07
2019
05

微信硬件开发系列教程04-微信公众号开发DEMO(airkiss/airsync)

这篇讲解对微信公众号开发DEMO分析,主要的目的是了解它的原理和微信API的使用。
然后进行修改,实现我们想要的功能,如:菜单的创建、信息交互、跳转到自定义HTML5页面等等。



一、目录结构讲解。

展开目录后,按照1、2、3、4、5的顺序讲解:
1、web.xml网站配置(上面图片标错了,是在WEB-INF未展来的目录里的web.xml)
2、公众账号信息配置。
3、微信推送消息的入口。
4、处理微信消息的业务类。
5、相关微信API的使用方法,创建菜单,进行设备授权,生成二维码等。



二、web.xml(程序引导配置)


双击web.xml,就会看到网站配置的内容
1、声明地址名称,绑定相关的Servlet类,以后访问就用这个地址。
2、将名称映射到地址。
这样就能成功访问:http://你的域名/callback来访问com.bluelight.demo.web.CallbackServlet类了。




我们运行,右击bluelight->Run As->Run Server,然后Finish。




1、在后面添加callback,回车。
2、出现Null异常,说明已经成功调用了类,只是没有传参数。





那我们如何添加一个访问类地址呢?

我们复制,访着实现一个能使用calltest访问的地址。






重新运行,然后访问http://localhost:8080/demo/calltest,成功调用了类文件。
这里还有一种是jsp,可以直接放到WebContent目录里,直接访问文件名就可以,不需要做映射。




三、config.properties(微信公众号appID、appsecret、taken设置)

双击config.properties,打开后appID、appsecret、taken都是空的,我们要复制进去。




登陆公众号开发测试网址:
http://mp.weixin.qq.com/debug/cgi-bin/sandboxinfo?action=showinfo&t=sandbox/index
直接复制appID、appsecret填写,URL是我们之后要教大家申请的服务器地址,taken自定义一个就可以了。



四、CallbackServlet.java(入口类讲解)

打开类,主要看到三个类:doGet、doPost、out函数。



在这里的doGet函数,基本不做事,只接收到传来的值,然后直接就返回空的值回去了,如果验证不通过就返回错误而以。




doPost涵数,多了解决xml,然后使用CallbackService业务类进行处理(这才是关键的地方),然后调用out函数才返回给微信。





out函数,使用了Writer类,然后输出返回,这样微信就能收到啦。




五、CallbackService.java(微信消息业务类讲解)

在入口类的doPost涵数里,调用了这个业务类,那我们来一一分析它。
这个类就只有一个事件处理函数handle



001
002
003
004
005
006
007
008
009
010
011
012
013
014
015
016
017
018
019
020
021
022
023
024
025
026
027
028
029
030
031
032
033
034
035
036
037
038
039
040
041
042
043
044
045
046
047
048
049
050
051
052
053
054
055
056
057
058
059
060
061
062
063
064
065
066
067
068
069
070
071
072
073
074
075
076
077
078
079
080
081
082
083
084
085
086
087
088
089
090
091
092
093
094
095
096
097
098
099
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
package com.bluelight.demo.service;
 
import java.util.Map;
 
import org.apache.commons.codec.binary.Base64;
 
import com.bluelight.demo.api.DeviceApi;
import com.bluelight.demo.api.MpApi;
import com.bluelight.demo.consts.MsgType;
import com.bluelight.demo.consts.XmlResp;
import com.bluelight.demo.mock.DBMock;
import com.bluelight.demo.protocol.BlueLight;
import com.bluelight.demo.protocol.BlueLight.CmdId;
 
/**
 * 回调业务处理
 */
public class CallbackService {
 
        // 自定义菜单中的key值
        public static final String V1001_LIGHT_ON = "V1001_LIGHT_ON";//点灯
        public static final String V1002_LIGHT_OFF = "V1002_LIGHT_OFF";//灭灯
         
