Package org.apache.ofbiz.entity.datasource

Class GenericHelperDAO

java.lang.Object

org.apache.ofbiz.entity.datasource.GenericHelperDAO

All Implemented Interfaces:

GenericHelper

public class GenericHelperDAO
extends Object
implements GenericHelper

Generic Entity Helper Class

Constructor Summary

Constructors

Constructor	Description
GenericHelperDAO(GenericHelperInfo helperInfo)

Method Summary

Modifier and Type	Method	Description
void	checkDataSource(Map<String,ModelEntity> modelEntities, List<String> messages, boolean addMissing)	Check the datasource to make sure the entity definitions are correct, optionally adding missing entities or fields on the server
GenericValue	create(GenericValue value)	Creates a Entity in the form of a GenericValue and write it to the database
List<GenericValue>	findAllByPrimaryKeys(List<GenericPK> primaryKeys)	Find a number of Generic Value objects by their Primary Keys, all at once This is done here for the DAO GenericHelper; for a client-server helper it would be done on the server side to reduce network round trips.
List<GenericValue>	findByMultiRelation(GenericValue value, ModelRelation modelRelationOne, ModelEntity modelEntityOne, ModelRelation modelRelationTwo, ModelEntity modelEntityTwo, List<String> orderBy)
GenericValue	findByPrimaryKey(GenericPK primaryKey)	Find a Generic Entity by its Primary Key
GenericValue	findByPrimaryKeyPartial(GenericPK primaryKey, Set<String> keys)	Find a Generic Entity by its Primary Key and only returns the values requested by the passed keys (names)
long	findCountByCondition(Delegator delegator, ModelEntity modelEntity, EntityCondition whereEntityCondition, EntityCondition havingEntityCondition, List<ModelField> selectFields, EntityFindOptions findOptions)
long	findCountByCondition(Delegator delegator, ModelEntity modelEntity, EntityCondition whereEntityCondition, EntityCondition havingEntityCondition, EntityFindOptions findOptions)
EntityListIterator	findListIteratorByCondition(Delegator delegator, ModelEntity modelEntity, EntityCondition whereEntityCondition, EntityCondition havingEntityCondition, Collection<String> fieldsToSelect, List<String> orderBy, EntityFindOptions findOptions)	Finds GenericValues by the conditions specified in the EntityCondition object, the the EntityCondition javadoc for more details.
String	getHelperName()	Gets the name of the server configuration that corresponds to this helper
int	removeByCondition(Delegator delegator, ModelEntity modelEntity, EntityCondition condition)	Removes/deletes Generic Entity records found by all the specified condition
int	removeByPrimaryKey(GenericPK primaryKey)	Remove a Generic Entity corresponding to the primaryKey
int	store(GenericValue value)	Store the Entity from the GenericValue to the persistent store
int	storeByCondition(Delegator delegator, ModelEntity modelEntity, Map<String,? extends Object> fieldsToSet, EntityCondition condition)	Updates a group of values in a single pass.

Methods inherited from class java.lang.Object

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

Constructor Details

GenericHelperDAO

public GenericHelperDAO(GenericHelperInfo helperInfo)

Method Details

getHelperName

public String getHelperName()

Description copied from interface: GenericHelper

Gets the name of the server configuration that corresponds to this helper

Specified by:

getHelperName in interface GenericHelper

Returns:

server configuration name

create

public GenericValue create(GenericValue value)
                    throws GenericEntityException

Creates a Entity in the form of a GenericValue and write it to the database

Specified by:

create in interface GenericHelper

Returns:

GenericValue instance containing the new instance

Throws:

GenericEntityException

findByPrimaryKey

public GenericValue findByPrimaryKey(GenericPK primaryKey)
                              throws GenericEntityException

Find a Generic Entity by its Primary Key

Specified by:

findByPrimaryKey in interface GenericHelper

Parameters:

primaryKey - The primary key to find by.

Returns:

The GenericValue corresponding to the primaryKey

Throws:

GenericEntityException

findByPrimaryKeyPartial

public GenericValue findByPrimaryKeyPartial(GenericPK primaryKey,
 Set<String> keys)
                                     throws GenericEntityException

Find a Generic Entity by its Primary Key and only returns the values requested by the passed keys (names)

Specified by:

findByPrimaryKeyPartial in interface GenericHelper

Parameters:

primaryKey - The primary key to find by.

keys - The keys, or names, of the values to retrieve; only these values will be retrieved

Returns:

The GenericValue corresponding to the primaryKey

Throws:

GenericEntityException

findAllByPrimaryKeys

public List<GenericValue> findAllByPrimaryKeys(List<GenericPK> primaryKeys)
                                        throws GenericEntityException

Find a number of Generic Value objects by their Primary Keys, all at once This is done here for the DAO GenericHelper; for a client-server helper it would be done on the server side to reduce network round trips.

Specified by:

findAllByPrimaryKeys in interface GenericHelper

Parameters:

primaryKeys - A List of primary keys to find by.

Returns:

