From 03d85ee53e3ddaafc6a0cb4c66ac8276538f21c0 Mon Sep 17 00:00:00 2001 From: ZHANG Dapeng Date: Tue, 24 Jul 2018 14:01:24 -0700 Subject: [PATCH] doc: clarify channel state API unimplemented until v1.6.1 Resolves #4624 --- core/src/main/java/io/grpc/ManagedChannel.java | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/core/src/main/java/io/grpc/ManagedChannel.java b/core/src/main/java/io/grpc/ManagedChannel.java index 38085dc27f..7875fdb57f 100644 --- a/core/src/main/java/io/grpc/ManagedChannel.java +++ b/core/src/main/java/io/grpc/ManagedChannel.java @@ -73,6 +73,8 @@ public abstract class ManagedChannel extends Channel { /** * Gets the current connectivity state. Note the result may soon become outdated. * + *

Note that the core library did not provide an implementation of this method until v1.6.1. + * * @param requestConnection if {@code true}, the channel will try to make a connection if it is * currently IDLE * @throws UnsupportedOperationException if not supported by implementation @@ -96,6 +98,8 @@ public abstract class ManagedChannel extends Channel { * states may not have been observed. The API is only reliable in tracking the current * state. * + *

Note that the core library did not provide an implementation of this method until v1.6.1. + * * @param source the assumed current state, typically just returned by {@link #getState} * @param callback the one-off callback * @throws UnsupportedOperationException if not supported by implementation