微信硬件蓝牙开发教程之公众平台回复文本消息

2018年05月19日 22:02 | 73次浏览 | 分类: 微信硬件蓝牙开发教程03版 作者原创 版权保护

其实我们在上一章节已经做了回复文本消息的功能,本章节将详细介绍此功能的开发。

如图所示,这是整个公众号与终端用户的数据流向图,当用户发送消息给公众号时(或某些特定的用户操作引发的事件推送时),会产生一个POST请求,开发者可以在响应包(Get)中返回特定XML结构,来对该消息进行响应(现支持回复文本、图片、图文、语音、视频、音乐)。严格来说,发送被动响应消息其实并不是一种接口,而是对微信服务器发过来消息的一次回复。

微信服务器在将用户的消息发给公众号的开发者服务器地址(开发者中心处配置)后,微信服务器在五秒内收不到响应会断掉连接,并且重新发起请求,总共重试三次,如果在调试中,发现用户无法收到响应的消息,可以检查是否消息处理超时。关于重试的消息排重,有msgid的消息推荐使用msgid排重。事件类型消息推荐使用FromUserName + CreateTime 排重。

如果开发者希望增强安全性,可以在开发者中心处开启消息加密,这样,用户发给公众号的消息以及公众号被动回复用户消息都会继续加密(但),详见被动回复消息加解密说明。

假如服务器无法保证在五秒内处理并回复,必须做出下述回复,这样微信服务器才不会对此作任何处理,并且不会发起重试(这种情况下,可以使用客服消息接口进行异步回复),否则,将出现严重的错误提示。详见下面说明:

1、(推荐方式)直接回复success

2、直接回复空串(指字节长度为0的空字符串,而不是XML结构体中content字段的内容为空)

一旦遇到以下情况,微信都会在公众号会话中,向用户下发系统提示“该公众号暂时无法提供服务,请稍后再试”:

1、开发者在5秒内未回复任何内容

2、开发者回复了异常数据,比如JSON数据等

项目服务器向微信服务器推送XML格式:

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>12345678</CreateTime>
<MsgType><![CDATA[text]]></MsgType>
<Content><![CDATA[你好]]></Content>
</xml>
参数是否必须描述
ToUserName接收方帐号(收到的OpenID)
FromUserName开发者微信号
CreateTime消息创建时间 (整型)
MsgTypetext
Content回复的消息内容(换行:在content中能够换行,微信客户端就支持换行显示)

类或参数说明:

类名或参数描述
WeChatServlet

公众号基本配置里-服务器配置url,http://100.200.200.78/weChat/weChatServlet

一个普通的java servlet类,服务器会把XML格式数据经servlet类中doPost方法回复给微信服务器,weChat为项目名称

Token公众号中基本配置-服务器配置中的Token,案例中为weixinTest(请查看doGet方法)
SignUtiWeChatServet微信接入验签名算法工具类,请参考doGet方法
MessageUtil解析XML工具类

WeChatServlet代码:

package com.test;
import java.io.IOException;
import java.io.PrintWriter;
import java.util.Map;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import com.test.util.MessageUtil;
/**
 * 核心请求处理类
 * @author V型知识库 www.vxzsk.com
 * linfanhehe@163.com
 * doGet方法里 有个weixinTest,这个是公众管理平台里面自己设置的token 大家根据自己的token替换
 */
public class WeChatServlet extends HttpServlet {
         
    private static final long serialVersionUID = 1508798736675904038L;
     
    /**
     * 确认请求来自微信服务器
     */
    public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        System.out.println("V型知识库原创www.vxzsk.com");
        // 微信加密签名
        String signature = request.getParameter("signature");
        System.out.println("微信加密签名signature:-----------------------"+signature);
        // 时间戳
        String timestamp = request.getParameter("timestamp");
        System.out.println("时间戳timestamp:-----------------------"+timestamp);
        // 随机数
        String nonce = request.getParameter("nonce");
        System.out.println("随机数nonce:-----------------------"+nonce);
        // 随机字符串
        String echostr = request.getParameter("echostr");
        System.out.println("随机字符串echostr:-----------------------"+echostr);
        //System.out.println("token-----------------------:"+token);
         
