微信公众号开发系列教程(四):监听关注/取消关注事件 消息接收与响应处理

版权声明:本文为博主原创文章,如需转载,敬请注明转载链接 https://blog.csdn.net/guobinhui/article/details/88822858

10万+IT都在关注,史上最全面的微信公众号开发系列教程:基于Springboot开发公众号关注/取消关注事件

前言:

关于监听公众号用户关注和取消关注的消息事件,微信官方文档给出的参考内容寥寥无几,具体如何配置url,官方文档也没有具体的说明,确实很坑,让人很难懂,而且网上关于配置微信消息事件接口的讲解资料很少,大多数只讲到验证token的url的配置,很少有讲到消息接口的url配置注意事项,很多开发者朋友也经常会卡到这里,通过加笔者微信请教笔者,本篇内容是笔者经过深入钻研实现的。能读到本篇干货的读者都是幸运的,经过精心整理,笔者今天把实现过程和完整案例无私分享给广大开发者朋友。

之前文章笔者已经实现了在测试公众号接入URL进行token验证,从本节起,开始利用微信官方提供的公众号开发文档来实现不同的交互案例。(注意:如果开发者还没有接入url进行token验证操作,请参考笔者之前的开发教程【springmvc开发微信公众号接口 微信公众号测试账号配置接口Token验证】。本案例演示效果如下:用户关注后公众号测试账号自动回复定制化的各种消息响应用户,并且可以根据用户发的消息进行智能回复。

实现思路

1.打开公众账号测试网址http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login,扫码登陆测试公众号 

2.我们打开微信公众号开发文档https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1445241432,选择左侧"消息管理"模块中的"接收普通消息",阅读微信官方开发文档。

文档中已经告诉我们,当普通微信用户向公众账号发送消息时,微信服务器会把该消息封装成XML数据包通过POST的方式发送到开发者填写的URL上。我们设置的URL仅仅只有一个,之前笔者分享的文章(【springmvc开发微信公众号接口 微信公众号测试账号配置接口Token验证】)中接入的url是用来做token验证的,就是微信服务器向开发者服务器发送GET请求过来,而现在是要用来做消息处理的,此时微信服务器向开发者服务器配置的url发送的是POST请求,因此我们只需要根据请求方式区分即可,配置的url和验证token配置的url保持一致即可,唯一不同的是,这次的请求接口路径上要用注解表明POST请求。详细见下面代码:

package com.chenyun.cloud.controller;

import java.io.IOException;
import java.io.PrintWriter;
import java.util.Map;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.dom4j.DocumentException;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.ResponseBody;

import com.alibaba.fastjson.JSONObject;
import com.chenyun.cloud.utils.CheckoutUtil;
import com.chenyun.cloud.utils.MessageUtil;
import com.chenyun.cloud.utils.WeiXinUtil;
import com.chenyun.cloud.utils.XmlUtil;

/**
 * 创建时间:2019年3月18日 下午3:35:33
 * 项目名称:weixindev
 * 类说明:微信开发之token验证以及各种消息处理
 * @author guobinhui
 * @since JDK 1.8.0_51
 */
@Controller
public class WeixinMsgController {

    public static String URL = "https://api.weixin.qq.com/cgi-bin/user/info?access_token=ACCESS_TOKEN&openid=OPENID&lang=zh_CN";

    /**
     * 微信消息接收和token验证
     * @param request
     * @param response
     * @throws IOException
     */
    @RequestMapping(value="/msg/checkToken",method=RequestMethod.GET)
    public void weChat(HttpServletRequest request, HttpServletResponse response) throws IOException {
        boolean isGet = request.getMethod().toLowerCase().equals("get");
        if (isGet) {
            // 微信加密签名
            String signature = request.getParameter("signature");
            // 时间戳
            String timestamp = request.getParameter("timestamp");
            // 随机数
            String nonce = request.getParameter("nonce");
            // 随机字符串
            String echostr = request.getParameter("echostr");
            // 通过检验signature对请求进行校验,若校验成功则原样返回echostr,表示接入成功,否则接入失败
            if (signature != null && CheckoutUtil.checkSignature(signature, timestamp, nonce)) {
                try {
                    boolean flag = CheckoutUtil.checkSignature(signature, timestamp, nonce);
                    System.out.println(flag);
                    PrintWriter print = response.getWriter();
                    print.write(echostr);
                    System.out.println(echostr);
                    print.flush();
                    print.close();
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }
        }
    }

    @RequestMapping(value="/msg/checkToken",method=RequestMethod.POST)
    @ResponseBody
    public String  responseEvent(HttpServletRequest req, HttpServletResponse resp)throws IOException {
        req.setCharacterEncoding("UTF-8");
        resp.setCharacterEncoding("UTF-8");
        String message = "success";
        try {
            //把微信返回的xml信息转义成map
            Map<String, String> map = XmlUtil.xmlToMap(req);
            System.out.println("微信接收到的消息为:"+map.toString());
            String fromUserName = map.get("FromUserName");//消息来源用户标识
            String toUserName = map.get("ToUserName");//消息目的用户标识
            String msgType = map.get("MsgType");//消息类型(event或者text)
            System.out.println("消息来源于:"+fromUserName);
            System.out.println("openId:"+toUserName);
            System.out.println("消息类型为:"+msgType);
            String eventType = map.get("Event");//事件类型
            String nickName = getUserNickName(fromUserName);
            if(MessageUtil.MSGTYPE_EVENT.equals(msgType)){//如果为事件类型
                if(MessageUtil.SUBSCIBE_EVENT.equals(eventType)){//处理订阅事件
                    String content = "欢迎关注,这是一个公众号测试账号,您可以回复任意消息测试,开发者郭先生,18629374628";
                    String msg = "@"+ nickName + "," +content;
                    System.out.println("事件类型为:"+","+eventType);
                    message = MessageUtil.subscribeForText(toUserName, fromUserName,msg);
                }else if(MessageUtil.UNSUBSCIBE_EVENT.equals(eventType)){//处理取消订阅事件
                    System.out.println("事件类型为:"+eventType);
                    message = MessageUtil.unsubscribe(toUserName, fromUserName);
                }
            }else {
                //微信消息分为事件推送消息和普通消息,非事件即为普通消息类型
                switch (msgType) {
                    case "text":{//文本消息
                        String content = map.get("Content");//用户发的消息内容
                        content = "您发的消息内容是:"+content+",如需帮助,请联系郭先生,18629374628";
                        message = MessageUtil.replyMsg(toUserName, fromUserName,content,"text");
                        break;
                    }
                    case "image":{//图片消息
                        String content = "您发的消息内容是图片,如需帮助,请联系郭先生,18629374628";
	                    message = MessageUtil.replyMsg(toUserName, fromUserName,content,"text");
                        break;
                    }	
                    default:{//其他类型的普通消息
                        break;
                    }
                }
            }
        } catch (DocumentException e) {
            e.printStackTrace();
        }
        System.out.println("关注微信公众号自动回复的消息内容为:"+message);
        return message;
    }
    
    public static String getUserNickName(String openId) {
    	String nickName  = null;
    	try {
            Map map = WeiXinUtil.cacheTokenAndTicket();
            String token = (String)map.get("access_token");
            String url = URL.replace("OPENID", openId).replace("ACCESS_TOKEN", token);
            JSONObject obj = WeiXinUtil.HttpGet(url);
            nickName = (String)obj.get("nickname");
        } catch (IOException e) {
            e.printStackTrace();
        }
        return nickName;
    }
}

次处access_token缓存7200秒是用笔者写的一个工具类实现的,这个工具类也一并分享给大家,主要思路就是通过IO流把生成的access_token写到项目所在的文件中每隔7200秒重新生成access_token覆盖原有的access_token,当然也可以用ehcache等缓存插件实现,那么所有的需要用到access_token的请求,取到的access_token都是实时的最新的。直接看代码:

public static  Map <String,Object> cacheTokenAndTicket() throws IOException {
	  Gson gson = new Gson();
      Map <String,Object> map = new HashMap <String,Object> ();
      String token = null;
      String ticket = null;
      JSONObject tokenObj = null; //需要获取的access_token对象;
      JSONObject ticketObj = null;//需要获取的jsapi_ticket对象;
      String filePath = System.getProperty("user.dir")+"/src/main/resources/token.txt";
      File file = new File(filePath);//Access_token保存的位置
      if (!file.exists())
        file.createNewFile();
      // 如果文件大小等于0,说明第一次使用,存入Access_token
      if (file.length() == 0) {
    	tokenObj = WeiXinUtil.getToken();
        token = (String)tokenObj.get("access_token");
        FileOutputStream fos = new FileOutputStream(filePath, false);// 不允许追加
        tokenObj.put("expires_in",System.currentTimeMillis()/1000+"");
        String json = gson.toJson(tokenObj);
        fos.write(json.getBytes());
        fos.close();
      }else {
    	//读取文件内容
        @SuppressWarnings("resource")
		FileInputStream fis = new FileInputStream(file);
        byte[] b = new byte[2048];
        int len = fis.read(b);
        String jsonAccess_token = new String(b, 0, len);// 读取到的文件内容
        JSONObject access_token = gson.fromJson(jsonAccess_token,JSONObject.class);
        if (access_token.get("expires_in") != null) {
          String lastSaveTime = (String)access_token.get("expires_in");
          long nowTime = System.currentTimeMillis()/1000;
          long remianTime = nowTime - Long.valueOf(lastSaveTime);
          if (remianTime < WeixinConstant.EXPIRESIN_TIME) {
        	  JSONObject access = gson.fromJson(jsonAccess_token,JSONObject.class);
        	  token = (String)access.get("access_token");
          } else {
        	  tokenObj = WeiXinUtil.getToken();
              FileOutputStream fos = new FileOutputStream(file, false);// 不允许追加
              tokenObj.put("expires_in",System.currentTimeMillis()/1000+"");
              String json = gson.toJson(tokenObj);
              fos.write((json).getBytes());
              fos.close();
          }
      }
      }
      map.put("access_token",token);
      map.put("jsapi_ticket",ticket);
      return map;
	}

 更多JavaEE资料请关注下面公众号,欢迎广大开发者朋友一起交流。笔者电话(微信):18629374628

具体功能体验可以扫右边的公众号测试账号二维码体验 

展开阅读全文

没有更多推荐了,返回首页