ICode9

精准搜索请尝试: 精确搜索
首页 > 编程语言> 文章详细

Java EE网络基础(10)—使用JavaMail收发Email电子邮件

2021-01-09 11:30:59  阅读:345  来源: 互联网

标签:10 Java EE 设置 服务器 msg new com 邮件


  使用JavaMail收发送电子邮件,包括带有附件和内嵌图片的邮件!

  Email就是电子邮件。发邮件是从客户端把邮件发送到邮件服务器,收邮件是把邮件服务器的邮件下载到客户端,Java同样提供了收发邮件的API。
在这里插入图片描述
  163、126、QQ、sohu、sina等网站都提供了邮件服务,这些网站都有自己的邮件服务器,我们自己的Email用户页面实际上就相当于客户端。

文章目录

1 邮件协议

1.1 邮件协议

  与HTTP协议相同,收发邮件也是需要有传输协议的。

  1. SMTP:(Simple Mail Transfer Protocol,简单邮件传输协议)发邮件协议;
  2. POP3:(Post Office Protocol Version 3,邮局协议第3版)收邮件协议;
  3. IMAP:(Internet Message Access Protocol,因特网消息访问协议)收发邮件协议。

  这些协议都属于应用层协议。

1.2 理解电子邮件收发过程

  其实你可以把邮件服务器理解为邮局!如果你需要给朋友寄一封信,那么你需要把信放到邮筒中,这样你的信会“自动”到达邮局,邮局会把信邮到另一个省市的邮局中。然后这封信会被送到收信人的邮箱中。最终收信人需要自己经常查看邮箱是否有新的信件。
  其实每个邮件服务器都由SMTP服务器和POP3服务器构成,其中SMTP服务器负责发邮件的请求,而POP3负责收邮件的请求。
在这里插入图片描述
  当然,有时我们也会使用163的账号,向126的账号发送邮件。这时邮件是发送到126的邮件服务器,而对于163的邮件服务器是不会存储这封邮件的。
在这里插入图片描述

1.3 邮件服务器名称

  smtp服务器的端口号为25,服务器名称为smtp.xxx.xxx。
  pop3服务器的端口号为110,服务器名称为pop3.xxx.xxx。
  例如:

  1. 163: smtp.163.com和pop3.163.com;
  2. 126: smtp.126.com和pop3.126.com;
  3. qq: smtp.qq.com和pop3.qq.com;
  4. sohu: smtp.sohu.com和pop3.sohu.com;
  5. sina: smtp.sina.com和pop3.sina.com。

2 JavaMail

2.1 JavaMail概述

  JavaMail是由SUN公司提供的专门用于Java收发邮件的API,使用Java程序发送邮件时,我们无需关心SMTP协议的底层原理,只需要使用JavaMail这个标准API就可以直接发送邮件。
  JavaMail中主要类有javax.mail.Session、javax.mail.internet.MimeMessage、javax.mail.Transport。

  1. Session: 表示会话,即客户端与邮件服务器之间的会话!想获得会话需要给出账户和密码,当然还要给出服务器名称。在邮件服务中的Session对象,就相当于连接数据库时的Connection对象。
  2. MimeMessage: 表示邮件类,它是Message的子类。它包含邮件的主题(标题)、内容,收件人地址、发件人地址,还可以设置抄送和暗送,甚至还可以设置附件。
  3. Transport: 用来发送邮件。它是发送器!

2.2 maven依赖

  使用JavaMail的API我们需要引入对应的jar包或者maven依赖:

<!-- https://mvnrepository.com/artifact/com.sun.mail/javax.mail -->
<dependency>
    <groupId>com.sun.mail</groupId>
    <artifactId>javax.mail</artifactId>
    <version>1.6.2</version>
</dependency>

  jar包下载地址为:https://mvnrepository.com/artifact/com.sun.mail/javax.mail/1.6.2。
在这里插入图片描述

2.3 JavaMail发送邮件

  我们使用smtp协议发送邮件!

2.3.1 简单邮件

  发送一个简单的邮件需要三步:

  1. 根据服务器参数和认证器信息来获取Session实例;
  2. 根据Session创建MimeMessage对象,MimeMessage中包含了各种可以设置的邮件属性
  3. 通过Transport发送邮件

  简单的案例如下:

/**
 * @author lx
 */
