您好,登錄后才能下訂單哦!
本篇文章為大家展示了SpringBoot中的利用Email發送功能怎么利用Thymeleaf實現,內容簡明扼要并且容易理解,絕對能使你眼前一亮,通過這篇文章的詳細介紹希望你能有所收獲。
添加依賴(Mail starter dependencies)
首先制作并且通過SMTP郵件服務器來發送一個純文本郵件。
如果你之前有用過Spring Boot的話,那你寧該并不好奇在你建立一個新工程的時候,Spring Boot已經幫你繼承了常用的依賴庫。 通常你只需要在你的 pom.xml 中添加如下依賴即可:
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-mail</artifactId> </dependency>
郵件服務器屬性配置(Properties configuration)
通常情況下,如果所需要的依賴在 class path 中都是可用的話,這時候Spring會自動幫你注冊一個默認實現的郵件發送服務 (default mail sender service)。 spring.mail.host 屬性已經被自動定義了, 所有我們所需要做的事情就是把這個屬性添加到我們應用的 application.properties 配置文件中。
application.properties 在resource文件夾下
Spring Boot 提供的默認郵件發送服務 其實已經非常強大了,我們可以通過簡單的配置它的屬性就可以了。所謂的屬性其實說白了就是配置它的郵件SMTP 服務器:
spring.mail.port=25 # SMTP server port spring.mail.username= # Login used for authentication spring.mail.password= # Password for the given login spring.mail.protocol=smtp spring.mail.defaultEncoding=UTF-8 # Default message encoding
這里附帶一份 gmail 的SMTP服務器配置清單:
spring.mail.host = smtp.gmail.com spring.mail.username = *****@gmail.com spring.mail.password = **** spring.mail.properties.mail.smtp.auth = true spring.mail.properties.mail.smtp.socketFactory.port = 587 spring.mail.properties.mail.smtp.socketFactory.class = javax.net.ssl.SSLSocketFactory spring.mail.properties.mail.smtp.socketFactory.fallback = false
郵件發送服務(Mail sending service)
在這里我們使用 Autowired 在注入我們的service, 它主要就是生成郵件的相關信息
@Service public class MailClient { private JavaMailSender mailSender; @Autowired public MailService(JavaMailSender mailSender) { this.mailSender = mailSender; } public void prepareAndSend(String recipient, String message) { //TODO implement } }
生成郵件內容
下面是一個簡單的生成郵件內容的代碼。
public void prepareAndSend(String recipient, String message) { MimeMessagePreparator messagePreparator = mimeMessage -> { MimeMessageHelper messageHelper = new MimeMessageHelper(mimeMessage); messageHelper.setFrom("sample@dolszewski.com"); messageHelper.setTo(recipient); messageHelper.setSubject("Sample mail subject"); messageHelper.setText(message); }; try { mailSender.send(messagePreparator); } catch (MailException e) { // runtime exception; compiler will not force you to handle it } }
send() 需要被重寫以接受不同類型的參數變量:
MimeMessageHelper類是MimeMessage的裝飾類,它提供了更多的開發人員友好界面,并為類的許多屬性添加了輸入驗證。你可以不用,但是別人肯定會用,而且你會后悔不用 XD。
send() 會拋出 **MailException ** 異常,這是個運行時異常,也就是通常所說的 RuntimeException。 在消息傳遞失敗的情況下,很可能會重復發送操作,或者至少使用一些更復雜的解決方案處理這種情況,例如:使用相應的堆棧跟蹤記錄錯誤消息。
手動測試
通常如果你想郵件功能,你首先需要擁有一個SMTP服務器在你本機的電腦上處理你的請求。 如果你還沒用過,下面給你們推薦一些常用的:
集成測試
你可能或許會感到好奇應該如果寫一個自動化的Test來驗證你客戶端的功能。 如果你手動測試的話,你需要開啟SMTP 服務器然后在運行你的Spring Boot客戶端。 在這里給大家推薦一個神器 GreenMail, 因為他跟Junit單元測試高度集成,可以簡化我們的測試。
添加依賴
GreenMail 已經在Maven倉庫中了,所以我們唯一所需要做的就是將其依賴加入我們的 pom.xml 配置文件中:
<dependency> <groupId>com.icegreen</groupId> <artifactId>greenmail</artifactId> <version>1.5.0</version> <scope>test</scope> </dependency>
SMTP服務器與Test模板
現在呢,說了這么多廢話,我們終于可以創建我們的第一個集成測試類了。 它會啟動Spring應用程序并同時運行郵件客戶端。但是在我們編寫實際測試之前呢,我們首先必須要確保SMTP服務器正確運行,同時在測試結束的時候能夠正確關閉。
@RunWith(SpringJUnit4ClassRunner.class) @SpringApplicationConfiguration(Application.class) public class MailClientTest { private GreenMail smtpServer; @Before public void setUp() throws Exception { smtpServer = new GreenMail(new ServerSetup(25, null, "smtp")); smtpServer.start(); } @After public void tearDown() throws Exception { smtpServer.stop(); } }
創建郵件客戶端
首先,我們需要注入我們的郵件service在測試類中。之后,我們才能通過GrennMail來驗證是否能夠接受到郵件。
@Autowired private MailClient mailClient; @Test public void shouldSendMail() throws Exception { //given String recipient = "name@hotmail.com"; String message = "Test message content"; //when mailClient.prepareAndSend(recipient, message); //then assertReceivedMessageContains(message); } private void assertReceivedMessageContains(String expected) throws IOException, MessagingException { MimeMessage[] receivedMessages = smtpServer.getReceivedMessages(); assertEquals(1, receivedMessages.length); String content = (String) receivedMessages[0].getContent(); assertTrue(content.contains(expected)); }
發送HTML郵件
在這里我們主要說一下如何構建HTML類型的郵件。
Thymeleaf 模板引擎
首先在你的 pom.xml 中添加依賴。Spring引導將使用其默認設置自動準備引擎
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-thymeleaf</artifactId> </dependency>
Thymeleaf的默認配置期望所有HTML文件都放在 **resources/templates ** 目錄下,以.html擴展名結尾。 讓我們創建一個名為mailTemplate.html的簡單文件,我們將使用創建的郵件客戶端類發送:
除了在生成過程中作為參數傳遞的消息的占位符,該模板幾乎不包含任何內容。這不是廢話么-,-
模板處理
創建一個服務類,它主要負責將寫入的模板和外部模型組合在一起,這在我們的例子中是一個簡單的短信。
@Service public class MailContentBuilder { private TemplateEngine templateEngine; @Autowired public MailContentBuilder(TemplateEngine templateEngine) { this.templateEngine = templateEngine; } public String build(String message) { Context context = new Context(); context.setVariable("message", message); return templateEngine.process("mailTemplate", context); } }
注意:這里的 context。 這里主要使用的 鍵值對 的形式,類似map,將模板里面的需要的變量與值對應起來。 比如: <span th:text="${message}"></span>
, 這里我們通過context就將message的內容賦值給了span。
TemplateEngine類的實例由Spring Boot Thymeleaf自動配置提供。我們所需要做的就是調用process()
方法,該方法接受兩個參數,也就是我們使用的模板的名稱以及充當模型的容器的上下文對象對象。
將新創建的 MailContentBuilder 注入到MailService類中。我們需要在prepareAndSen() 方法中進行一個小的調整,以利用構建器將生成內容設置為mime消息。我們還使用 setText()
方法的重載變量將 Content-Type 頭設置為text / html,而不是默認的 text / plain。
測試
需要更新的最后一件事是我們的測試,更確切地說,是接收到的消息的預期內容。只需對驗證邏輯進行一個小的更改,運行測試并檢查結果。
@Test public void shouldSendMail() throws Exception { //given String recipient = "name@dolszewski.com"; String message = "Test message content"; //when mailService.prepareAndSend(recipient, message); //then String content = "<span>" + message + "</span>"; assertReceivedMessageContains(content); }
本文到此基本宣告結束。
再次獻上一份我常用的html email模板:
<!DOCTYPE html> <html lang="en" xmlns="http://www.w3.org/1999/xhtml" xmlns:th="http://www.thymeleaf.org"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/> <meta name="viewport" content="width=device-width, initial-scale=1.0"/> <title>Siemens Sinnovation</title> <style> .button { background-color: #4CAF50; border-radius: 12px; border: none; color: white; padding: 10px 25px; text-align: center; text-decoration: none; display: inline-block; font-size: 18px; margin: 4px 2px; cursor: pointer; box-shadow: 0 8px 16px 0 rgba(0, 0, 0, 0.2), 0 6px 20px 0 rgba(0, 0, 0, 0.19); } .button:hover { box-shadow: 0 12px 16px 0 rgba(0, 0, 0, 0.24), 0 17px 50px 0 rgba(0, 0, 0, 0.19); } </style> </head> <body > <table align="center" border="1" cellpadding="0" cellspacing="0" width="600px"> <tr> <td> <table align="center" border="0" cellpadding="0" cellspacing="0" width="600" > <tr> <td align="center" > <!--![](image/logo.png)--> ![](|cid:${imageResourceName}|) </td> </tr> <tr> <td bgcolor="#ffffff" > <h5>The following message was created by <span th:text="${owner.getName()}"></span> in the Siemens DFFA group: </h5> <table border="0" cellpadding="0" cellspacing="0" width="100%"> <tr> <td><span th:text="${title}">title</span></td> </tr> <tr> <td > <span th:text="${description}">description</span> </td> </tr> <tr> <table border="0" cellpadding="0" cellspacing="0" width="100%"> <tr> <!--<td align="center" >Status:<span--> <!--th:text="${status}">status</span></td>--> <!--<td align="center" >Date submitted: <span--> <!--th:text="${createDate}">createDate</span></td>--> <!--<td align="center" >Days left to join:<span--> <!--th:text="${leftTime}">leftTime</span></td>--> <td align="center" >Status:<span th:text="${status}"> OPEN FOR JOINING</span></td> <td align="center" >Date submitted: 28/08/2017 <span th:text="${createDate}">createDate</span></td> <td align="center" >Days left to join: 10h<span th:text="${leftTime}">leftTime</span></td> </tr> </table> </tr> <tr> <table border="0" cellpadding="0" cellspacing="0" width="100%"> <tr> <td > Team Member: </td> </tr> <tr th:each="member :${members}"> <td ><span th:text="${member.getName()}+', Email: '+${member.getEmail()}"></span> </td> </tr> </table> </tr> <tr> <td align="center" > <button class="button">View Details</button> </td> </tr> </table> </td> </tr> </table> </td> </tr> </table> </body> </html>
上述內容就是SpringBoot中的利用Email發送功能怎么利用Thymeleaf實現,你們學到知識或技能了嗎?如果還想學到更多技能或者豐富自己的知識儲備,歡迎關注億速云行業資訊頻道。
免責聲明:本站發布的內容(圖片、視頻和文字)以原創、轉載和分享為主,文章觀點不代表本網站立場,如果涉及侵權請聯系站長郵箱:is@yisu.com進行舉報,并提供相關證據,一經查實,將立刻刪除涉嫌侵權內容。