Ana içeriğe atla

Functions

Eşleştiricilerdeki Fonksiyonlar​

Bir eşleştiricide daha güçlü hale getirmek için fonksiyonları bile belirtebilirsiniz. Yerleşik fonksiyonları kullanabilir veya kendi fonksiyonunuzu belirtebilirsiniz. Yerleşik anahtar eşleştirme fonksiyonları aşağıdaki formatı alır:

bool function_name(string url, string pattern)

url'nin pattern ile eşleşip eşleşmediğini belirten bir boolean döndürürler.

Desteklenen yerleşik fonksiyonlar şunlardır:

FonksiyonurlkalıpÖrnek
keyMatch/alice_data/resource1 gibi bir URL yolu/alice_data/* gibi bir URL yolu veya * desenikeymatch_model.conf/keymatch_policy.csv
keyMatch2/alice_data/resource1 gibi bir URL yolu/alice_data/:resource gibi bir URL yolu veya : desenikeymatch2_model.conf/keymatch2_policy.csv
keyMatch3/alice_data/resource1 gibi bir URL yolubir URL yolu veya /alice_data/{resource} gibi bir {} kalıbıhttps://github.com/casbin/casbin/blob/277c1a2b85698272f764d71a94d2595a8d425915/util/builtin_operators_test.go#L171-L196
keyMatch4/alice_data/123/book/123 gibi bir URL yolubir URL yolu veya /alice_data/{id}/book/{id} gibi bir {} kalıbıhttps://github.com/casbin/casbin/blob/277c1a2b85698272f764d71a94d2595a8d425915/util/builtin_operators_test.go#L208-L222
keyMatch5/alice_data/123/?status=1 gibi bir URL yolubir URL yolu, /alice_data/{id}/* gibi bir {} veya * kalıbıhttps://github.com/casbin/casbin/blob/1cde2646d10ad1190c0d784c3a1c0e1ace1b5bc9/util/builtin_operators_test.go#L485-L526
regexMatchherhangi bir dizenormal bir ifade desenikeymatch_model.conf/keymatch_policy.csv
ipMatch192.168.2.123 gibi bir IP adresi192.168.2.0/24 gibi bir IP adresi veya CIDRipmatch_model.conf/ipmatch_policy.csv
globMatch/alice_data/resource1 gibi bir yol benzeri yol/alice_data/* gibi bir glob kalıbıhttps://github.com/casbin/casbin/blob/277c1a2b85698272f764d71a94d2595a8d425915/util/builtin_operators_test.go#L426-L466

Anahtar-alma fonksiyonları için, genellikle üç parametre alırlar ( keyGet hariç):

bool function_name(string url, string pattern, string key_name)

Eğer key_name anahtarı kalıpla eşleşiyorsa, onun değerini döndürürler ve hiçbir şey eşleşmezse "" döndürürler.

Örneğin, KeyGet2("/resource1/action", "/:res/action", "res") "resource1" döndürecek ve KeyGet3("/resource1_admin/action", "/{res}_admin/*", "res") "resource1" döndürecektir. KeyGet ise iki parametre alır, KeyGet("/resource1/action", "/*) "resource1/action" döndürecektir.

Fonksiyonurlkalıpkey_nameörnek
anahtarAl/proj/resource1 gibi bir URL yolu/proj/* gibi bir URL yolu veya * kalıbı\keyget_model.conf/keymatch_policy.csv
anahtarAl2/proj/resource1 gibi bir URL yolu/prooj/:resource gibi bir URL yolu veya : kalıbıkalıpta belirtilen anahtar adıkeyget2_model.conf/keymatch2_policy.csv
keyGet3/proj/res3_admin/ gibi bir URL yolu/proj/{resource}_admin/* gibi bir URL yolu veya {} kalıbıKalıpta belirtilen anahtar adıhttps://github.com/casbin/casbin/blob/7bd496f94f5a2739a392d333a9aaaa10ae397673/util/builtin_operators_test.go#L209-L247

Yukarıdaki fonksiyonların detayları için bkz: https://github.com/casbin/casbin/blob/master/util/builtin_operators_test.go

Özelleştirilmiş bir fonksiyon nasıl eklenir​

İlk olarak, fonksiyonunuzu hazırlayın. Birkaç parametre alır ve bir bool döndürür:

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]
}

Ardından, bunu interface{} türleriyle sarmalayın:

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

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

Son olarak, fonksiyonu Casbin enforcer'a kaydedin:

e.AddFunction("my_func", KeyMatchFunc)

Şimdi, fonksiyonu model CONF'unuzda şu şekilde kullanabilirsiniz:

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