{"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\/et\/blog\/novosti-interneta\/razrabotka-veb-serverov-na-golang-ot-prostogo-k-slozhnomu","title":{"rendered":"Veebiserverite arendamine Golangis \u2014 lihtsast keeruliseni","gt_translate_keys":[{"key":"rendered","format":"text"}]},"content":{"rendered":"

\"Veebiserverite
\n
\nViis aastat tagasi alustasin Gophishi arendamist<\/a><\/noindex>, see andis v\u00f5imaluse Golangi \u00f5ppimiseks. M\u00f5istsin, et Go on v\u00f5imas keel, mille v\u00f5imalusi t\u00e4iendavad mitmed teegid. Go on universaalne: selle abil on lihtne arendada serverirakendusi.<\/p>\n

See artikkel on p\u00fchendatud Go-s serveri kirjutamisele. Alustame lihtsatest asjadest, nagu \"Tere maailm!\", ja l\u00f5petame rakendusega, millel on j\u00e4rgmised v\u00f5imalused:<\/p>\n

\u2014 Let\u2019s Encrypti kasutamine HTTPS-i jaoks.
\n\u2014 T\u00f6\u00f6 API marsruutijana.
\n\u2014 T\u00f6\u00f6 middleware\u2019iga.
\n\u2014 Statiliste failide t\u00f6\u00f6tlemine.
\n\u2014 Korralik l\u00f5petamine.
\n<\/a><\/noindex><\/p>\n

Skillbox soovitab:<\/b> Praktiline kursus \u201ePython-arendaja algusest peale\u201c<\/a><\/noindex>.<\/p>\n

Tuletame meelde:<\/b> k\u00f5igile \u00abHabra\u00bb lugejatele \u2014 10 000 rubla soodustus, kui registreerite end Skillboxi mis tahes kursusele promokoodi \u00abHabr\u00bb abil.<\/i>\n<\/p><\/blockquote>\n

Tere, maailm!<\/h3>\n

\nVeebiserveri loomine Go-s on v\u00e4ga kiire. Siin on n\u00e4ide t\u00f6\u00f6tlejast, mis naaseb lubatud \"Tere, maailm!\".<\/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, \"Tere maailm!\")\n})\nhttp.ListenAndServe(\":80\", nil)\n}<\/code><\/pre>\n
\nP\u00e4rast seda, kui rakendus k\u00e4ivitada ja lehte avada localhost<\/noindex>, n\u00e4ete kohe teksti \"Tere, maailm!\" (loomulikult, kui k\u00f5ik t\u00f6\u00f6tab \u00f5igesti).<\/p>\n
Edasi kavatseme t\u00f6\u00f6tlejat mitu korda kasutada, kuid esmalt m\u00f5istame, kuidas k\u00f5ik on \u00fcles seatud.<\/p>\n
net\/http<\/h4>\n
\nN\u00e4ites kasutati paketti net\/http<\/code><\/a><\/noindex>, mis on Go-s peamine vahend serverite ja HTTP-kliendi arendamiseks. Koodi parema m\u00f5istmise nimel tutvume kolme olulise elemendi t\u00e4hendusega: http.Handler, http.ServeMux ja http.Server.<\/p>\n
HTTP t\u00f6\u00f6tlejad<\/h4>\n
\nKui saame p\u00e4ringu, anal\u00fc\u00fcsib t\u00f6\u00f6tleja selle ja vormib vastuse. Go-s on t\u00f6\u00f6tlejad rakendatud j\u00e4rgmiselt:<\/p>\n
type Handler interface {\n        ServeHTTP(ResponseWriter, *Request)\n}<\/code><\/pre>\n
\nEsimeses n\u00e4ites kasutatakse abifunktsiooni http.HandleFunc. See \u00fcmbritseb teise funktsiooni, mis omakorda v\u00f5tab vastu http.ResponseWriter ja http.Request funktsioonis ServeHTTP.<\/p>\n
Teisiti \u00f6eldes, on t\u00f6\u00f6tlejad Golangis esitatud \u00fchtse liidesena, mis annab programmeerijale palju v\u00f5imalusi. N\u00e4iteks rakendatakse middleware t\u00f6\u00f6tleja kaudu, kus ServeHTTP teeb k\u00f5igepealt midagi ja seej\u00e4rel kutsub teise t\u00f6\u00f6tleja ServeHTTP meetodi.<\/p>\n
Nagu juba mainitud, kujundavad t\u00f6\u00f6tlejad lihtsalt vastuseid p\u00e4ringutele. Kuid millist t\u00f6\u00f6tlejat on konkreetsel hetkel vaja kasutada?<\/p>\n
P\u00e4ringute marsruutimine<\/h4>\n
\n\u00d5ige valiku tegemiseks kasutage HTTP-multiplexerit. Mitmes raamatukogus nimetatakse seda muxeriks v\u00f5i ruuteriks, kuid t\u00f5epoolest on need k\u00f5ik \u00fchesugused. Multiplexer'i funktsioon on anal\u00fc\u00fcsida p\u00e4ringu teed ja valida vastav t\u00f6\u00f6tleja.<\/p>\n
Kui on vajalik keeruka marsruutimise tugi, siis on parem kasutada kolmandate osapoolte raamatukogusid. \u00dcks k\u00f5ige arenenumatest on gorilla\/mux<\/a><\/noindex> ja go-chi\/chi<\/a><\/noindex>, need raamatukogud v\u00f5imaldavad h\u00f5lpsasti rakendada vahepealse t\u00f6\u00f6tlemise lahendusi. Nende abil saate seadistada wildcard-marsruutimise ja teisi \u00fclesandeid. Nende eeliseks on \u00fchilduvus standardsete HTTP-t\u00f6\u00f6tlejatega. Tulemusena saate kirjutada lihtsa koodi, millel on v\u00f5imalus seda tulevikus kohandada.<\/p>\n
T\u00f6\u00f6tamine keerukate raamistikudega tavap\u00e4rases olukorras n\u00f5uab mitte v\u00e4ga standardseid lahendusi, mis oluliselt raskendab vaikimisi t\u00f6\u00f6tlejate kasutamist. Enamik rakendusi saavad hakkama vaikimisi raamatukogu ja lihtsa ruuteriga.<\/p>\n
P\u00e4ringute t\u00f6\u00f6tlemine<\/h4>\n
\nLisaks vajame komponenti, mis \"kuulab\" sisse tulevaid \u00fchendusi ja suunab k\u00f5ik p\u00e4ringud \u00f5ige t\u00f6\u00f6tleja juurde. Selle \u00fclesande t\u00e4idab probleemideta http.Server.<\/p>\n
Allpool on n\u00e4idatud, et server vastutab k\u00f5igi \u00fclesannete eest, mis on seotud \u00fchenduste t\u00f6\u00f6tlemisega. N\u00e4iteks toimub siin TLS-protokolli t\u00f6\u00f6tlemine. http.ListenAndServeri rakendamiseks kasutatakse standardset HTTP-serverit.<\/p>\n
N\u00fc\u00fcd vaatame keerulisemaid n\u00e4iteid.<\/p>\n
Lisamine Let\u2019s Encrypt<\/h3>\n
\nVaikimisi t\u00f6\u00f6tab meie rakendus HTTP-protokolli kaudu, kuid on soovitatav kasutada HTTPS-protokolli. Go-s on see lihtne. Kui olete saanud sertifikaadi ja privaatv\u00f5tme, piisab, kui kutsuda esile ListenAndServeTLS, osutades \u00f5igele sertifikaadi ja v\u00f5tme failile.<\/p>\n
http.ListenAndServeTLS(\":443\", \"cert.pem\", \"key.pem\", nil)<\/code><\/pre>\n
\nAlati on v\u00f5imalik paremini teha.<\/p>\n
Let\u2019s Encrypt<\/a><\/noindex> pakub tasuta sertifikaate automaatse uuendamise v\u00f5imalusega. Teenuse kasutamiseks on vajalik pakett autocert<\/code>.<\/p>\n
Lihtsaim viis selle seadistamiseks on kasutada autocert.NewListener meetodit koos http.Serve'iga. See meetod v\u00f5imaldab hankida ja uuendada TLS-sertifikaate, samal ajal kui HTTP-server k\u00e4sitleb p\u00e4ringuid:<\/p>\n
http.Serve(autocert.NewListener(\"example.com\"), nil)<\/code><\/pre>\n
\nKui avame brauseris example.com<\/a><\/noindex>, saame HTTPS-vastuse \u201eHello, world!\u201d.<\/p>\n
Kui vajame t\u00e4iendavat seadistamist, on soovitatav kasutada autocert.Manager haldurit. Seej\u00e4rel loome oma http.Server eksemplari (kuni siiamaani kasutasime vaikeversiooni) ja lisame halduri serveri TLSConfig'i:<\/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
\nSee on lihtne viis t\u00e4ieliku HTTPS toe rakendamiseks koos automaatse sertifikaadi uuendamisega.<\/p>\n
Kohandatud marsruutide lisamine<\/h3>\n
\nStandardteekide vaikemarsruuter, mis on kaasatud standardbiblioteeki, on hea, kuid v\u00e4ga lihtne. Enamikus rakendustes on vaja keerukamat marsruutimist, sealhulgas pesamarsruute ja wildcard-marsruute v\u00f5i samuti mallide ja marsruutide parameetrite m\u00e4\u00e4ramist.<\/p>\n
Selles olukorras on soovitatav kasutada pakette gorilla\/mux<\/a><\/noindex> ja go-chi\/chi<\/a><\/noindex>Meie viimane teema on see, kuidas t\u00f6\u00f6tada . Allpool on n\u00e4ide.<\/p>\n
Antud on fail api\/v1\/api.go, mis sisaldab marsruute meie API-le:<\/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
\nSeadistame marsruutide eelprefiksiks api\/vq peafailis.<\/p>\n
Saame selle mountida meie peamise marsruudile api\/v1\/ prefiksi alla tagasi meie p\u00f5hi\u00e4pis:<\/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
\nGo-s keeruliste marsruutidega t\u00f6\u00f6tamise lihtsus v\u00f5imaldab lihtsustada suuremate keeruliste rakenduste haldamist.<\/p>\n
T\u00f6\u00f6tamine vahekihiga<\/h3>\n
\nVahekihtide t\u00f6\u00f6tamisel \u00fcmbritsetakse \u00fchte HTTP-k\u00e4sitlejat teisega, mis v\u00f5imaldab kiiresti teostada autentimist, tihendamist, logimist ja m\u00f5ningaid muid funktsioone.<\/p>\n
N\u00e4iteks vaatame http.Handler liidest, millega kirjutame HTTP-k\u00e4sitleja, mis teostab teenuse kasutajate autentimist.<\/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        \/\/ Eeldades, et autentimine on l\u00e4bitud, k\u00e4ivita algne k\u00e4sitleja\n        next.ServeHTTP(w, r)\n    })\n}<\/code><\/pre>\n
\nOn ka kolmandate osapoolte marsruuterid, nagu chi, mis v\u00f5imaldavad laiendada vahekihit\u00f6\u00f6tluse funktsionaalsust.<\/p>\n
T\u00f6\u00f6tamine staatiliste failidega<\/h3>\n
\nGo standardraamatukogus on olemas v\u00f5imalused staatilise sisu t\u00f6\u00f6tlemiseks, sealhulgas piltide ning JavaScripti ja CSS-failide jaoks. Neile p\u00e4\u00e4seb juurde funktsiooni http.FileServer kaudu, mis tagastab t\u00f6\u00f6tleja, mis jagab faile m\u00e4\u00e4ratud kataloogist.<\/p>\n
func NewRouter() http.Handler {\n    router := chi.NewRouter()\n    r.Get(\"\/{name}\", HelloName)\n\n\/\/ Staatiliste failide jagamise seadistus\nstaticPath, _ := filepath.Abs(\"..\/..\/..\/static\/\")\nfs := http.FileServer(http.Dir(staticPath))\n    router.Handle(\"\/*\", fs)\n\n    return r<\/code><\/pre>\n
\nOluline on meeles pidada, et http.Dir kuvab katalooge ainult siis, kui seal ei ole p\u00f5hifaili index.html. Sellisel juhul, et v\u00e4ltida katalooge riskimist, tuleks kasutada paketti unindexed<\/code><\/a><\/noindex>.<\/p>\n
Korrektselt t\u00f6\u00f6 l\u00f5petamine<\/h3>\n
\nGo-s on olemas ka selline funktsioon nagu HTTP-serveri korrektselt t\u00f6\u00f6 l\u00f5petamine. Seda saab teha meetodi Shutdown() abil. Server k\u00e4ivitatakse goroutine'is ning seej\u00e4rel kuulatakse signaali katkestamise vastuv\u00f5tmiseks. Nii varsti kui signaal on saadud, l\u00fclitatakse server v\u00e4lja, kuid mitte kohe, vaid m\u00f5ne sekundi p\u00e4rast.<\/p>\n
handler := server.NewRouter()\nsrv := &http.Server{\n    Handler: handler,\n}\n \ngo func() {\nsrv.Serve(autocert.NewListener(domains...))\n}()\n \n\/\/ Oota katkestust\nc := make(chan os.Signal, 1)\nsignal.Notify(c, os.Interrupt)\n<-c\n \n\/\/ Proovi korralikku sulgemist\nctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)\ndefer cancel()\nsrv.Shutdown(ctx)<\/code><\/pre>\n
<\/p>\n
Kokkuv\u00f5tteks<\/h3>\n
\nGo \u2014 v\u00f5imas keel, millel on praktiliselt universaalne standardraamatukogu. Selle vaikimisi v\u00f5imalused on \u00fcsna laiad, ja neid saab tugevdada liideste abil \u2014 see v\u00f5imaldab arendada t\u00f5eliselt usaldusv\u00e4\u00e4rseid HTTP-servereid.<\/p>\n
Skillbox soovitab:<\/b><\/p>\n