er.extensions.eof

Class ERXEntityOrder

java.lang.Object

er.extensions.eof.ERXEntityOrder

Direct Known Subclasses:

ERXEntityFKConstraintOrder

public abstract class ERXEntityOrder
extends Object

Abstract class defining an ordering of EOEntities that also provides NSComparators to sort entities based on this ordering. The ordering is based on groups of entities with entities within each group having no defined order.

This is implemented by creating a dictionary of entity name to group. Group 1 is entities with no dependencies. Group 2 is entities with dependencies on entities in group 1. Group 3 is entities with dependencies on entities in groups 1 and 2. etc. The dependencies between entities are determined by the abstract NSDictionary dependenciesByEntity().

Author:

chill

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ERXEntityOrder.EntityDeleteOrderComparator NSComparator to sort on the ascending EOEntity group number from ordering.entityOrdering().
static class	ERXEntityOrder.EntityInsertOrderComparator NSComparator to sort on the descending EOEntity group number from ordering.entityOrdering().

Field Summary

Fields

Modifier and Type	Field and Description
protected NSArray<com.webobjects.eoaccess.EOEntity>	allEntities
protected NSMutableDictionary<String,Integer>	groupedEntities

Constructor Summary

Constructors

Constructor and Description
ERXEntityOrder() Convenience constructor for implementing classes.
ERXEntityOrder(com.webobjects.eoaccess.EOModelGroup modelGroup) Designated constructor for implementing classes.

Method Summary

Modifier and Type	Method and Description
NSArray<com.webobjects.eoaccess.EOEntity>	allEntities()
void	createListOfEntities(com.webobjects.eoaccess.EOModelGroup modelGroup) Creates list of all entities (excluding prototype entities) in all models in modelGroup.
protected abstract NSDictionary<String,NSSet<String>>	dependenciesByEntity() Processes allEntities() and returns a dictionary keyed on dependencyKeyFor(EOEntity).
protected String	dependencyKeyFor(com.webobjects.eoaccess.EOEntity entity) This implementation returns entity.name().
protected NSSet<String>	dependentEntities(NSDictionary<String,NSSet<String>> dependencies, com.webobjects.eoaccess.EOEntity entity)
protected void	generateOrdering() Calls dependenciesByEntity() to determine dependencies and processes entities in allEntities() to generate the groupedEntities() dictionary.
NSMutableDictionary<String,Integer>	groupedEntities() Returns dictionary of group numbers (java.lang.Integer) to entity names.
protected boolean	hasDependenciesForEntity(NSDictionary<String,NSSet<String>> dependencies, com.webobjects.eoaccess.EOEntity entity)

Methods inherited from class java.lang.Object

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

Field Detail

groupedEntities

protected NSMutableDictionary<String,Integer> groupedEntities

allEntities

protected NSArray<com.webobjects.eoaccess.EOEntity> allEntities

Constructor Detail

ERXEntityOrder

public ERXEntityOrder(com.webobjects.eoaccess.EOModelGroup modelGroup)

Designated constructor for implementing classes.

Parameters:

modelGroup - EOModelGroup to get list of all entities from

ERXEntityOrder

public ERXEntityOrder()

Convenience constructor for implementing classes. Uses EOModelGroup.defaultGroup().

Method Detail

groupedEntities

public NSMutableDictionary<String,Integer> groupedEntities()

Returns dictionary of group numbers (java.lang.Integer) to entity names. Group 1 is entities with no dependencies. Group 2 is entities with dependencies on entities in group 1. Group 3 is entities with dependencies on entities in groups 1 and 2. etc

Returns:

dictionary of group numbers to entity names

dependenciesByEntity

protected abstract NSDictionary<String,NSSet<String>> dependenciesByEntity()

Processes allEntities() and returns a dictionary keyed on dependencyKeyFor(EOEntity). The keys are usually entity.name() but are not required to be. The value associated with each key is an NSSet of the entity names that have a dependency on the key. This dictionary is used to determine the dependency ordering.

Returns:

a dictionary keyed on dependencyKeyFor(EOEntity)

generateOrdering

protected void generateOrdering()

Calls dependenciesByEntity() to determine dependencies and processes entities in allEntities() to generate the groupedEntities() dictionary.

hasDependenciesForEntity

protected boolean hasDependenciesForEntity(NSDictionary<String,NSSet<String>> dependencies,
                                           com.webobjects.eoaccess.EOEntity entity)

Parameters:

dependencies - dictionary from dependenciesByEntity()

entity - entity to check for dependencies

Returns:

true if groupedEntities() has all the entities named in dependentEntities(dependencies, entity).

dependentEntities

protected NSSet<String> dependentEntities(NSDictionary<String,NSSet<String>> dependencies,
                                          com.webobjects.eoaccess.EOEntity entity)

Parameters:

dependencies - result from dependenciesByEntity()

entity - EOEntity to return dependencies set for

Returns:

set of names of entities that are dependent on entity

dependencyKeyFor

protected String dependencyKeyFor(com.webobjects.eoaccess.EOEntity entity)

This implementation returns entity.name().

Parameters:

entity - EOEntity to return key into dependency dictionary for

Returns:

key for entity into dependency dictionary returned by dependenciesByEntity()

createListOfEntities

public void createListOfEntities(com.webobjects.eoaccess.EOModelGroup modelGroup)

Creates list of all entities (excluding prototype entities) in all models in modelGroup.

Parameters:

modelGroup - EOModelGroup to get list of all entities from

allEntities

public NSArray<com.webobjects.eoaccess.EOEntity> allEntities()

Returns:

list of all entities in all models in the model group