docs/net.corda.core.node.services/VaultService/_trackBy

_trackBy

abstract fun <T : ContractState> _trackBy(criteria: QueryCriteria, paging: PageSpecification, sorting: Sort, contractStateType: Class<out T>): DataFeed<Vault.Page<T>, Vault.Update<T>>

Generic vault query function which takes a QueryCriteria object to define filters, optional PageSpecification and optional Sort modification criteria (default unsorted), and returns a DataFeed object containing:

  1. a snapshot as a Vault.Page (described previously in queryBy).

  2. an Observable of Vault.Update.

Throws

if the query cannot be executed for any reason.

Notes: - The snapshot part of the query adheres to the same behaviour as the queryBy function. - The update part of the query currently only supports query criteria filtering by contract type(s) and state status(es). CID-731 https://r3-cev.atlassian.net/browse/CID-731 proposes adding the complete set of QueryCriteria filtering.