前言
没错,有需求才有动力,这一次老大让我自己研究一下如何使用Java代码来发送一封邮件.正愁没事可搞,借着今天是七夕,就好好搞搞这个需求,前后总共用了半天时间搞定了,所以在这浅谈一下其填坑过程.
邮件收发协议
说到邮件收发,就不得不说下邮件收发协议,其分为SMTP、POP3、IMAP三种协议,因为这里我们不涉及收取邮箱,所以我们只需要使用SMTP即可.下面我们就对其三个协议的概念做一个总结.
SMTP（发送邮件协议，默认端口25）
POP3（收取邮件协议，默认端口110，不能在线操作）
IMAP（收取邮件协议，默认端口143，运行在TCP/IP协议之上，与POP3的主要区别：可以在线操作，用户可以不用把所有的邮件全部下载，可以通过客户端直接对服务器上的邮件进行操作）
JavaEmail发送邮件流程
JavaEmail发送邮件的流程主要是四步,其中第三步可有可无.分别是连接服务器,编辑邮件,添加附件,发送邮件.如下图所示.
JavaEmail开发配置
由于我创建的是一个Maven项目,所以我在pom.xml中添加了如下的Maven依赖.
<properties>
<javamail.version>1.4.1</javamail.version>
</properties>
<dependencies>
<dependency>
<groupId>javax.mail</groupId>
<artifactId>mail</artifactId>
<version>${javamail.version}</version>
</dependency>
</dependencies>
但是好像听说在JDK6.0 以后开发，不需要导入 mail.jar了,因为在官方的JDK中已经包含了这个jar包,但是我没有找到,所以我建立了依赖.假设两者都存在的话,会出现如下错误.
java.lang.NoClassDefFoundError: com/sun/mail/util/LineInputStream
解决方案就很简单了,只要删除 javaee.jar 里面的 mail 目录和 activation 目录即可（如果想一劳永逸，去 javaee.jar 所在的硬盘位置把这两个目录删掉)。
发送一份纯本文的邮件
不管是发送什么邮件,这里我建议大家使用企业邮箱,因为普通邮箱好像是有发送次数限制的.这里我使用的是QQ企业邮箱,账号都是公司提供的.这里我们需要去邮箱的设置页面查看两个地方.一个是我们的收发服务器地址以及相关信息,二是查看我们是否已经开启对应的收发服务了.如下图所示.
❗️ ❗️❗️从上图看出,我们知道,腾讯企业邮箱是发送地址为smtp.exmail.qq.com,使用SSL,端口为465,这里有个坑,那就是如果不使用SSL,那么端口为25,和新浪,网易邮箱端口是一致.
查看完我们想要的之后我们就需要进行连接服务器.首先我们需要设置服务器参数.这里我们使用Properties来存储服务器连接信息.如下所示.
private static String smtpHost = "smtp.exmail.qq.com";
private static String port = "25";
private static Properties props = System.getProperties();
public static void main( String[] args ) throws AddressException, MessagingException, UnsupportedEncodingException{
props.put("mail.smtp.host", smtpHost);
props.put("mail.smtp.auth", "true");
props.put("mail.smtp.port", port);
props.setProperty("mail.transport.protocol", "smtp");
}
然后,我们通过上面服务器信息来连接服务器.
Session session = Session.getInstance(props);// 与邮件服务器连接会话
session.setDebug(true);//打开Debug模式
连接完成之后,我们就需要编辑我们的邮件了.这里需要MimeMessage这个类来实现.代码如下所示.
MimeMessage message = new MimeMessage(session);// 代表一封邮件
message.setFrom(new InternetAddress("发送邮件的地址"));
message.setRecipients(Message.RecipientType.TO,"接受邮件的地址");
message.setSubject("骚栋发给你一份惊喜");
message.setText("邮件正文内容");
编写完地址之后,我们就需要发送这封邮件了,这里我们需要使用Transport这个类来实现邮件发送的功能.当然了,我们需要在发送过程中验证我们的发送账号以及密码.如下所示.
Transport transport = session.getTransport();
// 发邮件前进行身份校验
transport.connect("发送邮件账号", "账号密码");
transport.sendMessage(message, message.getAllRecipients());
❗️ ❗️❗️注意:邮件账号和邮件发送地址可能不同吆~
这样,我们就成功发送了一个邮件.效果图如下所示.(完整Demo在文章最底部)
发送一份带有格式的邮件(html形式)
假定一个纯文本已经不能满足我们的需求了,我们需要搞成有格式的邮件,这时候我们该怎么办呢?这时候我们就需要使用MimeMultipart和MimeBodyPart这两个类来进行实现了.
前面的连接服务器,发送邮件不需要发生改变,类似于纯文本的即可,改变的是编辑邮件内容.代码如下所示.
MimeBodyPart content = new MimeBodyPart();
content.setContent("<h1>附件是首好听的歌曲！</h1>", "text/html;charset=utf-8");
MimeMultipart mimeMultipart = new MimeMultipart();
mimeMultipart.addBodyPart(content);
mimeMultipart.setSubType("mixed");
message.setContent(mimeMultipart);//添加主题内容
正常执行之后,收件箱得到如下的邮件,我们发现附件是首好听的歌曲！确实是h1标签的形式.
发送一份带有附件的邮件
上面都说了有附件了,那么怎么能不搞搞如何发送一份有附件的邮件呢?和上面添加格式一样,我们需要使用MimeMultipart和MimeBodyPart这两个类来进行实现了.
具体部分代码如下所示.
MimeBodyPart attachment = new MimeBodyPart();
attachment.setDataHandler(new DataHandler
(new FileDataSource("附件的本地地址"))
);
attachment.setFileName(MimeUtility.encodeText("音乐.mp3"));
MimeBodyPart content = new MimeBodyPart();
content.setContent("<h1>附件是首好听的歌曲！</h1>", "text/html;charset=utf-8");
MimeMultipart mimeMultipart = new MimeMultipart();
mimeMultipart.addBodyPart(attachment);
mimeMultipart.addBodyPart(content);
mimeMultipart.setSubType("mixed");
message.setContent(mimeMultipart);
这时候我们在发送邮件的话,对应的邮箱中就会出现我们的邮件了.如下图所示.
文章整体代码如下所示
package com.infosports.emaildemo;
import java.io.UnsupportedEncodingException;
import java.util.Properties;
import javax.activation.DataHandler;
import javax.activation.FileDataSource;
import javax.mail.Message;
import javax.mail.MessagingException;
import javax.mail.Session;
import javax.mail.Transport;
import javax.mail.internet.AddressException;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeBodyPart;
import javax.mail.internet.MimeMessage;
import javax.mail.internet.MimeMultipart;
import javax.mail.internet.MimeUtility;
public class App {
private static String smtpHost = "smtp.exmail.qq.com";
private static String formPerson = "邮件发送地址";
private static String toPerson = "邮件接受账号";
private static String port = "25";
private static Properties props = System.getProperties();
public static void main( String[] args ) throws AddressException, MessagingException, UnsupportedEncodingException{
props.put("mail.smtp.host", smtpHost);
props.put("mail.smtp.auth", "true");
props.put("mail.smtp.port", port);
props.setProperty("mail.transport.protocol", "smtp");
Session session = Session.getInstance(props);// 与邮件服务器连接会话
session.setDebug(true);
MimeMessage message = new MimeMessage(session);// 代表一封邮件
message.setFrom(new InternetAddress(formPerson));
message.setRecipients(Message.RecipientType.TO, toPerson);
message.setSubject("骚栋发给你一份惊喜");
// message.setText("邮件正文内容");
//附件部分
MimeBodyPart attachment = new MimeBodyPart();
attachment.setDataHandler(new DataHandler
(new FileDataSource("附件路径"))
);
attachment.setFileName(MimeUtility.encodeText("音乐.mp3"));
MimeBodyPart content = new MimeBodyPart();
content.setContent("<h1>附件是首好听的歌曲！</h1>", "text/html;charset=utf-8");
MimeMultipart mimeMultipart = new MimeMultipart();
mimeMultipart.addBodyPart(attachment);
mimeMultipart.addBodyPart(content);
mimeMultipart.setSubType("mixed");
message.setContent(mimeMultipart);
Transport transport = session.getTransport();
// 发邮件前进行身份校验
transport.connect(formPerson, "发送账号密码");
transport.sendMessage(message, message.getAllRecipients());
}
}
总结
使用JavaEmail发送邮件就谈到这里了,有什么不足欢迎来批斗骚栋,这里感谢大家了.希望大家喜欢这篇文章.话不多说了.今天是七夕,祝大家七夕快乐~
