Struct qiniu_http::Response

impl<B: Default> Response

pub fn builder() -> ResponseBuilder

返回 HTTP 响应构建器

impl Response

pub fn body(&self) -> &B

获取 HTTP 响应体

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

获取 HTTP 响应体的可变引用

Examples found in repository ?

src/response.rs (line 501)

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

pub fn parts(&self) -> &ResponseParts

HTTP 响应信息

pub fn parts_mut(&mut self) -> &mut ResponseParts

获取 HTTP 响应信息的可变引用

pub fn into_body(self) -> B

转换为 HTTP 响应体

pub fn into_parts_and_body(self) -> (ResponseParts, B)

转换为响应信息和响应体

Examples found in repository ?

src/response.rs (line 384)

    pub fn map_body<B2>(self, f: impl FnOnce(B) -> B2) -> Response<B2> {
        let (parts, body) = self.into_parts_and_body();
        let body = f(body);
        Response::from_parts_and_body(parts, body)
    }

    /// 尝试对 HTTP 响应体进行映射
    #[inline]
    pub fn try_map_body<B2, E>(
        self,
        f: impl FnOnce(B) -> result::Result<B2, E>,
    ) -> result::Result<Response<B2>, MapError<E>> {
        let (parts, body) = self.into_parts_and_body();
        match f(body) {
            Ok(body) => Ok(Response::from_parts_and_body(parts, body)),
            Err(err) => Err(MapError::new(err, parts)),
        }
    }

    /// 尝试对 HTTP 响应体进行异步映射
    #[inline]
    #[cfg(feature = "async")]
    pub async fn try_async_map_body<B2, E, F, Fut>(self, f: F) -> result::Result<Response<B2>, MapError<E>>
    where
        F: FnOnce(B) -> Fut,
        Fut: Future<Output = result::Result<B2, E>>,
    {
        let (parts, body) = self.into_parts_and_body();
        match f(body).await {
            Ok(body) => Ok(Response::from_parts_and_body(parts, body)),
            Err(err) => Err(MapError::new(err, parts)),
        }
    }

pub fn from_parts_and_body(parts: ResponseParts, body: B) -> Self

通过响应信息和响应体创建 HTTP 响应

Examples found in repository ?

src/response.rs (line 386)

    pub fn map_body<B2>(self, f: impl FnOnce(B) -> B2) -> Response<B2> {
        let (parts, body) = self.into_parts_and_body();
        let body = f(body);
        Response::from_parts_and_body(parts, body)
    }

    /// 尝试对 HTTP 响应体进行映射
    #[inline]
    pub fn try_map_body<B2, E>(
        self,
        f: impl FnOnce(B) -> result::Result<B2, E>,
    ) -> result::Result<Response<B2>, MapError<E>> {
        let (parts, body) = self.into_parts_and_body();
        match f(body) {
            Ok(body) => Ok(Response::from_parts_and_body(parts, body)),
            Err(err) => Err(MapError::new(err, parts)),
        }
    }

    /// 尝试对 HTTP 响应体进行异步映射
    #[inline]
    #[cfg(feature = "async")]
    pub async fn try_async_map_body<B2, E, F, Fut>(self, f: F) -> result::Result<Response<B2>, MapError<E>>
    where
        F: FnOnce(B) -> Fut,
        Fut: Future<Output = result::Result<B2, E>>,
    {
        let (parts, body) = self.into_parts_and_body();
        match f(body).await {
            Ok(body) => Ok(Response::from_parts_and_body(parts, body)),
            Err(err) => Err(MapError::new(err, parts)),
        }
    }

pub fn map_body<B2>(self, f: impl FnOnce(B) -> B2) -> Response<B2>

对 HTTP 响应体进行映射

pub fn try_map_body<B2, E>(
self,
f: impl FnOnce(B) -> Result<B2, E>
) -> Result<Response<B2>, MapError<E>>

尝试对 HTTP 响应体进行映射

pub async fn try_async_map_body<B2, E, F, Fut>(
 self,
 f: F
) -> Result<Response<B2>, MapError<E>>where
 F: FnOnce(B) -> Fut,
 Fut: Future<Output = Result<B2, E>>,

