Criando ou Alterando uma Referência de Recurso

Uma referência de recurso suporta o acesso do aplicativo a um recurso (como uma origem de dados, uma URL ou um provedor de e-mail) que utiliza um nome lógico, em vez do nome real no ambiente de tempo de execução. Esse recurso elimina a necessidade de alterar o código do aplicativo quando você altera as configurações de tempo de execução do recurso.

Antes de Iniciar

Este tópico o guia pela atualização de referências de recursos de um aplicativo corporativo que foi montado anteriormente. O tópico, Montando Aplicativos, detalha o procedimento de montagem.

Sobre Esta Tarefa

As referências de recurso são declaradas no descritor de implementação pelo provedor de aplicativos. Em algum ponto do processo de implementação do aplicativo, você deve ligar a referência de recurso ao nome real do recurso no ambiente do tempo de execução. Ao criar um connection factory ou origem de dados no servidor de aplicativos, o servidor de aplicativos fornece um nome JNDI que um componente poderá utilizar para acessar esse connection factory ou origem de dados. O servidor de aplicativos utiliza um nome indireto com o prefixo java:comp/env. Por exemplo:
  • Ao criar uma origem de dados, o nome JNDI padrão é definido para jdbc/data_source_name.
  • Ao criar uma connection factory, seu nome padrão será eis/j2c_connection_factory_name.
Se você substituir esses valores pelos seus próprios valores, mantenha o prefixo java:comp/env. Um nome JNDI indireto permite que a infra-estrutura de gerenciamento de conexão acesse quaisquer dados da referência de recursos associados ao aplicativo. Isso permite gerenciar melhor os recursos com base nas configurações para autenticação, nível de isolamento, escopo de compartilhamento e controle de resolução.

Este tópico descreve como atualizar as referências de recurso de um aplicativo corporativo usando uma ferramenta de montagem. Após definir a referência de recurso, é possível executar uma consulta de JNDI indireta utilizando o contexto de java:comp/env.

Procedimento

  1. Inicie uma ferramenta de montagem.
  2. Se você ainda não fez isso, configure a ferramenta de montagem para trabalhar nos módulo Java EE (Java Platform, Enterprise Edition).
  3. Importe o aplicativo corporativo (arquivo EAR) que você deseja alterar no objeto EJB.
  4. Exiba as referências de recurso para o tipo de módulo:
    • Se um bean corporativo utilizar a referência de recurso:
      1. Expanda o nome do arquivo EAR.
      2. Expanda Módulos de EJB.
      3. Expanda o módulo EJB desejado.
      4. Expanda a seção para o tipo apropriado do bean corporativo (Beans de Sessão ou Beans de Entidade).
      5. Expanda o bean corporativo.
    • Se um servlet utilizar a referência de recurso:
      1. Expanda o nome do arquivo EAR.
      2. Expanda Módulos da Web.
      3. Expanda o módulo da Web desejado.
    • Se um aplicativo cliente utilizar a referência de recurso:
      1. Expanda o nome do arquivo EAR.
      2. Expanda Application Clients.
      3. Expanda o módulo de cliente aplicativo desejado.
  5. Clique com o botão direito do mouse no módulo cujas referências de recurso você deseja alterar e clique em Abrir Com > Deployment Descriptor Editor.
  6. Para os servlets e os clientes aplicativos, clique em Add. Para os módulos EJB, selecione o bean específico e clique em Incluir.
  7. Selecione a opção da referência do recurso e clique em Avançar.
  8. Especifique as configurações para a referência de recurso e clique em Concluir.
  9. Opcional: Selecione a guia References e, sob WebSphere Extensions, selecione um nível de isolamento. Se você optar por preceder esta etapa, o nível de isolamento utiliza como padrão TRANSACTION_NONE.
  10. Opcional: Em WebSphere Bindings, especifique um nome JNDI. Se você optar pro preceder esta etapa, é possível definir (ou substituir) a ligação quando o aplicativo é implementado.
  11. Feche o deployment descriptor editor e salve as alterações.

Resultados

Os arquivos para o módulo atualizado são mostrados na visualização Project Explorer.

O que Fazer Depois

Verifique o conteúdo do aplicativo corporativo atualizado na visualização Project Explorer. Em seguida, implemente seu aplicativo corporativo.

É possível gerar código de implementação EJB e implementar um módulo EJB em um servidor de destino em uma etapa. Na visualização Project Explorer, clique com o botão direito do mouse no projeto EJB e clique em Implementar. Consulte também o tópico Implementando Módulos EJB.


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



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