A Java send mail class - A simple class to simplify sending email

Here’s the source code for a simple “Java send mail” class that can simplify the process of sending email messages from Java applications. I named this class MailAgent, and I’m sharing the source code here for free. I’ve included a brief usage statement in the Javadoc at the top of the class. Hopefully it’s all pretty straightforward, and a decent example of using the JavaMail API to send an email message.

Note that you will need two jar files from Sun, activation.jar and mail.jar to use this class. You should be able to find those on this JavaMail API page. Look for the downloads of the JavaMail API and the JavaBeans Activation Framework.

package com.devdaily.web.email;

import javax.mail.*;
import javax.mail.internet.*;
import java.util.Date;
import java.util.Properties;

/**
 *
 *  MailAgent.java from devdaily.com.
 *  Demonstrates using the JavaMail API to send an email message.
 *
 *  Usage:
 *
 *  MailAgent agent = new MailAgent(to, cc, bcc, from, subject, body, smtpHost);
 *  agent.sendMessage();
 *
 *  The fields "to", "cc", and "bcc" can be comma-separated sequences of addresses.
 *  @see mail.internet.InternetAddress.parse() for details.
 *
 */
public class MailAgent
{
  private String to;
  private String cc;
  private String bcc;
  private String from;
  private String subject;
  private String content;
  private String smtpHost;
  private Message message;

  public MailAgent(String to,
                   String cc,
                   String bcc,
                   String from,
                   String subject,
                   String content,
                   String smtpHost)
  throws AddressException, MessagingException
  {
    this.to = to;
    this.cc = cc;
    this.bcc = bcc;
    this.from = from;
    this.subject = subject;
    this.content = content;
    this.smtpHost = smtpHost;

    message = createMessage();
    message.setFrom(new InternetAddress(from));
    setToCcBccRecipients();

    message.setSentDate(new Date());
    message.setSubject(subject);
    message.setText(content);
  }

  public void sendMessage() 
  throws MessagingException
  {
    try
    {
      Transport.send(message);
    }
    catch (MessagingException me)
    {
      // do logging here
      throw me;
    }
  }

  private Message createMessage()
  {
    Properties properties = new Properties();
    properties.put("mail.smtp.host", smtpHost);
    Session session = Session.getDefaultInstance(properties, null);
    return new MimeMessage(session);
  }

  private void setToCcBccRecipients()
  throws AddressException, MessagingException
  {
    setMessageRecipients(to, Message.RecipientType.TO);
    setMessageRecipients(cc, Message.RecipientType.CC);
    setMessageRecipients(bcc, Message.RecipientType.BCC);
  } 

  private void setMessageRecipients(String recipient, Message.RecipientType recipientType)
  throws AddressException, MessagingException
  {
    InternetAddress[] addressArray = buildInternetAddressArray(recipient);

    if ((addressArray != null) && (addressArray.length > 0))
    {
      message.setRecipients(recipientType, addressArray);
    }
  }

  /**
   * The address can be a comma-separated sequence of email addresses.
   * @see mail.internet.InternetAddress.parse() for details.
   *
   */
  private InternetAddress[] buildInternetAddressArray(String address)
  throws AddressException
  {
    // could test for a null or blank String but I'm letting parse just throw an exception
    InternetAddress[] internetAddressArray = null;
    try
    {
      internetAddressArray = InternetAddress.parse(address);
    }
    catch (AddressException ae)
    {
      // do logging here
      throw ae;
    }
    return internetAddressArray;
  }

}

In summary, I hope this is a useful example of a Java “send email” class and the JavaMail API.

Add new comment

Anonymous format

  • Allowed HTML tags: <em> <strong> <cite> <code> <ul type> <ol start type> <li> <pre>
  • Lines and paragraphs break automatically.