发送邮件

在日常工作和生活中经常会用到电子邮件。例如，当注册一个新账户时，系统会自动给注册邮箱发送一封激活邮件，通过邮件找回密码，自动批量发送活动信息等。邮箱的使用基本包括这几步：先打开浏览器并登录邮箱，然后创建邮件再发送邮件。在这个过程中有大量的重复性工作且不能批量发送邮件，说明手动的方式效率太低。本节就介绍如何通过代码完成发送邮件的功能。

SMTP与发送一封邮件的步骤

电子邮件在网络中传输时需要遵从协议，常用的电子邮件协议包括SMTP、POP3、IMAP。其中，邮件的创建和发送只需要使用SMTP（Simple MailTransfer Protocol，简单邮件传输协议）。

如果需要给客户发送邮件，可以直接使用Java代码发送。发送邮件的过程是先登录指定的邮箱，然后再给用户发送邮件，因此需要配置邮箱的权限或者SMTP。本小节以QQ邮箱作为收件人，介绍怎么配置163邮箱发送邮件。首先登录163邮箱，选择“设置”标签，就会看到设置页面如图6.14所示。

必须开启IMAP/SMTP服务和POP3/SMTP服务，开启后可以看到服务器的地址，然后就可以使用Java配置163邮箱发送邮件了，这个很重要。

在网页上创建并发送一封电子邮件的步骤如下：

（1）创建一个邮件对象（MimeMessage）。

（2）设置发件人、收件人，可以增加多个收件人、抄送人。

（3）设置邮件的主题（标题）。

（4）设置邮件的正文（内容）。

（5）设置邮件的发送时间。

（6）发送邮件。

同理，在Java中发送邮件的步骤和上面相似，完成上述步骤就能成功发送邮件，具体的代码实现后面会详细介绍。

实战：使用Java Mail发送邮件

前面简述了邮件的发送过程，下面使用Java的API完成邮件的发送。

（1）在pom.xml中添加E-mail的依赖坐标：

<dependency>

<groupId>com.sun.mail</groupId>

<artifactId>javax.mail</artifactId>

<version>1.6.2</version>

</dependency>

（2）编写发送邮件的代码：

package com.example.springextenddemo.email;

import javax.mail.Session;

import javax.mail.Transport;

import javax.mail.internet.InternetAddress;

import javax.mail.internet.MimeMessage;

import java.util.Date;

import java.util.Properties;

/**

* Java 发送邮件

*/

