Rust JSON查询与处理库jaq-json的使用指南

jaq-json 是一个轻量级的 Rust JSON 查询和处理库，提供了高效的方式来解析和操作 JSON 数据。它特别适合需要快速查询和转换 JSON 数据的场景。

主要特性

• 轻量级且高效
• 支持类似jq的查询语法
• 零拷贝解析
• 易于使用的API

安装方法

在Cargo.toml中添加依赖：

[dependencies]
jaq-json = "0.5"

基本使用方法

1. 解析JSON字符串

use jaq_json::{parse, Val};

fn main() {
    let json_str = r#"{"name": "Alice", "age": 30, "hobbies": ["reading", "hiking"]}"#;
    
    let json_value = parse(json_str).unwrap();
    
    println!("Parsed JSON: {:?}", json_value);
}

2. 查询JSON数据

jaq-json支持类似jq的查询语法：

use jaq_json::{parse, query};

fn main() {
    let json_str = r#"{
        "users": [
            {"name": "Alice", "age": 30},
            {"name": "Bob", "age": 25}
        ]
    }"#;
    
    let json_value = parse(json_str).unwrap();
    
    // 查询所有用户名
    let names = query(".users[].name", &json_value).unwrap();
    println!("User names: {:?}", names);
    
    // 查询年龄大于28的用户
    let adults = query(".users[] | select(.age > 28)", &json_value).unwrap();
    println!("Adult users: {:?}", adults);
}

3. 修改JSON数据

use jaq_json::{parse, Val};

fn main() {
    let mut json_value = parse(r#"{"name": "Alice", "age": 30}"#).unwrap();
    
    // 修改字段值
    if let Val::Object(map) = &mut json_value {
        map.insert("age".to_string(), Val::Num(31.0));
    }
    
    println!("Updated JSON: {:?}", json_value);
}

4. 创建新JSON

use jaq_json::Val;

fn main() {
    let mut new_json = Val::Object(Default::default());
    
    if let Val::Object(map) = &mut new_json {
        map.insert("name".to_string(), Val::Str("Charlie".to_string()));
        map.insert("age".to_string(), Val::Num(28.0));
        map.insert("active".to_string(), Val::Bool(true));
    }
    
    println!("New JSON: {:?}", new_json);
}

高级查询示例

复杂查询

use jaq_json::{parse, query};

fn main() {
    let json_str = r#"{
        "store": {
            "books": [
                {"title": "Rust in Action", "price": 39.99, "stock": 5},
                {"title": "The Rust Programming Language", "price": 29.99, "stock": 10},
                {"title": "Zero to Production in Rust", "price": 34.99, "stock": 2}
            ]
        }
    }"#;
    
    let json_value = parse(json_str).unwrap();
    
    // 查询库存少于5本的书籍标题和价格
    let low_stock = query(".store.books[] | select(.stock < 5) | {title, price}", &json_value).unwrap();
    println!("Low stock books: {:?}", low_stock);
    
    // 计算所有书籍的总价值
    let total_value = query("[.store.books[] | .price * .stock] | add", &json_value).unwrap();
    println!("Total inventory value: {:?}", total_value);
}

性能提示

1. 对于大型JSON数据，考虑使用流式解析
2. 重复使用的查询可以预编译
3. 对于只读操作，使用不可变引用

jaq-json 是一个强大而灵活的工具，特别适合需要在Rust中高效处理JSON数据的场景。它的查询语法与jq兼容，使得从其他语言迁移过来的开发者能够快速上手。

完整示例demo

下面是一个完整的示例，展示了jaq-json的主要功能：

use jaq_json::{parse, query, Val};

fn main() {
    // 示例1: 解析JSON字符串
    let json_str = r#"{
        "company": "TechCorp",
        "employees": [
            {"id": 1, "name": "Alice", "department": "Engineering", "salary": 85000},
            {"id": 2, "name": "Bob", "department": "Marketing", "salary": 75000},
            {"id": 3, "name": "Charlie", "department": "Engineering", "salary": 90000}
        ],
        "locations": ["New York", "San Francisco", "Austin"]
    }"#;
    
    // 解析JSON
    let json_value = parse(json_str).unwrap();
    println!("Parsed JSON:\n{:#?}\n", json_value);
    
    // 示例2: 基本查询
    // 查询所有员工姓名
    let names = query(".employees[].name", &json_value).unwrap();
    println!("All employee names: {:?}\n", names);
    
    // 查询工程部门的员工
    let engineers = query(".employees[] | select(.department == \"Engineering\")", &json_value).unwrap();
    println!("Engineering department employees: {:#?}\n", engineers);
    
    // 示例3: 复杂查询
    // 查询高薪员工(工资>80000)的姓名和部门
    let high_earners = query(".employees[] | select(.salary > 80000) | {name, department}", &json_value).unwrap();
    println!("High earning employees: {:#?}\n", high_earners);
    
    // 计算平均工资
    let avg_salary = query("[.employees[] | .salary] | add / length", &json_value).unwrap();
    println!("Average salary: {:?}\n", avg_salary);
    
    // 示例4: 修改JSON数据
    let mut json_value = json_value;
    if let Val::Object(ref mut map) = json_value {
        // 添加新字段
        map.insert("founded_year".to_string(), Val::Num(2010.0));
        
        // 修改现有字段
        if let Some(Val::Array(ref mut employees)) = map.get_mut("employees") {
            if let Some(Val::Object(ref mut first_employee)) = employees.get_mut(0) {
                first_employee.insert("salary".to_string(), Val::Num(88000.0));
            }
        }
    }
    println!("Modified JSON:\n{:#?}\n", json_value);
    
    // 示例5: 创建新JSON
    let mut new_json = Val::Object(Default::default());
    if let Val::Object(ref mut map) = new_json {
        map.insert("product".to_string(), Val::Str("jaq-json".to_string()));
        map.insert("version".to_string(), Val::Num(0.5));
        map.insert("features".to_string(), Val::Array(vec![
            Val::Str("jq-like syntax".to_string()),
            Val::Str("zero-copy".to_string()),
            Val::Str("high performance".to_string())
        ]));
    }
    println!("Newly created JSON:\n{:#?}", new_json);
}

这个完整示例展示了：

1. JSON字符串的解析
2. 基本查询操作
3. 复杂查询和过滤
4. JSON数据的修改
5. 新JSON对象的创建

每个操作都有清晰的注释说明，可以直接运行测试jaq-json的各种功能。