de.ipcon.db.tools

Class UnlazyUpdateStrategy

java.lang.Object

de.ipcon.db.tools.UnlazyUpdateStrategy

All Implemented Interfaces:

CachingBOLoaderUpdateStrategyI

public class UnlazyUpdateStrategy
extends java.lang.Object
implements CachingBOLoaderUpdateStrategyI

Cache update strategy managing entity reachability and selective unlazy configurations.

Precomputes the graph of entities and classes to keep synchronized in the CachingBOLoader based on root classes, persistent relations and configured unlazy paths. Graph traversals and sub-entity attribute expansions are handled by SchemaUtils.

See Also:

CachingBOLoaderUpdateStrategyI, SchemaUtils

Field Summary

Fields

Modifier and Type	Field and Description
static java.util.Set<java.lang.Class<?>>	DEFAULT_IGNORE_CLASSES_FOR_UPDATING Internal classes that are unmodifiable by default and ignored during cache updates.

Fields inherited from interface de.ipcon.db.core.CachingBOLoaderUpdateStrategyI

$0

Constructor Summary

Constructors

Constructor and Description
UnlazyUpdateStrategy(SchemaI schema, java.util.Collection<java.lang.Class<?>> rootClasses, java.util.Collection<java.lang.String> unlazyUpdateInformation, java.util.Set<java.lang.Class<?>> ignoredClassesWhenUpdating) Creates and initializes a new update strategy.

Method Summary

Modifier and Type	Method and Description
java.util.Map<EntityI,java.util.Set<AttributeI>>	getFullUnlazyMap() Returns the internal mapping of all entities to their expanded unlazy attributes.
java.util.Set<EntityI>	getMonitoredEntities() Returns the entity types to register with the database change listener.
static java.util.Collection<java.lang.String>	getNetwork(BO bo, java.util.Set<java.lang.String> recursionGuard, boolean onlyManyRelations) Deprecated. Relocated to SchemaUtils.findUnlazyPaths(BOI, Set, boolean). Call SchemaUtils.findUnlazyPaths(de.ipcon.schema.BOI, java.util.Set<java.lang.String>, boolean) directly.
SchemaI	getSchema() Returns the active schema.
java.util.Set<AttributeI>	getUnlazyManyrelations(java.lang.Class clazz) Returns all unlazy many-relation attributes configured for the given BO class.
java.util.Set<AttributeI>	getUnlazyManyrelations(EntityI entity) Returns all unlazy many-relation attributes configured for the given entity.
boolean	hasUnlazyManyrelations(java.lang.Class clazz) Checks whether the given BO class has any configured unlazy many-relations.
boolean	hasUnlazyManyrelations(EntityI entity) Checks whether the given entity has any configured unlazy many-relations.
boolean	isEagerLoadingEnabled() Determines whether newly created server objects matching the monitored entities should be eagerly loaded into the cache even if not previously cached.
boolean	isMonitoredClass(java.lang.Class aClass) Evaluates whether a specific BO class requires cache synchronization.
boolean	isUnlazy(EntityI entity, AttributeI attr) Evaluates whether a specific relation attribute should be loaded unlazily for an entity.
void	setSchema(SchemaI schema) Updates the active schema and triggers a complete cache re-initialization if the instance changed.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_IGNORE_CLASSES_FOR_UPDATING

public static final java.util.Set<java.lang.Class<?>> DEFAULT_IGNORE_CLASSES_FOR_UPDATING

Internal classes that are unmodifiable by default and ignored during cache updates.

Constructor Detail

UnlazyUpdateStrategy

public UnlazyUpdateStrategy(SchemaI schema,
                            java.util.Collection<java.lang.Class<?>> rootClasses,
                            java.util.Collection<java.lang.String> unlazyUpdateInformation,
                            java.util.Set<java.lang.Class<?>> ignoredClassesWhenUpdating)

Creates and initializes a new update strategy.

Parameters:

schema - schema for entity lookups; must not be null

rootClasses - root BO classes marking graph entry points; must not be null

unlazyUpdateInformation - configuration strings (e.g. "Entity#attribute"); must not be null

ignoredClassesWhenUpdating - classes to exclude from updates; must not be null

Method Detail

getMonitoredEntities

public java.util.Set<EntityI> getMonitoredEntities()

