java微信开发API第四步 微信自定义个性化菜单实现
微信如何实现自定义个性化菜单，下面为大家介绍
一、全局说明
详细说明请参考前两篇文章。
二、本文说明
本文分为五部分：
*工具类AccessTokenUtils的封装
*自定义菜单和个性化菜单文档的阅读解析
*菜单JSON的分析以及构建对应bean
*自定义菜单的实现
*个性化菜单的实现
微信自定义菜单所有类型菜单都给出演示
本文结束会给出包括本文前四篇文章的所有演示源码
工具类AccessTokenUtils的封装
在上文中关于AccessToken的获取和定时保存已经详细介绍过，此处直接给出处理过之后封装的AccessTokenUtils，实现原理以及文档阅读不再给出。
AccessTokenUtils.java
packagecom.gist.utils;
importjava.io.File;
importjava.io.FileInputStream;
importjava.io.FileOutputStream;
importjava.io.IOException;
importjava.io.InputStreamReader;
importjava.net.URL;
importjavax.net.ssl.HttpsURLConnection;
importcom.gist.bean.Access_token;
importcom.google.gson.Gson;
/**
*@author高远</n>邮箱：wgyscsf@163.com</n>博客http://blog.csdn.net/wgyscsf</n>
*编写时期2016-4-7下午5:44:33
*/
publicclassAccessTokenUtils{
privatestaticfinallongMAX_TIME=7200*1000;//微信允许最长Access_token有效时间（ms）
privatestaticfinalStringTAG="WeixinApiTest";//TAG
privatestaticfinalStringAPPID="wx889b020b3666b0b8";//APPID
privatestaticfinalStringSECERT="6da7676bf394f0a9f15fbf06027856bb";//秘钥
/*
*该方法实现获取Access_token、保存并且只保存2小时Access_token。如果超过两个小时重新获取；如果没有超过两个小时，直接获取。该方法依赖
*：publicstaticStringgetAccessToken()；
*
*思路:将获取到的Access_token和当前时间存储到file里，
*取出时判断当前时间和存储里面的记录的时间的时间差，如果大于MAX_TIME,重新获取，并且将获取到的存储到file替换原来的内容
*，如果小于MAX_TIME，直接获取。
*/
//为了调用不抛异常，这里全部捕捉异常，代码有点长
publicstaticStringgetSavedAccess_token(){
Gsongson=newGson();//第三方jar,处理json和bean的转换
StringmAccess_token=null;//需要获取的Access_token；
FileOutputStreamfos=null;//输出流
FileInputStreamfis=null;//输入流
Filefile=newFile("temp_access_token.temp");//Access_token保存的位置
try{
//如果文件不存在，创建
if(!file.exists()){
file.createNewFile();
}
}catch(Exceptione1){
e1.printStackTrace();
}
//如果文件大小等于0，说明第一次使用，存入Access_token
if(file.length()==0){
try{
mAccess_token=getAccessToken();//获取AccessToken
Access_tokenat=newAccess_token();
at.setAccess_token(mAccess_token);
at.setExpires_in(System.currentTimeMillis()+"");//设置存入时间
Stringjson=gson.toJson(at);
fos=newFileOutputStream(file,false);//不允许追加
fos.write((json).getBytes());//将AccessToken和当前时间存入文件
fos.close();
returnmAccess_token;
}catch(Exceptione){
e.printStackTrace();
}
}else{
//读取文件内容
byte[]b=newbyte[2048];
intlen=0;
try{
fis=newFileInputStream(file);
len=fis.read(b);
}catch(IOExceptione1){
//TODOAuto-generatedcatchblock
e1.printStackTrace();
}
StringmJsonAccess_token=newString(b,0,len);//读取到的文件内容
Access_tokenaccess_token=gson.fromJson(mJsonAccess_token,
newAccess_token().getClass());
if(access_token.getExpires_in()!=null){
longsaveTime=Long.parseLong(access_token.getExpires_in());
longnowTime=System.currentTimeMillis();
longremianTime=nowTime-saveTime;
//System.out.println(TAG+"时间差："+remianTime+"ms");
if(remianTime<MAX_TIME){
Access_tokenat=gson.fromJson(mJsonAccess_token,
newAccess_token().getClass());
mAccess_token=at.getAccess_token();
returnmAccess_token;
}else{
mAccess_token=getAccessToken();
Access_tokenat=newAccess_token();
at.setAccess_token(mAccess_token);
at.setExpires_in(System.currentTimeMillis()+"");
Stringjson=gson.toJson(at);
try{
fos=newFileOutputStream(file,false);//不允许追加
fos.write((json).getBytes());
fos.close();
}catch(IOExceptione){
//TODOAuto-generatedcatchblock
e.printStackTrace();
}
returnmAccess_token;
}
}else{
returnnull;
}
}
returnmAccess_token;
}
/*
*获取微信服务器AccessToken。该部分和getAccess_token()一致，不再加注释
*/
publicstaticStringgetAccessToken(){
StringurlString="https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid="
+APPID+"&secret="+SECERT;
Stringreslut=null;
try{
URLreqURL=newURL(urlString);
HttpsURLConnectionhttpsConn=(HttpsURLConnection)reqURL
.openConnection();
InputStreamReaderisr=newInputStreamReader(
httpsConn.getInputStream());
char[]chars=newchar[1024];
reslut="";
intlen;
while((len=isr.read(chars))!=-1){
reslut+=newString(chars,0,len);
}
isr.close();
}catch(IOExceptione){
e.printStackTrace();
}
Gsongson=newGson();
Access_tokenaccess_token=gson.fromJson(reslut,
newAccess_token().getClass());
if(access_token.getAccess_token()!=null){
returnaccess_token.getAccess_token();
}else{
returnnull;
}
}
}
自定义菜单和个性化菜单文档的阅读解析
•自定义菜单
◦自定义菜单创建接口
◦自定义菜单查询接口
◦自定义菜单删除接口
◦自定义菜单事件推送
◦个性化菜单接口
◦获取公众号的菜单配置
•文档地址：http://mp.weixin.qq.com/wiki/10/0234e39a2025342c17a7d23595c6b40a.html
•官网文档给出这样解释：
*自定义菜单接口可实现多种类型按钮，如下：1、click:点击事件...;2、view:跳转事件...;3、...(关于自定义菜单)
*接口调用请求说明http请求方式：POST（请使用https协议）https://api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN(关于自定义菜单)
*click和view的请求示例{"button":[...]} (关于自定义菜单)
*参数说明...(关于自定义菜单)
*创建个性化菜单http请求方式：POST（请使用https协议）https://api.weixin.qq.com/cgi-bin/menu/addconditional?access_token=ACCESS_TOKEN(关于个性化菜单)
*请求示例：{"button":[...],"matchrule":{...}}(关于个性化菜单)
*参数说明...(关于个性化菜单)
*开发者可以通过以下条件来设置用户看到的菜单(关于个性化菜单)：
1、用户分组（开发者的业务需求可以借助用户分组来完成）
2、性别
3、手机操作系统
4、地区（用户在微信客户端设置的地区）
5、语言（用户在微信客户端设置的语言）
•理解：
◦又是熟悉的POST请求，但是，关于调用貌似说的含糊其辞，不太明白。只是知道我们需要使用“?access_token=ACCESS_TOKEN”这个参数，这个参数我们在上篇文章已经获取到了。假如我们将微信文档给的那个请求地址中“ACCESS_TOKEN”换成我们获取到的自己的ACCESS_TOKEN，访问该网址，会看到“{“errcode”:44002,”errmsg”:”emptypostdatahint:[Gdveda0984vr23]”}”。大概意思是，空的post请求数据。所以，我们要通过POST请求的形式传递参数给微信服务器，在文档下面还给出了参数的格式：{“button”:[…]}，所以，我们要按照该格式给微信服务器进行传递参数。
◦关于参数说明，我们可以看到在自定义菜单创建中有七个参数。在个性化菜单接口中除去这七个参数之外，另外多个八个参数。简单查看此部分文档，我们可以了解到这个八个参数是为了个性化菜单做匹配筛选用的。
◦现在，我们需要按照微信文档的要求构造json通过post的请求向微信服务器发送这一串json数据，json里面就包括我们创建的各种类型的按钮事件。
菜单JSON的分析以及构建对应bean
自定义菜单json分析（不包括个性化菜单）。下面这段代码是微信文档给的示例。
click和view的请求示例
{
"button":[
{
"type":"click",
"name":"今日歌曲",
"key":"V1001_TODAY_MUSIC"
},
{
"name":"菜单",
"sub_button":[
{
"type":"view",
"name":"搜索",
"url":"http://www.soso.com/"
},
{
"type":"view",
"name":"视频",
"url":"http://v.qq.com/"
},
{
"type":"click",
"name":"赞一下我们",
"key":"V1001_GOOD"
}]
}]
}
经过分析我们可以看到这串json数据分为三层：“”button”:[{…},{…}]”、“[{…},{{“name”:菜单，”sub_button”:[{},{}]}]”、“{“type”:”view”,”name:”:”视频”,”url”:”…”},{},{}”，可能看起来比较晕。
但是，如果我们能够联想起来现实中看到的微信菜单，就会好理解一点：一级:菜单（一个菜单），下包括一到三个父按钮；二级：父按钮（1~3个父按钮），下包括一到五个子按钮；三级：子按钮（1~5个子按钮）。
现在，我们可以看到json和我们理解的“菜单”可以一一对应起来了。现在重点是如何确认每一级的“级名”，在java中也就是对应的javabean对象。
同时，因为一级菜单下会有多个父按钮，所以是一个List<父菜单>的形式。父按钮下可能有多个子菜单，也是一个List<子菜单>；但是，父按钮也有可能也是一个单独的可以响应的按钮。是一个单独的父按钮对象。子按钮就是一个单独的子按钮对象。
查看关于自定义菜单的参数说明，我们可以看到按钮分为一级按钮（“button”）和二级按钮（“sub_button”）。还有一些公用的数据类型，例如：菜单响应类型（“type”）、菜单标题（“name”）、click类型的参数（“key”）、view类型的参数（“url”）、media_id类型和view_limited类型的参数（“media_id”）。
•数据抽象（没有写setter,getter）：
//按钮基类
publicclassBaseButton{
privateStringtype;
privateStringname;
privateStringkey;
privateStringurl;
privateStringmedia_id;
}
//子按钮
publicclassSonButtonextendsBaseButton{
privateStringsub_button;
}
//父按钮
publicclassFatherButtonextendsBaseButton{
privateStringbutton;//可能直接一个父按钮做响应
@SerializedName("sub_button")//为了保证Gson解析后子按钮的名字是“sub_button”，具体用法请搜索
privateList<SonButton>sonButtons;//可能有多个子按钮
}
publicclassMenu{
@SerializedName("button")
privateList<FatherButton>fatherButtons;
}
以上是完整的自定义菜单的分析以及对应javabean的构建。
对于个性化菜单，如果查看该部分的文档，会发现和自定义菜单大致相同，只是多个一个“配置”的json,格式是这样的：{“button”:[…],”matchrule”:{…}}。
我们发现，“匹配”这段json和“button”是同级的，分析和实现和上面基本等同，直接给出实现的javabean。
//匹配的json对应的json
publicclassMatchRule{
privateStringgroup_id;
privateStringsex;
privateStringclient_platform_type;
privateStringcountry;
privateStringprovince;
privateStringcity;
privateStringlanguage;
}
//修改Menu.java
publicclassMenu{
@SerializedName("button")
privateList<FatherButton>fatherButtons;
privateMatchRulematchrule;
}
自定义菜单的实现
任务，我们实现所有微信按钮响应类型：
任务（注释：“m-0”表示父按钮；“m-n”表示第m个父按钮，第n个子按钮（m,n≠0））：1-0：名字：click，响应点击事件：点击推事件 。2-0：名字:父按钮2。2-1：名字：view,响应事件：跳转网页；2-2：名字：scancode_push，响应事件：扫码推事件；2-3：名字：scancode_waitmsg，响应事件：扫码推事件且弹出“消息接收中”提示框；2-4：名字：pic_sysphoto，响应事件
：弹出系统拍照发图。2-5：名字：pic_photo_or_album，响应事件：弹出拍照或者相册发图。3-0：名字:父按钮3。3-1：名字
：pic_weixin,响应事件：弹出微信相册发图器；3-2：名字：location_select，响应事件：弹出地理位置选择器；3-3：名字：media_id，响应事件：下发消息（除文本消息）；3-4：名字：view_limited，响应事件：跳转图文消息url。
实现源码（引用的AccessTokenUtils.java在第一部分：工具类AccessTokenUtils的封装）
/*
*创建自定义菜单。
*/
@Test
publicvoidcreateCommMenu(){
StringACCESS_TOKEN=AccessTokenUtils.getAccessToken();//获取AccessToken，AccessTokenUtils是封装好的类
//拼接api要求的httpsurl链接
StringurlString="https://api.weixin.qq.com/cgi-bin/menu/create?access_token="
+ACCESS_TOKEN;
try{
//创建一个url
URLreqURL=newURL(urlString);
//拿取链接
HttpsURLConnectionhttpsConn=(HttpsURLConnection)reqURL
.openConnection();
httpsConn.setDoOutput(true);
//取得该连接的输出流，以读取响应内容
OutputStreamWriterosr=newOutputStreamWriter(
httpsConn.getOutputStream());
osr.write(getMenuJson());//使用本类外部方法getMenuJson()
osr.close();
//返回结果
InputStreamReaderisr=newInputStreamReader(
httpsConn.getInputStream());
//读取服务器的响应内容并显示
char[]chars=newchar[1024];
Stringreslut="";
intlen;
while((len=isr.read(chars))!=-1){
reslut+=newString(chars,0,len);
}
System.out.println("返回结果:"+reslut);
isr.close();
}catch(IOExceptione){
e.printStackTrace();
}
}
publicStringgetMenuJson(){
Gsongson=newGson();//json处理工具
Menumenu=newMenu();//菜单类
List<FatherButton>fatherButtons=newArrayList<FatherButton>();//菜单中的父按钮集合
//-----------
//父按钮1
FatherButtonfb1=newFatherButton();
fb1.setName("click");
fb1.setType("click");
fb1.setKey("10");
//-------------
//父按钮2
FatherButtonfb2=newFatherButton();
fb2.setName("父按钮2");
List<SonButton>sonButtons2=newArrayList<SonButton>();//子按钮的集合
//子按钮2-1
SonButtonsb21=newSonButton();
sb21.setName("view");
sb21.setUrl("http://www.baidu.com");
sb21.setType("view");
//子按钮2-2
SonButtonsb22=newSonButton();
sb22.setName("scancode_push");
sb22.setType("scancode_push");
sb22.setKey("22");
//子按钮2-3
SonButtonsb23=newSonButton();
sb23.setName("scancode_waitmsg");
sb23.setType("scancode_waitmsg");
sb23.setKey("23");
//子按钮2-4
SonButtonsb24=newSonButton();
sb24.setName("pic_sysphoto");
sb24.setType("pic_sysphoto");
sb24.setKey("24");
//子按钮2-5
SonButtonsb25=newSonButton();
sb25.setName("pic_photo_or_album");
sb25.setType("pic_photo_or_album");
sb25.setKey("25");
//添加子按钮到子按钮集合
sonButtons2.add(sb21);
sonButtons2.add(sb22);
sonButtons2.add(sb23);
sonButtons2.add(sb24);
sonButtons2.add(sb25);
//将子按钮放到2-0父按钮集合
fb2.setSonButtons(sonButtons2);
//------------------
//父按钮3
FatherButtonfb3=newFatherButton();
fb3.setName("父按钮3");
List<SonButton>sonButtons3=newArrayList<SonButton>();
//子按钮3-1
SonButtonsb31=newSonButton();
sb31.setName("pic_weixin");
sb31.setType("pic_weixin");
sb31.setKey("31");
//子按钮3-2
SonButtonsb32=newSonButton();
sb32.setName("locatselect");
sb32.setType("location_select");
sb32.setKey("32");
////子按钮3-3-->测试不了，因为要media_id。这需要调用素材id.
//SonButtonsb33=newSonButton();
//sb33.setName("media_id");
//sb33.setType("media_id");
//sb33.setMedia_id("???");
////子按钮3-4-->测试不了，因为要media_id。这需要调用素材id.
//SonButtonsb34=newSonButton();
//sb34.setName("view_limited");
//sb34.setType("view_limited");
//sb34.setMedia_id("???");
//添加子按钮到子按钮队列
sonButtons3.add(sb31);
sonButtons3.add(sb32);
//sonButtons3.add(sb33);
//sonButtons3.add(sb34);
//将子按钮放到3-0父按钮队列
fb3.setSonButtons(sonButtons3);
//---------------------
//将父按钮加入到父按钮集合
fatherButtons.add(fb1);
fatherButtons.add(fb2);
fatherButtons.add(fb3);
//将父按钮队列加入到菜单栏
menu.setFatherButtons(fatherButtons);
Stringjson=gson.toJson(menu);
System.out.println(json);//测试输出
returnjson;
}
个性化菜单的实现
•任务：根据性别展示不同的按钮显示（可以根据性别、地区、分组手机操作系统等）
•修改代码一，因为是不同的微信后台实现，所以接口也不一样，不过还是POST请求，代码不用改，只要替换原来urlString即可。
//拼接api要求的httpsurl链接 StringurlString="https://api.weixin.qq.com/cgi-bin/menu/addconditional?access_token=" +ACCESS_TOKEN;
•修改代码二，只要创建一个MatchRule，设置匹配规则，然后将matchrule加入到menu便可以完成匹配规则。
//-----
//从此处开始设置个性菜单
MatchRulematchrule=newMatchRule();
matchrule.setSex("2");//男生
menu.setMatchrule(matchrule);
//----
源码下载：http://xiazai.jb51.net/201606/yuanma/WeixinApi(jb51.net).rar
本文已被整理到了《Android微信开发教程汇总》，《java微信开发教程汇总》欢迎大家学习阅读。
以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持毛票票。