基于Javamail构建邮件客户端的简单实现

背景

近期需要实现一个邮件客户端的项目,类似Foxmail,outlook客户端。但项目只做消息转发,不需要完整实现。

邮件协议

常用的电子邮件协议有SMTP、POP3、IMAP4,它们都隶属于TCP/IP协议簇,默认状态下,分别通过TCP端口25、110和143建立连接。
SMTP即简单邮件传输协议,SMTP邮件服务器是遵循SMTP协议的发送邮件的服务器。如QQ:smtp.qq.com、163:smtp.163.com
POP即邮局协议,可以查询邮件,查询是否有新邮件,可以删除邮件。POP3是POP协议的第三个版本。如QQ:pop.qq.com、163:pop.163.com。
IMAP即互联网信息访问协议,此协议优于POP协议,拥有POP协议的功能,克服了POP协议的缺点。这里不做过多介绍。
MIME多用途互联网邮件扩展类型,这个不是协议,也在这里介绍,因为邮件消息需要遵循MIME扩展类型。具体的对照关系可以参看http://tool.oschina.net/commons

邮箱帐号的设置

在第三方客户端登录,需要设置帐号授权,获取授权码,此授权码将作为登录鉴权的密码使用。具体设置以QQ邮箱为例:

  • 登录QQ邮箱,点击设置,帐号界面,下拉直到出现POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务的设置,在“IMAP/SMTP服务”选项处点击“开启”。
Setting.png
  • 出现了短信验证的界面,如上操作,将一串数字发送指定的电话号码后,点击“我已发送”。


    Setting.png
  • 开启成功后,就可以根据自己的需求设置“收取选项”。之后“保存设置”,到这里我们就完成了IMAP服务的开启,可以成功使用第三方邮件客户端登陆了(可以看到如果你在第三方登入时忘记授权码,你可以在这里点击“生成授权码”,重新发短信获得新授权码)。


    Setting.png
Javamail简介

JavaMail API提供了一种与平台无关和协议独立的框架来构建邮件和消息应用程序。下载地址:http://java.sun.com/products/javamail/
解压后将javax.mail.jar导入项目。
javamail主要的模块:

  • Session对象
    Session对象管理客户端与邮件服务器的连接会话
static Session getDefaultInstance(Properties props);
static Session getDefaultInstance(Properties props, Authenticator authenticator);
static Session getInstance(Properties props);
static Session getInstance(Properties props, Authenticator authenticator);

getDefaultInstance获取缺省初始对象,getInstance获取的都是新对象。
Properties对象复用java.util.Properties,SMTP协议属性参数设置如下:

Properties props = new Properties();
props.put("mail.debug", "true");
props.put("mail.smtp.auth", "true");
props.put("mail.smtp.starttls.enable", "true");
props.put("mail.smtp.host", "smtp.qq.com");
props.put("mail.smtp.port", "465");
props.put("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory");        props.put("mail.smtp.socketFactory.port", "465");
props.put("mail.smtp.socketFactory.fallback", "false");

POP3协议属性参数设置如下:

Properties props = new Properties();
props.put("mail.debug", "true");
props.put("mail.pop3.host", "pop3.qq.com");
props.put("mail.pop3.port", "995");
props.put("mail.pop3.starttls.enable", "true");

Authenticator对象控制连接过程中的权限认证,设置代码如下:

