Java后端发送微信公众号模版消息自创建公用类

103 阅读 0 评论 68 点赞

我是靠谱客的博主魔幻萝莉，最近开发中收集的这篇文章主要介绍Java后端发送微信公众号模版消息自创建公用类，觉得挺不错的，现在分享给大家，希望可以做个参考。

概述

微信公众号模版消息

肯定很多人都被微信的开放平台折磨，我也一样无一例外，也是根据公司的业务踩的坑，后来花时间研究了几个小时算是搞明白了。

下边不多说直接上详细说明和demo

首先打开微信开发平台

微信开放平台地址：

https://open.weixin.qq.com/

然后去查看发送模版消息微信提供的接口
在这里插入图片描述
调用微信的接口地址：

http请求方式: POST https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=ACCESS_TOKEN

Access_Token 的获取方式我会在后期的文章中说明以及获取微信用户的OpenId

数据结构

这里可以查看到微信所提供的接口地址和传参结构，可以发现巨恶心人。。。。

首先先了解数据结构

 {
           "touser":"OPENID",
           "template_id":"ngqIpbwh8bUfcSsECmogfXcV14J0tQlEpBO27izEYtY",
           "url":"http://weixin.qq.com/download",  
           "miniprogram":{
             "appid":"xiaochengxuappid12345",
             "pagepath":"index?foo=bar"
           },          
           "data":{
                   "first": {
                       "value":"恭喜你购买成功！",
                       "color":"#173177"
                   },
                   "keyword1":{
                       "value":"巧克力",
                       "color":"#173177"
                   },
                   "keyword2": {
                       "value":"39.8元",
                       "color":"#173177"
                   },
                   "keyword3": {
                       "value":"2014年9月22日",
                       "color":"#173177"
                   },
                   "remark":{
                       "value":"欢迎再次购买！",
                       "color":"#173177"
                   }
           }
       }

注意：
逐一去了解下每个字短是干什么的，这个一定要了解，包括传参时候一点要保证一摸一样

结构说明

在这里插入图片描述

还有一个比较重要的就是微信放回的结构包体：

 {
    "errcode":0,
     "errmsg":"ok",
     "msgid":200228332
  }

我会在下边把微信的错误状态码附上

接下来就改上代码了，我是写了一个公用的微信调用方法，可以直接拿走

package com.util;

import com.alibaba.fastjson.JSONObject;

import org.apache.commons.lang.StringUtils;
import org.apache.log4j.Logger;
import org.springframework.web.bind.annotation.RequestParam;

/**
 * @author: LIJia
 * @date: 2021-09-17 16:28
 **/


public class WeChetUtil {



    private static Logger logger = Logger.getLogger(WeChetUtil.class);

    public JSONObject WeChetTemp(String accessToken,String openId,String tempId,String url,String first, 
    							 String keyWord1,
                                 String keyWord2,
                                 String keyWord3,
                                 String keyWord4,
                                 String remark){

        JSONObject jsonExternal = new JSONObject();
        jsonExternal.put("url",url);
        jsonExternal.put("touser",openId);
        jsonExternal.put("template_id",tempId);


        JSONObject jsonFirst =new JSONObject();
        JSONObject keyword1 =new JSONObject();
        JSONObject keyword2 =new JSONObject();
        JSONObject keyword3 =new JSONObject();
        JSONObject keyword4 =new JSONObject();
        JSONObject jsonRemark =new JSONObject();

//        构建模版发送包体内容
        jsonFirst.put("value",first);
//		这几个极端根据业务的需求做了非空的判定，
        keyword1.put("value",keyWord1);
        keyword2.put("value",keyWord2);
        keyword3.put("value",keyWord3);
        keyword4.put("value",keyWord4);
        jsonRemark.put("value",remark);

        JSONObject jsonData =new JSONObject();
        jsonData.put("first",jsonFirst);
        jsonData.put("keyword1",keyword1);
        jsonData.put("keyword2",keyword2);
        jsonData.put("keyword3",keyword3);
        jsonData.put("keyword4",keyword4);
        jsonData.put("remark",jsonRemark);
        jsonExternal.put("data",jsonData);
        System.out.println(jsonExternal);
		// 调用微信模版消息发送的 url 地址
        String urlAccessToken = String.from("https://xxxxx?accountToken",accountToken);
        // 发起 Http 请求 可以选择使用 apache 的 httpClient jar 中的公用方法
        JSONObject res =  HttpClientUtil.postJson(jsonExternal, urlAccessToken);
        if(res.getInteger("errcode") == 0){
            return ResponseUtil.success();
        }else{
            logger.info("fail to send msg: " + JSONObject.toJSONString(res));
            return ResponseUtil.failMsg("fail to send msg: " + JSONObject.toJSONString(res));
        }
    }

}

这里边写的比较粗潮特别是数据j结构体但是有另外一种的方式


//		JSONObject jsonFirst =new JSONObject();
//        JSONObject keyword1 =new JSONObject();
//        JSONObject keyword2 =new JSONObject();
//        JSONObject keyword3 =new JSONObject();
//        JSONObject keyword4 =new JSONObject();
//        JSONObject jsonRemark =new JSONObject();
//		  jsonData.put("first",jsonFirst);
//        jsonData.put("keyword1",keyword1);
//        jsonData.put("keyword2",keyword2);
//        jsonData.put("keyword3",keyword3);
//        jsonData.put("keyword4",keyword4);
//        jsonData.put("remark",jsonRemark);


                String[] tempkey = {"first","keyword1","keyword2","keyword3","keyword4","remark"};
                String[] tempValue = {first,keyword1,keyword2,keyword3,keyword4,remark};