svn commit: r1543346 - /jackrabbit/oak/trunk/oak-core/src/main/java/org/apache/jackrabbit/oak/api/Blob.java

[md...@apache.org]

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();