Base interface of all access adapters, which provides the functionality required by Tesla. During initialization, the method IAccessAdapter#initialize(int, int, String, String, HashMap) is called, such that the adapter can configure itself to access the required data. Developers must ensure that the parameters are internally stored and returned by the corresponding get-methods.
Note: This interface contains an IAccessAdapterTest which can be run by Tesla's JUnit-Component. Developers who re-implement this interface should run this component to validate their implementation.
|<T>||an interface extending DataObject.|
|void||initialize (int experimentId, ComponentEntity component, int roleId, Properties properties)|
|Set< Class<?extends T > >||getSubTypes ()|
|public< L extends T >|
InputIterator< Annotation< L > >
|getAllAnnotations (Class< L > clazz)|
|InputIterator< String >||getAllSignalIds ()|
|Annotation< T >||getAnnotationById (long id)|
This method is called when the lifecycle of an adapter ends, either by a component itself or by the framework. Subclasses should release used resources and free reserved memory.
|public<L extends T> InputIterator<Annotation<L> > getAllAnnotations||(||Class< L >||clazz||)|
Returns the ids of all signals which were annotated by the underlying component.
Returns the annotation with the given id, or
null, if it does not exist.
Returns the unique id of the component which produced the results.
Returns the unique id of the currently executed experiment, as set in IAccessAdapter#initialize(int, int, String, String, Map). Must never return 0.
Returns the ComponentEntity which created the data accessed by this adapter.
Returns the role of the component which created the data accessed by this adapter.
Returns the unique id of the accessed role (generated by Tesla during runtime), as set in IAccessAdapter#initialize(int, int, String, String, Map). Must never return 0.
|Set<Class<? extends T> > getSubTypes||(||)|
Initialization-method which is called at the beginning of an adapter life cycle.
|experimentId||the unique id of the experiment that is currently executed|
|roleId||the id of the role that is getting accessed. Note that this is not the role definition id.|
|dataObjectClass||the fully qualified name of the DataObject implementation that is getting accessed|
|properties||an optional map of properties which can contain implementation-specific attributes. Can be null.|