package me.chanjar.weixin.mp.api;

import java.util.List;

import me.chanjar.weixin.common.exception.WxErrorException;
import me.chanjar.weixin.mp.bean.WxMpUserQuery;
import me.chanjar.weixin.mp.bean.result.WxMpUser;
import me.chanjar.weixin.mp.bean.result.WxMpUserList;

/**
 * 用户管理和统计相关操作接口
 *
 * @author Binary Wang
 */
public interface WxMpUserService {

  /**
   * <pre>
   * 设置用户备注名接口
   * 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=设置用户备注名接口
   * </pre>
   *
   * @param openid 用户openid
   * @param remark 备注名
   */
  void userUpdateRemark(String openid, String remark) throws WxErrorException;

  /**
   * <pre>
   * 获取用户基本信息
   * 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=获取用户基本信息
   * </pre>
   *
   * @param openid 用户openid
   * @param lang 语言，zh_CN 简体(默认)，zh_TW 繁体，en 英语
   */
  WxMpUser userInfo(String openid, String lang) throws WxErrorException;

  /**
   * <pre>
   * 获取用户基本信息列表
   * 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=批量获取用户基本信息
   * </pre>
   *
   * @param openid 用户openid, lang 使用默认(zh_CN 简体)
   */
  List<WxMpUser> userInfoList(List<String> openidList) throws WxErrorException;

  /**
   * <pre>
   * 获取用户基本信息列表
   * 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=批量获取用户基本信息
   * </pre>
   *
   * @param userQuery 详细查询参数
   */
  List<WxMpUser> userInfoList(WxMpUserQuery userQuery) throws WxErrorException;

  /**
   * <pre>
   * 获取关注者列表
   * 详情请见: http://mp.weixin.qq.com/wiki/index.php?title=获取关注者列表
   * </pre>
   *
   * @param nextOpenid 可选，第一个拉取的OPENID，null为从头开始拉取
   */
  WxMpUserList userList(String nextOpenid) throws WxErrorException;
}

@@ -32,32 +32,8 @@
 i;%0A%0A
-import java.util.List;%0A%0A
 impo
@@ -241,16 +241,40 @@
 rList;%0A%0A
+import java.util.List;%0A%0A
 /**%0A * %E7%94%A8
@@ -1000,32 +1000,36 @@
  * @param openid
+List
  %E7%94%A8%E6%88%B7openid, lang 
@@ -1025,29 +1025,10 @@
 enid
-, lang %E4%BD%BF%E7%94%A8%E9%BB%98%E8%AE%A4(zh_CN %E7%AE%80%E4%BD%93)
+%E5%88%97%E8%A1%A8
 %0A   

fix javadoc