增加会员卡管理服务的更新会员信息接口的实现

weixin-java-mp/src/main/java/me/chanjar/weixin/mp/api/WxMpMemberCardService.java

@@ -2,6 +2,8 @@
 
 import me.chanjar.weixin.common.exception.WxErrorException;
 import me.chanjar.weixin.mp.bean.membercard.WxMpMemberCardActivatedMessage;
+import me.chanjar.weixin.mp.bean.membercard.WxMpMemberCardUpdateMessage;
+import me.chanjar.weixin.mp.bean.membercard.WxMpMemberCardUpdateResult;
 import me.chanjar.weixin.mp.bean.membercard.WxMpMemberCardUserInfoResult;
 
 /**
@@ -35,4 +37,17 @@ public interface WxMpMemberCardService {
    * @throws WxErrorException 接口调用失败抛出的异常
    */
   WxMpMemberCardUserInfoResult getUserInfo(String cardId, String code) throws WxErrorException;
+
+  /**
+   * 当会员持卡消费后，支持开发者调用该接口更新会员信息。会员卡交易后的每次信息变更需通过该接口通知微信，便于后续消息通知及其他扩展功能。
+   *
+   * 1.开发者可以同时传入add_bonus和bonus解决由于同步失败带来的幂等性问题。同时传入add_bonus和bonus时
+   * add_bonus作为积分变动消息中的变量值，而bonus作为卡面上的总积分额度显示。余额变动同理。
+   * 2.开发者可以传入is_notify_bonus控制特殊的积分对账变动不发送消息，余额变动同理。
+   *
+   * @param updateUserMessage 更新会员信息所需字段消息
+   * @return 调用返回的JSON字符串。
+   * @throws WxErrorException 接口调用失败抛出的异常
+   */
+  WxMpMemberCardUpdateResult updateUserMemberCard(WxMpMemberCardUpdateMessage updateUserMessage) throws WxErrorException;
 }

weixin-java-mp/src/main/java/me/chanjar/weixin/mp/api/impl/WxMpMemberCardServiceImpl.java

@@ -9,6 +9,8 @@
 import me.chanjar.weixin.mp.api.WxMpMemberCardService;
 import me.chanjar.weixin.mp.api.WxMpService;
 import me.chanjar.weixin.mp.bean.membercard.WxMpMemberCardActivatedMessage;
+import me.chanjar.weixin.mp.bean.membercard.WxMpMemberCardUpdateMessage;
+import me.chanjar.weixin.mp.bean.membercard.WxMpMemberCardUpdateResult;
 import me.chanjar.weixin.mp.bean.membercard.WxMpMemberCardUserInfoResult;
 import me.chanjar.weixin.mp.util.json.WxMpGsonBuilder;
 import org.slf4j.Logger;
@@ -26,6 +28,7 @@ public class WxMpMemberCardServiceImpl implements WxMpMemberCardService {
 
   private static final String MEMBER_CARD_ACTIVATE = "https://api.weixin.qq.com/card/membercard/activate";
   private static final String MEMBER_CARD_USER_INFO_GET = "https://api.weixin.qq.com/card/membercard/userinfo/get";
+  private static final String MEMBER_CARD_UPDATE_USER = "https://api.weixin.qq.com/card/membercard/updateuser";
 
   private WxMpService wxMpService;
 
@@ -75,4 +78,27 @@ public WxMpMemberCardUserInfoResult getUserInfo(String cardId, String code) thro
       new TypeToken<WxMpMemberCardUserInfoResult>() {
       }.getType());
   }
+
+  /**
+   * 当会员持卡消费后，支持开发者调用该接口更新会员信息。会员卡交易后的每次信息变更需通过该接口通知微信，便于后续消息通知及其他扩展功能。
+   *
+   * 1.开发者可以同时传入add_bonus和bonus解决由于同步失败带来的幂等性问题。同时传入add_bonus和bonus时
+   * add_bonus作为积分变动消息中的变量值，而bonus作为卡面上的总积分额度显示。余额变动同理。
+   * 2.开发者可以传入is_notify_bonus控制特殊的积分对账变动不发送消息，余额变动同理。
+   *
+   * @param updateUserMessage 更新会员信息所需字段消息
+   * @return 调用返回的JSON字符串。
+   * @throws WxErrorException 接口调用失败抛出的异常
+   */
+  @Override
+  public WxMpMemberCardUpdateResult updateUserMemberCard(WxMpMemberCardUpdateMessage updateUserMessage)
+    throws WxErrorException {
+
+    String responseContent = this.getWxMpService().post(MEMBER_CARD_UPDATE_USER, GSON.toJson(updateUserMessage));
+
+    JsonElement tmpJsonElement = new JsonParser().parse(responseContent);
+    return WxMpGsonBuilder.INSTANCE.create().fromJson(tmpJsonElement,
+      new TypeToken<WxMpMemberCardUpdateResult>() {
+      }.getType());
+  }
 }

