最近需要开发微信和小程序的推送功能，需要用java后台实现推送，自己本身java和小程序都做，所以就自己动手实现下小程序的模版推送功能推送。
实现思路
- 1 小程序获取用户openid，收集formid传给java后台
- 2 java推送消息给指定小程序用户
老规矩，还是先看效果图
下面开始讲解实现步骤
一，微信小程序管理后台开通模版推送
二，java后台实现推送所需字段
- 1 看微信官方推送消息所需要的字段
- 2 有了官方说明，我门接下来就去拿到官方所需要的这些字段，来组装请求数据就可以了。
三，下面讲解实现步骤
我的java后台是基于springboot开发的，如果你不了解spring boot，建议你先去了解下springboot再回来接着学习。 还有RestTemplate是我们java后台做get和post请求必须的，我们和微信服务器交互就用的RestTemplate
- 1 首先根据官方推送所需字段组装java-bean 这里用到两个javabean
/*
* 小程序推送所需数据
* qcl 微信：2501902696
* */
@Data
public class WxMssVo {
private String touser;//用户openid
private String template_id;//模版id
private String page = "index";//默认跳到小程序首页
private String form_id;//收集到的用户formid
private String emphasis_keyword = "keyword1.DATA";//放大那个推送字段
private Map<String, TemplateData> data;//推送文字
}
复制代码/*
* 设置推送的文字和颜色
* qcl 微信：2501902696
* */
@Data
public class TemplateData {
//keyword1：订单类型，keyword2：下单金额，keyword3：配送地址，keyword4：取件地址，keyword5备注
private String value;//,,依次排下去
// private String color;//字段颜色（微信官方已废弃，设置没有效果）
}
复制代码到这里请求推送的数据就组装好了，解下来我们去实现推送功能。 奥不对，还有一个重要的字段需要获取到：access_token
access_token的获取
/*
* 获取access_token
* appid和appsecret到小程序后台获取，当然也可以让小程序开发人员给你传过来
* */
public String getAccess_token(String appid, String appsecret) {
//获取access_token
String url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential" +
"&appid=" + appid + "&secret=" + appsecret;
String json = restTemplate.getForObject(url, String.class);
AccessToken accessToken = new Gson().fromJson(json, AccessToken.class);
return accessToken.getAccess_token();
}
复制代码这次是真正的可以来请求微信服务器来实现消息推送了
/*
* 微信小程序推送单个用户
* */
public String pushOneUser(String openid, String formid) {
//获取access_token
String access_token = getAccess_token(ConstantUtils.SCHOOL_APPID, ConstantUtils.SCHOOL_APPSECRET);
String url = "https://api.weixin.qq.com/cgi-bin/message/wxopen/template/send" +
"?access_token=" + access_token;
//拼接推送的模版
WxMssVo wxMssVo = new WxMssVo();
wxMssVo.setTouser(openid);//用户openid
wxMssVo.setTemplate_id("LzeDP0G5PLgHoOjCMfhu44wfUluhW11Zeezu3r_dC24");//模版id
wxMssVo.setForm_id(formid);//formid
Map<String, TemplateData> m = new HashMap<>(5);
//keyword1：订单类型，keyword2：下单金额，keyword3：配送地址，keyword4：取件地址，keyword5备注
TemplateData keyword1 = new TemplateData();
keyword1.setValue("新下单待抢单");
m.put("keyword1", keyword1);
TemplateData keyword2 = new TemplateData();
keyword2.setValue("这里填下单金额的值");
m.put("keyword2", keyword2);
wxMssVo.setData(m);
TemplateData keyword3 = new TemplateData();
keyword3.setValue("这里填配送地址");
m.put("keyword3", keyword3);
wxMssVo.setData(m);
TemplateData keyword4 = new TemplateData();
keyword4.setValue("这里填取件地址");
m.put("keyword4", keyword4);
wxMssVo.setData(m);
TemplateData keyword5 = new TemplateData();
keyword5.setValue("这里填备注");
m.put("keyword5", keyword5);
wxMssVo.setData(m);
ResponseEntity<String> responseEntity =
restTemplate.postForEntity(url, wxMssVo, String.class);
log.error("小程序推送结果={}", responseEntity.getBody());
return responseEntity.getBody();
}
复制代码openid可以让小程序开发人员给你传过来，也可以自己获取。 formid需要小程序开发给你传过来，你也可以把formid存到数据库里，什么时候需要直接拿出来用就可以了。 注意：formid必须和用户openid对应。
下面贴出来完整代码
package com.qcl.paotuischool.wechat;
import com.google.gson.Gson;
import com.qcl.userwechat.bean.AccessToken;
import com.qcl.utils.ConstantUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity;
import org.springframework.stereotype.Service;
import org.springframework.web.client.RestTemplate;
import java.util.HashMap;
import java.util.Map;
import lombok.extern.slf4j.Slf4j;
/**
* Created by qcl on 2018/9/11.
* 微信小程序推送服务，
* 包含获取access_token的服务
*/
@Service
@Slf4j
public class WxPushServiceQcl {
//用来请求微信的get和post
@Autowired
private RestTemplate restTemplate;
/*
* 微信小程序推送单个用户
* */
public String pushOneUser(String openid, String formid) {
//获取access_token
String access_token = getAccess_token(ConstantUtils.SCHOOL_APPID, ConstantUtils.SCHOOL_APPSECRET);
String url = "https://api.weixin.qq.com/cgi-bin/message/wxopen/template/send" +
"?access_token=" + access_token;
//拼接推送的模版
WxMssVo wxMssVo = new WxMssVo();
wxMssVo.setTouser(openid);//用户openid
wxMssVo.setTemplate_id("LzeDP0G5PLgHoOjCMfhu44wfUluhW11Zeezu3r_dC24");//模版id
wxMssVo.setForm_id(formid);//formid
Map<String, TemplateData> m = new HashMap<>(5);
//keyword1：订单类型，keyword2：下单金额，keyword3：配送地址，keyword4：取件地址，keyword5备注
TemplateData keyword1 = new TemplateData();
keyword1.setValue("新下单待抢单");
m.put("keyword1", keyword1);
TemplateData keyword2 = new TemplateData();
keyword2.setValue("这里填下单金额的值");
m.put("keyword2", keyword2);
wxMssVo.setData(m);
TemplateData keyword3 = new TemplateData();
keyword3.setValue("这里填配送地址");
m.put("keyword3", keyword3);
wxMssVo.setData(m);
TemplateData keyword4 = new TemplateData();
keyword4.setValue("这里填取件地址");
m.put("keyword4", keyword4);
wxMssVo.setData(m);
TemplateData keyword5 = new TemplateData();
keyword5.setValue("这里填备注");
m.put("keyword5", keyword5);
wxMssVo.setData(m);
ResponseEntity<String> responseEntity =
restTemplate.postForEntity(url, wxMssVo, String.class);
log.error("小程序推送结果={}", responseEntity.getBody());
return responseEntity.getBody();
}
/*
* 获取access_token
* appid和appsecret到小程序后台获取，当然也可以让小程序开发人员给你传过来
* */
public String getAccess_token(String appid, String appsecret) {
//获取access_token
String url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential" +
"&appid=" + appid + "&secret=" + appsecret;
String json = restTemplate.getForObject(url, String.class);
AccessToken accessToken = new Gson().fromJson(json, AccessToken.class);
return accessToken.getAccess_token();
}
}
复制代码在需要做推送的地方调用WxPushServiceQcl类中的pushOneUser方法，并传入openid, formid参数即可。
下面来讲小程序端开发需要做些什么
可以看出，我们的formid有效期是7天，并且一个form_id只能使用一次，所以我们小程序端所需要做的就是尽可能的多拿些formid，然后传个后台，让后台存到数据库中，这样7天有效期内，想怎么用就怎么用了。
所以接下来要讲的就是小程序开发怎么尽可能多的拿到formid了。
<form report-submit='true' >
<button form-type='submit'>获取formid</button>
</form>
复制代码所以我们就要在这里下功夫了，既然只能在form组件获取，我们能不能把我们小程序里用到最多的地方用form来伪装呢。
<view class='button_item'>
<form class="form_item" bindsubmit='gorRunnerLobby' report-submit='true' data-type="1">
<button class="button" form-type='submit'>
<text>抢单大厅</text>
<text class='runner_desc'>(兼职也可月入万元)</text>
</button>
</form>
<view class='right_arrow' />
</view>
复制代码这样就可以在用户点击条目时，收集到用户formid了
.button_item {
width: 100%;
display: flex;
flex-direction: row;
align-items: center;
padding: 2px 20px;
background: white;
border-bottom: 1px solid gainsboro;
}
/* 主要通过这里去除botton默认样式 */
.button {
width: 100%;
background: white;
border: none;
text-align: left;
padding: 6px 0px;
margin: 0px;
line-height: 1.5;
}
/* 主要通过这里去除botton边框 */
.button::after {
border: none;
}
/* 用button伪装获取formid */
.form_item {
width: 100%;
}
复制代码到这里我们小程序端也圆满完成自己的任务了。
补充知识点
这样我们java后台和小程序开发就可以开开心心的完成微信小程序的消息推送功能了。
