2.8. 使用 JSON API 进行 JSON 处理(JSON-P)
用于 JSON 处理的 JSON API(JSON-P)是在 Java EE 7 规范中引入的,该规范在 JSR 353 中定义。其他规范在 JSR 374 中定义,用于 Java EE 8。等同于 JSON 处理的 Jakarta EE 遵循 Jakarta JSON Processing 1.1 规范。
JSON-P 定义用于处理 JSON 的 API。JBoss EAP 支持 javax.json.JsonObject
、javax.json.JsonArray
和 javax.json.JsonStructure
作为请求或响应实体。
用于 JSON 处理的 JSON API(JSON-P)与使用 Padding(JSONP)的 JSON 不同。
如果 JSON-P 位于同一个类路径上,则 JSON-P 不会与 Jackson 冲突。
若要创建 JsonObject
,请通过调用
并构建 JSON 对象来使用 JsonObjectBuilder。
Json.createObjectBuilder
()
示例:创建 javax.json.JsonObject
JsonObject obj = Json.createObjectBuilder().add("name", "Bill").build();
示例: javax.json.JsonObject
的 Corresponding JSON
{ "name":"Bill" }
若要创建 JsonArray
,请通过调用
。
Json.createArrayBuilder
()并构建 JSON 数组来使用JsonArrayBuilderBuilder
示例:创建 javax.json.JsonArray
JsonArray array = Json.createArrayBuilder() .add(Json.createObjectBuilder().add("name", "Bill").build()) .add(Json.createObjectBuilder().add("name", "Monica").build()).build();
示例:用于 javax.json.JsonArray
的 Corresponding JSON
[ { "name":"Bill" }, { "name":"Monica" } ]
JsonStructure
是 JsonObject 和Json
Array
的父类。
示例:创建 javax.json.JsonStructure
JsonObject obj = Json.createObjectBuilder().add("name", "Bill").build(); JsonArray array = Json.createArrayBuilder() .add(Json.createObjectBuilder().add("name", "Bill").build()) .add(Json.createObjectBuilder().add("name", "Monica").build()).build(); JsonStructure sObj = (JsonStructure) obj; JsonStructure sArray = (JsonStructure) array;
您可以在 JAX-RS资源中直接使用
。
和JsonStructureJsonObject
、JsonArray
示例:使用 JSON-P 的 JAX-RS 资源
@Path("object") @POST @Produces("application/json") @Consumes("application/json") public JsonObject object(JsonObject obj) { // do something return obj; } @Path("array") @POST @Produces("application/json") @Consumes("application/json") public JsonArray array(JsonArray array) { // do something return array; } @Path("structure") @POST @Produces("application/json") @Consumes("application/json") public JsonStructure structure(JsonStructure structure) { // do something return structure; }
您还可以使用客户端中的 JSON-P 来发送 JSON。
示例:使用 JSON-P 的客户端
WebTarget target = client.target(...); JsonObject obj = Json.createObjectBuilder().add("name", "Bill").build(); JsonObject newObj = target.request().post(Entity.json(obj), JsonObject.class);