Embeds a page fragment in a JSP.
<dsp:include {page="page
-spec
" | src="page
-spec
"[
otherContext="context
"]
} staticcharset="charset
" />
Attributes
page
Sets the page’s path and file name in two ways:
Resolves relative paths using the current page as a starting point.
Resolves absolute paths using the Web application root as a starting point by prepending the request object’s
context root
to the specified value.
src
Sets the page’s path and file name. The src
attribute can specify a page in another Web application if one of the following is true:
src
is set as follows:src="
webAppName
:/
path
"
where the application’s WebAppRegistry maps
webAppName
to a context root. Thepath
-specified page is searched within that context root.The current application’s
web.xml
atg.dynamo.contextPaths
parameter is configured appropriately,The
otherContext
attribute specifies the correct context path.
For more information, see Invoking Pages in Other Web Applications.
otherContext
identifies a context path that is not specified in the application’s web.xml
; valid with the src
attribute.
staticcharset
Specifies the character set to use when bytes are converted to characters. The default setting character set is ISO-8859-1.
Usage Notes
dsp:include
lets you embed a page fragment in a JSP just as you can with the JSP include
tag. It is also possible to pass page parameters from the parent page to the included page using this tag.
For information on other methods for embedding documents, see Included Pages.
Example
<dsp:include otherContext="/myOtherWebApp" page="/SophomoreRegistration.jsp"/>
The SophomoreRegistration.jsp
page is embedded in the parent page.
For more information about using dsp:include
, see Included Pages.