前面写过一篇云开发实现小程序订阅消息(模板消息)推送的文章,《借助云开发实现小程序订阅消息和模板消息的推送功能》是有好多同学用的是Java写后台,所以今天就再来写一篇Java后台实现小程序订阅消息推送的文章。
老规矩先看效果图
至于如何创建模板消息,如果获取模板id我这节就不再讲解,不知道的同学可以查看我上篇文章《借助云开发实现小程序订阅消息和模板消息的推送功能》里面有详细的讲解。
今天呢就来重点讲下如何在Java后台编写小程序订阅消息推送的知识。
其实我很早之前有写过一篇Java实现模板消息推送的,但是小程序后面用订阅消息替换了模板推送,所以我也会根据最新的知识点不定期的更新文章的。
发送订阅消息三步走
- 1,拿到用户的openid
- 2,获取access_token
- 3,调用小程序消息推送的接口
一,获取用户的openid
关于用户openid的获取,我写过很多篇文章了,也有录过视频出来的,还不知道怎么获取的同学,可以取翻看下我之前的文章,或者看下我录制的零基础入门小程序的视频:《5小时零基础入门小程序云开发》 所以这一步不是今天的重点。
二,获取access_token
首先来看下access_token是什么,下图是官方给出的
其实通俗的讲,access_token就是小程序官方给我们提供的一个凭证,你要调用小程序官方的接口,就必须先拿到access_token。所以下面先讲下如果获取access_token
- 看下官方文档,可以知道我们需要用到下面的几个参数
grant_type是一个固定的值,只有appid和secret是需要我们填入的,这两个值在我们的小程序后台就可以拿到,我也有录视频教大家如何拿到,如果不知道怎么获取的同学可以取看下我的视频。
下面就是Java代码的编写了
我们这里用的是springboot,这里涉及到一个请求小程序官方接口,所以我们这里用了springboot自带的RestTemplate来做网络请求。具体代码如下。
可以看出代码很简单,就是用RestTemplate来实现一个get请求,这样我们就可以轻松的获取到了access_token。
注意点
关于这个access_token,是存在有效期的,来看下官方给出的提示
所以我要在获取到access_token的时候,把access_token存到数据库,或者存到本地缓存,并且还要记录当前时间,后面再用的时候先判断这个access_token有没有超过2个小时,如果超过2个小时的话,就要重新获取了。由于这里不是本节的重点,我这里只给大家说下原理。
三,发送消息到小程序
我们通过上面第二步,成功的获取到了access_token。下面就要调用小程序官方为我们提供的发送消息的接口了。先看下官方文档。
上面的参数都是我们发送消息时需要的。这些参数的定义和设置我在前面的文章里也都讲过了,不知道的同学可以去看下我前面写的这篇文章 《借助云开发实现小程序订阅消息和模板消息的推送功能》
这里需要注意的一点是,我们要给用户发送消息,就必须引导用户授权,就是下面这个图
因为用户不点击允许,你是没有办法给用户推送消息的。每一次授权只允许发送一条消息,所以如果你想尽量多的发送消息,就得尽量多的引导用户授权。
推送的Java代码如下
可以看到,我们这里需要定义用户的openid,模板id,跳转路径,模板消息内容。。。
这些都定义好以后,我们就可以提供一个服务给到Java的其他代码调用,或者提供一个接口供外界传入openid,然后给对应的用户推送消息了。
我们在浏览器里调用上面接口,可以看到下图所示,这样就代表我们消息推送成功了。
下面我把完整的代码贴出来给到大家。
package com.qcl.demo;
import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.client.RestClientException;
import org.springframework.web.client.RestTemplate;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
/**
* 作者:编程小石头
* 发送小程序订阅消息
*/
@RestController
public class SendWxMessage {
/*
* 发送订阅消息
* */
@GetMapping("/pushOneUser")
public String pushOneUser() {
return push("o3DoL0WEdzcJ20AVJg1crP96gbjM");
}
public String push(String openid) {
RestTemplate restTemplate = new RestTemplate();
//这里简单起见我们每次都获取最新的access_token(时间开发中,应该在access_token快过期时再重新获取)
String url = "https://api.weixin.qq.com/cgi-bin/message/subscribe/send?access_token=" + getAccessToken();
//拼接推送的模版
WxMssVo wxMssVo = new WxMssVo();
wxMssVo.setTouser(openid);//用户的openid(要发送给那个用户,通常这里应该动态传进来的)
wxMssVo.setTemplate_id("CFeSWarQLMPyPjwmiy6AV4eB-IZcipu48V8bFLkBzTU");//订阅消息模板id
wxMssVo.setPage("pages/index/index");
Map<String, TemplateData> m = new HashMap<>(3);
m.put("thing1", new TemplateData("小程序入门课程"));
m.put("thing6", new TemplateData("杭州浙江大学"));
m.put("thing7", new TemplateData("第一章第一节"));
wxMssVo.setData(m);
ResponseEntity<String> responseEntity =
restTemplate.postForEntity(url, wxMssVo, String.class);
return responseEntity.getBody();
}
@GetMapping("/getAccessToken")
public String getAccessToken() {
RestTemplate restTemplate = new RestTemplate();
Map<String, String> params = new HashMap<>();
params.put("APPID", "wx7c54942dfc87f4d8"); //
params.put("APPSECRET", "5873a729c365b65ab42bb5fc82d2ed49"); //
ResponseEntity<String> responseEntity = restTemplate.getForEntity(
"https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid={APPID}&secret={APPSECRET}", String.class, params);
String body = responseEntity.getBody();
JSONObject object = JSON.parseObject(body);
String Access_Token = object.getString("access_token");
String expires_in = object.getString("expires_in");
System.out.println("有效时长expires_in:" + expires_in);
return Access_Token;
}
}
对应的两个数据类如下
WxMssVo用来封装请求官方接口的参数
package com.qcl.demo;
import java.util.Map;
/*
* 小程序推送所需数据
* 编程小石头
* */
public class WxMssVo {
private String touser;//用户openid
private String template_id;//订阅消息模版id
private String page = "pages/index/index";//默认跳到小程序首页
private Map<String, TemplateData> data;//推送文字
public String getTouser() {
return touser;
}
public void setTouser(String touser) {
this.touser = touser;
}
public String getTemplate_id() {
return template_id;
}
public void setTemplate_id(String template_id) {
this.template_id = template_id;
}
public String getPage() {
return page;
}
public void setPage(String page) {
this.page = page;
}
public Map<String, TemplateData> getData() {
return data;
}
public void setData(Map<String, TemplateData> data) {
this.data = data;
}
}
TemplateData 用来定义消息的内容
package com.qcl.demo;
public class TemplateData {
private String value;//
public TemplateData(String value) {
this.value = value;
}
public String getValue() {
return value;
}
public void setValue(String value) {
this.value = value;
}
}
到这里我们就可以完整的实现Java发送小程序消息的功能了。完整代码也已经贴给大家了。
上文代码全是坑,慎用。
@Data @AllArgsConstructor public static class Keyword { private String value; }
import xin.xihc.rebate.schedule.WxTemplateMsg; import java.util.LinkedHashMap; import java.util.Map; /** * 订阅消息对象 * * @author Leo.Xi * @date 2019/10/25 * @since 1.0 **/ public class SubscribeMsgData { /** 顺序值 */ private int index = 1; /** 数据data */ private LinkedHashMap<String, WxTemplateMsg.Keyword> data = new LinkedHashMap<>(); public static SubscribeMsgData create() { return new SubscribeMsgData(); } /** * thing.DATA 事物 20个以内字符 可汉字、数字、字母或符号组合 * * @param thing * @author Leo.Xi * @date 2019/10/25 * @since 0.0.1 */ public SubscribeMsgData thing(String thing) { if (thing.length() > 20){ thing = thing.substring(0, 20); } data.put("thing" + index, new WxTemplateMsg.Keyword(thing)); ++index; return this; } /** * number.DATA 数字 32位以内数字 只能数字,可带小数 * * @param number * @author Leo.Xi * @date 2019/10/25 * @since 0.0.1 */ public SubscribeMsgData number(String number) { if (number.length() > 32){ number = number.substring(0, 32); } data.put("number" + index, new WxTemplateMsg.Keyword(number)); ++index; return this; } /** * letter.DATA 字母 32位以内字母 只能字母 * * @param letter * @author Leo.Xi * @date 2019/10/25 * @since 0.0.1 */ public SubscribeMsgData letter(String letter) { data.put("letter" + index, new WxTemplateMsg.Keyword(letter)); ++index; return this; } /** * date.DATA 日期 年月日格式(支持+24小时制时间) 例如:2019年10月1日,或:2019年10月1日 15:01 * * @param date * @author Leo.Xi * @date 2019/10/25 * @since 0.0.1 */ public SubscribeMsgData date(String date) { data.put("date" + index, new WxTemplateMsg.Keyword(date)); ++index; return this; } /** * amount.DATA 金额 1个币种符号+10位以内纯数字,可带小数,结尾可带“元” 可带小数 * * @param amount * @author Leo.Xi * @date 2019/10/25 * @since 0.0.1 */ public SubscribeMsgData amount(String amount) { data.put("amount" + index, new WxTemplateMsg.Keyword(amount)); ++index; return this; } /** * phrase.DATA 汉字 5个以内汉字 5个以内纯汉字,例如:配送中 * * @param phrase * @author Leo.Xi * @date 2019/10/25 * @since 0.0.1 */ public SubscribeMsgData phrase(String phrase) { data.put("phrase" + index, new WxTemplateMsg.Keyword(phrase)); ++index; return this; } public Map<String, WxTemplateMsg.Keyword> data() { return this.data; } }
这是小程序社区吧- -