Modulo modulo base

Modulo http

Modulo Hypertext Transfer Protocol per supportare l'elaborazione del protocollo http, alias del modulo: https

Oggetto

Request

Creare un oggetto richiesta http, vedere HttpRequest

1
HttpRequest http.Request;

Response

Creare un oggetto di risposta http, vedere HttpResponse

1
HttpResponse http.Response;

Creare un oggetto cookie http, vedere 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

Creare un server https, vedere HttpsServer

1
HttpsServer http.HttpsServer;

Handler

Creare un oggetto gestore del protocollo http, vedere HttpHandler

1
HttpHandler http.Handler;

Repeater

Creare un oggetto processore di inoltro delle richieste http, vedere HttpRepeater

1
HttpRepeater http.Repeater;

Funzione statica

fileHandler

Creare un elaboratore di file statici 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 : Object, impostazioni MIME estese
  • autoIndex : booleano, se supporta la navigazione nei file del catalogo, il valore predefinito è false, non supportato

Risultato di ritorno:

  • Handler , restituisce un gestore di file statico per l'elaborazione dei messaggi http

fileHandler supporta la precompressione 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 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
static HttpResponse http.request(Stream conn, HttpRequest req) async;

Parametri di chiamata:

Risultato di ritorno:


Richiedi l' url specificato e restituisci il risultato

1 2 3
static HttpResponse http.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:

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
static HttpResponse http.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:

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
static HttpResponse http.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:

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
static HttpResponse http.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:

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
static HttpResponse http.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:

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
static HttpResponse http.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:

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

Proprietà statiche

STATUS_CODES

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

1
static readonly Array http.STATUS_CODES;

cookies

NArray, restituisce un elenco di oggetti HttpCookie del client http

1
static readonly NArray http.cookies;

timeout

Intero, query e impostazione del timeout

1
static Integer http.timeout;

enableCookie

Booleano, interruttore di funzione cookie, abilitato per impostazione predefinita

1
static Boolean http.enableCookie;

autoRedirect

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

1
static Boolean http.autoRedirect;

enableEncoding

Booleano, interruttore della 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, interroga e imposta il tempo di timeout della connessione cache keep-alive, il valore predefinito è 10000 ms

1
static Integer http.poolTimeout;

proxyAgent

String, interroga e imposta il server proxy

1
static String http.proxyAgent;