| 
 | ||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
public interface ValueHolder
Provides a level of indirection for property value access, most often used for deferred faulting of to-one relationships. A ValueHolder abstracts how a property value is obtained (fetched from DB, etc.), thus simplifying design of an object that uses it.
Here is an example of a bean property implemented using ValueHolder:
 protected ValueHolder someProperty;
 
 public SomeClass getSomeProperty() {
     return (SomeClass) somePropertyHolder.getValue(SomeClass.class);
 }
 
 public void setSomeProperty(SomeClass newValue) {
     somePropertyHolder.setValue(SomeClass.class, newValue);
 }
 
| Method Summary | |
|---|---|
|  Object | getValue()Returns an object stored by this ValueHolder. | 
|  Object | getValueDirectly()Retrieves ValueHolder value without triggering fault resolution. | 
|  void | invalidate()Turns a ValueHolder into a fault. | 
|  boolean | isFault()Returns true if the internal value is not yet resolved. | 
|  Object | setValue(Object value)Sets an object stored by this ValueHolder. | 
|  Object | setValueDirectly(Object value)Sets ValueHolder vaue without triggering fault resolution. | 
| Method Detail | 
|---|
Object getValue()
                throws CayenneRuntimeException
CayenneRuntimeException
Object getValueDirectly()
                        throws CayenneRuntimeException
CayenneRuntimeException
Object setValue(Object value)
                throws CayenneRuntimeException
value - a new value of the ValueHolder.
CayenneRuntimeException
Object setValueDirectly(Object value)
                        throws CayenneRuntimeException
CayenneRuntimeExceptionboolean isFault()
void invalidate()
| 
 | ||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||