Criação de consultas básicas (JavaScript)

Faça login no AWS Management Console e abra o Console do AppSync.

1. No painel de APIs, escolha sua API GraphQL.

2. Na barra lateral, escolha Esquema.

Insira os detalhes do esquema e da fonte de dados. Consulte as seções Criar seu esquema e Anexar uma fonte de dados para obter mais informações.

Ao lado do editor de esquemas, há uma janela chamada Resolvedores. Essa caixa contém uma lista dos tipos e campos conforme definido na janela Esquema. É possível anexar resolvedores aos campos. Você provavelmente estará anexando resolvedores às suas operações de campo. Nesta seção, veremos configurações de consultas simples. Em Tipo de consulta, escolha Anexar ao lado do campo da sua consulta.

Na página Anexar resolvedor, em Tipo de resolvedor, você pode escolher entre resolvedores de pipeline ou de unidade. Para obter mais informações sobre esses tipos de regra, consulte Resolvedores. Este guia fará uso de pipeline resolvers.

Para Runtime do resolvedor, escolha APPSYNC_JS para ativar o runtime do JavaScript.

Você pode ativar o armazenamento em cache dessa API. Recomendamos desativar esse atributo por enquanto. Selecione Criar.

Na página Editar resolvedor, há um editor de código chamado Código do resolvedor que permite implementar a lógica para o manipulador e a resposta do resolvedor (etapas anterior e posterior). Para obter mais informações, consulte JavaScript resolvers overview.

import {util} from '@aws-appsync/utils';

export function request(ctx) {
    return {};
}

export function response(ctx) {
    return ctx.prev.result;
}

Abaixo dessa seção, há uma tabela chamada Funções. As funções permitem que você implemente códigos que possam ser reutilizados em vários resolvedores. Em vez de reescrever ou copiar sempre o código, você pode armazenar o código-fonte como uma função a ser adicionada a um resolvedor sempre que precisar.

As funções compõem a maior parte da lista de operações de um pipeline. Ao usar várias funções em um resolvedor, você define a ordem das funções, e elas serão executadas nessa ordem sequencialmente. Elas são executadas depois da função de solicitação e antes do início da função de resposta.

Para adicionar uma nova função, em Funções, escolha Adicionar função e, em seguida, Criar nova função. Como alternativa, pode haver um botão Criar função para escolher.

1. Escolha uma fonte de dados. Essa será a fonte de dados em que o resolvedor vai atuar.

   nota

   Em nosso exemplo, estamos anexando um resolvedor para getPost, que recupera um objeto Post pelo id. Vamos supor que já tenhamos configurado uma tabela do DynamoDB para esse esquema. Sua chave de partição está vazia e definida como id.

2. Insira um Function name.

3. Em Código da função, você precisará implementar o comportamento da função. Isso pode ser confuso, mas cada função terá seu próprio manipulador local de solicitações e respostas. A solicitação é executada e, em seguida, a invocação da fonte de dados é feita para lidar com a solicitação e, em seguida, a resposta da fonte de dados é processada pelo manipulador. O resultado é armazenado no objeto do contexto. Depois disso, a próxima função na lista será executada ou transmitida para o manipulador de resposta da etapa posterior, se for a última.

   nota

   Em nosso exemplo, estamos anexando um resolvedor ao getPost, que obtém uma lista de objetos Post da fonte de dados. Nossa função de solicitação vai demandar os dados da nossa tabela, que transmitirá a resposta ao contexto (ctx) e, em seguida, a resposta retornará o resultado no contexto. A força do AWS AppSync está em sua interconexão com outros serviços da AWS. Como estamos usando o DynamoDB, temos um conjunto de operações para simplificar processos como esses. Também temos alguns exemplos padronizados para outros tipos de fontes de dados.

   Nosso código será semelhante a este:

   import { util } from '@aws-appsync/utils';
   
   /**
    * Performs a scan on the dynamodb data source
    */
   export function request(ctx) {
     return { operation: 'Scan' };
   }
   
   /**
    * return a list of scanned post items
    */
   export function response(ctx) {
     return ctx.result.items;
   }

   Nesta etapa, adicionamos duas funções:

   • request: o manipulador de solicitações executa a operação de recuperação na fonte de dados. O argumento contém o objeto de contexto (ctx) ou alguns dados que estão disponíveis para todos os resolvedores que executam uma operação específica. Por exemplo, ele pode conter dados de autorização, os nomes dos campos que estão sendo resolvidos etc. A instrução return executa uma operação de Scan (confira exemplos aqui). Como estamos trabalhando com o DynamoDB, podemos usar algumas das operações desse serviço. A verificação executa uma busca básica de todos os itens em nossa tabela. O resultado dessa operação é armazenado no objeto de contexto como um contêiner de result antes de ser transmitido ao manipulador de respostas. A request é executada antes da resposta no pipeline.

   • response: o manipulador de respostas que retorna o resultado da request. O argumento é o objeto de contexto atualizado e a instrução de retorno é ctx.prev.result. Neste ponto do guia, é possível que você não conheça esse valor. ctx refere-se ao objeto de contexto, e prev refere-se à operação anterior no pipeline, que era nossa request. O result contém os resultados do resolvedor à medida que ele se move pelo pipeline. Se você juntar tudo isso, ctx.prev.result está retornando o resultado da última operação realizada, que foi o manipulador da solicitação.

