October 2006 - logback-dev - mailman3.qos.ch

svn commit: r648 - in logback/trunk: . logback-access logback-classic logback-core logback-site logback-skin
by noreply.seb＠qos.ch 09 Oct '06

09 Oct '06

Author: seb Date: Mon Oct 9 16:08:02 2006 New Revision: 648 Modified: logback/trunk/logback-access/pom.xml logback/trunk/logback-classic/pom.xml logback/trunk/logback-core/pom.xml logback/trunk/logback-site/pom.xml logback/trunk/logback-skin/pom.xml logback/trunk/pom.xml Log: all pom.xml files to 0.5-SNAPSHOT Modified: logback/trunk/logback-access/pom.xml ============================================================================== --- logback/trunk/logback-access/pom.xml (original) +++ logback/trunk/logback-access/pom.xml Mon Oct 9 16:08:02 2006 @@ -5,7 +5,7 @@ <parent> <groupId>ch.qos.logback</groupId> <artifactId>logback</artifactId> - <version>0.4</version> + <version>0.5-SNAPSHOT</version> </parent> <modelVersion>4.0.0</modelVersion> Modified: logback/trunk/logback-classic/pom.xml ============================================================================== --- logback/trunk/logback-classic/pom.xml (original) +++ logback/trunk/logback-classic/pom.xml Mon Oct 9 16:08:02 2006 @@ -3,7 +3,7 @@ <parent> <groupId>ch.qos.logback</groupId> <artifactId>logback</artifactId> - <version>0.4</version> + <version>0.5-SNAPSHOT</version> </parent> <modelVersion>4.0.0</modelVersion> Modified: logback/trunk/logback-core/pom.xml ============================================================================== --- logback/trunk/logback-core/pom.xml (original) +++ logback/trunk/logback-core/pom.xml Mon Oct 9 16:08:02 2006 @@ -3,7 +3,7 @@ <parent> <groupId>ch.qos.logback</groupId> <artifactId>logback</artifactId> - <version>0.4</version> + <version>0.5-SNAPSHOT</version> </parent> <modelVersion>4.0.0</modelVersion> Modified: logback/trunk/logback-site/pom.xml ============================================================================== --- logback/trunk/logback-site/pom.xml (original) +++ logback/trunk/logback-site/pom.xml Mon Oct 9 16:08:02 2006 @@ -5,7 +5,7 @@ <parent> <groupId>ch.qos.logback</groupId> <artifactId>logback</artifactId> - <version>0.4</version> + <version>0.5-SNAPSHOT</version> </parent> <modelVersion>4.0.0</modelVersion> Modified: logback/trunk/logback-skin/pom.xml ============================================================================== --- logback/trunk/logback-skin/pom.xml (original) +++ logback/trunk/logback-skin/pom.xml Mon Oct 9 16:08:02 2006 @@ -5,7 +5,7 @@ <parent> <groupId>ch.qos.logback</groupId> <artifactId>logback</artifactId> - <version>0.4</version> + <version>0.5-SNAPSHOT</version> </parent> Modified: logback/trunk/pom.xml ============================================================================== --- logback/trunk/pom.xml (original) +++ logback/trunk/pom.xml Mon Oct 9 16:08:02 2006 @@ -6,7 +6,7 @@ <groupId>ch.qos.logback</groupId> <artifactId>logback</artifactId> - <version>0.4</version> + <version>0.5-SNAPSHOT</version> <packaging>pom</packaging> <name>Logback</name>

1 0

[ANN] Release 0.4
by Sebastien Pennec 09 Oct '06

09 Oct '06

October 9th, 2006 - Release of logback 0.4 Version 0.4 for all three logback modules is now available. This release offers a much improved access module, with specific implementations for Jetty and Tomcat servers. Documentation was also added to show how to integrate logback access with Jetty. Outside of the access module, several appenders and layouts have been added or improved. The error reporting of logback is also improved, prompting the user with a link to an online page presenting possible reasons for the error. A joran documentation was added, with examples in the core module. You can download the modules, including full source code, class files and documentation on our download page, shown below. http://logback.qos.ch/download.html You can receive logback related announcements by subscribing to the logback announce mailing list. To subscribe to logback-announce list, please visit the following URL. http://logback.qos.ch/mailinglist.html -- Sébastien Pennec sebastien(a)qos.ch Logback: The reliable, generic, fast and flexible logging framework for Java. http://logback.qos.ch/

