MailQueue (Atlassian Mail 6.0.4 API)

All Known Implementing Classes:

MailQueueImpl
```
public interface MailQueue
```
The MailQueue is used to asynchronously send mail from within applications.

It is populated with MailQueueItem objects, which know how to send themselves.

The queue also keeps track of which messages have attempted to be send, and were erroring.

Method Summary

All Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`void`	`addErrorItem(MailQueueItem item)` Add an error item
`void`	`addItem(MailQueueItem item)` Add a new item to the mail queue.
`void`	`emptyErrorQueue()` Empty the error queue (discard these messages)
`int`	`errorSize()`
`Queue<MailQueueItem>`	`getErrorQueue()` Get access to the messages in the error queue.
`MailQueueItem`	`getItemBeingSent()` Retrieve the item currently being sent.
`default Timestamp`	`getLastSendingAttempt()`
`Queue<MailQueueItem>`	`getQueue()` Get access to the messages in the mail queue.
`Timestamp`	`getSendingStarted()`
`boolean`	`isSending()`
`void`	`resendErrorQueue()` Send all messages in the error queue.
`void`	`sendBuffer()` Send all the messages in the queue.
`void`	`sendBufferBlocking()` Send all the messages in the queue.
`int`	`size()`
`void`	`unstickQueue()` If the queue is sending and has 'stuck' on an item, this lets the queue proceed.

- Method Detail
  - sendBuffer
```
void sendBuffer()
```
    Send all the messages in the queue.
  - sendBufferBlocking
```
void sendBufferBlocking()
```
    Send all the messages in the queue. Block until all other sendBuffer() operations are finished.
  - size
```
int size()
```
    Returns:
    
    The number of messages in the queue.
  - errorSize
```
int errorSize()
```
    Returns:
    
    The number of erroring messages in the queue.
  - addItem
```
void addItem(MailQueueItem item)
```
    Add a new item to the mail queue.
    
    Parameters:
    
    item - The item to be added to the queue.
  - addErrorItem
```
void addErrorItem(MailQueueItem item)
```
    Add an error item
    
    Parameters:
    
    item - a mail queue item to append to the "errorItems" list
  - getQueue
```
Queue<MailQueueItem> getQueue()
```
    Get access to the messages in the mail queue.
    
    Note: you should synchronize on access to this queue.
    
    Returns:
    
    a queue of MailQueueItem objects representing messages in the mail queue
  - getErrorQueue
```
Queue<MailQueueItem> getErrorQueue()
```
    Get access to the messages in the error queue.
    
    Note: you should synchronize on access to this queue.
    
    Returns:
    
    a queue of MailQueueItem objects representing messages in the error queue
  - isSending
```
boolean isSending()
```
    Returns:
    
    Whether or not the queue is currently sending.
  - getSendingStarted
```
Timestamp getSendingStarted()
```
    Returns:
    
    The date/time the queue started sending, null if the queue is not sending
  - getLastSendingAttempt
```
default Timestamp getLastSendingAttempt()
```
    Returns:
    
    The date/time the queue attempted to send the last email in the current batch, null if no email was sent yet
  - emptyErrorQueue
```
void emptyErrorQueue()
```
    Empty the error queue (discard these messages)
  - resendErrorQueue
```
void resendErrorQueue()
```
    Send all messages in the error queue.
  - getItemBeingSent
```
MailQueueItem getItemBeingSent()
```
    Retrieve the item currently being sent.
    
    Returns:
    
    the MailQueueItem object representing a message currently being sent.
  - unstickQueue
```
void unstickQueue()
```
    If the queue is sending and has 'stuck' on an item, this lets the queue proceed. Only relevant for synchronous queues.

Interface MailQueue

Method Summary

Method Detail

sendBuffer

sendBufferBlocking

size

errorSize

addItem

addErrorItem

getQueue

getErrorQueue

isSending

getSendingStarted

getLastSendingAttempt

emptyErrorQueue

resendErrorQueue

getItemBeingSent

unstickQueue