Enum LocationPatternKind

Source

pub enum LocationPatternKind {
    Exact = 0,
    Prefix = 1,
    Regex = 2,
    NormalPrefix = 3,
    Common = 4,
}

Expand description

位置模式类型，类似 Nginx location 配置

§示例

use dhttp_access::pattern::{LocationPattern, LocationPatternKind};

// 精确匹配
let pattern: LocationPattern = "= /api/v1".parse().unwrap();
assert_eq!(pattern.kind(), &LocationPatternKind::Exact);
assert!(pattern.is_match("/api/v1"));
assert!(!pattern.is_match("/api/v1/users"));

// 字面量前缀匹配
let pattern: LocationPattern = "^~ /static/".parse().unwrap();
assert_eq!(pattern.kind(), &LocationPatternKind::Prefix);
assert!(pattern.is_match("/static/css/style.css"));
assert!(!pattern.is_match("/images/logo.png"));

// 正则表达式匹配
let pattern: LocationPattern = r"~ ^/api/\d+$".parse().unwrap();
assert_eq!(pattern.kind(), &LocationPatternKind::Regex);
assert!(pattern.is_match("/api/123"));
assert!(!pattern.is_match("/api/abc"));

// 普通前缀匹配
let pattern: LocationPattern = "/uploads".parse().unwrap();
assert_eq!(pattern.kind(), &LocationPatternKind::NormalPrefix);
assert!(pattern.is_match("/uploads/file.jpg"));

// 通用匹配（根路径）
let pattern: LocationPattern = "/".parse().unwrap();
assert_eq!(pattern.kind(), &LocationPatternKind::Common);
assert!(pattern.is_match("/anything"));

Variants§

§

Exact = 0

精确匹配 - 语法：= pattern

§Examples

use dhttp_access::pattern::{LocationPattern, LocationPatternKind};

let pattern: LocationPattern = "= /home".parse().unwrap();
assert!(matches!(pattern.kind(), LocationPatternKind::Exact));
assert!(pattern.is_match("/home"));
assert!(!pattern.is_match("/home/"));
assert!(!pattern.is_match("/home/user"));

§

Prefix = 1

字面量前缀匹配 - 语法：^~ pattern

§Examples

use dhttp_access::pattern::{LocationPattern, LocationPatternKind};

let pattern: LocationPattern = "^~ /api".parse().unwrap();
assert!(matches!(pattern.kind(), LocationPatternKind::Prefix));
assert!(pattern.is_match("/api"));
assert!(pattern.is_match("/api/"));
assert!(pattern.is_match("/api/users"));
assert!(!pattern.is_match("/app"));

§

Regex = 2

正则表达式匹配 - 语法：~ regex 或 ~* regex (不区分大小写)

§Examples

use dhttp_access::pattern::{LocationPattern, LocationPatternKind};

// 区分大小写的正则
let pattern: LocationPattern = "~ /api/\\d+".parse().unwrap();
assert!(matches!(pattern.kind(), LocationPatternKind::Regex));
assert!(pattern.is_match("/api/123"));
assert!(!pattern.is_match("/API/123"));

// 不区分大小写的正则
let pattern: LocationPattern = "~* /api/\\d+".parse().unwrap();
assert!(pattern.is_match("/api/123"));
assert!(pattern.is_match("/API/123"));

§

NormalPrefix = 3

普通前缀匹配 - 语法：/xxx (以 / 开头的路径)

§Examples

use dhttp_access::pattern::{LocationPattern, LocationPatternKind};

let pattern: LocationPattern = "/admin".parse().unwrap();
assert!(matches!(pattern.kind(), LocationPatternKind::NormalPrefix));
assert!(pattern.is_match("/admin"));
assert!(pattern.is_match("/admin/"));
assert!(pattern.is_match("/admin/users"));
assert!(!pattern.is_match("/app"));

§

Common = 4

通用匹配 - 语法：/ (根路径)

§Examples

use dhttp_access::pattern::{LocationPattern, LocationPatternKind};

let pattern: LocationPattern = "/".parse().unwrap();
assert!(matches!(pattern.kind(), LocationPatternKind::Common));
assert!(pattern.is_match("/"));
assert!(pattern.is_match("/anything"));
assert!(pattern.is_match("/deeply/nested/path"));