Java WeChat API 개발의 네 번째 단계: WeChat 맞춤형 개인화 메뉴 구현

WeChat에서 맞춤형 개인화 메뉴를 구현하는 방법은 아래에 소개되어 있습니다

1. 글로벌 설명
자세한 지침은 처음 두 기사를 참조하세요.

2. 이 기사 설명
이 기사는 다섯 부분으로 구성됩니다:
* 도구 클래스 AccessTokenUtils의 캡슐화
* 사용자 정의 메뉴 및 개인화 메뉴 문서 읽기 및 구문 분석
* 메뉴 JSON 해당 빈 분석 및 구축
* 사용자 정의 메뉴 구현
* 개인화 메뉴 구현
WeChat 사용자 정의 메뉴의 모든 유형의 메뉴가 시연됩니다
이 기사의 마지막에는 처음 4개 이 기사의 기사는 기사의 모든 데모 소스 코드

도구 클래스 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> 邮箱：wgyscsf@163.com</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. 클릭: 클릭 이벤트.. .;2 . 보기: 점프 이벤트...;3....(커스텀 메뉴 관련)
* 인터페이스 호출 요청 설명 http 요청 방법: POST(https 프로토콜을 사용하세요) https://api.weixin .qq.com/ cgi-bin/menu/create?access_token=ACCESS_TOKEN (맞춤 메뉴 정보)
* 클릭하여 요청 예시 보기 {"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" 매개변수를 사용해야 한다는 것만 알고 있습니다. WeChat 문서에서 제공한 요청 주소의 "ACCESS_TOKEN"을 우리가 얻은 자체 ACCESS_TOKEN으로 바꾸고 URL을 방문하면 "{"errcode":44002,"errmsg":"빈 게시물 데이터 힌트가 표시됩니다. Gdveda0984vr23]”}”. 이는 아마도 빈 게시물 요청 데이터를 의미할 것입니다. 따라서 매개변수를 POST 요청 형식으로 WeChat 서버에 전달해야 합니다. 매개변수 형식은 문서 아래에도 제공됩니다: {"button":[...]} 이 형식에 따른 WeChat 서버.
◦ 매개변수 설명을 보면 맞춤 메뉴 생성에 매개변수가 7개 있는 것을 알 수 있습니다. 개인화된 메뉴 인터페이스에는 이러한 7개의 매개변수 외에도 8개의 매개변수가 더 있습니다. 문서의 이 부분만 보면 이 8가지 매개변수가 개인화된 메뉴의 매칭 및 선별에 사용된다는 것을 이해할 수 있습니다.
◦ 이제 WeChat 문서의 요구 사항에 따라 json을 구성하고 이 json 데이터 문자열을 게시물 요청을 통해 WeChat 서버로 보내야 합니다. json에는 우리가 생성한 다양한 유형의 버튼 이벤트가 포함되어 있습니다.

메뉴 JSON 분석 및 해당 Bean 구성
사용자 정의 메뉴 json 분석(개인 메뉴 제외). 다음 코드는 WeChat 설명서에 제공된 예입니다.
요청 예시를 클릭하여 확인하세요

{
 "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对象。
 同时，因为一级菜单下会有多个父按钮，所以是一个Listd2905179da6d93a5bd31b4e0b355d3e3的形式。父按钮下可能有多个子菜单，也是一个 Listed4e838aa2d3dca629a3ac82fa5b59ba；但是，父按钮也有可能也是一个单独的可以响应的按钮。是一个单独的父按钮对象。子按钮就是一个单独的子按钮对象。
 查看关于自定义菜单的参数说明，我们可以看到按钮分为一级按钮（“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);
// ----

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持PHP中文网。

更多java微信开发API第四步 微信自定义个性化菜单实现相关文章请关注PHP中文网！