doc: name resolver start() should not throw (#9589)

This commit is contained in:
yifeizhuang 2022-10-05 16:22:30 -07:00 committed by GitHub
parent df0a4bdc1b
commit cff8bd8d87
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 6 additions and 2 deletions

View File

@ -73,7 +73,9 @@ public abstract class NameResolver {
public abstract String getServiceAuthority(); public abstract String getServiceAuthority();
/** /**
* Starts the resolution. * Starts the resolution. The method is not supposed to throw any exceptions. That might cause the
* Channel that the name resolver is serving to crash. Errors should be propagated
* through {@link Listener#onError}.
* *
* @param listener used to receive updates on the target * @param listener used to receive updates on the target
* @since 1.0.0 * @since 1.0.0
@ -97,7 +99,9 @@ public abstract class NameResolver {
} }
/** /**
* Starts the resolution. * Starts the resolution. The method is not supposed to throw any exceptions. That might cause the
* Channel that the name resolver is serving to crash. Errors should be propagated
* through {@link Listener2#onError}.
* *
* @param listener used to receive updates on the target * @param listener used to receive updates on the target
* @since 1.21.0 * @since 1.21.0