thx / rap Goto Github PK

2014年7月15日 ～ 本月底业务项目较重，不紧急的项目问题修复暂停2星期，技术支持永不停止。影响使用的严重问题依然支持。谢谢！

• 数组在控制台中的输出不正确
• 添加参数时的focus位置跑到最上面了（受自动排序功能的影响），修改为在最底部（靠近添加按钮）处添加。
• 有时保存后TAB切换页面样式会乱

由于JSON.stringify的格式化不支持function，所以进行了toString处理，但是这种方案会使函数变成字符串，并且实现的问题导致控制台不能直观的看到最终的MockJS结果。

场景描述

国际站AE公共库使用了seajs并在业务代码执行前提前加载了jQuery，导致无法正常加载到RAP插件修改后的jQuery

使用seajs alias配置不会影响已经加载过的jQuery

删除cache中的jQuery条目后，业务的seajs.use依然不能重新访访问新的jQuery

临时解决方案

增加参数seajs=false来禁用seajs的默认封装
在业务代码中调用

window.wrapJQueryForRAP && wrapJQueryForRAP($);

完成手动封装

TODO

重现CASE，看看是否可以通过RAP插件内部解决该问题。

目前RAP在校验数据结构上，只能以结构的方式，也就校验的范围是：

• 参数是否缺少/多余
• 参数类型是否正确

为了进一步校验，对后端返回数据的规则进行限定，这一块儿搞出第二套规则不如直接使用MockJS的语法。比如限定数组返回必须是3-6组，则填写

{
    "list|3-6" : []
}

IF-TEST在实现自动化测试时不知道CASE是如何编写的？是否考虑过规范约束的实现是否需要引入什么方法论或工具？

该issue已过期

已经更新到文档，该issue已过期，请以：

http://thx.github.io/RAP/tutorials

中 9.开放API部分中的描述为准:)

API1：返回RAP项目的模型数据，到接口层级。

路径和请求参数

http://{domain}/queryModel.do?projectId={projectId}&ver={ver}

{projectId}为项目ID
{ver}为版本号，不传默认返回当前版本

响应数据结构

返回的对象有3个字段，分别是：
model - 细化到action层级的项目模型信息
code - 错误码，正确返回200
msg - 错误消息，正确返回空字符串

EXAMPLE

链接：http://rap.domain.com/api/querySchema.do?actionId=1460&type=request

{"model":{"moduleList":[{"id":518,"pageList":[{"id":738,"interfaceList":[{"id":2024,"desc":"","reqUrl":"a","name":"某请求","reqType":"1"},{"id":2025,"desc":"","reqUrl":"bbb","name":"bbb","reqType":"1"}],"name":"某页面","intro":""}],"name":"某模块（点击编辑后双击修改）","intro":""}],"id":429,"name":"临时项目一会儿删掉不要动","ver":"0.0.0.4","intro":""},"code":200,"msg":""}

API2：返回具体一个接口的JSON Schema接口详情

路径和请求参数

http://{domain}/querySchema.do?actionId={actionId}&ver={ver}&projectId={projectId}&type={type}

其中
{actionId}为接口的ID
{ver}和{projectId}均为可选参数，同时出现表示指定某一版本的接口。
{type}值为request时表示返回请求参数的schema，其它值或不传默认返回响应参数的schema

响应数据结构

返回的对象有3个字段，分别是：
model - 细化到action层级的项目模型信息
code - 错误码，正确返回200
msg - 错误消息，正确返回空字符串

EXAMPLE

链接：http://rap.domain.com/api/querySchema.do?projectId=429&actionId=2024&ver=0.0.0.2

{"schema":{"id":2024,"$schema":"http://json-schema.org/draft-04/schema","properties":{"resParam":{"id":38393,"title":"某响应参数","description":"","format":"MOCKJS||","required":false,"type":"number"},"a":{"id":38392,"title":"","description":"","format":"MOCKJS||","required":false,"type":""}},"required":"false","type":"object"},"code":200,"msg":""}

另外 “生成模拟数据”，“获取mockjs规则”这两个功能貌似很相似，可以删掉一个？

