{"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\/news\/razrabotka-veb-serverov-na-golang-ot-prostogo-k-slozhnomu","title":{"rendered":"Veebiserverite arendamine Golangi abil - lihtsast keeruliseks","gt_translate_keys":[{"key":"rendered","format":"text"}]},"content":{"rendered":"

\"Veebiserverite
\n
\nViis aastat tagasi alustasin ma Gophishi arendamist<\/a><\/noindex>, see andis v\u00f5imaluse \u00f5ppida Golangi. Ma m\u00f5istsin, et Go on v\u00f5imas keel, mille v\u00f5imalusi t\u00e4iendab arvukalt teeke. Go on universaalne: n\u00e4iteks saab seda kasutada serverirakenduste arendamiseks probleemideta.<\/p>\n

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

\u2014 Let\u2019s Encrypti kasutamine HTTPS-iks.
\n\u2014 T\u00f6\u00f6tamine API marsruutijana.
\n\u2014 T\u00f6\u00f6tamine middleware'iga.
\n\u2014 Staatiliste failide t\u00f6\u00f6tlemine.
\n\u2014 Korralik v\u00e4ljal\u00fclitamine.
\n<\/a><\/noindex><\/p>\n

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

Tuletame meelde:<\/b> k\u00f5igile \u00abHabr\u00bb lugejatele \u2013 10 000 rubla allahindlus igale Skillboxi kursusele, kasutades sooduskoodi \u00abHabr\u00bb.<\/i>\n<\/p><\/blockquote>\n

Tere, maailm!<\/h3>\n

\nVeebiserveri loomine Go-s on v\u00e4ga kiire. Siin on n\u00e4ide toimimisest t\u00f6\u00f6tlusest, mis tagastab eelnevalt mainitud \u201eTere, maailm!\u201c.<\/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 leht avada localhost<\/noindex>, n\u00e4ete kohe teksti \u201eTere, maailm!\u201c (muidugi, kui k\u00f5ik t\u00f6\u00f6tab \u00f5igesti).<\/p>\n
Edasi kasutame t\u00f6\u00f6tlust korduvalt, kuid k\u00f5igepealt v\u00f5tame aega m\u00f5istmiseks, kuidas k\u00f5ik toimib.<\/p>\n
net\/http<\/h4>\n
\nN\u00e4ites kasutati paketti net\/http<\/code><\/a><\/noindex>, see on Go p\u00f5hivahend serverite ja HTTP-kliendi arendamiseks. Koodi m\u00f5istmiseks vaatame kolme olulise elemendi t\u00e4hendust: http.Handler, http.ServeMux ja http.Server.<\/p>\n
HTTP-t\u00f6\u00f6tlustooted<\/h4>\n
\nKui me saame p\u00e4ringu, anal\u00fc\u00fcsib t\u00f6\u00f6tlus selle ja koostab 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 teist funktsiooni, mis omakorda v\u00f5tab http.ResponseWriter ja http.Request'i ServeHTTP-s.<\/p>\n
Teisis\u00f5nu, t\u00f6\u00f6tlejad Golangis esindavad \u00fchtset liidest, mis pakub programmeerijale palju v\u00f5imalusi. N\u00e4iteks on middleware rakendatud l\u00e4bi t\u00f6\u00f6tleja, kus ServeHTTP teeb esmalt midagi ja seej\u00e4rel kutsub teise t\u00f6\u00f6tleja ServeHTTP meetodi.<\/p>\n
Nagu eelpool \u00f6eldud, t\u00f6\u00f6tlejad koostavad lihtsalt vastuseid p\u00e4ringutele. Kuid millist t\u00f6\u00f6tlejat tuleks kasutada konkreetsel hetkel?<\/p>\n
P\u00e4ringute marsruutimine<\/h4>\n
\n\u00d5ige valiku tegemiseks kasutage HTTP-multiplexerit. M\u00f5nedes raamatukogudes nimetatakse seda muxeriks v\u00f5i ruuteriks, kuid k\u00f5ik need on sama asi. Multiplexer'i funktsioon on anal\u00fc\u00fcsida p\u00e4ringu teed ja valida vastav t\u00f6\u00f6tleja.<\/p>\n
Kui on vajalik keerulise marsruutimise tugi, on parem kasutada kolmandate osapoolte raamatukogusid. M\u00f5ned k\u00f5ige arenenumad on: gorilla\/mux<\/a><\/noindex> ja go-chi\/chi<\/a><\/noindex>, need raamatukogud v\u00f5imaldavad rakendada vahepealseid t\u00f6\u00f6tlemisi ilma eriliste probleemideta. Nende abil on v\u00f5imalik seadistada wildcards-marsruutimist ja lahendada mitmeid muid \u00fclesandeid. Nende eeliseks on \u00fchilduvus standardsete HTTP-t\u00f6\u00f6tlejatega. Tulemuseks on, et saate kirjutada lihtsa koodi, millel on tulevikus muudetava koodi v\u00f5imalus.<\/p>\n
T\u00f6\u00f6keeruliste raamistikudega tavaliselt n\u00f5uab ebatavalisi lahendusi, mis oluliselt keerukamaks muudab standardsete t\u00f6\u00f6tlejate kasutamise. Enamikule rakendustele piisab vaikimisi raamatukogu ja lihtsa ruuteri kombinatsioonist.<\/p>\n
P\u00e4ringute t\u00f6\u00f6tlemine<\/h4>\n
\nLisaks on meil vajalik komponent, mis \u201ekuulab\u201d sissetulevaid \u00fchendusi ja suunab k\u00f5ik p\u00e4ringud \u00f5igele t\u00f6\u00f6tlejale. Selle \u00fclesandega saab h\u00f5lpsasti hakkama http.Server.<\/p>\n
Allpool on n\u00e4idatud, et server vastutab k\u00f5igi \u00fclesannete eest, mis on seotud \u00fchenduste t\u00f6\u00f6tlemisega. See h\u00f5lmab n\u00e4iteks TLS-protokolli t\u00f6\u00f6d. http.ListenAndServe'i kutsumise rakendamiseks kasutatakse standardset HTTP-serverit.<\/p>\n
N\u00fc\u00fcd vaatame keerulisemaid n\u00e4iteid.<\/p>\n
Let\u2019s Encrypti lisamine<\/h3>\n
\nVaikimisi t\u00f6\u00f6tab meie rakendus HTTP-protokolli abil, kuid soovitatakse kasutada HTTPS-protokolli. Go-s saab seda teha probleemideta. Kui olete saanud sertifikaadi ja privaatv\u00f5tme, piisab, kui m\u00e4\u00e4rata ListenAndServeTLS koos \u00f5ige sertifikaadi ja v\u00f5tmefailiga.<\/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 meetodit autocert.NewListener koos http.Serve'iga. Meetod v\u00f5imaldab saada ja uuendada TLS-sertifikaate, samal ajal kui HTTP-server t\u00f6\u00f6tleb p\u00e4ringuid:<\/p>\n
http.Serve(autocert.NewListener(\"example.com\"), nil)<\/code><\/pre>\n
\nKui avame brauseris example.com<\/a><\/noindex>, siis saame HTTPS-reaktsiooni \u00abTere, maailm!\u00bb.<\/p>\n
Kui vajate p\u00f5hjalikumat seadistamist, siis tasub kasutada autocert.Manager'i. Seej\u00e4rel loome oma http.Server'i instantsi (kuni praeguseni oleme kasutanud vaikeseadet) ja lisame halduri TLSConfig'i serverisse:<\/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 kogu HTTPS-toe rakendamiseks automaatse sertifikaadi uuendamisega.<\/p>\n
Mitte-standardsete marsruutide lisamine<\/h3>\n
\nVaikimisi marsruuter, mis on kaasatud standardteekidesse, on hea, kuid v\u00e4ga lihtne. Enamikes rakendustes on vajalik keerulisem marsruutimine, sealhulgas pesakonnad ja wildcard-marsruudid v\u00f5i \u0161abloonide ja teeparameetrite seadistamise protseduur.<\/p>\n
Selles olukorras tasub kasutada pakette gorilla\/mux<\/a><\/noindex> ja go-chi\/chi<\/a><\/noindex>. Viimasega \u00f5pime me t\u00f6\u00f6tama \u2014 allpool on n\u00e4ide.<\/p>\n
Antud on fail api\/v1\/api.go, mis sisaldab meie API marsruute:<\/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
\nSeame marsruutidele api\/vq prefiksi peafailis.<\/p>\n
Saame seej\u00e4rel selle meie peamisse marsruuterisse lisada api\/v1\/ prefiksi all tagasi meie p\u00f5hitarvutis:<\/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
\nT\u00f6\u00f6tamine keeruliste marsruutidega Go-s v\u00f5imaldab lihtsustada suure keeruliste rakenduste haldust.<\/p>\n
T\u00f6\u00f6tamine middleware'iga<\/h3>\n
\nVahepealse t\u00f6\u00f6tlemise korral kasutatakse \u00fche HTTP-k\u00e4itja m\u00e4hkimist teise, mis v\u00f5imaldab kiiresti teha autentimist, tihendamist, logimist ja m\u00f5ned muud funktsioonid.<\/p>\n
N\u00e4iteks vaatame http.Handler'i liidest, mille abil kirjutame kasutajate autentimisega k\u00e4itja.<\/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\u00e4itame originaalk\u00e4itjat\n        next.ServeHTTP(w, r)\n    })\n}<\/code><\/pre>\n
\nOn olemas kolmanda osapoole marsruutijad, nagu chi, mis v\u00f5imaldavad vahepealse t\u00f6\u00f6tlemise funktsionaalsust laiendada.<\/p>\n
T\u00f6\u00f6tamine staatiliste failidega<\/h3>\n
\nGo standardteek sisaldab v\u00f5imalusi staatilise sisu k\u00e4sitlemiseks, sealhulgas pilte ja JavaScripti ja CSS-faile. Neile p\u00e4\u00e4seb juurde http.FileServer'i funktsiooni kaudu. See tagastab k\u00e4itja, mis edastab faile kindlast kataloogist.<\/p>\n
func NewRouter() http.Handler {\n    router := chi.NewRouter()\n    r.Get(\"\/{name}\", HelloName)\n \n\/\/ Kuidas seadistada staatiliste failide jagamist\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 kausta sisu vaid juhul, kui seal pole p\u00f5hifaili index.html. Sellisel juhul tuleks kausta kompromiteerimise v\u00e4ltimiseks kasutada paketti indeksimata<\/code><\/a><\/noindex>.<\/p>\n
Korralik sulgemine<\/h3>\n
\nGo-s on olemas ka selline funktsioon nagu HTTP-serveri korralik sulgemine. Seda saab teha Shutdown() meetodi abil. Server k\u00e4ivitub goroutines ja seej\u00e4rel kuulatakse signaali katkestamiseks. 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 on v\u00f5imas keel, millel on quasi-\u00fcksne standardteek. Selle vaikimisi v\u00f5imalused on ulatuslikud, 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