{"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\/hr\/blog\/news\/razrabotka-veb-serverov-na-golang-ot-prostogo-k-slozhnomu","title":{"rendered":"Razvoj web poslu\u017eitelja na Golangu \u2014 od jednostavnog do slo\u017eenog","gt_translate_keys":[{"key":"rendered","format":"text"}]},"content":{"rendered":"

\"Razvoj
\n
\nPrije pet godina po\u010deo sam razvijati Gophish<\/a><\/noindex>, to mi je omogu\u0107ilo da u\u010dim Golang. Shvatio sam da je Go mo\u0107an jezik \u010dije mogu\u0107nosti dopunjuju brojni alati. Go je univerzalan: posebno, uz njegovu pomo\u0107 lako je razvijati serverske aplikacije.<\/p>\n

Ovaj \u010dlanak posve\u0107en je pisanju servera na Go-u. Po\u010dnimo s jednostavnim stvarima, kao \u0161to je \"Hello world!\", a zavr\u0161imo aplikacijom koja ima sljede\u0107e mogu\u0107nosti:<\/p>\n

\u2014 Kori\u0161tenje Let\u2019s Encrypt za HTTPS.
\n\u2014 Rad kao API rutera.
\n\u2014 Rad s middleware-om.
\n\u2014 Obrada stati\u010dnih datoteka.
\n\u2014 Ispravno zatvaranje rada.
\n<\/a><\/noindex><\/p>\n

Skillbox preporu\u010duje:<\/b> Prakti\u010dni te\u010daj \"Python programer od nule\"<\/a><\/noindex>.<\/p>\n

Podsje\u0107amo:<\/b> za sve \u010ditatelje \"Habra\" \u2014 popust od 10 000 rubalja prilikom upisa na bilo koji te\u010daj Skillbox uz promo kod \"Habr\".<\/i>\n<\/p><\/blockquote>\n

Hello, world!<\/h3>\n

\nBrzo mo\u017eete stvoriti web server na Go-u. Evo primjera kori\u0161tenja handlera koji vra\u0107a ranije spomenuti \"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
\nNakon toga, ako pokrenete aplikaciju i otvorite stranicu localhost<\/noindex>, odmah \u0107ete vidjeti tekst \"Hello, world!\" (naravno, ako sve ispravno radi).<\/p>\n
Zatim \u0107emo vi\u0161e puta koristiti handler, ali prvo hajde da shvatimo kako sve to funkcioni\u0161e.<\/p>\n
net\/http<\/h4>\n
\nU primjeru se koristi paket net\/http<\/code><\/a><\/noindex>, to je osnovno sredstvo u Go-u za razvoj i servera i HTTP klijenata. Da bismo razumjeli kod, razjasnimo zna\u010denje tri va\u017ena elementa: http.Handler, http.ServeMux i http.Server.<\/p>\n
HTTP handleri<\/h4>\n
\nKada primimo zahtjev, handler ga analizira i formira odgovor. Handleri u Go-u su implementirani na sljede\u0107i na\u010din:<\/p>\n
type Handler interface {\n        ServeHTTP(ResponseWriter, *Request)\n}<\/code><\/pre>\n
\nU prvom primjeru koristi se pomo\u0107na funkcija http.HandleFunc. Ona omotava drugu funkciju koja, zauzvrat, prima http.ResponseWriter i http.Request u ServeHTTP.<\/p>\n
Drugim rije\u010dima, handleri u Golangu predstavljeni su jedinstvenim interfejsom, \u0161to programerima pru\u017ea brojne mogu\u0107nosti. Na primjer, middleware je implementiran putem handlera, gdje ServeHTTP prvo radi ne\u0161to, a zatim poziva metodu ServeHTTP drugog handlera.<\/p>\n
Kao \u0161to je obenuto, handleri jednostavno formiraju odgovore na zahtjeve. No, koji to\u010dno handler treba koristiti u odre\u0111enom trenutku?<\/p>\n
Ruting zahtjeva<\/h4>\n
\nKako biste donijeli pravu odluku, koristite HTTP multiplexor. U nekim bibliotekama nazivaju ga muxer ili router, no sve je to isto. Funkcija multiplexora je analizirati putanju zahtjeva i odabrati odgovaraju\u0107i obra\u0111iva\u010d.<\/p>\n
Ako je potrebna podr\u0161ka za slo\u017eeno usmjeravanje, bolje je koristiti vanjske biblioteke. Neke od najnaprednijih su gorilla\/mux<\/a><\/noindex> i go-chi\/chi<\/a><\/noindex>, ove biblioteke omogu\u0107uju realizaciju me\u0111uprocesne obrade bez posebnih problema. Uz njihovu pomo\u0107 mo\u017eete postaviti wildcard usmjeravanje i izvr\u0161iti niz drugih zadataka. Njihova prednost je kompatibilnost sa standardnim HTTP obra\u0111iva\u010dima. Kao rezultat toga, mo\u017eete napisati jednostavan kod s mogu\u0107no\u0161\u0107u njegove modifikacije u budu\u0107nosti.<\/p>\n
Rad sa slo\u017eenim okvirima u obi\u010dnim situacijama zahtijevat \u0107e ne posve standardna rje\u0161enja, \u0161to zna\u010dajno ote\u017eava kori\u0161tenje zadnjih obra\u0111iva\u010da. Za izradu velike ve\u0107ine aplikacija dovoljna je kombinacija zadane biblioteke i jednostavnog usmjeriva\u010da.<\/p>\n
Obrada zahtjeva<\/h4>\n
\nOsim toga, potrebna nam je komponenta koja \u0107e \"slu\u0161ati\" dolazne veze i preusmjeravati sve zahtjeve pravom obra\u0111iva\u010du. Ovaj zadatak bez pote\u0161ko\u0107a \u0107e obaviti http.Server.<\/p>\n
Ispod je prikazano da server odgovara za sve zadatke koji se odnose na obradu veza. To uklju\u010duje rad s TLS protokolom. Za realizaciju poziva http.ListenAndServe koristi se standardni HTTP server.<\/p>\n
Sada pogledajmo slo\u017eenije primjere.<\/p>\n
Dodavanje Let\u2019s Encrypt<\/h3>\n
\nPrema zadanim postavkama, na\u0161a aplikacija radi putem HTTP protokola, me\u0111utim preporu\u010duje se koristiti HTTPS protokol. U Go-u se to mo\u017ee lako u\u010diniti. Ako ste dobili certifikat i privatni klju\u010d, dovoljnu je navesti ListenAndServeTLS s pravilnim datotekama certifikata i klju\u010da.<\/p>\n
http.ListenAndServeTLS(\":443\", \"cert.pem\", \"key.pem\", nil)<\/code><\/pre>\n
\nUvijek se mo\u017ee bolje.<\/p>\n
Let\u2019s Encrypt<\/a><\/noindex> nudi besplatne certifikate s mogu\u0107no\u0161\u0107u automatskog obnavljanja. Da biste koristili uslugu, potreban je paket autocert<\/code>.<\/p>\n
Najlak\u0161i na\u010din da ga postavite je koristiti metodu autocert.NewListener u kombinaciji s http.Serve. Metoda omogu\u0107uje dobivanje i obnavljanje TLS certifikata, dok HTTP server obra\u0111uje zahtjeve:<\/p>\n
http.Serve(autocert.NewListener(\"example.com\"), nil)<\/code><\/pre>\n
\nAko otvorimo u pregledniku example.com<\/a><\/noindex>, dobijamo HTTPS odgovor \u201eHello, world!\u201c.<\/p>\n
Ako je potrebna detaljnija konfiguracija, vrijedi koristiti autocert.Manager. Zatim kreiramo vlastiti instancu http.Server (do sada smo koristili zadanu) i dodajemo menad\u017eer u server 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
\nOvo je jednostavan na\u010din za implementaciju potpune podr\u0161ke za HTTPS s automatskim obnavljanjem certifikata.<\/p>\n
Dodavanje nestandardnih ruta<\/h3>\n
\nZadani usmjeriva\u010d uklju\u010den u standardnu biblioteku je dobar, ali je vrlo jednostavan. U ve\u0107ini aplikacija potrebna je slo\u017eenija usmjeravanje, uklju\u010duju\u0107i ugnije\u017edene i wildcard rute ili postupak postavljanja predlo\u017eaka i parametara putanje.<\/p>\n
U ovom slu\u010daju vrijedi koristiti pakete gorilla\/mux<\/a><\/noindex> i go-chi\/chi<\/a><\/noindex>. S posljednjim \u0107emo nau\u010diti raditi \u2014 u nastavku je prikazan primjer.<\/p>\n
Imamo \u2014 datoteku api\/v1\/api.go, koja sadr\u017ei rute za na\u0161 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
\nPostavljamo prefiks za rute api\/vq u glavnoj datoteci.<\/p>\n
Tada to mo\u017eemo montirati na na\u0161 glavni usmjeriva\u010d pod prefiksom api\/v1 u na\u0161oj glavnoj aplikaciji:<\/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
\nJednostavnost rada sa slo\u017eenim rutama u Go omogu\u0107ava pojednostavljenje strukture odr\u017eavanja velikih kompleksnih aplikacija.<\/p>\n
Rad s middleware-om<\/h3>\n
\nU slu\u010daju me\u0111uprosje\u010divanja koristi se omota\u010d jednog HTTP obra\u0111iva\u010da drugim, \u0161to omogu\u0107ava brzo provoditi autentifikaciju, kompresiju, logiranje i neke druge funkcije.<\/p>\n
Kao primjer razmotrit \u0107emo su\u010delje http.Handler, pomo\u0107u kojeg \u0107emo napisati obra\u0111iva\u010d s autentifikacijom korisnika servisa.<\/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        \/\/ Pretpostavljaju\u0107i da je autentifikacija pro\u0161la, pokreni izvorni obra\u0111iva\u010d\n        next.ServeHTTP(w, r)\n    })\n}<\/code><\/pre>\n
\nPostoje i vanjski usmjeriva\u010di, poput chi, koji omogu\u0107uju pro\u0161irenje funkcionalnosti me\u0111uprosje\u010divanja.<\/p>\n
Rad sa stati\u010dkim datotekama<\/h3>\n
\nStandardna biblioteka Go sadr\u017ei mogu\u0107nosti za rad sa stati\u010dkim sadr\u017eajem, uklju\u010duju\u0107i slike, kao i JavaScript i CSS datoteke. Pristup njima mo\u017ee se dobiti putem funkcije http.FileServer. Ona vra\u0107a obra\u0111iva\u010d koji isporu\u010duje datoteke iz odre\u0111enog direktorija.<\/p>\n
func NewRouter() http.Handler {\n    router := chi.NewRouter()\n    r.Get(\"\/{name}\", HelloName)\n \n\/\/ Konfiguracija dijeljenja stati\u010dkih datoteka\nstaticPath, _ := filepath.Abs(\"..\\\/..\\\/static\\\/\\\")\nfs := http.FileServer(http.Dir(staticPath))\n    router.Handle(\"\/*\", fs)\n    \n    return r<\/code><\/pre>\n
\nObavezno treba imati na umu da http.Dir prikazuje sadr\u017eaj direktorija u slu\u010daju da nema glavne datoteke index.html. U tom slu\u010daju, kako bi se sprije\u010dila kompromitacija direktorija, treba koristiti paket neindeksirano<\/code><\/a><\/noindex>.<\/p>\n
Ispravno zatvaranje rada<\/h3>\n
\nU Go-u postoji i funkcija za ispravno zatvaranje HTTP poslu\u017eitelja. To se mo\u017ee u\u010diniti pomo\u0107u metode Shutdown(). Poslu\u017eitelj se pokre\u0107e u gorutini, a zatim se kanal nadgleda za primanje signala prekida. \u010cim signal bude primljen, poslu\u017eitelj se isklju\u010duje, ali ne odmah, ve\u0107 nakon nekoliko sekundi.<\/p>\n
handler := server.NewRouter()\nsrv := &http.Server{\n    Handler: handler,\n}\n \ngo func() {\nsrv.Serve(autocert.NewListener(domains...))\n}()\n \n\/\/ \u010cekanje na prekid\nc := make(chan os.Signal, 1)\nsignal.Notify(c, os.Interrupt)\n<-c\n \n\/\/ Poku\u0161aj ispravnog zatvaranja\nctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)\ndef defer cancel()\nsrv.Shutdown(ctx)<\/code><\/pre>\n
<\/p>\n
Kao zaklju\u010dak<\/h3>\n
\nGo je mo\u0107an jezik s prakti\u010dki univerzalnom standardnom bibliotekom. Njegove zadane mogu\u0107nosti su vrlo \u0161iroke, a mogu se pobolj\u0161ati pomo\u0107u su\u010delja \u2014 to omogu\u0107uje razvoj doista pouzdanih HTTP poslu\u017eitelja.<\/p>\n
Skillbox preporu\u010duje:<\/b><\/p>\n