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

Menggunakan resolver pipa di AWS AppSync

AWS AppSync menyediakan cara sederhana untuk menghubungkan bidang GraphQL ke sumber data tunggal melalui resolver unit. Namun, menjalankan satu operasi mungkin tidak cukup. Pipeline resolvers menawarkan kemampuan untuk menjalankan operasi secara serial terhadap sumber data. Buat fungsi di Anda API dan lampirkan ke resolver pipeline. Setiap hasil eksekusi fungsi disalurkan ke yang berikutnya sampai tidak ada fungsi yang tersisa untuk dieksekusi. Dengan resolver pipeline, Anda sekarang dapat membangun alur kerja yang lebih kompleks secara langsung. AWS AppSync Dalam tutorial ini, Anda membangun aplikasi tampilan gambar sederhana, di mana pengguna dapat memposting dan melihat gambar yang diposting oleh teman-teman mereka.

Pengaturan Satu-Klik

Jika Anda ingin secara otomatis mengatur titik akhir AWS AppSync GraphQL dengan semua resolver yang dikonfigurasi dan sumber daya yang AWS diperlukan, Anda dapat menggunakan templat berikut: AWS CloudFormation

Tumpukan ini membuat sumber daya berikut di akun Anda:

Di akhir proses pembuatan AWS CloudFormation tumpukan, Anda menerima satu email untuk masing-masing dari tiga pengguna Amazon Cognito yang dibuat. Setiap email berisi kata sandi sementara yang Anda gunakan untuk masuk sebagai pengguna Amazon Cognito ke konsol. AWS AppSync Simpan kata sandi untuk sisa tutorial.

Pengaturan Manual

Jika Anda lebih suka melalui step-by-step proses secara manual melalui AWS AppSync konsol, ikuti proses pengaturan di bawah ini.

Menyiapkan Non AWS AppSync Sumber Daya Anda

APIBerkomunikasi dengan dua tabel DynamoDB: tabel gambar yang menyimpan gambar dan tabel teman yang menyimpan hubungan antar pengguna. APIIni dikonfigurasi untuk menggunakan kumpulan pengguna Amazon Cognito sebagai jenis otentikasi. AWS CloudFormation Tumpukan berikut mengatur sumber daya ini di akun.

Di akhir proses pembuatan AWS CloudFormation tumpukan, Anda menerima satu email untuk masing-masing dari tiga pengguna Amazon Cognito yang dibuat. Setiap email berisi kata sandi sementara yang Anda gunakan untuk masuk sebagai pengguna Amazon Cognito ke konsol. AWS AppSync Simpan kata sandi untuk sisa tutorial.

Membuat GraphQL Anda API

Untuk membuat GraphQL API di: AWS AppSync

AWS AppSync Konsol membuat API GraphQL baru untuk Anda menggunakan mode otentikasi kunciAPI. Anda dapat menggunakan konsol untuk mengatur sisa API GraphQL dan menjalankan kueri terhadapnya selama sisa tutorial ini.

Mengkonfigurasi GraphQL API

Anda perlu mengonfigurasi AWS AppSync API dengan kumpulan pengguna Amazon Cognito yang baru saja Anda buat.

Sekarang API diatur untuk menggunakan kumpulan pengguna Amazon Cognito sebagai jenis otorisasi.

Mengkonfigurasi Sumber Data untuk Tabel DynamoDB

Setelah tabel DynamoDB dibuat, navigasikan ke AWS AppSync GraphQL Anda di konsol dan API pilih tab Sumber Data. Sekarang, Anda akan membuat sumber data AWS AppSync untuk setiap tabel DynamoDB yang baru saja Anda buat.

Ulangi proses yang sama untuk tabel teman, nama tabel DynamoDB AppSyncTutorialharus -Friends jika Anda tidak mengubah parameter ResourceNamePrefixpada saat membuat tumpukan. CloudFormation

Membuat Skema GraphQL

Sekarang sumber data terhubung ke tabel DynamoDB Anda, mari buat skema GraphQL. Dari editor skema di AWS AppSync konsol, pastikan skema Anda cocok dengan skema berikut:

schema {
    query: Query
    mutation: Mutation
}

