Spring Boot學習(十四)之Spring boot中使用QQ郵箱傳送郵件

阿新 • • 發佈：2019-01-30

相信使用過Spring的眾多開發者都知道Spring提供了非常好用的JavaMailSender介面實現郵件傳送。在Spring Boot的Starter模組中也為此提供了自動化配置。下面通過例項看看如何在Spring Boot中使用JavaMailSender傳送郵件。快速入門在Spring Boot的工程中的pom.xml中引入spring-boot-starter-mail依賴：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
	<modelVersion>4.0.0</modelVersion>

	<groupId>com.cicoding</groupId>
	<artifactId>cicoding-mail</artifactId>
	<version>1.0.0</version>
	<packaging>jar</packaging>

	<name>cicoding-mail</name>
	<description>Spring Boot project</description>

	<parent>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-parent</artifactId>
		<version>1.3.2.RELEASE</version>
		<relativePath/> <!-- lookup parent from repository -->
	</parent>

	<properties>
		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
		<java.version>1.8</java.version>
	</properties>

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

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

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

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

	</dependencies>
	
	<build>
		<plugins>
			<plugin>
				<groupId>org.springframework.boot</groupId>
				<artifactId>spring-boot-maven-plugin</artifactId>
			</plugin>
		</plugins>
	</build>

</project>

如其他自動化配置模組一樣，在完成了依賴引入之後，只需要在application.properties中配置相應的屬性內容。下面我們以QQ郵箱為例，在application.properties中加入如下配置（注意替換自己的使用者名稱和密碼）：一種模版配置;

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
spring.mail.properties.mail.smtp.starttls.required=true

另一種模版配置;

spring.mail.host=smtp.qq.com
spring.mail.username=郵箱名
spring.mail.password=這裡填郵箱的授權碼
spring.mail.default-encoding=UTF-8
spring.mail.port=465
spring.mail.properties.mail.smtp.socketFactory.class=javax.net.ssl.SSLSocketFactory
spring.mail.properties.mail.debug=true

注意：

PO3/SMTP服務必須開啟

QQ郵箱傳送郵件伺服器主機名為：

smtp.qq.com，必須使用使用SSL（spring.mail.properties.mail.smtp.socketFactory.class=javax.net.ssl.SSLSocketFactory），埠號465或587（spring.mail.port=465）通過單元測試來實現一封簡單郵件的傳送：

@RunWith(SpringJUnit4ClassRunner.class)
@SpringApplicationConfiguration(classes = Application.class)
public class ApplicationTests {

	@Autowired
	private JavaMailSender mailSender;
	@Autowired
	private VelocityEngine velocityEngine;
	@Test
	public void sendSimpleMail() throws Exception {

		SimpleMailMessage message = new SimpleMailMessage();
		message.setFrom("[email protected]");
		message.setTo("[email protected]");
		message.setSubject("主題：簡單郵件");
		message.setText("測試郵件內容");

		mailSender.send(message);
	}
}

好,我們到這裡，一個簡單的郵件傳送就完成了，執行一下該單元測試，看看效果如何？注:由於Spring Boot的starter模組提供了自動化配置，所以在引入了spring-boot-starter-mail依賴之後，會根據配置檔案中的內容去建立JavaMailSender例項，因此我們可以直接在需要使用的地方直接@Autowired來引入郵件傳送物件。進階使用在上例中，我們通過使用SimpleMailMessage實現了簡單的郵件傳送，但是實際使用過程中，我們還可能會帶上附件、或是使用郵件模組等。這個時候我們就需要使用MimeMessage來設定複雜一些的郵件內容，下面我們就來依次實現一下。傳送附件在上面單元測試中加入如下測試用例（通過MimeMessageHelper來發送一封帶有附件的郵件）：

@Autowired
	private JavaMailSender mailSender;

	@Test
	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實現在郵件正文中嵌入靜態資源。

@Test
	public void sendInlineMail() throws Exception {

		MimeMessage mimeMessage = mailSender.createMimeMessage();

		MimeMessageHelper helper = new MimeMessageHelper(mimeMessage, true);
		helper.setFrom("[email protected]");
		helper.setTo("[email protected]m");
		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模組的依賴：(在pom檔案已經一如依賴)

@Test
	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", "cicoding");
		String text = VelocityEngineUtils.mergeTemplateIntoString(
				velocityEngine, "template.vm", "UTF-8", model);
		helper.setText(text, true);

		mailSender.send(mimeMessage);
	}

在resources/templates/下，建立一個模板頁面template.vm：<html><body> <h3>你好， ${username}, 這是一封模板郵件!</h3></body></html>嘗試執行一下，就可以收到內容為你好， cicoding, 這是一封模板郵件!的郵件。這裡，我們通過傳入username的引數，在郵件內容中替換了模板中的${username}變數。

Spring Boot學習(十四)之Spring boot中使用QQ郵箱傳送郵件

Spring Boot學習(十四)之Spring boot中使用QQ郵箱傳送郵件

Spring Boot學習(十二)之Spring Boot使用@Async實現非同步呼叫

spring boot 學習(十四)SpringBoot+Redis+SpringSession緩存之實戰

RabbitMQ學習(十一)之spring整合傳送非同步訊息

Spring的學習（四）：Web中的Spring

劍指offer十四之鏈表中倒數第k個結點

Spring Boot學習（四）

spring boot 學習(十二)攔截器實現IP黑名單

spring boot 學習(十一)使用@Async實現異步調用

Spring Boot（十四）RabbitMQ延遲隊列

Spring Boot（十四）RabbitMQ延遲佇列

Spring Boot學習筆記(四)使用AOP整合log4j日誌

Spring Boot學習（四）：使用@SpringBootTest註解進行單元測試

十四、spring boot 2.x 整合 jpa 進階

Spring Boot 構建企業級部落格學習（四）- Spting Boot 整合Thymeleaf模板

從.Net到Java學習第四篇——spring boot+redis

SpringCloud SpringBoot mybatis 分散式微服務（十四）Spring Boot整合MyBatis

Spring Boot 學習（四）自定義 Banner

第十四篇: Spring Boot使用校驗框架validation校驗

Spring Boot教程十四：基於自定義註解的AOP資料來源自動切換

Spring Boot學習(十四)之Spring boot中使用QQ郵箱傳送郵件

相關推薦