no.g9.domain

Interface DomainObjectProxy<T>

Type Parameters:

T - Type of domain object

All Known Implementing Classes:

G9Proxy

public interface DomainObjectProxy<T>

The domain object proxy interface

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) Forces the specified value to be the clean value.
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.

Method Detail

isClean

boolean isClean()

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

Returns:

true if the proxied object is clean.

isClean

boolean isClean(String attributeName)

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

Parameters:

attributeName - (missing javadoc)

Returns:

true if attribute is unchanged

getCleanVersionOfObject

T getCleanVersionOfObject()

Returns the object in its initial state.

Returns:

a clean object.

getObject

T getObject()

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

Returns:

the object in its current state.

setAttribute

void setAttribute(String attributeName,
                  Object attributeValue)

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.

Parameters:

attributeName - the name of the attribute to set.

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

getAttribute

Object getAttribute(String attributeName)

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.

Parameters:

attributeName - the name of the attribute to get.

Returns:

the current value of the attribute.

getCleanVersionOfAttribute

Object getCleanVersionOfAttribute(String attributeName)

Returns the initial value of the specified attribute.

Parameters:

attributeName - (missing javadoc)

Returns:

the attribute object

resetAttribute

void resetAttribute(String attributeName)

Resets the specified attribute to its original value.

Parameters:

attributeName - the (declared) name of the attribute

equalsInitialValue

boolean equalsInitialValue(String attributeName,
                           Object value)

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.

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.

reset

void reset()

Resets the object to its initial, clean state

forceClean

void forceClean(String attributeName,
                Object value)

Forces the specified value to be the clean value.

Parameters:

attributeName - the name of the attribute.

value - the (clean) value of the specified attribute

copyStatus

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

Copies the status from an attribute in fromProxy.

Parameters:

fromProxy - (missing javadoc)

fromAttributeName - (missing javadoc)

toAttributeName - (missing javadoc)

forceClean

void forceClean(T o)

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

Parameters:

o - (missing javadoc)