Struct RequestBuilder 

pub struct RequestBuilder { /* private fields */ }

Builder for a Request.

Setters are infallible; errors (an unparsable URL, an invalid header) are deferred and reported by build, mirroring http::request::Builder. The first error wins.

Implementations

impl RequestBuilder

pub fn method(self, method: Method) -> Self

Sets the request method (default: GET).

pub fn url(self, url: impl IntoUrl) -> Self

Sets the request URL. Required; the scheme must be https.

pub fn header<K, V>(self, key: K, value: V) -> Self

where K: TryInto<HeaderName>, K::Error: Into<Error>, V: TryInto<HeaderValue>, V::Error: Into<Error>,

Appends a header.

pub fn body(self, body: impl Into<Bytes>) -> Self

Sets the request body. Bodies are buffered; they are sent in full and can be replayed if connection establishment has to be repeated.

pub fn target(self, addr: ScionIpAddr) -> Self

Bypasses DNS resolution: connect to addr, as if resolution had returned exactly this address. The address carries no port — the port always comes from the URL. The URL’s host remains the server name for SNI and certificate validation.

This is the one-element case of targets.

pub fn targets(self, addrs: Vec<ScionIpAddr>) -> Self

Supplies the result of a resolution the caller performed itself: connect to any of addrs, as if DNS had returned exactly this list. The caller asserts the addresses are equivalent servers for the URL’s origin; certificate validation against the URL’s host enforces it.

Like target, the addresses carry no port. The list is sorted and de-duplicated, so element order does not affect connection reuse. It must not be empty.

pub fn request_timeout(self, timeout: Duration) -> Self

Overrides the client’s request timeout for this request.

One deadline covering establishment, the response head, and body collection; raise it for a response the caller will not collect right away (see Response).

pub fn build(self) -> Result<Request, BuildRequestError>

Validates the accumulated state and builds the Request.

Trait Implementations

impl Debug for RequestBuilder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.