type Mutation {
    createPicture(input: CreatePictureInput!): Picture!
    @aws_auth(cognito_groups: ["Admins"])
    createFriendship(id: ID!, target: ID!): Boolean
    @aws_auth(cognito_groups: ["Admins"])
}

type Query {
    getPicturesByOwner(id: ID!): [Picture]
    @aws_auth(cognito_groups: ["Admins", "Viewers"])
}

type Picture {
    id: ID!
    owner: ID!
    src: String
}

input CreatePictureInput {
    owner: ID!
    src: String!
}

Pilih Simpan Skema untuk menyimpan skema Anda.

Beberapa bidang skema telah dianotasi dengan direktif @aws_auth. Karena konfigurasi tindakan API default disetel ke DENY, API menolak semua pengguna yang bukan anggota grup yang disebutkan di dalam direktif @aws_auth. Untuk informasi selengkapnya tentang cara mengamankanAPI, Anda dapat membaca halaman Keamanan. Dalam hal ini, hanya pengguna admin yang memiliki akses ke Mutasi. createPicturedan mutasi. createFriendshipbidang, sementara pengguna yang merupakan anggota grup Admin atau Pemirsa dapat mengakses Kueri. getPicturesByBidang pemilik. Semua pengguna lain tidak memiliki akses.

Mengkonfigurasi Resolver

Sekarang Anda memiliki skema GraphQL yang valid dan dua sumber data, Anda dapat melampirkan resolver ke bidang GraphQL pada skema. APIMenawarkan kemampuan berikut:

Mutasi. createPicture

Dari editor skema di AWS AppSync konsol, di sisi kanan pilih Lampirkan Resolver untuk. createPicture(input: CreatePictureInput!): Picture! Pilih sumber data PicturesDynamoDBTableDynamoDB. Di bagian template pemetaan permintaan, tambahkan template berikut:

#set($id = $util.autoId())

{
    "version" : "2018-05-29",

    "operation" : "PutItem",

    "key" : {
        "id" : $util.dynamodb.toDynamoDBJson($id),
        "owner": $util.dynamodb.toDynamoDBJson($ctx.args.input.owner)
    },

    "attributeValues" : $util.dynamodb.toMapValuesJson($ctx.args.input)
}

Di bagian template pemetaan respons, tambahkan templat berikut:

#if($ctx.error)
    $util.error($ctx.error.message, $ctx.error.type)
#end
$util.toJson($ctx.result)

Fungsionalitas membuat gambar selesai. Anda menyimpan gambar di tabel Gambar, menggunakan id gambar yang dihasilkan UUID secara acak, dan menggunakan nama pengguna Cognito sebagai pemilik gambar.

Mutasi. createFriendship

Dari editor skema di AWS AppSync konsol, di sisi kanan pilih Lampirkan Resolver untuk. createFriendship(id: ID!, target: ID!): Boolean Pilih sumber data FriendsDynamoDBTableDynamoDB. Di bagian template pemetaan permintaan, tambahkan template berikut:

#set($userToFriendFriendship = { "userId" : "$ctx.args.id", "friendId": "$ctx.args.target" })
#set($friendToUserFriendship = { "userId" : "$ctx.args.target", "friendId": "$ctx.args.id" })
#set($friendsItems = [$util.dynamodb.toMapValues($userToFriendFriendship), $util.dynamodb.toMapValues($friendToUserFriendship)])

{
    "version" : "2018-05-29",
    "operation" : "BatchPutItem",
    "tables" : {
        ## Replace 'AppSyncTutorial-' default below with the ResourceNamePrefix you provided in the CloudFormation template
        "AppSyncTutorial-Friends": $util.toJson($friendsItems)
    }
}

Penting: Dalam template BatchPutItempermintaan, nama yang tepat dari tabel DynamoDB harus ada. Nama tabel default adalah AppSyncTutorial-Friends. Jika Anda menggunakan nama tabel yang salah, Anda mendapatkan kesalahan saat AppSync mencoba mengambil peran yang disediakan.

Demi kesederhanaan dalam tutorial ini, lanjutkan seolah-olah permintaan pertemanan telah disetujui dan simpan entri hubungan langsung ke AppSyncTutorialFriendstabel.

