微信平台开发.docx
- 文档编号:12834389
- 上传时间:2023-06-08
- 格式:DOCX
- 页数:17
- 大小:1.24MB
微信平台开发.docx
《微信平台开发.docx》由会员分享,可在线阅读,更多相关《微信平台开发.docx(17页珍藏版)》请在冰点文库上搜索。
微信平台开发
java版微信公众平台开发
∙浏览:
7725
∙|
∙更新:
2013-12-3110:
40
∙|
∙标签:
java
自定义菜单的创建步骤
1、找到AppId和AppSecret。
自定义菜单申请成功后,在“高级功能”-“开发模式”-“接口配置信息”的最后两项就是;
2、根据AppId和AppSecret,以httpsget方式获取访问特殊接口所必须的凭证access_token;
3、根据access_token,将json格式的菜单数据通过httpspost方式提交。
分析创建菜单的难点
原来创建菜单这么简单,三步就能搞定?
跟把大象放冰箱差不多。
呵呵,当然没有这么简单,那我们一步步来看,到底难在哪里?
首先,第1步肯定都没有问题,只要成功申请了自定义菜单,一定能拿到AppId和AppSecret这两个值。
再来看第2步,由于是get方式获取access_token,很多人直接把拼好的url放在浏览器里执行,access_token就拿到了。
抛开是不是用编程方式实现的来说,这真是个好办法,显然大家在第二步上也没有问题。
最后再看第3步,拼装json格式的菜单数据,虽然繁锁一点,但基本上也都没有什么问题的,因为官方给了个例子,照猫画虎就行了。
那问题一定就出现在httpspost提交上了。
结论:
不知道如何创建自定义菜单的朋友,大都可以归为以下三种情况:
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还在有效期内,就一直可以使用。
其实就是向地址
后面,关于参数说明的部分我就不一一贴图说明了,把重点说一下:
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 .ssl.X509TrustManager;
/**
* 证书信任管理器(用于https请求)
*
* @author liufeng
* @date 2013-08-08
*/
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 .ConnectException;
import .URL;
import .ssl.HttpsURLConnection;
import .ssl.SSLContext;
import .ssl.SSLSocketFactory;
import .ssl.TrustManager;
import net.sf.json.JSONObject;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
* 公众平台通用接口工具类
*
* @author liuyq
* @date 2013-08-09
*/
publicclass WeixinUtil {
privatestatic Logger log = LoggerFactory.getLogger(WeixinUtil.class);
/**
* 发起https请求并获取结果
*
* @param requestUrl 请求地址
* @param requestMethod 请求方式(GET、POST)
* @param outputStr 提交的数据
* @return JSONObject(通过JSONObject.get(key)的方式获取json对象的属性值)
*/
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,代码如下:
/**
* 微信通用接口凭证
*
* @author liufeng
* @date 2013-08-08
*/
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]viewplaincopy
{
"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"
}]
}]
}
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 平台 开发