用 Java 技术创建 RESTful Web 服务

核心提示： packagecom.ibm.jaxrs.sample.organization;importjava.util.List;importjavax.ws.rs.Consumes;importjavax.ws.rs.GET;importjavax.ws.rs.Path;importjavax.ws

package　com.ibm.jaxrs.sample.organization;　
　
import　java.util.List;　
import　javax.ws.rs.Consumes;　
import　javax.ws.rs.GET;　
import　javax.ws.rs.Path;　
import　javax.ws.rs.PathParam;　
import　javax.ws.rs.Produces;　
　
@Path(value="/contacts")　
public　class　ContactsResource　{　
　
　　
　@GET　
　@Path(value="/{emailAddress:.+@.+\\.[a-z]+}")　
　@Produces(value={"text/xml",　"application/json"})　
　public　ContactInfo　getByEmailAddress(@PathParam(value="emailAddress")　
　String　emailAddress)　{　
　...　
　}　
　
　@GET　
　@Path(value="/{lastName}")　
　@Produces(value="text/xml")　
　public　ContactInfo　getByLastName(@PathParam(value="lastName")　String　lastName)　{　
　...　
　}　
　
　@POST　
　@Consumes(value={"text/xml",　"application/json"})　
　public　void　addContactInfo(ContactInfo　contactInfo)　{　
　...　
　}　
}　

对于上述的 getByEmailAddress 和 addContactInfo 方法，它们均能处理 text/xml 和 application/json。被接受或返回的资源表示将依赖于客户机设置的 HTTP 请求头。@Consumes 注释针对 Content-Type 请求头进行匹配，以决定方法是否能接受给定请求的内容。

在清单 9 中，application/json 的 Content-Type 头再加上对路径 /contacts 的 POST，表明我们的 ContactsResource 类内的 addContactInfo 方法将会被调用以处理请求。