Rust矩阵标识符验证库ruma-identifiers-validation的使用：高效处理Matrix协议中的房间ID、用户ID等标识符验证

安装

在项目目录中运行以下Cargo命令：

cargo add ruma-identifiers-validation

或者在Cargo.toml中添加以下行：

ruma-identifiers-validation = "0.10.1"

示例代码

以下是使用ruma-identifiers-validation库验证Matrix协议中房间ID和用户ID的完整示例：

use ruma_identifiers_validation::{RoomIdValidation, UserIdValidation};

fn main() {
    // 验证用户ID
    let user_id = "@alice:matrix.org";
    match UserIdValidation::validate(user_id) {
        Ok(_) => println!("用户ID {} 是有效的", user_id),
        Err(e) => println!("用户ID验证失败: {}", e),
    }

    // 验证房间ID
    let room_id = "!room123:matrix.org";
    match RoomIdValidation::validate(room_id) {
        Ok(_) => println!("房间ID {} 是有效的", room_id),
        Err(e) => println!("房间ID验证失败: {}", e),
    }

    // 更复杂的示例 - 批量验证
    let identifiers = vec![
        "@bob:example.com",
        "!invalid-room",
        "@invalid:user:domain",
        "!room456:example.com",
    ];

    for id in identifiers {
        if id.starts_with('@') {
            match UserIdValidation::validate(id) {
                Ok(_) => println!("✅ 有效的用户ID: {}", id),
                Err(_) => println!("❌ 无效的用户ID: {}", id),
            }
        } else if id.starts_with('!') {
            match RoomIdValidation::validate(id) {
                Ok(_) => println!("✅ 有效的房间ID: {}", id),
                Err(_) => println!("❌ 无效的房间ID: {}", id),
            }
        } else {
            println!("⚠️ 未知标识符格式: {}", id);
        }
    }
}

完整示例代码

下面是一个更完整的示例，展示如何在实际应用中使用ruma-identifiers-validation库：

use ruma_identifiers_validation::{RoomIdValidation, UserIdValidation};
use std::io;

fn main() {
    println!("Matrix标识符验证工具");
    println!("请选择操作:");
    println!("1. 验证单个用户ID");
    println!("2. 验证单个房间ID");
    println!("3. 批量验证标识符");
    println!("4. 退出");

    loop {
        let mut choice = String::new();
        io::stdin()
            .read_line(&mut choice)
            .expect("读取输入失败");

        match choice.trim() {
            "1" => validate_user_id(),
            "2" => validate_room_id(),
            "3" => batch_validate(),
            "4" => break,
            _ => println!("无效的选择，请重新输入"),
        }
    }
}

fn validate_user_id() {
    println!("请输入要验证的用户ID (格式: @username:domain.com):");
    let mut user_id = String::new();
    io::stdin()
        .read_line(&mut user_id)
        .expect("读取输入失败");
    let user_id = user_id.trim();

    match UserIdValidation::validate(user_id) {
        Ok(_) => println!("✅ 用户ID {} 有效", user_id),
        Err(e) => println!("❌ 验证失败: {}", e),
    }
}

fn validate_room_id() {
    println!("请输入要验证的房间ID (格式: !roomid:domain.com):");
    let mut room_id = String::new();
    io::stdin()
        .read_line(&mut room_id)
        .expect("读取输入失败");
    let room_id = room_id.trim();

    match RoomIdValidation::validate(room_id) {
        Ok(_) => println!("✅ 房间ID {} 有效", room_id),
        Err(e) => println!("❌ 验证失败: {}", e),
    }
}

fn batch_validate() {
    println!("请输入要验证的标识符列表，用逗号分隔:");
    let mut input = String::new();
    io::stdin()
        .read_line(&mut input)
        .expect("读取输入失败");
    
    let identifiers: Vec<&str> = input.split(',').map(|s| s.trim()).collect();

    println!("验证结果:");
    for id in identifiers {
        if id.starts_with('@') {
            match UserIdValidation::validate(id) {
                Ok(_) => println!("✅ 有效的用户ID: {}", id),
                Err(_) => println!("❌ 无效的用户ID: {}", id),
            }
        } else if id.starts_with('!') {
            match RoomIdValidation::validate(id) {
                Ok(_) => println!("✅ 有效的房间ID: {}", id),
                Err(_) => println!("❌ 无效的房间ID: {}", id),
            }
        } else {
            println!("⚠️ 未知标识符格式: {}", id);
        }
    }
}

功能说明

ruma-identifiers-validation库提供了以下功能：

• 验证Matrix协议中的用户ID格式（如@user:domain.com）
• 验证Matrix协议中的房间ID格式（如!room123:domain.com）
• 支持本地和服务器部分验证
• 提供详细的错误信息

许可

该库采用MIT许可证发布。