You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@bookkeeper.apache.org by gi...@apache.org on 2019/10/10 16:09:58 UTC
[bookkeeper] branch asf-site updated: Updated site at revision
14c997904
This is an automated email from the ASF dual-hosted git repository.
git-site-role pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/bookkeeper.git
The following commit(s) were added to refs/heads/asf-site by this push:
new d1daa5d Updated site at revision 14c997904
d1daa5d is described below
commit d1daa5d393564c7163ad93d4766dab2d7c482b03
Author: jenkins <bu...@apache.org>
AuthorDate: Thu Oct 10 16:09:54 2019 +0000
Updated site at revision 14c997904
---
.../org/apache/bookkeeper/client/LedgerHandle.html | 33 ++++++++++++++--------
.../apache/bookkeeper/client/LedgerHandleAdv.html | 24 ++++++++++------
.../bookkeeper/client/ReadOnlyLedgerHandle.html | 12 +++++---
.../bookkeeper/client/api/WriteAdvHandle.html | 24 ++++++++++------
.../apache/bookkeeper/client/api/WriteHandle.html | 24 ++++++++++------
5 files changed, 78 insertions(+), 39 deletions(-)
diff --git a/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/LedgerHandle.html b/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/LedgerHandle.html
index d0a4808..631679d 100644
--- a/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/LedgerHandle.html
+++ b/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/LedgerHandle.html
@@ -1780,7 +1780,8 @@ implements <a href="../../../../org/apache/bookkeeper/client/api/WriteHandle.htm
<div class="block">Add entry synchronously to an open ledger.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>data</code> - array of bytes to be written to the ledger</dd>
+<dd><code>data</code> - array of bytes to be written to the ledger
+ do not reuse the buffer, bk-client will release it appropriately</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>the entryId of the new inserted entry</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
@@ -1802,7 +1803,8 @@ implements <a href="../../../../org/apache/bookkeeper/client/api/WriteHandle.htm
<dd><code><a href="../../../../org/apache/bookkeeper/client/api/WriteHandle.html#appendAsync-io.netty.buffer.ByteBuf-">appendAsync</a></code> in interface <code><a href="../../../../org/apache/bookkeeper/client/api/WriteHandle.html" title="interface in org.apache.bookkeeper.client.api">WriteHandle</a></code></dd>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>data</code> - a bytebuf to be written. The bytebuf's reference count will be decremented by 1 after the
- completable future is returned</dd>
+ completable future is returned
+ do not reuse the buffer, bk-client will release it appropriately.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>an handle to the result, in case of success it will return the id of the newly appended entry</dd>
</dl>
@@ -1823,7 +1825,8 @@ implements <a href="../../../../org/apache/bookkeeper/client/api/WriteHandle.htm
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>entryId</code> - entryId to be added</dd>
-<dd><code>data</code> - array of bytes to be written to the ledger</dd>
+<dd><code>data</code> - array of bytes to be written to the ledger
+ do not reuse the buffer, bk-client will release it appropriately</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>the entryId of the new inserted entry</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
@@ -1846,7 +1849,8 @@ implements <a href="../../../../org/apache/bookkeeper/client/api/WriteHandle.htm
<div class="block">Add entry synchronously to an open ledger.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>data</code> - array of bytes to be written to the ledger</dd>
+<dd><code>data</code> - array of bytes to be written to the ledger
+ do not reuse the buffer, bk-client will release it appropriately</dd>
<dd><code>offset</code> - offset from which to take bytes from data</dd>
<dd><code>length</code> - number of bytes to take from data</dd>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -1874,7 +1878,8 @@ implements <a href="../../../../org/apache/bookkeeper/client/api/WriteHandle.htm
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>entryId</code> - entryId to be added.</dd>
-<dd><code>data</code> - array of bytes to be written to the ledger</dd>
+<dd><code>data</code> - array of bytes to be written to the ledger
+ do not reuse the buffer, bk-client will release it appropriately</dd>
<dd><code>offset</code> - offset from which to take bytes from data</dd>
<dd><code>length</code> - number of bytes to take from data</dd>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -1897,7 +1902,8 @@ implements <a href="../../../../org/apache/bookkeeper/client/api/WriteHandle.htm
<div class="block">Add entry asynchronously to an open ledger.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>data</code> - array of bytes to be written</dd>
+<dd><code>data</code> - array of bytes to be written
+ do not reuse the buffer, bk-client will release it appropriately</dd>
<dd><code>cb</code> - object implementing callbackinterface</dd>
<dd><code>ctx</code> - some control object</dd>
</dl>
@@ -1918,7 +1924,8 @@ implements <a href="../../../../org/apache/bookkeeper/client/api/WriteHandle.htm
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>entryId</code> - entryId to be added</dd>
-<dd><code>data</code> - array of bytes to be written</dd>
+<dd><code>data</code> - array of bytes to be written
+ do not reuse the buffer, bk-client will release it appropriately</dd>
<dd><code>cb</code> - object implementing callbackinterface</dd>
<dd><code>ctx</code> - some control object</dd>
</dl>
@@ -1938,7 +1945,8 @@ implements <a href="../../../../org/apache/bookkeeper/client/api/WriteHandle.htm
<div class="block">Add entry asynchronously to an open ledger, using an offset and range.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>data</code> - array of bytes to be written</dd>
+<dd><code>data</code> - array of bytes to be written
+ do not reuse the buffer, bk-client will release it appropriately</dd>
<dd><code>offset</code> - offset from which to take bytes from data</dd>
<dd><code>length</code> - number of bytes to take from data</dd>
<dd><code>cb</code> - object implementing callbackinterface</dd>
@@ -1979,7 +1987,8 @@ implements <a href="../../../../org/apache/bookkeeper/client/api/WriteHandle.htm
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>entryId</code> - entryId of the entry to add.</dd>
-<dd><code>data</code> - array of bytes to be written</dd>
+<dd><code>data</code> - array of bytes to be written
+ do not reuse the buffer, bk-client will release it appropriately</dd>
<dd><code>offset</code> - offset from which to take bytes from data</dd>
<dd><code>length</code> - number of bytes to take from data</dd>
<dd><code>cb</code> - object implementing callbackinterface</dd>
@@ -2006,7 +2015,8 @@ implements <a href="../../../../org/apache/bookkeeper/client/api/WriteHandle.htm
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>entryId</code> - entryId of the entry to add</dd>
-<dd><code>data</code> - array of bytes to be written</dd>
+<dd><code>data</code> - array of bytes to be written
+ do not reuse the buffer, bk-client will release it appropriately</dd>
<dd><code>offset</code> - offset from which to take bytes from data</dd>
<dd><code>length</code> - number of bytes to take from data</dd>
<dd><code>cb</code> - object implementing callbackinterface</dd>
@@ -2033,7 +2043,8 @@ implements <a href="../../../../org/apache/bookkeeper/client/api/WriteHandle.htm
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>entryId</code> - entryId of the entry to add.</dd>
-<dd><code>data</code> - io.netty.buffer.ByteBuf of bytes to be written</dd>
+<dd><code>data</code> - io.netty.buffer.ByteBuf of bytes to be written
+ do not reuse the buffer, bk-client will release it appropriately</dd>
<dd><code>cb</code> - object implementing callbackinterface</dd>
<dd><code>ctx</code> - some control object</dd>
</dl>
diff --git a/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/LedgerHandleAdv.html b/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/LedgerHandleAdv.html
index 55d5a43..c2cf517 100644
--- a/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/LedgerHandleAdv.html
+++ b/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/LedgerHandleAdv.html
@@ -429,7 +429,8 @@ implements <a href="../../../../org/apache/bookkeeper/client/api/WriteAdvHandle.
<dd><code><a href="../../../../org/apache/bookkeeper/client/LedgerHandle.html#addEntry-long-byte:A-">addEntry</a></code> in class <code><a href="../../../../org/apache/bookkeeper/client/LedgerHandle.html" title="class in org.apache.bookkeeper.client">LedgerHandle</a></code></dd>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>entryId</code> - entryId of the entry to add</dd>
-<dd><code>data</code> - array of bytes to be written to the ledger</dd>
+<dd><code>data</code> - array of bytes to be written to the ledger
+ do not reuse the buffer, bk-client will release it appropriately</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>entryId that is just created.</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
@@ -456,7 +457,8 @@ implements <a href="../../../../org/apache/bookkeeper/client/api/WriteAdvHandle.
<dd><code><a href="../../../../org/apache/bookkeeper/client/LedgerHandle.html#addEntry-long-byte:A-int-int-">addEntry</a></code> in class <code><a href="../../../../org/apache/bookkeeper/client/LedgerHandle.html" title="class in org.apache.bookkeeper.client">LedgerHandle</a></code></dd>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>entryId</code> - entryId of the entry to add</dd>
-<dd><code>data</code> - array of bytes to be written to the ledger</dd>
+<dd><code>data</code> - array of bytes to be written to the ledger
+ do not reuse the buffer, bk-client will release it appropriately</dd>
<dd><code>offset</code> - offset from which to take bytes from data</dd>
<dd><code>length</code> - number of bytes to take from data</dd>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -483,7 +485,8 @@ implements <a href="../../../../org/apache/bookkeeper/client/api/WriteAdvHandle.
<dd><code><a href="../../../../org/apache/bookkeeper/client/LedgerHandle.html#asyncAddEntry-long-byte:A-org.apache.bookkeeper.client.AsyncCallback.AddCallback-java.lang.Object-">asyncAddEntry</a></code> in class <code><a href="../../../../org/apache/bookkeeper/client/LedgerHandle.html" title="class in org.apache.bookkeeper.client">LedgerHandle</a></code></dd>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>entryId</code> - entryId of the entry to add</dd>
-<dd><code>data</code> - array of bytes to be written</dd>
+<dd><code>data</code> - array of bytes to be written
+ do not reuse the buffer, bk-client will release it appropriately</dd>
<dd><code>cb</code> - object implementing callbackinterface</dd>
<dd><code>ctx</code> - some control object</dd>
</dl>
@@ -507,7 +510,8 @@ implements <a href="../../../../org/apache/bookkeeper/client/api/WriteAdvHandle.
<dd><code><a href="../../../../org/apache/bookkeeper/client/LedgerHandle.html#asyncAddEntry-long-byte:A-int-int-org.apache.bookkeeper.client.AsyncCallback.AddCallback-java.lang.Object-">asyncAddEntry</a></code> in class <code><a href="../../../../org/apache/bookkeeper/client/LedgerHandle.html" title="class in org.apache.bookkeeper.client">LedgerHandle</a></code></dd>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>entryId</code> - entryId of the entry to add</dd>
-<dd><code>data</code> - array of bytes to be written</dd>
+<dd><code>data</code> - array of bytes to be written
+ do not reuse the buffer, bk-client will release it appropriately</dd>
<dd><code>offset</code> - offset from which to take bytes from data</dd>
<dd><code>length</code> - number of bytes to take from data</dd>
<dd><code>cb</code> - object implementing callbackinterface</dd>
@@ -536,7 +540,8 @@ implements <a href="../../../../org/apache/bookkeeper/client/api/WriteAdvHandle.
<dd><code><a href="../../../../org/apache/bookkeeper/client/LedgerHandle.html#asyncAddEntry-long-byte:A-int-int-org.apache.bookkeeper.client.AsyncCallback.AddCallbackWithLatency-java.lang.Object-">asyncAddEntry</a></code> in class <code><a href="../../../../org/apache/bookkeeper/client/LedgerHandle.html" title="class in org.apache.bookkeeper.client">LedgerHandle</a></code></dd>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>entryId</code> - entryId of the entry to add</dd>
-<dd><code>data</code> - array of bytes to be written</dd>
+<dd><code>data</code> - array of bytes to be written
+ do not reuse the buffer, bk-client will release it appropriately</dd>
<dd><code>offset</code> - offset from which to take bytes from data</dd>
<dd><code>length</code> - number of bytes to take from data</dd>
<dd><code>cb</code> - object implementing callbackinterface</dd>
@@ -565,7 +570,8 @@ implements <a href="../../../../org/apache/bookkeeper/client/api/WriteAdvHandle.
<dd><code><a href="../../../../org/apache/bookkeeper/client/LedgerHandle.html#asyncAddEntry-long-io.netty.buffer.ByteBuf-org.apache.bookkeeper.client.AsyncCallback.AddCallbackWithLatency-java.lang.Object-">asyncAddEntry</a></code> in class <code><a href="../../../../org/apache/bookkeeper/client/LedgerHandle.html" title="class in org.apache.bookkeeper.client">LedgerHandle</a></code></dd>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>entryId</code> - entryId of the entry to add.</dd>
-<dd><code>data</code> - io.netty.buffer.ByteBuf of bytes to be written</dd>
+<dd><code>data</code> - io.netty.buffer.ByteBuf of bytes to be written
+ do not reuse the buffer, bk-client will release it appropriately</dd>
<dd><code>cb</code> - object implementing callbackinterface</dd>
<dd><code>ctx</code> - some control object</dd>
</dl>
@@ -602,7 +608,8 @@ implements <a href="../../../../org/apache/bookkeeper/client/api/WriteAdvHandle.
<dd><code><a href="../../../../org/apache/bookkeeper/client/api/WriteAdvHandle.html#writeAsync-long-io.netty.buffer.ByteBuf-">writeAsync</a></code> in interface <code><a href="../../../../org/apache/bookkeeper/client/api/WriteAdvHandle.html" title="interface in org.apache.bookkeeper.client.api">WriteAdvHandle</a></code></dd>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>entryId</code> - entryId to be added</dd>
-<dd><code>data</code> - array of bytes to be written</dd>
+<dd><code>data</code> - array of bytes to be written
+ do not reuse the buffer, bk-client will release it appropriately.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>an handle to the result, in case of success it will return the same value of param entryId</dd>
</dl>
@@ -640,7 +647,8 @@ implements <a href="../../../../org/apache/bookkeeper/client/api/WriteAdvHandle.
<dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
<dd><code><a href="../../../../org/apache/bookkeeper/client/LedgerHandle.html#asyncAddEntry-byte:A-int-int-org.apache.bookkeeper.client.AsyncCallback.AddCallback-java.lang.Object-">asyncAddEntry</a></code> in class <code><a href="../../../../org/apache/bookkeeper/client/LedgerHandle.html" title="class in org.apache.bookkeeper.client">LedgerHandle</a></code></dd>
<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>data</code> - array of bytes to be written</dd>
+<dd><code>data</code> - array of bytes to be written
+ do not reuse the buffer, bk-client will release it appropriately</dd>
<dd><code>offset</code> - offset from which to take bytes from data</dd>
<dd><code>length</code> - number of bytes to take from data</dd>
<dd><code>cb</code> - object implementing callbackinterface</dd>
diff --git a/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/ReadOnlyLedgerHandle.html b/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/ReadOnlyLedgerHandle.html
index 15f7a7a..dbac136 100644
--- a/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/ReadOnlyLedgerHandle.html
+++ b/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/ReadOnlyLedgerHandle.html
@@ -454,7 +454,8 @@ implements org.apache.bookkeeper.proto.BookkeeperInternalCallbacks.LedgerMetadat
<dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
<dd><code><a href="../../../../org/apache/bookkeeper/client/LedgerHandle.html#addEntry-byte:A-">addEntry</a></code> in class <code><a href="../../../../org/apache/bookkeeper/client/LedgerHandle.html" title="class in org.apache.bookkeeper.client">LedgerHandle</a></code></dd>
<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>data</code> - array of bytes to be written to the ledger</dd>
+<dd><code>data</code> - array of bytes to be written to the ledger
+ do not reuse the buffer, bk-client will release it appropriately</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>the entryId of the new inserted entry</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
@@ -480,7 +481,8 @@ implements org.apache.bookkeeper.proto.BookkeeperInternalCallbacks.LedgerMetadat
<dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
<dd><code><a href="../../../../org/apache/bookkeeper/client/LedgerHandle.html#addEntry-byte:A-int-int-">addEntry</a></code> in class <code><a href="../../../../org/apache/bookkeeper/client/LedgerHandle.html" title="class in org.apache.bookkeeper.client">LedgerHandle</a></code></dd>
<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>data</code> - array of bytes to be written to the ledger</dd>
+<dd><code>data</code> - array of bytes to be written to the ledger
+ do not reuse the buffer, bk-client will release it appropriately</dd>
<dd><code>offset</code> - offset from which to take bytes from data</dd>
<dd><code>length</code> - number of bytes to take from data</dd>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -506,7 +508,8 @@ implements org.apache.bookkeeper.proto.BookkeeperInternalCallbacks.LedgerMetadat
<dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
<dd><code><a href="../../../../org/apache/bookkeeper/client/LedgerHandle.html#asyncAddEntry-byte:A-org.apache.bookkeeper.client.AsyncCallback.AddCallback-java.lang.Object-">asyncAddEntry</a></code> in class <code><a href="../../../../org/apache/bookkeeper/client/LedgerHandle.html" title="class in org.apache.bookkeeper.client">LedgerHandle</a></code></dd>
<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>data</code> - array of bytes to be written</dd>
+<dd><code>data</code> - array of bytes to be written
+ do not reuse the buffer, bk-client will release it appropriately</dd>
<dd><code>cb</code> - object implementing callbackinterface</dd>
<dd><code>ctx</code> - some control object</dd>
</dl>
@@ -529,7 +532,8 @@ implements org.apache.bookkeeper.proto.BookkeeperInternalCallbacks.LedgerMetadat
<dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
<dd><code><a href="../../../../org/apache/bookkeeper/client/LedgerHandle.html#asyncAddEntry-byte:A-int-int-org.apache.bookkeeper.client.AsyncCallback.AddCallback-java.lang.Object-">asyncAddEntry</a></code> in class <code><a href="../../../../org/apache/bookkeeper/client/LedgerHandle.html" title="class in org.apache.bookkeeper.client">LedgerHandle</a></code></dd>
<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>data</code> - array of bytes to be written</dd>
+<dd><code>data</code> - array of bytes to be written
+ do not reuse the buffer, bk-client will release it appropriately</dd>
<dd><code>offset</code> - offset from which to take bytes from data</dd>
<dd><code>length</code> - number of bytes to take from data</dd>
<dd><code>cb</code> - object implementing callbackinterface</dd>
diff --git a/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/api/WriteAdvHandle.html b/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/api/WriteAdvHandle.html
index 715ee5f..654c324 100644
--- a/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/api/WriteAdvHandle.html
+++ b/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/api/WriteAdvHandle.html
@@ -248,7 +248,8 @@ extends <a href="../../../../../org/apache/bookkeeper/client/api/ReadHandle.html
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>entryId</code> - entryId to be added</dd>
-<dd><code>data</code> - array of bytes to be written</dd>
+<dd><code>data</code> - array of bytes to be written
+ do not reuse the buffer, bk-client will release it appropriately.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>an handle to the result, in case of success it will return the same value of param entryId.</dd>
</dl>
@@ -268,7 +269,8 @@ extends <a href="../../../../../org/apache/bookkeeper/client/api/ReadHandle.html
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>entryId</code> - entryId to be added</dd>
-<dd><code>data</code> - array of bytes to be written</dd>
+<dd><code>data</code> - array of bytes to be written
+ do not reuse the buffer, bk-client will release it appropriately.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>the same value of param entryId.</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
@@ -289,7 +291,8 @@ extends <a href="../../../../../org/apache/bookkeeper/client/api/ReadHandle.html
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>entryId</code> - entryId to be added.</dd>
-<dd><code>data</code> - array of bytes to be written</dd>
+<dd><code>data</code> - array of bytes to be written
+ do not reuse the buffer, bk-client will release it appropriately.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>an handle to the result, in case of success it will return the same value of param <code>entryId</code>.</dd>
</dl>
@@ -309,7 +312,8 @@ extends <a href="../../../../../org/apache/bookkeeper/client/api/ReadHandle.html
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>entryId</code> - entryId to be added.</dd>
-<dd><code>data</code> - array of bytes to be written</dd>
+<dd><code>data</code> - array of bytes to be written
+ do not reuse the buffer, bk-client will release it appropriately.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>same value of param <code>entryId</code>.</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
@@ -332,7 +336,8 @@ extends <a href="../../../../../org/apache/bookkeeper/client/api/ReadHandle.html
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>entryId</code> - entryId to be added.</dd>
-<dd><code>data</code> - array of bytes to be written</dd>
+<dd><code>data</code> - array of bytes to be written
+ do not reuse the buffer, bk-client will release it appropriately.</dd>
<dd><code>offset</code> - the offset of the bytes array</dd>
<dd><code>length</code> - the length to data to write</dd>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -356,7 +361,8 @@ extends <a href="../../../../../org/apache/bookkeeper/client/api/ReadHandle.html
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>entryId</code> - entryId to be added.</dd>
-<dd><code>data</code> - array of bytes to be written</dd>
+<dd><code>data</code> - array of bytes to be written
+ do not reuse the buffer, bk-client will release it appropriately.</dd>
<dd><code>offset</code> - the offset of the bytes array</dd>
<dd><code>length</code> - the length to data to write</dd>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -379,7 +385,8 @@ extends <a href="../../../../../org/apache/bookkeeper/client/api/ReadHandle.html
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>entryId</code> - entryId to be added</dd>
-<dd><code>data</code> - array of bytes to be written</dd>
+<dd><code>data</code> - array of bytes to be written
+ do not reuse the buffer, bk-client will release it appropriately.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>an handle to the result, in case of success it will return the same value of param entryId</dd>
</dl>
@@ -399,7 +406,8 @@ extends <a href="../../../../../org/apache/bookkeeper/client/api/ReadHandle.html
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>entryId</code> - entryId to be added</dd>
-<dd><code>data</code> - array of bytes to be written</dd>
+<dd><code>data</code> - array of bytes to be written
+ do not reuse the buffer, bk-client will release it appropriately.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>the same value of param entryId</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
diff --git a/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/api/WriteHandle.html b/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/api/WriteHandle.html
index 096ec2a..2008bc3 100644
--- a/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/api/WriteHandle.html
+++ b/content/docs/latest/api/javadoc/org/apache/bookkeeper/client/api/WriteHandle.html
@@ -256,7 +256,8 @@ extends <a href="../../../../../org/apache/bookkeeper/client/api/ReadHandle.html
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>data</code> - a bytebuf to be written. The bytebuf's reference count will be decremented by 1 after the
- completable future is returned</dd>
+ completable future is returned
+ do not reuse the buffer, bk-client will release it appropriately.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>an handle to the result, in case of success it will return the id of the newly appended entry</dd>
</dl>
@@ -275,7 +276,8 @@ extends <a href="../../../../../org/apache/bookkeeper/client/api/ReadHandle.html
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>data</code> - a bytebuf to be written. The bytebuf's reference count will be decremented by 1 after the
- call completes.</dd>
+ call completes.
+ do not reuse the buffer, bk-client will release it appropriately.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>the id of the newly appended entry</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
@@ -294,7 +296,8 @@ extends <a href="../../../../../org/apache/bookkeeper/client/api/ReadHandle.html
<div class="block">Add entry asynchronously to an open ledger.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>data</code> - array of bytes to be written</dd>
+<dd><code>data</code> - array of bytes to be written
+ do not reuse the buffer, bk-client will release it appropriately.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>an handle to the result, in case of success it will return the id of the newly appended entry</dd>
</dl>
@@ -312,7 +315,8 @@ extends <a href="../../../../../org/apache/bookkeeper/client/api/ReadHandle.html
<div class="block">Add entry synchronously to an open ledger.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>data</code> - array of bytes to be written</dd>
+<dd><code>data</code> - array of bytes to be written
+ do not reuse the buffer, bk-client will release it appropriately.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>the id of the newly appended entry</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
@@ -331,7 +335,8 @@ extends <a href="../../../../../org/apache/bookkeeper/client/api/ReadHandle.html
<div class="block">Add an entry asynchronously to an open ledger.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>data</code> - array of bytes to be written</dd>
+<dd><code>data</code> - array of bytes to be written
+ do not reuse the buffer, bk-client will release it appropriately.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>a completable future represents the add result, in case of success the future returns the entry id
of this newly appended entry</dd>
@@ -350,7 +355,8 @@ extends <a href="../../../../../org/apache/bookkeeper/client/api/ReadHandle.html
<div class="block">Add an entry synchronously to an open ledger.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>data</code> - array of bytes to be written</dd>
+<dd><code>data</code> - array of bytes to be written
+ do not reuse the buffer, bk-client will release it appropriately.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>the entry id of this newly appended entry</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
@@ -371,7 +377,8 @@ extends <a href="../../../../../org/apache/bookkeeper/client/api/ReadHandle.html
<div class="block">Add an entry asynchronously to an open ledger.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>data</code> - array of bytes to be written</dd>
+<dd><code>data</code> - array of bytes to be written
+ do not reuse the buffer, bk-client will release it appropriately.</dd>
<dd><code>offset</code> - the offset in the bytes array</dd>
<dd><code>length</code> - the length of the bytes to be appended</dd>
<dt><span class="returnLabel">Returns:</span></dt>
@@ -394,7 +401,8 @@ extends <a href="../../../../../org/apache/bookkeeper/client/api/ReadHandle.html
<div class="block">Add an entry synchronously to an open ledger.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>data</code> - array of bytes to be written</dd>
+<dd><code>data</code> - array of bytes to be written
+ do not reuse the buffer, bk-client will release it appropriately.</dd>
<dd><code>offset</code> - the offset in the bytes array</dd>
<dd><code>length</code> - the length of the bytes to be appended</dd>
<dt><span class="returnLabel">Returns:</span></dt>