JavaMail API常用类
JavaMail API使用javax.mail.Message类来表示一封邮件,Message类是一个抽象类,所以我们需要使用其子类javax.mail.internet.MimeMessage类来创建Message类的实例对象,如果我们创建的是一个简单文本邮件,那么MimeMessage类就可以满足我们的需求了,但是如果需要创建一封包含内嵌资源或者是带附件的复杂邮件,则需要使用到JavaMail API中的MimeMessage、javax.mail.internet.MimeBodyPart和javax.mail.internet.MimeMultipart等类。
1、MimeMessage类表示整封邮件
2、MimeBodyPart类表示邮件的一个MIME消息
3、MimeMultipart类表示一个由多个MIME消息组合成的组合MIME消息。
这三个类的工作关系如下图所示:
虽然应用程序开发者在使用JavaMailAPI创建邮件内容时,通常只需要使用MimeMessage,MimeBodyPart和MimeMultipart这3个主要的类,但是了解他们的类继承关系也是必要的。下图列出了这三个类的继承关系以及常用方法。
创建邮件
import java.util.Date; import java.util.Properties; import javax.mail.Message; import javax.mail.Session; import javax.mail.internet.InternetAddress; import javax.mail.internet.MimeMessage; import java.io.FileOutputStream; public class TextMessage { public static void main(String[] args) throws Exception { String from = "123456@qq.com"; String to = "123456@163.com"; String subject = "test"; String body = "test!!!"; // 创建Session实例对象 Session session = Session.getDefaultInstance(new Properties()); // 创建MimeMessage实例对象 MimeMessage msg = new MimeMessage(session); // 设置发件人 msg.setFrom(new InternetAddress(from)); // 设置收件人 msg.setRecipients(Message.RecipientType.TO, InternetAddress.parse(to)); // 设置发送日期 msg.setSentDate(new Date()); // 设置邮件主题 msg.setSubject(subject); // 设置纯文本内容的邮件正文 msg.setText(body); // 保存并生成最终的邮件内容 msg.saveChanges(); // 把MimeMessage对象中的内容写入到文件中 msg.writeTo(new FileOutputStream("c:\test.eml")); } }
1、MimeMessage类:上面介绍过MimeMessage是Message类的一个具体实现类,用来创建Message类的实例对象,这里构造函数传入了一个Session对象作为参数;
2、Session类:该对象用于收集客户端与邮件服务器之间的网络连接信息和定义整个邮件程序所需的环境信息,这些信息作为Session对象的属性保存在Session对象中,Session对象利用了java.util.Properties对象获得了邮件服务器、用户名、密码信息和整个应用程序都要使用到的共享信息,由于Session类的构造方法是私有的,所以我们使用Session类提供的getDefaultInstance()这个静态工厂方法获得一个默认的Session对象;
3、Properties类:该类表示了一个持久的属性集,用于存放相关键值对信息作为参数来创建Session对象,这里构造了一个空的集合作为参数;
4、InternetAddress类:该类是抽象类Address类的一个子类,用来创建一个邮件地址;
5、RecipientType类:该类是Message类的一个内部类,该类有3个静态变量,TO表示收件人,CC表示抄送人(收件人知道抄送的人),BCC表示密送人(收件人不知道密送的人)。
import java.util.Date; import java.util.Properties; import javax.mail.Message; import javax.mail.Session; import javax.mail.internet.InternetAddress; import javax.mail.internet.MimeMessage; import java.io.FileOutputStream; public class HtmlMessage { public static void main(String[] args) throws Exception { String from = "123456@qq.com"; String to = "123456@163.com"; String subject = "test"; String body = "<h4>欢迎大家阅读此邮件</h4>"; // 创建Session实例对象 Session session = Session.getDefaultInstance(new Properties()); // 创建MimeMessage实例对象 MimeMessage msg = new MimeMessage(session); // 设置发件人 msg.setFrom(new InternetAddress(from)); // 设置收件人 msg.setRecipients(Message.RecipientType.TO, InternetAddress.parse(to)); // 设置发送日期 msg.setSentDate(new Date()); // 设置邮件主题 msg.setSubject(subject); // 设置HTML格式的邮件正文 msg.setContent(body, "text/html;charset=gb2312"); // 保存并生成最终的邮件内容 msg.saveChanges(); // 把MimeMessage对象中的内容写入到文件中 msg.writeTo(new FileOutputStream("c:\test.eml")); } }
import java.io.FileOutputStream; import java.util.Properties; import javax.activation.DataHandler; import javax.activation.FileDataSource; import javax.mail.Message; import javax.mail.Session; import javax.mail.internet.InternetAddress; import javax.mail.internet.MimeBodyPart; import javax.mail.internet.MimeMessage; import javax.mail.internet.MimeMultipart; public class PictureMessage { public static void main(String[] args) throws Exception { String from = "123456@qq.com";// 发件人地址 String to = "123456@163.com"; // 收件人地址 String subject = "HTML邮件"; String body = "<a href=http://www.cnblogs.com>" + "欢迎大家访问博客园</a></br>" + "<img src="c:\dog.jpg">"; Session session = Session.getDefaultInstance(new Properties()); // 创建MimeMessage对象,并设置各种邮件头字段 MimeMessage message = new MimeMessage(session); message.setFrom(new InternetAddress(from)); message.setRecipients(Message.RecipientType.TO, InternetAddress.parse(to)); message.setSubject(subject); // 创建一个子类型为"related"的MimeMultipart对象。 MimeMultipart multipart = new MimeMultipart("related"); /* * 创建一个表示HTML正文的MimeBodyPart对象, 并将它加入到前面创建的MimeMultipart对象中 */ MimeBodyPart htmlBodyPart = new MimeBodyPart(); htmlBodyPart.setContent(body, "text/html;charset=gb2312"); multipart.addBodyPart(htmlBodyPart); /* * 创建一个表示图片内容的MimeBodyPart对象, 并将它加入到前面创建的MimeMultipart对象中 */ MimeBodyPart gifBodyPart = new MimeBodyPart(); FileDataSource fds = new FileDataSource("c:\dog.jpg"); gifBodyPart.setFileName(fds.getName()); gifBodyPart.setDataHandler(new DataHandler(fds)); multipart.addBodyPart(gifBodyPart); /* * 将MimeMultipart对象设置为整个邮件的内容, 要注意调用saveChanges方法进行更新 */ message.setContent(multipart); message.saveChanges(); // 把MimeMessage对象中的内容写入到文件中 message.writeTo(new FileOutputStream("c:\PictureMessage.eml")); } }
MimeMultipart有两种构造函数
public MimeMultipart() public MimeMultipart(String subtype)
第一种是无参数的,其默认的实例对象的MIME类型为mixed,第二种制定一个类型来创建MimeMultipart类的实例对象,其有三种常用的类型:mixed,related,alternative,这三种类型在MIME中的组合关系如下所示:
import java.io.FileOutputStream; import java.util.Properties; import javax.activation.DataHandler; import javax.activation.FileDataSource; import javax.mail.Message; import javax.mail.Session; import javax.mail.internet.InternetAddress; import javax.mail.internet.MimeBodyPart; import javax.mail.internet.MimeMessage; import javax.mail.internet.MimeMultipart; public class ComplexMessage { public static void main(String[] args) throws Exception { Session session = Session.getDefaultInstance(new Properties()); MimeMessage message = createMessage(session); message.writeTo(new FileOutputStream("c:\ComplexMessage.eml")); } public static MimeMessage createMessage(Session session) throws Exception { String from = "123456@qq.com";// 发件人地址 String to = "123456@163.com"; // 收件人地址 String subject = "HTML邮件"; // 邮件主题 String body = "<a href=http://www.cnblogs.com>" + "欢迎大家访问博客园</a></br>" + "<img src="c:\dog.jpg">"; MimeMessage message = new MimeMessage(session); message.setFrom(new InternetAddress(from)); message.setRecipients(Message.RecipientType.TO, InternetAddress.parse(to)); message.setSubject(subject); // 创建代表邮件正文和附件的各个MimeBodyPart对象 MimeBodyPart contentPart = createContent(body, "c:\dog.jpg"); // 下面的附件可以是视频或者是音频 MimeBodyPart attachPart1 = createAttachment("c:\音乐.MP3"); MimeBodyPart attachPart2 = createAttachment("c:\视频.avi"); // 创建用于组合邮件正文和附件的MimeMultipart对象 MimeMultipart allMultipart = new MimeMultipart("mixed"); allMultipart.addBodyPart(contentPart); allMultipart.addBodyPart(attachPart1); allMultipart.addBodyPart(attachPart2); // 设置整个邮件内容为最终组合出的MimeMultipart对象 message.setContent(allMultipart); message.saveChanges(); return message; } public static MimeBodyPart createContent(String body, String filename) throws Exception { /* * 创建代表组合MIME消息的MimeMultipart对象, 和将该MimeMultipart对象保存到的MimeBodyPart对象 */ MimeBodyPart contentPart = new MimeBodyPart(); MimeMultipart contentMultipart = new MimeMultipart("related"); /* * 创建用于保存HTML正文的MimeBodyPart对象, 并将它保存到MimeMultipart中 */ MimeBodyPart htmlBodyPart = new MimeBodyPart(); htmlBodyPart.setContent(body, "text/html;charset=gb2312"); contentMultipart.addBodyPart(htmlBodyPart); /* * 创建用于保存图片的MimeBodyPart对象, 并将它保存到MimeMultipart中 */ MimeBodyPart gifBodyPart = new MimeBodyPart(); FileDataSource fds = new FileDataSource(filename); gifBodyPart.setDataHandler(new DataHandler(fds)); contentMultipart.addBodyPart(gifBodyPart); // 将MimeMultipart对象保存到MimeBodyPart对象中 contentPart.setContent(contentMultipart); return contentPart; } public static MimeBodyPart createAttachment(String filename) throws Exception { // 创建保存附件的MimeBodyPart对象,并加入附件内容和相应信息 MimeBodyPart attachPart = new MimeBodyPart(); FileDataSource fds = new FileDataSource(filename); attachPart.setDataHandler(new DataHandler(fds)); attachPart.setFileName(fds.getName()); return attachPart; } }