Étape 2 : examen du modèle de données et des détails de la mise en œuvre

Table – Dans DynamoDB, une table est un ensemble d'éléments (registres), et chaque élément est un ensemble de paires nom-valeur appelées attributs.

Dans cet Tic-Tac-Toe exemple, l'application stocke toutes les données du jeu dans un tableau,Games. L'application crée un élément par jeu dans la table et stocke toutes les données de jeux en tant qu'attributs. Une tic-tac-toe partie peut comporter jusqu'à neuf coups. Les tables DynamoDB n'ayant pas de schéma dans les cas où seule la clé primaire est l'attribut obligatoire, l'application peut stocker différents nombres d'attributs par élément de jeu.

La table Games a une clé primaire simple composée d'un attribut, GameId, de type chaîne. L'application attribue un ID unique à chaque partie. Pour plus d'informations sur les clés primaires DynamoDB, consultez Clé primaire.

Lorsqu'un utilisateur lance un tic-tac-toe jeu en invitant un autre utilisateur à jouer, l'application crée un nouvel élément dans le Games tableau avec des attributs stockant les métadonnées du jeu, tels que les suivants :

En outre, l'application crée un attribut concaténé StatusDate, marquant l'état du jeu initial en tant que PENDING. La capture d'écran suivante présente un exemple d'élément tel qu'il s'affiche dans la console DynamoDB :

En cours de partie, l'application ajoute un attribut à la table pour chaque déplacement. Le nom d'attribut est la position sur le plateau, par exemple TopLeft ou BottomRight. Par exemple, un déplacement peut avoir un attribut TopLeft avec la valeur O, un attribut TopRight avec la valeur O et un attribut BottomRight avec la valeur X. La valeur d'attribut est O ou X, selon l'utilisateur qui a effectué le déplacement. Par exemple, considérez le plateau suivant.

Attributs de valeur concaténée – L'attribut StatusDate illustre un attribut de valeur concaténée. Dans cette approche, au lieu de créer des attributs distincts pour stocker le statut du jeu (PENDING, IN_PROGRESS et FINISHED) et la date (moment du dernier déplacement), vous les associez en un seul attribut, par exemple IN_PROGRESS_2014-04-30 10:20:32.

L'application utilise ensuite l'attribut StatusDate pour la création d'index secondaires en spécifiant StatusDate comme clé de tri pour l'index. L'avantage d'utiliser l'attribut de valeur concaténée StatusDate est illustré plus en détails dans les index abordés par la suite.

Index secondaires globaux – Vous pouvez utiliser la clé primaire de la table, GameId, pour interroger efficacement la table afin de trouver un élément de jeu. Pour interroger la table sur des attributs autres que les attributs de clé primaires, DynamoDB prend en charge la création d'index secondaires. Dans cet exemple d'application, vous créez les deux index secondaires suivants :

Ces index sont appelés index secondaires globaux, car la clé de partition dans ces index n'est pas la même que la clé de partition (GameId) utilisée dans la clé primaire de la table.

Notez que les deux index spécifient StatusDate comme clé de tri. Cela permet d'effectuer les opérations suivantes :

Page d'accueil — Cette page fournit à l'utilisateur un identifiant simple, un CREATEbouton pour créer un nouveau tic-tac-toe jeu, une liste des parties en cours, un historique des parties et toutes les invitations à des jeux en attente.

La page d'accueil n'est pas actualisée automatiquement. Vous devez actualiser la page pour actualiser les listes.

Page de jeu — Cette page montre la tic-tac-toe grille sur laquelle les utilisateurs jouent.

L'application met à jour la page de jeu automatiquement chaque seconde. JavaScript Dans votre navigateur, le serveur Web Python appelle le serveur Web Python toutes les secondes pour demander à la table Games si les éléments du jeu de la table ont changé. Si tel est le cas, JavaScript déclenche une actualisation de la page afin que l'utilisateur puisse voir le tableau mis à jour.

Invitations – Cette liste affiche jusqu'aux 10 dernières invitations d'autres personnes, qui sont en attente d'acceptation par l'utilisateur connecté. Dans la capture d'écran précédente, user1 dispose d'invitations d'user5 et d'user2 en attente.

Games in-progress – Cette liste affiche jusqu'aux 10 dernière parties en cours. Il s'agit de parties auxquelles l'utilisateur participe activement et qui ont le statut IN_PROGRESS. Sur la capture d'écran, l'utilisateur1 joue activement à un tic-tac-toe jeu avec utilisateur3 et utilisateur4.

Recent history – Cette liste affiche jusqu'aux 10 dernières parties que l'utilisateur a terminées, dont le statut est FINISHED. Dans la partie illustrée dans la capture d'écran, user1 a joué avec user2. Pour chaque partie terminée, la liste présente le résultat.

Elle spécifie l'index OpponentId-StatusDate-index à utiliser avec les valeurs de clés d'index et les opérateurs de comparaison suivants :

Vous utilisez l'index OpponentId-StatusDate-index pour récupérer les jeux auxquels l'utilisateur connecté est invité, c'est-à-dire où l'utilisateur connecté est l'adversaire.

La requête limite le résultat à 10 éléments.

Jeux en cours hébergés par l'utilisateur

Jeux en cours où l'utilisateur est l'adversaire

La fonction interroge la table Games en utilisant l'index HostId-StatusDate-index. Pour l'index, la requête spécifie les valeurs de clés primaires, clé de partition (HostId) et clé de tri (StatusDate), ainsi que les opérateurs de comparaison.

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

Notez la syntaxe Python pour les opérateurs de comparaison :

La fonction interroge la table Games en utilisant l'index OpponentId-StatusDate-index.

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

Ensuite, la fonction combine les deux listes, trie et pour les premiers 0 à 10 éléments, elle crée une liste des objets Game et renvoie la liste à la fonction d'appel (à savoir, l'index).

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

L'utilisateur crée un jeu en invitant un autre utilisateur à jouer.

Dans ce cas, la page affiche l'utilisateur comme hôte et le statut de jeu comme PENDING, en attendant que l'adversaire accepte.

L'utilisateur accepte l'une des invitations en attente sur la page d'accueil.

Dans ce cas, la page affiche l'utilisateur comme adversaire et le statut du jeu comme IN_PROGRESS.

Elle ajoute un nouvel attribut spécifique au déplacement.

Elle met à jour la valeur d'attribut Turn pour l'utilisateur qui jouera le prochain coup.

La fonction appelle la update_item fonction SDK for Python pour effectuer un ensemble fini de mises à jour d'un élément existant. La fonction mappe à l'opération UpdateItem dans DynamoDB. Pour plus d'informations, consultez UpdateItem.

La clé primaire de la table Games (à savoir, ItemId).

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

Le nouvel attribut à ajouter, spécifique au déplacement de l'utilisateur en cours et sa valeur (par exemple, TopLeft="X").

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

Conditions qui doivent avoir une valeur true pour que la mise à jour ait lieu :

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