Interface Informable<T>

    • Method Detail

      • withLimit

        Informable<T> withLimit​(Long limit)
        Set the limit to the number of resources to list at one time. This means that longer lists will take multiple requests to fetch.

        If the list fails to complete it will be re-attempted with this limit, rather than falling back to the full list. You should ensure that your handlers are either async or fast acting to prevent long delays in list processing that may cause results to expire before reaching the end of the list.

        WARNING As noted in the go client: "paginated lists are always served directly from etcd, which is significantly less efficient and may lead to serious performance and scalability problems."

        Parameters:
        limit - of a items in a list fetch
        Returns:
        the current Informable
      • inform

        default SharedIndexInformer<T> inform()
        Similar to a Watch, but will attempt to handle failures after successfully started. and provides a store of all the current resources.

        This returned informer will not support resync.

        This call will be blocking for the initial list and watch.

        You are expected to call stop to terminate the underlying Watch.

        The processing of handler events will be in the client's Executor.

        Returns:
        a running SharedIndexInformer
      • inform

        default SharedIndexInformer<T> inform​(ResourceEventHandler<? super T> handler)
        Similar to a Watch, but will attempt to handle failures after successfully started. and provides a store of all the current resources.

        This returned informer will not support resync.

        This call will be blocking for the initial list and watch.

        You are expected to call stop to terminate the underlying Watch.

        The processing of handler events will be in the client's Executor.

        Parameters:
        handler - to notify
        Returns:
        a running SharedIndexInformer
      • inform

        SharedIndexInformer<T> inform​(ResourceEventHandler<? super T> handler,
                                      long resync)
        Similar to a Watch, but will attempt to handle failures after successfully started. and provides a store of all the current resources.

        This call will be blocking for the initial list and watch.

        You are expected to call stop to terminate the underlying Watch.

        The processing of handler events will be in the client's Executor.

        Parameters:
        handler - to notify
        resync - the resync period or 0 for no resync
        Returns:
        a running SharedIndexInformer
      • runnableInformer

        SharedIndexInformer<T> runnableInformer​(long resync)
        Similar to a Watch, but will attempt to handle failures after successfully started. and provides a store of all the current resources.

        You are expected to call stop to terminate the underlying Watch.

        Parameters:
        resync - the resync period or 0 for no resync
        Returns:
        a non-running SharedIndexInformer
      • informOnCondition

        CompletableFuture<List<T>> informOnCondition​(Predicate<List<T>> condition)
        Return a Future when the list at this context satisfies the given Predicate. The predicate will be tested against the state of the underlying informer store on every event. The returned future should be cancelled by the caller if not waiting for completion to close the underlying informer

        The processing of events will be in the IO thread, blocking operations should be avoided.

        Parameters:
        condition - the Predicate to test
        Returns:
        a CompletableFuture of the list of items after the condition is met