目录
1、准备工作
1.1、获取tonweb授权(开发license.dat一般三个月有效期)
1.2、jar包文件。
1.3、license.dat文件
2、pom.xml中修改配置依赖
3、application.yml中修改项目配置。
3.1添加license文件属性配置,如下:
3.2修改Server容器相关配置,如下(若没有,可以忽略)
4、修改本地服务器时间(如果测试license未过期,可忽略)
5、启动验证。
5.1完成上述操作之后,正常启动项目
5.2调用接口,验证是否成功。
1、准备工作
1.1、获取tonweb授权(开发license.dat一般三个月有效期)
访问东方通官网https://www.tongtech.com/sy.html,点击右下角联系我们,点提交问题,一般一天内会有支撑人员联系我们,一般通过微信发送开发手册给我们
1.2、jar包文件。
如下图所示,按功能和版本需求选取对应的jar包文件,可以将jar包上传到nexus maven私服仓库,在从pom文件引用,以7.0.E.5.P3为例,若已有jar包,可忽略
1.3、license.dat文件
2、pom.xml中修改配置依赖
我们使用的springboot项目中使用了spring-boot-starter-web依赖,而spring-boot-starter-web这个依赖默认使用的是spring-boot-starter-tomcat这个依赖;所以我们只需要排除spring-boot-starter-tomcat依赖,然后再把TongWeb对应的starter加入进来即可,如下图所示,以7.0.E.5.P4为例:
如果需要tongweb容器集成其他的功能,需要添加额外的依赖如:
功能 | 依赖 |
集成JDBC | tongweb-spring-boot-data-jdbc-starter |
集成gmssl安全通信库(国密) | tongweb-gmssl |
JSP支持 | tongweb-jsp |
注:东方通和Springboot大版本对应关系
Springboot版本 | 东方通版本 |
spring-boot版本为1.*.* | tongweb-spring-boot-starter-1.x |
spring-boot版本为2.*.* | tongweb-spring-boot-starter-2.x |
spring-boot版本为3.*.* | tongweb-spring-boot-starter-3.x |
3、application.yml中修改项目配置。
3.1添加license文件属性配置,如下:
server:
tongweb:
license:
type: file # 定义license文件类型
path: /Users/xingguangming/Downloads/license - 2023-03-17T101916.225.dat #license文件存放绝对路径
# path: classpath:tongweb/license - 2023-03-17T101916.225.dat #license文件存放相对路径
3.2修改Server容器相关配置,如下(若没有,可以忽略)
在application.yml中配置的server相关参数都是tomcat的,使用tongweb替换了tomcat后,相关的server参数需要修改。(图中以application.properties为例)
4、修改本地服务器时间(如果测试license未过期,可忽略)
因为东方通TongWeb试用版的license需要专有渠道获取,所以现以试用版的license测试使用。如果license已经过期,所以需要通过修改本地服务器的时间来模拟license的验证。已知license.dat的有效期包含2024/03/17当天,所以把服务器时间改为【2024/03/17】,即可正常通过license验证。
5、启动验证。
5.1完成上述操作之后,正常启动项目
可以在IDEA控制台看到输出【TongWeb】图案。