微信小程序开发(1) 订阅消息通知

柔光的暖阳◎ 2022-10-13 05:15 454阅读 0赞

### 一、前言 ###

1.  本文将基于springboot实现小程序 - 订阅消息通知
2.  可参考微信小程序订阅消息文档：[https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/subscribe-message.html][https_developers.weixin.qq.com_miniprogram_dev_framework_open-ability_subscribe-message.html]

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjI1NTU4_size_16_color_FFFFFF_t_70]

### 二、获取模板 ID ###

> [https://mp.weixin.qq.com/wxamp/newtmpl/mytmpl?start=0&limit=10&token=721590608&lang=zh\_CN][https_mp.weixin.qq.com_wxamp_newtmpl_mytmpl_start_0_limit_10_token_721590608_lang_zh_CN]

到`小程序-订阅消息-公共模板库`下选用模板  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjI1NTU4_size_16_color_FFFFFF_t_70 1]  
注：`{ {thing2.DATA}}`和`{ {thing1.DATA}}`为模板动态值  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjI1NTU4_size_16_color_FFFFFF_t_70 2]

### 三、小程序端获取消息通知权限 ###

> [https://developers.weixin.qq.com/miniprogram/dev/api/open-api/subscribe-message/wx.requestSubscribeMessage.html][https_developers.weixin.qq.com_miniprogram_dev_api_open-api_subscribe-message_wx.requestSubscribeMessage.html]

// 小程序端示例代码
    wx.requestSubscribeMessage({ 
      tmplIds: [''],
      success (res) {  }
    })

### 四、服务端编写消息通知代码 ###

> [https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/subscribe-message/subscribeMessage.send.html][https_developers.weixin.qq.com_miniprogram_dev_api-backend_open-api_subscribe-message_subscribeMessage.send.html]

@Slf4j
    public class DemoTest { 
    
        @Test
        public void testPushWxMaMsg() { 
            // TODO 1、填写自己的数据
            final String APPID = "xxx";
            final String APPSECRET = "xxx";
            final String touser = "xxx";
            final String template_id = "xxx";
            final String url = "pages/index/index";
            final HashMap<String, Object> templateDataMap = new HashMap<String, Object>() { 
                { 
                    put("thing1", new HashMap<String, String>() { { 
                        put("value", "内容简述-test");
                    }});
                    put("thing2", new HashMap<String, String>() { { 
                        put("value", "学习内容-test");
                    }});
                }
            };
    
            // 2、发送订阅消息
            Map<String, String> resultMap = this.sendWxMaMsg(WxMaTemplateMsgBO.builder()
                    .access_token(this.getAccessToken(APPID, APPSECRET))
                    .touser(touser)
                    .template_id(template_id)
                    .page(url)
                    .miniprogram_state("developer")
                    .data(templateDataMap)
                    .lang("zh_CN")
                    .build());
            log.info("小程序-发送订阅消息结果：{}", resultMap);
        }
    
        /** * 小程序-发送订阅消息 * * @param wxMaTemplateMsgBO: 请求参数 * @return 通知结果 * @author zhengqingya * @date 2021/7/6 10:13 */
        public Map<String, String> sendWxMaMsg(WxMaTemplateMsgBO wxMaTemplateMsgBO) { 
            String sendWxMaMsgRequestUrl = String.format("https://api.weixin.qq.com/cgi-bin/message/subscribe/send?access_token=%s", wxMaTemplateMsgBO.getAccess_token());
            RestTemplate restTemplate = new RestTemplate();
            // 解决post请求中文乱码问题
            restTemplate.getMessageConverters().set(1, new StringHttpMessageConverter(StandardCharsets.UTF_8));
            // 注：如果报`{"errcode":47001,"errmsg":"data format error rid: 61334bd2-26ac356f-0eb9e0f6"}` 使用：wxMaTemplateMsgBO => JSON.toJSONString(wxMaTemplateMsgBO)
    // return restTemplate.postForEntity(sendWxMaMsgRequestUrl, JSON.toJSONString(wxMaTemplateMsgBO), Map.class).getBody();
            return restTemplate.postForEntity(sendWxMaMsgRequestUrl, wxMaTemplateMsgBO, Map.class).getBody();
        }
    
    
        /** * 获取小程序全局唯一后台接口调用凭据（access_token） * * @param appid: 小程序唯一凭证，即 AppID，可在「微信公众平台 - 设置 - 开发设置」页中获得。（需要已经成为开发者，且帐号没有异常状态） * @param secret: 小程序唯一凭证密钥，即 AppSecret，获取方式同 appid * @return 调用凭据 * @author zhengqingya * @date 2021/7/6 10:04 */
        private String getAccessToken(String appid, String secret) { 
            String accessTokenRequestUrl = String.format("https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=%s&secret=%s", appid, secret);
            Map<String, String> tokenMap = new RestTemplate().getForObject(accessTokenRequestUrl, Map.class);
            return CollectionUtils.isEmpty(tokenMap) ? "" : tokenMap.get("access_token");
        }
    
    }

运行之后，即可去微信上查看消息通知了 `^ _ ^`

### 本文案例demo源码 ###

[https://gitee.com/zhengqingya/java-workspace][https_gitee.com_zhengqingya_java-workspace]

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

> 今日分享语句：要么读书、要么旅行,灵魂和身体,必须有一个在路上。

[https_developers.weixin.qq.com_miniprogram_dev_framework_open-ability_subscribe-message.html]: https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/subscribe-message.html
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjI1NTU4_size_16_color_FFFFFF_t_70]: /images/20221005/eecfe71ecb9a4e8685044a7584d15b25.png
[https_mp.weixin.qq.com_wxamp_newtmpl_mytmpl_start_0_limit_10_token_721590608_lang_zh_CN]: https://mp.weixin.qq.com/wxamp/newtmpl/mytmpl?start=0&limit=10&token=721590608&lang=zh_CN
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjI1NTU4_size_16_color_FFFFFF_t_70 1]: /images/20221005/93750c4c8e8e4998983b2b837f385c76.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM4MjI1NTU4_size_16_color_FFFFFF_t_70 2]: /images/20221005/857d55bf4f8a41e0927656a6ed190499.png
[https_developers.weixin.qq.com_miniprogram_dev_api_open-api_subscribe-message_wx.requestSubscribeMessage.html]: https://developers.weixin.qq.com/miniprogram/dev/api/open-api/subscribe-message/wx.requestSubscribeMessage.html
[https_developers.weixin.qq.com_miniprogram_dev_api-backend_open-api_subscribe-message_subscribeMessage.send.html]: https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/subscribe-message/subscribeMessage.send.html
[https_gitee.com_zhengqingya_java-workspace]: https://gitee.com/zhengqingya/java-workspace