resteasy简介

原文地址：https://my.oschina.net/bigyuan/blog/57409

RestEasy技术说明

简介

RESTEasy

RESTEasy是JBoss的一个开源项目，提供各种框架帮助你构建RESTful Web Services和RESTful Java应用程序。它是JAX-RS规范的一个完整实现并通过JCP认证。作为一个JBOSS的项目，它当然能和JBOSS应用服务器很好地集成在一起。但是，它也能在任何运行JDK5或以上版本的Servlet容器中运行。RESTEasy还提供一个RESTEasy JAX-RS客户端调用框架。能够很方便与EJB、Seam、Guice、Spring和Spring MVC集成使用。支持在客户端与服务器端自动实现GZIP解压缩。

RESTEasy 项目是 JAX-RS 的一个实现，集成的一些亮点：

• 不需要配置文件，只要把JARs文件放到类路径里面，添加 @Path 标注就可以了。
• 完全的把 RESTEeasy 配置作为Seam 组件来看待。
• HTTP 请求由Seam来提供，不需要一个额外的Servlet。
• Resources 和providers可以作为 Seam components (JavaBean or EJB)，具有全面的Seam injection,lifecycle, interception, 等功能支持。
• 支持在客户端与服务器端自动实现GZIP解压缩。

名词解释:

JAX-RS: Java API for RESTful Web Services是一个Java编程语言的应用程序接口,支持按照 表象化状态转变 (REST)架构风格创建Web服务Web服务[1]. JAX-RS使用了Java SE 5引入的Java 标注来简化Web服务客户端和服务端的开发和部署。

规范内容

JAX-RS提供了一些标注将一个资源类，一个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。

@pathparam

   @GET
     @Path("delProByPNumber/{param}")
     @Produces("application/json; charset=utf-8")
     public Response delPro(@PathParam("param") String  pNumber){
         session.delete("production.delete", pNumber);
         session.commit();
         List list=queryAllPro();
         return Response.status(201).entity(list).build();
     }
 访问路径：http://localhost:8888/Invoice/optPro/delProByPNumber/7
 其中7为传入参数

@queryParam

 @GET
     @Path("addAcc/parameters")
     @Produces("application/json; charset=utf-8")
     public Response addCus(
             @QueryParam("accname") String accname,
             @QueryParam("balance") long balance,
             @QueryParam("department") String   department,
             @QueryParam("bankname") String bankname,
             @QueryParam("accnumber") long accnumber,
             @QueryParam("username") String username
             ) {
         Account account=new Account();
         account.setAccname(accname);
         account.setBalance(balance);
         account.setDepartment(department);
         account.setBankname(bankname);
         account.setAccnumber(accnumber);
         account.setUsername(username);
         session.insert("account.addAcc",account);
         session.commit();

         return Response.status(201).entity(queryOne(accname)).build();
     }
 访问路径：http://localhost:8888/Invoice/optAcc/addAcc/parameters?accname=rr&balance=99999&department=heda&bankname=邮政&accnumber=6666&username=yu
 parameters后面为传入参数

@FormParam

 @Path("/services/hello")
 public class HelloWorldRestService {
     @POST
     @Path("getName")
     public String  getName(@FormParam("fname") String fname,@FormParam("lname") String lname) {
         String result = "RESTEasy Hello World : " + fname+lname;
         System.out.println("fname"+fname);
         return result;
     }
 }
 前台form表单提交


 "Content-Type" content="text/html; charset=UTF-8">
 Insert title here


     "http://localhost:8888/Invoice/services/hello/getName" method="POST">
         First name: "text" name="fname" />
         Last name: "text" name="lname" />
         "submit" value="Submit" />

访问路径：

http://localhost:8888/Invoice/services/hello/getName

    @Context：获取各种类型请求参数

                例如：请求路径为： http://localhost:8080/RestEasy/test/test-context/123;color=balack

                           模版样例为：

 /**
 * @功能描述: (Context获取Path路径,Matrix参数,PathParam参数)
 */
 @GET
 @Path("test-context/{id}")
 @Produces("text/plain; charset=utf-8")
 public String getContext(@Context UriInfo uriInfo) {
 String path = uriInfo.getPath();
 List lsps = uriInfo.getPathSegments();
 String psString = "";
 for (PathSegment ps : lsps) {
 psString = psString + JSON.toJSONString(ps) + "; ";
 }
 MultivaluedMap map = uriInfo.getPathParameters();
 return "path:" + path + "; lsps:" + psString + "; map:"
 + JSON.toJSONString(map);
 }    "color:#808080;"> "font-family:'Microsoft YaHei UI';font-size:10.5pt; line-height:1.5">