JavaMailAPI详解(下)

五、如何使用JavaMail API
在明确了JavaMail API的核心部分如何工作后,本人将带领大家学习一些使用Java Mail API任务案例。
1.发送邮件
在获得了Session后,建立并填入邮件信息,然后发送它到邮件服务器。这便是使用Java Mail API发送邮件的过程,在发送邮件之前,我们需要设置SMTP服务器:通过设置Properties的mail.smtp.host属性。

成都创新互联公司主营栾川网站建设的网络公司,主营网站建设方案,APP应用开发,栾川h5小程序开发搭建,栾川网站营销推广欢迎栾川等地区企业咨询

 
 
 
  1. String host = ...;String from = ...;  
  2. String to = ...;// Get system propertiesProperties props = System.getProperties();  
  3. // Setup mail serverprops.put("mail.smtp.host", host);  
  4. // Get sessionSession session = Session.getDefaultInstance(props, null);  
  5. // Define messageMimeMessage message = new MimeMessage(session);  
  6. message.setFrom(new InternetAddress(from));  
  7. message.addRecipient(Message.RecipientType.TO,       
  8. new InternetAddress(to));message.setSubject("Hello JavaMail");  
  9. message.setText("Welcome to JavaMail");  
  10. // Send messageTransport.send(message); 

由于建立邮件信息和发送邮件的过程中可能会抛出异常,所以我们需要将上面的代码放入到try-catch结构块中。

2.接收邮件
为了在读取邮件,我们获得了session,并且连接到了邮箱的相应store,打开相应的Folder,然后得到我们想要的邮件,当然别忘记了在结束时关闭连接。

 
 
 
  1. String host = ...;String username = ...;  
  2. String password = ...;// Create empty propertiesProperties props = new Properties();  
  3. // Get sessionSession session = Session.getDefaultInstance(props, null);  
  4. // Get the storeStore store = session.getStore("pop3");
  5. store.connect(host, username, password);  
  6. // Get folderFolder folder = store.getFolder("INBOX");  
  7. folder.open(Folder.READ_ONLY);  
  8. // Get directoryMessage message[] = folder.getMessages();  
  9. for (int i=0, n=message.length;   
  10. i ": " + message[i].getFrom()[0]       
  11.  + "\t" + message[i].getSubject());}  
  12. // Close connection folder.close(false);  
  13. store.close(); 

上面的代码所作的是从邮箱中读取每个邮件,并且显示邮件的发信人地址和主题。从技术角度讲,这里存在着一个异常的可能:当发信人地址为空时,getFrom()[0]将抛出异常。