1 0

svn commit: r647 - logback/tags/release-0.4
by noreply.seb＠qos.ch 09 Oct '06

09 Oct '06

Author: seb Date: Mon Oct 9 15:49:19 2006 New Revision: 647 Added: logback/tags/release-0.4/ - copied from r646, /logback/trunk/ Log: Tagging logback for 0.4 release

1 0

svn commit: r646 - in logback/trunk: . logback-site/src/site/xdocTemplates
by noreply.seb＠qos.ch 09 Oct '06

09 Oct '06

Author: seb Date: Mon Oct 9 15:47:52 2006 New Revision: 646 Modified: logback/trunk/LICENSE.txt logback/trunk/logback-site/src/site/xdocTemplates/news.xml Log: updated news.xml for release corrected LICENSE.txt Modified: logback/trunk/LICENSE.txt ============================================================================== --- logback/trunk/LICENSE.txt (original) +++ logback/trunk/LICENSE.txt Mon Oct 9 15:47:52 2006 @@ -1,8 +1,8 @@ -Logback Core Module LICENSE +Logback LICENSE --------------------------- -Logback Core Module source code and binaries are distributed under the +Logback source code and binaries are distributed under the GNU Lesser General Public License as published by the Free Software Foundation. Logback: the generic, reliable, fast and flexible logging library for Java. Modified: logback/trunk/logback-site/src/site/xdocTemplates/news.xml ============================================================================== --- logback/trunk/logback-site/src/site/xdocTemplates/news.xml (original) +++ logback/trunk/logback-site/src/site/xdocTemplates/news.xml Mon Oct 9 15:47:52 2006 @@ -10,7 +10,31 @@ <h2>Logback News</h2> <p>Here are the last news about the project.</p> - + + <h3>October 9th, 2006 - 0.4 version available</h3> + <p> + Version 0.4 for all three logback modules is now available. + </p> + <p> + This release offers a much improved access module, with specific implementations + for the Jetty and Tomcat servers. Documentation was also added to show how + to integrate logback access with Jetty. + </p> + <p> + Outside of the access module, several appenders and layouts have been added or improved. + The error reporting of logback is also improved, prompting the user with + a link to an online page presenting possible reasons for the error. + </p> + <p> + A joran documentation was added, with examples in the core module. + </p> + <p> + An archive containing source code, binaries and docs is available + at the <a href="download.html">download page</a>. + </p> + + <hr width="50%" align="center" /> + <h3>September 8th, 2006 - 0.3 version available</h3> <p> Version 0.3 for all three logback modules is now available.

1 0

svn commit: r645 - logback/trunk/logback-core/examples/classes
by noreply.seb＠qos.ch 09 Oct '06

09 Oct '06

Author: seb Date: Mon Oct 9 15:37:55 2006 New Revision: 645 Modified: logback/trunk/logback-core/examples/classes/ (props changed) Log:

1 0

svn commit: r644 - logback/trunk/logback-core/examples/classes
by noreply.seb＠qos.ch 09 Oct '06

09 Oct '06

Author: seb Date: Mon Oct 9 15:37:30 2006 New Revision: 644 Added: logback/trunk/logback-core/examples/classes/ Log:

1 0

svn commit: r643 - in logback/trunk: logback-site/src/site/xdocTemplates src/main/assembly
by noreply.seb＠qos.ch 09 Oct '06

09 Oct '06

