微信公众号开发基础篇(八)

一、自定义菜单接口：

           其中3-8是click类型的其他方面应用.

二、需要的参数

        

参数	是否必须	说明
button	是	一级菜单数组，个数应为1~3个
sub_button	否	二级菜单数组，个数应为1~5个
type	是	菜单的响应动作类型
name	是	菜单标题，不超过16个字节，子菜单不超过60个字节
key	click等点击类型必须	菜单KEY值，用于消息接口推送，不超过128字节
url	view类型必须	网页链接，用户点击菜单可打开链接，不超过1024字节
media_id	media_id类型和view_limited类型必须	调用新增永久素材接口返回的合法media_id

三、实战自定义菜单操作

       1、建立实体类Button

package com.my.pojo.button;

import java.util.Arrays;

/**
 * ///菜单按钮实体类
 * 
 * @author liuya
 * 
 */

public class Button {

    // 菜单标题
    private String name;
    // 菜单类型
    private String type;
    // 菜单数组(微信界面最下边的菜单组件个数)
    private Button[] sub_button;

    public Button() {
        super();
    }

    public Button(String name, String type, Button[] sub_button) {
        this.name = name;
        this.type = type;
        this.sub_button = sub_button;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getType() {
        return type;
    }

    public void setType(String type) {
        this.type = type;
    }

    public Button[] getSub_button() {
        return sub_button;
    }

    public void setSub_button(Button[] sub_button) {
        this.sub_button = sub_button;
    }

    @Override
    public String toString() {
        return "Button [name=" + name + ", type=" + type + ", sub_button="
                + Arrays.toString(sub_button) + "]";
    }

}

           2、建立一个view类型的button

package com.my.pojo.button;

/**
 * //跳转URL用户点击view类型按钮后，微信客户端将会打开开发者在按钮中填写的网页URL，可与网页授权获取用户基本信息接口结合，获得用户基本信息。
 * 
 * @author liuya
 * 
 * 
 * 
 *         //跳转到网页的button
 */

public class ViewButton extends Button {

    // 跳转的链接
    private String url;

    public ViewButton() {
    }

    public ViewButton(String url) {
        this.url = url;
    }

    public String getUrl() {
        return this.url;
    }

    public void setUrl(String url) {
        this.url = url;
    }

    @Override
    public String toString() {
        return "ViewButton [url=" + url + "]";
    }

}

          3、建立一个clickButton类型的button

package com.my.pojo.button;

/**
 * 消息接口推送
 * 
 * @author liuya //
 * 
 *         //当点击button的时候触发事件
 */

public class ClickButton extends Button {

    // 菜单KEY
    private String key;

    public ClickButton() {
    }

    public ClickButton(String key) {
        this.key = key;
    }

    public String getKey() {
        return this.key;
    }

    public void setKey(String key) {
        this.key = key;
    }

    @Override
    public String toString() {
        return "ClickButton [key=" + key + "]";
    }

}

             4、建立一个承载button的menu

package com.my.pojo.button;

import java.util.Arrays;

/**
 * 
 * // 承载微信界面下边的多个菜单的框
 * 
 * @author liuya
 * 
 */

public class Menu {

    // button数组
    private Button[] button;

    public Menu() {
    }

    public Menu(Button[] button) {
        this.button = button;
    }

    public Button[] getButton() {
        return this.button;
    }

    public void setButton(Button[] button) {
        this.button = button;
    }

    @Override
    public String toString() {
        return "Menu [button=" + Arrays.toString(button) + "]";
    }

}

