公众号开发精品教程(2)——将项目接入微信及简单交互

系列文章传送门

公众号开发精品教程(1)——绪论及环境搭建

公众号开发精品教程(2)——将项目接入微信及简单交互

公众号开发精品教程(3)——创建菜单

公众号开发精品教程(4)——生成带参数的二维码及合成海报

公众号开发精品教程(5)——获取用户基本信息与网页授权

整个项目的源码已经上传到百度网盘(博主的Git在维护,就不拿出来丢人了),永久有效,免费,在ChatConf类中填写自己的APPID和开发者密钥,在相关地方替换一下外网域名,即可使用,如有任何问题,欢迎在下方评论:

链接:百度网盘传送门
提取码:03eb

目录

 

前言

开始接入

简单的交互

一、被关注时自动回复

二、用户发送消息时,自动回复

小结


前言

在上一篇博文中,我们申请了公众号的测试号,创建了服务器项目,并且通过内网穿透映射到了外网上。

那么我们如何让微信把公众号产生的消息,发送给我们的服务器呢?这就要在公众平台去配置服务器信息,因为我们这里是自己学习体验,所以在公众号测试系统去操作即可,公众号测试系统入口:

https://mp.weixin.qq.com/debug/cgi-bin/sandboxinfo?action=showinfo&t=sandbox/index

用你注册公众号的微信,扫码登录即可。

开始接入

登录到测试号系统中后,你会看到如下信息:

我们就是要在这里,配置自己的服务器信息。我们暂且不配置,因为后台服务器还没有进行相关代码的编写,先看一下文档怎么说。

 

主要是三个信息

1、提交配置之后,用户在你的公众号所有的操作,微信都会转发到你填写的URL

2、成为开发者时的认证,是以GET方式提交到你填写的URL,并且携带4个参数

3、认证逻辑你自己编写,只要你最后返回给我echostr字符串即可,哪怕不进行验证直接返回

既然这样,那我们就开始动手吧!

仍然继续在上一篇文章中创建的项目,我们新建一个WechatController,用于处理微信发来的请求:

package com.blog.wechat.controller;

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.RequestParam;

import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.PrintWriter;

/**
 *  微信控制器,负责接收微信推送的消息及开发者验证
 * @author 秋枫艳梦
 * @date 2019-06-02
 * */
@Controller
public class WechatController {

    /**
     *  进行开发者验证,接入微信。注意这个方法是GET请求
     * @param signature 微信加密签名
     * @param timestamp 时间戳
     * @param nonce 随机数
     * @param echostr 随机字符串
     * @return 验证通过,原样返回echostr字符串
     * */
    @RequestMapping(value = "/wechat",method = RequestMethod.GET)
    public void checkAuth(@RequestParam(value = "signature") String signature,
                          @RequestParam(value = "timestamp") String timestamp,
                          @RequestParam(value = "nonce") String nonce,
                          @RequestParam(value = "echostr") String echostr,
                          HttpServletResponse response) {
        //认证逻辑这里就不实现了,我们直接返回echostr,写入到响应体中
        PrintWriter writer = null;
        try {
            writer = response.getWriter();
            //返回结果
            writer.print(echostr);
        } catch (IOException e) {
            e.printStackTrace();
        }finally {
            if (writer!=null){
                writer.close();
            }
        }
    }
}

然后在测试号系统中填写我们的服务器配置(不要忘了先将你的项目映射到外网上),域名+请求路径:

 然后点击提交,如果你的项目及配置没问题的话,会显示配置成功,这时就已经对接上了,用户跟公众号产生的所有交互都会访问这个URL。

简单的交互

测试号系统中有一个二维码,我们扫一下,关注一下我们的测试公众号:

我们向公众号发起了交互,却说服务异常? 这是因为我们的服务器没有作出响应。前面提到,一旦成为了开发者模式,所有的交互行为都会访问我们填写的URL,这里也就是http://umu5uk.natappfree.cc/wechat,但是我们并没有处理这些交互,微信得不到响应,就会通知用户发生了异常。

那么问题来了,我只有一个/wechat请求处理路径,而且我已经用这个路径做了开发者认证,怎么能继续用它处理交互行为呢?

这就需要看文档了,文档指出,成为开发者模式的时候,是GET方式访问这个URL,而所有的事件交互,以POST方式访问。而且交互分为几种:普通消息、事件推送等,刚才我们向公众号发信息,属于普通消息,而被关注属于事件推送。

接下来,我们做两件事:

1、被关注的时候,给用户发送消息;

2、用户发送消息过来时,回复用户;

一、被关注时自动回复

这里需要向用户发送信息,所以先看一下文档怎么说:

因为我们要在用户关注的时候,发送给用户一段文本信息,所以就要先接收微信的事件推送,继续看文档:

 文档指出,当公众号被关注时,微信会向我们配置的服务器发送一个POST请求,并且携带一个XML格式的请求体,结合下面的参数说明,我们可以知道被关注时的event为subscribe,那么思路就理顺了:

先在控制器中解析微信推过来的xml数据,拿到event的值,如果是subscribe,则返回一个回复文本消息的xml响应体。

然后开始写代码,因为微信推过来的数据是XML格式的,操作起来不方便,所以我们先将它转为Map,写一个工具类:

注意:这里是采用dom4j解析的,需要引入依赖。

package com.blog.wechat.utils;

import org.dom4j.Document;
import org.dom4j.DocumentException;
import org.dom4j.Element;
import org.dom4j.io.SAXReader;

import java.io.InputStream;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

/**
 *  XML解析工具类
 * @author 秋枫艳梦
 * @date 2019-06-02
 * */
public class XMLUtil {

