小程序模板网

微信小程序领取卡券(java)

最近做了个领取微信卡券的小程序,看了很多文档资料以及花了很多时间才算搞定的,不过也算是好事多磨,这边记录分享一下,也算给一点提升。

一、开发前准备

1:申请微信公众号 和 微信小程序,这是两个不同的东西,都需要单独申请、不同的帐号;

2:微信公众号需要开通微信卡券的功能;

3:在微信公众号里面去绑定小程序;

4:申请微信开放平台,并将微信公众号 和 微信小程序绑定到该开放平台。(注:绑定到开发平台下的作用只是为了获取unionid,因为同一用户在 公众号 和 小程序下获得的openid是不一样的,如果公众号 和 小程序都需要领取卡券,则最好通过unionid来跟踪用户;如果你只是开发微信小程序的领取卡券,则完全可以忽略第4点,博主本人也没有去绑定到微信开放平台,感觉步骤好多,特别麻烦!)

 

二、开始开发

1:获取微信卡券

https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1451025272

这边可以直接通过微信公众号提供的接口获取或者创建微信的卡券,此处不过多介绍,只是提一下这边要获取的access_token,网址如下https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421140183,代码直接如下:

 

[java] view plain copy
 
  1. private static String grantType = "client_credential";  
  2.     public static String appId = "";            //微信公众号appid  
  3.         public static String secret = "";           //微信公众号密钥  
  4.     public static AccessToken token = null;         //微信公众号的accessToken对象,由于请求次数有限制,这里使用全局静态变量保存起来  
  5.     public static AccessToken getToken() throws WeixinException, JsonParseException, JsonMappingException, IOException{  
  6.         if(token == null || token.getExpires_in() < System.currentTimeMillis()){  
  7.             //拼接参数  
  8.             String param = "?grant_type=" + grantType + "&appid=" + appId + "&secret=" + secret;  
  9.             //创建请求对象  
  10.                 HttpsClient http = new HttpsClient();  
  11.                 //调用获取access_token接口  
  12.                 Response res = http.get("https://api.weixin.qq.com/cgi-bin/token" + param);  
  13.                 System.out.println(res.asString());  
  14.                 ObjectMapper mapper = new ObjectMapper();  
  15.                 token = mapper.readValue(res.asString(),AccessToken.class);  
  16.         }  
  17.             return token;  
  18.     }  


 

其中需要jackson和weixin4j的jar包,比较普遍,请自行下载;而AccessToken对象也比较简单,就errcode、errmsg、access_token、expires_in这四个参数,比较简单,在文章结尾贴代码

 

2:升级微信卡券

其实这个步骤也可以省略,升级微信卡券的目的是可以直接从微信卡券跳转到对应的小程序,博主就偷懒了,直接跳过了这个步骤;

