ServiceRegistry.java

package com.bazaarvoice.ostrich;

import java.io.Closeable;

/**
 * A registry for services.  The <code>ServiceRegistry</code> gives service providers a way to register their service
 * end points in order to make them available to consumers of the service across multiple JVMs.
 */
public interface ServiceRegistry extends Closeable {
    /**
     * Add an end point of a service to the service registry and make it available for discovery.
     *
     * @param endPoint The end point of the service to register.
     * @throws RuntimeException If there was a problem registering the end point.
     */
    void register(ServiceEndPoint endPoint);

    /**
     * Remove an end point of a service from the service registry.  This will make it no longer available
     * to be discovered.
     *
     * @param endPoint The end point of the service to unregister.
     * @throws RuntimeException If there was a problem de-registering the end point.
     */
    void unregister(ServiceEndPoint endPoint);
}