Pembangunan API Mengubah GraphQL

Pengenalan

Aplikasi web moden menuntut pengambilan data yang cekap dan fleksibel. GraphQL, bahasa pertanyaan yang merevolusikan pembangunan API, memenuhi keperluan ini. Sejak penampilan sulungnya pada 2015 oleh Facebook, penggunaan meluas GraphQL membuktikan nilainya melangkaui trend sekejap.

Memahami Prinsip Teras GraphQL

GraphQL ialah bahasa pertanyaan API dan masa jalan. Tidak seperti API REST tradisional, di mana pelayan menentukan struktur tindak balas, GraphQL membenarkan pelanggan meminta data yang tepat dengan permintaan tunggal. Ini menyelesaikan banyak cabaran pembangunan aplikasi moden.

Bayangkan seorang pustakawan berpengetahuan yang cepat mencari mana-mana buku. Daripada mencari berbilang rak (berbilang titik akhir API), anda menyediakan permintaan terperinci dan pustakawan mengembalikan apa yang anda perlukan—tidak lebih, tidak kurang.

Sifat dipacu skema GraphQL mewujudkan kontrak pelayan pelanggan yang jelas. Setiap perkhidmatan GraphQL mentakrifkan jenis data, membolehkan pengesahan skema sebelum pelaksanaan untuk respons yang boleh diramal dan konsisten.

Asas Teknikal

GraphQL menggunakan tiga operasi utama: pertanyaan (pendapatan semula data), mutasi (pengubahsuaian data) dan langganan (kemas kini masa nyata). Sistem jenis yang mantap menyokong setiap operasi, mentakrifkan keupayaan API.

<code>type User {
  id: ID!
  name: String!
  email: String!
  posts: [Post!]!
  friends: [User!]!
}

type Post {
  id: ID!
  title: String!
  content: String!
  author: User!
  comments: [Comment!]!
  createdAt: String!
}

type Comment {
  id: ID!
  text: String!
  author: User!
  post: Post!
}</code>

Skema mentakrifkan perhubungan, membenarkan pengambilan data bersarang (cth., siaran pengguna atau rakan) dalam satu pertanyaan.

Penyelesai: Jantung GraphQL

Kuasa GraphQL terletak pada fungsi penyelesainya. Fungsi ini mendapatkan semula data untuk setiap medan skema. Penyelesai boleh mengambil data daripada pangkalan data, memanggil API lain atau melakukan pengiraan yang rumit, semuanya telus kepada pelanggan.

Contoh Penyelesai (menggunakan Prisma)

Berikut ialah cara untuk melaksanakan penyelesai untuk mengambil siaran dan rakan pengguna menggunakan Prisma:

<code>const resolvers = {
  User: {
    async posts(parent, args, context) {
      const posts = await context.prisma.post.findMany({
        where: { authorId: parent.id },
        orderBy: { createdAt: 'desc' },
      });
      return posts;
    },
    async friends(parent, args, context) {
      const friends = await context.prisma.user.findMany({
        where: {
          id: { in: parent.friendIds },
        },
      });
      return friends;
    },
  },
};</code>

Penyelesai ini cekap mengambil data hanya apabila diminta.

Evolusi Pembangunan API

Ingat hari-hari REST API semata-mata? Berbilang titik akhir mengembalikan struktur data tetap. Ini berfungsi untuk aplikasi mudah tetapi menjadi sukar digunakan apabila kerumitan meningkat. Pelanggan mudah alih dan web memerlukan data yang berbeza, menghasilkan berbilang panggilan API.

Menyelesaikan Masalah Pertanyaan N 1

Masalah pertanyaan N 1 (mengambil data berkaitan dengan berbilang pertanyaan pangkalan data) ialah cabaran API yang ketara. Keupayaan GraphQL untuk mengumpulkan dan mengoptimumkan pertanyaan menggunakan DataLoader dan alatan yang serupa ialah pengubah permainan untuk prestasi.

Contoh Pelaksanaan (DataLoader):

Mengambil data berkaitan selalunya membawa kepada masalah N 1. GraphQL menangani perkara ini dengan alatan seperti DataLoader, batching dan caching panggilan pangkalan data:

<code>type User {
  id: ID!
  name: String!
  email: String!
  posts: [Post!]!
  friends: [User!]!
}

