玩玩微信公众号Java版之五：获取关注用户信息

　　在关注者与公众号产生消息交互后，公众号可获得关注者的OpenID（加密后的微信号，每个用户对每个公众号的OpenID是唯一的。对于不同公众号，同一用户的openid不同）。公众号可通过本接口来根据OpenID获取用户基本信息，包括昵称、头像、性别、所在城市、语言和关注时间。

请注意，如果开发者有在多个公众号，或在公众号、移动应用之间统一用户帐号的需求，需要前往微信开放平台（open.weixin.qq.com）绑定公众号后，才可利用UnionID机制来满足上述需求。

UnionID机制说明：

　　开发者可通过OpenID来获取用户基本信息。特别需要注意的是，如果开发者拥有多个移动应用、网站应用和公众帐号，可通过获取用户基本信息中的unionid来区分用户的唯一性，因为只要是同一个微信开放平台帐号下的移动应用、网站应用和公众帐号，用户的unionid是唯一的。换句话说，同一用户，对同一个微信开放平台下的不同应用，unionid是相同的。 

获取用户基本信息（包括UnionID机制）

开发者可通过OpenID来获取用户基本信息。请使用https协议。

接口调用请求说明

http请求方式: GET https://api.weixin.qq.com/cgi-bin/user/info?access_token=ACCESS_TOKEN&openid=OPENID&lang=zh_CN

参数说明

参数	是否必须	说明
access_token	是	调用接口凭证
openid	是	普通用户的标识，对当前公众号唯一
lang	否	返回国家地区语言版本，zh_CN 简体，zh_TW 繁体，en 英语

 

或者是批量获取用户基本信息

批量获取用户基本信息

开发者可通过该接口来批量获取用户基本信息。最多支持一次拉取100条。

接口调用请求说明

http请求方式: POST

https://api.weixin.qq.com/cgi-bin/user/info/batchget?access_token=ACCESS_TOKEN

POST数据示例

{

   "user_list": [

       {

           "openid": "otvxTs4dckWG7imySrJd6jSi0CWE",

           "lang": "zh_CN"

       },

       {

           "openid": "otvxTs_JZ6SEiP0imdhpi50fuSZg",

           "lang": "zh_CN"

       }

   ]

}

参数说明

参数	是否必须	说明
openid	是	用户的标识，对当前公众号唯一
lang	否	国家地区语言版本，zh_CN 简体，zh_TW 繁体，en 英语，默认为zh-CN

 

通过这2个接口，可以发现要获取用户信息必要要获取用户关注公众号的 openid，那么首先要获取对应的openid，涉及到另外一个接口：

获取用户列表

公众号可通过本接口来获取帐号的关注者列表，关注者列表由一串OpenID（加密后的微信号，每个用户对每个公众号的OpenID是唯一的）组成。一次拉取调用最多拉取10000个关注者的OpenID，可以通过多次拉取的方式来满足需求。

接口调用请求说明

http请求方式: GET（请使用https协议）

https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID

参数	是否必须	说明
access_token	是	调用接口凭证
next_openid	是	第一个拉取的OPENID，不填默认从头开始拉取

返回说明

正确时返回JSON数据包：

{"total":2,"count":2,"data":{"openid":["","OPENID1","OPENID2"]},"next_openid":"NEXT_OPENID"}

参数	说明
total	关注该公众账号的总用户数
count	拉取的OPENID个数，最大值为10000
data	列表数据，OPENID的列表
next_openid	拉取列表的最后一个用户的OPENID

 

这样可以获取到公众号的关注着列表. 获取到openid后即可获取用户的明细信息。

 

功能实现

分析完接口参数及调用方式，下面就来进行实现吧~

