Metawerx Java Hosting Small Logo

<jsp-property-group>

This sub-element of <jsp-config> defines a collection of properties that apply to one or more JSP pages.

Multiple <jsp-property-group> tags may be included in sequence, to define separate sets of JSP files.

Using <jsp-property-group> to include a header and footer JSP fragment

<jsp-property-group>
	<url-pattern>*.jsp</url-pattern>
	<include-prelude>/WEB-INF/jspf/header.jspf</include-prelude>
	<include-coda>/WEB-INF/jspf/footer.jspf</include-coda>
</jsp-property-group>
  • This will include the JSP specified at the beginning and end of each JSP page. It is equivelant to using a static include directive such as <%@ include file="include.jsp" %> at the top and bottom of the JSP and can be used to set various JSP variables.
  • Preludes and codas follow the same rules as statically included JSP segments. In particular, start tags and end tags must appear in the same file.

Important Notes

  • On Tomcat (at least as of Version 5.5.35, 6.0.35 and 7.0.26), only one <url-pattern> tag is permitted per <jsp-property-group>. If more than one is provided, only the final one will be used and debugging this condition can be very time consuming ;-)
  • After changing a JSP property group, it is necessary to recompile any JSP files which rely on it. This can be done by clearing the work folder (for metawerx customers - click Clear Work Folder in SiteWinder) or by touching each JSP file to force a recompile.

Child-elements:


See Also

  • SCWCD Study Guide by Mikalai Zaikin for a good description of the way include directives are handled, and the differences between the static include directive and the dynamic include action
navigation
metawerx specific
search
Share
tools
help

referring pages

Share