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 为转换工具，使用前需解压。

安装前准备

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里)，下面是参考格式


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