本篇文档介绍如何使用规则表达式对 Wilddog Sync 进行数据读写权限控制、用户访问控制、数据校验及数据索引。

规则表达式包含以下四种类型：

读写权限控制

.read .write 用于设置数据的读写权限。

例如，声明 /foo 节点的读写权限：true 为允许，false 为禁止：

{
  "rules": {
    "foo": {
      ".read": true,
      ".write": false
    }
  }
}

用户访问控制

规则表达式可以控制每个用户对数据的访问权限。

例如，授权用户在 /users/<uid> 写入数据，使用 内置对象 中的 auth 获取用户：

{
  "rules": {
    "users": {
      "$uid": {
        ".write": "$uid === auth.uid"
      }
    }
  }
}

数据校验

.validate 用于校验数据的合法性，只允许写入符合规则的数据。

例如，只允许写入字符串类型，并且长度 < 100 的值：

{
  "rules": {
    "foo": {
      ".validate": "newData.isString() && newData.val().length < 100"
    }
  }
}

数据索引

.indexOn 用于针对数据节点进行索引，提高查询数据效率。

例如，对 students 的子节点 age 和 score 进行索引：

{
  "rules": {
    "students": {
      ".indexOn": ["age", "score"]
    }
  }
}