项目场景:
Linux环境springboot+maven项目集成sapjco3.jar,sapjco.jar
问题描述
sap由于没有提供maven导致maven项目中无法直接引用,官方只提供了jar包和.so文件,而且限制颇多,不允许对官方提供的jar改名,必须要能加载到.so文件等。可以把libsapjco3.so文件看成一个运行必要的脚本文件。所以项目中需要解决springboot+maven项目如何引入sap jar包问题。
解决方案:
1、引入本地官方jar包,如图所示,我在项目resources的lib下引入了sap的必要的jar和libsapjco3.so,然后使用dependency的scope为system导入到项目中,本地编译运行代码能查找到jar中的引用类
这里在项目中引入本地jar
2、定义pom.xml
上述第一步只是解决本地编译运行的时候能找到类,但是并不能把引入的jar包打到我们自己的jar包中,那我们定义的src/main/java/resouces/lib中的jar就需要配置打包插件打入我们自己的jar中。这么做的目的是因为sap的包是有检查不让改名的,如果我们直接用第一步导入并打包到我们的jar包那么它就会带版本号,jar包名称就会变成sapjco3-1.0.0.jar和sapjco-1.0.0.jar,这样改了jar名称真正去Linux环境运行的时候它会报错提示你不让修改sapjco3.jar的名称。
这里我采用spring-boot-maven-plugin打包插件。
resources标签定义资源文件的复制,src/main/resources/lib下的文件复制到BOOT-INF/lib下并排除libsapjco3.so的复制,排除libsapjco3.so原因是如果加入到BOOT-INFO/lib下线上运行自己jar包的时候会报错,提示libsapjco3.so不能进行压缩,这个脚本文件后面我们通过配置环境变量的形式让它加载到
3、配置完了上述步骤,执行maven的打包操作,查看target目录
BOOT-INF/lib中已经有我们的需要的sap jar包
查看我们系统自己的jar包BOOT-INF/lib下是否有sap的jar包(重中之重)。把自己的jar包(我的是plat-job-1.0.0.jar)复制到空的目录下解压查看
sapjco.jar和sapjco3.jar都还是原始名称,到此jar包已准备好
4、在Linux环境配置环境变量,使得能加载到libsapjco3.so文件
上传libsapjco3.so文件到JAVA_HOME目录下的jre/lib/amd64/server目录下,我的是/data/jdk1.8.0_231/jre/lib/amd64/server。
如果上传后libsapjco3.so文件不是绿色(可执行)那么需要赋予权限,执行Linux命令:chmod 777 libsapjco3.so
chmod 777 libsapjco3.so
执行Linux命令添加环境变量
vim /etc/profile
追加export LD_LIBRARY_PATH=$JAVA_HOME/jre/lib/amd64/server
保存退出重新加载环境变量执行Linux命令:source /etc/profile
source /etc/profile
5、上传自己的jar包(我的是plat-job-1.0.0.jar)到Linux系统运行测试
启动程序:java -jar plat-job-1.0.0.jar
java -jar plat-job-1.0.0.jar
启动完进行测试:
没有报类加载不到,说明已经成功了,我的报错是因为权限验证没通过,我这台主机没有访问权限哈和这个问题本身无关。
6、做到第五步已经解决了我们的问题,想了解为什么这么做需要先了解使用spring-boot-maven-plugin插件执行的过程,以及jar的结构等知识。
原因分析:
sap的jar使用有比较多的限制,我们的思路是保证jar包名称不修改的前提下能加载到jar包和libsapjco3.so执行文件。按照这个思路有很多实现方式(也尝试了jar包和classes分离的方式,通过设置-Dloader.path来指定外部依赖的加载,可行但很复杂),我上面这种是我自己在采用的方式,通过maven插件复制本地的jar到BOOT-INF/lib下,这样能保证引入的jar能被加载到,至libsapjco3.so文件就用配置环境变量的方式单独进行加载