Task

<logging>

Configures the JDK logging java.util.logging, also known as "JUL".

Subelement Summary

Subelements

Name	Description
<logger>	One logger configuration.

Subelement Detail

<logger>

One logger configuration. An XML element that designates a Logger.

Attributes:

name="name"

The name of a logger to be configured; typically, but not necessarily, the qualified name of the Java class that will use the logger.

Iff no logger name is specified, then the "root logger" is configured.

clearLevel="true|false"

Whether the logger level should be "cleared", so that the level inherited from the ancestor loggers takes effect.

level="OFF|SEVERE|WARNING|INFO|CONFIG|FINE|FINER|FINEST|ALL|integer-value"

The logger level to set.

See also:

Level.parse(String)

useParentHandlers="true|false"

Whether to configure the logger(s) such that, after logging an event, the event is also logged by the logger's ancestor loggers.

See also:

Logger.setUseParentHandlers(boolean)

clearFilter="true|false"

Whether to remove any filter that was previously configured for the logger(s).

clearHandlers="true|false"

Whether to remove any handlers from the logger(s) before adding new ones.

Subelements:

<name>

The name of a logger to be configured; typically, but not necessarily, the qualified name of the Java class that will use the logger.

Iff no logger name is specified, then the "root logger" is configured.

An XML element that specifies a "value", either through nested text, or through a value attribute.

Text between start and end tag:

The "value" text - may alternatively be configured by the "value="..."" attribute.

Attributes:

value="value"

The "value" text - may alternatively be configured by text nested between start and end tags.

<filter>

The filter to configure for the logger(s); at most one.

See also:

Filter

An instance is obtained by either

• Creating one with the zero-arg constructor
• Creating one with a one-string-arg constructor (see argument=...)
• Creating one with a two-or-more-string-args constructor (see <argument>)

Attributes:

className="class-name"

The qualified name of the Java class to instantiate (mandatory).

argument="value"

The (single) string argument for the constructor.

Subelements:

<argument>

A string argument for the constructor. An XML element that specifies a "value", either through nested text, or through a value attribute.

Text between start and end tag:

The "value" text - may alternatively be configured by the "value="..."" attribute.

Attributes:

value="value"

The "value" text - may alternatively be configured by text nested between start and end tags.

<attribute>

Attributes to set on the object right after construction. An XML element that specifies a name-value pair.

Text between start and end tag:

The "value" text - may alternatively be configured by the "value="..."" attribute.

Attributes:

name="name"

The "name" of the name-value pair.

value="value"

The "value" text - may alternatively be configured by text nested between start and end tags.

<handler>

A handler to add to the logger(s).

See also:

Handler

An XML element that specifies a Handler object.

Attributes:

className="class-name"

The qualified name of the Java class to instantiate (mandatory).

argument="value"

The (single) string argument for the constructor.

Subelements:

<filter>

The filter to set on the handler (at most one).

The default is handler-specific, but typically is "none".

See also:

Handler.setFilter(Filter)

An instance is obtained by either

• Creating one with the zero-arg constructor
• Creating one with a one-string-arg constructor (see argument=...)
• Creating one with a two-or-more-string-args constructor (see <argument>)

Attributes:

className="class-name"

The qualified name of the Java class to instantiate (mandatory).

argument="value"

The (single) string argument for the constructor.

Subelements:

<argument>

A string argument for the constructor. An XML element that specifies a "value", either through nested text, or through a value attribute.

Text between start and end tag:

The "value" text - may alternatively be configured by the "value="..."" attribute.

Attributes:

value="value"

The "value" text - may alternatively be configured by text nested between start and end tags.

<attribute>

Attributes to set on the object right after construction. An XML element that specifies a name-value pair.

Text between start and end tag:

The "value" text - may alternatively be configured by the "value="..."" attribute.

Attributes:

name="name"

The "name" of the name-value pair.

value="value"

The "value" text - may alternatively be configured by text nested between start and end tags.

<formatter>

The formatter to use with the handler (at most one).

The default is handler-specific, but typically is a SimpleFormatter.

See also:

Formatter

Handler.setFormatter(Formatter)

An instance is obtained by either

• Creating one with the zero-arg constructor
• Creating one with a one-string-arg constructor (see argument=...)
• Creating one with a two-or-more-string-args constructor (see <argument>)

Attributes:

className="class-name"

The qualified name of the Java class to instantiate (mandatory).

argument="value"

The (single) string argument for the constructor.

Subelements:

<argument>

A string argument for the constructor. An XML element that specifies a "value", either through nested text, or through a value attribute.

Text between start and end tag:

The "value" text - may alternatively be configured by the "value="..."" attribute.

Attributes:

value="value"

The "value" text - may alternatively be configured by text nested between start and end tags.

<attribute>

Attributes to set on the object right after construction. An XML element that specifies a name-value pair.

Text between start and end tag:

The "value" text - may alternatively be configured by the "value="..."" attribute.

Attributes:

name="name"

The "name" of the name-value pair.

value="value"

The "value" text - may alternatively be configured by text nested between start and end tags.

<argument>

A string argument for the constructor. An XML element that specifies a "value", either through nested text, or through a value attribute.

Text between start and end tag:

The "value" text - may alternatively be configured by the "value="..."" attribute.

Attributes:

value="value"

The "value" text - may alternatively be configured by text nested between start and end tags.

<attribute>

Attributes to set on the object right after construction. An XML element that specifies a name-value pair.

Text between start and end tag:

The "value" text - may alternatively be configured by the "value="..."" attribute.

Attributes:

name="name"

The "name" of the name-value pair.

value="value"

The "value" text - may alternatively be configured by text nested between start and end tags.