微信公众平台开发实战Java版之微信获取用户基本信息

在关注者与公众号产生消息交互后，公众号可获得关注者的OpenID（加密后的微信号，每个用户对每个公众号的OpenID是唯一的。对于不同公众号，同一用户的openid不同）。

公众号可通过本接口来根据OpenID获取用户基本信息，包括昵称、头像、性别、所在城市、语言和关注时间。

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

我们可以看看官方的文档：获取用户的基本信息。

接口调用请求说明

http请求方式: GET

https://api.weixin.qq.com/cgi-bin/user/info?access_token=ACCESS_TOKEN&openid=OPENID&lang=zh_CN

参数说明

返回说明

正常情况下，微信会返回下述JSON数据包给公众号：

[java]  view plain  copy

1. <span style="font-size:18px;">{  
2.   "subscribe": 1,   
3.   "openid": "o6_bmjrPTlm6_2sgVt7hMZOPfL2M",   
4.   "nickname": "Band",   
5.   "sex": 1,   
6.   "language": "zh_CN",   
7.   "city": "广州",   
8.   "province": "广东",   
9.   "country": "中国",   
10.   "headimgurl":  "http://wx.qlogo.cn/mmopen/g3MonUZtNHkdmzicIlibx6iaFqAc56vxLSUfpb6n5WKSYVY0ChQKkiaJSgQ1dZuTOgvLLrhJbERQQ4eMsv84eavHiaiceqxibJxCfHe/0",   
11.   "subscribe_time": 1382694957,  
12.   "unionid": " o6_bmasdasdsad6_2sgVt7hMZOPfL"  
13.   "remark": "",  
14.   "groupid": 0  
15. }</span>  

参数说明:

错误时微信会返回错误码等信息，JSON数据包示例如下（该示例为AppID无效错误）:

[java]  view plain  copy

1. <span style="font-size:18px;">{"errcode":40013,"errmsg":"invalid appid"}</span>  

根据上面的信息，我们定义一个用户信息类来存放用户的基本信息。

[java]  view plain  copy

1. <span style="font-size:18px;">package com.souvc.weixin.pojo;  
2. /** 
3. * 类名: WeixinUserInfo </br> 
4. * 描述: 微信用户的基本信息 </br> 
5. * 开发人员： souvc </br> 
6. * 创建时间： 2015-11-27 </br> 
7. * 发布版本：V1.0 </br> 
8.  */  
9. public class WeixinUserInfo {  
10.   // 用户的标识  
11.   private String openId;  
12.   // 关注状态（1是关注，0是未关注），未关注时获取不到其余信息  
13.   private int subscribe;  
14.   // 用户关注时间，为时间戳。如果用户曾多次关注，则取最后关注时间  
15.   private String subscribeTime;  
16.   // 昵称  
17.   private String nickname;  
18.   // 用户的性别（1是男性，2是女性，0是未知）  
19.   private int sex;  
20.   // 用户所在国家  
21.   private String country;  
22.   // 用户所在省份  
23.   private String province;  
24.   // 用户所在城市  
25.   private String city;  
26.   // 用户的语言，简体中文为zh_CN  
27.   private String language;  
28.   // 用户头像  
29.   private String headImgUrl;  
30.   public String getOpenId() {  
31.     return openId;  
32.   }  
33.   public void setOpenId(String openId) {  
34.     this.openId = openId;  
35.   }  
36.   public int getSubscribe() {  
37.     return subscribe;  
38.   }  
39.   public void setSubscribe(int subscribe) {  
40.     this.subscribe = subscribe;  
41.   }  
42.   public String getSubscribeTime() {  
43.     return subscribeTime;  
44.   }  
45.   public void setSubscribeTime(String subscribeTime) {  
46.     this.subscribeTime = subscribeTime;  
47.   }  
48.   public String getNickname() {  
49.     return nickname;  
50.   }  
51.   public void setNickname(String nickname) {  
52.     this.nickname = nickname;  
53.   }  
54.   public int getSex() {  
55.     return sex;  
56.   }  
57.   public void setSex(int sex) {  
58.     this.sex = sex;  
59.   }  
60.   public String getCountry() {  
61.     return country;  
62.   }  
63.   public void setCountry(String country) {  
64.     this.country = country;  
65.   }  
66.   public String getProvince() {  
67.     return province;  
68.   }  
69.   public void setProvince(String province) {  
70.     this.province = province;  
71.   }  
72.   public String getCity() {  
73.     return city;  
74.   }  
75.   public void setCity(String city) {  
76.     this.city = city;  
77.   }  
78.   public String getLanguage() {  
79.     return language;  
80.   }  
81.   public void setLanguage(String language) {  
82.     this.language = language;  
83.   }  
84.   public String getHeadImgUrl() {  
85.     return headImgUrl;  
86.   }  
87.   public void setHeadImgUrl(String headImgUrl) {  
88.     this.headImgUrl = headImgUrl;  
89.   }  
90. }</span>  

