微信开发-回调模式

  • 时间:
  • 出处:跟我学网络
  • 作者:
  • 浏览:699

标签:

前言

越来越多的企业借助微信平台做开发,下面记录最近开发微信项目(企业号)一些关键设置、原理及代码

 一:添加应用

    关注企业微信号后,点击企业号,能看到该企业号下的应用列表,它类似我们常见后台中的模块或栏目,首先我们要创建自己的应用。

二:设置应用为回调模式

      创建好应用后,把应用设置成回调模式,按要求设置回调URL及密钥。保存时它会访问URL,只有URL能正确访问信息时才能保存成功,否则一直会提示失败

 

  原理    

以下摘自微信开发文档:

验证URL有效性

当你提交以上信息时,企业号将发送GET请求到填写的URL上,GET请求携带四个参数,企业在获取时需要做urldecode处理,否则会验证不成功。

参数描述是否必带
msg_signature 微信加密签名,msg_signature结合了企业填写的token、请求中的timestamp、nonce参数、加密的消息体
timestamp 时间戳
nonce 随机数
echostr 加密的随机字符串,以msg_encrypt格式提供。需要解密并返回echostr明文,解密后有random、msg_len、msg、$CorpID四个字段,其中msg即为echostr明文 首次校验时必带

企业通过参数msg_signature对请求进行校验,如果确认此次GET请求来自企业号,那么企业应用对echostr参数解密并原样返回echostr明文(不能加引号,不能带bom头,不能带换行符),则接入验证生效,回调模式才能开启。

 

      实操

为了能正确验证URL有效性,还需要以下操作

首先,我们需要一台服务器,并且有一个域名指向了该服务器,在该服务器上配置好网站。把验证URL的代码放置在该服务器上。wxpush代码如下:

package com.bf.weixin;

import java.io.IOException;
import java.io.PrintWriter;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import com.bf.meal.entity.App;
import com.qq.weixin.mp.aes.AesException;
import com.qq.weixin.mp.aes.WXBizMsgCrypt;

public class wxpush extends HttpServlet {

    public void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {

        WXBizMsgCrypt wxcpt = null;
        try {
            wxcpt = new WXBizMsgCrypt(App.getToken(), App.getEncodingAESKey(), App.getCorpID());
        } catch (AesException e1) {
            e1.printStackTrace();
        }
        
        // 解析出url上的参数值如下:
        String sVerifyMsgSig = request.getParameter("msg_signature");
        String sVerifyTimeStamp = request.getParameter("timestamp");
        String sVerifyNonce = request.getParameter("nonce"); 
        String sVerifyEchoStr = request.getParameter("echostr");
        App.logger.info("url:" + request.getQueryString());
        
        String sEchoStr; //需要返回的明文
        
        try {
            sEchoStr = wxcpt.VerifyURL(sVerifyMsgSig, sVerifyTimeStamp, sVerifyNonce, sVerifyEchoStr);
            App.logger.info("verifyurl echostr: " + sEchoStr);
            
            response.setContentType("text/html");
            PrintWriter out = response.getWriter();
            out.println(sEchoStr);
            out.flush();
            out.close();
        } catch (Exception e) {
            App.logger.error(e);
            e.printStackTrace();
        }
    }
}
View Code

注:需要到微信官网上下载

com.qq.weixin.mp.aes.AesException;

com.qq.weixin.mp.aes.WXBizMsgCrypt;

当然web.xml中还得有如下节点

  <servlet-mapping>
        <servlet-name>wxpush</servlet-name>
        <url-pattern>/servlet/wxpush</url-pattern>
    </servlet-mapping>

配置好后,应该能正确的访问URL(http://*.*.com.cn/meal/servlet/wxpush),把该URL作为微信后台填写的值,此时应该能正确保存了。

三:获取用户帐号信息

要针对企业号关注用户做一些应用,最重要一点是要识别该用户,以便能正确区分不同的用户。

根据文档OAuth2.0验证接口说明, 建议的方案

1、企业应用中的URL链接直接填写企业自己的页面地址

2、成员跳转到企业页面时,企业校验是否有代表成员身份的cookie,此cookie由企业生成

3、如果没有获取到cookie,重定向到OAuth验证链接,获取成员身份后,由企业生成代表成员身份的cookie

4、根据cookie获取成员身份,进入相应的页面

我的做法是,配置Filter拦截所有jsp或.do文件的请求,在Filter中先去Cookie,如果Cookie不存在,则调用OAuth2.0获取信息,具体还是看关键代码

public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain) throws ServletException, IOException {
        HttpServletRequest request = (HttpServletRequest) req;
        HttpServletResponse response = (HttpServletResponse) res;
        
        String userId = getUserId(request, response);
……