Clarify ConnectionObserver callbacks contract (#2838)

apple · Feb 17, 2024 · de5278d · de5278d
1 parent 897f3c6
commit de5278d
Showing 1 changed file with 2 additions and 1 deletion.
diff --git a/servicetalk-transport-api/src/main/java/io/servicetalk/transport/api/ConnectionObserver.java b/servicetalk-transport-api/src/main/java/io/servicetalk/transport/api/ConnectionObserver.java
@@ -24,7 +24,8 @@
  * An observer interface that provides visibility into events associated with a network connection.
  * <p>
  * Either {@link #connectionClosed()} or {@link #connectionClosed(Throwable)} will be invoked to signal when connection
- * is closed.
+ * is closed. The "closed" event is considered terminal and other callbacks after that can be safely discarded because
+ * nothing happens on the network interface after closure.
  */
 public interface ConnectionObserver {