使用 JAX-RS 简化 REST 应用开发

核心提示： 内容协商与数据绑定Web 资源可以有不同的表现形式，服务端与客户端之间需要一种称为内容协商（Content Negotiation）的机制：作为服务端，使用 JAX-RS 简化 REST 应用开发(7)，Resource 方法的 Produces 标注用于指定响应体的数据格式（MIME 类型），

内容协商与数据绑定

Web 资源可以有不同的表现形式，服务端与客户端之间需要一种称为内容协商（Content Negotiation）的机制：作为服务端，Resource 方法的 Produces 标注用于指定响应体的数据格式（MIME 类型），Consumes 标注用于指定请求体的数据格式；作为客户端，Accept 请求头用于选择响应体的数据格式，Content-Type 请求头用于标识请求体的数据格式。

JAX-RS 依赖于 MessageBodyReader 和 MessageBodyWriter 的实现来自动完成返回值到响应体的序列化以及请求体到实体参数的反序列化工作，其中，XML 格式的请求／响应数据与 Java 对象的自动绑定依赖于 JAXB 的实现。

用户可以使用 Provider 标注来注册使用自定义的 MessageBodyProvider，如 清单 6 所示，GsonProvider 类使用了 Google Gson 作为 JSON 格式的 MessageBodyProvider 的实现。

清单 6. GsonProvider
@Provider　
@Produces("application/json")　
@Consumes("application/json")　
public　class　GsonProvider　implements　MessageBodyWriter<Object>,　
　　MessageBodyReader<Object>　{　
　
　　private　final　Gson　gson;　
　
　　public　GsonProvider()　{　
　　　　gson　=　new　GsonBuilder().excludeFieldsWithoutExposeAnnotation().setDateFormat(　
　　　　　　　　"yyyy-MM-dd").create();　
　　}　
　
　　public　boolean　isReadable(Class<?>　type,　Type　genericType,　Annotation[]　annotations,　
　　　　　　MediaType　mediaType)　{　
　　　　return　true;　
　　}　
　
　　public　Object　readFrom(Class<Object>　type,　Type　genericType,　
　　　　　　Annotation[]　annotations,　MediaType　mediaType,　
　　　　　　MultivaluedMap<String,　String>　httpHeaders,　InputStream　entityStream)　
　　　　　　throws　IOException,　WebApplicationException　{　
　　　　return　gson.fromJson(new　InputStreamReader(entityStream,　"UTF-8"),　type);　
　　}　
　
　　public　boolean　isWriteable(Class<?>　type,　Type　genericType,　Annotation[]　annotations,　
　　　　　　MediaType　mediaType)　{　
　　　　return　true;　
　　}　
　
　　public　long　getSize(Object　obj,　Class<?>　type,　Type　genericType,　
　　　　　　Annotation[]　annotations,　MediaType　mediaType)　{　
　　　　return　-1;　
　　}　
　
　　public　void　writeTo(Object　obj,　Class<?>　type,　Type　genericType,　
　　　　　　Annotation[]　annotations,　MediaType　mediaType,　
　　　　　　MultivaluedMap<String,　Object>　httpHeaders,　OutputStream　entityStream)　
　　　　　　throws　IOException,　WebApplicationException　{　
　　　　entityStream.write(gson.toJson(obj,　type).getBytes("UTF-8"));　
　　}　
　
}