org.apache.uima.util.impl
Class JSR47Logger_impl

java.lang.Object
  extended by org.apache.uima.util.impl.JSR47Logger_impl
All Implemented Interfaces:
Logger

public class JSR47Logger_impl
extends java.lang.Object
implements Logger

UIMA Logging interface implementation for Java Logging Toolkit JSR-47 (JDK 1.4)


Method Summary
static Logger getInstance()
          Creates a new JSR47Logger instance with the default JSR-47 framework logger
static Logger getInstance(java.lang.Class<?> component)
          Creates a new JSR47Logger instance for the specified source class
 boolean isLoggable(Level level)
          Checks if the argument level is greater or equal to the specified level
 void log(Level level, java.lang.String aMessage)
          Logs a message.
 void log(Level level, java.lang.String aMessage, java.lang.Object param1)
          Logs a message with one parameter
 void log(Level level, java.lang.String aMessage, java.lang.Object[] params)
          Logs a message with an arbitrary number of parameters
 void log(Level level, java.lang.String aMessage, java.lang.Throwable thrown)
          Logs a message and a throwable object
 void log(java.lang.String aMessage)
          Deprecated. use new function with log level
 void log(java.lang.String aResourceBundleName, java.lang.String aMessageKey, java.lang.Object[] aArguments)
          Deprecated. use new function with log level
 void logException(java.lang.Exception aException)
          Deprecated. use new function with log level
 void logrb(Level level, java.lang.String sourceClass, java.lang.String sourceMethod, java.lang.String bundleName, java.lang.String msgKey)
          Logs a message with a message key.
 void logrb(Level level, java.lang.String sourceClass, java.lang.String sourceMethod, java.lang.String bundleName, java.lang.String msgKey, java.lang.Object param1)
          Logs a message with a message key and one parameter.
 void logrb(Level level, java.lang.String sourceClass, java.lang.String sourceMethod, java.lang.String bundleName, java.lang.String msgKey, java.lang.Object[] params)
          Logs a message with a message key and an arbitrary number of parameters.
 void logrb(Level level, java.lang.String sourceClass, java.lang.String sourceMethod, java.lang.String bundleName, java.lang.String msgKey, java.lang.Throwable thrown)
          Logs a message with a message key and a throwable object.
 void setLevel(Level level)
          Sets the level of messages that will be logged by this logger.
 void setOutputStream(java.io.OutputStream out)
          Deprecated. use external configuration possibility
 void setOutputStream(java.io.PrintStream out)
          Deprecated. use external configuration possibility
 void setResourceManager(ResourceManager resourceManager)
          Sets the ResourceManager to use for message localization.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

getInstance

public static Logger getInstance(java.lang.Class<?> component)
Creates a new JSR47Logger instance for the specified source class

Parameters:
component - current source class
Returns:
Logger returns the JSR47Logger object for the specified class

getInstance

public static Logger getInstance()
Creates a new JSR47Logger instance with the default JSR-47 framework logger

Returns:
Logger returns the JSR47Logger object with the default JSR-47 framework logger

log

@Deprecated
public void log(java.lang.String aMessage)
Deprecated. use new function with log level

Logs a message with level INFO.

Specified by:
log in interface Logger
Parameters:
aMessage - the message to be logged

log

@Deprecated
public void log(java.lang.String aResourceBundleName,
                           java.lang.String aMessageKey,
                           java.lang.Object[] aArguments)
Deprecated. use new function with log level

Logs a message with a message key and the level INFO

Specified by:
log in interface Logger
Parameters:
aResourceBundleName - base name of resource bundle
aMessageKey - key of message to localize with message level INFO
aArguments - arguments to message (may be null if none)
See Also:
Logger.log(java.lang.String, java.lang.String, java.lang.Object[])

logException

@Deprecated
public void logException(java.lang.Exception aException)
Deprecated. use new function with log level

Logs an exception with level INFO

Specified by:
logException in interface Logger
Parameters:
aException - the exception to be logged

setOutputStream

@Deprecated
public void setOutputStream(java.io.OutputStream out)
Deprecated. use external configuration possibility

Description copied from interface: Logger
Sets the output stream to which log messages will go. Setting the output stream to null will disable the logger.

Specified by:
setOutputStream in interface Logger
Parameters:
out - OutputStream to which log messages will be printed
See Also:
Logger.setOutputStream(java.io.OutputStream)

setOutputStream

@Deprecated
public void setOutputStream(java.io.PrintStream out)
Deprecated. use external configuration possibility

Description copied from interface: Logger
Sets the output stream to which log messages will go. Setting the output stream to null will disable the logger.

