首頁  >  文章  >  Java  >  SpringBoot中整合郵件服務的詳細講解(附程式碼)

SpringBoot中整合郵件服務的詳細講解(附程式碼)

不言
不言轉載
2018-10-09 14:23:513582瀏覽

這篇文章帶給大家的內容是關於SpringBoot中整合郵件服務的詳細講解(附程式碼),有一定的參考價值,有需要的朋友可以參考一下,希望對你有幫助。

一、前言

Spring Email 抽象的核心是 MailSender 接口,MailSender 的實作能夠把 Email 傳送給郵件伺服器,由郵件伺服器實作郵件傳送的功能。

SpringBoot中整合郵件服務的詳細講解(附程式碼)

Spring 自帶了一個 MailSender 的實作 JavaMailSenderImpl,它會使用 JavaMail API 來傳送 Email。 Spring 或 SpringBoot 應用在傳送 Email 之前,我們必須要 JavaMailSenderImpl 組裝為 Spring應用上下文的一個 bean。

二、設定

1、pom.xml

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

2、application.yml

spring:
  mail:
    host: smtp.163.com
    port: 25
    username: 159****2662@163.com
    password: ***********

host 屬性預設是JavaMail 會話的主機;port 連接埠預設監聽標準的SMTP 連接埠25;如果郵件伺服器需要認證的,還需要設定userrname 和password。

這裡我用的是 163 的郵件伺服器,需要在 163 郵箱中開啟用戶端授權密碼,否則會報 550 認證錯誤。

SpringBoot中整合郵件服務的詳細講解(附程式碼)

3、EmailConfig.java

#在這裡,我們把 JavaMailSenderImpl 組裝為 Spring 應用上下文的一個 Bean。同時要注意的是,這裡使用了@ConfigurationProperties 註解,該註解需要屬性有 setter 方法並在啟動類別中使用 @EnableConfigurationProperties 註解使之生效。

@Configuration
@ConfigurationProperties(prefix = "spring.mail")
public class EmailConfig {
    private String host;
    private Integer port;
    private String username;
    private String password;
    @Bean
    public MailSender javaMailSender() {
        JavaMailSenderImpl javaMailSender = new JavaMailSenderImpl();
        javaMailSender.setHost(host);
        javaMailSender.setPort(port);
        javaMailSender.setUsername(username);
        javaMailSender.setPassword(password);
        return javaMailSender;
    }
    public void setHost(String host) {
        this.host = host;
    }
    public void setPort(Integer port) {
        this.port = port;
    }
    public void setUsername(String username) {
        this.username = username;
    }
    public void setPassword(String password) {
        this.password = password;
    }
}

三、發送

有了 javaMailSender,那麼郵件發送就是一件再簡單不過的事情了。我們只需要將 javaMailSender 的 Bean 注入到我們自己的實作類別中,然後使用 JavaMail API 來傳送 Email。

1、文字郵件傳送

public void sendSimpleEmail() {
    // 构造Email消息
    SimpleMailMessage message = new SimpleMailMessage();
    message.setFrom("159****2662@163.com");
    message.setTo("****@qianxx.com");
    message.setSubject("邮件主题");
    message.setText("邮件内容");
    javaMailSender.send(message);
}

純文字的 Email 在於建構 SimpleMailMessage 實例,這個物件可以很方便地傳送Email訊息。

2、附件郵件發送

Spring 的 Email 功能並不局限於純文字的 Email。我們也可以新增附件。如果要傳送附有附件的 Email,關鍵技巧是創建 multipart 類型的訊息 ———— Email由多個部分組成,其中一部分是 Email 體,其他部分是附件。為了發送 multipart 類型的 Email,你需要建立一個MIME(Multipurpose Internet Mail Extensions)的訊息。

public void mimeEmail() throws MessagingException {
    // MimeMessage 本身的 API 有些笨重,我们可以使用 MimeMessageHelper
    MimeMessage mimeMessage = javaMailSender.createMimeMessage();
    // 第二个参数是 true ,表明这个消息是 multipart类型的/
    MimeMessageHelper mimeMessageHelper = new MimeMessageHelper(mimeMessage, true);
    mimeMessageHelper.setFrom("159****2662@163.com");
    mimeMessageHelper.setTo("****@qianxx.com");
    mimeMessageHelper.setSubject("附件邮件主题");
    mimeMessageHelper.setText("附件邮件内容");
    //添加附件,第一个参数表示添加到 Email 中附件的名称,第二个参数是图片资源
    mimeMessageHelper.addAttachment("boot.png", new ClassPathResource("public/images/boot.png"));
    javaMailSender.send(mimeMessage);
}

3、富文本郵件發送

Spring 的 Email 功能除了可以新增附件外,甚至可以使用 HTML 來美化訊息體的內容。發送富文本的 Email 與發送簡單文字的 Email 並沒有太大差別,關鍵在於將setText() 方法的訊息文字設為 HTML,並將第二個參數設為 true,表示這是 HTML 的富文本。

public void htmlEmail() throws MessagingException {
    MimeMessage mimeMessage = javaMailSender.createMimeMessage();
    MimeMessageHelper mimeMessageHelper = new MimeMessageHelper(mimeMessage, true);
    mimeMessageHelper.setFrom("159****2662@163.com");
    mimeMessageHelper.setTo("****@qianxx.com");
    mimeMessageHelper.setSubject("富文本邮件主题");
    String html = "<html><body><h4>Hello,SpringBoot</h4><img  src=&#39;cid:boot&#39; / alt="SpringBoot中整合郵件服務的詳細講解(附程式碼)" ></body></html>";
    mimeMessageHelper.setText(html, true);
    // 设置内嵌元素 cid,第一个参数表示内联图片的标识符,第二个参数标识资源引用
    mimeMessageHelper.addInline("boot", new ClassPathResource("public/images/boot.png"));
    javaMailSender.send(mimeMessage);
}

四、結語

HTML 標籤的字串拼接是一件很棘手的事。因為在你的大腦中解析HTML標籤並想像它在渲染時會是什麼樣子是挺困難的。而將HTML混合在Java程式碼中又會使得這個問題更加複雜。

因此 Spring 給出的解決方案是 使用模板產生Email,有多種模板方案可供選擇,包括Apache Velocity和Thymeleaf。 (由於對這兩個模板語法不是很擅長,所以就不多做介紹了)。

示範原始碼:https://github.com/JMCuixy/Boot

以上是SpringBoot中整合郵件服務的詳細講解(附程式碼)的詳細內容。更多資訊請關注PHP中文網其他相關文章!

陳述:
本文轉載於:cnblogs.com。如有侵權,請聯絡admin@php.cn刪除