Return-Path: Delivered-To: apmail-xml-cocoon-cvs-archive@xml.apache.org Received: (qmail 20729 invoked by uid 500); 21 Jul 2002 22:56:12 -0000 Mailing-List: contact cocoon-cvs-help@xml.apache.org; run by ezmlm Precedence: bulk Reply-To: cocoon-dev@xml.apache.org list-help: list-unsubscribe: list-post: Delivered-To: mailing list cocoon-cvs@xml.apache.org Received: (qmail 20684 invoked by uid 500); 21 Jul 2002 22:56:11 -0000 Delivered-To: apmail-xml-cocoon2-cvs@apache.org Date: 21 Jul 2002 22:56:11 -0000 Message-ID: <20020721225611.514.qmail@icarus.apache.org> From: vgritsenko@apache.org To: xml-cocoon2-cvs@apache.org Subject: cvs commit: xml-cocoon2/src/documentation/xdocs/tutorial tutorial-rmi-generator.xml X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N vgritsenko 2002/07/21 15:56:11 Modified: src/documentation/xdocs Tag: cocoon_2_0_3_branch dictionary.xml src/documentation/xdocs/developing Tag: cocoon_2_0_3_branch avalon.xml datasources.xml extending.xml httprequest.xml src/documentation/xdocs/tutorial Tag: cocoon_2_0_3_branch tutorial-rmi-generator.xml Log: Composer -> Composable Revision Changes Path No revision No revision 1.1.2.1 +1 -1 xml-cocoon2/src/documentation/xdocs/dictionary.xml Index: dictionary.xml =================================================================== RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/dictionary.xml,v retrieving revision 1.1 retrieving revision 1.1.2.1 diff -u -r1.1 -r1.1.2.1 --- dictionary.xml 3 Jan 2002 12:31:01 -0000 1.1 +++ dictionary.xml 21 Jul 2002 22:56:10 -0000 1.1.2.1 @@ -17,7 +17,7 @@ Controls access to sitemap objects. It's in charge of reloading the sitemaps as necessary, and mapping sitemap filenames with sitemap objects. It operates on Environments by processing them with a sitemap. - An aggregate of avalon's Composer, Configurable, and Modifiable interfaces, as well as the cocoon Processor interface. + An aggregate of avalon's Composable, Configurable, Contextualizable, and Modifiable interfaces, as well as the cocoon Processor interface. Parent of the stylesheet-generated sitemap objects. It provides access to all of the cocoon components by role name. It keeps track of when the stylesheet was created. It loads components by name and configures them. It provides a utility substitute method for string manipulation. No revision No revision 1.1.2.1 +3 -3 xml-cocoon2/src/documentation/xdocs/developing/avalon.xml Index: avalon.xml =================================================================== RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/developing/avalon.xml,v retrieving revision 1.1 retrieving revision 1.1.2.1 diff -u -r1.1 -r1.1.2.1 --- avalon.xml 3 Jan 2002 12:31:02 -0000 1.1 +++ avalon.xml 21 Jul 2002 22:56:10 -0000 1.1.2.1 @@ -62,18 +62,18 @@

org.apache.avalon.framework.component.Composable

-

A Composer is a class that need to connect to software +

A Composable is a class that need to connect to software components using a "role" abstraction, thus not depending on particular implementations but on behavioral interfaces.

org.apache.avalon.framework.component.Component

This interface identifies classes that can be used as - Components by a Composer.

+ Components by a Composable.

A Component is the basic building block of Avalon. When a class implements this interface, it allows itself to be managed by a ComponentManager and used by an outside element called a - Composer. The Composer must know what type of + Composable. The Composable must know what type of Component it is accessing, so it will re-cast the Component into the type it needs.

Components in Cocoon are e.g. those defined in 1.1.2.1 +1 -1 xml-cocoon2/src/documentation/xdocs/developing/datasources.xml Index: datasources.xml =================================================================== RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/developing/datasources.xml,v retrieving revision 1.1 retrieving revision 1.1.2.1 diff -u -r1.1 -r1.1.2.1 --- datasources.xml 3 Jan 2002 12:31:02 -0000 1.1 +++ datasources.xml 21 Jul 2002 22:56:10 -0000 1.1.2.1 @@ -132,7 +132,7 @@

