mcconnell 2003/08/27 21:06:36
Added: merlin/merlin-platform/xdocs/meta/block categories.xml
components.xml includes.xml index.xml
navigation.xml
merlin/merlin-platform/xdocs/meta/block/classloader
extensions.xml index.xml navigation.xml
merlin/merlin-platform/xdocs/meta/block/classloader/classpath
fileset.xml index.xml navigation.xml repository.xml
merlin/merlin-platform/xdocs/meta/block/classloader/classpath/repository
index.xml navigation.xml resource.xml
merlin/merlin-platform/xdocs/meta/block/components
configuration.xml index.xml navigation.xml
merlin/merlin-platform/xdocs/meta/block/components/categories
category.xml index.xml navigation.xml
merlin/merlin-platform/xdocs/meta/block/components/context
index.xml navigation.xml
merlin/merlin-platform/xdocs/meta/block/components/context/entry
import.xml index.xml navigation.xml
merlin/merlin-platform/xdocs/meta/block/components/context/entry/constructor
index.xml navigation.xml param.xml
merlin/merlin-platform/xdocs/meta/block/components/parameters
index.xml navigation.xml parameter.xml
merlin/merlin-platform/xdocs/meta/block/services index.xml
navigation.xml service.xml
Log:
Updated block deployment meta-data spec.
Revision Changes Path
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/categories.xml
Index: categories.xml
===================================================================
<?xml version="1.0"?>
<document>
<header>
<title>Category Directives</title>
<authors>
<person name="Stephen McConnell" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
<section name="Logging Category Directives">
<p>Component scoped logging directives are relative to the enclosing component
profile declaration. The logging categories are component specific and will normally
be documented as part of the component you are using. The following example is the
logging configuration for the demonstration component included with the
distribution.</p>
<source>
<p><font color="gray"><i><!-- A classpath declaration could be included here or
under the container scope. --></i></font></p>
<container name="<font color="darkred">root</font>">
</source>
<font color="gray"><i><!--
Component profile declaration.
--></i></font>
<source>
<component name="<font color="darkred">complex</font>"
class="<font
color="darkred">org.apache.excalibur.playground.ComplexComponent</font>"
activation="<font color="darkred">true</font>">
</source>
<p><font color="gray"><i><!--
Multiple categories may be declared - each category defines a priority and target to
be used for the respective caegory. Category names are scoped relative to the
component. As such a category name of "init" translates to a full logging category
path of <container-path>root.init. The logging element may contain priority and
target attribute values. These values will overide the container wide defaults.
--></i></font>
</p>
<source>
<categories priority="<font color="darkred">DEBUG</font>">
<category name="<font color="darkred">init</font>" priority="<font
color="darkred">WARN</font>"/>
</categories>
</component>
</source>
<p><font color="gray"><i><!-- Other container declarations. --></i></font></p>
<source>
</container>
</source>
</section>
</body>
<footer>
<legal>
Copyright (c) @year@ The Apache Avalon Project All rights reserved.
$Revision: 1.1 $ $Date: 2003/08/28 04:06:34 $
</legal>
</footer>
</document>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/components.xml
Index: components.xml
===================================================================
<?xml version="1.0"?>
<document>
<header>
<title>Container Managed Component Declaration</title>
<authors>
<person name="Stephen McConnell" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
<section name="Component Directive">
<subsection name="Component Directive">
<p>In preparation.</p>
<p><strong>Attributes</strong></p>
<table>
<tr><th>Attribute</th><th>Required</th><th>Description</th></tr>
<tr>
<td>name</td><td>yes</td>
<td>The name to assign to the component.</td>
</tr>
<tr>
<td>class</td><td>yes</td>
<td>The classname of the component implementation.</td>
</tr>
<tr>
<td>activation</td><td>no</td>
<td>The activation policy. Recognized values include 'startup' and
'lazy'.</td>
</tr>
</table>
<p><strong>Nested Elements</strong></p>
<p>
A component tag supports the same structure as the profile element. See
the <a href="../../profile/index.html">profile</a> tag under
the Meta Model XML description.
</p>
<p><strong>Sample XML</strong></p>
<source><![CDATA[
<container name="tutorial">
<component name="hello" class="tutorial.HelloComponent" activation="startup">
<!-- optional categories element -->
<!-- optional configuration or parameters element -->
<!-- optional context element -->
</component>
</container>
]]></source>
</subsection>
</section>
</body>
</document>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/includes.xml
Index: includes.xml
===================================================================
<?xml version="1.0"?>
<document>
<header>
<title>Include Directive</title>
<authors>
<person name="Stephen McConnell" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
<section name="Include Directive">
<subsection name="Attributes">
<table>
<tr><th>Attribute</th><th>Required</th><th>Description</th></tr>
<tr>
<td>id</td><td>normally</td>
<td>
A resource artifact identifier in form [group]:[artifact-name]. The value
identifes a jar file containing a block defintition that is resolved
relative to a repository established by the Merlin Kernel.
</td>
</tr>
<tr>
<td>version</td><td>no</td>
<td>
Used in conjuction with the id attribute to qualify the artifact version.
</td>
</tr>
<tr>
<td>config</td><td>no</td>
<td>
Relative url referencing a configuration target defintion.
</td>
</tr>
<tr>
<td>path</td><td>no</td>
<td>
May be used to reference a jar file relative to the base directory
of the containing block. Is useful as alternative form to the "id"
model during development. If the "path" attribute is declared, the
id and version attribute will be ignored.
</td>
</tr>
</table>
<p>
NOTE: It is an error the include directive does not container one of
two possible include forms ("path" or "id").
</p>
</subsection>
<subsection name="Description">
<p>An include directive instructs Merlin to load and deploy the block defined within
the referenced jar file as a subcontainer within the enclosing container. The include
directive is equivalent to the nesting of a full block definition within another
block. Block includes enable composition of pre-packaged component based solutions as
the included block appears to other components as a regual component (exposing
services and dependecies, etc.).</p>
</subsection>
<subsection name="Sample XML">
<p>
The following example block.xml demonstrates the inclusion of three blocks within
another enclosing block. In this example, the common shared API (containing service
interfaces classes is declared in the containing block classloader).
</p>
<source><![CDATA[
<container name="tutorial">
<classloader>
<classpath>
<repository>
<resource id="tutorial:composition-api" version="1.0"/>
</repository>
</classpath>
</classloader>
<include id="tutorial:composition-publisher" version="1.0"/>
<include id="tutorial:composition-application" version="1.0"/>
<include id="tutorial:composition-location" version="1.0"/>
</container>
]]></source>
</subsection>
</section>
</body>
</document>
1.1 avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/index.xml
Index: index.xml
===================================================================
<?xml version="1.0"?>
<document>
<header>
<title>Impementation Directive</title>
<authors>
<person name="Stephen McConnell" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
<section name="Container Directive">
<subsection name="Nested Elements">
<table>
<tr><th>Element</th><th>Occurance</th><th>Description</th></tr>
<tr>
<td><a href="services/index.html">services</a></td><td>0..n</td>
<td>
A container can declare the export of a set of services established
by the components contained within it. This enables a container to
function as a composite component relative to its peers.
</td>
</tr>
<tr>
<td><a href="classloader/index.html">classloader</a></td><td>0..1</td>
<td>
The classloader to assign to the container.
</td>
</tr>
<tr>
<td><a href="components/index.html">component</a></td><td>0..n</td>
<td>
A component directive is an instruction to merlin to build
a component of the type specified, and deploy the component
in accordance with a stated policy.
</td>
</tr>
<tr>
<td><a href="index.html">container</a></td><td>0..n</td>
<td>
A container directive is simply a composite component. A container
establishes a partition within which a set of other components and
containers can be declared.
</td>
</tr>
<tr>
<td><a href="include/index.html">include</a></td><td>0..n</td>
<td>
An include directive instructs Merlin to include an external
block within the container. Services exported by the block will
be made available to other components at the same level as the
included block.
</td>
</tr>
</table>
</subsection>
<subsection name="Description">
<p>
A container holds a set of components,
sub-containers, and includes that make up the compostion
of the block in terms of its internal functionality, exported
through optional service directives.
</p>
</subsection>
<subsection name="Sample XML">
<p>
The following XML is a sample of a implementation declaration
containing an engine, components, subcontainers and block includes.
</p>
<source><![CDATA[
<!-- block implementation declaration -->
<container>
<!--
declaration of the classloader that this block
will execute within
-->
<classloader>
<classpath>
<repository>
<resource id="tutorial:composition-api" version="1.0"/>
</repository>
</classpath>
</classloader>
<!--
declaration of a root component (services provided by this component
will be avbailable to all other components at the same or lower levels
in the container hierachy
-->
<component name="application"
class="tutorial.application.Application" activation="startup">
</component>
<!--
declaration of a container contining other components
-->
<container name="subcontainer">
<!--
This component is only visible to other components at the same
level or lower in this branch of the container hierachy
-->
<component name="test2" class="AnotherComponent"/>
<!--
A subcontainer declaring a custom container type.
-->
<container name="testing" class="MySpecialContainerClass">
<!-- etc. -->
</container>
</container>
<!--
Declaration of a block to includes. The inclusion of a block
results in the establishment of a container with a name correponding
to the name of the block.
-->
<include path="example-block.xml"/>
<include id="osm:collaboration" version="1.0"/>
</container>
]]></source>
</subsection>
</section>
</body>
</document>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/navigation.xml
Index: navigation.xml
===================================================================
<?xml version="1.0" encoding="UTF-8"?>
<project>
<title>Merlin</title>
<body>
<links>
<item name="Home" href="http://avalon.apache.org/"/>
<item name="Framework" href="http://avalon.apache.org/framework/"/>
<item name="Components" href="http://avalon.apache.org/components"/>
<item name="Containers" href="http://avalon.apache.org/containers/"/>
<item name="Sandbox" href="http://avalon.apache.org/sandbox/"/>
</links>
<menu name="About Merlin">
<item name="Overview" href="/about/index.html"/>
<item name="Getting Started" href="/starting/index.html"/>
<item name="Merlin System" href="/merlin/index.html"/>
<item name="Meta Model" href="/meta/index.html">
<item name="kernel.xml" href="/meta/kernel/index.html"/>
<item name="blocks.xml" href="/meta/block/index.html">
<item name="services" href="/meta/block/services/index.html"/>
<item name="classloader" href="/meta/block/classloader/index.html"/>
<item name="component" href="/meta/block/components/index.html"/>
<item name="container" href="/meta/block/index.html"/>
<item name="include" href="/meta/block/include/index.html"/>
</item>
<item name="config.xml" href="/meta/config/index.html"/>
</item>
<item name="Tools" href="/tools/index.html"/>
<item name="Resources" href="/resources/index.html"/>
</menu>
<menu name="Extensions">
<item name="JNDI" href="/extensions/jndi/index.html"/>
<item name="Servlet" href="/extensions/servlet/index.html"/>
</menu>
</body>
</project>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/classloader/extensions.xml
Index: extensions.xml
===================================================================
<?xml version="1.0"?>
<document>
<header>
<title>Extension Directive</title>
<authors>
<person name="Stephen McConnell" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
<section name="Library Directive">
<subsection name="Nested Elements">
<table>
<tr><th>Element</th><th>Occurance</th><th>Description</th></tr>
<tr>
<td>include</td><td>0..n</td>
<td>
Declaration of a directory within which the container may
use to resolve optional jar file dependencies.
</td>
</tr>
</table>
</subsection>
<subsection name="Description">
<p>An engine may contain a muliple extensions path declarations that specify the
directories in which extension jar files may be located. Extensions directories may
be declared within any classloader.</p>
<p>The extensions element may contain multiple directory-set declarations, each
containing possible multiple relative directory paths. Merlin will attempt to resolve
any jar files declaring extension dependencies based on the jar files included in the
declared extension directories and the extension directories declared in parent
engine.</p>
</subsection>
<subsection name="Sample XML">
<p>An example of an extensions dir declaration is included below.</p>
<source><![CDATA[
<classloader>
<library dir=".">
<include name="dist"/>
<include name="lib"/>
</library>
</classloader>
]]></source>
</subsection>
</section>
</body>
</document>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/classloader/index.xml
Index: index.xml
===================================================================
<?xml version="1.0"?>
<document>
<header>
<title>Classloader</title>
<authors>
<person name="Stephen McConnell" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
<section name="Classloader Directive">
<subsection name="Nested Elements">
<table>
<tr><th>Element</th><th>Occurance</th><th>Description</th></tr>
<tr>
<td><a href="classpath/index.html">classpath</a></td><td>0..1</td>
<td>
The classloader classpath descriptor.
</td>
</tr>
<tr>
<td><a href="extensions.html">library</a></td><td>0..1</td>
<td>
Jar file option extensions repository.
</td>
</tr>
</table>
</subsection>
<subsection name="Description">
<p>
An engine directive declares the defintion of a classloader to be
used assigned as the context classloader for the container
it is defined within.
</p>
</subsection>
<subsection name="Example XML">
<source><![CDATA[
<classloader>
<classpath>
<repository>
<resource id="tutorial:composition-api" version="1.0"/>
</repository>
</classpath>
</classloader>
]]></source>
</subsection>
</section>
</body>
</document>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/classloader/navigation.xml
Index: navigation.xml
===================================================================
<?xml version="1.0" encoding="UTF-8"?>
<project>
<title>Merlin</title>
<body>
<links>
<item name="Home" href="http://avalon.apache.org/"/>
<item name="Framework" href="http://avalon.apache.org/framework/"/>
<item name="Components" href="http://avalon.apache.org/components"/>
<item name="Containers" href="http://avalon.apache.org/containers/"/>
<item name="Sandbox" href="http://avalon.apache.org/sandbox/"/>
</links>
<menu name="About Merlin">
<item name="Overview" href="/about/index.html"/>
<item name="Getting Started" href="/starting/index.html"/>
<item name="Merlin System" href="/merlin/index.html"/>
<item name="Meta Model" href="/meta/index.html">
<item name="kernel.xml" href="/meta/kernel/index.html"/>
<item name="blocks.xml" href="/meta/block/index.html">
<item name="services" href="/meta/block/services/index.html"/>
<item name="classloader" href="/meta/block/classloader/index.html">
<item name="classpath"
href="/meta/block/classloader/classpath/index.html"/>
<item name="library" href="/meta/block/classloader/extensions.html"/>
</item>
<item name="component" href="/meta/block/components/index.html"/>
<item name="container" href="/meta/block/index.html"/>
<item name="include" href="/meta/block/include/index.html"/>
</item>
<item name="config.xml" href="/meta/config/index.html"/>
</item>
<item name="Tools" href="/tools/index.html"/>
<item name="Resources" href="/resources/index.html"/>
</menu>
<menu name="Extensions">
<item name="JNDI" href="/extensions/jndi/index.html"/>
<item name="Servlet" href="/extensions/servlet/index.html"/>
</menu>
</body>
</project>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/classloader/classpath/fileset.xml
Index: fileset.xml
===================================================================
<?xml version="1.0"?>
<document>
<header>
<title>Fileset Directive</title>
<authors>
<person name="Stephen McConnell" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
<section name="Fileset Declarations">
<subsection name="Nested Elements">
<table>
<tr><th>Element</th><th>Occurance</th><th>Description</th></tr>
<tr>
<td>include</td><td>0..n</td>
<td>
Declaration of a jar file withing the filset directory to be
included within the classloader.
</td>
</tr>
</table>
</subsection>
<subsection name="Description">
<p>Declaration of a set of jar files to include.</p>
</subsection>
<subsection name="Sample XML">
<source>
<fileset dir="<font color="darkred">lib</font>">
<include name="<font color="darkred">avalon-framework.jar</font>"/>
<include name="<font color="darkred">logkit.jar</font>"/>
</fileset>
</source>
</subsection>
</section>
</body>
</document>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/classloader/classpath/index.xml
Index: index.xml
===================================================================
<?xml version="1.0"?>
<document>
<header>
<title>Classpath Directive</title>
<authors>
<person name="Stephen McConnell" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
<section name="Classpath Directive">
<subsection name="Nested Elements">
<table>
<tr><th>Element</th><th>Occurance</th><th>Description</th></tr>
<tr>
<td><a href="repository/index.html">repository</a></td><td>0..n</td>
<td>
A logical jar repository (repository development is in progress,
as such limitations may apply).
</td>
</tr>
<tr>
<td><a href="fileset.html">fileset</a></td><td>n</td>
<td>
A fileset directive.
</td>
</tr>
</table>
</subsection>
<subsection name="Description">
<p>A classpath directive qualifies the defintion of the enclosing classloader. The
enclosing classloader shall be established with the jar resources declared within the
classpath. The resulting classloader shall be made available to the enclosing
container and subsidiary components (including subsidiary containers). An example of a
classpath declaration is included below.</p>
</subsection>
<subsection name="Sample XML (using filesets)">
<source>
<classpath>
<fileset dir="<font color="darkred">lib</font>">
<include name="<font color="darkred">avalon-framework.jar</font>"/>
<include name="<font color="darkred">logkit.jar</font>"/>
</fileset>
</classpath>
</source>
</subsection>
<subsection name="Sample XML (using a repository)">
<p>
The following classpath (from the James deployment directive) demonstrates the use
of repository based references. A repository contains references to resources within
the repository. A repository implementation is responsible for mapping resource
directives to physical jar file. The default repository is a file based repository
located under the Merlin installation.
</p>
<source><![CDATA[
<classpath>
<repository>
<resource id="avalon-framework:avalon-framework-impl" version="4.1.5-dev"/>
<resource id="cornerstone-threads:cornerstone-threads-api" version="1.0"/>
<resource id="cornerstone-sockets:cornerstone-sockets-api" version="1.0"/>
<resource id="cornerstone-connection:cornerstone-connection-api" version="1.0"/>
<resource id="cornerstone-scheduler:cornerstone-scheduler-api" version="1.0"/>
<resource id="cornerstone-datasources:cornerstone-datasources-api"
version="1.0"/>
<resource id="cornerstone-store:cornerstone-store-api" version="1.0"/>
<resource id="cornerstone-connection:cornerstone-connection-impl" version="1.0"/>
<resource id="excalibur:excalibur-collections" version="1.0"/>
<resource id="excalibur-thread:excalibur-thread" version="1.1.1"/>
<resource id="excalibur-pool:excalibur-pool" version="1.2"/>
<resource id="james:dnsjava" version="1.3.2"/>
<resource id="james:mail" version="1.3"/>
<resource id="james:activation" version="1.0"/>
<resource id="james:mailet" version="1.0"/>
<resource id="james:james" version="1.3"/>
</repository>
</classpath>
]]></source>
</subsection>
</section>
</body>
<footer>
<legal>
Copyright (c) @year@ The Apache Apache Project. All rights reserved.
$Revision: 1.1 $ $Date: 2003/08/28 04:06:35 $
</legal>
</footer>
</document>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/classloader/classpath/navigation.xml
Index: navigation.xml
===================================================================
<?xml version="1.0" encoding="UTF-8"?>
<project>
<title>Merlin</title>
<body>
<links>
<item name="Home" href="http://avalon.apache.org/"/>
<item name="Framework" href="http://avalon.apache.org/framework/"/>
<item name="Components" href="http://avalon.apache.org/components"/>
<item name="Containers" href="http://avalon.apache.org/containers/"/>
<item name="Sandbox" href="http://avalon.apache.org/sandbox/"/>
</links>
<menu name="About Merlin">
<item name="Overview" href="/about/index.html"/>
<item name="Getting Started" href="/starting/index.html"/>
<item name="Merlin System" href="/merlin/index.html"/>
<item name="Meta Model" href="/meta/index.html">
<item name="kernel.xml" href="/meta/kernel/index.html"/>
<item name="blocks.xml" href="/meta/block/index.html">
<item name="services" href="/meta/block/services/index.html"/>
<item name="classloader" href="/meta/block/classloader/index.html">
<item name="classpath"
href="/meta/block/classloader/classpath/index.html">
<item name="repository"
href="/meta/block/classloader/classpath/repository/index.html"/>
<item name="fileset"
href="/meta/block/classloader/classpath/fileset.html"/>
</item>
<item name="library" href="/meta/block/classloader/extensions.html"/>
</item>
<item name="component" href="/meta/block/components/index.html"/>
<item name="container" href="/meta/block/index.html"/>
<item name="include" href="/meta/block/include/index.html"/>
</item>
<item name="config.xml" href="/meta/config/index.html"/>
</item>
<item name="Tools" href="/tools/index.html"/>
<item name="Resources" href="/resources/index.html"/>
</menu>
<menu name="Extensions">
<item name="JNDI" href="/extensions/jndi/index.html"/>
<item name="Servlet" href="/extensions/servlet/index.html"/>
</menu>
</body>
</project>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/classloader/classpath/repository.xml
Index: repository.xml
===================================================================
<?xml version="1.0"?>
<document>
<header>
<title>Repository Directive</title>
<authors>
<person name="Stephen McConnell" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
<section name="Repository Directive">
<p>In preparation.</p>
</section>
</body>
</document>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/classloader/classpath/repository/index.xml
Index: index.xml
===================================================================
<?xml version="1.0"?>
<document>
<header>
<title>Repository Directive</title>
<authors>
<person name="Stephen McConnell" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
<section name="Repository Directive">
<subsection name="Description">
<p>A repository is a logical source of jar files. Resource directives contained in
the repository are resolved to jar files by a repository implementation. The default
implementation is a file based repository located under the Melrin installation.</p>
</subsection>
<subsection name="Sample XML">
<p>
The following classpath (from the James deployment directive) demonstrates the use
of repository based references.
</p>
<source><![CDATA[
<classpath>
<repository>
<resource id="avalon-framework:avalon-framework-impl"
version="4.1.5-dev"/>
<resource id="cornerstone-threads:cornerstone-threads-api" version="1.0"/>
<resource id="cornerstone-sockets:cornerstone-sockets-api" version="1.0"/>
<resource id="cornerstone-connection:cornerstone-connection-api"
version="1.0"/>
<resource id="cornerstone-scheduler:cornerstone-scheduler-api"
version="1.0"/>
<resource id="cornerstone-datasources:cornerstone-datasources-api"
version="1.0"/>
<resource id="cornerstone-store:cornerstone-store-api" version="1.0"/>
<resource id="cornerstone-connection:cornerstone-connection-impl"
version="1.0"/>
<resource id="excalibur:excalibur-collections" version="1.0"/>
<resource id="excalibur-thread:excalibur-thread" version="1.1.1"/>
<resource id="excalibur-pool:excalibur-pool" version="1.2"/>
<resource id="james:dnsjava" version="1.3.2"/>
<resource id="james:mail" version="1.3"/>
<resource id="james:activation" version="1.0"/>
<resource id="james:mailet" version="1.0"/>
<resource id="james:james" version="1.3"/>
</repository>
</classpath>
]]></source>
</subsection>
</section>
</body>
</document>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/classloader/classpath/repository/navigation.xml
Index: navigation.xml
===================================================================
<?xml version="1.0" encoding="UTF-8"?>
<project>
<title>Merlin</title>
<body>
<links>
<item name="Home" href="http://avalon.apache.org/"/>
<item name="Framework" href="http://avalon.apache.org/framework/"/>
<item name="Components" href="http://avalon.apache.org/components"/>
<item name="Containers" href="http://avalon.apache.org/containers/"/>
<item name="Sandbox" href="http://avalon.apache.org/sandbox/"/>
</links>
<menu name="About Merlin">
<item name="Overview" href="/about/index.html"/>
<item name="Getting Started" href="/starting/index.html"/>
<item name="Merlin System" href="/merlin/index.html"/>
<item name="Meta Model" href="/meta/index.html">
<item name="kernel.xml" href="/meta/kernel/index.html"/>
<item name="blocks.xml" href="/meta/block/index.html">
<item name="services" href="/meta/block/services/index.html"/>
<item name="classloader" href="/meta/block/classloader/index.html">
<item name="classpath"
href="/meta/block/classloader/classpath/index.html">
<item name="repository"
href="/meta/block/classloader/classpath/repository/index.html">
<item name="resource"
href="/meta/block/classloader/classpath/repository/resource.html"/>
</item>
<item name="fileset"
href="/meta/block/classloader/classpath/fileset.html"/>
</item>
<item name="library" href="/meta/block/classloader/extensions.html"/>
</item>
<item name="component" href="/meta/block/components/index.html"/>
<item name="container" href="/meta/block/index.html"/>
<item name="include" href="/meta/block/include/index.html"/>
</item>
<item name="config.xml" href="/meta/config/index.html"/>
</item>
<item name="Tools" href="/tools/index.html"/>
<item name="Resources" href="/resources/index.html"/>
</menu>
<menu name="Extensions">
<item name="JNDI" href="/extensions/jndi/index.html"/>
<item name="Servlet" href="/extensions/servlet/index.html"/>
</menu>
</body>
</project>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/classloader/classpath/repository/resource.xml
Index: resource.xml
===================================================================
<?xml version="1.0"?>
<document>
<header>
<title>Include Directive</title>
<authors>
<person name="Stephen McConnell" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
<section name="Resource Directive">
<subsection name="Attributes">
<table>
<tr><th>Attribute</th><th>Required</th><th>Description</th></tr>
<tr>
<td>id</td><td>yes</td>
<td>
A resource artifact identifier in form [group]:[artifact-name]. The value
identifes a jar file containing a block defintition that is resolved
relative to a repository established by the Merlin Kernel.
</td>
</tr>
<tr>
<td>version</td><td>no</td>
<td>
Used in conjuction with the id attribute to qualify the artifact version.
</td>
</tr>
<tr>
<td>type</td><td>no</td>
<td>
Default to 'jar'. Used to declare the type of resource.
</td>
</tr>
</table>
</subsection>
<subsection name="Description">
<p>
A resource directive is a logical reference to a jar file within the enclosing
repository. A repository implementation is responsible for the mapping of logical
directives to physical jar URL.
</p>
</subsection>
<subsection name="Sample XML">
<p>
The following example block.xml demonstrates the inclusion of three blocks within
another enclosing block. In this example, the common shared API (containing service
interfaces classes is declared in the containing block classloader).
</p>
<source><![CDATA[
<container name="test">
<classloader>
<classpath>
<repository>
<resource id="james:mail" version="1.3"/>
<resource id="james:activation" version="1.0"/>
<resource id="james:mailet-api" version="1.0"/>
</repository>
</classpath>
</classloader>
<!-- include blocks here -->
<include name="james" id="james:block" type="xml"/>
</container>
]]></source>
</subsection>
</section>
</body>
</document>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/components/configuration.xml
Index: configuration.xml
===================================================================
<?xml version="1.0"?>
<document>
<header>
<title>Configuration Directive</title>
<authors>
<person name="Stephen McConnell" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
<section name="Configuration Directive">
<subsection name="Specification">
<p>A configuration directive is a configuration fragment that will be supplied to a
component that implements the org.apache.avalon.configuration.Configurable interface.
The attributes and content of a configuration element are application specific. The
<configuration> element is the root element passed to the component.</p>
<p><strong>Sample XML</strong></p>
<source><![CDATA[
<container name="container">
<!-- ... -->
<container name="subcontainer">
<!-- ... -->
<component name="test2" class="AnotherComponent">
<!-- will be passed into configurable() method -->
<configuration>
<colour>red</color>
</configuration>
</component>
</container>
</container>
]]></source>
</subsection>
</section>
</body>
</document>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/components/index.xml
Index: index.xml
===================================================================
<?xml version="1.0"?>
<document>
<header>
<title>Container Managed Component Declaration</title>
<authors>
<person name="Stephen McConnell" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
<section name="Component Directive">
<subsection name="Attributes">
<table>
<tr><th>Attribute</th><th>Required</th><th>Description</th></tr>
<tr>
<td>name</td><td>yes</td>
<td>The name to assign to the component profile implied by
the directive.</td>
</tr>
<tr>
<td>class</td><td>yes</td>
<td>The classname of the component implementation.</td>
</tr>
<tr>
<td>activation</td><td>no</td>
<td>The activation policy. Recognized values include
'startup' and 'lazy'.</td>
</tr>
</table>
</subsection>
<subsection name="Nested Elements">
<table>
<tr><th>Element</th><th>Cardinality</th><th>Description</th></tr>
<tr>
<td><a href="categories/index.html">categories</a></td><td>0..1</td>
<td>Defintion of the priority and targets parameterization to apply
to logging channels declared by the component.</td>
</tr>
<tr>
<td><a href="context/index.html">context</a></td><td>0..1</td>
<td>Defintion of the context class and entries.</td>
</tr>
<tr>
<td><a href="parameters/index.html">parameters</a></td><td>0..1</td>
<td>Defintion of the parameters to be supplied during Parameterization
of the component.</td>
</tr>
<tr>
<td><a href="configuration.html">configuration</a></td><td>0..1</td>
<td>The configuration fragment to be applied to the target component
during a configuration lifecycle stage.</td>
</tr>
</table>
</subsection>
<subsection name="Description">
<p>
A component directive is an instruction to a container to
mount and deploy a component instance in accordance with
the declared configuration, context, parameters and activation
policy.
</p>
</subsection>
<subsection name="Sample XML">
<source><![CDATA[
<container name="tutorial">
<component name="hello" class="tutorial.HelloComponent" activation="startup">
<!-- optional categories element -->
<!-- optional configuration or parameters element -->
<!-- optional context element -->
</component>
</block>
]]></source>
</subsection>
</section>
</body>
</document>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/components/navigation.xml
Index: navigation.xml
===================================================================
<?xml version="1.0" encoding="UTF-8"?>
<project>
<title>Merlin</title>
<body>
<links>
<item name="Home" href="http://avalon.apache.org/"/>
<item name="Framework" href="http://avalon.apache.org/framework/"/>
<item name="Components" href="http://avalon.apache.org/components"/>
<item name="Containers" href="http://avalon.apache.org/containers/"/>
<item name="Sandbox" href="http://avalon.apache.org/sandbox/"/>
</links>
<menu name="About Merlin">
<item name="Overview" href="/about/index.html"/>
<item name="Getting Started" href="/starting/index.html"/>
<item name="Merlin System" href="/merlin/index.html"/>
<item name="Meta Model" href="/meta/index.html">
<item name="kernel.xml" href="/meta/kernel/index.html"/>
<item name="blocks.xml" href="/meta/block/index.html">
<item name="services" href="/meta/block/services/index.html"/>
<item name="classloader" href="/meta/block/classloader/index.html"/>
<item name="component" href="/meta/block/components/index.html">
<item name="categories"
href="/meta/block/components/categories/index.html"/>
<item name="context" href="/meta/block/components/context/index.html"/>
<item name="configuration"
href="/meta/block/components/configuration.html"/>
<item name="parameters"
href="/meta/block/components/parameters/index.html"/>
</item>
<item name="container" href="/meta/block/index.html"/>
<item name="include" href="/meta/block/include/index.html"/>
</item>
<item name="config.xml" href="/meta/config/index.html"/>
</item>
<item name="Tools" href="/tools/index.html"/>
<item name="Resources" href="/resources/index.html"/>
</menu>
<menu name="Extensions">
<item name="JNDI" href="/extensions/jndi/index.html"/>
<item name="Servlet" href="/extensions/servlet/index.html"/>
</menu>
</body>
</project>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/components/categories/category.xml
Index: category.xml
===================================================================
<?xml version="1.0"?>
<document>
<header>
<title>Category Directive</title>
<authors>
<person name="Stephen McConnell" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
<section name="Category Directive">
<subsection name="Attributes">
<table>
<tr><th>Attribute</th><th>Required</th><th>Description</th></tr>
<tr>
<td>name</td><td>yes</td>
<td>
Logging category name. The category name refers to
a logging sub-category within the enclosing category.
</td>
</tr>
<tr>
<td>priority</td><td>no</td>
<td>
The logging priority (one of INFO, WARN, ERROR, FATAL, DEBUG).
</td>
</tr>
<tr>
<td>target</td><td>no</td>
<td>
Named logging target.
</td>
</tr>
</table>
</subsection>
<subsection name="Description">
<p>The logging channel category directive.</p>
</subsection>
<subsection name="Sample XML">
<source><![CDATA[
<category name="/sys" priority="INFO"/>
]]></source>
</subsection>
</section>
</body>
</document>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/components/categories/index.xml
Index: index.xml
===================================================================
<?xml version="1.0"?>
<document>
<header>
<title>Categories Directive</title>
<authors>
<person name="Stephen McConnell" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
<section name="Categories Directive">
<subsection name="Attributes">
<table>
<tr><th>Attribute</th><th>Required</th><th>Description</th></tr>
<tr>
<td>priority</td><td>no</td>
<td>
The default logging priority (one of INFO, WARN, ERROR, FATAL, DEBUG)
to assign to the component.
</td>
</tr>
<tr>
<td>target</td><td>no</td>
<td>
Named default logging target.
</td>
</tr>
</table>
</subsection>
<subsection name="Nested Elements">
<table>
<tr><th>Element</th><th>Cardinality</th><th>Description</th></tr>
<tr>
<td><a href="category.html">category</a></td><td>0..n</td>
<td>Logging sub-category directive.</td>
</tr>
</table>
</subsection>
<subsection name="Description">
<p>The logging channels used by a component may be parameterized using a categories
directive. Each category with a categories directive enables customization of the
priority and targets of logging channels used by the component.</p>
</subsection>
<subsection name="Sample XML">
<source><![CDATA[
<!--
Create a component with a logging channel priority of INFO.
Set the subsidiary channel for tutorial.data to a priority
of DEBUG and the tutorial.data.model channel to a ERROR
priority.
-->
<component name="tutorial">
<categories priority="INFO">
<category name="/data" priority="DEBUG"/>
<category name="/data/model" priority="ERROR"/>
</categories>
</component>
]]></source>
</subsection>
</section>
</body>
</document>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/components/categories/navigation.xml
Index: navigation.xml
===================================================================
<?xml version="1.0" encoding="UTF-8"?>
<project>
<title>Merlin</title>
<body>
<links>
<item name="Home" href="http://avalon.apache.org/"/>
<item name="Framework" href="http://avalon.apache.org/framework/"/>
<item name="Components" href="http://avalon.apache.org/components"/>
<item name="Containers" href="http://avalon.apache.org/containers/"/>
<item name="Sandbox" href="http://avalon.apache.org/sandbox/"/>
</links>
<menu name="About Merlin">
<item name="Overview" href="/about/index.html"/>
<item name="Getting Started" href="/starting/index.html"/>
<item name="Merlin System" href="/merlin/index.html"/>
<item name="Meta Model" href="/meta/index.html">
<item name="kernel.xml" href="/meta/kernel/index.html"/>
<item name="blocks.xml" href="/meta/block/index.html">
<item name="services" href="/meta/block/services/index.html"/>
<item name="classloader" href="/meta/block/classloader/index.html"/>
<item name="component" href="/meta/block/components/index.html">
<item name="categories"
href="/meta/block/components/categories/index.html">
<item name="Category"
href="/meta/block/components/categories/category.html"/>
</item>
<item name="context" href="/meta/block/components/context/index.html"/>
<item name="configuration"
href="/meta/block/components/configuration.html"/>
<item name="parameters"
href="/meta/block/components/parameters/index.html"/>
</item>
<item name="container" href="/meta/block/index.html"/>
<item name="include" href="/meta/block/include/index.html"/>
</item>
<item name="config.xml" href="/meta/config/index.html"/>
</item>
<item name="Tools" href="/tools/index.html"/>
<item name="Resources" href="/resources/index.html"/>
</menu>
<menu name="Extensions">
<item name="JNDI" href="/extensions/jndi/index.html"/>
<item name="Servlet" href="/extensions/servlet/index.html"/>
</menu>
</body>
</project>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/components/context/index.xml
Index: index.xml
===================================================================
<?xml version="1.0"?>
<document>
<header>
<title>Context Directive</title>
<authors>
<person name="Stephen McConnell" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
<section name="Context Directive">
<subsection name="Attributes">
<table>
<tr><th>Attribute</th><th>Required</th><th>Description</th></tr>
<tr>
<td>class</td><td>no</td>
<td>
The classname of a context implementation class. The class must
implement
a constructor that takes a java.util.Map instance as a single
constructor
argument. The supplied map shall be used by the implementation as
source
of keyed context entries.
</td>
</tr>
</table>
</subsection>
<subsection name="Nested Elements">
<table>
<tr><th>Element</th><th>Cardinality</th><th>Description</th></tr>
<tr>
<td><a href="entry/index.html">entry</a></td><td>n</td>
<td>A context entry creation directive.</td>
</tr>
</table>
</subsection>
<subsection name="Description">
<p>A context directive describes information that Merlin uses to build a context
instance that will be supplied to a target component during the contextualization
lifecycle stage.</p>
</subsection>
<subsection name="Sample XML">
<source><![CDATA[
<component name="demo" class="MyDemoComponent">
<context class="org.apache.avalon.playground.basic.BasicContextImp">
<entry key="home">
<import key="urn:avalon:home"/>
</entry>
<entry key="location">
<constructor>Paris</constructor>
</entry>
</context>
</component>
]]></source>
</subsection>
</section>
</body>
</document>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/components/context/navigation.xml
Index: navigation.xml
===================================================================
<?xml version="1.0" encoding="UTF-8"?>
<project>
<title>Merlin</title>
<body>
<links>
<item name="Home" href="http://avalon.apache.org/"/>
<item name="Framework" href="http://avalon.apache.org/framework/"/>
<item name="Components" href="http://avalon.apache.org/components"/>
<item name="Containers" href="http://avalon.apache.org/containers/"/>
<item name="Sandbox" href="http://avalon.apache.org/sandbox/"/>
</links>
<menu name="About Merlin">
<item name="Overview" href="/about/index.html"/>
<item name="Getting Started" href="/starting/index.html"/>
<item name="Merlin System" href="/merlin/index.html"/>
<item name="Meta Model" href="/meta/index.html">
<item name="kernel.xml" href="/meta/kernel/index.html"/>
<item name="blocks.xml" href="/meta/block/index.html">
<item name="services" href="/meta/block/services/index.html"/>
<item name="classloader" href="/meta/block/classloader/index.html"/>
<item name="component" href="/meta/block/components/index.html">
<item name="categories"
href="/meta/block/components/categories/index.html"/>
<item name="context" href="/meta/block/components/context/index.html">
<item name="entry"
href="/meta/block/components/context/entry/index.html"/>
</item>
<item name="configuration"
href="/meta/block/components/configuration.html"/>
<item name="parameters"
href="/meta/block/components/parameters/index.html"/>
</item>
<item name="container" href="/meta/block/index.html"/>
<item name="include" href="/meta/block/include/index.html"/>
</item>
<item name="config.xml" href="/meta/config/index.html"/>
</item>
<item name="Tools" href="/tools/index.html"/>
<item name="Resources" href="/resources/index.html"/>
</menu>
<menu name="Extensions">
<item name="JNDI" href="/extensions/jndi/index.html"/>
<item name="Servlet" href="/extensions/servlet/index.html"/>
</menu>
</body>
</project>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/components/context/entry/import.xml
Index: import.xml
===================================================================
<?xml version="1.0"?>
<document>
<header>
<title>Import Directive</title>
<authors>
<person name="Stephen McConnell" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
<section name="Import Directive">
<subsection name="Attributes">
<table>
<tr><th>Attribute</th><th>Required</th><th>Description</th></tr>
<tr>
<td>key</td><td>yes</td>
<td>
The container scoped context key to import into the component scope.
The imported key must be know by the container. Once established,
the value will be imported against the component key declared in the
enclosing entry tag.
</td>
</tr>
</table>
</subsection>
<subsection name="Description">
<p>A context import directive is used to map a standard container context entry to a
component context entry.</p>
</subsection>
<subsection name="Sample XML">
<source><![CDATA[
<profile name="basic">
<context class="org.apache.avalon.playground.basic.BasicContextImp">
<entry key="home">
<import name="urn:avalon:home"/>
</entry>
</context>
</profile>
]]></source>
</subsection>
</section>
</body>
</document>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/components/context/entry/index.xml
Index: index.xml
===================================================================
<?xml version="1.0"?>
<document>
<header>
<title>Entry Directive</title>
<authors>
<person name="Stephen McConnell" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
<section name="Entry Directive">
<subsection name="Attributes">
<table>
<tr><th>Attribute</th><th>Required</th><th>Description</th></tr>
<tr>
<td>key</td><td>yes</td>
<td>
The context entry key.
</td>
</tr>
</table>
</subsection>
<subsection name="Nested Elements">
<table>
<tr><th>Element</th><th>Cardinality</th><th>Description</th></tr>
<tr>
<td><a href="import.html">import</a></td><td>1 (or param)</td>
<td>
Declaration of the import of a container standard context entry into
the context entries to supplied to the component.
</td>
</tr>
<tr>
<td><a href="constructor/index.html">constructor</a></td><td>1 (or
import)</td>
<td>
A constructor argument.If the value of the element is not empty, the
value will be
used as a default constructor argument. Otherwise, Merlin will attempt
to
locate nested parameter elements in order to build a new instance.
</td>
</tr>
</table>
</subsection>
<subsection name="Description">
<p>A context entry directive defines the creation of a tagged object.</p>
</subsection>
<subsection name="Sample XML">
<source><![CDATA[
<profile name="basic">
<context class="org.apache.avalon.playground.basic.BasicContextImp">
<entry key="home">
<import key="urn:avalon:home"/>
</entry>
<entry key="location">
<param>Paris</param>
</entry>
<entry key="working">
<constructor class="java.io.File">../../lib/cache</constructor>
</entry>
</context>
</profile>
]]></source>
</subsection>
</section>
</body>
</document>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/components/context/entry/navigation.xml
Index: navigation.xml
===================================================================
<?xml version="1.0" encoding="UTF-8"?>
<project>
<title>Merlin</title>
<body>
<links>
<item name="Home" href="http://avalon.apache.org/"/>
<item name="Framework" href="http://avalon.apache.org/framework/"/>
<item name="Components" href="http://avalon.apache.org/components"/>
<item name="Containers" href="http://avalon.apache.org/containers/"/>
<item name="Sandbox" href="http://avalon.apache.org/sandbox/"/>
</links>
<menu name="About Merlin">
<item name="Overview" href="/about/index.html"/>
<item name="Getting Started" href="/starting/index.html"/>
<item name="Merlin System" href="/merlin/index.html"/>
<item name="Meta Model" href="/meta/index.html">
<item name="kernel.xml" href="/meta/kernel/index.html"/>
<item name="blocks.xml" href="/meta/block/index.html">
<item name="services" href="/meta/block/services/index.html"/>
<item name="classloader" href="/meta/block/classloader/index.html"/>
<item name="component" href="/meta/block/components/index.html">
<item name="categories"
href="/meta/block/components/categories/index.html"/>
<item name="context" href="/meta/block/components/context/index.html">
<item name="entry"
href="/meta/block/components/context/entry/index.html">
<item name="import"
href="/meta/block/components/context/entry/import.html"/>
<item name="constructor"
href="/meta/block/components/context/entry/constructor/index.html"/>
</item>
</item>
<item name="configuration"
href="/meta/block/components/configuration.html"/>
<item name="parameters"
href="/meta/block/components/parameters/index.html"/>
</item>
<item name="container" href="/meta/block/index.html"/>
<item name="include" href="/meta/block/include/index.html"/>
</item>
<item name="config.xml" href="/meta/config/index.html"/>
</item>
<item name="Tools" href="/tools/index.html"/>
<item name="Resources" href="/resources/index.html"/>
</menu>
<menu name="Extensions">
<item name="JNDI" href="/extensions/jndi/index.html"/>
<item name="Servlet" href="/extensions/servlet/index.html"/>
</menu>
</body>
</project>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/components/context/entry/constructor/index.xml
Index: index.xml
===================================================================
<?xml version="1.0"?>
<document>
<header>
<title>Entry Directive</title>
<authors>
<person name="Stephen McConnell" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
<section name="Constructor Directive">
<subsection name="Attributes">
<table>
<tr><th>Attribute</th><th>Required</th><th>Description</th></tr>
<tr>
<td>key</td><td>yes</td>
<td>
The context entry key.
</td>
</tr>
</table>
</subsection>
<subsection name="Nested Elements">
<table>
<tr><th>Element</th><th>Cardinality</th><th>Description</th></tr>
<tr>
<td><a href="param.html">param</a></td><td>*</td>
<td>
A constructor argument.If the value of the element is not empty, the
value will be
used as a default constructor argument. Otherwise, Merlin will attempt
to
locate nested parameter elements in order to build a new instance.
</td>
</tr>
</table>
</subsection>
<subsection name="Description">
<p>A context entry directive defines the creation of a tagged object.</p>
</subsection>
<subsection name="Sample XML">
<source><![CDATA[
<component name="basic" class="MyComponent">
<context class="org.apache.avalon.playground.basic.BasicContextImp">
<entry key="gws">
<constructor class="VerySpecialClass">
<param class="java.io.File">temp</param>
<param>George C. Scott</param>
<param class="SpecialClass">
<param>100</param>
<param>200</param>
</param>
</constructor>
</entry>
</context>
</component>
]]></source>
</subsection>
</section>
</body>
</document>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/components/context/entry/constructor/navigation.xml
Index: navigation.xml
===================================================================
<?xml version="1.0" encoding="UTF-8"?>
<project>
<title>Merlin</title>
<body>
<links>
<item name="Home" href="http://avalon.apache.org/"/>
<item name="Framework" href="http://avalon.apache.org/framework/"/>
<item name="Components" href="http://avalon.apache.org/components"/>
<item name="Containers" href="http://avalon.apache.org/containers/"/>
<item name="Sandbox" href="http://avalon.apache.org/sandbox/"/>
</links>
<menu name="About Merlin">
<item name="Overview" href="/about/index.html"/>
<item name="Getting Started" href="/starting/index.html"/>
<item name="Merlin System" href="/merlin/index.html"/>
<item name="Meta Model" href="/meta/index.html">
<item name="kernel.xml" href="/meta/kernel/index.html"/>
<item name="blocks.xml" href="/meta/block/index.html">
<item name="services" href="/meta/block/services/index.html"/>
<item name="classloader" href="/meta/block/classloader/index.html"/>
<item name="component" href="/meta/block/components/index.html">
<item name="categories"
href="/meta/block/components/categories/index.html"/>
<item name="context" href="/meta/block/components/context/index.html">
<item name="entry"
href="/meta/block/components/context/entry/index.html">
<item name="import"
href="/meta/block/components/context/entry/import.html"/>
<item name="constructor"
href="/meta/block/components/context/entry/constructor/index.html">
<item name="param"
href="/meta/block/components/context/entry/constructor/param.html"/>
</item>
</item>
</item>
<item name="configuration"
href="/meta/block/components/configuration.html"/>
<item name="parameters"
href="/meta/block/components/parameters/index.html"/>
</item>
<item name="container" href="/meta/block/index.html"/>
<item name="include" href="/meta/block/include/index.html"/>
</item>
<item name="config.xml" href="/meta/config/index.html"/>
</item>
<item name="Tools" href="/tools/index.html"/>
<item name="Resources" href="/resources/index.html"/>
</menu>
<menu name="Extensions">
<item name="JNDI" href="/extensions/jndi/index.html"/>
<item name="Servlet" href="/extensions/servlet/index.html"/>
</menu>
</body>
</project>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/components/context/entry/constructor/param.xml
Index: param.xml
===================================================================
<?xml version="1.0"?>
<document>
<header>
<title>Parameter Directive</title>
<authors>
<person name="Stephen McConnell" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
<section name="Param Directive">
<subsection name="Attributes">
<table>
<tr><th>Attribute</th><th>Required</th><th>Description</th></tr>
<tr>
<td>class</td><td>no</td>
<td>
The parameter classname. The default value is java.lang.String.
</td>
</tr>
</table>
</subsection>
<subsection name="Nested Elements">
<table>
<tr><th>Element</th><th>Cardinality</th><th>Description</th></tr>
<tr>
<td><a href="param.html">param</a></td><td>0..n</td>
<td>
A constructor argument.
If the value of the parameter is not null, the value will be
used as a default constructor argument. Otherwise, Merlin will attempt to
locate nested parameter elements in order to build a new instance of the
specified class.
</td>
</tr>
</table>
</subsection>
<subsection name="Description">
<p>A param directive within a context or enclosing param represents a constructor
argument value.</p>
</subsection>
<subsection name="Sample XML">
<source><![CDATA[
<component name="basic" class="MyComponent">
<context class="org.apache.avalon.playground.basic.BasicContextImp">
<entry key="gws">
<constructor class="ReallySpecialClass">
<param class="java.io.File">temp</param>
<param>George C. Scott</param>
<param class="SpecialClass">
<param>100</param>
<param>200</param>
</param>
</constructor>
</entry>
</context>
</component>
]]></source>
</subsection>
</section>
</body>
</document>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/components/parameters/index.xml
Index: index.xml
===================================================================
<?xml version="1.0"?>
<document>
<header>
<title>Parameters Directive</title>
<authors>
<person name="Stephen McConnell" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
<section name="Parameters Directive">
<subsection name="Nested Elements">
<table>
<tr><th>Element</th><th>Cardinality</th><th>Description</th></tr>
<tr>
<td><a href="parameter.html">parameter</a></td><td>n</td>
<td>
Declaration of the paramets to include within a Parameters instance.
</td>
</tr>
</table>
</subsection>
<subsection name="Description">
<p>A parameters directive is used by Merlin to construct a Parameters argument when
servicing a Parameterizable object.</p>
</subsection>
<subsection name="Sample XML">
<source><![CDATA[
<profile>
<parameters>
<parameter name="name" value="Gloria">
<parameter name="size" value="142">
<parameter name="color" value="red">
</parameters>
</profile>
]]></source>
</subsection>
</section>
</body>
</document>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/components/parameters/navigation.xml
Index: navigation.xml
===================================================================
<?xml version="1.0" encoding="UTF-8"?>
<project>
<title>Merlin</title>
<body>
<links>
<item name="Home" href="http://avalon.apache.org/"/>
<item name="Framework" href="http://avalon.apache.org/framework/"/>
<item name="Components" href="http://avalon.apache.org/components"/>
<item name="Containers" href="http://avalon.apache.org/containers/"/>
<item name="Sandbox" href="http://avalon.apache.org/sandbox/"/>
</links>
<menu name="About Merlin">
<item name="Overview" href="/about/index.html"/>
<item name="Getting Started" href="/starting/index.html"/>
<item name="Merlin System" href="/merlin/index.html"/>
<item name="Meta Model" href="/meta/index.html">
<item name="kernel.xml" href="/meta/kernel/index.html"/>
<item name="blocks.xml" href="/meta/block/index.html">
<item name="services" href="/meta/block/services/index.html"/>
<item name="classloader" href="/meta/block/classloader/index.html"/>
<item name="component" href="/meta/block/components/index.html">
<item name="categories"
href="/meta/block/components/categories/index.html"/>
<item name="context" href="/meta/block/components/context/index.html"/>
<item name="configuration"
href="/meta/block/components/configuration.html"/>
<item name="parameters"
href="/meta/block/components/parameters/index.html">
<item name="parameter"
href="/meta/block/components/parameters/parameter.html"/>
</item>
</item>
<item name="container" href="/meta/block/index.html"/>
<item name="include" href="/meta/block/include/index.html"/>
</item>
<item name="config.xml" href="/meta/config/index.html"/>
</item>
<item name="Tools" href="/tools/index.html"/>
<item name="Resources" href="/resources/index.html"/>
</menu>
<menu name="Extensions">
<item name="JNDI" href="/extensions/jndi/index.html"/>
<item name="Servlet" href="/extensions/servlet/index.html"/>
</menu>
</body>
</project>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/components/parameters/parameter.xml
Index: parameter.xml
===================================================================
<?xml version="1.0"?>
<document>
<header>
<title>Parameters Directive</title>
<authors>
<person name="Stephen McConnell" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
<section name="Parameters Directive">
<subsection name="Attributes">
<table>
<tr><th>Attribute</th><th>Required</th><th>Description</th></tr>
<tr>
<td>name</td><td>yes</td>
<td>The parameter name.</td>
</tr>
<tr>
<td>value</td><td>no</td>
<td>The parameter value.</td>
</tr>
</table>
</subsection>
<subsection name="Description">
<p>A parameters directive is used by Merlin to construct an entry within a
Parameters instance.</p>
<p><strong>Attributes</strong></p>
</subsection>
<subsection name="Sample XML">
<source><![CDATA[
<profile>
<parameters>
<parameter name="name" value="Gloria">
<parameter name="size" value="142">
<parameter name="color" value="red">
</parameters>
</profile>
]]></source>
</subsection>
</section>
</body>
</document>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/services/index.xml
Index: index.xml
===================================================================
<?xml version="1.0"?>
<document>
<header>
<title>Block Service Export</title>
<authors>
<person name="Stephen McConnell" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
<section name="Block Service Export">
<p>In preparation.</p>
</section>
</body>
<footer>
<legal>
Copyright (c) @year@ The Jakarta Apache Project All rights reserved.
$Revision: 1.1 $ $Date: 2003/08/28 04:06:35 $
</legal>
</footer>
</document>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/services/navigation.xml
Index: navigation.xml
===================================================================
<?xml version="1.0" encoding="UTF-8"?>
<project>
<title>Merlin</title>
<body>
<links>
<item name="Home" href="http://avalon.apache.org/"/>
<item name="Framework" href="http://avalon.apache.org/framework/"/>
<item name="Components" href="http://avalon.apache.org/components"/>
<item name="Containers" href="http://avalon.apache.org/containers/"/>
<item name="Sandbox" href="http://avalon.apache.org/sandbox/"/>
</links>
<menu name="About Merlin">
<item name="Overview" href="/about/index.html"/>
<item name="Getting Started" href="/starting/index.html"/>
<item name="Merlin System" href="/merlin/index.html"/>
<item name="Meta Model" href="/meta/index.html">
<item name="kernel.xml" href="/meta/kernel/index.html"/>
<item name="blocks.xml" href="/meta/block/index.html">
<item name="services" href="/meta/block/services/index.html">
<item name="services" href="/meta/block/services/service.html"/>
</item>
<item name="classloader" href="/meta/block/classloader/index.html"/>
<item name="component" href="/meta/block/components/index.html"/>
<item name="container" href="/meta/block/index.html"/>
<item name="include" href="/meta/block/include/index.html"/>
</item>
</item>
<item name="Tools" href="/tools/index.html"/>
<item name="Resources" href="/resources/index.html"/>
</menu>
<menu name="Extensions">
<item name="JNDI" href="/extensions/jndi/index.html"/>
<item name="Servlet" href="/extensions/servlet/index.html"/>
</menu>
</body>
</project>
1.1
avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/services/service.xml
Index: service.xml
===================================================================
<?xml version="1.0"?>
<document>
<header>
<title>Block Service Export</title>
<authors>
<person name="Stephen McConnell" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
<section name="Block Service Export">
<p>In preparation.</p>
</section>
</body>
<footer>
<legal>
Copyright (c) @year@ The Jakarta Apache Project All rights reserved.
$Revision: 1.1 $ $Date: 2003/08/28 04:06:35 $
</legal>
</footer>
</document>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
