oracle.adfnmc.util.logging
Class Trace

java.lang.Object
  oracle.adfnmc.util.logging.Trace

public class Trace
extends java.lang.Object

Trace facility. Uses Java ME port of java.util.logging under the covers. Logging is completely configurable either from code or from a JAD file.

Author:

PARACHAN

Field Summary

static java.lang.String	BINDINGS_LOGNAME
static java.lang.Class	CLASS_INSTANCE
static java.lang.String	MODEL_LOGNAME
static java.lang.String	PROFILING_LOGNAME
static java.lang.String	ROOT_LOGNAME
static java.lang.String	SCANNER_LOGNAME
static java.lang.String	SCANNERDC_LOGNAME
static java.lang.String	TEST_LOGNAME
static java.lang.String	TRSDC_LOGNAME
static java.lang.String	UI_LOGNAME
static java.lang.String	UTIL_LOGNAME

Constructor Summary

Trace()

Method Summary

static void	close() Close all the handlers associated with each logger
static void	configure() Configure logging via the application's JAD file
static void	debug(java.lang.Object message)
static void	disable() Disable all log output
static void	enable() Enable logging
static void	error(java.lang.Object message)
static void	fatal(java.lang.Object message)
static void	info(java.lang.Object message)
static void	initPalmReporter() If the app is running on a physical Blackberry device, this method MUST be called from the application's EVENT thread in order to have the PalmReporter output channel available for logging.
static void	log(java.lang.String loggerName, java.lang.Class callingClass, java.lang.String methodName, AdfNmcException t) Log an AdfNmcException via java.util.logging.
static void	log(java.lang.String loggerName, java.lang.Class callingClass, java.lang.String methodName, java.lang.Throwable t) Log a Throwable via java.util.logging
static void	log(java.lang.String loggerName, Level priority, java.lang.Class callingClass, java.lang.String callingMethod, java.lang.Class resourceBundle, java.lang.String resourceKey) Log a message contained in a ResourceBundle
static void	log(java.lang.String loggerName, Level priority, java.lang.Class callingClass, java.lang.String callingMethod, java.lang.Class bundleClass, java.lang.String resourceKey, java.lang.Object[] params) Log a message contained in a ResourceBundle
static void	log(java.lang.String loggerName, Level priority, java.lang.Class callingClass, java.lang.String methodName, java.lang.Object msg) Log a message via java.util.logging
static void	log(java.lang.String loggerName, Level priority, java.lang.Class callingClass, java.lang.String callingMethod, ResourceBundle resourceBundle, java.lang.String resourceKey) Log a message contained in a ResourceBundle
static void	log(java.lang.String loggerName, Level priority, java.lang.Class callingClass, java.lang.String callingMethod, ResourceBundle resourceBundle, java.lang.String resourceKey, java.lang.Object[] params) Log a message contained in a ResourceBundle
static void	log(java.lang.String loggerName, Level priority, java.lang.Class callingClass, java.lang.String methodName, java.lang.String msg, java.lang.Object[] params) Log an optionally formatted message string via java.util.logging
static void	log(java.lang.String loggerName, Level priority, java.lang.Class callingClass, java.lang.String callingMethod, java.lang.String bundleName, java.lang.String resourceKey, java.lang.Object[] params) Log a message contained in a ResourceBundle
static void	log(java.lang.String loggerName, Level priority, java.lang.Class callingClass, java.lang.String methodName, java.lang.Throwable t)
static void	logForTest(java.lang.Class callingClass, java.lang.String methodName, java.lang.String msg, java.lang.Object[] params)
static void	println()
static void	println(java.lang.Object message)
static void	profiling(java.lang.Object message) Send a message with priority INFO to the profiling-specific logger
static void	warn(java.lang.Object message)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

CLASS_INSTANCE

public static final java.lang.Class CLASS_INSTANCE

UI_LOGNAME

public static final java.lang.String UI_LOGNAME

See Also:

Constant Field Values

MODEL_LOGNAME

public static final java.lang.String MODEL_LOGNAME

See Also:

Constant Field Values

BINDINGS_LOGNAME

public static final java.lang.String BINDINGS_LOGNAME

See Also:

Constant Field Values

PROFILING_LOGNAME

public static final java.lang.String PROFILING_LOGNAME

See Also:

Constant Field Values

SCANNER_LOGNAME

public static final java.lang.String SCANNER_LOGNAME

See Also:

Constant Field Values

SCANNERDC_LOGNAME

public static final java.lang.String SCANNERDC_LOGNAME

See Also:

Constant Field Values

TRSDC_LOGNAME

public static final java.lang.String TRSDC_LOGNAME

See Also:

Constant Field Values

UTIL_LOGNAME

public static final java.lang.String UTIL_LOGNAME

See Also:

Constant Field Values

TEST_LOGNAME

public static final java.lang.String TEST_LOGNAME

See Also:

Constant Field Values