Specified by:
setOutputStream in interface Logger
Parameters:
out - PrintStream to which log messages will be printed
See Also:
Logger.setOutputStream(java.io.PrintStream)

isLoggable

public boolean isLoggable(Level level)
Description copied from interface: Logger
Checks if the argument level is greater or equal to the specified level

Specified by:
isLoggable in interface Logger
Parameters:
level - message level
Returns:
boolean - true if the argument level is greater or equal to the specified level

setLevel

public void setLevel(Level level)
Description copied from interface: Logger
Sets the level of messages that will be logged by this logger. Note that if you call UIMAFramework.getLogger().setLevel(level), this will only change the logging level for messages produced by the UIMA framework. It will NOT change the logging level for messages produced by annotators. To change the logging level for an annotator, use UIMAFramework.getLogger(YourAnnotatorClass.class).setLevel(level).

If you need more flexibilty it configuring the logger, consider using the standard Java logger properties file or the java.util.logging APIs.

Specified by:
setLevel in interface Logger
Parameters:
level - message level

log

public void log(Level level,
                java.lang.String aMessage)
Description copied from interface: Logger
Logs a message.

Specified by:
log in interface Logger
Parameters:
level - message level
aMessage - the message to be logged

log

public void log(Level level,
                java.lang.String aMessage,
                java.lang.Object param1)
Description copied from interface: Logger
Logs a message with one parameter

Specified by:
log in interface Logger
Parameters:
level - message level
aMessage - the message to be logged
param1 - message parameter

log

public void log(Level level,
                java.lang.String aMessage,
                java.lang.Object[] params)
Description copied from interface: Logger
Logs a message with an arbitrary number of parameters

Specified by:
log in interface Logger
Parameters:
level - message level
aMessage - the message to be logged
params - message parameter array

log

public void log(Level level,
                java.lang.String aMessage,
                java.lang.Throwable thrown)
Description copied from interface: Logger
Logs a message and a throwable object

Specified by:
log in interface Logger
Parameters:
level - message level
aMessage - the message to be logged
thrown - throwable object

logrb

public void logrb(Level level,
                  java.lang.String sourceClass,
                  java.lang.String sourceMethod,
                  java.lang.String bundleName,
                  java.lang.String msgKey,
                  java.lang.Object param1)
Description copied from interface: Logger
Logs a message with a message key and one parameter. The real message is extracted from a resource bundle.

Specified by:
logrb in interface Logger
Parameters:
level - message level
sourceClass - source class name
sourceMethod - source method name
bundleName - resource bundle
msgKey - message key
param1 - message parameter

logrb

public void logrb(Level level,
                  java.lang.String sourceClass,
                  java.lang.String sourceMethod,
                  java.lang.String bundleName,
                  java.lang.String msgKey,
                  java.lang.Object[] params)
Description copied from interface: Logger
Logs a message with a message key and an arbitrary number of parameters. The real message is extracted from a resource bundle.

Specified by:
logrb in interface Logger
Parameters:
level - message level
sourceClass - source class name
sourceMethod - source method name
bundleName - resource bundle
msgKey - message key
params - message parameter array with an arbitrary number of parameters

logrb

public void logrb(Level level,
                  java.lang.String sourceClass,
                  java.lang.String sourceMethod,
                  java.lang.String bundleName,
                  java.lang.String msgKey,
                  java.lang.Throwable thrown)
Description copied from interface: Logger
Logs a message with a message key and a throwable object. The real message is extracted from a resource bundle.

Specified by:
logrb in interface Logger
Parameters:
level - message level
sourceClass - source class name
sourceMethod - source method name
bundleName - resource bundle
msgKey - message key
thrown - throwable object

logrb

public void logrb(Level level,
                  java.lang.String sourceClass,
                  java.lang.String sourceMethod,
                  java.lang.String bundleName,
                  java.lang.String msgKey)
Description copied from interface: Logger
Logs a message with a message key. The real message is extracted from a resource bundle.

Specified by:
logrb in interface Logger
Parameters:
level - message level
sourceClass - source class name
sourceMethod - source method name
bundleName - resource bundle
msgKey - message key

setResourceManager

public void setResourceManager(ResourceManager resourceManager)
Description copied from interface: Logger
Sets the ResourceManager to use for message localization. This method is intended for use by the framework, not by user code.

Specified by:
setResourceManager in interface Logger
Parameters:
resourceManager - A resource manager instance whose extension ClassLoader (if any) will be used for message localization by this logger.


Copyright © 2010 The Apache Software Foundation. All Rights Reserved.