Package org.kohsuke.stapler.tags

Class Include

java.lang.Object
javax.servlet.jsp.tagext.SimpleTagSupport
org.kohsuke.stapler.tags.Include
All Implemented Interfaces:
javax.servlet.jsp.tagext.JspTag, javax.servlet.jsp.tagext.SimpleTag
public class Include extends javax.servlet.jsp.tagext.SimpleTagSupport
Includes a side JSP file for the "it" object.

This tag looks for a side JSP file of the given name from the inheritance hierarchy of the it object, and includes the contents of it, just like <jsp:include>.

For example, if the "it" object is an instance of the Foo class, which looks like the following: 


 class Foo extends Bar { ... }
 class Bar extends Zot { ... }

And if you write: 


 <st:include page="abc.jsp"/>
then, it looks for the following files in this order, and includes the first one found.
  1. a side-file of the Foo class named abc.jsp (/WEB-INF/side-files/Foo/abc.jsp)
  2. a side-file of the Bar class named abc.jsp (/WEB-INF/side-files/Bar/abc.jsp)
  3. a side-file of the Zot class named abc.jsp (/WEB-INF/side-files/Zot/abc.jsp)
Author:
Kohsuke Kawaguchi

  • Constructor Summary

    Constructors
    Constructor
    Description
    Include()
     

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    doTag()
     
    void
    setIt(Object it)
    Specifies the object for which JSP will be included.
    void
    setPage(String page)
    Specifies the name of the JSP to be included.

    Methods inherited from class javax.servlet.jsp.tagext.SimpleTagSupport

    findAncestorWithClass, getJspBody, getJspContext, getParent, setJspBody, setJspContext, setParent

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Constructor Details

    • Include

      public Include()

  • Method Details

    • setPage

      public void setPage(String page)
      Specifies the name of the JSP to be included.

    • setIt

      public void setIt(Object it)
      Specifies the object for which JSP will be included.

    • doTag

      public void doTag() throws javax.servlet.jsp.JspException, IOException
      Specified by:
      doTag in interface javax.servlet.jsp.tagext.SimpleTag
      Overrides:
      doTag in class javax.servlet.jsp.tagext.SimpleTagSupport
      Throws:
      javax.servlet.jsp.JspException
      IOException