Returns the entity types to register with the database change listener.

Only changes to business objects belonging to these entities trigger update evaluation.

Returns all schema entities discovered via reachability traversal from the configured root classes across persistent single and configured unlazy many-relations.

Specified by:

getMonitoredEntities in interface CachingBOLoaderUpdateStrategyI

Returns:

unmodifiable set of reachable schema entities

isMonitoredClass

public boolean isMonitoredClass(java.lang.Class aClass)

Evaluates whether a specific BO class requires cache synchronization.

Acts as a concrete type filter for polymorphic entities returned by CachingBOLoaderUpdateStrategyI.getMonitoredEntities(). Called only for classes whose entity definition is included in CachingBOLoaderUpdateStrategyI.getMonitoredEntities().

Performs a constant-time reference equality check against precomputed reachable classes.

Specified by:

isMonitoredClass in interface CachingBOLoaderUpdateStrategyI

Parameters:

aClass - concrete BO class to evaluate

Returns:

true if the class is reachable from configured roots; false otherwise

isEagerLoadingEnabled

public boolean isEagerLoadingEnabled()

Determines whether newly created server objects matching the monitored entities should be eagerly loaded into the cache even if not previously cached.

If false, updates are applied strictly to objects already resident in the cache or linked via currently unlazied many-relations.

Returns false; this strategy restricts cache synchronization exclusively to already-cached objects or objects attached to active, unlazied relation paths.

Specified by:

isEagerLoadingEnabled in interface CachingBOLoaderUpdateStrategyI

Returns:

false

getSchema

public SchemaI getSchema()

Returns the active schema.

Returns:

current schema instance

setSchema

public void setSchema(SchemaI schema)

Updates the active schema and triggers a complete cache re-initialization if the instance changed.

Parameters:

schema - new schema instance

getUnlazyManyrelations

public java.util.Set<AttributeI> getUnlazyManyrelations(java.lang.Class clazz)

Returns all unlazy many-relation attributes configured for the given BO class.

Parameters:

clazz - business object class

Returns:

configured unlazy attributes or an empty set if none exist

getUnlazyManyrelations

public java.util.Set<AttributeI> getUnlazyManyrelations(EntityI entity)

Returns all unlazy many-relation attributes configured for the given entity.

Parameters:

entity - target schema entity

Returns:

configured unlazy attributes or an empty set if none exist

isUnlazy

public boolean isUnlazy(EntityI entity,
                        AttributeI attr)

Evaluates whether a specific relation attribute should be loaded unlazily for an entity.

Single relations (n-1) are always treated as unlazy; many-relations (1-n, n-m) require explicit configuration.

Parameters:

entity - owning schema entity

attr - relation attribute to inspect

Returns:

true if unlazy loading is required; false otherwise

hasUnlazyManyrelations

public boolean hasUnlazyManyrelations(java.lang.Class clazz)

Checks whether the given BO class has any configured unlazy many-relations.

Parameters:

clazz - business object class

Returns:

true if at least one unlazy many-relation is configured; false otherwise

hasUnlazyManyrelations

public boolean hasUnlazyManyrelations(EntityI entity)

Checks whether the given entity has any configured unlazy many-relations.

Parameters:

entity - schema entity to inspect

Returns:

true if at least one unlazy many-relation is configured; false otherwise

getFullUnlazyMap

public java.util.Map<EntityI,java.util.Set<AttributeI>> getFullUnlazyMap()

Returns the internal mapping of all entities to their expanded unlazy attributes.

Returns:

map of entities to their unlazy attributes

getNetwork

@Deprecated
public static java.util.Collection<java.lang.String> getNetwork(BO bo,
                                                                            java.util.Set<java.lang.String> recursionGuard,
                                                                            boolean onlyManyRelations)

Deprecated. Relocated to SchemaUtils.findUnlazyPaths(BOI, Set, boolean). Call SchemaUtils.findUnlazyPaths(de.ipcon.schema.BOI, java.util.Set<java.lang.String>, boolean) directly.

Iterates over a BO network to collect descriptors of currently unlazied relations.

Parameters:

bo - business object to inspect

recursionGuard - visited path accumulator

onlyManyRelations - true to restrict analysis to many-relations

Returns:

collection of unlazy path descriptions