com.kuzumeji.framework.enterprise.component.mail.MailServiceImpl.java Source code

Introduction

Here is the source code for com.kuzumeji.framework.enterprise.component.mail.MailServiceImpl.java

Source

// ----------------------------------------------------------------------------
// Copyright (C) Kuzumeji Evolution Laboratory. All rights reserved.
// GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007
// http://www.gnu.org/licenses/gpl-3.0-standalone.html
// ----------------------------------------------------------------------------
package com.kuzumeji.framework.enterprise.component.mail;

import static com.kuzumeji.framework.standard.component.ConfigHelper.*;
import java.io.UnsupportedEncodingException;
import java.util.Map;
import java.util.Map.Entry;
import javax.mail.Message;
import javax.mail.Message.RecipientType;
import javax.mail.MessagingException;
import javax.mail.Multipart;
import javax.mail.Session;
import javax.mail.Transport;
import javax.mail.internet.AddressException;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeMessage;
import org.apache.commons.lang3.Validate;
import com.kuzumeji.framework.enterprise.component.EnterpriseException;

/**
 * 
 * <dl>
 * <dt>?
 * <dd>
 * <ol>
 * <li>{@link MailService I/F} ????</li>
 * <li>{@link #MailServiceImpl(Session) } ????</li>
 * </ol>
 * </dl>
 * @author nilcy
 */
public class MailServiceImpl implements MailService {
    /**  */
    private static final String CHARSET = "UTF-8";
    /**  */
    private final Session session;

    /**
     * 
     * @param session {@link #session }
     */
    public MailServiceImpl(final Session session) {
        Validate.notNull(session, "??NULL?????????");
        this.session = session;
    }

    /** {@inheritDoc} */
    @Override
    public final void send(final InternetAddress originator, final Map<RecipientType, InternetAddress> recipients,
            final String subject, final String body) throws EnterpriseException {
        try {
            final Message message = createMessage(originator, recipients, subject);
            message.setContent(body, "text/plain;charset=UTF-8");
            send(message);
        } catch (final MessagingException e) {
            throw new EnterpriseException(e);
        }
    }

    /** {@inheritDoc} */
    @Override
    public final void send(final InternetAddress originator, final Map<RecipientType, InternetAddress> recipients,
            final String subject, final Object body, final String type) throws EnterpriseException {
        try {
            final Message message = createMessage(originator, recipients, subject);
            message.setContent(body, type);
            send(message);
        } catch (final MessagingException e) {
            throw new EnterpriseException(e);
        }
    }

    /** {@inheritDoc} */
    @Override
    public final void send(final InternetAddress originator, final Map<RecipientType, InternetAddress> recipients,
            final String subject, final Multipart body) throws EnterpriseException {
        try {
            final Message message = createMessage(originator, recipients, subject);
            message.setContent(body);
            send(message);
        } catch (final MessagingException e) {
            throw new EnterpriseException(e);
        }
    }

    /**
     * ??
     * @param originator 
     * @param recipients ?
     * @param subject ??
     * @return 
     * @throws EnterpriseException ?
     */
    private Message createMessage(final InternetAddress originator,
            final Map<RecipientType, InternetAddress> recipients, final String subject) throws EnterpriseException {
        Validate.isTrue(recipients.size() > 0);
        try {
            final MimeMessage message = new MimeMessage(session);
            if (originator != null) {
                message.setFrom(originator);
            }
            for (final Entry<RecipientType, InternetAddress> recipient : recipients.entrySet()) {
                message.addRecipient(recipient.getKey(), recipient.getValue());
            }
            message.setSubject(subject, CHARSET);
            return message;
        } catch (final MessagingException e) {
            throw new EnterpriseException(e);
        }
    }

    /**
     * ?
     * @param message 
     * @throws EnterpriseException ?
     */
    private static void send(final Message message) throws EnterpriseException {
        Validate.notNull(message);
        try {
            Transport.send(message);
        } catch (final MessagingException e) {
            throw new EnterpriseException(e);
        }
    }

    /** {@inheritDoc} */
    @Override
    public InternetAddress createAddress(final String address) throws AddressException {
        return new InternetAddress(address);
    }

    /** {@inheritDoc} */
    @Override
    public InternetAddress createAddress(final String address, final String personal)
            throws UnsupportedEncodingException {
        return new InternetAddress(address, personal, INET_ADDRESS_CHARSET);
    }
}