接口
接口可以提供Http服务让外部程序调用，使用Javascript编写，可以直接调用Java类。
入口
点系统的左上角导航->设计中心->服务管理->接口打开。
访问限制
如果“访问的地址表达式”不为空，那么只有匹配的地址可以访问，允许使用通配符。
接口调用
接口请求方式
http
请求地址
flag的值优先级为
1、别名不为空，使用别名;
2、名称不为空，使用名称;
3、也可以使用id作为flag。
请求方法
POST
请求标头
Content-Type: application/json
响应标头
Content-Type: application/json; charset=utf-8
接口调试
在 上图的服务中填写接口的标识（接口别名、名称或者ID），在JsonElement区域输入接口接收数据，然后点击POST进行调试，接口会在Result区域输出返回数据。
可以在接口中使用
print( text )在服务器控制台输出调试信息。输入和输出
在接口脚本中可以使用 requestText 来获取请求的内容。
在接口脚本的末尾使用直接量作为接口的输出。
样例: 在调用接口的时候提交的报文为 { "subject" : "接口测试样例" }，那么脚本中的获取为：
1
var requestJson = JSON.parse(requestText);
2
if( typeof(requestJson) === "string" ){ //某些情况下可能需要转换两次
3
requestJson = JSON.parse(requestJson);
4
}
5
var subject = requestJson.subject; //subject值为"接口测试样例"
6
7
var result = { "result" : "已获取subject"+subject };
8
result; //接口的输出
9
Copied!
最终接口的http request正文如下
1
{
2
"type": "success",
3
"data": {
4
"value": { //接口脚本的输出内容
5
"result": "已获取subject这是一个测试接口"
6
}
7
},
8
"message": "",
9
"date": "2019-08-18 18:09:24",
10
"spent": 397,
11
"size": -1,
12
"count": 0,
13
"position": 0
14
}
Copied!
当前用户
使用 effectivePerson 来获取当前用户。
如果未登录系统，返回如下：
1
{
2
"tokenType": "anonymous",
3
"token": "",
4
"name": "anonymous",
5
"unique": "anonymous",
6
"distinguishedName": "anonymous",
7
"debugger": true,
8
"remoteAddress": "115.216.34.235",
9
"uri": "/x_program_center/jaxrs/invoke/invokeTest/execute",
10
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:68.0) Gecko/20100101 Firefox/68.0"
11
}
Copied!
如果已登录系统，返回如下：
1
{
2
"tokenType": "user", //如果是管理员为manager
3
"token": "jlMh2guoFibWcTwR3NHdVTbw_ylqeq-uFLrLL9stmcruJSx7mPOjiX-euWIQv-ovp8orv1dTAwkavfdfdfdfdf",
4
"name": "张三",
5
"unique": "zhangsan",
6
"distinguishedName": "张三@[email protected]",
7
"debugger": true,
8
"remoteAddress": "115.216.34.235",
9
"uri": "/x_program_center/jaxrs/invoke/invokeTest/execute",
10
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/64.0.3282.140 Safari/537.36 Edge/17.17134"
11
}
Copied!
完整样例
更多样例可以查看 webServer/x_component_service_InvokeDesigner/sample/ 目录
Last modified 2yr ago