template:call

Inserts the template denoted by the "file" attribute. On its own it functions purely like a <jsp:insert> tag, but this tag can have nested parameter tags, which are set for the duration of this call, and are restored to their old values, if they had any before the call.

See also

template:parameter

Syntax

<template:call
   file="..."?
   fileName="..."?
   fileProperty="..."?
   pluginName="..."?
   pluginProperty="..."?
   prefix="..."?
   sectionParameter="..."?
   servletContext="..."?
   suffix="..."?>
   <template:parameter.../>
</template:call>

Attributes

file

The context-relative path of the JSP file to include. The mentioned JSP file will be included at this point in the resulting page, and any nested parameters will be made available to the mentioned page.

The parameters are stored in the request scope for the duration of the call. The parameters will be restored to their old values when the target JSP file is finished, even if those values have been changed by the target JSP file.

fileName

Name of the bean that contains the name of file to be called. The mentioned JSP file will be included at this point in the resulting page, and any nested parameters will be made available to the mentioned page.

The parameters are stored in the request scope for the duration of the call. The parameters will be restored to their old values when the target JSP file is finished, even if those values have been changed by the target JSP file.

This attribute can be used together with 'filePropery'.

fileProperty

The property to get the name of the file to be included.

This attribute can not be used without the 'fileName' attribute.

sectionParameter

The name of the Section Parameter that contains the context-relative path of the JSP file to include. sectionParameter simply asks the Section for the parameter of the specified name, and assumes that it is a context- relative file-name. See the "file" attribute for more information.

prefix

Prefix to add to the file specified by either the file-attribute or the sectionParameter-attribute.

suffix

Suffix to add to the file specified by either the file-attribute or the sectionParameter-attribute.

pluginName

Will only insert the jsp page if the named plugin is installed.

This attribute can either be the name itself or the name of a bean to get the name from. If it is a bean the pluginPropty must be used to get the name of the plugin.

pluginProperty

The property to get the name of the plugin.

This attribute can not be used without the pluginName property.

servletContext

URI path to the servlet context in which to find the file to call.

Use this when the file is in another webapp (war-file) and the ServletContext should be switched to this new webapp before calling the file. The uripath is the context root of the webapp, e.g. "/escenic". The file name is relative to the new context.

IMPORTANT NOTICE: The servlet specification is vague about the effects of changing context and then including a resource. Differences between application servers are to be expected. Also note that the session scope will usually be unavailable while in the other ServletContext.

Note that in order to use this feature on a Tomcat server, the following configuration must be added to the Host element of conf/server.xml:

              <DefaultContext crossContext="true"/>