Object HttpClient

oggetto client http

http oggetto client simula l'ambiente browser per i cookie di cache e porta il cookie corrispondente quando si accede alla url . Diverse http oggetti client sono isolati gli uni dagli altri e forniscono http richiesta, ottenere, posta e altri metodi. L'utilizzo è il seguente:

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

Eredità

Costruttore

HttpClient

HttpClient costruttore per creare un nuovo oggetto HttpClient

1
new HttpClient();

Attributi dei membri

cookies

NArray, restituisce un elenco di oggetti HttpCookie del client http

1
readonly NArray HttpClient.cookies;

timeout

Intero, interroga e imposta il tempo di timeout in millisecondi

1
Integer HttpClient.timeout;

enableCookie

Booleano, interruttore di funzione cookie, abilitato per impostazione predefinita

1
Boolean HttpClient.enableCookie;

autoRedirect

Booleano, interruttore di funzione di reindirizzamento automatico, abilitato per impostazione predefinita

1
Boolean HttpClient.autoRedirect;

enableEncoding

Booleano, interruttore della funzione di decompressione automatica, abilitato per impostazione predefinita

1
Boolean HttpClient.enableEncoding;

maxBodySize

Intero, interroga e imposta la dimensione massima del corpo, in MB, il valore predefinito è -1 e la dimensione non è limitata

1
Integer HttpClient.maxBodySize;

userAgent

Stringa, interroga e imposta l'ID del browser nella richiesta http

1
String HttpClient.userAgent;

poolSize

Intero, interroga e imposta il numero massimo di connessioni cache keep-alive, il valore predefinito è 128

1
Integer HttpClient.poolSize;

poolTimeout

Intero, interroga e imposta il tempo di timeout della connessione cache keep-alive, il valore predefinito è 10000 ms

1
Integer HttpClient.poolTimeout;

proxyAgent

String, interroga e imposta il server proxy

1
String HttpClient.proxyAgent;

sslVerification

Intero, interroga e imposta la modalità di verifica del certificato durante la connessione a https, fai riferimento alla costante VERIFY_ * del modulo ssl , il valore predefinito è ssl.verification

1
Integer HttpClient.sslVerification;

Funzione membro

setClientCert

Imposta certificato client predefinito

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

Parametri di chiamata:

• crt : X509Cert , certificato X509Cert , utilizzato per il server di autenticazione client
• key : PKey , chiave privata PKey , utilizzata per parlare con il client

request

Invia la richiesta http all'oggetto stream specificato e restituisci il risultato

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

Parametri di chiamata:

• conn : Stream , specifica l'oggetto stream che elabora la richiesta
• req : HttpRequest , l'oggetto HttpRequest da inviare

Risultato di ritorno:

• HttpResponse , restituisce la risposta del server

Richiedi l' url specificato e restituisci il risultato

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

Parametri di chiamata:

• method : stringa, specificare il metodo di richiesta http : GET, POST, ecc.
• url : String, l' url specificato, deve essere l' url completo incluso l'host
• opts : Oggetto, specifica informazioni aggiuntive

Risultato di ritorno:

• HttpResponse , restituisce la risposta del server

opts contiene ulteriori opzioni richieste e il contenuto supportato è il seguente:

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

Il corpo e il json non devono apparire contemporaneamente. L'impostazione predefinita è {} senza alcuna informazione aggiuntiva

get

Utilizza il metodo GET per richiedere l' url specificato e restituire il risultato, che equivale a request ("GET", ...)

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

Parametri di chiamata:

• url : String, l' url specificato, deve essere l' url completo incluso l'host
• opts : Oggetto, specifica informazioni aggiuntive

Risultato di ritorno:

• HttpResponse , restituisce la risposta del server

opts contiene ulteriori opzioni richieste e il contenuto supportato è il seguente:

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

Il corpo e il json non devono apparire contemporaneamente. L'impostazione predefinita è {} senza alcuna informazione aggiuntiva

post

Utilizza il metodo POST per richiedere l' url specificato e restituire il risultato, che equivale a request ("POST", ...)

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

Parametri di chiamata:

• url : String, l' url specificato, deve essere l' url completo incluso l'host
• opts : Oggetto, specifica informazioni aggiuntive

Risultato di ritorno:

• HttpResponse , restituisce la risposta del server

opts contiene ulteriori opzioni richieste e il contenuto supportato è il seguente:

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

Il corpo e il json non devono apparire contemporaneamente. L'impostazione predefinita è {} senza alcuna informazione aggiuntiva

del

Utilizza il metodo DELETE per richiedere l' url specificato e restituire il risultato, che equivale a request ("DELETE", ...)

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

Parametri di chiamata:

• url : String, l' url specificato, deve essere l' url completo incluso l'host
• opts : Oggetto, specifica informazioni aggiuntive

Risultato di ritorno:

• HttpResponse , restituisce la risposta del server

opts contiene ulteriori opzioni richieste e il contenuto supportato è il seguente:

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

Il corpo e il json non devono apparire contemporaneamente. L'impostazione predefinita è {} senza alcuna informazione aggiuntiva

put

Utilizza il metodo PUT per richiedere l' url specificato e restituire il risultato, che equivale a request ("PUT", ...)

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

Parametri di chiamata:

• url : String, l' url specificato, deve essere l' url completo incluso l'host
• opts : Oggetto, specifica informazioni aggiuntive

Risultato di ritorno:

• HttpResponse , restituisce la risposta del server

opts contiene ulteriori opzioni richieste e il contenuto supportato è il seguente:

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

Il corpo e il json non devono apparire contemporaneamente. L'impostazione predefinita è {} senza alcuna informazione aggiuntiva

patch

Usa il metodo PATCH per richiedere l' url specificato e restituire il risultato, che è equivalente a request ("PATCH", ...)

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

Parametri di chiamata:

• url : String, l' url specificato, deve essere l' url completo incluso l'host
• opts : Oggetto, specifica informazioni aggiuntive

Risultato di ritorno:

• HttpResponse , restituisce la risposta del server

opts contiene ulteriori opzioni richieste e il contenuto supportato è il seguente:

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

Il corpo e il json non devono apparire contemporaneamente. L'impostazione predefinita è {} senza alcuna informazione aggiuntiva

toString

Restituisce la rappresentazione in stringa dell'oggetto, generalmente restituisce "[Native Object]", l'oggetto può essere reimplementato secondo le proprie caratteristiche

1
String HttpClient.toString();

Risultato di ritorno:

• String , restituisce la rappresentazione in formato stringa dell'oggetto

toJSON

Restituisce la rappresentazione in formato JSON dell'oggetto, generalmente restituisce una raccolta di attributi leggibili definiti dall'oggetto

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

Parametri di chiamata:

• key : stringa, non utilizzata

Risultato di ritorno:

• Value , restituisce un valore contenente JSON serializzabile