初试javax.mail

最近在项目中用到发送邮件的功能，因为之前没有接触过，找了不少资料才终于把它弄出来，今天写下这些，算是作个总结吧。 

一、首先定义一个邮件的数据结构类 
public class EmailData() { 
     String from   = null;  //发件人 
     String[] recipients = null;  //收件人,能够多个 
     String subject   = null;  //邮件主题 
     String content   = null;  //邮件内容 
     String contentType  = null;  //邮件内容格式(文本或html) 
     String fileName  = null;  //附件文件名(目前只提供一个附件) 
  
     //下面是相应的setter/getter方法，省略.. 
} 
二、发送不带附件的邮件(包括文本格式和html两种格式) 
public void postMail(EmailData emailData) 
 throws MessagingException,Exception { 
   
 String from   = emailData.getFrom(); 
 String[] recipients = emailData.getRecipents(); 
 String subject   = emailData.getSubject(); 
 String content   = emailData.getContent(); 
 String contentType = emailData.getContentType(); 
 String fileName  = emailData.getFileName(); 
  
    if (recipients != null && recipients.length > 0) {

     Properties props = new Properties(); 
     //设置邮件服务器地址，链接超时时限等信息 
     props.put("mail.smtp.host", "10.30.1.233"); //10.30.1.233邮件服务器 
     props.put("mail.smtp.connectiontimeout", "10000"); // 
  props.put("mail.smtp.timeout", "10000");   // 
     
     //建立缺省的session对象 
     Session session = Session.getDefaultInstance(props, null); 
  
     //建立message对象 
     Message msg = new MimeMessage(session); 
  
     //设置发件人和收件人 
     InternetAddress addressFrom = new InternetAddress(from); 
     msg.setFrom(addressFrom);   
     InternetAddress[] addressTo = new InternetAddress[recipients.length]; 
     for (int i = 0; i < recipients.length; i++){ 
         addressTo[i] = new InternetAddress(recipients[i]); 
     } 
     msg.setRecipients(Message.RecipientType.TO, addressTo); 
   
  //设置邮件标题，中文编码 
     subject = MimeUtility.encodeText(new String(subject.getBytes(), "GB2312"), "GB2312", "B"); 
     msg.setSubject(subject); 
     
     //设置邮件内容,区分文本格式和HTML格式 
     if (contentType == null || contentType.equals("text")) { 
      msg.setText(content); 
  } else if (contentType.equals("html")) { 
   //给消息对象设置内容 
   BodyPart bodyPart1 = new MimeBodyPart(); //新建一个存放信件内容的BodyPart对象 
   mdp.setContent(content, "text/html;charset=gb2312");//给BodyPart对象设置内容和格式/编码方式 
   Multipart mmp = new MimeMultipart();//新建一个MimeMultipart对象用来存放BodyPart对象(事实上能够存放多个) 
   //设置邮件附件 
   BodyPart bodyPart2 = new MimeBodyPart();  
   FileDataSource fileDataSource = new FileDataSource(fileName); 
   bodyPart2.setDataHandler(new DataHandler(fileDataSource));        
   bodyPart2.setFileName("=?GB2312?B?"+enc.encode(fileName.getBytes())+"?="); 
    
      
   Multipart multipart = new MimeMultipart(); 
   multipart.addBodyPart(bodyPart1); 
   multipart.addBodyPart(bodyPart2); 
    
   mmp.addBodyPart(mdp);//将BodyPart加入到MimeMultipart对象中(能够加入多个BodyPart) 
   msg.setContent(mmp);//把mm做为消息对象的内容 
  } 
      
     //设置邮件发送时间 
        msg.setSentDate(new java.util.Date()); 
        //调用抽象类的静态方法send()发送邮件 
     Transport.send(msg); 
    } 
} 

三、发送带附件的邮件稍微复杂一些，跟发送普通邮件的区别主要以下： 
   //设置邮件内容 
   BodyPart bodyPart1 = new MimeBodyPart(); 
   bodyPart1.setDataHandler(new DataHandler( new MailDataSource(content,"text/html"))); 
    
   //设置邮件附件 
   BodyPart bodyPart2 = new MimeBodyPart();  
   FileDataSource fileDataSource = new FileDataSource(fileName); 
   bodyPart2.setDataHandler(new DataHandler(fileDataSource));        
   //须要对附件文件名称进行转码，否则会出现乱码 
   bodyPart2.setFileName("=?GB2312?B?"+enc.encode(fileName.getBytes())+"?="); 
         
   Multipart multipart = new MimeMultipart(); 
   multipart.addBodyPart(bodyPart1); 
   multipart.addBodyPart(bodyPart2);

   //将Multipart加入到信件 
   newMessage.setContent(multipart); 

四、如下是转载的关于java mail的介绍 
Session 
-------------------------------------------------------------------- 
 Session 定义了一个基本的邮件会话，任何工做都是基于这个Session的。Session 对象须要一个 java.util.Properties 对象来获得相似 邮件服务器，用户名，密码这样的信息。 
  
 Session 的构造函数是私有的，你能够经过 getDefaultInstance() 方法来取得一个单一的能够被共享的默认session 如： 

  Properties props = new Properties(); 
  // 填写一些信息 
  Session session = Session.getDefaultInstance(props,null); 

 或者，你可使用 getInstance() 方法来建立一个惟一的 session如： 

  Properties props = new Properties(); 
  // 填写一些信息 
  Session session = Session.getInstance(props,null); 
  
 在这两种方法中 其中的 null 参数是一个 Authenticator 对象，在这里没有被使用的，因此就是null 
  
 在大多数案例中，使用一个共享session 已经作够了。 

