获取用户信息

let MyUser = new BaaS.User()

获取指定用户信息

MyUser.get(userID)

参数说明

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

返回字段说明

参数类型说明
avatarString用户头像
cityString用户所在城市
countryString用户所在国家
genderString用户的性别，值为 1 时是男性，值为 2 时是女性，值为 0 时是未知
idNumber用户 ID (对应 _userprofile 表中的 id 字段)
languageString用户的语言，简体中文为 zh_CN
nicknameString用户昵称
openidString用户唯一标识，由微信生成
provinceString用户所在省份
unionidString用户在开放平台的唯一标识符，由微信生成

如果有自定义字段，则一并返回

请求示例

  1. let MyUser = new BaaS.User()
  2. let userID = 36395395
  3. MyUser.get(userID).then(res => {
  4.   // success
  5. }, err => {
  6.   // err
  7. })

返回示例

  1. {
  2.   "status": 200,
  3.   "data": {
  4.     "avatar": "https://xxx.jpg",
  5.     "id": 36395395,
  6.     "is_authorized": true,
  7.     "nickname": "姚凯伦",
  8.     "openid": "xxx",
  9.     "unionid": null
  10.   }
  11. }

筛选返回字段

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

扩展字段

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

请求示例

假设 _userprofile 表中有一个类型为 pointer 的字段，名称为 pointer_test_oder, 指向了 test_order 表

  1. let MyUser = new BaaS.User()
  2. MyUser.expand(['pointer_test_oder']).select(['nickname', 'pointer_test_order']).get(123456).then((res) => {
  3. // success
  4. }, (err) => {
  5. // err
  6. })

请求结果

  1. {
  2.   "status": 200,
  3.   "data": {
  4.     "pointer_test_order": {
  5.       "created_at": 1538966895,
  6.       "_table": "test_order",
  7.       "id": "5bbac56fbd66033df7fd0aa2",
  8.       "created_by": 61736923,
  9.       "updated_at": 1538966895
  10.     },
  11.     "nickname": "ifanrx"
  12.   }
  13. }
  1. let MyUser = new wx.BaaS.User()
  2. MyUser.expand(['pointer_test_oder']).select(['nickname', 'pointer_test_order']).find().then((res) => {
  3. // success
  4. }, (err) => {
  5. // err
  6. })

请求结果

  1. {
  2.   "status": 200,
  3.   "data": {
  4.     "meta": {
  5.       "next": null,
  6.       "offset": 0,
  7.       "total_count": 1,
  8.       "limit": 20,
  9.       "previous": null
  10.     },
  11.     "objects": [
  12.       {
  13.         "pointer_test_order": {
  14.           "id": "5bbac56fbd66033df7fd0aa2",
  15.           "_table": "test_order",
  16.           "created_by": 61736923,
  17.           "updated_at": 1538966895
  18.         },
  19.         "nickname": "ifanrx"
  20.       }
  21.     ]
  22.   }
  23. }

微信目前对小程序获取用户信息有两个小时的缓存设定，因此，如果一个用户修改了个人信息如头像、昵称等，需两个小时才能重新授权拿到最新的信息。

更新用户信息

更新用户信息与数据表更新数据项方法基本一致。这里只支持对 _userprofile 表中自定义的字段进行更新。

请求示例

  1. let MyUser = new BaaS.User()
  2. let userID = 36395395
  3. let user = MyUser.getWithoutData(userID)
  5. // age 为自定义字段
  6. user.set('age', 30).update().then(res => {
  7.   // success
  8. }, err => {
  9.   // err
  10. })

查询，获取用户列表

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

请求示例

  1. let MyUser = new BaaS.User()
  3. // 查找所有用户
  4. MyUser.find()
  6. // 查询 nickname 中包含 like 的用户
  7. let query = new BaaS.Query()
  8. query.contains('nickname', 'like')
  9. MyUser.setQuery(query).find().then(res => {
  10.   // success
  11. }, err => {
  12.   // err
  13. })

查询用户组下的用户

_group 是一个系统定义的特殊字段，可以通过 _group 来查询指定用户组下的用户，目前只支持 in 查询。该字段仅支持查询，不支持删除和修改。

  1. let MyUser = new BaaS.User()
  2. let query = new BaaS.Query()
  4. // 查询用户组 [123, 456, 789] 下的用户
  5. query.in('_group', [123, 456, 789])
  7. MyUser.setQuery(query).find().then(res => {
  8.   // success
  9. }, err => {
  10.   // err
  11. })

返回示例

成功时 res 结构如下

  1. {
  2.   "status": 200,
  3.   "data": {
  4.     "meta": {
  5.       "limit": 20,
  6.       "next": null,
  7.       "offset": 0,
  8.       "previous": null,
  9.       "total_count": 3
  10.     },
  11.     "objects": [
  12.       {
  13.         "age": 40,
  14.         "avatar": "https://media.ifanrusercontent.com/tavatar/f1/e8/f1e8da860635ec7386102a4a9bb5e45857c9369e.jpg",
  15.         "city": "Guangzhou",
  16.         "country": "China",
  17.         "created_at": 1513326300,
  18.         "created_by": 36476036,
  19.         "gender": 1,
  20.         "id": 36476036,
  21.         "is_authorized": true,
  22.         "language": "zh_CN",
  23.         "nickname": "yuky123123",
  24.         "openid": "xxxxxxx",
  25.         "province": "Guangdong",
  26.         "unionid": null,
  27.         "updated_at": 1524146181,
  28.         "_group": [123],
  29.         "user_id": 36476036
  30.       }
  31.     ]
  32.   }
  33. }

排序

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

请求示例

  1. let MyUser = new BaaS.User()
  3. MyUser.orderBy('-nickname').find().then()

分页

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

请求示例

  1. let MyUser = new BaaS.User()
  3. MyUser.limit(5).offset(10).find().then()

pointer 引用

使用 wx.BaaS.User().getWithoutData 可以创建一个 _userprofile 指定数据行的引用。主要配合 pointer 功能使用

  1. let user = new BaaS.User().getWithoutData(123456)

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