public interface DynamicDSGenerator
DynamicDSGenerators can be registered with the SmartClient Server framework via the
DataSource.addDynamicDSGenerator(DynamicDSGenerator)method. The framework will call the
getDataSourcemethod of registered
DynamicDSGeneratorswhenever it needs to obtain a DataSource, giving user code a means of generating DataSource definitions at runtime, rather than (or as well as) providing them as
.ds.xmlfiles in the filesystem.
DataSource getDataSource(java.lang.String id, DSRequest dsRequest)
DataSource. If you do not wish to provide an instance for the given ID, return
nulland the system will go through its normal process for loading a DataSource. Please see the docs for
DataSource.addDynamicDSGenerator(DynamicDSGenerator)for an important warning about this. NOTE: Please scan the client-side documentation for "serverDataSourceImplementation" for a discussion of caching and thread-safety issues with server-side DataSources.
id- The ID of the DataSource the framework is trying to obtain
DSRequestfor which the framework is trying to obtain a DataSource. This will be null if the DataSource is not needed in the context of a DSRequest