This tutorial will show you how to send a basic mail via Spring framework’s email support.

The Spring Framework provides a helpful utility library for sending email that shields the user from the specifics of the underlying mailing system and is responsible for low level resource handling on behalf of the client. A class that comes in pretty handy when dealing with JavaMail messages is the org.springframework.mail.javamail.MimeMessageHelper class, which shields you from having to use the verbose JavaMail API. Using the MimeMessageHelper it is pretty easy to create a MimeMessage. Multipart email messages allow for both attachments and inline resources. Examples of inline resources would be images or a stylesheet you want to use in your message, but that you don’t want displayed as an attachment. Inline resources are added to the mime message using the specified Content-ID (file.getName() in the below example). The order in which you are adding the text and the resource are very important. Be sure to first add the text and after that the resources. If you are doing it the other way around, it won’t work!

The following example shows you how to use the MimeMessageHelper to send an email along with an inline image.

For this tutorial we will create a standalone maven project in Eclipse. If you already have an idea on how to create a maven project in Eclipse will be great otherwise I will tell you here how to create a maven project in Eclipse.

The following configurations are required in order to run the application
Eclipse Mars
JDK 1.8
Have maven installed and configured
Spring and Java Mail dependencies in pom.xml
Now we will see the below steps how to create a maven based spring project in Eclipse
Step 1. Create a standalone maven project in Eclipse

Go to File -> New -> Other. On popup window under Maven select Maven Project. Then click on Next. Select the workspace location – either default or browse the location. Click on Next. Now in next window select the row as highlighted from the below list of archtypes and click on Next button.

Now enter the required fields (Group Id, Artifact Id) as shown below
Group Id : com.roytuts
Artifact Id : springcore
Step 2. Modify the pom.xml file as shown below.

<project xmlns="" xmlns:xsi=""
        <!-- Spring framework -->
        <!-- Java Mail API -->
        <!-- junit -->

Step 3. If you see JRE System Library[J2SE-1.5] then change the version by below process

Do right-click on the project and go to Build -> Configure build path, under Libraries tab click on JRE System Library[J2SE-1.5], click on Edit button and select the appropriate jdk 1.8 from the next window. Click on Finish then Ok.

Step 4. Create src/main/resources folder for putting the resource files.

Do right-click on the project and go New -> Source Folder. Give Folder name: as src/main/resources and click on Finish button.

Step 5. Create an XML file email.xml under src/main/resources.

Do right-click on src/main/resources in the project and go New -> file. Give File name: as email.xml and click on Finish button.

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns=""
    xmlns:xsi="" xmlns:p=""
    <bean id="mailSender" class="org.springframework.mail.javamail.JavaMailSenderImpl">
        <property name="host" value="" />
        <property name="port" value="121" />
        <property name="username" value="[email protected]" />
        <property name="password" value="******" />
        <property name="javaMailProperties">
                <!-- if you need ssl then uncomment below two lines -->
                <!-- <prop key=""></prop>
                <prop key="mail.smtp.starttls.enable">true</prop> -->
                <prop key="mail.smtp.auth">true</prop>
    <bean id="emailSender" class="">
        <property name="mailSender" ref="mailSender" />

Step 6. Create below EmailSender class under src/main/java folder

import javax.mail.Message;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeMessage;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.mail.javamail.JavaMailSender;
import org.springframework.mail.javamail.MimeMessageHelper;
public class EmailSender {
    private JavaMailSender mailSender;
    public void sendEmailInlineResource(final String subject, final String message, final String emailAddress,
            final File attachment, final boolean isHtmlMail) {
        try {
            MimeMessage mimeMessage = mailSender.createMimeMessage();
            // use the true flag to indicate you need a multipart message
            MimeMessageHelper helper = new MimeMessageHelper(mimeMessage, true);
            helper.setFrom("[email protected]");
            if (isHtmlMail) {
                helper.setText("<html><body>" + message + "</html></body>", true);
            } else {
            // add the file attachment
            FileSystemResource file = new FileSystemResource(attachment);
            helper.addInline(attachment.getName(), file);
            System.out.println("Email sending complete.");
        } catch (Exception e) {
    public JavaMailSender getMailSender() {
        return mailSender;
    public void setMailSender(JavaMailSender mailSender) {
        this.mailSender = mailSender;

Step 7. Create below Junit test class under src/test/java folder to test the application

import org.junit.Before;
import org.junit.Test;
import org.springframework.context.ApplicationContext;
public class EmailSenderTest {
    private EmailSender emailSender;
    public void setUp() throws Exception {
        ApplicationContext applicationContext = new ClassPathXmlApplicationContext("email.xml");
        emailSender = applicationContext.getBean("emailSender", EmailSender.class);
    public void testSendEmail() {
        File attachment = new File("D:/buttons.png");
        emailSender.sendEmailInlineResource("How are you ?",
                "Hello Dear, <i>How are you ?</i> <br/> Look how attachment is shown as inline resource",
                "[email protected]", attachment, true);

Step 8. Now run the above Junit test class, you will see the below output in console
Console Output

Apr 23, 2016 8:48:27 AM prepareRefresh
INFO: Refreshing org[email protected]265ba4: startup date [Sat Apr 23 08:48:27 IST 2016]; root of context hierarchy
Apr 23, 2016 8:48:27 AM org.springframework.beans.factory.xml.XmlBeanDefinitionReader loadBeanDefinitions
INFO: Loading XML bean definitions from class path resource [email.xml]
Email sending complete.

Step 9. Check the inbox you will get a message. If you do not find the message in inbox then check the Spam folder.
email spring inline attachment
See in the above image how <i/>, <br/> tags made italic & break in HTML email.
Thanks for reading.