You are viewing a plain text version of this content. The canonical link for it is here.
Posted to scm@excalibur.apache.org by rd...@apache.org on 2009/06/16 19:55:28 UTC
svn commit: r785324 [17/28] - in /excalibur/site: ./ css/ developing/ event/
fortress/ framework/ images/logos/ instrument/ lifecycle/ sourceresolve/
store/ xmlutil/
Modified: excalibur/site/framework/lifecycle.html
URL: http://svn.apache.org/viewvc/excalibur/site/framework/lifecycle.html?rev=785324&r1=785323&r2=785324&view=diff
==============================================================================
--- excalibur/site/framework/lifecycle.html (original)
+++ excalibur/site/framework/lifecycle.html Tue Jun 16 17:55:25 2009
@@ -1,142 +1,594 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Apache Excalibur - </title><style type="text/css" media="all">
- @import url("../style/maven-base.css");
-
- @import url("../style/maven-theme.css");</style><link rel="stylesheet" href="../style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://www.apache.org/" id="organizationLogo"><img alt="The Apache Software Foundation" src="http://www.apache.org/images/asf-logo.gif"></img></a><a href="http://excalibur.apache.org/" id="projectLogo"><img alt="Apache Excalibur" src="http://excalibur.apache.org/logo.gif"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xright">
-
- <a href="../index.html">Home</a>
-
-
-
- <span class="separator">|</span>
-
-
- <a href="../fortress/index.html">Fortress</a>
-
-
-
- <span class="separator">|</span>
-
-
- <a href="../component-list.html">Components</a>
-
-
-
- <span class="separator">|</span>
-
-
- <a href="../containerkit.html">Containerkit</a>
- </div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuEssentials"><h5>Essentials</h5><ul><li class="none"><a href="../index.html">Overview</a></li><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li><li class="none"><a href="../svn.html">Subversion</a></li><li class="none"><a href="http://wiki.apache.org/excalibur/" class="externalLink" title="External Link">Wiki</a></li><li class="none"><a href="http://wiki.apache.org/excalibur/FrequentlyAskedQuestions" class="externalLink" title="External Link">FAQ</a></li><li class="none"><a href="http://excalibur.apache.org/apidocs/" class="externalLink" title="External Link">Javadocs</a></li><li class="none"><a href="http://excalibur.apache.org/download.cgi" class="externalLink" title="External Link">Download</a></li><li class="none"><a href="../issue-tracking.html">Issue Tracking</a></li><li class="collapsed"><a href="../misc.html">Miscellaneous</a></li></ul></div><div
id="menuFortress"><h5>Fortress</h5><ul><li class="none"><a href="../fortress/index.html">Overview</a></li><li class="none"><a href="../fortress/features.html">Features Oriented</a></li><li class="none"><a href="../fortress/getting-started.html">Getting Started</a></li><li class="none"><a href="../fortress/using-meta-info.html">Using Meta Info</a></li><li class="none"><a href="../fortress/cli.html">CLI</a></li><li class="none"><a href="../fortress/swing.html">Swing</a></li><li class="none"><a href="../fortress/servlet.html">Servlet</a></li><li class="none"><a href="../lifecycle/index.html">Lifecycle Extensions</a></li><li class="none"><a href="../fortress/design-notes.html">Design Notes</a></li></ul></div><div id="menuFramework"><h5>Framework</h5><ul><li class="expanded"><a href="../framework/index.html">Documentation</a><ul><li class="none"><strong><a href="../framework/lifecycle.html">Lifecycle</a></strong></li><li class="none"><a href="../framework/guide-cop-in-avalon.htm
l">COP in Avalon</a></li><li class="none"><a href="../framework/guide-patterns-avalon.html">Patterns in Avalon</a></li><li class="none"><a href="../framework/guide-patterns-ioc.html">IOC Patterns</a></li><li class="none"><a href="../framework/guide-patterns-ioc-security.html">IOC Security</a></li><li class="none"><a href="../framework/guide-patterns-soc.html">Seperation of Concerns</a></li><li class="none"><a href="../framework/guide-patterns-soii.html">Interface and Implementation</a></li><li class="none"><a href="../framework/component-design.html">Designing Components</a></li><li class="none"><a href="../framework/best-practices.html">Best Practices</a></li></ul></li><li class="collapsed"><a href="../developing/index.html">Developing</a></li></ul></div><div id="menuComponents"><h5>Components</h5><ul><li class="none"><a href="../component-list.html">Overview</a></li><li class="collapsed"><a href="../sourceresolve/index.html">Sourceresolver</a></li><li class="collapsed"><a
href="../store/index.html">Store</a></li><li class="none"><a href="../thread.html">Thread</a></li><li class="collapsed"><a href="../xmlutil/index.html">XMLUtil</a></li></ul></div><div id="menuContainerkit"><h5>Containerkit</h5><ul><li class="none"><a href="../containerkit.html">Overview</a></li><li class="collapsed"><a href="../instrument/index.html">Instrument</a></li><li class="collapsed"><a href="../lifecycle/index.html">Lifecycle</a></li><li class="none"><a href="../logger.html">Logger</a></li></ul></div><div id="menuDeprecated_Materials"><h5>Deprecated Materials</h5><ul><li class="none"><a href="../deprecation.html">Overview</a></li><li class="expanded"><a href="../deprecation.html">Old Documentation</a><ul><li class="none"><a href="../component.html">ECM</a></li><li class="collapsed"><a href="../event/index.html">Event</a></li><li class="none"><a href="../configuration.html">Configuration</a></li></ul></li></ul></div><div id="menuThanks"><h5>Thanks</h5><ul><li class="n
one"><a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="External Link">to our sponsors!</a></li><li class="none"><a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="External Link">Sponsor the ASF</a></li></ul></div><div id="menuProject_Documentation"><h5>Project Documentation</h5><ul><li class="none"><a href="../index.html">About Apache Excalibur</a></li><li class="collapsed"><a href="../project-info.html">Project Info</a></li><li class="collapsed"><a href="../maven-reports.html">Project Reports</a></li><li class="none"><a href="http://maven.apache.org/development-process.html" class="externalLink" title="External Link">Development Process</a></li></ul></div></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Introduction"></a><h2>Introduction</h2><p>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+
+
+
+
+
+
+
+
+
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+ <title>Excalibur - </title>
+ <style type="text/css" media="all">
+ @import url("../css/maven-base.css");
+ @import url("../css/maven-theme.css");
+ @import url("../css/site.css");
+ </style>
+ <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <span id="bannerLeft">
+
+ Excalibur
+
+ </span>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+
+
+
+
+
+
+ <div class="xleft">
+ Last Published: 2009-06-16
+ </div>
+ <div class="xright"> <a href="../index.html">Home</a>
+ |
+ <a href="../fortress/index.html">Fortress</a>
+ |
+ <a href="../component-list.html">Components</a>
+ |
+ <a href="../containerkit.html">Containerkit</a>
+
+
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+
+
+
+
+
+
+ <h5>Essentials</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../index.html">Overview</a>
+ </li>
+
+ <li class="none">
+ <a href="../mail-lists.html">Mailing Lists</a>
+ </li>
+
+ <li class="none">
+ <a href="../svn.html">Subversion</a>
+ </li>
+
+ <li class="none">
+ <a href="http://wiki.apache.org/excalibur/" class="externalLink">Wiki</a>
+ </li>
+
+ <li class="none">
+ <a href="http://wiki.apache.org/excalibur/FrequentlyAskedQuestions" class="externalLink">FAQ</a>
+ </li>
+
+ <li class="none">
+ <a href="http://excalibur.apache.org/apidocs/" class="externalLink">Javadocs</a>
+ </li>
+
+ <li class="none">
+ <a href="http://excalibur.apache.org/download.cgi" class="externalLink">Download</a>
+ </li>
+
+ <li class="none">
+ <a href="../issue-tracking.html">Issue Tracking</a>
+ </li>
+
+
+
+
+
+
+
+
+
+ <li class="collapsed">
+ <a href="../misc.html">Miscellaneous</a>
+ </li>
+ </ul>
+ <h5>Fortress</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../fortress/index.html">Overview</a>
+ </li>
+
+ <li class="none">
+ <a href="../fortress/features.html">Features Oriented</a>
+ </li>
+
+ <li class="none">
+ <a href="../fortress/getting-started.html">Getting Started</a>
+ </li>
+
+ <li class="none">
+ <a href="../fortress/using-meta-info.html">Using Meta Info</a>
+ </li>
+
+ <li class="none">
+ <a href="../fortress/cli.html">CLI</a>
+ </li>
+
+ <li class="none">
+ <a href="../fortress/swing.html">Swing</a>
+ </li>
+
+ <li class="none">
+ <a href="../fortress/servlet.html">Servlet</a>
+ </li>
+
+ <li class="none">
+ <a href="../lifecycle/index.html">Lifecycle Extensions</a>
+ </li>
+
+ <li class="none">
+ <a href="../fortress/design-notes.html">Design Notes</a>
+ </li>
+ </ul>
+ <h5>Framework</h5>
+ <ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li class="expanded">
+ <a href="../framework/index.html">Documentation</a>
+ <ul>
+
+ <li class="none">
+ <strong>Lifecycle</strong>
+ </li>
+
+ <li class="none">
+ <a href="../framework/guide-cop-in-avalon.html">COP in Avalon</a>
+ </li>
+
+ <li class="none">
+ <a href="../framework/guide-patterns-avalon.html">Patterns in Avalon</a>
+ </li>
+
+ <li class="none">
+ <a href="../framework/guide-patterns-ioc.html">IOC Patterns</a>
+ </li>
+
+ <li class="none">
+ <a href="../framework/guide-patterns-ioc-security.html">IOC Security</a>
+ </li>
+
+ <li class="none">
+ <a href="../framework/guide-patterns-soc.html">Seperation of Concerns</a>
+ </li>
+
+ <li class="none">
+ <a href="../framework/guide-patterns-soii.html">Interface and Implementation</a>
+ </li>
+
+ <li class="none">
+ <a href="../framework/component-design.html">Designing Components</a>
+ </li>
+
+ <li class="none">
+ <a href="../framework/best-practices.html">Best Practices</a>
+ </li>
+ </ul>
+ </li>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li class="collapsed">
+ <a href="../developing/index.html">Developing</a>
+ </li>
+ </ul>
+ <h5>Components</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../component-list.html">Overview</a>
+ </li>
+
+
+
+
+
+ <li class="collapsed">
+ <a href="../sourceresolve/index.html">Sourceresolver</a>
+ </li>
+
+
+
+
+
+ <li class="collapsed">
+ <a href="../store/index.html">Store</a>
+ </li>
+
+ <li class="none">
+ <a href="../thread.html">Thread</a>
+ </li>
+
+
+
+
+
+ <li class="collapsed">
+ <a href="../xmlutil/index.html">XMLUtil</a>
+ </li>
+ </ul>
+ <h5>Containerkit</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../containerkit.html">Overview</a>
+ </li>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li class="collapsed">
+ <a href="../instrument/index.html">Instrument</a>
+ </li>
+
+
+
+
+
+
+
+
+
+
+
+ <li class="collapsed">
+ <a href="../lifecycle/index.html">Lifecycle</a>
+ </li>
+
+ <li class="none">
+ <a href="../logger.html">Logger</a>
+ </li>
+ </ul>
+ <h5>Deprecated Materials</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../deprecation.html">Overview</a>
+ </li>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li class="expanded">
+ <a href="../deprecation.html">Old Documentation</a>
+ <ul>
+
+ <li class="none">
+ <a href="../component.html">ECM</a>
+ </li>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li class="collapsed">
+ <a href="../event/index.html">Event</a>
+ </li>
+
+ <li class="none">
+ <a href="../configuration.html">Configuration</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+ <h5>Thanks</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../../foundation/thanks.html">to our sponsors!</a>
+ </li>
+
+ <li class="none">
+ <a href="../../foundation/sponsorship.html">Sponsor the ASF</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img alt="Built by Maven" src="../images/logos/maven-feather.png"></img>
+ </a>
+
+
+
+
+
+
+
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <header>Avalon Framework - The Component Lifecycle<authors><person id="BL" name="Berin Loritsch" email="bloritsch@apache.org"><person id="PD" name="Peter Donald" email="peter at apache.org"><person id="LS" name="Leo Simons" email="mail@leosimons.com"></authors></header><div class="section"><h2><a name="Introduction"></a>Introduction</h2>
+<p>
A component lives within something called a container. The contract between a
container and a contained component is simple: the container is required to
take a component through what is called its <strong>lifecycle</strong>.
- </p><p>
+ </p>
+<p>
The Avalon project provides an
application that functions as a container for componentized applications
called <link href="http://avalon.apache.org/merlin">Merlin</link>.
- </p><p>
+ </p>
+<p>
The lifecyle methods from the Avalon Framework sub-project are designed to be
used by just about any component hosted by any container. Of course, the API
in question may well require additional interfaces for strongly typed
functionality, but these interfaces should negate the need for any duplication
of effort.
- </p></div><div class="section"><a name="The_Lifecycle"></a><h2>The Lifecycle</h2><p>
+ </p>
+</div>
+<div class="section"><h2><a name="The_Lifecycle"></a>The Lifecycle</h2>
+<p>
The lifecycle of a component specifies the methods that can be called on it,
and the order in which this may happen. Some methods can be called only once
in a specific <code>phase</code> of a component's lifecycle, others may
be called multiple times. These methods are called the lifecycle methods.
- </p><p>
+ </p>
+<p>
It is up to each container to indicate which lifecycle methods it will honor.
This should be clearly documented together with the description of the
container. A sister project to Phoenix supports all of the lifecycle methods defined in the
Avalon Framework API.
- </p></div><div class="section"><a name="The_Lifecycle_Interfaces"></a><h2>The Lifecycle Interfaces</h2><p>
+ </p>
+</div>
+<div class="section"><h2><a name="The_Lifecycle_Interfaces"></a>The Lifecycle Interfaces</h2>
+<p>
A component exposes its lifecycle methods by implementing the lifecycle
interfaces. Each of these defines one or more methods that represent a
specific phase in a component's lifecycle. The defined interfaces are:
- </p><ol>
- <li>LogEnabled</li>
- <li>Contextualizable</li>
- <li>Serviceable (replacement for Composable)</li>
- <li>Configurable</li>
- <li>Parameterizable</li>
- <li>Initializable</li>
- <li>Startable</li>
- <li>Suspendable</li>
- <li>Recontextualizable</li>
- <li>Recomposable</li>
- <li>Reconfigurable</li>
- <li>Reparameterizable</li>
- <li>Stoppable</li>
- <li>Disposable</li>
- </ol><p><i>
- <strong>Note:</strong>java.lang.Runnable has also been in use as a lifecycle
+ </p>
+<ol type="1"><li>LogEnabled</li>
+<li>Contextualizable</li>
+<li>Serviceable (replacement for Composable)</li>
+<li>Configurable</li>
+<li>Parameterizable</li>
+<li>Initializable</li>
+<li>Startable</li>
+<li>Suspendable</li>
+<li>Recontextualizable</li>
+<li>Recomposable</li>
+<li>Reconfigurable</li>
+<li>Reparameterizable</li>
+<li>Stoppable</li>
+<li>Disposable</li>
+</ol>
+<p><i><strong>Note:</strong>java.lang.Runnable has also been in use as a lifecycle
interface. This is not recommended and is not supported by Avalon. Instead,
the run() method is the responsibility of the component itself. If you wish
to use it, call it from within start() or another method.
- </i></p></div><div class="section"><a name="Phase_Order"></a><h2>Phase Order</h2><p>
+ </i></p>
+</div>
+<div class="section"><h2><a name="Phase_Order"></a>Phase Order</h2>
+<p>
The order in which the various lifecycle methods are called is very specific.
While none are required (it is possible to have a component implementing
none of the lifecycle methods, although the use of that would be limited),
some can only be used when others are as well. This is best explained using
a few examples.
- </p><div class="subsection"><a name="Simple_Examples"></a><h3>Simple Examples</h3><p>The lifecycle of a component implementing only Configurable for
- example will be:</p><ol>
- <li>constructor</li>
- <li>configure</li>
- <li>finalize</li>
- </ol><p>The lifecycle of a component implementing only Serviceable will be:</p><ol>
- <li>constructor</li>
- <li>service</li>
- <li>finalize</li>
- </ol></div><div class="subsection"><a name="Complete"></a><h3>Complete</h3><p>
+ </p>
+<div class="section"><h3><a name="Simple_Examples"></a>Simple Examples</h3>
+<p>The lifecycle of a component implementing only Configurable for
+ example will be:</p>
+<ol type="1"><li>constructor</li>
+<li>configure</li>
+<li>finalize</li>
+</ol>
+<p>The lifecycle of a component implementing only Serviceable will be:</p>
+<ol type="1"><li>constructor</li>
+<li>service</li>
+<li>finalize</li>
+</ol>
+</div>
+<div class="section"><h3><a name="Complete"></a>Complete</h3>
+<p>
If a component implements more than one interface the order of
the events (service, configure etc.) follow a specific order. A component
implementing all above interfaces (including Runnable) will follow these
specific paths.
- </p><p>
+ </p>
+<p>
Startup Phase:
- </p><ol>
- <li>constructor <strong>as a consequence of instantiation</strong>
-</li>
- <li>contextualize</li>
- <li>service or compose</li>
- <li>configure</li>
- <li>parameterize</li>
- <li>initialize</li>
- <li>start</li>
- </ol><p>
+ </p>
+<ol type="1"><li>constructor <strong>as a consequence of instantiation</strong></li>
+<li>contextualize</li>
+<li>service or compose</li>
+<li>configure</li>
+<li>parameterize</li>
+<li>initialize</li>
+<li>start</li>
+</ol>
+<p>
At various or repeated times after startup:
- </p><ol>
- <li>suspend</li>
- <li>recontextualize</li>
- <li>recompose</li>
- <li>reconfigure</li>
- <li>reparameterize</li>
- <li>resume</li>
- </ol><p>
+ </p>
+<ol type="1"><li>suspend</li>
+<li>recontextualize</li>
+<li>recompose</li>
+<li>reconfigure</li>
+<li>reparameterize</li>
+<li>resume</li>
+</ol>
+<p>
Shutdown Phase:
- </p><ol>
- <li>stop</li>
- <li>dispose</li>
- <li>finalize <strong>at some indeterminate moment by the garbage collector</strong>
-</li>
- </ol></div><div class="subsection"><a name="Phases_executed_once"></a><h3>Phases executed once</h3><p>
+ </p>
+<ol type="1"><li>stop</li>
+<li>dispose</li>
+<li>finalize <strong>at some indeterminate moment by the garbage collector</strong></li>
+</ol>
+</div>
+<div class="section"><h3><a name="Phases_executed_once"></a>Phases executed once</h3>
+<p>
These lifecycle methods are only called once in the entire life of a
component:
- </p><ul>
- <li>contextualize</li>
- <li>service</li>
- <li>configure</li>
- <li>parameterize</li>
- <li>initialize</li>
- <li>dispose</li>
- </ul></div><div class="subsection"><a name="Phases_executed_once_or_more"></a><h3>Phases executed once or more</h3><p>
+ </p>
+<ul><li>contextualize</li>
+<li>service</li>
+<li>configure</li>
+<li>parameterize</li>
+<li>initialize</li>
+<li>dispose</li>
+</ul>
+</div>
+<div class="section"><h3><a name="Phases_executed_once_or_more"></a>Phases executed once or more</h3>
+<p>
These lifecycle methods are called at least once and possibly more, depending
on the container:
- </p><ul>
- <li>start</li>
- <li>stop</li>
- </ul></div><div class="subsection"><a name="The_Suspendable_Interface"></a><h3>The Suspendable Interface</h3><p>
+ </p>
+<ul><li>start</li>
+<li>stop</li>
+</ul>
+</div>
+<div class="section"><h3><a name="The_Suspendable_Interface"></a>The Suspendable Interface</h3>
+<p>
The methods suspend() and resume() are not guaranteed to be called at all,
even when implemented. They can be called more than once, but only after
one another and between start() and stop(). The reason they exist is so
@@ -145,9 +597,37 @@
on one of the components used by this component, or it may wish to call any
of the following methods, which can also be called zero or more times, and
only between a suspend() and a resume().
- </p><ul>
- <li>recontextualize()</li>
- <li>recompose()</li>
- <li>reconfigure()</li>
- <li>reparameterize()</li>
- </ul></div></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 1997-2007, The Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
+ </p>
+<ul><li>recontextualize()</li>
+<li>recompose()</li>
+<li>reconfigure()</li>
+<li>reparameterize()</li>
+</ul>
+</div>
+</div>
+
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">©
+ 2009
+
+ The Apache Software Foundation
+
+
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Added: excalibur/site/images/logos/build-by-maven-black.png
URL: http://svn.apache.org/viewvc/excalibur/site/images/logos/build-by-maven-black.png?rev=785324&view=auto
==============================================================================
Binary file - no diff available.
Propchange: excalibur/site/images/logos/build-by-maven-black.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: excalibur/site/images/logos/build-by-maven-white.png
URL: http://svn.apache.org/viewvc/excalibur/site/images/logos/build-by-maven-white.png?rev=785324&view=auto
==============================================================================
Binary file - no diff available.
Propchange: excalibur/site/images/logos/build-by-maven-white.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Modified: excalibur/site/images/logos/maven-feather.png
URL: http://svn.apache.org/viewvc/excalibur/site/images/logos/maven-feather.png?rev=785324&r1=785323&r2=785324&view=diff
==============================================================================
Binary files - no diff available.
Modified: excalibur/site/index.html
URL: http://svn.apache.org/viewvc/excalibur/site/index.html?rev=785324&r1=785323&r2=785324&view=diff
==============================================================================
--- excalibur/site/index.html (original)
+++ excalibur/site/index.html Tue Jun 16 17:55:25 2009
@@ -1,95 +1,515 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Apache Excalibur - Front Page</title><style type="text/css" media="all">
- @import url("./style/maven-base.css");
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+
+
+
+
+
+
+
+
+
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+ <title>Excalibur - Front Page</title>
+ <style type="text/css" media="all">
+ @import url("./css/maven-base.css");
+ @import url("./css/maven-theme.css");
+ @import url("./css/site.css");
+ </style>
+ <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <span id="bannerLeft">
+
+ Excalibur
+
+ </span>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
- @import url("./style/maven-theme.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://www.apache.org/" id="organizationLogo"><img alt="The Apache Software Foundation" src="http://www.apache.org/images/asf-logo.gif"></img></a><a href="http://excalibur.apache.org/" id="projectLogo"><img alt="Apache Excalibur" src="http://excalibur.apache.org/logo.gif"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xright">
-
- <a href="index.html">Home</a>
+
+
+
+
+
+
+
+ <div class="xleft">
+ Last Published: 2009-06-16
+ </div>
+ <div class="xright"> <a href="index.html">Home</a>
+ |
+ <a href="fortress/index.html">Fortress</a>
+ |
+ <a href="component-list.html">Components</a>
+ |
+ <a href="containerkit.html">Containerkit</a>
+
+
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+
+
+
+
+
+
+ <h5>Essentials</h5>
+ <ul>
+
+ <li class="none">
+ <strong>Overview</strong>
+ </li>
+
+ <li class="none">
+ <a href="mail-lists.html">Mailing Lists</a>
+ </li>
+
+ <li class="none">
+ <a href="svn.html">Subversion</a>
+ </li>
+
+ <li class="none">
+ <a href="http://wiki.apache.org/excalibur/" class="externalLink">Wiki</a>
+ </li>
+
+ <li class="none">
+ <a href="http://wiki.apache.org/excalibur/FrequentlyAskedQuestions" class="externalLink">FAQ</a>
+ </li>
+
+ <li class="none">
+ <a href="http://excalibur.apache.org/apidocs/" class="externalLink">Javadocs</a>
+ </li>
+
+ <li class="none">
+ <a href="http://excalibur.apache.org/download.cgi" class="externalLink">Download</a>
+ </li>
+
+ <li class="none">
+ <a href="issue-tracking.html">Issue Tracking</a>
+ </li>
+
+
+
-
-
- <span class="separator">|</span>
-
-
- <a href="fortress/index.html">Fortress</a>
+
-
-
- <span class="separator">|</span>
-
-
- <a href="component-list.html">Components</a>
+
-
-
- <span class="separator">|</span>
+
+ <li class="collapsed">
+ <a href="misc.html">Miscellaneous</a>
+ </li>
+ </ul>
+ <h5>Fortress</h5>
+ <ul>
+
+ <li class="none">
+ <a href="fortress/index.html">Overview</a>
+ </li>
+
+ <li class="none">
+ <a href="fortress/features.html">Features Oriented</a>
+ </li>
+
+ <li class="none">
+ <a href="fortress/getting-started.html">Getting Started</a>
+ </li>
+
+ <li class="none">
+ <a href="fortress/using-meta-info.html">Using Meta Info</a>
+ </li>
+
+ <li class="none">
+ <a href="fortress/cli.html">CLI</a>
+ </li>
+
+ <li class="none">
+ <a href="fortress/swing.html">Swing</a>
+ </li>
+
+ <li class="none">
+ <a href="fortress/servlet.html">Servlet</a>
+ </li>
+
+ <li class="none">
+ <a href="lifecycle/index.html">Lifecycle Extensions</a>
+ </li>
+
+ <li class="none">
+ <a href="fortress/design-notes.html">Design Notes</a>
+ </li>
+ </ul>
+ <h5>Framework</h5>
+ <ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li class="collapsed">
+ <a href="framework/index.html">Documentation</a>
+ </li>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li class="collapsed">
+ <a href="developing/index.html">Developing</a>
+ </li>
+ </ul>
+ <h5>Components</h5>
+ <ul>
+
+ <li class="none">
+ <a href="component-list.html">Overview</a>
+ </li>
+
+
+
+
+
+ <li class="collapsed">
+ <a href="sourceresolve/index.html">Sourceresolver</a>
+ </li>
+
+
+
+
+
+ <li class="collapsed">
+ <a href="store/index.html">Store</a>
+ </li>
+
+ <li class="none">
+ <a href="thread.html">Thread</a>
+ </li>
+
+
+
+
+
+ <li class="collapsed">
+ <a href="xmlutil/index.html">XMLUtil</a>
+ </li>
+ </ul>
+ <h5>Containerkit</h5>
+ <ul>
+
+ <li class="none">
+ <a href="containerkit.html">Overview</a>
+ </li>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li class="collapsed">
+ <a href="instrument/index.html">Instrument</a>
+ </li>
+
+
+
+
+
+
+
+
+
+
+
+ <li class="collapsed">
+ <a href="lifecycle/index.html">Lifecycle</a>
+ </li>
+
+ <li class="none">
+ <a href="logger.html">Logger</a>
+ </li>
+ </ul>
+ <h5>Deprecated Materials</h5>
+ <ul>
+
+ <li class="none">
+ <a href="deprecation.html">Overview</a>
+ </li>
+
-
- <a href="containerkit.html">Containerkit</a>
- </div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuEssentials"><h5>Essentials</h5><ul><li class="none"><strong><a href="index.html">Overview</a></strong></li><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="svn.html">Subversion</a></li><li class="none"><a href="http://wiki.apache.org/excalibur/" class="externalLink" title="External Link">Wiki</a></li><li class="none"><a href="http://wiki.apache.org/excalibur/FrequentlyAskedQuestions" class="externalLink" title="External Link">FAQ</a></li><li class="none"><a href="http://excalibur.apache.org/apidocs/" class="externalLink" title="External Link">Javadocs</a></li><li class="none"><a href="http://excalibur.apache.org/download.cgi" class="externalLink" title="External Link">Download</a></li><li class="none"><a href="issue-tracking.html">Issue Tracking</a></li><li class="collapsed"><a href="misc.html">Miscellaneous</a></li></ul></div><d
iv id="menuFortress"><h5>Fortress</h5><ul><li class="none"><a href="fortress/index.html">Overview</a></li><li class="none"><a href="fortress/features.html">Features Oriented</a></li><li class="none"><a href="fortress/getting-started.html">Getting Started</a></li><li class="none"><a href="fortress/using-meta-info.html">Using Meta Info</a></li><li class="none"><a href="fortress/cli.html">CLI</a></li><li class="none"><a href="fortress/swing.html">Swing</a></li><li class="none"><a href="fortress/servlet.html">Servlet</a></li><li class="none"><a href="lifecycle/index.html">Lifecycle Extensions</a></li><li class="none"><a href="fortress/design-notes.html">Design Notes</a></li></ul></div><div id="menuFramework"><h5>Framework</h5><ul><li class="collapsed"><a href="framework/index.html">Documentation</a></li><li class="collapsed"><a href="developing/index.html">Developing</a></li></ul></div><div id="menuComponents"><h5>Components</h5><ul><li class="none"><a href="component-list.html"
>Overview</a></li><li class="collapsed"><a href="sourceresolve/index.html">Sourceresolver</a></li><li class="collapsed"><a href="store/index.html">Store</a></li><li class="none"><a href="thread.html">Thread</a></li><li class="collapsed"><a href="xmlutil/index.html">XMLUtil</a></li></ul></div><div id="menuContainerkit"><h5>Containerkit</h5><ul><li class="none"><a href="containerkit.html">Overview</a></li><li class="collapsed"><a href="instrument/index.html">Instrument</a></li><li class="collapsed"><a href="lifecycle/index.html">Lifecycle</a></li><li class="none"><a href="logger.html">Logger</a></li></ul></div><div id="menuDeprecated_Materials"><h5>Deprecated Materials</h5><ul><li class="none"><a href="deprecation.html">Overview</a></li><li class="expanded"><a href="deprecation.html">Old Documentation</a><ul><li class="none"><a href="component.html">ECM</a></li><li class="collapsed"><a href="event/index.html">Event</a></li><li class="none"><a href="configuration.html">Configur
ation</a></li></ul></li></ul></div><div id="menuThanks"><h5>Thanks</h5><ul><li class="none"><a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="External Link">to our sponsors!</a></li><li class="none"><a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="External Link">Sponsor the ASF</a></li></ul></div><div id="menuProject_Documentation"><h5>Project Documentation</h5><ul><li class="none"><strong><a href="index.html">About Apache Excalibur</a></strong></li><li class="collapsed"><a href="project-info.html">Project Info</a></li><li class="collapsed"><a href="maven-reports.html">Project Reports</a></li><li class="none"><a href="http://maven.apache.org/development-process.html" class="externalLink" title="External Link">Development Process</a></li></ul></div></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="What_is_excalibur_"></a><h2>What is excalibur?</h2><p>
- Excalibur is an <a href="http://www.opensource.org/" class="externalLink" title="External Link">open source</a> software
- project of <a href="http://www.apache.org/" class="externalLink" title="External Link">The Apache Software Foundation</a>.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li class="expanded">
+ <a href="deprecation.html">Old Documentation</a>
+ <ul>
+
+ <li class="none">
+ <a href="component.html">ECM</a>
+ </li>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li class="collapsed">
+ <a href="event/index.html">Event</a>
+ </li>
+
+ <li class="none">
+ <a href="configuration.html">Configuration</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+ <h5>Thanks</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../foundation/thanks.html">to our sponsors!</a>
+ </li>
+
+ <li class="none">
+ <a href="../foundation/sponsorship.html">Sponsor the ASF</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img alt="Built by Maven" src="./images/logos/maven-feather.png"></img>
+ </a>
+
+
+
+
+
+
+
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <div class="section"><h2><a name="What_is_excalibur"></a>What is excalibur?</h2>
+<p>
+ Excalibur is an <a href="http://www.opensource.org/" class="externalLink">open source</a> software
+ project of <a href="http://www.apache.org/" class="externalLink">The Apache Software Foundation</a>.
Our primary product is a lightweight, embeddable
- <a href="http://www.martinfowler.com/articles/injection.html" class="externalLink" title="External Link">Inversion of Control</a>
- <em>container</em> named <a href="fortress/index.html">Fortress</a> that is written
- in <a href="http://java.sun.com/" class="externalLink" title="External Link">java</a>.
- </p><p>
- Inversion of control, also known as the hollywood principle ("don't call us,
- we'll call you"), is a simple but powerful concept. The idea is that we
- don't "wire up" all the pieces that make up an application (the "components") by
+ <a href="http://www.martinfowler.com/articles/injection.html" class="externalLink">Inversion of Control</a><em>container</em> named <a href="fortress/index.html">Fortress</a> that is written
+ in <a href="http://java.sun.com/" class="externalLink">java</a>.
+ </p>
+<p>
+ Inversion of control, also known as the hollywood principle ("don't call us,
+ we'll call you"), is a simple but powerful concept. The idea is that we
+ don't "wire up" all the pieces that make up an application (the "components") by
writing lots of this-component-uses-that-one-like-so code, nor do we use some
kind of lookup directory (like
- <a href="http://java.sun.com/products/jndi/" class="externalLink" title="External Link">JNDI</a>, for example) where each component
+ <a href="http://java.sun.com/products/jndi/" class="externalLink">JNDI</a>, for example) where each component
decides what components to interact with itself. Instead, we instruct a smart piece
of software, the container, to <em>tell</em> the components how to interact.
- </p><p>
- Fortress (and also its predecessor, "ECM") is such a container. It is
+ </p>
+<p>
+ Fortress (and also its predecessor, "ECM") is such a container. It is
<em>lightweight</em>, by which we mean that it doesn't need a lot of resources,
take a lot of disk or memory, or impose all sorts of demands on its environment. Fortress
is also <em>embeddable</em>, by which we mean that you can use fortress inside just
about every java environment. More concretely, you can use it as the basis of a
large standalone development platform (like the
- <a href="http://www.keelframework.org/" class="externalLink" title="External Link">Keel</a> project), at the core of a
+ <a href="http://www.keelframework.org/" class="externalLink">Keel</a> project), at the core of a
servlet-based web application (like
- <a href="http://cocoon.apache.org/" class="externalLink" title="External Link">Cocoon</a>) or even as the basis of a GUI
+ <a href="http://cocoon.apache.org/" class="externalLink">Cocoon</a>) or even as the basis of a GUI
application (like
- <a href="http://projects.d-haven.org/modules/mydownloads/singlefile.php?cid=2&lid=2" class="externalLink" title="External Link">GuiApp</a>).
- </p><p>
+ <a href="http://projects.d-haven.org/modules/mydownloads/singlefile.php?cid=2&lid=2" class="externalLink">GuiApp</a>).
+ </p>
+<p>
Fortress knows how to manage components that have been developed using a
rigid <em>lifecycle</em> contract called
- <a href="http://wiki.apache.org/excalibur/AvalonFramework" class="externalLink" title="External Link">Avalon-Framework</a>.
+ <a href="http://wiki.apache.org/excalibur/AvalonFramework" class="externalLink">Avalon-Framework</a>.
In the next upcoming release, fortress will also be able to manage ordinary
javabeans, and support for other kinds of Inversion of Control are planned.
- </p><p>
+ </p>
+<p>
Besides providing fortress, excalibur also provides a small library of very
- useful <a href="http://excalibur.apache.org/component-list.html" class="externalLink" title="External Link">components</a>.
+ useful <a href="http://excalibur.apache.org/component-list.html" class="externalLink">components</a>.
We also distribute some of the libraries used to build fortress (and some
other containers) seperately. This selection of libraries is called
- <a href="http://excalibur.apache.org/containerkit.html" class="externalLink" title="External Link">containerkit</a>.
- </p></div><div class="section"><a name="So_why_is_excalibur_an_interesting_project_"></a><h2>So why is excalibur an interesting project?</h2><p>Here's a few partial answers.</p><p>
- <strong>good code</strong>. Code that comes from the mature avalon project
- (everything that used to be branded as "Avalon Excalibur" and "Avalon Fortress").
+ <a href="http://excalibur.apache.org/containerkit.html" class="externalLink">containerkit</a>.
+ </p>
+</div>
+<div class="section"><h2><a name="So_why_is_excalibur_an_interesting_project"></a>So why is excalibur an interesting project?</h2>
+<p>Here's a few partial answers.</p>
+<p><strong>good code</strong>. Code that comes from the mature avalon project
+ (everything that used to be branded as "Avalon Excalibur" and "Avalon Fortress").
This includes two lightweight Inversion of Control containers. One of these powers,
among other things,
- <a href="http://cocoon.apache.org/" class="externalLink" title="External Link">Cocoon</a>. The other ("fortress") is the basis
+ <a href="http://cocoon.apache.org/" class="externalLink">Cocoon</a>. The other ("fortress") is the basis
of projects like
- <a href="http://www.keelframework.org/" class="externalLink" title="External Link">Keel</a>. Excalibur also includes powerful
- and mature reusable "components" and "libraries", handling tasks ranging from thread
+ <a href="http://www.keelframework.org/" class="externalLink">Keel</a>. Excalibur also includes powerful
+ and mature reusable "components" and "libraries", handling tasks ranging from thread
management to component pooling to (URI-and-similar-) source resolving.
- </p><p>
- <strong>smart developers</strong>. See
+ </p>
+<p><strong>smart developers</strong>. See
<a href="/team-list.html">this list</a>.
- </p><p>
+ </p>
+<p>
Most of these people are or have been active in the avalon project in various roles.
Several of them are apache members. Together they have loads and loads experience
under their belts related to inversion of control development. In fact, I'm
confident to say this list includes some of the biggest experts on
- inversion-of-control-style container development.</p><p>
- <strong>exciting community</strong>. Several open source and commercial projects
+ inversion-of-control-style container development.</p>
+<p><strong>exciting community</strong>. Several open source and commercial projects
(both at apache and elsewhere) depend on and contribute to the excalibur project. A
strong team of enthousiastic developers (with strong ties to several other projects
in the same problem domain) has various big and small plans with excalibur. One of
the leading open source organisations in the world,
- <a href="http://www.apache.org/" class="externalLink" title="External Link">The Apache Software Foundation</a>, is hosting the
+ <a href="http://www.apache.org/" class="externalLink">The Apache Software Foundation</a>, is hosting the
project, providing insight, advice, infrastructure, legal backing, a time- and
battle-proven development process, and much more.
- </p></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 1997-2007, The Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
+ </p>
+</div>
+
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">©
+ 2009
+
+ The Apache Software Foundation
+
+
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Modified: excalibur/site/instrument/component-extend-ai.html
URL: http://svn.apache.org/viewvc/excalibur/site/instrument/component-extend-ai.html?rev=785324&r1=785323&r2=785324&view=diff
==============================================================================
--- excalibur/site/instrument/component-extend-ai.html (original)
+++ excalibur/site/instrument/component-extend-ai.html Tue Jun 16 17:55:25 2009
@@ -1,34 +1,421 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Apache Excalibur - Excalibur Instrument - Extending the AbstractInstrumentable Base-Class</title><style type="text/css" media="all">
- @import url("../style/maven-base.css");
-
- @import url("../style/maven-theme.css");</style><link rel="stylesheet" href="../style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta><meta name="author" content="Leif Mortenson"></meta><meta name="email" content="leif.AT.tanukisoftware.DOT.com"></meta></head><body class="composite"><div id="banner"><a href="http://www.apache.org/" id="organizationLogo"><img alt="The Apache Software Foundation" src="http://www.apache.org/images/asf-logo.gif"></img></a><a href="http://excalibur.apache.org/" id="projectLogo"><img alt="Apache Excalibur" src="http://excalibur.apache.org/logo.gif"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xright">
-
- <a href="../index.html">Home</a>
-
-
-
- <span class="separator">|</span>
-
-
- <a href="../fortress/index.html">Fortress</a>
-
-
-
- <span class="separator">|</span>
-
-
- <a href="../component-list.html">Components</a>
-
-
-
- <span class="separator">|</span>
-
-
- <a href="../containerkit.html">Containerkit</a>
- </div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuEssentials"><h5>Essentials</h5><ul><li class="none"><a href="../index.html">Overview</a></li><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li><li class="none"><a href="../svn.html">Subversion</a></li><li class="none"><a href="http://wiki.apache.org/excalibur/" class="externalLink" title="External Link">Wiki</a></li><li class="none"><a href="http://wiki.apache.org/excalibur/FrequentlyAskedQuestions" class="externalLink" title="External Link">FAQ</a></li><li class="none"><a href="http://excalibur.apache.org/apidocs/" class="externalLink" title="External Link">Javadocs</a></li><li class="none"><a href="http://excalibur.apache.org/download.cgi" class="externalLink" title="External Link">Download</a></li><li class="none"><a href="../issue-tracking.html">Issue Tracking</a></li><li class="collapsed"><a href="../misc.html">Miscellaneous</a></li></ul></div><div
id="menuFortress"><h5>Fortress</h5><ul><li class="none"><a href="../fortress/index.html">Overview</a></li><li class="none"><a href="../fortress/features.html">Features Oriented</a></li><li class="none"><a href="../fortress/getting-started.html">Getting Started</a></li><li class="none"><a href="../fortress/using-meta-info.html">Using Meta Info</a></li><li class="none"><a href="../fortress/cli.html">CLI</a></li><li class="none"><a href="../fortress/swing.html">Swing</a></li><li class="none"><a href="../fortress/servlet.html">Servlet</a></li><li class="none"><a href="../lifecycle/index.html">Lifecycle Extensions</a></li><li class="none"><a href="../fortress/design-notes.html">Design Notes</a></li></ul></div><div id="menuFramework"><h5>Framework</h5><ul><li class="collapsed"><a href="../framework/index.html">Documentation</a></li><li class="collapsed"><a href="../developing/index.html">Developing</a></li></ul></div><div id="menuComponents"><h5>Components</h5><ul><li class="none
"><a href="../component-list.html">Overview</a></li><li class="collapsed"><a href="../sourceresolve/index.html">Sourceresolver</a></li><li class="collapsed"><a href="../store/index.html">Store</a></li><li class="none"><a href="../thread.html">Thread</a></li><li class="collapsed"><a href="../xmlutil/index.html">XMLUtil</a></li></ul></div><div id="menuContainerkit"><h5>Containerkit</h5><ul><li class="none"><a href="../containerkit.html">Overview</a></li><li class="collapsed"><a href="../instrument/index.html">Instrument</a></li><li class="collapsed"><a href="../lifecycle/index.html">Lifecycle</a></li><li class="none"><a href="../logger.html">Logger</a></li></ul></div><div id="menuDeprecated_Materials"><h5>Deprecated Materials</h5><ul><li class="none"><a href="../deprecation.html">Overview</a></li><li class="expanded"><a href="../deprecation.html">Old Documentation</a><ul><li class="none"><a href="../component.html">ECM</a></li><li class="collapsed"><a href="../event/index.html
">Event</a></li><li class="none"><a href="../configuration.html">Configuration</a></li></ul></li></ul></div><div id="menuThanks"><h5>Thanks</h5><ul><li class="none"><a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="External Link">to our sponsors!</a></li><li class="none"><a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="External Link">Sponsor the ASF</a></li></ul></div><div id="menuProject_Documentation"><h5>Project Documentation</h5><ul><li class="none"><a href="../index.html">About Apache Excalibur</a></li><li class="collapsed"><a href="../project-info.html">Project Info</a></li><li class="collapsed"><a href="../maven-reports.html">Project Reports</a></li><li class="none"><a href="http://maven.apache.org/development-process.html" class="externalLink" title="External Link">Development Process</a></li></ul></div></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Extendi
ng_the_AbstractInstrumentable_Base-Class"></a><h2>Extending the AbstractInstrumentable Base-Class</h2><p>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+
+
+
+
+
+
+
+
+
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+ <title>Excalibur - Excalibur Instrument - Extending the AbstractInstrumentable Base-Class</title>
+ <style type="text/css" media="all">
+ @import url("../css/maven-base.css");
+ @import url("../css/maven-theme.css");
+ @import url("../css/site.css");
+ </style>
+ <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
+ <meta name="author" content="Leif Mortenson" />
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <span id="bannerLeft">
+
+ Excalibur
+
+ </span>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+
+
+
+
+
+
+ <div class="xleft">
+ Last Published: 2009-06-16
+ </div>
+ <div class="xright"> <a href="../index.html">Home</a>
+ |
+ <a href="../fortress/index.html">Fortress</a>
+ |
+ <a href="../component-list.html">Components</a>
+ |
+ <a href="../containerkit.html">Containerkit</a>
+
+
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+
+
+
+
+
+
+ <h5>Essentials</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../index.html">Overview</a>
+ </li>
+
+ <li class="none">
+ <a href="../mail-lists.html">Mailing Lists</a>
+ </li>
+
+ <li class="none">
+ <a href="../svn.html">Subversion</a>
+ </li>
+
+ <li class="none">
+ <a href="http://wiki.apache.org/excalibur/" class="externalLink">Wiki</a>
+ </li>
+
+ <li class="none">
+ <a href="http://wiki.apache.org/excalibur/FrequentlyAskedQuestions" class="externalLink">FAQ</a>
+ </li>
+
+ <li class="none">
+ <a href="http://excalibur.apache.org/apidocs/" class="externalLink">Javadocs</a>
+ </li>
+
+ <li class="none">
+ <a href="http://excalibur.apache.org/download.cgi" class="externalLink">Download</a>
+ </li>
+
+ <li class="none">
+ <a href="../issue-tracking.html">Issue Tracking</a>
+ </li>
+
+
+
+
+
+
+
+
+
+ <li class="collapsed">
+ <a href="../misc.html">Miscellaneous</a>
+ </li>
+ </ul>
+ <h5>Fortress</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../fortress/index.html">Overview</a>
+ </li>
+
+ <li class="none">
+ <a href="../fortress/features.html">Features Oriented</a>
+ </li>
+
+ <li class="none">
+ <a href="../fortress/getting-started.html">Getting Started</a>
+ </li>
+
+ <li class="none">
+ <a href="../fortress/using-meta-info.html">Using Meta Info</a>
+ </li>
+
+ <li class="none">
+ <a href="../fortress/cli.html">CLI</a>
+ </li>
+
+ <li class="none">
+ <a href="../fortress/swing.html">Swing</a>
+ </li>
+
+ <li class="none">
+ <a href="../fortress/servlet.html">Servlet</a>
+ </li>
+
+ <li class="none">
+ <a href="../lifecycle/index.html">Lifecycle Extensions</a>
+ </li>
+
+ <li class="none">
+ <a href="../fortress/design-notes.html">Design Notes</a>
+ </li>
+ </ul>
+ <h5>Framework</h5>
+ <ul>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li class="collapsed">
+ <a href="../framework/index.html">Documentation</a>
+ </li>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li class="collapsed">
+ <a href="../developing/index.html">Developing</a>
+ </li>
+ </ul>
+ <h5>Components</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../component-list.html">Overview</a>
+ </li>
+
+
+
+
+
+ <li class="collapsed">
+ <a href="../sourceresolve/index.html">Sourceresolver</a>
+ </li>
+
+
+
+
+
+ <li class="collapsed">
+ <a href="../store/index.html">Store</a>
+ </li>
+
+ <li class="none">
+ <a href="../thread.html">Thread</a>
+ </li>
+
+
+
+
+
+ <li class="collapsed">
+ <a href="../xmlutil/index.html">XMLUtil</a>
+ </li>
+ </ul>
+ <h5>Containerkit</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../containerkit.html">Overview</a>
+ </li>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li class="collapsed">
+ <a href="../instrument/index.html">Instrument</a>
+ </li>
+
+
+
+
+
+
+
+
+
+
+
+ <li class="collapsed">
+ <a href="../lifecycle/index.html">Lifecycle</a>
+ </li>
+
+ <li class="none">
+ <a href="../logger.html">Logger</a>
+ </li>
+ </ul>
+ <h5>Deprecated Materials</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../deprecation.html">Overview</a>
+ </li>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li class="expanded">
+ <a href="../deprecation.html">Old Documentation</a>
+ <ul>
+
+ <li class="none">
+ <a href="../component.html">ECM</a>
+ </li>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <li class="collapsed">
+ <a href="../event/index.html">Event</a>
+ </li>
+
+ <li class="none">
+ <a href="../configuration.html">Configuration</a>
+ </li>
+ </ul>
+ </li>
+ </ul>
+ <h5>Thanks</h5>
+ <ul>
+
+ <li class="none">
+ <a href="../../foundation/thanks.html">to our sponsors!</a>
+ </li>
+
+ <li class="none">
+ <a href="../../foundation/sponsorship.html">Sponsor the ASF</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img alt="Built by Maven" src="../images/logos/maven-feather.png"></img>
+ </a>
+
+
+
+
+
+
+
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <div class="section"><h2><a name="Extending_the_AbstractInstrumentable_Base-Class"></a>Extending the AbstractInstrumentable Base-Class</h2>
+<p>
Under Construction.
</p>
- <div class="source"><pre>
+<div class="source"><pre>
public class MyNiftyComponent
extends AbstractInstrumentable
{
@@ -39,10 +426,10 @@
public MyNiftyComponent()
{
- addInstrument( m_instrumentPushes = new CounterInstrument( "pushes" ) );
- addInstrument( m_instrumentPops = new CounterInstrument( "pops" ) );
- addInstrument( m_instrumentStackSize = new ValueInstrument( "stack-size" ) );
- addInstrument( m_instrumentProcessTime = new ValueInstrument( "process-time" ) );
+ addInstrument( m_instrumentPushes = new CounterInstrument( "pushes" ) );
+ addInstrument( m_instrumentPops = new CounterInstrument( "pops" ) );
+ addInstrument( m_instrumentStackSize = new ValueInstrument( "stack-size" ) );
+ addInstrument( m_instrumentProcessTime = new ValueInstrument( "process-time" ) );
}
public void push( Object obj )
@@ -72,5 +459,32 @@
m_instrumentProcessTime.setValue( (int)( System.currentTimeMillis() - start ) );
}
}
- </pre></div>
- </div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 1997-2007, The Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
+ </pre>
+</div>
+</div>
+
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">©
+ 2009
+
+ The Apache Software Foundation
+
+
+
+
+
+
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
---------------------------------------------------------------------
To unsubscribe, e-mail: scm-unsubscribe@excalibur.apache.org
For additional commands, e-mail: scm-help@excalibur.apache.org