Package edu.kit.ipd.sdq.eventsim.instrumentation.injection

This package provides means for injection of instrumentations based on InstrumentationDescriptions. The InstrumentorBuilder can be used to create an Instrumentor which is actually responsible for instrumentation injection. Using the builder, the actual implementation of the instrumentor does not need to be known.
An example for the usage of the builder and the instrumentors is provided in the following:

 private ActiveResourceRep getModelResource(MyResourceImpl res) {
        // do something
        return modelResource;
 }
 
 ...
 
 Instrumentor<MyResourceImpl, ?> instrumentor =
 	InstrumentorBuilder.buildFor(myPcm)
                .withDescription(myDescription)
                .inBundle(myBundle)
                .withStorage(myStorage)
                .forModelType(ActiveResourceRep.class)
                .withMapping(this::getModelResource)
                .createFor(myProbeConfig);
 
 ...
 
 MyResourceImpl res = ...;
 instrumentor.instrument(res);
 

Interface Summary

Interface	Description
Instrumentor<E,C extends ProbeConfiguration>	Responsible for injecting probes and calculators.
SimulationElementMapping<S,M>	Functional interface that maps a simulation element (actual implementation of the element) to an element of an instrumentation description

Class Summary

Class	Description
ActionInstrumentor<C extends ProbeConfiguration>	An instrumentor for actions.
Activator
InstrumentorBuilder	A builder for Instrumentors.
InstrumentorInstantiator<S,M>	Creates Instrumentors dealing with elements of the simulation engine.
InstrumentorSEMBuilder<M>	Lets the user decide if the created instrumentor should deal with model elements or with the actual implementation of the model elements.
InstrumentorWrapper<S,M,C extends ProbeConfiguration>	Wraps an instrumentor which is dealing with elements of the instrumentation description and represents an instrumentor dealing with elements of the simulation engine.
MappinglessInstrumentorInstantiator<M>	Creates Instrumentors dealing directly with elements of the instrumentation description.
ResourceInstrumentor<R,C extends ProbeConfiguration>	An instrumentor for resources.
SEMPair<S,M>	Represents a pair of a simulation element and a model element.
UserActionInstrumentor<C extends ProbeConfiguration>	An instrumentor for user actions.