微信公众号开发-接收消息

161 阅读2分钟

公众号配置

image.png

后端代码编写

package com.app.api.controller.wx;

import com.app.api.utils.WxUtil;
import org.springframework.web.bind.annotation.*;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.PrintWriter;
import java.util.Map;

/**
 * @ClassName MpController
 * @Description: 接收微信公众号的消息
 * @Author: wu
 * @CreateDate: 2024/2/2 17:09
 */
@RestController
@RequestMapping("/wx/mp/")
public class MpController {


    /**
     * 接收消息接口
     * @param request
     * @param response
     * @param xmldata
     * @throws IOException
     */
    @PostMapping(value = "callback")
    public void postCallBack(HttpServletRequest request, HttpServletResponse response, @RequestBody String xmldata) throws IOException {
        System.out.println("响应了");
        // 接收微信服务器以Get请求发送的4个参数
        String signature = request.getParameter("signature");
        String timestamp = request.getParameter("timestamp");
        String nonce = request.getParameter("nonce");
        String echostr = request.getParameter("echostr");

        PrintWriter out = response.getWriter();
        if (WxUtil.checkSignature(signature, timestamp, nonce)) {
            doSomething(xmldata);
            out.print(echostr);        // 校验通过,原样返回echostr参数内容
        } else {
            System.out.println("不是微信发来的请求!");
        }
    }

    /**
     * 服务器验证接口
     * @param request
     * @param response
     * @throws IOException
     */
    @GetMapping(value = "callback")
    public void getCallBack(HttpServletRequest request, HttpServletResponse response) throws IOException {
        System.out.println("响应了");
        // 接收微信服务器以Get请求发送的4个参数
        String signature = request.getParameter("signature");
        String timestamp = request.getParameter("timestamp");
        String nonce = request.getParameter("nonce");
        String echostr = request.getParameter("echostr");

        PrintWriter out = response.getWriter();
        if (WxUtil.checkSignature(signature, timestamp, nonce)) {
            out.print(echostr);        // 校验通过,原样返回echostr参数内容
        } else {
            System.out.println("不是微信发来的请求!");
        }
    }

    /**
     * 做些事情
     * @param xmldata
     */
    private void doSomething(String xmldata) {
        Map<String, String> map = WxUtil.readStringXmlOut(xmldata);
        String event = map.get("Event");
        System.out.println(event);
        String fromUserName = map.get("FromUserName");
        System.out.println(fromUserName);

    }


}
package com.app.api.utils;

import org.apache.commons.codec.digest.DigestUtils;
import org.dom4j.Document;
import org.dom4j.DocumentException;
import org.dom4j.DocumentHelper;
import org.dom4j.Element;

import java.util.Arrays;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

/**
 * @ClassName WxUtil
 * @Description: 微信工具类
 * @Author: wu
 * @CreateDate: 2024/2/2 17:19
 */
public class WxUtil {


    /**
     * xml转map
     * @param xml
     * @return
     */
    public static Map<String,String> readStringXmlOut(String xml) {
        Map<String,String> map = new HashMap<String,String>();
        Document doc = null;
        try {
            doc = DocumentHelper.parseText(xml); // 将字符串转为XML
            Element rootElt = doc.getRootElement(); // 获取根节点
            List<Element> list = rootElt.elements();//获取根节点下所有节点
            for (Element element : list) {  //遍历节点
                map.put(element.getName(), element.getText()); //节点的name为map的key,text为map的value
            }
        } catch (DocumentException e) {
            e.printStackTrace();
        } catch (Exception e) {
            e.printStackTrace();
        }
        return map;
    }

    /**
     * 这个token值要和微信公众号服务器配置一致
     */
    private static final String token = "diezhong"; 
    /**
     * 微信公众号校验
     */
    public static boolean checkSignature(String signature, String timestamp, String nonce) {

        String[] arr = new String[]{token, timestamp, nonce};
        // 排序
        Arrays.sort(arr);
        // 生成字符串
        StringBuilder content = new StringBuilder();
        for (int i = 0; i < arr.length; i++) {
            content.append(arr[i]);
        }

        // sha1加密
        String temp = getSHA1String(content.toString());

        return temp.equals(signature); // 与微信传递过来的签名进行比较
    }

    private static String getSHA1String(String data) {
        // 使用commons codec生成sha1字符串
        return DigestUtils.shaHex(data);
    }
}

消息内容

<xml>
  <ToUserName><![CDATA[toUser]]></ToUserName>
  <FromUserName><![CDATA[FromUser]]></FromUserName>
  <CreateTime>123456789</CreateTime>
  <MsgType><![CDATA[event]]></MsgType>
  <Event><![CDATA[subscribe]]></Event>
</xml>
参数描述
ToUserName开发者微信号
FromUserName发送方账号(一个OpenID)
CreateTime消息创建时间 (整型)
MsgType消息类型,event
Event事件类型,subscribe(订阅)、unsubscribe(取消订阅)

注意事项

  1. 公众号上提交服务器配置接口时,http协议只能用80端口,https协议只能用443端口
  2. 验证接口只调用一次后续就没有调用了