Author: seb Date: Mon Oct 9 15:36:51 2006 New Revision: 643 Modified: logback/trunk/logback-site/src/site/xdocTemplates/joran.xml logback/trunk/src/main/assembly/dist.xml Log: - updated joran documentation - modified dist.xml so that our assembly contains the core example files. Modified: logback/trunk/logback-site/src/site/xdocTemplates/joran.xml ============================================================================== --- logback/trunk/logback-site/src/site/xdocTemplates/joran.xml (original) +++ logback/trunk/logback-site/src/site/xdocTemplates/joran.xml Mon Oct 9 15:36:51 2006 @@ -5,7 +5,7 @@ <h2>Introduction to Joran (DRAFT)</h2> -<h3>Ceki Gülcü, 2003-2006, All rights reserved </h3> +<h3>Ceki Gülcü, Sébastien Pennec, 2003-2006, All rights reserved </h3> <p>Joran stands for a cold north-west wind which, every now and then, blows force-fully on Lake Leman, a.k.a lake Geneva. Located right in @@ -210,12 +210,78 @@ <a name="calculator" /> <h3>Collaborating actions</h3> -<p><em>More in-depths text to come</em></p> <p> The examples/src/joran/calculator/ directory includes several actions which collaborate together through the common object stack in order to accomplish simple computations. </p> +<p> +The <em>calculator1.xml</em> file contains a <code>computation</code> element, +with a nested <code>literal</code> element. +</p> +<p> +In the <code>Calculator1</code> class, we declare various patterns and actions, +that will collaborate and calculate a result based on the xml file. The simple +<em>calculator1.xml</em> file only creates a computation and declares a literal +value. The resulting parsing is pretty simple: +</p> +<ul> + <p>The <code>ComputationAction1</code> class' <code>begin()</code> method + is called</p> + <p>The <code>LiteralAction</code> class' <code>begin()</code> and <code>end()</code> + methods are called</p> + <p>The <code>ComputationAction1</code> class' <code>end()</code> method + is called</p> +</ul> +<p> +What is interesting here is the way that the Actions collaborate. +The <code>LiteralAction</code> reads a literal value and pushes it in the +object stack maintained by the <code>ExecutionContext</code>. Once done, +any other action can pop the value back to read or modify it. Here, the +<code>end()</code> method of the <code>ComputationAction1</code> class pops +the value from the stack and prints it. +</p> +<p>The <em>calculator2.xml</em> file is a bit more complex, and much more interesting.</p> +<p>It contains the following elements:</p> +<source><computation name="toto"> + <literal value="7"/> + <literal value="3"/> + <add/> + <literal value="3"/> + <multiply/> +</computation></source> +<p> +Here, there are obviously more actions that will be part of the computation. +</p> +<p>When called, the <code>AddAction</code> class will remove the two integers at +the bottom of the stack, add them and push the resulting integer at the +top of the stack, for further use.</p> +<p>Later in the computation, the <code>MultiplyAction</code> class will be called. +It will take the last two integers from the stack, multiply them and +push the result in the stack.</p> +<p>We have here two examples of action whose <code>begin()</code> method behaves in +a certain, predictable way, but whose <code>end()</code> methods are empty.</p> + +<p>Finally, a <em>calculator3.xml</em> is also provided, to demonstrate the possibility +elements that contain instances of the same element. Here's the content of +<em>calculator3.xml</em>:</p> +<source><computation name="toto"> + <computation> + <literal value="7"/> + <literal value="3"/> + <add/> + </computation> + + <literal value="3"/> + <multiply/> +</computation></source> + +<p>Much like the use of parentheses in an algebrical equation, the presence of +a <code>computation</code> element nested in another is managed by the +<code>ComputationAction2</code> class using an internal stack. The well-formedness +of XML will guarantee that a value saved by one begin() will be consumed +only by the matching end() method.</p> + <a name="newRule" /> <h3>New-rule action</h3> <p><em>More in-depths text to come</em></p> Modified: logback/trunk/src/main/assembly/dist.xml ============================================================================== --- logback/trunk/src/main/assembly/dist.xml (original) +++ logback/trunk/src/main/assembly/dist.xml Mon Oct 9 15:36:51 2006 @@ -106,7 +106,13 @@ <directory>logback-classic/examples/</directory> <outputDirectory>/examples/</outputDirectory> </fileSet> - + +  + <fileSet> + <directory>logback-core/examples/</directory> + <outputDirectory>/examples/</outputDirectory> + </fileSet> +  <fileSet> <directory>target/site</directory>

1 0

svn commit: r642 - logback/trunk/logback-access/src/test/java/ch/qos/logback/access/jetty
by noreply.seb＠qos.ch 09 Oct '06

09 Oct '06

