org.jboss.seam.persistence
Class PersistenceProvider

java.lang.Object
  org.jboss.seam.persistence.PersistenceProvider

Direct Known Subclasses:

HibernatePersistenceProvider

@Name(value="org.jboss.seam.persistence.persistenceProvider")
@Scope(value=STATELESS)
@BypassInterceptors
@Install(precedence=0,
         classDependencies="javax.persistence.EntityManager")
public class PersistenceProvider
extends Object

Abstraction layer for persistence providers (JPA implementations). This class provides a working base implementation that can be optimized for performance and non-standardized features by extending and overriding the methods. The methods on this class are a great todo list for the next rev of the JPA spec ;-)

Author:

Gavin King, Pete Muir

Constructor Summary

PersistenceProvider()

Method Summary

void	checkVersion(Object bean, javax.persistence.EntityManager entityManager, Object oldVersion, Object version)
void	enableFilter(Filter filter, javax.persistence.EntityManager entityManager) Enable a Filter.
Class	getBeanClass(Object bean) Returns the class of an entity bean instance
Object	getId(Object bean, javax.persistence.EntityManager entityManager) Get the value of the entity identifier attribute.
String	getName(Object bean, javax.persistence.EntityManager entityManager) Get the name of the entity
Method	getPostLoadMethod(Class beanClass)
Method	getPrePersistMethod(Class beanClass)
Method	getPreRemoveMethod(Class beanClass)
Method	getPreUpdateMethod(Class beanClass)
Object	getVersion(Object bean, javax.persistence.EntityManager entityManager) Get the value of the entity version attribute.
static PersistenceProvider	instance()
boolean	isDirty(javax.persistence.EntityManager entityManager) Does the persistence context have unflushed changes? If it does not, persistence context replication can be optimized.
Object	proxyDelegate(Object delegate) Wrap the delegate before returning it to the application
javax.persistence.EntityManager	proxyEntityManager(javax.persistence.EntityManager entityManager) Wrap the entityManager before returning it to the application
boolean	registerSynchronization(Synchronization sync, javax.persistence.EntityManager entityManager) Register a Synchronization with the current transaction.
void	setFlushModeManual(javax.persistence.EntityManager entityManager) Set the flush mode to manual-only flushing.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PersistenceProvider

public PersistenceProvider()

Method Detail

setFlushModeManual

public void setFlushModeManual(javax.persistence.EntityManager entityManager)

Set the flush mode to manual-only flushing. Called when an atomic persistence context is required.

isDirty

public boolean isDirty(javax.persistence.EntityManager entityManager)

Does the persistence context have unflushed changes? If it does not, persistence context replication can be optimized.

Returns:

true to indicate that there are unflushed changes

getId

public Object getId(Object bean,
                    javax.persistence.EntityManager entityManager)

Get the value of the entity identifier attribute.

Parameters:

bean - a managed entity instance

getName

public String getName(Object bean,
                      javax.persistence.EntityManager entityManager)
               throws IllegalArgumentException

Get the name of the entity

Parameters:

bean -

entityManager -

Throws:

IllegalArgumentException - if the passed object is not an entity

getVersion

public Object getVersion(Object bean,
                         javax.persistence.EntityManager entityManager)

Get the value of the entity version attribute.

Parameters:

bean - a managed entity instance

checkVersion

public void checkVersion(Object bean,
                         javax.persistence.EntityManager entityManager,
                         Object oldVersion,
                         Object version)

enableFilter

public void enableFilter(Filter filter,
                         javax.persistence.EntityManager entityManager)

Enable a Filter. This is here just especially for Hibernate, since we well know that other products don't have such cool features.

registerSynchronization

public boolean registerSynchronization(Synchronization sync,
                                       javax.persistence.EntityManager entityManager)

Register a Synchronization with the current transaction.

instance

public static PersistenceProvider instance()

proxyDelegate

public Object proxyDelegate(Object delegate)

Wrap the delegate before returning it to the application

proxyEntityManager

public javax.persistence.EntityManager proxyEntityManager(javax.persistence.EntityManager entityManager)

Wrap the entityManager before returning it to the application

getBeanClass

public Class getBeanClass(Object bean)

Returns the class of an entity bean instance

Parameters:

bean - The entity bean instance

Returns:

The class of the entity bean

getPostLoadMethod

public Method getPostLoadMethod(Class beanClass)

getPrePersistMethod

public Method getPrePersistMethod(Class beanClass)

getPreUpdateMethod

public Method getPreUpdateMethod(Class beanClass)

getPreRemoveMethod

public Method getPreRemoveMethod(Class beanClass)