Tarefas a Serem Concluídas Após a Geração do Padrão Worklight: Manipulador de Recurso

As tarefas que você deve concluir após ter gerado o padrão.

O padrão cria um subfluxo para cada operação (Criar, Ler, Atualizar e Excluir). Conclua a implementação dos subfluxos com chamadas para seus aplicativos de backend. O padrão gera uma implementação de referência para cada operação CRUD nos subfluxos. A implementação de referência é fornecida como um exemplo. Ela permite que você implemente o aplicativo gerado no Message Broker como uma solução de trabalho e ajuda a entender como o padrão funciona.

O adaptador Worklight gerado por esse padrão passa os dados do aplicativo remoto diretamente por meio do Message Broker com nenhuma transformação aplicada. Esse design significa que você deve concordar com o formato dos dados JSON transmitidos entre o aplicativo remoto e os subfluxos no Message Broker. Os dados do aplicativo que são passados entre o aplicativo remoto e o Message Broker é um objeto JSON único. O aplicativo remoto fornece esse objeto JSON quando chama WL.Client.InvokeProcedure para chamar um aplicativo de back end.

É possível testar o aplicativo Message Broker separadamente do Worklight e o aplicativo remoto. Por exemplo, o plug-in FireFox Poster pode enviar e receber solicitações HTTP/JSON para o Message Broker. Também é possível testar o aplicativo Message Broker por meio do Worklight Studio. O Worklight Studio pode chamar o adaptador gerado por esse padrão simulando a solicitação HTTP/JSON a partir de um aplicativo remoto.

Se você ativou a segurança, o aplicativo remoto também deve fornecer as credenciais do usuário para autenticação e autorização.

Security

Se você ativou a segurança, o padrão gerará arquivos de serviço configurável adicionais. Os arquivos configuram o processamento de segurança no Message Broker. O primeiro arquivo (AuthenticationSecurityProfile.configurableservice) configura a autenticação executada pelo nó HTTPInput. O segundo arquivo (AuthorisationSecurityProfileReaders.configurableservice) configura a autorização para leitores. O terceiro arquivo (AuthorisationSecurityProfileWriters.configurableservice) será gerado apenas se você selecionou uma ou mais operações de gravação (Criar, Atualizar ou Excluir). Esse arquivo configura a autorização para gravadores.

Implemente os arquivos de serviço configurável para o Message Broker no Message Broker Toolkit ou no Message Broker Explorer. Para obter informações adicionais, consulte o tópico Serviços Configuráveis disponível na ajuda do Message Broker.

No momento da implementação, recomenda-se configurar um ID de usuário e senha LDAP usando mqsisetdbparms. O Message Broker usará essas credenciais para efetuar login no servidor LDAP para executar autenticação. Se um ID de usuário e senha não forem configurados, o Message Broker será ligado ao servidor LDAP anonimamente. Para obter informações adicionais, consulte o tópico Configurando a Autenticação com LDAP disponível na ajuda do Message Broker.

Cache Global

Se você ativou o armazenamento em cache, deverá configurar o cache global no Message Broker. O cache global padrão é simples para configurar no Message Broker Explorer. Para obter informações adicionais, consulte o tópico Gerenciando o Cache Global disponível na ajuda do Message Broker.

O cache global não possui expiração automática (despejo) de dados. Portanto, o aplicativo gerado por esse padrão armazena os dados em cache indefinidamente. Isso pode não ser suficiente se mudanças forem feitas no aplicativo de back end por meio de outros canais (por exemplo, direto no aplicativo de back end e não por meio do Message Broker).

Há várias maneiras de refinar o armazenamento em cache fornecido por esse padrão. A primeira opção é receber as mudanças no aplicativo e usar esses eventos como um acionador para remover entradas do cache. O nó DatabaseInput é um bom exemplo de como executar isso. O nó DatabaseInput pode monitorar uma ou mais tabelas de banco de dados, procurando mudanças nos dados do aplicativo. Quando uma mudança é detectada, um fluxo de mensagens pode remover a entrada necessária do cache. A próxima solicitação de leitura que chegar de um aplicativo remoto não localizará os dados no cache e consultará o aplicativo back end para assimilar as mudanças.

Uma segunda opção é limpar periodicamente o cache inteiro. Isso tem a vantagem de ser simples implementar usando o comando mqsicacheadmin. Um shell script que executa periodicamente esse comando com a opção -c clearGrid remove todas as entradas do cache. Essa abordagem assegura que o cache não cresça indefinidamente e também assegura um tempo máximo para quaisquer dados no cache. Para obter informações adicionais, consulte o tópico mqsicacheadmin disponível na ajuda do Message Broker.

Implementação do Message Broker

  1. Implemente o serviço no WebSphere Message Broker. O aplicativo deve ser incluso em um arquivo bar.
    1. Clique em Arquivo>Novo>Arquivo BAR.
    2. Insira o nome da aplicação ou selecione um da lista exibida. A lista é filtrada para mostrar apenas projetos no conjunto de trabalhos ativo.
    3. Insira um nome para o arquivo BAR sendo criado.
    4. Clique em Concluir. Um arquivo com uma extensão .bar é criado e exibido na visualização do Navegador, na pasta Broker Archives. O editor de Conteúdo para o arquivo BAR é aberto.
    5. Na guia Preparar, selecione o aplicativo gerado para incluí-lo em seu arquivo BAR.
    6. Clique em Construir e Salvar para criar seu arquivo BAR.
  2. Configure o arquivo broker archive. Não é necessária configuração adicional do aplicativo no arquivo bar antes da implementação dos fluxos de mensagens de sua instância padrão Worklight: Manipulador de Recurso, mas talvez você deseje revisar algumas opções padrão e configurar mudanças em seu ambiente. Na página Gerenciar do editor de Broker Archive:
    1. Opcional: Use a propriedade LoggingOn definida pelo usuário para selecionar se a criação de log está ativada ou desativada para o fluxo de mensagens do serviço da Web.
    2. Opcional: Use a propriedade definida pelo usuário ErrorLoggingOn para selecionar se as mensagens de erro são geradas.
    3. Opcional: É possível alterar qualquer uma das propriedades configuráveis no broker archive, por exemplo, propriedades para segurança ou criar instâncias adicionais.

      É necessário assegurar que quaisquer valores que você alterar não causem impacto no comportamento da instância padrão.

  3. Crie filas. As filas do WebSphere MQ devem ser criadas se ainda não existirem para as mensagens de erro e de log.
    1. Crie recursos do WebSphere MQ. É possível criar recursos do WebSphere MQ na linha de comandos usando programas e utilitários como runmqsc ou usando a interface gráfica do WebSphere MQ Explorer. Para obter informações adicionais sobre como criar recursos do WebSphere MQ, consulte Intercomunicação do WebSphere MQ, disponível na página da web da biblioteca do WebSphere MQ.
  4. Implementa um arquivo BAR em um grupo de execução.

Implementação do Worklight

  1. Implemente o adaptador Worklight gerado no Worklight Server.
    1. Exporte o projeto Worklight para o sistema de arquivos a partir de sua área de trabalho.
    2. Inicie o Worklight Studio e importe o projeto do Worklight.
    3. Clique no adaptador no projeto importado Executar Como > Implementar Adaptador Worklight.

Voltar para a Especificação do Padrão Worklight: Manipulador de Recurso