微信公众号开发详细教程
公众号的关键词回复是一个最基本的功能,大部分的关键词回复可以在授权的第三方平台(微微校、腾讯微校等)去进行管理,配置开发服务器之后,微信平台的自动回复和自定义菜单会失效,而在开发服务器里面管理这些又过于繁琐,第三方平台解决了这个问题,而且第三方平台功能很多,如微信公众号上墙功能,可以去看看。
微信公众测试号
URL:验证的时候会携带参数以GET方法去请求这个url。而验证成功之后,微信公众号用户发送数据时,微信服务器会将数据以POST方法发送到这个url。
所以说我们应该写两个相同路径,请求方法不同的controller。
@RequestMapping(value="/wxserver",method={RequestMethod.GET});@RequestMapping(value="/wxserver",produces={"application/xml;charset=UTF-8;"},method={RequestMethod.POST})
普通消息
文本消息事例
<xml><ToUserName><![CDATA[toUser]]></ToUserName><FromUserName><![CDATA[fromUser]]></FromUserName><CreateTime>1348831860</CreateTime><MsgType><![CDATA[text]]></MsgType><Content><![CDATA[this is a test]]></Content><MsgId>1234567890123456</MsgId>
</xml>
参数 | 描述 |
---|---|
ToUserName | 开发者微信号 |
FromUserName | 发送方帐号(一个OpenID) |
CreateTime | 消息创建时间 (整型) |
MsgType | 消息类型,文本为text |
Content | 文本消息内容 |
MsgId | 消息id,64位整型 |
MsgType:消息类型,文本为text,图片为image,语音为voice等。可以去官方文档里去查看。
推送事件
菜单点击事件事例
用户点击自定义菜单后,微信会把点击事件推送给开发者,请注意,点击菜单弹出子菜单,不会产生上报。
点击菜单拉取消息时的事件推送
推送XML数据包示例:
<xml><ToUserName><![CDATA[toUser]]></ToUserName><FromUserName><![CDATA[FromUser]]></FromUserName><CreateTime>123456789</CreateTime><MsgType><![CDATA[event]]></MsgType><Event><![CDATA[CLICK]]></Event><EventKey><![CDATA[EVENTKEY]]></EventKey>
</xml>
参数说明:
参数 | 描述 |
---|---|
ToUserName | 开发者微信号 |
FromUserName | 发送方帐号(一个OpenID) |
CreateTime | 消息创建时间 (整型) |
MsgType | 消息类型,event |
Event | 事件类型,CLICK |
EventKey | 事件KEY值,与自定义菜单接口中KEY值对应 |
微信公众号工具包依赖
<!-- 微信开发工具包 --><dependency><groupId>me.chanjar</groupId><artifactId>weixin-java-mp</artifactId><version>1.3.3</version></dependency><dependency><groupId>me.chanjar</groupId><artifactId>weixin-java-common</artifactId><version>1.3.3</version></dependency>
开发代码
@ResponseBody()@RequestMapping(value="/wxserver",produces={"application/xml;charset=UTF-8;"},method={RequestMethod.POST})public String receive(HttpServletRequest request, HttpServletResponse response) throws Exception{//因为微信服务器返回的是xml 所以我们需要解析//获取消息流WxMpXmlMessage message=WxMpXmlMessage.fromXml(request.getInputStream());//消息类型String messageType=message.getMsgType();if("text".equals(messageType)){String res= wxTextReceiveService.receiveText(message);return res;}else if("event".equals(messageType)){String res= wxEventReceiveService.receiveClick(message);return res;}return "";}
自定义类WxTextReceiveService 中的处理方法
/*** 接收微信用户发送的普通文本消息 并且回复*/@Overridepublic String receiveText(WxMpXmlMessage message) {String str="";String fromUserName = message.getFromUserName();String toUserName = message.getToUserName();//文本消息 文本内容String content = message.getContent();//将回复消息按格式封装成xml //toUser(fromUserName).fromUser(toUserName) 发送者变成接受者WxMpXmlOutTextMessage text = WxMpXmlOutTextMessage.TEXT().toUser(fromUserName).fromUser(toUserName).content("hello word"+content ).build();str = text.toXml();return str;}
整个简单的交互过程就已经完成了。