可以定义一个用户信息类，这样后续处理用户信息或存储到数据库均较方便，主要属性可按接口返回字段进行定义：

 /**
  * 微信用户信息类
  * @author Damon
  */
 public class UserInfo
 {

     // 用户的标识
     private String openId;

     // 关注状态（1是关注，0是未关注），未关注时获取不到其余信息
     private int subscribe;

     // 用户关注时间，为时间戳。如果用户曾多次关注，则取最后关注时间
     private int subscribetime;

     // 昵称
     private String nickname;

     // 用户的性别（1是男性，2是女性，0是未知）
     private int sex;

     // 用户所在国家
     private String country;

     // 用户所在省份
     private String province;

     // 用户所在城市
     private String city;

     // 用户的语言，简体中文为zh_CN
     private String language;

     // 用户头像
     private String headimgurl;

     private String remark;

     private int groupid;

     public String getOpenId()
     {
         return openId;
     }

     public void setOpenId(String openId)
     {
         this.openId = openId;
     }

     public int getSubscribe()
     {
         return subscribe;
     }

     public void setSubscribe(int subscribe)
     {
         this.subscribe = subscribe;
     }

     public int getSubscribetime()
     {
         return subscribetime;
     }

     public void setSubscribetime(int subscribetime)
     {
         this.subscribetime = subscribetime;
     }

     public String getNickname()
     {
         return nickname;
     }

     public void setNickname(String nickname)
     {
         this.nickname = nickname;
     }

     public int getSex()
     {
         return sex;
     }

     public void setSex(int sex)
     {
         this.sex = sex;
     }

     public String getCountry()
     {
         return country;
     }

     public void setCountry(String country)
     {
         this.country = country;
     }

     public String getProvince()
     {
         return province;
     }

     public void setProvince(String province)
     {
         this.province = province;
     }

     public String getCity()
     {
         return city;
     }

     public void setCity(String city)
     {
         this.city = city;
     }

     public String getLanguage()
     {
         return language;
     }

     public void setLanguage(String language)
     {
         this.language = language;
     }

     public String getHeadimgurl()
     {
         return headimgurl;
     }

     public void setHeadimgurl(String headimgurl)
     {
         this.headimgurl = headimgurl;
     }

     public String getRemark()
     {
         return remark;
     }

     public void setRemark(String remark)
     {
         this.remark = remark;
     }

     public int getGroupid()
     {
         return groupid;
     }

     public void setGroupid(int groupid)
     {
         this.groupid = groupid;
     }

 }

 然后就是具体的实现方法了，其实很简单，就是先后调用2次接口就行了：

 首先的要调用获取用户openid的列表：

     /**
      * 获取公众号关注的用户openid
      * @return
      */
     public List<String> getUserOpenId(String access_token, String nextOpenid)
     {
         String path = "https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID";
         path = path.replace("ACCESS_TOKEN", access_token).replace("NEXT_OPENID", nextOpenid);
         System.out.println("path:" + path);

         List<String> result = null;
         try
         {
             String strResp = WeChatUtil.doHttpsGet(path, "");
             System.out.println(strResp);

             Map map = WeChatUtil.jsonToMap(strResp);
             Map tmapMap = (Map) map.get("data");

             result = (List<String>) tmapMap.get("openid");

             System.out.println(result.toString());

         }
         catch (HttpException e)
         {
             // TODO Auto-generated catch block
             e.printStackTrace();
         }
         catch (IOException e)
         {
             // TODO Auto-generated catch block
             e.printStackTrace();
         }

         return result;
     }

获取到openi的信息后，也可以先存储起来（具体看项目需要了），或再等详细信息后才存储，

