org.duracloud.common.queue.rabbitmq

Class RabbitMQTaskQueue

java.lang.Object

org.duracloud.common.queue.rabbitmq.RabbitMQTaskQueue

All Implemented Interfaces:

TaskQueue

public class RabbitMQTaskQueue
extends Object
implements TaskQueue

RabbitMQ implementation of the TaskQueue emulates the functionality of a queue.

Author:

Shibo Liu Date: 07/03/19

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RabbitMQTaskQueue.MsgProp

Constructor Summary

Constructors

Constructor and Description
RabbitMQTaskQueue(com.rabbitmq.client.Connection conn, String exchange, String queueName)
RabbitMQTaskQueue(String host, Integer port, String vhost, String exchange, String username, String password, String queueName) Creates RabbitMQ task queue, a RabbitMQ server is needed and a DIRECT exchange must be created and bound to the queue name provided (routing key must be the same as the queue name)

Method Summary

Modifier and Type	Method and Description
void	deleteTask(Task task) Deletes a task from the queue.
void	deleteTasks(Set<Task> tasks) Deletes a set of tasks
void	extendVisibilityTimeout(Task task) RabbitMQ does not have this feature, messages would not be visible until rejected and requeued
String	getName() A name identifying the queue used for logging and analysis purposes.
protected Task	marshallTask(byte[] msgBody, long deliveryTag, String routingKey, String exchange)
void	put(Set<Task> tasks) puts multiple tasks on the queue using batch puts if the queue implementation supports batch puts
void	put(Task... tasks) Convenience method that calls put(Set)
void	put(Task task) puts a task on the queue
void	requeue(Task task) Requeues the task by deleting the task, incrementing the "attempts" counter, and re-adding back to the queue.
Integer	size()
Integer	sizeIncludingInvisibleAndDelayed()
Task	take() Blocks until a task is available
Set<Task>	take(int maxTasks) Take a max of specified number of tasks.
protected String	unmarshallTask(Task task)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RabbitMQTaskQueue

public RabbitMQTaskQueue(String host,
                         Integer port,
                         String vhost,
                         String exchange,
                         String username,
                         String password,
                         String queueName)

Creates RabbitMQ task queue, a RabbitMQ server is needed and a DIRECT exchange must be created and bound to the queue name provided (routing key must be the same as the queue name)

RabbitMQTaskQueue

public RabbitMQTaskQueue(com.rabbitmq.client.Connection conn,
                         String exchange,
                         String queueName)

Method Detail

getName

public String getName()

Description copied from interface: TaskQueue

A name identifying the queue used for logging and analysis purposes.

Specified by:

getName in interface TaskQueue

Returns:

marshallTask

protected Task marshallTask(byte[] msgBody,
                            long deliveryTag,
                            String routingKey,
                            String exchange)

unmarshallTask

protected String unmarshallTask(Task task)

put

public void put(Task task)

Description copied from interface: TaskQueue

puts a task on the queue

Specified by:

put in interface TaskQueue

put

public void put(Task... tasks)

Convenience method that calls put(Set)

Specified by:

put in interface TaskQueue

Parameters:

tasks -

put

public void put(Set<Task> tasks)

Description copied from interface: TaskQueue

puts multiple tasks on the queue using batch puts if the queue implementation supports batch puts

Specified by:

put in interface TaskQueue

take

public Set<Task> take(int maxTasks)
               throws TimeoutException

Description copied from interface: TaskQueue

Take a max of specified number of tasks. Blocks until at least one task is available.

Specified by:

take in interface TaskQueue

Parameters:

maxTasks - to take from queue. Must be between 1 and 10 inclusive.

Returns:

Throws:

TimeoutException

take

public Task take()
          throws TimeoutException

Description copied from interface: TaskQueue

Blocks until a task is available

Specified by:

take in interface TaskQueue

Returns:

Throws:

TimeoutException

extendVisibilityTimeout

public void extendVisibilityTimeout(Task task)
                             throws TaskNotFoundException

RabbitMQ does not have this feature, messages would not be visible until rejected and requeued

Specified by:

extendVisibilityTimeout in interface TaskQueue

Throws:

TaskNotFoundException

deleteTask

public void deleteTask(Task task)
                throws TaskNotFoundException

Description copied from interface: TaskQueue

Deletes a task from the queue.

Specified by:

deleteTask in interface TaskQueue

Throws:

TaskNotFoundException

deleteTasks

public void deleteTasks(Set<Task> tasks)
                 throws TaskException

Description copied from interface: TaskQueue

Deletes a set of tasks

Specified by:

deleteTasks in interface TaskQueue

Throws:

TaskException

requeue

public void requeue(Task task)

Description copied from interface: TaskQueue

Requeues the task by deleting the task, incrementing the "attempts" counter, and re-adding back to the queue. Any subsequent calls on the requeued task via the task queue should fail due to the task not being found.

Specified by:

requeue in interface TaskQueue

size

public Integer size()

Specified by:

size in interface TaskQueue

Returns:

The approximate number of elements in this queue (does not include invisible and delayed tasks).

sizeIncludingInvisibleAndDelayed

public Integer sizeIncludingInvisibleAndDelayed()

Specified by:

sizeIncludingInvisibleAndDelayed in interface TaskQueue

Returns:

The approximate number of elements in this queue including all items that are visible (available for takes), invisible (in process - not yet completed), and delayed (pending addition to the queue).