com.ibm.websphere.ras.annotation

Annotation Type TraceOptions



  • @Retention(value=RUNTIME)
    @Target(value={TYPE,PACKAGE})
    public @interface TraceOptions
    The 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.
    or:
     @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.
    • Element Detail

      • traceGroup

        public abstract java.lang.String traceGroup
        Default:
        ""
      • traceGroups

        public abstract java.lang.String[] traceGroups
        Default:
        {}
      • messageBundle

        public abstract java.lang.String messageBundle
        Default:
        ""
      • traceExceptionThrow

        public abstract boolean traceExceptionThrow
        Default:
        false
      • traceExceptionHandling

        public abstract boolean traceExceptionHandling
        Default:
        false