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

• JSON指針 RFC 6901
• JSON補(bǔ)丁 RFC 6902
• JSON合并修補(bǔ)程序RFC 7396

我將在這個(gè)迷你系列中涵蓋這些主題。

入門(mén)

要開(kāi)始使用JSON-P，您將需要Maven中央存儲(chǔ)庫(kù)中的以下依賴項(xiàng)。

<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補(bǔ)丁

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

JsonPatchBuilder接口是該API的網(wǎng)關(guān)，并且是通過(guò)Json類(lèi)中的靜態(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ù)組的第一個(gè)元素的值替換為Chapter 1：Introduction的值。

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

apply（）方法返回JsonStructure類(lèi)的實(shí)例。

添加和刪??除操作

JSON補(bǔ)丁的主要功能是能夠?qū)⒍鄠€(gè)操作鏈接在一起，并將其順序應(yīng)用于先前補(bǔ)丁結(jié)果的結(jié)果。 如果在修補(bǔ)操作期間引發(fā)異常，它將停止操作，并且不會(huì)對(duì)原始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í)要在其中插入新數(shù)據(jù)的元素。 第二個(gè)元素是要插入的新數(shù)據(jù)。

要?jiǎng)h除元素，請(qǐng)將要?jiǎng)h除的元素的JSON指針傳遞給remove（）方法。

移動(dòng)和復(fù)制操作

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

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

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

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

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

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

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

測(cè)試操作

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

在代碼段中，對(duì)元素/ pages進(jìn)行了測(cè)試。 如果其值為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概述系列的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

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