com.opencloud.rhino.management.trace

Interface TraceMBean

All Superinterfaces:

TraceMBean

public interface TraceMBean
extends TraceMBean

Field Summary

Fields inherited from interface javax.slee.management.TraceMBean

OBJECT_NAME, TRACE_NOTIFICATION_TYPE

Method Summary

Modifier and Type	Method and Description
String	getLogkeyForTracer(NotificationSource notificationSource, String tracerName) Tracers may be treated as loggers for the purposes of adding filters and logging appenders.
Level	getTraceLevel(ComponentID id)
TraceLevel	getTraceLevel(NotificationSource notificationSource, String tracerName)
String[]	getTracersSet(NotificationSource notificationSource)
String[]	getTracersUsed(NotificationSource notificationSource)

Methods inherited from interface javax.slee.management.TraceMBean

setTraceLevel, setTraceLevel, unsetTraceLevel

Method Detail

getTraceLevel

Level getTraceLevel(ComponentID id)
             throws NullPointerException,
                    UnrecognizedComponentException,
                    ManagementException

Specified by:

getTraceLevel in interface TraceMBean

Throws:

NullPointerException

UnrecognizedComponentException

ManagementException

getTracersUsed

String[] getTracersUsed(NotificationSource notificationSource)
                 throws NullPointerException,
                        UnrecognizedNotificationSourceException,
                        ManagementException

Specified by:

getTracersUsed in interface TraceMBean

Throws:

NullPointerException

UnrecognizedNotificationSourceException

ManagementException

getTracersSet

String[] getTracersSet(NotificationSource notificationSource)
                throws NullPointerException,
                       UnrecognizedNotificationSourceException,
                       ManagementException

Specified by:

getTracersSet in interface TraceMBean

Throws:

NullPointerException

UnrecognizedNotificationSourceException

ManagementException

getTraceLevel

TraceLevel getTraceLevel(NotificationSource notificationSource,
                         String tracerName)
                  throws NullPointerException,
                         InvalidArgumentException,
                         UnrecognizedNotificationSourceException,
                         ManagementException

Specified by:

getTraceLevel in interface TraceMBean

Throws:

NullPointerException

InvalidArgumentException

UnrecognizedNotificationSourceException

ManagementException

getLogkeyForTracer

String getLogkeyForTracer(NotificationSource notificationSource,
                          String tracerName)
                   throws InvalidArgumentException,
                          UnrecognizedNotificationSourceException,
                          ManagementException

Tracers may be treated as loggers for the purposes of adding filters and logging appenders. By default Rhino abbreviates Tracer owned logkeys. Logging management operations require the full logkey to operate on. In order to support managing Tracers in this way this method returns the full logkey used by a given Tracer

Parameters:

notificationSource - the notification source.

tracerName - the name of the tracer for which the effective trace level should be obtained. The empty string denotes the root tracer.

Returns:

The full logkey matching the Tracer uniquely identified by notificationSource and tracerName

Throws:

NullPointerException - if any argument is null.

UnrecognizedNotificationSourceException - if notificationSource does not identify a notification source recognizable by the SLEE.

InvalidArgumentException - if tracerName is not a valid tracer name.

ManagementException - if the trace logkey could not be obtained due to a system-level failure.

Since:

Rhino 2.6