Class JspContextWrapper

java.lang.Object

javax.servlet.jsp.JspContext

javax.servlet.jsp.PageContext

org.apache.jasper.runtime.JspContextWrapper

public class JspContextWrapper
extends javax.servlet.jsp.PageContext

Implementation of a JSP Context Wrapper. The JSP Context Wrapper is a JspContext created and maintained by a tag handler implementation. It wraps the Invoking JSP Context, that is, the JspContext instance passed to the tag handler by the invoking page via setJspContext().

Field Summary

Fields

Modifier and Type	Field	Description
private Map<String,String>	aliases
private ArrayList<String>	atBeginVars
private ArrayList<String>	atEndVars
private javax.el.ELContext	elContext
private javax.servlet.jsp.PageContext	invokingJspCtxt
private ArrayList<String>	nestedVars
private HashMap<String,Object>	originalNestedVars
private Hashtable<String,Object>	pageAttributes

Fields inherited from class javax.servlet.jsp.PageContext

APPLICATION, APPLICATION_SCOPE, CONFIG, EXCEPTION, OUT, PAGE, PAGE_SCOPE, PAGECONTEXT, REQUEST, REQUEST_SCOPE, RESPONSE, SESSION, SESSION_SCOPE

Constructor Summary

Constructors

Constructor	Description
JspContextWrapper(javax.servlet.jsp.JspContext jspContext, ArrayList<String> nestedVars, ArrayList<String> atBeginVars, ArrayList<String> atEndVars, Map<String,String> aliases)

Method Summary

Modifier and Type	Method	Description
private void	copyTagToPageScope(int scope)	Copies the variables of the given scope from the virtual page scope of this JSP context wrapper to the page scope of the invoking JSP context.
private String	findAlias(String varName)	Checks to see if the given variable name is used as an alias, and if so, returns the variable name for which it is used as an alias.
Object	findAttribute(String name)
void	forward(String relativeUrlPath)
Object	getAttribute(String name)
Object	getAttribute(String name, int scope)
Enumeration<String>	getAttributeNamesInScope(int scope)
int	getAttributesScope(String name)
javax.el.ELContext	getELContext()
Exception	getException()
javax.servlet.jsp.el.ExpressionEvaluator	getExpressionEvaluator()
javax.servlet.jsp.JspWriter	getOut()
Object	getPage()
javax.servlet.ServletRequest	getRequest()
javax.servlet.ServletResponse	getResponse()
static javax.servlet.jsp.PageContext	getRootPageContext(javax.servlet.jsp.PageContext pc)
javax.servlet.ServletConfig	getServletConfig()
javax.servlet.ServletContext	getServletContext()
javax.servlet.http.HttpSession	getSession()
javax.servlet.jsp.el.VariableResolver	getVariableResolver()
void	handlePageException(Exception ex)
void	handlePageException(Throwable t)
void	include(String relativeUrlPath)
void	include(String relativeUrlPath, boolean flush)
void	initialize(javax.servlet.Servlet servlet, javax.servlet.ServletRequest request, javax.servlet.ServletResponse response, String errorPageURL, boolean needsSession, int bufferSize, boolean autoFlush)
javax.servlet.jsp.JspWriter	popBody()
javax.servlet.jsp.tagext.BodyContent	pushBody()
javax.servlet.jsp.JspWriter	pushBody(Writer writer)
void	release()
void	removeAttribute(String name)
void	removeAttribute(String name, int scope)
private void	restoreNestedVariables()	Restores the values of any NESTED variables in the invoking JSP context.
private void	saveNestedVariables()	Saves the values of any NESTED variables that are present in the invoking JSP context, so they can later be restored.
void	setAttribute(String name, Object value)
void	setAttribute(String name, Object value, int scope)
void	syncBeforeInvoke()	Synchronize variables before fragment invokation
void	syncBeginTagFile()	Synchronize variables at begin of tag file
void	syncEndTagFile()	Synchronize variables at end of tag file

Methods inherited from class javax.servlet.jsp.PageContext

getErrorData

Methods inherited from class Object

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

Field Details

invokingJspCtxt

private javax.servlet.jsp.PageContext invokingJspCtxt

pageAttributes

private Hashtable<String,Object> pageAttributes

nestedVars

private ArrayList<String> nestedVars

atBeginVars

private ArrayList<String> atBeginVars

atEndVars

private ArrayList<String> atEndVars

aliases

private Map<String,String> aliases

originalNestedVars

private HashMap<String,Object> originalNestedVars

elContext

private javax.el.ELContext elContext

Constructor Details

JspContextWrapper

public JspContextWrapper(javax.servlet.jsp.JspContext jspContext,
 ArrayList<String> nestedVars,
 ArrayList<String> atBeginVars,
 ArrayList<String> atEndVars,
 Map<String,String> aliases)

Method Details

initialize

public void initialize(javax.servlet.Servlet servlet,
 javax.servlet.ServletRequest request,
 javax.servlet.ServletResponse response,
 String errorPageURL,
 boolean needsSession,
 int bufferSize,
 boolean autoFlush)
                throws IOException,
IllegalStateException,
IllegalArgumentException

Specified by:

initialize in class javax.servlet.jsp.PageContext

Throws:

IOException

IllegalStateException

IllegalArgumentException

getAttribute

public Object getAttribute(String name)

Specified by:

getAttribute in class javax.servlet.jsp.JspContext

getAttribute