导入API Blueprint工具到RAP，全面支持Blueprint API规范。所有文档手册、应用提供英语支持。

进度

• 可导入的Blueprint API工具调研
• RAP数据 => Blueprint API转换器
• 导入第一个Blueprint API工具 (Aglio)
• 提供英文RAP (release_en分支)
• Blueprint API => RAP数据转换器
• 最后将RAP推送到Blueprint API官网实现互通
• dredd - 后端自动化测试工具导入
• 进一步提升转换器支持程度

/mockjsdata/后端生成Mock数据不支持自定义函数

发现后端Node.js的自定义函数情况不能正常解析...

比如：http://thx.github.io/RAP/demos/
中的页面，都无法正常访问（貌似提示的是只能阿里内网才可以访问）
是否可以提供一个外部能正常访问的DEMO？

RAP插件在处理Sea.js时是通过修改Seajs的alias来使后面seajs.use引入期望的RAP插件包装过的jQuery.js。

如果因为客户业务需求导致RAP插件执行前，jQuery一定要预先加载，则该拦截方法失效。

咨询seajs的技术支持，目前没有很好的解决办法。

结合大家讨论，目前最好的方案是：

/demo/mock.plugin/casebox/case1_seajs_jquery_preload.html

采用拦截seajs.use方法，并做一次wrapJQueryForRAP调用即可解决。

调试发现是由于rap.js 中Validate.validForm 有问题, 应该修正为

// var list = form.elements;
var list = form;

需求

为和Blueprint API对接，并结合开源社区的优势，RAP需要有国际化的版本。

跟踪

• 英文版界面的分支，暂定release-en（暂时英汉两版够用鸟）
• 英文介绍视频，上传至YouTube #postponed#
• 英文文档中心
• 英文README.md
• 增加需求：提供unit-test外网用户部署所使用的UT的SQL脚本。最好能够内置化，用于UT的工程对外不可见。tb_project增加bit1类型的hidden字段。 #postponed#

Deadline

2014.09.30

虽然看不见这个删除图标, 但删除功能是可以正常使用的, 只是需要小心地找到那个可以点击的区域去触发删除功能

请求链接复制功能(&actionId=xxxx)

修复路径写死的问题，对类似问题做复查，防止公司外或其它自行部署服务的用户使用自己的域名后无法正常工作。

• pageTester高版本IE浏览器下控制台不能正常工作。
• IE8 & 8- 浏览器没有给出兼容警告。
• 在保存后有时切换TAB会出现样式问题
• 只读模式下查看文档，会有间距小问题

目前RAP中使用JSON导入时，如果是数组，只导入第一组数据。
用户在导入一些逻辑数据时会发生丢失。

需求

导入数据后不做任何修改默认产出与导入一样的数据，且保持正确的文档结构。

跟踪

• 实现MockJS的@order指令 @nuysoft
• 需要实现JSON导入时载入枚举、数组长度(length > 1)信息。@Bosn

MockJS 有序枚举详解

例如用户导入一组数据为：

[{
    "a" : 1,
    "b" : true
}, {
    "a" : 222,
    "b" : false
}, {
    "a" : 243,
    "b" : true
}]

为生成的MockJS模板，可以导出上面的数据，需要指定每个字段的值，并且要保证顺序。

MockJS模板示例

例如MockJS模板（猜想的、或者期望的支持方式）

// 这也是目前MockJS的问题，不能指定最外层结构，请参考上次给出的渗透模型虚拟根节点的定义，这里__root__是虚拟根节点，|3表示有3组数据。
{
    "__root__|3" :  [{
        "a" : "@order(1, 222, 243)",
        "b" : "@order(true, false, true)"
    }]
}

通用RAP插件，通过拦截底层XmlHttpRequest解决路由拦截问题，防止多类库多版本兼容性问题带来的高额维护&开发工作量。

@xinglie 已经给出了第一版：
https://github.com/thx/RAP/blob/master/lab/rap.plugin.xinglie.js

http://thx.github.io/RAP/resources/RAP-deploy/#h5 初始化数据库的这个文档是不是有问题啊，另外我没看到 sql 里面有创建 database 的。
还有执行 /database/crate_table.sql 的时候，出现错误：
You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near 'tb_production_line' at line 1