Message 
---------------------------------------------------------------- 
 一旦你建立了Session对象，那么下面要作的就是建立 message 来发送。Message 是一个抽象类，在大部分应用中你可使用它的子类 javax.mail.internet.MimeMessage 。MimeMessage 是一个理解在不一样RFCs中定义的MIME类型以及headers的e-mail message&nbsp;。 Message headers 必须使用 US-ASCII 字符集。 

 能够用以下的方法建立一个 Message  
  MimeMessage message = new MimeMessage(session); 
 咱们注意到，这里须要用session对象做为构造函数的参数。固然，还有其它的构造函数，好比从用RFC822格式化过的输入流来建立message。 

 一旦你获得了 message ,你就能够来设置它的各个部分（parts）。设置内容（content）的基本的机制是使用setContent() 方法。 

  message.setContent("Email Content. ","text/plain"); 

 若是，你可以明确你的使用MimeMessage来建立message 而且只是使用普通的文本（plain text） 那么你也可使用 setText() 方法，setTest()方法只须要设置具体的内容，它默认的MIME类型是 text/plain 
   
  message.setText("Email Content. "); 
  
 对于普通文本类型的邮件，有一种机制是首选（ message.setText("Email Content. ")）的设置内容的方法。若是要建立其它类型的message ，好比　HTML类型的message  那么仍是须要使用前者　（　message.setContent("Email Content. ","text/html");　） 

 设置主题（subject ），使用setSubject() 方法 
   
  message.setSubject(" Subject "); 

Address  
---------------------------------------------------------------- 
  
 当你已经建立Session 以及 Message，而且已经为message 填充了内容，那么接下来要作的就是给你的邮件添加一个地址（Address）。　就像Message同样，Address也是一个抽象类，咱们可使用它的一个子类javax.mail.internet.InternetAddress　。 

 建立一个地址很是简单 

  Address address = new InternetAddress("suixin@asiainfo.com"); 

 若是，你但愿在出现邮件地址的地方出现一个名称，那么你只须要再多传递一个参数。 

  Address address = new InternetAddress("suixin@asiainfo.com","Steve"); 

 你须要为 message 的from以及 to 字段建立address对象。为了识别发送者，你须要使用setFrom() 和 setReplyTo() 方法。 
   
  messge.setFrom(address); 

 若是你的message 须要显示多个 from 地址，可使用 addFrom() 方法 

  Address address[] = {....}; 
  message.addFrom(address); 

 为了辨识message 的收件人，你须要使用 setRecipient() 方法。这个方法除了address参数以外，还须要一个Message.RecipientType 。 

 message.addRecipient(type,address); 

 Message.RecipientType有几个预先定义好的类型 
  
 Message.RecipientType.TO　　收件人 
 Message.RecipientType.CC　　抄送 
 Message.RecipientType.BCC　 暗送 

 若是你的一封邮件，须要发送给你的老师，并还要给你的几个同窗，那么你能够这样 

 Address toAddress = new InternetAddress("teacher@17288.com"); 
 Address[] ccAddress = {new InternetAddress("schoolmate1@17288.com"),new InternetAddress("schoolmate2@17288.com")}; 

 message.addRecipient(Message.RecipientType.To, toAddress); 
 message.addRecipient(Message.RecipientType.CC, ccAddress); 
  
 JavaMail 没有提供电子邮件地址有效性的检测。这些超越了JavaMail API的范围。 

Authenticator 
  
 经过Authenticator设置用户名、密码，来访问受保护的资源，这里的资源通常指的是邮件服务器。 
  
 Authenticator也是一个抽象类，你须要本身编写子类已备应用。你须要实现getPasswordAuthentication()方法，并返回一个PasswordAuthentication实例。你必须在 session被建立时， 注册你的 Authenticator。这样，当须要进行认证是，你的Authenticator就能够被获得。 

  Properties props = new Properties(); 
  //设置属性 
  Authenticator auth = new YourAuthenticator(); 
  Session session = Session.getDefaultInstance(props, auth); 
  
Transport 
---------------------------------------------------------------- 

 发送消息最后的一步就是使用Transport类，你能够经过两种方法来进行发送。 
 Transport 是一个抽象类，你能够调用它静态的send() 方法来发送 

  Transport.send(message); 

 或者，你能够为你使用的协议从session中取得一个指定的实例， 

  Transport transport = session.getTransport("smtp"); 
  transport.sendMessage(message, message.getAllRecipients()); 
  transport.close(); 

Store and Folder 
  
 这两个类重要用于取得信息。在建立了Session以后，须要链接到一个 Store ，你须要告诉Store  你使用的是什么协议。 

  // Store store = session.getStore("imap"); 
  Store store = session.getStore("pop3"); 
  store.connect(host, username, password); 

 在链接到一个 Store 后，你能够获得一个 Folder，固然，这个Floder必须是打开的。 

  Folder folder = store.getFolder("INBOX"); 
  folder.open(Folder.READ_ONLY); 
  Message message[] = folder.getMessages(); 

 若是使用POP3那么，INDEX是惟一可用的文件夹。若是使用的是IMAP，你就可使用其它的文件夹。