deprecate canHandleEmptyAddressListFromNameResolution

Author: shivaspeaks

api/src/main/java/io/grpc/LoadBalancer.java

@@ -423,7 +423,18 @@ public void handleSubchannelState(
    *
    * <p>This method should always return a constant value.  It's not specified when this will be
    * called.
+   * 
+   * <p>
+   * Note that this method is only called when the deprecated
+   * {@code handleResolvedAddresses()}
+   * is overwritten.
+   *
+   * @deprecated Instead of overwriting this and {@code handleResolvedAddresses()}, only
+   *     overwrite {@code acceptResolvedAddresses()} which indicates if the addresses provided
+   *     by the name resolver are acceptable with the {@code boolean} return value.
    */
+  @Deprecated
+  @SuppressWarnings("InlineMeSuggester")
   public boolean canHandleEmptyAddressListFromNameResolution() {
     return false;
   }

grpclb/src/main/java/io/grpc/grpclb/GrpclbLoadBalancer.java

@@ -154,6 +154,8 @@ public void handleNameResolutionError(Status error) {
   }
 
   @Override
+  @Deprecated
+  @SuppressWarnings("InlineMeSuggester")
   public boolean canHandleEmptyAddressListFromNameResolution() {
     return true;
   }

util/src/main/java/io/grpc/util/ForwardingLoadBalancer.java

@@ -63,6 +63,8 @@ public void shutdown() {
   }
 
   @Override
+  @Deprecated
+  @SuppressWarnings("InlineMeSuggester")
   public boolean canHandleEmptyAddressListFromNameResolution() {
     return delegate().canHandleEmptyAddressListFromNameResolution();
   }

util/src/test/java/io/grpc/util/GracefulSwitchLoadBalancerTest.java

@@ -102,6 +102,7 @@ public void handleSubchannelState_shouldThrow() {
   }
 
   @Test
+  @Deprecated
   public void canHandleEmptyAddressListFromNameResolutionForwardedToLatestPolicy() {
     assertIsOk(gracefulSwitchLb.acceptResolvedAddresses(addressesBuilder()
         .setLoadBalancingPolicyConfig(createConfig(lbPolicies[0], new Object()))

xds/src/main/java/io/grpc/xds/WeightedTargetLoadBalancer.java

@@ -128,6 +128,8 @@ public void handleNameResolutionError(Status error) {
   }
 
   @Override
+  @Deprecated
+  @SuppressWarnings("InlineMeSuggester")
   public boolean canHandleEmptyAddressListFromNameResolution() {
     return true;
   }