Módulo módulo básico

Módulo http

Módulo de protocolo de transferencia de hipertexto para soportar o procesamento de protocolo http, alias de módulo: https

Obxecto

Request

Crea un obxecto de solicitude http, ver HttpRequest

1
HttpRequest http.Request;

Response

Crea un obxecto de resposta http, ver HttpResponse

1
HttpResponse http.Response;

Crea un obxecto cookie http, ver HttpCookie

1
HttpCookie http.Cookie;

Server

Crea un servidor http, ver HttpServer

1
HttpServer http.Server;

Client

Crea un cliente http, ver HttpClient

1
HttpClient http.Client;

HttpsServer

Crea un servidor https, ver HttpsServer

1
HttpsServer http.HttpsServer;

Handler

Crea un obxecto manipulador de protocolo http, ver HttpHandler

1
HttpHandler http.Handler;

Repeater

Crea un obxecto de procesador de reenvío de solicitudes http, ver HttpRepeater

1
HttpRepeater http.Repeater;

Función estática

fileHandler

Crea un procesador de ficheiros estáticos http para responder ás mensaxes http con ficheiros estáticos

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

Parámetros de chamada:

  • root: Cadea, ruta raíz do ficheiro
  • mimes: Obxecto, configuración MIME estendida
  • autoIndex: Booleano, se admite a navegación de ficheiros de catálogo, o predeterminado é falso, non é compatible

Resultado de volta:

  • Handler, Devolve un procesador estático de ficheiros para procesar mensaxes http

fileHandler admite a precompresión gzip. Cando a solicitude acepta a codificación gzip e o ficheiro filename.ext.gz existe no mesmo camiño, devolverá este ficheiro directamente para evitar a carga do servidor causada por unha compresión repetida.


setClientCert

Establecer certificado de cliente predeterminado

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

Parámetros de chamada:

  • crt: X509Cert, Certificado, usado para enviar ao servidor para verificar o cliente
  • key: PKey, Clave privada, que se usa para falar co cliente

request

Envía a solicitude http ao obxecto de fluxo especificado e devolve o resultado

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

Parámetros de chamada:

Resultado de volta:


Envía a solicitude http ao obxecto de fluxo especificado e devolve o resultado

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

Parámetros de chamada:

Resultado de volta:


Solicitude especificada urlE devolve o resultado

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

Parámetros de chamada:

  • method: Cadea, especifique o método de solicitude http: GET, POST, etc.
  • url: Cadea, especificar url, Debe ser o completo incluído o host url
  • opts: Obxecto, especifique información adicional

Resultado de volta:

opts contén opcións adicionais solicitadas e o contido soportado é o seguinte:

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

Onde corpo,json, O paquete non debe aparecer ao mesmo tempo. O valor predeterminado é {}, non contén ningunha información adicional


get

Use o método GET para solicitar o especificado url, E devolve o resultado, que equivale a solicitude ("GET", ...)

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

Parámetros de chamada:

  • url: Cadea, especificar url, Debe ser o completo incluído o host url
  • opts: Obxecto, especifique información adicional

Resultado de volta:

opts contén opcións adicionais solicitadas e o contido soportado é o seguinte:

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

Onde corpo,json, O paquete non debe aparecer ao mesmo tempo. O valor predeterminado é {}, non contén ningunha información adicional


post

Use o método POST para solicitar o especificado url, E devolve o resultado, que equivale a solicitude ("POST", ...)

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

Parámetros de chamada:

  • url: Cadea, especificar url, Debe ser o completo incluído o host url
  • opts: Obxecto, especifique información adicional

Resultado de volta:

opts contén opcións adicionais solicitadas e o contido soportado é o seguinte:

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

Onde corpo,json, O paquete non debe aparecer ao mesmo tempo. O valor predeterminado é {}, non contén ningunha información adicional


del

Use o método DELETE para solicitar o especificado url, E devolve o resultado, que equivale a solicitude ("ELIMINA", ...)

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

Parámetros de chamada:

  • url: Cadea, especificar url, Debe ser o completo incluído o host url
  • opts: Obxecto, especifique información adicional

Resultado de volta:

opts contén opcións adicionais solicitadas e o contido soportado é o seguinte:

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

Onde corpo,json, O paquete non debe aparecer ao mesmo tempo. O valor predeterminado é {}, non contén ningunha información adicional


put

Use o método PUT para solicitar o especificado url, E devolve o resultado, que equivale a solicitude ("PUT", ...)

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

Parámetros de chamada:

  • url: Cadea, especificar url, Debe ser o completo incluído o host url
  • opts: Obxecto, especifique información adicional

Resultado de volta:

opts contén opcións adicionais solicitadas e o contido soportado é o seguinte:

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

Onde corpo,json, O paquete non debe aparecer ao mesmo tempo. O valor predeterminado é {}, non contén ningunha información adicional


patch

Use o método PATCH para solicitar o especificado url, E devolve o resultado, que equivale a solicitude ("PARCHE", ...)

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

Parámetros de chamada:

  • url: Cadea, especificar url, Debe ser o completo incluído o host url
  • opts: Obxecto, especifique información adicional

Resultado de volta:

opts contén opcións adicionais solicitadas e o contido soportado é o seguinte:

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

Onde corpo,json, O paquete non debe aparecer ao mesmo tempo. O valor predeterminado é {}, non contén ningunha información adicional

Propiedades estáticas

STATUS_CODES

Array, devolve unha colección de códigos de estado de resposta HTTP estándar e unha breve descrición de cada un.

1
static readonly Array http.STATUS_CODES;

cookies

NArray, devolve o cliente http HttpCookie Lista de obxectos

1
static readonly NArray http.cookies;

timeout

Entero, consulta e tempo de espera establecido

1
static Integer http.timeout;

enableCookie

Cambio de función cookie, booleano, habilitado de xeito predeterminado

1
static Boolean http.enableCookie;

autoRedirect

Cambio de función de redirección automático booleano, habilitado de xeito predeterminado

1
static Boolean http.autoRedirect;

enableEncoding

Cambio de función de descompresión automático booleano, habilitado de xeito predeterminado

1
static Boolean http.enableEncoding;

maxBodySize

Entero, consulta e define o tamaño máximo do corpo, en MB, o predeterminado é -1 e o tamaño non está limitado

1
static Integer http.maxBodySize;

userAgent

Cadea, consulta e configura o ID do navegador na solicitude http

1
static String http.userAgent;

poolSize

Entero, consulta e configura o número máximo de conexións de caché para manter vivo, o predeterminado é 128

1
static Integer http.poolSize;

poolTimeout

Entero, consulta e configura o tempo de espera de conexión da caché para manter vivo, o valor predeterminado é 10000 ms

1
static Integer http.poolTimeout;

proxyAgent

Cadea, consulta e configuración do servidor proxy

1
static String http.proxyAgent;