{"id":30782,"date":"2019-10-31T21:37:25","date_gmt":"2019-10-31T18:37:25","guid":{"rendered":"https:\/\/prohoster.info\/blog\/razrabotka-veb-serverov-na-golang-ot-prostogo-k-slozhnomu\/"},"modified":"2019-10-31T21:37:25","modified_gmt":"2019-10-31T18:37:25","slug":"razrabotka-veb-serverov-na-golang-ot-prostogo-k-slozhnomu","status":"publish","type":"post","link":"https:\/\/prohoster.info\/pt\/blog\/news\/razrabotka-veb-serverov-na-golang-ot-prostogo-k-slozhnomu","title":{"rendered":"Desenvolvimento de servidores web em Golang \u2014 do simples ao complexo","gt_translate_keys":[{"key":"rendered","format":"text"}]},"content":{"rendered":"

\"Desenvolvimento
\n
\nCinco anos atr\u00e1s, eu comecei a desenvolver Gophish<\/a><\/noindex>, isso me deu a oportunidade de aprender Golang. Eu percebi que Go \u00e9 uma linguagem poderosa, cujas capacidades s\u00e3o complementadas por in\u00fameras bibliotecas. Go \u00e9 vers\u00e1til: em particular, \u00e9 poss\u00edvel desenvolver aplicativos de servidor sem problemas.<\/p>\n

Este artigo \u00e9 dedicado \u00e0 escrita de um servidor em Go. Come\u00e7aremos com coisas simples, como \"Hello world!\", e terminaremos com um aplicativo que possui as seguintes funcionalidades:<\/p>\n

\u2014 Uso do Let\u2019s Encrypt para HTTPS.
\n\u2014 Funcionamento como um roteador API.
\n\u2014 Trabalhar com middleware.
\n\u2014 Manipula\u00e7\u00e3o de arquivos est\u00e1ticos.
\n\u2014 Desligamento ordenado.
\n<\/a><\/noindex><\/p>\n

A Skillbox recomenda:<\/b> Curso Pr\u00e1tico \"Desenvolvedor Python do zero\"<\/a><\/noindex>.<\/p>\n

Lembramos:<\/b> para todos os leitores do \u00abHabr\u00bb \u2014 desconto de 10.000 rublos na inscri\u00e7\u00e3o em qualquer curso Skillbox com o c\u00f3digo promocional \u00abHabr\u00bb.<\/i>\n<\/p><\/blockquote>\n

Hello, world!<\/h3>\n

\nCriar um servidor web em Go pode ser feito muito rapidamente. Aqui est\u00e1 um exemplo de uso de um manipulador que retorna o prometido \"Hello, world!\".<\/p>\n

package main\n \nimport (\n\"fmt\"\n\"net\/http\"\n)\n \nfunc main() {\nhttp.HandleFunc(\"\/\", func(w http.ResponseWriter, r *http.Request) {\nfmt.Fprintf(w, \"Hello World!\")\n})\nhttp.ListenAndServe(\":80\", nil)\n}<\/code><\/pre>\n
\nDepois disso, se voc\u00ea executar o aplicativo e abrir a p\u00e1gina localhost<\/noindex>, voc\u00ea ver\u00e1 imediatamente o texto \"Hello, world!\" (claro, se tudo estiver funcionando corretamente).<\/p>\n
Em seguida, utilizaremos o manipulador repetidamente, mas primeiro vamos entender como tudo funciona.<\/p>\n
net\/http<\/h4>\n
\nNo exemplo, foi utilizado o pacote net\/http<\/code><\/a><\/noindex>, que \u00e9 a principal ferramenta em Go para desenvolver tanto servidores quanto clientes HTTP. Para entender o c\u00f3digo, vamos analisar o significado de tr\u00eas elementos importantes: http.Handler, http.ServeMux e http.Server.<\/p>\n
Manipuladores HTTP<\/h4>\n
\nQuando recebemos uma solicita\u00e7\u00e3o, o manipulador a analisa e forma uma resposta. Os manipuladores em Go s\u00e3o implementados da seguinte forma:<\/p>\n
type Handler interface {\n        ServeHTTP(ResponseWriter, *Request)\n}<\/code><\/pre>\n
\nNo primeiro exemplo, a fun\u00e7\u00e3o auxiliar http.HandleFunc \u00e9 usada. Ela envolve outra fun\u00e7\u00e3o que, por sua vez, aceita http.ResponseWriter e http.Request no ServeHTTP.<\/p>\n
Em outras palavras, os manipuladores em Golang s\u00e3o representados por uma \u00fanica interface, o que oferece in\u00fameras possibilidades para o programador. Por exemplo, o middleware \u00e9 implementado por meio de um manipulador, onde ServeHTTP primeiro faz algo e depois chama o m\u00e9todo ServeHTTP de outro manipulador.<\/p>\n
Como mencionado acima, os manipuladores apenas formam respostas para solicita\u00e7\u00f5es. Mas qual manipulador exatamente devemos usar em um momento espec\u00edfico?<\/p>\n
Roteamento de solicita\u00e7\u00f5es<\/h4>\n
\nPara fazer a escolha correta, utilize o multiplexador HTTP. Em v\u00e1rias bibliotecas, ele \u00e9 chamado de muxer ou router, mas tudo isso \u00e9 a mesma coisa. A fun\u00e7\u00e3o do multiplexador consiste em analisar o caminho da solicita\u00e7\u00e3o e selecionar o manipulador apropriado.<\/p>\n
Se voc\u00ea precisar de suporte para roteamento complexo, \u00e9 melhor utilizar bibliotecas de terceiros. Algumas das mais avan\u00e7adas s\u00e3o gorilla\/mux<\/a><\/noindex> e go-chi\/chi<\/a><\/noindex>, essas bibliotecas permitem implementar o processamento intermedi\u00e1rio sem grandes problemas. Com elas, \u00e9 poss\u00edvel configurar roteamento wildcard e realizar v\u00e1rias outras tarefas. Seu ponto positivo \u00e9 a compatibilidade com manipuladores HTTP padr\u00e3o. Como resultado, voc\u00ea pode escrever um c\u00f3digo simples com a possibilidade de modific\u00e1-lo no futuro.<\/p>\n
Trabalhar com frameworks complexos geralmente requer solu\u00e7\u00f5es n\u00e3o t\u00e3o padr\u00e3o, o que complica significativamente o uso dos manipuladores padr\u00e3o. Para a cria\u00e7\u00e3o da grande maioria das aplica\u00e7\u00f5es, \u00e9 suficiente a combina\u00e7\u00e3o da biblioteca padr\u00e3o com um roteador simples.<\/p>\n
Processamento de solicita\u00e7\u00f5es<\/h4>\n
\nAl\u00e9m disso, precisamos de um componente que escute as conex\u00f5es de entrada e redirecione todas as solicita\u00e7\u00f5es para o manipulador correto. Para essa tarefa, o http.Server se sai muito bem.<\/p>\n
Abaixo est\u00e1 mostrado que o servidor \u00e9 respons\u00e1vel por todas as tarefas relacionadas ao processamento de conex\u00f5es. Isso inclui, por exemplo, a opera\u00e7\u00e3o pelo protocolo TLS. A chamada http.ListenAndServer utiliza o servidor HTTP padr\u00e3o.<\/p>\n
Agora, vamos considerar exemplos mais complexos.<\/p>\n
Adicionando o Let\u2019s Encrypt<\/h3>\n
\nPor padr\u00e3o, nossa aplica\u00e7\u00e3o opera pelo protocolo HTTP, mas \u00e9 recomend\u00e1vel usar o protocolo HTTPS. No Go, isso pode ser feito sem problemas. Se voc\u00ea obteve um certificado e uma chave privada, ent\u00e3o basta definir o ListenAndServeTLS com os arquivos de certificado e chave corretos.<\/p>\n
http.ListenAndServeTLS(\":443\", \"cert.pem\", \"key.pem\", nil)<\/code><\/pre>\n
\nSempre h\u00e1 espa\u00e7o para melhorar.<\/p>\n
Let\u2019s Encrypt<\/a><\/noindex> fornece certificados gratuitos com a possibilidade de atualiza\u00e7\u00e3o autom\u00e1tica. Para utilizar o servi\u00e7o, \u00e9 necess\u00e1rio o pacote autocert<\/code>.<\/p>\n
A maneira mais simples de configur\u00e1-lo \u00e9 utilizando o m\u00e9todo autocert.NewListener em combina\u00e7\u00e3o com http.Serve. O m\u00e9todo permite obter e atualizar certificados TLS enquanto o servidor HTTP processa as solicita\u00e7\u00f5es:<\/p>\n
http.Serve(autocert.NewListener(\"example.com\"), nil)<\/code><\/pre>\n
\nSe abrirmos no navegador example.com<\/a><\/noindex>, receberemos a resposta HTTPS \"Hello, world!\".<\/p>\n
Se precisar de uma configura\u00e7\u00e3o mais detalhada, deve-se usar o gerenciador autocert.Manager. Em seguida, criamos nossa pr\u00f3pria inst\u00e2ncia http.Server (at\u00e9 agora, usamos a padr\u00e3o) e adicionamos o gerenciador na configura\u00e7\u00e3o TLS do servidor:<\/p>\n
m := &autocert.Manager{\nCache:      autocert.DirCache(\"golang-autocert\"),\nPrompt:     autocert.AcceptTOS,\nHostPolicy: autocert.HostWhitelist(\"example.org\", \"www.example.org\"),\n}\nserver := &http.Server{\n    Addr:      \":443\",\n    TLSConfig: m.TLSConfig(),\n}\nserver.ListenAndServeTLS(\"\", \"\")<\/code><\/pre>\n
\nEsta \u00e9 uma maneira simples de implementar suporte completo a HTTPS com atualiza\u00e7\u00e3o autom\u00e1tica do certificado.<\/p>\n
Adicionando rotas n\u00e3o padr\u00e3o<\/h3>\n
\nO roteador padr\u00e3o inclu\u00eddo na biblioteca padr\u00e3o \u00e9 bom, mas \u00e9 muito simples. A maioria dos aplicativos requer uma rotea\u00e7\u00e3o mais complexa, incluindo rotas aninhadas e wildcard, ou o procedimento de configura\u00e7\u00e3o de templates e par\u00e2metros de caminhos.<\/p>\n
Nesse caso, vale a pena usar os pacotes gorilla\/mux<\/a><\/noindex> e go-chi\/chi<\/a><\/noindex>. Com o \u00faltimo, aprenderemos a trabalhar \u2014 abaixo est\u00e1 um exemplo.<\/p>\n
Dado \u2014 o arquivo api\/v1\/api.go, contendo as rotas para nossa API:<\/p>\n
\/ HelloResponse is the JSON representation for a customized message\ntype HelloResponse struct {\nMessage string `json:\"message\"`\n}\n \n\/\/ HelloName returns a personalized JSON message\nfunc HelloName(w http.ResponseWriter, r *http.Request) {\nname := chi.URLParam(r, \"name\")\nresponse := HelloResponse{\nMessage: fmt.Sprintf(\"Hello %s!\", name),\n}\njsonResponse(w, response, http.StatusOK)\n}\n \n\/\/ NewRouter returns an HTTP handler that implements the routes for the API\nfunc NewRouter() http.Handler {\nr := chi.NewRouter()\nr.Get(\"\/{name}\", HelloName)\nreturn r\n}<\/code><\/pre>\n
\nConfiguramos para as rotas o prefixo api\/vq no arquivo principal.<\/p>\n
Podemos ent\u00e3o montar isso no nosso roteador principal sob o prefixo api\/v1 de volta em nossa aplica\u00e7\u00e3o principal:<\/p>\n
\/\/ NewRouter returns a new HTTP handler that implements the main server routes\nfunc NewRouter() http.Handler {\nrouter := chi.NewRouter()\n    router.Mount(\"\/api\/v1\/\", v1.NewRouter())\n    return router\n}\nhttp.Serve(autocert.NewListener(\"example.com\"), NewRouter())<\/code><\/pre>\n
\nA facilidade de trabalhar com rotas complexas em Go torna poss\u00edvel simplificar a estrutura\u00e7\u00e3o ao lidar com grandes aplica\u00e7\u00f5es complexas.<\/p>\n
Trabalhando com middleware<\/h3>\n
\nNo caso do processamento intermedi\u00e1rio, usa-se o encapsulamento de um manipulador HTTP em outro, permitindo rapidamente realizar autentica\u00e7\u00e3o, compress\u00e3o, registro e algumas outras fun\u00e7\u00f5es.<\/p>\n
Como exemplo, considere a interface http.Handler, com a qual escreveremos um manipulador com autentica\u00e7\u00e3o de usu\u00e1rios do servi\u00e7o.<\/p>\n
func RequireAuthentication(next http.Handler) http.Handler {\n    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {\n        if !isAuthenticated(r) {\n            http.Redirect(w, r, \"\/login\", http.StatusTemporaryRedirect)\n            return\n        }\n        \/\/ Supondo que a autentica\u00e7\u00e3o tenha sido bem-sucedida, execute o manipulador original\n        next.ServeHTTP(w, r)\n    })\n}<\/code><\/pre>\n
\nExistem roteadores de terceiros, como o chi, que permitem expandir a funcionalidade do middleware.<\/p>\n
Trabalhando com arquivos est\u00e1ticos<\/h3>\n
\nA biblioteca padr\u00e3o do Go inclui recursos para trabalhar com conte\u00fado est\u00e1tico, incluindo imagens, bem como arquivos JavaScript e CSS. Voc\u00ea pode acess\u00e1-los atrav\u00e9s da fun\u00e7\u00e3o http.FileServer. Ela retorna um manipulador que serve arquivos de um diret\u00f3rio espec\u00edfico.<\/p>\n
func NewRouter() http.Handler {\n    router := chi.NewRouter()\n    r.Get(\"\/{name}\", HelloName)\n \n\/\/ Configura\u00e7\u00e3o da distribui\u00e7\u00e3o de arquivos est\u00e1ticos\nstaticPath, _ := filepath.Abs(\"..\/\/..\/\/static\/\/\")\nfs := http.FileServer(http.Dir(staticPath))\n    router.Handle(\"\/*\", fs)\n    \n    return r<\/code><\/pre>\n
\n\u00c9 importante lembrar que http.Dir exibe o conte\u00fado do diret\u00f3rio caso n\u00e3o exista um arquivo principal index.html. Neste caso, para evitar a exposi\u00e7\u00e3o do diret\u00f3rio, voc\u00ea deve usar o pacote n\u00e3o indexado<\/code><\/a><\/noindex>.<\/p>\n
Encerramento correto<\/h3>\n
\nEm Go, tamb\u00e9m existe uma fun\u00e7\u00e3o para o encerramento correto do servidor HTTP. Isso pode ser feito usando o m\u00e9todo Shutdown(). O servidor \u00e9 iniciado em uma goroutine, e depois um canal \u00e9 escutado para receber o sinal de interrup\u00e7\u00e3o. Assim que o sinal \u00e9 recebido, o servidor \u00e9 desligado, mas n\u00e3o imediatamente, e sim ap\u00f3s alguns segundos.<\/p>\n
handler := server.NewRouter()\nsrv := &http.Server{\n    Handler: handler,\n}\n \ngo func() {\nsrv.Serve(autocert.NewListener(domains...))\n}()\n \n\/\/ Aguarde uma interrup\u00e7\u00e3o\nc := make(chan os.Signal, 1)\nsignal.Notify(c, os.Interrupt)\n<-c\n \n\/\/ Tente um encerramento gracioso\nctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)\ndefere cancel()\nsrv.Shutdown(ctx)<\/code><\/pre>\n
<\/p>\n
Em conclus\u00e3o<\/h3>\n
\nGo \u00e9 uma linguagem poderosa com uma biblioteca padr\u00e3o praticamente universal. Suas capacidades padr\u00e3o s\u00e3o bastante amplas, e podem ser ampliadas atrav\u00e9s de interfaces \u2014 isso permite desenvolver servidores HTTP realmente confi\u00e1veis.<\/p>\n
A Skillbox recomenda:<\/b><\/p>\n