Introdução

A substituição do método HTTP é uma técnica usada para oferecer suporte a clientes que não oferecem suporte a determinados métodos HTTP, como PUT ou DELETE. Isto é particularmente útil para navegadores web e clientes mais antigos que suportam apenas métodos GET e POST. A estrutura da web Iris fornece um middleware de substituição de método robusto e flexível que permite aos desenvolvedores implementar facilmente a substituição de método HTTP em seus aplicativos. Este guia orientará você nos recursos e no uso do middleware de substituição do método Iris, ajudando você a compreender e aproveitar seus recursos para aprimorar seus aplicativos da web.

Recursos do middleware de substituição do método Iris

O middleware de substituição de método Iris oferece uma variedade de recursos para lidar com a substituição de método HTTP com eficiência. Esses recursos incluem:

1. Métodos personalizáveis: Defina quais métodos HTTP podem ser substituídos.
2. Cabeçalhos personalizados: Especifique cabeçalhos personalizados para determinar a substituição do método.
3. Suporte a campo de formulário: Use campos de formulário para especificar a substituição do método.
4. Suporte a parâmetros de consulta: use parâmetros de consulta para especificar a substituição do método.
5. Salvar método original: Opcionalmente, salve o método HTTP original para uso posterior.

Instalação

Para usar o middleware de substituição do método Iris, você precisa importá-lo em seu aplicativo Iris:

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

Uso

Configuração básica

Para usar o middleware de substituição de método, você precisa importar os pacotes necessários e configurar o middleware em seu aplicativo Iris. Aqui está um exemplo 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 personalizáveis

Você pode definir quais métodos HTTP podem ser substituídos usando a opção Métodos. Por padrão, apenas o método POST pode ser substituído. Aqui está um exemplo:

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

Cabeçalhos personalizados

Você pode especificar cabeçalhos personalizados para determinar a substituição do método usando a opção Cabeçalhos. Por padrão, o middleware verifica os seguintes cabeçalhos: X-HTTP-Method, X-HTTP-Method-Override e X-Method-Override. Aqui está um exemplo:

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

Suporte de campo de formulário

Você pode usar campos de formulário para especificar a substituição do método usando a opção FormField. Por padrão, o middleware verifica o campo de formulário _method. Aqui está um exemplo:

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

Suporte a parâmetros de consulta

Você pode usar parâmetros de consulta para especificar a substituição do método usando a opção Consulta. Por padrão, o middleware verifica o parâmetro de consulta _method. Aqui está um exemplo:

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

Salvar método original

Opcionalmente, você pode salvar o método HTTP original para uso posterior usando a opção SaveOriginalMethod. Aqui está um exemplo:

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

Exemplo

Aqui está um exemplo completo que demonstra como usar o método override middleware com uma aplicação 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")
}

Conclusão

O middleware de substituição de método Iris fornece uma maneira simples e eficiente de oferecer suporte a clientes que não oferecem suporte a determinados métodos HTTP. Ao aproveitar os recursos desse middleware, você pode aprimorar a compatibilidade e a flexibilidade de seus aplicativos da web.