JavaMail是SUN提供给开发人员在应用程序中实现邮件发送和接收功能而提供的一套标准开发类库,支持常用的邮件协议,如SMTP、POP3、IMAP,开发人员使用JavaMail编写邮件程序时,无需考虑底层的通信细节(Socket),JavaMail也提供了能够创建出各种复杂MIME格式的邮件内容的API。使用JavaMail,我们可以实现类似OutLook、FoxMail的软件。虽然JavaMail(仅支持JDK4及以上)也是Java的API之一,但是却没有直接加入到JDK中,所以我们需要另行下载。另外,JavaMail依赖JAF(JavaBeans Activation Framework),JAF在Java6之后已经合并到JDK中,而JDK5之前需要另外下载JAF的类库。下载地址如下:
JavaMail:http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-downloads-eeplat-419426.html#javamail-1.4.5-oth-JPR
JavaMail spec:http://www.oracle.com/technetwork/java/javamail-1-149769.pdf
JAF:http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-downloads-java-plat-419418.html#jaf-1.1.1-fcs-oth-JPR
JavaMail下载好后,我们来看一下其主要内容:
- README.txt:整体介绍JavaMail,需要看一下
- docs/javadocs:The JavaMail API javadocs,需要看一下
- mail.jar:包括JavaMail API和所有service providers,大部分用户只需要该jar包
- lib/mailapi.jar :只有JavaMail API
- lib/imap.jar:The IMAP service provider
- lib/smtp.jar:The SMTP service provider
- lib/pop3.jar:The POP3 service provider
- lib/dsn.jar:multipart/report DSN message support
- demo:demo示例,简单了解,有需要再看
JavaMail包含两部分内容,一部分是JavaMail API,定义了一组平台无关、独立于通讯协议的邮件程序框架,该部分称为应用级接口,也就是供我们调用的部分,另一部分是service provider,该部分使用特定的协议语言来实现第一部分定义的抽象类和接口,这些协议包括:SMTP、NNTP、POP3、IMAP,如果让JavaMail与邮件服务器通信,就需要相应的协议支持,该部分称为服务提供者接口,也就是JavaMail自身需要的协议支持。
在使用JavaMail时,通常我们只需将mail.jar放在classpath下使用,它包含了JavaMail API部分和SUN自己实现的service provider部分。可能也有特殊的时候,我们应用程序中需要自己实现service provider部分,那我们只需要mailapi.jar。下面通过几个类来简单认识下JavaMail API:
- javax.mail.Session:上下文环境信息,如服务器的主机名、端口号、协议名称等
- javax.mail.Message:邮件模型,发送邮件和接收邮件的媒介,封装了邮件的信息,如发件人、收件人、邮件标题、邮件内容等
- javax.mail.Transport:连接邮件SMTP服务器,发送邮件
- javax.mail.Store:连接邮件POP3、IMAP服务器,收取邮件
通过这些类,最终就可以实现收发邮件,一个发送邮件的简单示例:
- public class JavaMailTest1 {
- public static void main(String[] args) throws MessagingException {
- Properties props = new Properties();
-
- props.setProperty("mail.debug", "true");
-
- props.setProperty("mail.smtp.auth", "true");
-
- props.setProperty("mail.host", "smtp.163.com");
-
- props.setProperty("mail.transport.protocol", "smtp");
-
-
- Session session = Session.getInstance(props);
-
-
- Message msg = new MimeMessage(session);
- msg.setSubject("JavaMail测试");
-
- msg.setText("这是一封由JavaMail发送的邮件!");
-
- msg.setFrom(new InternetAddress("java_mail_001@163.com"));
-
- Transport transport = session.getTransport();
-
- transport.connect("java_mail_001", "javamail");
-
- transport.sendMessage(msg, new Address[] {new InternetAddress("java_mail_002@163.com")});
-
- transport.close();
- }
- }
最终运行后,邮件发送成功。由于我们开启了debug调试,在控制台可以看到JavaMail和服务器之间的交互信息记录,可以发现,和
Java Mail(一):telnet实现发送收取邮件
中telnet下的命令及服务器反馈信息基本一致。