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

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

如图所示，这是整个公众号与终端用户的数据流向图，当用户发送消息给公众号时（或某些特定的用户操作引发的事件推送时），会产生一个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>

类或参数说明:

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：

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

服务器tomcat日志：

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

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