[logback-dev] svn commit: r1112 - in logback/trunk: logback-examples/src/main/java/chapter3 logback-examples/src/main/java/chapter3/calculator logback-examples/src/main/java/chapter3/helloWorld logback-examples/src/main/java/chapter3/implicit logback-examples/src/main/java/chapter3/newRule logback-site/src/site/xdocTemplates/manual
noreply.seb at qos.ch
noreply.seb at qos.ch
Mon Dec 18 16:31:08 CET 2006
Author: seb
Date: Mon Dec 18 16:31:07 2006
New Revision: 1112
Modified:
logback/trunk/logback-examples/src/main/java/chapter3/SimpleConfigurator.java
logback/trunk/logback-examples/src/main/java/chapter3/calculator/AddAction.java
logback/trunk/logback-examples/src/main/java/chapter3/calculator/Calculator1.java
logback/trunk/logback-examples/src/main/java/chapter3/calculator/Calculator2.java
logback/trunk/logback-examples/src/main/java/chapter3/calculator/ComputationAction1.java
logback/trunk/logback-examples/src/main/java/chapter3/calculator/ComputationAction2.java
logback/trunk/logback-examples/src/main/java/chapter3/calculator/LiteralAction.java
logback/trunk/logback-examples/src/main/java/chapter3/calculator/MultiplyAction.java
logback/trunk/logback-examples/src/main/java/chapter3/calculator/readme.txt
logback/trunk/logback-examples/src/main/java/chapter3/helloWorld/HelloWorld.java
logback/trunk/logback-examples/src/main/java/chapter3/helloWorld/HelloWorldAction.java
logback/trunk/logback-examples/src/main/java/chapter3/helloWorld/readme.txt
logback/trunk/logback-examples/src/main/java/chapter3/implicit/NOPAction.java
logback/trunk/logback-examples/src/main/java/chapter3/implicit/PrintMe.java
logback/trunk/logback-examples/src/main/java/chapter3/implicit/PrintMeImplicitAction.java
logback/trunk/logback-examples/src/main/java/chapter3/implicit/readme.txt
logback/trunk/logback-examples/src/main/java/chapter3/newRule/NewRuleCalculator.java
logback/trunk/logback-examples/src/main/java/chapter3/newRule/new-rule.xml
logback/trunk/logback-examples/src/main/java/chapter3/newRule/readme.txt
logback/trunk/logback-site/src/site/xdocTemplates/manual/joran.xml
Log:
examples refactoring
on going work in documentation
Modified: logback/trunk/logback-examples/src/main/java/chapter3/SimpleConfigurator.java
==============================================================================
--- logback/trunk/logback-examples/src/main/java/chapter3/SimpleConfigurator.java (original)
+++ logback/trunk/logback-examples/src/main/java/chapter3/SimpleConfigurator.java Mon Dec 18 16:31:07 2006
@@ -7,7 +7,7 @@
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation.
*/
-package joran;
+package chapter3;
import java.util.List;
import java.util.Map;
Modified: logback/trunk/logback-examples/src/main/java/chapter3/calculator/AddAction.java
==============================================================================
--- logback/trunk/logback-examples/src/main/java/chapter3/calculator/AddAction.java (original)
+++ logback/trunk/logback-examples/src/main/java/chapter3/calculator/AddAction.java Mon Dec 18 16:31:07 2006
@@ -8,17 +8,17 @@
* Software Foundation.
*/
-package joran.calculator;
+package chapter3.calculator;
+import java.util.EmptyStackException;
+
import org.xml.sax.Attributes;
import ch.qos.logback.core.joran.action.Action;
import ch.qos.logback.core.joran.spi.InterpretationContext;
-import java.util.EmptyStackException;
-
/**
* This action adds the two integers at the top of the stack (they are removed)
Modified: logback/trunk/logback-examples/src/main/java/chapter3/calculator/Calculator1.java
==============================================================================
--- logback/trunk/logback-examples/src/main/java/chapter3/calculator/Calculator1.java (original)
+++ logback/trunk/logback-examples/src/main/java/chapter3/calculator/Calculator1.java Mon Dec 18 16:31:07 2006
@@ -8,18 +8,18 @@
* Software Foundation.
*/
-package joran.calculator;
+package chapter3.calculator;
import java.util.HashMap;
import java.util.Map;
-import joran.SimpleConfigurator;
import ch.qos.logback.core.Context;
import ch.qos.logback.core.ContextBase;
import ch.qos.logback.core.joran.action.Action;
import ch.qos.logback.core.joran.spi.JoranException;
import ch.qos.logback.core.joran.spi.Pattern;
import ch.qos.logback.core.util.StatusPrinter;
+import chapter3.SimpleConfigurator;
/**
* This examples illustrates collaboration between multiple actions through the
Modified: logback/trunk/logback-examples/src/main/java/chapter3/calculator/Calculator2.java
==============================================================================
--- logback/trunk/logback-examples/src/main/java/chapter3/calculator/Calculator2.java (original)
+++ logback/trunk/logback-examples/src/main/java/chapter3/calculator/Calculator2.java Mon Dec 18 16:31:07 2006
@@ -7,18 +7,18 @@
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation.
*/
-package joran.calculator;
+package chapter3.calculator;
import java.util.HashMap;
import java.util.Map;
-import joran.SimpleConfigurator;
import ch.qos.logback.core.Context;
import ch.qos.logback.core.ContextBase;
import ch.qos.logback.core.joran.action.Action;
import ch.qos.logback.core.joran.spi.JoranException;
import ch.qos.logback.core.joran.spi.Pattern;
import ch.qos.logback.core.util.StatusPrinter;
+import chapter3.SimpleConfigurator;
/**
Modified: logback/trunk/logback-examples/src/main/java/chapter3/calculator/ComputationAction1.java
==============================================================================
--- logback/trunk/logback-examples/src/main/java/chapter3/calculator/ComputationAction1.java (original)
+++ logback/trunk/logback-examples/src/main/java/chapter3/calculator/ComputationAction1.java Mon Dec 18 16:31:07 2006
@@ -8,7 +8,7 @@
* Software Foundation.
*/
-package joran.calculator;
+package chapter3.calculator;
Modified: logback/trunk/logback-examples/src/main/java/chapter3/calculator/ComputationAction2.java
==============================================================================
--- logback/trunk/logback-examples/src/main/java/chapter3/calculator/ComputationAction2.java (original)
+++ logback/trunk/logback-examples/src/main/java/chapter3/calculator/ComputationAction2.java Mon Dec 18 16:31:07 2006
@@ -8,7 +8,7 @@
* Software Foundation.
*/
-package joran.calculator;
+package chapter3.calculator;
import java.util.Stack;
Modified: logback/trunk/logback-examples/src/main/java/chapter3/calculator/LiteralAction.java
==============================================================================
--- logback/trunk/logback-examples/src/main/java/chapter3/calculator/LiteralAction.java (original)
+++ logback/trunk/logback-examples/src/main/java/chapter3/calculator/LiteralAction.java Mon Dec 18 16:31:07 2006
@@ -8,7 +8,7 @@
* Software Foundation.
*/
-package joran.calculator;
+package chapter3.calculator;
import org.xml.sax.Attributes;
Modified: logback/trunk/logback-examples/src/main/java/chapter3/calculator/MultiplyAction.java
==============================================================================
--- logback/trunk/logback-examples/src/main/java/chapter3/calculator/MultiplyAction.java (original)
+++ logback/trunk/logback-examples/src/main/java/chapter3/calculator/MultiplyAction.java Mon Dec 18 16:31:07 2006
@@ -8,7 +8,7 @@
* Software Foundation.
*/
-package joran.calculator;
+package chapter3.calculator;
import org.xml.sax.Attributes;
Modified: logback/trunk/logback-examples/src/main/java/chapter3/calculator/readme.txt
==============================================================================
--- logback/trunk/logback-examples/src/main/java/chapter3/calculator/readme.txt (original)
+++ logback/trunk/logback-examples/src/main/java/chapter3/calculator/readme.txt Mon Dec 18 16:31:07 2006
@@ -13,5 +13,5 @@
For more in-depth informations about this example, please visit:
-http://logback.qos.ch/joran.html#calculator
+http://logback.qos.ch/manual/joran.html#calculator
Modified: logback/trunk/logback-examples/src/main/java/chapter3/helloWorld/HelloWorld.java
==============================================================================
--- logback/trunk/logback-examples/src/main/java/chapter3/helloWorld/HelloWorld.java (original)
+++ logback/trunk/logback-examples/src/main/java/chapter3/helloWorld/HelloWorld.java Mon Dec 18 16:31:07 2006
@@ -8,12 +8,12 @@
* Software Foundation.
*/
-package joran.helloWorld;
+package chapter3.helloWorld;
import java.util.HashMap;
import java.util.Map;
-import joran.SimpleConfigurator;
+import chapter3.SimpleConfigurator;
import ch.qos.logback.core.Context;
import ch.qos.logback.core.ContextBase;
import ch.qos.logback.core.joran.action.Action;
Modified: logback/trunk/logback-examples/src/main/java/chapter3/helloWorld/HelloWorldAction.java
==============================================================================
--- logback/trunk/logback-examples/src/main/java/chapter3/helloWorld/HelloWorldAction.java (original)
+++ logback/trunk/logback-examples/src/main/java/chapter3/helloWorld/HelloWorldAction.java Mon Dec 18 16:31:07 2006
@@ -8,7 +8,7 @@
* Software Foundation.
*/
-package joran.helloWorld;
+package chapter3.helloWorld;
Modified: logback/trunk/logback-examples/src/main/java/chapter3/helloWorld/readme.txt
==============================================================================
--- logback/trunk/logback-examples/src/main/java/chapter3/helloWorld/readme.txt (original)
+++ logback/trunk/logback-examples/src/main/java/chapter3/helloWorld/readme.txt Mon Dec 18 16:31:07 2006
@@ -12,5 +12,5 @@
For more in-depth informations about this example, please visit:
-http://logback.qos.ch/joran.html#helloWorld
+http://logback.qos.ch/manual/joran.html#helloWorld
Modified: logback/trunk/logback-examples/src/main/java/chapter3/implicit/NOPAction.java
==============================================================================
--- logback/trunk/logback-examples/src/main/java/chapter3/implicit/NOPAction.java (original)
+++ logback/trunk/logback-examples/src/main/java/chapter3/implicit/NOPAction.java Mon Dec 18 16:31:07 2006
@@ -7,7 +7,7 @@
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation.
*/
-package joran.implicit;
+package chapter3.implicit;
import org.xml.sax.Attributes;
Modified: logback/trunk/logback-examples/src/main/java/chapter3/implicit/PrintMe.java
==============================================================================
--- logback/trunk/logback-examples/src/main/java/chapter3/implicit/PrintMe.java (original)
+++ logback/trunk/logback-examples/src/main/java/chapter3/implicit/PrintMe.java Mon Dec 18 16:31:07 2006
@@ -7,14 +7,14 @@
* the terms of the GNU Lesser General Public License as published by the Free
* Software Foundation.
*/
-package joran.implicit;
+package chapter3.implicit;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
-import joran.SimpleConfigurator;
+import chapter3.SimpleConfigurator;
import ch.qos.logback.core.Context;
import ch.qos.logback.core.ContextBase;
import ch.qos.logback.core.joran.action.Action;
Modified: logback/trunk/logback-examples/src/main/java/chapter3/implicit/PrintMeImplicitAction.java
==============================================================================
--- logback/trunk/logback-examples/src/main/java/chapter3/implicit/PrintMeImplicitAction.java (original)
+++ logback/trunk/logback-examples/src/main/java/chapter3/implicit/PrintMeImplicitAction.java Mon Dec 18 16:31:07 2006
@@ -8,7 +8,7 @@
* Software Foundation.
*/
-package joran.implicit;
+package chapter3.implicit;
import org.xml.sax.Attributes;
Modified: logback/trunk/logback-examples/src/main/java/chapter3/implicit/readme.txt
==============================================================================
--- logback/trunk/logback-examples/src/main/java/chapter3/implicit/readme.txt (original)
+++ logback/trunk/logback-examples/src/main/java/chapter3/implicit/readme.txt Mon Dec 18 16:31:07 2006
@@ -13,5 +13,5 @@
For more in-depth informations about this example, please visit:
-http://logback.qos.ch/joran.html#implicit
+http://logback.qos.ch/manual/joran.html#implicit
Modified: logback/trunk/logback-examples/src/main/java/chapter3/newRule/NewRuleCalculator.java
==============================================================================
--- logback/trunk/logback-examples/src/main/java/chapter3/newRule/NewRuleCalculator.java (original)
+++ logback/trunk/logback-examples/src/main/java/chapter3/newRule/NewRuleCalculator.java Mon Dec 18 16:31:07 2006
@@ -8,13 +8,11 @@
* Software Foundation.
*/
-package joran.newRule;
+package chapter3.newRule;
import java.util.HashMap;
import java.util.Map;
-import joran.SimpleConfigurator;
-import joran.calculator.ComputationAction2;
import ch.qos.logback.core.Context;
import ch.qos.logback.core.ContextBase;
import ch.qos.logback.core.joran.action.Action;
@@ -22,6 +20,8 @@
import ch.qos.logback.core.joran.spi.JoranException;
import ch.qos.logback.core.joran.spi.Pattern;
import ch.qos.logback.core.util.StatusPrinter;
+import chapter3.SimpleConfigurator;
+import chapter3.calculator.ComputationAction2;
/**
Modified: logback/trunk/logback-examples/src/main/java/chapter3/newRule/new-rule.xml
==============================================================================
--- logback/trunk/logback-examples/src/main/java/chapter3/newRule/new-rule.xml (original)
+++ logback/trunk/logback-examples/src/main/java/chapter3/newRule/new-rule.xml Mon Dec 18 16:31:07 2006
@@ -10,11 +10,11 @@
<computation name="toto">
<new-rule pattern="*/computation/literal"
- actionClass="joran.calculator.LiteralAction"/>
+ actionClass="chapter3.calculator.LiteralAction"/>
<new-rule pattern="*/computation/add"
- actionClass="joran.calculator.AddAction"/>
+ actionClass="chapter3.calculator.AddAction"/>
<new-rule pattern="*/computation/multiply"
- actionClass="joran.calculator.MultiplyAction"/>
+ actionClass="chapter3.calculator.MultiplyAction"/>
<computation>
<literal value="7"/>
Modified: logback/trunk/logback-examples/src/main/java/chapter3/newRule/readme.txt
==============================================================================
--- logback/trunk/logback-examples/src/main/java/chapter3/newRule/readme.txt (original)
+++ logback/trunk/logback-examples/src/main/java/chapter3/newRule/readme.txt Mon Dec 18 16:31:07 2006
@@ -13,5 +13,5 @@
For more in-depth informations about this example, please visit:
-http://logback.qos.ch/joran.html#newRule
+http://logback.qos.ch/manual/joran.html#newRule
Modified: logback/trunk/logback-site/src/site/xdocTemplates/manual/joran.xml
==============================================================================
--- logback/trunk/logback-site/src/site/xdocTemplates/manual/joran.xml (original)
+++ logback/trunk/logback-site/src/site/xdocTemplates/manual/joran.xml Mon Dec 18 16:31:07 2006
@@ -13,6 +13,36 @@
Authors: Ceki Gülcü, Sébastien Pennec
</div>
+ <table>
+ <tr>
+ <td valign="top" align="top">
+ <a rel="license"
+ href="http://creativecommons.org/licenses/by-nc-sa/2.5/">
+ <img alt="Creative Commons License"
+ style="border-width: 0"
+ src="http://creativecommons.org/images/public/somerights20.png" />
+ </a>
+ </td>
+ <td>
+ <p>Copyright © 2000-2006, QOS.ch</p>
+
+ <p>
+ <!--Creative Commons License-->
+ This work is licensed under a
+ <a rel="license"
+ href="http://creativecommons.org/licenses/by-nc-sa/2.5/">
+ Creative Commons
+ Attribution-NonCommercial-ShareAlike 2.5
+ License
+ </a>
+ .
+ <!--/Creative Commons License-->
+ </p>
+ </td>
+ </tr>
+ </table>
+
+
<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
the middle of Europe, the Leman happens to be the continent's largest
@@ -79,14 +109,14 @@
and actions lies at the core of Joran. Quite remarkably, one can deal
with quite complex requirements by using simple patterns, or more
precisely with exact matches and wildcard matches. For example, the
-pattern "a/b" will match a <code><b></code> element nested within
+pattern <em>a/b</em> will match a <code><b></code> element nested within
an <code><a></code> element but not a <code><c></code> element,
even if nested within a <code><b></code> element. It is also
possible to match a particular XML element, regardless of its nesting
-level, by using the "*" wildcard character. For example, the pattern
-"*/a" will match an <code><a></code> element at any nesting
+level, by using the <em>*</em> wildcard character. For example, the pattern
+<em>*/a</em> will match an <code><a></code> element at any nesting
position within the document. Other types of patterns, for example
-"a/*", are not currently supported by Joran.
+<em>a/*</em>, are not currently supported by Joran.
</p>
<h2>SAX or DOM?</h2>
@@ -172,25 +202,26 @@
<a name="helloWorld" />
<h3>A hello world example</h3>
-<p>The <em>logback-examples/src/main/java/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.
+<p>The <em>logback-examples/src/main/java/chapter3/helloWorld/</em> directory includes a
+trivial action and Joran interpreter setup which just displays <em>Hello
+World</em> 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
+other nested elements. The <a href="../xref/chapter3/helloWorld/HelloWorldAction.html">
+<code>HelloWorldAction</code></a> 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,
+<a href="../xref/chapter3/helloWorld/HelloWorld.html"><code>HelloWorld</code></a>
+is a class that sets up the Joran interpreter,
with the minimal steps necessary:
</p>
<ul>
- <!-- Pretty dirty, thanks site-generation... -->
<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 interpreter, and passes the <code>RuleStore</code></p>
@@ -201,7 +232,7 @@
<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
+error reporting, one can have a good feedback on what happened during
the parsing.
</p>
@@ -210,13 +241,13 @@
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.
+will be issued, displaying <em>Hello World</em> in the console.
</p>
<a name="calculator" />
<h3>Collaborating actions</h3>
<p>
-The logback-examples/src/main/java/joran/calculator/ directory includes several actions
+The <em>logback-examples/src/main/java/joran/calculator/</em> directory includes several actions
which collaborate together through the common object stack in order
to accomplish simple computations.
</p>
@@ -225,17 +256,21 @@
with a nested <code>literal</code> element.
</p>
<p>
-In the <code>Calculator1</code> class, we declare various patterns and actions,
+In the <a href="../xref/chapter3/calculator/Calculator1.html">
+<code>Calculator1</code></a> 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
+ <p>The <a href="../xref/chapter3/calculator/ComputationAction1.html">
+ <code>ComputationAction1</code></a> class' <code>begin()</code> method
is called</p>
- <p>The <code>LiteralAction</code> class' <code>begin()</code> and <code>end()</code>
+ <p>The <a href="../xref/chapter3/calculator/LiteralAction.html">
+ <code>LiteralAction</code></a> class' <code>begin()</code> and <code>end()</code>
methods are called</p>
- <p>The <code>ComputationAction1</code> class' <code>end()</code> method
+ <p>The <a href="../xref/chapter3/calculator/ComputationAction1.html">
+ <code>ComputationAction1</code></a> class' <code>end()</code> method
is called</p>
</ul>
<p>
@@ -246,7 +281,7 @@
<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>The <em>calculator2.xml</em> file is a bit more complex, but much more interesting.</p>
<p>It contains the following elements:</p>
<div class="source"><pre><computation name="toto">
<literal value="7"/>
@@ -258,10 +293,12 @@
<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
+<p>When called, the <a href="../xref/chapter3/calculator/AddAction.html">
+<code>AddAction</code></a> 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.
+<p>Later in the computation, the <a href="../xref/chapter3/calculator/MultiplyAction.html">
+<code>MultiplyAction</code></a> 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
@@ -283,9 +320,10 @@
<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 href="../xref/chapter3/calculator/ComputationAction2.html">
+<code>ComputationAction2</code></a> class using an internal stack. The well-formedness
+of XML will guarantee that a value saved by one <code>begin()</code> will be consumed
+only by the matching <code>end()</code> method.</p>
<a name="newRule" />
<h3>New-rule action</h3>
@@ -294,7 +332,8 @@
new rules. See the <em>logback-examples/src/main/java/joran/newRule/</em>
directory for sample code.
</p>
-<p>In this package, the <code>NewRuleCalculator</code> class contains
+<p>In this package, the <a href="../xref/chapter3/newRule/NewRuleCalculator.html">
+<code>NewRuleCalculator</code></a> class contains
the same setup as we have seen so far, but for one line:</p>
<source>ruleStore.addRule(new Pattern("/computation/new-rule"), new NewRuleAction());</source>
@@ -310,18 +349,18 @@
<p>Here is how new rules can be declared in an xml file:</p>
-<div class="source"><pre><new-rule pattern="*/computation/literal" actionClass="joran.calculator.LiteralAction"/></pre></div>
+<div class="source"><pre><new-rule pattern="*/computation/literal" actionClass="chapter3.calculator.LiteralAction"/></pre></div>
<p>Using new rule declarations, the preceding example, involving the calculation, could be
expressed this way:</p>
<div class="source"><pre><computation name="toto">
<new-rule pattern="*/computation/literal"
- actionClass="joran.calculator.LiteralAction"/>
+ actionClass="chapter3.calculator.LiteralAction"/>
<new-rule pattern="*/computation/add"
- actionClass="joran.calculator.AddAction"/>
+ actionClass="chapter3.calculator.AddAction"/>
<new-rule pattern="*/computation/multiply"
- actionClass="joran.calculator.MultiplyAction"/>
+ actionClass="chapter3.calculator.MultiplyAction"/>
<computation>
<literal value="7"/>
@@ -350,8 +389,9 @@
rules come in very handy when processing components composed of
sub-components unknown ahead of time. For example, Apache Ant is
capable of handling tasks which contain tags unknown at compile time
-by looking at methods whose names start with add, as in addFile, or
-addClassPath. When Ant encounters an embedded tag within a task, it
+by looking at methods whose names start with <em>add</em>, as in
+<code>addFile</code>, or <code>addClassPath</code>.
+When Ant encounters an embedded tag within a task, it
simply instantiates an object that matches the signature of the task
class' add method and attaches the resulting object to the parent.
</p>
@@ -368,7 +408,10 @@
given situation.
</p>
-<p>For example, the NestedComponentIA extending ImplicitAction , will
+<p>For example, the <a href="../xref/ch/qos/logback/core/joran/action/NestedComponentIA.html">
+<code>NestedComponentIA</code></a> extending
+<a href="../xref/ch/qos/logback/core/joran/action/ImplicitAction.html">
+<code>ImplicitAction</code></a> , will
instantiate the class specified in a nested component and attach it
to the parent component by using setter method of the parent
component and the nested element's name. Under certain circumstances,
@@ -379,7 +422,7 @@
implicit action.
</p>
-<p>Both ImplicitAction and NestedComponentIA are located in the
+<p>Both <code>ImplicitAction</code> and <code>NestedComponentIA</code> are located in the
<code>ch.qos.logback.core.joran.action</code> package.
</p>
@@ -390,12 +433,15 @@
<p>In that directory, you will find two actions classes, one xml file and one
class containing the setup of Joran.</p>
-<p>The <code>NOPAction</code> class does nothing. It is used to set
+<p>The <a href="../xref/chapter3/implicit/NOPAction.html">
+<code>NOPAction</code></a> class does nothing. It is used to set
the context of the <em>foo</em> element, using this line:</p>
<source>ruleStore.addRule(new Pattern("*/foo"), new NOPAction());</source>
-<p>After that, the implicit action, namely <code>PrintMeImplicitAction</code>,
+<p>After that, the implicit action, namely
+<a href="../xref/chapter3/implicit/PrintMeImplicitAction.html">
+<code>PrintMeImplicitAction</code></a>,
is added to the <code>RuleStore</code>. This is done by simply adding a new
instance of the action to the <code>Joran interpreter</code></p>
More information about the logback-dev
mailing list