示例

在您的 Cargo.toml 文件中添加

[dependencies]
parse_link_header = "0.4"

然后

let link_header = r#"<https://api.github.com/repositories/41986369/contributors?page=2>; rel="next", <https://api.github.com/repositories/41986369/contributors?page=14>; rel="last""#;

let res = parse_link_header::parse(link_header);
assert!(res.is_ok());

let val = res.unwrap();
assert_eq!(val.len(), 2);
assert_eq!(val.get(&Some("next".to_string())).unwrap().raw_uri, "https://api.github.com/repositories/41986369/contributors?page=2");
assert_eq!(val.get(&Some("last".to_string())).unwrap().raw_uri, "https://api.github.com/repositories/41986369/contributors?page=14");

解析值是一个 Result<HashMap<Option<Rel>, Link>, Error>（即一个 LinkMap），其中 Rel 和 Link 是

use std::collections::HashMap;

#[cfg(not(feature = "url"))]
use http::Uri;

#[cfg(feature = "url")]
use url::Url as Uri;

#[derive(Debug, PartialEq)]
pub struct Link {
    pub uri: Uri,
    pub raw_uri: String,
    pub queries: HashMap<String, String>,
    pub params: HashMap<String, String>,
}

type Rel = String;

请注意，根据https://tools.ietf.org/html/rfc8288#section-3.3（2017年10月），rel参数必须存在。这就是为什么HashMap<Option<Rel>, Link>的键是Option<Rel>。因此，如果您发现键是None，请检查您是否指定了rel类型。

parse_with_rel

版本 >= 0.3.0

或者，使用parse_with_rel()函数来获取一个HashMap<String, Link>（即RelLinkMap），如下所示：

let link_header = r#"<https://api.github.com/repositories/41986369/contributors?page=2>; rel="next", <https://api.github.com/repositories/41986369/contributors?page=14>; rel="last""#;

let res = parse_link_header::parse_with_rel(link_header);
assert!(res.is_ok());

let val = res.unwrap();
assert_eq!(val.len(), 2);
assert_eq!(val.get("next").unwrap().raw_uri, "https://api.github.com/repositories/41986369/contributors?page=2");
assert_eq!(val.get("last").unwrap().raw_uri, "https://api.github.com/repositories/41986369/contributors?page=14");

如果您确保头中存在rel参数，则可以使用此函数。

特性: url

版本 >= 0.3.0

如果启用了url功能，结构体parse_link_header::Link中的uri字段将是从url crate的url::Url类型，而不是通常的http::uri::Uri类型。这允许与其他使用url crate的库进行集成，例如reqwest。

注意：这隐式禁用了对相对引用的支持，因为URL不支持相对引用（而URI支持）。

如何贡献

提交一个请求或创建一个问题来描述您的更改或问题。

许可证

MIT @ g1eny0ung