com.bazaarvoice.ostrich.HostDiscovery Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of ostrich-core Show documentation

Core classes that form Ostrich

There is a newer version: 2.1.0

package com.bazaarvoice.ostrich;

import java.io.Closeable;

/**
 * The HostDiscovery class is used to encapsulate the strategy that provides a set of hosts for use.
 * Users of this class shouldn't cache the results of discovery as subclasses can choose to change the set of available
 * hosts based on some external mechanism (ex. using ZooKeeper).
 */
public interface HostDiscovery extends Closeable {
    /**
     * Retrieve the available hosts.
     *
     * @return The available hosts.
     */
    Iterable getHosts();

    /**
     * Add an end point listener.
     *
     * @param listener The end point listener to add.
     */
    void addListener(EndPointListener listener);

    /**
     * Remove an end point listener.
     *
     * @param listener The end point listener to remove.
     */
    void removeListener(EndPointListener listener);

    /** Listener interface that is notified when end points are added and removed. */
    interface EndPointListener {
        void onEndPointAdded(ServiceEndPoint endPoint);
        void onEndPointRemoved(ServiceEndPoint endPoint);
    }
}