一、概述
信创需要;
原状:原来的服务使用springboot框架,自带的web容器是tomcat,打成jar包启动;
需求:使用东方通tongweb来替换tomcat容器;
二、替换步骤
2.1 准备
获取到TongWeb7.0.E.6_P7嵌入版
这个文件,文件内容有相关对应的依赖包,可以根据需要来安装到本地或者上传到对应的maven仓库;
这个文件里面,也有对应的安装/上传依赖的执行文件,不用自己一个一个安装上传了:
2.2 修改pom.xml
spring-boot-starter-web
这个依赖默认使用的是spring-boot-starter-tomcat
这个依赖;我们只需要排除这个依赖,然后再把TongWeb对应的starter加入进来即可;
由于我的spring-boot使用的是2.*.* 版本,所以我们使用的依赖:
<dependency> <groupId>com.tongweb.springboot</groupId> <artifactId>tongweb-spring-boot-starter-2.x</artifactId> <version>7.0.E.6_P7</version></dependency>
-2.x
是和spring-boot的大版本对应:
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
修改后的pom.xml:
<dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> <exclusions> <exclusion> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-tomcat</artifactId> </exclusion> </exclusions> </dependency> <dependency> <groupId>com.tongweb.springboot</groupId> <artifactId>tongweb-spring-boot-starter-2.x</artifactId> <version>7.0.E.6_P7</version> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <scope>test</scope> </dependency></dependencies>
如果需要tongweb容器集成其他的功能,需要添加额外的依赖如:
功能 | 依赖 |
---|---|
集成JDBC | tongweb-spring-boot-data-jdbc-starter |
集成Websocket | tongweb-spring-boot-websocket |
集成gmssl安全通信库(国密) | tongweb-gmssl |
JSP支持 | tongweb-jsp |
2.3 配置application.yml
配置属性server.tongweb.*
server: port: 9099 tongweb: license: type: file path: classpath:tongweb/license 7.0.E嵌入式版-0506.dat
配置了 授权码
的类型和路径,路径推荐放到项目的tongweb文件夹里面:
注意:授权码的版本和我们依赖的jar包的版本一定要保持一致,否则会报如下错误:
2.4 启动验证
启动成功:
验证接口,请求成功: