Modulo modulo base

Modulo http

Modulo del protocollo di trasferimento ipertestuale per supportare l'elaborazione del protocollo http, alias del modulo: https

Oggetto

Request

Crea un oggetto di richiesta http, vedi HttpRequest

1
HttpRequest http.Request;

Response

Crea un oggetto di risposta http, vedi HttpResponse

1
HttpResponse http.Response;

Crea un oggetto cookie http, vedi HttpCookie

1
HttpCookie http.Cookie;

Server

Crea un server http, vedi HttpServer

1
HttpServer http.Server;

Client

Crea un client http, vedi HttpClient

1
HttpClient http.Client;

HttpsServer

Crea un server https, vedi HttpsServer

1
HttpsServer http.HttpsServer;

Handler

Crea un oggetto gestore di protocollo http, vedi HttpHandler

1
HttpHandler http.Handler;

Repeater

Crea un oggetto del processore di inoltro della richiesta http, vedi HttpRepeater

1
HttpRepeater http.Repeater;

Funzione statica

fileHandler

Crea un processore di file statico http per rispondere ai messaggi http con file statici

1 2 3
static Handler http.fileHandler(String root, Object mimes = {}, Boolean autoIndex = false);

Parametri di chiamata:

  • root: Stringa, percorso radice del file
  • mimes: Oggetto, impostazioni mime estese
  • autoIndex: booleano, se supportare la navigazione dei file di catalogo, l'impostazione predefinita è false, non supportato

Risultato di ritorno:

  • Handler, Restituisce un processore di file statico per l'elaborazione dei messaggi http

fileHandler supporta la pre-compressione gzip.Quando la richiesta accetta la codifica gzip e il file filename.ext.gz esiste nello stesso percorso, restituirà direttamente questo file, in modo da evitare il carico del server causato dalla compressione ripetuta.


setClientCert

Imposta certificato client predefinito

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

Parametri di chiamata:

  • crt: X509Cert, Certificato, utilizzato per inviare al server per verificare il client
  • key: PKey, Chiave privata, usata per parlare con il cliente

request

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

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

Parametri di chiamata:

Risultato di ritorno:


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

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

Parametri di chiamata:

Risultato di ritorno:


Richiesta specificata urlE restituisci il risultato

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

Parametri di chiamata:

  • method: Stringa, specifica il metodo di richiesta http: GET, POST, ecc.
  • url: Stringa, specifica url, Deve essere completo incluso l'host url
  • opts: Oggetto, specificare ulteriori informazioni

Risultato di ritorno:

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

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

dove corpo,json, Pack non deve apparire contemporaneamente. Il valore predefinito è {}, non contiene alcuna informazione aggiuntiva


get

Usa il metodo GET per richiedere quanto specificato url, e restituisce il risultato, che è equivalente a request("GET", ...)

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

Parametri di chiamata:

  • url: Stringa, specifica url, Deve essere completo incluso l'host url
  • opts: Oggetto, specificare ulteriori informazioni

Risultato di ritorno:

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

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

dove corpo,json, Pack non deve apparire contemporaneamente. Il valore predefinito è {}, non contiene alcuna informazione aggiuntiva


post

Usa il metodo POST per richiedere quanto specificato url, e restituisce il risultato, che è equivalente a request("POST", ...)

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

Parametri di chiamata:

  • url: Stringa, specifica url, Deve essere completo incluso l'host url
  • opts: Oggetto, specificare ulteriori informazioni

Risultato di ritorno:

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

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

dove corpo,json, Pack non deve apparire contemporaneamente. Il valore predefinito è {}, non contiene alcuna informazione aggiuntiva


del

Utilizzare il metodo DELETE per richiedere quanto specificato url, e restituisce il risultato, che è equivalente a request("DELETE", ...)

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

Parametri di chiamata:

  • url: Stringa, specifica url, Deve essere completo incluso l'host url
  • opts: Oggetto, specificare ulteriori informazioni

Risultato di ritorno:

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

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

dove corpo,json, Pack non deve apparire contemporaneamente. Il valore predefinito è {}, non contiene alcuna informazione aggiuntiva


put

Utilizzare il metodo PUT per richiedere lo specificato url, e restituisce il risultato, che è equivalente a request("PUT", ...)

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

Parametri di chiamata:

  • url: Stringa, specifica url, Deve essere completo incluso l'host url
  • opts: Oggetto, specificare ulteriori informazioni

Risultato di ritorno:

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

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

dove corpo,json, Pack non deve apparire contemporaneamente. Il valore predefinito è {}, non contiene alcuna informazione aggiuntiva


patch

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

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

Parametri di chiamata:

  • url: Stringa, specifica url, Deve essere completo incluso l'host url
  • opts: Oggetto, specificare ulteriori informazioni

Risultato di ritorno:

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

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

dove corpo,json, Pack non deve apparire contemporaneamente. Il valore predefinito è {}, non contiene alcuna informazione aggiuntiva

Proprietà statiche

STATUS_CODES

Array, restituisce una raccolta di codici di stato di risposta HTTP standard e una breve descrizione di ciascuno.

1
static readonly Array http.STATUS_CODES;

cookies

NArray, restituisce i client http HttpCookie Elenco oggetti

1
static readonly NArray http.cookies;

timeout

Intero, interrogazione e impostazione del timeout

1
static Integer http.timeout;

enableCookie

Booleano, interruttore funzione cookie, abilitato per impostazione predefinita

1
static Boolean http.enableCookie;

autoRedirect

Boolean, interruttore della funzione di reindirizzamento automatico, abilitato per impostazione predefinita

1
static Boolean http.autoRedirect;

enableEncoding

Interruttore booleano, funzione di decompressione automatica, abilitato per impostazione predefinita

1
static Boolean http.enableEncoding;

maxBodySize

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

1
static Integer http.maxBodySize;

userAgent

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

1
static String http.userAgent;

poolSize

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

1
static Integer http.poolSize;

poolTimeout

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

1
static Integer http.poolTimeout;

proxyAgent

Stringa, interroga e imposta il server proxy

1
static String http.proxyAgent;