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;

---

Cookie

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:

• conn: Stream, Specificare l'oggetto stream per elaborare la richiesta
• req: HttpRequest, Da inviare HttpRequest Oggetto

Risultato di ritorno:

• HttpResponse, Restituisci la risposta del server

---

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:

• conn: Stream, Specificare l'oggetto stream per elaborare la richiesta
• req: HttpRequest, Da inviare HttpRequest Oggetto
• response_body: SeekableStream, Specificare il flusso di response.body

Risultato di ritorno:

• HttpResponse, Restituisci la risposta del server

---

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:

• HttpResponse, Restituisci la risposta del server

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:

• HttpResponse, Restituisci la risposta del server

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:

• HttpResponse, Restituisci la risposta del server

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:

• HttpResponse, Restituisci la risposta del server

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:

• HttpResponse, Restituisci la risposta del server

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:

• HttpResponse, Restituisci la risposta del server

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;