Package io.grpc.netty
Class UdsNameResolver
java.lang.Object
io.grpc.NameResolver
io.grpc.netty.UdsNameResolver
-
Nested Class Summary
Nested classes/interfaces inherited from class io.grpc.NameResolver
NameResolver.Args, NameResolver.ConfigOrError, NameResolver.Factory, NameResolver.Listener, NameResolver.Listener2, NameResolver.ResolutionResult, NameResolver.ResolutionResultAttr, NameResolver.ServiceConfigParser
-
Field Summary
Fields -
Constructor Summary
ConstructorsConstructorDescriptionUdsNameResolver
(String authority, String targetPath, NameResolver.Args args) -
Method Summary
Modifier and TypeMethodDescriptionReturns the authority used to authenticate connections to servers.void
refresh()
Re-resolve the name.private void
resolve()
void
shutdown()
Stops the resolution.void
start
(NameResolver.Listener2 listener) Starts the resolution.Methods inherited from class io.grpc.NameResolver
start
-
Field Details
-
listener
-
authority
-
-
Constructor Details
-
UdsNameResolver
UdsNameResolver(String authority, String targetPath, NameResolver.Args args)
-
-
Method Details
-
getServiceAuthority
Description copied from class:NameResolver
Returns the authority used to authenticate connections to servers. It must be from a trusted source, because if the authority is tampered with, RPCs may be sent to the attackers which may leak sensitive user data.An implementation must generate it without blocking, typically in line, and must keep it unchanged.
NameResolver
s created from the same factory with the same argument must return the same authority.- Specified by:
getServiceAuthority
in classNameResolver
-
start
Description copied from class:NameResolver
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 throughNameResolver.Listener2.onError(io.grpc.Status)
.An instance may not be started more than once, by any overload of this method, even after an intervening call to
NameResolver.shutdown()
.- Overrides:
start
in classNameResolver
- Parameters:
listener
- used to receive updates on the target
-
refresh
public void refresh()Description copied from class:NameResolver
Re-resolve the name.Can only be called after
NameResolver.start(io.grpc.NameResolver.Listener)
has been called.This is only a hint. Implementation takes it as a signal but may not start resolution immediately. It should never throw.
The default implementation is no-op.
- Overrides:
refresh
in classNameResolver
-
resolve
private void resolve() -
shutdown
public void shutdown()Description copied from class:NameResolver
Stops the resolution. Updates to the Listener will stop.- Specified by:
shutdown
in classNameResolver
-