引用
Rop,即Rapid Open Platform,是一个参考淘宝开放平台(TOP Taobao Open Platform)的平台设计思路,充分借鉴Spring MVC的技术架构原理开发的一个快速服务开放平台开源框架项目,可以让您迅速构建成熟的SOA服务平台。它不同于传统的SOAP Web Service和Rest Web Service这些Web Service 技术型框架,Rop是一个应用型的Web Service平台框架,它不但可以方便快捷地开发一个个Web Service服务,还提供了服务平台领域问题的整体解决方案。因此,...
传统的Web Service框架帮助你建造房子,而Rop框架帮助您建造城市。
Rop项目文档前后写了一个多月,在写的过程中发现很多功能不完善的,又回过头了改项目,此种反复多次,现在Rop开源项目的文档已经差不多了,将陆续在iteye此发出,希望对大家有帮助。在Rop项目的开发过程中得到了众多iteye网友的有力帮助,收到了很多很好的整改的意见,在此对他们的奉献和帮助表示诚挚的感谢,这些网友包括但不限于:
melin
kellokitty
風一樣的男子
lioliang
木木的爱情童话
devotionalist
ericliang
Rop相关资源:
1.github:
https://github.com/itstamen/rop
2.群组:
http://rop.group.iteye.com/
目录
1.快速了解Rop
2.请求服务模型
3.应用授权及验证
4.服务会话管理
5.错误处理模型
6.响应报文控制
7.文件上传
8.服务安全控制
9.拦截器及事件体系
10.性能调优
11.开发客户端SDK
12.参考资料
分体式报文模型
服务开放平台对服务的处理结果统一由响应报文告之调用终端,不管服务处理正确与否,都必须对应一个响应报文。如果响应报文既要包含正确的业务响应报文,又要包括错误的响应报文,将增加服务响应报文格式的复杂度。由于Rop已经建立了一个可以描述所有类型错误的错误模型,因此错误响应报文的格式是统一的。业务服务的结果响应报文是业务相关的,也就是说,每个业务服务方法的正确业务响应报文是不一样的。
基于以上的分析,Rop将正确业务响应报文和错误处理响应报文独立开来,这样服务平台的开发者仅需设计正确的业务响应报文即可,错误响应报文直接由Rop提供。如果服务正确执行,返回正确的业务响应报文,否则返回Rop格式的错误响应报文。
响应报文定义
Rop的服务方法可以返回任何类型的对象,通过JSR 222注解进行对象流化定义。只要定义好响应类,并正确标注JSR 222注解,业务响应报文也就定义好了。
代码清单CreateUserResponse .java:服务响应的返回对象
package com.rop.sample.response;
import javax.xml.bind.annotation.*;
@XmlAccessorType(XmlAccessType.FIELD) ①
@XmlRootElement(name = "createUserResponse")
public class CreateUserResponse{
@XmlAttribute ②
private String userId;
@XmlAttribute
private String createTime;
@XmlElement
private Foo foo = new Foo();
@XmlElement
private String feedback;
…
}
在上节的addUser(CreateUserRequest request)服务方法中,如果一切服务执行正常,将返回一个CreateUserResponse的对象。
运行rop-sample项目的UserServiceRawClient#testAddUserByVersion1()测试方法,将看到如下的响应报文:
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<createUserResponse createTime="20120101010101" userId="1">
<foo field2="2" field1="1"/>
<feedback>hello</feedback>
</createUserResponse>
观察以上的输出报文,可以看到createTime和userId以元素属性的形式出现,而foo和feedback则以子元素的形式出现。
报文输出格式
默认情况下,Rop的响应报文是以XML的格式输出的。除XML之外,Rop还支持JSON格式的响应报文。您只要将format的系统级参数设置为json,就会返回JSON格式的响应报文了。
运行rop-sample项目的UserServiceRawClient#testAddUserWithJsonFormat()测试方法,您将看到如下的输出:
{"userId":"1","createTime":"20120101010101","foo":{"field1":"1","field2":"2"},"feedback":"hello"}
值得注意的是,当前Rop不支持混合使用XML和JSON的报文格式,也即请求和响应的数据格式要么采用XML,要么采用JSON。如果希望采用XML格式的请求参数值,那么响应的报文也必须是XML。
报文的国际化支持
Rop使用locale系统级参数指定本地化的信息,默认的locale值为zh_CN,服务平台将根据locale值的不同返回相应的本地化报文信息。由于错误报文是由Rop框架全权负责的,因此错误报文的国际化问题,Rop本身已经提供了解决方案。目前,Rop为系统级错误提供了zh_CN和en两个国际化资源文件。
运行rop-sample的UserServiceRawClient#testI18nErrorMessage()测试方法,该方法将发起两次对user.add服务方法的调用,其中请求参数都相同,唯有locale的值不同:第一次为locale=en,第二次为locale=zh_CN。第一次服务调用返回的错误响应报文为:
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<error code="33">
<message>Invalid Arguments</message>
<solution>
check the Required application parameter is valid(refer the subError message)
</solution>
<subErrors>
<subError code="isv.parameters-mismatch:salary-and-yyy">
<message>
incoming parameter salary and aaa does not match, both have a certain correspondence between
</message>
</subError>
</subErrors>
</error>
第二次服务调用返回的错误响应报文:
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<error code="33">
<message>非法的参数</message>
<solution>请查看根据服务接口对参数格式的要求</solution>
<subErrors>
<subError code="isv.parameters-mismatch:salary-and-yyy">
<message>传入的参数salary和aaa不匹配,两者有一定的对应关系</message>
</subError>
</subErrors>
</error>
正确的业务响应报文由服务平台开发者负责,因此国际化的工作也由服务平台开发者负责。在服务方法内部,可以通过request.getRopRequestContext().getLocale()获取请求参数locale对应的本地化对象,进而控制响应对象的国际化输出。如果服务开放平台没有国际化的需求,可以不关注locale参数。
分享到:
相关推荐
Rop开发手册,内容详尽,开放平台框架,易使用易扩展
Rop,即Rapid Open Platform,是一个参考淘宝开放平台(TOP Taobao Open Platform)的平台设计思路,充分借鉴Spring MVC的技术架构原理开发的一个快速服务开放平台开源框架项目,可以让您迅速构建成熟的SOA服务平台。...
rop开放平台s
Rop(Rapid Open Platform)是借鉴淘宝开发平台(TOP:Taobal Open Platform)实现的全功能Rest Web Service 开源框架(Full-Stack)。 它高于CXF,Aixs等一般的纯技术Web Service框架,提供了请求/响应序列化、数据...
RopRop 开发类似于淘宝 开发类似于淘宝 开发类似于淘宝 开发类似于淘宝 服务开放平台 服务开放平台 服务开放平台 这样的服务平台 这样的服务平台 这样的服务平台 这样的服务平台 。RopRopRop充分借鉴了当前大型网站...
ROP 是一种计算协议,旨在发现所有读数的来源,这些读数源自复杂的 RNA 分子、重组抗体和微生物群落。 ROP 占 poly(A) 和核糖耗竭协议所有读数的 98.8%,而传统的基于参考的协议为 83.8%。 ROP 分析重复、circRNA、...
本文是借助maven搭建的一个rop框架,以及一个简单的测试用例,供大家学习分享。如果发现不对的地方,希望大家留言提出,
通过method参数指定具体API服务:如taobao.user.get、taobao.users.get等。相比于http://host/user/tom,TOP使用http://gw.api.tbsandbox.com/router/rest?method=taobao.user.get&userName=tom,乍看起来纯REST简单...
rop-plus rop框架修改加强版:) 2014-06-24 重新整理版
Rop,即Rapid Open Platform,是一个参考淘宝开放平台(TOP Taobao Open Platform)的平台设计思路,充分借鉴Spring MVC的技术架构原理开发的一个快速服务开放平台开源框架项目,可以让您迅速构建成熟的SOA服务平台。...
rop基础
用友T6金牌服务课程班培训课件:生产数据及ROP运算.ppt
9月25日,SyScan360 2013国际前瞻信息安全会议在北京国家会议中心举行。安全专家Nguyen Anh Quynh同与会者共同探讨《OptiROP:ROP gadgets搜寻神器》这一议题,并现场传授使用OptiROP的方法。
基于ROP的SAMPLE开发代码,属于通信框架的一部分。ROP是淘宝提供的一种开发协议框架,底层基于NETTY。
apple-ropApple里面集成陈雄华的ROP框架,详细介绍参考
pwn学习资料整理——ROP技术(pwn_rop1)
arm64_rop_exploit arm64 rop小工具二进制文件,用于将arm64反向外壳程序代码映射到内存中并执行代码这仅适用于目标arm64设备。 用于将rop小工具映射到内存中并从libc库执行shell代码的源代码。 在运行Ubuntu 18.04....