ObjectInserter: Add warning about mixing read-back with writes

Change-Id: Ib0460d3c7df315d86f9adca5f66a8fd4c39e4060
This commit is contained in:
Dave Borowitz 2017-12-20 12:16:40 -05:00
parent 1e56842742
commit f63ee965d4
1 changed files with 7 additions and 0 deletions

View File

@ -423,6 +423,13 @@ public abstract ObjectId insert(int objectType, long length, InputStream in)
* <p>
* The returned reader should return this inserter instance from {@link
* ObjectReader#getCreatedFromInserter()}.
* <p>
* Behavior is undefined if an insert method is called on the inserter in the
* middle of reading from an {@link ObjectStream} opened from this reader. For
* example, reading the remainder of the object may fail, or newly written
* data may even be corrupted. Interleaving whole object reads (including
* streaming reads) with inserts is fine, just not interleaving streaming
* <em>partial</em> object reads with inserts.
*
* @since 3.5
* @return reader for any object, including an object recently inserted by