JAXRS 1.0规范

《JAXRS 1.0规范》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、JSR311JAX-RS1.0规范目录1.概览42.Applications42.1.配置42.2.发布43.资源（Resources）43.1.资源类53.1.1.生命周期和环境53.1.2.构造函数53.2.字段和属性53.3.方法63.3.1.可见性73.3.2.参数73.3.3.返回类型73.3.4.异常83.3.5.HEAD和OPTIONS请求93.4.URI模板（URITemplates）93.4.1.子资源93.5.声明所支持的媒体类型（DeclaringMediaTypeCapabilities）103.6.注释继承113

2、.7.请求与资源方法之间的映射123.7.1.请求预处理123.7.2.请求匹配123.7.3.将URI模板转换成规则表达式153.8.决定响应的媒体类型164.提供者（Providers）184.1.生命周期与环境184.1.1.构造函数184.2.实体提供者（EntityProviders）184.2.1.MessageBodyReader184.2.2.MessageBodyWriter194.2.3.声明所支持的媒体类型194.2.4.标准实体提供者204.2.5.编码转换204.2.6.内容编码204.3.上下文提供者（Cont

3、extProviders）214.3.1.声明所支持的媒体类型214.4.异常映射提供者（ExceptionMappingProviders）215.上下文（Context）215.1.并发215.2.上下文类型215.2.1.URIs和URI模板225.2.2.Headers225.2.3.内容协商和前置条件225.2.4.安全上下文245.2.5.Providers256.环境256.1.Servlet容器256.2.JavaEE容器256.3.其它257.运行时委托（RuntimeDelegate）257.1.配置26附录A：注释汇

4、总27附录B：HTTPHeader支持281.概览2.ApplicationsJSR-311应用程序由一个或多个Resource，以及零个或多个Provider构成。2.1.配置组成应用程序的Resource和Provider通过应用程序所使用的Application的子类（具体实现类）配置。2.2.发布应用程序的发布方式和应用程序的运行环境（JRE,容器）有关。3.资源（Resources）使用JAX-RS时，一个web资源由一个资源类来实现，而请求则由资源类的方法处理。3.1.资源类资源类是一个使用JAX-RSannotations来

5、实现相应web资源的java类。资源类是POJO，其至少有一个方法标注有@Path注释、或者其他请求方法指示符（@GET,@POST,@PUT,@DELETE,@HEAD,@OPTIONS）。3.1.1.生命周期和环境默认情况下，实现会在每次请求该资源时创建该资源类实例。1.调用构造函数；2.依赖注入；3.调用相应方法，返回结果；4.最后此资源实例就可以被垃圾回收了。3.1.2.构造函数根资源类由JAX-RS运行时初始化，它必须拥有公共的构造函数，并且该构造函数的所有参数都能由JAX-RS运行时注入。当然，在该规则下，一个public的无

6、参数构造函数也是允许的。一个公共的构造函数可以定义带有以下注释的参数：@Context,@HeaderParam,@CookieParam,@MatrixParam,@QueryParam或者@PathParam.不过，取决于资源类实例的生命周期和并发支持，构造函数中请求级别（perrequest）的信息也许并没有用。如果有多个带参数的公共构造函数可用，实现必须使用参数最多的那个。如果有相同参数数量的公共构造函数，那么具体实现可以自己决定选择哪一个，并且实现应该对这种Resource类给出警告信息。非根资源类由应用程序自己实例化，它没有上

7、面所说的构造函数的限制。3.2.字段和属性当资源类被实例化的时候，有以下注释的字段和属性的值也会相应被设置：@MatrixParamExtractsthevalueofaURImatrixparameter.@QueryParamExtractsthevalueofaURIqueryparameter.@PathParamExtractsthevalueofaURItemplateparameter.@CookieParamExtractsthevalueofacookie.@HeaderParamExtractsthevalueofah

8、eader.@ContextInjectsaninstanceofasupportedresource,seechapters5and6formoredetails因为注入发生在资源类对象创建