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

一、简介

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

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

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

二、思路分析

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

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

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

三、判断消息类型

$postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA);
$RX_TYPE = trim($postObj->MsgType);

switch($RX_TYPE)
{
    case "text":
        $resultStr = $this->handleText($postObj);
        break;
    case "event":
        $resultStr = $this->handleEvent($postObj);
        break;
    default:
        $resultStr = "Unknow msg type: ".$RX_TYPE;
        break;
}

说明:

$RX_TYPE = trim($postObj->MsgType);   得到消息类型;

case "text":
  $resultStr = $this->handleText($postObj);   使用handleText() 函数处理文本消息;

case "event":
  $resultStr = $this->handleEvent($postObj);   使用handleEvent() 函数处理事件推送;

四、判断事件类型

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

说明:

如果是subscribe事件,设定回复内容为“感谢您关注【卓锦苏州】...”;

五、完整代码

<?php
/**
  * wechat php test
  */

//define your token
define("TOKEN", "zhuojin");
$wechatObj = new wechatCallbackapiTest();
$wechatObj->responseMsg();
//$wechatObj->valid();

class wechatCallbackapiTest
{
    /*public function valid()
    {
        $echoStr = $_GET["echostr"];

        //valid signature , option
        if($this->checkSignature()){
            echo $echoStr;
            exit;
        }
    }*/

    public function responseMsg()
    {
        //get post data, May be due to the different environments
        $postStr = $GLOBALS["HTTP_RAW_POST_DATA"];

        //extract post data
        if (!empty($postStr)){
                
                $postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA);
                $RX_TYPE = trim($postObj->MsgType);

                switch($RX_TYPE)
                {
                    case "text":
                        $resultStr = $this->handleText($postObj);
                        break;
                    case "event":
                        $resultStr = $this->handleEvent($postObj);
                        break;
                    default:
                        $resultStr = "Unknow msg type: ".$RX_TYPE;
                        break;
                }
                echo $resultStr;
        }else {
            echo "";
            exit;
        }
    }

    public function handleText($postObj)
    {
        $fromUsername = $postObj->FromUserName;
        $toUsername = $postObj->ToUserName;
        $keyword = trim($postObj->Content);
        $time = time();
        $textTpl = "<xml>
                    <ToUserName><![CDATA[%s]]></ToUserName>
                    <FromUserName><![CDATA[%s]]></FromUserName>
                    <CreateTime>%s</CreateTime>
                    <MsgType><![CDATA[%s]]></MsgType>
                    <Content><![CDATA[%s]]></Content>
                    <FuncFlag>0</FuncFlag>
                    </xml>";             
        if(!empty( $keyword ))
        {
            $msgType = "text";
            $contentStr = "Welcome to wechat world!";
            $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
            echo $resultStr;
        }else{
            echo "Input something...";
        }
    }

    public function handleEvent($object)
    {
        $contentStr = "";
        switch ($object->Event)
        {
            case "subscribe":
                $contentStr = "感谢您关注【卓锦苏州】"."\n"."微信号:zhuojinsz"."\n"."卓越锦绣,名城苏州,我们为您提供苏州本地生活指南,苏州相关信息查询,做最好的苏州微信平台。"."\n"."目前平台功能如下:"."\n"."【1】 查天气,如输入:苏州天气"."\n"."【2】 查公交,如输入:苏州公交178"."\n"."【3】 翻译,如输入:翻译I love you"."\n"."【4】 苏州信息查询,如输入:苏州观前街"."\n"."更多内容,敬请期待...";
                break;
            default :
                $contentStr = "Unknow Event: ".$object->Event;
                break;
        }
        $resultStr = $this->responseText($object, $contentStr);
        return $resultStr;
    }
    
    public function responseText($object, $content, $flag=0)
    {
        $textTpl = "<xml>
                    <ToUserName><![CDATA[%s]]></ToUserName>
                    <FromUserName><![CDATA[%s]]></FromUserName>
                    <CreateTime>%s</CreateTime>
                    <MsgType><![CDATA[text]]></MsgType>
                    <Content><![CDATA[%s]]></Content>
                    <FuncFlag>%d</FuncFlag>
                    </xml>";
        $resultStr = sprintf($textTpl, $object->FromUserName, $object->ToUserName, time(), $content, $flag);
        return $resultStr;
    }

    private function checkSignature()
    {
        $signature = $_GET["signature"];
        $timestamp = $_GET["timestamp"];
        $nonce = $_GET["nonce"];    
                
        $token = TOKEN;
        $tmpArr = array($token, $timestamp, $nonce);
        sort($tmpArr);
        $tmpStr = implode( $tmpArr );
        $tmpStr = sha1( $tmpStr );
        
        if( $tmpStr == $signature ){
            return true;
        }else{
            return false;
        }
    }
}

?>



<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**:模拟微信服务器发送事件消息。 --- 通过以上步骤,即可实现订阅通知的发送。具体代码需根据实际业务调整模板参数和用户触发逻辑。
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值