不过升级卡券也比较简单,就是调用调用微信公众号的更改微信卡券接口(URL:https://api.weixin.qq.com/card/update?access_token=TOKEN),添加几个字段,可以参考微信官方文档3.1,链接如下:https://mp.weixin.qq.com/cgi-bin/announce?action=getannouncement&key=1490190158&version=1&lang=zh_CN&platform=2

 

3:领取卡券

3.1:先获取openId

小程序端代码,通过调用wx.login获取code,再调用https://api.weixin.qq.com/sns/jscode2session接口获取openid,博主看到很多例子是直接从小程序端调用这个接口,但我事实中发现是行不通的,因为这个域名无法添加到小程序的request合法域名中,微信给的说明是不要在前端调用这个接口,需要通过后台,那没办法喽

 

[javascript] view plain copy
 
  1. wx.login({  
  2.   success: function (res) {  
  3.     var service_url = 'https://???/???/weixin/api/login?code=' + res.code;//需要将服务器域名添加到小程序的request合法域名中,而且必须是https开头  
  4.     wx.request({  
  5.       url: l,  
  6.       data: {},  
  7.       method: 'GET',  
  8.       success: function (res) {  
  9.         console.log(res);  
  10.         if (res.data != null && res.data != undefined && res.data != '') {  
  11.           wx.setStorageSync("openid", res.data.openid);//将获取的openid存到缓存中  
  12.         }  
  13.       }  
  14.     });  
  15.   }  
  16. });  

 

后端java代码

 

[java] view plain copy
 
  1. /** 
  2.   * 小程序后台登录,向微信平台发送获取access_token请求,并返回openId 
  3.   * @param code 
  4.   * @return 用户凭证 
  5.   * @throws WeixinException 
  6.   * @throws IOException  
  7.   * @throws JsonMappingException  
  8.   * @throws JsonParseException  
  9.   */  
  10.  @RequestMapping("login")  
  11.  @ResponseBody  
  12.  public Map<String, Object> login(String code, HttpServletRequest request) throws WeixinException, JsonParseException, JsonMappingException, IOException {  
  13.      if (code == null || code.equals("")) {  
  14.          throw new WeixinException("invalid null, code is null.");  
  15.      }  
  16.        
  17.      Map<String, Object> ret = new HashMap<String, Object>();  
  18.      //拼接参数  
  19.      String param = "?grant_type=" + grant_type + "&appid=" + appid + "&secret=" + secret + "&js_code=" + code;  
  20.        
  21.      System.out.println("https://api.weixin.qq.com/sns/jscode2session" + param);  
  22.        
  23.      //创建请求对象  
  24.      HttpsClient http = new HttpsClient();  
  25.      //调用获取access_token接口  
  26.      Response res = http.get("https://api.weixin.qq.com/sns/jscode2session" + param);  
  27.      //根据请求结果判定,是否验证成功  
  28.      JSONObject jsonObj = res.asJSONObject();  
  29.      if (jsonObj != null) {  
  30.          Object errcode = jsonObj.get("errcode");  
  31.          if (errcode != null) {  
  32.              //返回异常信息  
  33.              throw new WeixinException(getCause(Integer.parseInt(errcode.toString())));  
  34.          }  
  35.            
  36.          ObjectMapper mapper = new ObjectMapper();  
  37.          OAuthJsToken oauthJsToken = mapper.readValue(jsonObj.toJSONString(),OAuthJsToken.class);  
  38.          ret.put("openid", oauthJsToken.getOpenid());  
  39.      }  
  40.      return ret;  
  41.  }  


 

其中OAuthJsToken对象的字段为:openid、expires_in、session_key(会话密钥) ,在文章结尾贴代码;

 

3.2:生成领取卡券的签名,并调用wx.addCard方法领取卡券

这边写贴java后端代码

 

[java] view plain copy
 
  1.        public static ApiTicket ticket = null;//使用全局静态变量存储ApiTicket对象,当然如果使用缓存框架保存当然更好,这边只是做一个简单示例  
  2. /** 
  3.  * @Description: 获取领取卡券获取签名等参数 
  4.  * @param cardId:需要领取的卡券的cardId 
  5.  * @return 
  6.  * @throws WeixinException 
  7.  * @throws JsonParseException 
  8.  * @throws JsonMappingException 
  9.  * @throws IOException 
  10.  */  
  11. @RequestMapping("getCardSign")  
  12. @ResponseBody  
  13. public Map<String, String> getCardSign(String cardId) throws WeixinException, JsonParseException, JsonMappingException, IOException{  
  14.     Map<String, String> ret = new HashMap<String, String>();  
  15.     //先要获取api_ticket,由于请求api_ticket的接口访问有次数限制,所以最好将获得到的api_ticket保存到缓存中,这边做法比较简单,直接使用的静态变量  
  16.     if(ticket == null || ticket.getExpires_in() < System.currentTimeMillis()){  
  17.         //创建请求对象  
  18.             HttpsClient http = new HttpsClient();  
  19.           
  20.             ObjectMapper mapper = new ObjectMapper();  
  21.           
  22.             AccessToken token = OpenApi.getToken();//这里获取的token就是最上方代码保存的微信公众号全局静态变量token  
  23.                   
  24.                 //通过access_token调用获取api_ticket接口  
  25.             Response res = http.get("https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=" + token.getAccess_token() + "&type=wx_card");  
  26.             System.out.println(res.asString());  
  27.             ticket = mapper.readValue(res.asString(), ApiTicket.class);  
  28.             }  
  29.         
  30.             ret = sign(ticket.getTicket(), cardId);//生成领取卡券需要的签名,并返回相关的参数  
  31.   
  32.             for (Map.Entry entry : ret.entrySet()) {  
  33.                 System.out.println(entry.getKey() + ", " + entry.getValue());  
  34.             }  
  35.             return ret;  
  36. }  
  37. /** 
  38.  * @Description: 生成卡券需要的签名并返回参数 
  39.  * @param api_ticket: 
  40.  * @param cardId:需要领取的卡券的cardId 
  41.  * @return 
  42.  */  
  43. public static Map<String, String> sign(String api_ticket, String cardId) {  
  44.        Map<String, String> ret = new HashMap<String, String>();  
  45.        String nonce_str = create_nonce_str();  
  46.        String timestamp = create_timestamp();  
  47.        String signature = "";  
  48.          
  49.        String param[] = new String[4];  
  50.          
  51.        param[0] = nonce_str;  
  52.        param[1] = timestamp;  
  53.        param[2] = api_ticket;  
  54.        param[3] = cardId;  
  55.          
  56.        Arrays.sort(param);//对参数的value值进行字符串的字典序排序  
  57.          
  58.        StringBuilder sb = new StringBuilder();  
  59.     for(String b : param){  
  60.         sb.append(b);  
  61.     }  
  62.     System.out.println(sb);  
  63.        //对上面拼接的字符串进行sha1加密,得到signature  
  64.        try{  
  65.            MessageDigest crypt = MessageDigest.getInstance("SHA-1");  
  66.            crypt.reset();  
  67.            crypt.update(sb.toString().getBytes("UTF-8"));  
  68.            signature = byteToHex(crypt.digest());  
  69.        }catch (NoSuchAlgorithmException e){  
  70.            e.printStackTrace();  
  71.        }catch (UnsupportedEncodingException e){  
  72.            e.printStackTrace();  
  73.        }  
  74.   
  75.     //返回领取卡券需要的参数,其中nonceStr和timestamp必须和签名中的保持一致  
  76.        ret.put("card_id", cardId);  
  77.        ret.put("api_ticket", api_ticket);  
  78.        ret.put("nonceStr", nonce_str);  
  79.        ret.put("timestamp", timestamp);  
  80.        ret.put("signature", signature);  
  81.   
  82.        return ret;  
  83.    }  


 

其中ApiTicket对象的属性有:errcode、errmsg、ticket、expires_in,在文章结尾贴出该代码

再贴小程序端代码

 

[javascript] view plain copy
 
  1. var that = this;  
  2. var service_url = 'https://???/???/weixin/api/getCardSign?cardId=' + cardId;//需要将服务器域名添加到小程序的request合法域名中,而且必须是https开头  
  3. wx.request({  
  4.   url: service_url,  
  5.   data: {},  
  6.   method: 'GET',  
  7.   success: function (res) {  
  8.     console.log(res);  
  9.       wx.addCard({  
  10.         cardList: [{  
  11.           cardId: that.data.cardId,  
  12.           cardExt: '{"code":"","openid":"","timestamp":' + res.data.timestamp + ',"nonce_str":"' + res.data.nonceStr + '","signature":"' + res.data.signature + '"}'  
  13.         }],//这里需要注意的是cardExt参数的value值是 String类型,不要使用对象发送;另外openid如果在创建优惠券的时候没有指定,则这边为空,千万不要填写当前用户的openid  
  14.         success: function (result) {  
  15.           console.log(res);  
  16.   
  17.           wx.showToast({  
  18.             title: '领取成功',  
  19.             icon: 'success',  
  20.             duration: 2000  
  21.           });  
  22.         },  
  23.         fail: function (res) {  
  24.           console.log('领取失败');  
  25.           console.log(res);  
  26.         }  
  27.       })  
  28.       
  29.   }  
  30. });  


 

ok,如果领取成功,可以直接到微信卡包里面查看。下面贴出AccessToken、ApiTicket、OAuthJsToken的java模型代码

 

[java] view plain copy
 
  1. public class BaseResponse {  
  2.     private int errcode;  
  3.     private String errmsg;  
  4.       
  5.     public int getErrcode() {  
  6.         return errcode;  
  7.     }  
  8.     public void setErrcode(int errcode) {  
  9.         this.errcode = errcode;  
  10.     }  
  11.     public String getErrmsg() {  
  12.         return errmsg;  
  13.     }  
  14.     public void setErrmsg(String errmsg) {  
  15.         this.errmsg = errmsg;  
  16.     }  
  17. }  
  18. public class AccessToken extends BaseResponse{  
  19.     private String access_token;  
  20.     private long expires_in;  
  21.       
  22.     public String getAccess_token() {  
  23.         return access_token;  
  24.     }  
  25.     public void setAccess_token(String access_token) {  
  26.         this.access_token = access_token;  
  27.     }  
  28.     public long getExpires_in() {  
  29.         return expires_in;  
  30.     }  
  31.     public void setExpires_in(long expires_in) {  
  32.         this.expires_in = System.currentTimeMillis() + (expires_in - 100) * 1000;//原expires_in是有效时长,比如:7200,现改为过期的时间戳  
  33.     }  
  34. }  
  35. public class ApiTicket extends BaseResponse{  
  36.     private String ticket;  
  37.     private long expires_in;  
  38.       
  39.     public String getTicket() {  
  40.         return ticket;  
  41.     }  
  42.     public void setTicket(String ticket) {  
  43.         this.ticket = ticket;  
  44.     }  
  45.     public long getExpires_in() {  
  46.         return expires_in;  
  47.     }  
  48.     public void setExpires_in(long expires_in) {  
  49.         this.expires_in = System.currentTimeMillis() + (expires_in - 100) * 1000;//原expires_in是有效时长,比如:7200,现改为过期的时间戳  
  50.     }  
  51. }  
  52. public class OAuthJsToken {  
  53.     private String openid;              //用户唯一标识  
  54.     private int expires_in = 7200;      //凭证有效时间,单位:秒  
  55.     private String session_key;         //会话密匙  
  56.     private long exprexpiredTime;           //过期时间  
  57.       
  58.     public String getOpenid() {  
  59.         return openid;  
  60.     }  
  61.     public void setOpenid(String openid) {  
  62.         this.openid = openid;  
  63.     }  
  64.     public int getExpires_in() {  
  65.         return expires_in;  
  66.     }  
  67.     public void setExpires_in(int expires_in) {  
  68.         this.expires_in = expires_in;  
  69.         this.exprexpiredTime = System.currentTimeMillis() + expires_in * 1000;  
  70.     }  
  71.     public String getSession_key() {  
  72.         return session_key;  
  73.     }  
  74.     public void setSession_key(String session_key) {  
  75.         this.session_key = session_key;  
  76.     }  
  77.       
  78.     public long getExprexpiredTime() {  
  79.         return exprexpiredTime;  
  80.     }  
  81.     public void setExprexpiredTime(long exprexpiredTime) {  
  82.         this.exprexpiredTime = exprexpiredTime;  
  83.     }  
  84.     /** 
  85.      * 判断用户凭证是否过期 
  86.      * 
  87.      * @return 过期返回 true,否则返回false 
  88.      */  
  89.     public boolean isExprexpired() {  
  90.         return System.currentTimeMillis() >= this.exprexpiredTime;  
  91.     }  
  92. }  
  93.  


易优小程序(企业版)+灵活api+前后代码开源 码云仓库:starfork
本文地址:https://www.eyoucms.com/wxmini/doc/course/18311.html 复制链接 如需定制请联系易优客服咨询:800182392 点击咨询
QQ在线咨询