com.geneea.celery.spi.Broker Maven / Gradle / Ivy

Go to download
package com.geneea.celery.spi;

import java.io.IOException;

/**
 * Internal, used by {@link com.geneea.celery.Celery} and implemented by broker providers.
 *
 * 
 *     Broker delivers messages to the workers.
 * 
 */
public interface Broker {

    /**
     * The client should declare a queue it intends to use. This is a performance optimization so that the broker
     * doesn't need to check the queue exists every time a message is sent.
     *
     * @param name queue name
     * @throws IOException in case of a connection problem
     */
    void declareQueue(String name) throws IOException;

    /**
     * @return message that can be constructed and later sent
     */
    Message newMessage();
}