您的位置: 首页  >  文章  >  微信公众平台开发实战Java版之微信获取用户基本信息

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

分类: 文章 • 2024-06-27 15:29:10
在关注者与公众号产生消息交互后，公众号可获得关注者的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

参数说明

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

返回说明

正常情况下，微信会返回下述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>  
参数说明:

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


错误时微信会返回错误码等信息，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

相关推荐