Java tutorial
/* * Copyright (c) 2009-2010 Lockheed Martin Corporation * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package org.eurekastreams.server.service.actions.strategies; import java.io.IOException; import java.util.Date; import java.util.Iterator; import java.util.Map; import java.util.Properties; import javax.mail.BodyPart; import javax.mail.MessagingException; import javax.mail.Multipart; import javax.mail.Session; import javax.mail.Transport; import javax.mail.internet.InternetAddress; import javax.mail.internet.MimeBodyPart; import javax.mail.internet.MimeMessage; import javax.mail.internet.MimeMultipart; import javax.mail.internet.MimeMessage.RecipientType; import org.apache.commons.lang.StringUtils; import org.eurekastreams.server.domain.HasEmail; //TODO would be cool to turn this into a real message factory and create an email impl. /** * Email helper for sending Emails. */ public class EmailerFactory { /** Protocol message is using (e.g. "smtp"). */ private String mailTransportProtocol; /** * List of configuration properties relevant to the given transport protocol. (For SMTP use mail.smtp.host and * mail.smtp.port) */ private Map<String, String> transportConfiguration; /** Address of sender if not otherwise specified. */ private String defaultFromAddress; /** * Constructor. * * @param inMailTransportProtocol * Protocol message is using (e.g. "smtp"). * @param inTransportConfiguration * List of configuration properties relevant to the given transport protocol. * @param inDefaultFromAddress * Address of sender if not otherwise specified. */ public EmailerFactory(final String inMailTransportProtocol, final Map<String, String> inTransportConfiguration, final String inDefaultFromAddress) { mailTransportProtocol = inMailTransportProtocol; transportConfiguration = inTransportConfiguration; defaultFromAddress = inDefaultFromAddress; } /** * Convenience routine to create a string containing a list of emails from a list of people objects. * * @param list * List of objects which have an email property. * @return String of concatenated email addresses ready to pass to setTo/setCc/setBcc. */ public static String buildEmailList(final Iterable<? extends HasEmail> list) { Iterator<String> iter = new Iterator<String>() { Iterator<? extends HasEmail> innerIterator = list.iterator(); @Override public boolean hasNext() { return innerIterator.hasNext(); } @Override public String next() { return innerIterator.next().getEmail(); } @Override public void remove() { // Not used } }; return StringUtils.join(iter, ','); } /** * @param message * message to be sent. * @throws MessagingException * Thrown if there are problems sending the message. */ public void sendMail(final MimeMessage message) throws MessagingException { Transport.send(message); } /** * Creates a "blank" email message, ready for the application to set the content (subject, body, etc.). * * @return An email message. * @throws MessagingException * Thrown if there are problems creating the message. */ public MimeMessage createMessage() throws MessagingException { Properties mailProps = new Properties(); mailProps.put("mail.transport.protocol", mailTransportProtocol); for (Map.Entry<String, String> cfg : transportConfiguration.entrySet()) { mailProps.put(cfg.getKey(), cfg.getValue()); } Session mailSession = Session.getInstance(mailProps, null); MimeMessage msg = new MimeMessage(mailSession); msg.setContent(new MimeMultipart("alternative")); msg.setSentDate(new Date()); msg.setFrom(new InternetAddress(defaultFromAddress)); return msg; } /** * Sets the primary ('to') recipients. * * @param message * Email message being built. * @param emailToString * Comma delimited list of email addresses Email is being sent to. * @throws MessagingException * Thrown if there are problems creating the message. */ public void setTo(final MimeMessage message, final String emailToString) throws MessagingException { message.setRecipients(RecipientType.TO, emailToString); } /** * Sets the CC recipients. * * @param message * Email message being built. * @param emailToString * Comma delimited list of email addresses Email is being sent to. * @throws MessagingException * Thrown if there are problems creating the message. */ public void setCc(final MimeMessage message, final String emailToString) throws MessagingException { message.setRecipients(RecipientType.CC, emailToString); } /** * Sets the BCC recipients. * * @param message * Email message being built. * @param emailToString * Comma delimited list of email addresses Email is being sent to. * @throws MessagingException * Thrown if there are problems creating the message. */ public void setBcc(final MimeMessage message, final String emailToString) throws MessagingException { message.setRecipients(RecipientType.BCC, emailToString); } /** * @param message * Email message being built. * @param emailFromString * Email Address of person sending the email. * @throws MessagingException * Thrown if there are problems creating the message. */ public void setFrom(final MimeMessage message, final String emailFromString) throws MessagingException { InternetAddress fromAddress = new InternetAddress(emailFromString); message.setFrom(fromAddress); } /** * @param message * Email message being built. * @param subject * Subject of the Email. * @throws MessagingException * Thrown if there are problems creating the message. */ public void setSubject(final MimeMessage message, final String subject) throws MessagingException { message.setSubject(subject); } /** * @param message * Email message being built. * @param textBody * Plain Text Email Body. * @throws MessagingException * Thrown if there are problems creating the message. */ public void setTextBody(final MimeMessage message, final String textBody) throws MessagingException { BodyPart textBp = new MimeBodyPart(); textBp.setText(textBody); getMultipart(message).addBodyPart(textBp); } /** * @param message * Email message being built. * @param htmlBody * Rich HTML body of the Email. * @throws MessagingException * Thrown if there are problems creating the message. */ public void setHtmlBody(final MimeMessage message, final String htmlBody) throws MessagingException { BodyPart htmlBp = new MimeBodyPart(); htmlBp.setContent(htmlBody, "text/html"); htmlBp.setHeader("MIME-VERSION", "1.0"); htmlBp.setHeader("Content-Type", "text/html; charset=ISO-8859-1"); getMultipart(message).addBodyPart(htmlBp); } /** * Retrieves the multipart object from the message. * * @param message * Email message being built. * @return multipart object. * @throws MessagingException * If there is a problem retrieving the content. */ protected Multipart getMultipart(final MimeMessage message) throws MessagingException { try { return (Multipart) message.getContent(); } catch (IOException ex) { throw new MessagingException("Failed to retrieve multipart from message being built.", ex); } } }