4. Depois de concluir, escolha Criar.

De volta à tela do resolvedor, em Funções, escolha o menu suspenso Adicionar função e inclua sua função na sua lista.

Escolha Salvar para atualizar o resolvedor.

Faça login no AWS Management Console e abra o Console do AppSync.

1. No painel de APIs, escolha sua API GraphQL.

2. Na barra lateral, escolha Esquema.

Na seção Resolvedores e no tipo de mutação, escolha Anexar ao lado do seu campo.

Na página Anexar resolvedor, em Tipo de resolvedor, escolha pipeline resolvers. Como lembrete, você pode encontrar mais informações sobre resolvedores aqui. Para Runtime do resolvedor, escolha APPSYNC_JS para ativar o runtime do JavaScript.

Você pode ativar o armazenamento em cache dessa API. Recomendamos desativar esse atributo por enquanto. Selecione Criar.

Escolha Adicionar função e, em seguida, Criar nova função. Como alternativa, pode haver um botão Criar função para escolher.

1. Selecione sua fonte de dados. Essa deve ser a fonte cujos dados você manipulará com a mutação.

2. Insira um Function name.

3. Em Código da função, você precisará implementar o comportamento da função. Isso é uma mutação, portanto, o ideal é que a solicitação realize alguma operação de mudança de estado na fonte de dados invocada. O resultado será processado pela função de resposta.

   nota

   O createPost adiciona ou “insere” um novo Post na tabela com nossos parâmetros como dados. Isso pode ser semelhante a:

   import { util } from '@aws-appsync/utils';
   
   /**
    * Sends a request to `put` an item in the DynamoDB data source
    */
   export function request(ctx) {
     return {
       operation: 'PutItem',
       key: util.dynamodb.toMapValues({id: util.autoId()}),
       attributeValues: util.dynamodb.toMapValues(ctx.args.input),
     };
   }
   
   /**
    * returns the result of the `put` operation
    */
   export function response(ctx) {
     return ctx.result;
   }

   Nesta etapa, adicionamos as funções request e response:

   • request: o manipulador da solicitação aceita o contexto como argumento. A instrução return do manipulador de solicitações executa um comando PutItem, que é uma operação integrada do DynamoDB (confira alguns exemplos neste link ou aqui). O comando PutItem adiciona um objeto Post à nossa tabela do DynamoDB considerando o valor key da partição (gerado automaticamente por util.autoid()) e attributes a partir da entrada do argumento de contexto (esses são os valores que vamos transmitir em nossa solicitação). A key é o id, e os attributes são os argumentos de campo date e title. Ambos são pré-formatados por meio do auxiliar util.dynamodb.toMapValues para trabalhar com a tabela do DynamoDB.

   • response: a resposta aceita o contexto atualizado e retorna o resultado do manipulador da solicitação.

4. Depois de concluir, escolha Criar.

De volta à tela do resolvedor, em Funções, escolha o menu suspenso Adicionar função e inclua sua função na sua lista.

Escolha Salvar para atualizar o resolvedor.