微信公众平台开发(三) 订阅事件(subscribe)处理

微信公众平台开发(三) 订阅事件(subscribe)处理

来源:David Camp   时间:2013-09-09 18:40:50   阅读数:19986
分享到: 4

[导读] 一、简介新用户关注微信公众平台,将产生一个订阅事件,即subscribe事件,默认代码中没有对这一事件进行相应回复处理。在新用户关注公众平台后,可能想知道该平台提供了哪些功能,以及怎样使用该平台,通俗一点讲

一、简介

新用户关注微信公众平台,将产生一个订阅事件,即subscribe事件,默认代码中没有对这一事件进行相应回复处理。

在新用户关注公众平台后,可能想知道该平台提供了哪些功能,以及怎样使用该平台,通俗一点讲就是该平台的“使用说明书”。

本文将详细讲述对subscribe事件的处理过程,回复相应信息提升交互性。

二、思路分析

微信目前提供了五种消息类型,分别为:

  • 文本消息(text);
  • 图片消息(image);
  • 地理位置消息(location);
  • 链接消息(link);
  • 事件推送(event);

接收到消息后,首先需要对消息类型做出判断,然后再针对不同类型的消息做出处理。在事件推送中,事件类型又分为三种,subscribe(订阅)、unsubscribe(取消订阅)、CLICK(自定义菜单点击事件),还需要再加一次判断;判断为subscribe事件后,根据设定好的欢迎消息,回复给用户。

三、判断消息类型

 
01. $postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA);
02. $RX_TYPE = trim($postObj->MsgType);
03.  
04. switch($RX_TYPE)
05. {
06. case "text":
07. $resultStr = $this->handleText($postObj);
08. break;
09. case "event":
10. $resultStr = $this->handleEvent($postObj);
11. break;
12. default:
13. $resultStr = "Unknow msg type: ".$RX_TYPE;
14. break;
15. }
 
 

说明:

 

1. $RX_TYPE = trim($postObj->MsgType);   得到消息类型;
2.  
3. case "text":
4.   $resultStr = $this->handleText($postObj);   使用handleText() 函数处理文本消息;
5.  
6. case "event":
7.   $resultStr = $this->handleEvent($postObj);   使用handleEvent() 函数处理事件推送;

 

四、判断事件类型

01. switch ($object->Event)
02. {
03. case "subscribe":
04. $contentStr = "感谢您关注【卓锦苏州】"."\n"."微信号:zhuojinsz"."\n"."卓越锦绣,名城苏州,我们为您提供苏州本地生活指南,苏州相关信息查询,做最好的苏州微信平台。"."\n"."目前平台功能如下:"."\n"."【1】 查天气,如输入:苏州天气"."\n"."【2】 查公交,如输入:苏州公交178"."\n"."【3】 翻译,如输入:翻译I love you"."\n"."【4】 苏州信息查询,如输入:苏州观前街"."\n"."更多内容,敬请期待...";
05. break;
06. default :
07. $contentStr = "Unknow Event: ".$object->Event;
08. break;
09. }

五、完整代码