我们先来看看获取用户信息的接口：

https://api.weixin.qq.com/cgi-bin/user/info?access_token=ACCESS_TOKEN&openid=OPENID&lang=zh_CN

根据分析，获取用户的基本信息需要一个token。

[java]  view plain  copy

1. <span style="font-size:18px;">package com.souvc.weixin.pojo;  
2. /** 
3. * 类名: Token </br> 
4. * 描述: 凭证 </br> 
5. * 开发人员： souvc </br> 
6. * 创建时间： 2015-11-27 </br> 
7. * 发布版本：V1.0 </br> 
8.  */  
9. public class Token {  
10.   // 接口访问凭证  
11.   private String accessToken;  
12.   // 凭证有效期，单位：秒  
13.   private int expiresIn;  
14.   public String getAccessToken() {  
15.     return accessToken;  
16.   }  
17.   public void setAccessToken(String accessToken) {  
18.     this.accessToken = accessToken;  
19.   }  
20.   public int getExpiresIn() {  
21.     return expiresIn;  
22.   }  
23.   public void setExpiresIn(int expiresIn) {  
24.     this.expiresIn = expiresIn;  
25.   }  
26. }</span>  

https请求，需要的信任管理器:

[java]  view plain  copy

1. <span style="font-size:18px;">package com.souvc.weixin.util;  
2. import java.security.cert.CertificateException;  
3. import java.security.cert.X509Certificate;  
4. import javax.net.ssl.X509TrustManager;  
5. /** 
6. * 类名: MyX509TrustManager </br> 
7. * 描述:信任管理器 </br> 
8. * 开发人员： souvc </br> 
9. * 创建时间： 2015-11-27 </br> 
10. * 发布版本：V1.0 </br> 
11.  */  
12. public class MyX509TrustManager implements X509TrustManager {  
13.   // 检查客户端证书  
14.   public void checkClientTrusted(X509Certificate[] chain, String authType) throws CertificateException {  
15.   }  
16.   // 检查服务器端证书  
17.   public void checkServerTrusted(X509Certificate[] chain, String authType) throws CertificateException {  
18.   }  
19.   // 返回受信任的X509证书数组  
20.   public X509Certificate[] getAcceptedIssuers() {  
21.     return null;  
22.   }  
23. }</span>  

封装了一个公共类：

[java]  view plain  copy