ROOT_LOGNAME

public static final java.lang.String ROOT_LOGNAME

Constructor Detail

Trace

public Trace()

Method Detail

println

public static final void println()

println

public static final void println(java.lang.Object message)

debug

public static final void debug(java.lang.Object message)

info

public static final void info(java.lang.Object message)

warn

public static final void warn(java.lang.Object message)

error

public static final void error(java.lang.Object message)

fatal

public static final void fatal(java.lang.Object message)

profiling

public static final void profiling(java.lang.Object message)

Send a message with priority INFO to the profiling-specific logger

Parameters:

message -

configure

public static final void configure()

Configure logging via the application's JAD file

close

public static final void close()

Close all the handlers associated with each logger

logForTest

public static final void logForTest(java.lang.Class callingClass,
                                    java.lang.String methodName,
                                    java.lang.String msg,
                                    java.lang.Object[] params)

log

public static final void log(java.lang.String loggerName,
                             Level priority,
                             java.lang.Class callingClass,
                             java.lang.String methodName,
                             java.lang.Object msg)

Log a message via java.util.logging

Parameters:

loggerName - Name of logger.

priority - e.g. Level.INFO

callingClass - Class object for calling class

methodName - Name of method making the call

msg - An Object to print via its toString() method

log

public static final void log(java.lang.String loggerName,
                             Level priority,
                             java.lang.Class callingClass,
                             java.lang.String methodName,
                             java.lang.Throwable t)

log

public static final void log(java.lang.String loggerName,
                             java.lang.Class callingClass,
                             java.lang.String methodName,
                             java.lang.Throwable t)

Log a Throwable via java.util.logging

Parameters:

loggerName -

callingClass -

methodName -

t -

log

public static final void log(java.lang.String loggerName,
                             java.lang.Class callingClass,
                             java.lang.String methodName,
                             AdfNmcException t)

Log an AdfNmcException via java.util.logging. Shouldn't need this, as AdfNmcException dervives from Throwable, but RAPC complains with verification errors if this overload doesn't exist.

Parameters:

loggerName -

callingClass -

methodName -

t -

log

public static final void log(java.lang.String loggerName,
                             Level priority,
                             java.lang.Class callingClass,
                             java.lang.String callingMethod,
                             java.lang.Class bundleClass,
                             java.lang.String resourceKey,
                             java.lang.Object[] params)

Log a message contained in a ResourceBundle

Parameters:

loggerName -

priority -

callingClass -

callingMethod -

bundleClass -

resourceKey -

params -

log

public static final void log(java.lang.String loggerName,
                             Level priority,
                             java.lang.Class callingClass,
                             java.lang.String callingMethod,
                             java.lang.String bundleName,
                             java.lang.String resourceKey,
                             java.lang.Object[] params)

Log a message contained in a ResourceBundle

Parameters:

loggerName -

priority -

callingClass -

callingMethod -

bundleName -

resourceKey -

params -

log

public static final void log(java.lang.String loggerName,
                             Level priority,
                             java.lang.Class callingClass,
                             java.lang.String callingMethod,
                             ResourceBundle resourceBundle,
                             java.lang.String resourceKey)

Log a message contained in a ResourceBundle

Parameters:

loggerName -

priority -

callingClass -

callingMethod -

resourceBundle -

resourceKey -

log

public static final void log(java.lang.String loggerName,
                             Level priority,
                             java.lang.Class callingClass,
                             java.lang.String callingMethod,
                             ResourceBundle resourceBundle,
                             java.lang.String resourceKey,
                             java.lang.Object[] params)

Log a message contained in a ResourceBundle

Parameters:

loggerName -

priority -

callingClass -

callingMethod -

resourceBundle -

resourceKey -

params -

log

public static final void log(java.lang.String loggerName,
                             Level priority,
                             java.lang.Class callingClass,
                             java.lang.String callingMethod,
                             java.lang.Class resourceBundle,
                             java.lang.String resourceKey)

Log a message contained in a ResourceBundle

Parameters:

loggerName -

priority -

callingClass -

callingMethod -

resourceBundle -

resourceKey -

log

public static final void log(java.lang.String loggerName,
                             Level priority,
                             java.lang.Class callingClass,
                             java.lang.String methodName,
                             java.lang.String msg,
                             java.lang.Object[] params)

Log an optionally formatted message string via java.util.logging

Parameters:

loggerName -

priority -

callingClass -

methodName -

msg -

params -

disable

public static final void disable()

Disable all log output

enable

public static final void enable()

Enable logging

initPalmReporter

public static final void initPalmReporter()

If the app is running on a physical Blackberry device, this method MUST be called from the application's EVENT thread in order to have the PalmReporter output channel available for logging. Easiest way to do this is just invoke it in the app's main screen's constructor. Invoking it on other platforms, e.g. Blackberry simulator or Windows Mobile is safe but has no effect, as PalmReporter is already correctly initialized via Utility.init().