avalon-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mcconn...@apache.org
Subject cvs commit: jakarta-avalon-excalibur/meta/src/xdocs profile.xml menu.xml
Date Mon, 11 Nov 2002 11:58:48 GMT
mcconnell    2002/11/11 03:58:47

  Modified:    meta/src/xdocs menu.xml
  Added:       meta/src/xdocs profile.xml
  Log:
  Update to the menu to include the profile documentation and initial commit
  of the profile description, UML, and XML examples.
  
  Revision  Changes    Path
  1.3       +10 -6     jakarta-avalon-excalibur/meta/src/xdocs/menu.xml
  
  Index: menu.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-avalon-excalibur/meta/src/xdocs/menu.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- menu.xml	22 Sep 2002 07:55:15 -0000	1.2
  +++ menu.xml	11 Nov 2002 11:58:47 -0000	1.3
  @@ -11,18 +11,22 @@
               <item name="Tools" href="tools.html"/>
           </menu>
   
  +        <menu name="Profile">
  +            <item name="Profile Defintion" href="profile.html"/>
  +        </menu>
  +
  +        <menu name="Service">
  +            <item name="Service Definition" href="service.html"/>
  +        </menu>
  +
           <menu name="Type">
               <item name="Type Defintion" href="type.html"/>
  -            <item name="Logging" href="logging.html"/>
  -            <item name="Context" href="context.html"/>
  +            <item name="Logging Crieria" href="logging.html"/>
  +            <item name="Context Crieria" href="context.html"/>
               <item name="Services" href="services.html"/>
               <item name="Dependencies" href="dependencies.html"/>
               <item name="Extensions" href="extensions.html"/>
               <item name="Stages" href="stages.html"/>
  -        </menu>
  -
  -        <menu name="Service">
  -            <item name="Service Definition" href="service.html"/>
           </menu>
   
           <menu name="Links">
  
  
  
  1.1                  jakarta-avalon-excalibur/meta/src/xdocs/profile.xml
  
  Index: profile.xml
  ===================================================================
  <?xml version="1.0"?>
  
  <document>
  
    <header>
      <title>Profile Definition</title>
      <authors>
        <person name="Stephen McConnell" email="mcconnell@apache.org"/>
      </authors>
    </header>
  
    <body>
  
      <s1 title="Introduction">
  <p>A profile is the definition of the criteria for the establishment of a component.
 A profile, when included within the scope of a container declaration, will be instantiated
in the model as an EXPLICIT profile resulting in the initiation of dependency resolution relative
to the component as the target deployment objective.  Multiple supplementary profiles may
be packaged in a files &lt;classname&gt;.xprofile.  Profile declarations included
within an .xprofile resource are refered to as packaged profiles.</p>
  
  <p>A profile represents an aggregation of the following information:</p>
  <ul>
  <li>the component Type that the profile is qualifying</li>
  <li>a logging directive within which multiple logging categories declare the priority
and target to set for a  logging channel</li>
  <li>a context directive that contains:
    <ul>
      <li>import directives the declare to a container that the component expects the
host container to supply the context entry</li>
      <li>context creation directives then enable the declarative specification of the
criteria for the creation of a context value usingh constructor parameters</li>
    </ul>
  </li>
  <li>the configuration to be used</li>
  <li>the parameters to be applied</li>
  </ul>
  
  <s2 title="UML">
  <p>An overview of the Profile object model is presented in the following UML diagram.</p>
  <img src="images/Profile.gif" />
  </s2>
  
  <s2 title="XML">
  <p>The Profile API includes factory services that support the creation of a profile
instance from an XML description.  The following XML is an example of a profile declaration.</p>
  
  <source>
   <font color="gray"><i>&lt;!--
   Declaration of the services hosted by this container.  Service container here
   will be managed relative to other provider components at the same level and
   may be serviced by components declared in parent container.
   --&gt;</i></font>
  
   &lt;component name="<font color="darkred">complex</font>" class="<font
color="darkred">org.apache.excalibur.playground.ComplexComponent</font>" activation="<font
color="darkred">startup</font>"&gt;
  
   <font color="gray"><i>&lt;!--
   Priority and target assignments for component specific logging categrories.
   --&gt;</i></font>
  
   &lt;categories priority="<font color="darkred">DEBUG</font>"&gt;
   &lt;category name="<font color="darkred">init</font>" priority="<font
color="darkred">DEBUG</font>" /&gt;
   &lt;/categories&gt;
  
   <font color="gray"><i>&lt;!--
   Include the following context value in the context supplied a component using this
   profile.  Context entries are normally only required in the case where the component
   type declares a required context type and entry values. Generally speaking, a component
   will normally qualify it's instantiation criteria through a configuration declaration.
   Any context values defined at this level will override context values supplied by the
   container.
   --&gt;</i></font>
  
   &lt;context&gt;
   &lt;entry name="<font color="darkred">location</font>" value="<font
color="darkred">Paris</font>"/&gt;
   &lt;/context&gt;
  
   <font color="gray"><i>&lt;!--
   Apply the following configuration when instantiating the component.  This configuration
   will be applied as the primary configuration in a cascading configuration chain.  A
   type may declare a default configuration under a "classname".xconfig file that will be
   used to dereference any configuration requests not resolvable by the configuration
   supplied here.
   --&gt;</i></font>
  
   &lt;configuration&gt;
   &lt;message value="<font color="darkred">Hello</font>"/&gt;
   &lt;/configuration&gt;
  
   <font color="gray"><i>&lt;!--
   The parameterization criteria from this instance of the component type.
   --&gt;</i></font>
  
   &lt;parameters/&gt;
  
   &lt;/component&gt;
  </source>
  </s2>
  </s1>
    </body>
  
    <footer>
      <legal>
        Copyright (c) @year@ The Jakarta Apache Project All rights reserved.
        $Revision: 1.1 $ $Date: 2002/11/11 11:58:47 $
      </legal>
    </footer>
  
  </document>
  
  
  
  
  

--
To unsubscribe, e-mail:   <mailto:avalon-cvs-unsubscribe@jakarta.apache.org>
For additional commands, e-mail: <mailto:avalon-cvs-help@jakarta.apache.org>


Mime
View raw message