Java微信公众平台开发之用户管理(用户基本信息和关注列表)

一、用户基本信息

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

1.根据文档说明，封装用户的基本信息

 

/**
 * 微信用户基本信息
 * @author fjing
 *
 */
public class WeiXinUserInfo {
	private int subscribe;// 用户是否订阅该公众号标识，值为0时，代表此用户没有关注该公众号，拉取不到其余信息。
	private String openid; // 用户的标识，对当前公众号唯一
	private String nickname;// 用户的昵称
	private int sex;// 用户的性别，值为1时是男性，值为2时是女性，值为0时是未知
	private String city;// 用户所在城市
	private String country;// 用户所在国家
	private String province;// 用户所在省份
	private String language;// 用户的语言，简体中文为zh_CN
	private String headimgurl;// 用户头像，最后一个数值代表正方形头像大小（有0、46、64、96、132数值可选，0代表640*640正方形头像），用户没有头像时该项为空。若用户更换头像，原有头像URL将失效。
	private String subscribe_time;// 用户关注时间，为时间戳。如果用户曾多次关注，则取最后关注时间
	private String unionid;// 只有在用户将公众号绑定到微信开放平台帐号后，才会出现该字段。
	private String remark;// 公众号运营者对粉丝的备注，公众号运营者可在微信公众平台用户管理界面对粉丝添加备注
	private int groupid;// 用户所在的分组ID（兼容旧的用户分组接口）
	private String tagid_list; // 用户被打上的标签ID列表
	
	get/set方法
}

2.通过openid获取用户的基本信息

 

private final static String WECHAT_USER_INFO_URL = "ttps://api.weixin.qq.com/cgi-bin/user/info"; //?access_token=ACCESS_TOKEN&openid=OPENID&lang=zh_CN 

/**
 * 获取微信用户基本信息
 * @param accessToken 
 * @param openid 
 * @return
 */
public WeiXinUserInfo getUserInfo(String accessToken, String openid){
	WeiXinUserInfo weixinUserInfo = null;
	Map<String,String> map = new TreeMap<String,String>();
	map.put("access_token", accessToken);
	map.put("openid", openid);
	String result = HttpRequestUtil.HttpsDefaultExecute(HttpRequestUtil.GET_METHOD, WECHAT_USER_INFO_URL, map, "");
	try {
		weixinUserInfo = new Gson().fromJson(result, WeiXinUserInfo.class);
	} catch (JsonSyntaxException e) {
		weixinUserInfo = null;
	}
	return weixinUserInfo;
	
}

3.官方的批量获取我直接无视了

 

二、获取关注列表

公众号可通过本接口来获取帐号的关注者列表，关注者列表由一串OpenID组成。一次拉取调用最多拉取10000个关注者的OpenID，可以通过多次拉取的方式来满足需求。

官方实例

 

当公众号关注者数量超过10000时，可通过填写next_openid的值，从而多次拉取列表的方式来满足需求。
具体而言，就是在调用接口时，将上一次调用得到的返回中的next_openid值，作为下一次调用中的next_openid值。
示例如下：
公众账号A拥有23000个关注的人，想通过拉取关注接口获取所有关注的人，那么分别请求url如下：https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN 返回结果:
{
 "total":23000,
 "count":10000,
 "data":{"
    openid":[
       "OPENID1",
       "OPENID2",
       ...,
       "OPENID10000"
    ]
  },
  "next_openid":"OPENID10000"
}https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID1返回结果:
{
  "total":23000,
  "count":10000,
  "data":{
    "openid":[
      "OPENID10001",
      "OPENID10002",
      ...,
      "OPENID20000"
    ]
  },
  "next_openid":"OPENID20000"
}https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID2返回结果（关注者列表已返回完时，返回next_openid为空）:
{
  "total":23000,
  "count":3000,
  "data":{"
      "openid":[
        "OPENID20001",
        "OPENID20002",
        ...,
        "OPENID23000"
      ]
  },
  "next_openid":"OPENID23000"
}

1.根据返回的json封装实体类

单个openid的WeiXinUserData.java

 

public class WeiXinUserData {

	private List<String> openid;

	public List<String> getOpenid() {
		return openid;
	}

	public void setOpenid(List<String> openid) {
		this.openid = openid;
	}
}

 

WeiXinUserList.java

/**
 * 关注用户列表
 * @author fjing
 *
 */
public class WeiXinUserList {
	// 总关注用户数
	private int total;
	// 获取的OpenId个数
	private int count;
	// OpenId列表
	private WeiXinUserData data;
	// 最后一个用户的openid
	private String next_openid;
	
	get/set方法
}

2.根据接口获取所有的关注者的openid

 

private final static String WECHAT_USER_GET_URL = "https://api.weixin.qq.com/cgi-bin/user/get"; //?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID

public List<String> findWeiXinUserList(List<String> openidList, String accessToken, String nextOpenid){	
	WeiXinUserList weixinUserList = null;
	Map<String,String> map = new TreeMap<String,String>();
	map.put("access_token", accessToken);
	if(StringUtils.isNotBlank(nextOpenid)){
		map.put("next_openid", nextOpenid);
	}
	String result = HttpRequestUtil.HttpsDefaultExecute(HttpRequestUtil.GET_METHOD, WECHAT_USER_GET_URL, map, "");
	if(result != null){
		try {
			weixinUserList = new Gson().fromJson(result, WeiXinUserList.class);
			openidList = new ArrayList<String>();
			if(weixinUserList.getCount() <= 10000 && weixinUserList.getCount() >0){
				openidList.addAll(weixinUserList.getData().getOpenid());
			}else{
				//如果大于10000的,继续查询
				findWeiXinUserList(openidList, accessToken, weixinUserList.getNext_openid());
			}	
		} catch (JsonSyntaxException e) {
			openidList = null;
		}
	}
	return openidList;
}

三、批量获取用户的基本信息

提供一个思想，准备好所有用户的openid -->遍历查询-->如果token过期(错误码识别出)-->重新获取token(从数据库或者文件)-->再继续查询