Amaliy loyiha — kitoblar JSON API

~20 daq · Go · HTTP va yakuniy loyiha

Muammodan boshlaylik

Struct, JSON, xato boshqaruvi va HTTP’ni birlashtirib o‘qish API’sini quramiz. Birinchi variant ma’lumotlarni faqat xotirada saqlaydi.

Tushunib olamiz

API faqat GET bilan oldindan belgilangan katalogni qaytaradi. Saqlash modeli va HTTP kodini ajratish keyinchalik test, ma’lumotlar bazasi va CRUD qo‘shishni osonlashtiradi. O‘zgarmas slice faqat o‘qilgani uchun bu misolda mutex kerak emas; yozish qo‘shilsa bir vaqtdagi kirish uchun alohida yechim zarur.

Ishlaydigan misol

Har darsni alohida papkada main.go fayliga saqlang. Standart kutubxona misollari uchun tashqi paket kerak emas. Go 1.22 yoki yangiroq versiyadan foydalaning.

package main
import (
  "encoding/json"
  "log"
  "net/http"
  "strings"
  "time"
)
type Kitob struct {
  ID int `json:"id"`
  Nom string `json:"nom"`
  Narx int `json:"narx"`
}
func main() {
  katalog := []Kitob{{1,"Go asoslari",25000},{2,"Java asoslari",30000}}
  mux := http.NewServeMux()
  mux.HandleFunc("GET /kitoblar", func(w http.ResponseWriter, r *http.Request) {
    q := strings.ToLower(r.URL.Query().Get("q"))
    topildi := make([]Kitob, 0)
    for _, k := range katalog {
      if strings.Contains(strings.ToLower(k.Nom), q) { topildi = append(topildi, k) }
    }
    w.Header().Set("Content-Type", "application/json; charset=utf-8")
    if err := json.NewEncoder(w).Encode(topildi); err != nil { log.Print(err) }
  })
  server := &http.Server{Addr:"127.0.0.1:8080", Handler:mux,
    ReadHeaderTimeout:5*time.Second, ReadTimeout:10*time.Second,
    WriteTimeout:10*time.Second, IdleTimeout:60*time.Second}
  log.Fatal(server.ListenAndServe())
}

Oddiy misolni go run main.go bilan bajaring. go fmt main.go kodni formatlaydi; modul va test darslarida ko‘rsatilgan maxsus buyruqlarni ishlating.

Natija va tahlil

curl "http://127.0.0.1:8080/kitoblar?q=go" bitta Go kitobini JSON massivda qaytaradi. q=yoq uchun [], parametrsiz so‘rovda ikkita kitob chiqadi. Bu serverni Ctrl+C bilan tugating.

Qabul mezonlari

  • Faqat GET qabul qilinsin.
  • JSON sarlavhasi to‘g‘ri bo‘lsin.
  • Topilmagan qidiruv null emas, bo‘sh massiv qaytarsin.
  • Harf kattaligi qidiruvni o‘zgartirmasin.
  • Keyingi bosqichda database/sql, migratsiya va boshqariladigan server yopilishini o‘rganing.

[!WARNING] Hozirgi API’ni tayyor production backend deb qabul qilmang. Yozish amallari, autentifikatsiya, doimiy saqlash va graceful shutdown bu boshlang‘ich loyiha doirasidan tashqarida.

Mustaqil mashq

Handlerni alohida funksiyaga ajrating va httptest bilan uchta qidiruv holatini tekshiring.

Avval yechimni yopiq holda o‘zingiz yozing. Oddiy qiymat bilan birga chegara holatini ham tekshiring: bo‘sh ma’lumot, nol yoki mos kelmaydigan qiymat dasturingizga qanday ta’sir qilishini kuzating.

Yechim va tekshirish yo‘li

Handler factory katalogni parametr sifatida olsin. Testlarda bo‘sh query uchun 2, GO uchun 1, topilmagan so‘z uchun 0 element bo‘lishini json.Unmarshal orqali tekshiring.

Xulosa

API faqat GET bilan oldindan belgilangan katalogni qaytaradi.

Misolni ko‘chirib ishlatgandan keyin qiymatlarni almashtiring va natijani oldindan taxmin qiling. Kutilgan natija chiqmasa, kompilyator xabari yoki bajarilish xatosini birinchi satridan boshlab o‘qing.

Keyingi dars: Error wrapping — errors.Is va errors.As.

Rasmiy qo‘llanma: Go rasmiy qo‘llanmalari