Author: mduerig
Date: Tue Nov 19 08:46:04 2013
New Revision: 1543346
URL: http://svn.apache.org/r1543346
Log:
OAK-1189: Blob instances do no adhere to contract
Adjust contract
Modified:
jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/Blob.java
Modified:
jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/Blob.java
URL:
http://svn.apache.org/viewvc/jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/Blob.java?rev=1543346&r1=1543345&r2=1543346&view=diff
==============================================================================
---
jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/Blob.java
(original)
+++
jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/Blob.java
Tue Nov 19 08:46:04 2013
@@ -38,9 +38,13 @@ import javax.annotation.Nonnull;
public interface Blob {
/**
- * Returns a new stream for this value object. Multiple calls to this
- * methods return equal instances: {@code
getNewStream().equals(getNewStream())}.
- * @return a new stream for this value based on an internal conversion.
+ * Returns a new stream for this blob. The streams returned from
+ * multiple calls to this method are byte wise equals. That is,
+ * subsequent calls to {@link java.io.InputStream#read() read}
+ * return the same sequence of bytes as long as neither call throws
+ * an exception.
+ *
+ * @return a new stream for this blob
*/
@Nonnull
InputStream getNewStream();
