Java实现 微信小程序 + 消息推送

时间:2024-02-18 20:30:39

 

 实现效果:

 

下面要显示五个字段

 

接下来,参照官方文档,一步步实现:

https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/template-message/templateMessage.send.html

 

一、官方给出请求示例、返回示例

 

 

 

二、根据上面编写实体类

 (1)请求参数

@Data
public class SendTemplateReq {
    /**
     * 接收者(用户)的 openid
     */
    private String touser;
    /**
     * 所需下发的模板消息的id
     */
    private String template_id;
    /**
     * 点击模板卡片后的跳转页面,仅限本小程序内的页面。支持带参数,(示例index?foo=bar)。
     * 该字段不填则模板无跳转。
     */
    private String page;
    /**
     * 表单提交场景下,为 submit 事件带上的 formId;支付场景下,为本次支付的 prepay_id
     */
    private String form_id;
    /**
     * 模板内容
     * 不填则下发空模板。具体格式请参考示例。
     */
    private DoctorReplyMsgData data;

    /**
     * 模板需要放大的关键词
     * 不填则默认无放大
     */
    private String emphasis_keyword;
}

  

(2)请求参数中的data,如实现效果所示,这是在小程序显示的五个字段.

(属性名就要叫keyword1、2、3,否则推送的消息空白)

@Data
public class DoctorReplyMsgData {
   
    private KeyNote keyword1;
 
    private KeyNote keyword2;
 
    private KeyNote keyword3;
 
    private KeyNote keyword4;
  
    private KeyNote keyword5;
}

 

(3)上面五个字段对应的值(data是对象,所以需要这样)

@Data
public class KeyNote {
    private String value;

}

  

(4)请求后,微信返回的消息体

 

@Data
public class SendTemplateResponse {
    /**
     * 错误码
     * 0 ok
     * 40037 template_id不正确
     * 41028 form_id不正确,或者过期
     * 41029 form_id已被使用
     * 41030 page不正确
     * 45009 接口调用超过限额(目前默认每个帐号日调用限额为100万)
     */
    private int errcode;
    /**
     * 错误信息
     */
    private String errmsg;
}

 

 

 

 

三、实现代码

 

public void sendTemplate() {

    SendTemplateReq sendTemplateReq = new SendTemplateReq();

    //1、用户的 openid
    sendTemplateReq.setTouser("openid");
    
    //2、模板消息的id
    sendTemplateReq.setTemplate_id("小程序启用模板的模板id");
    
    //3、formid
    sendTemplateReq.setForm_id("小程序传给后台的formid,七天有效");
    
    //4、点击模板跳转页面
    sendTemplateReq.setPage("");
    
    //5、Data,按次序,只能叫keyword1、2、3
    DoctorReplyMsgData replyData = new DoctorReplyMsgData();
    KeyNote keyword1 = new KeyNote();
    keyword1.setValue("小程序显示的消息字段1");
    replyData.setKeyword1(keyword1);
    KeyNote keyword2 = new KeyNote();
    keyword2.setValue("小程序显示的消息字段2");
    replyData.setKeyword2(keyword2);
    sendTemplateReq.setData(replyData);
    //如上...总共五个字段
    
    //6、获取token
    String token = "token,俩小时有效";
    
    //7、模板url拼接上token,最上面的请求的url那样
    String url = "TemplateUrl" + "token";
    //8、请求体转为json
    String reqStr=JsonUtil.ModelToGson(sendTemplateReq);
    
    //9、发送httpclient请求
    String resultStr = httpRequestUtil.doPost(sb.toString(), reqStr);
    
    //10、接收返回的消息体:是否成功,成功返回0
    SendTemplateResponse sendTemplateResponse = (SendTemplateResponse)JsonUtil.GsonToModel(resultStr,SendTemplateResponse.class);
    if(sendTemplateResponse.getErrcode() == 0){
        //"推送成功!"
    }
}

 

1、openid:通过jsCode获取的

2、formid:小程序端传过来的

3、Template_id:小程序设置模板时带的

4、data:对象类型

5、token:调用接口获取token