Java微信公众平台开发_04_自定义菜单

一、本节要点

1、菜单相关实体类的封装

参考官方文档中的请求包的内容，对菜单相关实体类进行封装。

2、数据传输格式—JSON

自定义菜单中请求包的数据是Json字符串格式的，请参见：  Java_数据交换_fastJSON_01_用法入门

二、代码实现

1、菜单实体的封装

1.1 按钮基类—Button

package com.ray.weixin.gz.model.menu;  
  
/**
 * @desc  : 按钮的基类 
 * 
 * @author: shirayner
 * @date  : 2017年11月13日 上午11:36:16
 */
public class Button {  
    private String name;  
  
    public String getName() {  
        return name;  
    }  
  
    public void setName(String name) {  
        this.name = name;  
    }  
}  

1.2 普通按钮—CommonButton

package com.ray.weixin.gz.model.menu;  
  
/**
 *  @desc  : 普通按钮（子按钮） 
 * 
 * @author: shirayner
 * @date  : 2017年11月13日 上午11:37:18
 */
public class CommonButton extends Button {  
    private String type;  
    private String key;  
  
    public String getType() {  
        return type;  
    }  
  
    public void setType(String type) {  
        this.type = type;  
    }  
  
    public String getKey() {  
        return key;  
    }  
  
    public void setKey(String key) {  
        this.key = key;  
    }  
}  

1.3 复杂按钮—ComplexButton

package com.ray.weixin.gz.model.menu;  
   
/**
 * @desc  :  复杂按钮（父按钮） 
 * 
 * @author: shirayner
 * @date  : 2017年11月13日 上午11:36:42
 */
public class ComplexButton extends Button {  
    private Button[] sub_button;  
  
    public Button[] getSub_button() {  
        return sub_button;  
    }  
  
    public void setSub_button(Button[] sub_button) {  
        this.sub_button = sub_button;  
    }  
}  

1.4 跳转按钮—ViewButton

package com.ray.weixin.gz.model.menu;  
  
/**
 *  @desc  : view类型的按钮
 * 
 * @author: shirayner
 * @date  : 2017年11月13日 上午11:37:42
 */
public class ViewButton extends Button {  
    private String type;  
    private String url;  
  
    public String getType() {  
        return type;  
    }  
  
    public void setType(String type) {  
        this.type = type;  
    }  
  
    public String getUrl() {  
        return url;  
    }  
  
    public void setUrl(String url) {  
        this.url = url;  
    }  
}  

1.5 菜单实体—Menu

package com.ray.weixin.gz.model.menu;  
  
/**
 * @desc  : 菜单 
 * 
 * @author: shirayner
 * @date  : 2017年11月13日 上午11:37:31
 */
public class Menu {  
    private Button[] button;  
  
    public Button[] getButton() {  
        return button;  
    }  
  
    public void setButton(Button[] button) {  
        this.button = button;  
    }  
}  

2.自定义菜单业务类—MenuService

package com.ray.weixin.gz.service.menu;

import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;

import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;
import com.ray.weixin.gz.model.menu.Menu;
import com.ray.weixin.gz.util.HttpHelper;

/**@desc  :  自定义菜单业务类
 * 
 * @author: shirayner
 * @date  : 2017年10月31日 上午9:40:05
 */
public class MenuService {
    private static final Logger logger = LogManager.getLogger(MenuService.class);

    //1.菜单创建（POST） 限100（次/天）  
    public static final String CREATE_MENU_URL = "https://api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN";  
    //2.查询菜单数据
    public static final String GET_MENU_URL = "https://api.weixin.qq.com/cgi-bin/menu/get?access_token=ACCESS_TOKEN";  
    //3.删除菜单
    public static final String DELETE_MENU_URL = "https://api.weixin.qq.com/cgi-bin/menu/delete?access_token=ACCESS_TOKEN";  


    /**
     * @desc ：1.创建菜单 
     *  
     * @param menu  菜单实例 
     * @param accessToken 有效凭证
     * @throws Exception void
     */
    public static void createMenu(Menu menu, String accessToken) throws Exception {  

        //1.准备POST请求参数
        Object data=JSON.toJSON(menu);
        logger.info(data);

        //2.拼装创建菜单的url  
        String url=CREATE_MENU_URL.replace("ACCESS_TOKEN", accessToken); 

        //3.发起POST请求，获取返回结果
        JSONObject jsonObject=HttpHelper.doPost(url, data);
        logger.info("jsonObject:"+jsonObject.toString());


        if (null != jsonObject) {  

            //5.错误消息处理
            if (0 != jsonObject.getInteger("errcode")) {  

                int errCode = jsonObject.getInteger("errcode");
                String errMsg = jsonObject.getString("errmsg");
                throw new Exception("error code:"+errCode+", error message:"+errMsg); 
            
            } else {
                logger.info("菜单创建成功！");
            } 
        }   




    }  

