文章目录
- 声明
- 相关概念
- 手册的使用
- 示范工程
- 安装工程介质
- 安装前准备
- 示范工程参考(spring-boot-helloWorld-2.x)
- 示范参考
声明
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里),下面是参考格式
配置后看看是否有报错,有报错再根据报错,参考常见问题手册进行处理