@Retention(value=RUNTIME)
@Target(value={TYPE,PACKAGE})
public @interface TraceOptions
TraceOptions annotation can be used to declare which trace
group a class (or classes in a package) should be asociated with. The
annotation can also be used to declare whether or not debug traces should be
cut when exceptions are explicitly thrown or caught.
For example:
@TraceOptions(traceGroup = "MyTraceGroup", traceExceptionThrow = true)
public class Foo
{}
will associate the class Foo with the MyTraceGroup
trace group and will cause debug traces to be added whenever an exception is
explicitly thrown.
@TraceOptions(traceGroups = { "BarGroup", "FooGroup" }, messageBundle = "com.ibm.bar")
public class Bar
{}
will associate the class Bar with the trace groups
BarGroup and FooGroup if the underlying trace
runtime supports multiple groups. If not, only the first trace group listed
will be used. The message bundle "com.ibm.bar" will be used for messages.| Modifier and Type | Optional Element and Description |
|---|---|
java.lang.String |
messageBundle |
boolean |
traceExceptionHandling |
boolean |
traceExceptionThrow |
java.lang.String |
traceGroup |
java.lang.String[] |
traceGroups |
public abstract java.lang.String traceGroup
public abstract java.lang.String[] traceGroups
public abstract java.lang.String messageBundle
public abstract boolean traceExceptionThrow
public abstract boolean traceExceptionHandling