Go Academy · Aula

Roteamento e parâmetros de caminho

Registre manipuladores e analise parâmetros de URL

Aula 2 de 413 etapas

Roteamento e parâmetros de caminho é uma aula grátis de Go Academy no CoddyKit. Esta é a aula 2 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Go Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Go Academy inclui 4 aulas no total.

Limitações do multiplexador padrão

O http.ServeMux padrão não oferece suporte a parâmetros de caminho (por exemplo, /users/{id}) nem a roteamento baseado em método. O Go 1.22 adicionou suporte aprimorado a padrões.

Padrões aprimorados do Go 1.22

A partir do Go 1.22, o ServeMux oferece suporte a prefixos de método e parâmetros de caminho:

mux.HandleFunc("GET /users/{id}", func(w http.ResponseWriter, r *http.Request) {
    id := r.PathValue("id")
    fmt.Fprintln(w, "user:", id)
})

r.PathValue

r.PathValue("name") extrai um segmento nomeado do padrão da URL (Go 1.22 ou posterior).

// Pattern: "GET /products/{category}/{id}"
category := r.PathValue("category")
id := r.PathValue("id")

Análise manual do caminho

Para o Go < 1.22 ou regras complexas, extraia os segmentos do caminho com strings.Split(r.URL.Path, "/"):

parts := strings.Split(strings.Trim(r.URL.Path, "/"), "/")
// /users/42 → ["users", "42"]

Roteamento por método

Use um switch em r.Method para implementar a lógica de cada método dentro de um único manipulador:

switch r.Method {
case http.MethodGet:
    getHandler(w, r)
case http.MethodPost:
    createHandler(w, r)
default:
    w.WriteHeader(http.StatusMethodNotAllowed)
}

Roteadores populares de terceiros

Bibliotecas como gorilla/mux, chi e httprouter oferecem um roteamento mais avançado: restrições com expressões regulares, grupos nomeados, cadeias de camadas intermediárias e subroteadores.

Roteador chi

chi é um roteador leve e idiomático, compatível com manipuladores net/http:

r := chi.NewRouter()
r.Get("/users/{id}", getUser)
http.ListenAndServe(":8080", r)

Parâmetros de consulta

Leia os parâmetros de consulta de r.URL.Query(), que retorna um mapa url.Values:

page := r.URL.Query().Get("page")
if page == "" { page = "1" }

Curinga e captura geral

Nos padrões do Go 1.22, {name...} é um curinga que corresponde ao restante do caminho:

mux.HandleFunc("/static/{path...}", serveStatic)

Rotas aninhadas

Agrupe rotas relacionadas com um subroteador ou registrando manipuladores com um prefixo comum. O r.Route do chi cria um subroteador para um prefixo.

Redirecionamento da barra final

O http.ServeMux redireciona automaticamente /path/ para /path ou vice-versa. Para desativar esse comportamento, remova as barras finais em uma camada intermediária antes que o multiplexador receba a requisição.

Verificação rápida

No Go 1.22 ou posterior, como você extrai o segmento {id} de um padrão de URL correspondente?

Recapitulação: roteamento e parâmetros de caminho

Pontos principais:

  • Go 1.22: prefixo de método + parâmetros de caminho {name} no ServeMux
  • r.PathValue("name") extrai segmentos nomeados
  • Switch de método para lógica específica de cada método
  • Roteadores de terceiros (chi, gorilla/mux) para roteamento complexo
Grátis para começar

Aprenda Go com um tutor de IA — grátis

Escreva e execute código real no seu navegador, obtenha ajuda instantânea de um tutor de IA 24/7 e continue de onde parou na web ou no app.

Cursos
51
Aulas
203

Perguntas Frequentes

A aula “Roteamento e parâmetros de caminho” é grátis?

Sim — o texto completo de “Roteamento e parâmetros de caminho” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Go Academy, atualize para CoddyKit PRO. O curso de Go Academy inclui 4 aulas no total.

O que vou aprender em “Roteamento e parâmetros de caminho”?

Registre manipuladores e analise parâmetros de URL Você pratica Go Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar Go Academy?

Nenhuma experiência prévia é necessária. Go Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 4.

Quanto tempo leva a aula “Roteamento e parâmetros de caminho”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de Go Academy?

Sim. Cada aula de Go Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

  1. Criando um servidor HTTP
  2. Roteamento e parâmetros de caminho
  3. Padrão de middleware
  4. Desligamento elegante
← Voltar para Go Academy