de.ipcon.db.tools

Class DeepCloneHelper

java.lang.Object

de.ipcon.db.tools.DeepCloneHelper

All Implemented Interfaces:

BOSerializationDepthI, java.util.function.Function<LazyRelationMap,java.lang.Boolean>

public class DeepCloneHelper
extends java.lang.Object
implements java.util.function.Function<LazyRelationMap,java.lang.Boolean>, BOSerializationDepthI

Default implementation for a Function to be put into BO.doExWriteLRMFunction to control if manyrelations should be deepCloned when frapFromCache'ing a BO. Allows to limit it by a maximum (overall) depth and number of BOs in a manyrelation. Does not support multithreading when counting, because the expected usage is inside a ThreadLocal, i.e. single threaded.

Field Summary

Fields inherited from interface de.ipcon.db.io.BOSerializationDepthI

$0

Constructor Summary

Constructors

Constructor and Description
DeepCloneHelper() Default constructor.
DeepCloneHelper(int maxDepth, int sizeLimit)
DeepCloneHelper(int maxDepth, int sizeLimit, boolean clearFailedUnlazies)

Method Summary

Modifier and Type	Method and Description
java.lang.Boolean	apply(LazyRelationMap lrm) Will be called BEFORE entering the n-m relation, i.e. we are asked if we want to increase nmDepth by 1
java.lang.String	getCurrentPath()
int	getDepth() The sum of n-1 and n-m relations, i.e. the current effective depth
int	getN1Depth() Current depth just regarding n-1 relations
int	getNMDepth() Current depth just regarding n-m relations
void	popN1() Decreses the n-1 relation counter and pops the last object from the depth stack
void	popNM() Decreses the n-1 relation counter and pops the last object from the depth stack
void	pushN1(BOI o) Increases the n-1 relation counter and adds this (nullable) BO to the stack.
void	pushNM(java.util.Map map) Increases the n-m relation counter and adds this nonnull LazyMap to the depth stack
void	reset() Resets all counters back to 0 and clears the current path
static <T> T	withUnlazyManyrelations(DeepCloneHelper helper, java.util.function.Supplier<T> supplier) Method to wrap a frapFromCache call inside a provided DeepCloneHelper to handle cloning of unlazy maps and correctly removing the used ThreadLocal again.
static <T> T	withUnlazyManyrelations(int maxDepth, int sizeLimit, java.util.function.Supplier<T> supplier)
static <T> T	withUnlazyManyrelations(java.util.function.Supplier<T> supplier)

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.function.Function

andThen, compose, identity

Constructor Detail

DeepCloneHelper

public DeepCloneHelper()

Default constructor. Will deepclone manyrelations with up to 1000 Elements to reduce the size of their subgraph. Need to refetch them if really needed. Limits the maximum depth to 6 steps/nodes away from the original BO, i.e. limit the maximum depth of the frapped graph at least for maynrelations

DeepCloneHelper

public DeepCloneHelper(int maxDepth,
                       int sizeLimit)

DeepCloneHelper

public DeepCloneHelper(int maxDepth,
                       int sizeLimit,
                       boolean clearFailedUnlazies)

Method Detail

reset

public void reset()

Description copied from interface: BOSerializationDepthI

Resets all counters back to 0 and clears the current path

Specified by:

reset in interface BOSerializationDepthI

pushN1

public void pushN1(BOI o)

Description copied from interface: BOSerializationDepthI

Increases the n-1 relation counter and adds this (nullable) BO to the stack. If bo is null, then the next expected call to this interface is to method BOSerializationDepthI.popN1()

Specified by:

pushN1 in interface BOSerializationDepthI

popN1

public void popN1()

Description copied from interface: BOSerializationDepthI

Decreses the n-1 relation counter and pops the last object from the depth stack

Specified by:

popN1 in interface BOSerializationDepthI

pushNM

public void pushNM(java.util.Map map)

Description copied from interface: BOSerializationDepthI

Increases the n-m relation counter and adds this nonnull LazyMap to the depth stack

Specified by:

pushNM in interface BOSerializationDepthI

popNM

public void popNM()

Description copied from interface: BOSerializationDepthI

Decreses the n-1 relation counter and pops the last object from the depth stack

Specified by:

popNM in interface BOSerializationDepthI

getN1Depth

public int getN1Depth()

Description copied from interface: BOSerializationDepthI

Current depth just regarding n-1 relations

Specified by:

getN1Depth in interface BOSerializationDepthI

getNMDepth

public int getNMDepth()

Description copied from interface: BOSerializationDepthI

Current depth just regarding n-m relations

Specified by:

getNMDepth in interface BOSerializationDepthI

getDepth

public int getDepth()

Description copied from interface: BOSerializationDepthI

The sum of n-1 and n-m relations, i.e. the current effective depth

Specified by:

getDepth in interface BOSerializationDepthI

apply

public java.lang.Boolean apply(LazyRelationMap lrm)

Will be called BEFORE entering the n-m relation, i.e. we are asked if we want to increase nmDepth by 1

Specified by:

apply in interface java.util.function.Function<LazyRelationMap,java.lang.Boolean>

getCurrentPath

public java.lang.String getCurrentPath()

Returns:

the path in stack like order, e.g. in the order towards the root bo

withUnlazyManyrelations

public static <T> T withUnlazyManyrelations(java.util.function.Supplier<T> supplier)

withUnlazyManyrelations

public static <T> T withUnlazyManyrelations(int maxDepth,
                                            int sizeLimit,
                                            java.util.function.Supplier<T> supplier)

withUnlazyManyrelations

public static <T> T withUnlazyManyrelations(DeepCloneHelper helper,
                                            java.util.function.Supplier<T> supplier)

Method to wrap a frapFromCache call inside a provided DeepCloneHelper to handle cloning of unlazy maps and correctly removing the used ThreadLocal again.