欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页

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

程序员文章站 2022-07-06 16:18:49
...

一、用户基本信息

在关注者与公众号产生消息交互后,公众号可获得关注者的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(从数据库或者文件)-->再继续查询