TongWeb7.0.E.6_P11嵌入式版本使用指引（by lqw）

文章目录

声明

1.本文参考001_TongWeb_V7.0嵌入式版_JavaEE标准容器用户指南_70E6_P11A01.pdf，实际以最新更新的手册为准。

2.本文仅说明在本地开发环境如何操作，转换工具以及其他方面内容请看用户手册与配置示例。

3.本文会同时示范安装包里的示范工程spring-boot-helloWorld-2.x。

4.本文仅示范如何用本地maven引入相关依赖，如果要将依赖引入到远程仓库，请自行阅读手册。

5.针对于应用打包方式为jar包，使用springboot的项目（使用war包部署，之前用tomcat部署的，请考虑使用Tongweb企业版）

相关概念

手册的使用

一般用JavaEE标准，参考安装包里的用户手册里的001_TongWeb_V7.0嵌入式版_JavaEE标准容器用户指南_70E6_P11A01.pdf。

使用JakartaEE标准，参考002_TongWeb_V7.0嵌入式版_JakartaEE标准容器用户指南_70E6_P11A01.pdf（springboot版本要求3.x）。

使用springcloud，尤其使用springgetaway的，参考003_TongWeb_V7.0嵌入式版_响应式编程容器用户指南_70E6_P11A01.pdf。

已打包成应用jar包的，可参考004_TongWeb_V7.0嵌入式版_转换工具指南_70E6_P11A01.pdf。(如果本身没有开发环境的，再考虑这一步)

相关手册均在安装包的用户手册与配置示例。

示范工程

示范工程也在安装包里（可根据自身需求进行参考）：

安装工程介质

通俗点说，就是tongweb的相关依赖jar包，如下图所示：

tongweb-embed-7.0.E.6_P11.zip 为java_EE和JakartaEE使用的安装介质，使用前需解压。

tongweb-gmssl-1.0.0.zip 为国密使用的安装介质，使用前需解压。

tongweb-spring-boot-reactor-7.0.E.6_P11.zip 为微服务相关的安装介质，使用前需解压。

tongweb-transform-7.0.E6_P11.zip,为转换工具，使用前需解压。

安装前准备

1.本地window已配置jdk环境变量。

参考：Windows配置JDK环境变量

2.本地window已配置maven环境变量，并在maven的setting文件里配置好本地仓库目录。

参考：maven环境变量配置（超详细！）

3.确保本地项目代码能正常运行和打包。

4.联系东方通的销售人员获取安装包和授权文件。

示范工程参考（spring-boot-helloWorld-2.x）

spring-boot-helloWorld-2.x在安装包的路径如下：

里面一般有个使用说明：

使用idea引入该项目，并配置好maven（包括maven的setting文件里的本地仓库目录）

引入后先在这里加个mavenplus的版本，避免之后爆红：

配置后解压安装包里的tongweb-embed-7.0.E.6_P11.zip：

解压后双击installMavenJar.bat

执行成功后，到idea里，刷新maven。

刷新maven后，在项目的resource目录下放入license.dat（也就是授权文件），然后配置license.dat路径：

server.tongweb.license.path=classpath:license.dat

编码项目看看有没有报错：

没有报错的话，直接运行：

一般会输出授权信息，包括到期时间

由于我本地设置的是8089，所以访问8089进行测试：

示范参考

示范工程里由于已经引入了tongweb的依赖坐标，所以并不是所有的示范工程都使用于自己的项目，这个时候，可以参考一下手册。

以001_TongWeb_V7.0嵌入式版_JavaEE标准容器用户指南_70E6_P11A01.pdf为例，引入pom.xml的依赖坐标参考这一章节：

springboot1.x:

<!-- 排除springboot自带的tomcat依赖 -->
<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>
<!-- 添加tongweb-spring-boot-starter依赖 -->
<dependency>
  <groupId>com.tongweb.springboot</groupId>
  <artifactId>tongweb-spring-boot-starter-1.x</artifactId>
  <version>7.0.E.6_P11</version>
</dependency>

springboot2.x:

<!-- 排除springboot自带的tomcat依赖 -->
<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>
<!-- 添加tongweb-spring-boot-starter依赖 -->
<dependency>
  <groupId>com.tongweb.springboot</groupId>
  <artifactId>tongweb-spring-boot-starter-2.x</artifactId>
  <version>7.0.E.6_P11</version>
</dependency>

jsp:

<dependency>
  <groupId>com.tongweb</groupId>
  <artifactId>tongweb-jsp</artifactId>
  <version>7.0.E.6_P11</version>
</dependency

WebSocket(springboot1.x):

<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-websocket</artifactId>
</dependency>
<dependency>
  <groupId>com.tongweb.springboot</groupId>
  <artifactId>tongweb-spring-boot-websocket-1.x</artifactId>
  <version>7.0.E.6_P11</version>
</dependency>
<dependency>
<groupId>com.tongweb.springboot</groupId>
  <artifactId>tongweb-spring-boot-starter-1.x</artifactId>
  <version>7.0.E.6_P11</version>
</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>

配置后解压安装包里的tongweb-embed-7.0.E.6_P11.zip：

解压后双击installMavenJar.bat

执行成功后，到idea里，刷新maven，看看有没有报错，有没有引入tongweb的依赖。

在项目的resource目录下放入license.dat（也就是授权文件），然后配置license.dat路径(一般在application.properties里)，下面是参考格式

配置后看看是否有报错，有报错再根据报错，参考常见问题手册进行处理