Resource Include Directive

Description

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.

Attributes

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.

Sample XML

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

<container name="tutorial">

     <include name="publisher">
       id="tutorial:composition-publisher" version="1.0"/>

</container>