de.ipcon.db.core

Class LazyBOReference

java.lang.Object

java.lang.ref.Reference<T>

java.lang.ref.SoftReference

de.ipcon.db.core.LazyBOReference

Type Parameters:

T - The type of the Business Object (BO) that this reference holds.

public class LazyBOReference
extends java.lang.ref.SoftReference

A lazy-loading reference to a Business Object (BO). This class extends SoftReference to provide a way to reference a BO that may not be in memory. It automatically reloads the BO from the database if the in-memory reference has been cleared by the garbage collector or if the reference was originally created with only the BO's unique identifier (ID). This design is useful for managing large numbers of objects without keeping all of them in active memory, thereby reducing memory footprint.

Constructor Summary

Constructors

Constructor and Description
LazyBOReference(BO _bo, BOLoaderI _bol) Constructs a LazyBOReference with a known Business Object instance.
LazyBOReference(long _idBO, BOLoaderI _bol) Constructs a LazyBOReference with the ID of the Business Object.
LazyBOReference(java.lang.Long _idBO, BOLoaderI _bol) Constructs a LazyBOReference with the ID of the Business Object.
LazyBOReference(long _idBO, BOLoaderI _bol, java.lang.Class<? extends BOI> _clazz)
LazyBOReference(java.lang.Long _idBO, BOLoaderI _bol, java.lang.Class<? extends BOI> _clazz)

Method Summary

Modifier and Type	Method and Description
BO	getBO() Retrieves the referenced Business Object.
BO	getBO(BOLoaderI _bol)
long	getIdBO()
void	setIdBO(long $1)

Methods inherited from class java.lang.ref.SoftReference

get

Methods inherited from class java.lang.ref.Reference

clear, enqueue, isEnqueued

Methods inherited from class java.lang.Object

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

Constructor Detail

LazyBOReference

public LazyBOReference(BO _bo,
                       BOLoaderI _bol)

Constructs a LazyBOReference with a known Business Object instance.

Parameters:

_bo - The Business Object instance to be referenced. Must not be null.

_bol - The BOLoaderI to be used for reloading the object. Must not be null.

LazyBOReference

public LazyBOReference(java.lang.Long _idBO,
                       BOLoaderI _bol)

Constructs a LazyBOReference with the ID of the Business Object. This constructor is useful when the BO is not currently in memory. The object will be loaded from the database the first time getBO() is called.

Parameters:

_idBO - The unique ID of the Business Object.

_bol - The BOLoaderI to be used for reloading the object. Must not be null.

_clazz - The Class object of the Business Object. This is useful for the loader to know which type of object to load. If null, it defaults to BO.class.

LazyBOReference

public LazyBOReference(java.lang.Long _idBO,
                       BOLoaderI _bol,
                       java.lang.Class<? extends BOI> _clazz)

LazyBOReference

public LazyBOReference(long _idBO,
                       BOLoaderI _bol)

Constructs a LazyBOReference with the ID of the Business Object. This constructor is useful when the BO is not currently in memory. The object will be loaded from the database the first time getBO() is called.

Parameters:

_idBO - The unique ID of the Business Object.

_bol - The BOLoaderI to be used for reloading the object. Must not be null.

_clazz - The Class object of the Business Object. This is useful for the loader to know which type of object to load. If null, it defaults to BO.class.

LazyBOReference

public LazyBOReference(long _idBO,
                       BOLoaderI _bol,
                       java.lang.Class<? extends BOI> _clazz)

Method Detail

getBO

public BO getBO()

Retrieves the referenced Business Object. This method first attempts to get the object from memory (the SoftReference). If the object has been garbage collected or was never loaded, it uses the internal or an alternative BOLoaderI to reload the object from the database using its stored ID.

Parameters:

_bol - A BOLoaderI to be used instead of the one originally provided during instantiation. This is useful for contexts where a different loader (e.g. one with a different transaction) is required. May be null, in which case the default loader is used.

Returns:

The referenced Business Object, or null if it could not be loaded.

getBO

public BO getBO(BOLoaderI _bol)

getIdBO

public long getIdBO()

setIdBO

public void setIdBO(long $1)