Fase 2: esame del modello di dati e dei dettagli di implementazione

Tabella: in DynamoDB, una tabella è una raccolta di elementi (ovvero record) e ogni elemento è una raccolta di coppie nome-valore denominate attributi.

In questo Tic-Tac-Toe esempio, l'applicazione memorizza tutti i dati di gioco in una tabella,. Games L'applicazione crea una item nella tabella per ogni partita e archivia tutti i dati di gioco come attributi. Una tic-tac-toe partita può avere fino a nove mosse. Poiché le tabelle DynamoDB non hanno uno schema nei casi in cui l'attributo richiesto è solo la chiave primaria, l'applicazione può archiviare un numero variabile di attributi per elemento di gioco.

La tabella Games ha una chiave primaria semplice costituita da un attributo, GameId, di tipo stringa. L'applicazione assegna un ID univoco a ogni partita. Per ulteriori informazioni sulle chiavi primarie di DynamoDB, vedi Chiave primaria.

Quando un utente inizia una tic-tac-toe partita invitando un altro utente a giocare, l'applicazione crea un nuovo elemento nella Games tabella con attributi che memorizzano i metadati del gioco, come i seguenti:

L'applicazione crea anche un attributo concatenato StatusDate, contrassegnando lo stato iniziale della partita come PENDING. Lo screenshot seguente mostra un elemento di esempio come appare nella console DynamoDB:

Man mano che la partita procede, l'applicazione aggiunge un attributo alla tabella per ogni mossa nel gioco. Il nome dell'attributo è costituito dalla posizione sulla griglia, ad esempio TopLeft o BottomRight. Una mossa, ad esempio, può avere un attributo TopLeft con il valore O, un attributo TopRight con il valore O e un attributo BottomRight con il valore X. Il valore dell'attributo è O o X, a seconda dell'utente che ha fatto la mossa. Considera, ad esempio, la griglia seguente.

Attributi dei valori concatenati: l'attributo StatusDateillustra un attributo valore concatenato. In base a questo approccio, anziché creare attributi separati per archiviare lo stato della partita (PENDING, IN_PROGRESS e FINISHED) e la data (dell'ultima mossa), i valori vengono combinati in un unico attributo, ad esempio IN_PROGRESS_2014-04-30 10:20:32.

L'applicazione usa quindi l'attributo StatusDate per la creazione di indici secondari specificando StatusDate come chiave di ordinamento per l'indice. Il vantaggio dell'uso dell'attributo con valori concatenati StatusDate è spiegato ulteriormente negli indici illustrati più avanti.

Indici secondari globali: è possibile utilizzare la chiave primaria della tabella, GameId, per interrogare in modo efficiente la tabella per trovare un oggetto di gioco. Per eseguire query sulla tabella in base ad attributi diversi da quelli della chiave primaria, DynamoDB supporta la creazione di indici secondari. In questa applicazione di esempio vengono creati i due indici secondari seguenti:

Questi indici vengono detti indici secondari globali perché la loro chiave di partizione non corrisponde alla chiave di partizione (GameId) usata nella chiave primaria della tabella.

Entrambi gli indici hanno StatusDate come chiave di ordinamento. Ciò permette quanto segue:

Pagina iniziale: questa pagina fornisce all'utente un accesso semplice, un CREATEpulsante per creare una nuova tic-tac-toe partita, un elenco delle partite in corso, la cronologia delle partite e tutti gli inviti a giocare attivi in sospeso.

La home page non si aggiorna automaticamente, ma deve essere aggiornata manualmente per aggiornare gli elenchi.

Pagina del gioco: questa pagina mostra la tic-tac-toe griglia in cui giocano gli utenti.

L'applicazione aggiorna la pagina del gioco automaticamente ogni secondo. JavaScript Nel tuo browser richiama il server web Python ogni secondo per chiedere alla tabella Giochi se gli elementi del gioco nella tabella sono cambiati. In caso affermativo, JavaScript attiva un aggiornamento della pagina in modo che l'utente veda la bacheca aggiornata.

Inviti: in questo elenco vengono visualizzati fino a 10 inviti più recenti da altri che sono in attesa di accettazione da parte dell'utente che ha eseguito l'accesso. Nello screenshot precedente l'utente user1 ha inviti in attesa da user5 e user2.

Giochi in corso: questo elenco mostra fino ai 10 giochi più recenti in corso. Si tratta delle partite a cui l'utente sta giocando, che hanno stato IN_PROGRESS. Nello screenshot, l'utente1 sta giocando attivamente con user3 e tic-tac-toe user4.

Cronologia recente: questo elenco mostra fino ai 10 giochi più recenti che l'utente ha terminato, che hanno lo stato FINISHED. Nello screenshot user1 ha giocato in precedenza con user2. Per ogni partita completata viene indicato il risultato.

Specifica l'indice OpponentId-StatusDate-index da usare con i valori delle chiavi di indice e gli operatori di confronto seguenti:

È possibile utilizzare l'indice OpponentId-StatusDate-index per recuperare i giochi a cui è invitato l'utente connesso, ovvero dove l'utente connesso è l'avversario.

La query prevede un limite di 10 item nel risultato.

Partite in corso ospitate dall'utente

Partite in corso in cui l'utente è l'avversario

La funzione esegue una query sulla tabella Games usando l'indice HostId-StatusDate-index. Per l'indice, la query specifica i valori della chiave primaria, sia la chiave di partizione (HostId) che la chiave di ordinamento (StatusDate), insieme agli operatori di confronto.

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

Ecco la sintassi Python per gli operatori di confronto:

La funzione esegue una query sulla tabella Games usando l'indice OpponentId-StatusDate-index.

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

La funzione combina quindi i due elenchi, li ordina, crea un elenco di oggetti Game per i primi da 0 a 10 item e restituisce l'elenco alla funzione chiamante, ovvero all'indice.

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

L'utente crea una partita invitando un altro utente a giocare.

In questo caso, la pagina mostra l'utente come host e lo stato della partita come PENDING, in attesa che l'avversario accetti l'invito.

L'utente accetta uno degli inviti in attesa nella home page.

In questo caso, la pagina mostra l'utente come avversario e lo stato della partita come IN_PROGRESS.

Aggiunge un nuovo attributo specifico della mossa.

Aggiorna il valore dell'attributo Turn in base all'utente che deve giocare il turno successivo.

La funzione chiama la update_item funzione di SDK for Python per apportare un insieme finito di aggiornamenti a un elemento esistente. La funzione è mappata all'operazione UpdateItem in DynamoDB. Per ulteriori informazioni, consulta UpdateItem.

La chiave primaria della tabella Games, ovvero ItemId.

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

Il nuovo attributo da aggiungere, specifico della mossa dell'utente corrente, e il relativo valore (ad esempio TopLeft="X").

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

Le condizioni che devono essere soddisfatte affinché venga eseguito l'aggiornamento:

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