电子邮件的应用非常广泛,例如在某网站注册了一个账户,自动发送一封欢迎邮件,通过邮件找回密码,自动批量发送活动信息等。但这些应用不可能和我们自己平时发邮件一样,先打开浏览器,登录邮箱,创建邮件再发送。本文将简单介绍如何通过 java 代码来创建电子邮件,并连接邮件服务器发送邮件。
1. 电子邮件协议
电子邮件的在网络中传输和网页一样需要遵从特定的协议,常用的电子邮件协议包括 smtp,pop3,imap。其中邮件的创建和发送只需要用到 smtp协议,所以本文也只会涉及到smtp协议。smtp 是 simple mail transfer protocol 的简称,即简单邮件传输协议。
2. javamail
我们平时通过 java 代码打开一个 http 网页链接时,通常可以使用已经对 http 协议封装好的 httpurlconnection 类来快速地实现。java 官方也提供了对电子邮件协议封装的 java 类库,就是javamail,但并没有包含到标准的 jdk 中,需要我们自己去官方下载,这里我从 javaee 官方的 github 仓库下载。
javamail 下载地址:https://github.com/javaee/javamail/releases
这里我下载的版本是 1.6.0 版本,包含了 smtp, imap, 和 pop3 协议的实现的 jar 包:
我把 javamail 1.6.0 的 jar 包上传到了 csdn,如果无法从 github 下载,可以从这:
特别注意:
- 本测试用例用的 javamail 版本是 1.6.0,如果下载到其他版本的 javamail 运行时出现问题,请使用 javamail 1.6.0 版本再进行尝试。
- 使用 javamail 1.6.0 要求的 jdk 版本必须是 jdk 1.7 以上(建议使用最新版 jdk)。
- 不要直接就完完全全复制我的代码,需要 修改一下发送的标题、内容、用户昵称,要不然所有人都直接复制我的代码发送,内容一致,邮箱服务器就可能会检测到这些内容是垃圾广告内容,不让你发送,会返回错误码,查询错误码也能查询到失败原因。
有些童鞋反应代码提示某些类找不到,或运行出现问题,往往都是 jdk 版本过低,或 javamail 版本过低,出现问题时 请使用推荐的版本。
再出现问题,只要能连接成功,都有错误码返回,有些童鞋发送失败在控制台已经给出了错误码,大部分还给出了查看错误码含义的链接,点开链接,查询对应的错误码,为什么失败,已经明明白白的告诉你了,针对失败原因修改即可!
邮件发送,涉及多端(本地代码端、邮件发送服务器端、邮件接收服务器端),保证自己的代码没问题了,不一定就能成功,你把你的邮件提交到邮件发送服务器,发送的服务器可以给你拒绝服务(比如认为发送的内容是垃圾广告,或者你频繁请求发送),这不是代码端能管的事情,但都有错误码返回,明确告诉你为什么错误。就算你发送成功了,对方也有可能接收不到,成功发送到对方的邮件接收服务器后,对方的服务器可以根据你的内容拒绝收你的邮件(比如认为你的内容是广告诈骗等信息,或者发送过于频繁),对方的服务器可能直接把你的邮件扔垃圾箱,或者直接忽略。出现这些问题,请修改发送的标题、内容、昵称等,重复的内容不要反复发送,或多更换收件箱和发件箱试试!!!
3. 创建一封简单的电子邮件
首先创建一个 java 工程,把下载好的 javax.mail.jar 作为类库加入工程,这里不多说。
邮件创建步骤:
- 创建一个邮件对象(mimemessage);
- 设置发件人,收件人,可选增加多个收件人,抄送人,密送人;
- 设置邮件的主题(标题);
- 设置邮件的正文(内容);
- 设置显示的发送时间;
- 保存到本地。
代码实现:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
|
package com.xiets.javamaildemo;
import javax.mail.session;
import javax.mail.internet.internetaddress;
import javax.mail.internet.mimemessage;
import java.io.fileoutputstream;
import java.io.outputstream;
import java.util.date;
import java.util.properties;
/**
* javamail 版本: 1.6.0
* jdk 版本: jdk 1.7 以上(必须)
*/
public class main {
public static void main(string[] args) throws exception {
// 1. 创建一封邮件
properties props = new properties(); // 用于连接邮件服务器的参数配置(发送邮件时才需要用到)
session session= session.getdefaultinstance(props); // 根据参数配置,创建会话对象(为了发送邮件准备的)
mimemessage message = new mimemessage(session); // 创建邮件对象
/*
* 也可以根据已有的eml邮件文件创建 mimemessage 对象
* mimemessage message = new mimemessage(session, new fileinputstream("myemail.eml"));
*/
// 2. from: 发件人
// 其中 internetaddress 的三个参数分别为: 邮箱, 显示的昵称(只用于显示, 没有特别的要求), 昵称的字符集编码
// 真正要发送时, 邮箱必须是真实有效的邮箱。
message.setfrom( new internetaddress( "aa@send.com" , "user_aa" , "utf-8" ));
// 3. to: 收件人
message.setrecipient(mimemessage.recipienttype.to, new internetaddress( "cc@receive.com" , "user_cc" , "utf-8" ));
// to: 增加收件人(可选)
message.addrecipient(mimemessage.recipienttype.to, new internetaddress( "dd@receive.com" , "user_dd" , "utf-8" ));
// cc: 抄送(可选)
message.setrecipient(mimemessage.recipienttype.cc, new internetaddress( "ee@receive.com" , "user_ee" , "utf-8" ));
// bcc: 密送(可选)
message.setrecipient(mimemessage.recipienttype.bcc, new internetaddress( "ff@receive.com" , "user_ff" , "utf-8" ));
// 4. subject: 邮件主题
message.setsubject( "test邮件主题" , "utf-8" );
// 5. content: 邮件正文(可以使用html标签)
message.setcontent( "test这是邮件正文。。。" , "text/html;charset=utf-8" );
// 6. 设置显示的发件时间
message.setsentdate( new date());
// 7. 保存前面的设置
message.savechanges();
// 8. 将该邮件保存到本地
outputstream out = new fileoutputstream( "myemail.eml" );
message.writeto(out);
out.flush();
out.close();
}
}
|
保存的 myemail.eml 可以使用邮件客户端打开查看,实际上就是一堆符合smtp协议格式的文本(内容使用base64进行了编码),也可用记事本打开,如下所示:
4. 发送电子邮件
发送邮件首先需要有一个邮箱账号和密码,本文以网易163邮箱为例,邮箱账号必须要开启 smtp 服务,在浏览器网页登录邮箱后一般在邮箱的“设置”选项中可以开启,并记下邮箱的 smtp 服务器地址,如下所示(其他邮箱大同小异):
代码实现:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
|
package com.xiets.javamaildemo;
import javax.mail.session;
import javax.mail.transport;
import javax.mail.internet.internetaddress;
import javax.mail.internet.mimemessage;
import java.util.date;
import java.util.properties;
/**
* javamail 版本: 1.6.0
* jdk 版本: jdk 1.7 以上(必须)
*/
public class main {
// 发件人的 邮箱 和 密码(替换为自己的邮箱和密码)
// ps: 某些邮箱服务器为了增加邮箱本身密码的安全性,给 smtp 客户端设置了独立密码(有的邮箱称为“授权码”),
// 对于开启了独立密码的邮箱, 这里的邮箱密码必需使用这个独立密码(授权码)。
public static string myemailaccount = "xxxxxxxxx@163.com" ;
public static string myemailpassword = "xxxxxxxxx" ;
// 发件人邮箱的 smtp 服务器地址, 必须准确, 不同邮件服务器地址不同, 一般(只是一般, 绝非绝对)格式为: smtp.xxx.com
// 网易163邮箱的 smtp 服务器地址为: smtp.163.com
public static string myemailsmtphost = "smtp.163.com" ;
// 收件人邮箱(替换为自己知道的有效邮箱)
public static string receivemailaccount = "xxxxxxxxx@qq.com" ;
public static void main(string[] args) throws exception {
// 1. 创建参数配置, 用于连接邮件服务器的参数配置
properties props = new properties(); // 参数配置
props.setproperty( "mail.transport.protocol" , "smtp" ); // 使用的协议(javamail规范要求)
props.setproperty( "mail.smtp.host" , myemailsmtphost); // 发件人的邮箱的 smtp 服务器地址
props.setproperty( "mail.smtp.auth" , "true" ); // 需要请求认证
// ps: 某些邮箱服务器要求 smtp 连接需要使用 ssl 安全认证 (为了提高安全性, 邮箱支持ssl连接, 也可以自己开启),
// 如果无法连接邮件服务器, 仔细查看控制台打印的 log, 如果有有类似 “连接失败, 要求 ssl 安全连接” 等错误,
// 打开下面 /* ... */ 之间的注释代码, 开启 ssl 安全连接。
/*
// smtp 服务器的端口 (非 ssl 连接的端口一般默认为 25, 可以不添加, 如果开启了 ssl 连接,
// 需要改为对应邮箱的 smtp 服务器的端口, 具体可查看对应邮箱服务的帮助,
// qq邮箱的smtp(sll)端口为465或587, 其他邮箱自行去查看)
final string smtpport = "465" ;
props.setproperty( "mail.smtp.port" , smtpport);
props.setproperty( "mail.smtp.socketfactory.class" , "javax.net.ssl.sslsocketfactory" );
props.setproperty( "mail.smtp.socketfactory.fallback" , "false" );
props.setproperty( "mail.smtp.socketfactory.port" , smtpport);
*/
// 2. 根据配置创建会话对象, 用于和邮件服务器交互
session session = session.getdefaultinstance(props);
session.setdebug( true ); // 设置为debug模式, 可以查看详细的发送 log
// 3. 创建一封邮件
mimemessage message = createmimemessage(session, myemailaccount, receivemailaccount);
// 4. 根据 session 获取邮件传输对象
transport transport = session.gettransport();
// 5. 使用 邮箱账号 和 密码 连接邮件服务器, 这里认证的邮箱必须与 message 中的发件人邮箱一致, 否则报错
//
// ps_01: 成败的判断关键在此一句, 如果连接服务器失败, 都会在控制台输出相应失败原因的 log,
// 仔细查看失败原因, 有些邮箱服务器会返回错误码或查看错误类型的链接, 根据给出的错误
// 类型到对应邮件服务器的帮助网站上查看具体失败原因。
//
// ps_02: 连接失败的原因通常为以下几点, 仔细检查代码:
// (1) 邮箱没有开启 smtp 服务;
// (2) 邮箱密码错误, 例如某些邮箱开启了独立密码;
// (3) 邮箱服务器要求必须要使用 ssl 安全连接;
// (4) 请求过于频繁或其他原因, 被邮件服务器拒绝服务;
// (5) 如果以上几点都确定无误, 到邮件服务器网站查找帮助。
//
// ps_03: 仔细看log, 认真看log, 看懂log, 错误原因都在log已说明。
transport.connect(myemailaccount, myemailpassword);
// 6. 发送邮件, 发到所有的收件地址, message.getallrecipients() 获取到的是在创建邮件对象时添加的所有收件人, 抄送人, 密送人
transport.sendmessage(message, message.getallrecipients());
// 7. 关闭连接
transport.close();
}
/**
* 创建一封只包含文本的简单邮件
*
* @param session 和服务器交互的会话
* @param sendmail 发件人邮箱
* @param receivemail 收件人邮箱
* @return
* @throws exception
*/
public static mimemessage createmimemessage(session session, string sendmail, string receivemail) throws exception {
// 1. 创建一封邮件
mimemessage message = new mimemessage(session);
// 2. from: 发件人(昵称有广告嫌疑,避免被邮件服务器误认为是滥发广告以至返回失败,请修改昵称)
message.setfrom( new internetaddress(sendmail, "某宝网" , "utf-8" ));
// 3. to: 收件人(可以增加多个收件人、抄送、密送)
message.setrecipient(mimemessage.recipienttype.to, new internetaddress(receivemail, "xx用户" , "utf-8" ));
// 4. subject: 邮件主题(标题有广告嫌疑,避免被邮件服务器误认为是滥发广告以至返回失败,请修改标题)
message.setsubject( "打折钜惠" , "utf-8" );
// 5. content: 邮件正文(可以使用html标签)(内容有广告嫌疑,避免被邮件服务器误认为是滥发广告以至返回失败,请修改发送内容)
message.setcontent( "xx用户你好, 今天全场5折, 快来抢购, 错过今天再等一年。。。" , "text/html;charset=utf-8" );
// 6. 设置发件时间
message.setsentdate( new date());
// 7. 保存设置
message.savechanges();
return message;
}
}
|
发送后查看收件人的收件箱:
包含文本、图片、附件 的复杂邮件的创建请看下一篇:基于 javamail 的 java 邮件发送:复杂邮件发送
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持服务器之家。
原文链接:http://blog.csdn.net/xietansheng/article/details/51673073