浅谈JavaEmail:发送第一封邮件

作者: 神经骚栋 | 来源:发表于2017-08-28 18:01 被阅读754次
    前言

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

    邮件收发协议

    说到邮件收发,就不得不说下邮件收发协议,其分为SMTPPOP3IMAP三种协议,因为这里我们不涉及收取邮箱,所以我们只需要使用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形式)

    假定一个纯文本已经不能满足我们的需求了,我们需要搞成有格式的邮件,这时候我们该怎么办呢?这时候我们就需要使用MimeMultipartMimeBodyPart这两个类来进行实现了.

    前面的连接服务器,发送邮件不需要发生改变,类似于纯文本的即可,改变的是编辑邮件内容.代码如下所示.

            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标签的形式.

    发送一份带有附件的邮件

    上面都说了有附件了,那么怎么能不搞搞如何发送一份有附件的邮件呢?和上面添加格式一样,我们需要使用MimeMultipartMimeBodyPart这两个类来进行实现了.

    具体部分代码如下所示.

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


    相关文章

      网友评论

        本文标题:浅谈JavaEmail:发送第一封邮件

        本文链接:https://www.haomeiwen.com/subject/xdgudxtx.html