Constructors
RequestOptions ({String ? method , int ? sendTimeout , int ? receiveTimeout , int ? connectTimeout , dynamic data , required String path , Map <String , dynamic > ? queryParameters , ProgressCallback ? onReceiveProgress , ProgressCallback ? onSendProgress , CancelToken ? cancelToken , String ? baseUrl , ResponseType ? responseType , String ? contentType , ValidateStatus ? validateStatus , bool ? receiveDataWhenStatusError , bool ? followRedirects , int ? maxRedirects , RequestEncoder ? requestEncoder , ResponseDecoder ? responseDecoder , ListFormat ? listFormat , bool ? setRequestContentTypeWhenNoPayload } )
Properties
baseUrl
↔ String
Request base url, it can contain sub path, like: "https://www.google.com/api/".
read / write, inherited
cancelToken
↔ CancelToken ?
read / write
connectTimeout
↔ int
Timeout in milliseconds for opening url.
Dio will throw the DioError with DioErrorType.connectTimeout type
when time out.
read / write, inherited
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
data
↔ dynamic
Request data, can be any type. [...]
read / write
Custom field that you can retrieve it later in Interceptor 、Transformer and the Response object.
read / write, inherited
followRedirects
↔ bool
see HttpClientRequest.followRedirects ,
The default value is true
read / write, inherited
hashCode
→ int
The hash code for this object. [...]
read-only, inherited
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
listFormat
↔ ListFormat
The listFormat indicates the format of collection data in request
query parameters and x-www-url-encoded
body data.
Possible values defined in ListFormat are csv
, ssv
, tsv
, pipes
, multi
, multiCompatible
.
The default value is multi
. [...]
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
onReceiveProgress
↔ ProgressCallback ?
read / write
onSendProgress
↔ ProgressCallback ?
read / write
path
↔ String
If the path
starts with 'http(s)', the baseURL
will be ignored, otherwise,
it will be combined and then resolved with the baseUrl.
read / write
queryParameters
↔ Map <String , dynamic >
Common query parameters. [...]
read / write, inherited
receiveDataWhenStatusError
↔ bool
Whether receiving response data when http status code is not successful.
The default value is true
read / write, inherited
receiveTimeout
↔ int
Timeout in milliseconds for receiving data. [...]
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.sendTimeout type
when time out.
read / write, inherited
uri
→ Uri
generate uri
read-only
validateStatus
↔ ValidateStatus
validateStatus
defines whether the request is successful for a given
HTTP response status code. If validateStatus
returns true
,
the request will be perceived as successful; otherwise, considered as failed.
read / write, inherited
Methods
copyWith ({String ? method , int ? sendTimeout , int ? receiveTimeout , int ? connectTimeout , String ? data , String ? path , Map <String , dynamic > ? queryParameters , String ? baseUrl , ProgressCallback ? onReceiveProgress , ProgressCallback ? onSendProgress , CancelToken ? cancelToken , ResponseType ? responseType , String ? contentType , ValidateStatus ? validateStatus , bool ? receiveDataWhenStatusError , bool ? followRedirects , int ? maxRedirects , RequestEncoder ? requestEncoder , ResponseDecoder ? responseDecoder , ListFormat ? listFormat , bool ? setRequestContentTypeWhenNoPayload } )
→ RequestOptions
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