pub struct ClientBuilder { /* fields omitted */ }
A ClientBuilder
can be used to create a Client
with custom configuration.
Constructs a new ClientBuilder
.
This is the same as Client::builder()
.
Returns a Client
that uses this ClientBuilder
configuration.
This method fails if TLS backend cannot be initialized, or the resolver
cannot load the system configuration.
Add a custom root certificate.
This can be used to connect to a server that has a self-signed
certificate for example.
Sets the identity to be used for client certificate authentication.
Controls the use of hostname verification.
Defaults to false
.
You should think very carefully before you use this method. If
hostname verification is not used, any valid certificate for any
site will be trusted for use from any other. This introduces a
significant vulnerability to man-in-the-middle attacks.
Controls the use of certificate validation.
Defaults to false
.
You should think very carefully before using this method. If
invalid certificates are trusted, any certificate for any site
will be trusted for use. This includes expired certificates. This
introduces significant vulnerabilities, and should only be used
as a last resort.
Sets the default headers for every request.
Enable auto gzip decompression by checking the ContentEncoding response header.
If auto gzip decompresson is turned on:
- When sending a request and if the request's headers do not already contain
an
Accept-Encoding
and Range
values, the Accept-Encoding
header is set to gzip
.
The body is not automatically inflated.
- When receiving a response, if it's headers contain a
Content-Encoding
value that
equals to gzip
, both values Content-Encoding
and Content-Length
are removed from the
headers' set. The body is automatically deinflated.
Default is enabled.
Add a Proxy
to the list of proxies the Client
will use.
Set a RedirectPolicy
for this client.
Default will follow redirects up to a maximum of 10.
Enable or disable automatic setting of the Referer
header.
Default is true
.
Set a timeout for both the read and write operations of a client.
Formats the value using the given formatter. Read more
🔬 This is a nightly-only experimental API. (try_from
)
The type returned in the event of a conversion error.
🔬 This is a nightly-only experimental API. (try_from
)
Immutably borrows from an owned value. Read more
Mutably borrows from an owned value. Read more
🔬 This is a nightly-only experimental API. (try_from
)
The type returned in the event of a conversion error.
🔬 This is a nightly-only experimental API. (try_from
)
🔬 This is a nightly-only experimental API. (get_type_id
)
this method will likely be replaced by an associated static