               5、在util里建立一个可以操作菜单的方法

// 建立一个菜单响应的方法(组装界面的菜单样式)
    public static Menu initMenu() {

        // 创建一个menu对象
        Menu menu = new Menu();

        // 一个展示的菜单(主菜单,就是菜单下没有菜单了)
        ViewButton button11 = new ViewButton();

        // 设置菜单的名称(就是菜单上显示的字)
        button11.setName("我的主页");
        // 设置菜单的类型(展示类型的)
        button11.setType("view");
        // 网址需要是一个完整的路径,包括协议和后边的路径
        button11.setUrl("http://www.cnblogs.com/liuyangfirst/");

        // 第二个主菜单
        ViewButton button22 = new ViewButton();
        // 设置菜单的名称(就是菜单上显示的字)
        button22.setName("个人简介");
        // 设置菜单的类型(展示类型的)
        button22.setType("view");
        // 网址需要是一个完整的路径,包括协议和后边的路径
        button22.setUrl("https://home.cnblogs.com/u/liuyangfirst/");

        // 第三个主菜单有子菜单
        Button button33 = new Button();
        // 设置菜单的名称(就是菜单上显示的字)
        button33.setName("菜单");

        // 第三个菜单的子菜单
        ClickButton button331 = new ClickButton();
        // 设置菜单的名称(就是菜单上显示的字)
        button331.setName("扫码事件");
        // 设置菜单的类型(扫码类型的)
        button331.setType("scancode_push");
        // 关键字
        button331.setKey("331");

        // 第三个菜单的子菜单
        ClickButton button332 = new ClickButton();
        // 设置菜单的名称(就是菜单上显示的字)
        button332.setName("地理位置");
        // 设置菜单的类型(地理位置类型的)
        button332.setType("location_select");
        // 关键字
        button332.setKey("332");

        // 把两个二级菜单通过数组的方式放入到主菜单中
        button331.setSub_button(new Button[] { button331, button332 });

        // 把三个主菜单,放入到menu中
        menu.setButton(new Button[] { button11, button22, button33 });
        return menu;

    }

    /**
     * 
     * @param token
     * @param menu
     * @return
     * @throws ParseException
     * @throws IOException
     * 
     * 
     * 
     *             //封装一个方法,请求微信服务平台,在公众号上建立一个菜单
     * 
     * 
     * 
     * 
     */

    public static int createMenu(String token, String menu)
            throws ParseException, IOException {
        Integer result = null;

        // 把接口传进来
        String url = CREATE_MENU_URL.replace("ACCESS_TOKEN", token);

        // 封装好的doPost方法调用这个接口地址
        JSONObject jsonObject = doPostStr(url, menu);

        // 获取的结果进行判断,不为空就进行操作
        if (jsonObject != null) {

            // 获取结果进行判断,如果是0的话就判断,如果不是0的话,根据文档的错误代码进行判断
            result = Integer.valueOf(jsonObject.getInt("errcode"));
        }

        return result;
    }

同时要建立常量的menu接口

// 菜单接口(使用接口创建自定义菜单后，开发者还可使用接口查询自定义菜单的结构)
    private static final String CREATE_MENU_URL = "https://api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN";

           6、调用建立的接口，进行测试和实际建立菜单（注意：公众号上的界面菜单，是通过这里调用测试建立的）

package com.my.test;

import net.sf.json.JSONObject;

import org.junit.Test;

import com.my.pojo.AccessToken;
import com.my.utils.WeixinUtil;

/**
 * 测试类
 * 
 * @author liuya
 * 
 */

public class TestDemo {

    @Test
    public void test() throws Exception {
        AccessToken accessToken = WeixinUtil.getAccessToken();
        System.out.println("票据信息 : " + accessToken.getToken());
        System.out.println("有效时间 : " + accessToken.getExpiresIn());
    }

    // 对菜单建立是否成功测试,同时是界面菜单建立的类
    @Test
    public void test3() throws Exception {
        AccessToken token = WeixinUtil.getAccessToken();
        String menuString = JSONObject.fromObject(WeixinUtil.initMenu())
                .toString();
        int result = WeixinUtil.createMenu(token.getToken(), menuString);
        if (result == 0)
            System.out.println("创建菜单成功");
        else
            System.out.println("错误码" + result);
    }

}