java微信开发API解析(四)-自定义菜单以及个性化菜单实现

全局说明

* 详细说明请参考前两篇文章。

本文说明

*本文分为五部分:
    * 工具类AccessTokenUtils的封装
    * 自定义菜单和个性化菜单文档的阅读解析
    * 菜单JSON的分析以及构建对应bean
    * 自定义菜单的实现
    * 个性化菜单的实现
*  微信自定义菜单所有类型菜单都给出演示
* 本文结束会给出包括本文前四篇文章的所有演示源码

工具类AccessTokenUtils的封装

  • 在上文中关于AccessToken的获取和定时保存已经详细介绍过,此处直接给出处理过之后封装的AccessTokenUtils,实现原理以及文档阅读不再给出。
  • AccessTokenUtils.java
    package com.gist.utils;
    
    import java.io.File;
    import java.io.FileInputStream;
    import java.io.FileOutputStream;
    import java.io.IOException;
    import java.io.InputStreamReader;
    import java.net.URL;
    
    import javax.net.ssl.HttpsURLConnection;
    
    import com.gist.bean.Access_token;
    import com.google.gson.Gson;
    
    /**
     * @author 高远</n> 邮箱:[email protected]</n> 博客 http://blog.csdn.net/wgyscsf</n>
     *         编写时期 2016-4-7 下午5:44:33
     */
    public class AccessTokenUtils {
        private static final long MAX_TIME = 7200 * 1000;// 微信允许最长Access_token有效时间(ms)
        private static final String TAG = "WeixinApiTest";// TAG
        private static final String APPID = "wx889b020b3666b0b8";// APPID
        private static final String SECERT = "6da7676bf394f0a9f15fbf06027856bb";// 秘钥
    
        /*
         * 该方法实现获取Access_token、保存并且只保存2小时Access_token。如果超过两个小时重新获取;如果没有超过两个小时,直接获取。该方法依赖
         * :public static String getAccessToken();
         *
         * 思路:将获取到的Access_token和当前时间存储到file里,
         * 取出时判断当前时间和存储里面的记录的时间的时间差,如果大于MAX_TIME,重新获取,并且将获取到的存储到file替换原来的内容
         * ,如果小于MAX_TIME,直接获取。
         */
        // 为了调用不抛异常,这里全部捕捉异常,代码有点长
        public static String getSavedAccess_token() {
            Gson gson = new Gson();// 第三方jar,处理json和bean的转换
            String mAccess_token = null;// 需要获取的Access_token;
            FileOutputStream fos = null;// 输出流
            FileInputStream fis = null;// 输入流
            File file = new File("temp_access_token.temp");// Access_token保存的位置
            try {
                // 如果文件不存在,创建
                if (!file.exists()) {
                    file.createNewFile();
                }
            } catch (Exception e1) {
                e1.printStackTrace();
            }
            // 如果文件大小等于0,说明第一次使用,存入Access_token
            if (file.length() == 0) {
                try {
                    mAccess_token = getAccessToken();// 获取AccessToken
                    Access_token at = new Access_token();
                    at.setAccess_token(mAccess_token);
                    at.setExpires_in(System.currentTimeMillis() + "");// 设置存入时间
                    String json = gson.toJson(at);
                    fos = new FileOutputStream(file, false);// 不允许追加
                    fos.write((json).getBytes());// 将AccessToken和当前时间存入文件
                    fos.close();
                    return mAccess_token;
                } catch (Exception e) {
                    e.printStackTrace();
                }
            } else {
                // 读取文件内容
                byte[] b = new byte[2048];
                int len = 0;
                try {
                    fis = new FileInputStream(file);
                    len = fis.read(b);
                } catch (IOException e1) {
                    // TODO Auto-generated catch block
                    e1.printStackTrace();
                }
                String mJsonAccess_token = new String(b, 0, len);// 读取到的文件内容
                Access_token access_token = gson.fromJson(mJsonAccess_token,
                        new Access_token().getClass());
                if (access_token.getExpires_in() != null) {
                    long saveTime = Long.parseLong(access_token.getExpires_in());
                    long nowTime = System.currentTimeMillis();
                    long remianTime = nowTime - saveTime;
                    // System.out.println(TAG + "时间差:" + remianTime + "ms");
                    if (remianTime < MAX_TIME) {
                        Access_token at = gson.fromJson(mJsonAccess_token,
                                new Access_token().getClass());
                        mAccess_token = at.getAccess_token();
                        return mAccess_token;
                    } else {
                        mAccess_token = getAccessToken();
                        Access_token at = new Access_token();
                        at.setAccess_token(mAccess_token);
                        at.setExpires_in(System.currentTimeMillis() + "");
                        String json = gson.toJson(at);
                        try {
                            fos = new FileOutputStream(file, false);// 不允许追加
                            fos.write((json).getBytes());
                            fos.close();
                        } catch (IOException e) {
                            // TODO Auto-generated catch block
                            e.printStackTrace();
                        }
                        return mAccess_token;
                    }
    
                } else {
                    return null;
                }
            }
    
            return mAccess_token;
        }
    
        /*
         * 获取微信服务器AccessToken。该部分和getAccess_token() 一致,不再加注释
         */
        public static String getAccessToken() {
            String urlString = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid="
                    + APPID + "&secret=" + SECERT;
            String reslut = null;
            try {
                URL reqURL = new URL(urlString);
                HttpsURLConnection httpsConn = (HttpsURLConnection) reqURL
                        .openConnection();
                InputStreamReader isr = new InputStreamReader(
                        httpsConn.getInputStream());
                char[] chars = new char[1024];
                reslut = "";
                int len;
                while ((len = isr.read(chars)) != -1) {
                    reslut += new String(chars, 0, len);
                }
                isr.close();
            } catch (IOException e) {
    
                e.printStackTrace();
            }
            Gson gson = new Gson();
            Access_token access_token = gson.fromJson(reslut,
                    new Access_token().getClass());
            if (access_token.getAccess_token() != null) {
                return access_token.getAccess_token();
            } else {
                return null;
            }
        }
    }
    

