org.nlab.smtp.transport.connection

Class DefaultClosableSmtpConnection

java.lang.Object

org.nlab.smtp.transport.connection.DefaultClosableSmtpConnection

All Implemented Interfaces:

AutoCloseable, ObjectPoolAware, ClosableSmtpConnection

public class DefaultClosableSmtpConnection
extends Object
implements ClosableSmtpConnection, ObjectPoolAware

Created by nlabrot on 30/04/15.

Field Summary

Fields inherited from interface org.nlab.smtp.transport.connection.ClosableSmtpConnection

HEADER_MESSAGE_ID

Constructor Summary

Constructors

Constructor and Description
DefaultClosableSmtpConnection(javax.mail.Transport delegate, boolean invalidateConnectionOnException)

Method Summary

Modifier and Type	Method and Description
void	addTransportListener(javax.mail.event.TransportListener l) Add a new TransportListener
void	clearListeners() Clear the list of TransportListener
void	close()
javax.mail.Transport	getDelegate()
SmtpConnectionPool	getObjectPool()
javax.mail.Session	getSession()
void	invalidate() Marks this pooled object to be invalid such that it is not returned in the pool when closed.
boolean	isConnected() Test if the current connection is connected
void	removeTransportListener(javax.mail.event.TransportListener l) Remove the provided TransportListener
void	sendMessage(javax.mail.internet.MimeMessage msg) Send a message.
void	sendMessage(javax.mail.internet.MimeMessage msg, javax.mail.Address[] recipients) Send a message to a list of recipients
void	sendMessages(javax.mail.internet.MimeMessage... msgs) Send the given array of JavaMail MIME messages in batch.
void	setInvalidateConnectionOnClose(boolean invalidateConnectionOnClose) Allows setting the invalid flag to true or false
void	setObjectPool(SmtpConnectionPool objectPool) Called after the object has been borrowed on the pool to set the pool on the object.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultClosableSmtpConnection

public DefaultClosableSmtpConnection(javax.mail.Transport delegate,
                                     boolean invalidateConnectionOnException)

Method Detail

invalidate

public void invalidate()

Description copied from interface: ClosableSmtpConnection

Marks this pooled object to be invalid such that it is not returned in the pool when closed. This is equivalent to setInvalid(true).

Specified by:

invalidate in interface ClosableSmtpConnection

setInvalidateConnectionOnClose

public void setInvalidateConnectionOnClose(boolean invalidateConnectionOnClose)

Description copied from interface: ClosableSmtpConnection

Allows setting the invalid flag to true or false

Specified by:

setInvalidateConnectionOnClose in interface ClosableSmtpConnection

Parameters:

invalidateConnectionOnClose - true if the object should not be returned in the pool when closed.

sendMessage

public void sendMessage(javax.mail.internet.MimeMessage msg,
                        javax.mail.Address[] recipients)
                 throws javax.mail.MessagingException

Description copied from interface: ClosableSmtpConnection

Send a message to a list of recipients

Specified by:

sendMessage in interface ClosableSmtpConnection

Throws:

javax.mail.MessagingException

sendMessage

public void sendMessage(javax.mail.internet.MimeMessage msg)
                 throws javax.mail.MessagingException

Description copied from interface: ClosableSmtpConnection

Send a message. The list of recipients are taken from MimeMessage.getAllRecipients()

Specified by:

sendMessage in interface ClosableSmtpConnection

Parameters:

msg - MimeMessage

Throws:

javax.mail.MessagingException

sendMessages

public void sendMessages(javax.mail.internet.MimeMessage... msgs)
                  throws MailSendException

Description copied from interface: ClosableSmtpConnection

Send the given array of JavaMail MIME messages in batch. Do not stop the batch when a message could not be sent MailSendException.getFailedMessages() will contain the failed messages

Specified by:

sendMessages in interface ClosableSmtpConnection

Parameters:

msgs - Array of MimeMessage

Throws:

MailSendException - in case of failure when sending a message

addTransportListener

public void addTransportListener(javax.mail.event.TransportListener l)

Description copied from interface: ClosableSmtpConnection

Add a new TransportListener

Specified by:

addTransportListener in interface ClosableSmtpConnection

removeTransportListener

public void removeTransportListener(javax.mail.event.TransportListener l)

Description copied from interface: ClosableSmtpConnection

Remove the provided TransportListener

Specified by:

removeTransportListener in interface ClosableSmtpConnection

clearListeners

public void clearListeners()

Description copied from interface: ClosableSmtpConnection

Clear the list of TransportListener

Specified by:

clearListeners in interface ClosableSmtpConnection

isConnected

public boolean isConnected()

Description copied from interface: ClosableSmtpConnection

Test if the current connection is connected

Specified by:

isConnected in interface ClosableSmtpConnection

Returns:

close

public void close()

Specified by:

close in interface AutoCloseable

setObjectPool

public void setObjectPool(SmtpConnectionPool objectPool)

Description copied from interface: ObjectPoolAware

Called after the object has been borrowed on the pool to set the pool on the object.

Specified by:

setObjectPool in interface ObjectPoolAware

getObjectPool

public SmtpConnectionPool getObjectPool()

Specified by:

getObjectPool in interface ObjectPoolAware

getDelegate

public javax.mail.Transport getDelegate()

Specified by:

getDelegate in interface ClosableSmtpConnection

Returns:

the Transport associated to this connection

getSession

public javax.mail.Session getSession()

Specified by:

getSession in interface ClosableSmtpConnection

Returns:

the Session