Объект HttpClient

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

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

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 клиента

1readonly NArray HttpClient.cookies;

timeout

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

1Integer HttpClient.timeout;

enableCookie

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

1
Boolean HttpClient.enableCookie;

autoRedirect

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

1
Boolean HttpClient.autoRedirect;

enableEncoding

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

1
Boolean HttpClient.enableEncoding;

maxBodySize

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

1Integer HttpClient.maxBodySize;

userAgent

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

1
String HttpClient.userAgent;

poolSize

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

1Integer HttpClient.poolSize;

poolTimeout

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

1Integer HttpClient.poolTimeout;

proxyAgent

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

1
String HttpClient.proxyAgent;

sslVerification

Целое число, запрос и установка режима проверки сертификата при подключении к https, обратитесь к константе VERIFY_ * модуля ssl , значение по умолчанию - ssl.verification

1Integer HttpClient.sslVerification;

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

setClientCert

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

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

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

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

request

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

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

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

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

Результат возврата:

HttpResponse , возвращает ответ сервера

Запросить указанный 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, укажите дополнительную информацию

Результат возврата:

HttpResponse , возвращает ответ сервера

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, укажите дополнительную информацию

Результат возврата:

HttpResponse , возвращает ответ сервера

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, укажите дополнительную информацию

Результат возврата:

HttpResponse , возвращает ответ сервера

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, укажите дополнительную информацию

Результат возврата:

HttpResponse , возвращает ответ сервера

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, укажите дополнительную информацию

Результат возврата:

HttpResponse , возвращает ответ сервера

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 : Строка, указанный url , должен быть полным url включая хост
opts : Object, укажите дополнительную информацию

Результат возврата:

HttpResponse , возвращает ответ сервера

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

Руководство по развитию

Базовый модуль

Встроенные объекты

Модуль сообщества

Объект HttpClient

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

Конструктор

HttpClient

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

cookies

timeout

enableCookie

autoRedirect

enableEncoding

maxBodySize

userAgent

poolSize

poolTimeout

proxyAgent

sslVerification

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

setClientCert

request

get

post

del

put

patch

toString

toJSON