1. <span style="font-size:18px;">package com.souvc.weixin.util;  
2. import java.io.BufferedReader;  
3. import java.io.InputStream;  
4. import java.io.InputStreamReader;  
5. import java.io.OutputStream;  
6. import java.io.UnsupportedEncodingException;  
7. import java.net.ConnectException;  
8. import java.net.URL;  
9. import javax.net.ssl.HttpsURLConnection;  
10. import javax.net.ssl.SSLContext;  
11. import javax.net.ssl.SSLSocketFactory;  
12. import javax.net.ssl.TrustManager;  
13. import net.sf.json.JSONException;  
14. import net.sf.json.JSONObject;  
15. import org.slf4j.Logger;  
16. import org.slf4j.LoggerFactory;  
17. import com.souvc.weixin.pojo.Token;  
18. /** 
19. * 类名: CommonUtil </br> 
20. * 描述: 通用工具类 </br> 
21. * 开发人员： souvc </br> 
22. * 创建时间： 2015-11-27 </br> 
23. * 发布版本：V1.0 </br> 
24.  */  
25. public class CommonUtil {  
26.   private static Logger log = LoggerFactory.getLogger(CommonUtil.class);  
27.   // 凭证获取（GET）  
28.   public final static String token_url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET";  
29.   /** 
30.    * 发送https请求 
31.    *  
32.    * @param requestUrl 请求地址 
33.    * @param requestMethod 请求方式（GET、POST） 
34.    * @param outputStr 提交的数据 
35.    * @return JSONObject(通过JSONObject.get(key)的方式获取json对象的属性值) 
36.    */  
37.   public static JSONObject httpsRequest(String requestUrl, String requestMethod, String outputStr) {  
38.     JSONObject jsonObject = null;  
39.     try {  
40.       // 创建SSLContext对象，并使用我们指定的信任管理器初始化  
41.       TrustManager[] tm = { new MyX509TrustManager() };  
42.       SSLContext sslContext = SSLContext.getInstance("SSL", "SunJSSE");  
43.       sslContext.init(null, tm, new java.security.SecureRandom());  
44.       // 从上述SSLContext对象中得到SSLSocketFactory对象  
45.       SSLSocketFactory ssf = sslContext.getSocketFactory();  
46.       URL url = new URL(requestUrl);  
47.       HttpsURLConnection conn = (HttpsURLConnection) url.openConnection();  
48.       conn.setSSLSocketFactory(ssf);  
49.       conn.setDoOutput(true);  
50.       conn.setDoInput(true);  
51.       conn.setUseCaches(false);  
52.       // 设置请求方式（GET/POST）  
53.       conn.setRequestMethod(requestMethod);  
54.       // 当outputStr不为null时向输出流写数据  
55.       if (null != outputStr) {  
56.         OutputStream outputStream = conn.getOutputStream();  
57.         // 注意编码格式  
58.         outputStream.write(outputStr.getBytes("UTF-8"));  
59.         outputStream.close();  
60.       }  
61.       // 从输入流读取返回内容  
62.       InputStream inputStream = conn.getInputStream();  
63.       InputStreamReader inputStreamReader = new InputStreamReader(inputStream, "utf-8");  
64.       BufferedReader bufferedReader = new BufferedReader(inputStreamReader);  
65.       String str = null;  
66.       StringBuffer buffer = new StringBuffer();  
67.       while ((str = bufferedReader.readLine()) != null) {  
68.         buffer.append(str);  
69.       }  
70.       // 释放资源  
71.       bufferedReader.close();  
72.       inputStreamReader.close();  
73.       inputStream.close();  
74.       inputStream = null;  
75.       conn.disconnect();  
76.       jsonObject = JSONObject.fromObject(buffer.toString());  
77.     } catch (ConnectException ce) {  
78.       log.error("连接超时：{}", ce);  
79.     } catch (Exception e) {  
80.       log.error("https请求异常：{}", e);  
81.     }  
82.     return jsonObject;  
83.   }  
84.   /** 
85.    * 获取接口访问凭证 
86.    *  
87.    * @param appid 凭证 
88.    * @param appsecret 密钥 
89.    * @return 
90.    */  
91.   public static Token getToken(String appid, String appsecret) {  
92.     Token token = null;  
93.     String requestUrl = token_url.replace("APPID", appid).replace("APPSECRET", appsecret);  
94.     // 发起GET请求获取凭证  
95.     JSONObject jsonObject = httpsRequest(requestUrl, "GET", null);  
96.     if (null != jsonObject) {  
97.       try {  
98.         token = new Token();  
99.         token.setAccessToken(jsonObject.getString("access_token"));  
100.         token.setExpiresIn(jsonObject.getInt("expires_in"));  
101.       } catch (JSONException e) {  
102.         token = null;  
103.         // 获取token失败  
104.         log.error("获取token失败 errcode:{} errmsg:{}", jsonObject.getInt("errcode"), jsonObject.getString("errmsg"));  
105.       }  
106.     }  
107.     return token;  
108.   }  
109.   /** 
110.    * URL编码（utf-8） 
111.    *  
112.    * @param source 
113.    * @return 
114.    */  
115.   public static String urlEncodeUTF8(String source) {  
116.     String result = source;  
117.     try {  
118.       result = java.net.URLEncoder.encode(source, "utf-8");  
119.     } catch (UnsupportedEncodingException e) {  
120.       e.printStackTrace();  
121.     }  
122.     return result;  
123.   }  
124.   /** 
125.    * 根据内容类型判断文件扩展名 
126.    *  
127.    * @param contentType 内容类型 
128.    * @return 
129.    */  
130.   public static String getFileExt(String contentType) {  
131.     String fileExt = "";  
132.     if ("image/jpeg".equals(contentType))  
133.       fileExt = ".jpg";  
134.     else if ("audio/mpeg".equals(contentType))  
135.       fileExt = ".mp3";  
136.     else if ("audio/amr".equals(contentType))  
137.       fileExt = ".amr";  
138.     else if ("video/mp4".equals(contentType))  
139.       fileExt = ".mp4";  
140.     else if ("video/mpeg4".equals(contentType))  
141.       fileExt = ".mp4";  
142.     return fileExt;  
143.   }  
144. }</span>  

获取用户基本信息的方法：

