Merge pull request #303 from PathfinderAx/develop

feat(0): [java]-[mvn]-功能更新及缺陷修复 Close #300

clients/java/wechat-ferry-mvn/CHANGELOG.md

@@ -1,31 +1,81 @@
 ## v39.3.3
 
+### 版本列表
+
+下载地址：[v39.3.3](https://github.com/lich0821/WeChatFerry/releases/tag/v39.3.3)
+
+| 名称              | 版本        | 文件名                       |
+|-----------------|-----------|---------------------------|
+| 微信客户端           | 3.9.11.25 | WeChatSetup-3.9.11.25.exe |
+| WeChatFerry-SDK | 39.3.3    | v39.3.3.zip               |
+
 ### 功能列表
 
-| 接口名            | 地址                | 是否支持 | 备注                |
-|----------------|-------------------|------|-------------------|
-| 查询登录状态         | /loginStatus      | √    | 已测试               |
-| 获取登录微信内部识别号UID | /loginWeChatUid   | √    | 已测试               |
-| 获取登录微信信息       | /loginWeChatInfo  | √    | 已测试               |
-| 获取消息类型列表       | /list/msgType     | √    | 已测试               |
-| 获取联系人列表        | /list/contacts    | √    | 已测试               |
-| 获取数据库表名称列表     | /list/dbTableName | √    | 已测试               |
-| 获取指定数据库中的表列表   | /list/dbTable     | √    | 已测试               |
-| 执行数据库查询SQL     | /exec/dbQuerySql  | √    | 已测试               |
-| 查询群成员          | /list/groupMember | √    | 已测试               |
-| 发送消息汇总入口       | /send/msgMaster   | x    | 预留                |
-| 发送文本消息         | /send/textMsg     | x    | 该版本不支持            |
-| 发送富文本消息        | /send/richTextMsg | x    | 缩略图参数需要为空，否则会发送失败 |
-| 发送XML消息        | /send/xmlMsg      | ?    | 待测试               |
-| 发送图片消息         | /send/imageMsg    | √    | 已测试               |
-| 发送表情消息         | /send/emojiMsg    | x    | 该版本不支持            |
-| 发送文件消息         | /send/fileMsg     | x    | 该版本不支持            |
-| 拍一拍群友          | /patOnePat        | √    | 已测试               |
+| 接口名            | 地址                     | 是否支持 | 备注                |
+|----------------|------------------------|------|-------------------|
+| 查询登录状态         | /loginStatus           | ✔️   | 已测试               |
+| 获取登录微信内部识别号UID | /loginWeChatUid        | ✔️   | 已测试               |
+| 获取登录微信信息       | /loginWeChatInfo       | ✔️   | 已测试               |
+| 获取消息类型列表       | /list/msgType          | ✔️   | 已测试               |
+| 获取联系人列表        | /list/contacts         | ✔️   | 已测试               |
+| 获取数据库表名称列表     | /list/dbTableName      | ✔️   | 已测试               |
+| 获取指定数据库中的表列表   | /list/dbTable          | ✔️   | 已测试               |
+| 执行数据库查询SQL     | /exec/dbQuerySql       | ✔️   | 已测试               |
+| 发送消息汇总入口       | /send/msgMaster        | ❌    | 预留                |
+| 发送文本消息         | /send/textMsg          | ✔️   | 已测试               |
+| 发送富文本消息        | /send/richTextMsg      | ❌    | 缩略图参数需要为空，否则会发送失败 |
+| 发送XML消息        | /send/xmlMsg           | ❌    | 该版本不支持            |
+| 发送图片消息         | /send/imageMsg         | ✔️   | 已测试               |
+| 发送表情消息         | /send/emojiMsg         | ❌    | 该版本不支持            |
+| 发送文件消息         | /send/fileMsg          | ❌    | 该版本不支持            |
+| 拍一拍群友          | /patOnePat             | ✔️   | 已测试               |
+| 撤回消息           | /revokeMsg             | ❌    | 该版本不支持            |
+| 通过好友申请         | /passFriendApply       | ❌    | 该版本不支持            |
+| 添加群成员为微信好友     | /addFriend/groupMember | ❔    | 待测试               |
+| 查询群成员          | /groupMember/list      | ✔️   | 已测试               |
+| 邀请群成员          | /groupMember/invite    | ❔    | 待测试               |
+| 删除群成员          | /groupMember/delete    | ❔    | 待测试               |
+| 查询朋友圈          | /friendCircle          | ❔    | 待测试               |
+| 接收转账           | /receiveTransfer       | ❌    | 该版本不支持            |
 
 ### 已知BUG
 
 - 1.发送表情微信客户端闪退 - `待修复`
 - 2.发送富文本包含thumbnailUrl参数会导致消息发送不出去 - `待修复`
+- 3.发送文件成功之后客户端崩溃 - `待修复`
+
+### 2025-01-04
+
+#### ⛰️ Features
+
+- 退群监测功能关闭，待完善，目前未开启
+- 说明文档更新
+
+#### 🐛 Bug fixes
+- 微信端退出之后，调用接口返回客户端状态异常提示
+
+### 2024-12-27
+
+#### ⛰️ Features
+
+- 查询群成员返回类新增字段
+- 新增退群监测功能
+- 说明文档更新
+
+### 2024-12-25
+
+#### ⛰️ Features
+
+- 新增通过好友申请接口
+- 新增添加群成员为微信好友接口
+- 新增邀请群成员接口
+- 新增删除群成员接口
+- 新增刷新朋友圈接口
+- 新增撤回消息接口
+- 接收转账
+- 查询群成员请求地址变更
+- 消息回调配置文件参数名称修改
+- 封装接收到消息之后的业务操作类
 
 ### 2024-12-24
 
@@ -44,4 +94,54 @@
 
 - 适配SDK39.3.3版本
 - wcf.proto文件部分字段类型修改
-- 消息转发适配多种消息类型
+- 消息转发适配多种消息类型
+
+<br/>
+
+___
+
+<br/><br/>
+
+## v39.2.4 - 推荐✨
+
+### 版本列表
+
+下载地址：[v39.2.4](https://github.com/lich0821/WeChatFerry/releases/tag/v39.2.4)
+
+| 名称              | 版本        | 文件名                       |
+|-----------------|-----------|---------------------------|
+| 微信客户端           | 3.9.10.27 | WeChatSetup-3.9.10.27.exe |
+| WeChatFerry-SDK | 39.2.4    | v39.2.4.zip               |
+
+### 功能列表
+
+| 接口名            | 地址                     | 是否支持 | 备注     |
+|----------------|------------------------|------|--------|
+| 查询登录状态         | /loginStatus           | ✔️   | 已测试    |
+| 获取登录微信内部识别号UID | /loginWeChatUid        | ✔️   | 已测试    |
+| 获取登录微信信息       | /loginWeChatInfo       | ✔️   | 已测试    |
+| 获取消息类型列表       | /list/msgType          | ✔️   | 已测试    |
+| 获取联系人列表        | /list/contacts         | ✔️   | 已测试    |
+| 获取数据库表名称列表     | /list/dbTableName      | ✔️   | 已测试    |
+| 获取指定数据库中的表列表   | /list/dbTable          | ✔️   | 已测试    |
+| 执行数据库查询SQL     | /exec/dbQuerySql       | ✔️   | 已测试    |
+| 发送消息汇总入口       | /send/msgMaster        | ❌    | 预留     |
+| 发送文本消息         | /send/textMsg          | ✔️   | 已测试    |
+| 发送富文本消息        | /send/richTextMsg      | ✔️   | 已测试    |
+| 发送XML消息        | /send/xmlMsg           | ❌    | 该版本不支持 |
+| 发送图片消息         | /send/imageMsg         | ✔️   | 已测试    |
+| 发送表情消息         | /send/emojiMsg         | ✔️   | 已测试    |
+| 发送文件消息         | /send/fileMsg          | ✔️   | 已测试    |
+| 拍一拍群友          | /patOnePat             | ✔️   | 已测试    |
+| 撤回消息           | /revokeMsg             | ❌    | 该版本不支持 |
+| 通过好友申请         | /passFriendApply       | ❌    | 该版本不支持 |
+| 添加群成员为微信好友     | /addFriend/groupMember | ❔    | 待测试    |
+| 查询群成员          | /groupMember/list      | ✔️   | 已测试    |
+| 邀请群成员          | /groupMember/invite    | ❔    | 待测试    |
+| 删除群成员          | /groupMember/delete    | ❔    | 待测试    |
+| 查询朋友圈          | /friendCircle          | ❔    | 待测试    |
+| 接收转账           | /receiveTransfer       | ❌    | 该版本不支持 |
+
+<br/>
+
+___

clients/java/wechat-ferry-mvn/README.MD

@@ -13,7 +13,7 @@
 |-----------------|-----------|----|
 | JDK             | 1.8+      | √  |
 | Maven           | 3.8+      | √  |
-| 微信              | 3.9.11.25 | √  |
+| 微信客户端           | 3.9.11.25 | √  |
 | WeChatFerry-SDK | 39.3.3    | √  |
 | MySQL           | 8.0+      | 备用 |
 
@@ -35,6 +35,15 @@
 
 把刚下载的最新发布文件解压到本项目中的 dll 文件目录下，直接替换原因文件即可
 
+替换 `clients/java/wechat-ferry-mvn/dll` 目录下(也可以在配置文件中改为自定义的目录)
+
+- sdk.dll
+- spy.dll
+- spy_debug.dll
+
+> 如果之前已经使用本项目启动过微信，此时替换发现替换不了，是因为正则运行的微信客户端正在使用该文件，
+> 请退出并关闭微信客户端之后再进行替换
+
 ### 修改配置文件
 
 配置文件：src/main/resources/application.yml
@@ -71,15 +80,17 @@ swagger地址：http://localhost:9201/swagger-ui/index.html
 
 ### 核心依赖
 
-| 依赖            | 版本     | 说明       |
-|---------------|--------|----------|
-| Spring Boot   | 2.7.18 | 基础框架     |
-| protobuf-java | 3.22.2 | rpc      |
-| jna           | 5.6.0  | 态访问系统本地库 |
-| nng-java      | 1.4.0  | 本地包      |
-| fastjson2     | 2.0.52 | 序列化      |
-| dom4j         | 2.1.3  | XML解析包   |
-| httpclient    | 4.5.13 | 客户端请求    |
+| 依赖            | 版本          | 说明       |
+|---------------|-------------|----------|
+| Spring Boot   | 2.7.18      | 基础框架     |
+| protobuf-java | 3.22.2      | rpc      |
+| jna           | 5.6.0       | 态访问系统本地库 |
+| nng-java      | 1.4.0       | 本地包      |
+| fastjson2     | 2.0.52      | 序列化      |
+| dom4j         | 2.1.3       | XML解析包   |
+| httpclient    | 4.5.13      | 客户端请求    |
+| validation    | 2.0.1.Final | 参数校验     |
+| springfox     | 3.0.0       | swagger3 |
 
 ### 模块结构
 
@@ -93,16 +104,22 @@ wechat-ferry-mvn
 │  ├─main                                   重启命令
 │  │  ├─java(com.wechat.ferry)              java代码目录
 │  │  │  ├─config                           配置
+│  │  │  ├─constant                         常量
+│  │  │  ├─controller                       控制层(API接口)
 │  │  │  ├─entity                           聚合模型
 │  │  │  │  ├─dto                           DTO模型
 │  │  │  │  ├─po                            数据库实体(与表结构一一对应,否则请使用DTO)
 │  │  │  │  ├─proto                         PB实体
 │  │  │  │  └─vo                            视图层返回体目录
 │  │  │  ├─enums                            枚举
+│  │  │  ├─exception                        异常封装
 │  │  │  ├─handle                           处理层
-│  │  │  ├─service                          业务接口
+│  │  │  ├─service                          业务层
 │  │  │  │  └─impl                          业务实现类
-│  │  │  ├─utils                            工具类
+│  │  │  ├─strategy                         策略层
+│  │  │  │  └─impl                          策略实现类(如接收到消息之后的事件处理可以放在这里)
+│  │  │  ├─task                             定时任务
+│  │  │  ├─utils                            工具层
 │  │  │  └─WcferryApplication.java          启动类
 │  │  │
 │  │  │resources                            资源目录

clients/java/wechat-ferry-mvn/src/main/java/com/wechat/ferry/aggregation/.gitkeep

@@ -0,0 +1,3 @@
+# Ignore everything in this directory
+*
+# Except this file !.gitkeep

clients/java/wechat-ferry-mvn/src/main/java/com/wechat/ferry/aggregation/facade/ChatRoomDo.java

@@ -0,0 +1,15 @@
+package com.wechat.ferry.aggregation.facade;
+
+import lombok.Data;
+import lombok.extern.slf4j.Slf4j;
+
+/**
+ * 聚合模型类-联系人
+ *
+ * @author chandler
+ * @date 2023-06-08 22:39:53
+ */
+@Slf4j
+@Data
+public class ChatRoomDo {
+}