|
47 | 47 | <img height="120" src="https://gitee.com/binary/weixin-java-tools/raw/develop/images/qrcodes/mp.png" alt="mp qrcode"> |
48 | 48 | </a> |
49 | 49 | </td> |
50 | | - <td align="center"> |
51 | | - <a href="https://www.diboot.com?from=wxjava" target="_blank"> |
52 | | - <img height="120" src="https://www.diboot.com/img/diboot_ad.png" alt="diboot低代码开发平台"> |
53 | | - </a> |
| 50 | + <td align="center" style="font-size: 18px; font-weight: bold; vertical-align: middle;"> |
| 51 | + 赞助商招募中 |
54 | 52 | </td> |
55 | 53 | <td align="center"> |
56 | 54 | <a href="https://www.crmeb.com/xiazai" target="_blank"> |
|
64 | 62 | ### 重要信息 |
65 | 63 | 1. [`WxJava` 荣获 `GitCode` 2024年度十大开源社区奖项](https://mp.weixin.qq.com/s/wM_UlMsDm3IZ1CPPDvcvQw)。 |
66 | 64 | 2. 项目合作洽谈请联系微信`binary0000`(在微信里自行搜索并添加好友,请注明来意,如有关于SDK问题需讨论请参考下文入群讨论,不要加此微信)。 |
67 | | -3. **2024-12-30 发布 [【4.7.0正式版】](https://mp.weixin.qq.com/s/_7k-XLYBqeJJhvHWCsdT0A)**! |
68 | | -4. **从 4.7.8.B 版本开始支持 Quarkus/GraalVM Native Image,详见 [【Quarkus 支持文档】](QUARKUS_SUPPORT.md)**。 |
| 65 | +3. **2026-01-03 发布 [【4.8.0正式版】](https://mp.weixin.qq.com/s/mJoFtGc25pXCn3uZRh6Q-w)**! |
69 | 66 | 5. 贡献源码可以参考视频:[【贡献源码全过程(上集)】](https://mp.weixin.qq.com/s/3xUZSATWwHR_gZZm207h7Q)、[【贡献源码全过程(下集)】](https://mp.weixin.qq.com/s/nyzJwVVoYSJ4hSbwyvTx9A) ,友情提供:[程序员小山与Bug](https://space.bilibili.com/473631007) |
70 | 67 | 6. 新手重要提示:本项目仅是一个SDK开发工具包,未提供Web实现,建议使用 `maven` 或 `gradle` 引用本项目即可使用本SDK提供的各种功能,详情可参考 **[【Demo项目】](demo.md)** 或本项目中的部分单元测试代码; |
71 | 68 | 7. 微信开发新手请务必阅读【开发文档】([Gitee Wiki](https://gitee.com/binary/weixin-java-tools/wikis/Home) 或者 [Github Wiki](https://github.com/binarywang/WxJava/wiki))的常见问题部分,可以少走很多弯路,节省不少时间。 |
|
96 | 93 | <dependency> |
97 | 94 | <groupId>com.github.binarywang</groupId> |
98 | 95 | <artifactId>(不同模块参考下文)</artifactId> |
99 | | - <version>4.7.0</version> |
| 96 | + <version>4.8.0</version> |
100 | 97 | </dependency> |
101 | 98 | ``` |
102 | 99 |
|
|
115 | 112 | - **微信开放平台**(`weixin-java-open`)主要用于第三方平台,代公众号或小程序进行开发和管理 |
116 | 113 |
|
117 | 114 |
|
| 115 | +--------------------------------- |
| 116 | +### HTTP 客户端支持 |
| 117 | + |
| 118 | +本项目同时支持多种 HTTP 客户端实现,默认推荐使用 **Apache HttpClient 5.x**(最新稳定版本)。 |
| 119 | + |
| 120 | +#### 支持的 HTTP 客户端类型 |
| 121 | + |
| 122 | +| HTTP 客户端 | 说明 | 配置值 | 推荐程度 | |
| 123 | +|------------|------|--------|---------| |
| 124 | +| Apache HttpClient 5.x | Apache HttpComponents Client 5.x,最新版本 | `HttpComponents` | ⭐⭐⭐⭐⭐ 推荐 | |
| 125 | +| Apache HttpClient 4.x | Apache HttpClient 4.x,向后兼容 | `HttpClient` | ⭐⭐⭐⭐ 兼容 | |
| 126 | +| OkHttp | Square OkHttp 客户端 | `OkHttp` | ⭐⭐⭐ 可选 | |
| 127 | +| Jodd-http | Jodd 轻量级 HTTP 客户端 | `JoddHttp` | ⭐⭐ 可选 | |
| 128 | + |
| 129 | +#### 配置方式 |
| 130 | + |
| 131 | +**Spring Boot 配置示例:** |
| 132 | + |
| 133 | +```properties |
| 134 | +# 使用 HttpClient 5.x(推荐,MP/MiniApp/CP/Channel/QiDian 模块默认) |
| 135 | +wx.mp.config-storage.http-client-type=HttpComponents |
| 136 | + |
| 137 | +# 使用 HttpClient 4.x(兼容模式) |
| 138 | +wx.mp.config-storage.http-client-type=HttpClient |
| 139 | + |
| 140 | +# 使用 OkHttp |
| 141 | +wx.mp.config-storage.http-client-type=OkHttp |
| 142 | + |
| 143 | +# 使用 Jodd-http |
| 144 | +wx.mp.config-storage.http-client-type=JoddHttp |
| 145 | +``` |
| 146 | + |
| 147 | +**注意**:如果使用 Multi-Starter(如 `wx-java-mp-multi-spring-boot-starter`),枚举值需使用大写下划线格式: |
| 148 | +```properties |
| 149 | +# Multi-Starter 配置格式 |
| 150 | +wx.mp.config-storage.http-client-type=HTTP_COMPONENTS # 注意使用大写下划线 |
| 151 | +``` |
| 152 | + |
| 153 | +**注意事项:** |
| 154 | +1. **MP、MiniApp、Channel、QiDian 模块**已完整支持 HttpClient 5.x,默认推荐使用 |
| 155 | +2. **CP 模块**的支持情况取决于具体使用的 Starter 版本,请参考对应模块文档 |
| 156 | +3. 如需使用 OkHttp 或 Jodd-http,需在项目中添加对应的依赖(scope为provided) |
| 157 | +4. HttpClient 4.x 和 HttpClient 5.x 可以共存,按需配置即可 |
| 158 | + |
| 159 | + |
118 | 160 | --------------------------------- |
119 | 161 | ### 版本说明 |
120 | 162 |
|
|
0 commit comments