husted 2002/07/07 11:57:50 Modified: doc newbie.xml Log: Add definitions for application modules and module-relative. Revision Changes Path 1.8 +31 -0 jakarta-struts/doc/newbie.xml Index: newbie.xml =================================================================== RCS file: /home/cvs/jakarta-struts/doc/newbie.xml,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- newbie.xml 15 Jun 2002 12:09:33 -0000 1.7 +++ newbie.xml 7 Jul 2002 18:57:50 -0000 1.8 @@ -13,6 +13,8 @@ their first project. <b>For an in-depth, searchable FAQ, visit our friends at <a href="http://www.jguru.com/faq/home.jsp?topic=Struts";>JGuru</a>.</b></p> <ul> + <li><a href="#modules">What is a modular application? What does module-relative mean?</a></li> + <li><a href="#naming">Why are some of the class and element names counter-intuitive?</a></li> <li>Why is ActionForm a base class rather than an interface?</li> @@ -64,6 +66,35 @@ </ul> </section> + +<section href="modules" name="What is a modular application? What does module-relative mean?"> + +<p> +Since Struts 1.1, the framework supports multiple application modules. All applications have at +least one root, or default, module. Like the root directory in a file system, the default application +has no name. (Or is named with an empty string, depending your viewpoint.) Developing an application +with only a default module is no different from how applications were developed under Struts 1.0. +Since Struts 1.1, you can add additional modules to your application, each of which can have their +own configuration files, messages resources, and so forth. Each module is developed in the same way as +the default module. Applications that were developed as a single module can added to a multiple +module application, and modules can promoted to a standalone application without change. For more +about configuring your application to support multiple modules, see +<a href="userGuide/building_controller.html#module_config">Building Controller Components</a> in the +User Guide. +</p> + +<p> +But to answer the question =:0), a modular application is a Struts application that uses more than +one module. Module-relative means that the URI starts at the application-module level, rather than at +the application-context level, or the absolute-URL level. +</p> +<ul> +<li>Absolute URL: http://localhost/myApplication/myModule/myAction.do</li> +<li>context-relative: /myModule/myAction.do</li> +<li>module-relative: /myAction.do</li> +</ul> + +</section> <section href="naming" name="Why are some of the class and element names counter-intuitive?"> <p>
-- To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]> For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
