Translate

函数

Matchers中的函数

你甚至可以在Matcher中指定函数，使它更强大。 你可以使用内置函数，或者指定你自己的函数。 所有的内置函数都需要这样的格式(除了 keyGet 和 keyGet2)：

bool function_name(string arg1, string arg2)

它返回arg1是否匹配arg2。

keyGet and keyGet2 将返回匹配通配符的字符串，如果没有匹配返回 ""。

支持的内置函数如下：

函数	参数1	参数2	示例
keyMatch	一个URL 路径，例如 /alice_data/resource1	一个URL 路径或 * 模式下，例如 /alice_data/*	keymatch_model.conf/keymatch_policy.csv
keyGet	一个URL 路径，例如 /alice_data/resource1	一个URL 路径或 * 模式下，例如 /alice_data/*	keyget_model.conf/keymatch_policy.csv
keyMatch2	一个URL 路径，例如 /alice_data/resource1	一个URL 路径或 : 模式下，例如 /alice_data/:resource	keymatch2_model.conf/keymatch2_policy.csv
keyGet2	一个URL 路径，例如 /alice_data/resource1	一个URL 路径或 : 模式下，例如 /alice_data/:resource	keyget_model.conf/keymatch_policy.csv
keyMatch3	一个URL 路径，例如 /alice_data/resource1	一个URL 路径或 {} 模式下，例如 /alice_data/{resource}	https://github.com/casbin/casbin/blob/277c1a2b85698272f764d71a94d2595a8d425915/util/builtin_operators_test.go#L171-L196
keyMatch4	一个URL 路径，例如 /alice_data/resource1	一个URL 路径或 {} 模式下，例如 /alice_data//{id}/book/{id}	https://github.com/casbin/casbin/blob/277c1a2b85698272f764d71a94d2595a8d425915/util/builtin_operators_test.go#L208-L222
regexMatch	任意字符串	正则表达式模式	keymatch_model.conf/keymatch_policy.csv
ipMatch	一个 IP 地址，例如 192.168.2.123	一个 IP 地址或一个 CIDR ，例如192.168.2.0/24	ipmatch_model.conf/ipmatch_policy.csv
globMatch	类似路径的 /alice_data/resource1	一个全局模式，例如 /alice_data/*	https://github.com/casbin/casbin/blob/277c1a2b85698272f764d71a94d2595a8d425915/util/builtin_operators_test.go#L426-L466

详情见：https://github.com/casbin/casbin/blob/master/util/builtin_operators_test.go

怎样增加自定义函数

首先准备您的函数。 它接受一些参数，然后返回一个布尔类型：

func KeyMatch(key1 string, key2 string) bool {
    i := strings.Index(key2, "*")
    if i == -1 {
        return key1 == key2
    }

    if len(key1) > i {
        return key1[:i] == key2[:i]
    }
    return key1 == key2[:i]
}

然后用 interface{} 类型的接口包装它：

func KeyMatchFunc(args ...interface{}) (interface{}, error) {
    name1 := args[0].(string)
    name2 := args[1].(string)

    return (bool)(KeyMatch(name1, name2)), nil
}

最后，在Casbin的执行者(enforcer)中注册这个函数：

e.AddFunction("my_func", KeyMatchFunc)

现在，您可以在您的模型CONF中像这样使用这个函数：

[matchers]
m = r.sub == p.sub && my_func(r.obj, p.obj) && r.act == p.act