معالجة المعاملات في إطار Go Iris

يقدم هذا الفصل كيفية الحصول على معلمات الطلب مثل GET و POST وغيرها في إطار العمل iris، بما في ذلك قراءة وكتابة الكوكيز.

المعلمات في المسار

func main() {
    app := iris.Default()

    // سيتطابق هذا المعالج مع /user/john، ولكن ليس /user/ أو /user
    app.Get("/user/{name}", func(ctx iris.Context) {
        name := ctx.Params().Get("name")
        ctx.Writef("مرحبًا %s", name)
    })
    
    // ومع ذلك، سيتطابق هذا المعالج مع /user/john/ و /user/john/send
    // إذا لم يتطابق أي مسار آخر مع /user/john، سيتم إعادة توجيهه إلى /user/john/
    app.Get("/user/{name}/{action:path}", func(ctx iris.Context) {
        name := ctx.Params().Get("name")
        action := ctx.Params().Get("action")
        message := name + " " + action
        ctx.WriteString(message)
    })
    
    // لكل طلب متطابق، ستحتفظ السياق بتعريف الموجه
    app.Post("/user/{name:string}/{action:path}", func(ctx iris.Context) {
        ctx.GetCurrentRoute().Tmpl().Src == "/user/{name:string}/{action:path}" // الصحيح
    })
    
    app.Listen(":8080")
}

أنواع المعلمات المضمنة المتاحة:

الحصول على معلمات الاستعلام

func main() {
    app := iris.Default()

    // تحليل معلمات سلسلة الاستعلام باستخدام كائن الطلب منخفض المستوى الحالي.
    // مطابقة عنوان URL: /welcome?firstname=Jane&lastname=Doe
    app.Get("/welcome", func(ctx iris.Context) {
        firstname := ctx.URLParamDefault("firstname", "زائر")
        lastname := ctx.URLParam("lastname") // الاختصار لـ ctx.Request().URL.Query().Get("lastname")

        ctx.Writef("مرحبًا %s %s", firstname, lastname)
    })
    app.Listen(":8080")
}

الحصول على معلمات النموذج

func main() {
    app := iris.Default()

    app.Post("/form_post", func(ctx iris.Context) {
        message := ctx.PostValue("message")
        nick := ctx.PostValueDefault("nick", "مجهول")

        ctx.JSON(iris.Map{
            "status":  "تم النشر",
            "message": message,
            "nick":    nick,
        })
    })
    app.Listen(":8080")
}

مثال مجتمع عن معلمات الاستعلام + النموذج

POST /post?id=1234&page=1 HTTP/1.1
Content-Type: application/x-www-form-urlencoded

name=kataras&message=this_is_great

func main() {
    app := iris.Default()

    app.Post("/post", func(ctx iris.Context) {
        id, err := ctx.URLParamInt("id", 0)
        if err != nil {
            ctx.StopWithError(iris.StatusBadRequest, err)
            return
        }

        page := ctx.URLParamIntDefault("page", 0)
        name := ctx.PostValue("name")
        message := ctx.PostValue("message")

        ctx.Writef("id: %d; page: %d; name: %s; message: %s", id, page, name, message)
    })
    app.Listen(":8080")
}

id: 1234; page: 1; name: kataras; message: this_is_great

الحصول على معلمات الاستعلام في طلب POST

POST /post?id=a&id=b&id=c&name=john&name=doe&name=kataras
Content-Type: application/x-www-form-urlencoded

func main() {
    app := iris.Default()

    app.Post("/post", func(ctx iris.Context) {

        ids := ctx.URLParamSlice("id")
        names, err := ctx.PostValues("name")
        if err != nil {
            ctx.StopWithError(iris.StatusBadRequest, err)
            return
        }

        ctx.Writef("ids: %v; names: %v", ids, names)
    })
    app.Listen(":8080")
}

ids: [a b c], names: [john doe kataras]

قراءة / كتابة الكوكيز

import "github.com/kataras/iris/v12"

func main() {
    app := iris.Default()

    app.Get("/cookie", func(ctx iris.Context) {
        // قراءة الكوكي
        value := ctx.GetCookie("my_cookie")

        if value == "" {
            value = "NotSet"
            // إنشاء كوكي
            ctx.SetCookieKV("my_cookie", value)
            // بديلًا: ctx.SetCookie(&http.Cookie{...})
            // إنشاء كوكي
            ctx.SetCookie("", "test", 3600, "/", "localhost", false, true)
        }

        ctx.Writef("قيمة الكوكي: %s \n", value)
    })

    app.Listen(":8080")
}