获取用户信息

获取指定用户信息

Users.user(id)

参数说明

参数类型必填说明
idNumber用户 ID (对应 _userprofile 表中的 id 字段)

返回字段说明

各个字段的值,用户可以通过 getXXX 方法拿到,比如:

当查询的用户为非当前用户时:

参数类型说明
User.AVATARString用户头像
User.IDNumber用户 ID (对应 _userprofile 表中的 id 字段)
User.NICKNAMEString用户昵称

当查询的用户为当前用户时:

参数类型说明
User.AVATARString用户头像
User.CITYString用户所在城市
User.COUNTRYString用户所在国家
User.GENDERNumber用户的性别,值为 1 时是男性,值为 2 时是女性,值为 0 时是未知
User.IDNumber用户 ID (对应 _userprofile 表中的 id 字段)
User.LANGUAGEString用户的语言,简体中文为 zh_CN
User.NICKNAMEString用户昵称
User.OPENIDString用户唯一标识,由微信提供
User.PROVINCEString用户所在省份
User.EMAILString用户邮箱(用于用户以邮箱 & 密码登录)
User.USERNAMEString用户名(用于用户以用户名 & 密码登录)
User.EMAIL_VERIFIEDBoolean用户邮箱是否已经通过验证(已验证邮箱才能找回密码)
User.PROVIDERJSONObject用户在平台方的用户信息

User.PROVIDER 支付宝平台的用户信息对象说明

参数类型说明
user_idstring支付宝小程序用户 user_id
is_studentboolean用户是否是学生
user_typestring用户类型,包括:company_account(公司账户)以及 personal_account (个人账户)
user_statusboolean用户状态,包括:registered(快速注册用户)、authenticated(已认证用户)、frozen(被冻结用户) 以及inactive(已注册,未激活用户)
verifiedboolean用户是否通过实名认证,当且仅当该值为 true 时gender 值才保证准确性
avatarstring支付宝小程序用户头像
provincestring支付宝小程序用户省份
citystring支付宝小程序用户市名称
nicknamestring支付宝小程序用户昵称
genderstring支付宝小程序用户性别,female 为女性,male 为男性

如果有自定义字段,则一并返回(以上两种情况皆是如此)。

请求示例

  1. try {
  2. User potter = Users.user(15549039403);
  3. potter.getString(User.AVATAR);
  4. potter.getInt(User.ID);
  5. // 操作成功
  6. } catch (Exception e) {
  7. Log.d(TAG, e.getMessage(), e);
  8. // 操作失败
  9. }

返回示例

非当前用户:

  1. {
  2. "avatar": "https://media.ifanrusercontent.com/media/tavatar/9a/1d/9a1db7592d6a325a845548f2fecbfb4516e138d0.jpg",
  3. "id": 36395394,
  4. "nickname": "hip hop man"
  5. }

当前用户:

  1. {
  2. "id": 5123461461,
  3. "avatar": "http://cdn.ifanr.cn/ifanr/default_avatar.png",
  4. "nickname": "riDGldYXLHouWIYx",
  5. "_username": "myusername",
  6. "_email": "myemail@somemail.com",
  7. "_email_verified": false,
  8. "_provider": {
  9. "alipay": {
  10. "avatar": "http://tfsimg.alipay.com/images/partner/T1uIxXXbpXXXXXXXX",
  11. "province": "安徽省",
  12. "city": "安庆",
  13. "nick_name": "支付宝小二",
  14. "is_student": true,
  15. "user_type": "company_account",
  16. "user_status": "authenticated",
  17. "verified": true,
  18. "gender": "female"
  19. }
  20. }
  21. }

筛选返回字段

select 使用方法可以参考数据表 - 字段过滤小节

扩展字段

expand 使用方法可以参考数据表 - 字段扩展小节

查询,获取用户列表

用户查询与数据表查询方法一致

请求示例

  1. try {
  2. // 获取所有用户
  3. PagedList<User> all = Users.users(null);
  4. // 获取第一页的用户
  5. Query query = new Query();
  6. query.offset(10);
  7. query.limit(10);
  8. PagedList<User> pageTwo = Users.users(query);
  9. // 操作成功
  10. } catch (Exception e) {
  11. Log.d(TAG, e.getMessage(), e);
  12. // 操作失败
  13. }

排序

用户查询排序与数据表排序方法一致,不包含在返回数据里的字段不支持排序,如 created_at。

请求示例

  1. Query query = new Query().orderBy("-nickname");
  2. PagedList<User> all = Users.users(query);

分页

用户查询分页与数据表分页方法一致。

请求示例

  1. Query query = new Query();
  2. query.offset(10);
  3. query.limit(5);
  4. PagedList<User> pageTwo = Users.users(query);

pointer 引用

创建一个 _userprofile 指定数据行的引用。主要配合 pointer 功能使用

  1. new Table(Const.TABLE_USER_PROFILE).fetchWithoutData("xxxxxxx")

具体使用方法请参考 数据表-添加 pointer 类型数据 小节