org.objectweb.util.monolog.wrapper.remote.api
Interface MonologFactoryMBean

public interface MonologFactoryMBean

Defines a MBean for managing the 3 Monolog concepts: Logger, Handler and Level

Author:

S.Chassande-Barrioz

See Also:

LoggerInfo

Method Summary

void	addHandlerToLogger(String handlerName, String loggerName) A TopicalLogger manages a list of Handler instances.
void	addTopicToLogger(String topic, String loggerName) This method allows adding a topic to a TopicalLogger.
int	compareTo(String levelname1, String levelname2) Compares two levels.
boolean	createHandler(String hn, String handlertype) Creates a new handler
boolean	defineLevel(String name, int value) It defines a new Level with a name and an integer value.
boolean	defineLevel(String name, String value) It defines a new Level with a name and a string value.
Map	getAllHandlerAttributes() It retrieves the attributes of all handlers
Map	getHandlerAttributes(String handlername) It retrieves the attributes of an handler
String[]	getHandlerNames() It retrieves name of all handler managed by this factory.
Level	getLevel(int value) It retrieves a Level instance which the integer value is equals to the parameter.
Level	getLevel(String name) It retrieves a Level instance which the name is equals to the parameter.
Level[]	getLevels() It retrieves all Level instances defined in this manager.
LoggerInfo	getLogger(String loggername) Creates a logger if it does not exist.
LoggerInfo	getLogger(String key, String resourceBundleName) Creates a logger if it does not exist.
LoggerInfo[]	getLoggers() It retrieves a list of all loggers.
Properties	getMonologProperties() Retrieves the properties corresponding to the current configuration.
String	getResourceBundleName() Accessors to a resource bundle name associated to a LoggerFactory.
void	removeAllHandlersFromLogger(String loggerName) A TopicalLogger manages a list of Handler instances.
boolean	removeHandler(String handlername) It removes the handler which the name is specified by the parameter
void	removeHandlerFromLogger(String handlerName, String loggerName) A TopicalLogger manages a list of Handler instances.
void	removeLevel(String name) It removes a Level instance to this manager.
void	removeTopicFromLogger(String topic, String loggerName) This method allows removing a topic to a TopicalLogger.
void	setAdditivity(boolean a, String loggerName) It assigns the additivity flag for this logger instance.
void	setHandlerAttribute(String handlername, String attributeName, String value) Assignes a value to an handler attribute.
void	setLoggerLevel(int level, String loggerName) It assigns a level to a logger.
void	setLoggerLevel(String levelName, String loggerName) It assigns a level to a logger.
void	setMonologProperties(Properties p) Configure Monolog with properties.
void	setResourceBundleName(String resourceBundleName) Accessors to a resource bundle name associated to a LoggerFactory.

Method Detail

defineLevel

boolean defineLevel(String name,
                    int value)

It defines a new Level with a name and an integer value.

Parameters:

name - is the name of the new level

value - is the integer value of the new level

Returns:

true if the level has been created.

defineLevel

boolean defineLevel(String name,
                    String value)

It defines a new Level with a name and a string value. The string value is analyzed to obtain the integer value.

Parameters:

name - is the name of the new level

value - is the string value of the new level

Returns:

true if the level has been created.

removeLevel

void removeLevel(String name)

It removes a Level instance to this manager.

getLevel

Level getLevel(String name)

It retrieves a Level instance which the name is equals to the parameter.

Parameters:

name - is the name of request Level

Returns:

a Leve instance or a null value if the level does not exist.

getLevel

Level getLevel(int value)

It retrieves a Level instance which the integer value is equals to the parameter.

Parameters:

value - is the integer value of request Level

Returns:

a Leve instance or a null value if the level does not exist. As it is possible to define several Levels which have the same integer value this methods returns the Level instance of first name found in the list.

getLevels

Level[] getLevels()

It retrieves all Level instances defined in this manager.

compareTo

int compareTo(String levelname1,
              String levelname2)

Compares two levels.

Parameters:

levelname1 - is the name of the first level

