add comments.

apache · Jan 30, 2024 · ec91972 · ec91972
1 parent 09dc215
commit ec91972
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/bookkeeper-server/src/main/java/org/apache/bookkeeper/client/LedgerHandle.java b/bookkeeper-server/src/main/java/org/apache/bookkeeper/client/LedgerHandle.java
@@ -780,6 +780,8 @@ public void asyncBatchReadEntries(long startEntry, int maxCount, long maxSize, b
             asyncBatchReadEntriesInternal(startEntry, maxCount, maxSize, new ReadCallback() {
                 @Override
                 public void readComplete(int rc, LedgerHandle lh, Enumeration<LedgerEntry> seq, Object ctx) {
+                    //If the bookie server not support the batch read request, the bookie server will close the
+                    // connection, then get the BookieHandleNotAvailableException.
                     if (rc == Code.BookieHandleNotAvailableException) {
                         notSupportBatch = true;
                         if (failbackToSingleRead) {
@@ -870,6 +872,8 @@ public void asyncBatchReadUnconfirmedEntries(long startEntry, int maxCount, long
             asyncBatchReadEntriesInternal(startEntry, maxCount, maxSize, new ReadCallback() {
                 @Override
                 public void readComplete(int rc, LedgerHandle lh, Enumeration<LedgerEntry> seq, Object ctx) {
+                    //If the bookie server not support the batch read request, the bookie server will close the
+                    // connection, then get the BookieHandleNotAvailableException.
                     if (rc == Code.BookieHandleNotAvailableException) {
                         notSupportBatch = true;
                         if (failbackToSingleRead) {
@@ -951,6 +955,8 @@ public CompletableFuture<LedgerEntries> batchReadAsync(long startEntry, int maxC
         batchReadEntriesInternalAsync(startEntry, maxCount, maxSize, false)
                 .whenComplete((entries, ex) -> {
                     if (ex != null) {
+                        //If the bookie server not support the batch read request, the bookie server will close the
+                        // connection, then get the BookieHandleNotAvailableException.
                         if (ex instanceof BKException.BKBookieHandleNotAvailableException) {
                             notSupportBatch = true;
                             if (failbackToSingleRead) {