public class SimpleSendEmail {

    public static void main(String[] args) throws MessagingException {

        /*
         * 1 获取Session
         */

        /*设置服务器参数*/
        Properties props = new Properties();
        //设置服务器主机名
        props.put("mail.smtp.host", "smtp.163.com");
        //设置需要认证
        props.put("mail.smtp.auth", "true");
        // 启用TLS加密
        props.put("mail.smtp.starttls.enable", "true");
        /*
         * 根据服务器参数集合和认证器来获取Session实例
         *
         * Authenticator是一个接口表示认证器,即校验客户端的身份。
         * 我们需要自己来实现这个接口,实现这个接口需要使用账户和密码。
         */
        Session session = Session.getInstance(props, new Authenticator() {
            @Override
            protected PasswordAuthentication getPasswordAuthentication() {
                //使用自己的账户和密码,有些邮件服务器可能需要的是申请的授权码
                return new PasswordAuthentication("xxxx@163.com", "xxxx");
            }
        });
        // 设置debug模式,将会输出日志信息
        session.setDebug(true);

        /*
         * 2 根据Session创建MimeMessage对象
         *
         * MimeMessage中包含了各种可以设置的邮件属性
         */
        MimeMessage msg = new MimeMessage(session);
        //设置发信人
        msg.setFrom(new InternetAddress("xxx@163.com"));
        //设置收信人,可以设置多个,采用参数数组或者","分隔
        msg.addRecipients(TO, "xxx@qq.com");
        //设置抄送人,可以设置多个,采用参数数组或者","分隔
        msg.addRecipients(CC, "xxx@yeah.net");
        //设置暗送人,可以设置多个,采用参数数组或者","分隔
        msg.addRecipients(BCC, "xxx@xx.com");
        //设置邮件主题(标题)
        msg.setSubject("第一封邮件");
        //设置邮件内容(正文)和类型
        msg.setContent("说点啥呢?", "text/plain;charset=utf-8");

        /*
         * 3 发送邮件
         */
        Transport.send(msg);
    }
}

2.3.2 发送HTML文本

  有时候我们的邮件正文可能是一个HTML页面,发送方式和上面的案例完全一致,只需要注意编码格式为“text/html;charset=utf-8”,后面的字符集要与html文本的字符集一致。
  当然,也可以发送图片资源等等。

/**
 * @author lx
 */
public class SendHtmlEmail {

    public static void main(String[] args) throws MessagingException {

        /*
         * 1 获取Session
         */

        /*设置服务器参数*/
        Properties props = new Properties();
        //设置服务器主机名
        props.put("mail.smtp.host", "smtp.163.com");
        //设置需要认证
        props.put("mail.smtp.auth", "true");
        // 启用TLS加密
        props.put("mail.smtp.starttls.enable", "true");
        /*
         * 根据服务器参数集合和认证器来获取Session实例
         *
         * Authenticator是一个接口表示认证器,即校验客户端的身份。
         * 我们需要自己来实现这个接口,实现这个接口需要使用账户和密码。
         */
        Session session = Session.getInstance(props, new Authenticator() {
            @Override
            protected PasswordAuthentication getPasswordAuthentication() {
                //使用自己的账户和密码,有些邮件服务器可能需要的是授权码
                return new PasswordAuthentication("xx@163.com", "xxx");
            }
        });
        // 设置debug模式,将会输出日志信息
        session.setDebug(true);

        /*
         * 2 根据Session创建MimeMessage对象
         *
         * MimeMessage中包含了各种可以设置的邮件属性
         */
        MimeMessage msg = new MimeMessage(session);
        //设置发信人
        msg.setFrom(new InternetAddress("x@163.com"));
        //设置收信人,可以设置多个,采用参数数组或者","分隔
        msg.addRecipients(TO, "xx@qq.com");
        //设置抄送人,可以设置多个,采用参数数组或者","分隔
        msg.addRecipients(CC, "xxx@yeah.net");
        //设置暗送人,可以设置多个,采用参数数组或者","分隔
        msg.addRecipients(BCC, "xxx@ikang.com");
        //设置邮件主题(标题)
        msg.setSubject("HTML邮件");
        //设置邮件内容(正文)和类型
        msg.setContent("<h2><font color=red>2021加油哦!</font></h2>", "text/html;charset =utf-8");

        /*
         * 3 发送邮件
         */
        Transport.send(msg);
    }
}

  结果:
