简单介绍模板消息
什么是模板消息？模板消息仅用于公众号向用户发送重要的服务通知，只能用于符合其要求的服务场景中，如涉及金钱交易-刷卡支付，商品购买等，不支持广告等营销类消息以及其它所有可能对用户造成骚扰的消息。模版消息可以不通过用户主动交互向用户推送消息，但尽量少推送消息，避免被举报，以下微信模板消息的使用规则：
微信官方文档：https://developers./doc/offiaccount/Message_Management/Template_Message_Interface.html
第一步：有一个公众号或申请一个公众号测试号 然后 添加一个消息模板
申请一个公众号测试号，详情请看我在前面写的博客：微信公众号推送模板消息（一）：申请微信公众帐号测试号
第二步：通过公众号或测试号的 appid 和 secret ，获取 access_token 信息
获取 access_token 信息，详细请看我在前面写的博客：微信公众号推送模板消息（二）：Access_token的获取
第三步：通过获取到的 access_token 获取关注者 openid （以便于给多用户推送消息）
获取 openid 关注者列表，详细请看我在前面写的博客：微信公众号推送模板消息（三）：获取关注者列表 openid
第四步：配置模板类 及 定义相关参数 来准备消息推送
微信模板消息推送采用的是 JSON 格式，我们可以用两种方式对他进行配置：
第一种就是下面的这个配置模板类，然后一步一步的来搞定 微信消息参数，模版消息内容，模版消息（公用的类，注意一下模版名称规范）。
第二种就是手动拼接成 JSON 串，进行推送。
配置模板类
微信消息参数模板 WxTemplate
import java.util.Map;/*** 微信消息参数*/public class WxTemplate {//进行推送所需参数private String touser;//用户openid（接收人）private String template_id;//消息模版idprivate String url = "";//跳转到某链接或某页面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 getUrl() {return url;}public void setUrl(String url) {this.url = url;}public Map<String, TemplateData> getData() {return data;}public void setData(Map<String, TemplateData> data) {this.data = data;}}
微信模版消息内容 TemplateData
/*** 微信模版消息内容*/public class TemplateData {private String value;//消息内容private String color;//消息颜色//构造方法（空参）public TemplateData() {}//构造方法（有参）public TemplateData(String value,String color) {this.value = value;this.color = color;}public String getValue() {return value;}public void setValue(String value) {this.value = value;}public String getColor() {return color;}public void setColor(String color) {this.color = color;}}
微信消息模版 MeTemplate (根据消息模版的字段来定义此类）
/*** 微信消息模板*/public class MeTemplate {// 根据 新增的消息测试模板来定义private String title;// 标题private String content;// 内容private String time;// 时间private String remark;// 备注public String getTitle() {return title;}public void setTitle(String title) {this.title = title;}public String getContent() {return content;}public void setContent(String content) {this.content = content;}public String getTime() {return time;}public void setTime(String time) {this.time = time;}public String getRemark() {return remark;}public void setRemark(String remark) {this.remark = remark;}}
第五步： 配置好所需要的参数后们就可以进行 配置推送模板消息
import com.alibaba.fastjson.JSON;import com.alibaba.fastjson.JSONArray;import com.alibaba.fastjson.JSONObject;import org.springframework.http.ResponseEntity;import org.springframework.web.bind.annotation.GetMapping;import org.springframework.web.bind.annotation.PostMapping;import org.springframework.web.bind.annotation.RestController;import org.springframework.web.client.RestTemplate;import java.text.DateFormat;import java.text.SimpleDateFormat;import java.util.*;/*** 发送模板消息*/@RestControllerpublic class PushWxMessage {/** 微信测试账号 批量 循环推送 模板消息*/@PostMapping("/weChatPush")public String weChatPush() {try {List<String> ls = getOpenId(getAccessToken());for (int i=0;i<ls.size();i++){System.out.println(ls.get(i));push(ls.get(i),"","");}return ("推送成功");}catch (Exception e){e.printStackTrace();return ("推送失败");}}/** 微信测试账号 发送模板消息*/@PostMapping("/push")public Object push(String openid, String template_id, String jumpurl) {RestTemplate restTemplate = new RestTemplate();//为了简单测试 这里每次都获取最新的access_token（在实际开发中，应该在 access_token 快过期时再重新获取）String url = "https://api./cgi-bin/message/template/send?access_token=" + getAccessToken();//推送的模版 （目前为了简单测试 很多参数都写死,固定了,但也可以根据需要动态传入参数）WxTemplate wxTe = new WxTemplate();wxTe.setTouser(openid);//用户的openid（接收人，这里应该传进来的）wxTe.setTemplate_id("你拿到的 模板id");//订阅消息模板idwxTe.setUrl("");//跳转链接//日期格式定义 转换DateFormat dateformat = new SimpleDateFormat("yyyy-MM-dd HH:mm");String dateString = dateformat.format(new Date());Map<String, TemplateData> m = new HashMap<>();m.put("title", new TemplateData("测试推送：收费通知！","#F7A36F"));m.put("content", new TemplateData("即将要欠费，你要交钱了！","#79CCE9"));m.put("time", new TemplateData(dateString,"#79CCE9"));m.put("remark", new TemplateData("多交点！少费事！","#FF0000"));wxTe.setData(m);ResponseEntity<String> responseEntity = restTemplate.postForEntity(url, wxTe, String.class);return JSON.parseObject(responseEntity.getBody());}/** 获取 access_token（接口调用凭据）*/@GetMapping("/getAccessToken")public String getAccessToken() {RestTemplate restTemplate = new RestTemplate();Map<String, String> params = new HashMap<>();params.put("APPID", "你拿到的 appid"); //params.put("APPSECRET", "你拿到的 appsecret"); //ResponseEntity<String> responseEntity = restTemplate.getForEntity("https://api./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;}/** 获取 openid（关注者列表）*/@GetMapping("/getOpenId")public List<String> getOpenId(String access_token) {RestTemplate restTemplate = new RestTemplate();Map<String, String> params = new HashMap<>();params.put("access_token", access_token); //ResponseEntity<String> responseEntity = restTemplate.getForEntity("https://api./cgi-bin/user/get?access_token={access_token}", String.class, params);String body = responseEntity.getBody();// 解析成JSONObject 并获取（叫data的JSON对象）JSONObjectJSONObject object = JSON.parseObject(body).getJSONObject("data");// 获取 JSONObject 中的 JSONArrayJSONArray array = object.getJSONArray("openid");System.out.println("array"+array);// JSONArray 转成 List<Strig> 集合（注意 alibaba 的fastjson 1.2.23以下的版本 和 1.2.3 的版本不包含 toJavaList()方法 ）List<String> lists = array.toJavaList(String.class);System.out.println(lists.get(0));return lists;}}
了解一下，拼接JSON串
像以下的格式，简单理解一下，其实就是 一个大的对象里 套了一个叫 data 的对象，然后又套了(title,content,time,remark)几个同级的对象 ； 一共三个层级 组成json串。
{"touser":"接收人 OPENID","template_id":"模板ID","url":"","data":{"title":{"value":"标题","color":"#282A36"},"content":{"value":"内容","color":"#02ABE4"},"time":{"value":"时间","color":"#02ABE4"},"remark":{"value":"备注","color":"#02ABE4"}}}
在这里就不用代码进行拼接了，直接用 postman 传json格式（其实和下面注释掉的 一片代码差不多，三层 逐层追加）
/** 发送模板消息*/@PostMapping("/jsonpush")public Object jsonpush(@RequestBody Map<String, Object> map) {System.out.println(map);RestTemplate restTemplate = new RestTemplate();//为了简单测试 这里每次都获取最新的access_token（在实际开发中，应该在 access_token 快过期时再重新获取）String url = "https://api./cgi-bin/message/template/send?access_token=" + getAccessToken();// //日期格式定义 转换// DateFormat dateformat = new SimpleDateFormat("yyyy-MM-dd HH:mm");// String dateString = dateformat.format(new Date());//当前时间//// //也可以定义为 JSONObject 类型来进行追加// Map<String, Object> data = (Map<String, Object>) map.get("data");// 获取data对象 转为Map集合// Map<String, String> time = new HashMap<String, String>();// 定义一个叫time的Map集合// //逐层追加// time.put("value",dateString);// time.put("color","#02ABE4");// data.put("time",time);// map.put("data",data);ResponseEntity<String> responseEntity = restTemplate.postForEntity(url, map, String.class);return JSON.parseObject(responseEntity.getBody());}
总结：
这一套流程走下来，比较简单的模板消息推送就能完成了。
在上面为了简单 我们把推送的相关方法和接口都写在一块了，这样不能说是有错但有点不够规范 严谨。我们其实可以把相关方法拿出来进行封装一下，接口再调用封装的方法；面向对象的三大原则相信就不用多说了。
在上面有一个微信消息模版 MeTemplate 类 暂时没用到，在传参赋值或获取参数值时 可以调用其中相关get set 方法。
还有一个问题 在上面获取 access_token 会有一个expires_in（过期时间）在这里我们可以用Redis来进行定期获取。
