org.apache.sling.distribution.queue.impl.simple

Class SimpleDistributionQueue

java.lang.Object

org.apache.sling.distribution.queue.impl.simple.SimpleDistributionQueue

All Implemented Interfaces:

DistributionQueue

public class SimpleDistributionQueue
extends Object
implements DistributionQueue

A simple implementation of a DistributionQueue.

Note that, at the moment, this is a transient in memory queue not persisted on the repository and therefore not usable for production. Note: potentially the Queue could contain the ordered package ids, with a sidecar map id->item; that way removal could be faster.

Constructor Summary

Constructors

Constructor and Description
SimpleDistributionQueue(String agentName, String name)

Method Summary

Modifier and Type	Method and Description
DistributionQueueEntry	add(DistributionQueueItem item) add a distribution item to this queue
DistributionQueueEntry	getHead() get the first item (in a FIFO strategy, the next to be processed) from the queue
DistributionQueueEntry	getItem(String id) gets an item from the queue by specifying its id
Iterable<DistributionQueueEntry>	getItems(int skip, int limit) get all the items in the queue
String	getName() get this queue name
DistributionQueueStatus	getStatus() get the status of the queue
DistributionQueueType	getType() get the type of this queue
DistributionQueueEntry	remove(String id) remove an item from the queue by specifying its id
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

SimpleDistributionQueue

public SimpleDistributionQueue(String agentName,
                               String name)

Method Detail

getName

@Nonnull
public String getName()

Description copied from interface: DistributionQueue

get this queue name

Specified by:

getName in interface DistributionQueue

Returns:

the queue name

add

public DistributionQueueEntry add(@Nonnull
                                  DistributionQueueItem item)

Description copied from interface: DistributionQueue

add a distribution item to this queue

Specified by:

add in interface DistributionQueue

Parameters:

item - a distribution item, typically representing a DistributionPackage to distribute

Returns:

the queue entry created for this item or noll if none is created

getHead

@CheckForNull
public DistributionQueueEntry getHead()

Description copied from interface: DistributionQueue

get the first item (in a FIFO strategy, the next to be processed) from the queue

Specified by:

getHead in interface DistributionQueue

Returns:

the first item into the queue or null if the queue is empty

getStatus

@Nonnull
public DistributionQueueStatus getStatus()

Description copied from interface: DistributionQueue

get the status of the queue

Specified by:

getStatus in interface DistributionQueue

Returns:

the queue status

getType

public DistributionQueueType getType()

Description copied from interface: DistributionQueue

get the type of this queue

Specified by:

getType in interface DistributionQueue

Returns:

the type

getItems

@Nonnull
public Iterable<DistributionQueueEntry> getItems(int skip,
                                                          int limit)

Description copied from interface: DistributionQueue

get all the items in the queue

Specified by:

getItems in interface DistributionQueue

Parameters:

skip - the number of items to skip

limit - the maximum number of items to return. use -1 to return all items.

Returns:

a Iterable of DistributionQueueItems

getItem

@CheckForNull
public DistributionQueueEntry getItem(@Nonnull
                                                    String id)

Description copied from interface: DistributionQueue

gets an item from the queue by specifying its id

Specified by:

getItem in interface DistributionQueue

Parameters:

id - the id of the item as returned by DistributionQueueItem.getPackageId()

Returns:

the item, or null if the item with the given id doesn't exist

remove

@CheckForNull
public DistributionQueueEntry remove(@Nonnull
                                                   String id)

Description copied from interface: DistributionQueue

remove an item from the queue by specifying its id

Specified by:

remove in interface DistributionQueue

Parameters:

id - the id the item as returned by DistributionQueueItem.getPackageId()

Returns:

the removed item, or null if the item with the given id doesn't exist

toString

public String toString()

Overrides:

toString in class Object