摘要：在很多服務(wù)中我經(jīng)常需要用到發(fā)送郵件功能，所幸的是可以快速使用的框架，只要引入改框架我們可以快速的完成發(fā)送郵件功能。引入獲取郵件發(fā)送服務(wù)器配置在國(guó)內(nèi)用的最多的就是郵件和網(wǎng)易郵件，這里會(huì)簡(jiǎn)單講解獲取兩家服務(wù)商的發(fā)送郵件配置。

在很多服務(wù)中我經(jīng)常需要用到發(fā)送郵件功能，所幸的是SpringBoot可以快速使用的框架spring-boot-starter-mail，只要引入改框架我們可以快速的完成發(fā)送郵件功能。

    org.springframework.boot
    spring-boot-starter-mail

在國(guó)內(nèi)用的最多的就是QQ郵件和網(wǎng)易163郵件，這里會(huì)簡(jiǎn)單講解獲取兩家服務(wù)商的發(fā)送郵件配置。

等錄QQ郵箱，點(diǎn)擊設(shè)置然后選擇賬戶在下方可以看到POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服務(wù),然后我們需要把smtp服務(wù)開啟，開啟成功后會(huì)得到一個(gè)秘鑰。如圖所示：

開啟成功需要在application.properties配置文件中加入相應(yīng)的配置，以下信息部分需要替換為自己的信息，教程結(jié)束下面的賬號(hào)就會(huì)被停用

spring.mail.host=smtp.qq.com
[email protected] # 替換為自己的QQ郵箱號(hào)
spring.mail.password=owqpkjmqiasnbigc # 替換為自己的秘鑰或授權(quán)碼
spring.mail.port=465
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.starttls.enable=true
spring.mail.properties.mail.smtp.starttls.required=true
# sender 
[email protected] # 替換為自己的QQ郵箱號(hào)

登錄賬戶然后在設(shè)置找到POP3/SMTP/IMAP選項(xiàng)，然后開啟smtp服務(wù)，具體操作如下圖所示，然后修改對(duì)應(yīng)的配置文件

spring.mail.host=smtp.163.com
[email protected] # 替換為自己的163郵箱號(hào)
spring.mail.password=owqpkj163MC # 替換為自己的授權(quán)碼
spring.mail.port=465
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.starttls.enable=true
spring.mail.properties.mail.smtp.starttls.required=true
# sender 
[email protected] # 替換為自己的163郵箱號(hào)

這里發(fā)送郵件我們主要用到的是JavaMailSender對(duì)象，發(fā)送簡(jiǎn)單郵件主要是發(fā)送字符串內(nèi)容，復(fù)雜的郵件我們可能會(huì)添加附件或者是發(fā)送HTML格式的郵件，我們先測(cè)試簡(jiǎn)單的發(fā)送，代碼如下:

override fun sendSimple(receiver: String, title: String, content: String) {
    logger.info("發(fā)送簡(jiǎn)單郵件服務(wù)")
    val message = mailSender.createMimeMessage()
    val helper = MimeMessageHelper(message, true)
    helper.setFrom(sender)
    helper.setTo(receiver)
    helper.setSubject(title)
    helper.setText(content)
    mailSender.send(message)
}

測(cè)試代碼

@RunWith(SpringJUnit4ClassRunner::class)
@SpringBootTest
class MailServiceImplTest {

    @Autowired lateinit var mailService: MailService

    @Test
    fun sendSimple() {
        mailService.sendSimple("[email protected]", "Hello Kotlin Mail", "SpringBoot Kotlin 專欄學(xué)習(xí)之JavaMailSender發(fā)送郵件")
    }

}

檢查郵件是否收到發(fā)送的內(nèi)容

我們這里用的HTML模板引擎是thymeleaf，大家需要引入一下spring-boot-starter-thymeleaf

    org.springframework.boot
    spring-boot-starter-thymeleaf

有個(gè)地方需要注意，SpringBoot項(xiàng)目默認(rèn)靜態(tài)資源都是放在resources/templates目錄下，所以我們編寫的HTML模板就需要放在該目錄下，具體內(nèi)容如下:

    
    


    
Demo
    
xxx

發(fā)送模板郵件主要實(shí)現(xiàn)代碼

override fun sendMail(receiver: String, title: String, o: Any, templateName: String) {
    logger.info("開始發(fā)送郵件服務(wù),To:{}", receiver)
    val message = mailSender.createMimeMessage()
    val helper = MimeMessageHelper(message, true)
    helper.setFrom(sender)
    helper.setTo(receiver)
    helper.setSubject(title)

    val context = Context()
    context.setVariable("title", title)
    /*
     * 設(shè)置動(dòng)態(tài)數(shù)據(jù)，這里不建議強(qiáng)轉(zhuǎn)，具體業(yè)務(wù)需求傳入具體的對(duì)象
     */
    context.setVariables(o as MutableMap?)
    /*
     * 讀取取模板html代碼并賦值
     */
    val content = templateEngine.process(templateName, context)
    helper.setText(content, true)

    mailSender.send(message)
    logger.info("郵件發(fā)送結(jié)束")
}

