浅谈JavaEmail:发送第一封邮件

一时失言乱红尘 2023-01-08 12:26 1阅读 0赞

![ed8cf0eebaebb7cb3e6a673a12db029a.png][]

##### 前言 #####

--------------------

没错,有需求才有动力,这一次老大让我自己研究一下如何使用Java代码来发送一封邮件.正愁没事可搞,借着今天是七夕,就好好搞搞这个需求,前后总共用了半天时间搞定了,所以在这浅谈一下其填坑过程.

![f1dd2791362544fbead4ddb7308bffc5.png][]

##### 邮件收发协议 #####

--------------------

说到邮件收发,就不得不说下邮件收发协议,其分为**SMTP**、**POP3**、**IMAP**三种协议,因为这里我们不涉及收取邮箱,所以我们只需要使用**SMTP**即可.下面我们就对其三个协议的概念做一个总结.

>  *  SMTP（发送邮件协议，默认端口25）
>  *  POP3（收取邮件协议，默认端口110，不能在线操作）
>  *  IMAP（收取邮件协议，默认端口143，运行在TCP/IP协议之上，与POP3的主要区别：可以在线操作，用户可以不用把所有的邮件全部下载，可以通过客户端直接对服务器上的邮件进行操作）

##### JavaEmail发送邮件流程 #####

--------------------

JavaEmail发送邮件的流程主要是四步,其中第三步可有可无.分别是连接服务器,编辑邮件,添加附件,发送邮件.如下图所示.  
![9604d9abe6063b8623436ced621ed088.png][]

##### 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企业邮箱][QQ],账号都是公司提供的.这里我们需要去邮箱的设置页面查看两个地方.一个是我们的收发服务器地址以及相关信息,二是查看我们是否已经开启对应的收发服务了.如下图所示.

![da498bc7eec775f39d6407df7dda6d8c.png][]

> ❗️ ❗️❗️从上图看出,我们知道,腾讯企业邮箱是发送地址为**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在文章最底部)

![ac8ac71e1f33438fc8030257a14a804d.png][]

##### 发送一份带有格式的邮件(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标签的形式.

![814ca9304ec452faec3ed0ea917743bc.png][]

##### 发送一份带有附件的邮件 #####

--------------------

上面都说了有附件了,那么怎么能不搞搞如何发送一份有附件的邮件呢?和上面添加格式一样,我们需要使用**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);

这时候我们在发送邮件的话,对应的邮箱中就会出现我们的邮件了.如下图所示.

![93c86d46c7c3e6a2bd43ef5cd53ffc1b.png][]

##### 文章整体代码如下所示 #####

--------------------

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发送邮件就谈到这里了,有什么不足欢迎来批斗骚栋,这里感谢大家了.希望大家喜欢这篇文章.话不多说了.今天是七夕,祝大家七夕快乐~

![32c86203dde2910fb4be0b87c22a3531.png][]

--------------------

![5da29a8582ac7cd9ad291d1563304dbd.gif][]

[ed8cf0eebaebb7cb3e6a673a12db029a.png]: /images/20221119/50cfd61484bc4d59b2765c53eb4cf140.png
[f1dd2791362544fbead4ddb7308bffc5.png]: /images/20221119/3906d66f57544605a0e21407d8e50f94.png
[9604d9abe6063b8623436ced621ed088.png]: /images/20221119/5cb0b75200904e29b93d2e08e03780a4.png
[QQ]: https://exmail.qq.com/cgi-bin/loginpage
[da498bc7eec775f39d6407df7dda6d8c.png]: /images/20221119/ee78f727b64d4df1ad02b94ee80274d2.png
[ac8ac71e1f33438fc8030257a14a804d.png]: /images/20221119/9d8afaea03bf4a09bb1a7b1c2f24a666.png
[814ca9304ec452faec3ed0ea917743bc.png]: /images/20221119/8da509b15ae948e1bbb18a4b37312844.png
[93c86d46c7c3e6a2bd43ef5cd53ffc1b.png]: /images/20221119/e83ac95f3b274bdab1bf06a4227b5a21.png
[32c86203dde2910fb4be0b87c22a3531.png]: /images/20221119/21bd40fb4ae64831b16a0ac528fece24.png
[5da29a8582ac7cd9ad291d1563304dbd.gif]: /images/20221119/5fe03a2b8f734cea8c21f0697fb4f8b2.png