logging-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ihabu...@apache.org
Subject svn commit: r1163184 - in /logging/log4php/trunk/src: main/php/layouts/LoggerLayoutXml.php site/apt/docs/appender/layout.apt
Date Tue, 30 Aug 2011 12:22:35 GMT
Author: ihabunek
Date: Tue Aug 30 12:22:34 2011
New Revision: 1163184

URL: http://svn.apache.org/viewvc?rev=1163184&view=rev
Log:
Updated documentation for the LoggerLayoutXML and added examples to site docs.

Modified:
    logging/log4php/trunk/src/main/php/layouts/LoggerLayoutXml.php
    logging/log4php/trunk/src/site/apt/docs/appender/layout.apt

Modified: logging/log4php/trunk/src/main/php/layouts/LoggerLayoutXml.php
URL: http://svn.apache.org/viewvc/logging/log4php/trunk/src/main/php/layouts/LoggerLayoutXml.php?rev=1163184&r1=1163183&r2=1163184&view=diff
==============================================================================
--- logging/log4php/trunk/src/main/php/layouts/LoggerLayoutXml.php (original)
+++ logging/log4php/trunk/src/main/php/layouts/LoggerLayoutXml.php Tue Aug 30 12:22:34 2011
@@ -21,8 +21,13 @@
 /**
  * The output of the LoggerXmlLayout consists of a series of log4php:event elements. 
  * 
- * <p>Parameters: {@link $locationInfo}.</p>
- *
+ * Configurable parameters: 
+ * - {@link $locationInfo} - If set to true then the file name and line number 
+ *   of the origin of the log statement will be included in output.
+ * - {@link $log4jNamespace} - If set to true then log4j namespace will be used
+ *   instead of log4php namespace. This can be usefull when using log viewers 
+ *   which can only parse the log4j namespace such as Apache Chainsaw. 
+ * 
  * <p>It does not output a complete well-formed XML file. 
  * The output is designed to be included as an external entity in a separate file to form
  * a correct XML file.</p>

Modified: logging/log4php/trunk/src/site/apt/docs/appender/layout.apt
URL: http://svn.apache.org/viewvc/logging/log4php/trunk/src/site/apt/docs/appender/layout.apt?rev=1163184&r1=1163183&r2=1163184&view=diff
==============================================================================
--- logging/log4php/trunk/src/site/apt/docs/appender/layout.apt (original)
+++ logging/log4php/trunk/src/site/apt/docs/appender/layout.apt Tue Aug 30 12:22:34 2011
@@ -253,7 +253,7 @@ log4php.appender.default.layout = Logger
 
 ** {LoggerLayoutXml}
 
-  The LoggerLayoutXml formats the message as a XML fragment.
+  The LoggerLayoutXml formats the messages as an XML document.
   
   
 *** Configurable parameters
@@ -263,9 +263,26 @@ log4php.appender.default.layout = Logger
 *---------------------+--------------*-------------------+------------------------+
 | locationInfo        | No           | true              | If set to true then the file name
and line number of the origin of the log statement will be included in output.
 *---------------------+--------------*-------------------+------------------------+
+| log4jNamespace      | No           | false             | If set to true then log4j namespace
will be used instead of the log4php namespace. This can be usefull when using log viewers
which can only parse the log4j namespace such as Apache Chainsaw. 
+*---------------------+--------------*-------------------+------------------------+
 
 *** Examples
 
+	This layout will by default include the Nested Diagnostic Context if any is present. 
+
+	Consider the following code snippet:
+	
++--
+$logger = Logger::getLogger('myLogger');
+
+LoggerNDC::push('foo');
+$logger->info("My first message.");
+LoggerNDC::push('bar');
+$logger->info("My second message.");
++-- 
+
+**** Example 1: default configuration
+
   Configuration via XML file:
   
 +--
@@ -281,7 +298,7 @@ log4php.appender.default = LoggerAppende
 log4php.appender.default.layout = LoggerLayoutXml
 +--
 
-  Sample output:
+  The resulting output:
 
 +--
 <log4php:eventSet xmlns:log4php="http://logging.apache.org/log4php/" version="0.3" includesLocationInfo="true">
@@ -296,12 +313,43 @@ log4php.appender.default.layout = Logger
         <log4php:NDC><![CDATA[foo bar]]></log4php:NDC>
         <log4php:locationInfo class="main" file="/home/ihabunek/log4php/example.php" line="14"
method="main" />
     </log4php:event>
+</log4php:eventSet>
++--
 
-    <log4php:event logger="myLogger" level="WARN" thread="5032" timestamp="1294329322044">
-        <log4php:message><![CDATA[My third message.]]></log4php:message>
-        <log4php:NDC><![CDATA[foo bar baz]]></log4php:NDC>
-        <log4php:locationInfo class="main" file="/home/ihabunek/log4php/example.php" line="16"
method="main" />
-    </log4php:event>
+**** Example 2: log4j namespace, without location information
+
+  Configuration via XML file:
+  
++--
+<appender name="default" class="LoggerAppenderEcho">
+    <layout class="LoggerLayoutXml">
+    	<param name="locationInfo" value="false" />
+    	<param name="log4jNamespace" value="true" />
+    </layout>
+</appender>
++--
+
+  Configuration via ini file:
+  
++--
+log4php.appender.default = LoggerAppenderEcho
+log4php.appender.default.layout = LoggerLayoutXml
+log4php.appender.default.layout.locationInfo = false
+log4php.appender.default.layout.log4jNamespace = true
++--
+
+  The resulting output:
 
-</log4php:eventSet>
 +--
+<log4j:eventSet xmlns:log4j="http://jakarta.apache.org/log4j/" version="0.3" includesLocationInfo="false">
+	<log4j:event logger="myLogger" level="INFO" thread="5284" timestamp="1313152509034">
+		<log4j:message><![CDATA[My first message.]]></log4j:message>
+		<log4j:NDC><![CDATA[foo]]></log4j:NDC>
+	</log4j:event>
+	
+	<log4j:event logger="myLogger" level="INFO" thread="5284" timestamp="1313152509035">
+		<log4j:message><![CDATA[My second message.]]></log4j:message>
+		<log4j:NDC><![CDATA[foo bar]]></log4j:NDC>
+	</log4j:event>
+</log4j:eventSet>
++--
\ No newline at end of file



Mime
View raw message