Secara efektif, Anda menyimpan dua item untuk setiap pertemanan karena hubungan itu dua arah. Untuk detail selengkapnya tentang praktik terbaik Amazon DynamoDB untuk many-to-many mewakili hubungan, lihat Praktik Terbaik DynamoDB.

Di bagian template pemetaan respons, tambahkan templat berikut:

#if($ctx.error)
    $util.error($ctx.error.message, $ctx.error.type)
#end
true

Catatan: Pastikan template permintaan Anda berisi nama tabel yang tepat. Nama default adalah AppSyncTutorial-Friends, tetapi nama tabel Anda mungkin berbeda jika Anda mengubah CloudFormation ResourceNamePrefixparameter.

Permintaan. getPicturesByPemilik

Sekarang Anda memiliki pertemanan dan gambar, Anda perlu memberikan kemampuan bagi pengguna untuk melihat foto teman-teman mereka. Untuk memenuhi persyaratan ini, Anda harus terlebih dahulu memeriksa apakah pemohon berteman dengan pemilik, dan akhirnya meminta gambar.

Karena fungsi ini memerlukan dua operasi sumber data, Anda akan membuat dua fungsi. Fungsi pertama, isFriend, memeriksa apakah pemohon dan pemilik adalah teman. Fungsi kedua, getPicturesByOwner, mengambil gambar yang diminta diberikan ID pemilik. Mari kita lihat alur eksekusi di bawah ini untuk resolver yang diusulkan pada Query. getPicturesByBidang pemilik:

Pertama mari kita buat fungsinya.

isFriend Fungsi

Hasil: Anda telah membuat isFriendfungsi.

getPicturesByFungsi pemilik

Hasil: Anda telah membuat fungsi getPicturesByOwner. Sekarang fungsi telah dibuat, lampirkan resolver pipeline ke Query. getPicturesByBidang pemilik.

Dari editor skema di AWS AppSync konsol, di sisi kanan pilih Lampirkan Resolver untuk. Query.getPicturesByOwner(id: ID!): [Picture] Pada halaman berikut, pilih tautan Convert to pipeline resolver yang muncul di bawah daftar drop-down sumber data. Gunakan yang berikut ini untuk template sebelum pemetaan:

#set($result = { "owner": $ctx.args.id, "callerId": $ctx.identity.username })
$util.toJson($result)

Di bagian template setelah pemetaan, gunakan yang berikut ini:

#foreach($picture in $ctx.result.items)
    ## prepend "src://" to picture.src property
    #set($picture['src'] = "src://${picture['src']}")
#end
$util.toJson($ctx.result.items)

Pilih Buat Resolver. Anda telah berhasil memasang resolver pipa pertama Anda. Pada halaman yang sama, tambahkan dua fungsi yang Anda buat sebelumnya. Di bagian fungsi, pilih Tambahkan Fungsi dan kemudian pilih atau ketik nama fungsi pertama, isFriend. Tambahkan fungsi kedua dengan mengikuti proses yang sama untuk fungsi getPicturesByPemilik. Pastikan isFriendfungsi muncul pertama dalam daftar diikuti oleh fungsi getPicturesByOwner. Anda dapat menggunakan panah atas dan bawah untuk mengatur ulang urutan pelaksanaan fungsi dalam pipa.

Sekarang setelah pipeline resolver dibuat dan Anda telah melampirkan fungsinya, mari kita uji GraphQL yang baru dibuat. API

Menguji GraphQL Anda API

Pertama, Anda perlu mengisi gambar dan pertemanan dengan mengeksekusi beberapa mutasi menggunakan pengguna admin yang Anda buat. Di sisi kiri AWS AppSync konsol, pilih tab Kueri.

createPicture Mutasi

Mari kita kirim beberapa createPicturemutasi untuk mengisi tabel gambar. Jalankan query GraphQL berikut di dalam konsol:

mutation {
  createPicture(input:{
    owner: "nadia"
    src: "nadia.jpg"
  }) {
    id
    owner
    src
  }
}

Responsnya akan terlihat seperti di bawah ini:

{
  "data": {
    "createPicture": {
      "id": "c6fedbbe-57ad-4da3-860a-ffe8d039882a",
      "owner": "nadia",
      "src": "nadia.jpg"
    }
  }
}

Mari tambahkan beberapa gambar lagi:

mutation {
  createPicture(input:{
    owner: "shaggy"
    src: "shaggy.jpg"
  }) {
    id
    owner
    src
  }
}

mutation {
  createPicture(input:{
    owner: "rex"
    src: "rex.jpg"
  }) {
    id
    owner
    src
  }
}

Anda telah menambahkan tiga gambar menggunakan nadia sebagai pengguna admin.

createFriendship Mutasi

Mari tambahkan entri persahabatan. Jalankan mutasi berikut di konsol.

Catatan: Anda masih harus masuk sebagai pengguna admin (pengguna admin default adalah nadia).

mutation {
  createFriendship(id: "nadia", target: "shaggy")
}

Responsnya akan terlihat seperti:

{
  "data": {
    "createFriendship": true
  }
}

Nadia dan shaggy adalah teman. Rex tidak berteman dengan siapa pun.

getPicturesByKueri Pemilik

Untuk langkah ini, masuk sebagai pengguna nadia menggunakan Cognito User Pools, menggunakan kredensil yang diatur di awal tutorial ini. Sebagai nadia, ambil foto-foto yang dimiliki oleh shaggy.

query {
    getPicturesByOwner(id: "shaggy") {
        id
        owner
        src
    }
}

Karena nadia dan shaggy adalah teman, kueri harus mengembalikan gambar yang sesuai.

{
  "data": {
    "getPicturesByOwner": [
      {
        "id": "05a16fba-cc29-41ee-a8d5-4e791f4f1079",
        "owner": "shaggy",
        "src": "src://shaggy.jpg"
      }
    ]
  }
}

Demikian pula, jika nadia mencoba mengambil fotonya sendiri, itu juga berhasil. Penyelesai pipa telah dioptimalkan untuk menghindari menjalankan isFriend GetItem operasi dalam kasus itu. Coba kueri berikut:

query {
    getPicturesByOwner(id: "nadia") {
        id
        owner
        src
    }
}

Jika Anda mengaktifkan logging pada API (di panel Pengaturan), mengatur tingkat debug ke ALL, dan menjalankan kueri yang sama lagi, itu akan mengembalikan log untuk eksekusi bidang. Dengan melihat log, Anda dapat menentukan apakah isFriendfungsi dikembalikan lebih awal pada tahap Template Pemetaan Permintaan:

{
  "errors": [],
  "mappingTemplateType": "Request Mapping",
  "path": "[getPicturesByOwner]",
  "resolverArn": "arn:aws:appsync:us-west-2:XXXX:apis/XXXX/types/Query/fields/getPicturesByOwner",
  "functionArn": "arn:aws:appsync:us-west-2:XXXX:apis/XXXX/functions/o2f42p2jrfdl3dw7s6xub2csdfs",
  "functionName": "isFriend",
  "earlyReturnedValue": {
    "owner": "nadia",
    "callerId": "nadia"
  },
  "context": {
    "arguments": {
      "id": "nadia"
    },
    "prev": {
      "result": {
        "owner": "nadia",
        "callerId": "nadia"
      }
    },
    "stash": {},
    "outErrors": []
  },
  "fieldInError": false
}

earlyReturnedValueKunci mewakili data yang dikembalikan oleh direktif #return.

Akhirnya, meskipun rex adalah anggota Grup UserPool Cognito Pemirsa, dan karena rex tidak berteman dengan siapa pun, dia tidak akan dapat mengakses salah satu gambar yang dimiliki oleh shaggy atau nadia. Jika Anda masuk sebagai rex di konsol dan menjalankan kueri berikut:

query {
    getPicturesByOwner(id: "nadia") {
        id
        owner
        src
    }
}

Anda mendapatkan kesalahan tidak sah berikut:

{
  "data": {
    "getPicturesByOwner": null
  },
  "errors": [
    {
      "path": [
        "getPicturesByOwner"
      ],
      "data": null,
      "errorType": "Unauthorized",
      "errorInfo": null,
      "locations": [
        {
          "line": 2,
          "column": 9,
          "sourceName": null
        }
      ],
      "message": "Not Authorized to access getPicturesByOwner on type Query"
    }
  ]
}

Anda telah berhasil menerapkan otorisasi kompleks menggunakan resolver pipa.