type Post {
  id: ID!
  title: String!
  content: String!
  author: User!
  comments: [Comment!]!
  createdAt: String!
}

type Comment {
  id: ID!
  text: String!
  author: User!
  post: Post!
}</code>

Ini meminimumkan pertanyaan pangkalan data dengan mengumpulkan permintaan, meningkatkan prestasi dengan ketara.

Kisah Kejayaan Dunia Nyata

• Antara Muka Pengguna Dinamik Netflix: Netflix menggunakan GraphQL untuk UI dinamik merentas peranti, mendapatkan maklumat rancangan tepat berdasarkan konteks.
• Revolusi API GitHub: Penukaran API v4 GitHub kepada GraphQL mengurangkan saiz muatan tindak balas dan meningkatkan fleksibiliti pembangun.

Melaksanakan GraphQL dengan Node.js dan Apollo Server

Berikut ialah pelaksanaan praktikal:

1. Pasang kebergantungan: npm install @apollo/server graphql

2. Tentukan skema anda:

<code>const resolvers = {
  User: {
    async posts(parent, args, context) {
      const posts = await context.prisma.post.findMany({
        where: { authorId: parent.id },
        orderBy: { createdAt: 'desc' },
      });
      return posts;
    },
    async friends(parent, args, context) {
      const friends = await context.prisma.user.findMany({
        where: {
          id: { in: parent.friendIds },
        },
      });
      return friends;
    },
  },
};</code>

3. Tambah penyelesai:

<code>const DataLoader = require('dataloader');

const userLoader = new DataLoader(async (userIds) => {
  const users = await prisma.user.findMany({
    where: {
      id: { in: userIds },
    },
  });
  return userIds.map(id => users.find(user => user.id === id));
});

const resolvers = {
  Post: {
    async author(parent) {
      return userLoader.load(parent.authorId);
    },
  },
};</code>

4. Mulakan pelayan:

<code>const typeDefs = `#graphql
type Query {
  hello: String
}`;</code>

Pengoptimuman Prestasi Melalui Pemilihan Medan (Prisma)

GraphQL mengoptimumkan pertanyaan pangkalan data berdasarkan medan yang diminta:

<code>const resolvers = {
  Query: {
    hello: () => "Hello, GraphQL!",
  },
};</code>

Ini hanya mendapatkan semula data yang diperlukan, mengurangkan overhed.

Masa Depan GraphQL

• Persekutuan Apollo: Membenarkan pemisahan skema GraphQL merentas berbilang perkhidmatan sambil mempersembahkan API bersatu.
• Ciri Masa Nyata dengan Langganan: Mendayakan kemas kini masa nyata untuk pemberitahuan langsung dan aplikasi kerjasama. Contoh menggunakan graphql-subscriptions:

<code>const { ApolloServer } = require('@apollo/server');

const server = new ApolloServer({ typeDefs, resolvers });
server.listen().then(({ url }) => {
  console.log(`? Server ready at ${url}`);
});</code>

Bermula dengan GraphQL

Penggunaan beransur-ansur GraphQL adalah faedah utama. Mulakan dengan melaksanakannya bersama API REST sedia ada, mungkin sebagai lapisan proksi. Ini meminimumkan risiko sambil menyedari kelebihannya.

Kesimpulan

GraphQL ialah anjakan paradigma dalam pengambilan data dan komunikasi pelanggan-pelayan. Fleksibiliti dan kecekapannya menjadi semakin penting apabila aplikasi berkembang. Pertimbangkan GraphQL untuk prestasi yang lebih baik, pengalaman pembangun dan kepuasan pengguna. Mulakan dengan percubaan kecil dan kembangkan penggunaannya secara beransur-ansur. Komuniti dan ekosistem yang berkembang maju kini menjadikan masa yang sesuai untuk menyepadukan GraphQL ke dalam timbunan pembangunan anda.

Rujukan

1. Dokumentasi Rasmi GraphQL
2. Platform Apollo GraphQL
3. Kejuruteraan Netflix - Persekutuan GraphQL
4. Kajian Kes API GitHub GraphQL
5. Amalan Terbaik GraphQL

Mengenai Pengarang

Ivan Duarte ialah pembangun backend bebas yang berminat dengan pembangunan web dan AI.

Langgan Surat Berita Kami

Baca artikel daripada ByteUp terus dalam peti masuk anda. Langgan sekarang!

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