File	Doc	Category	Size	Date	Package
JspContext.java	API Doc	Glassfish v2 API	12274	Fri May 04 22:34:24 BST 2007	javax.servlet.jsp

JspContext

• java.lang.Object

Fields Summary

Constructors Summary
public JspContext() Sole constructor. (For invocation by subclass constructors, typically implicit.)

Methods Summary
public abstract java.lang.Object	findAttribute(java.lang.String name) Searches for the named attribute in page, request, session (if valid), and application scope(s) in order and returns the value associated or null. param name the name of the attribute to search for return the value associated or null throws NullPointerException if the name is null
public abstract java.lang.Object	getAttribute(java.lang.String name) Returns the object associated with the name in the page scope or null if not found. param name the name of the attribute to get return the object associated with the name in the page scope or null if not found. throws NullPointerException if the name is null
public abstract java.lang.Object	getAttribute(java.lang.String name, int scope) Return the object associated with the name in the specified scope or null if not found. param name the name of the attribute to set param scope the scope with which to associate the name/object return the object associated with the name in the specified scope or null if not found. throws NullPointerException if the name is null throws IllegalArgumentException if the scope is invalid throws IllegalStateException if the scope is PageContext.SESSION_SCOPE but the page that was requested does not participate in a session or the session has been invalidated.
public abstract java.util.Enumeration	getAttributeNamesInScope(int scope) Enumerate all the attributes in a given scope. param scope the scope to enumerate all the attributes for return an enumeration of names (java.lang.String) of all the attributes the specified scope throws IllegalArgumentException if the scope is invalid throws IllegalStateException if the scope is PageContext.SESSION_SCOPE but the page that was requested does not participate in a session or the session has been invalidated.
public abstract int	getAttributesScope(java.lang.String name) Get the scope where a given attribute is defined. param name the name of the attribute to return the scope for return the scope of the object associated with the name specified or 0 throws NullPointerException if the name is null
public abstract javax.el.ELContext	getELContext() Returns the ELContext associated with this JspContext. The ELContext is created lazily and is reused if it already exists. There is a new ELContext for each JspContext. The ELContext must contain the ELResolver described in the JSP specification (and in the javadocs for {@link JspApplicationContext#addELResolver}). return The ELContext associated with this JspContext. since JSP 2.1
public abstract javax.servlet.jsp.el.ExpressionEvaluator	getExpressionEvaluator() Provides programmatic access to the ExpressionEvaluator. The JSP Container must return a valid instance of an ExpressionEvaluator that can parse EL expressions. deprecated As of JSP 2.1, replaced by {@link JspApplicationContext#getExpressionFactory} return A valid instance of an ExpressionEvaluator. since JSP 2.0
public abstract JspWriter	getOut() The current value of the out object (a JspWriter). return the current JspWriter stream being used for client response
public abstract javax.servlet.jsp.el.VariableResolver	getVariableResolver() Returns an instance of a VariableResolver that provides access to the implicit objects specified in the JSP specification using this JspContext as the context object. deprecated As of JSP 2.1, replaced by {@link ELContext#getELResolver}, which can be obtained by jspContext.getELContext().getELResolver(). return A valid instance of a VariableResolver. since JSP 2.0
public JspWriter	popBody() Return the previous JspWriter "out" saved by the matching pushBody(), and update the value of the "out" attribute in the page scope attribute namespace of the JspContext. return the saved JspWriter. return null; // XXX to implement
public JspWriter	pushBody(java.io.Writer writer) Return a new JspWriter object that sends output to the provided Writer. Saves the current "out" JspWriter, and updates the value of the "out" attribute in the page scope attribute namespace of the JspContext. The returned JspWriter must implement all methods and behave as though it were unbuffered. More specifically: clear() must throw an IOException clearBuffer() does nothing getBufferSize() always returns 0 getRemaining() always returns 0 param writer The Writer for the returned JspWriter to send output to. return a new JspWriter that writes to the given Writer. since JSP 2.0 return null; // XXX to implement
public abstract void	removeAttribute(java.lang.String name) Remove the object reference associated with the given name from all scopes. Does nothing if there is no such object. param name The name of the object to remove. throws NullPointerException if the name is null
public abstract void	removeAttribute(java.lang.String name, int scope) Remove the object reference associated with the specified name in the given scope. Does nothing if there is no such object. param name The name of the object to remove. param scope The scope where to look. throws IllegalArgumentException if the scope is invalid throws IllegalStateException if the scope is PageContext.SESSION_SCOPE but the page that was requested does not participate in a session or the session has been invalidated. throws NullPointerException if the name is null
public abstract void	setAttribute(java.lang.String name, java.lang.Object value) Register the name and value specified with page scope semantics. If the value passed in is null, this has the same effect as calling removeAttribute( name, PageContext.PAGE_SCOPE ). param name the name of the attribute to set param value the value to associate with the name, or null if the attribute is to be removed from the page scope. throws NullPointerException if the name is null
public abstract void	setAttribute(java.lang.String name, java.lang.Object value, int scope) Register the name and value specified with appropriate scope semantics. If the value passed in is null, this has the same effect as calling removeAttribute( name, scope ). param name the name of the attribute to set param value the object to associate with the name, or null if the attribute is to be removed from the specified scope. param scope the scope with which to associate the name/object throws NullPointerException if the name is null throws IllegalArgumentException if the scope is invalid throws IllegalStateException if the scope is PageContext.SESSION_SCOPE but the page that was requested does not participate in a session or the session has been invalidated.