Struct Host 

pub struct Host(pub String);

Host extractor

从 HTTP 请求中提取 Host 信息，兼容 HTTP/1.x 和 HTTP/2

工作原理

• HTTP/1.x: 从 Host header 中读取
• HTTP/2: 优先从 :authority pseudo-header 读取，回退到 Host header

示例

use axum::{Router, routing::get};
use axum_bootstrap::util::extractor::Host;

async fn show_host(Host(host): Host) -> String {
    format!("Your host is: {}", host)
}

let app = Router::new().route("/", get(show_host));

错误处理

如果请求中没有 Host 信息，将返回 500 错误

可选 Host 提取

如果你希望 Host 是可选的（不存在时不报错），可以使用 Option<Host>：

use axum::{Router, routing::get};
use axum_bootstrap::util::extractor::Host;

async fn show_host(host: Option<Host>) -> String {
    match host {
        Some(Host(h)) => format!("Your host is: {}", h),
        None => "No host provided".to_string(),
    }
}

let app = Router::new().route("/", get(show_host));

Tuple Fields

0: String

Trait Implementations

impl Clone for Host

fn clone(&self) -> Host

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Host

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

Formats the value using the given formatter.

impl<S> FromRequestParts<S> for Host

where S: Send + Sync,

type Rejection = AppError

If the extractor fails it’ll use this “rejection” type. A rejection is a kind of error that can be converted into a response.

async fn from_request_parts( parts: &mut Parts, _state: &S, ) -> Result<Self, Self::Rejection>

Perform the extraction.