微信公众号开发发送模版信息

前言：

微信开发往往有订阅号，公众号，企业号，而且都是要有认证才有各种权限，很麻烦。点击微信工作平台登录。但是作为学习用途，微信提供了微信公众号平台测试号，直接微信扫一扫就可以用了。查看官方文档，微信号公众平台调试工具

获取access_token

access_token是公众号的全局唯一接口调用凭据，公众号调用各接口时都需使用access_token。开发者需要进行妥善保存。access_token的存储至少要保留512个字符空间。access_token的有效期目前为2个小时，需定时刷新，重复获取将导致上次获取的access_token失效。

access_token的获取应该是服务器统一获取，全局使用。Access_token的有效时间可能会在未来有调整，所以中控服务器不仅需要内部定时主动刷新，还需要提供被动刷新access_token的接口，这样便于业务服务器在API调用获知access_token已超时的情况下，可以触发access_token的刷新流程。

核心代码：

public class WeixinUtil {
//  private static Logger log = LoggerFactory.getLogger(WeixinUtil.class);  
    // 获取access_token的接口地址（GET） 限200（次/天）  
    public final static String access_token_url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET";  
    // 菜单创建（POST） 限100（次/天）  
    public static String menu_create_url = "https://api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN";  
    /** 
     * 发起https请求并获取结果 
     *  
     * @param requestUrl 请求地址 
     * @param requestMethod 请求方式（GET、POST） 
     * @param outputStr 提交的数据 
     * @return JSONObject(通过JSONObject.get(key)的方式获取json对象的属性值) 
     */  
    public static JSONObject httpRequest(String requestUrl, String requestMethod, String outputStr) {  
        JSONObject jsonObject = null;  
        StringBuffer buffer = new StringBuffer();  
        try {  
            // 创建SSLContext对象，并使用我们指定的信任管理器初始化  
            TrustManager[] tm = { new MyX509TrustManager() };  
            SSLContext sslContext = SSLContext.getInstance("SSL", "SunJSSE");  
            sslContext.init(null, tm, new java.security.SecureRandom());  
            // 从上述SSLContext对象中得到SSLSocketFactory对象  
            SSLSocketFactory ssf = sslContext.getSocketFactory();  

            URL url = new URL(requestUrl);  
            HttpsURLConnection httpUrlConn = (HttpsURLConnection) url.openConnection();  
            httpUrlConn.setSSLSocketFactory(ssf);  

            httpUrlConn.setDoOutput(true);  
            httpUrlConn.setDoInput(true);  
            httpUrlConn.setUseCaches(false);  
            // 设置请求方式（GET/POST）  
            httpUrlConn.setRequestMethod(requestMethod);  

            if ("GET".equalsIgnoreCase(requestMethod))  
                httpUrlConn.connect();  

            // 当有数据需要提交时  
            if (null != outputStr) {  
                OutputStream outputStream = httpUrlConn.getOutputStream();  
                // 注意编码格式，防止中文乱码  
                outputStream.write(outputStr.getBytes("UTF-8"));  
                outputStream.close();  
            }  

            // 将返回的输入流转换成字符串  
            InputStream inputStream = httpUrlConn.getInputStream();  
            InputStreamReader inputStreamReader = new InputStreamReader(inputStream, "utf-8");  
            BufferedReader bufferedReader = new BufferedReader(inputStreamReader);  

            String str = null;  
            while ((str = bufferedReader.readLine()) != null) {  
                buffer.append(str);  
            }  
            bufferedReader.close();  
            inputStreamReader.close();  
            // 释放资源  
            inputStream.close();  
            inputStream = null;  
            httpUrlConn.disconnect();  
            System.out.println(buffer.toString());
            jsonObject = JSONObject.fromObject(buffer.toString());  
        } catch (ConnectException ce) {  
            System.out.println("Weixin server connection timed out.");
        } catch (Exception e) {  
            System.err.println("https request error:{}");
//            log.error("https request error:{}", e);  
        }  
        return jsonObject;  
    }  
    /** 
     * 获取access_token 
     *  
     * @param appid 凭证 
     * @param appsecret 密钥 
     * @return 
     */  
    public static AccessToken getAccessToken(String appid, String appsecret) {  
        AccessToken accessToken = null;  

        String requestUrl = access_token_url.replace("APPID", appid).replace("APPSECRET", appsecret);  
        JSONObject jsonObject = httpRequest(requestUrl, "GET", null);  
        // 如果请求成功  
        if (null != jsonObject) {  
            try {  
                accessToken = new AccessToken();  
                accessToken.setToken(jsonObject.getString("access_token"));  
                accessToken.setExpiresIn(jsonObject.getInt("expires_in"));  
            } catch (Exception e) {  
                accessToken = null;  
                // 获取token失败  
                System.out.println("获取token失败 errcode:"+jsonObject.getInt("errcode")+"errmsg:"+jsonObject.getString("errmsg"));
//              log.error("获取token失败 errcode:{} errmsg:{}", jsonObject.getInt("errcode"), jsonObject.getString("errmsg"));  
            }  
        }  
        return accessToken;  
    }

}

