Membina API Graphql tanpa pelayan dalam nod dengan Express dan Netlify

Membina API boleh kelihatan menakutkan, tetapi ia tidak perlu. Tutorial ini menunjukkan cara membuat dan menggunakan API yang mudah dan mudah dibaca dalam masa satu jam menggunakan kod minimum dan alat yang tersedia. Tiada pengalaman back-end yang luas diperlukan; Pemahaman asas JavaScript dan NPM cukup.

Panduan ini menafikan konsep API biasa seperti REST dan memperkenalkan GraphQL dan Arsitektur tanpa pelayan. Kami akan menggunakan alat yang tersedia dan menerangkan tujuan mereka di sepanjang jalan. Pada akhirnya, anda akan mempunyai API yang digunakan tanpa sakit kepala pengurusan pelayan.

Konsep utama: Graphql dan tanpa pelayan

API pada asasnya melibatkan membaca dan mengemas kini data. REST API Gunakan URL untuk menentukan titik akses data, yang memerlukan pelbagai permintaan untuk pengambilan data yang kompleks. GraphQL meningkatkan kecekapan dengan membenarkan pelanggan menentukan data yang tepat yang diperlukan dalam satu permintaan. Hubungan data diwakili sebagai graf, mengoptimumkan pengambilan data.

Senibina tanpa pelayan menghapuskan keperluan untuk menguruskan pelayan. Anda hanya membayar untuk sumber yang digunakan, memudahkan penggunaan dan penyelenggaraan. Kami akan memanfaatkan fungsi Netlify untuk fungsi tanpa pelayan ini.

Alat perdagangan

1. Node.js dan Express: Node.js membolehkan pelaksanaan JavaScript sisi pelayan, sementara Express memudahkan pembangunan API dengan ciri-ciri seperti penghalaan dan middleware.

2. Fungsi Netlify: Platform tanpa pelayan yang menyediakan penggunaan percuma dan penskalaan fungsi. Netlify Dev membolehkan ujian tempatan.

Persediaan Projek

1. Buat direktori projek baru dan mulakannya dengan npm init .

2. Pasang Pakej yang diperlukan: npm i express express-graphql graphql body-parser serverless-http netlify-cli -g

Struktur fail dan konfigurasi

• netlify.toml : Mengkonfigurasi netlify untuk membina dan menggunakan. Secara asasnya, ia menentukan lokasi fungsi tanpa pelayan:

 [Membina]
Command = "NPM Run Build"
Terbitkan = "Membina"
fungsi = "Fungsi"

• /functions/api.js : Mengandungi kod API.

Pecahan Kod api.js

1. Ketergantungan Import:

 const express = memerlukan ("Express");
constParser = memerlukan ("badan-parser");
const Expressgraphql = memerlukan ("Express-Graphql");
constless = memerlukan ("Serverless-Http");
const {graphqlschema, graphqlObjectType, graphqlstring} = memerlukan ("graphql");

2. Inisialisasi pembungkus ekspres dan tanpa pelayan:

 const app = express ();
modul.exports.handler = serverless (app);

3. Konfigurasikan middleware ekspres:

 app.use (bodyParser.json ());
app.use ("/", ExpressGraphql ({Skema: Skema, Graphiql: True}));

4. Tentukan skema GraphQL:

 const skema = graphqlschema baru ({
  pertanyaan: graphqlobjectType baru ({
    Nama: "Helloworld",
    medan: () => ({
      Mesej: {
        Jenis: Graphqlstring,
        Selesaikan: () => "Hello World",
      },
    }),
  }),
});

Pembangunan dan ujian tempatan

Jalankan netlify dev di terminal anda. Akses Taman Permainan GraphIQL di http://localhost:8888/.netlify/functions/api . Uji API anda dengan menanyakan { message } .

Penggunaan

Sambungkan projek anda ke Netlify (contohnya, melalui GitHub) untuk penggunaan automatik. Netlify akan mengendalikan bangunan dan menggunakan fungsi tanpa pelayan anda.

Pilihan: Permintaan pengalihan semula

Buat fail _redirects di root projek anda untuk mengalihkan permintaan dari /api ke fungsi Netlify anda:

 <code>/api /.netlify/functions/api 200!</code>

Ini memudahkan akses API.

Kesimpulan

Tutorial ini menyediakan asas untuk membina dan menggunakan API GraphQL tanpa pelayan dengan mudah. Pendekatan ini berskala dan membolehkan pembangunan API yang lebih kompleks seperti yang diperlukan. Ingatlah untuk meneroka sumber yang berkaitan untuk menyelam yang lebih mendalam ke dalam GraphQL dan Teknologi tanpa pelayan. Kod sumber lengkap boleh didapati di GitHub (pautan yang disediakan dalam artikel asal).

Atas ialah kandungan terperinci Membina API Graphql tanpa pelayan dalam nod dengan Express dan Netlify. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!