自定义菜单和个性化菜单文档的阅读解析

  • 自定义菜单

    • 自定义菜单创建接口
    • 自定义菜单查询接口
    • 自定义菜单删除接口
    • 自定义菜单事件推送
    • 个性化菜单接口
    • 获取公众号的菜单配置
  • 文档地址: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”:”empty post data hint: [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):
    //按钮基类
    public class BaseButton {
        private String type;
        private String name;
        private String key;
        private String url;
        private String media_id;
    }
    //子按钮
    public class SonButton extends BaseButton {
        private String sub_button;
    }
    //父按钮
    public class FatherButton extends BaseButton {
    private String button;//可能直接一个父按钮做响应
    @SerializedName("sub_button")//为了保证Gson解析后子按钮的名字是“sub_button”,具体用法请搜索
    private List<SonButton> sonButtons;//可能有多个子按钮
    }
    
    public class Menu {
    @SerializedName("button")
    private List<FatherButton> fatherButtons;
    }
    
  • 以上是完整的自定义菜单的分析以及对应javabean的构建。
  • 对于个性化菜单,如果查看该部分的文档,会发现和自定义菜单大致相同,只是多个一个“配置”的json,格式是这样的:{“button”:[…],”matchrule”:{…}}。
  • 我们发现,“匹配”这段json和“button”是同级的,分析和实现和上面基本等同,直接给出实现的javabean。
    //匹配的json对应的json
    public class MatchRule {
    private String group_id;
    private String sex;
    private String client_platform_type;
    private String country;
    private String province;
    private String city;
    private String language;
    }
    
    //修改Menu.java
    public class Menu {
    @SerializedName("button")
    private List<FatherButton> fatherButtons;
    private MatchRule matchrule;
    }
    

