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;
}
}
View Code
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;
}
}
View Code
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;
}
}
View Code
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;
}
}
View Code
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;
}
}
View Code
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("菜单删除成功！");
}
}
}
}
View Code
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;
}
}
View Code
三、参考文档
1.微信公众平台技术文档
2.柳峰： [专栏]微信公众帐号开发教程
以上是 Java微信公众平台开发_04_自定义菜单 的全部内容， 来源链接： utcz.com/z/390226.html