下面的代码片断有效的说明了如何读取邮件内容,在显示每个邮件发信人和主题后,将出现用户提示从而得到用户是否读取该邮件的确认,如果输入YES的话,我们可用Message.writeTo(java.io.OutputStream os)方法将邮件内容输出到控制台上,关于Message.writeTo()的具体用法请看JavaMail API。

 
 
 
  1. BufferedReader reader = new BufferedReader (    new InputStreamReader(System.in));  
  2. // Get directoryMessage message[] = folder.getMessages();  
  3. for (int i=0, n=message.length; i
  4. {    System.out.println(i + ": " + message[i].getFrom()[0]        
  5.  + "\t" + message[i].getSubject());      
  6. System.out.println("Do you want to read message? " +      "[YES to read/QUIT to end]");    
  7. String line = reader.readLine();      
  8. if ("YES".equals(line)) {      message[i].writeTo(System.out);    }   
  9. else if ("QUIT".equals(line)) {      break;    }} 

3.删除邮件和标志
设置与message相关的Flags是删除邮件的常用方法。这些Flags表示了一些系统定义和用户定义的不同状态。在Flags类的内部类Flag中预定义了一些标志:

 
 
 
  1. Flags.Flag.ANSWERED  
  2. Flags.Flag.DELETED  
  3. Flags.Flag.DRAFT  
  4. Flags.Flag.FLAGGED  
  5. Flags.Flag.RECENT  
  6. Flags.Flag.SEEN  
  7. Flags.Flag.USER 

但需要在使用时注意的:标志存在并非意味着这个标志被所有的邮件服务器所支持。例如,对于删除邮件的操作,POP协议不支持上面的任何一个。所以要确定哪些标志是被支持的——通过访问一个已经打开的Folder对象的getPermanetFlags()方法,它将返回当前被支持的Flags类对象。
删除邮件时,我们可以设置邮件的DELETED标志:

 
 
 
  1. message.setFlag(Flags.Flag.DELETED, true);  
  2. 但是首先要采用READ_WRITE的方式打开Folder:  
  3. folder.open(Folder.READ_WRITE);  

在对邮件进行删除操作后关闭Folder时,需要传递一个true作为对删除邮件的擦除确认。

folder.close(true);

Folder类中另一种用于删除邮件的方法expunge()也同样可删除邮件,但是它并不为sun提供的POP3实现支持,而其它第三方提供的POP3实现支持或者并不支持这种方法。
另外,介绍一种检查某个标志是否被设置的方法:Message.isSet(Flags.Flag flag)方法,其中参数为被检查的标志。

4.邮件认证
我们在前面已经学会了如何使用Authenticator类来代替直接使用用户名和密码这两字符串作为Session.getDefaultInstance()或者Session.getInstance()方法的参数。在前面的小试牛刀后,现在我们将了解到全面认识一下邮件认证。
我们在此取代了直接使用邮件服务器主机名、用户名、密码这三个字符串作为连接到POP3 Store的方式,使用存储了邮件服务器主机名信息的属性文件,并在获得Session时传入自定义的Authenticator实例:

 
 
 
  1. // Setup propertiesProperties props = System.getProperties();  
  2. props.put("mail.pop3.host", host);  
  3. // Setup authentication, get sessionAuthenticator auth = new PopupAuthenticator();  
  4. Session session = Session.getDefaultInstance(props, auth);  
  5. // Get the storeStore store = session.getStore("pop3");  
  6. store.connect(); 

PopupAuthenticator类继承了抽象类Authenticator,并且通过重载Authenticator类的getPasswordAuthentication()方法返回PasswordAuthentication类对象。而getPasswordAuthentication()方法的参数param是以逗号分割的用户名、密码组成的字符串。

 
 
 
  1. import javax.mail.*;  
  2. import java.util.*;  
  3. public class PopupAuthenticator extends Authenticator   
  4. {    public PasswordAuthentication getPasswordAuthentication(String param)   
  5. {      String username, password;        
  6. StringTokenizer st = new StringTokenizer(param, ",");        
  7. username = st.nextToken();        
  8. password = st.nextToken();        
  9. return new PasswordAuthentication(username, password);    }} 

5.回复邮件
回复邮件的方法很简单:使用Message类的reply()方法,通过配置回复邮件的收件人地址和主题(如果没有提供主题的话,系统将默认将“Re:”作为邮件的主体),这里不需要设置任何的邮件内容,只要复制发信人或者reply-to到新的收件人。而reply()方法中的boolean参数表示是否将邮件回复给发送者(参数值为false),或是恢复给所有人(参数值为true)。
补充一下,reply-to地址需要在发信时使用setReplyTo()方法设置。

 
 
 
  1. MimeMessage reply = (MimeMessage)message.reply(false);  
  2. reply.setFrom(new InternetAddress("president@whitehouse.gov"));  
  3. reply.setText("Thanks");  
  4. Transport.send(reply); 

6.转发邮件
转发邮件的过程不如前面的回复邮件那样简单,它将建立一个转发邮件,这并非一个方法就能做到。
每个邮件是由多个部分组成,每个部分称为一个邮件体部分,是一个BodyPart类对象,对于MIME类型邮件来讲就是MimeBodyPart类对象。这些邮件体包含在成为Multipart的容器中对于MIME类型邮件来讲就是MimeMultiPart类对象。在转发邮件时,我们建立一个文字邮件体部分和一个被转发的文字邮件体部分,然后将这两个邮件体放到一个Multipart中。说明一下,复制一个邮件内容到另一个邮件的方法是仅复制它的DataHandler(数据处理者)即可。这是由JavaBeans Activation Framework定义的一个类,它提供了对邮件内容的操作命令的访问、管理了邮件内容操作,是不同的数据源和数据格式之间的一致性接口。

 
 
 
  1. // Create the message to forwardMessage forward = new MimeMessage(session);  
  2. // Fill in headerforward.setSubject("Fwd: " + message.getSubject());  
  3. forward.setFrom(new InternetAddress(from));  
  4. forward.addRecipient(Message.RecipientType.TO,     new InternetAddress(to));  
  5. // Create your new message partBodyPart messageBodyPart = new MimeBodyPart();messageBodyPart.setText
  6. (    "Here you go with the original message:\n\n");  
  7. // Create a multi-part to combine the partsMultipart multipart = new MimeMultipart();  
  8. multipart.addBodyPart(messageBodyPart);  
  9. // Create and fill part for the forwarded contentmessageBodyPart = new MimeBodyPart();  
  10. messageBodyPart.setDataHandler(message.getDataHandler());  
  11. // Add part to multi partmultipart.addBodyPart(messageBodyPart);  
  12. // Associate multi-part with messageforward.setContent(multipart);  
  13. // Send messageTransport.send(forward); 

7.使用附件
附件作为与邮件相关的资源经常以文本、表格、图片等格式出现,如流行的邮件客户端一样,我们可以用JavaMail API从邮件中获取附件或是发送带有附件的邮件。

A.发送带有附件的邮件
发送带有附件的邮件的过程有些类似转发邮件,我们需要建立一个完整邮件的各个邮件体部分,在第一个部分(即我们的邮件内容文字)后,增加一个具有DataHandler的附件而不是在转发邮件时那样复制第一个部分的DataHandler。

如果我们将文件作为附件发送,那么要建立FileDataSource类型的对象作为附件数据源;如果从URL读取数据作为附件发送,那么将要建立URLDataSource类型的对象作为附件数据源。

然后将这个数据源(FileDataSource或是URLDataSource)对象作为DataHandler类构造方法的参数传入,从而建立一个DataHandler对象作为数据源的DataHandler。

接着将这个DataHandler设置为邮件体部分的DataHandler。这样就完成了邮件体与附件之间的关联工作,下面的工作就是BodyPart的setFileName()方法设置附件名为原文件名。

最后将两个邮件体放入到Multipart中,设置邮件内容为这个容器Multipart,发送邮件。

 
 
 
  1. // Define messageMessage message = new MimeMessage(session);  
  2. message.setFrom(new InternetAddress(from));  
  3. message.addRecipient(Message.RecipientType.TO,       
  4. new InternetAddress(to));message.setSubject("Hello JavaMail Attachment");  
  5. // Create the message part BodyPart messageBodyPart = new MimeBodyPart();  
  6. // Fill the messagemessageBodyPart.setText("Pardon Ideas");  
  7. Multipart multipart = new MimeMultipart();  
  8. multipart.addBodyPart(messageBodyPart);  
  9. // Part two is attachmentmessageBodyPart = new MimeBodyPart();  
  10. DataSource source = new FileDataSource(filename);  
  11. messageBodyPart.setDataHandler(new DataHandler(source));  
  12. messageBodyPart.setFileName(filename);multipart.addBodyPart(messageBodyPart);  
  13. // Put parts in messagemessage.setContent(multipart);  
  14. // Send the messageTransport.send(message); 

如果我们使用servlet实现发送带有附件的邮件,则必须上传附件给servlet,这时需要注意提交页面form中对编码类型的设置应为multipart/form-data。

method=post action="/myservlet">    

B.读取邮件中的附件
读取邮件中的附件的过程要比发送它的过程复杂一点。因为带有附件的邮件是多部分组成的,我们必须处理每一个部分获得邮件的内容和附件。
但是如何辨别邮件信息内容和附件呢?Sun在Part类(BodyPart类实现的接口类)中提供了getDisposition()方法让开发者获得邮件体部分的部署类型,当该部分是附件时,其返回之将是Part.ATTACHMENT。但附件也可以没有部署类型的方式存在或者部署类型为Part.INLINE,无论部署类型为Part.ATTACHMENT还是Part.INLINE,我们都能把该邮件体部分导出保存。

 
 
 
  1. Multipart mp = (Multipart)message.getContent();  
  2. for (int i=0, n=multipart.getCount(); 
  3. i{    Part part = multipart.getBodyPart(i));      
  4. String disposition = part.getDisposition();      
  5. if ((disposition != null) &&           
  6. ((disposition.equals(Part.ATTACHMENT) ||            
  7. (disposition.equals(Part.INLINE)))   
  8. { saveFile(part.getFileName(), part.getInputStream());    }} 

下列代码中使用了saveFile方法是自定义的方法,它根据附件的文件名建立一个文件,如果本地磁盘上存在名为附件的文件,那么将在文件名后增加数字表示区别。然后从邮件体中读取数据写入到本地文件中(代码省略)。

 
 
 
  1. // from saveFile()File file = new File(filename);  
  2. for (int i=0; file.exists(); i++)   
  3. {    file = new File(filename+i);} 

以上是邮件体部分被正确设置的简单例子,如果邮件体部分的部署类型为null,那么我们通过获得邮件体部分的MIME类型来判断其类型作相应的处理,代码结构框架如下:

 
 
 
  1. if (disposition == null)   
  2. {    // Check if plain    MimeBodyPart mbp = (MimeBodyPart)part;      
  3. if (mbp.isMimeType("text/plain"))   
  4. {      // Handle plain    } else   
  5. {      // Special non-attachment cases here of         
  6. // image/gif, text/html, ...    }...} 

8.处理HTML邮件
前面的例子中发送的邮件都是以文本为内容的(除了附件),下面将介绍如何接收和发送基于HTML的邮件。
A.发送HTML邮件
假如我们需要发送一个HTML文件作为邮件内容,并使邮件客户端在读取邮件时获取相关的图片或者文字的话,只要设置邮件内容为html代码,并设置内容类型为text/html即可:

  1. String htmlText = "

    Hello

    " +  " ;  

  2. message.setContent(htmlText, "text/html")); 

请注意:这里的图片并不是在邮件中内嵌的,而是在URL中定义的。邮件接收者只有在线时才能看到。
在接收邮件时,如果我们使用JavaMail API接收邮件的话是无法实现以HTML方式显示邮件内容的。因为JavaMail API邮件内容视为二进制流。所以要显示HTML内容的邮件,我们必须使用JEditorPane或者第三方HTML展现组件。

以下代码显示了如何使用JEditorPane显示邮件内容:

 
 
 
  1. if (message.getContentType().equals("text/html"))   
  2. {    String content = (String)message.getContent();      
  3. JFrame frame = new JFrame();      
  4. JEditorPane text = new JEditorPane("text/html", content);      
  5. text.setEditable(false);      
  6. JScrollPane pane = new JScrollPane(text);      
  7. frame.getContentPane().add(pane);      
  8. frame.setSize(300300);      
  9. frame.setDefaultCloseOperation(JFrame.DISPOSE_ON_CLOSE);      
  10. frame.show();} 

B.在邮件中包含图片
如果我们在邮件中使用HTML作为内容,那么最好将HTML中使用的图片作为邮件的一部分,这样无论是否在线都会正确的显示HTML中的图片。处理方法就是将HTML中用到的图片作为邮件附件并使用特殊的cid URL作为图片的引用,这个cid就是对图片附件的Content-ID头的引用。
处理内嵌图片就像向邮件中添加附件一样,不同之处在于我们必须通过设置图片附件所在的邮件体部分的header中Content-ID为一个随机字符串,并在HTML中img的src标记中设置为该字符串。这样就完成了图片附件与HTML的关联。

  1. String file = ...;  
  2. // Create the messageMessage message = new MimeMessage(session);  
  3. // Fill its headersmessage.setSubject("Embedded Image");  
  4. message.setFrom(new InternetAddress(from));  
  5. message.addRecipient(Message.RecipientType.TO,       
  6. new InternetAddress(to));  
  7. // Create your new message partBodyPart messageBodyPart = new MimeBodyPart();  
  8. String htmlText = "

    Hello

    " + ";

  9. messageBodyPart.setContent(htmlText, "text/html");  
  10. // Create a related multi-part to combine the partsMimeMultipart multipart = new MimeMultipart("related");
  11. multipart.addBodyPart(messageBodyPart);  
  12. // Create part for the imagemessageBodyPart = new MimeBodyPart();  
  13. // Fetch the image and associate to partDataSource fds = new FileDataSource(file);  
  14. messageBodyPart.setDataHandler(new DataHandler(fds));  
  15. messageBodyPart.setHeader("Content-ID"," " );  
  16. // Add part to multi-partmultipart.addBodyPart(messageBodyPart);  
  17. // Associate multi-part with messagemessage.setContent(multipart); 

9.在邮件中搜索短语
JavaMail API提供了过滤器机制,它被用来建立搜索短语。这个短语由javax.mail.search包中的SearchTerm抽象类来定义,在定义后我们便可以使用Folder的Search()方法在Folder中查找邮件:

SearchTerm st = ...;Message[] msgs = folder.search(st);

下面有22个不同的类(继承了SearchTerm类)供我们使用:

 
 
 
  1. AND terms (class AndTerm)  
  2. OR terms (class OrTerm)  
  3. NOT terms (class NotTerm)  
  4. SENT DATE terms (class SentDateTerm)  
  5. CONTENT terms (class BodyTerm)  
  6. HEADER terms (FromTerm / FromStringTerm, RecipientTerm / RecipientStringTerm, SubjectTerm, etc.)  

使用这些类定义的断语集合,我们可以构造一个逻辑表达式,并在Folder中进行搜索。下面是一个实例:在Folder中搜索邮件主题含有“ADV”字符串或者发信人地址为friend@public.com的邮件。

 
 
 
  1. SearchTerm st =     new Or
  2. Term(      new SubjectTerm("ADV:"),         
  3. new FromStringTerm("friend@public.com"));  
  4. Message[] msgs = folder.search(st); 

【编辑推荐】

  1. 对Java编程思想的忠告
  2. 和我共同了解Java是什么
  3. 著名的Java论坛和网站
  4. 2009年十大Java技术解决方案
  5. 2008最值得学习的五种JAVA技术

网站栏目:JavaMailAPI详解(下)
文章链接:http://www.stwzsj.com/qtweb/news3/13853.html

网站建设、网络推广公司-创新互联,是专注品牌与效果的网站制作,网络营销seo公司;服务项目有等

广告

声明:本网站发布的内容(图片、视频和文字)以用户投稿、用户转载内容为主,如果涉及侵权请尽快告知,我们将会在第一时间删除。文章观点不代表本网站立场,如需处理请联系客服。电话:028-86922220;邮箱:631063699@qq.com。内容未经允许不得转载,或转载时需注明来源: 创新互联