对应的调用方法如下：

     /**
      * 通过用户openid 获取用户信息
      * @param userOpenids
      * @return
      */
     public List<UserInfo> getUserInfo(List<String> userOpenids)
     {
         // 1、获取access_token
         // 使用测试 wx9015ccbcccf8d2f5 02e3a6877fa5fdeadd78d0f6f3048245
         WeChatTokenService tWeChatTokenService = new WeChatTokenService();
         String tAccess_Token = tWeChatTokenService.getToken("wx9015ccbcccf8d2f5", "02e3a6877fa5fdeadd78d0f6f3048245").getToken();

         // 2、封装请求数据
         List user_list = new ArrayList<Map>();
         for (int i = 0; i < userOpenids.size(); i++)
         {
             String openid = userOpenids.get(i);
             Map tUserMap = new HashMap<String, String>();
             tUserMap.put("openid", openid);
             tUserMap.put("lang", "zh_CN");
             user_list.add(tUserMap);
         }
         System.out.println(user_list.toString());
         Map requestMap = new HashMap<String, List>();
         requestMap.put("user_list", user_list);
         String tUserJSON = JSONObject.fromObject(requestMap).toString();

         // 3、请求调用
         String result = getUserInfobyHttps(tAccess_Token, tUserJSON);
         System.out.println(result);

         // 4、解析返回将结果
         return parseUserInfo(result);
     }

其中详细方法实现如下：

     /**
      * 解析返回用户信息数据
      * @param userInfoJSON
      * @return
      */
     private List<UserInfo> parseUserInfo(String userInfoJSON)
     {
         List user_info_list = new ArrayList<UserInfo>();

         Map tMapData = WeChatUtil.jsonToMap(userInfoJSON);

         List<Map> tUserMaps = (List<Map>) tMapData.get("user_info_list");

         for (int i = 0; i < tUserMaps.size(); i++)
         {
             UserInfo tUserInfo = new UserInfo();
             tUserInfo.setSubscribe((Integer) tUserMaps.get(i).get("subscribe"));
             tUserInfo.setSex((Integer) tUserMaps.get(i).get("sex"));
             tUserInfo.setOpenId((String) tUserMaps.get(i).get("openid"));
             tUserInfo.setNickname((String) tUserMaps.get(i).get("nickname"));
             tUserInfo.setLanguage((String) tUserMaps.get(i).get("language"));
             tUserInfo.setCity((String) tUserMaps.get(i).get("city"));
             tUserInfo.setProvince((String) tUserMaps.get(i).get("province"));
             tUserInfo.setCountry((String) tUserMaps.get(i).get("country"));
             tUserInfo.setHeadimgurl((String) tUserMaps.get(i).get("headimgurl"));
             tUserInfo.setSubscribetime((Integer) tUserMaps.get(i).get("subscribe_time"));
             tUserInfo.setRemark((String) tUserMaps.get(i).get("remark"));
             tUserInfo.setGroupid((Integer) tUserMaps.get(i).get("groupid"));
             user_info_list.add(tUserInfo);
         }

         return user_info_list;
     }

     /**
      * 调用HTTPS接口，获取用户详细信息
      * @param access_token
      * @param requestData
      * @return
      */
     private String getUserInfobyHttps(String access_token, String requestData)
     {
         // 返回报文
         String strResp = "";
         String path = "https://api.weixin.qq.com/cgi-bin/user/info/batchget?access_token=ACCESS_TOKEN";
         path = path.replace("ACCESS_TOKEN", access_token);

         try
         {
             strResp = WeChatUtil.doHttpsPost(path, requestData);
         }
         catch (HttpException e)
         {
             // 发生致命的异常，可能是协议不对或者返回的内容有问题
             System.out.println("Please check your provided http address!" + e);
             e.printStackTrace();
         }
         catch (IOException e)
         {
             // 发生网络异常
         }
         catch (Exception e)
         {
             System.out.println(e);
         }
         finally
         {}
         return strResp;
     }

测试方法如下：

     public static void main(String[] args)
     {
         WeChatUserService tChatUserService = new WeChatUserService();
         tChatUserService.getUserInfo(tChatUserService.getUserOpenId(new WeChatTokenService().getToken("appid", "appSceret").getToken(), ""));
     }

最终获取数据结果：

 

可用把最终过去的用户信息存到数据库，后面的就由大家去发挥啦！