金蝶整合说明
1. 金蝶相关 jar 包依赖处理
解压下面的 zip 压缩包:AAMS-V10-embed.zip
将金蝶相关 Jar 包 install 安装到本地 Maven 仓库:
- springboot1.x 版本依赖安装:进入
starter-1.5文件夹 - springboot2.0-sprigboot2.4 版本依赖安装:进入
starter-2.1文件夹 - sprigboot2 中 2.4 以上版本依赖安装:进入
starter-2.4文件夹
注:
- websocket 相关的 jar 包依赖,安装也参考上面 mvn install 方式即可。(项目用到 websocket,才需要安装)
- jxbp 底座用的是 springboot2.3,所以这里我们安装金蝶 2.1.7 版本的依赖即可。
- 需要提前准备 Maven 构建管理工具,指定本地 Maven 仓库地址。
将金蝶相关 Jar 包 deploy 发布到 nexus 私服。
注: AAMS 相关的依赖已经发布到 nexus 私服,能连上私服的,上面的安装和发布操作可以不用处理。
shell
mvn install:install-file -Dfile=aams-spring-boot-starter-all-1.5.20.RELEASE.jar -DgroupId=com.apusic -DartifactId=aams-spring-boot-starter-all -Dversion=1.5.20.RELEASE -Dpackaging=jar
mvn install:install-file -Dfile=aams-spring-boot-starter-all-2.1.7.RELEASE.jar -DgroupId=com.apusic -DartifactId=aams-spring-boot-starter-all -Dversion=2.1.7.RELEASE -Dpackaging=jar
mvn install:install-file -Dfile=aams-spring-boot-starter-all-2.4.0.jar -DgroupId=com.apusic -DartifactId=aams-spring-boot-starter-all -Dversion=2.4.0 -Dpackaging=jar
shell
mvn deploy:deploy-file -Dfile=aams-spring-boot-starter-all-2.1.7.RELEASE.jar -DgroupId=com.apusic -DartifactId=aams-spring-boot-starter-all -Dversion=2.1.7.RELEASE -Dpackaging=jar -DrepositoryId="releases" -Durl="http://192.168.4.94:81/nexus/content/repositories/maven-releases"
2. springboot 项目处理
pom.xml 依赖处理
改成:
xml
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<!-- 排除 springboot 自带的 tomcat 依赖 -->
<exclusions>
<exclusion>
<artifactId>spring-boot-starter-tomcat</artifactId>
<groupId>org.springframework.boot</groupId>
</exclusion>
</exclusions>
</dependency>
<!-- 增加 aams 的 starter 依赖 -->
<dependency>
<groupId>com.apusic</groupId>
<artifactId>aams-spring-boot-starter-all</artifactId>
<version>2.1.7.RELEASE</version>
</dependency>
指定 license 文件路径
properties
# 指定金蝶 licpath 文件路径
server.aas.license-path=/home/root/license.xml
注:
- License 存放路径支持"本地磁盘路径"和"classpath 路径"。
3. 相关参数配置修改
properties
# tomcat 调优
# 等待连接数
server.tomcat.accept-count=1000
# 最大连接数
server.tomcat.max-connections=1000
# 最大线程数量
server.tomcat.max-threads=1000
# 最小线程数
server.tomcat.min-spare-threads=10
# tomcat 调优
# 等待连接数
server.aas.accept-count=1000
# 最大连接数
server.aas.max-connections=1000
# 最大线程数量
server.aas.max-threads=1000
# 最小线程数
server.aas.min-spare-threads=10
4. mvn 打包指定 pom.xml
一般来说,一个项目只需有一个 pom.xml 文件即可。
但是有时候,可能需要整合金蝶、东方通这些服务器中间件时,就需要将 springboot 内置的 tomcat 替换相应的中间件,这时虽然可以使用同一个 pom.xml 文件,但是每次打包都得改 pom.xml,这样使用起来很不方便。
这时,我们可以为不同的中间件创建对应的 pom.xml 文件。例如:
- 金蝶:可以创建一个
pomAams.xml文件; - 东方通:可以创建一个
pomTw.xml文件; - 本地测试时编译项目使用的还是
pom.xml文件。
当我们想打包金蝶相关的 jar 包时,可以使用下面的命令:
shell
# 指定 pom 文件打包:
mvn clean && mvn package -f pomAams.xml -Dmaven.test.skip=true
这样做的目的,是为了可以动态的切换打包的服务器中间件,也比较灵活,也能提交到 svn 中进行相关的记录。
pomAams.xml 和原来的 pom.xml 基本上是一样,只是加入了金蝶相关的依赖和去掉 tomcat 的依赖。