Rust唯一ID生成库cuid2的使用指南

介绍

cuid2是一个高性能、可排序且安全的分布式唯一标识符生成库，专为Rust设计。它生成的ID具有以下特点：

• 唯一性：极低的碰撞概率
• 可排序性：按时间大致有序
• 安全性：不包含敏感信息
• 分布式友好：无需中央协调

安装

在Cargo.toml中添加依赖：

[dependencies]
cuid2 = "0.3"

基本使用

生成ID

use cuid2;

fn main() {
    // 生成一个默认长度的CUID2 ID
    let id = cuid2::create_id();
    println!("Generated ID: {}", id);
}

自定义配置

use cuid2::{CuidConstructor, Length};

fn main() {
    // 创建一个自定义长度的ID生成器
    let constructor = CuidConstructor::new().with_length(Length::Long);
    
    // 生成ID
    let id = constructor.create_id();
    println!("Long ID: {}", id);
}

高级用法

使用自定义随机数生成器

use cuid2::{CuidConstructor, Length};
use rand::thread_rng;

fn main() {
    let constructor = CuidConstructor::new()
        .with_rng(thread_rng())
        .with_length(Length::Short);
    
    let id = constructor.create_id();
    println!("Short ID with custom RNG: {}", id);
}

批量生成ID

use cuid2;

fn generate_ids(count: usize) -> Vec<String> {
    (0..count).map(|_| cuid2::create_id()).collect()
}

fn main() {
    let ids = generate_ids(5);
    println!("Batch IDs: {:?}", ids);
}

性能考虑

cuid2设计为高性能ID生成器，但在极高吞吐量场景下，可以考虑重用生成器实例：

use cuid2::CuidConstructor;

fn main() {
    let constructor = CuidConstructor::new();
    
    // 在循环中重用生成器
    for _ in 0..1000 {
        let id = constructor.create_id();
        // 使用ID...
    }
}

安全提示

cuid2生成的ID不包含敏感信息，可以安全地在日志和URL中使用：

use cuid2;

fn create_secure_url() -> String {
    let id = cuid2::create_id();
    format!("https://example.com/resource/{}", id)
}

fn main() {
    println!("Secure URL: {}", create_secure_url());
}

完整示例

这是一个结合了基本使用和高级用法的完整示例：

use cuid2::{CuidConstructor, Length};
use rand::thread_rng;

fn main() {
    // 基本用法 - 生成默认ID
    let default_id = cuid2::create_id();
    println!("Default ID: {}", default_id);

    // 自定义长度
    let constructor = CuidConstructor::new()
        .with_length(Length::Long);
    let long_id = constructor.create_id();
    println!("Long ID: {}", long_id);

    // 使用自定义随机数生成器
    let custom_rng = CuidConstructor::new()
        .with_rng(thread_rng())
        .with_length(Length::Short);
    let short_id = custom_rng.create_id();
    println!("Short ID with custom RNG: {}", short_id);

    // 批量生成ID
    let ids: Vec<String> = (0..5).map(|_| cuid2::create_id()).collect();
    println!("Batch IDs: {:?}", ids);

    // 性能优化 - 重用生成器
    let optimized_constructor = CuidConstructor::new();
    let optimized_ids: Vec<String> = (0..10).map(|_| optimized_constructor.create_id()).collect();
    println!("Optimized generation: {:?}", optimized_ids);

    // 安全使用 - 在URL中
    let secure_url = format!("https://api.example.com/users/{}", cuid2::create_id());
    println!("Secure API URL: {}", secure_url);
}

cuid2是分布式系统中生成唯一标识符的优秀选择，特别适合需要可排序ID且不透露系统内部信息的场景。