dart:io

Класс HttpClientRequest

HTTP-запрос для подключения клиента.

Для настройки запроса установите заголовки, используя свойство headers, предоставленное в этом классе, и запишите данные в тело запроса. HttpClientRequest является IOSink. Используйте методы из IOSink, такие как writeCharCode(), для записи тела HTTP-запроса. Когда один из методов IOSink используется впервые, заголовок запроса отправляется. Вызов любого метода, изменяющего заголовок после его отправки, генерирует исключение.

При записи строковых данных через IOSink используемое кодирование определяется из параметра "charset" заголовка "Content-Type".

HttpClientRequest request = ...
request.headers.contentType
    = new ContentType("application", "json", charset: "utf-8");
request.write(...);  // Strings written will be UTF-8 encoded.

Если параметр charset не задан, используется по умолчанию ISO-8859-1 (Latin 1).

HttpClientRequest request = ...
request.headers.add(HttpHeaders.CONTENT_TYPE, "text/plain");
request.write(...);  // Strings written will be ISO-8859-1 encoded.

Исключение генерируется, если используется неподдерживаемое кодирование, и метод, используемый в данный момент, принимает строковый параметр.

Реализует

• IOSink

Конструкторы

HttpClientRequest()

Свойства

bufferOutput → bool

чтение/запись

Получение или установка значения, указывающего, должен ли HttpClientRequest буферизовать вывод.

connectionInfo → HttpConnectionInfo

только для чтения

Получение информации о подключении клиента. Возвращает null если сокет недоступен.

contentLength → int

чтение/запись

Получение и установка длины содержимого запроса. Если размер запроса заранее неизвестен, установите длину содержимого в -1, что также является значением по умолчанию.

cookies → List<Cookie>

только для чтения

Куки для представления серверу (в заголовке 'cookie').

done → Future<HttpClientResponse>

только для чтения

HttpClientResponse будущее, которое завершится, как только ответ будет доступен. Если ошибка произойдёт до получения ответа, это будущее завершится с ошибкой.

followRedirects → bool

чтение/запись

Установите это свойство в true, если этот запрос должен автоматически следовать редиректам. По умолчанию true.

headers → HttpHeaders

только для чтения

Возвращает заголовки запроса клиента.

maxRedirects → int

чтение/запись

Установите это свойство в максимальное количество редиректов для следования, когда followRedirects true. Если это число превышено, событие об ошибке будет добавлено с RedirectException.

method → String

только для чтения

Метод запроса.

persistentConnection → bool

чтение/запись

Получение и установка состояния запрошенного постоянного соединения.

uri → Uri

только для чтения

Uri запроса.

encoding → Encoding

чтение/запись, унаследованно

Используемое кодирование при записи строк. В зависимости от подчинённого потребителя, это свойство может быть изменяемым.

hashCode → int

только для чтения, унаследованно

Хеш-код для этого объекта.

runtimeType → Type

только для чтения, унаследованно

Представление типа объекта во время выполнения.

Операторы

operator ==(other) → bool

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

Оператор равенства.

Методы

close() → Future<HttpClientResponse>

Закрыть запрос для ввода. Возвращает значение done.

add(List<int> data) → void

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

Добавляет байты data к целевому потребителю, игнорируя encoding.

addError(error, [ StackTrace stackTrace ]) → void

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

Передаёт ошибку целевому потребителю как событие об ошибке.

addStream(Stream<List<int>> stream) → Future

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

Добавляет все элементы заданного stream к this.

flush() → Future

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

Возвращает Future, который завершается, как только все буферизованные данные будут приняты подчинённым StreamConsumer.

noSuchMethod(Invocation invocation) → dynamic

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

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

toString() → String

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

Возвращает строковое представление этого объекта.

write(Object obj) → void

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

Преобразует obj в строку, вызвав Object.toString, и добавляет кодирование результата в целевого потребителя.

writeAll(Iterable objects, [ String separator = "" ]) → void

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

Итерируется по заданному objects и writeт их последовательно.

writeCharCode(int charCode) → void

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

Записывает символ charCode.

writeln([Object obj = "" ]) → void

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

Преобразует obj в строку, вызвав Object.toString, и записывает результат в this, после чего добавляет перевод строки.