Restful 介绍

REST 中最重要的概念是资源（resources），使用全球 ID（通常使用 URI）标识。客户端应用程序使用 HTTP 方法（GET/ POST/ PUT/ DELETE）操作资源或资源集。RESTful Web 服务是使用 HTTP 和 REST 原理实现的 Web 服务。通常，RESTful Web 服务应该定义以下方面：

• Web 服务的基/根 URI，比如 http://host/<appcontext>/resources。
• 支持 MIME 类型的响应数据，包括 JSON/XML/ATOM 等等。
• 服务支持的操作集合（例如 POST、GET、PUT 或 DELETE)

如下表所示：

方法/资源  资源集合， URI 如：
http://host/<appctx>/resources  成员资源，URI 如：
http://host/<appctx>/resources/1234 GET列出资源集合的所有成员检索标识为 1234 的资源的表示形式。PUT使用一个集合更新（替换）另一个集合。更新标记为 1234 的数字资源。POST在集合中创建数字资源在下面创建一个子资源。DELETE删除整个资源集合。删除标记为 1234 的数字资源。

 

 

JSR－311  Java API for RESTful Web Services (JAX-RS) 1.0 and 1.1

      JAX-RS是将在JavaEE 6引起的一种新技术。 JAX-RS即Java API for RESTful Web Services，是一个Java 编程语言的应用程序接口，支持按照表述性状态转移（REST）架构风格创建Web服务。JAX-RS使用了Java SE5引入的Java标注来简化Web服务的客户端和服务端的开发和部署。包括：

 

• @Path，标注资源类或者方法的相对路径 　　
• @GET，@PUT，@POST，@DELETE，标注方法是HTTP请求的类型。 　　
• @Produces，标注返回的MIME媒体类型 　　
• @Consumes，标注可接受请求的MIME媒体类型
• @PathParam，@QueryParam，@HeaderParam，@CookieParam，@MatrixParam，@FormParam,分别标注方法的参数来自于HTTP请求的不同位置，例如@PathParam来自于URL的路径，@QueryParam来自于URL的查询参数，@HeaderParam来自于HTTP请求的头信息，@CookieParam来自于HTTP请求的Cookie。