自定义菜单的实现

  • 任务,我们实现所有微信按钮响应类型:

     任务(注释:“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
    public void createCommMenu() {
        String ACCESS_TOKEN = AccessTokenUtils.getAccessToken();// 获取AccessToken,AccessTokenUtils是封装好的类
        // 拼接api要求的httpsurl链接
        String urlString = "https://api.weixin.qq.com/cgi-bin/menu/create?access_token="
                + ACCESS_TOKEN;
        try {
            // 创建一个url
            URL reqURL = new URL(urlString);
            // 拿取链接
            HttpsURLConnection httpsConn = (HttpsURLConnection) reqURL
                    .openConnection();
            httpsConn.setDoOutput(true);
            // 取得该连接的输出流,以读取响应内容
            OutputStreamWriter osr = new OutputStreamWriter(
                    httpsConn.getOutputStream());
            osr.write(getMenuJson());// 使用本类外部方法getMenuJson()
            osr.close();

            // 返回结果
            InputStreamReader isr = new InputStreamReader(
                    httpsConn.getInputStream());
            // 读取服务器的响应内容并显示
            char[] chars = new char[1024];
            String reslut = "";
            int len;
            while ((len = isr.read(chars)) != -1) {
                reslut += new String(chars, 0, len);
            }
            System.out.println("返回结果:" + reslut);
            isr.close();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    public String getMenuJson() {
        Gson gson = new Gson();// json处理工具

        Menu menu = new Menu();// 菜单类
        List<FatherButton> fatherButtons = new ArrayList<FatherButton>();// 菜单中的父按钮集合
        // -----------
        // 父按钮1
        FatherButton fb1 = new FatherButton();
        fb1.setName("click");
        fb1.setType("click");
        fb1.setKey("10");
        // -------------
        // 父按钮2
        FatherButton fb2 = new FatherButton();
        fb2.setName("父按钮2");
        List<SonButton> sonButtons2 = new ArrayList<SonButton>();// 子按钮的集合

        // 子按钮2-1
        SonButton sb21 = new SonButton();
        sb21.setName("view");
        sb21.setUrl("http://www.baidu.com");
        sb21.setType("view");
        // 子按钮2-2
        SonButton sb22 = new SonButton();
        sb22.setName("scancode_push");
        sb22.setType("scancode_push");
        sb22.setKey("22");
        // 子按钮2-3
        SonButton sb23 = new SonButton();
        sb23.setName("scancode_waitmsg");
        sb23.setType("scancode_waitmsg");
        sb23.setKey("23");
        // 子按钮2-4
        SonButton sb24 = new SonButton();
        sb24.setName("pic_sysphoto");
        sb24.setType("pic_sysphoto");
        sb24.setKey("24");
        // 子按钮2-5
        SonButton sb25 = new SonButton();
        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
        FatherButton fb3 = new FatherButton();
        fb3.setName("父按钮3");
        List<SonButton> sonButtons3 = new ArrayList<SonButton>();

        // 子按钮3-1
        SonButton sb31 = new SonButton();
        sb31.setName("pic_weixin");
        sb31.setType("pic_weixin");
        sb31.setKey("31");
        // 子按钮3-2
        SonButton sb32 = new SonButton();
        sb32.setName("locatselect");
        sb32.setType("location_select");
        sb32.setKey("32");
        // // 子按钮3-3-->测试不了,因为要media_id。这需要调用素材id.
        // SonButton sb33 = new SonButton();
        // sb33.setName("media_id");
        // sb33.setType("media_id");
        // sb33.setMedia_id("???");
        // // 子按钮3-4-->测试不了,因为要media_id。这需要调用素材id.
        // SonButton sb34 = new SonButton();
        // 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);
        String json = gson.toJson(menu);
        System.out.println(json);// 测试输出
        return json;

    }

个性化菜单的实现

  • 任务:根据性别展示不同的按钮显示(可以根据性别、地区、分组手机操作系统等)
  • 修改代码一,因为是不同的微信后台实现,所以接口也不一样,不过还是POST请求,代码不用改,只要替换原来urlString即可。
    // 拼接api要求的httpsurl链接
    String urlString = "https://api.weixin.qq.com/cgi-bin/menu/addconditional?access_token="
                + ACCESS_TOKEN;
    
  • 修改代码二,只要创建一个MatchRule,设置匹配规则,然后将matchrule加入到menu便可以完成匹配规则。
    // -----
    // 从此处开始设置个性菜单
    MatchRule matchrule = new MatchRule();
    matchrule.setSex("2");// 男生
    menu.setMatchrule(matchrule);
    // ----
    


测试号二维码,大家可以扫描查看效果(只保留最新效果,因为测试,可能效果会变化):



这是平时写的一些技术文章的微信公众号,欢迎关注:



源码:http://download.csdn.net/detail/wgyscsf/9485817

时间: 2024-11-03 05:29:03

java微信开发API解析(四)-自定义菜单以及个性化菜单实现的相关文章

java微信开发API解析(六)-综合运用(消息处理、自定义菜单响应处理、用户自动分组处理;包含源码)

java微信开发API解析(六) 全局说明 * 详细说明请参考前两篇文章. 本文说明 * 本文主要是对前面学习的知识进行综合整合. * 我们对需要的bean.工具类.xml.file进行必要的包装. * 我们构建一个可以直接使用的Java微信应用. * 文后包含该部分效果的测试微信公众号 * 文后包含构建好的源码供下载 bean的构建 public class Access_token,获取Access_token对应的bean. private String access_token; pri

java微信开发API解析(五)-用户管理

java微信开发API解析(五)-用户管理 全局说明 * 详细说明请参考前两篇文章. 本文说明 *本文分为五部分: * 工具类MyHttpUtils的封装 * 用户分组管理文档的简单阅读解析 * 分组bean的构建以及各种分组管理的实现源码 * 用户管理的应用场景 * 测试的微信号二维码 * 本文只分析用户管理的用户分组管理部分,其它都大同小异,不再分析处理.如需要,请留言. * 以后原理分析会越来越简洁,具体原理分析请查看以前文章. * 下一篇文章会对于用户普通消息.自定义菜单消息.自动完成用

java微信开发API解析(七)-网页开发-微信网页授权

java微信开发API解析(七)-网页开发-微信网页授权 全局说明 * 详细说明请参考前两篇文章. 本文说明 本文主要完成获取用户基本信息的工作,包括(昵称.头像.地址.国家等基本信息) 对于snsapi_base和snsapi_userinfo我们只演示关于snsapi_userinfo.因为snsapi_userinfo更难,如果能够理解snsapi_userinfo,那么snsapi_base不在话下. 对于该部分(微信网页开发)我们只介绍如何获取用户基本信息,对于开发样式库,js-SDK

Force.com微信开发系列(四)申请Access Token及自定义菜单之创建菜单

在微信接口开发中,许多服务的使用都离不开Access Token,Access Token相当于打开这些服务的钥匙,正常情况下会在7200秒内失效,重复获取将导致上次获取的Token失效,本文将首先介绍如何获取Access Token,再介绍如何通过Access Token来在微信内添加自定义菜单(注意,开发者需要申请测试账号来测试自定义菜单,如何申请请参照前文). 申请Access Token 获取Access Token接口的网址如下: https://api.weixin.qq.com/c

java微信开发

所谓的微信开发就是在微信开发模式之下,对微信进行公众号和企业号的扩展开发. 如果要让你的微信公众号有更多的功能,比如菜单支持,自动的信息服务,查询,消息推送等,就必须开启微信的开发模式.进入微信公众平台的管理界面,打开开发模式,配置好你的服务器即可. 使用java微信开发,就是你配置的服务器中的应用程序是使用java开发. 使用java开发微信的步骤: 1.进入微信公众平台开启开发模式. 2.搭建你自己的服务器,必须是80端口,且必须有域名. 3.寻找一个快速开发的框架,强烈推荐开源的wecha

分享 Java微信开发SDK

分享 Java微信开发SDK •发布于 4周前  •作者 朋也  •432 次浏览  •最后一次编辑是 2周前  •来自 分享 给大家分享两个java开发微信公众号的sdk jfinal-weixin weixin-java-tools fastweixin 第一个是jfinal框架开发的微信开发sdk,貌似没什么文档,大家知道哪地方有文档可以在下方留言 第二个是在github上找的,fork人数也不少,文档写的挺好,基于maven方式搭建,开发起来也很方便 第三个是在osc上看到的,可以整合s

微信开发 api 需要 https 服务器

微信开发 api 需要 https 服务器 先建一个环境,本地的 https 服务器. 以下这篇不错,很完整. https://zhuanlan.zhihu.com/p/23640321 原文地址:https://www.cnblogs.com/F4NNIU/p/9018040.html

Java微信开发_Exception_01_The type org.xmlpull.v1.XmlPullParser cannot be resolved. It is indirectly referenced from required .class files

一.源码: package com.souvc.weixin.util; import java.io.InputStream; import java.io.Writer; import java.util.HashMap; import java.util.List; import java.util.Map; import javax.servlet.http.HttpServletRequest; import org.dom4j.Document; import org.dom4j.E

Java微信开发-崔用志-微信开发-java版本

  今天看到一些关于微信开发的知识蛮好的博客,分享给大家,希望对大家有帮助. 微信开发准备(一)--Maven仓库管理新建WEB项目 微信开发准备(二)--springmvc+mybatis项目结构的搭建 微信开发准备(三)--框架以及工具的基本使用 Mybatis工具Generator 微信开发准备(四)--nat123内网地址公网映射实现 Java微信公众平台开发(一)--接入微信公众平台 Java微信公众平台开发(二)--微信服务器post消息体的接收 Java微信公众平台开发(三)--接