leosimons 2003/02/07 08:08:13 Modified: fortress/src/java/org/apache/avalon/fortress/impl ComponentHandlerEntry.java ComponentHandlerMetaData.java DefaultContainer.java DefaultContainerManager.java fortress/src/java/org/apache/avalon/fortress/impl/handler AbstractComponentHandler.java ComponentHandler.java FactoryComponentHandler.java PassThroughInvocationHandler.java PerThreadComponentHandler.java PoolableComponentHandler.java PrepareHandlerCommand.java ProxyObjectFactory.java ThreadSafeComponentHandler.java fortress/src/java/org/apache/avalon/fortress/impl/lookup FortressServiceManager.java FortressServiceSelector.java fortress/src/java/org/apache/avalon/fortress/impl/role AbstractRoleManager.java ConfigurableRoleManager.java FortressRoleManager.java fortress/src/java/org/apache/avalon/fortress/util ContextBuilder.java ContextManager.java OverridableContext.java fortress/src/xdocs cli.xml getting-started.xml index.xml lifecycle-extensions.xml servlet.xml swing.xml Log: [EMAIL PROTECTED][EMAIL PROTECTED]/ Revision Changes Path 1.2 +2 -2 avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/ComponentHandlerEntry.java Index: ComponentHandlerEntry.java =================================================================== RCS file: /home/cvs/avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/ComponentHandlerEntry.java,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- ComponentHandlerEntry.java 27 Jan 2003 16:55:41 -0000 1.1 +++ ComponentHandlerEntry.java 7 Feb 2003 16:08:11 -0000 1.2 @@ -13,7 +13,7 @@ * This is the impl of runtime information about a * ComponentHandler. * - * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> + * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> * @version $Revision$ $Date$ */ class ComponentHandlerEntry 1.2 +2 -2 avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/ComponentHandlerMetaData.java Index: ComponentHandlerMetaData.java =================================================================== RCS file: /home/cvs/avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/ComponentHandlerMetaData.java,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- ComponentHandlerMetaData.java 27 Jan 2003 16:55:41 -0000 1.1 +++ ComponentHandlerMetaData.java 7 Feb 2003 16:08:11 -0000 1.2 @@ -12,7 +12,7 @@ /** * A class holding metadata about a component handler. * - * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> + * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> * @version $Revision$ $Date$ */ public class ComponentHandlerMetaData 1.3 +2 -2 avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/DefaultContainer.java Index: DefaultContainer.java =================================================================== RCS file: /home/cvs/avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/DefaultContainer.java,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- DefaultContainer.java 27 Jan 2003 17:48:49 -0000 1.2 +++ DefaultContainer.java 7 Feb 2003 16:08:11 -0000 1.3 @@ -59,7 +59,7 @@ * This is the default implementation of {@link org.apache.avalon.fortress.Container}, * adding configuration markup semantics to the {@link AbstractContainer}. * - * @author <a href="mailto:[EMAIL PROTECTED]">The Avalon Team</a> + * @author <a href="mailto:[EMAIL PROTECTED]">The Avalon Team</a> * @version CVS $Revision$ $Date$ */ public class DefaultContainer 1.2 +2 -2 avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/DefaultContainerManager.java Index: DefaultContainerManager.java =================================================================== RCS file: /home/cvs/avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/DefaultContainerManager.java,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- DefaultContainerManager.java 27 Jan 2003 16:55:41 -0000 1.1 +++ DefaultContainerManager.java 7 Feb 2003 16:08:11 -0000 1.2 @@ -71,7 +71,7 @@ * This is the default implementation of the {@link org.apache.avalon.fortress.ContainerManager} interface. * See that interface for a description. * - * @author <a href="mailto:[EMAIL PROTECTED]">The Avalon Team</a> + * @author <a href="mailto:[EMAIL PROTECTED]">The Avalon Team</a> * @version CVS $Revision$ $Date$ */ public class DefaultContainerManager 1.2 +2 -2 avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/handler/AbstractComponentHandler.java Index: AbstractComponentHandler.java =================================================================== RCS file: /home/cvs/avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/handler/AbstractComponentHandler.java,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- AbstractComponentHandler.java 27 Jan 2003 16:55:41 -0000 1.1 +++ AbstractComponentHandler.java 7 Feb 2003 16:08:11 -0000 1.2 @@ -65,7 +65,7 @@ * AbstractComponentHandler class, ensures components are initialized * and destroyed correctly. * - * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> + * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> * @version CVS $Revision$ $Date$ * @since 4.0 */ 1.2 +2 -2 avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/handler/ComponentHandler.java Index: ComponentHandler.java =================================================================== RCS file: /home/cvs/avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/handler/ComponentHandler.java,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- ComponentHandler.java 27 Jan 2003 16:55:41 -0000 1.1 +++ ComponentHandler.java 7 Feb 2003 16:08:12 -0000 1.2 @@ -54,7 +54,7 @@ * The desire for a ComponentHandler is to manage the instances of a * Component. * - * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> + * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> * @version CVS $Revision$ $Date$ * @since 4.0 */ 1.2 +2 -2 avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/handler/FactoryComponentHandler.java Index: FactoryComponentHandler.java =================================================================== RCS file: /home/cvs/avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/handler/FactoryComponentHandler.java,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- FactoryComponentHandler.java 27 Jan 2003 16:55:41 -0000 1.1 +++ FactoryComponentHandler.java 7 Feb 2003 16:08:12 -0000 1.2 @@ -53,7 +53,7 @@ * The FactoryComponentHandler to make sure components are initialized * and destroyed correctly. * - * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> + * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> * @version CVS $Revision$ $Date$ * @since 4.0 */ 1.2 +1 -1 avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/handler/PassThroughInvocationHandler.java Index: PassThroughInvocationHandler.java =================================================================== RCS file: /home/cvs/avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/handler/PassThroughInvocationHandler.java,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- PassThroughInvocationHandler.java 27 Jan 2003 16:55:41 -0000 1.1 +++ PassThroughInvocationHandler.java 7 Feb 2003 16:08:12 -0000 1.2 @@ -14,7 +14,7 @@ /** * InvocationHandler that just passes on all methods to target object. * - * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> + * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> */ final class PassThroughInvocationHandler implements InvocationHandler 1.2 +2 -2 avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/handler/PerThreadComponentHandler.java Index: PerThreadComponentHandler.java =================================================================== RCS file: /home/cvs/avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/handler/PerThreadComponentHandler.java,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- PerThreadComponentHandler.java 27 Jan 2003 16:55:41 -0000 1.1 +++ PerThreadComponentHandler.java 7 Feb 2003 16:08:12 -0000 1.2 @@ -52,7 +52,7 @@ * The ThreadSafeComponentHandler to make sure components are initialized * and destroyed correctly. * - * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> + * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> * @version CVS $Revision$ $Date$ * @since 4.0 */ 1.2 +2 -2 avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/handler/PoolableComponentHandler.java Index: PoolableComponentHandler.java =================================================================== RCS file: /home/cvs/avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/handler/PoolableComponentHandler.java,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- PoolableComponentHandler.java 27 Jan 2003 16:55:41 -0000 1.1 +++ PoolableComponentHandler.java 7 Feb 2003 16:08:12 -0000 1.2 @@ -61,7 +61,7 @@ * The PoolableComponentHandler to make sure components are initialized * and destroyed correctly. * - * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> + * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> * @version CVS $Revision$ $Date$ * @since 4.0 */ 1.2 +2 -2 avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/handler/PrepareHandlerCommand.java Index: PrepareHandlerCommand.java =================================================================== RCS file: /home/cvs/avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/handler/PrepareHandlerCommand.java,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- PrepareHandlerCommand.java 27 Jan 2003 16:55:41 -0000 1.1 +++ PrepareHandlerCommand.java 7 Feb 2003 16:08:12 -0000 1.2 @@ -57,7 +57,7 @@ /** * This is the command class to initialize a ComponentHandler * - * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> + * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> * @version CVS $Revision$ $Date$ */ public final class PrepareHandlerCommand implements Command 1.2 +2 -2 avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/handler/ProxyObjectFactory.java Index: ProxyObjectFactory.java =================================================================== RCS file: /home/cvs/avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/handler/ProxyObjectFactory.java,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- ProxyObjectFactory.java 27 Jan 2003 16:55:41 -0000 1.1 +++ ProxyObjectFactory.java 7 Feb 2003 16:08:12 -0000 1.2 @@ -13,7 +13,7 @@ * An ObjectFactory that delegates to another ObjectFactory * and proxies results of that factory. * - * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> + * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> * @version $Revision$ $Date$ */ public class ProxyObjectFactory 1.2 +2 -2 avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/handler/ThreadSafeComponentHandler.java Index: ThreadSafeComponentHandler.java =================================================================== RCS file: /home/cvs/avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/handler/ThreadSafeComponentHandler.java,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- ThreadSafeComponentHandler.java 27 Jan 2003 16:55:41 -0000 1.1 +++ ThreadSafeComponentHandler.java 7 Feb 2003 16:08:12 -0000 1.2 @@ -53,7 +53,7 @@ * The ThreadSafeComponentHandler to make sure components are initialized * and destroyed correctly. * - * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> + * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> * @version CVS $Revision$ $Date$ * @since 4.0 */ 1.3 +2 -2 avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/lookup/FortressServiceManager.java Index: FortressServiceManager.java =================================================================== RCS file: /home/cvs/avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/lookup/FortressServiceManager.java,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- FortressServiceManager.java 4 Feb 2003 19:39:36 -0000 1.2 +++ FortressServiceManager.java 7 Feb 2003 16:08:12 -0000 1.3 @@ -65,7 +65,7 @@ * a very simple abstraction, and makes it easy for the Container to manage * the references. * - * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> + * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> * @version CVS $Revision$ $Date$ */ public class FortressServiceManager 1.2 +2 -2 avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/lookup/FortressServiceSelector.java Index: FortressServiceSelector.java =================================================================== RCS file: /home/cvs/avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/lookup/FortressServiceSelector.java,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- FortressServiceSelector.java 27 Jan 2003 16:55:42 -0000 1.1 +++ FortressServiceSelector.java 7 Feb 2003 16:08:12 -0000 1.2 @@ -61,7 +61,7 @@ * a very simple abstraction, and makes it easy for the Container to manage * the references. * - * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> + * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> * @version CVS $Revision$ $Date$ */ public class FortressServiceSelector 1.2 +2 -2 avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/role/AbstractRoleManager.java Index: AbstractRoleManager.java =================================================================== RCS file: /home/cvs/avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/role/AbstractRoleManager.java,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- AbstractRoleManager.java 27 Jan 2003 16:55:42 -0000 1.1 +++ AbstractRoleManager.java 7 Feb 2003 16:08:12 -0000 1.2 @@ -58,7 +58,7 @@ * The Excalibur Role Manager is used for Excalibur Role Mappings. All of * the information is hard-coded. * - * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> + * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> * @version CVS $Revision$ $Date$ * @since 4.1 */ 1.2 +2 -2 avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/role/ConfigurableRoleManager.java Index: ConfigurableRoleManager.java =================================================================== RCS file: /home/cvs/avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/role/ConfigurableRoleManager.java,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- ConfigurableRoleManager.java 27 Jan 2003 16:55:42 -0000 1.1 +++ ConfigurableRoleManager.java 7 Feb 2003 16:08:12 -0000 1.2 @@ -59,7 +59,7 @@ * from a configuration hierarchy. This is based on the DefaultRoleManager * in the org.apache.avalon.component package. * - * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> + * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> * @version CVS $Revision$ $Date$ * @since 4.1 */ 1.3 +2 -2 avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/role/FortressRoleManager.java Index: FortressRoleManager.java =================================================================== RCS file: /home/cvs/avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/impl/role/FortressRoleManager.java,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- FortressRoleManager.java 5 Feb 2003 19:44:59 -0000 1.2 +++ FortressRoleManager.java 7 Feb 2003 16:08:12 -0000 1.3 @@ -55,7 +55,7 @@ * The Excalibur Role Manager is used for Excalibur Role Mappings. All of * the information is hard-coded. * - * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> + * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> * @version CVS $Revision$ $Date$ */ public class FortressRoleManager 1.2 +2 -2 avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/util/ContextBuilder.java Index: ContextBuilder.java =================================================================== RCS file: /home/cvs/avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/util/ContextBuilder.java,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- ContextBuilder.java 27 Jan 2003 16:55:42 -0000 1.1 +++ ContextBuilder.java 7 Feb 2003 16:08:12 -0000 1.2 @@ -61,7 +61,7 @@ /** * Helper class to create a context for the ContextManager. - * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> + * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> * @version CVS $Revision$ $Date$ */ public class ContextBuilder 1.2 +2 -2 avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/util/ContextManager.java Index: ContextManager.java =================================================================== RCS file: /home/cvs/avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/util/ContextManager.java,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- ContextManager.java 27 Jan 2003 16:55:42 -0000 1.1 +++ ContextManager.java 7 Feb 2003 16:08:12 -0000 1.2 @@ -114,7 +114,7 @@ * component m_manager, a pool m_manager, etc. It will manage these components * and dispose of them properly when it itself is disposed .</p> * - * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> + * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> * @version CVS $Revision$ $Date$ * @since 4.1 */ 1.2 +2 -2 avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/util/OverridableContext.java Index: OverridableContext.java =================================================================== RCS file: /home/cvs/avalon-excalibur/fortress/src/java/org/apache/avalon/fortress/util/OverridableContext.java,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- OverridableContext.java 27 Jan 2003 16:55:43 -0000 1.1 +++ OverridableContext.java 7 Feb 2003 16:08:12 -0000 1.2 @@ -56,7 +56,7 @@ * The OverridableContext allows you to "null" out entries, even if they are * in a parent context. * - * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> + * @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a> * @version CVS $Revision$ $Date$ */ public final class OverridableContext 1.2 +1 -1 avalon-excalibur/fortress/src/xdocs/cli.xml Index: cli.xml =================================================================== RCS file: /home/cvs/avalon-excalibur/fortress/src/xdocs/cli.xml,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- cli.xml 24 Jan 2003 04:34:18 -0000 1.1 +++ cli.xml 7 Feb 2003 16:08:12 -0000 1.2 @@ -4,7 +4,7 @@ <header> <title>Excalibur Fortress - CLI Applications</title> <authors> - <person name="The Avalon Documentation Team" email="[EMAIL PROTECTED]"/> + <person name="The Avalon Documentation Team" email="[EMAIL PROTECTED]"/> </authors> </header> <body> 1.3 +202 -101 avalon-excalibur/fortress/src/xdocs/getting-started.xml Index: getting-started.xml =================================================================== RCS file: /home/cvs/avalon-excalibur/fortress/src/xdocs/getting-started.xml,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- getting-started.xml 6 Feb 2003 13:38:30 -0000 1.2 +++ getting-started.xml 7 Feb 2003 16:08:12 -0000 1.3 @@ -1,101 +1,202 @@ -<?xml version="1.0"?> - -<document> - <header> - <title>Excalibur Fortress - Getting Started</title> - <authors> - <person name="The Avalon Documentation Team" email="[EMAIL PROTECTED]"/> - </authors> - </header> - <body> - <s1 title="Introduction"> - <p> - This is a brief guide to getting you up and running with fortress. - For complex topics like how to decompose a system into individual - components, Seperation of Concerns, etc, refer to other documentation. - </p> - </s1> - <s1 title="Getting your stuff together"> - <ul> - <li>If you haven't already, download and install the latest version - of <link href="http://ant.apache.org/">Apache Ant</link>.</li> - <li>Get and install a CVS client (see - <link href="http://jakarta.apache.org/site/cvsindex.html">here</link> - for information on CVS).</li> - <li>Check out the modules avalon, avalon-excalibur, - avalon-logkit and jakarta-site</li> - <li>Use ant to build the various projects: - <source> -cd $CVSROOT/avalon -ant jar -cd $CVSROOT/avalon-logkit -ant jar -cd $CVSROOT/avalon-excalibur/fortress -ant dist -cd examples -ant - </source> - If something goes wrong, run ant in verbose mode using the -v option and - send the output to the avalon-user mailing list. Someone'll help you out. - </li> - </ul> - - <p>Or, if you hate CVS, get a nightly build.</p> - </s1> - <s1 title="Hello, world!"> - <p>You just built fortress, its dependencies, and its examples from cvs in - the previous step. This enables you to (finally!) run a HelloWorld demo. - change into the bin directory for the examples and run the - scripts there (runswing.sh is a nice one).</p> - </s1> - <s1 title="Well, duh! So now what?"> - <s2 title="Play with the examples"> - <p>After looking at the sources to the examples provided and figuring out - what goes on (if you're an IDE person, run the examples in your IDE - debugger! If you develop servlets, be sure to try to get the servlet - example to run), the real cool but also the hard part begins.</p> - </s2> - <s2 title="Converting from ECM"> - <p>If you're looking at converting an existing avalonized application that - uses ECM, well, we want to write a tool that does this all but automatically - for you. Not there yet though.</p> - </s2> - <s2 title="Convert a non-avalon application"> - <p>The first thing you want to do is to create a fortress instance inside - your applications main loop or bootstrap class. The second thing you want - to do is identify the building blocks of your application, and transform - them into avalon components (by making them passive, and extending the - avalon framework lifecycle interfaces). - Then, create the fortress configuration files to tell it about those new - components, and transfer control over those components from your bootstrap - code to fortress. Done!</p> - <p>Okay, so it may not be so simple as it sounds, but that is the general - idea. Just get started, and come and talk to us on the mailing list when - you get lost.</p> - </s2> - <s2 title="Creating a new application"> - <p>Start with the example that fits your enviroment (console, GUI - or embedded), and simply start hacking from there. You'll want to think - about the various tasks your app serves, and how to decompose your app - into components that fit those tasks. The - <link href="http://jakarta.apache.org/avalon/developing">Developing with Avalon</link> - paper talks you through this.</p> - </s2> - </s1> - <s1 title="Mastering Fortress"> - <p> - The best way to learn about avalon and its concepts is to build your own - container. Try and plug in your own implementations of the different parts - of fortress, like a different ComponentHandler. Once you get a hang of it, - come and join the avalon folks in their quest for the holy grail of - software architecture! - </p> - </s1> - </body> - <footer> - <legal> - Copyright (c) @year@ The Jakarta Apache Project All rights reserved. - $Revision$ $Date$ - </legal> - </footer> -</document> +<?xml version="1.0"?> + + + +<document> + + <header> + + <title>Excalibur Fortress - Getting Started</title> + + <authors> + + <person name="The Avalon Documentation Team" email="[EMAIL PROTECTED]"/> + + </authors> + + </header> + + <body> + + <s1 title="Introduction"> + + <p> + + This is a brief guide to getting you up and running with fortress. + + For complex topics like how to decompose a system into individual + + components, Seperation of Concerns, etc, refer to other documentation. + + </p> + + </s1> + + <s1 title="Getting your stuff together"> + + <ul> + + <li>If you haven't already, download and install the latest version + + of <link href="http://ant.apache.org/">Apache Ant</link>.</li> + + <li>Get and install a CVS client (see + + <link href="http://jakarta.apache.org/site/cvsindex.html">here</link> + + for information on CVS).</li> + + <li>Check out the modules avalon, avalon-excalibur, + + avalon-logkit and jakarta-site</li> + + <li>Use ant to build the various projects: + + <source> + +cd $CVSROOT/avalon + +ant jar + +cd $CVSROOT/avalon-logkit + +ant jar + +cd $CVSROOT/avalon-excalibur/fortress + +ant dist + +cd examples + +ant + + </source> + + If something goes wrong, run ant in verbose mode using the -v option and + + send the output to the avalon-user mailing list. Someone'll help you out. + + </li> + + </ul> + + + + <p>Or, if you hate CVS, get a nightly build.</p> + + </s1> + + <s1 title="Hello, world!"> + + <p>You just built fortress, its dependencies, and its examples from cvs in + + the previous step. This enables you to (finally!) run a HelloWorld demo. + + change into the bin directory for the examples and run the + + scripts there (runswing.sh is a nice one).</p> + + </s1> + + <s1 title="Well, duh! So now what?"> + + <s2 title="Play with the examples"> + + <p>After looking at the sources to the examples provided and figuring out + + what goes on (if you're an IDE person, run the examples in your IDE + + debugger! If you develop servlets, be sure to try to get the servlet + + example to run), the real cool but also the hard part begins.</p> + + </s2> + + <s2 title="Converting from ECM"> + + <p>If you're looking at converting an existing avalonized application that + + uses ECM, well, we want to write a tool that does this all but automatically + + for you. Not there yet though.</p> + + </s2> + + <s2 title="Convert a non-avalon application"> + + <p>The first thing you want to do is to create a fortress instance inside + + your applications main loop or bootstrap class. The second thing you want + + to do is identify the building blocks of your application, and transform + + them into avalon components (by making them passive, and extending the + + avalon framework lifecycle interfaces). + + Then, create the fortress configuration files to tell it about those new + + components, and transfer control over those components from your bootstrap + + code to fortress. Done!</p> + + <p>Okay, so it may not be so simple as it sounds, but that is the general + + idea. Just get started, and come and talk to us on the mailing list when + + you get lost.</p> + + </s2> + + <s2 title="Creating a new application"> + + <p>Start with the example that fits your enviroment (console, GUI + + or embedded), and simply start hacking from there. You'll want to think + + about the various tasks your app serves, and how to decompose your app + + into components that fit those tasks. The + + <link href="http://jakarta.apache.org/avalon/developing">Developing with Avalon</link> + + paper talks you through this.</p> + + </s2> + + </s1> + + <s1 title="Mastering Fortress"> + + <p> + + The best way to learn about avalon and its concepts is to build your own + + container. Try and plug in your own implementations of the different parts + + of fortress, like a different ComponentHandler. Once you get a hang of it, + + come and join the avalon folks in their quest for the holy grail of + + software architecture! + + </p> + + </s1> + + </body> + + <footer> + + <legal> + + Copyright (c) @year@ The Jakarta Apache Project All rights reserved. + + $Revision$ $Date$ + + </legal> + + </footer> + +</document> + 1.8 +2 -2 avalon-excalibur/fortress/src/xdocs/index.xml Index: index.xml =================================================================== RCS file: /home/cvs/avalon-excalibur/fortress/src/xdocs/index.xml,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- index.xml 6 Feb 2003 13:38:30 -0000 1.7 +++ index.xml 7 Feb 2003 16:08:12 -0000 1.8 @@ -4,7 +4,7 @@ <header> <title>Excalibur Fortress - Overview</title> <authors> - <person name="The Avalon Documentation Team" email="[EMAIL PROTECTED]"/> + <person name="The Avalon Documentation Team" email="[EMAIL PROTECTED]"/> </authors> </header> <body> 1.5 +2 -2 avalon-excalibur/fortress/src/xdocs/lifecycle-extensions.xml Index: lifecycle-extensions.xml =================================================================== RCS file: /home/cvs/avalon-excalibur/fortress/src/xdocs/lifecycle-extensions.xml,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- lifecycle-extensions.xml 10 Nov 2002 14:43:38 -0000 1.4 +++ lifecycle-extensions.xml 7 Feb 2003 16:08:12 -0000 1.5 @@ -557,7 +557,7 @@ <s1 title="Need more information ?"> <p> If you have any particular questions, comments, etc, please send an email to the Avalon - developer mailing <link href="mailto:[EMAIL PROTECTED]">list</link>. + developer mailing <link href="mailto:[EMAIL PROTECTED]">list</link>. </p> </s1> 1.3 +1 -1 avalon-excalibur/fortress/src/xdocs/servlet.xml Index: servlet.xml =================================================================== RCS file: /home/cvs/avalon-excalibur/fortress/src/xdocs/servlet.xml,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- servlet.xml 28 Jan 2003 21:19:17 -0000 1.2 +++ servlet.xml 7 Feb 2003 16:08:12 -0000 1.3 @@ -4,7 +4,7 @@ <header> <title>Excalibur Fortress - Servlet Applications</title> <authors> - <person name="The Avalon Documentation Team" email="[EMAIL PROTECTED]"/> + <person name="The Avalon Documentation Team" email="[EMAIL PROTECTED]"/> </authors> </header> <body> 1.2 +1 -1 avalon-excalibur/fortress/src/xdocs/swing.xml Index: swing.xml =================================================================== RCS file: /home/cvs/avalon-excalibur/fortress/src/xdocs/swing.xml,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- swing.xml 24 Jan 2003 04:34:18 -0000 1.1 +++ swing.xml 7 Feb 2003 16:08:12 -0000 1.2 @@ -4,7 +4,7 @@ <header> <title>Excalibur Fortress - Swing Applications</title> <authors> - <person name="The Avalon Documentation Team" email="[EMAIL PROTECTED]"/> + <person name="The Avalon Documentation Team" email="[EMAIL PROTECTED]"/> </authors> </header> <body>
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]