org.xwiki.mail

Interface MailListener

@Role
@Unstable
public interface MailListener

Allows listening to Mail sending results.

Since:

6.1M2

Version:

$Id: 73b47d97c2c51f9a17f57250c836ab5a7bf9af3d $

Method Summary

Methods

Modifier and Type	Method and Description
MailStatusResult	getMailStatusResult()
void	onPrepareBegin(String batchId, Map<String,Object> parameters) Called when the preparation phase begins.
void	onPrepareEnd(Map<String,Object> parameters) Called when the preparation phase is finished.
void	onPrepareFatalError(Exception exception, Map<String,Object> parameters) Called when the preparation phase has encounter a fatal error.
void	onPrepareMessageError(javax.mail.internet.MimeMessage message, Exception e, Map<String,Object> parameters) Called when a mail has failed to be prepared.
void	onPrepareMessageSuccess(javax.mail.internet.MimeMessage message, Map<String,Object> parameters) Called when a mail has been prepared with success.
void	onSendMessageError(javax.mail.internet.MimeMessage message, Exception exception, Map<String,Object> parameters) Called when a mail has failed to be sent.
void	onSendMessageFatalError(String messageId, Exception exception, Map<String,Object> parameters) Called when a message could not be retrieve for sending.
void	onSendMessageSuccess(javax.mail.internet.MimeMessage message, Map<String,Object> parameters) Called when a mail has been sent successfully.

Method Detail

onPrepareBegin

void onPrepareBegin(String batchId,
                  Map<String,Object> parameters)

Called when the preparation phase begins.

Parameters:

batchId - identifier of the batch being prepared

parameters - some parameters specifying addition context data

Since:

7.1RC1

onPrepareMessageSuccess

void onPrepareMessageSuccess(javax.mail.internet.MimeMessage message,
                           Map<String,Object> parameters)

Called when a mail has been prepared with success.

Parameters:

message - the message to be sent

parameters - some parameters specifying addition context data

Since:

7.1RC1

onPrepareMessageError

void onPrepareMessageError(javax.mail.internet.MimeMessage message,
                         Exception e,
                         Map<String,Object> parameters)

Called when a mail has failed to be prepared.

Parameters:

message - the message that was tried to be prepared

e - the exception explaining why the message couldn't be sent

parameters - some parameters specifying addition context data

Since:

7.1RC1

onPrepareFatalError

void onPrepareFatalError(Exception exception,
                       Map<String,Object> parameters)

Called when the preparation phase has encounter a fatal error. The batch in progress has been incompletely processed.

Parameters:

exception - the exception explaining why messages couldn't be prepared

parameters - some parameters specifying addition context data

Since:

7.1RC1

onPrepareEnd

void onPrepareEnd(Map<String,Object> parameters)

Called when the preparation phase is finished.

Parameters:

parameters - some parameters specifying addition context data

Since:

7.1RC1

onSendMessageSuccess

void onSendMessageSuccess(javax.mail.internet.MimeMessage message,
                        Map<String,Object> parameters)

Called when a mail has been sent successfully.

Parameters:

message - the message sent

parameters - some parameters specifying addition context data

Since:

7.1RC1

onSendMessageError

void onSendMessageError(javax.mail.internet.MimeMessage message,
                      Exception exception,
                      Map<String,Object> parameters)

Called when a mail has failed to be sent.

Parameters:

message - the message that was tried to be sent

exception - the exception explaining why the message couldn't be sent

parameters - some parameters specifying addition context data

Since:

7.1RC1

onSendMessageFatalError

void onSendMessageFatalError(String messageId,
                           Exception exception,
                           Map<String,Object> parameters)

Called when a message could not be retrieve for sending.

Parameters:

messageId - the message identifier that was tried to be load for sending

exception - the exception explaining why the message couldn't be sent

parameters - some parameters specifying addition context data

Since:

7.1RC1

getMailStatusResult

MailStatusResult getMailStatusResult()

Returns:

the status of all the mails from the batch (whether they were sent successfully, failed to be sent, ready to be sent but not sent yet, etc). Note that since mails can be sent asynchronously it's possible that when calling this method, not all mails have been processed yet for sending and thus users or this method should call MailStatusResult.waitTillProcessed(long) or MailStatusResult.isProcessed() to ensure that all mails have been processed

Since:

6.4M3