用 Java 技术创建 RESTful Web 服务

核心提示： 在上述例子中，对 /contact/{contactName}/department 路径的任何 HTTP 请求都将由 getContactDepartment 子资源定位器处理，用 Java 技术创建 RESTful Web 服务(4)， {contactName} 部分表明 contact

在上述例子中，对 /contact/{contactName}/department 路径的任何 HTTP 请求都将由 getContactDepartment 子资源定位器处理。 {contactName} 部分表明 contact 路径部分之后可以是任何合法的 URL 值。

注释

本节将会探讨一些重要的注释及其使用。

@Path

@Path 注释被用来描述根资源、子资源方法或子资源的位置。value 值可以包含文本字符、变量或具有定制正则表达式的变量。清单 6 的例子展示了 @Path 注释的主要应用。

清单 6. @Path 的使用

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

ContactsResource 类上的注释表明对 /contacts 路径的所有请求都将由 ContactsResource 根资源处理。getByEmailAddress 上的 @Path 注释则表明任何发送到 /contacts/{emailAddress} 的请求（其中 emailAddress 代表的是正则表达式 .+@.+\\.[a-z]+）都将由 getByEmailAddress 处理。