Author: markt
Date: Mon Feb 18 10:06:16 2013
New Revision: 1447178
URL: http://svn.apache.org/r1447178
Log:
Improve Javadoc. Clarify difference between spec minimum behaviour and what
Tomcat does.
Modified:
tomcat/trunk/java/javax/servlet/http/Part.java
Modified: tomcat/trunk/java/javax/servlet/http/Part.java
URL:
http://svn.apache.org/viewvc/tomcat/trunk/java/javax/servlet/http/Part.java?rev=1447178&r1=1447177&r2=1447178&view=diff
==============================================================================
--- tomcat/trunk/java/javax/servlet/http/Part.java (original)
+++ tomcat/trunk/java/javax/servlet/http/Part.java Mon Feb 18 10:06:16 2013
@@ -71,10 +71,14 @@ public interface Part {
/**
* Deletes the underlying storage for a part, including deleting any
- * associated temporary disk file. Although this storage will be deleted
- * automatically when the Part instance is garbage collected, this
- * method can be used to ensure that this is done at an earlier time, thus
- * preserving system resources.
+ * associated temporary disk file. Although the container will delete this
+ * storage automatically this method can be used to ensure that this is
done
+ * at an earlier time, thus preserving system resources.
+ * <p>
+ * Containers are only required to delete the associated storage when the
+ * Part instance is garbage collected. Apache Tomcat will delete the
+ * associated storage when the associated request has finished processing.
+ * Behaviour of other containers may be different.
*/
public void delete() throws IOException;
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org