新版本提供了两种类型的返回格式：对象、数组。
对于数组，希望返回的是一个数组对象，且能够让mock生成多个项。
但是设定了返回类型为数组，且设定了响应参数后，生成的数据（数组对象），长度一直是1。
是否有什么方式可以让其随机生成不同长度的数组对象？

偶发的，MockJS会访问错误的链接：

/mock/dist/dist/mock.js

1. 增加MockJS文档编辑视图，用户可以以Mock.js模板的视图编辑接口结构。
2. 保存前预览模拟数据。
3. MockJS标签与备注拆分。

在 com.taobao.rigel.rap.project.bo.Project.java 中用到了 org.ocpsoft.prettytime.PrettyTime, 但 WebContent/WEB-INF/lib 目录下却没有包含依赖的 prettytime.jar, 需要添加上去, 否则项目无法编译通过

dataType=String
remark=@mock=

时，空字符串被自动转换为默认值1，非用户所预期。

用户预期结果：
"val" : ""

• 项目编辑视图下的BU、产品线、分组修改。
• Can edit product line/group info in workspace page

自己想要的功能，方便JSON导入。

加入JSLint/JSHint的判断

目前的请求类型只有get和put
现在很多项目都使用restful架构
建议增加put，还有delete
restful相关信息点击下面
http://www.ruanyifeng.com/blog/2011/09/restful.html
http://www.infoq.com/cn/articles/designing-restful-http-apps-roth

实现接口(Action)级的位置变化操作

需求

实现接口(Action)级的位置变化操作。特别说明一下引用，表示不同的页面下引用其它的请求，修改会同步。实现上可能有点复杂...

跟踪

• UI、界面开发
• 移动功能：从一个位置、移动到另一个位置。
• 复制功能：从一个位置，复制到另一个位置。
• 挂载功能：另一个位置引用该接口

可否考虑对数据项增加xss选项，来模拟xss攻击数据。提前暴露安全问题

当执行如下语句时, 会执行失败

ALTER TABLE tb_project
ADD COLUMN update_time timestamp NOT NULL
        DEFAULT now();

Error Code: 1293. Incorrect table definition; there can be only one TIMESTAMP column with CURRENT_TIMESTAMP in DEFAULT or ON UPDATE clause

看错误描述, 是因为不能出现2个DEFAULT值是CURRENT_TIMESTAMP
因此需要做出如下修改:

ALTER TABLE tb_project
ADD COLUMN update_time timestamp NOT NULL;

并增加如下的初始化数据(初始公司, 产品线, 分组和历史项目)

INSERT INTO tb_corporation (id, name, logo_url, user_id) VALUES ('1', '测试公司', '', '1');
INSERT INTO tb_production_line (id, name, project_num, corporation_id, user_id) VALUES ('1', '测试产品线', '1', '1', '1');
INSERT INTO tb_group (id, name, production_line_id, user_id) VALUES ('1', '测试分组', '1', '1');

update tb_project set group_id = 1 where id >= 0;
update tb_project set update_time = current_timestamp where id >= 0;

在部署使用RAP时，无论是插件地址，还是跨域请求的host都是rap.alibaba.com，是否可以独立出来以配置的方式管理，谢谢

1. 希望支持字典对象的数据模拟,key和value都在mock里随机指定一个数组范围
   如

{
    airCompany:{
        "CA":"国航",
        "CZ":"南方航空"
    }
}

1. 希望模拟当前系统时间数据

{
    time : 1398062130000
}

类似淘宝开放平台：http://api.taobao.com/apitools/apiTools.htm?catId=4&apiName=taobao.item.recommend.add&scopeId=

用户不写变量名，自动生成的emptyIdentifier格式错误。

BUC账户接入有同学@乐东 发现了重复注册账户的问题。

排查中...

在有自定义函数时，隐藏MOCK标签的模式依然显示一个}
在一些为空情况下（如@mock=）没有正确隐藏

Release分支公网用户部署RAP，注册时出现create_date null错误

