玩玩微信公眾號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(), ""));
    }

最終獲取數據結果：

 

 可用把最終過去的用戶信息存到數據庫，后面的就由大家去發揮啦！