[置顶] java微信开发API解析(五)-用户管理

java微信开发API解析(五)-用户管理

全局说明

* 详细说明请参考前两篇文章。

本文说明

*本文分为五部分:
    * 工具类MyHttpUtils的封装
    * 用户分组管理文档的简单阅读解析
    * 分组bean的构建以及各种分组管理的实现源码
    * 用户管理的应用场景
    * 测试的微信号二维码
* 本文只分析用户管理的用户分组管理部分,其它都大同小异,不再分析处理。如需要,请留言。
* 以后原理分析会越来越简洁,具体原理分析请查看以前文章。
* 下一篇文章会对于用户普通消息、自定义菜单消息、自动完成用户分组等进行分析处理。
* 然后的文章是关于微信网页开发部分的分析。

工具类MyHttpUtils的封装

  • 在上篇文章关于自定义菜单的创建以及第三篇文章关于Access_token的处理,我们都用到了Http请求部分的内容。今天,我们简单的抽离,抽离成一个简单的工具类MyHttpUtils
  • MyHttpUtils.java

    package com.gist.utils;
    
    import java.io.IOException;
    import java.io.InputStreamReader;
    import java.io.OutputStreamWriter;
    import java.net.MalformedURLException;
    import java.net.URL;
    
    import javax.net.ssl.HttpsURLConnection;
    
    /**
     * @author 高远</n>
     * 编写日期   2016-4-17下午12:45:37</n>
     * 邮箱  [email protected]</n>
     * 博客  http://blog.csdn.net/wgyscsf</n>
     * TODO</n>
     */
    /*
     * 该工具封装一些请求http的一些常用方法。
     */
    public class MyHttpUtils {
        static String TAG = "MyHttpUtils";// 确定我们打印的数据属于哪个方法
    
        /*
         * 我们封装一个http请求方法,该方法需要传递一个请求的url和一个json数据。返回值是一个json字符串。
         */
        public static String getReturnJson(String url, String osrJson) {
            String reslut = "";// 返回的结果json
            try {
                // 创建一个url
                URL reqURL = new URL(url);
                // 拿取链接
                HttpsURLConnection httpsConn = (HttpsURLConnection) reqURL
                        .openConnection();
                // 当需要参数传递时,才执行该方法
                if (osrJson != null) {
                    httpsConn.setDoOutput(true);
                    // 取得该连接的输出流,以读取响应内容
                    OutputStreamWriter osr = new OutputStreamWriter(
                            httpsConn.getOutputStream());
                    osr.write(osrJson);// 写请求数据
                    osr.close();
                }
    
    
                // 返回结果
                InputStreamReader isr = new InputStreamReader(
                        httpsConn.getInputStream());
                char[] chars = new char[1024];
                int len;
                while ((len = isr.read(chars)) != -1) {
                    reslut += new String(chars, 0, len);
                }
                isr.close();
            } catch (MalformedURLException e) {
                // TODO Auto-generated catch block
                e.printStackTrace();
            } catch (IOException e) {
                // TODO Auto-generated catch block
                e.printStackTrace();
            }
            return reslut;
        }
    }
    

用户分组管理文档的简单阅读解析

  • 用户分组管理
    • 创建分组
    • 查询所有分组
    • 查询用户所在分组
    • 修改分组名
    • 移动用户分组
    • 批量移动用户分组
    • 删除分组
  • 文档地址:http://mp.weixin.qq.com/wiki/8/d6d33cf60bce2a2e4fb10a21be9591b8.html
  • 关于创建分组(其它用户分组管理类似,不再给出),官网文档给出这样解释:

    • 开发者可以使用接口,对公众平台的分组进行查询、创建、修改、删除等操作,也可以使用接口在需要时移动用户到某个分组。
    • 接口调用请求说明

      http请求方式: POST(请使用https协议)
      https://api.weixin.qq.com/cgi-bin/groups/create?access_token=ACCESS_TOKEN
      POST数据格式:json
      POST数据例子:{"group":{"name":"test"}}  
      
    • 返回说明 正常时的返回JSON数据包示例:

      {
          "group": {
              "id": 107, 
              "name": "test"
          }
      }
      
  • 理解:

    • 同样的post请求,同样的json处理,同样的数据返回格式。
    • 我们重点放到关于bean的构建,因为bean格式的正确与否直接影响到我们能否正确进行分组管理。
    • 特别注意,移动用户分组可以是在用户没有分组的时候进行(因为有一个默认分组)。
    • 特别注意,对于没有认证的公众号,是不能进行分组管理的,因为没有权限,会报异常,异常代码是48001,文档给出该代码的解释是“api功能未授权,请确认公众号已获得该接口,可以在公众平台官网-开发者中心页中查看接口权限”。

