接入说明
- 通过WeBASE管理平台获得注册信息,并通过API向WeBASE注册服务。
- 通过WeBASE提供的基础能力API和WeBASE连通。
WeBASE-APP-SDK是应用集成SDK,提供调用WeBASE-Node-Manager的接口,方便WeBASE管理台接入第三方应用。 从开始,提供应用集成SDK,方便应用接入。接口API可以查看WeBASE通用API。调用之前需要添加依赖和初始化应用信息。
v1.5.1
及其以上版本,应用配置AppConfig的属性isTransferEncrypt
需和WeBASE-Node-Manager的配置文件/conf/application.yml
下的配置constant.isTransferEncrypt
相同,默认为true
。- 如果
v1.5.0
需要使用SDK,应用配置AppConfig的属性isTransferEncrypt
需设置为false
。v1.5.1
及其以上版本新增的接口调用不了。
添加依赖
- 添加 SDK 的依赖,以Gradle为例
- 应用配置
public class AppConfig {
// 节点管理服务地址
private String nodeManagerUrl;
// 应用Key
private String appKey;
// 应用密码
private String appSecret;
private boolean isTransferEncrypt;
}
- Http请求配置
调用示例
public class ClientTest {
// WeBASE-Node-Manager的url
private static String url = "http://localhost:5001";
private static String appSecret = "65KiXNxUpPywVwQxM7SFsMHsKmCbpGrQ";
private static boolean isTransferEncrypt = true;
private static AppClient appClient = null;
public static void main(String[] args) {
try {
initClient();
appRegister();
} catch (Exception e) {
e.printStackTrace();
}
System.exit(0);
}
public static void initClient() {
// 未设置httpConfig时,默认http连接均为30s
HttpConfig httpConfig = new HttpConfig(30, 30, 30);
appClient = new AppClient(url, appKey, appSecret, isTransferEncrypt, httpConfig);
System.out.println("testInitClient:" + JacksonUtil.objToString(appClient));
}
public static void appRegister() throws Exception {
ReqAppRegister req = new ReqAppRegister();
req.setAppIp("127.0.0.1");
req.setAppPort(5001);
req.setAppLink("https://127.0.0.1:5001/");
appClient.appRegister(req);
System.out.println("appRegister end.");
} catch (Exception e) {
e.printStackTrace();
}
}
}
签名
使用SDK时,SDK会自动填充。
- 每个URL请求需带以下三个参数:
签名规则
使用MD5对timestamp
、appKey
加密并转大写得到签名值signature
- 参数值:
参数 | 参数值 |
---|---|
timestamp | 1614928857832 |
appKey | fdsf78aW |
appSecret | oMdarsqFOsSKThhvXagTpNdoOcIJxUwQ |