Untuk membina API GraphQL di GO, Perpustakaan GQLGen disyorkan untuk meningkatkan kecekapan pembangunan. 1. Pertama, pilih perpustakaan yang sesuai, seperti GQLGen, yang menyokong penjanaan kod automatik berdasarkan skema; 2. Kemudian tentukan skema GraphQL, terangkan struktur API dan portal pertanyaan, seperti menentukan jenis pos dan kaedah pertanyaan; 3 kemudian memulakan projek dan menghasilkan kod asas untuk melaksanakan logik perniagaan dalam resolver; 4. Akhirnya, sambungkan pengendali GraphQL ke pelayan HTTP dan uji API melalui taman permainan terbina dalam. Nota termasuk spesifikasi penamaan medan, pengendalian ralat, pengoptimuman prestasi dan tetapan keselamatan, dan lain -lain untuk memastikan penyelenggaraan dan kestabilan projek.

Membina API GraphQL tidak benar-benar rumit dalam bahasa Go, terutamanya selepas mempunyai perpustakaan seperti graphql-go atau gqlgen . Sekiranya anda sudah biasa dengan sintaks asas dan proses pembangunan web GO, maka langkah ini hanya menambah satu lagi lapisan pertanyaan dan logik parsing.

Di bawah ini saya akan bermula dari beberapa perspektif praktikal untuk membantu anda menyelesaikan keseluruhan proses.

Persediaan: Pilih perpustakaan yang betul

Terdapat dua perpustakaan graphql arus perdana dalam ekosistem Go:

• GRAPHQL-Go : Komuniti kuno, matang, sesuai untuk mereka yang ingin memahami prinsip-prinsip yang mendasari.
• GQLGen : Rangka kerja moden yang dihasilkan oleh kod yang sesuai untuk projek-projek dengan perkembangan pesat dan struktur yang jelas.

Jika anda ingin mengurangkan kerja berulang skema dan resolver secara manual, GQLGen disyorkan . Ia secara automatik boleh menghasilkan definisi jenis dan resolver antara muka berdasarkan skema anda, menjimatkan banyak masa.

Langkah 1: Tentukan Skema (Sistem Jenis GraphQL)

Inti GraphQL adalah skema, iaitu fail penerangan antara muka API anda. Di GQLGen, anda perlu membuat fail schema.graphqls untuk menentukan portal jenis dan pertanyaan.

Sebagai contoh, jika anda ingin membuat sistem blog yang mudah, anda boleh menulis seperti ini:

 Taipkan pos {
  Id: Id!
  Tajuk: String!
  Kandungan: String!
}

Taipkan pertanyaan {
  Catatan: [post!]!
  Post (ID: ID!): Pos
}

Skema ini bermakna anda boleh mendapatkan semua artikel melalui /query atau pertanyaan satu artikel berdasarkan ID anda.

Petua: Definisi skema hendaklah hampir dengan logik perniagaan yang mungkin untuk mengelakkan bersarang berlebihan atau redundansi medan. Ini menjadikannya lebih mudah untuk dijaga kemudian.

Langkah 2: Mulakan projek dan menjana kod

Salah satu kelebihan utama menggunakan GQLGen ialah penjanaan kod automatik . Dengan mengandaikan bahawa anda telah memasang persekitaran Go, laksanakan arahan berikut:

 pergi github.com/99designs/gqlgen init

Ia akan menjana struktur direktori berikut:

 graf/
  model/
  Resolver.go
  skema.resolvers.go
skema.graphqls

Kemudian anda hanya perlu melaksanakan kaedah resolver yang sepadan. Sebagai contoh, lengkapkan logik Posts() dan Post() kaedah dalam schema.resolvers.go .

 Func (R *QueryResolver) Posts (CTX Context.Context) ([] *Model.Post, ERROR) {
    // Melaksanakan logik pertanyaan pangkalan data}

Langkah 3: Sambungkan ke pelayan HTTP dan ujian

Langkah terakhir adalah untuk menyambungkan pengendali GraphQL ke kerangka web anda. GQLGen menyokong net/http standard secara lalai, jadi anda boleh menulis fungsi utama secara langsung untuk memulakan perkhidmatan:

 Pakej utama

import (
    "Log"
    "Net/http"
    "anda_project/grafik"
    "github.com/99designs/gqlgen/graphql/handler"
    "github.com/99designs/gqlgen/graphql/playground"
)

func main () {
    srv: = handler.newDefaultServer (graf.newexecutableschema (graph.config {resolvers: & graph.resolver {}}))

    http.handle ("/pertanyaan", srv)
    http.handle ("/", mainground.handler ("Graphql Playground", "/Query"))

    Log.println ("Sambung ke http: // localhost: 8080/untuk taman permainan graphql")
    log.fatal (http.listenandserve (": 8080", nil))
}

Selepas berlari, lawati http://localhost:8080 dan anda boleh menggunakan taman permainan terbina dalam untuk menguji pertanyaan GraphQL anda.

Soalan dan nota yang sering ditanya

• Spesifikasi penamaan medan : Bidang GraphQL biasanya menggunakan unta, dan struktur GO juga disyorkan untuk Comelcase. Konsisten antara kedua -duanya dapat mengurangkan kesilapan pemetaan.
• Pengendalian ralat : Adalah sah untuk mengembalikan error dalam resolver, dan bahagian depan akan menerima maklumat ralat terperinci.
• Pengoptimuman Prestasi : Jika jumlah data adalah besar, ingatlah untuk menambah DataLoader untuk memuatkan batch data yang berkaitan untuk mengelakkan masalah pertanyaan n 1.
• Tetapan Keselamatan : Adalah disyorkan untuk menutup halaman permainan dalam persekitaran pengeluaran dan mengehadkan kedalaman pertanyaan maksimum atau kerumitan.

Pada dasarnya ini adalah langkah -langkah. Walaupun ia mungkin mengambil sedikit masa untuk memahami hubungan antara skema dan resolver pada mulanya, apabila contoh pertama selesai, ia akan menjadi mudah untuk berkembang kemudian.

Atas ialah kandungan terperinci Cara Membina API GraphQL di Golang. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!