Distributor.java

package com.dhemery.publishing;

/**
 * Distributes publications to subscribers.
 * The nature of the publications
 * and the nature of the delivery mechanism
 * are left to implementors.
 * @see Publisher
 */
public interface Distributor {
    /**
     * Register the subscriber to receive publications from this distributor
     */
    void subscribe(Object subscriber);

    /**
     * Register the subscribers to receive publications from this distributor
     */
    void subscribe(Object subscriber1, Object... others);


    /**
     * Remove the subscriber from this distributor's recipients
     */
    void unsubscribe(Object subscriber);

    /**
     * Remove the subscribers from this distributor's recipients
     */
    void unsubscribe(Object subscriber1, Object... others);
}