Package org.openxava.model.impl

Class POJOPersistenceProviderBase

java.lang.Object

org.openxava.model.impl.POJOPersistenceProviderBase

All Implemented Interfaces:

Serializable, IPersistenceProvider

Direct Known Subclasses:

JPAPersistenceProvider

public abstract class POJOPersistenceProviderBase
extends Object
implements IPersistenceProvider

Abstract class for create Persistence Providers based in POJOs.

Author:

Javier Paniza

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
POJOPersistenceProviderBase()

Method Summary

Modifier and Type	Method	Description
Object	create(MetaModel metaModel, Map values)	Create a persistent object (saved in database) from the data passed in map format.
Object	createAggregate(MetaModel metaModel, Map values, MetaModel metaModelContainer, Object containerModel, int number)	Create an aggregate (saving it in database) from the data passed in map format.
protected abstract Object	createQuery(String query)	Creates a query, it can be Hibernate query or JPA query.
protected abstract Object	find(Class pojoClass, Serializable key)	Return the object associated to the sent key.
Object	find(MetaModel metaModel, Object key)	Find a object from its key object.
Object	find(MetaModel metaModel, Map keyValues)	Find an object from its key in map format.
protected Object	find(MetaModel metaModel, Map keyValues, boolean useQueryForFind)
Object	findByAnyProperty(MetaModel metaModel, Map keyValues)	Find an object by any property (or properties).
Object	findByKeyUsingQuery(MetaModel metaModel, Map keyValues)
Object	getContainer(MetaModel metaModel, Map containerKeyValues)	Return the object that represents the container object.
Object	getKey(MetaModel metaModel, Map keyValues)	Return an object that can be used as primary key in model layer.
String	getModelName(Object modelObject)	Model name from the model object.
protected abstract Object	getUniqueResult(Object query)	Returns the unique result of the sent query.
Map	keyToMap(MetaModel metaModel, Object key)	Returns a map that contains the value of primary key sent as object.
void	moveCollectionElement(MetaModel metaModel, Map keyValues, String collectionName, int from, int to)	Move an element in a collection.
protected abstract void	persist(Object object)	Marks the object as persistent.
protected abstract void	setParameterToQuery(Object query, String name, Object value)	Sets the parameter to the indicated query.
IPropertiesContainer	toPropertiesContainer(MetaModel metaModel, Object o)	Return an IPropertiesContainer to manage using introspection the sent object.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.openxava.model.impl.IPersistenceProvider

begin, commit, createTabProvider, flush, reassociate, refreshIfManaged, remove, rollback

Constructor Details

POJOPersistenceProviderBase

public POJOPersistenceProviderBase()

Method Details

find

protected abstract Object find(Class pojoClass,
 Serializable key)

Return the object associated to the sent key.

persist

protected abstract void persist(Object object)

Marks the object as persistent.

createQuery

protected abstract Object createQuery(String query)

Creates a query, it can be Hibernate query or JPA query.

setParameterToQuery

protected abstract void setParameterToQuery(Object query,
 String name,
 Object value)

Sets the parameter to the indicated query.

The query is of the type returned by createQuery method.

getUniqueResult

protected abstract Object getUniqueResult(Object query)

Returns the unique result of the sent query.

It does not fail if there more than one match, in this case must returns the first one.

Parameters:

query - Of the type returned by createQuery method.

Returns:

Null if not result.

find

public Object find(MetaModel metaModel,
 Map keyValues)
            throws FinderException

Description copied from interface: IPersistenceProvider

Find an object from its key in map format.

Specified by:

find in interface IPersistenceProvider

Returns:

Never null.

Throws:

FinderException

find

protected Object find(MetaModel metaModel,
 Map keyValues,
 boolean useQueryForFind)
               throws FinderException

Throws:

FinderException

find

public Object find(MetaModel metaModel,
 Object key)
            throws FinderException

Description copied from interface: IPersistenceProvider

Find a object from its key object.

Specified by:

find in interface IPersistenceProvider

Returns:

Never null.

Throws:

FinderException

moveCollectionElement

