{"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\/da\/blog\/news\/razrabotka-veb-serverov-na-golang-ot-prostogo-k-slozhnomu","title":{"rendered":"Udvikling af webservere p\u00e5 Golang - fra simpel til kompleks","gt_translate_keys":[{"key":"rendered","format":"text"}]},"content":{"rendered":"

\"Udvikling
\n
\nFor fem \u00e5r siden begyndte jeg at udvikle Gophish<\/a><\/noindex>, det gav mig mulighed for at l\u00e6re Golang. Jeg inds\u00e5, at Go er et kraftfuldt sprog, hvis muligheder supplerer et v\u00e6ld af biblioteker. Go er alsidigt: specielt kan det bruges til let at udvikle serverapplikationer.<\/p>\n

Denne artikel handler om at skrive en server i Go. Vi starter med enkle elementer, s\u00e5som 'Hello world!', og afslutter med en applikation med f\u00f8lgende funktioner:<\/p>\n

\u2014 Anvendelse af Let\u2019s Encrypt til HTTPS.
\n\u2014 Funktionere som API-router.
\n\u2014 Arbejde med middleware.
\n\u2014 H\u00e5ndtering af statiske filer.
\n\u2014 Korrekt nedlukning.
\n<\/a><\/noindex><\/p>\n

Skillbox anbefaler:<\/b> Praktisk kursus \u00abPython-udvikler fra bunden\u00bb<\/a><\/noindex>.<\/p>\n

Vi minder om:<\/b> til alle l\u00e6sere af 'Habr' \u2014 rabat p\u00e5 10.000 rubler ved tilmelding til et hvilket som helst Skillbox-kursus med rabatkoden 'Habr'.<\/i>\n<\/p><\/blockquote>\n

Hello, world!<\/h3>\n

\nDet er meget hurtigt at oprette en webserver i Go. Her er et eksempel p\u00e5 en handler, der returnerer den lovede '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
\nEfter dette, hvis du k\u00f8rer applikationen og \u00e5bner siden localhost<\/noindex>, vil du straks se teksten 'Hello, world!' (naturligvis, hvis alt fungerer korrekt).<\/p>\n
Herefter vil vi flere gange bruge handleren, men f\u00f8rst lad os forst\u00e5, hvordan det hele fungerer.<\/p>\n
net\/http<\/h4>\n
\nI eksemplet blev pakken net\/http<\/code><\/a><\/noindex>, som er det prim\u00e6re v\u00e6rkt\u00f8j i Go til udvikling af b\u00e5de servere og HTTP-klienter. For at forst\u00e5 koden, lad os se p\u00e5 betydningen af tre vigtige elementer: http.Handler, http.ServeMux og http.Server.<\/p>\n
HTTP-handlere<\/h4>\n
\nN\u00e5r vi modtager en anmodning, analyserer handleren den og formidler et svar. Handlere i Go implementeres s\u00e5ledes:<\/p>\n
type Handler interface {\n        ServeHTTP(ResponseWriter, *Request)\n}<\/code><\/pre>\n
\nI det f\u00f8rste eksempel bruges hj\u00e6lpefunktionen http.HandleFunc. Den indkapsler en anden funktion, som igen modtager http.ResponseWriter og http.Request i ServeHTTP.<\/p>\n
Med andre ord er handlere i Golang repr\u00e6senteret af et f\u00e6lles interface, hvilket giver programm\u00f8ren mange muligheder. S\u00e5ledes er middleware implementeret ved hj\u00e6lp af en handler, hvor ServeHTTP f\u00f8rst g\u00f8r noget, og derefter kalder metoden ServeHTTP for en anden handler.<\/p>\n
Som n\u00e6vnt tidligere, danner handlere blot svar p\u00e5 anmodninger. Men hvilken specifik handler skal bruges p\u00e5 et givet tidspunkt?<\/p>\n
Routing af anmodninger<\/h4>\n
\nFor making the right choice, use the HTTP multiplexer. In several libraries, it is called a muxer or router, but they are all the same. The function of the multiplexer is to analyze the request path and select the appropriate handler.<\/p>\n
If support for complex routing is needed, it is better to use third-party libraries. Some of the most advanced are gorilla\/mux<\/a><\/noindex> og go-chi\/chi<\/a><\/noindex>, these libraries allow for middleware processing without any problems. With them, you can set up wildcard routing and perform a number of other tasks. Their advantage is compatibility with standard HTTP handlers. As a result, you can write simple code with the ability to modify it in the future.<\/p>\n
Working with complex frameworks usually requires somewhat non-standard solutions, which significantly complicates the use of default handlers. For creating the overwhelming majority of applications, a combination of the default library and a simple router is sufficient.<\/p>\n
Request processing<\/h4>\n
\nIn addition, we need a component that will 'listen' for incoming connections and redirect all requests to the correct handler. This task can easily be handled by http.Server.<\/p>\n
Below is shown that the server is responsible for all tasks related to connection processing. This includes working with the TLS protocol. The standard HTTP server is used to implement http.ListenAndServer.<\/p>\n
Now let's look at more complex examples.<\/p>\n
Adding Let\u2019s Encrypt<\/h3>\n
\nBy default, our application runs over the HTTP protocol, but it is recommended to use the HTTPS protocol. In Go, this can be done without problems. If you have obtained a certificate and a private key, it is sufficient to write ListenAndServeTLS with the correct certificate and key files specified.<\/p>\n
http.ListenAndServeTLS(\":443\", \"cert.pem\", \"key.pem\", nil)<\/code><\/pre>\n
\nThere is always room for improvement.<\/p>\n
Let\u2019s Encrypt<\/a><\/noindex> provides free certificates with the possibility of automatic renewal. To use the service, the package is needed autocert<\/code>.<\/p>\n
The simplest way to set it up is to use the autocert.NewListener method in combination with http.Serve. The method allows obtaining and updating TLS certificates while the HTTP server processes requests:<\/p>\n
http.Serve(autocert.NewListener(\"example.com\"), nil)<\/code><\/pre>\n
\nIf we open in the browser example.com<\/a><\/noindex>, vi f\u00e5r HTTPS-svaret \u00abHello, world!\u00bb.<\/p>\n
Hvis der er behov for mere pr\u00e6cis konfiguration, b\u00f8r man bruge autocert.Manager. Derefter opretter vi vores egen instans af http.Server (indtil nu har vi brugt standardvarianten) og tilf\u00f8jer manageren til serverens TLSConfig:<\/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
\nDette er en simpel metode til at implementere fuld st\u00f8tte til HTTPS med automatisk opdatering af certifikatet.<\/p>\n
Tilf\u00f8jelse af ikke-standardruter<\/h3>\n
\nDen standardrouter, der er inkluderet i standardbiblioteket, er god, men den er meget simpel. De fleste applikationer har brug for mere kompleks routing, herunder indlejrede og wildcard-ruter eller en procedure for at ops\u00e6tte skabeloner og sti-parametre.<\/p>\n
I dette tilf\u00e6lde b\u00f8r man bruge pakker gorilla\/mux<\/a><\/noindex> og go-chi\/chi<\/a><\/noindex>. Med den sidstn\u00e6vnte vil vi l\u00e6re at arbejde \u2014 nedenfor er et eksempel.<\/p>\n
Givet \u2014 filen api\/v1\/api.go, der indeholder ruter for vores 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
\nVi s\u00e6tter et pr\u00e6fiks api\/vq for ruterne i hovedfilen.<\/p>\n
Vi kan derefter montere dette til vores hovedrouter under api\/v1\/-pr\u00e6fikset tilbage i vores hovedapplikation:<\/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
\nDen enkle h\u00e5ndtering af komplekse ruter i Go g\u00f8r det muligt at simplificere strukturen ved vedligeholdelse af store, komplekse applikationer.<\/p>\n
Arbejde med middleware<\/h3>\n
\nI tilf\u00e6lde af mellemliggende behandling bruges omsluttende en HTTP-handler med en anden, hvilket muligg\u00f8r hurtig autentificering, komprimering, logf\u00f8ring og nogle andre funktioner.<\/p>\n
Som eksempel ser vi p\u00e5 http.Handler-gr\u00e6nsefladen, som vi bruger til at skrive en handler med autentificering af tjeneste brugere.<\/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        \/\/ Antager at autentificering er best\u00e5et, k\u00f8r den oprindelige handler\n        next.ServeHTTP(w, r)\n    })\n}<\/code><\/pre>\n
\nDer er tredjeparts-rutere, s\u00e5som chi, der tilbyder udvidet funktionalitet til mellemliggende behandling.<\/p>\n
Arbejder med statiske filer<\/h3>\n
\nStandardbiblioteket i Go indeholder funktioner til at arbejde med statisk indhold, herunder billeder samt JavaScript- og CSS-filer. Adgang til dem kan f\u00e5s gennem funktionen http.FileServer. Den returnerer en handler, der serverer filer fra et bestemt bibliotek.<\/p>\n
func NewRouter() http.Handler {\n    router := chi.NewRouter()\n    r.Get(\"\/{name}\", HelloName)\n \n\/\/ Konfigurering af statiske filfordelinger\nstaticPath, _ := filepath.Abs(\"..\/\/..\/\/static\/\/\")\nfs := http.FileServer(http.Dir(staticPath))\n    router.Handle(\"\/*\", fs)\n    \n    return r<\/code><\/pre>\n
\nDet er vigtigt at huske, at http.Dir viser indholdet af en mappe, hvis der ikke er nogen hovedfil index.html. I s\u00e5 fald, for at undg\u00e5 kompromittering af mappen, b\u00f8r pakken anvendes uindekseret<\/code><\/a><\/noindex>.<\/p>\n
Korrekt afslutning af arbejdet<\/h3>\n
\nI Go er der ogs\u00e5 en funktion til korrekt afslutning af en HTTP-server. Dette kan g\u00f8res ved hj\u00e6lp af metoden Shutdown(). Serveren k\u00f8rer i en goroutine, og kanalen lytter derefter efter afbrydelsessignaler. S\u00e5 snart signalet er modtaget, slukkes serveren, men ikke straks, men efter et par sekunder.<\/p>\n
handler := server.NewRouter()\nsrv := &http.Server{\n    Handler: handler,\n}\n \ngo func() {\nsrv.Serve(autocert.NewListener(domains...))\n}()\n \n\/\/ Vent p\u00e5 et afbrudt signal\nc := make(chan os.Signal, 1)\nsignal.Notify(c, os.Interrupt)\n<-c\n \n\/\/ Fors\u00f8g en effektiv nedlukning\nctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)\ndefers cancel()\nsrv.Shutdown(ctx)<\/code><\/pre>\n
<\/p>\n
Som konklusion<\/h3>\n
\nGo \u2014 et kraftfuldt sprog med en n\u00e6sten universel standardbibliotek. Dens standardfunktioner er ret omfattende, og de kan styrkes ved hj\u00e6lp af gr\u00e6nseflader \u2014 dette muligg\u00f8r udvikling af virkelig p\u00e5lidelige HTTP-servere.<\/p>\n
Skillbox anbefaler:<\/b><\/p>\n