You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@logging.apache.org by mi...@apache.org on 2017/04/24 16:05:29 UTC
logging-log4j2 git commit: Document Log4j 1.x layout stuff
Repository: logging-log4j2
Updated Branches:
refs/heads/master b5640d9ed -> 80f21756f
Document Log4j 1.x layout stuff
Project: http://git-wip-us.apache.org/repos/asf/logging-log4j2/repo
Commit: http://git-wip-us.apache.org/repos/asf/logging-log4j2/commit/80f21756
Tree: http://git-wip-us.apache.org/repos/asf/logging-log4j2/tree/80f21756
Diff: http://git-wip-us.apache.org/repos/asf/logging-log4j2/diff/80f21756
Branch: refs/heads/master
Commit: 80f21756ff5bebd8aecc8fee6bd4d29a2735d1a8
Parents: b5640d9
Author: Mikael St�ldal <mi...@magine.com>
Authored: Mon Apr 24 18:05:13 2017 +0200
Committer: Mikael St�ldal <mi...@magine.com>
Committed: Mon Apr 24 18:05:13 2017 +0200
----------------------------------------------------------------------
src/site/xdoc/manual/migration.xml | 32 +++++++++++++++++++-------------
1 file changed, 19 insertions(+), 13 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/80f21756/src/site/xdoc/manual/migration.xml
----------------------------------------------------------------------
diff --git a/src/site/xdoc/manual/migration.xml b/src/site/xdoc/manual/migration.xml
index 4c35c2b..f688cd9 100644
--- a/src/site/xdoc/manual/migration.xml
+++ b/src/site/xdoc/manual/migration.xml
@@ -114,6 +114,14 @@
<code>${sys:catalina.base}</code>.
</p>
<p>
+ Log4j 1.x has a XMLLayout which is different from the XmlLayout in Log4j 2, the log4j-1.2-api module
+ contains a <code>Log4j1XmlLayout</code> which produce output in the format as in Log4j 1.x.
+ The Log4j 1.x <code>SimpleLayout</code> can be emulated with PatternLayout "%level - %m%n".
+ The Log4j 1.x <code>TTCCLayout</code> can be emulated with PatternLayout "%r [%t] %p %c %notEmpty{%ndc }- %m%n".
+ The log4j-1.2-api module contains two pattern conversions "%ndc" and "%properties" which
+ can be used to emulate "%x" and "%X" in Log4j 1.x PatternLayout ("%x" and %X" in Log4j 2 have a slightly different format).
+ </p>
+ <p>
Below are the example configurations for Log4j 1.x and their counterparts in Log4j 2.
</p>
@@ -151,7 +159,7 @@
</Loggers>
</Configuration>]]></pre>
- <h4>Sample 2 - Simple configuration using a File Appender</h4>
+ <h4>Sample 2 - Simple configuration using a File Appender, XMLLayout and SimpleLayout</h4>
<p>Log4j 1.x XML configuration</p>
<pre class="prettyprint linenums"><![CDATA[<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE log4j:configuration PUBLIC "-//APACHE//DTD LOG4J 1.2//EN" "log4j.dtd">
@@ -159,14 +167,10 @@
<appender name="A1" class="org.apache.log4j.FileAppender">
<param name="File" value="A1.log" />
<param name="Append" value="false" />
- <layout class="org.apache.log4j.PatternLayout">
- <param name="ConversionPattern" value="%t %-5p %c{2} - %m%n"/>
- </layout>
+ <layout class="org.apache.log4j.xml.XMLLayout" />
</appender>
<appender name="STDOUT" class="org.apache.log4j.ConsoleAppender">
- <layout class="org.apache.log4j.PatternLayout">
- <param name="ConversionPattern" value="%d %-5p [%t] %C{2} (%F:%L) - %m%n"/>
- </layout>
+ <layout class="org.apache.log4j.SimpleLayout" />
</appender>
<category name="org.apache.log4j.xml">
<priority value="debug" />
@@ -183,10 +187,10 @@
<Configuration>
<Appenders>
<File name="A1" fileName="A1.log" append="false">
- <PatternLayout pattern="%t %-5p %c{2} - %m%n"/>
+ <Log4j1XmlLayout />
</File>
<Console name="STDOUT" target="SYSTEM_OUT">
- <PatternLayout pattern="%d %-5p [%t] %C{2} (%F:%L) - %m%n"/>
+ <PatternLayout pattern="%level - %m%n"/>
</Console>
</Appenders>
<Loggers>
@@ -249,7 +253,7 @@
</Loggers>
</Configuration>]]></pre>
- <h4>Sample 4 - AsyncAppender</h4>
+ <h4>Sample 4 - AsyncAppender and TTCCLayout</h4>
<p>Log4j 1.x XML configuration using the AsyncAppender.</p>
<pre class="prettyprint linenums"><![CDATA[<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE log4j:configuration PUBLIC "-//APACHE//DTD LOG4J 1.2//EN" "log4j.dtd">
@@ -259,8 +263,10 @@
</appender>
<appender name="TEMP" class="org.apache.log4j.FileAppender">
<param name="File" value="temp"/>
- <layout class="org.apache.log4j.PatternLayout">
- <param name="ConversionPattern" value="%d %-5p [%t] %C{2} (%F:%L) - %m%n"/>
+ <layout class="org.apache.log4j.TTCCLayout">
+ <param name="ThreadPrinting" value="true"/>
+ <param name="CategoryPrefixing" value="true"/>
+ <param name="ContextPrinting" value="true"/>
</layout>
</appender>
<root>
@@ -274,7 +280,7 @@
<Configuration status="debug">
<Appenders>
<File name="TEMP" fileName="temp">
- <PatternLayout pattern="%d %-5p [%t] %C{2} (%F:%L) - %m%n"/>
+ <PatternLayout pattern="%r [%t] %p %c %notEmpty{%ndc }- %m%n"/>
</File>
<Async name="ASYNC">
<AppenderRef ref="TEMP"/>