Introdução
O http.ServeMux
do Go ganhou novas features muito aguardadas pelos desenvolvedores, e como sempre, essas features são retrocompatíveis.
Em resumo, as features são:
- Match com base no método HTTP
http.Handle("GET /users", ...)
- Variavéis no path da requisição
http.Handle("GET /users/{id}", ...)
- Match exato de paths terminados em barra
// match para qualquer path iniciado com /static/
http.Handle("GET /static/", ...)
// match somente GET /static/
http.Handle("GET /static/{$}", ...)
Essas mudanças vão reduzir bastante a necessidade de utilizar bibliotecas de routers, e como vai para a stdlib, vai ter a garantia de compatibilidade do Go 1.
1. Como funciona o http.ServeMux
O ServeMux
tem um comportamento diferente da maioria dos routers.
Caminhos terminados em barra são como pastas
http.Handle("/assets/", ...)
Esse handler processa qualquer requisição com prefixo /assets/
, como:
GET /assets/
GET /assets/img/img.png
DELETE /assets/abcd
O match é feito com o path exato se não for terminado em barra
http.Handle("/", ...)
http.Handle("/assets", ...)
Nesse caso o segundo pattern não termina em barra, então só requisições para exatamente /assets
vão ser processadas por esse handler, e qualquer outra será processada pelo primeiro handler.
Obs.: O caminho /
dá match em qualquer requisição que não dê match em outro handler, então ele é geralmente usado para a página raiz e página de not found.
O match é feito com o path mais similar
Se você tiver:
http.Handle("/users/", ...)
http.Handle("/users/123", ...)
http.Handle("/users/books/", ...)
- Uma requisição para
/users/
vai cair no primeiro handler. - Uma requisição para
/users/123
vai cair no segundo handler. - Uma requisição para
/users/1234
vai cair no primeiro handler. - Uma requisição para
/users/books/123
vai cair no terceiro handler. - Uma requisição para
/users/a/b/c/d
também cai no primeiro handler
2. Entendendo o match com base no método HTTP
O comportamento das funções Handle
e HandleFunc
vai se manter igual para códigos existentes por conta da retrocompatibilidade da linguagem, então se você não especificar um método HTTP, seu handler vai continuar dando match em qualquer método.
Obs.: Um handler para o método GET vai também bater para requisições do método HEAD.
// GET /users
// HEAD /users
http.HandleFunc("GET /users", ...)
// somente DELETE /users
http.HandleFunc("DELETE /users", ...)
3. Utilizando variáveis de path
Podemos capturar o valor de uma variável de path usando o PathValue
.
http.HandleFunc("GET /users/{id}", func(w http.ResponseWriter, r *http.Request) {
id := r.PathValue("id")
...
})
4. Utilizando matches exatos
Ao utilizar o {$}
indicamos que um handler terminado em barra deve somente bater com aquele path, e não com qualquer path com aquele prefixo.
// redirecionar um request de / para /home
http.HandleFunc("GET /{$}", func(w http.ResponseWriter, r *http.Request) {
http.Redirect(w, r, "/home")
})
// qualquer outro path que não de match em outro handler vai dar um not found
http.HandleFunc("GET /", func(w http.ResponseWriter, r *http.Request) {
http.NotFound(w, r)
})
Conclusão
Apesar de simples, essa foi uma mudança bem importante na stdlib do Go, tendo em vista que é uma linguagem muito utilizada para desenvolver servidores Web.
Mas é claro que essas foram só algumas das muitas novidades do Go 1.22 e pretendo falar de outras que foram bem expressivas, como no for
loop, pacote rand
, e outros em próximos artigos.
Top comments (0)