Java代码发送Email邮件教程(详细)
程序员文章站
2022-07-14 10:34:39
...
Java代码发送Email邮件教程(详细)
一. 环境准备
1.1 本节要点
- 博主环境
- 实战步骤
1.2 博主环境
- SpringBoot+ jdk1.8 + Maven + IDEA
1.3 实战步骤
- 打开IDEA,创建一个项目,随意取名;
- 引入相关依赖:(完整pom.xml如下:)
<?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 https://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.1.6.RELEASE</version> <relativePath/> <!-- lookup parent from repository --> </parent> <groupId>com.example</groupId> <artifactId>demo</artifactId> <version>0.0.1-SNAPSHOT</version> <name>demo</name> <description>Demo project for Spring Boot</description> <!--<properties>--> <!--<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>--> <!--<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>--> <!--<mybatis-spring-boot.version>2.0.0</mybatis-spring-boot.version>--> <!--<mysql-connector.version>5.1.24</mysql-connector.version>--> <!--<java.version>1.8</java.version>--> <!--<fastjson.version>1.2.56</fastjson.version>--> <!--<lombok.version>1.18.4</lombok.version>--> <!--<poi.version>3.15</poi.version>--> <!--<slf4j.version>1.7.22</slf4j.version>--> <!--<!–<swagger.version>2.7.0</swagger.version>–>--> <!--<!–<swagger.version>2.9.2</swagger.version>–>--> <!--<!–<swagger-ui.version>1.9.5</swagger-ui.version>–>--> <!--</properties>--> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> </dependency> <!-- https://mvnrepository.com/artifact/org.springframework.boot/spring-boot-starter-mail --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-mail</artifactId> <version>2.2.2.RELEASE</version> </dependency> <!-- excel end --> </dependencies> <build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin> </plugins> </build> </project>
- 创建MailUtil工具类: 代码如下:
package com.example.demo.util; 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; public class MailUtil { // 发件人的 邮箱 和 密码(替换为自己的邮箱和密码) // PS: 某些邮箱服务器为了增加邮箱本身密码的安全性,给 SMTP 客户端设置了独立密码(有的邮箱称为“授权码”), // 对于开启了独立密码的邮箱, 这里的邮箱密码必需使用这个独立密码(授权码)。 public static String myEmailAccount = "aaa@qq.com"; // 此处的密码是第三方授权码,不是邮箱密码 public static String myEmailPassword = "xxx"; // 发件人邮箱的 SMTP 服务器地址, 必须准确, 不同邮件服务器地址不同, 一般(只是一般, 绝非绝对)格式为: smtp.xxx.com // 网易163邮箱的 SMTP 服务器地址为: smtp.163.com public static String myEmailSMTPHost = "smtp.qq.com"; // 收件人邮箱(替换为自己知道的有效邮箱,传参时覆盖即可) public static String receiveMailAccount = "aaa@qq.com"; public static void sendActiveMail(String receiveMailAccount, String mailActiveCode) throws Exception { // 1. 创建参数配置, 用于连接邮件服务器的参数配置 Properties props = new Properties(); // 参数配置 props.setProperty("mail.transport.protocol", "smtp"); // 使用的协议(JavaMail规范要求) props.setProperty("mail.smtp.host", myEmailSMTPHost); // 发件人的邮箱的 SMTP 服务器地址 props.setProperty("mail.smtp.auth", "true"); // 需要请求认证 // PS: 某些邮箱服务器要求 SMTP 连接需要使用 SSL 安全认证 (为了提高安全性, 邮箱支持SSL连接, 也可以自己开启), // 如果无法连接邮件服务器, 仔细查看控制台打印的 log, 如果有有类似 “连接失败, 要求 SSL 安全连接” 等错误, // 打开下面 /* ... */ 之间的注释代码, 开启 SSL 安全连接。 /* // SMTP 服务器的端口 (非 SSL 连接的端口一般默认为 25, 可以不添加, 如果开启了 SSL 连接, // 需要改为对应邮箱的 SMTP 服务器的端口, 具体可查看对应邮箱服务的帮助, // QQ邮箱的SMTP(SLL)端口为465或587, 其他邮箱自行去查看) final String smtpPort = "465"; props.setProperty("mail.smtp.port", smtpPort); props.setProperty("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory"); props.setProperty("mail.smtp.socketFactory.fallback", "false"); props.setProperty("mail.smtp.socketFactory.port", smtpPort); */ // 2. 根据配置创建会话对象, 用于和邮件服务器交互 Session session = Session.getDefaultInstance(props); session.setDebug(true); // 设置为debug模式, 可以查看详细的发送 log // 3. 创建一封邮件 MimeMessage message = createMimeMessage(session, myEmailAccount, receiveMailAccount, mailActiveCode); // 4. 根据 Session 获取邮件传输对象 Transport transport = session.getTransport(); // 5. 使用 邮箱账号 和 密码 连接邮件服务器, 这里认证的邮箱必须与 message 中的发件人邮箱一致, 否则报错 // // PS_01: 成败的判断关键在此一句, 如果连接服务器失败, 都会在控制台输出相应失败原因的 log, // 仔细查看失败原因, 有些邮箱服务器会返回错误码或查看错误类型的链接, 根据给出的错误 // 类型到对应邮件服务器的帮助网站上查看具体失败原因。 // // PS_02: 连接失败的原因通常为以下几点, 仔细检查代码: // (1) 邮箱没有开启 SMTP 服务; // (2) 邮箱密码错误, 例如某些邮箱开启了独立密码; // (3) 邮箱服务器要求必须要使用 SSL 安全连接; // (4) 请求过于频繁或其他原因, 被邮件服务器拒绝服务; // (5) 如果以上几点都确定无误, 到邮件服务器网站查找帮助。 // // PS_03: 仔细看log, 认真看log, 看懂log, 错误原因都在log已说明。 transport.connect(myEmailAccount, myEmailPassword); // 6. 发送邮件, 发到所有的收件地址, message.getAllRecipients() 获取到的是在创建邮件对象时添加的所有收件人, 抄送人, 密送人 transport.sendMessage(message, message.getAllRecipients()); // 7. 关闭连接 transport.close(); } /** * 创建一封只包含文本的简单邮件 * * @param session 和服务器交互的会话 * @param sendMail 发件人邮箱 * @param receiveMail 收件人邮箱 * @return * @throws Exception */ public static MimeMessage createMimeMessage(Session session, String sendMail, String receiveMail, String mailActiveCode) throws Exception { // 1. 创建一封邮件 MimeMessage message = new MimeMessage(session); // 2. From: 发件人 message.setFrom(new InternetAddress(sendMail, "这里写发件人名称", "UTF-8")); // 3. To: 收件人(可以增加多个收件人、抄送、密送) message.setRecipient(MimeMessage.RecipientType.TO, new InternetAddress(receiveMail, "您好", "UTF-8")); // 4. Subject: 邮件主题 message.setSubject("我是邮件主题", "UTF-8"); String activeUrl = "http://localhost:8080/web_pro/user/activemail?mailcode=" + mailActiveCode; // 5. Content: 邮件正文(可以使用html标签) message.setContent("尊敬的用户,您好!xxxxx邀请您击**链接完成邮箱**<a href=" + activeUrl + " target='_blank'>" + activeUrl + "</a>", "text/html;charset=UTF-8"); // 6. 设置发件时间 message.setSentDate(new Date()); // 7. 保存设置 message.saveChanges(); return message; } public static void main(String[] args) throws Exception { String email = "aaa@qq.com"; try { // date.getTime()+""是用时间戳作为校验码发送给对方邮箱 MailUtil.sendActiveMail(email, new Date().getTime() + ""); } catch (Exception e) { e.printStackTrace(); } } }
- 这里我们需要指定收件人以及填入内容。在做这个之前,我们需要先生成授权码。通过授权码我们才能够将信息发送给收件人。这里获取授权码以qq邮箱举例:
- 登录qq邮箱,然后点击设置,然后再点击账户,如图所示:
- 往下翻,找到POP3…服务,然后点击开启服务:POP3/SMTP服务,最后再下方点击生成授权码,如图所示:
- 将得到的授权码复制进入代码中,如图所示:
- 登录qq邮箱,然后点击设置,然后再点击账户,如图所示: