SpringBoot多环境+docker集成企业微信会话存档sdk

dockersdk_0">SpringBoot多环境+docker集成企业微信会话存档sdk

文章来自于 https://developer.work.weixin.qq.com/community/article/detail?content_id=16529801754907176021

dockersdk_7">SpringBoot多环境+docker集成企业微信会话存档sdk

对于现在基本流行的springboot环境，官方文档真是比较坑的，基本都要自己摸索。

以下代码大家根据自己项目调整，无需生搬硬套，代码不重要，主要了解到其中的思路和坑点。

一. 主要目录结构

hell
├─src
│ ├─main
│ │ ├─java
│ │ │ └─com
│ │ │   ├─ft
│ │ │   │ └─qb
│ │ │   │   └─job
│ │ │   │     └─biz
│ │ │   │       └─employee
│ │ │   │        └─qywx
│ │ │   │          └─QywxMessageWinJob.java		# 业务主入口，定时任务执行入口
│ │ │   └─tencent
│ │ │     └─wework
│ │ │       └─Finance.java								# 企业微信sdk中的Finance.java文件copy过来（切记，包名不能错）
│ │ └─resources
│ │   ├─config
│ │   └─lib
│ │     └─qywx
│ │       └─linux
│ │       	 └─libWeWorkFinanceSdk_Java.so				# 企业微信linux sdk中的同名文件
│ │       	 └─libWeWorkFinanceSdk.so				# copy自libWeWorkFinanceSdk_Java.so，改名
│ │       └─win
│ │       	 └─libcrypto-1_1-x64.dll				# 企业微信linux sdk中的同名文件
│ │       	 └─libcurl-x64.dll						# 企业微信linux sdk中的同名文件
│ │       	 └─libssl-1_1-x64.dll					# 企业微信linux sdk中的同名文件
│ │       	 └─WeWorkFinanceSdk.dll					# 企业微信linux sdk中的同名文件

注意：

Finance.java文件的包名千万不能错，一定要是com.tencent.wework。

- linux下的sdk中libWeWorkFinanceSdk_Java.so要改名为libWeWorkFinanceSdk.so，后面都是使用这个libWeWorkFinanceSdk.so。别TM问为什么，我也想知道为什么，腾讯的程序员不出来解释一下么？文档中没有提及，完全的大坑，我也是看了某个老兄的帖子才改的。

实际项目截图：

在这里插入图片描述

二. 改造Finance.java文件

因为sdk是分win和linux环境的，所以我们需要对Finance.java进行一些改造，使之可以判断win和linux环境，自动切换加载的dll或so文件。

修改static部分的代码：

avastatic {if (isWindows()) {// win。获取4个dll的实际位置，下边使用System.load来加载dll。String path = System.getProperty("user.dir") + "\\src\\main\\resources\\lib\\qywx\\win\\";path = path.replaceAll("%20", " ").replaceFirst("/", "").replace("/", "\\\\");//加载顺序不能变System.load(path.concat("libcrypto-1_1-x64.dll"));System.load(path.concat("libssl-1_1-x64.dll"));System.load(path.concat("libcurl-x64.dll"));System.load(path.concat("WeWorkFinanceSdk.dll"));} else {// linux。加载指定so文件在linux系统下的位置。// docker的话这行也可以不要。这里有点小坑，后文会讲。System.load("/usr/lib/libWeWorkFinanceSdk.so");}//这行是本身Finance.java就有的，别丢掉。System.loadLibrary("WeWorkFinanceSdk");}public static boolean isWindows() {String osName = System.getProperties().getProperty("os.name");return osName.toUpperCase().indexOf("WINDOWS") != -1;}

自建一个isWindows()方法来判断当前的运行环境。然后在static中根据环境加载不同的dll和so就可以了。

三、win & linux

在win或linux运行，看一下主程序调用入口文件QywxMessageWinJob.java。

package com.ft.qb.job.biz.employee.job;import com.tencent.wework.Finance;import com.xxl.job.core.handler.annotation.XxlJob;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;import java.io.File;
import java.lang.reflect.Field;/*** 用于调用企业微信接口，获取会话存到内容，持久化到数据库*/
@Component
@Slf4j
public class QywxMessageWinJob {@Value("${project.qywx.session-message.corpid}")private String corpid;@Value("${project.qywx.session-message.secret}")private String secret;@XxlJob("QywxMessageJob_syncMessage")public void syncMessage() {try {long ret = 0;//使用sdk前需要初始化，初始化成功后的sdk可以一直使用。//如需并发调用sdk，建议每个线程持有一个sdk实例。//初始化时请填入自己企业的corpid与secrectkey。long sdk = Finance.NewSdk();ret = Finance.Init(sdk, this.corpid, this.secret);}catch(Exception e){log.error("企业微信会话sdk初始化失败：", e);throw e;}log.info("sdk加载成功了，继续!!!");}}

只要上一步Finance.java别改错，基本上就run通了。

docker_214">四、docker

docker环境比较特殊。

一定要注意不要使用alpine版本的java镜像做基础镜像，会丢失一些基础的so文件，导致sdk加载失败。

 基础镜像FROM openjdk:17-jdk-alpine

比如我一开始是openjdk:17-jdk-alpine镜像，当Finance.java执行到System.loadLibrary(“WeWorkFinanceSdk”)的时候，会报错找不到ld-linux-x86-64.so.2

java.lang.UnsatisfiedLinkError: /usr/lib/libWeWorkFinanceSdk.so: Error loading shared library ld-linux-x86-64.so.2: No such file or directory (needed by /usr/lib/libWeWorkFinanceSdk.so)

将libWeWorkFinanceSdk.so放入docker镜像中。在DockerFile中加一行copy libWeWorkFinanceSdk_Java.so

# 基础镜像FROM openjdk:17-jdk# copy libWeWorkFinanceSdk_Java.soCOPY src/main/resources/lib/qywx/linux/libWeWorkFinanceSdk.so /usr/lib/libWeWorkFinanceSdk.soADD target/app.jar app.jar# 更改为中国时区RUN ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtimeRUN echo 'Asia/Shanghai' >/etc/timezone# 启动容器时执行ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-Ddruid.mysql.usePingMethod=false","-jar","app.jar"]# 使用端口80EXPOSE 29202 29203

这里如果加了这行copy，因为jdk容器中，/usr/lib属于java的运行时目录，所以Finance.java文件中的 System.load(“/usr/lib/libWeWorkFinanceSdk.so”); 这行加不加是无所谓的。

下边执行的System.loadLibrary(“WeWorkFinanceSdk”);会自动在/usr/lib目录中加载到WeWorkFinanceSdk的。

如上，根据自己的项目改改，基本都是可以run通的。

使用端口80

EXPOSE 29202 29203

这里如果加了这行copy，因为jdk容器中，/usr/lib属于java的运行时目录，所以**Finance.java**文件中的**System.load("/usr/lib/libWeWorkFinanceSdk.so");**这行加不加是无所谓的。下边执行的**System.loadLibrary("WeWorkFinanceSdk");**会自动在/usr/lib目录中加载到**WeWorkFinanceSdk**的。如上，根据自己的项目改改，基本都是可以run通的。