    /**
     * @desc ：2.查询菜单数据
     *  
     * @param accessToken 有效凭证
     * @return
     * @throws Exception JSONObject
     */
    public static JSONObject getMenu(String accessToken) throws Exception {  
        //1.获取请求url
        String url=GET_MENU_URL.replace("ACCESS_TOKEN", accessToken); 

        //2.发起GET请求，获取返回结果
        JSONObject jsonObject=HttpHelper.doGet(url);
        logger.info("jsonObject:"+jsonObject.toString());

        //3.解析结果，获取菜单数据
        JSONObject returnJsonObject=null;
        if (null != jsonObject) {  

            //4.错误消息处理
            if (jsonObject.getInteger("errcode")!=null && 0 != jsonObject.getInteger("errcode")) {  
                int errCode = jsonObject.getInteger("errcode");
                String errMsg = jsonObject.getString("errmsg");
                throw new Exception("error code:"+errCode+", error message:"+errMsg); 
            //5.成功获取菜单数据
            } else {
                returnJsonObject= jsonObject;
            } 
        }   
        
        return returnJsonObject;
    }  
    
    /**
     * @desc ： 3.删除菜单
     *  
     * @param accessToken  有效凭证
     * @throws Exception void
     */
    public static void deleteMenu(String accessToken) throws Exception {  
        //1.获取请求url
        String url=DELETE_MENU_URL.replace("ACCESS_TOKEN", accessToken); 

        //2.发起GET请求，获取返回结果
        JSONObject jsonObject=HttpHelper.doGet(url);
        logger.info("jsonObject:"+jsonObject.toString());

        //3.解析结果
        if (null != jsonObject) {  

            //4.错误消息处理
            if (jsonObject.getInteger("errcode")!=null && 0 != jsonObject.getInteger("errcode")) {  
                int errCode = jsonObject.getInteger("errcode");
                String errMsg = jsonObject.getString("errmsg");
                throw new Exception("error code:"+errCode+", error message:"+errMsg); 
            
            //5.成功删除菜单
            } else {
                logger.info("菜单删除成功！");
            } 
        }   
        
    }  
}

3.菜单测试类—MenuServiceTest

package com.ray.weixin.gz.service.menu;

import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;
import org.junit.Test;

import com.alibaba.fastjson.JSONObject;
import com.ray.weixin.gz.config.Env;
import com.ray.weixin.gz.model.menu.Button;
import com.ray.weixin.gz.model.menu.CommonButton;
import com.ray.weixin.gz.model.menu.ComplexButton;
import com.ray.weixin.gz.model.menu.Menu;
import com.ray.weixin.gz.model.menu.ViewButton;
import com.ray.weixin.gz.service.menu.MenuService;
import com.ray.weixin.gz.util.AuthHelper;

/**@desc  : 菜单测试类
 * 
 * @author: shirayner
 * @date  : 2017年10月31日 上午9:53:00
 */
public class MenuServiceTest {
    
    private static final Logger logger = LogManager.getLogger(MenuServiceTest.class);

    
    
    /**
     * @desc ：1. 创建菜单
     *  
     * @throws Exception void
     */
    @Test
    public void testCreateMenu() throws Exception {
        //1.准备好请求参数
        String accessToken=AuthHelper.getAccessToken(Env.APP_ID, Env.APP_SECRET);
        Menu menu=getMenu();
        
        //2.调用接口，执行请求
        MenuService.createMenu(menu, accessToken);

    }

    /**
     * @desc ：2.查询菜单数据
     *  
     * @throws Exception void
     */
    @Test
    public void testGetMenu() throws Exception {
        //1.准备好请求参数
        String accessToken=AuthHelper.getAccessToken(Env.APP_ID, Env.APP_SECRET);
        
        //2.调用接口，执行请求
        JSONObject jsonObject=MenuService.getMenu(accessToken);
        logger.info("菜单数据："+jsonObject.toJSONString());
    }