RT，客户端使用RAP插件，引用相应的URL，
同一个页面，调用一个接口（一个Project），能够正常执行。
但是如果调用多个接口（多个project），则后面的接口地址无法正常处理。
比如：

……

getProductList4Page接口数据获取正常，但是getUserList请求失败，提示找不到。（发现浏览器里面获取的地址是localhost，而不是rap的服务器，getProductList4Page地址是正确的）。

期待在部署手册中有所说明, 告知用户需要修改哪些连接数据库的配置, 以免出现部署失败的情况

jkd

# java -version
java version "1.7.0_45"
Java(TM) SE Runtime Environment (build 1.7.0_45-b18)
Java HotSpot(TM) 64-Bit Server VM (build 24.45-b08, mixed mode)

tomcat 7

注册用户时报错

<2014-06-25 18:21:35> <http-bio-8080-exec-3> com.opensymphony.xwork2.interceptor.ParametersInterceptor.setParameters(ParametersInterceptor.java:242) 
<ERROR> ParametersInterceptor - [setParameters]: Unexpected Exception caught setting 'passwordConfirm' on 'class com.taobao.rigel.rap.account.web.action.AccountAction: Error setting expression 'passwordConfirm' with value '[Ljava.lang.String;@4992d3b1'

<2014-06-25 18:21:35> <http-bio-8080-exec-3> org.hibernate.util.JDBCExceptionReporter.logExceptions(JDBCExceptionReporter.java:77) 
<WARN> SQL Error: 1048, SQLState: 23000

<2014-06-25 18:21:35> <http-bio-8080-exec-3> org.hibernate.util.JDBCExceptionReporter.logExceptions(JDBCExceptionReporter.java:78) 
<ERROR> Column 'create_date' cannot be null

Bosn实在受不鸟超级烂到家的Eclipse了！！！正在准备切换到IDEA社区版，有更好的推荐求介绍！

涉及请求连接：
/workspace/myWorkspace.action?projectId=354&actionId=1564

TEST

• 所有的MOCK默认规则升级导致的
• seajs BUG导致的
• 修复奇怪的/base请求错误

线上unit-test错误已全部修复，但是依然有console错误，具体错误信息如下。

目前项目只能在ROOT下部署, 有点不太适应, 不知道是否因为有其他方面的考虑而不支持自定义contextpath?

目前项目只能部署在ROOT下面, 例如http://localhost:8080/, 希望可以支持部署到自定义的contextpath, 例如http://localhost:8080/RAP

如上图所示：

后台报错如下：

<2014-08-11 16:23:30> com.opensymphony.xwork2.interceptor.ParametersInterceptor.setParameters(ParametersInterceptor.java:242)
ParametersInterceptor - [setParameters]: Unexpected Exception caught setting '' on 'class com.taobao.rigel.rap.mock.web.action.MockAction: Error setting expression '' with value '[Ljava.lang.String;@1e48fc3'

<2014-08-11 16:23:30> com.opensymphony.xwork2.interceptor.ParametersInterceptor.setParameters(ParametersInterceptor.java:242)
ParametersInterceptor - [setParameters]: Unexpected Exception caught setting '_ksTS' on 'class com.taobao.rigel.rap.mock.web.action.MockAction: Error setting expression '_ksTS' with value '[Ljava.lang.String;@e62ec'

<2014-08-11 16:23:30> com.opensymphony.xwork2.interceptor.ParametersInterceptor.setParameters(ParametersInterceptor.java:242)
ParametersInterceptor - [setParameters]: Unexpected Exception caught setting '_ksTS' on 'class com.taobao.rigel.rap.mock.web.action.MockAction: Error setting expression '_ksTS' with value '[Ljava.lang.String;@1e50694'

<2014-08-11 16:27:56> com.opensymphony.xwork2.interceptor.ParametersInterceptor.setParameters(ParametersInterceptor.java:242)
ParametersInterceptor - [setParameters]: Unexpected Exception caught setting 'b1407745676157' on 'class com.taobao.rigel.rap.workspace.web.action.WorkspaceAction: Error setting expression 'b1407745676157' with value '[Ljava.lang.String;@f29347'

请帮忙看一下是那部分的配置没有做好？