ObjectInserter: Add warning about mixing read-back with writes
Change-Id: Ib0460d3c7df315d86f9adca5f66a8fd4c39e4060
This commit is contained in:
parent
1e56842742
commit
f63ee965d4
|
@ -423,6 +423,13 @@ public abstract ObjectId insert(int objectType, long length, InputStream in)
|
||||||
* <p>
|
* <p>
|
||||||
* The returned reader should return this inserter instance from {@link
|
* The returned reader should return this inserter instance from {@link
|
||||||
* ObjectReader#getCreatedFromInserter()}.
|
* 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
|
* @since 3.5
|
||||||
* @return reader for any object, including an object recently inserted by
|
* @return reader for any object, including an object recently inserted by
|
||||||
|
|
Loading…
Reference in New Issue