分组bean的构建以及各种分组管理的实现源码

  • 分组bean的构建

    /*
     * 分组所需要的各种信息
     */
    public class Group {
        private int id;
        private String name;
        private int count;
        private String openid;
        private String to_groupid;
        private String groupid;
    
        //Setter、Getter...
    
    }
    
    
    
    /*
     * 有时候返回是一个list类型;或者是一个类似这样格式的信息:{
     * 'group':{'name':'组名'}},请注意这个json的“group”。常规的bean,转化为json是{'name':'组名'}这样的格式。
     * 我们需要这样一个类进行处理,我们称之为Group联合体。
     */
    public class GroupUnit {
        private Group group;
        private List<Group> groups;
    
        //Setter、Getter...
        }
    
  • 各种分组操作的实现源码

    package com.gist.demo_offline;
    
    import java.util.List;
    
    import org.junit.Test;
    
    import com.gist.bean.Group;
    import com.gist.bean.GroupUnit;
    import com.gist.utils.AccessTokenUtils;
    import com.gist.utils.MyHttpUtils;
    import com.google.gson.Gson;
    
    /**
     * @author 高远</n> 编写日期 2016-4-17下午12:31:32</n> 邮箱 [email protected]</n> 博客
     *         http://blog.csdn.net/wgyscsf</n> TODO</n>
     */
    /*
     * 该类主要测试用户分组管理
     */
    public class GroupManager {
        private static final String TAG = "GroupManager";
    
        /*
         * 测试创建分组
         */
        @Test
        public void createGroup() {
            String ACCESS_TOKEN = AccessTokenUtils.getSavedAccess_token();// 获取我们保存且实时更新的ACCESS_TOKEN,实现原理参看第三篇文章
            String url = "https://api.weixin.qq.com/cgi-bin/groups/create?access_token="
                    + ACCESS_TOKEN;// 请求路径
            // String osrJson = "{'group':{'name':'组名'}}";// 简单测试,不再封装对应bean
            // 创建分组群组
            GroupUnit groupUnit = new GroupUnit();
            // 创建分组对象
            Group group = new Group();
            group.setName("测试组名");// 设置新建组名
            groupUnit.setGroup(group);
            Gson gson = new Gson();
            String osrJson = gson.toJson(groupUnit);
            System.out.println(osrJson);
            String returnJson = MyHttpUtils.getReturnJson(url, osrJson);// 我们封装的http工具类
            System.out.println(TAG + "返回结果:" + returnJson);
        }
    
        /*
         * 测试查询所有分组
         */
        @Test
        public void showAllGroup() {
            String ACCESS_TOKEN = AccessTokenUtils.getSavedAccess_token();// 获取我们保存且实时更新的ACCESS_TOKEN,实现原理参看第三篇文章
            String url = "https://api.weixin.qq.com/cgi-bin/groups/get?access_token="
                    + ACCESS_TOKEN;// 请求路径
            String returnJson = MyHttpUtils.getReturnJson(url, null);// 我们封装的http工具类
            System.out.println(TAG + "返回结果:" + returnJson);
    
            /*
             * 我们对返回的数据进行封装
             */
            GroupUnit groupUnit = new GroupUnit();
            Gson gson = new Gson();
            groupUnit = gson.fromJson(returnJson, groupUnit.getClass());
            List<Group> groups = groupUnit.getGroups();
            for (Group group : groups) {
                System.out.println(TAG + ":组名" + group.getName());
            }
        }
    
        /*
         * 该方法测试得到用户所在的分组id,需要传递过来一个用户openid
         */
        public static String getGroup(String openid) {
    
            String ACCESS_TOKEN = AccessTokenUtils.getSavedAccess_token();// 获取我们保存且实时更新的ACCESS_TOKEN,实现原理参看第三篇文章
            String url = "https://api.weixin.qq.com/cgi-bin/groups/getid?access_token="
                    + ACCESS_TOKEN;// 请求路径
            String osrJson = "{\"openid\":\"" + openid + "\"}";// 简单json,不再封装
            System.out.println(osrJson);
            String returnJson = MyHttpUtils.getReturnJson(url, osrJson);// 我们封装的http工具类
            System.out.println(TAG + "返回结果:" + returnJson);
            /*
             * 封装返回结果
             */
            Group goup = new Group();
            Gson gson = new Gson();
            goup = gson.fromJson(returnJson, goup.getClass());
            return goup.getGroupid();
    
        }
    
        /*
         * 该方法测试将用户移动到指定分组
         */
        public static String updateGroup(String openid, String to_groupid) {
            String ACCESS_TOKEN = AccessTokenUtils.getSavedAccess_token();// 获取我们保存且实时更新的ACCESS_TOKEN,实现原理参看第三篇文章
            String url = "https://api.weixin.qq.com/cgi-bin/groups/members/update?access_token="
                    + ACCESS_TOKEN;// 请求路径
            // 封装请求数据
            Group group = new Group();
            group.setOpenid(openid);
            group.setTo_groupid(to_groupid);
            Gson gson = new Gson();
            String osrJson = gson.toJson(group);
            System.out.println(TAG + osrJson);
    
            String returnJson = MyHttpUtils.getReturnJson(url, osrJson);// 我们封装的http工具类
            System.out.println(TAG + "返回结果:" + returnJson);
    
            return returnJson;
    
        }
    
        /**
         * TODO
         */
        public static void main(String[] args) {
    
            // 移动分组
            String msg = updateGroup("obM1Qt2oWq3K1FD6MIM1ImCm5ZZE", 101 + "");
            System.out.println(msg);
            // 获取用户分组id
            String id = getGroup("obM1Qt2oWq3K1FD6MIM1ImCm5ZZE");
            System.out.println(id);
        }
    
    }
    

用户管理的应用场景

  • 应用一:假如一个公众号需要根据分组给用户提供相应的服务,这个时候人工去一个一个实现分组,甚至需要和用户沟通,太麻烦。我们可以在用户关注该公众号时要求用户根据指令(比如:1、2)进行自动分组,可以省去很大人工分组的麻烦,并且不需要和用户沟通即可以实现。
  • 应用二:假如我们想要设置用户备注,可以通过该部分知识,实现“智能化”,让用户自动设置自己的备注名。
  • 应用三:对于深度定制的微信公众号第三方平台,这部分很重要。比如显示用户分组、显示用户个人信息、自动化分组、改名、添加分组等。

测试的微信号二维码

  • 测试号二维码

  • 个人技术学习公众号,欢迎关注

你可能感兴趣的:(java学习方法,java微信开发,微信分组管理,微信文档阅读,微信用户管理)