集成JAX-RS和JSON-P

集成JAX-RS和JSON-P

作者：chszs，未经博主允许不得转载。经许可的转载需注明作者和博客主页：http://blog.csdn.net/chszs

一、JSON-P和JSON-B介绍

在Java EE 7中引入了JSON Processing API，即JSON-P规范。JSON-P规范定义了一套标准的API来操纵JSON数据，这一点与JAXP规范相似（操纵XML的API规范）。在Java EE 8中还将引入JSON Binding API，即JSON-B规范。

JSR 353: Java API for JSON Processing (JSON-P)规范详见 http://jcp.org/en/jsr/detail?id=353

JSR 367: Java API for JSON Binding (JSON-B)规范详见 https://www.jcp.org/en/jsr/detail?id=367

二、JAX-RS 2.0支持JSON-P

JAX-RS 2.0规范是Java EE 7规范的一部分，它同时也支持JSON-P规范，比如对JsonObject类、JsonArray类、JsonStructure类等提供了开箱即用的支持。每一个兼容JAX-RS 2.0规范的参考实现都提供了内建的支持以上类的实体Provider，使得JAX-RS应用程序可以轻松简单地交换JSON数据。

JsonObject见： https://docs.oracle.com/javaee/7/api/javax/json/JsonObject.html

JsonArray见： https://docs.oracle.com/javaee/7/api/javax/json/JsonArray.html

JsonStructure见： https://docs.oracle.com/javaee/7/api/javax/json/JsonStructure.html

三、例子

1、从JAX-RS资源方法发散JSON数组

@GET
public JsonArray buildJsonArray(){
return Json.createArrayBuilder().add("jsonp").add("jaxrs").build();
}

2、从客户端接收JSON数据

@POST
public void acceptJsonObject(JsonObject payload){
System.out.println("the payload -- "+ payload.toString());
}

3、JsonObject使用的例子

1）JSON数据如下

{
"firstName": "John", "lastName": "Smith", "age": 25,
"address" : {
"streetAddress": "21 2nd Street",
"city": "New York",
"state": "NY",
"postalCode": "10021"
},
"phoneNumber": [
{ "type": "home", "number": "212 555-1234" },
{ "type": "fax", "number": "646 555-4567" }
]
}

2）构建JsonObject

JsonObject value = Json.createObjectBuilder()
.add("firstName", "John")
.add("lastName", "Smith")
.add("age", 25)
.add("address", Json.createObjectBuilder()
.add("streetAddress", "21 2nd Street")
.add("city", "New York")
.add("state", "NY")
.add("postalCode", "10021"))
.add("phoneNumber", Json.createArrayBuilder()
.add(Json.createObjectBuilder()
.add("type", "home")
.add("number", "212 555-1234"))
.add(Json.createObjectBuilder()
.add("type", "fax")
.add("number", "646 555-4567")))
.build();

四、值得注意的情况

1、无需编写自定义的MessageBodyReader类或MessageBodyWriter类的实现，正如前面提到的，JAX-RS规范提供了这些API。

2、使用注释绑定JSON方法的方式目前还不支持（类似于在POJOs类上使用JAXB注释），等未来的版本吧。GlassFish 4.1 (Jersey)和Wildfly 8.x (RESTEasy)已经支持了注释绑定JSON方法，但这种使用方式还不是标准，应注意这一点。

五、参考

1、官方JAX-RS规范： https://jcp.org/aboutJava/communityprocess/final/jsr339/index.html