Include Directive

Delivered-To: mailing list cvs@avalon.apache.org Received: (qmail 83883 invoked by uid 500); 28 Aug 2003 04:13:36 -0000 Received: (qmail 83877 invoked from network); 28 Aug 2003 04:13:36 -0000 Received: from unknown (HELO minotaur.apache.org) (209.237.227.194) by daedalus.apache.org with SMTP; 28 Aug 2003 04:13:36 -0000 Received: (qmail 34626 invoked by uid 1438); 28 Aug 2003 04:07:10 -0000 Date: 28 Aug 2003 04:07:10 -0000 Message-ID: <20030828040710.34625.qmail@minotaur.apache.org> From: mcconnell@apache.org To: avalon-sandbox-cvs@apache.org Subject: cvs commit: avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/include index.xml navigation.xml resource.xml source.xml X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N X-Spam-Rating: minotaur-2.apache.org 1.6.2 0/1000/N mcconnell 2003/08/27 21:07:10 Added: merlin/merlin-platform/xdocs/meta/block/include index.xml navigation.xml resource.xml source.xml Log: Updated block deployment meta-data spec. Revision Changes Path 1.1 avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/include/index.xml Index: index.xml ===================================================================

Include Directive

Element	Occurance	Description
target	*	A set of target directives scoped relative to the container established by the include. Targets declarations correspond to the specification of target elements presented under the config.xml spec.

Attribute	Required	Description
name	yes	A name to assign to the container created by the block include. Will default to the name of the included block.
id	yes	The resource repository identifier.
version	no	The resource version.
type	no	A resource type such as 'jar' or 'xml'. Tge default value is 'jar'.

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 regular component (exposing services and dependecies, etc.).

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).

id="tutorial:composition-publisher" version="1.0"/> id="tutorial:composition-application" version="1.0"/> id="tutorial:composition-location" version="1.0"/> ]]>

1.1 avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/include/navigation.xml Index: navigation.xml =================================================================== Merlin 1.1 avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/include/resource.xml Index: resource.xml ===================================================================

Include Directive

Attribute	Required	Description
id	yes	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.
version	no	Used in conjuction with the id attribute to qualify the artifact version.

The defintion of the block to include will be resolved from the jar file referenced by the resource directive. The jar file shall be assumed to be a packaged block containing a block defintion under the path BLOCK-INF/block.xml.

id="tutorial:composition-publisher" version="1.0"/> ]]>

1.1 avalon-sandbox/merlin/merlin-platform/xdocs/meta/block/include/source.xml Index: source.xml ===================================================================

Source Include Directive

Attribute	Required	Description
path	no	URL used to reference a block directive as a URL. Is useful as an alternative form to the resource include during development.

Includes a block defined by the block descriptor referenced by the path attribute value.

]]>

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