Object State APIs

The object state APIs provide methods for returning information about the state of an entity in an application.

• Entity State Management
  The object state APIs provide methods for returning information about entities in the database. All entities that support pending state have the following attributes:
• Pending State Pattern
  When a create, update, delete, or save operation is called on an entity in a replication-based synchronization application, the requested change becomes pending. To apply the pending change, call submitPending on the entity, or submitPendingOperations on the MBO class:
• Mobile Business Object States
  A mobile business object can be in one of three states:
• Refresh Operation
  The refresh operation of an MBO allows you to refresh the MBO state from the client database.
• Clear Relationship Objects
  The clearRelationshipObjects method releases relationship attributes and sets them to null. Attributes get filled from the client database on the next getter method call or property reference. You can use this method to conserve memory if an MBO has large child attributes that are not needed at all times.