001. <!--?php
002. /**
003. * wechat php test
004. */
005.  
006. //define your token
007. define("TOKEN""zhuojin");
008. $wechatObj new wechatCallbackapiTest();
009. $wechatObj--->responseMsg();
010. //$wechatObj->valid();
011.  
012. class wechatCallbackapiTest
013. {
014. /*public function valid()
015. {
016. $echoStr = $_GET["echostr"];
017.  
018. //valid signature , option
019. if($this->checkSignature()){
020. echo $echoStr;
021. exit;
022. }
023. }*/
024.  
025. public function responseMsg()
026. {
027. //get post data, May be due to the different environments
028. $postStr $GLOBALS["HTTP_RAW_POST_DATA"];
029.  
030. //extract post data
031. if (!emptyempty($postStr)){
032.  
033. $postObj = simplexml_load_string($postStr'SimpleXMLElement', LIBXML_NOCDATA);
034. $RX_TYPE = trim($postObj->MsgType);
035.  
036. switch($RX_TYPE)
037. {
038. case "text":
039. $resultStr $this->handleText($postObj);
040. break;
041. case "event":
042. $resultStr $this->handleEvent($postObj);
043. break;
044. default:
045. $resultStr "Unknow msg type: ".$RX_TYPE;
046. break;
047. }
048. echo $resultStr;
049. }else {
050. echo "";
051. exit;
052. }
053. }
054.  
055. public function handleText($postObj)
056. {
057. $fromUsername $postObj->FromUserName;
058. $toUsername $postObj->ToUserName;
059. $keyword = trim($postObj->Content);
060. $time = time();
061. $textTpl = "<xml>
062. <tousername><!--[CDATA[%s]]--></tousername>
063. <fromusername><!--[CDATA[%s]]--></fromusername>
064. <createtime>%s</createtime>
065. <msgtype><!--[CDATA[%s]]--></msgtype>
066. <content><!--[CDATA[%s]]--></content>
067. <funcflag>0</funcflag>
068. </xml>";            
069. if(!emptyempty$keyword ))
070. {
071. $msgType "text";
072. $contentStr "Welcome to wechat world!";
073. $resultStr = sprintf($textTpl$fromUsername$toUsername$time,$msgType$contentStr);
074. echo $resultStr;
075. }else{
076. echo "Input something...";
077. }
078. }
079.  
080. public function handleEvent($object)
081. {
082. $contentStr "";
083. switch ($object->Event)
084. {
085. case "subscribe":
086. $contentStr "感谢您关注【卓锦苏州】"."\n"."微信号:zhuojinsz"."\n"."卓越锦绣,名城苏州,我们为您提供苏州本地生活指南,苏州相关信息查询,做最好的苏州微信平台。"."\n"."目前平台功能如下:"."\n"."【1】 查天气,如输入:苏州天气"."\n"."【2】 查公交,如输入:苏州公交178"."\n"."【3】 翻译,如输入:翻译I love you"."\n"."【4】 苏州信息查询,如输入:苏州观前街"."\n"."更多内容,敬请期待...";
087. break;
088. default :
089. $contentStr "Unknow Event: ".$object->Event;
090. break;
091. }
092. $resultStr $this->responseText($object$contentStr);
093. return $resultStr;
094. }
095.  
096. public function responseText($object$content$flag=0)
097. {
098. $textTpl = "<xml>
099. <tousername><!--[CDATA[%s]]--></tousername>
100. <fromusername><!--[CDATA[%s]]--></fromusername>
101. <createtime>%s</createtime>
102. <msgtype><!--[CDATA[text]]--></msgtype>
103. <content><!--[CDATA[%s]]--></content>
104. <funcflag>%d</funcflag>
105. </xml>";
106. $resultStr = sprintf($textTpl$object->FromUserName, $object->ToUserName, time(), $content$flag);
107. return $resultStr;
108. }
109.  
110. private function checkSignature()
111. {
112. $signature $_GET["signature"];
113. $timestamp $_GET["timestamp"];
114. $nonce $_GET["nonce"];   
115.  
116. $token = TOKEN;
117. $tmpArr array($token$timestamp$nonce);
118. sort($tmpArr);
119. $tmpStr = implode( $tmpArr );
120. $tmpStr = sha1( $tmpStr );
121.  
122. if$tmpStr == $signature ){
123. return true;
124. }else{
125. return false;
126. }
127. }
128. }
129.  
130. ?>

