binarywang#389 微信支付查询退款返回结果中增加退款成功时间字段

Author: binarywang

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/request/WxPayRefundRequest.java

@@ -14,13 +14,6 @@
 /**
  * <pre>
  * 微信支付-申请退款请求参数
- * 注释中各行每个字段描述对应如下：
- * <li>字段名
- * <li>变量名
- * <li>是否必填
- * <li>类型
- * <li>示例值
- * <li>描述
  * Created by Binary Wang on 2016-10-08.
  * </pre>
  *
@@ -34,117 +27,116 @@
 @XStreamAlias("xml")
 public class WxPayRefundRequest extends WxPayBaseRequest {
   private static final String[] REFUND_ACCOUNT = new String[]{
-    RefundAccountSource.RECHARGE_FUNDS,
-    RefundAccountSource.UNSETTLED_FUNDS
-  };
+    RefundAccountSource.RECHARGE_FUNDS, RefundAccountSource.UNSETTLED_FUNDS};
+
   /**
    * <pre>
-   * 设备号
-   * device_info
-   * 否
-   * String(32)
-   * 13467007045764
-   * 终端设备号
+   * 字段名：设备号.
+   * 变量名：device_info
+   * 是否必填：否
+   * 类型：String(32)
+   * 示例值：13467007045764
+   * 描述：终端设备号
    * </pre>
    */
   @XStreamAlias("device_info")
   private String deviceInfo;
   /**
    * <pre>
-   * 微信订单号
-   * transaction_id
-   * 跟out_trade_no二选一
-   * String(28)
-   * 1217752501201400000000000000
-   * 微信生成的订单号，在支付通知中有返回
+   * 字段名：微信订单号.
+   * 变量名：transaction_id
+   * 是否必填：跟out_trade_no二选一
+   * 类型：String(28)
+   * 示例值：1217752501201400000000000000
+   * 描述：微信生成的订单号，在支付通知中有返回
    * </pre>
    */
   @XStreamAlias("transaction_id")
   private String transactionId;
   /**
    * <pre>
-   * 商户订单号
-   * out_trade_no
-   * 跟transaction_id二选一
-   * String(32)
-   * 1217752501201400000000000000
-   * 商户侧传给微信的订单号
+   * 字段名：商户订单号.
+   * 变量名：out_trade_no
+   * 是否必填：跟transaction_id二选一
+   * 类型：String(32)
+   * 示例值：1217752501201400000000000000
+   * 描述：商户侧传给微信的订单号
    * </pre>
    */
   @XStreamAlias("out_trade_no")
   private String outTradeNo;
   /**
    * <pre>
-   * 商户退款单号
-   * out_refund_no
-   * 是
-   * String(32)
-   * 1217752501201400000000000000
-   * 商户系统内部的退款单号，商户系统内部唯一，同一退款单号多次请求只退一笔
+   * 字段名：商户退款单号.
+   * 变量名：out_refund_no
+   * 是否必填：是
+   * 类型：String(32)
+   * 示例值：1217752501201400000000000000
+   * 描述：商户系统内部的退款单号，商户系统内部唯一，同一退款单号多次请求只退一笔
    * </pre>
    */
   @Required
   @XStreamAlias("out_refund_no")
   private String outRefundNo;
   /**
    * <pre>
-   * 订单金额
-   * total_fee
-   * 是
-   * Int
-   * 100
-   * 订单总金额，单位为分，只能为整数，详见支付金额
+   * 字段名：订单金额.
+   * 变量名：total_fee
+   * 是否必填：是
+   * 类型：Int
+   * 示例值：100
+   * 描述：订单总金额，单位为分，只能为整数，详见支付金额
    * </pre>
    */
   @Required
   @XStreamAlias("total_fee")
   private Integer totalFee;
   /**
    * <pre>
-   * 退款金额
-   * refund_fee
-   * 是
-   * Int
-   * 100
-   * 退款总金额，订单总金额，单位为分，只能为整数，详见支付金额
+   * 字段名：退款金额.
+   * 变量名：refund_fee
+   * 是否必填：是
+   * 类型：Int
+   * 示例值：100
+   * 描述：退款总金额，订单总金额，单位为分，只能为整数，详见支付金额
    * </pre>
    */
   @Required
   @XStreamAlias("refund_fee")
   private Integer refundFee;
   /**
    * <pre>
-   * 货币种类
-   * refund_fee_type
-   * 否
-   * String(8)
-   * CNY
-   * 货币类型，符合ISO 4217标准的三位字母代码，默认人民币：CNY，其他值列表详见货币类型
+   * 字段名：货币种类.
+   * 变量名：refund_fee_type
+   * 是否必填：否
+   * 类型：String(8)
+   * 示例值：CNY
+   * 描述：货币类型，符合ISO 4217标准的三位字母代码，默认人民币：CNY，其他值列表详见货币类型
    * </pre>
    */
   @XStreamAlias("refund_fee_type")
   private String refundFeeType;
   /**
    * <pre>
-   * 操作员
-   * op_user_id
-   * 是
-   * String(32)
-   * 1900000109
-   * 操作员帐号, 默认为商户号
+   * 字段名：操作员.
+   * 变量名：op_user_id
+   * 是否必填：是
+   * 类型：String(32)
+   * 示例值：1900000109
+   * 描述：操作员帐号, 默认为商户号
    * </pre>
    */
   //@Required
   @XStreamAlias("op_user_id")
   private String opUserId;
   /**
    * <pre>
-   * 退款资金来源
-   * refund_account
-   * 否
-   * String(30)
-   * REFUND_SOURCE_RECHARGE_FUNDS
-   * 仅针对老资金流商户使用，
+   * 字段名：退款资金来源.
+   * 变量名：refund_account
+   * 是否必填：否
+   * 类型：String(30)
+   * 示例值：REFUND_SOURCE_RECHARGE_FUNDS
+   * 描述：仅针对老资金流商户使用，
    * <li>REFUND_SOURCE_UNSETTLED_FUNDS---未结算资金退款（默认使用未结算资金退款），
    * <li>REFUND_SOURCE_RECHARGE_FUNDS---可用余额退款
    * </pre>
@@ -153,12 +145,12 @@ public class WxPayRefundRequest extends WxPayBaseRequest {
   private String refundAccount;
   /**
    * <pre>
-   * 退款原因
-   * refund_account
-   * 否
-   * String(80)
-   * 商品已售完
-   * 若商户传入，会在下发给用户的退款消息中体现退款原因
+   * 字段名：退款原因.
+   * 变量名：refund_account
+   * 是否必填：否
+   * 类型：String(80)
+   * 示例值：商品已售完
+   * 描述：若商户传入，会在下发给用户的退款消息中体现退款原因
    * </pre>
    */
   @XStreamAlias("refund_desc")
@@ -177,8 +169,8 @@ public void checkAndSign(WxPayConfig config, boolean isIgnoreSignType) throws Wx
   protected void checkConstraints() throws WxPayException {
     if (StringUtils.isNotBlank(this.getRefundAccount())) {
       if (!ArrayUtils.contains(REFUND_ACCOUNT, this.getRefundAccount())) {
-        throw new WxPayException(String.format("refund_account目前必须为%s其中之一,实际值：%s",
-          Arrays.toString(REFUND_ACCOUNT), this.getRefundAccount()));
+        throw new WxPayException(
+          String.format("refund_account目前必须为%s其中之一,实际值：%s", Arrays.toString(REFUND_ACCOUNT), this.getRefundAccount()));
       }
     }