de.uni_hildesheim.sse.monitoring.runtime.annotations

Annotation Type ConfigurationChange

@Retention(value=RUNTIME)
 @Target(value={METHOD,CONSTRUCTOR})
public @interface ConfigurationChange

Annotates a method or constructor which is responsible for executing a configuration change. Configuration changes may be detected automatically (see agent configuration) or defined at a certain point of execution (which usually adds more precision to the monitoring results. If automatic configuration detection is deactivated, this annotation deactivates VariabilityHandler on the same constructor or method.

Since:

1.00

Version:

1.00

Author:

Holger Eichelberger

Required Element Summary

Required Elements

Modifier and Type	Required Element and Description
java.lang.String	valueExpression A programming language expression which determines the configuration.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
java.lang.String	idExpression A fixed id denoting the new configuration.

Element Detail

valueExpression

public abstract java.lang.String valueExpression

A programming language expression which determines the configuration. The parameters are denoted as $1, ..., $n with $0 as this for instance methods nor null for static methods. Currently, we require only method calls to be supported - calculations can be done in static methods being excluded from monitoring.

Returns:

the value expression

Since:

1.00

idExpression

public abstract java.lang.String idExpression

A fixed id denoting the new configuration. If not empty, it overrides the valueExpression().

Returns:

the id expression, none if empty

Since:

1.00

Default:

""