Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Penyelesai

Dari bagian sebelumnya, Anda belajar tentang komponen skema dan sumber data. Sekarang, kita perlu membahas bagaimana skema dan sumber data berinteraksi. Semuanya dimulai dengan resolver.

Resolver adalah unit kode yang menangani bagaimana data bidang itu akan diselesaikan ketika permintaan dibuat ke layanan. Resolver dilampirkan ke bidang tertentu dalam tipe Anda dalam skema Anda. Mereka paling sering digunakan untuk mengimplementasikan operasi perubahan status untuk kueri, mutasi, dan operasi bidang langganan Anda. Penyelesai akan memproses permintaan klien, lalu mengembalikan hasilnya, yang dapat berupa sekelompok tipe keluaran seperti objek atau skalar:

Runtime penyelesai

Di AWS AppSync, Anda harus terlebih dahulu menentukan runtime untuk resolver Anda. Runtime resolver menunjukkan lingkungan di mana resolver dijalankan. Ini juga menentukan bahasa resolver Anda akan ditulis. AWS AppSync saat ini mendukung APPSYNC _JS for JavaScript dan Velocity Template Language ()VTL. Lihat fitur JavaScript runtime untuk resolver dan fungsi untuk JavaScript atau referensi utilitas template pemetaan Resolver untuk. VTL

Struktur penyelesai

Dari segi kode, resolver dapat disusun dalam beberapa cara. Ada resolver unit dan pipa.

Penyelesai unit

Unit resolver terdiri dari kode yang mendefinisikan permintaan tunggal dan penangan respons yang dijalankan terhadap sumber data. Handler permintaan mengambil objek konteks sebagai argumen dan mengembalikan payload permintaan yang digunakan untuk memanggil sumber data Anda. Response handler menerima payload kembali dari sumber data dengan hasil dari permintaan yang dieksekusi. Response handler mengubah payload menjadi respons GraphQL untuk menyelesaikan bidang GraphQL.

Penyelesai pipa

Saat menerapkan resolver pipa, ada struktur umum yang mereka ikuti:

Struktur penangan penyelesai

Handler biasanya fungsi yang disebut Request danResponse:

export function request(ctx) {
    // Code goes here
}

export function response(ctx) {
    // Code goes here
}

Dalam unit resolver, hanya akan ada satu set fungsi ini. Dalam resolver pipa, akan ada satu set ini untuk langkah sebelum dan sesudah dan satu set tambahan per fungsi. Untuk memvisualisasikan bagaimana ini bisa terlihat, mari kita tinjau Query jenis sederhana:

type Query {
	helloWorld: String!
}

Ini adalah kueri sederhana dengan satu bidang helloWorld yang disebut tipeString. Mari kita asumsikan kita selalu ingin bidang ini mengembalikan string “Hello World”. Untuk menerapkan perilaku ini, kita perlu menambahkan resolver ke bidang ini. Dalam unit resolver, kita bisa menambahkan sesuatu seperti ini:

export function request(ctx) {
    return {}
}

export function response(ctx) {
    return "Hello World"
}

Itu request bisa dibiarkan kosong karena kami tidak meminta atau memproses data. Kami juga dapat mengasumsikan sumber data kamiNone, menunjukkan kode ini tidak perlu melakukan pemanggilan apa pun. Responsnya hanya mengembalikan “Hello World”. Untuk menguji resolver ini, kita perlu membuat permintaan menggunakan tipe query:

query helloWorldTest {
  helloWorld
}

Ini adalah kueri helloWorldTest yang disebut yang mengembalikan helloWorld bidang. Saat dijalankan, penyelesai helloWorld bidang juga mengeksekusi dan mengembalikan respons:

{
  "data": {
    "helloWorld": "Hello World"
  }
}

Mengembalikan konstanta seperti ini adalah hal paling sederhana yang dapat Anda lakukan. Pada kenyataannya, Anda akan mengembalikan input, daftar, dan banyak lagi. Berikut contoh yang lebih rumit:

type Book {
  id: ID!
  title: String
}

type Query {
  getBooks: [Book]
}

Di sini kami mengembalikan daftarBooks. Mari kita asumsikan kita menggunakan tabel DynamoDB untuk menyimpan data buku. Penangan kami mungkin terlihat seperti ini:

/**
 * Performs a scan on the dynamodb data source
 */
export function request(ctx) {
  return { operation: 'Scan' };
}

/**
 * return a list of scanned post items
 */
export function response(ctx) {
  return ctx.result.items;
}

Permintaan kami menggunakan operasi pemindaian bawaan untuk mencari semua entri dalam tabel, menyimpan temuan dalam konteks, lalu meneruskannya ke respons. Tanggapan mengambil item hasil dan mengembalikannya sebagai tanggapan:

{
  "data": {
    "getBooks": {
      "items": [
        {
          "id": "abcdefgh-1234-1234-1234-abcdefghijkl",
          "title": "book1"
        },
        {
          "id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
          "title": "book2"
        },

        ...

      ]
    }
  }
}

Konteks penyelesai

Dalam resolver, setiap langkah dalam rantai penangan harus menyadari status data dari langkah sebelumnya. Hasil dari satu handler dapat disimpan dan diteruskan ke yang lain sebagai argumen. GraphQL mendefinisikan empat argumen resolver dasar:

Dalam AWS AppSync, argumen context (ctx) dapat menampung semua data yang disebutkan di atas. Ini adalah objek yang dibuat per permintaan dan berisi data seperti kredensil otorisasi, data hasil, kesalahan, metadata permintaan, dll. Konteksnya adalah cara mudah bagi programmer untuk memanipulasi data yang berasal dari bagian lain dari permintaan. Ambil cuplikan ini lagi:

/**
 * Performs a scan on the dynamodb data source
 */
export function request(ctx) {
  return { operation: 'Scan' };
}

/**
 * return a list of scanned post items
 */
export function response(ctx) {
  return ctx.result.items;
}

Permintaan diberikan konteks (ctx) sebagai argumen; ini adalah status permintaan. Ini melakukan pemindaian untuk semua item dalam tabel, kemudian menyimpan hasilnya kembali dalam konteks diresult. Konteks kemudian diteruskan ke argumen respons, yang mengakses result dan mengembalikan isinya.

Permintaan dan Parsing

Saat Anda membuat kueri ke layanan GraphQL Anda, itu harus dijalankan melalui proses parsing dan validasi sebelum dieksekusi. Permintaan Anda akan diurai dan diterjemahkan ke dalam pohon sintaks abstrak. Isi pohon divalidasi dengan menjalankan beberapa algoritma validasi terhadap skema Anda. Setelah langkah validasi, simpul pohon dilintasi dan diproses. Resolver dipanggil, hasilnya disimpan dalam konteks, dan respons dikembalikan. Misalnya, ambil kueri ini:

query {
  Person {  //object type
    name  //scalar
    age   //scalar
  } 
}

Kami kembali Person dengan a name dan age ladang. Saat menjalankan kueri ini, pohon akan terlihat seperti ini:

Dari pohon, tampak bahwa permintaan ini akan mencari root untuk Query dalam skema. Di dalam kueri, Person bidang akan diselesaikan. Dari contoh sebelumnya, kita tahu bahwa ini bisa menjadi masukan dari pengguna, daftar nilai, dll Person kemungkinan besar terkait dengan tipe objek yang memegang bidang yang kita butuhkan (namedanage). Setelah dua bidang anak ini ditemukan, mereka diselesaikan dalam urutan yang diberikan (namediikuti olehage). Setelah pohon benar-benar diselesaikan, permintaan selesai dan akan dikirim kembali ke klien.