Gerenciador de entidade
A interface EntityManager é uma API que gerencia o ciclo de vida de uma instância de entidade.
Entidades não podem persistir por si próprias no banco de dados relacional; anotações são utilizadas somente para declarar um POJO como entidade ou para definir seu mapeamento e relações com as tabelas correspondentes no banco de dados relacional.
No JPA, a interface do EntityManager é utilizada para possibilitar que os aplicativos gerenciem e procurem por entidades no banco de dados relacional.
O EntityManager é uma API que gerencia o ciclo de vida de instâncias de entidade. Um objeto EntityManager gerencia um conjunto de entidades que são definidas por uma unidade de persistência. Cada instância do EntityManager é associada a um contexto de persistência. Um contexto de persistência define o escopo no qual instâncias de entidade específicas são criadas, persistidas e removidas por meio de APIs disponibilizadas pelo EntityManager. De algumas formas, um contexto de persistência é conceitualmente semelhante a um contexto de transação.
O gerenciador de entidade controla todos os objetos de entidade dentro de um contexto de persistência para mudanças e atualizações que são feitas, e libera essas mudanças no banco de dados. Quando um contexto de persistência é fechado, todas as instâncias de objetos de entidade gerenciadas se desconectam do contexto de persistência e de seus respectivos gerenciadores de entidade, deixando, assim, de ser gerenciados. Quando um objeto se desconecta de um contexto de persistência, ele não pode mais ser gerenciado por um gerenciador de entidade, e quaisquer mudanças feitas à instância desse objeto não serão sincronizadas com o banco de dados.
Entidades gerenciadas e não gerenciadas
Uma instância de objeto de entidade é gerenciada (conectada) ou não gerenciada (desconectada) por um gerenciador de entidade.
Quando uma entidade é conectada a um gerenciador de entidade, esse gerenciador monitora quaisquer mudanças sofridas pela entidade e sincroniza tais mudanças com o banco de dados, sempre que o gerenciador de entidade decide alinhar seu estado.
Quando uma entidade é desconectada e, portanto, deixa de estar associada ao contexto de persistência, ela se torna não gerenciada e suas mudanças de estado não serão rastreadas pelo gerenciador de entidade.
Instâncias de entidade se tornam não gerenciadas e desconectadas quando um escopo de transação ou contexto de persistência estendido chega ao fim. Uma consequência importante desse fato é que as entidades desconectadas podem ser serializadas e enviadas pela rede para um cliente remoto. O cliente pode alterar remotamente essas instâncias de objeto serializadas e enviá-las de volta ao servidor para serem mescladas e sincronizadas com o banco de dados.
Operações do gerenciador de entidade
| Operação | Descrição |
|---|---|
| persistente |
|
| find | Obter uma instância de entidade gerenciada com uma determinada identidade persistente (chave primária), retornar nulo se não for encontrada. |
| remove | Excluir do banco de dados uma entidade gerenciada com a determinada entidade persistente. |
| fundir | Estado em que uma entidade conectada é mesclada com uma cópia gerenciada da entidade conectada. retorno A entidade gerenciada que é retornada possui uma entidade Java diferente da entidade desconectada. |
| atualização | Recarregar o estado da entidade a partir do banco de dados. |
| lock | Configure o modo de bloqueio para um objeto de entidade que esteja contido no contexto de persistência. |
| flush | Forçar a sincronização com o banco de dados. |
| contém | Determinar se uma entidade é contida por um contexto de persistência atual. |
| createQuery | Criar uma instância de consulta usando Java Persistente de Query Language dinâmica. |
| createNamedQuery | Criar uma instância de uma consulta predefinida. |
| createNativeQuery | Criar uma instância de consulta SQL. |
Gerenciador de entidade gerenciado por contêiner
Uma forma de utilizar um gerenciador de entidade em um ambiente Java EE é por meio de um gerenciador de entidade gerenciado por contêiner. Neste modo, o contêiner é responsável pela abertura e pelo fechamento do gerenciador de entidade e, portanto, o ciclo de vida do contexto de persistência (de uma forma que seja transparente para o aplicativo). Um gerenciador de entidade gerenciado por contêiner também é responsável pelos limites da transação.
Um gerenciador de unidade gerenciado por contêiner é obtido em um aplicativo por meio de injeção de dependência ou por meio de consulta de JNDI, e o contêiner gerencia a interação com o factory do gerenciador de entidade de forma transparente para o aplicativo.
Um gerenciador de entidade gerenciado por contêiner requer o uso de uma transação de JTA, porque seu contexto de persistência é automaticamente propagado com a transação de JTA atual, e as referências do gerenciador de entidade que são mapeadas para a mesma unidade de persistência fornecem acesso a esse mesmo contexto de persistência dentro da transação de JTA. Essa propagação de contexto de persistência pelo contêiner do Java EE significa que o aplicativo não precisa passar referências para as instâncias do gerenciador de entidade de um componente para outro.
- Escopo de persistência de transação
- Escopo de persistência estendida
Gerenciador de entidade gerenciado por aplicativo
A utilização de um gerenciador de entidade gerenciado por aplicativo possibilita o controle do gerenciador de entidade em código de aplicativo.
- Com gerenciadores de entidade gerenciada por aplicativo, o contexto de persistência não é propagado para os componentes do aplicativo e o ciclo de vida de instâncias do gerenciador de entidade é gerenciado pelo aplicativo. Isso significa que o contexto de persistência não é propagado com a transação de JTA pelas instâncias do gerenciador de entidade em uma unidade de persistência específica.
- O gerenciador de entidade e seu respectivo contexto de persistência são criados e destruídos explicitamente pelo aplicativo.
- Nos ambientes do Java SE, nos quais o usuário deseja acessar um contexto de persistência que seja independente, e não propagado junto com a transação de JTA pelas referências do gerenciador de entidade para a determinada unidade de persistência.
- Dentro de um contêiner Java EE, quando você deseja obter controle muito detalhado sobre o ciclo de vida do gerenciador de entidade.