Acessando dados usando JPA dentro do pacote configurável

Sobre Esta Tarefa

Acessar dados usando JPA dentro do pacote configurável supõe que você esteja trabalhando em um pacote configurável que é tratado como um módulo Java™ EE no servidor. Por exemplo, um pacote configurável do aplicativo da web do OSGi que possui uma máscara JPA ativada e contém as entidades e a lógica para acessar, consumir e exibir dados usando JPA. Um outro exemplo é um projeto da web que contém entidades JPA e a lógica para consumir os dados usando JPA que é publicado em um aplicativo OSGi em vez de como parte de uma implementação do EAR.

É necessário configurar o pacote configurável OSGi e incluir as origens de dados no WebSphere Application Server antes que possa acessar as unidades de persistência do JPA.

Dica:

Assegure que o arquivo de persistência do JPA contenha referências a uma Java Transaction API (JTA) e origem de dados não JTA.

A JPA tem dois padrões transacionais para acessar uma origem de dados:
jta-data-source
O padrão de recursos JTA (Java Transaction API) depende de transações globais. O padrão de recursos JTA normalmente é utilizado no escopo de uma fachada de sessão EJB (Enterprise JavaBeans). Essa configuração permite que o bean de sessão controle a transação e os contextos de segurança enquanto o JPA manipula os mapeamentos de persistência. Nesse caso, o aplicativo não utiliza a interface EntityTransaction, mas depende do EntityManager listado com a transação global quando é acessada.
non-jta-data-source
O padrão de recurso não JTA é usado para lidar com um único recurso na ausência de transações globais. O padrão de recurso não JTA geralmente é utilizado dentro do escopo de um aplicativo da Web ou um aplicativo cliente. O aplicativo controla a transação com a origem de dados com a interface EntityTransaction.

Em arquivos persistence.xml para um aplicativo OSGi, os elementos jta-data-source e non-jta-data-source acessam as origens de dados por meio de uma consulta Java Naming and Directory Interface (JNDI), uma consulta do JNDI para o registro de serviço ou por meio do blueprint.

Se as origens de dados JTA e não JTA não estiverem configuradas no arquivo persistence.xml, as origens de dados JTA e não JTA padrão configuradas para o servidor serão usadas. Por padrão, os valores são nulos. Alguns recursos da entidade JPA requerem uma origem de dados não JTA a ser especificada. Por exemplo, a geração de identidade da entidade automática.

Procedimento

  1. Inclua origens de dados não JTA em persistence.xml:
    1. Abra persistence.xml no editor.
    2. Na seção Visão Geral, verifique a lista de componentes e selecione a entidade para exibir os detalhes de sua entidade.
    3. No campo origem de dados não JTA, digite o nome JNDI global de uma origem de dados não JTA. Por exemplo, osgi:service/javax.sql.DataSource/(osgi.jndi.service.name=jdbc/blogdbnojta).
  2. Inclua origens de dados JTA em persistence.xml:
    1. Abra persistence.xml no editor.
    2. Na seção Visão Geral, verifique a lista de componentes e selecione a entidade para exibir os detalhes de sua entidade.
    3. No campo Origem de Dados JTA, digite o nome JNDI global da origem de dados. Por exemplo, osgi:service/javax.sql.DataSource/(osgi.jndi.service.name=jdbc/blogdb).
  3. Inclua um provedor JDBC no Administrative Console do WebSphere Application Server:
    1. Vá para a exibição Servers.
    2. Clique com o botão direito na instância do servidor e selecione Iniciar.
    3. Clique com o botão direito do mouse na instância do servidor e selecione Administração > Executar o Console Administrativo para abrir o Administrative Console.
    4. Clique em Recursos > JDBC > Provedores JDBC.
    5. Clique em Novo na página de provedores JDBC. O assistente Criar uma origem de dados é aberto.
    6. Siga as instruções no assistente para criar o provedor JDBC.
    7. Salve suas mudanças.
  4. Inclua definições de origem de dados no Administrative Console do WebSphere Application Server:
    1. No Administrative Console, clique em Recursos > JDBC > Origens de dados para abrir a página Origens de Dados no console.
    2. Na página Origens de Dados, clique em Novo para criar uma definição de origem de dados com um nome JNDI configurado para a definição de conexão JTA especificada em seu persistence.xml. Por exemplo, jdbc/blogdb.
    3. Na página Origens de Dados, clique em Novo para criar uma outra definição de origem de dados com um nome JNDI configurado para a definição de conexão não JTA especificada em seu persistence.xml. Por exemplo, jdbc/blogdbnojta.
    4. Quando a origem de dados para a conexão não JTA for criada, clique na definição para a conexão não JTA na página Origens de Dados do console do administrador. A página Configuração é aberta.
    5. Na seção Propriedades Adicionais, clique em Propriedades de Origem de Dados do WebSphere Application Server.
    6. Selecione Origem de dados não transacional. No servidor de aplicativos, o uso do elemento <non-jta-data-source> requer uma configuração especial para uma origem de dados não transacional. Origens de Dados que estão configuradas para o servidor de aplicativos não funcionarão como <non-jta-data-source> porque todas as origens de dados que são configuradas pelo servidor de aplicativos são automaticamente inscritas com o contexto transacional atual. Para evitar essa inscrição automática, inclua uma propriedade customizada de origem de dados nonTransactionalDataSource=true.

Resultados

O persistence.xml e o WebSphere Application Server são configurados para acessar o JPA em um pacote configurável OSGi.
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: taccessjpainbundle.html