Package org.exoplatform.services.log

Class ExoLogger

java.lang.Object

org.exoplatform.services.log.ExoLogger

public abstract class ExoLogger
extends Object

The logger definition for exo platform.

ExoLogger it's wrapping factory for different Log factories existing in runtime for eXo.
The logger implements the Log interface for backward compatibility purpose.

This class is also the way to obtain a reference to a logger through the static methods getExoLogger(String) and getExoLogger(Class) .

The factory methods delegates to an instance of ExoLogFactory that is determined by the following rules

• A static instance is used and by default the static instance is assigned with an instance of the class SLF4JExoLogFactory. It is possible to change the instance at runtime by calling the static method setFactory(ExoLogFactory).
• If the static instance fails to deliver a logger at runtime due to a NoClassDefFoundError then a factory instance of class SimpleExoLogFactory is used for fail over.

Constructor Summary

Constructors

Constructor	Description
ExoLogger()

Method Summary

Modifier and Type	Method	Description
static Log	getExoLogger(Class name)	Returns a specified logger.
static Log	getExoLogger(String name)	Returns a specified logger.
static Log	getLogger(Class name)	Use instead getExoLogger(Class).
static Log	getLogger(String name)	Use instead getExoLogger(String).
static void	setFactory(ExoLogFactory factory)	Configures the exo logger factory.

Methods inherited from class java.lang.Object

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

Constructor Details

ExoLogger

public ExoLogger()

Method Details

setFactory

public static void setFactory(ExoLogFactory factory)
                       throws IllegalArgumentException

Configures the exo logger factory. This method can be called multiple times to replace the current static instance.

Parameters:

factory - ExoLogFactory, the new factory

Throws:

IllegalArgumentException - when the factory is null

getLogger

public static Log getLogger(String name)

Use instead getExoLogger(String).

Parameters:

name - String, the logger name

Returns:

the logger

getLogger

public static Log getLogger(Class name)

Use instead getExoLogger(Class).

Parameters:

name - Class, the logger name

Returns:

the logger

getExoLogger

public static Log getExoLogger(String name)
                        throws IllegalArgumentException

Returns a specified logger.

Parameters:

name - the logger name

Returns:

the logger

Throws:

IllegalArgumentException - if the name is null

getExoLogger

public static Log getExoLogger(Class name)
                        throws IllegalArgumentException

Returns a specified logger.

Parameters:

name - the logger name

Returns:

the logger

Throws:

IllegalArgumentException - if the name is null