no.g9.domain

Class G9Proxy<T>

java.lang.Object

no.g9.domain.G9Proxy<T>

Type Parameters:

T - Type of proxied domain object

All Implemented Interfaces:

DomainObjectProxy<T>

public class G9Proxy<T>
extends Object
implements DomainObjectProxy<T>

This class acts as a proxy for domain objects, and is a concrete implementation of DomainObjectProxy.

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	ZERO_VALUE_BOOLEAN Default zero value for boolean
static byte	ZERO_VALUE_BYTE Default zero value for byte
static char	ZERO_VALUE_CHAR Default zero value for char
static double	ZERO_VALUE_DOUBLE Default zero value for double
static float	ZERO_VALUE_FLOAT Default zero value for float
static int	ZERO_VALUE_INT Default zero value for int
static long	ZERO_VALUE_LONG Default zero value for long
static short	ZERO_VALUE_SHORT Default zero value for short

Constructor Summary

Constructors

Constructor and Description
G9Proxy(T domainObject, G9Enums enums, boolean useAccessMethods) Creates a new G9Proxy.

Method Summary

Modifier and Type	Method and Description
void	copyStatus(DomainObjectProxy<?> fromProxy, String fromAttributeName, String toAttributeName) Copies the status from an attribute in fromProxy.
boolean	equalsInitialValue(String attributeName, Object value) Checks if the specified value equals the original value from the domain object.
void	forceClean(String attributeName, Object value) Updates the specified value and sets the state of this attribute to "clean"
void	forceClean(T o) Forces the proxy to hold a new object, which then are considered "clean"
Object	getAttribute(String attributeName) Returns the specified attribute with its current value.
Object	getCleanVersionOfAttribute(String attributeName) Returns the initial value of the specified attribute.
T	getCleanVersionOfObject() Returns the object in its initial state.
T	getObject() Returns the object in its current state, which might be clean, might be dirty.
boolean	isClean() Quiering about the object state.
boolean	isClean(String attributeName) Quiering about the attribute state.
void	reset() Resets the object to its initial, clean state
void	resetAttribute(String attributeName) Resets the specified attribute to its original value.
void	setAttribute(String attributeName, Object attributeValue) Sets an attribute.
String	toString() Returns a string representation of this proxy.

Methods inherited from class java.lang.Object

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

Field Detail

ZERO_VALUE_BYTE

public static final byte ZERO_VALUE_BYTE

Default zero value for byte

See Also:

Constant Field Values

ZERO_VALUE_SHORT

public static final short ZERO_VALUE_SHORT

Default zero value for short

See Also:

Constant Field Values

ZERO_VALUE_INT

public static final int ZERO_VALUE_INT

Default zero value for int

See Also:

Constant Field Values

ZERO_VALUE_CHAR

public static final char ZERO_VALUE_CHAR

Default zero value for char

See Also:

Constant Field Values

ZERO_VALUE_LONG

public static final long ZERO_VALUE_LONG

Default zero value for long

See Also:

Constant Field Values

ZERO_VALUE_FLOAT

public static final float ZERO_VALUE_FLOAT

Default zero value for float

See Also:

Constant Field Values

ZERO_VALUE_DOUBLE

public static final double ZERO_VALUE_DOUBLE

Default zero value for double

See Also:

Constant Field Values

ZERO_VALUE_BOOLEAN

public static final boolean ZERO_VALUE_BOOLEAN

Default zero value for boolean

See Also:

Constant Field Values

Constructor Detail

G9Proxy

public G9Proxy(T domainObject,
               G9Enums enums,
               boolean useAccessMethods)

Creates a new G9Proxy.

Parameters:

domainObject - the domain object that shall be proxied

enums - the application's enumerators

useAccessMethods - if true variables are accessed using bean-style getter and setter methods.

Method Detail

isClean

public boolean isClean()

Description copied from interface: DomainObjectProxy

Quiering about the object state. Returns true if the object state is unchanged from the initial state (in other words clean).

Specified by:

isClean in interface DomainObjectProxy<T>

Returns:

true if the proxied object is clean.

isClean

public boolean isClean(String attributeName)

Description copied from interface: DomainObjectProxy

Quiering about the attribute state. Returns true if the attribute is unchanged from it's original state.

