Options class
Every request can pass an Options object which will be merged with Dio.options
- Implementers
Constructors
-
Options({String method, int sendTimeout, int receiveTimeout, Map<
String, dynamic> extra, Map<String, dynamic> headers, ResponseType responseType, String contentType, ValidateStatus validateStatus, bool receiveDataWhenStatusError, bool followRedirects, int maxRedirects, RequestEncoder requestEncoder, ResponseDecoder responseDecoder})
Properties
- contentType ↔ String
-
The request Content-Type. The default value is ContentType.json.
If you want to encode request body with 'application/x-www-form-urlencoded',
you can set
ContentType.parse('application/x-www-form-urlencoded'), and Dio will automatically encode the request body.read / write, inherited -
extra
↔ Map<
String, dynamic> -
Custom field that you can retrieve it later in Interceptor、Transformer and the Response object.
read / write, inherited
- followRedirects ↔ bool
-
see HttpClientRequest.followRedirects
read / write, inherited
- hashCode → int
-
The hash code for this object. [...]
read-only, inherited
-
headers
↔ Map<
String, dynamic> -
Http request headers. The keys of initial headers will be converted to lowercase,
for example 'Content-Type' will be converted to 'content-type'. [...]
read / write, inherited
- maxRedirects ↔ int
-
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. [...]read / write, inherited - method ↔ String
-
Http method.
read / write, inherited
- receiveDataWhenStatusError ↔ bool
-
Whether receiving response data when http status code is not successful.
read / write, inherited
- receiveTimeout ↔ int
-
Timeout in milliseconds for receiving data.
Dio will throw the DioError with DioErrorType.RECEIVE_TIMEOUT type
when time out. [...]
read / write, inherited
- requestEncoder ↔ RequestEncoder
-
The default request encoder is utf8encoder, you can set custom
encoder by this option.
read / write, inherited
- responseDecoder ↔ ResponseDecoder
-
The default response decoder is utf8decoder, you can set custom
decoder by this option, it will be used in Transformer.
read / write, inherited
- responseType ↔ ResponseType
-
responseType indicates the type of data that the server will respond with
options which defined in ResponseType are
json,stream,plain. [...]read / write, inherited - runtimeType → Type
-
A representation of the runtime type of the object.
read-only, inherited
- sendTimeout ↔ int
-
Timeout in milliseconds for sending data.
Dio will throw the DioError with DioErrorType.SEND_TIMEOUT type
when time out.
read / write, inherited
- validateStatus ↔ ValidateStatus
-
validateStatusdefines whether the request is successful for a given HTTP response status code. IfvalidateStatusreturnstrue, the request will be perceived as successful; otherwise, considered as failed.read / write, inherited
Methods
-
merge(
{String method, int sendTimeout, int receiveTimeout, Map< String, dynamic> extra, Map<String, dynamic> headers, ResponseType responseType, String contentType, ValidateStatus validateStatus, bool receiveDataWhenStatusError, bool followRedirects, int maxRedirects, RequestEncoder requestEncoder, ResponseDecoder responseDecoder}) → Options - Create a Option from current instance with merging attributes.
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a non-existent method or property is accessed. [...]
inherited
-
toString(
) → String -
A string representation of this object. [...]
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator. [...]
inherited