Struct RequestBuilder 

pub struct RequestBuilder { /* private fields */ }

Builds a Request while deferring parsing and serialization errors.

Implementations

impl RequestBuilder

pub async fn enqueue( self, queue: &dyn RequestQueue, ) -> Result<QueueOpInfo, CrawlError>

Builds and adds this request to a queue.

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

Sets the request URL.

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

Sets the HTTP method.

pub fn header(self, name: &str, value: &str) -> Self

Appends a header, deferring validation until Self::build.

pub fn headers(self, headers: HeaderMap) -> Self

Replaces all currently configured headers.

pub fn body(self, body: RequestBody) -> Self

Sets the request body.

pub fn json<T: Serialize>(self, value: &T) -> Self

Serializes and sets a JSON request body.

pub fn form(self, pairs: impl IntoIterator<Item = (String, String)>) -> Self

Sets an ordered form request body.

pub fn label(self, label: impl Into<String>) -> Self

Sets the routing label.

pub fn user_data(self, user_data: UserData) -> Self

Replaces the request’s user data.

pub fn user_data_entry<T: Serialize>( self, key: impl Into<String>, value: &T, ) -> Self

Serializes and inserts an entry into user data.

pub fn max_retries(self, max_retries: u32) -> Self

Sets the per-request retry limit.

pub fn no_retry(self, no_retry: bool) -> Self

Enables or disables retries.

pub fn skip_navigation(self, skip_navigation: bool) -> Self

Controls whether navigation is skipped.

pub fn unique_key(self, unique_key: impl Into<String>) -> Self

Overrides the computed queue deduplication key.

pub fn forefront(self, forefront: bool) -> Self

Controls whether a future queue enqueue places this request at the front.

pub fn is_forefront(&self) -> bool

Returns whether future queue enqueue convenience should use the forefront.

pub fn crawl_depth(self, crawl_depth: u32) -> Self

Sets the discovery depth.

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

Validates this builder and creates a request.

Trait Implementations

impl Debug for RequestBuilder

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

Formats the value using the given formatter.

impl Default for RequestBuilder

fn default() -> RequestBuilder

Returns the “default value” for a type.