<think>嗯,用户想用Java Spring Boot开发微信服务号的订阅通知功能,我得先理清楚整个流程。首先,用户可能对微信公众平台开发流程不太熟悉,可能需要先介绍一些基本步骤。 首先,注册服务号并认证是必须的,因为只有认证的服务号才能申请模板消息或者订阅通知的权限。然后,需要配置服务器,这涉及到微信的验证流程,比如验证消息的确来自微信服务器。这里可能需要用到Spring Boot的Controller来处理GET请求,验证签名什么的。 接下来,申请订阅消息模板。微信现在可能已经从模板消息转向了订阅通知,所以用户需要注意接口的变化。用户需要知道如何获取模板ID,以及模板里的各个参数怎么配置。 然后是用户订阅事件处理。当用户关注服务号或者点击订阅按钮时,微信会发送一个事件到配置的服务器,这时候需要用Controller来接收这个事件,并触发发送订阅通知的请求。可能需要用HTTP客户端比如RestTemplate或者Feign来调用微信的接口。 发送订阅通知的时候,要构造正确的JSON数据,包括用户的OpenID、模板ID、跳转的页面、数据内容等。还要注意access_token的获取和缓存,避免频繁调用导致接口限制。这里可能需要用Redis或者缓存机制来保存token,定时刷新。 用户可能会有疑问,比如如何保证安全性,比如验证消息的真实性,处理敏感数据。还有可能遇到哪些常见问题,比如签名错误、token失效、模板参数不对等,需要给出调试建议,比如用微信的测试号先进行开发,查看日志等。 另外,用户可能想知道如何让用户触发订阅,比如通过菜单按钮或者回复关键字,这时候需要设计相应的交互流程。同时,订阅通知的发送时机也很重要,不能频繁打扰用户,否则可能被投诉。 还有,返回结果的处理,比如发送成功或失败后的逻辑,是否需要重试或者记录日志。异常处理也是关键,比如网络问题导致调用微信接口失败,应该如何处理。 总之,整个流程需要分步骤讲解,从配置公众号、服务器设置、处理订阅事件、获取token、发送消息到异常处理,每个环节都要详细说明,并且给出代码示例,这样用户才能更好地理解和实现。</think>使用Java Spring Boot开发微信服务号订阅通知功能,主要分为以下步骤: --- ### **1. 准备工作** - **注册微信服务号**:完成企业认证(订阅通知功能需认证的服务号)。 - **配置服务器信息**: - 登录微信公众平台,进入**开发 > 基本配置**,启用服务器配置(填写Spring Boot应用的公网URL和Token)。 - **申请订阅消息模板**: - 在微信公众平台**功能 > 订阅消息**中创建模板,获取`template_id`。 --- ### **2. Spring Boot项目搭建** #### 依赖配置(`pom.xml`): ```xml <!-- 核心依赖 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <!-- HTTP客户端(如发送微信API请求) --> <dependency> <groupId>org.apache.httpcomponents</groupId> <artifactId>httpclient</artifactId> </dependency> <!-- JSON处理 --> <dependency> <groupId>com.alibaba</groupId> <artifactId>fastjson</artifactId> <version>1.2.83</version> </dependency> ``` --- ### **3. 实现核心逻辑** #### (1) **验证微信服务器(GET请求)** 微信会通过GET请求验证服务器有效性,需在Controller中处理: ```java @RestController public class WechatController { @GetMapping("/wechat") public String validate(@RequestParam("signature") String signature, @RequestParam("timestamp") String timestamp, @RequestParam("nonce") String nonce, @RequestParam("echostr") String echostr) { // 1. 将token、timestamp、nonce按字典序排序并拼接 // 2. SHA1加密后与signature比对 // 3. 验证成功返回echostr return checkSignature(signature, timestamp, nonce) ? echostr : "error"; } } ``` #### (2) **获取Access Token** 调用微信API需要凭证`access_token`,需定时刷新(建议缓存): ```java @Component public class WechatTokenService { private String accessToken; @Scheduled(fixedRate = 7200 * 1000 - 600) // 每2小时刷新一次 public void refreshToken() { String url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid={APPID}&secret={APPSECRET}"; ResponseEntity<String> response = restTemplate.getForEntity(url, String.class); JSONObject json = JSON.parseObject(response.getBody()); this.accessToken = json.getString("access_token"); } } ``` #### (3) **处理用户订阅事件** 当用户触发订阅操作(如点击订阅按钮),微信会发送事件到服务器: ```java @PostMapping("/wechat") public String handleMessage(@RequestBody String body) { // 解析XML消息 Map<String, String> msgMap = parseXmlMessage(body); if ("event".equals(msgMap.get("MsgType")) && "subscribe".equals(msgMap.get("Event"))) { // 用户订阅事件,触发发送订阅通知 sendSubscribeMessage(msgMap.get("FromUserName")); } return "success"; } ``` #### (4) **发送订阅通知** 调用微信订阅消息接口(需替换模板参数): ```java public void sendSubscribeMessage(String openId) { String url = "https://api.weixin.qq.com/cgi-bin/message/subscribe/send?access_token=" + accessToken; JSONObject data = new JSONObject(); // 填充模板内容(根据申请的模板字段) data.put("thing1", JSON.parseObject("{'value':'您有新的订单'}")); data.put("time2", JSON.parseObject("{'value':'2024-01-01 12:00'}")); JSONObject requestBody = new JSONObject(); requestBody.put("touser", openId); requestBody.put("template_id", "YOUR_TEMPLATE_ID"); requestBody.put("page", "pages/index"); // 跳转的小程序页面(非必填) requestBody.put("data", data); // 发送HTTP POST请求 HttpHeaders headers = new HttpHeaders(); headers.setContentType(MediaType.APPLICATION_JSON); HttpEntity<String> entity = new HttpEntity<>(requestBody.toJSONString(), headers); restTemplate.postForObject(url, entity, String.class); } ``` --- ### **4. 关键注意事项** 1. **安全性**:验证消息签名,防止伪造请求。 2. **模板匹配**:确保模板ID和参数与申请的一致。 3. **频率限制**:微信API有调用频率限制(如每天5000次)。 4. **用户授权**:部分场景需用户主动同意接收通知(如一次性订阅)。 --- ### **5. 调试工具** - **微信公众平台测试号**:通过测试号快速开发(无需正式服务号)。 - **日志记录**:记录微信API请求与响应,便于排查问题。 - **Postman**:模拟微信服务器发送事件消息。 --- 通过以上步骤,即可实现订阅通知的发送。具体代码需根据实际业务调整模板参数和用户触发逻辑。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值