Sha256: faeab8491ea287d5dd12984810dad46b1c4dbd848cc6e42fa795d7589701a3c4
Contents?: true
Size: 1.21 KB
Versions: 137
Compression:
Stored size: 1.21 KB
Contents
= Formatters
Formatters are responsible for formatting LogEvent data.
An Outputter owning a Formatter will invoke the
Log4r::Formatter#format method prior to writing.
== Available Formatters
* Log4r::BasicFormatter - default
* Log4r::PatternFormatter - most flexible. See log4r/formatter/patternformatter.rb
* Log4r::SimpleFormatter - like BasicFormatter for Strings only (low noise)
* Log4r::ObjectFormatter - for inspecting objects
* Log4r::NullFormatter - twirls on its feet and does nothing
= XML Configuration
Specify the Formatter and its class (as +type+) under an
<tt><outputter></tt> directive:
<outputter name="someout" type="sometype">
<formatter type="Log4r::BasicFormatter"/>
</outputter>
As explained in log4r/configurator.rb, the hash arguments you would normally
pass to +new+ are specified as <i>XML parameters</i>. Only PatternFormatter
has any of these.
= Custom Formatting
Building a custom Formatter is extremely easy. Just define a class
that extends Formatter and override the Formatter#format method.
Then give it to any interested Outputters.
If you're interested in setting up your custom formatters in XML,
please take a look at log4r/configurator.rb.
== Data Available
See Log4r::LogEvent
Version data entries
137 entries across 99 versions & 18 rubygems