- /*
- * @(#)TraceDestination.java 1.14 03/12/19
- *
- * Copyright 2004 Sun Microsystems, Inc. All rights reserved.
- * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
- */
- package com.sun.jmx.trace;
-
- import java.io.IOException;
-
- /**
- * Defines the methods that a trace destination must implement.
- *
- * @since 1.5
- * @since.unbundled JMX RI 1.2
- */
- public interface TraceDestination {
-
- /**
- * Verify whether the specified info level and the info type are
- * selected by a listener.
- *
- * <P>It is strongly recommended to call this method before sending
- * information to this Trace class.
- *
- * @param level the level of trace information.
- * @param type the type of the trace information.
- */
- public boolean isSelected(int level, int type);
-
- /**
- * Send a new information to this Trace destination
- *
- * @param level the level of trace information to be sent.
- * @param type the type of trace information to be sent.
- * @param className the name of the class from which the trace
- * information is from.
- * @param methodName the name of the method from which the trace
- * information is from.
- * @param info the trace information to be sent.
- * @return false if the level and the type are not selected.
- */
- public boolean send(int level,
- int type,
- String className,
- String methodName,
- String info);
-
- /**
- * Send an exception to this Trace class.
- *
- * @param level the level of trace information to be sent.
- * @param type the type of trace information to be sent.
- * @param className the name of the class from which the trace
- * information is from.
- * @param methodName the name of the method from which the trace
- * information is from.
- * @param exception exception sent as the trace information.
- */
- public boolean send(int level,
- int type,
- String className,
- String methodName,
- Throwable exception);
-
- /**
- * Reset the trace destination.
- * The behaviour of this method is implementation dependent.
- * It could be used, for instance, to (re)initialize the traces
- * according to some default System properties, or to flush
- * (empty) the log file, etc...
- **/
- public void reset() throws IOException;
- }
-