xJavaMail 是sun公司(现以被甲骨文收购)为方便Java开发人员在应用程序中实现邮件发送和接收功能而提供的一套标准开发包,它支持一些常用的邮件协议,如前面所讲的SMTP,POP3,IMAP,还有MIME等。我们在使用JavaMail API 编写邮件时,无须考虑邮件的底层实现细节,只要调用JavaMail 开发包中相应的API类就可以了。

获取 JavaMail 资源

JavaMail 在 GitHub 的地址是:https://github.com/javaee/javamail。不过这个项目现在已经被所有者归档,"This repository has been archived by the owner. It is now read-only.",如下:

javamail使用企业邮箱 java邮件_java 发送邮件

点击上图中右下角红色框部分 Release 版本信息,可以进入到 JavaMail 1.6.2 Final Release 界面,这里可以下载到 JavaMail 1.6.2 版本的 Source Code、javax.mail.jar 包、Samples 等,如下:

javamail使用企业邮箱 java邮件_java接收多个文件_02

Java 项目准备


创建项目的过程不多说,这里说一下怎么添加  javax.mail 依赖,如下:

javamail使用企业邮箱 java邮件_java接收多个文件_03

然后搜索 javax.mail,并从搜索结果中选择 javax.mail:mail:1.4.7 依赖文件,并且勾选 Download to,点击 OK,如下:

javamail使用企业邮箱 java邮件_java 发送邮件_04

之后就会自动下载 javax.mail:mail:1.4.7 依赖文件,如下左图;在出现的 Configure Library 对话框中直接点击 OK 即可,如下右图:

javamail使用企业邮箱 java邮件_java 发送邮件_05

javamail使用企业邮箱 java邮件_javamail 设置自动回执_06

这样 javax.mail:mail:1.4.7 依赖文件就会出现在项目的 Dependencies 中,勾选它并点击底部的 OK 按钮,如下:

javamail使用企业邮箱 java邮件_javamail 设置自动回执_07

完成之后,在项目目录结构的 lib 目录下就可以看到 mail-1.4.7.jar 和 activation-1.1.jar 两个依赖文件了,如下:

javamail使用企业邮箱 java邮件_java发送邮件_08

javamail使用企业邮箱 java邮件_javamail 设置自动回执_09

实现邮件发送

首先在 src/main/java 目录下创建一个 com.example.mail 目录用于放置 Java 代码文件,如下:

javamail使用企业邮箱 java邮件_javamail 设置自动回执_10

创建代码 SendMailText.java 文件,其内容如下:

