Author: ivaynberg
Date: Fri Aug 20 21:43:59 2010
New Revision: 987641
URL: http://svn.apache.org/viewvc?rev=987641&view=rev
Log:
Issue: WICKET-3002
Modified:
wicket/branches/wicket-1.4.x/wicket/src/main/java/org/apache/wicket/Resource.java
Modified:
wicket/branches/wicket-1.4.x/wicket/src/main/java/org/apache/wicket/Resource.java
URL:
http://svn.apache.org/viewvc/wicket/branches/wicket-1.4.x/wicket/src/main/java/org/apache/wicket/Resource.java?rev=987641&r1=987640&r2=987641&view=diff
==============================================================================
---
wicket/branches/wicket-1.4.x/wicket/src/main/java/org/apache/wicket/Resource.java
(original)
+++
wicket/branches/wicket-1.4.x/wicket/src/main/java/org/apache/wicket/Resource.java
Fri Aug 20 21:43:59 2010
@@ -78,9 +78,19 @@ public abstract class Resource implement
cacheable = true;
}
- /**
- * @return Gets the resource to render to the requester
- */
+
+ /**
+ * Returns a new IResourceStream that provides all data for the request.
+ *
+ * Despite its name, this method should return a new IResourceStream instance
+ * each time it is invoked (otherwise the InputStream returned from the
+ * IResourceStream would be at EOF when a second request is handled for the
+ * same Resource).
+ *
+ * The caller must invoke IResourceStream.close() when finished.
+ *
+ * @return a new IResourceStream instance for this Resource.
+ */
public abstract IResourceStream getResourceStream();
/**