在这里插入图片描述

2.3.3 发送附件

  如果想发送带有附件邮件,那么需要设置邮件的内容为MimeMultiPart,而不仅仅是一段文本。
  多部件对象MimeMultiPart,可以理解为是部件的集合。一个Multipart对象可以添加若干个BodyPart,其中第一个BodyPart是文本,即邮件正文,后面的BodyPart是附件,最后将MimeMultiPart设置到msg的content中。
在这里插入图片描述
  案例如下:

/**
 * @author lx
 */
public class SendMultipartEmail {

    public static void main(String[] args) throws MessagingException, IOException {

        /*
         * 1 获取Session
         */

        /*设置服务器参数*/
        Properties props = new Properties();
        //设置服务器主机名
        props.put("mail.smtp.host", "smtp.163.com");
        //设置需要认证
        props.put("mail.smtp.auth", "true");
        // 启用TLS加密
        props.put("mail.smtp.starttls.enable", "true");
        /*
         * 根据服务器参数集合和认证器来获取Session实例
         *
         * Authenticator是一个接口表示认证器,即校验客户端的身份。
         * 我们需要自己来实现这个接口,实现这个接口需要使用账户和密码。
         */
        Session session = Session.getInstance(props, new Authenticator() {
            @Override
            protected PasswordAuthentication getPasswordAuthentication() {
                //使用自己的账户和密码,有些邮件服务器可能需要的是申请的授权码
                return new PasswordAuthentication("ccc@163.com", "ccc");
            }
        });
        // 设置debug模式,将会输出日志信息
        session.setDebug(true);

        /*
         * 2 根据Session创建MimeMessage对象
         *
         * MimeMessage中包含了各种可以设置的邮件属性
         */
        MimeMessage msg = new MimeMessage(session);
        //设置发信人
        msg.setFrom(new InternetAddress("ccc@163.com"));
        //设置收信人,可以设置多个,采用参数数组或者","分隔
        msg.addRecipients(TO, "ccc@qq.com");
        //设置抄送人,可以设置多个,采用参数数组或者","分隔
        msg.addRecipients(CC, "cc@yeah.net");
        //设置暗送人,可以设置多个,采用参数数组或者","分隔
        msg.addRecipients(BCC, "c@ikang.com");
        //设置邮件主题(标题)
        msg.setSubject("附件");
        //设置邮件内容(正文)和类型
        //msg.setContent("<h2><font color=red>2021加油哦!</font></h2>", "text/html;charset =utf-8");

        /*
         * 创建一个多部件对象Multipart,可以理解为是部件的集合。
         * 一个Multipart对象可以添加若干个BodyPart,其中第一个BodyPart是文本,即邮件正文,后面的BodyPart是附件
         */

        Multipart parts = new MimeMultipart();

        /*
         * 设置邮件的内容为多部件内容。
         */
        msg.setContent(parts);

        /*
         * 创建第一个部件,为邮件正文
         */
        BodyPart contentPart = new MimeBodyPart();
        //给部件设置正文内容
        contentPart.setContent("<h2><font color=red>附件来了!</font></h2>", "text/html;charset=utf-8");
        //把部件添加到部件集中
        parts.addBodyPart(contentPart);

        /*
         * 创建第二个附件部件,一张图片
         */

        MimeBodyPart imagepart = new MimeBodyPart();
        //设置附件名称
        imagepart.setFileName("people.jpg");
        //注意,如果在设置文件名称时,文件名称中包含了中文的话,那么需要使用MimeUitlity类来给中文编码:
        //imagepart.setFileName(MimeUtility.encodeText("中文.jpg"));

        //设置附件,二进制文件可以用application/octet-stream,Word文档则是application/msword。

        FileInputStream fileInputStream = new FileInputStream("email\\src\\main\\resources\\people.jpg");
        imagepart.setDataHandler(new DataHandler(new ByteArrayDataSource(fileInputStream, "application/octet-stream")));

        //把附件添加到部件集中
        parts.addBodyPart(imagepart);

        /*
         * 3 发送邮件
         */
        Transport.send(msg);
    }
}

  结果:
在这里插入图片描述

