Arbitrary Find

The arbitrary find method provides custom device application the ability to dynamically build queries based on user input. These queries operate on multiple MBOs through the use of joins.

• SUPAttributeTest
  In addition to allowing for arbitrary search criteria, the arbitrary find method lets the user specify a desired ordering of the results and object state criteria. A SUPQuery class is included in one of the client runtime libraries, libclientrt.a. The SUPQuery class is the single object passed to the arbitrary search methods and consists of search conditions, object/row state filter conditions, and data ordering information.
• SUPCompositeTest
  A SUPCompositeTest combines multiple SUPTestCriteria using the logical operators AND, OR, and NOT to create a compound filter.
• Dynamic Query
  User can use query to construct a query SQL statement as he wants to query data from local database. This query may across multiple tables (MBOs).
• Paging Data
  On low memory devices, retrieving up to 30,000 records from the database may cause the custom client to fail and throw an OutOfMemoryException.