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;

Cookie

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:

• 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
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:

• 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
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:

• 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
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:

• 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
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:

• 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
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:

• 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
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:

• 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

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;