com.github.mlk.queue.implementation

Interface ServerImplementation

public interface ServerImplementation

This should be implemented by MQ Clients. Notes: - Implementations should be thread safe. If they are not this MUST be clearly noted in the documentation. - Implementations should try and create the queue if it does not exist, where it can not this should be clearly noted in the documentation. - Implementations should utilize some form of connection pooling. Options for this may be exposed via the `Server`. - Exceptions should be wrapped with QueueException. - Implementations should not handle retries here.

Method Summary

Modifier and Type	Method and Description
void	close() Closes the connection to the server.
void	listen(String queue, com.google.common.base.Function<byte[],Boolean> action) Starts listening to the given queue.
void	publish(String queueName, byte[] message) Publishes a message to the given queue.

Method Detail

publish

void publish(String queueName,
             byte[] message)
      throws QueueException

Publishes a message to the given queue.

Parameters:

queueName - The queue to push the message to.

message - The message to be pushed.

Throws:

QueueException - Any issues sending this message.

listen

void listen(String queue,
            com.google.common.base.Function<byte[],Boolean> action)
     throws QueueException

Starts listening to the given queue.

Parameters:

queue - The queue to listen to.

action - The event handler.

Throws:

QueueException - Any issues registering this event handler.

close

void close()

Closes the connection to the server. This MUST NOT throw an exception. Implementations may log exceptions via the appropriate logging framework for the MQ. If the MQ does not specify a framework JUL should be used.