dart:io

Класс HttpClientRequest

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

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

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

var client = HttpClient();
HttpClientRequest request = await client.get('localhost', 80, '/file.txt');
request.headers.contentType =
    ContentType('application', 'json', charset: 'utf-8');
request.write('text content👍🎯'); // Strings written will be UTF-8 encoded.

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

var client = HttpClient();
HttpClientRequest request = await client.get('localhost', 80, '/file.txt');
request.headers.add(HttpHeaders.contentTypeHeader, "text/plain");
request.write('blåbærgrød'); // Strings written will be ISO-8859-1 encoded

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

Реализуемые типы

• IOSink

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

HttpClientRequest()

Свойства

bufferOutput ↔ bool

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

Получает или задает, должен ли HttpClientRequest буферизовать вывод.

connectionInfo → HttpConnectionInfo?

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

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

contentLength ↔ int

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

Получает и задаёт длину тела запроса.

cookies → List<Cookie>

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

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

done → Future<HttpClientResponse>

только для чтения, переопределение

HttpClientResponse будущее, которое завершится, как только ответ станет доступным.

encoding ↔ Encoding

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

Encoding, используемый при записи строк.

followRedirects ↔ bool

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

Следовать ли автоматически перенаправлениям.

hashCode → int

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

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

headers → HttpHeaders

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

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

maxRedirects ↔ int

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

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

method → String

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

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

persistentConnection ↔ bool

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

Запрошенное состояние постоянного подключения.

runtimeType → Type

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

Представление фактического типа объекта.

uri → Uri

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

Uri запроса.

Методы

abort([Object? exception, StackTrace? stackTrace]) → void

@Since("2.10")

Прерывает клиентское подключение.

add(List<int> data) → void

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

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

addError(Object error, [StackTrace? stackTrace]) → void

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

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

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

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

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

close() → Future<HttpClientResponse>

переопределение

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

flush() → Future

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

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

noSuchMethod(Invocation invocation) → dynamic

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

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

toString() → String

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

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

write(Object? object) → void

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

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

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

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

Перебирает заданный objects, и последовательно записывает их.

writeCharCode(int charCode) → void

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

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

writeln([Object? object = ""]) → void

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

Преобразует object в строку, вызвав Object.toString, и записывает результат в this, после чего записывает символ новой строки.

Операторы

operator ==(Object other) → bool

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

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