public void moveCollectionElement(MetaModel metaModel,
 Map keyValues,
 String collectionName,
 int from,
 int to)
                           throws FinderException

Description copied from interface: IPersistenceProvider

Move an element in a collection.

The collection must be sortable, in JPA it means to be a List with @OrderColumn.

Specified by:

moveCollectionElement in interface IPersistenceProvider

Parameters:

metaModel - of the entity that contains the collection. Not null.

keyValues - Key value of the container of the collection. Not null.

collectionName - Collection name of the container collection of element to move. Not null.

from - Original position of the element in the collection. Zero based.

to - Position in the collection where the element will be moved. Zero based.

Throws:

XavaException

ObjectNotFoundException - If object with this key does not exist

FinderException - Logic problem on find.

toPropertiesContainer

public IPropertiesContainer toPropertiesContainer(MetaModel metaModel,
 Object o)

Description copied from interface: IPersistenceProvider

Return an IPropertiesContainer to manage using introspection the sent object.

Specified by:

toPropertiesContainer in interface IPersistenceProvider

create

public Object create(MetaModel metaModel,
 Map values)
              throws CreateException,
ValidationException

Description copied from interface: IPersistenceProvider

Create a persistent object (saved in database) from the data passed in map format.

Specified by:

create in interface IPersistenceProvider

Throws:

XavaException

CreateException

ValidationException

getKey

public Object getKey(MetaModel metaModel,
 Map keyValues)

Description copied from interface: IPersistenceProvider

Return an object that can be used as primary key in model layer.

For example, in EJB2 will be the Key class, in Hibernate can be the POJO class, and JPA ...

Specified by:

getKey in interface IPersistenceProvider

Throws:

XavaException

getContainer

public Object getContainer(MetaModel metaModel,
 Map containerKeyValues)

Description copied from interface: IPersistenceProvider

Return the object that represents the container object.

The container object apply only to aggregates, and it's the object that containt to the aggregate. It can be a POJO or key class, depends on the implementation.

Specified by:

getContainer in interface IPersistenceProvider

Throws:

XavaException

keyToMap

public Map keyToMap(MetaModel metaModel,
 Object key)

Description copied from interface: IPersistenceProvider

Returns a map that contains the value of primary key sent as object.

The map must contain at least the primary key value, but it can contains more, the rest is ignored.

Specified by:

keyToMap in interface IPersistenceProvider

Throws:

XavaException

createAggregate

public Object createAggregate(MetaModel metaModel,
 Map values,
 MetaModel metaModelContainer,
 Object containerModel,
 int number)
                       throws CreateException,
ValidationException

Description copied from interface: IPersistenceProvider

Create an aggregate (saving it in database) from the data passed in map format.

Specified by:

createAggregate in interface IPersistenceProvider

Parameters:

metaModel - of the aggregate to create.

values - Values to fill aggregate before save.

metaModelContainer - of model that will contain the aggregate.

containerModel - The object that will contain the new aggregate.

number - This number will be passed to calculator of type IAggregateOidCalculator, it can use this number to calculate the oid. It's a simple counter.

Throws:

SystemException

XavaException

CreateException

ValidationException

findByAnyProperty

public Object findByAnyProperty(MetaModel metaModel,
 Map keyValues)
                         throws ObjectNotFoundException,
FinderException

Description copied from interface: IPersistenceProvider

Find an object by any property (or properties).

Returns the first object that match with the sent arguments (searchingValues).

Specified by:

findByAnyProperty in interface IPersistenceProvider

Returns:

Never null.

Throws:

XavaException

ObjectNotFoundException

FinderException

findByKeyUsingQuery

public Object findByKeyUsingQuery(MetaModel metaModel,
 Map keyValues)
                           throws ObjectNotFoundException,
FinderException

Throws:

XavaException

ObjectNotFoundException

FinderException

getModelName

public String getModelName(Object modelObject)

Description copied from interface: IPersistenceProvider

Model name from the model object. It can be null. This value is useful when inheritance is used and the official model name does not match the real model name, so if inheritance does not apply it can be null.

Specified by:

getModelName in interface IPersistenceProvider

Since:

5.6