| @@ -1,5 +1,8 @@ | |||
| package me.chanjar.weixin.common.bean; | |||
| import org.apache.commons.lang3.builder.ToStringBuilder; | |||
| import org.apache.commons.lang3.builder.ToStringStyle; | |||
| import java.io.Serializable; | |||
| /** | |||
| @@ -10,95 +13,100 @@ import java.io.Serializable; | |||
| */ | |||
| public class WxCardApiSignature implements Serializable { | |||
| private static final long serialVersionUID = 158176707226975979L; | |||
| private static final long serialVersionUID = 158176707226975979L; | |||
| private String appId; | |||
| private String appId; | |||
| private String cardId; | |||
| private String cardId; | |||
| private String cardType; | |||
| private String cardType; | |||
| private String locationId; | |||
| private String locationId; | |||
| private String code; | |||
| private String code; | |||
| private String openId; | |||
| private String openId; | |||
| private Long timestamp; | |||
| private Long timestamp; | |||
| private String nonceStr; | |||
| private String nonceStr; | |||
| private String signature; | |||
| private String signature; | |||
| public String getAppId() { | |||
| return appId; | |||
| } | |||
| @Override | |||
| public String toString() { | |||
| return ToStringBuilder.reflectionToString(this, ToStringStyle.JSON_STYLE); | |||
| } | |||
| public void setAppId(String appId) { | |||
| this.appId = appId; | |||
| } | |||
| public String getAppId() { | |||
| return appId; | |||
| } | |||
| public void setAppId(String appId) { | |||
| this.appId = appId; | |||
| } | |||
| public String getCardId() { | |||
| return cardId; | |||
| } | |||
| public String getCardId() { | |||
| return cardId; | |||
| } | |||
| public void setCardId(String cardId) { | |||
| this.cardId = cardId; | |||
| } | |||
| public void setCardId(String cardId) { | |||
| this.cardId = cardId; | |||
| } | |||
| public String getCardType() { | |||
| return cardType; | |||
| } | |||
| public String getCardType() { | |||
| return cardType; | |||
| } | |||
| public void setCardType(String cardType) { | |||
| this.cardType = cardType; | |||
| } | |||
| public void setCardType(String cardType) { | |||
| this.cardType = cardType; | |||
| } | |||
| public String getLocationId() { | |||
| return locationId; | |||
| } | |||
| public String getLocationId() { | |||
| return locationId; | |||
| } | |||
| public void setLocationId(String locationId) { | |||
| this.locationId = locationId; | |||
| } | |||
| public String getCode() { | |||
| return code; | |||
| } | |||
| return code; | |||
| } | |||
| public void setCode(String code) { | |||
| this.code = code; | |||
| } | |||
| public void setCode(String code) { | |||
| this.code = code; | |||
| } | |||
| public String getOpenId() { | |||
| return openId; | |||
| } | |||
| public String getOpenId() { | |||
| return openId; | |||
| } | |||
| public void setOpenId(String openId) { | |||
| this.openId = openId; | |||
| } | |||
| public void setOpenId(String openId) { | |||
| this.openId = openId; | |||
| } | |||
| public Long getTimestamp() { | |||
| return timestamp; | |||
| } | |||
| public Long getTimestamp() { | |||
| return timestamp; | |||
| } | |||
| public void setTimestamp(Long timestamp) { | |||
| this.timestamp = timestamp; | |||
| } | |||
| public void setTimestamp(Long timestamp) { | |||
| this.timestamp = timestamp; | |||
| } | |||
| public String getNonceStr() { | |||
| return nonceStr; | |||
| } | |||
| public String getNonceStr() { | |||
| return nonceStr; | |||
| } | |||
| public void setNonceStr(String nonceStr) { | |||
| this.nonceStr = nonceStr; | |||
| } | |||
| public void setNonceStr(String nonceStr) { | |||
| this.nonceStr = nonceStr; | |||
| } | |||
| public String getSignature() { | |||
| return signature; | |||
| } | |||
| public String getSignature() { | |||
| return signature; | |||
| } | |||
| public void setSignature(String signature) { | |||
| this.signature = signature; | |||
| } | |||
| public void setSignature(String signature) { | |||
| this.signature = signature; | |||
| } | |||
| } | |||
| @@ -0,0 +1,115 @@ | |||
| package me.chanjar.weixin.mp.api; | |||
| import me.chanjar.weixin.common.bean.WxCardApiSignature; | |||
| import me.chanjar.weixin.common.exception.WxErrorException; | |||
| import me.chanjar.weixin.mp.bean.result.WxMpCardResult; | |||
| /** | |||
| * 卡券相关接口 | |||
| * Created by Binary Wang on 2016/7/27. | |||
| * @author binarywang(https://github.com/binarywang) | |||
| */ | |||
| public interface WxMpCardService { | |||
| /** | |||
| * 获得卡券api_ticket,不强制刷新卡券api_ticket | |||
| * | |||
| * @return 卡券api_ticket | |||
| * @throws WxErrorException | |||
| * @see #getCardApiTicket(boolean) | |||
| */ | |||
| String getCardApiTicket() throws WxErrorException; | |||
| /** | |||
| * <pre> | |||
| * 获得卡券api_ticket | |||
| * 获得时会检查卡券apiToken是否过期,如果过期了,那么就刷新一下,否则就什么都不干 | |||
| * | |||
| * 详情请见:http://mp.weixin.qq.com/wiki/7/aaa137b55fb2e0456bf8dd9148dd613f.html#.E9.99.84.E5.BD.954-.E5.8D.A1.E5.88.B8.E6.89.A9.E5.B1.95.E5.AD.97.E6.AE.B5.E5.8F.8A.E7.AD.BE.E5.90.8D.E7.94.9F.E6.88.90.E7.AE.97.E6.B3.95 | |||
| * </pre> | |||
| * | |||
| * @param forceRefresh 强制刷新 | |||
| * @return 卡券api_ticket | |||
| * @throws WxErrorException | |||
| */ | |||
| String getCardApiTicket(boolean forceRefresh) throws WxErrorException; | |||
| /** | |||
| * <pre> | |||
| * 创建调用卡券api时所需要的签名 | |||
| * | |||
| * 详情请见:http://mp.weixin.qq.com/wiki/7/aaa137b55fb2e0456bf8dd9148dd613f.html#.E9.99.84.E5.BD | |||
| * .954-.E5.8D.A1.E5.88.B8.E6.89.A9.E5.B1.95.E5.AD.97.E6.AE.B5.E5.8F.8A.E7.AD.BE.E5.90.8D.E7.94 | |||
| * .9F.E6.88.90.E7.AE.97.E6.B3.95 | |||
| * </pre> | |||
| * | |||
| * @param optionalSignParam 参与签名的参数数组。 | |||
| * 可以为下列字段:app_id, card_id, card_type, code, openid, location_id | |||
| * </br>注意:当做wx.chooseCard调用时,必须传入app_id参与签名,否则会造成签名失败导致拉取卡券列表为空 | |||
| * @return 卡券Api签名对象 | |||
| */ | |||
| WxCardApiSignature createCardApiSignature(String... optionalSignParam) throws | |||
| WxErrorException; | |||
| /** | |||
| * 卡券Code解码 | |||
| * | |||
| * @param encryptCode 加密Code,通过JSSDK的chooseCard接口获得 | |||
| * @return 解密后的Code | |||
| */ | |||
| String decryptCardCode(String encryptCode) throws WxErrorException; | |||
| /** | |||
| * 卡券Code查询 | |||
| * | |||
| * @param cardId 卡券ID代表一类卡券 | |||
| * @param code 单张卡券的唯一标准 | |||
| * @param checkConsume 是否校验code核销状态,填入true和false时的code异常状态返回数据不同 | |||
| * @return WxMpCardResult对象 | |||
| */ | |||
| WxMpCardResult queryCardCode(String cardId, String code, boolean checkConsume) | |||
| throws WxErrorException; | |||
| /** | |||
| * 卡券Code核销。核销失败会抛出异常 | |||
| * | |||
| * @param code 单张卡券的唯一标准 | |||
| * @return 调用返回的JSON字符串。 | |||
| * <br>可用 com.google.gson.JsonParser#parse 等方法直接取JSON串中的errcode等信息。 | |||
| */ | |||
| String consumeCardCode(String code) throws WxErrorException; | |||
| /** | |||
| * 卡券Code核销。核销失败会抛出异常 | |||
| * | |||
| * @param code 单张卡券的唯一标准 | |||
| * @param cardId 当自定义Code卡券时需要传入card_id | |||
| * @return 调用返回的JSON字符串。 | |||
| * <br>可用 com.google.gson.JsonParser#parse 等方法直接取JSON串中的errcode等信息。 | |||
| */ | |||
| String consumeCardCode(String code, String cardId) throws WxErrorException; | |||
| /** | |||
| * 卡券Mark接口。 | |||
| * 开发者在帮助消费者核销卡券之前,必须帮助先将此code(卡券串码)与一个openid绑定(即mark住), | |||
| * 才能进一步调用核销接口,否则报错。 | |||
| * | |||
| * @param code 卡券的code码 | |||
| * @param cardId 卡券的ID | |||
| * @param openId 用券用户的openid | |||
| * @param isMark 是否要mark(占用)这个code,填写true或者false,表示占用或解除占用 | |||
| */ | |||
| void markCardCode(String code, String cardId, String openId, boolean isMark) throws | |||
| WxErrorException; | |||
| /** | |||
| * 查看卡券详情接口 | |||
| * 详见 https://mp.weixin.qq.com/wiki/14/8dd77aeaee85f922db5f8aa6386d385e.html#.E6.9F.A5.E7.9C.8B.E5.8D.A1.E5.88.B8.E8.AF.A6.E6.83.85 | |||
| * | |||
| * @param cardId 卡券的ID | |||
| * @return 返回的卡券详情JSON字符串 | |||
| * <br> [注] 由于返回的JSON格式过于复杂,难以定义其对应格式的Bean并且难以维护,因此只返回String格式的JSON串。 | |||
| * <br> 可由 com.google.gson.JsonParser#parse 等方法直接取JSON串中的某个字段。 | |||
| */ | |||
| String getCardDetail(String cardId) throws WxErrorException; | |||
| } | |||
| @@ -1,6 +1,5 @@ | |||
| package me.chanjar.weixin.mp.api; | |||
| import me.chanjar.weixin.common.bean.WxCardApiSignature; | |||
| import me.chanjar.weixin.common.bean.WxJsapiSignature; | |||
| import me.chanjar.weixin.common.exception.WxErrorException; | |||
| import me.chanjar.weixin.common.util.http.RequestExecutor; | |||
| @@ -15,7 +14,7 @@ import java.util.Map; | |||
| */ | |||
| public interface WxMpService { | |||
| public static final SimpleDateFormat SIMPLE_DATE_FORMAT = new SimpleDateFormat("yyyy-MM-dd"); | |||
| SimpleDateFormat SIMPLE_DATE_FORMAT = new SimpleDateFormat("yyyy-MM-dd"); | |||
| /** | |||
| * <pre> | |||
| @@ -23,14 +22,14 @@ public interface WxMpService { | |||
| * 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=验证消息真实性 | |||
| * </pre> | |||
| */ | |||
| public boolean checkSignature(String timestamp, String nonce, String signature); | |||
| boolean checkSignature(String timestamp, String nonce, String signature); | |||
| /** | |||
| * 获取access_token, 不强制刷新access_token | |||
| * | |||
| * @see #getAccessToken(boolean) | |||
| */ | |||
| public String getAccessToken() throws WxErrorException; | |||
| String getAccessToken() throws WxErrorException; | |||
| /** | |||
| * <pre> | |||
| @@ -46,14 +45,14 @@ public interface WxMpService { | |||
| * | |||
| * @param forceRefresh 强制刷新 | |||
| */ | |||
| public String getAccessToken(boolean forceRefresh) throws WxErrorException; | |||
| String getAccessToken(boolean forceRefresh) throws WxErrorException; | |||
| /** | |||
| * 获得jsapi_ticket,不强制刷新jsapi_ticket | |||
| * | |||
| * @see #getJsapiTicket(boolean) | |||
| */ | |||
| public String getJsapiTicket() throws WxErrorException; | |||
| String getJsapiTicket() throws WxErrorException; | |||
| /** | |||
| * <pre> | |||
| @@ -65,7 +64,7 @@ public interface WxMpService { | |||
| * | |||
| * @param forceRefresh 强制刷新 | |||
| */ | |||
| public String getJsapiTicket(boolean forceRefresh) throws WxErrorException; | |||
| String getJsapiTicket(boolean forceRefresh) throws WxErrorException; | |||
| /** | |||
| * <pre> | |||
| @@ -74,7 +73,7 @@ public interface WxMpService { | |||
| * 详情请见:http://mp.weixin.qq.com/wiki/7/aaa137b55fb2e0456bf8dd9148dd613f.html#.E9.99.84.E5.BD.951-JS-SDK.E4.BD.BF.E7.94.A8.E6.9D.83.E9.99.90.E7.AD.BE.E5.90.8D.E7.AE.97.E6.B3.95 | |||
| * </pre> | |||
| */ | |||
| public WxJsapiSignature createJsapiSignature(String url) throws WxErrorException; | |||
| WxJsapiSignature createJsapiSignature(String url) throws WxErrorException; | |||
| /** | |||
| * <pre> | |||
| @@ -82,7 +81,7 @@ public interface WxMpService { | |||
| * 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=发送客服消息 | |||
| * </pre> | |||
| */ | |||
| public void customMessageSend(WxMpCustomMessage message) throws WxErrorException; | |||
| void customMessageSend(WxMpCustomMessage message) throws WxErrorException; | |||
| /** | |||
| * <pre> | |||
| @@ -96,7 +95,7 @@ public interface WxMpService { | |||
| * @see #massGroupMessageSend(me.chanjar.weixin.mp.bean.WxMpMassGroupMessage) | |||
| * @see #massOpenIdsMessageSend(me.chanjar.weixin.mp.bean.WxMpMassOpenIdsMessage) | |||
| */ | |||
| public WxMpMassUploadResult massNewsUpload(WxMpMassNews news) throws WxErrorException; | |||
| WxMpMassUploadResult massNewsUpload(WxMpMassNews news) throws WxErrorException; | |||
| /** | |||
| * <pre> | |||
| @@ -107,7 +106,7 @@ public interface WxMpService { | |||
| * @see #massGroupMessageSend(me.chanjar.weixin.mp.bean.WxMpMassGroupMessage) | |||
| * @see #massOpenIdsMessageSend(me.chanjar.weixin.mp.bean.WxMpMassOpenIdsMessage) | |||
| */ | |||
| public WxMpMassUploadResult massVideoUpload(WxMpMassVideo video) throws WxErrorException; | |||
| WxMpMassUploadResult massVideoUpload(WxMpMassVideo video) throws WxErrorException; | |||
| /** | |||
| * <pre> | |||
| @@ -117,7 +116,7 @@ public interface WxMpService { | |||
| * 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=高级群发接口 | |||
| * </pre> | |||
| */ | |||
| public WxMpMassSendResult massGroupMessageSend(WxMpMassGroupMessage message) throws WxErrorException; | |||
| WxMpMassSendResult massGroupMessageSend(WxMpMassGroupMessage message) throws WxErrorException; | |||
| /** | |||
| * <pre> | |||
| @@ -127,7 +126,7 @@ public interface WxMpService { | |||
| * 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=高级群发接口 | |||
| * </pre> | |||
| */ | |||
| public WxMpMassSendResult massOpenIdsMessageSend(WxMpMassOpenIdsMessage message) throws WxErrorException; | |||
| WxMpMassSendResult massOpenIdsMessageSend(WxMpMassOpenIdsMessage message) throws WxErrorException; | |||
| /** | |||
| * <pre> | |||
| @@ -137,7 +136,7 @@ public interface WxMpService { | |||
| * | |||
| * @param long_url | |||
| */ | |||
| public String shortUrl(String long_url) throws WxErrorException; | |||
| String shortUrl(String long_url) throws WxErrorException; | |||
| /** | |||
| * <pre> | |||
| @@ -149,7 +148,7 @@ public interface WxMpService { | |||
| * @return msgid | |||
| * @throws WxErrorException | |||
| */ | |||
| public String templateSend(WxMpTemplateMessage templateMessage) throws WxErrorException; | |||
| String templateSend(WxMpTemplateMessage templateMessage) throws WxErrorException; | |||
| /** | |||
| * <pre> | |||
| @@ -169,7 +168,7 @@ public interface WxMpService { | |||
| * @param state | |||
| * @return url | |||
| */ | |||
| public String oauth2buildAuthorizationUrl(String scope, String state); | |||
| String oauth2buildAuthorizationUrl(String scope, String state); | |||
| /** | |||
| * <pre> | |||
| @@ -182,7 +181,7 @@ public interface WxMpService { | |||
| * @param state | |||
| * @return url | |||
| */ | |||
| public String oauth2buildAuthorizationUrl(String redirectURI, String scope, String state); | |||
| String oauth2buildAuthorizationUrl(String redirectURI, String scope, String state); | |||
| /** | |||
| * <pre> | |||
| @@ -190,14 +189,14 @@ public interface WxMpService { | |||
| * 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=网页授权获取用户基本信息 | |||
| * </pre> | |||
| */ | |||
| public WxMpOAuth2AccessToken oauth2getAccessToken(String code) throws WxErrorException; | |||
| WxMpOAuth2AccessToken oauth2getAccessToken(String code) throws WxErrorException; | |||
| /** | |||
| * <pre> | |||
| * 刷新oauth2的access token | |||
| * </pre> | |||
| */ | |||
| public WxMpOAuth2AccessToken oauth2refreshAccessToken(String refreshToken) throws WxErrorException; | |||
| WxMpOAuth2AccessToken oauth2refreshAccessToken(String refreshToken) throws WxErrorException; | |||
| /** | |||
| * <pre> | |||
| @@ -207,7 +206,7 @@ public interface WxMpService { | |||
| * @param oAuth2AccessToken | |||
| * @param lang zh_CN, zh_TW, en | |||
| */ | |||
| public WxMpUser oauth2getUserInfo(WxMpOAuth2AccessToken oAuth2AccessToken, String lang) throws WxErrorException; | |||
| WxMpUser oauth2getUserInfo(WxMpOAuth2AccessToken oAuth2AccessToken, String lang) throws WxErrorException; | |||
| /** | |||
| * <pre> | |||
| @@ -216,7 +215,7 @@ public interface WxMpService { | |||
| * | |||
| * @param oAuth2AccessToken | |||
| */ | |||
| public boolean oauth2validateAccessToken(WxMpOAuth2AccessToken oAuth2AccessToken); | |||
| boolean oauth2validateAccessToken(WxMpOAuth2AccessToken oAuth2AccessToken); | |||
| /** | |||
| * <pre> | |||
| @@ -243,12 +242,12 @@ public interface WxMpService { | |||
| * 可以参考,{@link me.chanjar.weixin.common.util.http.MediaUploadRequestExecutor}的实现方法 | |||
| * </pre> | |||
| */ | |||
| public <T, E> T execute(RequestExecutor<T, E> executor, String uri, E data) throws WxErrorException; | |||
| <T, E> T execute(RequestExecutor<T, E> executor, String uri, E data) throws WxErrorException; | |||
| /** | |||
| * 注入 {@link WxMpConfigStorage} 的实现 | |||
| */ | |||
| public void setWxMpConfigStorage(WxMpConfigStorage wxConfigProvider); | |||
| void setWxMpConfigStorage(WxMpConfigStorage wxConfigProvider); | |||
| /** | |||
| * <pre> | |||
| @@ -361,7 +360,7 @@ public interface WxMpService { | |||
| * @return 退款操作结果 | |||
| * @throws WxErrorException | |||
| */ | |||
| public WxMpPayRefundResult refundPay(Map<String, String> parameters) throws WxErrorException; | |||
| WxMpPayRefundResult refundPay(Map<String, String> parameters) throws WxErrorException; | |||
| /** | |||
| * <pre> | |||
| @@ -372,7 +371,7 @@ public interface WxMpService { | |||
| * @param kvm | |||
| * @param signature | |||
| */ | |||
| public boolean checkJSSDKCallbackDataSignature(Map<String, String> kvm, String signature); | |||
| boolean checkJSSDKCallbackDataSignature(Map<String, String> kvm, String signature); | |||
| /** | |||
| * 发送微信红包给个人用户 | |||
| @@ -395,115 +394,7 @@ public interface WxMpService { | |||
| * | |||
| * @param parameters | |||
| */ | |||
| public WxRedpackResult sendRedpack(Map<String, String> parameters) throws WxErrorException; | |||
| /** | |||
| * 获得卡券api_ticket,不强制刷新卡券api_ticket | |||
| * | |||
| * @return 卡券api_ticket | |||
| * @throws WxErrorException | |||
| * @see #getCardApiTicket(boolean) | |||
| */ | |||
| public String getCardApiTicket() throws WxErrorException; | |||
| /** | |||
| * <pre> | |||
| * 获得卡券api_ticket | |||
| * 获得时会检查卡券apiToken是否过期,如果过期了,那么就刷新一下,否则就什么都不干 | |||
| * | |||
| * 详情请见:http://mp.weixin.qq.com/wiki/7/aaa137b55fb2e0456bf8dd9148dd613f.html#.E9.99.84.E5.BD.954-.E5.8D.A1.E5.88.B8.E6.89.A9.E5.B1.95.E5.AD.97.E6.AE.B5.E5.8F.8A.E7.AD.BE.E5.90.8D.E7.94.9F.E6.88.90.E7.AE.97.E6.B3.95 | |||
| * </pre> | |||
| * | |||
| * @param forceRefresh 强制刷新 | |||
| * @return 卡券api_ticket | |||
| * @throws WxErrorException | |||
| */ | |||
| public String getCardApiTicket(boolean forceRefresh) throws WxErrorException; | |||
| /** | |||
| * <pre> | |||
| * 创建调用卡券api时所需要的签名 | |||
| * | |||
| * 详情请见:http://mp.weixin.qq.com/wiki/7/aaa137b55fb2e0456bf8dd9148dd613f.html#.E9.99.84.E5.BD | |||
| * .954-.E5.8D.A1.E5.88.B8.E6.89.A9.E5.B1.95.E5.AD.97.E6.AE.B5.E5.8F.8A.E7.AD.BE.E5.90.8D.E7.94 | |||
| * .9F.E6.88.90.E7.AE.97.E6.B3.95 | |||
| * </pre> | |||
| * | |||
| * @param optionalSignParam 参与签名的参数数组。 | |||
| * 可以为下列字段:app_id, card_id, card_type, code, openid, location_id | |||
| * </br>注意:当做wx.chooseCard调用时,必须传入app_id参与签名,否则会造成签名失败导致拉取卡券列表为空 | |||
| * @return 卡券Api签名对象 | |||
| */ | |||
| public WxCardApiSignature createCardApiSignature(String... optionalSignParam) throws | |||
| WxErrorException; | |||
| /** | |||
| * 卡券Code解码 | |||
| * | |||
| * @param encryptCode 加密Code,通过JSSDK的chooseCard接口获得 | |||
| * @return 解密后的Code | |||
| * @throws WxErrorException | |||
| */ | |||
| public String decryptCardCode(String encryptCode) throws WxErrorException; | |||
| /** | |||
| * 卡券Code查询 | |||
| * | |||
| * @param cardId 卡券ID代表一类卡券 | |||
| * @param code 单张卡券的唯一标准 | |||
| * @param checkConsume 是否校验code核销状态,填入true和false时的code异常状态返回数据不同 | |||
| * @return WxMpCardResult对象 | |||
| * @throws WxErrorException | |||
| */ | |||
| public WxMpCardResult queryCardCode(String cardId, String code, boolean checkConsume) | |||
| throws WxErrorException; | |||
| /** | |||
| * 卡券Code核销。核销失败会抛出异常 | |||
| * | |||
| * @param code 单张卡券的唯一标准 | |||
| * @return 调用返回的JSON字符串。 | |||
| * <br>可用 com.google.gson.JsonParser#parse 等方法直接取JSON串中的errcode等信息。 | |||
| * @throws WxErrorException | |||
| */ | |||
| public String consumeCardCode(String code) throws WxErrorException; | |||
| /** | |||
| * 卡券Code核销。核销失败会抛出异常 | |||
| * | |||
| * @param code 单张卡券的唯一标准 | |||
| * @param cardId 当自定义Code卡券时需要传入card_id | |||
| * @return 调用返回的JSON字符串。 | |||
| * <br>可用 com.google.gson.JsonParser#parse 等方法直接取JSON串中的errcode等信息。 | |||
| * @throws WxErrorException | |||
| */ | |||
| public String consumeCardCode(String code, String cardId) throws WxErrorException; | |||
| /** | |||
| * 卡券Mark接口。 | |||
| * 开发者在帮助消费者核销卡券之前,必须帮助先将此code(卡券串码)与一个openid绑定(即mark住), | |||
| * 才能进一步调用核销接口,否则报错。 | |||
| * | |||
| * @param code 卡券的code码 | |||
| * @param cardId 卡券的ID | |||
| * @param openId 用券用户的openid | |||
| * @param isMark 是否要mark(占用)这个code,填写true或者false,表示占用或解除占用 | |||
| * @throws WxErrorException | |||
| */ | |||
| public void markCardCode(String code, String cardId, String openId, boolean isMark) throws | |||
| WxErrorException; | |||
| /** | |||
| * 查看卡券详情接口 | |||
| * 详见 https://mp.weixin.qq.com/wiki/14/8dd77aeaee85f922db5f8aa6386d385e.html#.E6.9F.A5.E7.9C.8B.E5.8D.A1.E5.88.B8.E8.AF.A6.E6.83.85 | |||
| * | |||
| * @param cardId 卡券的ID | |||
| * @return 返回的卡券详情JSON字符串 | |||
| * <br> [注] 由于返回的JSON格式过于复杂,难以定义其对应格式的Bean并且难以维护,因此只返回String格式的JSON串。 | |||
| * <br> 可由 com.google.gson.JsonParser#parse 等方法直接取JSON串中的某个字段。 | |||
| * @throws WxErrorException | |||
| */ | |||
| public String getCardDetail(String cardId) throws WxErrorException; | |||
| WxRedpackResult sendRedpack(Map<String, String> parameters) throws WxErrorException; | |||
| /** | |||
| * <pre> | |||
| @@ -515,7 +406,7 @@ public interface WxMpService { | |||
| * @return wxMpMassSendResult | |||
| * @throws WxErrorException | |||
| */ | |||
| public WxMpMassSendResult massMessagePreview(WxMpMassPreviewMessage wxMpMassPreviewMessage) throws Exception; | |||
| WxMpMassSendResult massMessagePreview(WxMpMassPreviewMessage wxMpMassPreviewMessage) throws Exception; | |||
| /** | |||
| * <pre> | |||
| @@ -589,4 +480,11 @@ public interface WxMpService { | |||
| * @return WxMpQrcodeService | |||
| */ | |||
| WxMpQrcodeService getQrcodeService(); | |||
| /** | |||
| * 返回卡券相关接口的方法实现类,以方便调用个其各种接口 | |||
| * | |||
| * @return WxMpCardService | |||
| */ | |||
| WxMpCardService getCardService(); | |||
| } | |||
| @@ -0,0 +1,248 @@ | |||
| package me.chanjar.weixin.mp.api.impl; | |||
| import com.google.gson.JsonElement; | |||
| import com.google.gson.JsonObject; | |||
| import com.google.gson.JsonParser; | |||
| import com.google.gson.JsonPrimitive; | |||
| import com.google.gson.internal.Streams; | |||
| import com.google.gson.reflect.TypeToken; | |||
| import com.google.gson.stream.JsonReader; | |||
| import me.chanjar.weixin.common.bean.WxCardApiSignature; | |||
| import me.chanjar.weixin.common.bean.result.WxError; | |||
| import me.chanjar.weixin.common.exception.WxErrorException; | |||
| import me.chanjar.weixin.common.util.RandomUtils; | |||
| import me.chanjar.weixin.common.util.crypto.SHA1; | |||
| import me.chanjar.weixin.common.util.http.SimpleGetRequestExecutor; | |||
| import me.chanjar.weixin.mp.api.WxMpCardService; | |||
| import me.chanjar.weixin.mp.api.WxMpService; | |||
| import me.chanjar.weixin.mp.bean.result.WxMpCardResult; | |||
| import me.chanjar.weixin.mp.util.json.WxMpGsonBuilder; | |||
| import org.slf4j.Logger; | |||
| import org.slf4j.LoggerFactory; | |||
| import java.io.StringReader; | |||
| import java.security.NoSuchAlgorithmException; | |||
| import java.util.Arrays; | |||
| /** | |||
| * Created by Binary Wang on 2016/7/27. | |||
| */ | |||
| public class WxMpCardServiceImpl implements WxMpCardService { | |||
| private final Logger log = LoggerFactory.getLogger(WxMpCardServiceImpl.class); | |||
| /** | |||
| * 全局的是否正在刷新卡券api_ticket的锁 | |||
| */ | |||
| private final Object globalCardApiTicketRefreshLock = new Object(); | |||
| private WxMpService wxMpService; | |||
| WxMpCardServiceImpl(WxMpService wxMpService) { | |||
| this.wxMpService = wxMpService; | |||
| } | |||
| /** | |||
| * 获得卡券api_ticket,不强制刷新卡券api_ticket | |||
| * | |||
| * @return 卡券api_ticket | |||
| * @see #getCardApiTicket(boolean) | |||
| */ | |||
| @Override | |||
| public String getCardApiTicket() throws WxErrorException { | |||
| return getCardApiTicket(false); | |||
| } | |||
| /** | |||
| * <pre> | |||
| * 获得卡券api_ticket | |||
| * 获得时会检查卡券apiToken是否过期,如果过期了,那么就刷新一下,否则就什么都不干 | |||
| * | |||
| * 详情请见:http://mp.weixin.qq.com/wiki/7/aaa137b55fb2e0456bf8dd9148dd613f.html#.E9.99.84.E5.BD | |||
| * .954-.E5.8D.A1.E5.88.B8.E6.89.A9.E5.B1.95.E5.AD.97.E6.AE.B5.E5.8F.8A.E7.AD.BE.E5.90.8D.E7.94 | |||
| * .9F.E6.88.90.E7.AE.97.E6.B3.95 | |||
| * </pre> | |||
| * | |||
| * @param forceRefresh 强制刷新 | |||
| * @return 卡券api_ticket | |||
| */ | |||
| @Override | |||
| public String getCardApiTicket(boolean forceRefresh) throws WxErrorException { | |||
| if (forceRefresh) { | |||
| this.wxMpService.getWxMpConfigStorage().expireCardApiTicket(); | |||
| } | |||
| if (this.wxMpService.getWxMpConfigStorage().isCardApiTicketExpired()) { | |||
| synchronized (this.globalCardApiTicketRefreshLock) { | |||
| if (this.wxMpService.getWxMpConfigStorage().isCardApiTicketExpired()) { | |||
| String url = "https://api.weixin.qq.com/cgi-bin/ticket/getticket?type=wx_card"; | |||
| String responseContent = this.wxMpService.execute(new SimpleGetRequestExecutor(), url, null); | |||
| JsonElement tmpJsonElement = Streams.parse(new JsonReader(new StringReader(responseContent))); | |||
| JsonObject tmpJsonObject = tmpJsonElement.getAsJsonObject(); | |||
| String cardApiTicket = tmpJsonObject.get("ticket").getAsString(); | |||
| int expiresInSeconds = tmpJsonObject.get("expires_in").getAsInt(); | |||
| this.wxMpService.getWxMpConfigStorage().updateCardApiTicket(cardApiTicket, expiresInSeconds); | |||
| } | |||
| } | |||
| } | |||
| return this.wxMpService.getWxMpConfigStorage().getCardApiTicket(); | |||
| } | |||
| /** | |||
| * <pre> | |||
| * 创建调用卡券api时所需要的签名 | |||
| * | |||
| * 详情请见:http://mp.weixin.qq.com/wiki/7/aaa137b55fb2e0456bf8dd9148dd613f.html#.E9.99.84.E5.BD | |||
| * .954-.E5.8D.A1.E5.88.B8.E6.89.A9.E5.B1.95.E5.AD.97.E6.AE.B5.E5.8F.8A.E7.AD.BE.E5.90.8D.E7.94 | |||
| * .9F.E6.88.90.E7.AE.97.E6.B3.95 | |||
| * </pre> | |||
| * | |||
| * @param optionalSignParam 参与签名的参数数组。 | |||
| * 可以为下列字段:app_id, card_id, card_type, code, openid, location_id | |||
| * </br>注意:当做wx.chooseCard调用时,必须传入app_id参与签名,否则会造成签名失败导致拉取卡券列表为空 | |||
| * @return 卡券Api签名对象 | |||
| */ | |||
| @Override | |||
| public WxCardApiSignature createCardApiSignature(String... optionalSignParam) throws | |||
| WxErrorException { | |||
| long timestamp = System.currentTimeMillis() / 1000; | |||
| String nonceStr = RandomUtils.getRandomStr(); | |||
| String cardApiTicket = getCardApiTicket(false); | |||
| String[] signParam = Arrays.copyOf(optionalSignParam, optionalSignParam.length + 3); | |||
| signParam[optionalSignParam.length] = String.valueOf(timestamp); | |||
| signParam[optionalSignParam.length + 1] = nonceStr; | |||
| signParam[optionalSignParam.length + 2] = cardApiTicket; | |||
| try { | |||
| String signature = SHA1.gen(signParam); | |||
| WxCardApiSignature cardApiSignature = new WxCardApiSignature(); | |||
| cardApiSignature.setTimestamp(timestamp); | |||
| cardApiSignature.setNonceStr(nonceStr); | |||
| cardApiSignature.setSignature(signature); | |||
| return cardApiSignature; | |||
| } catch (NoSuchAlgorithmException e) { | |||
| throw new WxErrorException(WxError.newBuilder().setErrorMsg(e.getMessage()).build()); | |||
| } | |||
| } | |||
| /** | |||
| * 卡券Code解码 | |||
| * | |||
| * @param encryptCode 加密Code,通过JSSDK的chooseCard接口获得 | |||
| * @return 解密后的Code | |||
| */ | |||
| @Override | |||
| public String decryptCardCode(String encryptCode) throws WxErrorException { | |||
| String url = "https://api.weixin.qq.com/card/code/decrypt"; | |||
| JsonObject param = new JsonObject(); | |||
| param.addProperty("encrypt_code", encryptCode); | |||
| String responseContent = this.wxMpService.post(url, param.toString()); | |||
| JsonElement tmpJsonElement = Streams.parse(new JsonReader(new StringReader(responseContent))); | |||
| JsonObject tmpJsonObject = tmpJsonElement.getAsJsonObject(); | |||
| JsonPrimitive jsonPrimitive = tmpJsonObject.getAsJsonPrimitive("code"); | |||
| return jsonPrimitive.getAsString(); | |||
| } | |||
| /** | |||
| * 卡券Code查询 | |||
| * | |||
| * @param cardId 卡券ID代表一类卡券 | |||
| * @param code 单张卡券的唯一标准 | |||
| * @param checkConsume 是否校验code核销状态,填入true和false时的code异常状态返回数据不同 | |||
| * @return WxMpCardResult对象 | |||
| */ | |||
| @Override | |||
| public WxMpCardResult queryCardCode(String cardId, String code, boolean checkConsume) throws WxErrorException { | |||
| String url = "https://api.weixin.qq.com/card/code/get"; | |||
| JsonObject param = new JsonObject(); | |||
| param.addProperty("card_id", cardId); | |||
| param.addProperty("code", code); | |||
| param.addProperty("check_consume", checkConsume); | |||
| String responseContent = this.wxMpService.post(url, param.toString()); | |||
| JsonElement tmpJsonElement = Streams.parse(new JsonReader(new StringReader(responseContent))); | |||
| return WxMpGsonBuilder.INSTANCE.create().fromJson(tmpJsonElement, | |||
| new TypeToken<WxMpCardResult>() { | |||
| }.getType()); | |||
| } | |||
| /** | |||
| * 卡券Code核销。核销失败会抛出异常 | |||
| * | |||
| * @param code 单张卡券的唯一标准 | |||
| * @return 调用返回的JSON字符串。 | |||
| * <br>可用 com.google.gson.JsonParser#parse 等方法直接取JSON串中的errcode等信息。 | |||
| */ | |||
| @Override | |||
| public String consumeCardCode(String code) throws WxErrorException { | |||
| return consumeCardCode(code, null); | |||
| } | |||
| /** | |||
| * 卡券Code核销。核销失败会抛出异常 | |||
| * | |||
| * @param code 单张卡券的唯一标准 | |||
| * @param cardId 当自定义Code卡券时需要传入card_id | |||
| * @return 调用返回的JSON字符串。 | |||
| * <br>可用 com.google.gson.JsonParser#parse 等方法直接取JSON串中的errcode等信息。 | |||
| */ | |||
| @Override | |||
| public String consumeCardCode(String code, String cardId) throws WxErrorException { | |||
| String url = "https://api.weixin.qq.com/card/code/consume"; | |||
| JsonObject param = new JsonObject(); | |||
| param.addProperty("code", code); | |||
| if (cardId != null && !"".equals(cardId)) { | |||
| param.addProperty("card_id", cardId); | |||
| } | |||
| return this.wxMpService.post(url, param.toString()); | |||
| } | |||
| /** | |||
| * 卡券Mark接口。 | |||
| * 开发者在帮助消费者核销卡券之前,必须帮助先将此code(卡券串码)与一个openid绑定(即mark住), | |||
| * 才能进一步调用核销接口,否则报错。 | |||
| * | |||
| * @param code 卡券的code码 | |||
| * @param cardId 卡券的ID | |||
| * @param openId 用券用户的openid | |||
| * @param isMark 是否要mark(占用)这个code,填写true或者false,表示占用或解除占用 | |||
| */ | |||
| @Override | |||
| public void markCardCode(String code, String cardId, String openId, boolean isMark) throws | |||
| WxErrorException { | |||
| String url = "https://api.weixin.qq.com/card/code/mark"; | |||
| JsonObject param = new JsonObject(); | |||
| param.addProperty("code", code); | |||
| param.addProperty("card_id", cardId); | |||
| param.addProperty("openid", openId); | |||
| param.addProperty("is_mark", isMark); | |||
| String responseContent = this.wxMpService.post(url, param.toString()); | |||
| JsonElement tmpJsonElement = Streams.parse(new JsonReader(new StringReader(responseContent))); | |||
| WxMpCardResult cardResult = WxMpGsonBuilder.INSTANCE.create().fromJson(tmpJsonElement, | |||
| new TypeToken<WxMpCardResult>() { }.getType()); | |||
| if (!cardResult.getErrorCode().equals("0")) { | |||
| this.log.warn("朋友的券mark失败:{}", cardResult.getErrorMsg()); | |||
| } | |||
| } | |||
| @Override | |||
| public String getCardDetail(String cardId) throws WxErrorException { | |||
| String url = "https://api.weixin.qq.com/card/get"; | |||
| JsonObject param = new JsonObject(); | |||
| param.addProperty("card_id", cardId); | |||
| String responseContent = this.wxMpService.post(url, param.toString()); | |||
| // 判断返回值 | |||
| JsonObject json = (new JsonParser()).parse(responseContent).getAsJsonObject(); | |||
| String errcode = json.get("errcode").getAsString(); | |||
| if (!"0".equals(errcode)) { | |||
| String errmsg = json.get("errmsg").getAsString(); | |||
| WxError error = new WxError(); | |||
| error.setErrorCode(Integer.valueOf(errcode)); | |||
| error.setErrorMsg(errmsg); | |||
| throw new WxErrorException(error); | |||
| } | |||
| return responseContent; | |||
| } | |||
| } | |||
| @@ -1,12 +1,12 @@ | |||
| package me.chanjar.weixin.mp.api.impl; | |||
| import com.google.gson.*; | |||
| import com.google.gson.JsonArray; | |||
| import com.google.gson.JsonElement; | |||
| import com.google.gson.JsonObject; | |||
| import com.google.gson.internal.Streams; | |||
| import com.google.gson.reflect.TypeToken; | |||
| import com.google.gson.stream.JsonReader; | |||
| import com.thoughtworks.xstream.XStream; | |||
| import me.chanjar.weixin.common.bean.WxAccessToken; | |||
| import me.chanjar.weixin.common.bean.WxCardApiSignature; | |||
| import me.chanjar.weixin.common.bean.WxJsapiSignature; | |||
| import me.chanjar.weixin.common.bean.result.WxError; | |||
| import me.chanjar.weixin.common.exception.WxErrorException; | |||
| @@ -20,7 +20,6 @@ import me.chanjar.weixin.common.util.xml.XStreamInitializer; | |||
| import me.chanjar.weixin.mp.api.*; | |||
| import me.chanjar.weixin.mp.bean.*; | |||
| import me.chanjar.weixin.mp.bean.result.*; | |||
| import me.chanjar.weixin.mp.util.json.WxMpGsonBuilder; | |||
| import org.apache.http.Consts; | |||
| import org.apache.http.HttpHost; | |||
| import org.apache.http.client.ClientProtocolException; | |||
| @@ -39,8 +38,11 @@ import org.slf4j.helpers.MessageFormatter; | |||
| import java.io.IOException; | |||
| import java.io.StringReader; | |||
| import java.security.NoSuchAlgorithmException; | |||
| import java.util.*; | |||
| import java.util.HashMap; | |||
| import java.util.Map; | |||
| import java.util.Map.Entry; | |||
| import java.util.SortedMap; | |||
| import java.util.TreeMap; | |||
| public class WxMpServiceImpl implements WxMpService { | |||
| @@ -56,11 +58,6 @@ public class WxMpServiceImpl implements WxMpService { | |||
| */ | |||
| protected final Object globalJsapiTicketRefreshLock = new Object(); | |||
| /** | |||
| * 全局的是否正在刷新卡券api_ticket的锁 | |||
| */ | |||
| protected final Object globalCardApiTicketRefreshLock = new Object(); | |||
| protected WxMpConfigStorage wxMpConfigStorage; | |||
| protected WxMpKefuService kefuService = new WxMpKefuServiceImpl(this); | |||
| @@ -75,6 +72,8 @@ public class WxMpServiceImpl implements WxMpService { | |||
| protected WxMpQrcodeService qrCodeService = new WxMpQrcodeServiceImpl(this); | |||
| protected WxMpCardService cardService = new WxMpCardServiceImpl(this); | |||
| protected CloseableHttpClient httpClient; | |||
| protected HttpHost httpProxy; | |||
| @@ -782,218 +781,6 @@ public class WxMpServiceImpl implements WxMpService { | |||
| } | |||
| } | |||
| /** | |||
| * 获得卡券api_ticket,不强制刷新卡券api_ticket | |||
| * | |||
| * @return 卡券api_ticket | |||
| * @throws WxErrorException | |||
| * @see #getCardApiTicket(boolean) | |||
| */ | |||
| @Override | |||
| public String getCardApiTicket() throws WxErrorException { | |||
| return getCardApiTicket(false); | |||
| } | |||
| /** | |||
| * <pre> | |||
| * 获得卡券api_ticket | |||
| * 获得时会检查卡券apiToken是否过期,如果过期了,那么就刷新一下,否则就什么都不干 | |||
| * | |||
| * 详情请见:http://mp.weixin.qq.com/wiki/7/aaa137b55fb2e0456bf8dd9148dd613f.html#.E9.99.84.E5.BD | |||
| * .954-.E5.8D.A1.E5.88.B8.E6.89.A9.E5.B1.95.E5.AD.97.E6.AE.B5.E5.8F.8A.E7.AD.BE.E5.90.8D.E7.94 | |||
| * .9F.E6.88.90.E7.AE.97.E6.B3.95 | |||
| * </pre> | |||
| * | |||
| * @param forceRefresh 强制刷新 | |||
| * @return 卡券api_ticket | |||
| * @throws WxErrorException | |||
| */ | |||
| @Override | |||
| public String getCardApiTicket(boolean forceRefresh) throws WxErrorException { | |||
| if (forceRefresh) { | |||
| this.wxMpConfigStorage.expireCardApiTicket(); | |||
| } | |||
| if (this.wxMpConfigStorage.isCardApiTicketExpired()) { | |||
| synchronized (this.globalCardApiTicketRefreshLock) { | |||
| if (this.wxMpConfigStorage.isCardApiTicketExpired()) { | |||
| String url = "https://api.weixin.qq.com/cgi-bin/ticket/getticket?type=wx_card"; | |||
| String responseContent = execute(new SimpleGetRequestExecutor(), url, null); | |||
| JsonElement tmpJsonElement = Streams.parse(new JsonReader(new StringReader(responseContent))); | |||
| JsonObject tmpJsonObject = tmpJsonElement.getAsJsonObject(); | |||
| String cardApiTicket = tmpJsonObject.get("ticket").getAsString(); | |||
| int expiresInSeconds = tmpJsonObject.get("expires_in").getAsInt(); | |||
| this.wxMpConfigStorage.updateCardApiTicket(cardApiTicket, expiresInSeconds); | |||
| } | |||
| } | |||
| } | |||
| return this.wxMpConfigStorage.getCardApiTicket(); | |||
| } | |||
| /** | |||
| * <pre> | |||
| * 创建调用卡券api时所需要的签名 | |||
| * | |||
| * 详情请见:http://mp.weixin.qq.com/wiki/7/aaa137b55fb2e0456bf8dd9148dd613f.html#.E9.99.84.E5.BD | |||
| * .954-.E5.8D.A1.E5.88.B8.E6.89.A9.E5.B1.95.E5.AD.97.E6.AE.B5.E5.8F.8A.E7.AD.BE.E5.90.8D.E7.94 | |||
| * .9F.E6.88.90.E7.AE.97.E6.B3.95 | |||
| * </pre> | |||
| * | |||
| * @param optionalSignParam 参与签名的参数数组。 | |||
| * 可以为下列字段:app_id, card_id, card_type, code, openid, location_id | |||
| * </br>注意:当做wx.chooseCard调用时,必须传入app_id参与签名,否则会造成签名失败导致拉取卡券列表为空 | |||
| * @return 卡券Api签名对象 | |||
| */ | |||
| @Override | |||
| public WxCardApiSignature createCardApiSignature(String... optionalSignParam) throws | |||
| WxErrorException { | |||
| long timestamp = System.currentTimeMillis() / 1000; | |||
| String nonceStr = RandomUtils.getRandomStr(); | |||
| String cardApiTicket = getCardApiTicket(false); | |||
| String[] signParam = Arrays.copyOf(optionalSignParam, optionalSignParam.length + 3); | |||
| signParam[optionalSignParam.length] = String.valueOf(timestamp); | |||
| signParam[optionalSignParam.length + 1] = nonceStr; | |||
| signParam[optionalSignParam.length + 2] = cardApiTicket; | |||
| try { | |||
| String signature = SHA1.gen(signParam); | |||
| WxCardApiSignature cardApiSignature = new WxCardApiSignature(); | |||
| cardApiSignature.setTimestamp(timestamp); | |||
| cardApiSignature.setNonceStr(nonceStr); | |||
| cardApiSignature.setSignature(signature); | |||
| return cardApiSignature; | |||
| } catch (NoSuchAlgorithmException e) { | |||
| throw new RuntimeException(e); | |||
| } | |||
| } | |||
| /** | |||
| * 卡券Code解码 | |||
| * | |||
| * @param encryptCode 加密Code,通过JSSDK的chooseCard接口获得 | |||
| * @return 解密后的Code | |||
| * @throws WxErrorException | |||
| */ | |||
| @Override | |||
| public String decryptCardCode(String encryptCode) throws WxErrorException { | |||
| String url = "https://api.weixin.qq.com/card/code/decrypt"; | |||
| JsonObject param = new JsonObject(); | |||
| param.addProperty("encrypt_code", encryptCode); | |||
| String responseContent = post(url, param.toString()); | |||
| JsonElement tmpJsonElement = Streams.parse(new JsonReader(new StringReader(responseContent))); | |||
| JsonObject tmpJsonObject = tmpJsonElement.getAsJsonObject(); | |||
| JsonPrimitive jsonPrimitive = tmpJsonObject.getAsJsonPrimitive("code"); | |||
| return jsonPrimitive.getAsString(); | |||
| } | |||
| /** | |||
| * 卡券Code查询 | |||
| * | |||
| * @param cardId 卡券ID代表一类卡券 | |||
| * @param code 单张卡券的唯一标准 | |||
| * @param checkConsume 是否校验code核销状态,填入true和false时的code异常状态返回数据不同 | |||
| * @return WxMpCardResult对象 | |||
| * @throws WxErrorException | |||
| */ | |||
| @Override | |||
| public WxMpCardResult queryCardCode(String cardId, String code, boolean checkConsume) throws WxErrorException { | |||
| String url = "https://api.weixin.qq.com/card/code/get"; | |||
| JsonObject param = new JsonObject(); | |||
| param.addProperty("card_id", cardId); | |||
| param.addProperty("code", code); | |||
| param.addProperty("check_consume", checkConsume); | |||
| String responseContent = post(url, param.toString()); | |||
| JsonElement tmpJsonElement = Streams.parse(new JsonReader(new StringReader(responseContent))); | |||
| return WxMpGsonBuilder.INSTANCE.create().fromJson(tmpJsonElement, | |||
| new TypeToken<WxMpCardResult>() { | |||
| }.getType()); | |||
| } | |||
| /** | |||
| * 卡券Code核销。核销失败会抛出异常 | |||
| * | |||
| * @param code 单张卡券的唯一标准 | |||
| * @return 调用返回的JSON字符串。 | |||
| * <br>可用 com.google.gson.JsonParser#parse 等方法直接取JSON串中的errcode等信息。 | |||
| * @throws WxErrorException | |||
| */ | |||
| @Override | |||
| public String consumeCardCode(String code) throws WxErrorException { | |||
| return consumeCardCode(code, null); | |||
| } | |||
| /** | |||
| * 卡券Code核销。核销失败会抛出异常 | |||
| * | |||
| * @param code 单张卡券的唯一标准 | |||
| * @param cardId 当自定义Code卡券时需要传入card_id | |||
| * @return 调用返回的JSON字符串。 | |||
| * <br>可用 com.google.gson.JsonParser#parse 等方法直接取JSON串中的errcode等信息。 | |||
| * @throws WxErrorException | |||
| */ | |||
| @Override | |||
| public String consumeCardCode(String code, String cardId) throws WxErrorException { | |||
| String url = "https://api.weixin.qq.com/card/code/consume"; | |||
| JsonObject param = new JsonObject(); | |||
| param.addProperty("code", code); | |||
| if (cardId != null && !"".equals(cardId)) { | |||
| param.addProperty("card_id", cardId); | |||
| } | |||
| String responseContent = post(url, param.toString()); | |||
| return responseContent; | |||
| } | |||
| /** | |||
| * 卡券Mark接口。 | |||
| * 开发者在帮助消费者核销卡券之前,必须帮助先将此code(卡券串码)与一个openid绑定(即mark住), | |||
| * 才能进一步调用核销接口,否则报错。 | |||
| * | |||
| * @param code 卡券的code码 | |||
| * @param cardId 卡券的ID | |||
| * @param openId 用券用户的openid | |||
| * @param isMark 是否要mark(占用)这个code,填写true或者false,表示占用或解除占用 | |||
| * @throws WxErrorException | |||
| */ | |||
| @Override | |||
| public void markCardCode(String code, String cardId, String openId, boolean isMark) throws | |||
| WxErrorException { | |||
| String url = "https://api.weixin.qq.com/card/code/mark"; | |||
| JsonObject param = new JsonObject(); | |||
| param.addProperty("code", code); | |||
| param.addProperty("card_id", cardId); | |||
| param.addProperty("openid", openId); | |||
| param.addProperty("is_mark", isMark); | |||
| String responseContent = post(url, param.toString()); | |||
| JsonElement tmpJsonElement = Streams.parse(new JsonReader(new StringReader(responseContent))); | |||
| WxMpCardResult cardResult = WxMpGsonBuilder.INSTANCE.create().fromJson(tmpJsonElement, | |||
| new TypeToken<WxMpCardResult>() { }.getType()); | |||
| if (!cardResult.getErrorCode().equals("0")) { | |||
| this.log.warn("朋友的券mark失败:{}", cardResult.getErrorMsg()); | |||
| } | |||
| } | |||
| @Override | |||
| public String getCardDetail(String cardId) throws WxErrorException { | |||
| String url = "https://api.weixin.qq.com/card/get"; | |||
| JsonObject param = new JsonObject(); | |||
| param.addProperty("card_id", cardId); | |||
| String responseContent = post(url, param.toString()); | |||
| // 判断返回值 | |||
| JsonObject json = (new JsonParser()).parse(responseContent).getAsJsonObject(); | |||
| String errcode = json.get("errcode").getAsString(); | |||
| if (!"0".equals(errcode)) { | |||
| String errmsg = json.get("errmsg").getAsString(); | |||
| WxError error = new WxError(); | |||
| error.setErrorCode(Integer.valueOf(errcode)); | |||
| error.setErrorMsg(errmsg); | |||
| throw new WxErrorException(error); | |||
| } | |||
| return responseContent; | |||
| } | |||
| @Override | |||
| public WxMpMassSendResult massMessagePreview(WxMpMassPreviewMessage wxMpMassPreviewMessage) throws Exception { | |||
| String url = "https://api.weixin.qq.com/cgi-bin/message/mass/preview"; | |||
| @@ -1048,4 +835,9 @@ public class WxMpServiceImpl implements WxMpService { | |||
| return this.qrCodeService; | |||
| } | |||
| @Override | |||
| public WxMpCardService getCardService() { | |||
| return this.cardService; | |||
| } | |||
| } | |||
| @@ -1,6 +1,8 @@ | |||
| package me.chanjar.weixin.mp.bean.result; | |||
| import me.chanjar.weixin.mp.bean.WxMpCard; | |||
| import org.apache.commons.lang3.builder.ToStringBuilder; | |||
| import org.apache.commons.lang3.builder.ToStringStyle; | |||
| import java.io.Serializable; | |||
| @@ -58,14 +60,7 @@ public class WxMpCardResult implements Serializable { | |||
| @Override | |||
| public String toString() { | |||
| return "WxMpCardResult{" + | |||
| "errorCode='" + errorCode + '\'' + | |||
| ", errorMsg='" + errorMsg + '\'' + | |||
| ", openId='" + openId + '\'' + | |||
| ", card=" + card + | |||
| ", userCardStatus='" + userCardStatus + '\'' + | |||
| ", canConsume=" + canConsume + | |||
| '}'; | |||
| return ToStringBuilder.reflectionToString(this, ToStringStyle.JSON_STYLE); | |||
| } | |||
| public String getUserCardStatus() { | |||
| @@ -0,0 +1,93 @@ | |||
| package me.chanjar.weixin.mp.api.impl; | |||
| import com.google.inject.Inject; | |||
| import me.chanjar.weixin.common.bean.WxCardApiSignature; | |||
| import me.chanjar.weixin.mp.api.ApiTestModule; | |||
| import me.chanjar.weixin.mp.bean.result.WxMpCardResult; | |||
| import org.testng.annotations.Guice; | |||
| import org.testng.annotations.Test; | |||
| import static org.testng.AssertJUnit.assertNotNull; | |||
| /** | |||
| * 测试代码仅供参考,未做严格测试,因原接口作者并未提供单元测试代码 | |||
| * Created by Binary Wang on 2016/7/27. | |||
| * @author binarywang (https://github.com/binarywang) | |||
| */ | |||
| @Test | |||
| @Guice(modules = ApiTestModule.class) | |||
| public class WxMpCardServiceImplTest { | |||
| @Inject | |||
| protected WxMpServiceImpl wxService; | |||
| private String cardId = "123"; | |||
| private String code = "good"; | |||
| private String openid = "abc"; | |||
| @Test | |||
| public void testGetCardApiTicket() throws Exception { | |||
| String cardApiTicket = this.wxService.getCardService().getCardApiTicket(); | |||
| assertNotNull(cardApiTicket); | |||
| System.out.println(cardApiTicket); | |||
| } | |||
| @Test | |||
| public void testGetCardApiTicketWithParam() throws Exception { | |||
| String cardApiTicket = this.wxService.getCardService().getCardApiTicket(true); | |||
| assertNotNull(cardApiTicket); | |||
| System.out.println(cardApiTicket); | |||
| } | |||
| @Test | |||
| public void testCreateCardApiSignature() throws Exception { | |||
| //app_id, card_id, card_type, code, openid, location_id | |||
| String[] param = {"123", cardId, "", code, openid, ""}; | |||
| WxCardApiSignature cardApiSignature = this.wxService.getCardService().createCardApiSignature(param); | |||
| assertNotNull(cardApiSignature); | |||
| System.out.println(cardApiSignature); | |||
| } | |||
| @Test | |||
| public void testDecryptCardCode() throws Exception { | |||
| String encryptCode = "pd0vTUHSHc9tMUCL2gXABcUmINm6yxqJh0y9Phsy63E="; | |||
| String cardCode = this.wxService.getCardService().decryptCardCode(encryptCode); | |||
| assertNotNull(cardCode); | |||
| System.out.println(cardCode); | |||
| } | |||
| @Test | |||
| public void testQueryCardCode() throws Exception { | |||
| WxMpCardResult wxMpCardResult = this.wxService.getCardService().queryCardCode(cardId, code, false); | |||
| assertNotNull(wxMpCardResult); | |||
| System.out.println(wxMpCardResult); | |||
| } | |||
| @Test | |||
| public void testConsumeCardCode() throws Exception { | |||
| String result = this.wxService.getCardService().consumeCardCode(code); | |||
| assertNotNull(result); | |||
| System.out.println(result); | |||
| } | |||
| @Test | |||
| public void testConsumeCardCodeWithCardId() throws Exception { | |||
| String result = this.wxService.getCardService().consumeCardCode(code, cardId); | |||
| assertNotNull(result); | |||
| System.out.println(result); | |||
| } | |||
| @Test | |||
| public void testMarkCardCode() throws Exception { | |||
| this.wxService.getCardService().markCardCode(code, cardId, openid, true); | |||
| System.out.println("done"); | |||
| } | |||
| @Test | |||
| public void testGetCardDetail() throws Exception { | |||
| String result = this.wxService.getCardService().getCardDetail(cardId); | |||
| assertNotNull(result); | |||
| System.out.println(result); | |||
| } | |||
| } | |||