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.JsonObjectjavax.json.JsonArrayjavax.json.JsonStructure 作为请求或响应实体。

注意

用于 JSON 处理的 JSON API(JSON-P)与使用 Padding(JSONP)的 JSON 不同。

注意

如果 JSON-P 位于同一个类路径上,则 JSON-P 不会与 Jackson 冲突。

若要创建 JsonObject,请通过调用 Json.createObjectBuilder () 并构建 JSON 对象来使用 JsonObjectBuilder。

示例:创建 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"
  }
]

JsonStructureJsonObject 和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资源中直接使用 JsonObject、JsonArray 和JsonStructure

示例:使用 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);

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.