json-pointer

一个用于解析和使用JSON指针的crate，如RFC 6901中指定。与内置在serde_json中的pointer方法不同，此方法在使用前验证JSON指针，并处理URI片段标识符表示。

创建JSON指针

JSON指针可以用字面量[&str]创建，或者从String解析。

let from_strs = JsonPointer::new([
    "foo",
    "bar",
]);
let parsed = "/foo/bar".parse::<JsonPointer<_, _>>().unwrap();

assert_eq!(from_strs.to_string(), parsed.to_string());
}

使用JSON指针

JsonPointer类型提供了.get()和.get_mut()，分别用于获取适当的值和可变引用。

let ptr = "/foo/bar".parse::<JsonPointer<_, _>>().unwrap();

let document = json!({
    "foo": {
        "bar": 0,
        "baz": 1,
    },
    "quux": "xyzzy"
});

let indexed = ptr.get(&document).unwrap();

assert_eq!(indexed, &json!(0));

URI片段标识符表示

JSON指针可以嵌入URI的片段部分。这也是为什么大多数JSON指针库在JSON指针的开始处需要一个#字符。这个crate会检测开头的#作为在URI片段标识符表示中解析的指示器。请注意，这意味着这个crate不支持解析完整的URI。

let str_ptr = "/f%o".parse::<JsonPointer<_, _>>().unwrap();
let uri_ptr = "#/f%25o".parse::<JsonPointer<_, _>>().unwrap();

assert_eq!(str_ptr, uri_ptr);