測(cè)試代碼

@Test
fun sendMail() {
    val model = HashMap()
    model["name"] = "Tom"
    model["phone"] = "69288888"
    mailService.sendMail("[email protected]", "Kotlin Template Mail", model, "mail")
}

查看郵件我們可以看到如下內(nèi)容:

附件的添加也是非常容易的，我需要先把發(fā)送的附件放在resources/templates目錄下，然后在MimeMessageHelper對(duì)象中設(shè)置相應(yīng)的屬性即可，如下所示:

helper.addAttachment("test.txt", FileSystemResource(File("test.txt")))

package io.intodream.kotlin06.service.impl

import io.intodream.kotlin06.service.MailService
import org.slf4j.Logger
import org.slf4j.LoggerFactory
import org.springframework.beans.factory.annotation.Autowired
import org.springframework.beans.factory.annotation.Value
import org.springframework.core.io.FileSystemResource
import org.springframework.mail.javamail.JavaMailSender
import org.springframework.mail.javamail.MimeMessageHelper
import org.springframework.stereotype.Service
import org.thymeleaf.TemplateEngine
import org.thymeleaf.context.Context
import java.io.File

/**
 * {描述}
 *
 * @author [email protected]
 * @date 2019/4/8 19:19
 *
 */
@Service
class MailServiceImpl @Autowired constructor(private var mailSender: JavaMailSender, private var templateEngine: TemplateEngine) : MailService{

    val logger : Logger = LoggerFactory.getLogger(MailServiceImpl::class.java)

    @Value("${email.sender}")
    val sender: String = "[email protected]"

    override fun sendSimple(receiver: String, title: String, content: String) {
        logger.info("發(fā)送簡(jiǎn)單郵件服務(wù)")
        val message = mailSender.createMimeMessage()
        val helper = MimeMessageHelper(message, true)
        helper.setFrom(sender)
        helper.setTo(receiver)
        helper.setSubject(title)
        helper.setText(content)
        mailSender.send(message)
    }

    override fun sendMail(receiver: String, title: String, o: Any, templateName: String) {
        logger.info("開始發(fā)送郵件服務(wù),To:{}", receiver)
        val message = mailSender.createMimeMessage()
        val helper = MimeMessageHelper(message, true)
        helper.setFrom(sender)
        helper.setTo(receiver)
        helper.setSubject(title)

        val context = Context()
        context.setVariable("title", title)
        /*
         * 設(shè)置動(dòng)態(tài)數(shù)據(jù)，這里不建議強(qiáng)轉(zhuǎn)，具體業(yè)務(wù)需求傳入具體的對(duì)象
         */
        context.setVariables(o as MutableMap?)
        /*
         * 添加附件
         */
        helper.addAttachment("test.txt", FileSystemResource(File("test.txt")))
        /*
         * 讀取取模板html代碼并賦值
         */
        val content = templateEngine.process(templateName, context)
        helper.setText(content, true)

        mailSender.send(message)
        logger.info("郵件發(fā)送結(jié)束")
    }
}

package io.intodream.kotlin06.service.impl

import io.intodream.kotlin06.service.MailService
import org.junit.Test
import org.junit.runner.RunWith
import org.springframework.beans.factory.annotation.Autowired
import org.springframework.boot.test.context.SpringBootTest
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner

/**
 * {描述}
 *
 * @author [email protected]
 * @date 2019/4/9 18:38
 */
@RunWith(SpringJUnit4ClassRunner::class)
@SpringBootTest
class MailServiceImplTest {

    @Autowired lateinit var mailService: MailService

    @Test
    fun sendSimple() {
        mailService.sendSimple("[email protected]", "Hello Kotlin Mail",
                "SpringBoot Kotlin 專欄學(xué)習(xí)之JavaMailSender發(fā)送郵件")
    }

    @Test
    fun sendMail() {
        val model = HashMap()
        model["name"] = "Tom"
        model["phone"] = "69288888"
        mailService.sendMail("[email protected]", "Kotlin Template Mail", model, "mail")
    }
}

關(guān)于Kotlin使用JavaMailSender發(fā)送郵件的介紹就到此結(jié)束了，如果大家覺得教程有用麻煩點(diǎn)一下贊，如果有錯(cuò)誤的地方歡迎指出。