JAX-RS入门 六： 数据处理（1）

• public?void?post(File?file)?{??
• ????Reader?reader?=?new?Reader(new?FileInputStream(file));??
• 这里File作为请求参数使用。

   

  注：当使用File作为请求参数时，JAX-RS会在后台生成一个临时文件，以请求的信息体作为这个文件的内容，然后将这个临时文件作为参数传入。

  用于响应：

  private?static?final?String?basePath?=?"...";??
• @GET??
• @Path("{filepath:?.*}")??
• @Produces("text/plain")??
• public?File?getFile(@PathParam("filepath")?String?path)?{??
• new?File(basePath?+?path);??
• }??????

注：同样的，当File用作响应时，需要指定@Produces，用于告诉JAX-RS怎么转换File内容，即Content-Type。

四、byte[]

byte[]也可以用在请求或响应，例如：

• return?"hello?world".getBytes();??
• }??
• @POST??
• @Consumes("text/plain")??
• void?post(byte[]?bytes)?{??
• ????System.out.println(new?String(bytes));??
• 注：当用作响应时，需要指定@Produces，用于告诉JAX-RS怎么设置响应的Content-Type值。?

   

  五、String/Char[]

  大多数网络数据是基于文件格式的。JAX-RS可以进行任何文件格式的内容与String/Char[]之间的转换。例如：

  String/char[]代码?? @Produces("application/xml")??
• public?String?get()?{??
• ????return?"<customer><name>Bill?Burke</name></customer>";??
• @Consumes("text/plain")??
• public?void?post(String?str)?{??
• ????System.out.println(str);??
• 注：当用作响应时，需要指定@Produces，用于告诉JAX-RS怎么设置响应的Content-Type值。

   

  ?

  注：JAX-RS规范要求实现者必须处理在Content-Type中指定的charset值，当注入String时，例如：

  POST?/data??

• Content-Type:?application/xml;charset=UTF-8??
• <customer>...</customer>??

这里charset为UTF-8，实现者必须保证生成的Java String必须是UTF-8编码的。

六、MultivaluedMap<String,String> 和Form

在节4（http://liugang594.iteye.com/blog/1496651）中，已经介绍了使用@FormParam去获取提交的Form值。除了使用@FormParam，也可以直接注入MultivaluedMap<String,String>对象来表示所有请求的Form数据，其中Form数据格式是 "application/x-www-form-urlencoded"，例如：

@Consumes("application/x-www-form-urlencoded")??

• @Produces("application/x-www-form-urlencoded")??
• public?MultivaluedMap<String,String>?post(??
• ????MultivaluedMap<String,?String>?form)?{??
• return?form;??
• 注：JAX-RS规范并未指明注入的MultivaluedMap是否已经编码；大多数实现者都会自动解码其中的key/value值。如果你想保持编码的格式，则可以使用@javax.ws.rs.Encoded注释。

   

  七、javax.xml.transform.Source

  Source接口代表了一个XML的输入或输出，它通常是用来进行XSLT转换的，例如：

  @Consumes("application/xml")??

• @Produces("application/xml")??
• public?String?post(Source?source)?{??
• ????javax.xml.transform.TransformerFactory?tFactory?=??
• ????????javax.xml.transform.TransformerFactory.newInstance();??
• ????javax.xml.transform.Transformer?transformer?=??
• ????????tFactory.newTransformer(??
• ????????????new?javax.xml.transform.stream.StreamSource("foo.xsl"));??
• ????StringWriter?writer?=?new?StringWriter();??
• ????transformer.transform(source,??
• new?javax.xml.transform.stream.StreamResult(writer));??
• return?writer.toString();??
• 除了JAXB（下节讲）外，javax.xml.transform.Source对象是规范中唯一支持的基于XML结构的对象。（甚至不能注入org.w3c.dom.Document对象）