/*
*
* Copyright (c) 2007, 2012, Oracle and/or its affiliates. All rights reserved.
* ORACLE PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
*/
package com.sun.jmx.trace;
// java import
//
import java.util.Properties;
import java.util.ArrayList;
import java.util.HashMap;
import java.io.IOException;
import sun.misc.JavaAWTAccess;
import sun.misc.SharedSecrets;
/**
* Sends trace to a pluggable destination.
*
* @since 1.5
*/
@Deprecated
public final class Trace implements TraceTags {
private static TraceDestination out;
// private constructor defined to "hide" the default public constructor
private Trace() {
}
// Method used to test if the implementation of TraceDestination which relies
// on the java.util.logging API (com.sun.jmx.trace.TraceManager) can be used
// to initialize the trace destination. This is the case iff. we are running
// J2SE 1.4 or higher. Otherwise, the trace destination is null, and needs to
// be later initialized if we want to see traces !
//
private static TraceDestination initDestination()
{
// Attempt to locate class java.util.logging.LogManager
//
try
{
Class.forName("java.util.logging.LogManager");
// Class could be loaded, use a new instance of TraceManager as the trace
// destination
//
return new TraceManager();
}
catch (ClassNotFoundException e)
{
// Class could not be loaded, means that we are running J2SE 1.3 or below.
//
return null;
}
}
// --------------
// public methods
// --------------
/**
* Set the trace destination.
**/
public static synchronized void setDestination(TraceDestination output) {
JavaAWTAccess javaAWTAccess = SharedSecrets.getJavaAWTAccess();
if (javaAWTAccess == null) {
out = output; // Store the output object in the static field
} else {
// Store the output object in the appContext
javaAWTAccess.put(TraceDestination.class, output);
}
}
/**
* 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
* an information to this Trace class.
*
* @param level the level of trace information.
* @param type the type of the trace information.
*/
public static boolean isSelected(int level, int type) {
final TraceDestination output = out();
if (output != null) return output.isSelected(level,type);
return false;
}
/**
* Send a new information 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 info the trace information to be sent.
* @return false if the level and the type are not selected.
*/
public static boolean send(int level,
int type,
String className,
String methodName,
String info) {
final TraceDestination output = out();
if (output == null) return false;
if (!(output.isSelected(level, type))) return false;
return output.send(level,type,className,methodName,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 static boolean send(int level,
int type,
String className,
String methodName,
Throwable exception) {
final TraceDestination output = out();
if (output == null) return false;
if (!(output.isSelected(level, type))) return false;
return output.send(level,type,className,methodName,exception);
}
/**
* Logs a warning message.
* This is equivalent to
* <code>Logger.getLogger(loggerName).warning(msg);</code>
* This method is a hack for backward compatibility with J2SE 1.3.
*
**/
public static void warning(String loggerName, String msg) {
final TraceDestination output = out();
if (output instanceof TraceManager)
// Log a warning message
((TraceManager)output).warning(loggerName,msg);
else if (output != null)
// Best effort
output.send(LEVEL_TRACE,INFO_MISC,null,null,msg);
}
/**
* Logs a fine message.
* This is equivalent to
* <code>Logger.getLogger(loggerName).fine(msg);</code>
* This method is a hack for backward compatibility with J2SE 1.3.
*
**/
public static void fine(String loggerName, String msg) {
final TraceDestination output = out();
if (output instanceof TraceManager)
// Log a fine message
((TraceManager)output).fine(loggerName,msg);
else if (output != null)
// Best effort
output.send(LEVEL_TRACE,INFO_MISC,null,null,msg);
}
/**
* Return the trace destination.
**/
private static synchronized TraceDestination out() {
JavaAWTAccess javaAWTAccess = SharedSecrets.getJavaAWTAccess();
if (javaAWTAccess == null) {
if (out == null) {
// First time: create the output object and store in the static field
out = initDestination();
}
return out; // Get the output object from the static field
}
// Get the output object from the appContext
TraceDestination output = (TraceDestination)javaAWTAccess.get(TraceDestination.class);
if (output == null) {
// First time: create the output object and store in the appContext
output = initDestination();
javaAWTAccess.put(TraceDestination.class, output);
}
return output;
}
}