Etapa 2: examinar o modelo de dados e os detalhes da implantação

Tabela: no DynamoDB, uma tabela é uma coleção de itens (ou seja, registros), e cada item é uma coleção de pares de nome-valor chamados atributos.

Neste exemplo de Jogo da velha, o aplicativo armazena todos os dados do jogo em uma tabela, Games. O aplicativo cria um item na tabela por jogo e armazena todos os dados de jogos como atributos. Um jogo da velha pode ter até nove movimentações. Como as tabelas do DynamoDB não possuem um esquema em casos nos quais apenas a chave primária é o atributo obrigatório, a aplicação pode armazenar um número variável de atributos por item de jogo.

A tabela Games possui uma chave primária simples composta de um atributo, GameId, do tipo string. O aplicativo atribui um ID exclusivo a cada jogo. Para obter mais informações sobre chaves primárias do DynamoDB, consulte Chave primária.

Quando um usuário inicia um jogo da velha, convidando outro usuário para jogar, o aplicativo cria um novo item na tabela Games com atributos que armazenam metadados de jogos, como os seguintes:

Além disso, o aplicativo cria um atributo StatusDate concatenado, marcando o estado inicial do jogo como PENDING. A captura de tela a seguir mostra um item de exemplo como ele aparece no console do DynamoDB:

À medida que o jogo progride, o aplicativo adiciona um atributo à tabela para cada movimento do jogo. O nome do atributo é a posição no quadro, por exemplo TopLeft ou BottomRight. Por exemplo, um movimento pode ter um atributo TopLeft com o valor O, um atributo TopRight com o valor O e um atributo BottomRight com o valor X. O valor do atributo é O ou X, dependendo de qual usuário fez o movimento. Por exemplo, considere o quadro a seguir.

Atributos de valor concatenados: o atributo StatusDate ilustra um atributo de valor concatenado. Em essa abordagem, em vez de criar atributos separados para armazenar o status do jogo (PENDING, IN_PROGRESS e FINISHED) e a data (quando o último movimento foi feito), você pode combiná-los como um único atributo, por exemplo IN_PROGRESS_2014-04-30 10:20:32.

Em seguida, o aplicativo usa o atributo StatusDate na criação de índices secundários, especificando StatusDate como uma chave de classificação para o índice. A vantagem de usar o atributo de valor concatenado StatusDate é melhor demonstrada nos índices discutidos a seguir.

Índices secundários globais: você pode usar a chave primária da tabela, GameId, para consultar a tabela com eficiência para encontrar um item do jogo. Para possibilitar a consulta de outros atributos que não sejam atributos da chave primária na tabela, o DynamoDB oferece suporte à criação de índices secundários. Neste aplicativo de exemplo, você cria os seguintes dois índices secundários:

Esses índices são chamados de índices secundários globais porque a chave de partição nesses índices não é igual à chave de partição (GameId), usada na chave primária da tabela.

Observe que ambos os índices especificam StatusDate como chave de classificação. Fazer isso permite o seguinte:

Página inicial – esta página oferece ao usuário um login simples, um botão CRIAR para criar um novo jogo da velha, uma lista de jogos em andamento, o histórico de jogos e todos os convites de jogo pendentes ativos.

A página inicial não é atualizada automaticamente; você deve atualizar a página para atualizar as listas.

Página do jogo – Esta página mostra a grade do jogo da velha na qual os usuários jogam.

O aplicativo atualiza a página de jogos automaticamente a cada segundo. O JavaScript no navegador chama o servidor web Python a cada segundo para consultar na tabela Games se os itens do jogo na tabela foram alterados. Se for o caso, o JavaScript aciona uma atualização da página para que o usuário veja o quadro atualizado.

Convites: esta lista mostra até 10 convites mais recentes de outros usuários que estão aguardando aceitação pelo usuário que está conectado. Na captura de tela anterior, o user1 tem convites de user5 e de user2 pendentes.

Jogos em andamento: esta lista mostra até 10 jogos mais recentes que estão em andamento. Esses são os jogos que o usuário está ativamente jogando, que têm o status IN_PROGRESS. Na captura de tela, o user1 está jogando ativamente um jogo da velha com user3 e user4.

Histórico recente: esta lista mostra até 10 jogos mais recentes que o usuário terminou, os quais tem o status FINISHED. No jogo apresentado na captura de tela, o user1 jogou anteriormente com o user2. Para cada jogo concluído, a lista mostra o resultado do jogo.

Ela especifica o índice OpponentId-StatusDate-index para ser usado com os seguintes valores de chave de índice e operadores de comparação:

Você pode usar o índice OpponentId-StatusDate-index para recuperar jogos para os quais o usuário conectado é convidado – ou seja, nos quais o usuário conectado é o oponente.

A consulta limita o resultado a 10 itens.

Jogos em andamento hospedados pelo usuário

Jogos em andamento nos quais o usuário é o oponente

A função consulta a tabela Games usando o índice HostId-StatusDate-index. Para o índice, a consulta especifica valores de chave primária – tanto os valores de chave de partição (HostId) quanto os de chave de classificação (StatusDate), juntamente com operadores de comparação.

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

Observe a sintaxe do Python para operadores de comparação:

A função consulta a tabela Games usando o índice OpponentId-StatusDate-index.

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

Em seguida, a função combina as duas listas, classifica, e para os primeiros itens de 0 a 10, cria uma lista dos objetos Game e retorna a lista para a função de chamada (ou seja, o índice).

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

O usuário cria um jogo convidando outro usuário para jogar.

Neste caso, a página mostra o usuário como host e o status do jogo como PENDING, aguardando o oponente aceitar.

O usuário aceita um dos convites pendentes na página inicial.

Neste caso, a página mostra o usuário como o oponente e o status do jogo como IN_PROGRESS.

Ela adiciona um novo atributo específico ao movimento.

Ela atualiza o valor do atributo Turn para o usuário cuja vez é a próxima.

A função chama a função update_item do SDK for Python para fazer um conjunto finito de atualizações em um item existente. A função é mapeada na operação UpdateItem no DynamoDB. Para obter mais informações, consulte UpdateItem.

A chave primária da tabela Games (ou seja, ItemId).

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

O novo atributo a ser adicionado, específico para o movimento do usuário atual, e seu valor (por exemplo, TopLeft="X").

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

Condições que devem ser verdadeiras para a atualização acontecer:

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