缺点

• 有一些样板代码

我不喜欢类型系统，能否直接使用原始 gRPC API？

可以的。 SpiceDBClient 提供了获取底层 tonic 客户端的方法，而 spicedb 模块导出了所有 protobuf 类型。根据个人经验，这并不有趣。

示例

让我们看看以下 SpiceDB 模式

definition user {}

definition document {
    relation reader: user | user:*
    relation writer: user
    
    permission read = reader + writer
    permission write = writer
}

我们有 2 个实体，User 和 Document。这是样板代码

struct User;

impl Entity for User {
    type Relations = NoRelations;
    type Id = Uuid;

    fn object_type() -> &'static str {
        "user"
    }
}

struct MyActor(Uuid);

impl Actor for MyActor {
    fn to_subject(&self) -> SubjectReference {
        subject_reference_raw(self.0, User::object_type(), None::<String>)
    }
}

struct Document;

#[derive(IntoStaticStr)]
#[strum(serialize_all = "snake_case")]
pub enum DocumentPermission {
    Read,
    Write,
}

impl Entity for Document {
    type Relations = DocumentRelation;
    type Id = String;

    fn object_type() -> &'static str {
        "document"
    }
}

#[derive(IntoStaticStr)]
#[strum(serialize_all = "snake_case")]
pub enum DocumentRelation {
    Reader,
    Writer,
}

impl Resource for Document {
    type Permissions = DocumentPermission;
}

注意： 由于 strum crate 中的 IntoStaticStr 宏，现在已经移除了 Relations 和 Permissions 的样板代码，此 crate 也重新导出了它。

现在的类型系统使得无法检查不存在的权限，或创建不支持实体的关系。

注意： 我不知道是否可以通过类型限制关系的 Subject 部分，我还没有走过这条路，而且我现在还不需要，我会很好奇是否有简单的方法来做这件事。

现在让我们创建一些关系并检查一些权限！

let client = SpiceDBClient::new("https://127.0.0.1:50051".to_owned(), "randomkey")
    .await?;
let user_id = Uuid::now_v7();
let relationships = [
    relationship_update::<User, Document>(
        RelationshipOperation::Touch,
        user_id,
        None,
        "homework",
        DocumentRelation::Writer,
    ),
    wildcard_relationship_update::<User, Document>(
        RelationshipOperation::Touch,
        "manga",
        DocumentRelation::Reader,
    ),
];
let token = client
    .create_relationships(relationships, [])
    .await
    .unwrap();
let actor = MyActor(user_id);
let authorized = client.check_permission_at::<_, Document>(
    &actor,
    "homework",
    DocumentPermission::Write,
    token.clone(),
)
.await?;

模拟

启用 mock 功能，以使用由 mockall 生成的客户端。所有公共接口都将按预期工作，但请求构建器接口除外，因为它们没有被模拟，如果您目前正在使用这些接口，您必须针对 SpiceDB 的真实实例进行测试。代码仍然可以编译，但是任何测试到这些代码行的测试都将崩溃。