2.3.4 发送内嵌图片HTML

  发送的HTML文本的内嵌图片可以采用网络链接,也可以使用本地图片。本地内嵌图片实际上也是一个附件,即邮件本身也是Multipart,但需要做一点额外的处理。
  在HTML邮件中引用图片时,需要设定一个ID,用类似<img src=“cid:img1”>引用,然后,在添加图片作为BodyPart时,除了要正确设置MIME类型(根据图片类型使用image/jpeg或image/png),还需要设置ContentID为img1与HTML的中的img 标签的img1关联。

/**
 * @author lx
 */
public class SendPicEmail {

    public static void main(String[] args) throws MessagingException, IOException {

        /*
         * 1 获取Session
         */

        /*设置服务器参数*/
        Properties props = new Properties();
        //设置服务器主机名
        props.put("mail.smtp.host", "smtp.163.com");
        //设置需要认证
        props.put("mail.smtp.auth", "true");
        // 启用TLS加密
        props.put("mail.smtp.starttls.enable", "true");
        /*
         * 根据服务器参数集合和认证器来获取Session实例
         *
         * Authenticator是一个接口表示认证器,即校验客户端的身份。
         * 我们需要自己来实现这个接口,实现这个接口需要使用账户和密码。
         */
        Session session = Session.getInstance(props, new Authenticator() {
            @Override
            protected PasswordAuthentication getPasswordAuthentication() {
                //使用自己的账户和密码,有些邮件服务器可能需要的是申请的授权码
                return new PasswordAuthentication("xxx@163.com", "xx");
            }
        });
        // 设置debug模式,将会输出日志信息
        session.setDebug(true);

        /*
         * 2 根据Session创建MimeMessage对象
         *
         * MimeMessage中包含了各种可以设置的邮件属性
         */
        MimeMessage msg = new MimeMessage(session);
        //设置发信人
        msg.setFrom(new InternetAddress("cc@163.com"));
        //设置收信人,可以设置多个,采用参数数组或者","分隔
        msg.addRecipients(TO, "dd@ikang.com");
        //设置抄送人,可以设置多个,采用参数数组或者","分隔
        msg.addRecipients(CC, "cc@yeah.net");
        //设置暗送人,可以设置多个,采用参数数组或者","分隔
        msg.addRecipients(BCC, "xx@qq.com");
        //设置邮件主题(标题)
        msg.setSubject("这是一封图片HTML邮件");
        //设置邮件内容(正文)和类型
        //msg.setContent("<h2><font color=red>2021加油哦!</font></h2>", "text/html;charset =utf-8");

        /*
         * 创建一个多部件对象Multipart,可以理解为是部件的集合。
         * 一个Multipart对象可以添加若干个BodyPart,其中第一个BodyPart是文本,即邮件正文,后面的BodyPart是附件
         */

        Multipart parts = new MimeMultipart();

        /*
         * 设置邮件的内容为多部件内容。
         */
        msg.setContent(parts);

        /*
         * 创建第一个部件,为邮件正文
         */
        BodyPart contentPart = new MimeBodyPart();
        //给部件设置正文内容
        contentPart.setContent("<h1>Hello图片来了!</h1><p><img src='cid:img1'></p>", "text/html;charset=utf-8");
        //把部件添加到部件集中
        parts.addBodyPart(contentPart);

        /*
         * 创建第二个部件,一张图片,html中的图片也算作附件
         */

        MimeBodyPart imagepart = new MimeBodyPart();
        //设置附件名称
        imagepart.setFileName("people.jpg");
        //注意,如果在设置文件名称时,文件名称中包含了中文的话,那么需要使用MimeUitlity类来给中文编码:
        //imagepart.setFileName(MimeUtility.encodeText("中文.jpg"));

        //设置附件,二进制文件可以用application/octet-stream,Word文档则是application/msword。
        FileInputStream fileInputStream = new FileInputStream("email\\src\\main\\resources\\people.jpg");
        imagepart.setDataHandler(new DataHandler(new ByteArrayDataSource(fileInputStream, "image/jpeg")));

        //设置ContentID与HTML的中的<img src="cid:img01">关联
        imagepart.setContentID("img1");
        //把附件添加到部件集中
        parts.addBodyPart(imagepart);

        /*
         * 3 发送邮件
         */
        Transport.send(msg);
    }
}

2.4 JavaMail收取邮件

  我们使用pop3协议收取邮件!

