Functions

ฟังก์ชันใน matchers

คุณสามารถระบุฟังก์ชันใน matcher เพื่อทำให้มันมีประสิทธิภาพมากขึ้น คุณสามารถใช้ฟังก์ชันที่มีอยู่แล้วหรือระบุฟังก์ชันของคุณเอง ฟังก์ชันการจับคู่คีย์ที่มีอยู่แล้วมีรูปแบบดังต่อไปนี้:

bool function_name(string url, string pattern)

พวกเขาจะคืนค่า boolean ที่บ่งบอกว่า url ตรงกับ pattern หรือไม่

ฟังก์ชันที่มีอยู่แล้วที่ได้รับการสนับสนุนคือ:

ฟังก์ชัน	url	pattern	ตัวอย่าง
keyMatch	เส้นทาง URL อย่าง `/alice_data/resource1`	เส้นทาง URL หรือ pattern `` อย่าง `/alice_data/`	keymatch_model.conf/keymatch_policy.csv
keyMatch2	เส้นทาง URL อย่าง `/alice_data/resource1`	เส้นทาง URL หรือ pattern `:` อย่าง `/alice_data/:resource`	keymatch2_model.conf/keymatch2_policy.csv
keyMatch3	เส้นทาง URL อย่าง `/alice_data/resource1`	เส้นทาง URL หรือ pattern `{}` อย่าง `/alice_data/{resource}`	https://github.com/casbin/casbin/blob/277c1a2b85698272f764d71a94d2595a8d425915/util/builtin_operators_test.go#L171-L196
keyMatch4	เส้นทาง URL อย่าง `/alice_data/123/book/123`	เส้นทาง URL หรือ pattern `{}` อย่าง `/alice_data/{id}/book/{id}`	https://github.com/casbin/casbin/blob/277c1a2b85698272f764d71a94d2595a8d425915/util/builtin_operators_test.go#L208-L222
keyMatch5	เส้นทาง URL อย่าง `/alice_data/123/?status=1`	เส้นทาง URL, pattern `{}` หรือ `` อย่าง `/alice_data/{id}/`	https://github.com/casbin/casbin/blob/1cde2646d10ad1190c0d784c3a1c0e1ace1b5bc9/util/builtin_operators_test.go#L485-L526
regexMatch	สตริงใดๆ	pattern ของ regular expression	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	เส้นทางที่คล้ายกับ path อย่าง `/alice_data/resource1`	pattern ของ glob อย่าง `/alice_data/*`	https://github.com/casbin/casbin/blob/277c1a2b85698272f764d71a94d2595a8d425915/util/builtin_operators_test.go#L426-L466

สำหรับฟังก์ชันการเข้าถึงคีย์, โดยปกติจะใช้พารามิเตอร์สามตัว (ยกเว้น keyGet):

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

พวกเขาจะคืนค่าของคีย์ key_name ถ้ามันตรงกับ pattern, และจะคืนค่า "" ถ้าไม่มีอะไรตรงกัน

ตัวอย่างเช่น, KeyGet2("/resource1/action", "/:res/action", "res") จะคืนค่า "resource1", และ KeyGet3("/resource1_admin/action", "/{res}_admin/*", "res") จะคืนค่า "resource1" สำหรับ KeyGet, ซึ่งใช้พารามิเตอร์สองตัว, KeyGet("/resource1/action", "/*) จะคืนค่า "resource1/action"

ฟังก์ชัน	url	pattern	key_name	ตัวอย่าง
keyGet	a URL path like `/proj/resource1`	a URL path or a `` pattern like `/proj/`	\	keyget_model.conf/keymatch_policy.csv
keyGet2	a URL path like `/proj/resource1`	a URL path or `:` pattern like `/prooj/:resource`	ชื่อคีย์ที่ระบุในรูปแบบ	keyget2_model.conf/keymatch2_policy.csv
keyGet3	a URL path like `/proj/res3_admin/`	a URL path or `{}` pattern like `/proj/{resource}_admin/*`	ชื่อคีย์ที่ระบุในรูปแบบ	https://github.com/casbin/casbin/blob/7bd496f94f5a2739a392d333a9aaaa10ae397673/util/builtin_operators_test.go#L209-L247

ดูรายละเอียดของฟังก์ชันด้านบนได้ที่: https://github.com/casbin/casbin/blob/master/util/builtin_operators_test.go

วิธีการเพิ่มฟังก์ชันที่กำหนดเอง

ขั้นแรก, เตรียมฟังก์ชันของคุณ มันรับพารามิเตอร์หลายตัวและคืนค่าเป็น bool:

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

ฟังก์ชันใน matchers​

วิธีการเพิ่มฟังก์ชันที่กำหนดเอง​

ฟังก์ชันใน matchers

วิธีการเพิ่มฟังก์ชันที่กำหนดเอง