BT

如何利用碎片时间提升技术认知与能力? 点击获取答案

Java EE 6 Web Services:JAX-RS 1.1提供了基于注解的REST支持

| 作者 Srini Penchikala 关注 36 他的粉丝 ,译者 张龙 关注 14 他的粉丝 发布于 2010年2月15日. 估计阅读时间: 4 分钟 | QCon上海2018 关注大数据平台技术选型、搭建、系统迁移和优化的经验。

JavaEE 6规范提供了Java API for RESTful Web Services(JAX-RS)支持,提供了基于POJO的框架以构建轻量级的Web Services,该框架符合REST(Representational State Transfer)风格的软件架构。JAX-RS 1.1隶属于JSR 311,其所提供的几个注解可用于将Java类的方法公开为Web资源。
JAX-RS会自动进行Java类与MIME媒体类型之间的转换。比如说,如果通过注解“@Produces(MediaType.TEXT_PLAIN)”标记某个类方法,JAX-RS则会将该Java类型转换为“text/plain”MIME类型,这代表了普通文本,同时通过HTTP响应将该类型的内容发送给客户端。

Java EE 6包含了JAX-RS的最新版,即JAX-RS 1.1,该版本充分利用了Java EE 6的新特性,而Jersey则是JAX-RS规范开源的参考实现,Jersey 1.1.5实现了JAX-RS 1.1。

注解增加了一些额外的说明信息,可以标识资源并辅助处理HTTP请求。JAX-RS所支持的一些注解列举如下:

Path:该注解为资源指定了一个相对路径。@Path所标识的URI路径用于资源类或是类方法处理请求所用。

GET@GET所注解的方法用于处理HTTP GET请求。当客户端向代表某个Web资源的URI直接发送HTTP GET请求时,JAX-RS运行时会调用被@GET所注解的方法来处理该GET请求。

POST@POST所注解的方法用于处理HTTP POST请求。

Produces:该注解用于标识MIME媒体类型,这样资源中的方法就会生成该类型的内容并返回给客户端。

Consumes@Consumes注解用于标识MIME媒体类型,这表示了资源中的方法可以接受客户端所请求的类型。与@Produces注解一样,如果在类上指定了@Consumes注解,该注解就会应用到类中的所有方法;如果在某个方法上指定了@Consumes注解,那么它会覆盖类上所指定的@Consumes注解。

JAX-RS还提供了其他一些方便的特性,比如基于参数的注解可以获得请求中的信息,@QueryParam,就是这样一种注解,它可以从请求URL的查询字符串中获得查询参数。其他基于参数的注解还有@MatrixParam,它可以从URL路径的segment部分获取信息;@HeaderParam可以从HTTP头中获得信息,而@CookieParam则可以从cookie相关的HTTP头中获得cookie信息。

还有不少辅助类和接口简化了Java中RESTful Web Services的构建和使用,列举如下:

  • MediaType类可用于获取MIME媒体类型。该类的实例是不可变的。
  • UriInfo是个接口,可以获取应用和请求的URI信息。
  • UriBuilder能够获取URI模板信息,它可以从URI的各个组成部分来构建URI。
  • Response是个抽象类,代表了HTTP响应。在应用向运行时提供元数据时,它定义了返回实例与运行时之间的契约。应用中的类可以直接继承Response类,也可以使用其静态方法来通过ResponseBuilder创建实例。
  • Response.ResponseBuilder用于构建Response对象,使用了Builder模式。

来自JBoss的RESTEasy框架也实现了JAX-RS规范。Apache开源的服务框架CXF也在2.3版中提供了对JAX-RS 1.1的支持。

查看英文原文:Java EE 6 Web Services: JAX-RS 1.1 Provides Annotation Based REST Support

评价本文

专业度
风格

您好,朋友!

您需要 注册一个InfoQ账号 或者 才能进行评论。在您完成注册后还需要进行一些设置。

获得来自InfoQ的更多体验。

告诉我们您的想法

允许的HTML标签: a,b,br,blockquote,i,li,pre,u,ul,p

当有人回复此评论时请E-mail通知我
社区评论

允许的HTML标签: a,b,br,blockquote,i,li,pre,u,ul,p

当有人回复此评论时请E-mail通知我

允许的HTML标签: a,b,br,blockquote,i,li,pre,u,ul,p

当有人回复此评论时请E-mail通知我

讨论

登陆InfoQ,与你最关心的话题互动。


找回密码....

Follow

关注你最喜爱的话题和作者

快速浏览网站内你所感兴趣话题的精选内容。

Like

内容自由定制

选择想要阅读的主题和喜爱的作者定制自己的新闻源。

Notifications

获取更新

设置通知机制以获取内容更新对您而言是否重要

BT