public class ReceiveEmail {
    public static void main(String[] args) throws MessagingException {
        //POP3主机名
        String host = "pop3.163.com";
        //设置传输协议
        String protocol = "pop3";
        //用户账号
        String username = "15732631416@163.com";
        //密码或者授权码
        String password = "NPYRDKGYNSZIRZYO";


        /*
         * 获取Session
         */
        Properties props = new Properties();
        //协议
        props.setProperty("mail.store.protocol", protocol);
        //POP3主机名
        props.setProperty("mail.pop3.host", host);
        props.setProperty("mail.smtp.auth", "true");
        Session session = Session.getInstance(props);
        session.setDebug(true);

        /*
         * 获取Store,一个Store对象表示整个邮箱的存储
         *
         */
        URLName urlName = new URLName(protocol, host, 110, null, username, password);
        Store store = session.getStore(urlName);
        //连接邮件服务器
        store.connect();
        //要收取邮件,我们需要通过Store访问指定的Folder(文件夹),通常是INBOX表示收件箱
        //获取邮箱的邮件夹,通过pop3协议获取某个邮件夹的名称只能为inbox,不区分大小写
        Folder folder = store.getFolder("INBOX");
        //打开邮箱方式(邮件访问权限),这里的只读权限
        folder.open(Folder.READ_ONLY);
        //打印邮件总数/新邮件数量/未读数量/已删除数量:
        System.out.println("Total messages: " + folder.getMessageCount());
        System.out.println("New messages: " + folder.getNewMessageCount());
        System.out.println("Unread messages: " + folder.getUnreadMessageCount());
        System.out.println("Deleted messages: " + folder.getDeletedMessageCount());

        // 获得邮件夹Folder内的所有邮件Message对象,一个Message代表一个邮件
        Message[] messages = folder.getMessages();
        for (Message message : messages) {
            /*解析邮件*/

            //获取主题
            String subject = message.getSubject();
            System.out.println(subject);
            //解析其他内容
            //………………
        }
        //传入true表示删除操作会同步到服务器上(即删除服务器收件箱的邮件),无参方法默认传递true
        folder.close();
        store.close();
    }
}

2.5 相关异常

  1. Exception in thread “main” com.sun.mail.smtp.SMTPSendFailedException: 554 DT:SPM
    1. 一般是被邮件服务器识别为垃圾邮件,可以换个复杂点的主题和内容,或者换台主机发送。这很麻烦,比如在运行上面的案例时就有可能抛出这样的异常!
  2. Exception in thread “main” javax.mail.AuthenticationFailedException: 535 Error: authentication failed
    1. PasswordAuthentication中的用户登陆信息错误,可能是密码或者授权码错误。
  3. Exception in thread “main” com.sun.mail.smtp.SMTPSendFailedException: 553 Mail from must equal authorized user
    1. 如果用户信息和发件人信息不一致

3 总结

  本次我们学习了使用JavaMail的API简单的收发邮件的过程,电子邮件的收发需要使用道SMTP和POP3协议。在实际开发中,这样的底层API我们用的比较少,因为代码编写很麻烦,因此本文了解就行了。
  在实际项目开发中,常常使用Spring框架为我们提供的更高级的发送邮件的API。

如有需要交流,或者文章有误,请直接留言。另外希望点赞、收藏、关注,我将不间断更新各种Java学习博客!

标签:10,Java,EE,设置,服务器,msg,new,com,邮件
来源: https://blog.csdn.net/weixin_43767015/article/details/112388933

本站声明: 1. iCode9 技术分享网(下文简称本站)提供的所有内容,仅供技术学习、探讨和分享;
2. 关于本站的所有留言、评论、转载及引用,纯属内容发起人的个人观点,与本站观点和立场无关;
3. 关于本站的所有言论和文字,纯属内容发起人的个人观点,与本站观点和立场无关;
4. 本站文章均是网友提供,不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属;如您发现该文章侵犯了您的权益,可联系我们第一时间进行删除;
5. 本站为非盈利性的个人网站,所有内容不会用来进行牟利,也不会利用任何形式的广告来间接获益,纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。

专注分享技术,共同学习,共同进步。侵权联系[81616952@qq.com]

Copyright (C)ICode9.com, All Rights Reserved.

ICode9版权所有