Introducción

La anulación del método HTTP es una técnica utilizada para admitir clientes que no admiten ciertos métodos HTTP como PUT o DELETE. Esto es particularmente útil para navegadores web y clientes antiguos que solo admiten métodos GET y POST. El marco web Iris proporciona un middleware de anulación de métodos robusto y flexible que permite a los desarrolladores implementar fácilmente la anulación de métodos HTTP en sus aplicaciones. Esta guía lo guiará a través de las características y el uso del middleware de anulación del método Iris, ayudándolo a comprender y aprovechar sus capacidades para mejorar sus aplicaciones web.

Características del middleware de anulación del método Iris

El middleware de anulación de métodos Iris ofrece una variedad de características para manejar la anulación de métodos HTTP de manera eficiente. Estas características incluyen:

1. Métodos personalizables: define qué métodos HTTP se pueden anular.
2. Encabezados personalizados: especifique encabezados personalizados para determinar la anulación del método.
3. Compatibilidad con campos de formulario: use campos de formulario para especificar la anulación del método.
4. Compatibilidad con parámetros de consulta: utilice parámetros de consulta para especificar la anulación del método.
5. Guardar método original: Opcionalmente, guarde el método HTTP original para usarlo más adelante.

Instalación

Para utilizar el middleware de anulación del método Iris, debe importarlo en su aplicación Iris:

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

Uso

Configuración básica

Para utilizar el método de anulación del middleware, debe importar los paquetes necesarios y configurar el middleware en su aplicación Iris. Aquí hay un ejemplo básico:

package main

import (
    "github.com/kataras/iris/v12"
    "github.com/kataras/iris/v12/middleware/methodoverride"
)

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

    // Create the method override middleware
    mo := methodoverride.New(
        methodoverride.SaveOriginalMethod("_originalMethod"),
    )

    // Register the middleware with UseRouter
    app.UseRouter(mo)

    app.Post("/path", func(ctx iris.Context) {
        ctx.WriteString("POST response")
    })

    app.Delete("/path", func(ctx iris.Context) {
        ctx.WriteString("DELETE response")
    })

    app.Listen(":8080")
}

Métodos personalizables

Puedes definir qué métodos HTTP se pueden anular usando la opción Métodos. De forma predeterminada, sólo se puede anular el método POST. Aquí hay un ejemplo:

mo := methodoverride.New(
    methodoverride.Methods("POST", "PUT"),
)

Encabezados personalizados

Puede especificar encabezados personalizados para determinar la anulación del método utilizando la opción Encabezados. De forma predeterminada, el middleware comprueba los siguientes encabezados: X-HTTP-Method, X-HTTP-Method-Override y X-Method-Override. Aquí hay un ejemplo:

mo := methodoverride.New(
    methodoverride.Headers("X-Custom-Method"),
)

Soporte de campo de formulario

Puedes usar campos de formulario para especificar la anulación del método usando la opción FormField. De forma predeterminada, el middleware comprueba el campo del formulario _method. Aquí hay un ejemplo:

mo := methodoverride.New(
    methodoverride.FormField("_method"),
)

Soporte de parámetros de consulta

Puede usar parámetros de consulta para especificar la anulación del método usando la opción Consulta. De forma predeterminada, el middleware comprueba el parámetro de consulta _method. Aquí hay un ejemplo:

mo := methodoverride.New(
    methodoverride.Query("_method"),
)

Guardar método original

Opcionalmente, puedes guardar el método HTTP original para usarlo más adelante usando la opción SaveOriginalMethod. Aquí hay un ejemplo:

mo := methodoverride.New(
    methodoverride.SaveOriginalMethod("_originalMethod"),
)

Ejemplo

Aquí hay un ejemplo completo que demuestra cómo utilizar el método de anulación del middleware con una aplicación Iris:

package main

import (
    "github.com/kataras/iris/v12"
    "github.com/kataras/iris/v12/middleware/methodoverride"
)

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

    // Create the method override middleware
    mo := methodoverride.New(
        methodoverride.SaveOriginalMethod("_originalMethod"),
    )

    // Register the middleware with UseRouter
    app.UseRouter(mo)

    app.Post("/path", func(ctx iris.Context) {
        ctx.WriteString("POST response")
    })

    app.Delete("/path", func(ctx iris.Context) {
        ctx.WriteString("DELETE response")
    })

    app.Listen(":8080")
}

Conclusión

El middleware de anulación de métodos Iris proporciona una manera simple y eficiente de admitir clientes que no admiten ciertos métodos HTTP. Al aprovechar las características de este middleware, puede mejorar la compatibilidad y flexibilidad de sus aplicaciones web.