No matter how you defined your DataSourceComponent, you access it the same way. Because The DataSourceComponent is a Component, - your class needs to implement the Avalon Composer interface. The + your class needs to implement the Avalon Composable interface. The Avalon Framework will give your class a ComponentManager. At that point, it is up to you how and when you pull the DataSourceComponent out of the ComponentManager. 1.1.2.1 +1 -1 xml-cocoon2/src/documentation/xdocs/developing/extending.xml Index: extending.xml =================================================================== RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/developing/extending.xml,v retrieving revision 1.1 retrieving revision 1.1.2.1 diff -u -r1.1 -r1.1.2.1 --- extending.xml 3 Jan 2002 12:31:02 -0000 1.1 +++ extending.xml 21 Jul 2002 22:56:10 -0000 1.1.2.1 @@ -79,7 +79,7 @@

  • ComposerGenerator - Can be used as base class if you want your Generator to be an Avalon - Composer.
  • + Composable.
  • ServletGenerator - If you want to generate servlets. This is the base class for the ServerPagesGenerator.
  • 1.2.2.4 +3 -3 xml-cocoon2/src/documentation/xdocs/developing/httprequest.xml Index: httprequest.xml =================================================================== RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/developing/httprequest.xml,v retrieving revision 1.2.2.3 retrieving revision 1.2.2.4 diff -u -r1.2.2.3 -r1.2.2.4 --- httprequest.xml 30 Jun 2002 23:26:55 -0000 1.2.2.3 +++ httprequest.xml 21 Jul 2002 22:56:10 -0000 1.2.2.4 @@ -261,7 +261,7 @@
    1. The Handler creates a File object with the asked URL.
    2. -
    3. The Manager sets the Composer and the +
    4. The Manager sets the Composable and the Configuration of the Handler. (These are Avalon things).
    5. If necessary, the Manager asks the @@ -271,7 +271,7 @@
      1. The Handler gets the "program-generator" Component from its - Composer.
      2. + Composable.
      3. The load() method of this ProgramGeneratorImpl is called.
      4. The ProgramGeneratorImpl gets the @@ -307,7 +307,7 @@

        org.apache.cocoon.Cocoon

        While this sounds to be the most important part of the Cocoon - application, it is not. It is merely a Composer, meaning that it does some + application, it is not. It is merely a Composable, meaning that it does some administrative work and gets other classes to work.

        No revision No revision 1.1.2.5 +3 -3 xml-cocoon2/src/documentation/xdocs/tutorial/tutorial-rmi-generator.xml Index: tutorial-rmi-generator.xml =================================================================== RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/tutorial/tutorial-rmi-generator.xml,v retrieving revision 1.1.2.4 retrieving revision 1.1.2.5 diff -u -r1.1.2.4 -r1.1.2.5 --- tutorial-rmi-generator.xml 18 Jul 2002 14:16:41 -0000 1.1.2.4 +++ tutorial-rmi-generator.xml 21 Jul 2002 22:56:10 -0000 1.1.2.5 @@ -297,14 +297,14 @@ -

        Can be used as base class if you want your Generator to be an Avalon Composer
        +

        Can be used as base class if you want your Generator to be an Avalon Composable

        This abstract class extends org.apache.cocoon.generation.AbstractGenerator and extends the interfaces org.apache.avalon.framework.component.Composable and org.apache.avalon.framework.activity.Disposable.

        In addition to all the methods introduced in the AbstractGenerator class, these two interfaces introduce som new methods:

        • From org.apache.avalon.framework.component.Composable:
            -
          • public void compose(ComponentManager componentManager): Pass the ComponentManager to the composer. The Composable implementation should use the specified ComponentManager to acquire the components it needs for execution. +
          • public void compose(ComponentManager componentManager): Pass the ComponentManager to the Composable. The Composable implementation should use the specified ComponentManager to acquire the components it needs for execution.
        • @@ -319,7 +319,7 @@
        • From ComposerGenerator itself:
            -
          • public void compose(ComponentManager componentManager): Pass the ComponentManager to the composer. The Composable implementation should use the specified ComponentManager to acquire the components it needs for execution. (implemented) +
          • public void compose(ComponentManager componentManager): Pass the ComponentManager to the Composable. The Composable implementation should use the specified ComponentManager to acquire the components it needs for execution. (implemented)
          • public void dispose(): The dispose operation is called at the end of a components lifecycle. Components use this method to release and destroy any resources that the Component owns. (implemented - implementation sets the ComponentManager to null) ---------------------------------------------------------------------- In case of troubles, e-mail: webmaster@xml.apache.org To unsubscribe, e-mail: cocoon-cvs-unsubscribe@xml.apache.org For additional commands, e-mail: cocoon-cvs-help@xml.apache.org