package com.example.mail;import javax.mail.*;import javax.mail.internet.InternetAddress;import javax.mail.internet.MimeMessage;import java.util.Date;import java.util.Properties;public class SendMailText {    //发件人地址    private static String senderAddress = "AAAAAAAA@163.com";    //收件人地址    private static String recipientAddress = "BBBBBBBB@163.com";    //发件人账户名    private static String senderAccount = "AAAAAAAA";    //发件人账户密码    private static String senderPassword = "XXXXXXXXXXXXXXXX";    public static void main(String[] args) throws Exception {        //1.连接邮件服务器的参数配置        Properties props = new Properties();        //设置用户的认证方式        props.setProperty("mail.smtp.auth", "true");        //设置传输协议        props.setProperty("mail.transport.protocol", "smtp");        //设置收件人的 SMTP 服务器地址        props.setProperty("mail.smtp.host", "smtp.163.com");        //2.创建定义整个应用程序所需的环境信息的 Session 对象        Session session = Session.getInstance(props);        //设置调试信息在控制台打印出来        session.setDebug(true);        //3.创建邮件的实例对象        Message msg = getMimeMessage(session);        //4.根据 session 对象获取邮件传输对象 Transport        Transport transport = session.getTransport();        //设置发件人的账户名和密码        transport.connect(senderAccount, senderPassword);        //发送邮件,并发送到所有收件人地址,message.getAllRecipients() 获取到的是在创建邮件对象时添加的所有收件人,抄送人,密送人        transport.sendMessage(msg, msg.getAllRecipients());        //5.关闭邮件连接        transport.close();    }    /**     * 获得创建一封邮件的实例对象        */    public static MimeMessage getMimeMessage(Session session) throws Exception {        //创建一封邮件得实例对象        MimeMessage msg = new MimeMessage(session);        //设置发件人地址        msg.setFrom(new InternetAddress(senderAddress));        /**         * 设置收件人地址(可以增加多个收件人、抄送、密送),即下面这一行代码写多行         * MimeMessage.RecipientType.TO:发送         * MimeMessage.RecipientType.CC:抄送         * MimeMessage.RecipientType.BCC:密送         */        msg.setRecipient(MimeMessage.RecipientType.TO, new InternetAddress(recipientAddress));        //设置邮件主题        msg.setSubject("Mail Subject");        //设置邮件正文        msg.setContent("Simple plain text mail", "text/html;charset=UTF-8");        //设置邮件的发送时间,默认立即发送        msg.setSentDate(new Date());        return msg;    }}

完成上面的代码,还需要对发件邮箱进行设置,否则邮件发送不会成功。

首先这里要明确一点,上面代码中发件人账户密码 "XXXXXXXXXXXXXXXX" 并非发件邮箱的登录密码,而是发件邮箱的 "授权密码",顾名思义 "授权密码" 是邮箱授权第三方邮件客户端操作邮箱的专用密码,所以这里还需要对发件邮箱进行一些设置,对发件邮箱的设置如下(以 163 邮箱为例,其它邮箱设置方式可能会有差别):

登录到发件邮箱后,在顶部 "设置" 的下拉菜单中点击 "POP3/SMTP/IMAP",打开 POP3/SMTP/IMAP 设置界面。在 "开启服务" 一项中,分别开启 "IMAP/SMTP服务" 和 "POP3/SMTP服务",然后在 "授权密码管理" 设置中新增一个授权密码,而这个授权密码就是在代码中填入的 "发件人账户密码",如下:

javamail使用企业邮箱 java邮件_java接收多个文件_11

javamail使用企业邮箱 java邮件_javamail 设置自动回执_12

现在可以开始运行程序测试发送邮件了,在代码区域右键,点击 "Run 'SendMailText.main()'",如下:

javamail使用企业邮箱 java邮件_javamail 设置自动回执_13

没有出现错误信息,说明邮件发送是成功的,为了验证是否真的发送成功,可以登录收件邮箱查看是否接收到邮件,在收件邮箱查收到如下邮件,说明邮件发送是成功的:

javamail使用企业邮箱 java邮件_java 发送邮件_14

实现邮件接收

邮件接收现实中使用比较少,直接看代码即可。

RecipientMail.java 文件内容如下:

package com.example.mail;import javax.mail.*;import javax.mail.internet.InternetAddress;import javax.mail.internet.MimeMessage;import javax.mail.internet.MimeMultipart;import javax.mail.internet.MimeUtility;import java.io.*;import java.text.SimpleDateFormat;import java.util.Date;import java.util.Properties;public class RecipientMail {    //收件人地址    private static String recipientAddress = "BBBBBBBB@163.com";    //收件人账户名    private static String recipientAccount = "BBBBBBBB";    //收件人账户密码    private static String recipientPassword = "XXXXXXXXXXXXX";    public static void main(String[] args) throws Exception {        // 准备连接服务器的会话信息        Properties props = new Properties();        props.setProperty("mail.store.protocol", "pop3");        //协议//        props.setProperty("mail.pop3.port", "110");              //端口,默认端口就是 110,所以可以忽略        props.setProperty("mail.pop3.host", "pop3.163.com");     //pop3服务器        //创建 Session 实例对象        Session session = Session.getInstance(props);//        session.setDebug(true);        Store store = session.getStore("pop3");        store.connect("pop3.163.com", recipientAccount, recipientPassword);        //获得收件箱        Folder folder = store.getFolder("inbox");        //打开收件箱        Folder.READ_ONLY:只读权限    Folder.READ_WRITE:可读可写(可以修改邮件的状态)        folder.open(Folder.READ_WRITE);            //由于 POP3 协议无法获知邮件的状态,所以得到的是收件箱的邮件总数        System.out.println("未读邮件数: " + folder.getUnreadMessageCount());        //由于 POP3 协议无法获知邮件的状态,所以下面得到的结果始终都是 0        System.out.println("删除邮件数: " + folder.getDeletedMessageCount());        System.out.println("新邮件: " + folder.getNewMessageCount());        //获得收件箱中的邮件总数        System.out.println("邮件总数: " + folder.getMessageCount());        //得到收件箱中的所有邮件,并解析        Message[] messages = folder.getMessages();//        for (Message message : messages) {//            String subject = message.getSubject();//            Address[] from = message.getFrom();            String content = (String) message.getContent();//            System.out.println("---> " + from[0].toString() + ": " + subject);//        }        parseMessage(messages);        //释放资源        folder.close(true);        store.close();    }    /**     * 解析邮件     * @param message 要解析的邮件列表     */    public static void parseMessage(Message ...messages) throws MessagingException, IOException {        if ((messages == null) || (messages.length < 1))            throw new MessagingException("未找到要解析的邮件!");        //解析所有邮件        for (Message message : messages) {            MimeMessage msg = (MimeMessage) message;            System.out.println("---------解析第" + msg.getMessageNumber() + "封邮件---------");            System.out.println("主题: " + getSubject(msg));            System.out.println("发件人: " + getFrom(msg));            System.out.println("收件人: " + getRecipientAddress(msg, null));            System.out.println("发送时间: " + getSentDate(msg, null));            System.out.println("是否已读: " + isSeen(msg));            System.out.println("邮件优先级: " + getPriority(msg));            System.out.println("是否需要回执:" + isReplySign(msg));            System.out.println("邮件大小: " + msg.getSize() / 1024 + "kb");            boolean isContainerAttachment = isContainAttachment(msg);            System.out.println("是否包含附件: " + isContainerAttachment);//            if (isContainerAttachment) {//                saveAttachment(msg, "c:\\mailtmp\\" + msg.getSubject() + "_");  //保存附件//            }            StringBuffer content = new StringBuffer(30);            getMailTextContent(msg, content);            System.out.println("邮件正文: " + (content.length() > 100 ? content.substring(0, 100) + "..." : content));            System.out.println("------------------第" + msg.getMessageNumber() + "封邮件解析结束-------------------- ");            System.out.println();        }    }    /**     * 获得邮件主题     * @param msg 邮件内容     * @return 解码后的邮件主题     */    public static String getSubject(MimeMessage msg) throws UnsupportedEncodingException, MessagingException {        return MimeUtility.decodeText(msg.getSubject());    }    /**     * 获得邮件发件人     * @param msg 邮件内容     * @return 姓名      */    public static String getFrom(MimeMessage msg) throws MessagingException, UnsupportedEncodingException {        String from = "";        Address[] froms = msg.getFrom();        if (froms.length < 1)            throw new MessagingException("没有发件人!");        InternetAddress address = (InternetAddress) froms[0];        String person = address.getPersonal();        if (person != null) {            person = MimeUtility.decodeText(person) + " ";        } else {            person = "";        }        from = person + " + address.getAddress() + ">";        return from;    }    /**     * 根据收件人类型,获取邮件收件人、抄送和密送地址。如果收件人类型为空,则获得所有的收件人     *
Message.RecipientType.TO 收件人
 
   *  
  
Message.RecipientType.CC 抄送
 
   *  
  
Message.RecipientType.BCC 密送
 
   * @param msg 邮件内容 * @param type 收件人类型 * @return 收件人1 , 收件人2 , ... */ public static String getRecipientAddress(MimeMessage msg, Message.RecipientType type) throws MessagingException { StringBuffer recipientAddress = new StringBuffer(); Address[] addresses = null; if (type == null) { addresses = msg.getAllRecipients(); } else { addresses = msg.getRecipients(type); } if ((addresses == null) || (addresses.length < 1)) throw new MessagingException("没有收件人!"); for (Address address : addresses) { InternetAddress internetAddress = (InternetAddress) address; recipientAddress.append(internetAddress.toUnicodeString()).append(","); } recipientAddress.deleteCharAt(recipientAddress.length() - 1); return recipientAddress.toString(); } /** * 获得邮件发送时间 * @param msg 邮件内容 * @return yyyy年mm月dd日 星期x HH:mm */ public static String getSentDate(MimeMessage msg, String pattern) throws MessagingException { Date recipientDate = msg.getSentDate(); if (recipientDate == null) return ""; if ((pattern == null) || ("".equals(pattern))) pattern = "yyyy年MM月dd日 E HH:mm "; return new SimpleDateFormat(pattern).format(recipientDate); } /** * 获得邮件发送时间 * @param msg 邮件内容 * @return 邮件中存在附件返回 true,不存在返回 false */ public static boolean isContainAttachment(Part part) throws MessagingException, IOException { boolean flag = false; if (part.isMimeType("multipart/*")) { MimeMultipart multipart = (MimeMultipart) part.getContent(); int partCount = multipart.getCount(); for (int i=0; i BodyPart bodyPart = multipart.getBodyPart(i); String disp = bodyPart.getDisposition(); if ((disp != null) && (disp.equalsIgnoreCase(Part.ATTACHMENT) || (disp.equalsIgnoreCase(Part.INLINE)))) { flag = true; } else if (bodyPart.isMimeType("multipart/*")) { flag = isContainAttachment(bodyPart); } else { String contentType = bodyPart.getContentType(); if (contentType.indexOf("application") != -1) { flag = true; } if (contentType.indexOf("name") != -1) { flag = true; } } if (flag) break; } } else if (part.isMimeType("message/rfc822")) { flag = isContainAttachment((Part)part.getContent()); } return flag; } /** * 判断邮件是否已读 * @param msg 邮件内容 * @return 如果邮件已读返回 true,否则返回 false */ public static boolean isSeen(MimeMessage msg) throws MessagingException { return msg.getFlags().contains(Flags.Flag.SEEN); } /** * 判断邮件是否需要阅读回执 * @param msg 邮件内容 * @return 需要回执返回 true,否则返回 false */ public static boolean isReplySign(MimeMessage msg) throws MessagingException { boolean replySign = false; String[] headers = msg.getHeader("Disposition-Notification-To"); if (headers != null) { replySign = true; } return replySign; } /** * 判断邮件的优先级 * @param msg 邮件内容 * @return 1:紧急(High) 3:普通(Normal) 5:低(Low) */ public static String getPriority(MimeMessage msg) throws MessagingException { String priority = "普通"; String[] headers = msg.getHeader("X-Priority"); if (headers != null) { String headerPriority = headers[0]; if ((headerPriority.indexOf("1") != -1) || (headerPriority.indexOf("High") != -1)) priority = "紧急"; else if ((headerPriority.indexOf("5") != -1) || (headerPriority.indexOf("LOW") != -1)) priority = "低"; else priority = "普通"; } return priority; } /** * 获得邮件文本内容 * @param msg 邮件内容 * @return content 存储邮件文本内容的字符串 */ public static void getMailTextContent(Part part, StringBuffer content) throws MessagingException, IOException { boolean isContainTextAttach = part.getContentType().indexOf("name") > 0; if (part.isMimeType("text/*") && !isContainTextAttach) { content.append(part.getContent().toString()); } else if (part.isMimeType("message/rfc822")) { getMailTextContent((Part) part.getContent(), content); } else if (part.isMimeType("multipart/*")) { Multipart multipart = (Multipart) part.getContent(); int partCount = multipart.getCount(); for (int i=0; i BodyPart bodyPart = multipart.getBodyPart(i); getMailTextContent(bodyPart, content); } } } /** * 保存附件 * @param part 邮件中多个组合体中的某一个组合体 * @param destDir 附件保存目录 */ public static void saveAttachment(Part part, String destDir) throws UnsupportedEncodingException, MessagingException, FileNotFoundException, IOException { if (part.isMimeType("multipart/*")) { Multipart multipart = (Multipart) part.getContent(); int partCount = multipart.getCount(); for (int i=0; i BodyPart bodyPart = multipart.getBodyPart(i); String disp = bodyPart.getDisposition(); if ((disp != null) && (disp.equalsIgnoreCase(Part.ATTACHMENT) || disp.equalsIgnoreCase(Part.INLINE))) { InputStream is = bodyPart.getInputStream(); saveFile(is, destDir, decodeText(bodyPart.getFileName())); } else if (bodyPart.isMimeType("multipart/*")) { saveAttachment(bodyPart, destDir); } else { String contentType = bodyPart.getContentType(); if ((contentType.indexOf("name") != -1) || (contentType.indexOf("application") != -1)) { saveFile(bodyPart.getInputStream(), destDir, decodeText(bodyPart.getFileName())); } } } } else if (part.isMimeType("message/rfc822")) { saveAttachment((Part) part.getContent(), destDir); } } /** * 读取输入流中的数据保存至指定目录 * @param is 输入流 * @param fileName 文件名 * @param destDir 文件存储目录 */ private static void saveFile(InputStream is, String destDir, String fileName) throws FileNotFoundException, IOException { BufferedInputStream bis = new BufferedInputStream(is); BufferedOutputStream bos = new BufferedOutputStream(new FileOutputStream(new File(destDir + fileName))); int len = -1; while ((len = bis.read()) != -1) { bos.write(len); bos.flush(); } bos.close(); bis.close(); } /** * 文本解码 * @param encodeText 解码 MimeUtility.encodeText(String text) 方法编码后的文本 * @return 解码后的文本 */ private static String decodeText(String encodeText) throws UnsupportedEncodingException { if ((encodeText == null) || "".equals(encodeText)) { return ""; } else { return MimeUtility.decodeText(encodeText); } }}