New ClickStart: SendGrid with Tomcat

Our serial ClickStack-writer, Cyrille, is happy to announce the availability of a Tomcat7 SendGrid ClickStart that will help you to integrate SendGrid email gateway in your Java applications.

As usual on CloudBees, we create a Java-style binding between your SendGrid account and your application by injecting the proper JNDI JavaMail Session straight in your Tomcat container.

SendGrid with Tomcat


Tomcat7 SendGrid ClickStart



After that, the integration of SendGrid can be as simple as the following lines of code:



@WebServlet(...) public class MyServlet extends HttpServlet {

   // Get your SendGrid session injected in your application from JNDI
   @Resource(name = "mail/SendGrid", lookup = "mail/SendGrid")  private Session session;
   protected void service(HttpServletRequest req, HttpServletResponse resp) 
                     throws ServletException, IOException {

      // Create your e-mail using the injected SendGrid session, easy...
      Message message = new MimeMessage(session);  
      message.setFrom(new InternetAddress(""));        
      message.setRecipients(Message.RecipientType.TO, new InternetAddress[]{
                                 new InternetAddress("")
      message.setSubject("My Subject");
      message.setContent("My Content", "text/plain");

      // Send your message!


Note: if you use the JNDI JavaMail Session, beware not to bundle mail.jar in your .war application but to define it as provided in your project. Otherwise, you would get an error (see Tomcat docs here).

Happy e-mailing!