JSON指针：JSON-P 1.1概述系列

Java EE 8包括对JSON处理API的更新，并使其与JSON的最新IEFT标准保持同步。 他们是：

• JSON指针 （RFC 6901）
• JSON修补程序（RFC 6902）
• JSON合并补丁（RFC 7396）

我将在这个迷你系列中涵盖这些主题。

入门

要开始使用JSON-P，您将需要Maven中央存储库中的以下依赖项。

<dependency>
    <groupId>javax.json</groupId>
    <artifactId>javax.json-api</artifactId>
    <version>1.1</version>
</dependency>

<dependency>
    <groupId>org.glassfish</groupId>
    <artifactId>javax.json</artifactId>
    <version>1.1</version>
</dependency>

JSON指针

JSON指针定义了一个字符串表达式，该表达式引用JSON文档的层次结构内的元素。 使用JSON指针表达式，您可以通过检索，添加，删除和替换表达式引用的元素或值来访问和操作JSON文档。

入口API是javax.json.JsonPointer接口。 通过在javax.json.Json类上调用静态工厂方法createPointer（String expression）并向其传递指针表达式来创建实例。

检索值

如果给定下面的JSON文档，并且您想检索title元素的值，则创建JSON指针表达式/ title 。

{
"title": "Java EE: Only What's New",
"author": "Alex Theedom",
"chapters": [
  "Chapter 1: Java EE 8 What’s New Overview",
  "Chapter 2: Java API for JSON Binding 1.0 (JSR 367)",
  "Chapter 3: Java EE Security API 1.0 (JSR 375)"
],
"released": true,
"pages": 300,
"sourceCode": {
  "repositoryName": "Java-EE-8-Only-Whats-New",
  "url": "github.com/readlearncode/"
},
"otherBooks": [
  {
    "title": "Professional Java EE Design Patterns",
    "length": 350
  }
]
}

JsonObject jsonObject = ... create JSONObject from JSON document ...;

下面的代码段创建一个JsonPointer并引用title元素。 然后，它将调用getValue（）方法，该方法将传递给JsonObject进行查询。

JsonValue jsonValue = Json.createPointer("/title").getValue(jsonObject);

增值

要向JSON文档添加（或插入）值，请遵循与检索相同的逻辑，即使用JSON指针表达式来标识文档内的插入点。 以下代码段将新的“类别”：“编程” JSON对象添加到文档的根目录。

JsonObject jsonObject = Json
      .createPointer("/category")
      .add(jsonObject, Json.createValue("Programming"));

返回的JsonObject是整个新的修改对象。

删除值

删除过程要求删除要表示为JSON指针表达式的值的位置。 下面的代码片段删除了title元素，并将修改后的JSON文档作为JsonStructure实例返回。

JsonStructure jsonStructure = Json.createPointer("/title").remove(jsonObject);

替换值

要替换一个值，要替换的元素的JSON指针表达式将替换的元素传递给replace（）方法。 下面的代码片段替换了title元素的值并返回修改后的JSON文档。

JsonStructure jsonStructure = Json
     .createPointer("/title")
     .replace(jsonObject, Json.createValue("Java EE 8"));

测试一个值

可以使用containsValue（）方法测试某个位置值的存在。 下面的代码段进行测试，以查看在JSON指针表达式/ doesNotExist表示的位置是否有一个值。

Boolean containsValue = Json
     .createPointer("/doesNotExist")
     .containsValue(jsonObject);

结论

好了，这就是本迷你系列中有关JSON处理的新功能的第一篇文章。 目前为止就这样了。

翻译自: https://www.javacodegeeks.com/2018/04/get-to-know-json-pointer-json-p-1-1-overview-series.html