├── .gitignore
├── README.md
├── commons-email-example
    ├── README.md
    ├── pom.xml
    └── src
    │   └── main
    │       ├── java
    │           └── com
    │           │   └── example
    │           │       └── javamail
    │           │           ├── CommonsEmailService.java
    │           │           └── ExampleUI.java
    │       └── resources
    │           ├── file.pdf
    │           └── mail.properties
├── javamail-example
    ├── README.md
    ├── pom.xml
    └── src
    │   └── main
    │       ├── java
    │           └── com
    │           │   └── example
    │           │       └── javamail
    │           │           ├── ExampleUI.java
    │           │           └── JavaMailService.java
    │       └── resources
    │           ├── file.pdf
    │           └── mail.properties
└── spring-mail-example
    ├── README.md
    ├── pom.xml
    └── src
        └── main
            ├── java
                └── com
                │   └── example
                │       └── javamail
                │           ├── ExampleUI.java
                │           └── SpringEmailService.java
            ├── resources
                ├── file.pdf
                └── mail.properties
            └── webapp
                └── WEB-INF
                    └── applicationContext.xml


/.gitignore:
--------------------------------------------------------------------------------
1 | */.idea/*
2 | rebel.xml
3 | *.iml
4 | */src/main/webapp/VAADIN/themes/mytheme/styles.css
5 | */target
6 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # java-email-tutorial
 2 | 
 3 | This exmaple shows how to send emails from Java applications in three different ways:
 4 | 
 5 |   1. [Commons Email](https://github.com/alejandro-du/java-email-tutorial/tree/master/commons-email-example)
 6 |   2. [Spring Mail Support](https://github.com/alejandro-du/java-email-tutorial/tree/master/spring-mail-example)
 7 |   3. [Plain JavaMail](https://github.com/alejandro-du/java-email-tutorial/tree/master/javamail-example)
 8 | 
 9 | [Read the complete tutorial here](https://vaadin.com/wiki?p_p_id=36&p_p_lifecycle=0&p_p_state=normal&p_p_mode=view&p_p_col_id=row-1&p_p_col_pos=1&p_p_col_count=3&p_r_p_185834411_title=Sending+Email+from+Java+Applications&p_r_p_185834411_nodeName=vaadin.com+wiki&_36_struts_action=%2Fwiki%2Fview).
10 | 


--------------------------------------------------------------------------------
/commons-email-example/README.md:
--------------------------------------------------------------------------------
 1 | # Sending email using Apache Commons Email
 2 | 
 3 | 1. Checkout the project form Git, and build and run with Maven:
 4 | 
 5 | ```
 6 | git clone https://github.com/alejandro-du/java-email-tutorial
 7 | 
 8 | cd java-email-tutorial
 9 | 
10 | cd commons-email-example
11 | 
12 | mvn clean install
13 | 
14 | mvn jetty:run
15 | ```
16 | 
17 | 2. Download and run [FakeSMTP](https://nilhcem.github.io/FakeSMTP).
18 | 
19 | 3. Configure FakeSMTP listening port to `9090` and start the server.
20 | 
21 | 4. Open [http://localhost:8080](http://localhost:8080) in your browser.
22 | 


--------------------------------------------------------------------------------
/commons-email-example/pom.xml:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0" encoding="UTF-8"?>
  2 | <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  3 | 		 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  4 | 	<modelVersion>4.0.0</modelVersion>
  5 | 
  6 | 	<groupId>org.test</groupId>
  7 | 	<artifactId>vaadin-app</artifactId>
  8 | 	<packaging>war</packaging>
  9 | 	<version>1.0-SNAPSHOT</version>
 10 | 	<name>vaadin-app</name>
 11 | 
 12 | 	<prerequisites>
 13 | 		<maven>3</maven>
 14 | 	</prerequisites>
 15 | 
 16 | 	<properties>
 17 | 		<vaadin.version>8.0.5</vaadin.version>
 18 | 		<vaadin.plugin.version>8.0.5</vaadin.plugin.version>
 19 | 		<jetty.plugin.version>9.3.9.v20160517</jetty.plugin.version>
 20 | 		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 21 | 		<maven.compiler.source>1.8</maven.compiler.source>
 22 | 		<maven.compiler.target>1.8</maven.compiler.target>
 23 | 		<!-- If there are no local customisations, this can also be "fetch" or "cdn" -->
 24 | 		<vaadin.widgetset.mode>local</vaadin.widgetset.mode>
 25 | 	</properties>
 26 | 
 27 | 	<repositories>
 28 | 		<repository>
 29 | 			<id>vaadin-addons</id>
 30 | 			<url>http://maven.vaadin.com/vaadin-addons</url>
 31 | 		</repository>
 32 | 	</repositories>
 33 | 
 34 | 	<dependencyManagement>
 35 | 		<dependencies>
 36 | 			<dependency>
 37 | 				<groupId>com.vaadin</groupId>
 38 | 				<artifactId>vaadin-bom</artifactId>
 39 | 				<version>${vaadin.version}</version>
 40 | 				<type>pom</type>
 41 | 				<scope>import</scope>
 42 | 			</dependency>
 43 | 		</dependencies>
 44 | 	</dependencyManagement>
 45 | 
 46 | 	<dependencies>
 47 | 		<dependency>
 48 | 			<groupId>javax.servlet</groupId>
 49 | 			<artifactId>javax.servlet-api</artifactId>
 50 | 			<version>3.0.1</version>
 51 | 			<scope>provided</scope>
 52 | 		</dependency>
 53 | 		<dependency>
 54 | 			<groupId>com.vaadin</groupId>
 55 | 			<artifactId>vaadin-server</artifactId>
 56 | 		</dependency>
 57 | 		<dependency>
 58 | 			<groupId>com.vaadin</groupId>
 59 | 			<artifactId>vaadin-push</artifactId>
 60 | 		</dependency>
 61 | 		<dependency>
 62 | 			<groupId>com.vaadin</groupId>
 63 | 			<artifactId>vaadin-client-compiled</artifactId>
 64 | 		</dependency>
 65 | 		<dependency>
 66 | 			<groupId>com.vaadin</groupId>
 67 | 			<artifactId>vaadin-themes</artifactId>
 68 | 		</dependency>
 69 | 
 70 | 		<!-- Apache Commons Email -->
 71 | 		<dependency>
 72 | 			<groupId>org.apache.commons</groupId>
 73 | 			<artifactId>commons-email</artifactId>
 74 | 			<version>1.4</version>
 75 | 		</dependency>
 76 | 	</dependencies>
 77 | 
 78 | 	<build>
 79 | 		<plugins>
 80 | 			<plugin>
 81 | 				<groupId>org.apache.maven.plugins</groupId>
 82 | 				<artifactId>maven-war-plugin</artifactId>
 83 | 				<version>3.0.0</version>
 84 | 				<configuration>
 85 | 					<failOnMissingWebXml>false</failOnMissingWebXml>
 86 | 					<!-- Exclude an unnecessary file generated by the GWT compiler. -->
 87 | 					<packagingExcludes>WEB-INF/classes/VAADIN/widgetsets/WEB-INF/**</packagingExcludes>
 88 | 				</configuration>
 89 | 			</plugin>
 90 | 			<plugin>
 91 | 				<groupId>com.vaadin</groupId>
 92 | 				<artifactId>vaadin-maven-plugin</artifactId>
 93 | 				<version>${vaadin.plugin.version}</version>
 94 | 				<executions>
 95 | 					<execution>
 96 | 						<goals>
 97 | 							<goal>update-theme</goal>
 98 | 							<goal>update-widgetset</goal>
 99 | 							<goal>compile</goal>
100 | 							<!-- Comment out compile-theme goal to use on-the-fly theme compilation -->
101 | 							<goal>compile-theme</goal>
102 | 						</goals>
103 | 					</execution>
104 | 				</executions>
105 | 			</plugin>
106 | 			<plugin>
107 | 				<groupId>org.apache.maven.plugins</groupId>
108 | 				<artifactId>maven-clean-plugin</artifactId>
109 | 				<version>3.0.0</version>
110 | 				<!-- Clean up also any pre-compiled themes -->
111 | 				<configuration>
112 | 					<filesets>
113 | 						<fileset>
114 | 							<directory>src/main/webapp/VAADIN/themes</directory>
115 | 							<includes>
116 | 								<include>**/styles.css</include>
117 | 								<include>**/styles.scss.cache</include>
118 | 							</includes>
119 | 						</fileset>
120 | 					</filesets>
121 | 				</configuration>
122 | 			</plugin>
123 | 
124 | 			<!-- The Jetty plugin allows us to easily test the development build by
125 |                 running jetty:run on the command line. -->
126 | 			<plugin>
127 | 				<groupId>org.eclipse.jetty</groupId>
128 | 				<artifactId>jetty-maven-plugin</artifactId>
129 | 				<version>${jetty.plugin.version}</version>
130 | 				<configuration>
131 | 					<scanIntervalSeconds>2</scanIntervalSeconds>
132 | 				</configuration>
133 | 			</plugin>
134 | 		</plugins>
135 | 	</build>
136 | 
137 | 	<profiles>
138 | 		<profile>
139 | 			<!-- Vaadin pre-release repositories -->
140 | 			<id>vaadin-prerelease</id>
141 | 			<activation>
142 | 				<activeByDefault>false</activeByDefault>
143 | 			</activation>
144 | 
145 | 			<repositories>
146 | 				<repository>
147 | 					<id>vaadin-prereleases</id>
148 | 					<url>http://maven.vaadin.com/vaadin-prereleases</url>
149 | 				</repository>
150 | 				<repository>
151 | 					<id>vaadin-snapshots</id>
152 | 					<url>https://oss.sonatype.org/content/repositories/vaadin-snapshots/</url>
153 | 					<releases>
154 | 						<enabled>false</enabled>
155 | 					</releases>
156 | 					<snapshots>
157 | 						<enabled>true</enabled>
158 | 					</snapshots>
159 | 				</repository>
160 | 			</repositories>
161 | 			<pluginRepositories>
162 | 				<pluginRepository>
163 | 					<id>vaadin-prereleases</id>
164 | 					<url>http://maven.vaadin.com/vaadin-prereleases</url>
165 | 				</pluginRepository>
166 | 				<pluginRepository>
167 | 					<id>vaadin-snapshots</id>
168 | 					<url>https://oss.sonatype.org/content/repositories/vaadin-snapshots/</url>
169 | 					<releases>
170 | 						<enabled>false</enabled>
171 | 					</releases>
172 | 					<snapshots>
173 | 						<enabled>true</enabled>
174 | 					</snapshots>
175 | 				</pluginRepository>
176 | 			</pluginRepositories>
177 | 		</profile>
178 | 	</profiles>
179 | 
180 | </project>
181 | 


--------------------------------------------------------------------------------
/commons-email-example/src/main/java/com/example/javamail/CommonsEmailService.java:
--------------------------------------------------------------------------------
  1 | package com.example.javamail;
  2 | 
  3 | import org.apache.commons.mail.EmailException;
  4 | import org.apache.commons.mail.HtmlEmail;
  5 | 
  6 | import javax.activation.DataHandler;
  7 | import javax.mail.MessagingException;
  8 | import javax.mail.util.ByteArrayDataSource;
  9 | import java.io.IOException;
 10 | import java.io.InputStream;
 11 | import java.util.*;
 12 | 
 13 | /**
 14 |  * @author alejandro@vaadin.com
 15 |  **/
 16 | public class CommonsEmailService {
 17 | 
 18 |     /**
 19 |      * Sends an email message with no attachments.
 20 |      *
 21 |      * @param from       email address from which the message will be sent.
 22 |      * @param recipients the recipients of the message.
 23 |      * @param subject    subject header field.
 24 |      * @param text       content of the message.
 25 |      * @throws MessagingException
 26 |      * @throws IOException
 27 |      */
 28 |     public static void send(String from, Collection<String> recipients, String subject, String text)
 29 |             throws IOException, EmailException {
 30 |         send(from, recipients, subject, text, null, null, null);
 31 |     }
 32 | 
 33 |     /**
 34 |      * Sends an email message to one recipient with one attachment.
 35 |      *
 36 |      * @param from       email address from which the message will be sent.
 37 |      * @param recipient  the recipients of the message.
 38 |      * @param subject    subject header field.
 39 |      * @param text       content of the message.
 40 |      * @param attachment attachment to be included with the message.
 41 |      * @param fileName   file name of the attachment.
 42 |      * @param mimeType   mime type of the attachment.
 43 |      * @throws MessagingException
 44 |      * @throws IOException
 45 |      */
 46 |     public static void send(String from, String recipient, String subject, String text, InputStream attachment,
 47 |                             String fileName, String mimeType)
 48 |             throws IOException, EmailException {
 49 |         send(from, Arrays.asList(recipient), subject, text, Arrays.asList(attachment), Arrays.asList(fileName),
 50 |                 Arrays.asList(mimeType));
 51 |     }
 52 | 
 53 |     /**
 54 |      * Sends an email message with attachments.
 55 |      *
 56 |      * @param from        email address from which the message will be sent.
 57 |      * @param recipients  array of strings containing the recipients of the message.
 58 |      * @param subject     subject header field.
 59 |      * @param text        content of the message.
 60 |      * @param attachments attachments to be included with the message.
 61 |      * @param fileNames   file names for each attachment.
 62 |      * @param mimeTypes   mime types for each attachment.
 63 |      * @throws MessagingException
 64 |      * @throws IOException
 65 |      */
 66 |     public static void send(String from, Collection<String> recipients, String subject, String text,
 67 |                             List<InputStream> attachments, List<String> fileNames, List<String> mimeTypes)
 68 |             throws EmailException, IOException {
 69 | 
 70 |         // check for null references
 71 |         Objects.requireNonNull(from);
 72 |         Objects.requireNonNull(recipients);
 73 | 
 74 |         // load email configuration from properties file
 75 |         Properties properties = new Properties();
 76 |         properties.load(CommonsEmailService.class.getResourceAsStream("/mail.properties"));
 77 |         String host = properties.getProperty("mail.smtp.host");
 78 |         String port = properties.getProperty("mail.smtp.port");
 79 |         String ssl = properties.getProperty("mail.smtp.ssl.enable");
 80 |         String username = properties.getProperty("mail.smtp.username");
 81 |         String password = properties.getProperty("mail.smtp.password");
 82 | 
 83 |         // create an email message with html support
 84 |         HtmlEmail email = new HtmlEmail();
 85 | 
 86 |         // configure SMTP connection
 87 |         email.setHostName(host);
 88 |         email.setSmtpPort(Integer.parseInt(port));
 89 |         email.setAuthentication(username, password);
 90 |         email.setSSLOnConnect(Boolean.parseBoolean(ssl));
 91 | 
 92 |         // set its properties accordingly
 93 |         email.setFrom(from);
 94 |         email.addTo(recipients.toArray(new String[]{}));
 95 |         email.setSubject(subject);
 96 |         email.setHtmlMsg(text);
 97 | 
 98 |         if (attachments != null) {
 99 |             for (int i = 0; i < attachments.size(); i++) {
100 |                 // create a data source to wrap the attachment and its mime type
101 |                 ByteArrayDataSource dataSource = new ByteArrayDataSource(attachments.get(i), mimeTypes.get(i));
102 | 
103 |                 // add the attachment
104 |                 email.attach(dataSource, fileNames.get(i), "attachment");
105 |             }
106 |         }
107 | 
108 |         // send it!
109 |         email.send();
110 |     }
111 | 
112 | }


--------------------------------------------------------------------------------
/commons-email-example/src/main/java/com/example/javamail/ExampleUI.java:
--------------------------------------------------------------------------------
 1 | package com.example.javamail;
 2 | 
 3 | import com.vaadin.annotations.VaadinServletConfiguration;
 4 | import com.vaadin.server.VaadinRequest;
 5 | import com.vaadin.server.VaadinServlet;
 6 | import com.vaadin.ui.*;
 7 | 
 8 | import javax.servlet.annotation.WebServlet;
 9 | import java.io.InputStream;
10 | 
11 | /**
12 |  * @author alejandro@vaadin.com
13 |  **/
14 | public class ExampleUI extends UI {
15 | 
16 |     @Override
17 |     protected void init(VaadinRequest vaadinRequest) {
18 |         // the text field where users will specify their email address
19 |         TextField textField = new TextField("Your email:");
20 | 
21 |         // a button with a click listener that sends the email
22 |         Button button = new Button("Send me the PDF", e -> sendEmail(textField.getValue()));
23 | 
24 |         // a layout containing the previous components
25 |         VerticalLayout layout = new VerticalLayout(textField, button);
26 |         setContent(layout); // sets the content for this UI
27 |     }
28 | 
29 |     private void sendEmail(String to) {
30 |         try {
31 |             // all values as variables to clarify its usage
32 |             InputStream inputStream = getClass().getResourceAsStream("/file.pdf");
33 |             String from = "sender@test.com";
34 |             String subject = "Your PDF";
35 |             String text = "Here there is your <b>PDF</b> file!";
36 |             String fileName = "file.pdf";
37 |             String mimeType = "application/pdf";
38 | 
39 |             // call the email service to send the message
40 |             CommonsEmailService.send(from, to, subject, text, inputStream, fileName, mimeType);
41 | 
42 |             inputStream.close();
43 | 
44 |             Notification.show("Email sent");
45 | 
46 |         } catch (Exception e) {
47 |             e.printStackTrace();
48 |             Notification.show("Error sending the email", Notification.Type.ERROR_MESSAGE);
49 |         }
50 |     }
51 | 
52 |     @WebServlet(urlPatterns = "/*", name = "ExampleUIServlet", asyncSupported = true)
53 |     @VaadinServletConfiguration(ui = ExampleUI.class, productionMode = false)
54 |     public static class ExampleUIServlet extends VaadinServlet {
55 |     }
56 | 
57 | }
58 | 


--------------------------------------------------------------------------------
/commons-email-example/src/main/resources/file.pdf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/alejandro-du/java-email-tutorial/e71768868e232aaab29730449ed3456be7f81ef1/commons-email-example/src/main/resources/file.pdf


--------------------------------------------------------------------------------
/commons-email-example/src/main/resources/mail.properties:
--------------------------------------------------------------------------------
 1 | # Test SMTP server:
 2 | mail.smtp.host=localhost
 3 | mail.smtp.port=9090
 4 | mail.smtp.username=sender@test.com
 5 | mail.smtp.password=password
 6 | mail.smtp.ssl.enable=false
 7 | 
 8 | # Gmail's SMTP server:
 9 | # mail.smtp.host=smtp.gmail.com
10 | # mail.smtp.port=465
11 | # mail.smtp.ssl.enable=true
12 | # mail.smtp.username=your-account@gmail.com
13 | # mail.smtp.password=your-password
14 | 


--------------------------------------------------------------------------------
/javamail-example/README.md:
--------------------------------------------------------------------------------
 1 | # Sending email using JavaMail
 2 | 
 3 | 1. Checkout the project form Git, and build and run with Maven:
 4 | 
 5 | ```
 6 | git clone https://github.com/alejandro-du/java-email-tutorial
 7 | 
 8 | cd java-email-tutorial
 9 | 
10 | cd javamail-example
11 | 
12 | mvn clean install
13 | 
14 | mvn jetty:run
15 | ```
16 | 
17 | 2. Download and run [FakeSMTP](https://nilhcem.github.io/FakeSMTP).
18 | 
19 | 3. Configure FakeSMTP listening port to `9090` and start the server.
20 | 
21 | 4. Open [http://localhost:8080](http://localhost:8080) in your browser.
22 | 


--------------------------------------------------------------------------------
/javamail-example/pom.xml:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0" encoding="UTF-8"?>
  2 | <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  3 |          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  4 |     <modelVersion>4.0.0</modelVersion>
  5 | 
  6 |     <groupId>org.test</groupId>
  7 |     <artifactId>vaadin-app</artifactId>
  8 |     <packaging>war</packaging>
  9 |     <version>1.0-SNAPSHOT</version>
 10 |     <name>vaadin-app</name>
 11 | 
 12 |     <prerequisites>
 13 |         <maven>3</maven>
 14 |     </prerequisites>
 15 | 
 16 |     <properties>
 17 |         <vaadin.version>8.0.5</vaadin.version>
 18 |         <vaadin.plugin.version>8.0.5</vaadin.plugin.version>
 19 |         <jetty.plugin.version>9.3.9.v20160517</jetty.plugin.version>
 20 |         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 21 |         <maven.compiler.source>1.8</maven.compiler.source>
 22 |         <maven.compiler.target>1.8</maven.compiler.target>
 23 |         <!-- If there are no local customisations, this can also be "fetch" or "cdn" -->
 24 |         <vaadin.widgetset.mode>local</vaadin.widgetset.mode>
 25 |     </properties>
 26 | 
 27 |     <repositories>
 28 |         <repository>
 29 |             <id>vaadin-addons</id>
 30 |             <url>http://maven.vaadin.com/vaadin-addons</url>
 31 |         </repository>
 32 |     </repositories>
 33 | 
 34 |     <dependencyManagement>
 35 |         <dependencies>
 36 |             <dependency>
 37 |                 <groupId>com.vaadin</groupId>
 38 |                 <artifactId>vaadin-bom</artifactId>
 39 |                 <version>${vaadin.version}</version>
 40 |                 <type>pom</type>
 41 |                 <scope>import</scope>
 42 |             </dependency>
 43 |         </dependencies>
 44 |     </dependencyManagement>
 45 | 
 46 |     <dependencies>
 47 |         <dependency>
 48 |             <groupId>javax.servlet</groupId>
 49 |             <artifactId>javax.servlet-api</artifactId>
 50 |             <version>3.0.1</version>
 51 |             <scope>provided</scope>
 52 |         </dependency>
 53 |         <dependency>
 54 |             <groupId>com.vaadin</groupId>
 55 |             <artifactId>vaadin-server</artifactId>
 56 |         </dependency>
 57 |         <dependency>
 58 |             <groupId>com.vaadin</groupId>
 59 |             <artifactId>vaadin-push</artifactId>
 60 |         </dependency>
 61 |         <dependency>
 62 |             <groupId>com.vaadin</groupId>
 63 |             <artifactId>vaadin-client-compiled</artifactId>
 64 |         </dependency>
 65 |         <dependency>
 66 |             <groupId>com.vaadin</groupId>
 67 |             <artifactId>vaadin-themes</artifactId>
 68 |         </dependency>
 69 |         <dependency>
 70 |             <groupId>org.apache.commons</groupId>
 71 |             <artifactId>commons-email</artifactId>
 72 |             <version>1.4</version>
 73 |         </dependency>
 74 |     </dependencies>
 75 | 
 76 |     <build>
 77 |         <plugins>
 78 |             <plugin>
 79 |                 <groupId>org.apache.maven.plugins</groupId>
 80 |                 <artifactId>maven-war-plugin</artifactId>
 81 |                 <version>3.0.0</version>
 82 |                 <configuration>
 83 |                     <failOnMissingWebXml>false</failOnMissingWebXml>
 84 |                     <!-- Exclude an unnecessary file generated by the GWT compiler. -->
 85 |                     <packagingExcludes>WEB-INF/classes/VAADIN/widgetsets/WEB-INF/**</packagingExcludes>
 86 |                 </configuration>
 87 |             </plugin>
 88 |             <plugin>
 89 |                 <groupId>com.vaadin</groupId>
 90 |                 <artifactId>vaadin-maven-plugin</artifactId>
 91 |                 <version>${vaadin.plugin.version}</version>
 92 |                 <executions>
 93 |                     <execution>
 94 |                         <goals>
 95 |                             <goal>update-theme</goal>
 96 |                             <goal>update-widgetset</goal>
 97 |                             <goal>compile</goal>
 98 |                             <!-- Comment out compile-theme goal to use on-the-fly theme compilation -->
 99 |                             <goal>compile-theme</goal>
100 |                         </goals>
101 |                     </execution>
102 |                 </executions>
103 |             </plugin>
104 |             <plugin>
105 |                 <groupId>org.apache.maven.plugins</groupId>
106 |                 <artifactId>maven-clean-plugin</artifactId>
107 |                 <version>3.0.0</version>
108 |                 <!-- Clean up also any pre-compiled themes -->
109 |                 <configuration>
110 |                     <filesets>
111 |                         <fileset>
112 |                             <directory>src/main/webapp/VAADIN/themes</directory>
113 |                             <includes>
114 |                                 <include>**/styles.css</include>
115 |                                 <include>**/styles.scss.cache</include>
116 |                             </includes>
117 |                         </fileset>
118 |                     </filesets>
119 |                 </configuration>
120 |             </plugin>
121 | 
122 |             <!-- The Jetty plugin allows us to easily test the development build by
123 |                 running jetty:run on the command line. -->
124 |             <plugin>
125 |                 <groupId>org.eclipse.jetty</groupId>
126 |                 <artifactId>jetty-maven-plugin</artifactId>
127 |                 <version>${jetty.plugin.version}</version>
128 |                 <configuration>
129 |                     <scanIntervalSeconds>2</scanIntervalSeconds>
130 |                 </configuration>
131 |             </plugin>
132 |         </plugins>
133 |     </build>
134 | 
135 |     <profiles>
136 |         <profile>
137 |             <!-- Vaadin pre-release repositories -->
138 |             <id>vaadin-prerelease</id>
139 |             <activation>
140 |                 <activeByDefault>false</activeByDefault>
141 |             </activation>
142 | 
143 |             <repositories>
144 |                 <repository>
145 |                     <id>vaadin-prereleases</id>
146 |                     <url>http://maven.vaadin.com/vaadin-prereleases</url>
147 |                 </repository>
148 |                 <repository>
149 |                     <id>vaadin-snapshots</id>
150 |                     <url>https://oss.sonatype.org/content/repositories/vaadin-snapshots/</url>
151 |                     <releases>
152 |                         <enabled>false</enabled>
153 |                     </releases>
154 |                     <snapshots>
155 |                         <enabled>true</enabled>
156 |                     </snapshots>
157 |                 </repository>
158 |             </repositories>
159 |             <pluginRepositories>
160 |                 <pluginRepository>
161 |                     <id>vaadin-prereleases</id>
162 |                     <url>http://maven.vaadin.com/vaadin-prereleases</url>
163 |                 </pluginRepository>
164 |                 <pluginRepository>
165 |                     <id>vaadin-snapshots</id>
166 |                     <url>https://oss.sonatype.org/content/repositories/vaadin-snapshots/</url>
167 |                     <releases>
168 |                         <enabled>false</enabled>
169 |                     </releases>
170 |                     <snapshots>
171 |                         <enabled>true</enabled>
172 |                     </snapshots>
173 |                 </pluginRepository>
174 |             </pluginRepositories>
175 |         </profile>
176 |     </profiles>
177 | 
178 | </project>
179 | 


--------------------------------------------------------------------------------
/javamail-example/src/main/java/com/example/javamail/ExampleUI.java:
--------------------------------------------------------------------------------
 1 | package com.example.javamail;
 2 | 
 3 | import com.vaadin.annotations.VaadinServletConfiguration;
 4 | import com.vaadin.server.VaadinRequest;
 5 | import com.vaadin.server.VaadinServlet;
 6 | import com.vaadin.ui.*;
 7 | 
 8 | import javax.servlet.annotation.WebServlet;
 9 | import java.io.InputStream;
10 | 
11 | /**
12 |  * @author alejandro@vaadin.com
13 |  **/
14 | public class ExampleUI extends UI {
15 | 
16 |     @Override
17 |     protected void init(VaadinRequest vaadinRequest) {
18 |         // the text field where users will specify their email address
19 |         TextField textField = new TextField("Your email:");
20 | 
21 |         // a button with a click listener that sends the email
22 |         Button button = new Button("Send me the PDF", e -> sendEmail(textField.getValue()));
23 | 
24 |         // a layout containing the previous components
25 |         VerticalLayout layout = new VerticalLayout(textField, button);
26 |         setContent(layout); // sets the content for this UI
27 |     }
28 | 
29 |     private void sendEmail(String to) {
30 |         try {
31 |             // all values as variables to clarify its usage
32 |             InputStream inputStream = getClass().getResourceAsStream("/file.pdf");
33 |             String from = "sender@test.com";
34 |             String subject = "Your PDF";
35 |             String text = "Here there is your <b>PDF</b> file!";
36 |             String fileName = "file.pdf";
37 |             String mimeType = "application/pdf";
38 | 
39 |             // call the mail service to send the message
40 |             JavaMailService.send(from, to, subject, text, inputStream, fileName, mimeType);
41 | 
42 |             inputStream.close();
43 | 
44 |             Notification.show("Email sent");
45 | 
46 |         } catch (Exception e) {
47 |             e.printStackTrace();
48 |             Notification.show("Error sending the email", Notification.Type.ERROR_MESSAGE);
49 |         }
50 |     }
51 | 
52 |     @WebServlet(urlPatterns = "/*", name = "ExampleUIServlet", asyncSupported = true)
53 |     @VaadinServletConfiguration(ui = ExampleUI.class, productionMode = false)
54 |     public static class ExampleUIServlet extends VaadinServlet {
55 |     }
56 | 
57 | }
58 | 


--------------------------------------------------------------------------------
/javamail-example/src/main/java/com/example/javamail/JavaMailService.java:
--------------------------------------------------------------------------------
  1 | package com.example.javamail;
  2 | 
  3 | import javax.activation.DataHandler;
  4 | import javax.mail.Message;
  5 | import javax.mail.MessagingException;
  6 | import javax.mail.Session;
  7 | import javax.mail.Transport;
  8 | import javax.mail.internet.MimeBodyPart;
  9 | import javax.mail.internet.MimeMessage;
 10 | import javax.mail.internet.MimeMultipart;
 11 | import javax.mail.util.ByteArrayDataSource;
 12 | import java.io.IOException;
 13 | import java.io.InputStream;
 14 | import java.util.*;
 15 | 
 16 | /**
 17 |  * @author alejandro@vaadin.com
 18 |  **/
 19 | public class JavaMailService {
 20 | 
 21 |     /**
 22 |      * Sends an email message with no attachments.
 23 |      *
 24 |      * @param from       email address from which the message will be sent.
 25 |      * @param recipients the recipients of the message.
 26 |      * @param subject    subject header field.
 27 |      * @param text       content of the message.
 28 |      * @throws MessagingException
 29 |      * @throws IOException
 30 |      */
 31 |     public static void send(String from, Collection<String> recipients, String subject, String text)
 32 |             throws MessagingException, IOException {
 33 |         send(from, recipients, subject, text, null, null, null);
 34 |     }
 35 | 
 36 |     /**
 37 |      * Sends an email message to one recipient with one attachment.
 38 |      *
 39 |      * @param from       email address from which the message will be sent.
 40 |      * @param recipient  the recipients of the message.
 41 |      * @param subject    subject header field.
 42 |      * @param text       content of the message.
 43 |      * @param attachment attachment to be included with the message.
 44 |      * @param fileName   file name of the attachment.
 45 |      * @param mimeType   mime type of the attachment.
 46 |      * @throws MessagingException
 47 |      * @throws IOException
 48 |      */
 49 |     public static void send(String from, String recipient, String subject, String text, InputStream attachment,
 50 |                             String fileName, String mimeType)
 51 |             throws MessagingException, IOException {
 52 |         send(from, Arrays.asList(recipient), subject, text, Arrays.asList(attachment), Arrays.asList(fileName),
 53 |                 Arrays.asList(mimeType));
 54 |     }
 55 | 
 56 |     /**
 57 |      * Sends an email message with attachments.
 58 |      *
 59 |      * @param from        email address from which the message will be sent.
 60 |      * @param recipients  array of strings containing the recipients of the message.
 61 |      * @param subject     subject header field.
 62 |      * @param text        content of the message.
 63 |      * @param attachments attachments to be included with the message.
 64 |      * @param fileNames   file names for each attachment.
 65 |      * @param mimeTypes   mime types for each attachment.
 66 |      * @throws MessagingException
 67 |      * @throws IOException
 68 |      */
 69 |     public static void send(String from, Collection<String> recipients, String subject, String text,
 70 |                             List<InputStream> attachments, List<String> fileNames, List<String> mimeTypes)
 71 |             throws MessagingException, IOException {
 72 |         // check for null references
 73 |         Objects.requireNonNull(from);
 74 |         Objects.requireNonNull(recipients);
 75 | 
 76 |         // a message with attachments consists of several parts in a multipart
 77 |         MimeMultipart multipart = new MimeMultipart();
 78 | 
 79 |         // create text part
 80 |         MimeBodyPart textPart = new MimeBodyPart();
 81 |         textPart.setText(text, "utf-8", "html");
 82 | 
 83 |         // add the text part to the multipart
 84 |         multipart.addBodyPart(textPart);
 85 | 
 86 |         // create attachment parts if required
 87 |         if (attachments != null) {
 88 |             // check that attachment and fileNames arrays sizes match
 89 |             if (attachments.size() != fileNames.size() || attachments.size() != mimeTypes.size()) {
 90 |                 throw new IllegalArgumentException(
 91 |                         "Attachments, file names, and mime types array sizes must match");
 92 |             }
 93 | 
 94 |             // create parts and add them to the multipart
 95 |             for (int i = 0; i < attachments.size(); i++) {
 96 |                 // create a data source to wrap the attachment and its mime type
 97 |                 ByteArrayDataSource dataSource = new ByteArrayDataSource(attachments.get(i), mimeTypes.get(i));
 98 | 
 99 |                 // create a dataHandler wrapping the data source
100 |                 DataHandler dataHandler = new DataHandler(dataSource);
101 | 
102 |                 // create a body part for the attachment and set its data handler and file name
103 |                 MimeBodyPart attachmentPart = new MimeBodyPart();
104 |                 attachmentPart.setDataHandler(dataHandler);
105 |                 attachmentPart.setFileName(fileNames.get(i));
106 | 
107 |                 // add the body part to the multipart
108 |                 multipart.addBodyPart(attachmentPart);
109 |             }
110 |         }
111 | 
112 |         // load email configuration from properties file
113 |         Properties properties = new Properties();
114 |         properties.load(JavaMailService.class.getResourceAsStream("/mail.properties"));
115 | 
116 |         // create a Session instance specifying the system properties
117 |         Session session = Session.getInstance(properties);
118 | 
119 |         // create a message instance associated to the session
120 |         MimeMessage message = new MimeMessage(session);
121 | 
122 |         // set the multipart as content for the message
123 |         message.setContent(multipart);
124 | 
125 |         // configure from address, add recipients, and set the subject of the message
126 |         message.setFrom(from);
127 |         message.addRecipients(Message.RecipientType.TO, String.join(",", recipients));
128 |         message.setSubject(subject);
129 | 
130 |         // send the message
131 |         String username = properties.getProperty("mail.smtp.username");
132 |         String password = properties.getProperty("mail.smtp.password");
133 |         Transport.send(message, username, password);
134 |     }
135 | 
136 | }
137 | 


--------------------------------------------------------------------------------
/javamail-example/src/main/resources/file.pdf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/alejandro-du/java-email-tutorial/e71768868e232aaab29730449ed3456be7f81ef1/javamail-example/src/main/resources/file.pdf


--------------------------------------------------------------------------------
/javamail-example/src/main/resources/mail.properties:
--------------------------------------------------------------------------------
 1 | # Test SMTP server:
 2 | mail.smtp.host=localhost
 3 | mail.smtp.port=9090
 4 | 
 5 | # Gmail's SMTP server:
 6 | # mail.smtp.host=smtp.gmail.com
 7 | # mail.smtp.port=465
 8 | # mail.smtp.ssl.enable=true
 9 | # mail.smtp.username=your-account@gmail.com
10 | # mail.smtp.password=your-password
11 | 


--------------------------------------------------------------------------------
/spring-mail-example/README.md:
--------------------------------------------------------------------------------
 1 | # Sending email using JavaMail
 2 | 
 3 | 1. Checkout the project form Git, and build and run with Maven:
 4 | 
 5 | ```
 6 | git clone https://github.com/alejandro-du/java-email-tutorial
 7 | 
 8 | cd java-email-tutorial
 9 | 
10 | cd spring-mail-example
11 | 
12 | mvn clean install
13 | 
14 | mvn jetty:run
15 | ```
16 | 
17 | 2. Download and run [FakeSMTP](https://nilhcem.github.io/FakeSMTP).
18 | 
19 | 3. Configure FakeSMTP listening port to `9090` and start the server.
20 | 
21 | 4. Open [http://localhost:8080](http://localhost:8080) in your browser.
22 | 


--------------------------------------------------------------------------------
/spring-mail-example/pom.xml:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0" encoding="UTF-8"?>
  2 | <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  3 | 		 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  4 | 	<modelVersion>4.0.0</modelVersion>
  5 | 
  6 | 	<groupId>org.test</groupId>
  7 | 	<artifactId>vaadin-app</artifactId>
  8 | 	<packaging>war</packaging>
  9 | 	<version>1.0-SNAPSHOT</version>
 10 | 	<name>vaadin-app</name>
 11 | 
 12 | 	<prerequisites>
 13 | 		<maven>3</maven>
 14 | 	</prerequisites>
 15 | 
 16 | 	<properties>
 17 | 		<vaadin.version>8.0.5</vaadin.version>
 18 | 		<vaadin.plugin.version>8.0.5</vaadin.plugin.version>
 19 | 		<jetty.plugin.version>9.3.9.v20160517</jetty.plugin.version>
 20 | 		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 21 | 		<maven.compiler.source>1.8</maven.compiler.source>
 22 | 		<maven.compiler.target>1.8</maven.compiler.target>
 23 | 		<!-- If there are no local customisations, this can also be "fetch" or "cdn" -->
 24 | 		<vaadin.widgetset.mode>local</vaadin.widgetset.mode>
 25 | 	</properties>
 26 | 
 27 | 	<repositories>
 28 | 		<repository>
 29 | 			<id>vaadin-addons</id>
 30 | 			<url>http://maven.vaadin.com/vaadin-addons</url>
 31 | 		</repository>
 32 | 	</repositories>
 33 | 
 34 | 	<dependencyManagement>
 35 | 		<dependencies>
 36 | 			<dependency>
 37 | 				<groupId>com.vaadin</groupId>
 38 | 				<artifactId>vaadin-bom</artifactId>
 39 | 				<version>${vaadin.version}</version>
 40 | 				<type>pom</type>
 41 | 				<scope>import</scope>
 42 | 			</dependency>
 43 | 		</dependencies>
 44 | 	</dependencyManagement>
 45 | 
 46 | 	<dependencies>
 47 | 		<dependency>
 48 | 			<groupId>javax.servlet</groupId>
 49 | 			<artifactId>javax.servlet-api</artifactId>
 50 | 			<version>3.0.1</version>
 51 | 			<scope>provided</scope>
 52 | 		</dependency>
 53 | 		<dependency>
 54 | 			<groupId>com.vaadin</groupId>
 55 | 			<artifactId>vaadin-server</artifactId>
 56 | 		</dependency>
 57 | 		<dependency>
 58 | 			<groupId>com.vaadin</groupId>
 59 | 			<artifactId>vaadin-push</artifactId>
 60 | 		</dependency>
 61 | 		<dependency>
 62 | 			<groupId>com.vaadin</groupId>
 63 | 			<artifactId>vaadin-client-compiled</artifactId>
 64 | 		</dependency>
 65 | 		<dependency>
 66 | 			<groupId>com.vaadin</groupId>
 67 | 			<artifactId>vaadin-themes</artifactId>
 68 | 		</dependency>
 69 | 
 70 | 		<!-- JavaMail -->
 71 | 		<dependency>
 72 | 			<groupId>javax.mail</groupId>
 73 | 			<artifactId>mail</artifactId>
 74 | 			<version>1.5.0-b01</version>
 75 | 		</dependency>
 76 | 
 77 | 		<!-- Spring Email Support -->
 78 | 		<dependency>
 79 | 			<groupId>org.springframework</groupId>
 80 | 			<artifactId>spring-context-support</artifactId>
 81 | 			<version>4.2.4.RELEASE</version>
 82 | 		</dependency>
 83 | 
 84 | 		<!-- Vaadin/Spring integration -->
 85 | 		<dependency>
 86 | 			<groupId>com.vaadin</groupId>
 87 | 			<artifactId>vaadin-spring</artifactId>
 88 | 			<version>2.0.1</version>
 89 | 		</dependency>
 90 | 	</dependencies>
 91 | 
 92 | 	<build>
 93 | 		<plugins>
 94 | 			<plugin>
 95 | 				<groupId>org.apache.maven.plugins</groupId>
 96 | 				<artifactId>maven-war-plugin</artifactId>
 97 | 				<version>3.0.0</version>
 98 | 				<configuration>
 99 | 					<failOnMissingWebXml>false</failOnMissingWebXml>
100 | 					<!-- Exclude an unnecessary file generated by the GWT compiler. -->
101 | 					<packagingExcludes>WEB-INF/classes/VAADIN/widgetsets/WEB-INF/**</packagingExcludes>
102 | 				</configuration>
103 | 			</plugin>
104 | 			<plugin>
105 | 				<groupId>com.vaadin</groupId>
106 | 				<artifactId>vaadin-maven-plugin</artifactId>
107 | 				<version>${vaadin.plugin.version}</version>
108 | 				<executions>
109 | 					<execution>
110 | 						<goals>
111 | 							<goal>update-theme</goal>
112 | 							<goal>update-widgetset</goal>
113 | 							<goal>compile</goal>
114 | 							<!-- Comment out compile-theme goal to use on-the-fly theme compilation -->
115 | 							<goal>compile-theme</goal>
116 | 						</goals>
117 | 					</execution>
118 | 				</executions>
119 | 			</plugin>
120 | 			<plugin>
121 | 				<groupId>org.apache.maven.plugins</groupId>
122 | 				<artifactId>maven-clean-plugin</artifactId>
123 | 				<version>3.0.0</version>
124 | 				<!-- Clean up also any pre-compiled themes -->
125 | 				<configuration>
126 | 					<filesets>
127 | 						<fileset>
128 | 							<directory>src/main/webapp/VAADIN/themes</directory>
129 | 							<includes>
130 | 								<include>**/styles.css</include>
131 | 								<include>**/styles.scss.cache</include>
132 | 							</includes>
133 | 						</fileset>
134 | 					</filesets>
135 | 				</configuration>
136 | 			</plugin>
137 | 
138 | 			<!-- The Jetty plugin allows us to easily test the development build by
139 |                 running jetty:run on the command line. -->
140 | 			<plugin>
141 | 				<groupId>org.eclipse.jetty</groupId>
142 | 				<artifactId>jetty-maven-plugin</artifactId>
143 | 				<version>${jetty.plugin.version}</version>
144 | 				<configuration>
145 | 					<scanIntervalSeconds>2</scanIntervalSeconds>
146 | 				</configuration>
147 | 			</plugin>
148 | 		</plugins>
149 | 	</build>
150 | 
151 | 	<profiles>
152 | 		<profile>
153 | 			<!-- Vaadin pre-release repositories -->
154 | 			<id>vaadin-prerelease</id>
155 | 			<activation>
156 | 				<activeByDefault>false</activeByDefault>
157 | 			</activation>
158 | 
159 | 			<repositories>
160 | 				<repository>
161 | 					<id>vaadin-prereleases</id>
162 | 					<url>http://maven.vaadin.com/vaadin-prereleases</url>
163 | 				</repository>
164 | 				<repository>
165 | 					<id>vaadin-snapshots</id>
166 | 					<url>https://oss.sonatype.org/content/repositories/vaadin-snapshots/</url>
167 | 					<releases>
168 | 						<enabled>false</enabled>
169 | 					</releases>
170 | 					<snapshots>
171 | 						<enabled>true</enabled>
172 | 					</snapshots>
173 | 				</repository>
174 | 			</repositories>
175 | 			<pluginRepositories>
176 | 				<pluginRepository>
177 | 					<id>vaadin-prereleases</id>
178 | 					<url>http://maven.vaadin.com/vaadin-prereleases</url>
179 | 				</pluginRepository>
180 | 				<pluginRepository>
181 | 					<id>vaadin-snapshots</id>
182 | 					<url>https://oss.sonatype.org/content/repositories/vaadin-snapshots/</url>
183 | 					<releases>
184 | 						<enabled>false</enabled>
185 | 					</releases>
186 | 					<snapshots>
187 | 						<enabled>true</enabled>
188 | 					</snapshots>
189 | 				</pluginRepository>
190 | 			</pluginRepositories>
191 | 		</profile>
192 | 	</profiles>
193 | 
194 | </project>
195 | 


--------------------------------------------------------------------------------
/spring-mail-example/src/main/java/com/example/javamail/ExampleUI.java:
--------------------------------------------------------------------------------
 1 | package com.example.javamail;
 2 | 
 3 | import com.vaadin.server.VaadinRequest;
 4 | import com.vaadin.spring.annotation.EnableVaadin;
 5 | import com.vaadin.spring.annotation.SpringUI;
 6 | import com.vaadin.spring.server.SpringVaadinServlet;
 7 | import com.vaadin.ui.*;
 8 | import org.springframework.beans.factory.annotation.Autowired;
 9 | import org.springframework.context.annotation.Configuration;
10 | import org.springframework.web.context.ContextLoaderListener;
11 | 
12 | import javax.servlet.annotation.WebListener;
13 | import javax.servlet.annotation.WebServlet;
14 | import java.io.InputStream;
15 | 
16 | /**
17 |  * @author alejandro@vaadin.com
18 |  **/
19 | @SpringUI
20 | public class ExampleUI extends UI {
21 | 
22 |     @Autowired
23 |     private SpringEmailService springEmailService;
24 | 
25 |     @Override
26 |     protected void init(VaadinRequest vaadinRequest) {
27 |         // the text field where users will specify their email address
28 |         TextField textField = new TextField("Your email:");
29 | 
30 |         // a button with a click listener that sends the email
31 |         Button button = new Button("Send me the PDF", e -> sendEmail(textField.getValue()));
32 | 
33 |         // a layout containing the previous components
34 |         VerticalLayout layout = new VerticalLayout(textField, button);
35 |         setContent(layout); // sets the content for this UI
36 |     }
37 | 
38 |     private void sendEmail(String to) {
39 |         try {
40 |             // all values as variables to clarify its usage
41 |             InputStream inputStream = getClass().getResourceAsStream("/file.pdf");
42 |             String from = "sender@test.com";
43 |             String subject = "Your PDF";
44 |             String text = "Here there is your <b>PDF</b> file!";
45 |             String fileName = "file.pdf";
46 |             String mimeType = "application/pdf";
47 | 
48 |             springEmailService.send(from, to, subject, text, inputStream, fileName, mimeType);
49 | 
50 |             inputStream.close();
51 | 
52 |             Notification.show("Email sent");
53 | 
54 |         } catch (Exception e) {
55 |             e.printStackTrace();
56 |             Notification.show("Error sending the email", Notification.Type.ERROR_MESSAGE);
57 |         }
58 |     }
59 | 
60 |     @WebServlet(value = "/*", asyncSupported = true)
61 |     public static class Servlet extends SpringVaadinServlet {
62 |     }
63 | 
64 |     @WebListener
65 |     public static class MyContextLoaderListener extends ContextLoaderListener {
66 |     }
67 | 
68 |     @Configuration
69 |     @EnableVaadin
70 |     public static class MyConfiguration {
71 |     }
72 | 
73 | }
74 | 


--------------------------------------------------------------------------------
/spring-mail-example/src/main/java/com/example/javamail/SpringEmailService.java:
--------------------------------------------------------------------------------
  1 | package com.example.javamail;
  2 | 
  3 | import org.springframework.mail.javamail.JavaMailSenderImpl;
  4 | import org.springframework.mail.javamail.MimeMessageHelper;
  5 | import org.springframework.stereotype.Service;
  6 | 
  7 | import javax.mail.MessagingException;
  8 | import javax.mail.internet.MimeMessage;
  9 | import javax.mail.util.ByteArrayDataSource;
 10 | import java.io.IOException;
 11 | import java.io.InputStream;
 12 | import java.util.*;
 13 | 
 14 | /**
 15 |  * @author alejandro@vaadin.com
 16 |  **/
 17 | @Service
 18 | public class SpringEmailService {
 19 | 
 20 |     /**
 21 |      * Sends an email message with no attachments.
 22 |      *
 23 |      * @param from       email address from which the message will be sent.
 24 |      * @param recipients the recipients of the message.
 25 |      * @param subject    subject header field.
 26 |      * @param text       content of the message.
 27 |      * @throws MessagingException
 28 |      * @throws IOException
 29 |      */
 30 |     public static void send(String from, Collection<String> recipients, String subject, String text)
 31 |             throws MessagingException, IOException {
 32 |         send(from, recipients, subject, text, null, null, null);
 33 |     }
 34 | 
 35 |     /**
 36 |      * Sends an email message to one recipient with one attachment.
 37 |      *
 38 |      * @param from       email address from which the message will be sent.
 39 |      * @param recipient  the recipients of the message.
 40 |      * @param subject    subject header field.
 41 |      * @param text       content of the message.
 42 |      * @param attachment attachment to be included with the message.
 43 |      * @param fileName   file name of the attachment.
 44 |      * @param mimeType   mime type of the attachment.
 45 |      * @throws MessagingException
 46 |      * @throws IOException
 47 |      */
 48 |     public static void send(String from, String recipient, String subject, String text,
 49 |                             InputStream attachment, String fileName, String mimeType)
 50 |             throws MessagingException, IOException {
 51 |         send(from, Arrays.asList(recipient), subject, text, Arrays.asList(attachment), Arrays.asList(fileName),
 52 |                 Arrays.asList(mimeType));
 53 |     }
 54 | 
 55 |     /**
 56 |      * Sends an email message with attachments.
 57 |      *
 58 |      * @param from        email address from which the message will be sent.
 59 |      * @param recipients  array of strings containing the recipients of the message.
 60 |      * @param subject     subject header field.
 61 |      * @param text        content of the message.
 62 |      * @param attachments attachments to be included with the message.
 63 |      * @param fileNames   file names for each attachment.
 64 |      * @param mimeTypes   mime types for each attachment.
 65 |      * @throws MessagingException
 66 |      * @throws IOException
 67 |      */
 68 |     public static void send(String from, Collection<String> recipients, String subject, String text,
 69 |                             List<InputStream> attachments, List<String> fileNames, List<String> mimeTypes)
 70 |             throws MessagingException, IOException {
 71 | 
 72 |         // check for null references
 73 |         Objects.requireNonNull(from);
 74 |         Objects.requireNonNull(recipients);
 75 | 
 76 |         // load email configuration from properties file
 77 |         Properties properties = new Properties();
 78 |         properties.load(SpringEmailService.class.getResourceAsStream("/mail.properties"));
 79 |         String username = properties.getProperty("mail.smtp.username");
 80 |         String password = properties.getProperty("mail.smtp.password");
 81 | 
 82 |         // configure the connection to the SMTP server
 83 |         JavaMailSenderImpl mailSender = new JavaMailSenderImpl();
 84 |         mailSender.setJavaMailProperties(properties);
 85 |         mailSender.setUsername(username);
 86 |         mailSender.setPassword(password);
 87 | 
 88 |         MimeMessage message = mailSender.createMimeMessage();
 89 |         MimeMessageHelper helper = new MimeMessageHelper(message, true);
 90 |         helper.setFrom(from);
 91 |         helper.setSubject(subject);
 92 |         helper.setText(text, true);
 93 | 
 94 |         for (String recipient : recipients) {
 95 |             helper.addTo(recipient);
 96 |         }
 97 | 
 98 |         if (attachments != null) {
 99 |             for (int i = 0; i < attachments.size(); i++) {
100 |                 // create a data source to wrap the attachment and its mime type
101 |                 ByteArrayDataSource dataSource = new ByteArrayDataSource(attachments.get(i), mimeTypes.get(i));
102 | 
103 |                 // add the attachment
104 |                 helper.addAttachment(fileNames.get(i), dataSource);
105 |             }
106 |         }
107 | 
108 |         mailSender.send(message);
109 |     }
110 | 
111 | }
112 | 


--------------------------------------------------------------------------------
/spring-mail-example/src/main/resources/file.pdf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/alejandro-du/java-email-tutorial/e71768868e232aaab29730449ed3456be7f81ef1/spring-mail-example/src/main/resources/file.pdf


--------------------------------------------------------------------------------
/spring-mail-example/src/main/resources/mail.properties:
--------------------------------------------------------------------------------
 1 | # Test SMTP server:
 2 | mail.smtp.host=localhost
 3 | mail.smtp.port=9090
 4 | 
 5 | # Gmail's SMTP server:
 6 | # mail.smtp.host=smtp.gmail.com
 7 | # mail.smtp.port=465
 8 | # mail.smtp.ssl.enable=true
 9 | # mail.smtp.username=your-account@gmail.com
10 | # mail.smtp.password=your-password
11 | 


--------------------------------------------------------------------------------
/spring-mail-example/src/main/webapp/WEB-INF/applicationContext.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <beans xmlns="http://www.springframework.org/schema/beans"
 3 |        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 4 |        xmlns:context="http://www.springframework.org/schema/context"
 5 |        xsi:schemaLocation="http://www.springframework.org/schema/beans
 6 |                            http://www.springframework.org/schema/beans/spring-beans.xsd
 7 |                            http://www.springframework.org/schema/context
 8 |                            http://www.springframework.org/schema/context/spring-context-4.1.xsd">
 9 | 
10 |     <bean class="com.example.javamail.ExampleUI.MyConfiguration"/>
11 |     <context:component-scan base-package="com.example"/>
12 | </beans>


--------------------------------------------------------------------------------