Skip to content

Commit

Permalink
doc
Browse files Browse the repository at this point in the history
  • Loading branch information
Bosn committed Feb 24, 2014
1 parent 3cbaf4b commit b531d75
Showing 1 changed file with 10 additions and 12 deletions.
22 changes: 10 additions & 12 deletions INTRO.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,8 @@ RAP的主要目标用户群有四种:

RAP所解决的问题,主要集中于中大型的企业级项目,接口形式有一定的复杂度。比如一个报表的请求,可能嵌套较多的层级。传统的方式描述较多嵌套的层级结构会较为麻烦,复制、移动等修改都消耗大量时间,而RAP通过GUI工具和结构分析可以很好的解决这些问题。再复杂的嵌套参数,一键复制和移动。展开、折叠毫不费力。RAP专为接口编辑而设计,在用户体验和细节上做了大量处理,保证高效、方便的接口文档编辑。

![RAP文档编辑区](http://gtms02.alicdn.com/tps/i2/T1chaxFwdbXXbNZB.a-2474-1456.png "RAP文档编辑区")

### 二、手写模拟数据耗费时间 ###

从设计阶段之后到联调之前,前端需要编写大量的自测数据来自测(尤其层级嵌套或CASE较多的情况会比较麻烦)。有了RAP告别手写自测数据,RAP会根据最新的接口文档动态实时的产生模拟数据,且结合MockJS支持深度定制的数据模拟规则。“一处写好,大家共享。”不管是自测、做DEMO,RAP在数据模拟上都可用最少时间,达到最大产出。对于前端,RAP模拟请求返回生成靠谱的自测数据,对于后端,RAP根据接口文档中定义的参数格式伪造实际请求以此测试后端实际接口的准确性。
Expand All @@ -59,6 +61,8 @@ RAP中对接口文档的编辑提供了一套可视化界面,编辑操作像Ex

RAP的MOCK数据是动态生成的,默认数据会有自己的初始行为,您也能通过标签精细的控制数据生成的逻辑。这也为后续我们创建”响应参数“的数据创造基础。目前RAP支持[MockJS](http://mockjs.com)和RAP MOCK两种Mock规则,后续还会进行更多扩充。

![RAPv0.8请求流程](http://gtms02.alicdn.com/tps/i2/T1laKBFphXXXbNpIQO-1330-592.png "RAPv0.8请求流程")

### 三:集合THX平台发挥更大的优势 ###

RAP生成的数据通过跨平台Crox模板引擎可打通多平台,意味着RAP MOCK的用武之地不再局限于JSONP、JSON形式的接口,Velocity、Smarty等后端模板语言调用RAP MOCK服务依然可行,实现“一处编写、到处使用。”
Expand All @@ -71,20 +75,14 @@ RAP第一版在2010年中完成开发,历经了3年多的实际应用,无论

在文档结构化后再利用上,接口文档是第一个尝试,我们也在努力挖掘更多的可再利用文档,用以提升其它的重复劳动,我们也在努力让现有功能更加完善。无论你是前端、后端还是测试,有了RAP,文档共享和开发将更为方便。

## DEMO截图 ##

### RAP文档编辑区 ###
## RAP v1.0 ##

![RAP文档编辑区](http://gtms02.alicdn.com/tps/i2/T1chaxFwdbXXbNZB.a-2474-1456.png "RAP文档编辑区")

### RAPv0.8请求流程 ###

![RAPv0.8请求流程](http://gtms02.alicdn.com/tps/i2/T1laKBFphXXXbNpIQO-1330-592.png "RAPv0.8请求流程")

### RAPv1.0请求流程 ###
在即将到来的RAPv1.0版本中,我们会增加分布式的NodeJS客户端,支持Web服务器与RAP的深度结合,利用反向代理解决Mock服务跨域问题,支持离线存取,分散服务器Mock压力,并在客户端实现更多强大的功能。

![RAPv1.0请求流程](http://gtms04.alicdn.com/tps/i4/T1uMyyFtxbXXcs5az5-1798-948.png "RAPv1.0请求流程")

### RAPv1.0规则编辑和同步流程 ###
![RAPv1.0规则编辑和同步流程](http://gtms03.alicdn.com/tps/i3/T1lZqAFBNXXXXdFSzs-1458-300.png "RAPv1.0规则编辑和同步流程")

## 关于RAP ##

![RAPv1.0规则编辑和同步流程](http://gtms03.alicdn.com/tps/i3/T1lZqAFBNXXXXdFSzs-1458-300.png "RAPv1.0规则编辑和同步流程")
RAP由阿里妈妈用户体验部开发,属于[THX](http://thx.alibaba-inc.com)平台的产品之一。欢迎大家访问[RAP主站](http://rap.alibaba-inc.com),有任何疑问欢迎邮件至:[[email protected]]([email protected])。RAP诚挚的期待您的光临!

0 comments on commit b531d75

Please sign in to comment.