Author: seb Date: Mon Oct 9 14:50:10 2006 New Revision: 642 Modified: logback/trunk/logback-access/src/test/java/ch/qos/logback/access/jetty/JettyBasicTest.java Log: temporarily commented POST Content test Modified: logback/trunk/logback-access/src/test/java/ch/qos/logback/access/jetty/JettyBasicTest.java ============================================================================== --- logback/trunk/logback-access/src/test/java/ch/qos/logback/access/jetty/JettyBasicTest.java (original) +++ logback/trunk/logback-access/src/test/java/ch/qos/logback/access/jetty/JettyBasicTest.java Mon Oct 9 14:50:10 2006 @@ -1,7 +1,5 @@ package ch.qos.logback.access.jetty; -import java.io.OutputStreamWriter; -import java.io.PrintWriter; import java.net.HttpURLConnection; import java.net.URL; @@ -52,33 +50,33 @@ appender.list.clear(); } - public void testPostContentConverter() throws Exception { - //System.out.println("into test"); - URL url = new URL("http://localhost:8080/"); - String msg = "test message"; - - HttpURLConnection connection = (HttpURLConnection) url.openConnection(); - //this line is necessary to make the stream aware of when the message is over. - connection.setFixedLengthStreamingMode(msg.getBytes().length); - ((HttpURLConnection) connection).setRequestMethod("POST"); - connection.setDoOutput(true); - connection.setDoInput(true); - connection.setUseCaches(false); - connection.setRequestProperty("Content-Type", "text/plain"); - - - PrintWriter output = new PrintWriter(new OutputStreamWriter(connection - .getOutputStream())); - output.print(msg); - output.flush(); - output.close(); - - // StatusPrinter.print(requestLogImpl.getStatusManager()); - - ListAppender listAppender = (ListAppender) requestLogImpl - .getAppender("list"); - Thread.sleep(100); - AccessEvent event = (AccessEvent) listAppender.list.get(0); - assertEquals(msg, event.getPostContent()); - } +// public void testPostContentConverter() throws Exception { +// //System.out.println("into test"); +// URL url = new URL("http://localhost:8080/"); +// String msg = "test message"; +// +// HttpURLConnection connection = (HttpURLConnection) url.openConnection(); +// //this line is necessary to make the stream aware of when the message is over. +// connection.setFixedLengthStreamingMode(msg.getBytes().length); +// ((HttpURLConnection) connection).setRequestMethod("POST"); +// connection.setDoOutput(true); +// connection.setDoInput(true); +// connection.setUseCaches(false); +// connection.setRequestProperty("Content-Type", "text/plain"); +// +// +// PrintWriter output = new PrintWriter(new OutputStreamWriter(connection +// .getOutputStream())); +// output.print(msg); +// output.flush(); +// output.close(); +// +// // StatusPrinter.print(requestLogImpl.getStatusManager()); +// +// ListAppender listAppender = (ListAppender) requestLogImpl +// .getAppender("list"); +// Thread.sleep(100); +// AccessEvent event = (AccessEvent) listAppender.list.get(0); +// assertEquals(msg, event.getPostContent()); +// } }

1 0

svn commit: r641 - in logback/trunk: . logback-access logback-classic logback-core logback-site logback-skin
by noreply.seb＠qos.ch 09 Oct '06

09 Oct '06

Author: seb Date: Mon Oct 9 14:42:42 2006 New Revision: 641 Modified: logback/trunk/logback-access/pom.xml logback/trunk/logback-classic/pom.xml logback/trunk/logback-core/pom.xml logback/trunk/logback-site/pom.xml logback/trunk/logback-skin/ (props changed) logback/trunk/logback-skin/pom.xml logback/trunk/pom.xml Log: all poms to 0.4 before release Modified: logback/trunk/logback-access/pom.xml ============================================================================== --- logback/trunk/logback-access/pom.xml (original) +++ logback/trunk/logback-access/pom.xml Mon Oct 9 14:42:42 2006 @@ -5,7 +5,7 @@ <parent> <groupId>ch.qos.logback</groupId> <artifactId>logback</artifactId> - <version>0.4-SNAPSHOT</version> + <version>0.4</version> </parent> <modelVersion>4.0.0</modelVersion> Modified: logback/trunk/logback-classic/pom.xml ============================================================================== --- logback/trunk/logback-classic/pom.xml (original) +++ logback/trunk/logback-classic/pom.xml Mon Oct 9 14:42:42 2006 @@ -3,7 +3,7 @@ <parent> <groupId>ch.qos.logback</groupId> <artifactId>logback</artifactId> - <version>0.4-SNAPSHOT</version> + <version>0.4</version> </parent> <modelVersion>4.0.0</modelVersion> Modified: logback/trunk/logback-core/pom.xml ============================================================================== --- logback/trunk/logback-core/pom.xml (original) +++ logback/trunk/logback-core/pom.xml Mon Oct 9 14:42:42 2006 @@ -3,7 +3,7 @@ <parent> <groupId>ch.qos.logback</groupId> <artifactId>logback</artifactId> - <version>0.4-SNAPSHOT</version> + <version>0.4</version> </parent> <modelVersion>4.0.0</modelVersion> Modified: logback/trunk/logback-site/pom.xml ============================================================================== --- logback/trunk/logback-site/pom.xml (original) +++ logback/trunk/logback-site/pom.xml Mon Oct 9 14:42:42 2006 @@ -5,7 +5,7 @@ <parent> <groupId>ch.qos.logback</groupId> <artifactId>logback</artifactId> - <version>0.4-SNAPSHOT</version> + <version>0.4</version> </parent> <modelVersion>4.0.0</modelVersion> Modified: logback/trunk/logback-skin/pom.xml ============================================================================== --- logback/trunk/logback-skin/pom.xml (original) +++ logback/trunk/logback-skin/pom.xml Mon Oct 9 14:42:42 2006 @@ -5,7 +5,7 @@ <parent> <groupId>ch.qos.logback</groupId> <artifactId>logback</artifactId> - <version>0.4-SNAPSHOT</version> + <version>0.4</version> </parent> Modified: logback/trunk/pom.xml ============================================================================== --- logback/trunk/pom.xml (original) +++ logback/trunk/pom.xml Mon Oct 9 14:42:42 2006 @@ -6,7 +6,7 @@ <groupId>ch.qos.logback</groupId> <artifactId>logback</artifactId> - <version>0.4-SNAPSHOT</version> + <version>0.4</version> <packaging>pom</packaging> <name>Logback</name>

1 0

svn commit: r640 - in logback/trunk: logback-access/src/main/java/ch/qos/logback/access/net logback-core/examples/src/joran/calculator logback-core/examples/src/joran/helloWorld logback-core/examples/src/joran/implicit logback-core/examples/src/joran/newRule logback-site/src/site/xdocTemplates
by noreply.seb＠qos.ch 09 Oct '06

09 Oct '06

Author: seb Date: Mon Oct 9 14:38:44 2006 New Revision: 640 Added: logback/trunk/logback-core/examples/src/joran/calculator/readme.txt logback/trunk/logback-core/examples/src/joran/helloWorld/readme.txt logback/trunk/logback-core/examples/src/joran/implicit/readme.txt logback/trunk/logback-core/examples/src/joran/newRule/readme.txt Modified: logback/trunk/logback-access/src/main/java/ch/qos/logback/access/net/SMTPAppender.java logback/trunk/logback-site/src/site/xdocTemplates/documentation.xml logback/trunk/logback-site/src/site/xdocTemplates/joran.xml logback/trunk/logback-site/src/site/xdocTemplates/mailinglist.xml Log: - minor code fixes - added readMe in the core examples packages - modified joran documentation: WORK IN PROGRESS - added links to the archives of our mailing lists. Modified: logback/trunk/logback-access/src/main/java/ch/qos/logback/access/net/SMTPAppender.java ============================================================================== --- logback/trunk/logback-access/src/main/java/ch/qos/logback/access/net/SMTPAppender.java (original) +++ logback/trunk/logback-access/src/main/java/ch/qos/logback/access/net/SMTPAppender.java Mon Oct 9 14:38:44 2006 @@ -120,9 +120,9 @@ private boolean started; - private static final Integer TRIGGERING_STATUS_CODE = 500; + private static final int TRIGGERING_STATUS_CODE = 500; private static final long ONE_DAY = 1000*60*60*24; - private static long LAST_TRIGGER_DATE = 0L; + private long LAST_TRIGGER_DATE = 0L; /** @@ -138,7 +138,7 @@ public boolean isTriggeringEvent(File file, Object eventObject) { AccessEvent event = (AccessEvent) eventObject; - if (TRIGGERING_STATUS_CODE.compareTo(event.getStatusCode()) <= 0) { + if (TRIGGERING_STATUS_CODE <= event.getStatusCode()) { if (System.currentTimeMillis() >= LAST_TRIGGER_DATE + ONE_DAY) { LAST_TRIGGER_DATE = System.currentTimeMillis(); return true; Added: logback/trunk/logback-core/examples/src/joran/calculator/readme.txt ============================================================================== --- (empty file) +++ logback/trunk/logback-core/examples/src/joran/calculator/readme.txt Mon Oct 9 14:38:44 2006 @@ -0,0 +1,17 @@ ++------------------------------+ +| | +| Joran Examples | +| | +| Calculator | +| | ++------------------------------+ + +This directory contains the the calculator example. + +It shows how Actions can collaborate in order to accomplish a simple +computation. + +For more in-depth informations about this example, please visit: + +http://logback.qos.ch/joran.html#calculator + Added: logback/trunk/logback-core/examples/src/joran/helloWorld/readme.txt ============================================================================== --- (empty file) +++ logback/trunk/logback-core/examples/src/joran/helloWorld/readme.txt Mon Oct 9 14:38:44 2006 @@ -0,0 +1,16 @@ ++------------------------------+ +| | +| Joran Examples | +| | +| Hello World | +| | ++------------------------------+ + +This directory contains the simplest examples of the Joran tutorial. + +It includes a trivial action and a sample setup of Joran Interpreter. + +For more in-depth informations about this example, please visit: + +http://logback.qos.ch/joran.html#helloWorld + Added: logback/trunk/logback-core/examples/src/joran/implicit/readme.txt ============================================================================== --- (empty file) +++ logback/trunk/logback-core/examples/src/joran/implicit/readme.txt Mon Oct 9 14:38:44 2006 @@ -0,0 +1,17 @@ ++------------------------------+ +| | +| Joran Examples | +| | +| Implicit | +| | ++------------------------------+ + +This directory contains the implicit action example. + +It shows how to use implicit actions, which do not require an explicit +pattern. + +For more in-depth informations about this example, please visit: + +http://logback.qos.ch/joran.html#implicit + Added: logback/trunk/logback-core/examples/src/joran/newRule/readme.txt ============================================================================== --- (empty file) +++ logback/trunk/logback-core/examples/src/joran/newRule/readme.txt Mon Oct 9 14:38:44 2006 @@ -0,0 +1,17 @@ ++------------------------------+ +| | +| Joran Examples | +| | +| New rule | +| | ++------------------------------+ + +This directory contains an example using the new rule action. + +It shows how Joran can learn new rules on the fly, while interpreting +the xml file. + +For more in-depth informations about this example, please visit: + +http://logback.qos.ch/joran.html#newRule + Modified: logback/trunk/logback-site/src/site/xdocTemplates/documentation.xml ============================================================================== --- logback/trunk/logback-site/src/site/xdocTemplates/documentation.xml (original) +++ logback/trunk/logback-site/src/site/xdocTemplates/documentation.xml Mon Oct 9 14:38:44 2006 @@ -27,7 +27,7 @@ </li> <li> - <a href="joran.html">A introduction to Joran</a> + <a href="joran.html"><b>A introduction to Joran</b></a> </li> </ul> Modified: logback/trunk/logback-site/src/site/xdocTemplates/joran.xml ============================================================================== --- logback/trunk/logback-site/src/site/xdocTemplates/joran.xml (original) +++ logback/trunk/logback-site/src/site/xdocTemplates/joran.xml Mon Oct 9 14:38:44 2006 @@ -31,7 +31,8 @@ <em>LOGBACK_HOME/logback-core/examples/src/joran</em>. </p> -<p>Missing: setup instructions</p> +<p>To install joran, simply <a href="download.html">download</a> +logback and add logback core module to your classpath.</p> <h2>Historical perspective</h2> @@ -163,31 +164,70 @@ <code>StatusManager</code>. </p> +<a name="helloWorld" /> <h3>A hello world example</h3> <p>The <em>examples/src/joran/helloWorld/</em> directory includes a -trivial action and Joran interpreter setup which just diaplays "hello -world" when a <hello-world> element is encountered in an XML file. -Look into this example to learn about the basic steps which are +trivial action and Joran interpreter setup which just diaplays "Hello +World" when a <hello-world> element is encountered in an XML file. +It also includes the basic steps which are necessary to set up and invoke a Joran interpreter. </p> +<p> +The <em>hello.xml</em> file contains only one element, without any +other nested elements. The <code>HelloWorldAction</code> class is +a trivial implementation: it only prints "Hello World" in the console when +it's <code>begin()</code> method is called. +</p> +<p> +<code>HelloWorld</code> is a class that sets up the Joran interpreter, +with the minimal steps necessary: +</p> + +<ul> +  + <p>It creates a <code>RuleStore</code> and a <code>Context</code></p> + <p>It adds the <em>hello-world</em> pattern, with it's corresponding action</p> + <p>It creates a Joran interpreted, and passes the <code>RuleStore</code></p> + <p>It creates a SAX parser and parses the given file, specifying the newly created + Joran interpreter as the <code>ContentHandler</code></p> +</ul> + +<p> +It's last step is to print the content of the <code>Context</code>. +Since Joran uses logback's powerfull <code>Status</code> objects for +error reporting, one can have a good feedback on what happened during +the parsing. +</p> + +<p> +In this example, the parsing is rather simple. The <em>hello-world</em> element +will activate <code>HelloWorldAction</code>'s <code>begin()</code> and +<code>end()</code> methods. +In the first method, a simple call to <code>System.out.println()</code> +will be issued, displaying "Hello World" in the console. +</p> +<a name="calculator" /> <h3>Collaborating actions</h3> - +<p><em>More in-depths text to come</em></p> +<p> The examples/src/joran/calculator/ directory includes several actions which collaborate together through the common object stack in order to accomplish simple computations. - +</p> +<a name="newRule" /> <h3>New-rule action</h3> - +<p><em>More in-depths text to come</em></p> <p>Joran includes an action which allows the Joran interpreter to lean new rules on the fly while interpreting the XML file containing the new rules. See the <em>logback-core/examples/src/joran/newRule/</em> directory for sample code. </p> +<a name="implicit" /> <h3>Implicit actions </h3> - +<p><em>More in-depths text to come</em></p> <p>The rules defined thus far are called explicit rules because they require an explicit pattern, hence fixing the tag name of the elements for which they apply. Modified: logback/trunk/logback-site/src/site/xdocTemplates/mailinglist.xml ============================================================================== --- logback/trunk/logback-site/src/site/xdocTemplates/mailinglist.xml (original) +++ logback/trunk/logback-site/src/site/xdocTemplates/mailinglist.xml Mon Oct 9 14:38:44 2006 @@ -38,10 +38,10 @@ <table class="bodyTable"> <tr class="a"> <th>Name</th> - <th>Volume</th> + <th>Volume</th> <th>Subscribe</th> <th>Unsubscribe</th> - <th>Archive</th> + <th>Archives</th> </tr> <tr class="b"> <td>Logback Announce List</td> @@ -53,12 +53,23 @@ </a> </td> <td> - <a href="http://qos.ch/mailman/options/logback-announce">Unsubscribe</a> - </td> + <a + href="http://qos.ch/mailman/options/logback-announce"> + Unsubscribe + </a> + </td> <td> <a href="http://www.qos.ch/pipermail/logback-announce/"> - www.qos.ch + qos.ch + </a> + <a + href="http://marc.theaimsgroup.com/?l=logback-announce"> + MARC + </a> + <a + href="http://www.nabble.com/Logback-Announce-f16251.html"> + Nabble </a> </td> </tr> @@ -76,17 +87,26 @@ href="http://qos.ch/mailman/options/logback-user"> Unsubscribe </a> - </td> + </td> <td> <a href="http://www.qos.ch/pipermail/logback-user/"> - www.qos.ch + qos.ch + </a> + <a + href="http://marc.theaimsgroup.com/?l=logback-user"> + MARC + </a> + + <a + href="http://www.nabble.com/Logback-User-f16252.html"> + Nabble </a> </td> </tr> <tr class="b"> <td>Logback Dev List</td> - <td>Medium</td> + <td>Medium</td> <td> <a href="http://qos.ch/mailman/listinfo/logback-dev"> @@ -98,11 +118,19 @@ href="http://qos.ch/mailman/options/logback-dev"> Unsubscribe </a> - </td> + </td> <td> <a href="http://www.qos.ch/pipermail/logback-dev/"> - www.qos.ch + qos.ch + </a> + <a + href="http://marc.theaimsgroup.com/?l=logback-dev"> + MARC + </a> + <a + href="http://www.nabble.com/Logback-Dev-f16253.html"> + Nabble </a> </td> </tr>

1 0