weixin-java-mp/src/main/java/me/chanjar/weixin/mp/bean/membercard/NotifyOptional.java

@@ -0,0 +1,73 @@
+package me.chanjar.weixin.mp.bean.membercard;
+
+import com.google.gson.annotations.SerializedName;
+
+/**
+ * 控制原生消息结构体，包含各字段的消息控制字段。
+ *
+ * 用于 `7 更新会员信息` 的接口参数调用
+ * https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1451025283
+ *
+ * @author YuJian([email protected])
+ * @version 2017/7/15
+ */
+public class NotifyOptional {
+
+  // 积分变动时是否触发系统模板消息，默认为true
+  @SerializedName("is_notify_bonus")
+  private Boolean isNotifyBonus;
+
+  // 余额变动时是否触发系统模板消息，默认为true
+  @SerializedName("is_notify_balance")
+  private Boolean isNotifyBalance;
+
+  // 自定义group1变动时是否触发系统模板消息，默认为false。（2、3同理）
+  @SerializedName("is_notify_custom_field1")
+  private Boolean isNotifyCustomField1;
+
+  @SerializedName("is_notify_custom_field2")
+  private Boolean isNotifyCustomField2;
+
+  @SerializedName("is_notify_custom_field3")
+  private Boolean isNotifyCustomField3;
+
+  public Boolean getNotifyBonus() {
+    return isNotifyBonus;
+  }
+
+  public void setNotifyBonus(Boolean notifyBonus) {
+    isNotifyBonus = notifyBonus;
+  }
+
+  public Boolean getNotifyBalance() {
+    return isNotifyBalance;
+  }
+
+  public void setNotifyBalance(Boolean notifyBalance) {
+    isNotifyBalance = notifyBalance;
+  }
+
+  public Boolean getNotifyCustomField1() {
+    return isNotifyCustomField1;
+  }
+
+  public void setNotifyCustomField1(Boolean notifyCustomField1) {
+    isNotifyCustomField1 = notifyCustomField1;
+  }
+
+  public Boolean getNotifyCustomField2() {
+    return isNotifyCustomField2;
+  }
+
+  public void setNotifyCustomField2(Boolean notifyCustomField2) {
+    isNotifyCustomField2 = notifyCustomField2;
+  }
+
+  public Boolean getNotifyCustomField3() {
+    return isNotifyCustomField3;
+  }
+
+  public void setNotifyCustomField3(Boolean notifyCustomField3) {
+    isNotifyCustomField3 = notifyCustomField3;
+  }
+}

weixin-java-mp/src/main/java/me/chanjar/weixin/mp/bean/membercard/WxMpMemberCardUpdateMessage.java

