| velosurf.context.Instance
All known Subclasses: velosurf.context.ExternalObjectWrapper,
| Instance | | public class Instance extends TreeMap (Code) | | An Instance provides field values by their name.
author:
Claude Brisson |
| Field Summary | |
| protected Database | db
The main database connection. | | protected Entity | entity
This Instance's Entity. |
| Constructor Summary | |
| public | Instance()
Build an empty instance for the given entity. | | public | Instance(Entity entity)
Build an empty instance for the given entity. | | public | Instance(Map<String, Object> values)
Builds a generic instance using values. |
| Instance | | public Instance()(Code) | | Build an empty instance for the given entity.
The method initialize(Entity) should be called afterwards.
Parameters:
entity - Entity this instance is a realisation of |
| Instance | | public Instance(Entity entity)(Code) | | Build an empty instance for the given entity.
Parameters:
entity - Entity this instance is a realisation of |
| Instance | | public Instance(Map<String, Object> values)(Code) | | Builds a generic instance using values.
Parameters:
values - |
| delete | | public synchronized boolean delete()(Code) | | Delete the row associated with this Instance.
Velosurf will ensure all key columns are specified, to avoid an accidental massive update.
true if successfull, false if an erroroccurs (in which case $db.error can be checked). |
| equals | | public boolean equals(Object o)(Code) | | Test equality of two instances.
Parameters:
o - other instance equality status |
| get | | public Object get(Object k)(Code) | | Generic getter, used to access this instance properties by their name.
Asked property is first searched in the Map, then among Attributes defined for the entity.
Parameters:
key - key of the property to be returned a String, an Instance, an AttributeReference or null if an erroroccurs |
| getExternal | | public Object getExternal(Object key)(Code) | | External getter. Meant to be overloaded in ExternalObjectWrapper.
Parameters:
key - key of the property to be returned a String, an Instance, an AttributeReference or null if not found or if an erroroccurs |
| getInternal | | public Object getInternal(Object key)(Code) | | Internal getter. First tries on the external object then on the Map interface.
Parameters:
key - key of the property to be returned a String, an Instance, an AttributeReference or null if not found or if an erroroccurs |
| getPrimaryKey | | public List getPrimaryKey()(Code) | | Returns an ArrayList of two-entries maps ('name' & 'value'), meant to be use in a #foreach loop to build form fields.
Example:
#foreach ($field in $product.primaryKey)
<input type=hidden name='$field.name' value='$field.value'>
#end
Please note that this method won't be of any help if you are using column aliases.
an ArrayList of two-entries maps ('name' & 'value') |
| initialize | | public void initialize(Entity entity)(Code) | | Initialization. Meant to be overloaded if needed.
Parameters:
entity - |
| insert | | public synchronized boolean insert()(Code) | | Insert a new row corresponding to this Instance.
true if successfull, false if an erroroccurs (in which case $db.error can be checked). |
| put | | public synchronized Object put(String key, Object value)(Code) | | Generic setter.
Parameters:
key - key of the property to be set
Parameters:
value - corresponding value previous value, or null |
| setColumns | | public synchronized void setColumns(Map<String, Object> values)(Code) | | Global setter that will only set values the correspond to actual
columns (otherwise, use putAll(Map values)).
Parameters:
values - corresponding values |
| update | | public synchronized boolean update()(Code) | | Update the row associated with this Instance from passed values.
Velosurf will ensure all key columns are specified, to avoid an accidental massive update.
true if successfull, false if an erroroccurs (in which case $db.error can be checked). |
| update | | public synchronized boolean update(Map<String, Object> values)(Code) | | Update the row associated with this Instance from actual values.
Velosurf will ensure all key columns are specified, to avoid an accidental massive update.
Parameters:
values - values to be used for the update true if successfull, false if an erroroccurs (in which case $db.error can be checked). |
| validate | | public boolean validate()(Code) | | Validate this instance against declared contraints.
a boolean stating whether this instance data are valid in regard to declared constraints |
|
|