(kafka) branch trunk updated: KAFKA-19772 enhance the documentation for `Node#isFanced` (#20689)

[chia7712]

This is an automated email from the ASF dual-hosted git repository.

chia7712 pushed a commit to branch trunk
in repository https://gitbox.apache.org/repos/asf/kafka.git


The following commit(s) were added to refs/heads/trunk by this push:
     new f7aaf46a141 KAFKA-19772 enhance the documentation for `Node#isFanced` 
(#20689)
f7aaf46a141 is described below

commit f7aaf46a14144c58f4928d5779e36218f1d93e59
Author: Hong-Yi Chen <apala...@gmail.com>
AuthorDate: Sun Oct 12 23:54:47 2025 +0800

    KAFKA-19772 enhance the documentation for `Node#isFanced` (#20689)
    
    Clarify the Javadoc for `Node#isFenced` to align with KIP-1073, which
    introduced the “fenced” field in `DescribeCluster` for brokers. The
    “fenced” flag applies only to broker nodes returned by
    `DescribeCluster`. For controller quorum nodes, it doesn’t apply and is
    always `false`. This clarifies that not every node has a meaningful
    fenced state.
    
    Reviewers: TaiJuWu <tjwu1...@gmail.com>, Chia-Ping Tsai
     <chia7...@gmail.com>
---
 clients/src/main/java/org/apache/kafka/common/Node.java | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/clients/src/main/java/org/apache/kafka/common/Node.java 
b/clients/src/main/java/org/apache/kafka/common/Node.java
index e47d941e0f9..9467f8b2456 100644
--- a/clients/src/main/java/org/apache/kafka/common/Node.java
+++ b/clients/src/main/java/org/apache/kafka/common/Node.java
@@ -114,7 +114,10 @@ public class Node {
     }
 
     /**
-     * Whether if this node is fenced
+     * Returns whether this node is fenced.
+     * <p>
+     * This applies to broker nodes only. For controller quorum nodes, this 
field
+     * is not relevant and is defined to be {@code false}.
      */
     public boolean isFenced() {
         return isFenced;