编写测试：appID和appsecret可以使用接口测试号里面的即可。

public class Test {
    public static void main(String[] args) {
        AccessToken accessToken = WeixinUtil.getAccessToken(HC.appID, HC.appsecret);
        System.out.println(accessToken);
    }
}

结果：

{“access_token”:”7_nGdrfp2xkA8V6nL3ABtu5hkADqvANK0uJYzPmjmwlL9vkkUpazIJp4GGEdxmUCpYNIOUFV1AnW7JbsuMyDVQFSGQevJ-leNTZuM90AbYyneb5jz44q_uBB5kgap-Z_UEQiEwlUCe5upoZ3OtKLQhACADEJ”,”expires_in”:7200}

---

发送模版信息

在这里使用测试号发送模版信息。首先在接口测试页面指定自己的模版信息。微信公众号平台测试号。选择新增模版：

按照要求填写自己的模版信息。

其中first，keyword1等都是关键字。发送时替换发送报文里面的值就对应修改了。

创建实体对象1：TemplateData

/**
 * 模版消息
 * 
 * @author LinQin
 */
public class TemplateData {
    private String touser;
    private String template_id;
    private String url;
    private String topcolor;
    private TemplateItem data = new TemplateItem();

    public TemplateData() {
    }

    public void add(String key, String value) {
        data.put(key, new Item(value));
    }

    public void add(String key, String value, String color) {
        data.put(key, new Item(value, color));
    }
    //setter、getter省略
}   

TemplateItem:

public class TemplateItem extends HashMap<String, Item> implements Serializable {

    private static final long serialVersionUID = -3728490424738325020L;

    public TemplateItem() {
    }

    public TemplateItem(String key, Item item) {
        this.put(key, item);
    }
}

Item:

/**
 * 返回模版消息的data项
 * @author Linqin
 *
 */
public class Item {
    private Object value;
    private String color;

    public Item() {
    }

    public Item(Object value) {
        this.value = value;
    }

    public Item(Object value, String color) {
        this.value = value;
        this.color = color;
    }
    //setter、getter省略
}   

测试：

public class Test {

    public static void main(String[] args) {
        AccessToken accessToken = WeixinUtil.getAccessToken(HC.appID, HC.appsecret);
        System.out.println(accessToken);

        //发送模版信息
        TemplateData templateData=new TemplateData();
        templateData.setTemplate_id("508HKkPRMpjScIVB1Iml9zON5q9pKdbduTVCJMGIS0s");
        templateData.setTopcolor("#f23212");
        templateData.setTouser("oY6IOwQ5w-nXqMxg_3_l5Y5-wSeo");
        templateData.add("first", "first的消息");
        templateData.add("keyword1", "$255.2");
        templateData.add("keyword2","2013-06-25 12:21:06","#f23212");
        templateData.add("keyword3", "黑店", "#365545");

        String json2= JSONObject.fromObject(templateData).toString();
        System.out.println(json2);
        WeixinUtil.sendTemplateMsg(accessToken, json2);
    }
}

结果：

发送的json数据：

{
    "data" : {
        "keyword1" : {
            "color" : "",
            "value" : "$255.2"
        },
        "keyword2" : {
            "color" : "#f23212",
            "value" : "2013-06-25 12:21:06"
        },
        "first" : {
            "color" : "",
            "value" : "first的消息"
        },
        "keyword3" : {
            "color" : "#365545",
            "value" : "黑店"
        }
    },
    "template_id" : "508HKkPRMpjScIVB1Iml9zON5q9pKdbduTVCJMGIS0s",
    "topcolor" : "#f23212",
    "touser" : "oY6IOwQ5w-nXqMxg_3_l5Y5-wSeo",
    "url" : ""
}

---

1. 参考：https://www.jianshu.com/p/eb0e9c4dcdfe ↩