[java]  view plain  copy

1. <span style="font-size:18px;">/** 
2.    * 获取用户信息 
3.    *  
4.    * @param accessToken 接口访问凭证 
5.    * @param openId 用户标识 
6.    * @return WeixinUserInfo 
7.    */  
8.   public static WeixinUserInfo getUserInfo(String accessToken, String openId) {  
9.     WeixinUserInfo weixinUserInfo = null;  
10.     // 拼接请求地址  
11.     String requestUrl = "https://api.weixin.qq.com/cgi-bin/user/info?access_token=ACCESS_TOKEN&openid=OPENID";  
12.     requestUrl = requestUrl.replace("ACCESS_TOKEN", accessToken).replace("OPENID", openId);  
13.     // 获取用户信息  
14.     JSONObject jsonObject = CommonUtil.httpsRequest(requestUrl, "GET", null);  
15.     if (null != jsonObject) {  
16.       try {  
17.         weixinUserInfo = new WeixinUserInfo();  
18.         // 用户的标识  
19.         weixinUserInfo.setOpenId(jsonObject.getString("openid"));  
20.         // 关注状态（1是关注，0是未关注），未关注时获取不到其余信息  
21.         weixinUserInfo.setSubscribe(jsonObject.getInt("subscribe"));  
22.         // 用户关注时间  
23.         weixinUserInfo.setSubscribeTime(jsonObject.getString("subscribe_time"));  
24.         // 昵称  
25.         weixinUserInfo.setNickname(jsonObject.getString("nickname"));  
26.         // 用户的性别（1是男性，2是女性，0是未知）  
27.         weixinUserInfo.setSex(jsonObject.getInt("sex"));  
28.         // 用户所在国家  
29.         weixinUserInfo.setCountry(jsonObject.getString("country"));  
30.         // 用户所在省份  
31.         weixinUserInfo.setProvince(jsonObject.getString("province"));  
32.         // 用户所在城市  
33.         weixinUserInfo.setCity(jsonObject.getString("city"));  
34.         // 用户的语言，简体中文为zh_CN  
35.         weixinUserInfo.setLanguage(jsonObject.getString("language"));  
36.         // 用户头像  
37.         weixinUserInfo.setHeadImgUrl(jsonObject.getString("headimgurl"));  
38.       } catch (Exception e) {  
39.         if (0 == weixinUserInfo.getSubscribe()) {  
40.           log.error("用户{}已取消关注", weixinUserInfo.getOpenId());  
41.         } else {  
42.           int errorCode = jsonObject.getInt("errcode");  
43.           String errorMsg = jsonObject.getString("errmsg");  
44.           log.error("获取用户信息失败 errcode:{} errmsg:{}", errorCode, errorMsg);  
45.         }  
46.       }  
47.     }  
48.     return weixinUserInfo;  
49.   }</span>  

测试的方法：注意将以下替换为自己的appid和秘钥。

[java]  view plain  copy

1. <span style="font-size:18px;">public static void main(String args[]) {  
2.     // 获取接口访问凭证  
3.     String accessToken = CommonUtil.getToken("xxxx", "xxxx").getAccessToken();  
4.     /** 
5.      * 获取用户信息 
6.      */  
7.     WeixinUserInfo user = getUserInfo(accessToken, "ooK-yuJvd9gEegH6nRIen-gnLrVw");  
8.     System.out.println("OpenID：" + user.getOpenId());  
9.     System.out.println("关注状态：" + user.getSubscribe());  
10.     System.out.println("关注时间：" + user.getSubscribeTime());  
11.     System.out.println("昵称：" + user.getNickname());  
12.     System.out.println("性别：" + user.getSex());  
13.     System.out.println("国家：" + user.getCountry());  
14.     System.out.println("省份：" + user.getProvince());  
15.     System.out.println("城市：" + user.getCity());  
16.     System.out.println("语言：" + user.getLanguage());  
17.     System.out.println("头像：" + user.getHeadImgUrl());  
18.   }</span>  

效果如下：
OpenID：ooK-yuJvd9gEegH6nRIen-gnLrVw
关注状态：1
关注时间：1449021142
昵称：风少
性别：1
国家：中国
省份：广东
城市：广州
语言：zh_CN
头像：http://wx.qlogo.cn/mmopen/lOZIEvyfCa7aZQ7CkiamdpQicUDnGDEC0nzb7ZALjdl3TzFVFEHWM1AFqEXnicNIDeh0IQYTt0NrIP06ibg4W5WflASfFfX9qqib0/0