尝试对 HTTP 响应体进行异步映射

Methods from Deref<Target = ResponseParts>§

pub fn status_code(&self) -> StatusCode

获取 HTTP 状态码

pub fn status_code_mut(&mut self) -> &mut StatusCode

获取 HTTP 状态码的可变引用

Examples found in repository ?

src/response.rs (line 452)

    pub fn status_code(&mut self, status_code: StatusCode) -> &mut Self {
        *self.inner.status_code_mut() = status_code;
        self
    }

pub fn headers(&self) -> &HeaderMap

获取 HTTP Headers

Examples found in repository ?

src/response.rs (line 265)

264
265
266

    pub fn header(&self, header_name: impl AsHeaderName) -> Option<&HeaderValue> {
        self.headers().get(header_name)
    }

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

获取 HTTP Headers 的可变引用

Examples found in repository ?

src/response.rs (line 459)

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

    /// 设置 HTTP 版本
    #[inline]
    pub fn version(&mut self, version: Version) -> &mut Self {
        *self.inner.version_mut() = version;
        self
    }

    /// 设置 HTTP 服务器 IP 地址
    #[inline]
    pub fn server_ip(&mut self, server_ip: IpAddr) -> &mut Self {
        *self.inner.info.server_ip_mut() = Some(server_ip);
        self
    }

    /// 设置 HTTP 服务器端口号
    #[inline]
    pub fn server_port(&mut self, server_port: NonZeroU16) -> &mut Self {
        *self.inner.info.server_port_mut() = Some(server_port);
        self
    }

    /// 设置扩展信息
    #[inline]
    pub fn extensions(&mut self, extensions: Extensions) -> &mut Self {
        *self.inner.extensions_mut() = extensions;
        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 version(&self) -> Version

获取 HTTP 版本

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

获取 HTTP 版本的可变引用

Examples found in repository ?

src/response.rs (line 466)

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

pub fn extensions(&self) -> &Extensions

获取扩展信息

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

获取扩展信息的可变引用

Examples found in repository ?

src/response.rs (line 487)

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

获取 HTTP 响应 Header

pub fn server_ip(&self) -> Option<IpAddr>

获取 HTTP 服务器 IP 地址

pub fn server_ip_mut(&mut self) -> &mut Option<IpAddr>

获取 HTTP 服务器 IP 地址的可变引用

pub fn server_port(&self) -> Option<NonZeroU16>

获取 HTTP 服务器端口号

pub fn server_port_mut(&mut self) -> &mut Option<NonZeroU16>

获取 HTTP 服务器端口号的可变引用

pub fn metrics(&self) -> Option<&Metrics>

获取 HTTP 响应的指标信息

pub fn metrics_mut(&mut self) -> &mut Option<Metrics>

获取 HTTP 响应的指标信息的可变引用

Examples found in repository ?

src/response.rs (line 508)

    pub fn metrics(&mut self, metrics: Metrics) -> &mut Self {
        *self.inner.metrics_mut() = Some(metrics);
        self
    }

Trait Implementations§

impl<B: Debug> Debug for Response

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

Formats the value using the given formatter. Read more

impl<B: Default> Default for Response

fn default() -> Response

Returns the “default value” for a type. Read more

impl Deref for Response

type Target = ResponseParts

The resulting type after dereferencing.

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

Dereferences the value.

impl DerefMut for Response

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

Mutably dereferences the value.

Auto Trait Implementations§

impl !UnwindSafe for Response

Blanket Implementations§

impl<T> Any for Twhere
T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Borrow<T> for Twhere
T: ?Sized,

const: unstable · source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for Twhere
T: ?Sized,

const: unstable · source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> From<T> for T

const: unstable · source§

fn from(t: T) -> T

Returns the argument unchanged.

impl<T, U> Into for Twhere
U: From<T>,

const: unstable · source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T, U> TryFrom for Twhere
U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source§

fn try_from(value: U) -> Result<T, <T as TryFrom>::Error>

Performs the conversion.

impl<T, U> TryInto for Twhere
U: TryFrom<T>,