天天看点

java版微信公众平台开发java版微信公众平台开发

java版微信公众平台开发

1、找到AppId和AppSecret。自定义菜单申请成功后,在“高级功能”-“开发模式”-“接口配置信息”的最后两项就是;

java版微信公众平台开发java版微信公众平台开发

2、根据AppId和AppSecret,以https get方式获取访问特殊接口所必须的凭证access_token;

3、根据access_token,将json格式的菜单数据通过https post方式提交。

java版微信公众平台开发java版微信公众平台开发

分析创建菜单的难点

原来创建菜单这么简单,三步就能搞定?跟把大象放冰箱差不多。呵呵,当然没有这么简单,那我们一步步来看,到底难在哪里?

首先,第1步肯定都没有问题,只要成功申请了自定义菜单,一定能拿到AppId和AppSecret这两个值。

再来看第2步,由于是get方式获取access_token,很多人直接把拼好的url放在浏览器里执行,access_token就拿到了。抛开是不是用编程方式实现的来说,这真是个好办法,显然大家在第二步上也没有问题。

最后再看第3步,拼装json格式的菜单数据,虽然繁锁一点,但基本上也都没有什么问题的,因为官方给了个例子,照猫画虎就行了。那问题一定就出现在https post提交上了。

结论:不知道如何创建自定义菜单的朋友,大都可以归为以下三种情况:

1)根本不看或者没看懂公众平台API文档中关于“通用接口”、“自定义菜单接口”和“使用限制”部分的说明;

2)不知道如何发起HTTPS请求(平时的http请求,直接使用HttpUrlConnection就可以轻松搞定,但https请求要复杂一点);

3)不知道如何通过POST方式提交json格式的菜单数据。

正在看文章的你,不知道是属于哪一种,或者几种情况都有,不妨留言说出来,也可以做个调查。不管属于哪一种情况,既然看到了这篇文章,相信一定会让你弄明白的。

链接中有三个参数,分别是grant_type、appid和secret。根据图中的参数说明,grant_type传固定值client_credential,而appid和secret就是申请完自定义菜单后微信分配给我们的。

请求发送成功后,微信服务器会返回一个json串,包含access_token和expires_in两个元素。其中,access_token就是我们最终需要的凭证,而expires_in是凭证的有效期,单位是秒,7200秒也就是2个小时。这就意味着,不是每次访问特殊接口,都需要重新获取一次access_token,只要access_token还在有效期内,就一直可以使用。

其实就是向地址https://api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN以POST方式提交一个JSON格式的菜单字符串。

后面,关于参数说明的部分我就不一一贴图说明了,把重点说一下:

1)自定义菜单是一个3x5结构的,即菜单最多只能有二级,一级菜单最多只能有3个,每个一级菜单下最多可以有5个二级菜单项;

2)菜单项都有一个key值。当用户点击某个菜单项时,微信会将该菜单项的key值以事件推送的方式发送给我们的后台处理程序。

关于菜单的查询、创建我就不提了,这两个接口使用的频率非常小,一般都用不上。如果需要,再按照我上面提供的思路也不难理解。

封装通用的请求方法

读到这里,就默认大家已经掌握了上面讲到的所有关于自定义菜单的理论知识,下面就进入代码实战讲解的部分。

先前我们了解到,创建菜单需要调用二个接口,并且都是https请求,而非http。如果要封装一个通用的请求方法,该方法至少需要具备以下能力:

1)支持HTTPS请求;

2)支持GET、POST两种方式;

3)支持参数提交,也支持无参数的情况;

对于https请求,我们需要一个证书信任管理器,这个管理器类需要自己定义,但需要实现X509TrustManager接口,代码如下:

import java.security.cert.CertificateException;  

import java.security.cert.X509Certificate;  

import javax.net.ssl.X509TrustManager;  

publicclass MyX509TrustManager implements X509TrustManager {  

publicvoid checkClientTrusted(X509Certificate[] chain, String authType) throws CertificateException {  

    }  

publicvoid checkServerTrusted(X509Certificate[] chain, String authType) throws CertificateException {  

    }  

public X509Certificate[] getAcceptedIssuers() {  

returnnull;  

    }  

}  

这个证书管理器的作用就是让它信任我们指定的证书,上面的代码意味着信任所有证书,不管是否权威机构颁发。

证书有了,通用的https请求方法就不难实现了,实现代码如下:

import java.io.BufferedReader;  

import java.io.InputStream;  

import java.io.InputStreamReader;  

import java.io.OutputStream;  

import java.net.ConnectException;  

import java.net.URL;  

import javax.net.ssl.HttpsURLConnection;  

import javax.net.ssl.SSLContext;  

import javax.net.ssl.SSLSocketFactory;  

import javax.net.ssl.TrustManager;  

import net.sf.json.JSONObject;  

import org.slf4j.Logger;  

import org.slf4j.LoggerFactory;  

publicclass WeixinUtil {  

privatestatic Logger log = LoggerFactory.getLogger(WeixinUtil.class);  

publicstatic 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();  

            jsonObject = JSONObject.fromObject(buffer.toString());  

        } catch (ConnectException ce) {  

            log.error("Weixin server connection timed out.");  

        } catch (Exception e) {  

            log.error("https request error:{}", e);  

        }  

return jsonObject;  

    }  

}  

Pojo类的封装

在获取凭证创建菜单前,我们还需要封装一些pojo,这会让我们的代码更美观,有条理。

首先是调用获取凭证接口后,微信服务器会返回json格式的数据:{"access_token":"ACCESS_TOKEN","expires_in":7200},我们将其封装为一个AccessToken对象,对象有二个属性:token和expiresIn,代码如下:

publicclass AccessToken {  

// 获取到的凭证

private String token;  

// 凭证有效时间,单位:秒

privateint expiresIn;  

public String getToken() {  

return token;  

    }  

publicvoid setToken(String token) {  

this.token = token;  

    }  

publicint getExpiresIn() {  

return expiresIn;  

    }  

publicvoid setExpiresIn(int expiresIn) {  

this.expiresIn = expiresIn;  

    }  

}  

接下来是对菜单结构的封装。因为我们是采用面向对象的编程方式,最终提交的json格式菜单数据就应该是由对象直接转换得到,而不是在程序代码中拼一大堆json数据。菜单结构封装的依据是公众平台API文档中给出的那一段json格式的菜单结构,如下所示:

[java]view plaincopy

{  

"button":[  

    {     

"type":"click",  

"name":"今日歌曲",  

"key":"V1001_TODAY_MUSIC"

     },  

     {  

"type":"click",  

"name":"歌手简介",  

"key":"V1001_TODAY_SINGER"

     },  

     {  

"name":"菜单",  

"sub_button":[  

           {  

"type":"click",  

"name":"hello word",  

"key":"V1001_HELLO_WORLD"

           },  

           {  

"type":"click",  

"name":"赞一下我们",  

"key":"V1001_GOOD"

           }]  

      }]