Объект встроенный объект

Объект HttpClient

объект клиента http

Клиентский объект http имитирует среду браузера для кэширования файлов cookie и несет соответствующий файл cookie при обращении к url . Различные объекты клиента http изолированы друг от друга, предоставляя запрос http , get, post и другие методы. Использование заключается в следующем:

1 2 3
var http = require('http'); var httpClient = new http.Client(); httpClient.request('GET', 'http://fibjs.org');

наследование

Конструктор

HttpClient

Конструктор HttpClient для создания нового объекта HttpClient

1
new HttpClient();

Атрибут члена

cookies

NArray, возвращает список объектов HttpCookie http клиента

1
readonly NArray HttpClient.cookies;

timeout

Целое число, запрос и установка единицы времени ожидания в миллисекундах

1
Integer HttpClient.timeout;

enableCookie

Boolean, переключатель функции cookie, включен по умолчанию

1
Boolean HttpClient.enableCookie;

autoRedirect

Boolean, автоматический переключатель функций перенаправления, открытый по умолчанию

1
Boolean HttpClient.autoRedirect;

enableEncoding

Boolean, автоматический выключатель функции декомпрессии, открытый по умолчанию

1
Boolean HttpClient.enableEncoding;

maxBodySize

Целое число, запрос и установка максимального размера тела, в МБ, по умолчанию -1, неограниченный размер

1
Integer HttpClient.maxBodySize;

userAgent

Строка, запрос и установка идентификатора браузера в запросе http

1
String HttpClient.userAgent;

poolSize

Целое число, запрос и установка максимального количества сохраняемых подключений кеша, по умолчанию 128

1
Integer HttpClient.poolSize;

poolTimeout

Целое число, запрос и установка таймаута подключения к кешу, по умолчанию 10000 мс

1
Integer HttpClient.poolTimeout;

proxyAgent

Строка, запрос и установка прокси-сервера

1
String HttpClient.proxyAgent;

Функция-член

setClientCert

Установите сертификат клиента по умолчанию

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

Параметры вызова:

  • crt : X509Cert , сертификат X509Cert , используется для аутентификации клиента на сервере
  • key : PKey , закрытый ключ PKey , используемый для общения с клиентом

request

Отправьте http запрос указанному объекту потока и верните результат

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

Параметры вызова:

  • conn : Stream , указать объект потока для обработки запроса
  • req : HttpRequest , объект HttpRequest для отправки

Вернуть результат:


Запросить указанный url и вернуть результат

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

Параметры вызова:

  • method : String, укажите http метод запроса: GET, POST и т. д.
  • url : String, указанная url должна быть полной url содержащей хост
  • opts : Object, указать дополнительную информацию

Вернуть результат:

opts содержит запрошенные дополнительные параметры, поддерживаемый контент выглядит следующим образом:

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

Тело и json не должны появляться одновременно. По умолчанию {}, без дополнительной информации


get

Используйте метод GET для запроса указанного url и возврата результата, который эквивалентен запросу ("GET", ...)

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

Параметры вызова:

  • url : String, указанная url должна быть полной url содержащей хост
  • opts : Object, указать дополнительную информацию

Вернуть результат:

opts содержит запрошенные дополнительные параметры, поддерживаемый контент выглядит следующим образом:

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

Тело и json не должны появляться одновременно. По умолчанию {}, без дополнительной информации


post

Используйте метод POST для запроса указанного url и возврата результата, который эквивалентен запросу ("POST", ...)

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

Параметры вызова:

  • url : String, указанная url должна быть полной url содержащей хост
  • opts : Object, указать дополнительную информацию

Вернуть результат:

opts содержит запрошенные дополнительные параметры, поддерживаемый контент выглядит следующим образом:

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

Тело и json не должны появляться одновременно. По умолчанию {}, без дополнительной информации


del

Используйте метод DELETE для запроса указанного url и возврата результата, который эквивалентен запросу («DELETE», ...)

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

Параметры вызова:

  • url : String, указанная url должна быть полной url содержащей хост
  • opts : Object, указать дополнительную информацию

Вернуть результат:

opts содержит запрошенные дополнительные параметры, поддерживаемый контент выглядит следующим образом:

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

Тело и json не должны появляться одновременно. По умолчанию {}, без дополнительной информации


put

Используйте метод PUT для запроса указанного url и возврата результата, который эквивалентен запросу («PUT», ...)

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

Параметры вызова:

  • url : String, указанная url должна быть полной url содержащей хост
  • opts : Object, указать дополнительную информацию

Вернуть результат:

opts содержит запрошенные дополнительные параметры, поддерживаемый контент выглядит следующим образом:

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

Тело и json не должны появляться одновременно. По умолчанию {}, без дополнительной информации


patch

Используйте метод PATCH, чтобы запросить указанный url и вернуть результат, который эквивалентен запросу ("PATCH", ...)

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

Параметры вызова:

  • url : String, указанный url должен быть полным url содержащим хост
  • opts : Object, указать дополнительную информацию

Вернуть результат:

opts содержит запрошенные дополнительные параметры, поддерживаемый контент выглядит следующим образом:

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

Тело и json не должны появляться одновременно. По умолчанию {}, без дополнительной информации


toString

Возвращает строковое представление объекта, обычно возвращает «[Native Object]», объект может быть переопределён согласно его собственным характеристикам

1
String HttpClient.toString();

Вернуть результат:

  • String , возвращает строковое представление объекта

toJSON

Возвращает JSON-представление объекта, как правило, возвращает коллекцию читаемых атрибутов, определенных объектом

1
Value HttpClient.toJSON(String key = "");

Параметры вызова:

  • key : строка, не используется

Вернуть результат:

  • Value , возвращает значение, содержащее сериализуемый JSON