        PrintWriter out = response.getWriter();
        // 通过检验signature对请求进行校验,若校验成功则原样返回echostr,表示接入成功,否则接入失败
        if (SignUtil.checkSignature("weixinTest", signature, timestamp, nonce)) {
            out.print(echostr);
            //System.out.println("这是:"+echostr);
        }
        out.close();
        out = null;
    }
 
    /**
     * 处理微信服务器发来的消息
     */
    public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { 
        System.out.println("微信服务器发来消息------------");
        System.out.println("V型知识库原创www.vxzsk.com");
        // 将请求、响应的编码均设置为UTF-8(防止中文乱码)
        request.setCharacterEncoding("UTF-8");
        response.setCharacterEncoding("UTF-8");
        try{
        //xml请求解析
        Map<String, String> requestMap = MessageUtil.parseXml(request);//接收微信发过来的xml格式
        //发送方帐号(open_id)
        String fromUserName = requestMap.get("FromUserName");
        //公众帐号
        String toUserName = requestMap.get("ToUserName");
        //消息类型
        String msgType = requestMap.get("MsgType");
        //消息创建时间
        String createTime = requestMap.get("CreateTime");
        //微信服务器post过来的内容
        String weixinContent = requestMap.get("Content");
        System.out.println("公众号用户发送过来的文本消息内容:"+weixinContent);
        if(weixinContent.equals("123")){//用户通过关注微信公众号发送123文本内容
        String respMessage = "<xml>"
                +"<ToUserName><![CDATA["+fromUserName+"]]></ToUserName>"
                +"<FromUserName><![CDATA["+toUserName+"]]></FromUserName>"
                +"<CreateTime>12345678</CreateTime>"
                +"<MsgType><![CDATA[text]]></MsgType>"
                +"<Content><![CDATA[你好,已接收到内容。]]></Content>"
                +"</xml>";
        // 响应回复消息
                PrintWriter out = response.getWriter();
                out.print(respMessage);
                out.close();
        }
         
        }catch(Exception e){
            e.printStackTrace();
        }
        }
}

SignUtil:

package com.test;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.util.Arrays;
/***
 * 
 * @author V型知识库 www.vxzsk.com
 * linfanhehe@163.com
 * 
 */
public class SignUtil {
         
    /**
    * 验证签名
    * 
    * @param signature
    * @param timestamp
    * @param nonce
    * @return
    */
    public static boolean checkSignature(String token, String signature, String timestamp, String nonce) {     
        String[] arr = new String[] { token, timestamp, nonce };
        // 将token、timestamp、nonce三个参数进行字典序排序
        Arrays.sort(arr);
        StringBuilder content = new StringBuilder();
        for (int i = 0; i < arr.length; i++) {
            content.append(arr[i]);
        }
        MessageDigest md = null;
        String tmpStr = null;
        try {
        md = MessageDigest.getInstance("SHA-1");
        // 将三个参数字符串拼接成一个字符串进行sha1加密
        byte[] digest = md.digest(content.toString().getBytes());
        tmpStr = byteToStr(digest);
        } catch (NoSuchAlgorithmException e) {
        e.printStackTrace();
        }
        content = null;
        // 将sha1加密后的字符串可与signature对比,标识该请求来源于微信
        return tmpStr != null ? tmpStr.equals(signature.toUpperCase()) : false;
    }
    /**
    * 将字节数组转换为十六进制字符串 
    * @param byteArray
    * @return
    */
    private static String byteToStr(byte[] byteArray) {
        String strDigest = "";
        for (int i = 0; i < byteArray.length; i++) {
        strDigest += byteToHexStr(byteArray[i]);
        }
        return strDigest;
    }
    /**
    * 将字节转换为十六进制字符串
    * @param mByte
    * @return
    */
    private static String byteToHexStr(byte mByte) {
        char[] Digit = { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F' };
        char[] tempArr = new char[2];
        tempArr[0] = Digit[(mByte >>> 4) & 0X0F];
        tempArr[1] = Digit[mByte & 0X0F];
        String s = new String(tempArr);
        return s;
    }
}

MessageUtil:

package com.test.util;
import java.io.InputStream;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import javax.servlet.http.HttpServletRequest;
import org.dom4j.Document;
import org.dom4j.Element;
import org.dom4j.io.SAXReader;
/***
 
 * @author V型知识库 www.vxzsk.com
 * linfanhehe@163.com
 
 */
public class MessageUtil {
    /**
     * 解析微信发来的请求(XML)
     
     * @param request
     * @return
     * @throws Exception
     */
    @SuppressWarnings("unchecked")
    public static Map<String, String> parseXml(HttpServletRequest request) throws Exception {
        // 将解析结果存储在HashMap中
        Map<String, String> map = new HashMap<String, String>();
        // 从request中取得输入流
        InputStream inputStream = request.getInputStream();
         
        // 读取输入流
        SAXReader reader = new SAXReader();
        Document document = reader.read(inputStream);
        // 得到xml根元素
        Element root = document.getRootElement();
        // 得到根元素的所有子节点
        List<Element> elementList = root.elements();
        // 遍历所有子节点
        for (Element e : elementList) {
            map.put(e.getName(), e.getText());
        }
        // 释放资源
        inputStream.close();
        inputStream = null;
        return map;
    }
}

代码部署到服务器上,运行项目,效果如下:

服务器tomcat日志:

----------------------------------------------------------------------------------------------------

好了,至此,我们已经详细了解了公众号的收发以及响应消息了,公众号的基本开发大部分都是围绕着消息收发及响应来开发的,加上本章节共4个章节我们学会了公众号的消息接收及回复功能的开发,基本上满足了接下来微信硬件jsapi的接入的学习基础,至此公众平台基础功能开发告一段落,接下来的章节将进入微信硬件蓝牙jsapi的开发学习中。


此文章本站原创,地址 http://www.vxzsk.com/1785.html   转载请注明出处!谢谢!

感觉本站内容不错,读后有收获?小额赞助,鼓励网站分享出更好的教程