org.apache.tiles.web.jsp.taglib

## Class InsertTemplateTag

- java.lang.Object
- - javax.servlet.jsp.tagext.SimpleTagSupport
  - - org.apache.tiles.web.jsp.taglib.InsertTemplateTag

- All Implemented Interfaces:
    javax.servlet.jsp.tagext.JspTag, javax.servlet.jsp.tagext.SimpleTag

      public class InsertTemplateTag
      extends javax.servlet.jsp.tagext.SimpleTagSupport

  Insert a template.

  Insert a template with the possibility to pass parameters (called attributes). A template can be seen as a procedure that can take parameters or attributes. <tiles:insertTemplate> 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 template attribute, for inserting a template

  Example :

           <tiles:insertTemplate template="/basic/myLayout.jsp" 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:insertTemplate>

- - ### Constructor Summary

    Constructors
    Constructor and Description
    `InsertTemplateTag()`

  - ### Method Summary

    All Methods Instance Methods Concrete Methods
    Modifier and Type | Method and Description
    --- | ---
    `void` | `doTag()`
    `String` | `getPreparer()` Getter for preparer property.
    `String` | `getRole()` Getter for role property.
    `String` | `getTemplate()` Getter for template property.
    `String` | `getTemplateExpression()` Getter for templateExpression property.
    `String` | `getTemplateType()` Getter for templateType property.
    `boolean` | `isFlush()` Getter for flush property.
    `void` | `setFlush(boolean flush)` Setter for flush property.
    `void` | `setPreparer(String preparer)` Setter for preparer property.
    `void` | `setRole(String role)` Setter for role property.
    `void` | `setTemplate(String template)` Setter for template property.
    `void` | `setTemplateExpression(String templateExpression)` Setter for templateExpression property.
    `void` | `setTemplateType(String templateType)` Setter for templateType property.

    - ### Methods inherited from class javax.servlet.jsp.tagext.SimpleTagSupport

      `findAncestorWithClass, getJspBody, getJspContext, getParent, setJspBody, setJspContext, setParent`

    - ### Methods inherited from class java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- - ### Constructor Detail

    - #### InsertTemplateTag

          public InsertTemplateTag()

  - ### Method Detail

    - #### getTemplate

          public String getTemplate()

      Getter for template property.
      Returns:
        The template to render.

    - #### setTemplate

          public void setTemplate(String template)

      Setter for template property.
      Parameters:
        `template` - The template to render.

    - #### getTemplateType

          public String getTemplateType()

      Getter for templateType property.
      Returns:
        The type of the template attribute.

    - #### setTemplateType

          public void setTemplateType(String templateType)

      Setter for templateType property.
      Parameters:
        `templateType` - The type of the template attribute.

    - #### getTemplateExpression

          public String getTemplateExpression()

      Getter for templateExpression property.
      Returns:
        The expression to evaluate to get the value of the template.

    - #### setTemplateExpression

          public void setTemplateExpression(String templateExpression)

      Setter for templateExpression property.
      Parameters:
        `templateExpression` - The expression to evaluate to get the value of the template.

    - #### getRole

          public String getRole()

      Getter for role property.
      Returns:
        A comma-separated list of roles. If present, the template will be rendered only if the current user belongs to one of the roles.

    - #### setRole

          public void setRole(String role)

      Setter for role property.
      Parameters:
        `role` - A comma-separated list of roles. If present, the template will be rendered only if the current user belongs to one of the roles.

    - #### getPreparer

          public String getPreparer()

      Getter for preparer property.
      Returns:
        The preparer to use to invoke before the definition is rendered. If specified, it overrides the preparer specified in the definition itself.

    - #### setPreparer

          public void setPreparer(String preparer)

      Setter for preparer property.
      Parameters:
        `preparer` - The preparer to use to invoke before the definition is rendered. If specified, it overrides the preparer specified in the definition itself.

    - #### isFlush

          public boolean isFlush()

      Getter for flush property.
      Returns:
        If true, the response will be flushed after the insert.

    - #### setFlush

          public void setFlush(boolean flush)

      Setter for flush property.
      Parameters:
        `flush` - If true, the response will be flushed after the insert.

    - #### doTag

          public void doTag()
                     throws javax.servlet.jsp.JspException,
                            IOException

      Specified by:
        `doTag` in interface `javax.servlet.jsp.tagext.SimpleTag`
      Overrides:
        `doTag` in class `javax.servlet.jsp.tagext.SimpleTagSupport`
      Throws:
        `javax.servlet.jsp.JspException`
        `IOException`

Copyright © 2000–2026 Apache Software Foundation. All rights reserved.