Authenticator authenticator = new javax.mail.Authenticator() {
                    protected PasswordAuthentication getPasswordAuthentication() {
                        return new PasswordAuthentication("user:XXXX", "password:XXXX");
                    }

user是邮箱登录帐号,password是第三方客户端登录授权码

  • Message对象
    MimeMessage对象表示整封邮件,MimeBodyPart对象表示邮件的一个MIME消息,MimeMultipart对象表示一个由多个MIME消息组合而成的MIME消息。在具体组装复杂MIME消息,可参考如下代码:
Message message = new MimeMessage(session);
message.setSubject("subject");
message.setContent("test", "text/plain;charset=UTF-8");
Multipart multipart = new MimeMultipart();
BodyPart messageBodyPart = new MimeBodyPart();
messageBodyPart.setText("test");
multipart.addBodyPart(messageBodyPart);
message.setContent(multipart);

这里涉及到MIME类型参考:http://tool.oschina.net/commons

  • 邮件地址设置以及附件参数的组装
    邮件地址由InternetAddress对象做转换,邮件包含的地址类型如下:
Message.RecipientType.TO;
Message.RecipientType.Cc;
Message.RecipientType.Bcc;

设置发件人:

message.setFrom(new InternetAddress("xxx@qq.com"));

设置收件人:

message.setRecipients(Message.RecipientType.TO,InternetAddress.parse("xxx@qq.com;xxxx@qq.com"));
message.addRecipients(Message.RecipientType.Cc,InternetAddress.parse("xxx@qq.com;xxxx@qq.com"));
message.addRecipients(Message.RecipientType.Bcc,InternetAddress.parse("xxx@qq.com;xxx@qq.com"));

设置附件:

messageBodyPart = new MimeBodyPart();
messageBodyPart.setDataHandler(new DataHandler(new DataSource("xxxx")));
messageBodyPart.setFileName("filename");
multipart.addBodyPart(messageBodyPart);

附件对象构造依赖DataHandler对象,DataHandler对象构造依赖DataSource对象。DataSource就是通过读取文件二进制流生成。javax.mail.util.ByteArrayDataSource可以直接通过二进制流生成DataSource对象。

final ByteArrayDataSource dataSource = new ByteArrayDataSource(data, (type == null || "".equals(type)) ? "application/octet-stream" : type);
  • Transport对象
    Transport对象控制邮件的发送,具体过程是:连接服务器->发送邮件->关闭连接,代码如下:
Transport transport = session.getTransport("smtps");
transport.connect("smtp.qq.com", 465, "xxx@qq.com", "password:xxxxx");
transport.sendMessage(message, message.getAllRecipients());
transport.close();
  • Store对象
    Store对象表示整个邮局,可以获取查看邮局的所有信息,如查看收件夹,需要获取收件夹文件目录:
Folder emailFolder = store.getFolder("INBOX");
emailFolder.open(Folder.READ_ONLY);
//从folder中获取这些邮件信息并打印出来
Message[] messages  = emailFolder.getMessages();

Folder 对象表示邮局的一个文件目录,一个Message对象就是一封邮件,拆解的过程与组装过程相反。
当获取整个Store对象以后,我们可以做更多的操作,如删除邮件,移动邮件等。但删除邮件与邮件帐号的设置相关,需要授权给第三方客户端操作权限。具体设置,参看各邮件服务商的帐号设置选项。

注意

使用javamail在连接邮件服务器时connect报错:

javax.net.ssl.SSLHandshakeException: Received fatal alert: handshake_failure

问题原因是jdk里面的jce包,安全性机制导致的访问https会报错,官网上有替代的jar包,下载替换:
http://www.oracle.com/technetwork/java/javase/downloads/jce-7-download-432124.html

总结

到此,邮件收发基本功能完成。后续需要思考:

  • 实现一个任务队列,因为邮件发送过程是个比较耗时的过程,可以扩展实现多线程处理。
  • 新邮件收取的通知
借此项目作为学习java的契机,如有不当之处,请指正。
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 157,012评论 4 359
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 66,589评论 1 290
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 106,819评论 0 237
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,652评论 0 202
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 51,954评论 3 285
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,381评论 1 210
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,687评论 2 310
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,404评论 0 194
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,082评论 1 238
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,355评论 2 241
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,880评论 1 255
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,249评论 2 250
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,864评论 3 232
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,007评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,760评论 0 192
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,394评论 2 269
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,281评论 2 259

推荐阅读更多精彩内容

  • 本文包括:1、名词解释2、邮件收发过程3、JavaMail 知识概要4、发送一封符合 MIME 协议的 JavaM...
    廖少少阅读 3,848评论 2 13
  • 一.下载并添加mail.jar包到项目中 这里不附送下载链接,百度一下,你就知道。 二. 设置邮箱 这里以网易邮箱...
    佳勋学长阅读 1,294评论 0 0
  • 电子邮件的应用非常广泛,例如在某网站注册了一个账户,自动发送一封欢迎邮件,通过邮件找回密码,自动批量发送活动信息等...
    谁在烽烟彼岸阅读 412评论 0 1
  • Java Mail 简介 常见的邮件协议包括:SMTP(Simple Mail Transfer Protocol...
    Josaber阅读 3,164评论 1 9
  • 从古代的八百里加急,到现在的电子邮件,邮件的发展见证了上下五千年的发展史,这些当然是废话,只是要说说邮件的重要性。...
    大牧莫邪阅读 1,435评论 0 12