com.wadpam.open.service.EmailSender Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of tools-gae Show documentation
The newest version!
package com.wadpam.open.service;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import javax.activation.DataHandler;
import javax.mail.*;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeBodyPart;
import javax.mail.internet.MimeMessage;
import javax.mail.internet.MimeMultipart;
import javax.mail.util.ByteArrayDataSource;
import java.io.UnsupportedEncodingException;
import java.util.List;
import java.util.Properties;

/**
 * This class is responsible for sending email.
 * @author mattiaslevin
 */
public class EmailSender {
    static final Logger LOG = LoggerFactory.getLogger(EmailSender.class);

    /**
     * A basic send email method that only support plain text and to/from email address.
     * @param toEmail the to email address
     * @param fromEmail the from email address.
     *                  Please note the restrictions on GAE when setting the from email.
     *                  https://developers.google.com/appengine/docs/java/mail/usingjavamail#Senders_and_Recipients
     * @param subject the subject/title
     * @param body text body
     * @return true if send was successful
     */
    public static boolean sendEmail(String toEmail, String fromEmail, String subject, String body) {
        return sendEmail(toEmail, null, fromEmail, null, subject, body);
    }

    /**
     * A basic send email method that only support plain text and to/from email address.
     * @param toEmail the to email address
     * @param toName the name of the receiver
     * @param fromEmail the from email address.
     *                  Please note the restrictions on GAE when setting the from email.
     *                  https://developers.google.com/appengine/docs/java/mail/usingjavamail#Senders_and_Recipients
     * @param fromName the name of the sender
     * @param subject the subject/title
     * @param body text body
     * @return true if send was successful
     */
    public static boolean sendEmail(String toEmail, String toName,
                                    String fromEmail, String fromName,
                                    String subject, String body) {

        LOG.debug("Send email to:{}, subject:{}", toEmail, subject);

        final Session session = Session.getDefaultInstance(new Properties(), null);
        try {
            Message msg = new MimeMessage(session);
            msg.setFrom(new InternetAddress(fromEmail, fromName));
            msg.addRecipient(Message.RecipientType.TO, new InternetAddress(toEmail, toName));
            msg.setSubject(subject);
            msg.setText(body);
            Transport.send(msg);
            return true;
        } catch (Exception e) {
            // Catch all exceptions and just log an error, do not interrupt flow
            LOG.error("Not possible to send email with reason:{}", e.getMessage());
            return false;
        }

    }


    /**
     * A send email method that support multiple recipients and html body and attachments.
     * @param fromAddress the from email address
     * @param fromName the name of the sender
     * @param toAddresses list of to email addresses
     * @param ccAddresses list of cc email addresses
     * @param bccAddresses list of bcc email addresses
     * @param subject the subject/title
     * @param text plain text body.
     *             This this parameter is set the email will be plain text and any html body
     *             or attachments will be ignored.
     * @param html html text body.
     *             This parameter must be set if attachment should be included in the email.
     * @param attachment email attachment
     * @param filename the name of the attachment
     * @param contentType the content type of the attachment
     * @return true if send was successful
     * */
    public static boolean sendEmail(String fromAddress, String fromName,
                             List toAddresses,
                             List ccAddresses,
                             List bccAddresses,
                             String subject,
                             String text, String html,
                             byte[] attachment, String filename, String contentType) {
        LOG.info("Send email to:{}, subject:{}", toAddresses, subject);

        final Session session = Session.getDefaultInstance(new Properties(), null);
        try {
            // Build message
            final Message msg = new MimeMessage(session);

            // Set from address
            final InternetAddress from = new InternetAddress(fromAddress, fromName);
            msg.setFrom(from);
            // Set to address
            if (toAddresses != null) {
                for (String toAddress : toAddresses) {
                    final InternetAddress to = new InternetAddress(toAddress, null);
                    msg.addRecipient(Message.RecipientType.TO, to);
                }
            }

            if (null == toAddresses && null == ccAddresses && null == bccAddresses) {
                LOG.warn("One of to, cc or bcc address must be provided to send email");
                return false;
            }

            // Set cc address
            if (ccAddresses != null) {
                for (String ccAddress : ccAddresses) {
                    final InternetAddress cc = new InternetAddress(ccAddress, null);
                    msg.addRecipient(Message.RecipientType.CC, cc);
                }
            }
            // Set bcc address
            if (bccAddresses != null) {
                for (String bccAddress : bccAddresses) {
                    final InternetAddress bcc = new InternetAddress(bccAddress, null);
                    msg.addRecipient(Message.RecipientType.BCC, bcc);
                }
            }
            // Subject
            msg.setSubject(subject);

            // Check if plain text or multi-part message
            if (null != text) {
                // Plain text
                msg.setText(text);
            } else {
                // Multi-part message
                final Multipart mp = new MimeMultipart();

                // Add body as html
                final MimeBodyPart htmlPart = new MimeBodyPart();
                htmlPart.setContent(html, "text/html");
                mp.addBodyPart(htmlPart);

                // Add attachments if any
                if (null != attachment) {
                    LOG.debug("Add attachment to email");
                    final MimeBodyPart attachmentPart = createBodyPart(attachment, contentType, filename);
                    mp.addBodyPart(attachmentPart);
                }

                msg.setContent(mp);
            }

            msg.saveChanges();
            Transport.send(msg);
            return true;
        } catch (UnsupportedEncodingException ex) {
            LOG.warn("Cannot create InternetAddress when sending email:{}", ex);
            return false;
        } catch (MessagingException me) {
            LOG.warn("Cannot send email with reason:{}", me);
            return false;
        }
    }

    // Build attachment part
    private static MimeBodyPart createBodyPart(byte[] data, String type, String filename) throws MessagingException {
        final MimeBodyPart attachmentPart = new MimeBodyPart();
        attachmentPart.setFileName(filename);
        ByteArrayDataSource source = new ByteArrayDataSource(data, type);
        attachmentPart.setDataHandler(new DataHandler(source));
        attachmentPart.setHeader("Content-ID", createContentID(filename));
        attachmentPart.setDisposition(MimeBodyPart.INLINE);
        return attachmentPart;
    }

    //
    private static String createContentID(String filename) {
        return String.format("%[email protected]", filename);
    }

}