Langkah 2: Periksa model data dan detail implementasi

Tabel – Di DynamoDB, tabel adalah kumpulan item (yaitu, catatan), dan setiap item adalah kumpulan pasangan nama-nilai yang disebut atribut.

Dalam Tic-Tac-Toe contoh ini, aplikasi menyimpan semua data game dalam sebuah tabel,Games. Aplikasi ini membuat satu item dalam tabel per game dan menyimpan semua data game sebagai atribut. Sebuah tic-tac-toe permainan dapat memiliki hingga sembilan gerakan. Karena tabel DynamoDB tidak memiliki skema jika hanya kunci primer yang merupakan atribut yang diperlukan, aplikasi dapat menyimpan sejumlah atribut yang bervariasi per item game.

Tabel Games memiliki kunci primer sederhana yang dibuat dari satu atribut, GameId, jenis string. Aplikasi ini menetapkan ID unik untuk setiap game. Untuk informasi selengkapnya tentang kunci primer DynamoDB, lihat Kunci primer.

Saat pengguna memulai tic-tac-toe permainan dengan mengundang pengguna lain untuk bermain, aplikasi akan membuat item baru dalam Games tabel dengan atribut yang menyimpan metadata game, seperti berikut ini:

Selain itu, aplikasi membuat atribut bersambung StatusDate, menandai status game awal sebagai PENDING. Tangkapan layar berikut menampilkan contoh item seperti yang muncul di konsol DynamoDB:

Seiring game berlangsung, aplikasi menambahkan satu atribut ke tabel untuk setiap langkah game. Nama atribut adalah posisi papan, misalnya TopLeft atau BottomRight. Misalnya, sebuah langkah mungkin memiliki atribut TopLeft dengan nilai O, atribut TopRight dengan nilai O, dan atribut BottomRight dengan nilai X. Nilai atribut adalah O atau X, tergantung pada pengguna mana yang melangkah. Contoh, pertimbangkan papan berikut ini.

Atribut nilai bersambung – Atribut StatusDate mengilustrasikan atribut nilai bersambung. Dalam pendekatan ini, alih-alih membuat atribut terpisah untuk menyimpan status game (PENDING, IN_PROGRESS, dan FINISHED) dan tanggal (ketika langkah terakhir dilakukan), Anda menggabungkannya sebagai atribut tunggal, misalnya IN_PROGRESS_2014-04-30 10:20:32.

Aplikasi kemudian menggunakan atribut StatusDate dalam membuat indeks sekunder dengan menentukan StatusDate sebagai kunci urutan untuk indeks. Manfaat penggunaan atribut nilai bersambung StatusDate diilustrasikan lebih lanjut dalam indeks yang akan dibahas selanjutnya.

Indeks sekunder global – Anda dapat menggunakan kunci primer tabel, GameId, untuk mengkueri tabel secara efisien guna menemukan item game. Untuk mengkueri tabel pada atribut selain atribut kunci primer, DynamoDB mendukung pembuatan indeks sekunder. Dalam contoh aplikasi ini, Anda membuat dua indeks sekunder berikut:

Indeks ini disebut indeks sekunder global karena kunci partisi dalam indeks ini tidak sama dengan kunci partisi (GameId), yang digunakan dalam kunci primer tabel.

Perhatikan bahwa kedua indeks menentukan StatusDate sebagai kunci urutan. Ini akan memungkinkan hal berikut:

Halaman rumah — Halaman ini memberi pengguna login sederhana, tombol CREATE untuk membuat tic-tac-toe game baru, daftar game yang sedang berlangsung, riwayat game, dan undangan game aktif yang tertunda.

Halaman beranda tidak disegarkan secara otomatis; Anda harus menyegarkan halaman untuk menyegarkan daftar.

Halaman permainan — Halaman ini menunjukkan tic-tac-toe kisi tempat pengguna bermain.

Aplikasi memperbarui halaman game secara otomatis setiap detik. JavaScript Di browser Anda memanggil server web Python setiap detik untuk menanyakan tabel Game apakah item game dalam tabel telah berubah. Jika ada, JavaScript memicu penyegaran halaman sehingga pengguna melihat papan yang diperbarui.