public class JavaSendMailDemo {

/**

* 邮箱账户

*/

public static String emailAddress = "changhe626@163.com";

/**

* 授权码 */

public static String emailPassword = "OTLXYXXOELTJRMSO";

// 发件人邮箱的SMTP服务器地址

public static String smtpHost = "smtp.163.com";

public static void main(String[] args) throws Exception {

// 1. 创建参数配置，用于连接邮件服务器的参数配置

Properties props = new Properties();

// 使用的协议（JavaMail规范要求）

props.setProperty("mail.transport.protocol", "smtp");

// 发件人邮箱的SMTP服务器地址

props.setProperty("mail.smtp.host", smtpHost);

// 是否需要请求认证

props.setProperty("mail.smtp.auth", "true");

// 2. 根据配置创建会话对象，用于和邮件服务器进行交互

Session session = Session.getInstance(props);

// 设置为debug模式，观察详细的发送日志

session.setDebug(true);

// 3. 创建一封邮件

MimeMessage message = createMimeMessage(session,

emailAddress,"1507775353@qq.com");

// 4. 根据 Session 获取邮件传输对象

Transport transport = session.getTransport();

//5. 输入邮箱账号和密码连接邮件服务器，这里认证的邮箱必须与message中的发

件人邮箱一致，否则会报错

transport.connect(emailAddress, emailPassword);

// 6.给所有的收件地址发送邮件，message.getAllRecipients() 获取的是在

创建邮件对象时添加的所有收件人、抄送人、密送人

transport.sendMessage(message, message.getAllRecipients());

// 7. 关闭连接

transport.close();

System.out.println("完成邮件的发送");

}

/**

* 创建一封只包含文本的简单邮件

* @param session 和服务器交互的会话

* @param sendMailAddress 发件人邮箱

* @param receiveMailAddress 收件人邮箱

* @return * @throws Exception

*/

public static MimeMessage createMimeMessage(Session session,

String sendMailAddress,

String receiveMailAddress) throws Exception {

// 1. 创建一封邮件

MimeMessage message = new MimeMessage(session);

// 2. From: 发件人

message.setFrom(new InternetAddress(sendMailAddress, "紫龙

神","UTF-8"));

// 3. To: 收件人（可以增加多个收件人、抄送和密送）

message.setRecipient(MimeMessage.RecipientType.TO, new

Internet Address(receiveMailAddress, "你好", "UTF-8"));

// 4. Subject: 邮件主题

message.setSubject("你好,请问你吃饭了没有啊", "UTF-8");

// 5. Content: 邮件正文（可以使用HTML标签）

message.setContent("你好,许久不见,想问问你吃饭了没有啊",

"text/html; charset=UTF-8");

// 6. 设置发件时间

message.setSentDate(new Date());

// 7. 保存设置

message.saveChanges();

return message;

}

}

上述代码演示了邮件从创建到发送的过程。运行代码，控制台上打印的发送邮件的日志如图6.15所示，发件箱的发送记录如图6.16所示，收件箱的收件记录如图6.17所示。可以看到，已经成功发送邮件。

说明：在实际开发中，一般会把邮件发送封装成一个工具类，然后再配置一个只发送邮件的邮箱，最后直接调用工具类完成邮件的发送。

实战：Spring Boot集成邮件发送

Spring Boot为邮件发送功能提供了自动配置类，开发者只需要加入相关依赖，然后再配置邮箱的基本信息就可以发送邮件了，相较于邮件发送工具，类更加简便。

下面介绍在Spring Boot项目中如何实现邮件发送的功能。

（1）在application.properties中添加E-mail配置文件，内容如下：

#email config

spring.mail.host=smtp.163.com

spring.mail.port=25

spring.mail.username=changhe626@163.com

spring.mail.password=OTLXYXXOELTJRMSO

spring.mail.default-encoding=UTF-8

spring.mail.properties.mail.debug=true

（2）编写邮件发送的服务类和具体方法：

package com.example.springextenddemo.email;

import org.springframework.beans.factory.annotation.Autowired;

import org.springframework.beans.factory.annotation.Value;

import org.springframework.mail.SimpleMailMessage;

import org.springframework.mail.javamail.JavaMailSender;

import org.springframework.stereotype.Service;

import java.util.Date;

@Service

public class SpringEmailService {

@Autowired

private JavaMailSender javaMailSender;

/**

* 输入发件人的邮箱地址

*/

@Value("${spring.mail.username}")

private String from;

public void sendSimpleMail() {

SimpleMailMessage message = new SimpleMailMessage();

message.setSubject("Spring 邮件发送");

message.setFrom(from);

message.setTo("1507775353@qq.com");

message.setSentDate(new Date());

message.setText("这是使用Spring发送邮件");

javaMailSender.send(message);

}

}

（3）新建一个邮件发送的Controller作为Web入口，其中包括发送邮件的方法：

package com.example.springextenddemo.controller;

import com.example.springextenddemo.email.SpringEmailService;

import org.springframework.beans.factory.annotation.Autowired;

import org.springframework.web.bind.annotation.GetMapping;

import org.springframework.web.bind.annotation.RestController;

@RestController

public class EmailController {

@Autowired

private SpringEmailService springEmailService;

@GetMapping("/sendEamil")

public String sendEmail(){

springEmailService.sendSimpleMail();

return "send success";

}

}

（4）启动当前项目，访问localhost:8080/sendE mail，在控制台能看到邮件发送成功的提示。查看控制台打印的日志，如图6.18所示，收件箱收到的邮件如图6.19所示。

在Spring Boot中添加完E-mail的依赖和E-mail的配置文件后，SpringBoot会自动把E-mail的配置注入邮件的发送配置类中，不需要再手动配置。

使用的配置类是MailSender- AutoConfiguration，其中的部分源码如下：

package org.springframework.boot.autoconfigure.mail;

@Configuration(

proxyBeanMethods = false

)

@ConditionalOnClass({MimeMessage.class, MimeType.class,

MailSender.class})

@ConditionalOnMissingBean({MailSender.class})

@Conditional({MailSenderAutoConfiguration.MailSenderCondition.class})

@EnableConfigurationProperties({MailProperties.class})

@Import({MailSenderJndiConfiguration.class, MailSenderProperties

Configuration.class})

public class MailSenderAutoConfiguration {

static class MailSenderCondition extends AnyNestedCondition {

MailSenderCondition() {

super(ConfigurationPhase.PARSE_CONFIGURATION);

}

@ConditionalOnProperty(

prefix = "spring.mail",

name = {"jndi-name"}

)

static class JndiNameProperty {

JndiNameProperty() {

}

}

@ConditionalOnProperty(

prefix = "spring.mail",

name = {"host"}

)

static class HostProperty {

HostProperty() {

}

}

}

}

在
MailSenderAutoConfiguration类中可以看到还导入了另外一个配置类，即Mail- SenderPropertiesConfiguration类，其部分源码如下：

@Configuration(

proxyBeanMethods = false

)

@ConditionalOnProperty(

prefix = "spring.mail",

name = {"host"}

)

MailSenderPropertiesConfiguration类获取application.properties中E-mail的配置文件，把application.properties中E-mail的相关配置组装成E-mail的配置对象，然后注入Spring容器中，这样用户就可以方便地发送Email，不需要再手动配置E-mail信息了。