API de développement Java WeChat Exemple de code d'implémentation de menu personnalisé WeChat

Cet article présente principalement en détail la quatrième étape de l'API de développement Java WeChat, le menu personnalisé et la mise en œuvre du menu personnalisé. Les amis intéressés peuvent se référer à

Comment implémenter la personnalité personnalisée dans WeChat. Ce qui suit est une introduction au. menu

1. Description globale
Veuillez vous référer aux deux premiers articles pour des instructions détaillées.

2. Description de cet article
Cet article est divisé en cinq parties :
* Encapsulation de la classe d'outils AccessTokenUtils
* Lecture et analyse des menus personnalisés et personnalisés documents de menu
* Analyse du menu JSON et construction des beans correspondants
* Implémentation de menus personnalisés
* Implémentation de menus personnalisés
Des démonstrations de tous types de menus dans les menus personnalisés WeChat sont données
À la fin de cet article Comprend tous les codes sources de démonstration des quatre premiers articles de cet article

L'encapsulation de la classe d'outils AccessTokenUtils
L'acquisition et La sauvegarde programmée d'AccessToken a été présentée en détail ci-dessus. Cependant, les AccessTokenUtils encapsulés après traitement sont directement donnés ici, et le principe de mise en œuvre et la lecture du document ne sont plus donnés.
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;
  }
 }
}

Lecture et analyse de menus personnalisés et de documents de menus personnalisés
• Menu personnalisé
◦ Interface de création de menu personnalisée
◦ Interface de requête de menu personnalisée
◦ Interface de suppression de menu personnalisée
◦ Push d'événement de menu personnalisé
◦ Interface de menu personnalisée
◦ Obtenir la configuration du menu de le compte public

•Adresse du document : http://mp.weixin.qq.com/wiki/10/0234e39a2025342c17a7d23595c6b40a.html
•Document du site officiel pour Voici l'explication :
* L'interface du menu personnalisé peut implémenter plusieurs types de boutons, comme suit : 1. clic : événement de clic... ; 2. vue : événement de saut... ; 3.... (À propos du menu de définition personnalisé)
* Description de la demande d'appel d'interface Méthode de requête http : POST (veuillez utiliser le protocole https) https://api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN(À propos menu personnalisé)
* Cliquez et affichez l'exemple de demande {"button":[...]} (À propos du menu personnalisé)
* Description du paramètre... (À propos du menu personnalisé)
* Créer un menu personnalisé http méthode de demande : POST (veuillez utiliser le protocole https) https://api.weixin.qq.com/cgi-bin/menu/addconditional?access_token=ACCESS_TOKEN(À propos de la personnalité Menu personnalisé)
* Demande exemple : {"button":[...],"matchrule":{...}}(À propos du menu personnalisé)
* Description du paramètre... (À propos du menu de personnalisation)
* Les développeurs peuvent définir le menu que les utilisateurs voient (à propos des menus personnalisés) à travers les conditions suivantes :
1. Regroupement d'utilisateurs (les besoins commerciaux du développeur peuvent être complétés à l'aide du regroupement d'utilisateurs)
2, Sexe
3. Système d'exploitation mobile
4. Région (la région définie par l'utilisateur sur le client WeChat)
5. Langue (la langue définie par l'utilisateur sur le client WeChat)

•Compréhension :
◦ C'est une requête POST familière, mais elle semble vague à propos de l'appel, donc je ne la comprends pas très bien. On sait juste qu'il faut utiliser le paramètre "?access_token=ACCESS_TOKEN", que nous avons déjà obtenu dans l'article précédent. Si nous remplaçons le "ACCESS_TOKEN" dans l'adresse de requête donnée par le document WeChat par notre propre ACCESS_TOKEN que nous avons obtenu et que nous visitons l'URL, nous verrons "{"errcode":44002,"errmsg":"indice de données de publication vide : [ Gdveda0984vr23]”}”. Cela signifie probablement des données de demande de publication vides. Par conséquent, nous devons transmettre les paramètres au serveur WeChat sous la forme d'une requête POST. Le format des paramètres est également indiqué sous le document : {"button":[...]}, nous devons donc transmettre les paramètres à le serveur WeChat selon ce format.
◦ Concernant la description des paramètres, nous pouvons voir qu'il y a sept paramètres dans la création de menu personnalisé. En plus de ces sept paramètres, il existe huit autres paramètres dans l'interface du menu personnalisé. En regardant simplement cette partie du document, on comprend que ces huit paramètres sont utilisés pour l'appariement et le filtrage des menus personnalisés.
◦Maintenant, nous devons construire json selon les exigences du document WeChat et envoyer cette chaîne de données json au serveur WeChat via une requête de publication. Le json inclut différents types d'événements de bouton que nous avons créés.

Analyse JSON du menu et construction des beans correspondants
Analyse json du menu personnalisé (hors menus personnalisés). Le code suivant est un exemple donné par la documentation WeChat.
Cliquez et consultez des exemples de demandes

 {
  "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);
// ----

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!