tiles-config_3_0.dtd: Elements - Entities - Source | Intro - Index
FRAMES / NO FRAMES

DTD for the Tiles Definition File, Version 3.0

Usage: <!DOCTYPE tiles-definitions PUBLIC "-//Apache Software Foundation//DTD Tiles Configuration 3.0//EN" "http://tiles.apache.org/dtds/tiles-config_3_0.dtd">

   $Id: tiles-config_3_0.dtd 942533 2010-05-09 12:59:05Z apetrelli $

   Licensed to the Apache Software Foundation (ASF) under one
   or more contributor license agreements.  See the NOTICE file
   distributed with this work for additional information
   regarding copyright ownership.  The ASF licenses this file
   to you under the Apache License, Version 2.0 (the
   "License"); you may not use this file except in compliance
   with the License.  You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing,
   software distributed under the License is distributed on an
   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
   KIND, either express or implied.  See the License for the
   specific language governing permissions and limitations
   under the License.

The "tiles-definitions" element is the root of the configuration file hierarchy, and contains nested elements for all of the other configuration settings.

<tiles-definitions>'s children Name Cardinality definition At least one

(definition+)

The "definition" element describes a definition that can be inserted in a jsp page. This definition is identified by its logical name. A definition allows to define all the attributes that can be set in <insert> tag from a jsp page.

<definition>'s children Name Cardinality put-attribute Any number put-list-attribute Any number

<definition>'s attributes Name Values Default extends id Match the ID rules. name preparer role template templateExpression templateType

(put-attribute*, put-list-attribute*)

Element identifier.

Possible values: Match the ID rules.

The fully qualified Java class name of the preparer subclass to call immediately before the tiles is inserted. Only one of preparerClass or preparerUrl should be specified.

Name of a definition that is used as ancestor of this definition. All attributes from the ancestor are available to the new definition. Any attribute inherited from the ancestor can be overloaded by providing a new value.

The unique identifier for this definition. Required when it is a root definition, while it is implied in nested definitions.

Security role name that is allowed access to this definition object. The definition is inserted only if the role name is allowed.

The context-relative path to the resource used as tiles to insert. This tiles will be inserted and a tiles context containing appropriate attributes will be available.

The expression that will evaluate to a template for this definition. This attribute will be ignored if template is specified.

The type of the template attribute. Can be: string, template or definition. By default, the type is "template". If a type is associated, the desidered renderer will be invoked.

The "put-attribute" element describes an attribute of a definition. It allows to specify the tiles attribute name and its value. The tiles value can be specified as an xml attribute, or in the body of the <put-attribute> tag.

<put-attribute>'s children Name Cardinality definition Any number

<put-attribute>'s attributes Name Values Default cascade true, false expression id Match the ID rules. name role type value

((definition*))

Element identifier.

Possible values: Match the ID rules.

The unique identifier for this put-attribute.

Required

The type of the value. Can be: string, template or definition. By default, no type is associated to a value. If a type is associated, it will be used as a hint to process the value when the attribute will be used in the inserted tiles.

The value associated to this tiles attribute. The value should be specified with this tag attribute, or in the body of the tag.

The expression associated to this tiles attribute. This attribute will be ignored if value is specified.

Security role name that is allowed access to this attribute object. The attribute is inserted only if the role name is allowed.

If true, the attribute will be cascaded to all inner definitions. By default, cascade is false.

Possible values: true, false

The "put-list-attribute" element describes a list attribute of a definition. It allows to specify an attribute that is a java List containing any kind of values. In the config file, the list elements are specified by nested <add-attribute> or <add-list-attribute>.

<put-list-attribute>'s children Name Cardinality add-attribute Any number add-list-attribute Any number

<put-list-attribute>'s attributes Name Values Default cascade true, false id Match the ID rules. inherit true, false name role

((add-attribute* | add-list-attribute*)+)

Element identifier.

Possible values: Match the ID rules.

The unique identifier for this put attribute list.

Required

Security role name that is allowed access to this attribute object. The attribute is inserted only if the role name is allowed.

If true, the attribute will put the elements of the attribute with the same name of the parent definition before the ones specified here. By default, it is 'false'.

Possible values: true, false

If true, the attribute will be cascaded to all inner definitions. By default, cascade is false.

Possible values: true, false

The "add-attribute" element describes an element of a list. It is similar to the <put> element.

<add-attribute>'s children Name Cardinality definition Any number

<add-attribute>'s attributes Name Values Default expression id Match the ID rules. role type value

((definition*))

Element identifier.

Possible values: Match the ID rules.

The type of the value. Can be: string, template or definition. By default, no type is associated to a value. If a type is associated, it will be used as a hint to process the value when the attribute will be used in the inserted tiles.

The value associated to this tiles attribute. The value should be specified with this tag attribute, or in the body of the tag.

The expression associated to this tiles attribute. This attribute will be ignored if value is specified.

Security role name that is allowed access to this attribute object. The attribute will be added to the parent list anyway. It is delegated to the user of this attribute to use it or not depending on the role of the user.

The "add-list-attribute" element describes a list attribute subordinate to another list attribute. It allows to specify an attribute value that is a java List containing any kind of values. In the config file, the list elements are specified by nested <add-attribute> or <add-list-attribute>.

<add-list-attribute>'s children Name Cardinality add-attribute Any number add-list-attribute Any number

<add-list-attribute>'s attributes Name Values Default id Match the ID rules. role

((add-attribute* | add-list-attribute*)+)

Element identifier.

Possible values: Match the ID rules.

Security role name that is allowed access to this attribute object. The attribute will be added to the parent list anyway. It is delegated to the user of this attribute to use it or not depending on the role of the user.