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
1HttpRequest http.Request;
Response
Creare un oggetto di risposta http, vedere HttpResponse
1HttpResponse http.Response;
Cookie
Creare un oggetto cookie http, vedere HttpCookie
1HttpCookie http.Cookie;
Server
Crea un server http, vedi HttpServer
1HttpServer http.Server;
Client
Crea un client http, vedi HttpClient
1HttpClient http.Client;
HttpsServer
Creare un server https, vedere HttpsServer
1HttpsServer http.HttpsServer;
Handler
Creare un oggetto gestore del protocollo http, vedere HttpHandler
1HttpHandler http.Handler;
Repeater
Creare un oggetto del processore di inoltro delle richieste http, vedere HttpRepeater
1HttpRepeater http.Repeater;
Funzione statica
fileHandler
Creare un elaboratore di file statici http per rispondere ai messaggi http con file statici
1
2
3static 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 il certificato client predefinito
1
2static 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
2static 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
3static 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
2static 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
2static 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
2static 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
2static HttpResponse http.put(String url,
Object opts = {}) async;
Parametri di chiamata:
- url : la stringa, 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
2static 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.
1static readonly Array http.STATUS_CODES;
cookies
NArray, restituisce un elenco di oggetti HttpCookie del client http
1static readonly NArray http.cookies;
timeout
Intero, query e impostazione del timeout
1static Integer http.timeout;
enableCookie
Booleano, interruttore di funzione cookie, abilitato per impostazione predefinita
1static Boolean http.enableCookie;
autoRedirect
Booleano, interruttore di funzione di reindirizzamento automatico, abilitato per impostazione predefinita
1static Boolean http.autoRedirect;
enableEncoding
Booleano, interruttore della funzione di decompressione automatica, abilitato per impostazione predefinita
1static Boolean http.enableEncoding;
maxBodySize
Intero, interroga e imposta la dimensione massima del corpo, in MB, il valore predefinito è -1 e la dimensione non è limitata
1static Integer http.maxBodySize;
userAgent
Stringa, interroga e imposta l'ID del browser nella richiesta http
1static String http.userAgent;
poolSize
Intero, interroga e imposta il numero massimo di connessioni cache keep-alive, il valore predefinito è 128
1static Integer http.poolSize;
poolTimeout
Intero, interroga e imposta il tempo di timeout della connessione cache keep-alive, il valore predefinito è 10000 ms
1static Integer http.poolTimeout;
proxyAgent
String, interroga e imposta il server proxy
1static String http.proxyAgent;