Entities interface to represent a group of entities of the IEntity type.
The entities are part of the domain model. They have the concept configuration.
The entities have a Java collection that can be obtained by the getCollection method.
It is possible to obtain a subset of entities based on the selection criteria. The subset of entities is a selection destination object of the IEntities type. The destination entities are different from the source entities. In order words, the destination entities are a model view of the source entities.
A single entity may be retrieved by using an oid, a code, a property, or a neighbor object. An existance of an entity in the entities may also be checked.
A new entity may be added to the entities. If the new entity does not have oid, the oid is created by the add method. An entity may be removed from the entities. An entity may be updated by a new entity version. The add, remove and update methods check the action precondition and postcondition (or preaction and postaction). The action is accepted only if both pre and post conditions are satisfied. For example, the add precondition verifies if required properties do have values. If not, a dmLite error is created.
For the add and remove actions, if the action is on a model view, the action is propagated by default to the source entities.
A Java iterator may be defined over the entities.
@author Dzenan Ridjanovic
@version 2006-11-03