RESTEasy初探

1.RESTEasy是什么

       RESTEasy是JBoss的一个开源项目，提供一套完整的框架帮助开发人员构建RESTful Web Service和RESTful Java应用程序。它是JAX-RS 2.0规范的一个完整实现并通过JCP认证，通过Http协议对外提供基于Java API的 RestFul Web Service。

RestEasy可以运行在任何Servlet容器中，作为JBoss的官方实现它可以更好的和Jboss服务器紧密融合从而提供更好的用户体验。

 

       我的理解就是RESTEasy是一个帮助开发者搭建RESTful风格项目的框架。

进一步了解，就需要了解REST是什么

       REST（RepresentationalState Transfer） ，中文翻译为“具象状态传输”。REST并非标准，而是一种开发 Web 应用的架构风格，可以将其理解为一种设计模式。REST 基于 HTTP，URI，以及 XML 这些现有的广泛流行的协议和标准，伴随着 REST，HTTP 协议得到了更加正确的使用。

基于 REST 的 Web 服务遵循一些基本的设计原则：

1）系统中的每一个对象或是资源都可以通过一个唯一的 URI 来进行寻址，URI 的结构应该简单、可预测且易于理解，比如定义        目录结构式的 URI。

2）以遵循RFC-2616 所定义的协议的方式显式地使用 HTTP 方法，建立创建、检索、更新和删除（CRUD：Create, Retrieve,         Update and Delete）操作与 HTTP 方法之间的一对一映射：
     若要创建资源，应该使用 POST方法, URI : xxx/book(在服务器端新建图书信息,需提供该图书所有信息)
     若要检索某个资源，应该使用 GET 方法, URI:xxx/book/{ID} （从服务器端获得某图书信息）

     若要更改资源状态或对其进行更新，应该使用 PUT 方法,URI:xxx/book/{ID}（在服务器端更新某已存在的图书信息，需提供更       新的内容）
     若要删除某个资源，应该使用 DELETE 方法, URI :xxx/book/{ID} （从服务器端删除某图书信息）

2.JAX-RS

 

JAX-RS是一套用java实现REST服务的规范，提供了一些标注将一个资源类，一个POJOJava类，封装为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。

更通俗些说如果你用java写了一套框架，当开发者自己写的JAVA类使用了JAX-RS定义的这些注解标注过，然后通过你写的这套框架就可以将有这些JAX-RS标注的类发布成web资源，供其他客户端程序去调用。那么你写的这套框架就是一套RestFul Web Service框架，就是JAX-RS规范的实现者之一，是JAX-RS标准定义的这些标注的解释执行者。

目前比较流行的JAX-RS实现有以下几种：

Apache CXF，开源的Web服务框架开源组织Apache的实现。Jersey，由Sun提供的JAX-RS的参考实现。RestEasy，JBoss的JAX-RS的实现。

与其他几个框架相比较而言，RestEasy以其高性能，轻量级，简单易上手，高可靠性和稳定性以及易于与其他容器集成等特点，越来越受到开发人员的欢迎。