Undangan – Daftar ini menampilkan hingga 10 undangan terbaru dari pengguna lain yang menunggu penerimaan oleh pengguna yang masuk. Dalam tangkapan layar sebelumnya, user1 memiliki undangan tertunda dari user5 dan user2.

Game sedang dimainkan – Daftar ini menampilkan hingga 10 game terbaru yang sedang dimainkan. Ini adalah game yang dimainkan pengguna secara aktif, yang berstatus IN_PROGRESS. Dalam tangkapan layar, user1 secara aktif memainkan tic-tac-toe game dengan user3 dan user4.

Riwayat terbaru – Daftar ini menampilkan hingga 10 game terbaru yang telah diselesaikan pengguna, yang berstatus FINISHED. Dalam game yang ditampilkan di tangkapan layar, user1 sebelumnya pernah bermain dengan user2. Untuk setiap game yang telah selesai dimainkan, daftar ini menunjukkan hasil game.

Fungsi menentukan indeks OpponentId-StatusDate-index untuk digunakan dengan nilai kunci indeks berikut dan operator perbandingan:

Anda menggunakan indeks OpponentId-StatusDate-index untuk mengambil game yang mengundang pengguna yang masuk—yaitu, pengguna yang masuk adalah lawannya.

Kueri membatasi hasil hingga 10 item.

Game yang sedang berlangsung yang di-hosting oleh pengguna

Game yang sedang berlangsung yang lawannya adalah pengguna

Fungsi mengkueri tabel Games menggunakan indeks HostId-StatusDate-index. Untuk indeks, kueri menentukan nilai kunci primer—baik nilai kunci partisi (HostId) dan kunci urutan (StatusDate), bersama dengan operator perbandingan.

hostGamesInProgress = self.cm.getGamesTable ().query(HostId__eq=user,
                                               StatusDate__beginswith=status,
                                               index="HostId-StatusDate-index",
                                               limit=10)

Perhatikan sintaks Python untuk operator perbandingan:

Fungsi mengkueri tabel Games menggunakan indeks OpponentId-StatusDate-index.

oppGamesInProgress = self.cm.getGamesTable().query(Opponent__eq=user,
                                             StatusDate__beginswith=status,
                                             index="OpponentId-StatusDate-index",
                                             limit=10)

Fungsi tersebut kemudian menggabungkan dua daftar, mengurutkan, dan membuat daftar objek Game untuk 0 hingga 10 item pertama, serta mengembalikan daftar tersebut ke fungsi pemanggilan (yaitu, indeks).

games = self.mergeQueries(hostGamesInProgress,
                        oppGamesInProgress)
return games 

Pengguna membuat game yang mengundang pengguna lain untuk ikut bermain.

Dalam hal ini, halaman menunjukkan pengguna sebagai host dan status game sebagai PENDING, menunggu lawan menerima undangan.

Pengguna menerima salah satu undangan yang tertunda di halaman beranda.

Dalam hal ini, halaman menunjukkan pengguna sebagai lawan dan status game sebagai IN_PROGRESS.

Fungsi menambahkan atribut baru khusus untuk langkah.

Fungsi memperbarui nilai atribut Turn untuk pengguna yang mendapat giliran berikutnya.

Fungsi memanggil fungsi update_item SDK untuk Python untuk membuat serangkaian pembaruan terbatas pada item yang sudah ada. Fungsi ini dipetakan ke operasi UpdateItem di DynamoDB. Untuk informasi selengkapnya, lihat UpdateItem.

Kunci primer tabel Games (yaitu, ItemId).

key = { "GameId" : { "S" : gameId } }

Atribut baru yang akan ditambahkan, khusus untuk langkah pengguna saat ini, dan nilainya (misalnya, TopLeft="X").

attributeUpdates = {
    position : {
        "Action" : "PUT",
        "Value" : { "S" : representation }
    }
}

Kondisi yang harus true agar pembaruan dapat diterapkan:

expectations = {"StatusDate" : {"AttributeValueList": [{"S" : "IN_PROGRESS_"}],
    "ComparisonOperator": "BEGINS_WITH"},
    "Turn" : {"Value" : {"S" : current_player}},
    position : {"Exists" : False}}