    /**
     * @desc ：3.删除菜单
     *  
     * @throws Exception void
     */
    @Test
    public void testDeleteMenu() throws Exception {
        //1.准备好请求参数
        String accessToken=AuthHelper.getAccessToken(Env.APP_ID, Env.APP_SECRET);
        
        //2.调用接口，执行请求
        MenuService.deleteMenu(accessToken);
       
    }
    
    
    /**
     * @desc ：辅助1.组装菜单数据 
     *  
     * @return Menu
     */
    private static Menu getMenu() {  
        ViewButton btn11 = new ViewButton();  
        btn11.setName("移动审批");  
        btn11.setType("view");  
        btn11.setUrl("https://open.weixin.qq.com/connect/oauth2/authorize?appid=wxa0064ea657f80062&redirect_uri=http%3A%2F%2Frayner.nat300.top%2Fweixin_gz%2FIDAuthentication.jsp&response_type=code&scope=snsapi_userinfo&state=STATE#wechat_redirect");  
        //btn11.setUrl("https://open.weixin.qq.com/connect/oauth2/authorize?appid=wxa0064ea657f80062&redirect_uri=http%3A%2F%2Frayner.nat300.top%2Fweixingz_hec%2Fweixingz.screen&response_type=code&scope=snsapi_userinfo&state=STATE#wechat_redirect");  

        
        ViewButton btn12 = new ViewButton();  
        btn12.setName("上传图片");  
        btn12.setType("view");  
        btn12.setUrl("https://open.weixin.qq.com/connect/oauth2/authorize?appid=wxa0064ea657f80062&redirect_uri=http%3A%2F%2Frayner.nat300.top%2Fweixin_gz%2FuploadImg.jsp&response_type=code&scope=snsapi_userinfo&state=STATE#wechat_redirect");  

        ViewButton btn13 = new ViewButton();  
        btn13.setName("申请开票");  
        btn13.setType("view");  
        btn13.setUrl("https://mp.weixin.qq.com/bizmall/authinvoice?action=list&s_pappid=d3hhMDA2NGVhNjU3ZjgwMDYyX0s22HY1myAuWWro7q-FsX8KWzrWiEgI8Ngqa3-W6dQ4&appid=wxa0064ea657f80062&num=1&o1=1234&m1=11&t1=1510036149&source=web&type=1&redirect_url=https%3A%2F%2Fmp.weixin.qq.com&signature=9aa88c3a4587f51397703a7838cd2fcaa60abb38#wechat_redirect");  


        ViewButton btn14 = new ViewButton();  
        btn14.setName("获取发票信息");  
        btn14.setType("view");  
        btn14.setUrl("http://rayner.nat300.top/weixin_gz/showInvoice.jsp");  

        ViewButton btn15 = new ViewButton();  
        btn15.setName("上传图片2");  
        btn15.setType("view");  
        btn15.setUrl("http://5hcn2d.natappfree.cc/WeiXin_SanFenBaiXue/index2.jsp");  

        ViewButton btn21 = new ViewButton();  
        btn21.setName("index");  
        btn21.setType("view");  
        btn21.setUrl("http://rayner.nat300.top/weixin_gz/index.jsp");  

        CommonButton btn22 = new CommonButton();  
        btn22.setName("经典游戏");  
        btn22.setType("click");  
        btn22.setKey("22");  

        CommonButton btn23 = new CommonButton();  
        btn23.setName("美女电台");  
        btn23.setType("click");  
        btn23.setKey("23");  

        CommonButton btn24 = new CommonButton();  
        btn24.setName("人脸识别");  
        btn24.setType("click");  
        btn24.setKey("24");  

        CommonButton btn25 = new CommonButton();  
        btn25.setName("聊天唠嗑");  
        btn25.setType("click");  
        btn25.setKey("25");  

        CommonButton btn31 = new CommonButton();  
        btn31.setName("Q友圈");  
        btn31.setType("click");  
        btn31.setKey("31");  

        CommonButton btn33 = new CommonButton();  
        btn33.setName("幽默笑话");  
        btn33.setType("click");  
        btn33.setKey("33");  

        CommonButton btn34 = new CommonButton();  
        btn34.setName("用户反馈");  
        btn34.setType("click");  
        btn34.setKey("34");  

        CommonButton btn35 = new CommonButton();  
        btn35.setName("关于我们");  
        btn35.setType("click");  
        btn35.setKey("35");  

        ViewButton btn32 = new ViewButton();  
        btn32.setName("周边搜索");  
        btn32.setType("view");  
        btn32.setUrl("http://liufeng.gotoip2.com/xiaoqrobot/help.jsp");  

        ComplexButton mainBtn1 = new ComplexButton();  
        mainBtn1.setName("汉得测试");  
        mainBtn1.setSub_button(new Button[] { btn11, btn12, btn13, btn14, btn15 });  

        ComplexButton mainBtn2 = new ComplexButton();  
        mainBtn2.setName("休闲驿站");  
        mainBtn2.setSub_button(new Button[] { btn21, btn22, btn23, btn24, btn25 });  

        ComplexButton mainBtn3 = new ComplexButton();  
        mainBtn3.setName("更多");  
        mainBtn3.setSub_button(new Button[] { btn31, btn33, btn34, btn35, btn32 });  

        /** 
         * 这是公众号xiaoqrobot目前的菜单结构，每个一级菜单都有二级菜单项<br> 
         *  
         * 在某个一级菜单下没有二级菜单的情况，menu该如何定义呢？<br> 
         * 比如，第三个一级菜单项不是“更多体验”，而直接是“幽默笑话”，那么menu应该这样定义：<br> 
         * menu.setButton(new Button[] { mainBtn1, mainBtn2, btn33 }); 
         */  
        Menu menu = new Menu();  
        menu.setButton(new Button[] { mainBtn1, mainBtn2, mainBtn3 });  

        return menu;  
    }  
}

三、参考文档

1.微信公众平台技术文档

2.柳峰： [专栏]微信公众帐号开发教程