Java EE 8包括對JSON處理API的更新，并使其與JSON的最新IEFT標(biāo)準(zhǔn)保持同步。 他們是：

• 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修補程序表示要應(yīng)用于目標(biāo)JSON文檔的一系列操作。 這些操作以JSON-Pointer表示法格式化，并且可以執(zhí)行： 添加 ， 復(fù)制 ， 移動 ， 刪除 ， 替換和測試操作。

JsonPatchBuilder接口是該API的網(wǎng)關(guān)，并且是通過Json類中的靜態(tài)方法createPatchBuilder（）創(chuàng)建的。 JSON指針表達(dá)式傳遞到一種操作方法，并應(yīng)用于JSON文檔。

替換操作

替換操作由replace（）方法執(zhí)行，并將要替換的元素的位置傳遞給它（表示為JSON指針表達(dá)式）和替換值。

{ "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 ...;

在下面的代碼段中（在上面的JSON文檔中），使用JSON指針表達(dá)式/ chapters / 0表示的chapters數(shù)組的第一個元素的值替換為Chapter 1：Introduction的值。

JsonPatchBuilder builder = Json.createPatchBuilder();JsonPatch jsonPatch = builder.replace("/chapters/0", "Chapter 1: Introduction").build();JsonObject newJsonObject = jsonPatch.apply(jsonObject);

apply（）方法返回JsonStructure類的實例。

添加和刪??除操作

JSON補丁的主要功能是能夠?qū)⒍鄠€操作鏈接在一起，并將其順序應(yīng)用于先前補丁結(jié)果的結(jié)果。 如果在修補操作期間引發(fā)異常，它將停止操作，并且不會對原始JSON文檔進(jìn)行任何更改。

下面的代碼示例顯示了如何在JSON文檔中添加和刪除元素。

JsonObject newJsonObject = Json.createPatchBuilder().add("/chapters/3", "Chapter 4: Servlets 4.0").remove("/released").build().apply(jsonObject);

add（）方法采用JSON指針表達(dá)式，該表達(dá)式標(biāo)識要在其中插入新數(shù)據(jù)的元素。 第二個元素是要插入的新數(shù)據(jù)。

要刪除元素，請將要刪除的元素的JSON指針傳遞給remove（）方法。

移動和復(fù)制操作

移動操作需要兩個JSON指針表達(dá)式：

• 一個元素移動，
• 一個用于將值移動到的目標(biāo)位置。

目標(biāo)位置必須已經(jīng)存在，并且遵循與添加操作相同的邏輯，從這個意義上說，目標(biāo)位置是通過將元素移動到指定位置來將其移動。 有效地將所有元素下移一個位置。

復(fù)制操作將一個元素的值替換為另一個元素的值。 此操作還需要兩個JSON指針表達(dá)式：一個用于源值，一個用于目標(biāo)位置。

下面的代碼片段將三個操作鏈接在一起：兩個移動操作和一個復(fù)制操作。

JsonObject newJsonObject = Json.createPatchBuilder().move("/chapters/0", "/chapters/2").move("/chapters/2", "/chapters/1").copy("/otherBooks/0/length", "/pages").build().apply(jsonObject);

移動操作將位于章數(shù)組第三位置的值移動到第一位置，然后將第二位置的元素移動到第三位置。 復(fù)制操作會將 pages鍵的值復(fù)制到otherBooks數(shù)組中第一個元素的length鍵。

測試操作

測試操作確定是否在JSON文檔中設(shè)置了指定的值。 如果測試失敗，補丁操作將停止，否則它將繼續(xù)并完成剩余的操作。

在代碼段中，對元素/ pages進(jìn)行了測試。 如果其值為300，則復(fù)制操作將繼續(xù)，否則將拋出JsonException 。

JsonObject newJsonObject = Json.createPatchBuilder().test("/pages", 300).copy("/otherBooks/0/length", "/pages") // destination, source.build().apply(jsonObject);

結(jié)論

好了，這就是本微型系列文章的第二篇有關(guān)JSON處理的新功能。

目前為止就這樣了。

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

總結(jié)

以上是生活随笔為你收集整理的认识JSON补丁：JSON-P 1.1概述系列的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。