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
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"/>