Contoh API GO REST

Bagaimana dengan cepat melaksanakan contoh API REST yang ditulis dalam GO? Jawapannya ialah menggunakan perpustakaan standard Net/HTTP, yang boleh diselesaikan dalam tiga langkah berikut: 1. Sediakan struktur projek dan memulakan modul; 2. Tentukan struktur data dan fungsi pemprosesan, termasuk mendapatkan semua data, mendapatkan data tunggal berdasarkan ID, dan membuat data baru; 3. Daftar laluan dalam fungsi utama dan mulakan pelayan. Seluruh proses tidak memerlukan perpustakaan pihak ketiga. Fungsi API REST asas boleh dilaksanakan melalui perpustakaan standard dan boleh diuji melalui penyemak imbas atau pos.

Ingin cepat belajar tentang contoh API REST yang ditulis dalam GO? Malah, ia tidak rumit. Anda boleh berjalan dengan memahami beberapa langkah teras. Berikut adalah contoh mudah berdasarkan net/http dan Perpustakaan Standard, sesuai untuk rakan -rakan yang baru bermula dengan pembangunan web Go.

Menyediakan struktur projek dan kebergantungan

Buat direktori baru, seperti go-rest-example , dan kemudian memulakan modul:

 Go Mod Init Example.com/rest-api

Tidak perlu memasang perpustakaan pihak ketiga tambahan, hanya gunakan net/http yang dilengkapi dengan GO. Jika anda memerlukan middleware, pengumpulan penghalaan dan fungsi lain pada masa akan datang, anda boleh mempertimbangkan untuk memperkenalkan rangka kerja seperti Gin atau Echo , tetapi di sini kami tetap mudah terlebih dahulu.

Tulis API REST Asas

Buat fail main.go dan tulis yang berikut:

 Pakej utama

import (
    "Pengekodan/JSON"
    "FMT"
    "Log"
    "Net/http"
    "STRCONV"
)

taipkan struktur item {
    Id int `json:" id "`
    Nama String `Json:" Nama "`
}

var item = [] item {
    {Id: 1, nama: "Apple"},
    {Id: 2, nama: "pisang"},
}

Func GetItems (w http.ResponseWriter, r *http.request) {
    W.Header (). Set ("Kandungan-Jenis", "Aplikasi/JSON")
    json.newencoder (w) .encode (item)
}

Func GetItem (w http.ResponseWriter, r *http.request) {
    idstr: = r.url.path [len ("/item/"):]
    id, err: = strconv.atoi (idstr)
    jika err! = nil {
        http.error (W, "ID tidak sah", http.statusbadrequest)
        Kembali
    }

    untuk _, item: = item julat {
        jika item.id == id {
            W.Header (). Set ("Kandungan-Jenis", "Aplikasi/JSON")
            json.newencoder (w) .encode (item)
            Kembali
        }
    }

    http.notfound (w, r)
}

Funce CreateItem (w http.ResponseWriter, r *http.request) {
    item var newitem
    jika err: = json.newDecoder (r.body) .decode (& newItem); err! = nil {
        http.error (w, "badan permintaan tidak sah", http.statusbadrequest)
        Kembali
    }

    item = tambah (item, newItem)
    W.Header (). Set ("Kandungan-Jenis", "Aplikasi/JSON")
    W.WriteHeader (http.StatusCreated)
    json.newencoder (w) .encode (NewItem)
}

func main () {
    http.handlefunc ("/item", getItems)
    http.handlefunc ("/item/", getItem)
    http.handlefunc ("/create", createItem)

    fmt.println ("Pelayan permulaan di port 8080 ...")
    log.fatal (http.listenandserve (": 8080", nil))
}

Contoh ini melaksanakan tiga antara muka:

• GET /items : Kembalikan semua data
• GET /items/{id} : Mengembalikan satu data berdasarkan ID
• POST /create : Tambahkan data baru

Uji API anda

Mulakan perkhidmatan:

 pergi berjalan main.go

Kemudian anda boleh menggunakan penyemak imbas atau pos untuk menguji:

• Lawati http://localhost:8080/items untuk melihat semua penyertaan
• Lawati http://localhost:8080/items/1 untuk melihat penyertaan tertentu
• Hantar permintaan pos ke http://localhost:8080/create , badan berada dalam format json, sebagai contoh:

 {
    "Id": 3,
    "Nama": "Cherry"
}

Anda akan melihat data tambahan yang disimpan dalam ingatan (sudah tentu, ia akan hilang jika anda memulakan semula).

Masalah yang mungkin

• Masalah Pencocokan Laluan : Pemprosesan penghalaan lalai Go tidak cukup pintar untuk membezakan laluan /items/123 dan /items , jadi perhatikan pesanan pemprosesan
• CORS Cross-Domain Masalah : Sekiranya panggilan depan melaporkan ralat, ingatlah untuk menambah middleware atau menetapkan tajuk tindak balas secara manual
• Tiada sambungan pangkalan data : Ini hanya satu contoh. Projek sebenar mengesyorkan menyambung ke SQLite, PostgreSQL dan pangkalan data lain

Pada dasarnya itu sahaja. Walaupun ia mudah, ia sudah mempunyai fungsi asas API REST. Jika anda ingin memperluaskan ciri -ciri, seperti menggunakan Gorilla Mux untuk meningkatkan penghalaan, menyertai pengesahan JWT, atau dokumentasi Swagger, anda boleh terus berkembang atas dasar ini.

Atas ialah kandungan terperinci Contoh API GO REST. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!