GVLog4JConfiguration

GreenVulcano^® ESB Configuration

The following table shows the GVLog4JConfiguration element's attributes:

Attribute	Type	Description
type	fixed	This attribute must assume the value module
name	fixed	This attribute must assume the value LOG4J

GVJavaScriptConfig contains the sub-elements:

• log4j:configuration

log4j:configuration

Authors: Chris Taylor, Ceki Gulcu.

Version: 1.2

A configuration element consists of optional renderer elements, appender elements, categories and an optional root element.

The following table shows the log4j:configuration element's attributes:

Attribute	Type	Description
xmlns:log4j	fixed	This attribute must assume the value http://jakarta.apache.org/log4j/.
threshold	optional	The "threshold" attribute takes a level value such that all logging statements with a level equal or below this value are disabled. The attribute's default value is: null. The attribute's admitted values are: all debug info warn error fatal off null
debug	optional	By default, debug attribute is "null", meaning that we not touch internal log4j logging settings. Setting the "debug" attributes enable the printing of internal log4j logging statements. The attribute's default value is: null. The attribute's admitted values are: true false null

Might contain the sub-elements:

• renderer
• appender
• category or logger
• root
• categoryFactory

renderer

Renderer element allows the user to customize the conversion of message objects to String.

The following table shows its attributes:

Attribute	Type	Description
renderedClass	required
renderingClass	required

appender

Appenders must have a name and a class. Appenders may contain an error handler, a layout, optional parameters and filters. They may also reference (or include) other appenders.

The following table shows the appender element's attributes:

Attribute	Type	Description
name	required	The attribute's value can't be null.
class	required

Might contain the sub-elements:

• errorHandler
• param
• layout
• filter
• appender-ref

errorHandler

ErrorHandlers can be of any class. They can admit any number of parameters.

The following table shows its attributes:

Attribute	Type	Description
class	required

Might contain the following attributes:

• param
• root-ref
• logger-ref
• appender-ref

root-ref

EMPTY

logger-ref

The following table shows the logger-ref element's attributes:

Attribute	Type	Description
ref	required	The attribute's value can't be null.

appender-ref

The appender-ref Element is used by: appender, category, errorHandler, logger, root. The following table shows its attributes:

Attribute	Type	Description
ref	required

layout

See the layout class documentation to understand its parameters.

The following table shows the layout element's attributes:

Attribute	Type	Description
class	required

Might contain the following attributes:

• param

filter

See the filter class documentation to understand its parameters.

The following table shows the filter element's attributes:

Attribute	Type	Description
class	required

Might contain the following attributes:

• param

category

If no level element is specified, then the configurer MUST not touch the level of the named category.

The following table shows the category element's attributes:

Attribute	Type	Description
name	required	The attribute's value can't be null.
class	optional
additivity	optional	The attribute's default value is: true. The attribute's admitted values are: true false

Might contain the following attributes:

• param
• priority or level
• appender-ref

level

The level class is org.apache.log4j.Level by default. It is used by: category, logger, root. The following table shows the level element's attributes:

Attribute	Type	Description
class	optional
value	required

Might contain the following attributes:

• param

logger

If no level element is specified, then the configurer MUST not touch the level of the named category.

The following table shows the logger element's attributes:

Attribute	Type	Description
name	required	The attribute's value can't be null.
additivity	optional	The attribute's default value is: true. The attribute's admitted values are: true false

Might contain the following attributes:

• level
• appender-ref

root

If no priority element is specified, then the configurer MUST not touch the priority of root. The root category always exists and cannot be subclassed.

Might contain the following sub-elements:

• param
• priority or level
• appender-ref

param

The param Element is used by: appender, category, categoryFactory, errorHandler, filter, layout, level, priority and root.

The following table shows the param element's attributes:

Attribute	Type	Description
name	required	The attribute's value can't be null.
value	required

priority

The priority class is org.apache.log4j.Level by default.

The priority Element is used by: category and root. The following table shows its attributes:

Attribute	Type	Description
class	optional
value	required

Contains the sub-element param.

categoryFactory

The categoryFactory Element is used by: log4j:configuration. The following table shows its attributes:

Attribute	Type	Description
class	required

Contains the sub-element param.