This project has retired. For details please refer to its Attic page.
insertDefinition (Tiles - JSP support Tag library documentation)

tiles
Tag insertDefinition


Insert a definition.

Insert a definition with the possibility to override and specify parameters (called attributes). A definition can be seen as a (partially or totally) filled template that can override or complete attribute values. <tiles:insertDefinition> allows to define these attributes and pass them to the inserted jsp page, called template. Attributes are defined using nested tag <tiles:putAttribute> or <tiles:putListAttribute>.

You must specify name tag attribute, for inserting a definition from definitions factory.

Example :

  <tiles:insertDefinition name=".my.tiles.defininition flush="true"> <tiles:putAttribute name="title" value="My first page" /> <tiles:putAttribute name="header" value="/common/header.jsp" /> <tiles:putAttribute name="footer" value="/common/footer.jsp" /> <tiles:putAttribute name="menu" value="/basic/menu.jsp" /> <tiles:putAttribute name="body" value="/basic/helloBody.jsp" /> </tiles:insertDefinition>  


Tag Information
Tag Classorg.apache.tiles.jsp.taglib.InsertDefinitionTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
nametruetruejava.lang.String

Name of the definition to insert.

templatefalsetruejava.lang.String

A string representing the URI of a template (for example, a JSP page) that will override the one used by the definition itself.

flushfalsefalseboolean

True or false. If true, current page out stream is flushed before insertion.

ignorefalsetrueboolean

If this attribute is set to true, and the attribute specified by the name does not exist, simply return without writing anything. The default value is false, which will cause a runtime exception to be thrown.

rolefalsetruejava.lang.String

If the user is in the specified role, the tag is taken into account; otherwise, the tag is ignored (skipped).

preparerfalsetruejava.lang.StringThe fully qualified class name of preparer.

Variables
No Variables Defined.


Output Generated by Tag Library Documentation Generator. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-4 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.