Purpose

This tutorial is a supplement to the article of oracle published here. After reading this later, I decided to share some tips about this EE environment JavaMail api configuration.

Introduction

Two years ago, we decided to move to JEE 6 for our enterprise solutions and take a lot of fun with new EJB 3.1 features and annotations. Glassfish has made our lives easier, it was very easy to declare variables using it’s administration console. Less complicated than using global resource environment for properties It is also the continuation to this tricks this tutorial delegate to Glassfish EE server managing mail session.

Prerequisites

    Before starting this tutorial, you should:
  1. Fully understand of http://www.oracle.com/webfolder/technetwork/tutorials/obe/java/javamail/javamail.html
  2. Have access to an SMTP server. You must know the host name, port number, and security settings for your SMTP server. Web mail providers may offer SMTP access, view your email account settings or help to find further information. Be aware that your user name is often your full email address and not just the name that comes before the @ symbol.
  3. Have basic familiarity with Servlets and CDIs (helpful but not required)

Create a Java mail session resource :

    To create and JavaMail Session :
  1. start galssfish server
  2. open admin console ( default localhost:4848)
  3. Go to Resources -> JavaMail Sessions -> click new to add new javaMail resource
  4. make sure the following field are filled in :

Jndi name : EMailME for example, will be used later on lookup resource :

@Resource(lookup = "EMailME")
Mail host
  1. Default user
  2. Default sender will be used later on mailSession.getProperty("mail.from")
  3. For secure Mail add this advanced setting :
    • mail.smtp.password : email password
    • mail.smtp.port : email port
    • mail.smtp.auth : true

This screenshot summarizes all these parameters :

Mail EE

II - Using email Service

This tutorial is a supplement to oracle one. We will use CDI with the same example.

  1. MailSessionBean Will be a CDI bean with RequestScope
  2. Inject the full JavaMail Session as resource rather than create it
@Named
@RequestScoped
public class EmailSessionBean {

    @Resource(lookup = "EMailME")
    private Session mailSession;

    public void sendEmail(String to, String subject, String body) {
        MimeMessage message = new MimeMessage(mailSession);
        try {

            message.setFrom(new InternetAddress(mailSession.getProperty("mail.from")));
            InternetAddress[] address = {new InternetAddress(to)};
            message.setRecipients(Message.RecipientType.TO, address);
            message.setSubject(subject);
            message.setSentDate(new Date());
            message.setText(body);

            Transport.send(message);
        } catch (MessagingException ex) {
            ex.printStackTrace();
        }
    }
}

Look short !

  1. EmailServlet remind the same except using @Inject rather than @EJB
@WebServlet(name = "EmailServlet", urlPatterns = {"/EmailServlet"})
public class EmailServlet extends HttpServlet {

    @Inject
    private EmailSessionBean emailBean;

    protected void processRequest(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
 .........
   }
 ......
}

Conclusion :

Let’s EE Server manager MailSession for us, keep configuration on server and thanks to Glassfish administration console managing JavaMail Session became easier.