spring-boot實戰【12】:Spring Boot中使用JavaMailSender發送郵件
相信使用過Spring的眾多開發者都知道Spring提供了非常好用的JavaMailSender
接口實現郵件發送。在Spring Boot的Starter模塊中也為此提供了自動化配置。下面通過實例看看如何在Spring Boot中使用JavaMailSender
發送郵件。
快速入門
在Spring Boot的工程中的pom.xml
中引入spring-boot-starter-mail
依賴:
1 2 3 4 |
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-mail</artifactId> |
如其他自動化配置模塊一樣,在完成了依賴引入之後,只需要在application.properties
中配置相應的屬性內容。
下面我們以QQ郵箱為例,在application.properties
中加入如下配置(註意替換自己的用戶名和密碼):
1 2 3 4 5 6 |
spring.mail.host=smtp.qq.com
spring.mail.username=用戶名
spring.mail.password=密碼
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.starttls.enable=true |
通過單元測試來實現一封簡單郵件的發送:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
public class ApplicationTests {
private JavaMailSender mailSender; |
到這裏,一個簡單的郵件發送就完成了,運行一下該單元測試,看看效果如何?
由於Spring Boot的starter模塊提供了自動化配置,所以在引入了
spring-boot-starter-mail
依賴之後,會根據配置文件中的內容去創建JavaMailSender
實例,因此我們可以直接在需要使用的地方直接@Autowired
來引入郵件發送對象。
進階使用
在上例中,我們通過使用SimpleMailMessage
實現了簡單的郵件發送,但是實際使用過程中,我們還可能會帶上附件、或是使用郵件模塊等。這個時候我們就需要使用MimeMessage
來設置復雜一些的郵件內容,下面我們就來依次實現一下。
發送附件
在上面單元測試中加入如下測試用例(通過MimeMessageHelper來發送一封帶有附件的郵件):
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 | public void sendAttachmentsMail() throws Exception { MimeMessage mimeMessage = mailSender.createMimeMessage(); MimeMessageHelper helper = new MimeMessageHelper(mimeMessage, true); helper.setFrom("[email protected]"); helper.setTo("[email protected]"); helper.setSubject("主題:有附件"); helper.setText("有附件的郵件"); FileSystemResource file = new FileSystemResource(new File("weixin.jpg")); helper.addAttachment("附件-1.jpg", file); helper.addAttachment("附件-2.jpg", file); mailSender.send(mimeMessage); } |
嵌入靜態資源
除了發送附件之外,我們在郵件內容中可能希望通過嵌入圖片等靜態資源,讓郵件獲得更好的閱讀體驗,而不是從附件中查看具體圖片,下面的測試用例演示了如何通過MimeMessageHelper
實現在郵件正文中嵌入靜態資源。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 | public void sendInlineMail() throws Exception { MimeMessage mimeMessage = mailSender.createMimeMessage(); MimeMessageHelper helper = new MimeMessageHelper(mimeMessage, true); helper.setFrom("[email protected]"); helper.setTo("[email protected]"); helper.setSubject("主題:嵌入靜態資源"); helper.setText("<html><body><img src=\"cid:weixin\" ></body></html>", true); FileSystemResource file = new FileSystemResource(new File("weixin.jpg")); helper.addInline("weixin", file); mailSender.send(mimeMessage); } |
這裏需要註意的是addInline
函數中資源名稱weixin
需要與正文中cid:weixin
對應起來
模板郵件
通常我們使用郵件發送服務的時候,都會有一些固定的場景,比如重置密碼、註冊確認等,給每個用戶發送的內容可能只有小部分是變化的。所以,很多時候我們會使用模板引擎來為各類郵件設置成模板,這樣我們只需要在發送時去替換變化部分的參數即可。
在Spring Boot中使用模板引擎來實現模板化的郵件發送也是非常容易的,下面我們以velocity為例實現一下。
引入velocity模塊的依賴:
1 2 3 4 | <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-velocity</artifactId> </dependency> |
在resources/templates/
下,創建一個模板頁面template.vm
:
1 2 3 4 5 | <html> <body> <h3>你好, ${username}, 這是一封模板郵件!</h3> </body> </html> |
我們之前在Spring Boot中開發Web應用時,提到過在Spring Boot的自動化配置下,模板默認位於resources/templates/
目錄下
最後,我們在單元測試中加入發送模板郵件的測試用例,具體如下:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 | public void sendTemplateMail() throws Exception { MimeMessage mimeMessage = mailSender.createMimeMessage(); MimeMessageHelper helper = new MimeMessageHelper(mimeMessage, true); helper.setFrom("[email protected]"); helper.setTo("[email protected]"); helper.setSubject("主題:模板郵件"); Map<String, Object> model = new HashedMap(); model.put("username", "didi"); String text = VelocityEngineUtils.mergeTemplateIntoString( velocityEngine, "template.vm", "UTF-8", model); helper.setText(text, true); mailSender.send(mimeMessage); } |
嘗試運行一下,就可以收到內容為你好, didi, 這是一封模板郵件!
的郵件。這裏,我們通過傳入username的參數,在郵件內容中替換了模板中的${username}
變量。
完整示例:Chapter4-5-1
【轉載請註明出處】:http://blog.didispace.com/springbootmailsender/
spring-boot實戰【12】:Spring Boot中使用JavaMailSender發送郵件