List of GenericValue objects corresponding to the passed primaryKey objects

Throws:

GenericEntityException

removeByPrimaryKey

public int removeByPrimaryKey(GenericPK primaryKey)
                       throws GenericEntityException

Remove a Generic Entity corresponding to the primaryKey

Specified by:

removeByPrimaryKey in interface GenericHelper

Parameters:

primaryKey - The primary key of the entity to remove.

Returns:

int representing number of rows effected by this operation

Throws:

GenericEntityException

findListIteratorByCondition

public EntityListIterator findListIteratorByCondition(Delegator delegator,
 ModelEntity modelEntity,
 EntityCondition whereEntityCondition,
 EntityCondition havingEntityCondition,
 Collection<String> fieldsToSelect,
 List<String> orderBy,
 EntityFindOptions findOptions)
                                               throws GenericEntityException

Finds GenericValues by the conditions specified in the EntityCondition object, the the EntityCondition javadoc for more details.

Specified by:

findListIteratorByCondition in interface GenericHelper

Parameters:

modelEntity - The ModelEntity of the Entity as defined in the entity XML file

whereEntityCondition - The EntityCondition object that specifies how to constrain this query before any groupings are done (if this is a view entity with group-by aliases)

havingEntityCondition - The EntityCondition object that specifies how to constrain this query after any groupings are done (if this is a view entity with group-by aliases)

fieldsToSelect - The fields of the named entity to get from the database; if empty or null all fields will be retreived

orderBy - The fields of the named entity to order the query by; optionally add a " ASC" for ascending or " DESC" for descending

findOptions - An instance of EntityFindOptions that specifies advanced query options. See the EntityFindOptions JavaDoc for more details.

Returns:

EntityListIterator representing the result of the query: NOTE THAT THIS MUST BE CLOSED WHEN YOU ARE DONE WITH IT (preferably in a finally block), AND DON'T LEAVE IT OPEN TOO LONG BECAUSE IT WILL MAINTAIN A DATABASE CONNECTION.

Throws:

GenericEntityException

findByMultiRelation

public List<GenericValue> findByMultiRelation(GenericValue value,
 ModelRelation modelRelationOne,
 ModelEntity modelEntityOne,
 ModelRelation modelRelationTwo,
 ModelEntity modelEntityTwo,
 List<String> orderBy)
                                       throws GenericEntityException

Specified by:

findByMultiRelation in interface GenericHelper

Throws:

GenericEntityException

findCountByCondition

public long findCountByCondition(Delegator delegator,
 ModelEntity modelEntity,
 EntityCondition whereEntityCondition,
 EntityCondition havingEntityCondition,
 EntityFindOptions findOptions)
                          throws GenericEntityException

Specified by:

findCountByCondition in interface GenericHelper

Throws:

GenericEntityException

findCountByCondition

public long findCountByCondition(Delegator delegator,
 ModelEntity modelEntity,
 EntityCondition whereEntityCondition,
 EntityCondition havingEntityCondition,
 List<ModelField> selectFields,
 EntityFindOptions findOptions)
                          throws GenericEntityException

Specified by:

findCountByCondition in interface GenericHelper

Throws:

GenericEntityException

removeByCondition

public int removeByCondition(Delegator delegator,
 ModelEntity modelEntity,
 EntityCondition condition)
                      throws GenericEntityException

Removes/deletes Generic Entity records found by all the specified condition

Specified by:

removeByCondition in interface GenericHelper

Parameters:

modelEntity - The ModelEntity of the Entity as defined in the entity XML file

condition - The condition that restricts the list of removed values

Returns:

int representing number of rows effected by this operation

Throws:

GenericEntityException

store

public int store(GenericValue value)
          throws GenericEntityException

Store the Entity from the GenericValue to the persistent store

Specified by:

store in interface GenericHelper

Parameters:

value - GenericValue instance containing the entity

Returns:

int representing number of rows effected by this operation

Throws:

GenericEntityException

storeByCondition

public int storeByCondition(Delegator delegator,
 ModelEntity modelEntity,
 Map<String,? extends Object> fieldsToSet,
 EntityCondition condition)
                     throws GenericEntityException

Updates a group of values in a single pass.

Specified by:

storeByCondition in interface GenericHelper

Parameters:

modelEntity - The ModelEntity of the Entity as defined in the entity XML file

fieldsToSet - The fields of the named entity to set in the database

condition - The condition that restricts the list of removed values

Returns:

int representing number of rows effected by this operation

Throws:

GenericEntityException

checkDataSource

public void checkDataSource(Map<String,ModelEntity> modelEntities,
 List<String> messages,
 boolean addMissing)
                     throws GenericEntityException

Check the datasource to make sure the entity definitions are correct, optionally adding missing entities or fields on the server

Specified by:

checkDataSource in interface GenericHelper

Parameters:

modelEntities - Map of entityName names and ModelEntity values

messages - List to put any result messages in

addMissing - Flag indicating whether or not to add missing entities and fields on the server

Throws:

GenericEntityException