        public String handle(Map<String, String> reqMap) throws Exception {
                String msgType = reqMap.get("MsgType");
                String fromUser = reqMap.get("FromUserName");
                String toUser = reqMap.get("ToUserName");
 
                // 针对不同类型的消息和事件进行处理
 
                // 文本消息
                if (MsgType.TEXT.equals(msgType)) {
                        // 可以在此处进行关键字自动回复
                        String content = "收到文本消息:" + reqMap.get("Content");
                        return XmlResp.buildText(fromUser, toUser, content);
                }
                 
                // 基础事件推送
                if (MsgType.EVENT.equals(msgType)) {
                        String event = reqMap.get("Event");
                        // 关注公众号
                        if (MsgType.Event.SUBSCRIBE.equals(event)) {
                                // 回复欢迎语
                                return XmlResp.buildText(fromUser, toUser, "欢迎关注蓝牙灯泡demo测试公众号!");
                        }
                        // 菜单点击事件
                        if (MsgType.Event.CLICK.equals(event)) {
                                // 根据key值判断点击的哪个菜单
                                String eventKey = reqMap.get("EventKey");
                                // 点灯/灭灯
                                if (V1001_LIGHT_ON.equals(eventKey)
                                                || V1002_LIGHT_OFF.equals(eventKey)) {
                                        //是否点灯操作
                                        boolean open = V1001_LIGHT_ON.equals(eventKey);
 
                                        // 根据 fromUserName 获取绑定的信息
                                        Map<String, String> boundInfo = DBMock.queryBoundInfo(fromUser);
 
                                        // 未绑定
                                        if (boundInfo == null) {
                                                return XmlResp.buildText(fromUser, toUser, "未绑定");
                                        }
 
                                        String deviceType = boundInfo.get("deviceType");
                                        String deviceID = boundInfo.get("deviceID");
                                        String openID = boundInfo.get("openID");
                                         
                                        // 构造设备消息
                                        CmdId cmdId = open ? BlueLight.CmdId.OPEN_LIGHT_PUSH : BlueLight.CmdId.CLOSE_LIGHT_PUSH;
                                        byte[] respRaw = BlueLight.build(cmdId, null, (short)0).toBytes();
                                        // Base64编码
                                        final String content = Base64.encodeBase64String(respRaw);
                                         
                                        // 推送消息给设备
                                        DeviceApi.transMsg(deviceType, deviceID, openID, content);
                                         
                                        // 回复
                                        boolean debug = true;
                                        if(debug){
                                                // 返回调试信息
                                                String debugText = "已发送" + (open ? "点灯" : "灭灯") + "消息:" + "deviceID为" + deviceID + ",设备消息为" + content;
                                                return XmlResp.buildText(fromUser, toUser, debugText);
                                        }else{
                                                return "";
                                        }
                                }
                        }
                }
 
                // 设备消息或事件
                if (MsgType.DEVICE_EVENT.equals(msgType)
                                || MsgType.DEVICE_TEXT.equals(msgType)) {
                        String reqContent = reqMap.get("Content");
                        String deviceType = reqMap.get("DeviceType");
                        String deviceID = reqMap.get("DeviceID");
                        String sessionID = reqMap.get("SessionID");
                        final String openID = reqMap.get("OpenID");
                        // 设备事件推送
                        if (MsgType.DEVICE_EVENT.equals(msgType)) {
                                String event = reqMap.get("Event");
                                // 绑定/解绑事件
                                if (MsgType.DeviceEvent.BIND.equals(event)
                                                || MsgType.DeviceEvent.UNBIND.equals(event)) {
                                        // 存储用户和设备的绑定关系
                                        if(MsgType.DeviceEvent.BIND.equals(event)){
                                                DBMock.saveBoundInfo(reqMap);
                                        }else{
                                                DBMock.removeBoundInfo(reqMap.get("FromUserName"));
                                        }
                                        // 设备绑定/解绑事件可以回复空包体
                                        return "";
                                }
                        }
                        // 收到设备消息
                        if (MsgType.DEVICE_TEXT.equals(msgType)) {
                                // Base64解码
                                byte[] reqRaw = Base64.decodeBase64(reqContent);
                                // 反序列化
                                BlueLight lightReq = BlueLight.parse(reqRaw);
                                 
                                // 逻辑处理
                                // demo中 推送消息给用户微信
                                String reqText = lightReq.body;
                                System.out.println("recv text:" + reqText);
                                String transText = "收到设备发送的数据:";
                                 
                                byte[] reqTextRaw = reqText.getBytes("UTF-8");
                                if (reqTextRaw.length > 0 && reqTextRaw[reqTextRaw.length - 1] == 0) {
                                        // 推送给微信用户的内容去掉末尾的反斜杠零'\0'
                                        transText = transText + new String(reqTextRaw, 0, reqTextRaw.length - 1, "UTF-8");
                                } else{
                                        transText = transText + reqText;
                                }
                                 
                                // 推送文本消息给微信
                                MpApi.customSendText(openID, transText);
 
                                // demo中 回复 收到的内容给设备
                                BlueLight lightResp = BlueLight.build(BlueLight.CmdId.SEND_TEXT_RESP, reqText, lightReq.head.seq);
                                // 序列化
                                byte[] respRaw = lightResp.toBytes();
                                // Base64编码
                                String respCon = Base64.encodeBase64String(respRaw);
                                 
                                // 设备消息接口必须回复符合协议的xml
                                return XmlResp.buildDeviceText(toUser, fromUser, deviceType, deviceID, respCon, sessionID);
                        }
                }
 
                // 未处理的情况返回空字符串
                return "";
        }
}