Specified by:

isClean in interface DomainObjectProxy<T>

Parameters:

attributeName - (missing javadoc)

Returns:

true if attribute is unchanged

getCleanVersionOfObject

public T getCleanVersionOfObject()

Description copied from interface: DomainObjectProxy

Returns the object in its initial state.

Specified by:

getCleanVersionOfObject in interface DomainObjectProxy<T>

Returns:

a clean object.

getObject

public T getObject()

Description copied from interface: DomainObjectProxy

Returns the object in its current state, which might be clean, might be dirty.

Specified by:

getObject in interface DomainObjectProxy<T>

Returns:

the object in its current state.

setAttribute

public void setAttribute(String attributeName,
                         Object attributeValue)

Description copied from interface: DomainObjectProxy

Sets an attribute. If the attribute is sucessfully set, the object state is considered dirty, no matter what the previous state was. If the specified attribute name does not match an actual attribute which is possible to set (either directly or via a set-method), an IllegalArgumentException is thrown.

Specified by:

setAttribute in interface DomainObjectProxy<T>

Parameters:

attributeName - the name of the attribute to set.

attributeValue - the new value of the specified attribute. Primitive types must be wrapped.

getAttribute

public Object getAttribute(String attributeName)

Description copied from interface: DomainObjectProxy

Returns the specified attribute with its current value. Primitives are wrapped. If the specified attribute name does not match an actual attribute which is possible to get (either directly or via a get-method), an IllegalArgumentException is thrown.

Specified by:

getAttribute in interface DomainObjectProxy<T>

Parameters:

attributeName - the name of the attribute to get.

Returns:

the current value of the attribute.

reset

public void reset()

Description copied from interface: DomainObjectProxy

Resets the object to its initial, clean state

Specified by:

reset in interface DomainObjectProxy<T>

resetAttribute

public void resetAttribute(String attributeName)

Description copied from interface: DomainObjectProxy

Resets the specified attribute to its original value.

Specified by:

resetAttribute in interface DomainObjectProxy<T>

Parameters:

attributeName - the (declared) name of the attribute

getCleanVersionOfAttribute

public Object getCleanVersionOfAttribute(String attributeName)

Description copied from interface: DomainObjectProxy

Returns the initial value of the specified attribute.

Specified by:

getCleanVersionOfAttribute in interface DomainObjectProxy<T>

Parameters:

attributeName - (missing javadoc)

Returns:

the attribute object

equalsInitialValue

public boolean equalsInitialValue(String attributeName,
                                  Object value)

Description copied from interface: DomainObjectProxy

Checks if the specified value equals the original value from the domain object. All Strings not containing any letters (including null-pointers) are considered equal. Consider the following: String s1 = null; String s2 = ""; String s3 = " "; String orig1 = null; Asuming orig1 is a reference to the domain-objects initial value of the attribute, s1, s2 and s3 are all considered equal to the origianal value.

Specified by:

equalsInitialValue in interface DomainObjectProxy<T>

Parameters:

attributeName - the (declared) name of the attribute

value - - object holding the value which sould be compared to the initial value

Returns:

true if the specified value equals the initial value.

forceClean

public void forceClean(String attributeName,
                       Object value)

Updates the specified value and sets the state of this attribute to "clean"

Specified by:

forceClean in interface DomainObjectProxy<T>

Parameters:

attributeName - the name of the attribute

value - the value to set on the attribute.

forceClean

public void forceClean(T o)

Description copied from interface: DomainObjectProxy

Forces the proxy to hold a new object, which then are considered "clean"

Specified by:

forceClean in interface DomainObjectProxy<T>

Parameters:

o - (missing javadoc)

copyStatus

public void copyStatus(DomainObjectProxy<?> fromProxy,
                       String fromAttributeName,
                       String toAttributeName)

Description copied from interface: DomainObjectProxy

Copies the status from an attribute in fromProxy.

Specified by:

copyStatus in interface DomainObjectProxy<T>

Parameters:

fromProxy - (missing javadoc)

fromAttributeName - (missing javadoc)

toAttributeName - (missing javadoc)

toString

public String toString()

Returns a string representation of this proxy. The string contains information about which class, object and state of the object being proxied.

Overrides:

toString in class Object

Returns:

a string containing debug infromation