diff --git a/docs/HTTPCLIENT_UPGRADE_GUIDE.md b/docs/HTTPCLIENT_UPGRADE_GUIDE.md index 945341966..5cabb1067 100644 --- a/docs/HTTPCLIENT_UPGRADE_GUIDE.md +++ b/docs/HTTPCLIENT_UPGRADE_GUIDE.md @@ -43,8 +43,8 @@ ### 对现有项目 - **向后兼容**:不需要修改任何代码 -- HttpClient 4.x 依然可用,项目同时包含两个版本的依赖 -- 如果希望继续使用 HttpClient 4.x,只需在配置中显式指定 +- 如果希望继续使用 HttpClient 4.x,只需在配置中显式指定,pay 模块会自动包含 httpclient4 依赖(因为某些接口必须使用 httpclient4) + 其他模块(mp、miniapp、cp、open、channel、qidian)如果需要使用 httpclient4,必须显式在项目中添加 httpclient4 依赖 ## 迁移步骤 @@ -94,10 +94,10 @@ WxMpService wxMpService = new WxMpServiceHttpClientImpl(); A: 不会。项目保持完全向后兼容,HttpClient 4.x 的所有实现都保持不变。 ### Q: 我需要修改代码吗? -A: 大多数情况下不需要。如果希望继续使用 HttpClient 4.x,只需在配置中指定 `http-client-type=HttpClient` 即可。 +A: 大多数情况下不需要。如果希望继续使用 HttpClient 4.x,只需在配置中指定 `http-client-type=HttpClient` ,并引入 HttpClient 4.x 依赖即可。 ### Q: 我可以在同一个项目中同时使用两个版本吗? -A: 可以。不同的模块可以配置使用不同的 HTTP 客户端。例如,MP 模块使用 HttpClient 5.x,MiniApp 模块默认使用 HttpClient 4.x,但也可以按需配置为 HttpClient 5.x。 +A: 可以。不同的模块可以配置使用不同的 HTTP 客户端。例如,MP 模块使用 HttpClient 5.x,pay 模块部分接口仍使用 HttpClient 4.x,但也可以按需配置为 HttpClient 5.x。 ### Q: 如何排除不需要的依赖? A: 如果只想使用一个版本,可以在 `pom.xml` 中排除另一个: @@ -196,4 +196,4 @@ weixin-java-common/ - ✅ **推荐使用 HttpClient 5.x**:性能更好,功能更强 - ✅ **向后兼容**:可以继续使用 HttpClient 4.x - ✅ **灵活配置**:支持多种 HTTP 客户端,按需选择 -- ✅ **平滑迁移**:无需修改代码,仅需配置即可 +- ✅ **平滑迁移**:无需修改代码,仅需配置,若不使用 HttpClient 5.x ,引入其他依赖即可 diff --git a/pom.xml b/pom.xml index 5740a2779..d58a677b2 100644 --- a/pom.xml +++ b/pom.xml @@ -136,7 +136,7 @@ UTF-8 4.5.13 - 5.5 + 5.5.2 9.4.57.v20241219 diff --git a/weixin-java-channel/pom.xml b/weixin-java-channel/pom.xml index 13dd26fa9..c15ea302e 100644 --- a/weixin-java-channel/pom.xml +++ b/weixin-java-channel/pom.xml @@ -29,6 +29,16 @@ jodd-http provided + + org.apache.httpcomponents + httpclient + provided + + + org.apache.httpcomponents + httpmime + provided + org.apache.httpcomponents.client5 httpclient5 diff --git a/weixin-java-common/pom.xml b/weixin-java-common/pom.xml index 9032af97d..68826ca2d 100644 --- a/weixin-java-common/pom.xml +++ b/weixin-java-common/pom.xml @@ -34,6 +34,7 @@ org.apache.httpcomponents httpclient + provided commons-logging @@ -44,6 +45,7 @@ org.apache.httpcomponents httpmime + provided diff --git a/weixin-java-cp/pom.xml b/weixin-java-cp/pom.xml index 6c47176af..6f8ab756a 100644 --- a/weixin-java-cp/pom.xml +++ b/weixin-java-cp/pom.xml @@ -30,6 +30,11 @@ okhttp provided + + org.apache.httpcomponents + httpclient + provided + org.apache.httpcomponents.client5 httpclient5 diff --git a/weixin-java-miniapp/pom.xml b/weixin-java-miniapp/pom.xml index 340a15e58..4f5378727 100644 --- a/weixin-java-miniapp/pom.xml +++ b/weixin-java-miniapp/pom.xml @@ -31,6 +31,16 @@ okhttp provided + + org.apache.httpcomponents + httpclient + provided + + + org.apache.httpcomponents + httpmime + provided + org.apache.httpcomponents.client5 httpclient5 diff --git a/weixin-java-mp/pom.xml b/weixin-java-mp/pom.xml index c33aaeab8..755695d0c 100644 --- a/weixin-java-mp/pom.xml +++ b/weixin-java-mp/pom.xml @@ -31,6 +31,16 @@ okhttp provided + + org.apache.httpcomponents + httpclient + provided + + + org.apache.httpcomponents + httpmime + provided + org.apache.httpcomponents.client5 httpclient5 diff --git a/weixin-java-open/pom.xml b/weixin-java-open/pom.xml index 4c34786da..6720cd2b3 100644 --- a/weixin-java-open/pom.xml +++ b/weixin-java-open/pom.xml @@ -48,6 +48,16 @@ okhttp provided + + org.apache.httpcomponents + httpclient + provided + + + org.apache.httpcomponents + httpmime + provided + org.apache.httpcomponents.client5 httpclient5 diff --git a/weixin-java-pay/pom.xml b/weixin-java-pay/pom.xml index 9bf6d49a7..43851df85 100644 --- a/weixin-java-pay/pom.xml +++ b/weixin-java-pay/pom.xml @@ -34,6 +34,14 @@ jodd-util 6.1.0 + + org.apache.httpcomponents + httpclient + + + org.apache.httpcomponents + httpmime + org.apache.httpcomponents.client5 httpclient5 diff --git a/weixin-java-qidian/pom.xml b/weixin-java-qidian/pom.xml index 293a4655c..0752ce69d 100644 --- a/weixin-java-qidian/pom.xml +++ b/weixin-java-qidian/pom.xml @@ -31,6 +31,11 @@ okhttp provided + + org.apache.httpcomponents + httpclient + provided + org.apache.httpcomponents.client5 httpclient5