🎨 批量修复部分javadoc里的错误标签或不规范代码

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/MiPayNotifyV3Result.java

@@ -13,7 +13,7 @@ import java.io.Serializable;
  * </pre>
  *
  * @author xgl
- * @date 2025/12/20
+ * @since 2025/12/20
  */
 @Data
 @NoArgsConstructor

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayBaseNotifyV3Result.java

@@ -5,7 +5,8 @@ package com.github.binarywang.wxpay.bean.notify;
  *
  * @author Pursuer
  * @version 1.0
- * @date 2023/6/15
+ * @since 2023/6/15
+ * @param <T> 解密后的数据类型
  */
 public interface WxPayBaseNotifyV3Result<T> {
   /**
@@ -13,9 +14,8 @@ public interface WxPayBaseNotifyV3Result<T> {
    *
    * @param rawData 原始数据
    * @author Pursuer
-   * @date 2023/6/15
-   * @since 1.0
-   **/
+   * @since 2023/6/15
+   */
   void setRawData(OriginNotifyResponse rawData);
 
   /**
@@ -23,8 +23,7 @@ public interface WxPayBaseNotifyV3Result<T> {
    *
    * @param data 解密后的数据
    * @author Pursuer
-   * @date 2023/6/15
-   * @since 1.0
-   **/
+   * @since 2023/6/15
+   */
   void setResult(T data);
 }

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/WxPayNotifyV3Response.java

@@ -28,8 +28,8 @@ public class WxPayNotifyV3Response {
   /**
    * 返回成功
    *
-   * @param msg
-   * @return
+   * @param msg 返回消息
+   * @return 成功响应的JSON字符串
    */
   public static String success(String msg) {
     WxPayNotifyV3Response response = new WxPayNotifyV3Response(SUCCESS, msg);
@@ -40,7 +40,7 @@ public class WxPayNotifyV3Response {
    * 返回失败
    *
    * @param msg 返回信息，如非空，为错误原因
-   * @return
+   * @return 失败响应的JSON字符串
    */
   public static String fail(String msg) {
     WxPayNotifyV3Response response = new WxPayNotifyV3Response(FAIL, msg);

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/config/WxPayConfig.java

@@ -325,7 +325,8 @@ public class WxPayConfig {
    *
    * @return org.apache.http.impl.client.CloseableHttpClient
    * @author doger.wang
-   **/
+   * @throws WxPayException 微信支付异常
+   */
   public CloseableHttpClient initApiV3HttpClient() throws WxPayException {
     if (StringUtils.isBlank(this.getApiV3Key())) {
       throw new WxPayException("请确保apiV3Key值已设置");
@@ -663,6 +664,8 @@ public class WxPayConfig {
 
   /**
    * 配置HTTP代理
+   *
+   * @param httpClientBuilder HttpClient构建器
    */
   private void configureProxy(org.apache.http.impl.client.HttpClientBuilder httpClientBuilder) {
     if (StringUtils.isNotBlank(this.getHttpProxyHost()) && this.getHttpProxyPort() > 0) {

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/util/RequestUtils.java

@@ -17,7 +17,7 @@ public class RequestUtils {
   /**
    * 获取请求头数据，微信V3版本回调使用
    *
-   * @param request
+   * @param request HTTP请求对象
    * @return 字符串
    */
   public static String readData(HttpServletRequest request) {

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/util/ResourcesUtils.java

@@ -23,6 +23,10 @@ public class ResourcesUtils {
    * <li>{@link Class#getClassLoader() ClassLoaderUtil.class.getClassLoader()}</li>
    * <li>if <code>callingClass</code> is provided: {@link Class#getClassLoader() callingClass.getClassLoader()}</li>
    * </ul>
+   *
+   * @param resourceName 资源名称
+   * @param classLoader  类加载器
+   * @return 资源URL
    */
   public static URL getResourceUrl(String resourceName, final ClassLoader classLoader) {
 
@@ -64,6 +68,9 @@ public class ResourcesUtils {
   /**
    * Opens a resource of the specified name for reading.
    *
+   * @param resourceName 资源名称
+   * @return 输入流
+   * @throws IOException IO异常
    * @see #getResourceAsStream(String, ClassLoader)
    */
   public static InputStream getResourceAsStream(final String resourceName) throws IOException {
@@ -73,6 +80,10 @@ public class ResourcesUtils {
   /**
    * Opens a resource of the specified name for reading.
    *
+   * @param resourceName 资源名称
+   * @param callingClass 类加载器
+   * @return 输入流
+   * @throws IOException IO异常
    * @see #getResourceUrl(String, ClassLoader)
    */
   public static InputStream getResourceAsStream(final String resourceName, final ClassLoader callingClass) throws IOException {

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/util/SignUtils.java

@@ -112,7 +112,16 @@ public class SignUtils {
   /**
    * 企业微信签名
    *
-   * @param signType md5 目前接口要求使用的加密类型
+   * @param actName     活动名称
+   * @param mchBillNo   商户订单号
+   * @param mchId       商户号
+   * @param nonceStr    随机字符串
+   * @param reOpenid    用户openid
+   * @param totalAmount 金额
+   * @param wxAppId     微信appid
+   * @param signKey     签名密钥
+   * @param signType    md5 目前接口要求使用的加密类型
+   * @return 签名字符串
    */
   public static String createEntSign(String actName, String mchBillNo, String mchId, String nonceStr,
                                      String reOpenid, Integer totalAmount, String wxAppId, String signKey,
@@ -131,7 +140,18 @@ public class SignUtils {
 
   /**
    * 企业微信签名
-   * @param signType md5 目前接口要求使用的加密类型
+   *
+   * @param totalAmount    金额
+   * @param appId          应用ID
+   * @param description    描述
+   * @param mchId          商户号
+   * @param nonceStr       随机字符串
+   * @param openid         用户openid
+   * @param partnerTradeNo 商户订单号
+   * @param wwMsgType      消息类型
+   * @param signKey        签名密钥
+   * @param signType       md5 目前接口要求使用的加密类型
+   * @return 签名字符串
    */
   public static String createEntSign(Integer totalAmount, String appId, String description, String mchId,
                                      String nonceStr, String openid, String partnerTradeNo, String wwMsgType,