Springboot适配嵌入式TongWeb(东方通)7.0版本

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】图案。

5.2调用接口，验证是否成功。