public interface DsRequestEquivalence
automatic cache synchronizationand
offline caching and synchronization).
Aside from basic properties that would clearly make two DSRequests non-equivalent (dataSource, operationType and data, as well as sortBy, startRow, endRow and textMatchStyle for a "fetch"),
DSRequest.operationId is the only property that will cause two DSRequests to be considered distinct (non-equivalent) requests.
Bearing this in mind, the best practice is:
DSRequest.data. Do not "smuggle" data that will ultimately be used as criteria or values in other dsRequest properties, such as
DSRequest.operationIdas the sole piece of information in the request that modifies how the request as a whole is executed. If two or more pieces of information are required, combine or encode them into a single operationId String. If this becomes awkward because there are many operation variants, consider including additional fields in
DataSource.cloneDSRequest() can be used to create an equivalent DSRequest.