org.wisdom.mailer

Class Smtp

java.lang.Object

org.wisdom.mailer.Smtp

All Implemented Interfaces:

org.ow2.chameleon.mail.MailSenderService

public class Smtp
extends 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 String	CONFAUTH
private static String	CONFHOST
(package private) org.wisdom.api.configuration.ApplicationConfiguration	configuration
private static String	CONFPORT
protected Smtp.Connection	connection
private boolean	debug Enables / Disabled debugging.
static String	DEFAULT_FROM
protected String	from The mail address of the sender.
protected String	host The host.
private static org.slf4j.Logger	LOGGER
static String	MOCK_SERVER_NAME
protected String	password The password.
protected int	port The port.
private Properties	properties Configuration properties.
private static String	SEPARATOR
private javax.mail.Authenticator	sslAuthentication The authenticator used for SSL.
protected boolean	useMock True we should use the mock server.
protected String	username The username.
protected 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(List<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(String to, String cc, String subject, String body) Sends a mail.
void	send(String to, String cc, String subject, String body, List<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 String MOCK_SERVER_NAME

See Also:

Constant Field Values

DEFAULT_FROM

public static final String DEFAULT_FROM

See Also:

Constant Field Values

CONFHOST

private static final String CONFHOST

See Also:

Constant Field Values

CONFPORT

private static final String CONFPORT

See Also:

Constant Field Values

CONFAUTH

private static final String CONFAUTH

See Also:

Constant Field Values

SEPARATOR

private static final String SEPARATOR

See Also:

Constant Field Values

configuration

org.wisdom.api.configuration.ApplicationConfiguration configuration

properties

private Properties properties

Configuration properties.

debug

private boolean debug

Enables / Disabled debugging.

from

protected String from

The mail address of the sender.

port

protected int port

The port.

host

protected String host

The host.

username

protected String username

The username.

password

protected 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 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(String to,
                 String cc,
                 String subject,
                 String body)
          throws Exception

Sends a mail.

Specified by:

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

Parameters:

to - to

cc - cc

subject - subject

body - body

Throws:

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(String to,
                 String cc,
                 String subject,
                 String body,
                 List<File> attachments)
          throws 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:

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(List<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.