Configuring deployment attributes for a message-driven bean against JCA 1.5-compliant resources

You can configure the message-driven bean deployment attributes for a Java™ EE Connector Architecture (JCA) 1.5-compliant enterprise application, to override the deployment attributes defined within the application EAR file.

Before you begin

Esta tarefa assume que você tenha um arquivo EAR que contenha um aplicativo corporativo, desenvolvido como um bean acionado por mensagens, que pode ser implementado no WebSphere® Application Server.

Note: You can continue to configure message-driven beans against a listener port. É possível que você deseje fazer isso para a compatibilidade com os aplicativos de bean acionado por mensagens existentes. Porém, as portas listener são estabilizadas e você deve planejar a migração de todos os beans acionados por mensagens para usar os recursos compatíveis com o JCA 1.5 ou 1.6.

About this task

Configure os atributos de implementação de um aplicativo de bean acionado por mensagens utilizando uma ferramenta de montagem. As etapas detalhadas fornecidas nesta tarefa são para o Rational® Application Developer, mas outras ferramentas possuem etapas bem semelhantes.

Procedure

  1. Inicie sua ferramenta de montagem.
  2. Edite o arquivo EAR do aplicativo. Por exemplo, use o assistente de importação do Rational Application Developer para importar o arquivo EAR para a ferramenta do conjunto. Para iniciar o assistente para importação:
    1. Clique em Arquivo > Importar > Arquivo EAR.
    2. Clique em Avançar, em seguida, selecione o arquivo EAR.
    3. Clique em Concluir.
  3. Abre os atributos de implementação para edição. Na visualização Hierarquia do Java EE, clique com o botão direito do mouse no módulo EJB para o bean acionado por mensagens e, em seguida, clique em Abrir Com > Editor do Descritor de Implementação. Um bloco de notas do diálogo de propriedade para o bean acionado por mensagens é exibido na área de janela de propriedade.
  4. Review and, if needed, change the deployment attributes.
    1. Na área de janela de propriedade, clique na guia Bean.
    2. Em Configuração de Ativação, revise os atributos.
      Note: Para os beans acionados por mensagens do EJB 3, você deve usar uma anotação EJB 3 para definir as propriedades de configuração de ativação. Não use uma anotação EJB para alterar o que é especificado no descritor de implementação de bean. Se uma propriedade de configuração de ativação for especificada nos dois locais, o valor usado será aquele que for fornecido no descritor de implementação.
      acknowledgeMode
      Esse atributo determina como a sessão reconhece quaisquer mensagens que receber.
      Confirmação Automática
      A sessão reconhece automaticamente a entrega de cada mensagem.
      Confirmação de Recebimento Duplicada
      A sessão confirma com atraso a entrega de mensagens. Essa configuração provavelmente resulta na entrega de algumas mensagens duplicadas se o JMS falhar, portanto, ela deve ser usada apenas pelos aplicativos de consumidor que são tolerantes às mensagens duplicadas.
      destinationType
      Esse atributo determina se o bean acionado por mensagens usa um destino de fila ou de tópico.
      Fila
      O bean acionado por mensagens usa um destino de fila.
      Tópico
      O bean acionado por mensagens usa um destino de tópico.
      subscriptionDurability
      Esse atributo determina se uma assinatura de tópico JMS é durável ou não durável.
      Durável
      Um assinante registra uma assinatura durável com uma identidade exclusiva que é mantida pelo JMS. Objetos de assinante subsequentes com a mesma identidade retomam a assinatura no estado em que foi deixada pelo assinante anterior. Se não houver nenhum assinante ativo para uma assinatura durável, o JMS reterá as mensagens de assinatura até que elas sejam recebidas pela assinatura ou expirem.
      Não-durável
      As assinaturas não duráveis duram o tempo de vida do objeto do assinante. Isso significa que um cliente vê as mensagens publicadas em um tópico apenas enquanto o assinante está ativo. Se o assinante não estiver ativo, estará faltando mensagens do cliente publicadas neste tópico.

      Um assinante não durável somente pode ser utilizado no mesmo contexto de transação (por exemplo, uma transação global ou um contexto de transação não especificado) que existia quando o assinante foi criado.

      messageSelector
      Esse atributo determina o seletor de mensagens JMS que é usado para selecionar quais mensagens o bean acionado por mensagens recebe. Por exemplo:
      JMSType='car' AND color='blue' AND weight>2500

      A cadeia do seletor pode referir-se aos campos no cabeçalho de mensagens do JMS e aos campos nas propriedades da mensagem. Os seletores de mensagens não podem fazer referência a valores do corpo da mensagem.

    3. Especifique os atributos de implementação de ligações.

      Em Ligações do WebSphere, selecione a opção Adaptador JCA e especifique os atributos de implementação de ligações:

      Nome de JNDI de ActivationSpec
      Esse atributo especifica o nome do JNDI da especificação de ativação que é usado para implementar esse bean acionado por mensagem. Este nome deve corresponder ao nome de uma especificação de ativação definida para o WebSphere Application Server.
      Alias de Autorização ActivationSpec
      Esse atributo especifica o nome de um alias de autenticação usado para autenticação de conexões para o adaptador de recursos JCA. Um alias de autenticação especifica o ID de usuário e senha que são usados para autenticar a criação de uma nova conexão com o adaptador de recursos da JCA.
      Nome de JNDI de Destino
      Esse atributo especifica o nome da JNDI que o bean acionado por mensagens usa para procurar pelo destino da JMS no namespace da JNDI.
  5. Salve suas alterações no descritor de implementação:
    1. Feche o Editor do Descritor de Implementação.
    2. Quando solicitado, clique em Sim para indicar que deseja salvar as mudanças no descritor de implementação.
  6. Verifique os arquivos archive.
  7. A partir do menu pop-up para o projeto, clique em Implementar para gerar o código de implementação do EJB.
  8. Optional: Teste o módulo concluído em uma instalação do WebSphere Application Server.

    Clique com o botão direito do mouse em um módulo, clique em Executar no Servidor e, em seguida, siga as instruções no assistente exibido.

    Restriction: Executar no Servidor funciona apenas nos sistemas operacionais Windows, Linux/Intel e AIX®. Não é possível implementar remotamente em uma instalação do WebSphere Application Server em um sistema operacional UNIX como o Solaris.
    Important: Use Executar no Servidor apenas para a unidade de teste. Quando um aplicativo é publicado remotamente, a ferramenta de montagem sobrescreve o arquivo de configuração do servidor. Não utilize em servidores de produção.

What to do next

Depois de montar seu aplicativo, use uma ferramenta de gerenciamento do sistema para implementar o arquivo EAR no servidor de aplicativos que executará o aplicativo; por exemplo, use o console administrativo, conforme descrito em Implementando e Gerenciando Aplicativos.

Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: July 9, 2016 7:55
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tmb_depa3
Nome do arquivo: tmb_depa3.html