浅谈JavaEmail:发送第一封邮件

神经骚栋

已于 2023-03-19 19:04:00 修改

阅读量1k

点赞数

分类专栏： Java从头到最后的放手文章标签： java

于 2021-01-20 10:40:31 首次发布

本文链接：https://blog.csdn.net/qq_33591200/article/details/112859490

版权

Java从头到最后的放手专栏收录该内容

14 篇文章 0 订阅

订阅专栏

前言

没错,有需求才有动力,这一次老大让我自己研究一下如何使用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());
    	
    }
}