Jersey框架简介

一 Jersey简介  

  开发RESTful WebService意味着支持在多种媒体类型以及抽象底层的客户端-服务器通信细节,如果没有一个好的工具包可用,这将是一个困难的任务

  为了简化使用JAVA开发RESTful WebService及其客户端,一个轻量级的标准被提出:JAX-RS API

  Jersey RESTful WebService框架是一个开源的、产品级别的JAVA框架,支持JAX-RS API并且是一个JAX-RS(JSR 311和 JSR 339)的参考实现

  Jersey不仅仅是一个JAX-RS的参考实现,Jersey提供自己的API,其API继承自JAX-RS,提供更多的特性和功能以进一步简化RESTful service和客户端的开发

二 主要配置 

  @PathParam用来将请求URI的一部分作为方法参数传入方法中对URI的动态部分,可以自定义校验正则表达式,如果请求参数校验失败,容器返回404 Not Found

  1. @Path("{sub_path:[A-Z]*}")  

  @GET

  表明被注解的方法响应HTTP GET请求,@POST@PUT@DELETE同理

  @Consumes

  定义请求的媒体类型,如果不指定,则容器默认可接受任意媒体类型,容器负责确认被调用的方法可接受HTTP请求的媒体类型,否则返回415 Unsupported Media Type方法级注解将覆盖类级注解

  @Produces

  定义响应媒体类型,如果不指定,则容器默认可接受任意媒体类型,容器负责确认被调用的方法可返回HTTP请求可以接受媒体类型,否则返回406 Not Acceptable方法级注解将覆盖类级注解

  @QueryParam

  如果请求URI中包含desc参数,例如:http://127.0.0.1:10000/service/sean?desc=123456,则desc参数的值将会赋给方法的参数description,否则方法参数description的值将为@DefaultValue注解定义的默认值

  @Context

  将信息注入请求或响应相关的类,可注入的类有:Application,UriInfo,Request,HttpHeaders和SecurityContext

  @Singleton@PerRequest

  默认情况下,资源类的生命周期是per-request,也就是系统会为每个匹配资源类URI的请求创建一个实例,这样的效率很低,可以对资源类使用@Singleton注解,这样在应用范围内,只会创建资源类的一个实例

 

 

 

 

posted @ 2015-12-28 14:45  HEWU  阅读(1626)  评论(0编辑  收藏  举报