目录

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

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