写点什么

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

  • 2010-02-14
  • 本文字数:1239 字

    阅读完需:约 4 分钟

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

2010-02-14 07:133793
用户头像

发布了 88 篇内容, 共 269.0 次阅读, 收获喜欢 8 次。

关注

评论

发布
暂无评论
发现更多内容

手写JavaScript常见5种设计模式

helloworld1024fd

JavaScript

线下培训机构哪个比较靠谱?

小谷哥

React源码分析4-深度理解diff算法

goClient1992

React

Redis--Redis事务及错误处理方式

Java学术趴

10月月更

Redis--Redis持久化方式

Java学术趴

10月月更

GitHub上的宝藏级SpringBoot核心文档,拿走不谢!

Geek_0c76c3

Java 数据库 开源 程序员 开发

高频js手写题之实现数组扁平化、深拷贝、总线模式

helloworld1024fd

JavaScript

React源码分析1-jsx转换及React.createElement

goClient1992

React

React源码分析2-深入理解fiber

goClient1992

React

面试官:请实现Javascript发布-订阅模式

helloworld1024fd

JavaScript

如何在 Goerli 网络中获取测试 ETH

devpoint

以太坊 Goerli 测试网络

Vue项目处理错误上报如此简单

茶无味的一天

Vue 异常捕获

极客时间架构训练营模块二作业

李晨

架构

java工程师培训机构哪里好

小谷哥

clickhouse准实时数仓能力探索

水滴

实时数仓 OLAP 数仓 10月月更 clickhosue

【Go实现】实践GoF的23种设计模式:访问者模式

元闰子

Go 设计模式 访问者模式

每日一题之请描述Vue组件渲染流程

bb_xiaxia1998

Vue

web前端开发培训机构哪个好

小谷哥

吃透这份Java面试精选题解,我轻松拿到了字节跳动offer

Geek_0c76c3

Java 数据库 程序员 架构 开发

验证二叉搜索树

掘金安东尼

算法 10月月更

js函数柯里化-面试手写版

helloworld1024fd

JavaScript

什么是核心交换机、汇聚交换机、接入交换机,它们之间有啥区别?

wljslmz

交换机 网络设备 通信技术 10月月更

书单推荐|书籍是人类的良师益友

图灵教育

书单 教师节

Collections之Arraylist源码解读(六)

知识浅谈

ArrayList 10月月更

ESP32-C3 应用 篇(实例二、通过蓝牙将传感器数据发送给手机,手机端控制 SK6812 LED)

矜辰所致

蓝牙 ESP32-C3 10月月更

React源码分析3-render阶段(穿插scheduler和reconciler)

goClient1992

React

web前端开发培训机构比较好的是哪家

小谷哥

RecSysOps: 大规模推荐系统运维最佳实践

俞凡

架构 最佳实践 netflix 大厂实践

Python 3.12 目标:还可以更快!

Python猫

Python

你的方案逻辑自洽吗?

老张

测试方案 思维逻辑

前端培训机构应该怎么选

小谷哥

Java EE 6 Web Services:JAX-RS 1.1提供了基于注解的REST支持_Java_Srini Penchikala_InfoQ精选文章