通常一个SOA的应用都需要足够的灵活,以便于各种不同的客户端或平台进行集成与交互。 RESTful 服务在这方面相当有优势,因为大部分的程序语言都能够与HTTP协议间相互通信。
不过这还不够,为了高效的运行,不同的用户可能有不同的需求。例如Java用户端更多的希望他们的数据是xml格式的;Ajax用户端则更喜欢JSON格式;Ruby用户需要想要YAML格式。另外,有时他们还希望这些数据是经过的国际化的,这样他们可以提供翻译好的信息给不同的,例如英语、中文、日文、西班牙文或法文用户。最后,随着RESTful应用的不断发展,老用户也需要一个简单的方法来与新版本的服务进行交互。
HTTP协议有很多手段可以帮助解决这些集成问题。一个最强大的功能就是用户可以告诉服务器他们希望的返回格式,客户端和服务器可以约定好消息体的内容格式,例如:它是怎么编码的;它需要返回哪种语言格式等。这种协议被称为HTTP Content Negotiation(HTTP内容约定),简称conneg。 这节主要介绍conneg是怎么工作的,JAX-RS怎么支持它以及在你的应用中协调这些特性有多重要。
一、Conneg
* Media Type
当请求服务端信息时,用户可以指定他们希望的返回的Media Type,这是通过客户端设置的Accept 请求头来实现的,其中Accept的主体部分以逗号分隔。例如:
GET http://example.com/stuff
Accept: application/xml, application/json
上例中,客户端要求服务端以XML或JSON的格式返回对/stuff的请求。如果服务器不能提供期望的返回格式,则会得到一个406(Not Acceptable)响应码;否则服务器端选择其中的一种返回格式,将响应结果发回给客户端。
在Accept中还支持通配符和Media Type属性,例如:
GET http://example.com/stuff
Accept: text/*, text/html;level=1
text/*表示任何text格式。
* Media Type优先级
HTTP协议有隐式和显式选择返回的Media Type规则。
> 隐式规则
隐式规则就是越具体的Media Type总是优先于越宽泛的规则,例如:
GET http://example.com/stuff
Accept: text/*, text/html;level=1, */*, application/xml
服务器端会假设客户端总是想要一个具体的,而不是宽泛的响应类型,因此以上Accept的Media Types的顺序如下:
1. text/html;level=1
2. application/xml
3. text/*
4. */*
因为text/html;level=1最具体的,因为排第一;然后是application/xml,因为它没有任何属性定义;然后是text/*和*/*都是宽泛定义,但是相对*/*来说,text/*更具体一些。
> 显式规则
客户端也可以通过使用MIME type的q属性来指定优先顺序,q的值域为0.0到1.0,如果未指定,则缺省值被假设为1.0。例如:
GET http://example.com/stuff
Accept: text/*;q=0.9, */*;q=0.1, audio/mpeg, application/xml;q=0.5
如上的顺序为:
1. audio/mpeg
2. text/*
3. application/xml
4. */*
二、语言约定
客户端使用Accept-Language头来指定他们需要接收哪个语种,例如:
GET http://example.com/stuff
Accept-Language: en-us, es, fr
这里用户希望响应内容为英语、西班牙语或法语。Accept-Lauguage头使用编码格式来指定,以两个字母代码表示某种语言,其中这些代码与语言的映射在ISO-639*标准中定义;除此之处,还可以增加两个字母更具体的指定是哪个国家的那种语言,例如en-US表示美国英语。
另外Accept-Language头也支持q参数来指定优先级,例如:
GET http://example.com/stuff
Accept-Language: fr;q=1.0, es;q=1.0, en=0.1
对于服务器端的响应,则使用: Content-Language 。来告诉客户端返回内容的语种。
三、压缩约定
为了节省带宽,HTTP协议也支持内容压缩。最通用的压缩算法就是GZIP。客户端可以指定Accept-Encoding头来指定他们支持哪种压缩算法,例如:
GET http://example.com/stuff
Accept-Encoding: gzip, deflate
这里客户端说他希望响应内容是以gzip压缩或者干脆是不压缩的。
Accept-Encoding也支持q参数,来指定选择的优先级:
GET http://example.com/stuff
Accept-Encoding: gzip;q=1.0, compress;0.5; deflate;q=0.1
对于服务器端的响应,则使用: Content-Encoding 。来告诉客户端返回内容的压缩算法。
分享到:
相关推荐
[奥莱理] RESTful Java 开发 (Jax-RS 实现) (英文版) [奥莱理] RESTful Java with Jax-RS (E-Book) ☆ 图书概要:☆ Learn how to design and develop distributed web services in Java using RESTful ...
The RESTEasy workbook that follows provides step-by-step instructions for installing, configuring, and running several working JAX-RS examples, using the JBoss RESTEasy implementation of JAX-RS 2.0. ...
使用到的外部jar包有(必须的部分,需要加到Web容器中) •neethi-3.0.2.jar •jsr311-api-1.1.1.jar •cxf-bundle-2.6.0.jar 使用到的外部jar包有(可选的部分,当且仅当作为一个独立的application运行时) ...
赠送jar包:jackson-jaxrs-json-provider-2.7.8.jar; 赠送原API文档:jackson-jaxrs-json-provider-2.7.8-javadoc.jar; 赠送源代码:jackson-jaxrs-json-provider-2.7.8-sources.jar; 赠送Maven依赖信息文件:...
javax.xml.ws.Service 报错需要的包,亲测可以用,直接下载在ide里buildpath一下就可以,四个jar包 ,整合了其他的jar所以配置简单
JAX-RS(JSR 311)指的是Java API for RESTful Web Services,Roy Fielding也参与了JAX-RS的制订,他在自己的博士论文中定义了REST。对于那些想要构建RESTful Web Services的开发者来说,JAX-RS给出了不同于JAX-WS...
jax-rs-test JAX-RS测试
概述这是一个多模块项目,包含用于以下数据格式的基于Jackson的JAX-RS提供程序:(二进制JSON) (另一种二进制JSON) 提供程序实现特定数据格式的JAX-RS MessageBodyReader和MessageBodyWriter处理程序。...
JAX-RS 性能 比较每个请求和单例 JAX-RS 资源类的性能。 请参阅。 该项目包括 4 个资源类:2 个每个请求范围和 2 个单例。 两个只是返回一个查询参数。 在另外两个资源中,我们将通过@Context 注入 UriInfo。 上...
关于JAX-RS的注解详细,本人通过网络及实际应用收集的资料
jax-rs 2.1规范最终版,英文原版。jax-rs规范定义了java平台Rest调用风格的WebService接口。
JAX-RS-演示学术项目的 JAX-RS(用于 RESTful Web 服务的 Java API)演示。 该演示使用作为 JSR 311 规范的参考实现。
使用Eclipse开发基于SpringBoot+JAX-RS的Restful服务.docx使用Eclipse开发基于SpringBoot+JAX-RS的Restful服务.docx使用Eclipse开发基于SpringBoot+JAX-RS的Restful服务.docx使用Eclipse开发基于SpringBoot+JAX-RS的...
JAX-RS REST helloworld 项目源码 下载后引入eclipse jee 启动tomcat可直接访问 访问路径为http://localhost:8080/AndroidJAX-RS/jaxrs/helloworld/html
srb4j, Simple RESTFul backend for Java, 一个JAX-RS服务端代码脚手架(就像AppFuse之于Webapp),基于OAuth2提供了完整的注册、登录、密码恢复等功能。 它本质是一个Maven Archetype, 所以你可以用它快速生成一个...
restlet_jax-rs列子 可直接运行 在我的博客里有一些描述。希望能给大家提供点帮助
JAX-RS-FileUpload-Jersey-Example
JAX-RS+spring
web service rest(jax-rs)整合完整的Jax-rs组件包,内含2个版本,分别是1.0和1.4版本。