kinman 2003/01/29 13:42:13
Modified: jsr152/src/share/javax/servlet/jsp JspContext.java
JspEngineInfo.java JspFactory.java PageContext.java
jsr152/src/share/javax/servlet/jsp/tagext BodyTag.java
IterationTag.java PageData.java
SimpleTagSupport.java TagExtraInfo.java
TagLibraryValidator.java TryCatchFinally.java
Log:
- Patch by Mark Roth:
Javadoc enhancements for JSP 2.0 API.
New Files (attached separately):
- jsr152/src/share/javax/servlet/jsp/package.html
- jsr152/src/share/javax/servlet/jsp/el/package.html
- jsr152/src/share/javax/servlet/jsp/tagext/package.html
jsr152/src/share/javax/servlet/jsp/JspContext.java
- Added javadoc comment for public no-args constructor
jsr152/src/share/javax/servlet/jsp/JspEngineInfo.java
- Added javadoc comment for public no-args constructor
jsr152/src/share/javax/servlet/jsp/JspFactory.java
- Added javadoc comment for public no-args constructor
jsr152/src/share/javax/servlet/jsp/PageContext.java
- Added javadoc comment for public no-args constructor
jsr152/src/share/javax/servlet/jsp/tagext/BodyTag.java
- Added description for doInitBody() @throws JspException
jsr152/src/share/javax/servlet/jsp/tagext/IterationTag.java
- Added description for doAfterBody() @throws JspException
jsr152/src/share/javax/servlet/jsp/tagext/PageData.java
- Added javadoc comment for public no-args constructor
jsr152/src/share/javax/servlet/jsp/tagext/SimpleTagSupport.java
- Added javadoc comment for public no-args constructor
jsr152/src/share/javax/servlet/jsp/tagext/TagExtraInfo.java
- Added javadoc comment for public no-args constructor
jsr152/src/share/javax/servlet/jsp/tagext/TagLibraryValidator.java
- Added javadoc comment for public no-args constructor
jsr152/src/share/javax/servlet/jsp/tagext/TryCatchFinally.java
- Added @throws Throwable tag for doCatch()
Revision Changes Path
1.7 +7 -0
jakarta-servletapi-5/jsr152/src/share/javax/servlet/jsp/JspContext.java
Index: JspContext.java
===================================================================
RCS file:
/home/cvs/jakarta-servletapi-5/jsr152/src/share/javax/servlet/jsp/JspContext.java,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- JspContext.java 18 Dec 2002 18:35:37 -0000 1.6
+++ JspContext.java 29 Jan 2003 21:42:13 -0000 1.7
@@ -109,6 +109,13 @@
public abstract class JspContext {
+ /**
+ * Sole constructor. (For invocation by subclass constructors,
+ * typically implicit.)
+ */
+ public JspContext() {
+ }
+
/**
* Register the name and value specified with page scope semantics.
* If the value passed in is <code>null</code>, this has the same
1.2 +7 -0
jakarta-servletapi-5/jsr152/src/share/javax/servlet/jsp/JspEngineInfo.java
Index: JspEngineInfo.java
===================================================================
RCS file:
/home/cvs/jakarta-servletapi-5/jsr152/src/share/javax/servlet/jsp/JspEngineInfo.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- JspEngineInfo.java 13 Aug 2002 16:20:54 -0000 1.1
+++ JspEngineInfo.java 29 Jan 2003 21:42:13 -0000 1.2
@@ -61,6 +61,13 @@
*/
public abstract class JspEngineInfo {
+
+ /**
+ * Sole constructor. (For invocation by subclass constructors,
+ * typically implicit.)
+ */
+ public JspEngineInfo() {
+ }
/**
* Return the version number of the JSP specification that is supported by
1.3 +7 -0
jakarta-servletapi-5/jsr152/src/share/javax/servlet/jsp/JspFactory.java
Index: JspFactory.java
===================================================================
RCS file:
/home/cvs/jakarta-servletapi-5/jsr152/src/share/javax/servlet/jsp/JspFactory.java,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- JspFactory.java 19 Aug 2002 16:29:49 -0000 1.2
+++ JspFactory.java 29 Jan 2003 21:42:13 -0000 1.3
@@ -82,6 +82,13 @@
public abstract class JspFactory {
private static JspFactory deflt = null;
+
+ /**
+ * Sole constructor. (For invocation by subclass constructors,
+ * typically implicit.)
+ */
+ public JspFactory() {
+ }
/**
* <p>
1.7 +8 -1
jakarta-servletapi-5/jsr152/src/share/javax/servlet/jsp/PageContext.java
Index: PageContext.java
===================================================================
RCS file:
/home/cvs/jakarta-servletapi-5/jsr152/src/share/javax/servlet/jsp/PageContext.java,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- PageContext.java 18 Dec 2002 18:35:37 -0000 1.6
+++ PageContext.java 29 Jan 2003 21:42:13 -0000 1.7
@@ -132,7 +132,14 @@
abstract public class PageContext
extends JspContext
{
-
+
+ /**
+ * Sole constructor. (For invocation by subclass constructors,
+ * typically implicit.)
+ */
+ public PageContext() {
+ }
+
/**
* Page scope: (this is the default) the named reference remains available
* in this PageContext until the return from the current Servlet.service()
1.6 +1 -1
jakarta-servletapi-5/jsr152/src/share/javax/servlet/jsp/tagext/BodyTag.java
Index: BodyTag.java
===================================================================
RCS file:
/home/cvs/jakarta-servletapi-5/jsr152/src/share/javax/servlet/jsp/tagext/BodyTag.java,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- BodyTag.java 16 Jan 2003 01:37:04 -0000 1.5
+++ BodyTag.java 29 Jan 2003 21:42:13 -0000 1.6
@@ -214,7 +214,7 @@
* NESTED variables (defined by the associated TagExtraInfo or TLD) after
* the invocation of doInitBody().
*
- * @throws JspException
+ * @throws JspException if an error occurred while processing this tag
* @see #doAfterBody
*/
1.5 +1 -1
jakarta-servletapi-5/jsr152/src/share/javax/servlet/jsp/tagext/IterationTag.java
Index: IterationTag.java
===================================================================
RCS file:
/home/cvs/jakarta-servletapi-5/jsr152/src/share/javax/servlet/jsp/tagext/IterationTag.java,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- IterationTag.java 18 Dec 2002 18:35:37 -0000 1.4
+++ IterationTag.java 29 Jan 2003 21:42:13 -0000 1.5
@@ -147,7 +147,7 @@
* the invocation of doAfterBody().
*
* @return whether additional evaluations of the body are desired
- * @throws JspException
+ * @throws JspException if an error occurred while processing this tag
*/
int doAfterBody() throws JspException;
1.3 +7 -0
jakarta-servletapi-5/jsr152/src/share/javax/servlet/jsp/tagext/PageData.java
Index: PageData.java
===================================================================
RCS file:
/home/cvs/jakarta-servletapi-5/jsr152/src/share/javax/servlet/jsp/tagext/PageData.java,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- PageData.java 8 Nov 2002 21:30:21 -0000 1.2
+++ PageData.java 29 Jan 2003 21:42:13 -0000 1.3
@@ -69,6 +69,13 @@
abstract public class PageData {
/**
+ * Sole constructor. (For invocation by subclass constructors,
+ * typically implicit.)
+ */
+ public PageData() {
+ }
+
+ /**
* Returns an input stream on the XML view of a JSP page.
* The stream is encoded in UTF-8. Recall tht the XML view of a
* JSP page has the include directives expanded.
1.5 +7 -0
jakarta-servletapi-5/jsr152/src/share/javax/servlet/jsp/tagext/SimpleTagSupport.java
Index: SimpleTagSupport.java
===================================================================
RCS file:
/home/cvs/jakarta-servletapi-5/jsr152/src/share/javax/servlet/jsp/tagext/SimpleTagSupport.java,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- SimpleTagSupport.java 29 Oct 2002 01:18:12 -0000 1.4
+++ SimpleTagSupport.java 29 Jan 2003 21:42:13 -0000 1.5
@@ -81,6 +81,13 @@
/** The body of the tag. */
protected JspFragment jspBody;
+ /**
+ * Sole constructor. (For invocation by subclass constructors,
+ * typically implicit.)
+ */
+ public SimpleTagSupport() {
+ }
+
/**
* Default processing of the tag does nothing.
*
1.5 +7 -0
jakarta-servletapi-5/jsr152/src/share/javax/servlet/jsp/tagext/TagExtraInfo.java
Index: TagExtraInfo.java
===================================================================
RCS file:
/home/cvs/jakarta-servletapi-5/jsr152/src/share/javax/servlet/jsp/tagext/TagExtraInfo.java,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- TagExtraInfo.java 4 Nov 2002 17:44:24 -0000 1.4
+++ TagExtraInfo.java 29 Jan 2003 21:42:13 -0000 1.5
@@ -92,6 +92,13 @@
public abstract class TagExtraInfo {
/**
+ * Sole constructor. (For invocation by subclass constructors,
+ * typically implicit.)
+ */
+ public TagExtraInfo() {
+ }
+
+ /**
* information on scripting variables defined by the tag associated with
* this TagExtraInfo instance.
* Request-time attributes are indicated as such in the TagData parameter.
1.5 +8 -1
jakarta-servletapi-5/jsr152/src/share/javax/servlet/jsp/tagext/TagLibraryValidator.java
Index: TagLibraryValidator.java
===================================================================
RCS file:
/home/cvs/jakarta-servletapi-5/jsr152/src/share/javax/servlet/jsp/tagext/TagLibraryValidator.java,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- TagLibraryValidator.java 18 Dec 2002 18:35:37 -0000 1.4
+++ TagLibraryValidator.java 29 Jan 2003 21:42:13 -0000 1.5
@@ -106,6 +106,13 @@
abstract public class TagLibraryValidator {
/**
+ * Sole constructor. (For invocation by subclass constructors,
+ * typically implicit.)
+ */
+ public TagLibraryValidator() {
+ }
+
+ /**
* Set the init data in the TLD for this validator.
* Parameter names are keys, and parameter values are the values.
*
@@ -150,7 +157,7 @@
*/
public void release() {
initParameters = null;
- };
+ }
// Private data
private Map initParameters;
1.2 +3 -1
jakarta-servletapi-5/jsr152/src/share/javax/servlet/jsp/tagext/TryCatchFinally.java
Index: TryCatchFinally.java
===================================================================
RCS file:
/home/cvs/jakarta-servletapi-5/jsr152/src/share/javax/servlet/jsp/tagext/TryCatchFinally.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- TryCatchFinally.java 13 Aug 2002 16:20:56 -0000 1.1
+++ TryCatchFinally.java 29 Jan 2003 21:42:13 -0000 1.2
@@ -103,13 +103,15 @@
* one of the setter methods.
*
* <p>This method may throw an exception (the same or a new one)
- * that will be propagated further the nest chain. If an exception
+ * that will be propagated further up the nest chain. If an exception
* is thrown, doFinally() will be invoked.
*
* <p>This method is intended to be used to respond to an exceptional
* condition.
*
* @param t The throwable exception navigating through this tag.
+ * @throws Throwable if the exception is to be rethrown further up
+ * the nest chain.
*/
void doCatch(Throwable t) throws Throwable;
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
