patrickl 2002/08/08 15:20:31
Modified: src/share/javax/servlet/jsp JspContext.java
Log:
Reverse previous commit as it breaks the jakarta-tomcat-jasper/jasper2 build.
Revision Changes Path
1.3 +46 -0 jakarta-servletapi-5/src/share/javax/servlet/jsp/JspContext.java
Index: JspContext.java
===================================================================
RCS file:
/home/cvs/jakarta-servletapi-5/src/share/javax/servlet/jsp/JspContext.java,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- JspContext.java 8 Aug 2002 21:16:23 -0000 1.2
+++ JspContext.java 8 Aug 2002 22:20:31 -0000 1.3
@@ -77,6 +77,12 @@
* scripting environment
* </ul>
*
+ * <p><B>Methods Intended for Container Generated Code</B>
+ * <p>
+ * To facilitate Simple Tag Extensions, the <code>pushPageScope()</code>,
+ * <code>popPageScope()</code> and <code>peekPageScope()</code> methods are
+ * added.
+ *
* <p><B>Methods Intended for JSP authors</B>
* <p>
* The following methods provide <B>convenient access</B> to implicit objects:
@@ -220,6 +226,46 @@
abstract public JspWriter getOut();
+ /**
+ * Pops the page scope from the stack. After calling this method, the
+ * PageScope will appear the same as it was before the last call to
+ * pushPageScope.
+ *
+ * @return A Map representing the state of the page scope just before
+ * it was popped. This object can be passed to pushPageScope to
+ * restore this state. The keys of the returned Map are Strings
+ * representing attribute names. The values are the values of
+ * those attributes.
+ * @throws java.util.EmptyStackException if this is the last page scope on the
+ * stack.
+ */
+ public abstract java.util.Map popPageScope()
+ throws java.util.EmptyStackException;
+
+ /**
+ * Pushes a page scope on the stack. The scopeState cannot be arbitrary.
+ * Only a page scope returned from popPageScope() or peekPageScope() may
+ * be passed in.
+ *
+ * @param scopeState If null, a new, empty, page scope is pushed.
+ * Otherwise, the state of the page scope is restored to the
+ * contents of the provided Map.
+ */
+ public abstract void pushPageScope( java.util.Map scopeState );
+
+ /**
+ * Peeks at the top element of the page scope stack. This value is
+ * the current state of the page scope. Does not modify the state of
+ * the stack or copy any objects.
+ *
+ * @return A Map representing the state of the page scope currently
+ * at the top of the stack. This object can be passed to
+ * pushPageScope to restore this state. The keys of the returned
+ * Map are Strings representing attribute names. The values are
+ * the values of those attributes.
+ */
+ public abstract java.util.Map peekPageScope();
+
/**
* Provides programmatic access to the ExpressionEvaluator.
* The JSP Container must return a valid instance of an
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
