W3cubDocs

/Dart 2

HttpClientRequest class

HTTP request for a client connection.

To set up a request, set the headers using the headers property provided in this class and write the data to the body of the request. HttpClientRequest is an IOSink. Use the methods from IOSink, such as writeCharCode(), to write the body of the HTTP request. When one of the IOSink methods is used for the first time, the request header is sent. Calling any methods that change the header after it is sent throws an exception.

When writing string data through the IOSink the encoding used is determined from the "charset" parameter of the "Content-Type" header.

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

If no charset is provided the default of ISO-8859-1 (Latin 1) is be used.

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

An exception is thrown if you use an unsupported encoding and the write() method being used takes a string parameter.

Implements

IOSink

Constructors

HttpClientRequest()

Properties

bufferOutput ↔ bool read / write: Gets or sets if the HttpClientRequest should buffer output. [...]
connectionInfo → HttpConnectionInfo read-only: Gets information about the client connection. [...]
contentLength ↔ int read / write: Gets and sets the content length of the request. [...]
cookies → List<Cookie> read-only: Cookies to present to the server (in the 'cookie' header).
done → Future<HttpClientResponse> read-only: A HttpClientResponse future that will complete once the response is available. [...]
followRedirects ↔ bool read / write: Set this property to true if this request should automatically follow redirects. The default is true. [...]
headers → HttpHeaders read-only: Returns the client request headers. [...]
maxRedirects ↔ int read / write: Set this property to the maximum number of redirects to follow when followRedirects is true. If this number is exceeded an error event will be added with a RedirectException. [...]
method → String read-only: The method of the request.
persistentConnection ↔ bool read / write: Gets and sets the requested persistent connection state. [...]
uri → Uri read-only: The uri of the request.
encoding ↔ Encoding read / write, inherited: The Encoding used when writing strings. Depending on the underlying consumer this property might be mutable.
hashCode → int read-only, inherited: The hash code for this object. [...]
runtimeType → Type read-only, inherited: A representation of the runtime type of the object.

Methods

close() → Future<HttpClientResponse>: Close the request for input. Returns the value of done.
add(List<int> data) → void inherited: Adds byte data to the target consumer, ignoring encoding. [...]
addError(Object error, [ StackTrace stackTrace ]) → void inherited: Passes the error to the target consumer as an error event. [...]
addStream(Stream<List<int>> stream) → Future inherited: Adds all elements of the given stream to this. [...]
flush() → Future inherited: Returns a Future that completes once all buffered data is accepted by the underlying StreamConsumer. [...]
noSuchMethod(Invocation invocation) → dynamic inherited: Invoked when a non-existent method or property is accessed. [...]
toString() → String inherited: Returns a string representation of this object.
write(Object obj) → void inherited: Converts obj to a String by invoking Object.toString and adds the encoding of the result to the target consumer. [...]
writeAll(Iterable objects, [ String separator = "" ]) → void inherited: Iterates over the given objects and writes them in sequence. [...]
writeCharCode(int charCode) → void inherited: Writes the character of charCode. [...]
writeln([Object obj = "" ]) → void inherited: Converts obj to a String by invoking Object.toString and writes the result to this, followed by a newline. [...]

Operators

operator ==(dynamic other) → bool inherited: The equality operator. [...]

© 2012 the Dart project authors
Licensed under the Creative Commons Attribution-ShareAlike License v4.0.
https://api.dartlang.org/stable/2.0.0/dart-io/HttpClientRequest-class.html