Objet objet intégré

Objet HttpClient

httpObjet client

httpL'objet client simule l'environnement du navigateur pour mettre en cache les cookies et accèdeurlLors du transport du cookie correspondant, différentshttpLes objets clients sont isolés les uns des autres, fournissanthttpLes méthodes request, get, post et autres. L'utilisation est la suivante :

1 2 3
var http = require('http'); var httpClient = new http.Client(); httpClient.request('GET', 'http://fibjs.org');

Héritage

#lineWidth: 1.5 #font: Helvetica,sans-Serif #fontSize: 10 #leading: 1.6 #.this: fill=lightgray #.class: fill=white [<class>object|toString();toJSON()] [<this>HttpClient|new HttpClient()|cookies;timeout;enableCookie;autoRedirect;enableEncoding;maxBodySize;userAgent;poolSize;poolTimeout;proxyAgent;sslVerification|setClientCert();request();get();post();del();put();patch()] [object] <:- [HttpClient] HttpClient new HttpClient() cookies timeout enableCookie autoRedirect enableEncoding maxBodySize userAgent poolSize poolTimeout proxyAgent sslVerification setClientCert() request() get() post() del() put() patch() object toString() toJSON()

Constructeur

HttpClient

Constructeur HttpClient, créez un nouvel objet HttpClient

1
new HttpClient();

Attributs des membres

cookies

NArray, retourhttpClient HttpCookie Liste d'objets

1
readonly NArray HttpClient.cookies;

timeout

Entier, requête et définition du délai d'attente en millisecondes

1
Integer HttpClient.timeout;

enableCookie

Booléen, commutateur de fonction de cookie, activé par défaut

1
Boolean HttpClient.enableCookie;

autoRedirect

Booléen, commutateur de fonction de redirection automatique, activé par défaut

1
Boolean HttpClient.autoRedirect;

enableEncoding

Booléen, commutateur de fonction de décompression automatique, activé par défaut

1
Boolean HttpClient.enableEncoding;

maxBodySize

Entier, interrogez et définissez la taille maximale du corps, en Mo, la valeur par défaut est -1, et la taille n'est pas limitée

1
Integer HttpClient.maxBodySize;

userAgent

Chaîne, requête et ensemble http ID de navigateur dans la demande

1
String HttpClient.userAgent;

poolSize

Entier, interrogez et définissez le nombre maximal de connexions de cache persistantes, la valeur par défaut est 128

1
Integer HttpClient.poolSize;

poolTimeout

Entier, interrogez et définissez le délai d'expiration de la connexion au cache keep-alive, la valeur par défaut est 10000 ms

1
Integer HttpClient.poolTimeout;

proxyAgent

Chaîne, requête et définition du serveur proxy

1
String HttpClient.proxyAgent;

sslVerification

Entier, interroger et définir le mode de vérification du certificat lors de la connexion à https, référence ssl VERIFY_* constantes du module, la valeur par défaut est ssl.verification

1
Integer HttpClient.sslVerification;

Fonction membre

setClientCert

Définir le certificat client par défaut

1 2
HttpClient.setClientCert(X509Cert crt, PKey key);

Paramètres d'appel :

  • crt: X509Cert, Certificat, utilisé pour envoyer au serveur pour vérifier le client
  • key: PKey, Clé privée, utilisée pour parler au client

request

envoyer http Demande à l'objet de flux spécifié et renvoie le résultat

1 2
HttpResponse HttpClient.request(Stream conn, HttpRequest req) async;

Paramètres d'appel :

Résultat de retour :


envoyer http Demande à l'objet de flux spécifié et renvoie le résultat

1 2 3
HttpResponse HttpClient.request(Stream conn, HttpRequest req, SeekableStream response_body) async;

Paramètres d'appel :

Résultat de retour :


Demande spécifiée urlEt retourne le résultat

1 2 3
HttpResponse HttpClient.request(String method, String url, Object opts = {}) async;

Paramètres d'appel :

  • method: chaîne, spécifiez http Méthode de requête : GET, POST, etc.
  • url: chaîne, spécifiez url, Doit être le complet, y compris l'hôte url
  • opts: Objet, spécifiez des informations supplémentaires

Résultat de retour :

opts contient des options supplémentaires demandées, et le contenu pris en charge est le suivant :

