Cernunnos Manual


<log>

Description:

Writes the specified MESSAGE to the log.

The <log> task uses Apache commons-logging. Consult the commons-logging User Guide for comprehensive documentation.

Reagents:

Name XPath Description Reagent Type Expected Type Required
LOGGER_NAME @logger-name The name of the logger to write to. The default is org.danann.cernunnos.core.LogTask PHRASE java.lang.String No
LEVEL @level The log-level associated with MESSAGE. From least to most serious, the available log levels are ['trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal']. The default is 'info'. PHRASE java.lang.String No
PREFIX @prefix Characters that preceed MESSAGE. The default is an empty string. PHRASE java.lang.String No
MESSAGE text() Message to write to the log. PHRASE java.lang.String Yes
SUFFIX @suffix Characters that follow MESSAGE. The default is an empty string. PHRASE java.lang.String No
EXCEPTION @exception The optional exception to log with the message. PHRASE java.lang.Throwable No

Examples:

Writes a message at WARN level to the default logger:

 
       
        <log level="warn">Watch out!</log> 
       
    

Writes a message at INFO level (default) to a logger configured with the name 'myclass':

 
       
        <log logger-name="myclass">A useful piece of information...</log>