org.kohsuke.stapler.tags
Class Include

java.lang.Object
  extended by javax.servlet.jsp.tagext.SimpleTagSupport
      extended by 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
Include()
           
 
Method Summary
 void doTag()
           
 void setIt(java.lang.Object it)
          Specifies the object for which JSP will be included.
 void setPage(java.lang.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 Detail

Include

public Include()
Method Detail

setPage

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


setIt

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


doTag

public void doTag()
           throws javax.servlet.jsp.JspException,
                  java.io.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
java.io.IOException


Copyright © 2012. All Rights Reserved.