用 Java 技术创建 RESTful Web 服务

核心提示： 清单 1. JAX-RS 根资源packagecom.ibm.jaxrs.sample.organization;importjavax.ws.rs.Path;@Path(value="/contacts")publicclassContactsResource{...}子资

清单 1. JAX-RS 根资源

package　com.ibm.jaxrs.sample.organization;　
　
import　javax.ws.rs.Path;　
　
@Path(value="/contacts")　
public　class　ContactsResource　{　
　...　
}　

子资源

子资源是作为 subresource locator 调用的结果返回的 Java 类。它们类似于根资源，只不过它们不是由 @Path 注释的，因它们的路径是由子资源定位器给出的。子资源通常包含由 HTTP 请求方法指示符（designator）注释的方法以便服务此请求。如果它们不包含如此注释的方法，那么它们将会通过指派给合适的子资源定位器来进一步解析此资源处理请求。

清单 2. JAX-RS 子资源

package　com.ibm.jaxrs.sample.organization;　
　
import　javax.ws.rs.GET;　
　
public　class　Department　{　
　
　
　
　@GET　
　public　String　getDepartmentName()　{　
　...　
　}　
　
　
　
}　

如上所示的清单 2 展示了由 ContactsResource.getContactDepartment 方法返回的子资源。在这个例子中，如果一个 HTTP GET 请求被发送给 /contact/{contactName}/department 路径，那么 Department 子资源内的 getDepartmentName 资源方法就会处理此请求。

资源方法

资源方法是根资源或子资源内绑定到 HTTP 方法的 Java 方法。绑定是通过诸如 @GET 这样的注释完成的。

清单 3. JAX-RS 资源方法

package　com.ibm.jaxrs.sample.organization;　
　
import　java.util.List;　
import　javax.ws.rs.GET;　
import　javax.ws.rs.Path;　
　
@Path(value="/contacts")　
public　class　ContactsResource　{　
　
　
　
　@GET　
　public　List<ContactInfo>　getContacts()　{　
　...　
　}　
　
　
}