五、springboot 簡單優雅是實現郵件服務

前言

spring boot 的項目放下小半個月沒有更新了，終於閑下來可以開心的接着寫啦。
之前我們配置好mybatis 多數據源的，接下來我們需要做一個郵件服務。比如你注冊的時候，需要輸入驗證碼來校驗。這個驗證碼就可以通過郵件來發送。當然現在驗證碼大部分都是通過短信，單郵件有時候也是必不可少的。所以我們的spring架手架還是將郵件服務也搭建起來。下一篇將短信服務也整合進來。
好了，言歸正傳。搭建郵件服務沒有接觸可能會覺得很麻煩或者單機環境測試環境都實現不了。覺得沒有郵件服務。其實我們個人使用的話，是可以做到的。qq郵箱，網易郵箱都可以的。我這里使用的是QQ郵箱。網上有很多相關的教程。

郵箱服務器准備

登錄QQ郵箱，點擊設置 -->賬戶 可以找到 下圖這個。

需要開通 POP3/SMTP服務。開通這個后，會生成一個秘鑰。這個秘鑰我們待會會在項目中用到。拿小本本記下來哈哈。

添加依賴和配置

郵箱准備好了，我們就開始我們的項目吧。
首先在pom.xml 文件中添加依賴

<dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-mail</artifactId>
        </dependency>

然后在application.proteries 文件中添加配置，改成自己的郵箱。password 就是剛剛生成的那個秘鑰。QQ郵箱的服務器地址是：smtp.qq.com 。網易的大家可以搜一下。

spring.mail.host=smtp.qq.com
spring.mail.username=[e-mail]
spring.mail.password=abcdefgqazqaz
spring.mail.default-encoding=UTF-8

mail.from=[e-mail]

Service 層

配置信息都好了之后，我們就可以來使用啦。這里我們暫時沒有涉及到數據庫，就直接寫Service層和controller 層。
在service 包下創建一個MailService 和MailServiceImpl

MailServiceImpl 中代碼

@Service
@Slf4j
public class MailServiceImpl implements MailService{
    @Autowired
    private JavaMailSender mailSender;
    @Value("${mail.from}")
    private String mailFrom;
    @Override
    public void sendSimpleMail(String mailTo) {
        SimpleMailMessage message=new SimpleMailMessage();
        message.setFrom(mailFrom);
        message.setTo(mailTo);
        message.setSubject("simple mail");
        message.setText("hello world");
        mailSender.send(message);
        log.info("郵件已經發送");
    }

}

這里我們就先簡單的測試一下看看郵件能不能發送。mailFrom 是發件人，mailTo 是收件人。message.setSubject()設置郵件主題。message.setText()設置郵件內容。
mailSender.send(message)是發送短信。

controller層

我們創建一個MailController類。代碼如下：

@RestController
@RequestMapping("/mail")
public class MailController {
   @Autowired
   private MailService mailService;

   @RequestMapping(value = "/send",method = RequestMethod.GET)
   public String sendMail(@RequestParam(value = "userName")String userName){
       mailService.sendSimpleMail(userName);
       return "success";
   }
}

可以看到就一個發送的接口。很簡單，參數傳過來接收人的郵箱就好了。

測試

到此為止，我們郵件服務的demo 就已經搭建好了。我們接下來測試測試一下。我們啟動項目。然后調接口

http://localhost:9090/zlflovemm/mail/send?userName=[e-mail]

提示已經發送成功啦，我們進郵箱看下我們發送情況。可以看到是發送成功了。所以說明我們的郵件服務搭建成功了。

所以現在看來，springboot 集成郵件服務是非常簡單的，配置郵件服務器，就可以直接使用啦。

發送附件

有時候我們發送郵件不僅僅發送內容，還需要發送附件，那怎么實現呢。其實也很簡單。那些配置還是不變。我們在service 層。寫一個sendMail方法。如下

@Override
    public void sendMail(String mailTo) {
        MimeMessage message=mailSender.createMimeMessage();
        MimeMessageHelper helper = null;
        try {
            helper = new MimeMessageHelper(message, true);
            helper.setFrom(mailFrom);
            helper.setTo(mailTo);
            helper.setSubject("simple mail");
            helper.setText("hello world", true);
            FileSystemResource file = new FileSystemResource(new File("E:\\myself\\test.xls"));
            String fileName = file.getFilename();
            helper.addAttachment(fileName, file);
            mailSender.send(message);
            log.info("郵件已經發送");
        } catch (MessagingException e) {
            log.error("{}",e);
        }
    }

可以看到和我們開始測試的時候，有一點不同。這里先

MimeMessage message=mailSender.createMimeMessage();

MimeMessage 比 SimpleMailMessage 功能更強大，可以發送附件，也可以將內容轉成html 格式發送。所以一般實際使用的時候都使用MimeMessage。
另外發送附件，還需要借助MimeMessageHelper 。MimeMessageHelper是輔助MimeMessage的。

helper.setFrom(mailFrom);
helper.setTo(mailTo);
helper.setSubject("simple mail");
helper.setText("hello world", true);

這些和前面是一樣的，發件人收件人，主題，內容。
helper.addAttachment()是添加附件的。

好了，接下我們測試一下。可以看到發送的郵件是有附件的。證明沒問題。

番外

好了，就說這么多啦，今天項目的代碼也同步到github 上啦。
github地址：https://github.com/QuellanAn/zlflovemm

后續加油♡

歡迎大家關注個人公眾號 "程序員愛酸奶"

分享各種學習資料，包含java，linux，大數據等。資料包含視頻文檔以及源碼，同時分享本人及投遞的優質技術博文。

如果大家喜歡記得關注和分享喲❤