Skip to content

Latest commit

 

History

History
226 lines (190 loc) · 9.04 KB

store-sendgrid-java-how-to-send-email.md

File metadata and controls

226 lines (190 loc) · 9.04 KB
title description services documentationcenter author manager editor ms.assetid ms.service ms.workload ms.tgt_pltfrm ms.devlang ms.topic ms.date ms.author
How to use the SendGrid email service (Java) | Microsoft Docs
Learn how send email with the SendGrid email service on Azure. Code samples written in Java.
java
thinkingserious
sendgrid
mollybos
cc75c43e-ede9-492b-98c2-9147fcb92c21
multiple
na
na
Java
article
10/30/2014

How to Send Email Using SendGrid from Java

This guide demonstrates how to perform common programming tasks with the SendGrid email service on Azure. The samples are written in Java. The scenarios covered include constructing email, sending email, adding attachments, using filters, and updating properties. For more information on SendGrid and sending email, see the Next steps section.

What is the SendGrid Email Service?

SendGrid is a cloud-based email service that provides reliable transactional email delivery, scalability, and real-time analytics along with flexible APIs that make custom integration easy. Common SendGrid usage scenarios include:

  • Automatically sending receipts to customers
  • Administering distribution lists for sending customers monthly e-fliers and special offers
  • Collecting real-time metrics for things like blocked e-mail, and customer responsiveness
  • Generating reports to help identify trends
  • Forwarding customer inquiries
  • Email notifications from your application

For more information, see http://sendgrid.com.

Create a SendGrid account

[!INCLUDE sendgrid-sign-up]

How to: Use the javax.mail libraries

Obtain the javax.mail libraries, for example from http://www.oracle.com/technetwork/java/javamail and import them into your code. At a high-level, the process for using the javax.mail library to send email using SMTP is to do the following:

  1. Specify the SMTP values, including the SMTP server, which for SendGrid is smtp.sendgrid.net.
        import java.util.Properties;
        import javax.activation.*;
        import javax.mail.*;
        import javax.mail.internet.*;

        public class MyEmailer {
           private static final String SMTP_HOST_NAME = "smtp.sendgrid.net";
           private static final String SMTP_AUTH_USER = "your_sendgrid_username";
           private static final String SMTP_AUTH_PWD = "your_sendgrid_password";

           public static void main(String[] args) throws Exception{
               new MyEmailer().SendMail();
           }

           public void SendMail() throws Exception
           {
              Properties properties = new Properties();
                 properties.put("mail.transport.protocol", "smtp");
                 properties.put("mail.smtp.host", SMTP_HOST_NAME);
                 properties.put("mail.smtp.port", 587);
                 properties.put("mail.smtp.auth", "true");
                 // …

  1. Extend the javax.mail.Authenticator class, and in your implementation of the getPasswordAuthentication method, return your SendGrid user name and password.

    private class SMTPAuthenticator extends javax.mail.Authenticator {
public PasswordAuthentication getPasswordAuthentication() {
   String username = SMTP_AUTH_USER;
   String password = SMTP_AUTH_PWD;
   return new PasswordAuthentication(username, password);
}

  2. Create an authenticated email session through a javax.mail.Session object.

    Authenticator auth = new SMTPAuthenticator();
Session mailSession = Session.getDefaultInstance(properties, auth);

  3. Create your message and assign To, From, Subject and content values. This is shown in the How To: Create an Email section.

  4. Send the message through a javax.mail.Transport object. This is shown in the [How To: Send an Email][How to: Send an Email] section.

How to: Create an email

The following shows how to specify values for an email.

MimeMessage message = new MimeMessage(mailSession);
Multipart multipart = new MimeMultipart("alternative");
BodyPart part1 = new MimeBodyPart();
part1.setText("Hello, Your Contoso order has shipped. Thank you, John");
BodyPart part2 = new MimeBodyPart();
part2.setContent(
    "<p>Hello,</p>
    <p>Your Contoso order has <b>shipped</b>.</p>
    <p>Thank you,<br>John</br></p>",
    "text/html");
multipart.addBodyPart(part1);
multipart.addBodyPart(part2);
message.setFrom(new InternetAddress("[email protected]"));
message.addRecipient(Message.RecipientType.TO,
   new InternetAddress("[email protected]"));
message.setSubject("Your recent order");
message.setContent(multipart);

How to: Send an email

The following shows how to send an email.

Transport transport = mailSession.getTransport();
// Connect the transport object.
transport.connect();
// Send the message.
transport.sendMessage(message, message.getAllRecipients());
// Close the connection.
transport.close();

How to: Add an attachment

The following code shows you how to add an attachment.

// Local file name and path.
String attachmentName = "myfile.zip";
String attachmentPath = "c:\\myfiles\\";
MimeBodyPart attachmentPart = new MimeBodyPart();
// Specify the local file to attach.
DataSource source = new FileDataSource(attachmentPath + attachmentName);
attachmentPart.setDataHandler(new DataHandler(source));
// This example uses the local file name as the attachment name.
// They could be different if you prefer.
attachmentPart.setFileName(attachmentName);
multipart.addBodyPart(attachmentPart);

How to: Use filters to enable footers, tracking, and analytics

SendGrid provides additional email functionality through the use of filters. These are settings that can be added to an email message to enable specific functionality such as enabling click tracking, Google analytics, subscription tracking, and so on. For a full list of filters, see Filter Settings.

  • The following shows how to insert a footer filter that results in HTML text appearing at the bottom of the email being sent.

    message.addHeader("X-SMTPAPI",
    "{\"filters\":
    {\"footer\":
    {\"settings\":
    {\"enable\":1,\"text/html\":
    \"<html><b>Thank you</b> for your business.</html>\"}}}}");

  • Another example of a filter is click tracking. Let’s say that your email text contains a hyperlink, such as the following, and you want to track the click rate:

    messagePart.setContent(
    "Hello,
    <p>This is the body of the message. Visit
    <a href='http://www.contoso.com'>http://www.contoso.com</a>.</p>
    Thank you.",
    "text/html");

  • To enable the click tracking, use the following code:

    message.addHeader("X-SMTPAPI",
    "{\"filters\":
    {\"clicktrack\":
    {\"settings\":
    {\"enable\":1}}}}");

How to: Update email properties

Some email properties can be overwritten using setProperty or appended using addProperty.

For example, to specify ReplyTo addresses, use the following:

InternetAddress addresses[] =
    { new InternetAddress("[email protected]"),
      new InternetAddress("[email protected]") };

message.setReplyTo(addresses);

To add a Cc recipient, use the following:

message.addRecipient(Message.RecipientType.CC, new
InternetAddress("[email protected]"));

How to: Use additional SendGrid services

SendGrid offers web-based APIs that you can use to leverage additional SendGrid functionality from your Azure application. For full details, see the SendGrid API documentation.

Next steps

Now that you’ve learned the basics of the SendGrid Email service, follow these links to learn more.