    /**
     *  将XML转换成Map
     * @param inputStream 请求体中的输入流
     * @return Map
     * */
    public static Map<String,String> getMap(InputStream inputStream){
        //返回的Map
        Map<String,String> map = new HashMap<>();
        //初始化解析器
        SAXReader reader = new SAXReader();

        //读取XML文档
        Document document = null;
        try {
            document = reader.read(inputStream);
        } catch (DocumentException e) {
            e.printStackTrace();
        }

        //获取XML文档的根节点
        Element element = document.getRootElement();

        //遍历所有节点,把键和值存入Map
        List<Element> elementList = element.elements();
        for (Element e : elementList) {
            map.put(e.getName(),e.getText());
        }

        return map;
    }
}

然后还需要一个工具类,负责生成回复给用户的消息:

package com.blog.wechat.utils;

/**
 *  返回消息的工具类
 * @author 秋枫艳梦
 * @date 2019-06-02
 * */
public class MessageUtil {
    /**
     * 要回复的消息
     * @param fromUser 发送方
     * @param toUser 接收方
     * @param content 回复给用户的内容
     * @return 整理好的XML文本
     * */
    public static String setMessage(String fromUser,String toUser,String content){

        return "<xml>\n" +
                "  <ToUserName><![CDATA["+toUser+"]]></ToUserName>\n" +
                "  <FromUserName><![CDATA["+fromUser+"]]></FromUserName>\n" +
                "  <CreateTime>12345678</CreateTime>\n" +
                "  <MsgType><![CDATA[text]]></MsgType>\n" +
                "  <Content><![CDATA["+content+"]]></Content>\n" +
                "</xml>";
    }
}

然后在WechatController中增加一个POST请求的处理方法,请求路径依然是/wechat,返回数据格式是application/xml:

/**
     *  处理交互行为
     * @param request 请求体
     * @param response 响应体
     * */
    @RequestMapping(value = "/wechat",method = RequestMethod.POST,produces = {"application/xml;charset=utf-8"})
    public void doRequest(HttpServletRequest request,HttpServletResponse response) throws IOException {
        //将XML转为Map
        Map<String,String> map = XMLUtil.getMap(request.getInputStream());
        PrintWriter writer = response.getWriter();

        //这里不要弄混了,微信推过来的信息是用户发过来的,所以ToUserName是我们的公众号,FromUserName是用户的微信openid
        //所以我们既然要回复过去,就要颠倒过来
        String fromUser = map.get("ToUserName");
        String toUser = map.get("FromUserName");
        String content = "";

        //先判断是事件消息,还是普通消息
        if (map.get("MsgType").equals("event")){
            //如果是被关注事件,向用户回复内容,只需要将整理好的XML文本参数返回给微信即可
            if (map.get("Event").equals("subscribe")){
                content = "欢迎关注秋枫艳梦的测试公众号!";
                //把数据包返回给微信服务器,微信服务器再推给用户
                writer.print(MessageUtil.setMessage(fromUser,toUser,content));
            }
        }
        writer.close();
    }

然后重新运行项目,重新关注测试公众号:

 到这里,我们的第一个任务就完成了,接下来我们再完成下一个。

二、用户发送消息时,自动回复

这个场景很常见,用户发送一个信息,公众号返回一段内容,接下来我们就实现这个功能。

首先要明确,这个场景不再是事件消息了,而是普通消息,而且是普通消息中的文本消息,看一下文档说明:

 所以我们要做如下处理:

/**
     *  处理交互行为
     * @param request 请求体
     * @param response 响应体
     * */
    @RequestMapping(value = "/wechat",method = RequestMethod.POST,produces = {"application/xml;charset=utf-8"})
    public void doRequest(HttpServletRequest request,HttpServletResponse response) throws IOException {
        //将XML转为Map
        Map<String,String> map = XMLUtil.getMap(request.getInputStream());
        PrintWriter writer = response.getWriter();

        //这里不要弄混了,微信推过来的信息是用户发过来的,所以ToUserName是我们的公众号,FromUserName是用户的微信openid
        //所以我们既然要回复过去,就要颠倒过来
        String fromUser = map.get("ToUserName");
        String toUser = map.get("FromUserName");
        //要返回给用户的信息
        String content = "";

        //先判断是事件消息,还是普通消息
        if (map.get("MsgType").equals("event")){
            //如果是被关注事件,向用户回复内容,只需要将整理好的XML文本参数返回给微信即可
            if (map.get("Event").equals("subscribe")){
                content = "欢迎关注秋枫艳梦的测试公众号!";
            }
        }else if (map.get("MsgType").equals("text")){
            //如果是普通文本消息,先拿到用户发送过来的内容,模拟自动答疑的场景
            String text = map.get("Content");

            if (text.equals("1")){
                content = "您可以在“我的账户——服务——退款”中查看您的退款明细";
            }else if (text.equals("2")){
                content = "如果您购买了本店的产品,订单页面会展示在您的主菜单中";
            }else if (text.equals("3")){
                content = "如有更多问题,请拨打我们的客服热线:xxxxx";
            }else {
                //否则,不管用户输入什么,都返回给ta这个列表,这也是最常见的场景
                content = "请输入您遇到的问题编号:\n"+
                        "1、如何查看退款进度?\n"+
                        "2、我的订单在哪里查看?\n"+
                        "3、其他问题";
            }
        }

        //把数据包返回给微信服务器,微信服务器再推给用户
        writer.print(MessageUtil.setMessage(fromUser,toUser,content));
        writer.close();
    }

我们重新运行项目,测试一下:

 

小结

今天的博文就更新到这里,下一篇文章,将带领大家创建公众号的菜单!

  • 8
    点赞
  • 22
    收藏
    觉得还不错? 一键收藏
  • 2
    评论
评论 2
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值