练习5发送附件.txt

JavaMail教程及示范用例源代码……

操作附件
附件是与邮件消息关联的资源，通常保存在消息之外，如：一个文本文件，电子表格或图片。对于像Eudora和Pine之类的常用邮件程序，您可以通过JavaMail API把资源附加到邮件消息上，并在您接收消息时获取附件。


发送附件
发送附件与转发消息非常相似，您要创建组成完整消息的各个部分。在创建好第一个部分即消息文本之后，您添加的用DataHandler类处理的其他部分就是您的附件，而不是转发消息中的共享处理程序。当您从一个文件读取附件时，附件的数据资源是FileDataSource；从URL读取时，则是URLDataSource。一旦您有了自己的DataSource，在将其通过setDataHandler()方法最终附加到BodyPart上之前，只需将其传递给DataHandler类的构造器即可。假定您想保留附件的原始文件名，要做的最后一件事就是用BodyPart类的setFileName()方法设置与附件关联的文件名。所有这些操作如下所示：
// Define message
Message message = new MimeMessage(session);
message.setFrom(new InternetAddress(from));
message.addRecipient(Message.RecipientType.TO, 
new InternetAddress(to));
message.setSubject("Hello JavaMail Attachment");
// Create the message part 
BodyPart messageBodyPart = new MimeBodyPart();
// Fill the message
messageBodyPart.setText("Pardon Ideas");
Multipart multipart = new MimeMultipart();
multipart.addBodyPart(messageBodyPart);
// Part two is attachment
messageBodyPart = new MimeBodyPart();
DataSource source = new FileDataSource(filename);
messageBodyPart.setDataHandler(new DataHandler(source));
messageBodyPart.setFileName(filename);
multipart.addBodyPart(messageBodyPart);
// Put parts in message
message.setContent(multipart);
// Send the message
Transport.send(message);
在消息中包含附件时，如果您的程序是一个servlet，您的用户就必须上传附件，并告诉您要把消息发送到什么位置。上传的每一个文件都可以用一个表单来处理，该表单是以multipart/表单数据（form-data）来编码的。
<FORM ENCTYPE="multipart/form-data" 
method=post action="/myservlet"> 
<INPUT TYPE="file" NAME="thefile">
<INPUT TYPE="submit" VALUE="Upload">
</FORM>
注意：消息的大小要受到您的SMTP服务器的限制，而不是由JavaMail API限制的。如果出现了问题，可以通过设置ms和mx参数来考虑增加Java堆区的空间尺寸。


获取附件
从消息中取出附件比发送附件涉及的操作要稍微多一点，而MIME没有简单的附件概念。当消息带有附件时，消息的内容就是一个Multipart对象。然后需要处理各个部分，以获取主要内容和附件。通过part.getDisposition()方法标记上Part.ATTACHMENT配置的部分显然就是附件。同时，附件也可以不带有配置（和非文本MIME类型）或Part.INLINE配置。当配置是Part.ATTACHMENT或Part.INLINE时，您可以脱离该消息部分的内容将其保存起来。只需通过getFileName()方法获取原始文件名，并通过getInputStream()方法获取输入流即可。
Multipart mp = (Multipart)message.getContent();
for (int i=0, n=multipart.getCount(); i<n; i++) {
Part part = multipart.getBodyPart(i));
String disposition = part.getDisposition();
if ((disposition != null) && 
((disposition.equals(Part.ATTACHMENT) || 
(disposition.equals(Part.INLINE))) {
saveFile(part.getFileName(), part.getInputStream());
}
}
saveFile()方法只用于根据文件名创建一个文件，从输入流中读取字节，并将它们写入一个文件中去。如果文件已存在，将在文件名后添加一个编号，直到找到一个不存在的文件为止。
// from saveFile()
File file = new File(filename);
for (int i=0; file.exists(); i++) {
file = new File(filename+i);
}
上面的代码介绍了消息的各个部分被标上相应的标志的一个最简单的例子。要想包含所有的情况，还要对disposition值为null及消息部分为MIME类型的情况作相应处理。
if (disposition == null) {
// Check if plain
MimeBodyPart mbp = (MimeBodyPart)part;
if (mbp.isMimeType("text/plain")) {
// Handle plain
} else {
// Special non-attachment cases here of image/gif, text/html, ...
}
...
}
处理HTML消息
发送基于HTML的消息比发送纯文本消息要稍微复杂一点，尽管它不需要做大量的工作。它全部取决于您特定的需求。
发送HTML消息
如果您所要做的全部工作是发送一个等价的HTML文件作为消息，并让邮件阅读者忧心于取出任何嵌入的图片或相关片段，那么就可以使用消息的setContent()方法，以字符串形式传递消息内容，并把内容类型设置为text/html。
String htmlText = "<H1>Hello</H1>" + 
"<img src=\"http://www.jguru.com/images/logo.gif/">";
message.setContent(htmlText, "text/html"));
在接收端，如果您用JavaMail API获取消息，在该API中没有内置任何用于以HTML格式显示消息的功能。JavaMail API只以字节流的形式来查看消息。要以HTML格式显示消息，您必须使用Swing JeditorPane或某些第3方HTML阅读器组件。
if (message.getContentType().equals("text/html")) {
String content = (String)message.getContent();
JFrame frame = new JFrame();
JEditorPane text = new JEditorPane("text/html", content);
text.setEditable(false);
JScrollPane pane = new JScrollPane(text);
frame.getContentPane().add(pane);
frame.setSize(300, 300);
frame.setDefaultCloseOperation(JFrame.DISPOSE_ON_CLOSE);
frame.show();
}
在消息中包含图片
另一方面，如果您的HTML消息中嵌入了作为消息一部分的图片，并且您想保持消息内容的完整，就必须把图片看作附件，并用特殊的通信标识符URL引用该图片，该通信标识符引用的是图片附件的内容ID报文。
嵌入图片的处理与附加一个文件到消息上非常相似，惟一的不同之处在于：您必须区分MimeMultipart中，哪些部分是在构造器（或通过setSubType()方法）通过设置其子类型而使之相关的，以及将图片的内容ID报头设置成任意字符串，它将在img标记中用作图片的源路径。下面显示了一个完整的示例：
String file = ...;
// Create the message
Message message = new MimeMessage(session);
// Fill its headers
message.setSubject("Embedded Image");
message.setFrom(new InternetAddress(from));
message.addRecipient(Message.RecipientType.TO, 
new InternetAddress(to));
// Create your new message part
BodyPart messageBodyPart = new MimeBodyPart();
String htmlText = "<H1>Hello</H1>" + 
"<img src=\"cid:memememe\">";
messageBodyPart.setContent(htmlText, "text/html");
// Create a related multi-part to combine the parts
MimeMultipart multipart = new MimeMultipart("related");
multipart.addBodyPart(messageBodyPart);
// Create part for the image
messageBodyPart = new MimeBodyPart();
// Fetch the image and associate to part
DataSource fds = new FileDataSource(file);
messageBodyPart.setDataHandler(new DataHandler(fds));
messageBodyPart.setHeader("Content-ID","memememe");
// Add part to multi-part
multipart.addBodyPart(messageBodyPart);
// Associate multi-part with message
message.setContent(multipart);