org.wisdom.mailer

Class Smtp

java.lang.Object

org.wisdom.mailer.Smtp

All Implemented Interfaces:

org.ow2.chameleon.mail.MailSenderService

public class Smtp
extends java.lang.Object
implements org.ow2.chameleon.mail.MailSenderService

A implementation of the Mail Sender Service using SMTP. This implementation can delegate to a mock version, just printing the message on the console but not actually sending the mail. Unlike the original chameleon service, this service does not use the Event Admin.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Smtp.Connection Type of connections.

Field Summary

Fields

Modifier and Type	Field and Description
private static java.lang.String	CONFAUTH
private static java.lang.String	CONFHOST
(package private) org.wisdom.api.configuration.ApplicationConfiguration	configuration
private static java.lang.String	CONFPORT
protected Smtp.Connection	connection
private boolean	debug Enables / Disabled debugging.
static java.lang.String	DEFAULT_FROM
protected java.lang.String	from The mail address of the sender.
protected java.lang.String	fromName An optional name (for the sender).
protected java.lang.String	host The host.
private static org.slf4j.Logger	LOGGER
static java.lang.String	MOCK_SERVER_NAME
protected java.lang.String	password The password.
protected int	port The port.
private java.util.Properties	properties Configuration properties.
private static java.lang.String	SEPARATOR
private javax.mail.Authenticator	sslAuthentication The authenticator used for SSL.
protected boolean	useMock True we should use the mock server.
protected java.lang.String	username The username.
protected java.lang.Boolean	useSmtps

Fields inherited from interface org.ow2.chameleon.mail.MailSenderService

BODY_KEY, CC_KEY, ERROR_KEY, FROM_KEY, FROM_PROPERTY, SENT_TOPIC, STATUS_KEY, SUBJECT_KEY, TO_KEY

Constructor Summary

Constructors

Constructor and Description
Smtp()

Method Summary

Modifier and Type	Method and Description
private void	addBodyToMessage(org.ow2.chameleon.mail.Mail mail, javax.mail.internet.MimeMessage msg)
protected void	configure() Configures the sender.
static javax.mail.internet.InternetAddress[]	convert(java.util.List<java.lang.String> addresses) Converts the list of addresses to an array of InternetAddress.
private void	manageConnectionType()
void	reconfigure()
void	send(org.ow2.chameleon.mail.Mail mail) Sends the given mail object.
void	send(java.lang.String to, java.lang.String cc, java.lang.String subject, java.lang.String body) Sends a mail.
void	send(java.lang.String to, java.lang.String cc, java.lang.String subject, java.lang.String body, java.util.List<java.io.File> attachments) Sends a mail.
private void	sendMessageWithMockServer(org.ow2.chameleon.mail.Mail mail, javax.mail.internet.MimeMessage msg) Prints the mail info with the logger.

Methods inherited from class java.lang.Object

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

Field Detail

LOGGER

private static final org.slf4j.Logger LOGGER

MOCK_SERVER_NAME

public static final java.lang.String MOCK_SERVER_NAME

See Also:

Constant Field Values

DEFAULT_FROM

public static final java.lang.String DEFAULT_FROM

See Also:

Constant Field Values

CONFHOST

private static final java.lang.String CONFHOST

See Also:

Constant Field Values

CONFPORT

private static final java.lang.String CONFPORT

See Also:

Constant Field Values

CONFAUTH

private static final java.lang.String CONFAUTH

See Also:

Constant Field Values

SEPARATOR

private static final java.lang.String SEPARATOR

See Also:

Constant Field Values

configuration

org.wisdom.api.configuration.ApplicationConfiguration configuration

properties

private java.util.Properties properties

Configuration properties.

debug

private boolean debug

Enables / Disabled debugging.

from

protected java.lang.String from

The mail address of the sender.

fromName

protected java.lang.String fromName

An optional name (for the sender).

port

protected int port

The port.

host

protected java.lang.String host

The host.

username

protected java.lang.String username

The username.

password

protected java.lang.String password

The password.

sslAuthentication

private javax.mail.Authenticator sslAuthentication

The authenticator used for SSL.

useMock

protected boolean useMock

True we should use the mock server.

useSmtps

protected java.lang.Boolean useSmtps

connection

protected Smtp.Connection connection

Constructor Detail

Smtp

public Smtp()

Method Detail

configure

protected void configure()

Configures the sender.

manageConnectionType

private void manageConnectionType()

reconfigure

public void reconfigure()

send

public void send(java.lang.String to,
                 java.lang.String cc,
                 java.lang.String subject,
                 java.lang.String body)
          throws java.lang.Exception

Sends a mail.

Specified by:

send in interface org.ow2.chameleon.mail.MailSenderService

Parameters:

to - to

cc - cc

subject - subject

body - body

Throws:

java.lang.Exception - if the mail cannot be sent.

See Also:

MailSenderService.send(java.lang.String, java.lang.String, java.lang.String, java.lang.String)

send

public void send(java.lang.String to,
                 java.lang.String cc,
                 java.lang.String subject,
                 java.lang.String body,
                 java.util.List<java.io.File> attachments)
          throws java.lang.Exception

Sends a mail.

Specified by:

send in interface org.ow2.chameleon.mail.MailSenderService

Parameters:

to - to

cc - cc

subject - subject

body - body

attachments - list of attachments

Throws:

java.lang.Exception - if the mail cannot be sent

See Also:

MailSenderService.send(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.util.List)

send

public void send(org.ow2.chameleon.mail.Mail mail)
          throws javax.mail.MessagingException

Sends the given mail object. The mail to be sent must have a valid `to` clause, meaning not null or empty, and none of the addresses must be null.

Specified by:

send in interface org.ow2.chameleon.mail.MailSenderService

Parameters:

mail - the mail

Throws:

javax.mail.MessagingException - if the mail cannot be sent.

addBodyToMessage

private void addBodyToMessage(org.ow2.chameleon.mail.Mail mail,
                              javax.mail.internet.MimeMessage msg)
                       throws javax.mail.MessagingException

Throws:

javax.mail.MessagingException

sendMessageWithMockServer

private void sendMessageWithMockServer(org.ow2.chameleon.mail.Mail mail,
                                       javax.mail.internet.MimeMessage msg)
                                throws javax.mail.MessagingException

Prints the mail info with the logger.

Parameters:

mail - the mail

msg - the mime message

Throws:

javax.mail.MessagingException - if the message if malformed.

convert

public static javax.mail.internet.InternetAddress[] convert(java.util.List<java.lang.String> addresses)
                                                     throws javax.mail.internet.AddressException

Converts the list of addresses to an array of InternetAddress.

Parameters:

addresses - the addresses, must not be null, but can be empty.

Returns:

the array of Internet Addresses, empty if the input list is empty.

Throws:

javax.mail.internet.AddressException - if one of the address from 'addresses' is invalid.