@@ -0,0 +1,156 @@
+package me.chanjar.weixin.mp.bean.membercard;
+
+import com.google.gson.annotations.SerializedName;
+
+/**
+ * 更新会员信息所需字段消息。
+ *
+ * 1.开发者可以同时传入add_bonus和bonus解决由于同步失败带来的幂等性问题。同时传入add_bonus和bonus时
+ * add_bonus作为积分变动消息中的变量值，而bonus作为卡面上的总积分额度显示。余额变动同理。
+ * 2.开发者可以传入is_notify_bonus控制特殊的积分对账变动不发送消息，余额变动同理。
+ *
+ * @author YuJian([email protected])
+ * @version 2017/7/15
+ */
+public class WxMpMemberCardUpdateMessage {
+
+  // 领取会员卡用户获得的code
+  private String code;
+  // 卡券ID,自定义code卡券必填
+  @SerializedName("card_id")
+  private String cardId;
+  // 支持商家激活时针对单个会员卡分配自定义的会员卡背景
+  @SerializedName("background_pic_url")
+  private String backgroundPicUrl;
+  // 需要设置的积分全量值，传入的数值会直接显示
+  private Integer bonus;
+  // 本次积分变动值，传负数代表减少
+  @SerializedName("add_bonus")
+  private Integer addBounus;
+  // 商家自定义积分消耗记录，不超过14个汉字
+  @SerializedName("record_bonus")
+  private String recordBonus;
+  // 需要设置的余额全量值，传入的数值会直接显示在卡面
+  private Integer balance;
+  // 本次余额变动值，传负数代表减少
+  @SerializedName("add_balance")
+  private Integer addBalance;
+  // 商家自定义金额消耗记录，不超过14个汉字。
+  @SerializedName("record_balance")
+  private String recordBalance;
+
+  // 创建时字段custom_field定义类型的最新数值，限制为4个汉字，12字节。
+  @SerializedName("custom_field_value1")
+  private String customFieldValue1;
+  @SerializedName("custom_field_value2")
+  private String customFieldValue2;
+  @SerializedName("custom_field_value3")
+  private String customFieldValue3;
+
+  @SerializedName("notify_optional")
+  private NotifyOptional notifyOptional;
+
+  public String getCode() {
+    return code;
+  }
+
+  public void setCode(String code) {
+    this.code = code;
+  }
+
+  public String getCardId() {
+    return cardId;
+  }
+
+  public void setCardId(String cardId) {
+    this.cardId = cardId;
+  }
+
+  public String getBackgroundPicUrl() {
+    return backgroundPicUrl;
+  }
+
+  public void setBackgroundPicUrl(String backgroundPicUrl) {
+    this.backgroundPicUrl = backgroundPicUrl;
+  }
+
+  public Integer getBonus() {
+    return bonus;
+  }
+
+  public void setBonus(Integer bonus) {
+    this.bonus = bonus;
+  }
+
+  public Integer getAddBounus() {
+    return addBounus;
+  }
+
+  public void setAddBounus(Integer addBounus) {
+    this.addBounus = addBounus;
+  }
+
+  public String getRecordBonus() {
+    return recordBonus;
+  }
+
+  public void setRecordBonus(String recordBonus) {
+    this.recordBonus = recordBonus;
+  }
+
+  public Integer getBalance() {
+    return balance;
+  }
+
+  public void setBalance(Integer balance) {
+    this.balance = balance;
+  }
+
+  public Integer getAddBalance() {
+    return addBalance;
+  }
+
+  public void setAddBalance(Integer addBalance) {
+    this.addBalance = addBalance;
+  }
+
+  public String getRecordBalance() {
+    return recordBalance;
+  }
+
+  public void setRecordBalance(String recordBalance) {
+    this.recordBalance = recordBalance;
+  }
+
+  public String getCustomFieldValue1() {
+    return customFieldValue1;
+  }
+
+  public void setCustomFieldValue1(String customFieldValue1) {
+    this.customFieldValue1 = customFieldValue1;
+  }
+
+  public String getCustomFieldValue2() {
+    return customFieldValue2;
+  }
+
+  public void setCustomFieldValue2(String customFieldValue2) {
+    this.customFieldValue2 = customFieldValue2;
+  }
+
+  public String getCustomFieldValue3() {
+    return customFieldValue3;
+  }
+
+  public void setCustomFieldValue3(String customFieldValue3) {
+    this.customFieldValue3 = customFieldValue3;
+  }
+
+  public NotifyOptional getNotifyOptional() {
+    return notifyOptional;
+  }
+
+  public void setNotifyOptional(NotifyOptional notifyOptional) {
+    this.notifyOptional = notifyOptional;
+  }
+}

weixin-java-mp/src/main/java/me/chanjar/weixin/mp/bean/membercard/WxMpMemberCardUpdateResult.java

@@ -0,0 +1,82 @@
+package me.chanjar.weixin.mp.bean.membercard;
+
+import me.chanjar.weixin.mp.util.json.WxMpGsonBuilder;
+
+import java.io.Serializable;
+
+/**
+ * 用于 `7 更新会员信息` 的接口调用后的返回结果
+ * https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1451025283
+ *
+ * @author YuJian([email protected])
+ * @version 2017/7/15
+ */
+public class WxMpMemberCardUpdateResult  implements Serializable {
+
+  private static final long serialVersionUID = 9084886191442098311L;
+
+  private String errorCode;
+
+  private String errorMsg;
+
+  private String openId;
+
+  private Integer resultBonus;
+
+  private Integer resultBalance;
+
+  public String getErrorCode() {
+    return errorCode;
+  }
+
+  public void setErrorCode(String errorCode) {
+    this.errorCode = errorCode;
+  }
+
+  public String getErrorMsg() {
+    return errorMsg;
+  }
+
+  public void setErrorMsg(String errorMsg) {
+    this.errorMsg = errorMsg;
+  }
+
+  public String getOpenId() {
+    return openId;
+  }
+
+  public void setOpenId(String openId) {
+    this.openId = openId;
+  }
+
+  public Integer getResultBonus() {
+    return resultBonus;
+  }
+
+  public void setResultBonus(Integer resultBonus) {
+    this.resultBonus = resultBonus;
+  }
+
+  public Integer getResultBalance() {
+    return resultBalance;
+  }
+
+  public void setResultBalance(Integer resultBalance) {
+    this.resultBalance = resultBalance;
+  }
+
+  @Override
+  public String toString() {
+    return "WxMpMemberCardUpdateResult{" +
+      "errorCode='" + errorCode + '\'' +
+      ", errorMsg='" + errorMsg + '\'' +
+      ", openId='" + openId + '\'' +
+      ", resultBonus=" + resultBonus +
+      ", resultBalance=" + resultBalance +
+      '}';
+  }
+
+  public static WxMpMemberCardUpdateResult fromJson(String json) {
+    return WxMpGsonBuilder.INSTANCE.create().fromJson(json, WxMpMemberCardUpdateResult.class);
+  }
+}