第 48 章 将信息返回到 Consumer
摘要
RESTful 请求要求至少有 HTTP 响应代码返回给使用者。在很多情况下，可以通过返回普通的 JAXB 对象或通用性对象来满足请求。当资源方法需要返回其他元数据以及响应实体时，JAX-RS 资源方法可以返回包含任何所需 HTTP 标头或其他元数据的 Response 对象。
48.1. 返回类型
返回到使用者的信息决定了资源方法返回的确切对象类型。这似乎很明显，但 Java 返回对象之间的映射和返回到 RESTful 消费者之间的映射并非一。至少，除任何响应实体正文外，RESTful 消费者还需要返回有效的 HTTP 返回代码。Java 对象中包含的数据到响应实体的映射由消费者接受的 MIME 类型生效。
为了解决将 Java 对象映射到 RESTful 响应消息的问题，可以返回四种 Java 结构类型：
- 第 48.2 节 “返回普通 Java 结构” 使用由 JAX-RS 运行时确定的 HTTP 返回代码返回基本信息。
- 第 48.2 节 “返回普通 Java 结构” 通过由 JAX-RS 运行时确定的 HTTP 返回代码返回复杂信息。
-
第 48.3 节 “微调应用程序的响应” 通过编程方式确定的 HTTP 返回状态返回复杂信息。
Response对象还允许指定 HTTP 标头。 -
第 48.4 节 “使用通用类型信息返回实体” 通过由 JAX-RS 运行时确定的 HTTP 返回代码返回复杂信息。
GenericEnitity对象为运行时组件提供序列化数据的更多信息。
