Package io.grpc

Interface NameResolver.Listener

  • All Known Implementing Classes:
    NameResolver.Listener2
    Enclosing class:
    NameResolver

    @ExperimentalApi("https://github.com/grpc/grpc-java/issues/1770")
    @ThreadSafe
    public static interface NameResolver.Listener
    Receives address updates.

    All methods are expected to return quickly.

    Since:
    1.0.0
    • Method Detail

      • onAddresses

        void onAddresses​(java.util.List<EquivalentAddressGroup> servers,
                         @ResolutionResultAttr
                         Attributes attributes)
        Handles updates on resolved addresses and attributes.

        Implementations will not modify the given servers.

        Parameters:
        servers - the resolved server addresses. An empty list will trigger onError(io.grpc.Status)
        attributes - extra information from naming system.
        Since:
        1.3.0
      • onError

        void onError​(Status error)
        Handles an error from the resolver. The listener is responsible for eventually invoking NameResolver.refresh() to re-attempt resolution.
        Parameters:
        error - a non-OK status
        Since:
        1.0.0