levelname2 - is the name of the second level

createHandler

boolean createHandler(String hn,
                      String handlertype)

Creates a new handler

Parameters:

hn - is the name of the handler to create

handlertype - is the type of the parameter. The possible value are defined in this interface by the XXX_HANDLER_TYPE constants.

Returns:

true if the handler has been created

removeHandler

boolean removeHandler(String handlername)

It removes the handler which the name is specified by the parameter

Parameters:

handlername - is the name of the handler

Returns:

true if the handler has been removed.

getHandlerNames

String[] getHandlerNames()

It retrieves name of all handler managed by this factory.

getHandlerAttributes

Map getHandlerAttributes(String handlername)

It retrieves the attributes of an handler

Parameters:

handlername - is the name of the handler

Returns:

a map containing the association between an attribute name (String) and an attribute value (String).

getAllHandlerAttributes

Map getAllHandlerAttributes()

It retrieves the attributes of all handlers

Returns:

Map( String handlername, Map(String attributename, String attributevalue) )

setHandlerAttribute

void setHandlerAttribute(String handlername,
                         String attributeName,
                         String value)

Assignes a value to an handler attribute.

Parameters:

handlername - is the name of the handler

attributeName - is the name of the attribute

value - is the new value of the attribute

getLogger

LoggerInfo getLogger(String loggername)

Creates a logger if it does not exist.

Parameters:

loggername - is the name of the logger

getLogger

LoggerInfo getLogger(String key,
                     String resourceBundleName)

Creates a logger if it does not exist.

Parameters:

loggername - is the name of the logger

resourceBundleName - allows specifying the name of a resource bundle in order to internationalise the logging.

getResourceBundleName

String getResourceBundleName()

Accessors to a resource bundle name associated to a LoggerFactory.

setResourceBundleName

void setResourceBundleName(String resourceBundleName)

Accessors to a resource bundle name associated to a LoggerFactory.

getLoggers

LoggerInfo[] getLoggers()

It retrieves a list of all loggers.

addHandlerToLogger

void addHandlerToLogger(String handlerName,
                        String loggerName)

A TopicalLogger manages a list of Handler instances. This method allows adding a handler to this list. The addHandler method returns true only if the Handler did not exist

removeHandlerFromLogger

void removeHandlerFromLogger(String handlerName,
                             String loggerName)

A TopicalLogger manages a list of Handler instances. This method allows removing a handler to this list.

removeAllHandlersFromLogger

void removeAllHandlersFromLogger(String loggerName)

A TopicalLogger manages a list of Handler instances. This method allows removing all handler.

setAdditivity

void setAdditivity(boolean a,
                   String loggerName)

It assigns the additivity flag for this logger instance.

setLoggerLevel

void setLoggerLevel(int level,
                    String loggerName)

It assigns a level to a logger.

Parameters:

level - is an int value corresponding to a level

loggerName - is the name of logger which the level must be set.

setLoggerLevel

void setLoggerLevel(String levelName,
                    String loggerName)

It assigns a level to a logger. If the level name does not match any existing level, the level is not set on the logger.

Parameters:

level - is a string value corresponding to a level defined into the LevelFactory

loggerName - is the name of logger which the level must be set.

addTopicToLogger

void addTopicToLogger(String topic,
                      String loggerName)

This method allows adding a topic to a TopicalLogger. This actions change the hierarchical structure, but also the list of handlers. The list of handlers of a TopicalLogger is composed of its handlers and all handlers inherited from its parents. Adding a topic changes the inherited handlers list.

removeTopicFromLogger

void removeTopicFromLogger(String topic,
                           String loggerName)

This method allows removing a topic to a TopicalLogger. This actions change the hierarchical structure, but also the list of handlers. The list of handlers of a TopicalLogger is composed of its handlers and all handlers inherited from its parents. Removing a topic changes the inherited handlers list.

getMonologProperties

Properties getMonologProperties()

Retrieves the properties corresponding to the current configuration.

setMonologProperties

void setMonologProperties(Properties p)

Configure Monolog with properties.