Configurando o Acesso a Dados para o Cliente Aplicativo

A configuração do acesso a dados para o Cliente Aplicativo envolve a especificação da referência de recurso e de informações associadas ao banco de dados requeridas para acesso a dados. Essa especificação é feita como parte das etapas de montagem e implementação para o Cliente Aplicativo.

Sobre Esta Tarefa

Há duas ferramentas necessárias para configurar origens de dados utilizadas por clientes aplicativos J2EE:
  • Uma ferramenta de montagem para definir a referência de recurso no descritor de implementação; e
  • O ACRCT (Application Client Resource Configuration Tool) para definir a conexão ao banco de dados no ambiente de implementação do cliente.

O acesso a dados de um cliente aplicativo utiliza as funções de conexão do driver JDBC diretamente a partir do lado do cliente. Ele não se beneficia do suporte a conjuntos adicionais no tempo de execução do WebSphere Application Server. A configuração do acesso a dados para um cliente de aplicativo não requer configuração de um provedor JDBC e origem de dados na máquina servidor do WebSphere Application Server.

Se quiser beneficiar-se das funções de conjuntos e das funções adicionais do banco de dados fornecidas pelo produto, recomenda-se que o aplicativo cliente utilize um enterprise bean em execução no servidor para executar o acesso a dados.

Definindo uma referência de recurso do aplicativo cliente usando uma ferramenta do conjunto

Procedimento

  1. Monte seu módulo de aplicativo cliente conforme descrito no tópico Montando Aplicativos Clientes Java EE.
  2. Crie uma nova referência de recurso:
    1. Em uma visualização Explorador de Projetos, clique com o botão direito do mouse no módulo de aplicativo cliente e clique em Abrir com > Editor do descritor de implementação.
    2. Na guia Referências, clique em Incluir > Referência de recurso > Avançar.
    3. Na página Referência de Recurso, digite o Nome dessa referência de recurso. O tempo de execução do cliente de aplicativo para WebSphere Application Server usa esse nome para dois fins: ligar o objeto na parte java:comp/env do espaço de nomes JNDI e localizar informações de configuração específicas do cliente. Se o código do Cliente Aplicativo executar uma consulta de java:comp/env/jdbc/myDB, o nome da referência de recurso deverá ser jdbc/myDB.
    4. Para Tipo, selecione javax.sql.DataSource para conexões JDBC.
    5. Para Autenticação, selecione Aplicativo se o aplicativo cliente pretender fornecer informações de autenticação. Se o tempo de execução do cliente de aplicativo fornecer informações de autenticação (como configuradas pela ferramenta de Configuração de Recursos do Cliente de Aplicativo), selecione Contêiner.
    6. Ignore a definição Compartilhando Escopo; ela não é utilizada em uma referência de recurso do cliente aplicativo. Todos os recursos do Cliente Aplicativo não são compartilhados.
    7. Clique em Concluir.
    8. Feche o descritor de implementação e salve as alterações.

Resultados

O campo Nome de JNDI aparece sob Ligações do WebSphere depois de você incluir a referência.

Configuração do Cliente com a ACRCT

Sobre Esta Tarefa

Há dois recursos de cliente a serem configurados na ACRCT (Ferramenta de Configuração de Recursos do Aplicativo Cliente) para ativar o acesso a dados a partir de um aplicativo cliente: um provedor de origem de dados e uma origem de dados.
Restrição: Os seguintes objetos, que podem ser ligados ao espaço de nome do servidor, não são suportados no cliente:
  • Objetos J2C (Java 2 Connector)
  • Objetos do gerenciador de conexões

O cliente de aplicativo não fornece drivers de banco de dados do cliente. Se o aplicativo cliente utilizar um banco de dados diretamente, em vez de utilizar um enterprise bean, você deve fornecer os drivers de banco de dados na máquina cliente. Essa ação pode envolver o contato com o fornecedor do banco de dados para adquirir o código e as licenças do driver do banco de dados do cliente.

Em vez de acessar o banco de dados diretamente, recomenda-se que o aplicativo cliente utilize um enterprise bean. Acessar um banco de dados por meio de um enterprise bean elimina a necessidade de ter drivers de banco de dados na máquina cliente, já que o acesso do banco de dados é controlado pelo enterprise bean executado no servidor de aplicativos. Os enterprise beans também podem se beneficiar de funções adicionais do banco de dados fornecidas pelo tempo de execução.

Procedimento

  1. Configure um novo provedor de origem de dados conforme descrito no tópico Configurando Novos Provedores de Origem de Dados. Esse provedor descreve a implementação do banco de dados JDBC para o aplicativo cliente.
  2. Digite as seguintes informações na guia Geral:
    1. Um Nome para esse provedor de origem de dados.
    2. Opcional: Uma Descrição.
    3. O caminho de classe para as classes de implementação do provedor da origem de dados ou os arquivos JAR. Isso é opcional se as classes de implementação ou os arquivos JAR já estiverem na configuração do caminho de classe do cliente.
    4. O nome da classe de implementação. Por exemplo, para o DB2, esse valor é COM.ibm.db2.jdbc.DB2DataSource. Lembre-se de que essa classe deve implementar a classe javax.sql.DataSource. A ACRCT não verifica essa classe e você recebe um erro quando o aplicativo cliente é executado se a classe não implementar javax.sql.DataSource.
    Utilize a guia Customizado para configurar as propriedades fora do padrão do fornecedor de origem de dados. Esse painel permite inserir pares propriedade-valor. Durante o tempo de execução, o Nome da Classe de Implementação é criado e as propriedades personalizadas incluídas nesse painel são definidas no novo objeto de origem de dados criado utilizando a reflexão. As propriedades configuradas nesse painel devem ter um método set apropriado na classe da origem de dados. Por exemplo, suponhamos que haja uma propriedade chamada use2Phase e seu valor deve ser 1. No painel personalizado, você digita o valor use2Phase na coluna Nome e o valor 1 na coluna Valor. O tempo de execução do cliente de aplicativo usa então a reflexão para localizar uma propriedade na classe de origem de dados chamada, geralmente, de setUse2Phase e chama essa método transmitindo o valor 1. Consulte a documentação do produto de banco de dados para obter propriedades válidas em sua implementação da origem de dados.
  3. Clicar em OK.
  4. Configure uma nova origem de dados conforme descrito no tópico Configurando Novas Origens de Dados para Aplicativos Clientes. Descreve as propriedades do cliente do banco de dados que o aplicativo cliente utiliza.
  5. Digite as seguintes informações na guia Geral:
    1. Um Nome. Esse campo é obrigatório e identifica um nome a ser utilizado para a Ferramenta de Configuração de Recursos do Aplicativo Cliente. Esse nome não é utilizado pelo programa do aplicativo cliente.
    2. Opcional: Uma Descrição.
    3. O Nome JNDI. Esse campo é obrigatório e deve corresponder ao valor digitado no campo Nome na página Incluir Referência de Recurso da ferramenta de montagem. No exemplo anterior, configure esse valor como jdbc/myDB.
    4. Opcional: O Nome do Banco de Dados.
    5. Opcional: O ID do usuário no campo Usuário.
    6. Opcional: A senha no campo Senha. Essa senha não é exibida.
    7. A senha novamente para confirmar no campo Insira Senha Novamente. Nota: Os campos Usuário e Senha são utilizados somente quando o campo Autenticação da página Incluir Referência de Recurso da ferramenta de montagem estiver definido para Contêiner.

Í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_condacli
Nome do arquivo: tatk_condacli.html