Struct JsonRequestBuilder 

pub struct JsonRequestBuilder<T> { /* private fields */ }

表示通用 JSON 请求构建器。

Implementations

impl<T> JsonRequestBuilder<T>

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

设置整个请求体为一个 serde_json::Value。

pub fn json_body<U>(self, body: &U) -> Result<Self>

where U: Serialize,

使用任意可序列化对象设置请求体。

Errors

当序列化失败时返回错误。

pub fn extra_header( self, key: impl Into<String>, value: impl Into<String>, ) -> Self

添加一个额外请求头。

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

删除一个默认请求头。

pub fn extra_query( self, key: impl Into<String>, value: impl Into<String>, ) -> Self

添加一个额外查询参数。

pub fn extra_body( self, key: impl Into<String>, value: impl Into<JsonPayload>, ) -> Self

在 JSON 根对象中追加字段。

pub fn provider_option( self, key: impl Into<String>, value: impl Into<JsonPayload>, ) -> Self

在 provider 对应的 provider_options 下追加字段。

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

覆盖请求超时时间。

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

覆盖最大重试次数。

pub fn cancellation_token(self, token: CancellationToken) -> Self

设置取消令牌。

pub fn multipart_text( self, name: impl Into<String>, value: impl Into<String>, ) -> Self

添加 Multipart 文本字段。

pub fn multipart_file(self, name: impl Into<String>, file: UploadSource) -> Self

添加 Multipart 文件字段。

impl<T> JsonRequestBuilder<T>

where T: DeserializeOwned,

pub async fn send(self) -> Result<T>

发送请求并返回业务对象。

Errors

当请求失败或反序列化失败时返回错误。

pub async fn send_with_meta(self) -> Result<ApiResponse<T>>

发送请求并保留响应元信息。

Errors

当请求失败或反序列化失败时返回错误。

pub async fn send_raw(self) -> Result<Response<Bytes>>

发送请求并返回原始 http::Response<Bytes>。

Errors

当请求失败时返回错误。

pub async fn send_raw_sse(self) -> Result<RawSseStream>

发送请求并返回原始 SSE 事件流。

该方法会自动追加 Accept: text/event-stream 请求头。

Errors

当请求失败时返回错误。

impl<T> JsonRequestBuilder<T>

where T: DeserializeOwned + Send + 'static,

pub async fn send_sse(self) -> Result<SseStream<T>>

发送请求并把 SSE 数据流解析为指定类型。

该方法会自动追加 Accept: text/event-stream 请求头。

Errors

当请求失败或 SSE 事件反序列化失败时返回错误。

Trait Implementations

impl<T: Clone> Clone for JsonRequestBuilder<T>

fn clone(&self) -> JsonRequestBuilder<T>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug> Debug for JsonRequestBuilder<T>

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

Formats the value using the given formatter.