This is version 4. It is not the current version, and thus it cannot be edited.
[Back to current version]   [Restore this version]

<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 an include directive such as <%@ include file="relativeFileName" %> at the top and bottom of the JSP.
  • 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, 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