Struct qiniu_http::Request

pub struct Request<'r, B: 'r> { /* private fields */ }

HTTP 请求

封装 HTTP 请求相关字段

Implementations

impl<'r, B: Default + 'r> Request<'r, B>

pub fn builder() -> RequestBuilder<'r, B>

创建 HTTP 请求构建器

impl<'r, B: 'r> Request<'r, B>

pub fn body(&self) -> &B

获取请求体

pub fn body_mut(&mut self) -> &mut B

获取请求体的可变引用

Examples found in repository

src/request.rs (line 494)

    pub fn body(&mut self, body: B) -> &mut Self {
        *self.inner.body_mut() = body;
        self
    }

pub fn into_body(self) -> B

转换为 HTTP 请求体

pub fn parts(&self) -> &RequestParts<'r>

获取请求信息

pub fn parts_mut(&mut self) -> &mut RequestParts<'r>

获取请求信息的可变引用

pub fn into_parts_and_body(self) -> (RequestParts<'r>, B)

转换为请求信息和请求体

pub fn from_parts_and_body(parts: RequestParts<'r>, body: B) -> Self

通过请求信息和请求体创建 HTTP 请求

Methods from Deref<Target = RequestParts<'r>>

pub fn url(&self) -> &Uri

获取 HTTP 请求 URL

pub fn url_mut(&mut self) -> &mut Uri

获取 HTTP 请求 URL 的可变引用

Examples found in repository

src/request.rs (line 459)

    pub fn url(&mut self, url: Uri) -> &mut Self {
        *self.inner.url_mut() = url;
        self
    }

pub fn version(&self) -> Version

获取请求 HTTP 版本

pub fn version_mut(&mut self) -> &mut Version

获取请求 HTTP 版本的可变引用

Examples found in repository

src/request.rs (line 473)

    pub fn version(&mut self, version: Version) -> &mut Self {
        *self.inner.version_mut() = version;
        self
    }

pub fn method(&self) -> &Method

获取请求 HTTP 方法

pub fn method_mut(&mut self) -> &mut Method

获取请求 HTTP 方法的可变引用

Examples found in repository

src/request.rs (line 466)

    pub fn method(&mut self, method: Method) -> &mut Self {
        *self.inner.method_mut() = method;
        self
    }

pub fn headers(&self) -> &HeaderMap

获取请求 HTTP Headers

pub fn headers_mut(&mut self) -> &mut HeaderMap

获取请求 HTTP Headers 的可变引用

Examples found in repository

src/request.rs (line 480)

    pub fn headers(&mut self, headers: HeaderMap) -> &mut Self {
        *self.inner.headers_mut() = headers;
        self
    }

    /// 插入请求 HTTP Header
    #[inline]
    pub fn header(&mut self, header_name: impl IntoHeaderName, header_value: impl Into<HeaderValue>) -> &mut Self {
        self.inner.headers_mut().insert(header_name, header_value.into());
        self
    }

pub fn extensions(&self) -> &Extensions

获取扩展信息

pub fn extensions_mut(&mut self) -> &mut Extensions

获取扩展信息的可变引用

Examples found in repository

src/request.rs (line 501)

    pub fn extensions(&mut self, extensions: Extensions) -> &mut Self {
        *self.inner.extensions_mut() = extensions;
        self
    }

    /// 追加扩展信息
    #[inline]
    pub fn add_extension<T: Sync + Send + 'static>(&mut self, val: T) -> &mut Self {
        self.inner.extensions_mut().insert(val);
        self
    }

pub fn user_agent(&self) -> UserAgent

获取 UserAgent

pub fn appended_user_agent(&self) -> &UserAgent

获取追加的 UserAgent

Examples found in repository

src/request.rs (line 132)

    pub fn user_agent(&self) -> UserAgent {
        let mut user_agent = UserAgent::from(FULL_USER_AGENT.as_ref());
        if let Some(lib_user_agent) = LIBRARY_USER_AGENT.get() {
            user_agent.push_str(lib_user_agent);
        }
        user_agent.push_str(self.appended_user_agent().as_str());
        user_agent
    }

pub fn appended_user_agent_mut(&mut self) -> &mut UserAgent

获取追加的 UserAgent 的可变引用

Examples found in repository

src/request.rs (line 515)

    pub fn appended_user_agent(&mut self, user_agent: impl Into<UserAgent>) -> &mut Self {
        *self.inner.appended_user_agent_mut() = user_agent.into();
        self
    }

pub fn resolved_ip_addrs(&self) -> Option<&[IpAddr]>

获取预解析的服务器套接字地址

pub fn resolved_ip_addrs_mut(&mut self) -> &mut Option<Cow<'r, [IpAddr]>>

获取预解析的服务器套接字地址的可变引用

Examples found in repository

src/request.rs (line 522)

    pub fn resolved_ip_addrs(&mut self, resolved_ip_addrs: impl Into<Cow<'r, [IpAddr]>>) -> &mut Self {
        *self.inner.resolved_ip_addrs_mut() = Some(resolved_ip_addrs.into());
        self
    }

pub fn on_uploading_progress(
    &'r self
) -> Option<&'r (dyn Fn(TransferProgressInfo<'_>) -> AnyResult<()> + Send + Sync + 'r)>

获取上传进度回调

pub fn on_uploading_progress_mut(
    &mut self
) -> &mut Option<OnProgressCallback<'r>>

获取上传进度回调的可变引用

Examples found in repository

src/request.rs (line 529)

    pub fn on_uploading_progress(&mut self, f: impl Into<OnProgressCallback<'r>>) -> &mut Self {
        *self.inner.on_uploading_progress_mut() = Some(f.into());
        self
    }

pub fn on_receive_response_status(
    &'r self
) -> Option<&'r (dyn Fn(StatusCode) -> AnyResult<()> + Send + Sync + 'r)>

获取接受到响应状态回调

pub fn on_receive_response_status_mut(
    &mut self
) -> &mut Option<OnStatusCodeCallback<'r>>

获取接受到响应状态回调的可变引用

Examples found in repository

src/request.rs (line 536)

    pub fn on_receive_response_status(&mut self, f: impl Into<OnStatusCodeCallback<'r>>) -> &mut Self {
        *self.inner.on_receive_response_status_mut() = Some(f.into());
        self
    }

pub fn on_receive_response_header(
    &'r self
) -> Option<&'r (dyn Fn(&HeaderName, &HeaderValue) -> AnyResult<()> + Send + Sync + 'r)>

获取接受到响应 Header 回调

pub fn on_receive_response_header_mut(
    &mut self
) -> &mut Option<OnHeaderCallback<'r>>

获取接受到响应 Header 回调的可变引用

Examples found in repository

src/request.rs (line 543)

    pub fn on_receive_response_header(&mut self, f: impl Into<OnHeaderCallback<'r>>) -> &mut Self {
        *self.inner.on_receive_response_header_mut() = Some(f.into());
        self
    }

Trait Implementations

impl<'r, B: Debug + 'r> Debug for Request<'r, B>

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

Formats the value using the given formatter.

impl<'r, B: Default + 'r> Default for Request<'r, B>

fn default() -> Request<'r, B>

Returns the “default value” for a type.

impl<'r, B: 'r> Deref for Request<'r, B>

type Target = RequestParts<'r>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<'r, B: 'r> DerefMut for Request<'r, B>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.