1 2 3 4 5 6 7 8
{ "query": {}, "body": SeekableStream | Buffer | String | {}, "json": {}, "pack": {}, "headers": {}, "response_body": SeekableStream // 指定接受 resposne 数据的流 }

Où corps,json, Pack ne doit pas apparaître en même temps. La valeur par défaut est {}, ne contient aucune information supplémentaire


get

Utilisez la méthode GET pour demander le url, Et renvoie le résultat, qui équivaut à request("GET", ...)

1 2
HttpResponse HttpClient.get(String url, Object opts = {}) async;

Paramètres d'appel :

  • url: chaîne, spécifiez url, Doit être le complet, y compris l'hôte url
  • opts: Objet, spécifiez des informations supplémentaires

Résultat de retour :

opts contient des options supplémentaires demandées, et le contenu pris en charge est le suivant :

1 2 3 4 5 6 7
{ "query": {}, "body": SeekableStream | Buffer | String | {}, "json": {}, "pack": {}, "headers": {} }

Où corps,json, Pack ne doit pas apparaître en même temps. La valeur par défaut est {}, ne contient aucune information supplémentaire


post

Utilisez la méthode POST pour demander le url, Et renvoie le résultat, qui équivaut à request("POST", ...)

1 2
HttpResponse HttpClient.post(String url, Object opts = {}) async;

Paramètres d'appel :

  • url: chaîne, spécifiez url, Doit être le complet, y compris l'hôte url
  • opts: Objet, spécifiez des informations supplémentaires

Résultat de retour :

opts contient des options supplémentaires demandées, et le contenu pris en charge est le suivant :

1 2 3 4 5 6 7
{ "query": {}, "body": SeekableStream | Buffer | String | {}, "json": {}, "pack": {}, "headers": {} }

Où corps,json, Pack ne doit pas apparaître en même temps. La valeur par défaut est {}, ne contient aucune information supplémentaire


del

Utilisez la méthode DELETE pour demander le url, Et renvoie le résultat, qui équivaut à request("DELETE", ...)

1 2
HttpResponse HttpClient.del(String url, Object opts = {}) async;

Paramètres d'appel :

  • url: chaîne, spécifiez url, Doit être le complet, y compris l'hôte url
  • opts: Objet, spécifiez des informations supplémentaires

Résultat de retour :

opts contient des options supplémentaires demandées, et le contenu pris en charge est le suivant :

1 2 3 4 5 6 7
{ "query": {}, "body": SeekableStream | Buffer | String | {}, "json": {}, "pack": {}, "headers": {} }

Où corps,json, Pack ne doit pas apparaître en même temps. La valeur par défaut est {}, ne contient aucune information supplémentaire


put

Utilisez la méthode PUT pour demander le url, Et renvoie le résultat, qui équivaut à request("PUT", ...)

1 2
HttpResponse HttpClient.put(String url, Object opts = {}) async;

Paramètres d'appel :

  • url: chaîne, spécifiez url, Doit être le complet, y compris l'hôte url
  • opts: Objet, spécifiez des informations supplémentaires

Résultat de retour :

opts contient des options supplémentaires demandées, et le contenu pris en charge est le suivant :

1 2 3 4 5 6 7
{ "query": {}, "body": SeekableStream | Buffer | String | {}, "json": {}, "pack": {}, "headers": {} }

Où corps,json, Pack ne doit pas apparaître en même temps. La valeur par défaut est {}, ne contient aucune information supplémentaire


patch

Utilisez la méthode PATCH pour demander le url, Et renvoie le résultat, qui équivaut à request("PATCH", ...)

1 2
HttpResponse HttpClient.patch(String url, Object opts = {}) async;

Paramètres d'appel :

  • url: chaîne, spécifiez url, Doit être le complet, y compris l'hôte url
  • opts: Objet, spécifiez des informations supplémentaires

Résultat de retour :

opts contient des options supplémentaires demandées, et le contenu pris en charge est le suivant :

1 2 3 4 5 6 7
{ "query": {}, "body": SeekableStream | Buffer | String | {}, "json": {}, "pack": {}, "headers": {} }

Où corps,json, Pack ne doit pas apparaître en même temps. La valeur par défaut est {}, ne contient aucune information supplémentaire


toString

Renvoie la représentation sous forme de chaîne de l'objet, renvoie généralement "[Objet natif]", l'objet peut être ré-implémenté selon ses propres caractéristiques

1
String HttpClient.toString();

Résultat de retour :

  • String, Renvoie la représentation sous forme de chaîne de l'objet

toJSON

Renvoie la représentation au format JSON de l'objet, renvoie généralement une collection d'attributs lisibles définis par l'objet

1
Value HttpClient.toJSON(String key = "");

Paramètres d'appel :

  • key: chaîne, inutilisé

Résultat de retour :

  • Value, Renvoie une valeur contenant JSON sérialisable