{"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\/sv\/blog\/news\/razrabotka-veb-serverov-na-golang-ot-prostogo-k-slozhnomu","title":{"rendered":"Utveckling av webbservrar i Golang \u2013 fr\u00e5n enkelt till komplext","gt_translate_keys":[{"key":"rendered","format":"text"}]},"content":{"rendered":"

\"Utveckling
\n
\nF\u00f6r fem \u00e5r sedan b\u00f6rjade jag utveckla Gophish<\/a><\/noindex>, vilket gav mig m\u00f6jlighet att l\u00e4ra mig Golang. Jag ins\u00e5g att Go \u00e4r ett kraftfullt spr\u00e5k vars m\u00f6jligheter kompletteras av m\u00e5nga bibliotek. Go \u00e4r m\u00e5ngsidigt: framf\u00f6r allt kan man utan problem utveckla serverapplikationer med det.<\/p>\n

Denna artikel handlar om att skriva en server i Go. Vi b\u00f6rjar med enkla saker, som \"Hello world!\", och avslutar med en applikation med f\u00f6ljande funktioner:<\/p>\n

\u2014 Anv\u00e4ndning av Let's Encrypt f\u00f6r HTTPS.
\n\u2014 Arbetar som en API-ruttare.
\n\u2014 Arbetar med middleware.
\n\u2014 Hantering av statiska filer.
\n\u2014 Korrekt avslutande av arbetet.
\n<\/a><\/noindex><\/p>\n

Skillbox rekommenderar:<\/b> Praktisk kurs \u00abPython-utvecklare fr\u00e5n grunden\u00bb<\/a><\/noindex>.<\/p>\n

P\u00e5minnelse:<\/b> f\u00f6r alla l\u00e4sare av \"Habr\" \u2014 10 000 rubel rabatt vid registrering f\u00f6r vilken kurs som helst p\u00e5 Skillbox med rabattkoden \"Habr\".<\/i>\n<\/p><\/blockquote>\n

Hej, v\u00e4rlden!<\/h3>\n

\nAtt skapa en webbserver i Go g\u00e5r mycket snabbt. H\u00e4r \u00e4r ett exempel p\u00e5 en hanterare som returnerar den ovan n\u00e4mnda \"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 detta, om du startar applikationen och \u00f6ppnar sidan localhost<\/noindex>, kommer du omedelbart att se texten \"Hello, world!\" (naturligtvis om allt fungerar som det ska).<\/p>\n
D\u00e4refter kommer vi att anv\u00e4nda hanteraren flera g\u00e5nger, men f\u00f6rst l\u00e5t oss f\u00f6rst\u00e5 hur allt fungerar.<\/p>\n
net\/http<\/h4>\n
\nI exemplet anv\u00e4ndes paketet net\/http<\/code><\/a><\/noindex>, det \u00e4r huvudsakligt verktyg i Go f\u00f6r att utveckla b\u00e5de servrar och HTTP-klienter. F\u00f6r att f\u00f6rst\u00e5 koden, l\u00e5t oss g\u00e5 igenom betydelsen av tre viktiga element: http.Handler, http.ServeMux och http.Server.<\/p>\n
HTTP-hanterare<\/h4>\n
\nN\u00e4r vi f\u00e5r en beg\u00e4ran analyserar hanteraren den och formar ett svar. Hanterarna i Go implementeras p\u00e5 f\u00f6ljande s\u00e4tt:<\/p>\n
type Handler interface {\n        ServeHTTP(ResponseWriter, *Request)\n}<\/code><\/pre>\n
\nI det f\u00f6rsta exemplet anv\u00e4nds hj\u00e4lpfunktionen http.HandleFunc. Den omsluter en annan funktion som i sin tur tar http.ResponseWriter och http.Request i ServeHTTP.<\/p>\n
Med andra ord, hanterarna i Golang representeras av ett enda gr\u00e4nssnitt, vilket ger m\u00e5nga m\u00f6jligheter f\u00f6r programmeraren. Till exempel, middleware implementeras med hj\u00e4lp av en hanterare, d\u00e4r ServeHTTP f\u00f6rst g\u00f6r n\u00e5got och sedan anropar ServeHTTP-metoden f\u00f6r en annan hanterare.<\/p>\n
Som tidigare n\u00e4mnts formar hanterarna helt enkelt svar p\u00e5 beg\u00e4rningar. Men vilken specifik hanterare ska man anv\u00e4nda vid ett givet tillf\u00e4lle?<\/p>\n
Ruttning av beg\u00e4rningar<\/h4>\n
\nF\u00f6r att g\u00f6ra ett korrekt val, anv\u00e4nd HTTP-multiplexern. I flera bibliotek kallas den muxer eller router, men allt detta \u00e4r samma sak. Multiplexerns funktion \u00e4r att analysera s\u00f6kv\u00e4gen f\u00f6r f\u00f6rfr\u00e5gan och v\u00e4lja motsvarande hanterare.<\/p>\n
Om du beh\u00f6ver st\u00f6d f\u00f6r mer komplexa ruttningar, \u00e4r det b\u00e4ttre att anv\u00e4nda externa bibliotek. N\u00e5gra av de mest avancerade \u00e4r gorilla\/mux<\/a><\/noindex> och go-chi\/chi<\/a><\/noindex>, dessa bibliotek m\u00f6jligg\u00f6r mellanliggande bearbetning utan st\u00f6rre problem. Med deras hj\u00e4lp kan du konfigurera wildcard-routing och utf\u00f6ra en rad andra uppgifter. Deras f\u00f6rdel \u00e4r kompatibilitet med standard HTTP-hanterare. Som ett resultat kan du skriva enkel kod med m\u00f6jlighet till framtida modifieringar.<\/p>\n
Arbete med komplexa ramverk i vanliga situationer kr\u00e4ver inte helt standardl\u00f6sningar, vilket v\u00e4sentligt komplicerar anv\u00e4ndningen av standardhanterare. F\u00f6r att skapa majoriteten av applikationerna r\u00e4cker det med en kombination av det standardbiblioteket och en enkel router.<\/p>\n
Beg\u00e4rningshantering<\/h4>\n
\nDessutom beh\u00f6ver vi en komponent som 'lyssnar' p\u00e5 inkommande anslutningar och dirigerar alla f\u00f6rfr\u00e5gningar till r\u00e4tt hanterare. Denna uppgift klarar http.Server utan problem.<\/p>\n
Nedan visas att servern ansvarar f\u00f6r alla uppgifter relaterade till behandlingen av anslutningar. Det handlar till exempel om arbete enligt TLS-protokollet. F\u00f6r att implementera anropet http.ListenAndServer anv\u00e4nds standard HTTP-servern.<\/p>\n
Nu ska vi titta p\u00e5 mer komplexa exempel.<\/p>\n
Till\u00e4gg av Let\u2019s Encrypt<\/h3>\n
\nSom standard fungerar v\u00e5r applikation via HTTP-protokollet, men det rekommenderas att anv\u00e4nda HTTPS-protokollet. I Go g\u00e5r detta utan problem. Om du har f\u00e5tt ett certifikat och en privat nyckel, r\u00e4cker det med att ange ListenAndServeTLS med r\u00e4tt filer f\u00f6r certifikatet och nyckeln.<\/p>\n
http.ListenAndServeTLS(\":443\", \"cert.pem\", \"key.pem\", nil)<\/code><\/pre>\n
\nDet g\u00e5r alltid att g\u00f6ra det b\u00e4ttre.<\/p>\n
Let's Encrypt<\/a><\/noindex> erbjuder gratis certifikat med m\u00f6jlighet till automatisk f\u00f6rnyelse. F\u00f6r att anv\u00e4nda tj\u00e4nsten beh\u00f6vs paketet autocert<\/code>.<\/p>\n
Det enklaste s\u00e4ttet att konfigurera det \u00e4r att anv\u00e4nda metoden autocert.NewListener i kombination med http.Serve. Metoden g\u00f6r det m\u00f6jligt att f\u00e5 och f\u00f6rnya TLS-certifikat, medan HTTP-servern hanterar f\u00f6rfr\u00e5gningarna:<\/p>\n
http.Serve(autocert.NewListener(\"example.com\"), nil)<\/code><\/pre>\n
\nOm vi \u00f6ppnar i webbl\u00e4saren example.com<\/a><\/noindex>, f\u00e5r vi HTTPS-svar \"Hello, world!\".<\/p>\n
Om du beh\u00f6ver en mer noggrann konfiguration, b\u00f6r du anv\u00e4nda autocert.Manager. Skapa sedan din egen instans av http.Server (hittills har vi anv\u00e4nt standardinstansen) och l\u00e4gg till managern i serverns 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
\nDetta \u00e4r ett enkelt s\u00e4tt att implementera fullst\u00e4ndigt st\u00f6d f\u00f6r HTTPS med automatisk certifikatf\u00f6rnyelse.<\/p>\n
L\u00e4gga till icke-standardrutter<\/h3>\n
\nDen standardrouter som ing\u00e5r i standardbiblioteket \u00e4r bra, men den \u00e4r mycket enkel. De flesta applikationer beh\u00f6ver en mer komplicerad routing, inklusive inb\u00e4ddade och wildcard-rutter eller en process f\u00f6r att st\u00e4lla in mallar och v\u00e4gparameterar.<\/p>\n
I det h\u00e4r fallet b\u00f6r vi anv\u00e4nda paketen gorilla\/mux<\/a><\/noindex> och go-chi\/chi<\/a><\/noindex>. Vi kommer att l\u00e4ra oss att arbeta med det \u2014 en exempel visas nedan.<\/p>\n
Givet \u2014 filen api\/v1\/api.go, som inneh\u00e5ller rutter f\u00f6r v\u00e5rt 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\u00e4tter en prefix f\u00f6r rutter api\/vq i huvudfilen.<\/p>\n
Vi kan sedan montera detta p\u00e5 v\u00e5r huvudrouter under prefixet api\/v1 i v\u00e5r huvudapplikation:<\/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
\nEnkelheten i att arbeta med komplexa rutter i Go g\u00f6r det m\u00f6jligt att f\u00f6renkla strukturen f\u00f6r att hantera stora och komplexa applikationer.<\/p>\n
Arbeta med mellanprogram<\/h3>\n
\nVid anv\u00e4ndning av mellanprogram omger man en HTTP-behandlare med en annan, vilket m\u00f6jligg\u00f6r snabb autentisering, komprimering, loggning och n\u00e5gra andra funktioner.<\/p>\n
Som exempel, l\u00e5t oss titta p\u00e5 gr\u00e4nssnittet http.Handler, med hj\u00e4lp av detta skriver vi en behandlare med autentisering f\u00f6r anv\u00e4ndare av tj\u00e4nsten.<\/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        \/\/ Om autentiseringen lyckades, k\u00f6r den ursprungliga behandlaren\n        next.ServeHTTP(w, r)\n    })\n}<\/code><\/pre>\n
\nDet finns externa routrar som chi, som m\u00f6jligg\u00f6r ut\u00f6kning av funktionaliteten f\u00f6r mellanprogram.<\/p>\n
Arbeta med statiska filer<\/h3>\n
\nStandardbiblioteket i Go inkluderar funktioner f\u00f6r att hantera statiskt inneh\u00e5ll, inklusive bilder, samt JavaScript- och CSS-filer. \u00c5tkomst till dem kan g\u00f6ras via funktionen http.FileServer. Den returnerar en behandlare som serverar filer fr\u00e5n en specifik katalog.<\/p>\n
func NewRouter() http.Handler {\n    router := chi.NewRouter()\n    r.Get(\"\/{name}\", HelloName)\n \n\/\/ Konfigurera distribution av statiska filer\nstaticPath, _ := filepath.Abs(\"..\/..\/\/static\/\")\nfs := http.FileServer(http.Dir(staticPath))\n    router.Handle(\"\/*\", fs)\n    \n    return r<\/code><\/pre>\n
\nDet \u00e4r viktigt att komma ih\u00e5g att http.Dir visar inneh\u00e5llet i katalogen om det inte finns n\u00e5gon huvudfil index.html i den. I detta fall, f\u00f6r att undvika katalogkompromiss, b\u00f6r paketet anv\u00e4ndas oberoende<\/code><\/a><\/noindex>.<\/p>\n
Korrekt avst\u00e4ngning<\/h3>\n
\nI Go finns det ocks\u00e5 en funktion f\u00f6r korrekt avst\u00e4ngning av HTTP-servern. Detta kan g\u00f6ras med hj\u00e4lp av metoden Shutdown(). Servern startas i en goroutine, och sedan lyssnas p\u00e5 kanalen f\u00f6r att ta emot avbrottssignaler. S\u00e5 snart signalen tas emot st\u00e4ngs servern ner, men inte omedelbart, utan efter n\u00e5gra sekunder.<\/p>\n
handler := server.NewRouter()\nsrv := &http.Server{\n    Handler: handler,\n}\n \ngo func() {\nsrv.Serve(autocert.NewListener(domains...))\n}()\n \n\/\/ V\u00e4nta p\u00e5 ett avbrott\nc := make(chan os.Signal, 1)\nsignal.Notify(c, os.Interrupt)\n<-c\n \n\/\/ F\u00f6rs\u00f6k en smidig avst\u00e4ngning\nctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)\ndefer cancel()\nsrv.Shutdown(ctx)<\/code><\/pre>\n
<\/p>\n
Som en avslutning<\/h3>\n
\nGo \u00e4r ett kraftfullt spr\u00e5k med en praktiskt taget universell standardbibliotek. Dess standardfunktioner \u00e4r ganska omfattande, och de kan f\u00f6rst\u00e4rkas med hj\u00e4lp av gr\u00e4nssnitt \u2014 detta m\u00f6jligg\u00f6r utveckling av verkligt tillf\u00f6rlitliga HTTP-servrar.<\/p>\n
Skillbox rekommenderar:<\/b><\/p>\n