springboot项目东方通TongWeb改造适配

springboot项目东方通TongWeb改造适配

一、背景

在全球化背景下，为确保国家安全、推动产业升级、满足市场需求和技术进步，国产化成为国家发展战略的重要组成部分，旨在打造一个更加安全、自主、可控的信息技术生态环境。本文章的背景就是客户企业响应国产化政策，要求系统能够适配东方通，在东方通TongWeb上部署运行。

二、改造项目介绍

本文章改造适配的项目是使用的前后端分离的框架，只记录后端springboot项目的改造适配的过程。改造的项目使用的springboot是2.4.3版本。项目在生产环境都是打包成jar包，用jar包部署运行。

三、适配东方通

本文章记录的适配方式有两种，一种是嵌入式适配，在pom.xml中直接配置依赖，嵌入内置TongWeb容器，替代Tomcat，适配完成后打包成可执行 jar 包，按照原来的jar包方式部署运行。另外一种是打包成可执行 war 包，使用TongWeb进行安装部署。
本次项目适配版本：
tongweb嵌入式版本是TongWeb7.0.E.6_P8。
TongWeb企业版的版本是TongWeb7.0.4.9_M3。

1.嵌入式适配

根据东方通官方文档介绍，TongWeb 嵌入式版 Web 容器需要结合 Spring Boot 框架应用，TongWeb 应用服务器运行所需的 jar 资源包，可以根据不同的场景进行引入分别支持以下四种方式引入容器依赖 jar 资源包。
方式一：pom.xml中直接配置依赖
方式二：嵌入可执行 jar 包
方式三：嵌入可执行 war 包
方式四：作为外部 jar 包
本次采用的适配方式是方式一，在pom.xml中直接配置依赖。

1.1 pom.xml中直接配置依赖

在springboot项目的pom.xml中配置tongweb-spring-boot-starter依赖，同时排除掉springboot自带的 tomcat 的依赖。（在前面改造项目介绍时提到了springboot的版本，是因为这种方式不同的springboot版本引入相关依赖的版本不同）