代码主要针对不同类型的消息,进行处理,如TEXT,EVENT,DEVICE_EVENT,DEVICE_TEXT。
TEXT是纯文本发过来,含表情。
EVENT是关注公众号,取消公众号,菜单点击等等,
DEVICE_EVENT是硬件的消息,DEVICE_TEXT就是硬件发送过来的文本(一般用文本交互就可以了)




在菜单点击事件里,实现了开和关,这里获取硬件的信息,前提是先扫二维码绑定,这个之后讲硬件时会讲到的。




在设备事件里,如果是绑定事件和解绑事件,就进行临时的保存和删除。




这里处理收到设备的信息处理。




[Java] 纯文本查看 复制代码
1
2
3
4
5
6
7
8
9
// 文本消息
                if (MsgType.TEXT.equals(msgType)) {
                        // 可以在此处进行关键字自动回复
                        String content = "收到文本消息:" + reqMap.get("Content");
if(reqMap.get("Content").equals("你好")){
        content = "你也好,你全家都好。";
}
                        return XmlResp.buildText(fromUser, toUser, content);
                }


这里我们做一下修改,添加一段代码,如果用户发送“你好”两字,那么我直接回复他:你也好,你全家都好。
if(content.equals("你好")){
content = "你也好,你全家都好。";
}





六、Tools.java(操作微信API类讲解)

Tools.java共有main、createQrByDeviceId、createQrImage、device_Auth、createMenu等5个函数。
分别为主函数、建立二维码、生成图片、授权设备、建立菜单。
这里我们只跳用建立菜单,二维码和授权,之后在说硬件的时候再教大家。



01
02
03
04
05
06
07
08
09
10
11
12
// 文本消息
                if (MsgType.TEXT.equals(msgType)) {
                        // 可以在此处进行关键字自动回复
                        String content = "收到文本消息:" + reqMap.get("Content");
                        if(reqMap.get("Content").equals("你好")){
                                content = "你也好,你全家都好。";
                        }
                        if(reqMap.get("Content").equals("菜单") ){
                                Tools.createMenu();//建立菜单
                        }
                        return XmlResp.buildText(fromUser, toUser, content);
                }


跟上篇一样,用户发送菜单二字,我们就调用并生成菜单
提醒:(菜单生成微信要返回主界面,再进一次微信,同时设置第二次有时要24小时内才能生效)
但这里完成,经过小编测试,也还是不成功,原因是因为当前微信的demo不支持https请求(也不知道为什么微信demo自己不调试好),那我们再改改按下一个步聚来做就可以了。




七、支持Https的POST(默认DEMO不支持,修改代码)

我们要在这里添加二个文件,原本是没有的。




添加进去,SSLClient.java、MyX509TrustManager.java这两个文件就是实现https的请求的(修改后的DEMO在最后面提供给大家下载的)





我们还需要在http请求的地方调用SSLClient类,如上图,我们在executeGet、executePost添加了一段代码。
if( url.indexOf("https")>=0 ){
        httpclient =new SSLClient();
}else{
        httpclient = new DefaultHttpClient();
}
如果是https那么就自动请求ssl,实现可以请求https了。




八、JSP文件调用类文件。

右击WebContent文件-》New->JSP File,新建一个jsp文件,取名为test.jsp,然后点击finish。





自动生成jsp文件,然后运行。




网址后面加test.jsp,然后回车,就能看到白白的页面,访问成功。




[Java] 纯文本查看 复制代码
01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8" import="com.bluelight.tools.Tools"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
调用类函数的方法:
<%
            Tools ts= new Tools();
            ts.createMenu();
    %>
</body>
</html>


这时再修改一个这个文件的代码如上图,这样就可以成功调用类文件了,但不建议这么调用不正规,只是方便而以。


再运行,输出如下信息,说明成功!



九、打包成War文件。

开始导出war文件。



导出一个文件名,保存就能成功导出war文件,之后就可以上传到服务器了。



十、总结。
原来的DEMO不支持https请求,也没有jsp文件,这些都是要自己建立的。
经过对微信Demo的源代码分析、修改、调式,那么我们这一课节就完成了。
附源代码下载:http://pan.baidu.com/s/1skSC9jf



关注@智能创客  微信:znck007(打造DIY创客平台)


« 上一篇 下一篇 »

发表评论:

◎欢迎参与讨论,请在这里发表您的看法、交流您的观点。