org.gridgain.grid.logger.jcl
Class GridJclLogger

java.lang.Object
  org.gridgain.grid.lang.GridMetadataAwareAdapter
      org.gridgain.grid.logger.jcl.GridJclLogger

All Implemented Interfaces:

Serializable, Cloneable, GridMetadataAware, GridLogger

public class GridJclLogger
extends GridMetadataAwareAdapter
implements GridLogger

This logger wraps any JCL (Jakarta Commons Logging) loggers. Implementation simply delegates to underlying JCL logger. This logger should be used by loaders that have JCL-based internal logging (e.g., Websphere).

Here is an example of configuring JCL logger in GridGain configuration Spring file to work over log4j implementation. Note that we use the same configuration file as we provide by default:

      ...
      <property name="gridLogger">
          <bean class="org.gridgain.grid.logger.jcl.GridJclLogger">
              <constructor-arg type="org.apache.commons.logging.Log">
                  <bean class="org.apache.commons.logging.impl.Log4JLogger">
                      <constructor-arg type="java.lang.String" value="config/default-log4j.xml"/>
                  </bean>
              </constructor-arg>
          </bean>
      </property>
      ...
 

If you are using system properties to configure JCL logger use following configuration:

      ...
      <property name="gridLogger">
          <bean class="org.gridgain.grid.logger.jcl.GridJclLogger"/>
      </property>
      ...
 

And the same configuration if you'd like to configure GridGain in your code:

      GridConfiguration cfg = new GridConfigurationAdapter();
      ...
      GridLogger log = new GridJclLogger(new Log4JLogger("config/default-log4j.xml"));
      ...
      cfg.setGridLogger(log);
 

or following for the configuration by means of system properties:

      GridConfiguration cfg = new GridConfigurationAdapter();
      ...
      GridLogger log = new GridJclLogger();
      ...
      cfg.setGridLogger(log);
 

Please take a look at GridLoggerResource annotation about logger injection.

Wiki & Forum:

Wiki
Forum

See Also:

Serialized Form

Constructor Summary

GridJclLogger()
Creates new logger.

GridJclLogger(org.apache.commons.logging.Log impl)
Creates new logger with given implementation.

Method Summary

void	debug(String msg) Logs out debug message.
void	error(String msg) Logs out error message.
void	error(String msg, Throwable e) Logs error message with optional exception.
GridLogger	getLogger(Object ctgr) Creates new logger with given category based off the current instance.
void	info(String msg) Logs out information message.
boolean	isDebugEnabled() Tests whether debug level is enabled.
boolean	isInfoEnabled() Tests whether info level is enabled.
boolean	isQuiet() Tests whether info and debug levels are turned off.
void	warning(String msg) Logs out warning message.
void	warning(String msg, Throwable e) Logs out warning message with optional exception.

Methods inherited from class org.gridgain.grid.lang.GridMetadataAwareAdapter

addMeta, addMetaIfAbsent, addMetaIfAbsent, allMeta, clone, copyMeta, copyMeta, hasMeta, hasMeta, meta, putMetaIfAbsent, putMetaIfAbsent, readExternalMeta, removeMeta, removeMeta, replaceMeta, writeExternalMeta

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.gridgain.grid.GridMetadataAware

addMeta, addMetaIfAbsent, addMetaIfAbsent, allMeta, copyMeta, copyMeta, hasMeta, hasMeta, meta, putMetaIfAbsent, putMetaIfAbsent, removeMeta, removeMeta, replaceMeta

Constructor Detail

GridJclLogger

public GridJclLogger()

Creates new logger.

GridJclLogger

public GridJclLogger(org.apache.commons.logging.Log impl)

Creates new logger with given implementation.

Parameters:

impl - JCL implementation to use.

Method Detail

getLogger

public GridLogger getLogger(Object ctgr)

Creates new logger with given category based off the current instance.

Specified by:

getLogger in interface GridLogger

Parameters:

ctgr - Category for new logger.

Returns:

New logger with given category.

debug

public void debug(String msg)

Logs out debug message.

Specified by:

debug in interface GridLogger

Parameters:

msg - Debug message.

info

public void info(String msg)

Logs out information message.

Specified by:

info in interface GridLogger

Parameters:

msg - Information message.

warning

public void warning(String msg)

Logs out warning message.

Specified by:

warning in interface GridLogger

Parameters:

msg - Warning message.

warning

public void warning(String msg,
                    @Nullable
                    Throwable e)

Logs out warning message with optional exception.

Specified by:

warning in interface GridLogger

Parameters:

msg - Warning message.

e - Optional exception (can be null).

error

public void error(String msg)

Logs out error message.

Specified by:

error in interface GridLogger

Parameters:

msg - Error message.

isQuiet

public boolean isQuiet()

Tests whether info and debug levels are turned off.

Specified by:

isQuiet in interface GridLogger

Returns:

Whether info and debug levels are turned off.

error

public void error(String msg,
                  @Nullable
                  Throwable e)

Logs error message with optional exception.

Specified by:

error in interface GridLogger

Parameters:

msg - Error message.

e - Optional exception (can be null).

isDebugEnabled

public boolean isDebugEnabled()

Tests whether debug level is enabled.

Specified by:

isDebugEnabled in interface GridLogger

Returns:

true in case when debug level is enabled, false otherwise.

isInfoEnabled

public boolean isInfoEnabled()

Tests whether info level is enabled.

Specified by:

isInfoEnabled in interface GridLogger

Returns:

true in case when info level is enabled, false otherwise.