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 [9/28] - in /excalibur/site: ./ css/ developing/ event/
fortress/ framework/ images/logos/ instrument/ lifecycle/ sourceresolve/
store/ xmlutil/
Modified: excalibur/site/download.html
URL: http://svn.apache.org/viewvc/excalibur/site/download.html?rev=785324&r1=785323&r2=785324&view=diff
==============================================================================
--- excalibur/site/download.html (original)
+++ excalibur/site/download.html Tue Jun 16 17:55:25 2009
@@ -1,56 +1,446 @@
-<!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 - Apache Excalibur - Downloads</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 - Apache Excalibur - Downloads</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="Excalibur Documentation Team" />
+ </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><meta name="author" content="Excalibur Documentation Team"></meta><meta name="email" content="dev@excalibur.apache.org"></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="xleft">
- Last published: 28 June 2006
- </div><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">
+ <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>
+
+
+
-
-
- <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"><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="menuFortre
ss"><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></u
l></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="Download_distributions"></a><h2>Download distributions</h2><p>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <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="Download_distributions"></a>Download distributions</h2>
+<p>
Use the links below to download binary or source distributions of
- Excalibur from one of our mirrors. It's a good idea to
+ Excalibur from one of our mirrors. It's a good idea to
verify the integrity
of the downloaded files using signatures downloaded from our
main distribution directory (see below).
- </p><p>
+ </p>
+<p>
Excalibur is distributed as <code>zip</code> and <code>tar.gz</code>
archives - the contents are the same. Please note that the <code>tar.gz</code>
archives contain file names longer than 100 characters and have been
created using GNU tar extensions. They must be untarred with a GNU
compatible version of <code>tar</code>.
- </p><p>
+ </p>
+<p>
If you do not see the file you need in the links below, please
- see the <a href="http://www.apache.org/dist/excalibur/" class="externalLink" title="External Link">master
+ see the <a href="http://www.apache.org/dist/excalibur/" class="externalLink">master
distribution directory</a> or, preferably, its
<a href="[preferred]/excalibur/">mirror</a>.
- </p><div class="subsection"><a name="Mirror"></a><h3>Mirror</h3><p>
+ </p>
+<div class="section"><h3><a name="Mirror"></a>Mirror</h3>
+<p>
You are currently using the <strong>[preferred]</strong>.
If you encounter a problem with this mirror, please select another
- mirror. If all mirrors are failing, there are <em>backup</em>
+ mirror. If all mirrors are failing, there are <em>backup</em>
mirrors (at the end of the mirrors list) that should be available.
- </p><form action="[location]" method="get" id="SelectMirror">
-<p>Other mirrors: </p><select name="Preferred">
+ </p>
+<form action="[location]" method="get" id="SelectMirror"><p>Other mirrors: </p>
+<select name="Preferred">
[if-any http]
[for http]<option value="[http]">[http]</option>[end]
[end]
@@ -60,96 +450,133 @@
[if-any backup]
[for backup]<option value="[backup]">[backup] (backup)</option>[end]
[end]
- </select>
- <input type="submit" value="Change"></input>
- </form></div><div class="subsection"><a name="License"></a><h3>License</h3><p>
+ </select><input type="submit" value="Change"></form></div>
+<div class="section"><h3><a name="License"></a>License</h3>
+<p>
All Excalibur products are distributed under the terms of The Apache
Software License (version 2.0, and version 1.1 for some older releases).
See our
<a href="../license.html">License</a> page, or the LICENSE.txt
file included in each distribution.
- </p></div><div class="subsection"><a name="Jar_Repository"></a><h3>Jar Repository</h3><p>
+ </p>
+</div>
+<div class="section"><h3><a name="Jar_Repository"></a>Jar Repository</h3>
+<p>
All Excalibur jars can also be found in the
- <a href="http://repo1.maven.org/maven2" class="externalLink" title="External Link">public Maven 2</a>
- repository for use with <a href="http://maven.apache.org" class="externalLink" title="External Link">Maven 2</a>
+ <a href="http://repo1.maven.org/maven2" class="externalLink">public Maven 2</a>
+ repository for use with <a href="http://maven.apache.org" class="externalLink">Maven 2</a>
and other repository-aware applications.
- </p></div></div>
-
-<div class="section">
- <a name="Product_Downloads"></a><h2>Product Downloads</h2>
- <div class="subsection"><a name=""></a><h3>Excalibur Source Resolver 2.2.3 (5 Jul 2007)</h3>
- <ul>
- <li>Jar distribution
- (<a href="[preferred]/excalibur/excalibur-sourceresolve/excalibur-sourceresolve-current.jar">jar</a>)
- (<a href="[preferred]/excalibur/excalibur-sourceresolve/excalibur-sourceresolve-current.jar.asc">ppg</a>)
- (<a href="[preferred]/excalibur/excalibur-sourceresolve/excalibur-sourceresolve-current.jar.md5">md5</a>)</li>
- <li>Source distribution
- (<a href="[preferred]/excalibur/excalibur-sourceresolve/excalibur-sourceresolve-source-current.jar">jar</a>)
- (<a href="[preferred]/excalibur/excalibur-sourceresolve/excalibur-sourceresolve-source-current.jar.asc">ppg</a>)
- (<a href="[preferred]/excalibur/excalibur-sourceresolve/excalibur-sourceresolve-source-current.jar.md5">md5</a>)</li>
- <li>Javadocs
- (<a href="[preferred]/excalibur/excalibur-sourceresolve/excalibur-sourceresolve-javadoc-current.jar">jar</a>)
- (<a href="[preferred]/excalibur/excalibur-sourceresolve/excalibur-sourceresolve-javadoc-current.jar.asc">ppg</a>)
- (<a href="[preferred]/excalibur/excalibur-sourceresolve/excalibur-sourceresolve-javadoc-current.jar.md5">md5</a>)</li>
- </ul>
- </div>
- <div class="subsection"><a name=""></a><h3>Feb 2007 Release (r508111)</h3>
- <ul>
- <li><a href="[preferred]/excalibur/releases/200702/RELEASE_NOTES">Release Notes</a></li>
- <li>Binary distribution
- (<a href="[preferred]/excalibur/releases/200702/excalibur-r508111-15022007.tar.gz">tar.gz</a>)
- (<a href="[preferred]/excalibur/releases/200702/excalibur-r508111-15022007.tar.gz.asc">ppg</a>)
- (<a href="[preferred]/excalibur/releases/200702/excalibur-r508111-15022007.tar.gz.md5">md5</a>)</li>
- <li>Source distribution
- (<a href="[preferred]/excalibur/releases/200702/excalibur-src-r508111-15022007.tar.gz">tar.gz</a>)
- (<a href="[preferred]/excalibur/releases/200702/excalibur-src-r508111-15022007.tar.gz.asc">ppg</a>)
- (<a href="[preferred]/excalibur/releases/200702/excalibur-src-r508111-15022007.tar.gz.md5">md5</a>)</li>
- <li>Javadocs
- (<a href="[preferred]/excalibur/releases/200702/excalibur-javadoc-r508111-15022007.tar.gz">tar.gz</a>)
- (<a href="[preferred]/excalibur/releases/200702/excalibur-javadoc-r508111-15022007.tar.gz.asc">ppg</a>)
- (<a href="[preferred]/excalibur/releases/200702/excalibur-javadoc-r508111-15022007.tar.gz.md5">md5</a>)</li>
- <li>Maven 2 repository distribution
- (<a href="[preferred]/excalibur/releases/200702/excalibur-maven2-repo-r508111-15022007.tar.gz">tar.gz</a>)
- (<a href="[preferred]/excalibur/releases/200702/excalibur-maven2-repo-r508111-15022007.tar.gz.asc">ppg</a>)
- (<a href="[preferred]/excalibur/releases/200702/excalibur-maven2-repo-r508111-15022007.tar.gz.md5">md5</a>)</li>
- </ul>
- </div>
-
-<div class="subsection"><a name="Verify_Releases"></a><h3>Verify Releases</h3><p>
+ </p>
+</div>
+</div>
+<div class="section"><h2><a name="Product_Downloads"></a>Product Downloads</h2>
+<div class="section"><h3><a name="Excalibur_Source_Resolver_2.2.3_5_Jul_2007"></a>Excalibur Source Resolver 2.2.3 (5 Jul 2007)</h3>
+<ul><li>Jar distribution
+ (<a href="[preferred]/excalibur/excalibur-sourceresolve/excalibur-sourceresolve-current.jar">jar</a>)
+ (<a href="[preferred]/excalibur/excalibur-sourceresolve/excalibur-sourceresolve-current.jar.asc">ppg</a>)
+ (<a href="[preferred]/excalibur/excalibur-sourceresolve/excalibur-sourceresolve-current.jar.md5">md5</a>)
+ </li>
+<li>Source distribution
+ (<a href="[preferred]/excalibur/excalibur-sourceresolve/excalibur-sourceresolve-source-current.jar">jar</a>)
+ (<a href="[preferred]/excalibur/excalibur-sourceresolve/excalibur-sourceresolve-source-current.jar.asc">ppg</a>)
+ (<a href="[preferred]/excalibur/excalibur-sourceresolve/excalibur-sourceresolve-source-current.jar.md5">md5</a>)
+ </li>
+<li>Javadocs
+ (<a href="[preferred]/excalibur/excalibur-sourceresolve/excalibur-sourceresolve-javadoc-current.jar">jar</a>)
+ (<a href="[preferred]/excalibur/excalibur-sourceresolve/excalibur-sourceresolve-javadoc-current.jar.asc">ppg</a>)
+ (<a href="[preferred]/excalibur/excalibur-sourceresolve/excalibur-sourceresolve-javadoc-current.jar.md5">md5</a>)
+ </li>
+</ul>
+</div>
+<div class="section"><h3><a name="Feb_2007_Release_r508111"></a>Feb 2007 Release (r508111)</h3>
+<ul><li><a href="[preferred]/excalibur/releases/200702/RELEASE_NOTES">Release Notes</a></li>
+<li>Binary distribution
+ (<a href="[preferred]/excalibur/releases/200702/excalibur-r508111-15022007.tar.gz">tar.gz</a>)
+ (<a href="[preferred]/excalibur/releases/200702/excalibur-r508111-15022007.tar.gz.asc">ppg</a>)
+ (<a href="[preferred]/excalibur/releases/200702/excalibur-r508111-15022007.tar.gz.md5">md5</a>)
+ </li>
+<li>Source distribution
+ (<a href="[preferred]/excalibur/releases/200702/excalibur-src-r508111-15022007.tar.gz">tar.gz</a>)
+ (<a href="[preferred]/excalibur/releases/200702/excalibur-src-r508111-15022007.tar.gz.asc">ppg</a>)
+ (<a href="[preferred]/excalibur/releases/200702/excalibur-src-r508111-15022007.tar.gz.md5">md5</a>)
+ </li>
+<li>Javadocs
+ (<a href="[preferred]/excalibur/releases/200702/excalibur-javadoc-r508111-15022007.tar.gz">tar.gz</a>)
+ (<a href="[preferred]/excalibur/releases/200702/excalibur-javadoc-r508111-15022007.tar.gz.asc">ppg</a>)
+ (<a href="[preferred]/excalibur/releases/200702/excalibur-javadoc-r508111-15022007.tar.gz.md5">md5</a>)
+ </li>
+<li>Maven 2 repository distribution
+ (<a href="[preferred]/excalibur/releases/200702/excalibur-maven2-repo-r508111-15022007.tar.gz">tar.gz</a>)
+ (<a href="[preferred]/excalibur/releases/200702/excalibur-maven2-repo-r508111-15022007.tar.gz.asc">ppg</a>)
+ (<a href="[preferred]/excalibur/releases/200702/excalibur-maven2-repo-r508111-15022007.tar.gz.md5">md5</a>)
+ </li>
+</ul>
+</div>
+<div class="section"><h3><a name="Verify_Releases"></a>Verify Releases</h3>
+<p>
It is essential that you verify the integrity of the downloaded
files using the PGP or MD5 signatures.
- </p><p>
+ </p>
+<p>
The MD5 checksums can be verified using the <code>md5</code> utility (called
<code>md5sum</code> on some systems). Download the <code>md5</code> file that
corresponds to the distributions you want to check. Make sure you get these
checksums from the
- <a href="http://www.apache.org/dist/excalibur/" class="externalLink" title="External Link">main distribution
+ <a href="http://www.apache.org/dist/excalibur/" class="externalLink">main distribution
directory</a>, rather than from a mirror.
- </p><p>
+ </p>
+<p>
The PGP signatures can be verified using PGP or GPG. First
- download the <a href="http://www.apache.org/dist/excalibur/KEYS" class="externalLink" title="External Link">KEYS</a>
+ download the <a href="http://www.apache.org/dist/excalibur/KEYS" class="externalLink">KEYS</a>
as well as the <code>asc</code> signature file for the particular
- distribution. Make sure you get these files from the
- <a href="http://www.apache.org/dist/excalibur/" class="externalLink" title="External Link">main distribution
+ distribution. Make sure you get these files from the
+ <a href="http://www.apache.org/dist/excalibur/" class="externalLink">main distribution
directory</a>, rather than from a mirror. Then verify the signatures
using
</p>
- <div class="source"><pre>
+<div class="source"><pre>
% pgpk -a KEYS
% pgpv name-of-distributed-file.tar.gz.asc
-</pre></div>
- <p>
- <strong><em>or</em></strong>
- </p>
- <div class="source"><pre>
+</pre>
+</div>
+<p><strong><em>or</em></strong></p>
+<div class="source"><pre>
% pgp -ka KEYS
% pgp name-of-distributed-file.tar.gz.asc
-</pre></div>
- <p>
- <strong><em>or</em></strong>
- </p>
- <div class="source"><pre>
-% gpg --import KEYS<br></br>
+</pre>
+</div>
+<p><strong><em>or</em></strong></p>
+<div class="source"><pre>
+% gpg --import KEYS<br />
+
% gpg --verify name-of-distributed-file.tar.gz.asc
-</pre></div>
- </div></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 1997-2006, The Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>
+</pre>
+</div>
+</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>
Modified: excalibur/site/event/command-howto.html
URL: http://svn.apache.org/viewvc/excalibur/site/event/command-howto.html?rev=785324&r1=785323&r2=785324&view=diff
==============================================================================
--- excalibur/site/event/command-howto.html (original)
+++ excalibur/site/event/command-howto.html Tue Jun 16 17:55:25 2009
@@ -1,62 +1,509 @@
-<!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 - Event - How To Use Command</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="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="expanded"><a href="../event/index.html"
>Event</a><ul><li class="none"><a href="../event/event.html">Event</a></li><li class="none"><a href="../event/command.html">Command</a></li><li class="none"><a href="../event/mpool.html">MPool</a></li><li class="none"><a href="../event/util.html">Util</a></li><li class="none"><a href="../event/event-howto.html">Use Event Queues</a></li><li class="none"><strong><a href="../event/command-howto.html">Use the Command Manager</a></strong></li><li class="none"><a href="../event/mpool-howto.html">Use MPool</a></li><li class="none"><a href="../event/util-howto.html">Use System Util</a></li><li class="none"><a href="../event/cpuparser-howto.html">Extend System Util</a></li></ul></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://w
ww.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="Setting_Up_The_Command_Manager"></a><h2>Setting Up The Command Manager</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 - Event - How To Use Command</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="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="expanded">
+ <a href="../event/index.html">Event</a>
+ <ul>
+
+ <li class="none">
+ <a href="../event/event.html">Event</a>
+ </li>
+
+ <li class="none">
+ <a href="../event/command.html">Command</a>
+ </li>
+
+ <li class="none">
+ <a href="../event/mpool.html">MPool</a>
+ </li>
+
+ <li class="none">
+ <a href="../event/util.html">Util</a>
+ </li>
+
+ <li class="none">
+ <a href="../event/event-howto.html">Use Event Queues</a>
+ </li>
+
+ <li class="none">
+ <strong>Use the Command Manager</strong>
+ </li>
+
+ <li class="none">
+ <a href="../event/mpool-howto.html">Use MPool</a>
+ </li>
+
+ <li class="none">
+ <a href="../event/util-howto.html">Use System Util</a>
+ </li>
+
+ <li class="none">
+ <a href="../event/cpuparser-howto.html">Extend System Util</a>
+ </li>
+ </ul>
+ </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="Setting_Up_The_Command_Manager"></a>Setting Up The Command Manager</h2>
+<p>
Using Command is a two step process. You have to set it up,
and then you can send Commands to it. Because Command uses
an Event Pipeline to move the Commands through the Queue to
the EventHandler, we need to set up a ThreadManager. Currently
the only ThreadManager that works as advertized is the TPCThreadManager.
- TPC stands for "Thread Per CPU". The TPCThreadManager allows
+ TPC stands for "Thread Per CPU". The TPCThreadManager allows
you to customize its behaviour by passing in some parameters.
The code snippet below is fairly typical:
</p>
- <div class="source"><pre>
+<div class="source"><pre>
ThreadManager threadManager = new TPCThreadManager();
-threadManager.enableLogging( getLogger().getChildLogger("threadmanager") );
+threadManager.enableLogging( getLogger().getChildLogger("threadmanager") );
Parameters params = new Parameters();
-params.setParameter( "threads-per-processor", "2" );
-params.setParameter( "sleep-time", "1000" );
-params.setParameter( "block-timeout", "250" );
+params.setParameter( "threads-per-processor", "2" );
+params.setParameter( "sleep-time", "1000" );
+params.setParameter( "block-timeout", "250" );
threadManager.parameterize( params );
threadManager.initialize();
- </pre></div>
- <p>
+ </pre>
+</div>
+<p>
We create a Threadmanager, pass in the Logger, pass in the Parameters,
and then initialize it. The table below provides all the parameter names
that TPCThreadManager recognizes:
- </p><table class="bodyTable"><tr class="b"><th>Name</th><th>Description</th><th>Default Value</th></tr><tr class="a"><td>processors</td><td>Number of processors (autodetected if less than one)</td><td>Results from SystemUtil.numProcessors()</td></tr><tr class="b"><td>threads-per-processor</td><td>Threads per processor to use (Rewritten to 1 if less than one)</td><td>1</td></tr><tr class="a"><td>sleep-time</td><td>Time (in milliseconds) to wait between queue pipeline processing runs</td><td>1000</td></tr><tr class="b"><td>block-timeout</td><td>Time (in milliseconds) to wait for a thread to process a pipeline</td><td>1000</td></tr></table><p>
+ </p>
+<table class="bodyTable"><tr class="a"><th>Name</th>
+<th>Description</th>
+<th>Default Value</th>
+</tr>
+<tr class="b"><td>processors</td>
+<td>Number of processors (autodetected if less than one)</td>
+<td>Results from SystemUtil.numProcessors()</td>
+</tr>
+<tr class="a"><td>threads-per-processor</td>
+<td>Threads per processor to use (Rewritten to 1 if less than one)</td>
+<td>1</td>
+</tr>
+<tr class="b"><td>sleep-time</td>
+<td>Time (in milliseconds) to wait between queue pipeline processing runs</td>
+<td>1000</td>
+</tr>
+<tr class="a"><td>block-timeout</td>
+<td>Time (in milliseconds) to wait for a thread to process a pipeline</td>
+<td>1000</td>
+</tr>
+</table>
+<p>
Once the ThreadManager is set up and used, we can set up the CommandManager.
We do this by instantiating the CommandManager, and registering it with the
ThreadManager. Below is a code snippet showing how that is done:
</p>
- <div class="source"><pre>
+<div class="source"><pre>
// Create the CommandManager
CommandManager commandManager = new CommandManager();
@@ -64,11 +511,14 @@
// Register it with the ThreadManager
threadManager.register( commandManager );
- </pre></div>
- </div><div class="section"><a name="Running_Commands"></a><h2>Running Commands</h2><p>
+ </pre>
+</div>
+</div>
+<div class="section"><h2><a name="Running_Commands"></a>Running Commands</h2>
+<p>
There are three Command interfaces: Command, DelayedCommand, and RepeatedCommand.
Each one of those has a special purpose. The Command interface exposes the method
- that the CommandManager will execute named, oddly enough, "execute()". The
+ that the CommandManager will execute named, oddly enough, "execute()". The
Delayed Command is used to specify a number of milliseconds to wait before the
command is run. That delay is based on when the CommandManager receives the
DelayedCommand, not on when the object was created. Lastly the RepeatedCommand
@@ -76,13 +526,14 @@
be executed. Below is a code snippet showing how to send Commands to the
CommandManager:
</p>
- <div class="source"><pre>
+<div class="source"><pre>
Sink commandSink = commandManager.getCommandSink();
commandSink.enqueue( new MySpecialCommand() );
- </pre></div>
- <p>
+ </pre>
+</div>
+<p>
It's not that hard to use the CommandManager. Writing a Command is as easy as
implementing the java.lang.Runnable interface. There are two distinct advantages
to using the Command infrastructure: your Command can throw exceptions and it
@@ -94,7 +545,7 @@
write a RepeatedCommand. Below is an example RepeatedCommand that is used
for the DefaultPoolManager in MPool:
</p>
- <div class="source"><pre>
+<div class="source"><pre>
/**
* This is run every 10 seconds, starting after a 10 second delay.
@@ -158,5 +609,32 @@
}
}
- </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>
Modified: excalibur/site/event/command.html
URL: http://svn.apache.org/viewvc/excalibur/site/event/command.html?rev=785324&r1=785323&r2=785324&view=diff
==============================================================================
--- excalibur/site/event/command.html (original)
+++ excalibur/site/event/command.html Tue Jun 16 17:55:25 2009
@@ -1,31 +1,455 @@
-<!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 - Event - Command</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="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="expanded"><a href="../event/index.html"
>Event</a><ul><li class="none"><a href="../event/event.html">Event</a></li><li class="none"><strong><a href="../event/command.html">Command</a></strong></li><li class="none"><a href="../event/mpool.html">MPool</a></li><li class="none"><a href="../event/util.html">Util</a></li><li class="none"><a href="../event/event-howto.html">Use Event Queues</a></li><li class="none"><a href="../event/command-howto.html">Use the Command Manager</a></li><li class="none"><a href="../event/mpool-howto.html">Use MPool</a></li><li class="none"><a href="../event/util-howto.html">Use System Util</a></li><li class="none"><a href="../event/cpuparser-howto.html">Extend System Util</a></li></ul></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://w
ww.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="Why_Command_Was_Created"></a><h2>Why Command Was Created</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 - Event - Command</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="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="expanded">
+ <a href="../event/index.html">Event</a>
+ <ul>
+
+ <li class="none">
+ <a href="../event/event.html">Event</a>
+ </li>
+
+ <li class="none">
+ <strong>Command</strong>
+ </li>
+
+ <li class="none">
+ <a href="../event/mpool.html">MPool</a>
+ </li>
+
+ <li class="none">
+ <a href="../event/util.html">Util</a>
+ </li>
+
+ <li class="none">
+ <a href="../event/event-howto.html">Use Event Queues</a>
+ </li>
+
+ <li class="none">
+ <a href="../event/command-howto.html">Use the Command Manager</a>
+ </li>
+
+ <li class="none">
+ <a href="../event/mpool-howto.html">Use MPool</a>
+ </li>
+
+ <li class="none">
+ <a href="../event/util-howto.html">Use System Util</a>
+ </li>
+
+ <li class="none">
+ <a href="../event/cpuparser-howto.html">Extend System Util</a>
+ </li>
+ </ul>
+ </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="Why_Command_Was_Created"></a>Why Command Was Created</h2>
+<p>
Command was created as a way to offload management functions
to a CommandManager which would execute the functions in the
background. The benefits of this approach are tremendous
@@ -35,8 +459,11 @@
management), and you reduce the time for the critical path
to execute. The critical path is the part of your code that
actually solves your problems as opposed to managing resources.
- </p></div><div class="section"><a name="When_To_Use_Command"></a><h2>When To Use Command</h2><p>
- A better question might be "when should I not to use Command?".
+ </p>
+</div>
+<div class="section"><h2><a name="When_To_Use_Command"></a>When To Use Command</h2>
+<p>
+ A better question might be "when should I not to use Command?".
The complexity of the thread management and command timing is
completely hidden from you. That makes Command as easy to
use as any event based system like Swing. That said, if you
@@ -44,7 +471,10 @@
request loads it is definitely easier to design your system
the old fashioned way. If you do expect your application to
work under heavy load, you will find Command to be indespensible.
- </p></div><div class="section"><a name="Core_Concepts"></a><h2>Core Concepts</h2><p>
+ </p>
+</div>
+<div class="section"><h2><a name="Core_Concepts"></a>Core Concepts</h2>
+<p>
Command is built on top of
<link href="event.html">Event</link>.
That means we use a Command Sink to enqueue Commands for the
@@ -52,7 +482,9 @@
commands as they are pulled off of the queue. A Command can be
a repeating command, so CommandManager will automatically requeue
that command for you.
- </p><div class="section"><a name="Command"></a><h2>Command</h2><p>
+ </p>
+<div class="section"><h2><a name="Command"></a>Command</h2>
+<p>
A Command is an object that performs any function you desire.
You create it by simply implementing the Command interface.
There are three types of commands: a generic command that is
@@ -60,14 +492,48 @@
that is executed after a specified period of time, and a
repeated command that is executed again and again until the
Command Manager is shut down.
- </p></div><div class="section"><a name="Command_Manager"></a><h2>Command Manager</h2><p>
+ </p>
+</div>
+<div class="section"><h2><a name="Command_Manager"></a>Command Manager</h2>
+<p>
The Command Manager takes care of processing both Commands
and Signals. With Signals, it will notify the registered
Signal listener. With commands it schedules their execution
in a background thread.
- </p></div><div class="section"><a name="Thread_Manager"></a><h2>Thread Manager</h2><p>
+ </p>
+</div>
+<div class="section"><h2><a name="Thread_Manager"></a>Thread Manager</h2>
+<p>
A Thread Manager takes care of the threading policy for the
Command Manager. It manages the thread pool size, and how
often the Event Pipeline (the path from a Source to an
EventHandler) is checked.
- </p></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>
+</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