Object State APIs

The object state APIs include status indicator APIs for returning information about entities in the database, and a method to refresh the MBO entity in the local database.

• 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 message-based synchronization application, the requested change becomes pending. To apply the pending change, call submitPending on the entity, or submitPendingOperations on the mobile business object (MBO) class:
• Refresh
  The refresh method allows the client to refresh the MBO entity from the local 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.