public Object getAttribute(String name,
 int scope)

Specified by:

getAttribute in class javax.servlet.jsp.JspContext

setAttribute

public void setAttribute(String name,
 Object value)

Specified by:

setAttribute in class javax.servlet.jsp.JspContext

setAttribute

public void setAttribute(String name,
 Object value,
 int scope)

Specified by:

setAttribute in class javax.servlet.jsp.JspContext

findAttribute

public Object findAttribute(String name)

Specified by:

findAttribute in class javax.servlet.jsp.JspContext

removeAttribute

public void removeAttribute(String name)

Specified by:

removeAttribute in class javax.servlet.jsp.JspContext

removeAttribute

public void removeAttribute(String name,
 int scope)

Specified by:

removeAttribute in class javax.servlet.jsp.JspContext

getAttributesScope

public int getAttributesScope(String name)

Specified by:

getAttributesScope in class javax.servlet.jsp.JspContext

getAttributeNamesInScope

public Enumeration<String> getAttributeNamesInScope(int scope)

Specified by:

getAttributeNamesInScope in class javax.servlet.jsp.JspContext

release

public void release()

Specified by:

release in class javax.servlet.jsp.PageContext

getOut

public javax.servlet.jsp.JspWriter getOut()

Specified by:

getOut in class javax.servlet.jsp.JspContext

getSession

public javax.servlet.http.HttpSession getSession()

Specified by:

getSession in class javax.servlet.jsp.PageContext

getPage

public Object getPage()

Specified by:

getPage in class javax.servlet.jsp.PageContext

getRequest

public javax.servlet.ServletRequest getRequest()

Specified by:

getRequest in class javax.servlet.jsp.PageContext

getResponse

public javax.servlet.ServletResponse getResponse()

Specified by:

getResponse in class javax.servlet.jsp.PageContext

getException

public Exception getException()

Specified by:

getException in class javax.servlet.jsp.PageContext

getServletConfig

public javax.servlet.ServletConfig getServletConfig()

Specified by:

getServletConfig in class javax.servlet.jsp.PageContext

getServletContext

public javax.servlet.ServletContext getServletContext()

Specified by:

getServletContext in class javax.servlet.jsp.PageContext

getRootPageContext

public static javax.servlet.jsp.PageContext getRootPageContext(javax.servlet.jsp.PageContext pc)

getELContext

public javax.el.ELContext getELContext()

Specified by:

getELContext in class javax.servlet.jsp.JspContext

forward

public void forward(String relativeUrlPath)
             throws javax.servlet.ServletException,
IOException

Specified by:

forward in class javax.servlet.jsp.PageContext

Throws:

javax.servlet.ServletException

IOException

include

public void include(String relativeUrlPath)
             throws javax.servlet.ServletException,
IOException

Specified by:

include in class javax.servlet.jsp.PageContext

Throws:

javax.servlet.ServletException

IOException

include

public void include(String relativeUrlPath,
 boolean flush)
             throws javax.servlet.ServletException,
IOException

Specified by:

include in class javax.servlet.jsp.PageContext

Throws:

javax.servlet.ServletException

IOException

getVariableResolver

public javax.servlet.jsp.el.VariableResolver getVariableResolver()

Specified by:

getVariableResolver in class javax.servlet.jsp.JspContext

pushBody

public javax.servlet.jsp.tagext.BodyContent pushBody()

Overrides:

pushBody in class javax.servlet.jsp.PageContext

pushBody

public javax.servlet.jsp.JspWriter pushBody(Writer writer)

Overrides:

pushBody in class javax.servlet.jsp.JspContext

popBody

public javax.servlet.jsp.JspWriter popBody()

Overrides:

popBody in class javax.servlet.jsp.JspContext

getExpressionEvaluator

public javax.servlet.jsp.el.ExpressionEvaluator getExpressionEvaluator()

Specified by:

getExpressionEvaluator in class javax.servlet.jsp.JspContext

handlePageException

public void handlePageException(Exception ex)
                         throws IOException,
javax.servlet.ServletException

Specified by:

handlePageException in class javax.servlet.jsp.PageContext

Throws:

IOException

javax.servlet.ServletException

handlePageException

public void handlePageException(Throwable t)
                         throws IOException,
javax.servlet.ServletException

Specified by:

handlePageException in class javax.servlet.jsp.PageContext

Throws:

IOException

javax.servlet.ServletException

syncBeginTagFile

public void syncBeginTagFile()

Synchronize variables at begin of tag file

syncBeforeInvoke

public void syncBeforeInvoke()

Synchronize variables before fragment invokation

syncEndTagFile

public void syncEndTagFile()

Synchronize variables at end of tag file

copyTagToPageScope

private void copyTagToPageScope(int scope)

Copies the variables of the given scope from the virtual page scope of this JSP context wrapper to the page scope of the invoking JSP context.

Parameters:

scope - variable scope (one of NESTED, AT_BEGIN, or AT_END)

saveNestedVariables

private void saveNestedVariables()

Saves the values of any NESTED variables that are present in the invoking JSP context, so they can later be restored.

restoreNestedVariables

private void restoreNestedVariables()

Restores the values of any NESTED variables in the invoking JSP context.

findAlias

private String findAlias(String varName)

Checks to see if the given variable name is used as an alias, and if so, returns the variable name for which it is used as an alias.

Parameters:

varName - The variable name to check

Returns:

The variable name for which varName is used as an alias, or varName if it is not being used as an alias