Java: JavaMail 初试(一)

前言：以前的我，很喜欢写东西，写一写所想所见所闻所感，但是工作之后，总不能写出让自己满意的文章，突发奇想，能否利用写博客的时机，将其写成类似散文似的博文呢？哈哈...

邮件功能尝试：作为一个小菜鸟，对于技术性的东西却有特殊的偏好，每每通过自己学习而获得新的知识，总会如孩童拥有一个新奇的玩意儿一样，欢欣雀跃。第一次写邮件功能，这一篇文章就是记录下，我在参考网上前辈的博文敲代码时遇到的情况，代码大部分都是参考的网上的博文，感谢！我尽量写的详细，以备后用和帮助后来者。

言归正传:

1.环境及工具：myeclipse 9.0 ； jdk7 ；

2.项目截图：

3.jar备注:需要的jar包如上图所示，javamail-1[1].4.2.zip ； jaf-1_1_1.zip ；dom4j-1.6.1.jar ；jaxen-1.1.6.jar ，可以在网上自己下载

4.代码示例：主要参考网上的博文 ，地址：http://www.cnblogs.com/java-pan/archive/2012/03/06/javamail.html

4.1定义邮件发送所需要的字段：

 package com.email.emailtest;

 /**
  * 定义发送邮件的所有字段的javabean
  *
  * @author Administrator
  *
  */
 public class MailInfo {
     private String host;// 邮件服务器域名或IP
     private String from;// 发件人
     private String to;// 收件人
     private String cc;// 抄送人
     private String username;// 发件人用户名
     private String password;// 发件人密码
     private String title;// 邮件的主题
     private String content;// 邮件的内容

     public String getHost() {
         return host;
     }

     public void setHost(String host) {
         this.host = host;
     }

     public String getFrom() {
         return from;
     }

     public void setFrom(String from) {
         this.from = from;
     }

     public String getTo() {
         return to;
     }

     public void setTo(String to) {
         this.to = to;
     }

     public String getCc() {
         return cc;
     }

     public void setCc(String cc) {
         this.cc = cc;
     }

     public String getUsername() {
         return username;
     }

     public void setUsername(String username) {
         this.username = username;
     }

     public String getPassword() {
         return password;
     }

     public void setPassword(String password) {
         this.password = password;
     }

     public String getTitle() {
         return title;
     }

     public void setTitle(String title) {
         this.title = title;
     }

     public String getContent() {
         return content;
     }

     public void setContent(String content) {
         this.content = content;
     }
 }

4.2对密码进行加解密

 package com.email.emailtest;

 /**
  * 对密码进行加密和解密
  *
  * @author Administrator
  *
  */
 public class Encrypt {

     public static final int pass1 = 10;
     public static final int pass2 = 1;

     public Encrypt() {
     }

     /**
      * @Title: DoEncrypt
      * @Description: 对密码进行加密的方法
      * @param @param str
      * @param @return 设定文件
      * @return String 返回类型
      * @throws
      */
     public static String DoEncrypt(String str) {
         StringBuffer enStrBuff = new StringBuffer();
         for (int i = 0; i < str.length(); i++) {
             int tmpch = str.charAt(i);
             tmpch ^= 1;
             tmpch ^= 0xa;
             enStrBuff.append(Integer.toHexString(tmpch));
         }

         return enStrBuff.toString().toUpperCase();
     }

     /**
      * @Title: DoDecrypt
      * @Description: 对密码进行解密的方法
      * @param @param str
      * @param @return 设定文件
      * @return String 返回类型
      * @throws
      */
     public static String DoDecrypt(String str) {
         String deStr = str.toLowerCase();
         StringBuffer deStrBuff = new StringBuffer();
         for (int i = 0; i < deStr.length(); i += 2) {
             String subStr = deStr.substring(i, i + 2);
             int tmpch = Integer.parseInt(subStr, 16);
             tmpch ^= 1;
             tmpch ^= 0xa;
             deStrBuff.append((char) tmpch);
         }

         return deStrBuff.toString();
     }

     public static void main(String args[]) {
         String source = "123456";
         String s = DoEncrypt(source);
         System.out.println("de=" + s);

         source = DoDecrypt(s);
         System.out.println("en=" + source);

     }

 }

4.3邮件授权类

 package com.email.emailtest;

 import javax.mail.PasswordAuthentication;

 /**
  * 邮件授权类
  *
  * @author Administrator
  *
  */
 public class MyAuthenticator extends javax.mail.Authenticator {

     private String strUser;
     private String strPwd;

     public MyAuthenticator(String user, String password) {
         this.strUser = user;
         this.strPwd = password;
     }

     protected PasswordAuthentication getPasswordAuthentication() {
         return new PasswordAuthentication(strUser, strPwd);
     }
 }

4.4邮件发送

 package com.email.emailtest;

 import java.io.BufferedReader;
 import java.io.File;
 import java.io.FileInputStream;
 import java.io.FileNotFoundException;
 import java.io.IOException;
 import java.io.InputStreamReader;
 import java.io.UnsupportedEncodingException;
 import java.security.Security;
 import java.util.Properties;
 import java.util.logging.Logger;

 import javax.mail.Message;
 import javax.mail.MessagingException;
 import javax.mail.Session;
 import javax.mail.Transport;
 import javax.mail.internet.AddressException;
 import javax.mail.internet.InternetAddress;
 import javax.mail.internet.MimeMessage;

 import org.dom4j.Document;
 import org.dom4j.DocumentException;
 import org.dom4j.DocumentHelper;
 import org.dom4j.Element;

 import com.email.utils.LogManager;

 /**
  * 发送邮件
  *
  * @author Administrator
  *
  */
 public class SendMail {
     private static final Logger log = LogManager.getLogger(SendMail.class);
     // 配置文件xml的路径
     private final static String XML_PATH = "src" + File.separator
             + "com\\email\\emailtest" + File.separator + "SendMail.xml";

     // private final static String XML_PATH =
     // "src\\com\\email\\emailtest\\SendMail.xml";

     // xml文件中字段对应的javabean对象
     private static MailInfo mailInfo = new MailInfo();

     /**
      * <p>
      * Title: readXML
      * </p>
      * <p>
      * Description:读取xml文件,把文件内容以字符串形式输出
      * </p>
      *
      * @param xmlPath
      *            配置文件的路径
      * @return
      * @throws Exception
      */
     private String readXML(String xmlPath) throws Exception {
         log.info("----xmlPath----" + xmlPath);

         String fileContent = "";
         File file = new File(xmlPath);
         if (file.isFile() && file.exists()) {
             try {
                 InputStreamReader read = new InputStreamReader(
                         new FileInputStream(file), "UTF-8");
                 BufferedReader reader = new BufferedReader(read);
                 String line;
                 try {
                     while ((line = reader.readLine()) != null) {
                         fileContent += line;
                     }
                     reader.close();
                     read.close();
                 } catch (IOException e) {
                     e.printStackTrace();
                 }
             } catch (UnsupportedEncodingException e) {
                 e.printStackTrace();
             } catch (FileNotFoundException e) {
                 e.printStackTrace();
             }
         } else {
             throw new Exception("config目录下的配置文件SendMail.xml不存在,请检查");
         }
         log.info("xml=" + fileContent);
         return fileContent;
     }

     /**
      * <p>
      * Title: parseXML
      * </p>
      * <p>
      * Description:发送邮件给指定的收件人和抄送人,同时进行一些简单的校验判断,如必填项的字段、type的值
      * </p>
      *
      * @param xml
      *            配置文件的内容
      * @param type
      *            邮件类型
      */
     private void parseXML(String xml, String type) {

         type = type.toLowerCase();// 忽略type字段的大小写
         log.info("===========类型："+type);
         try {
             // 解析XML，获得doc对象
             Document doc = DocumentHelper.parseText(xml);

             // 判断type的值是否正确,type的值应是报文二级节点中的一个
             String flag = doc.getRootElement().element(type) + "";
             if (null == flag || flag.equals("null"))
                 throw new DocumentException(
                         "传入的type值不对,type的值应是SendMail.xml报文中二级节点的一个,请查看文件然后重新传入type的值");

             // 设置主机名称
             Element hostEle = (Element) doc.selectSingleNode("/mail/" + type
                     + "/host");
             if (null == hostEle || "".equals(hostEle.getTextTrim())) {
                 throw new DocumentException(
                         "邮件服务器域名或IP不能为空,请检查配置文件SendMail.xml");
             }
             mailInfo.setHost(hostEle == null ? "" : hostEle.getTextTrim());
             log.info("=======mailInfo.getHost():"+mailInfo.getHost());
             // 设置发件人
             Element fromEle = (Element) doc.selectSingleNode("/mail/" + type
                     + "/from");
             if (null == fromEle || "".equals(fromEle.getTextTrim())) {
                 throw new DocumentException("发件人地址不能为空,请检查配置文件SendMail.xml");
             }
             mailInfo.setFrom(fromEle == null ? "" : fromEle.getTextTrim());

             // 设置邮件主题
             Element titleEle = (Element) doc.selectSingleNode("/mail/" + type
                     + "/title");
             mailInfo.setTitle(titleEle == null ? "" : titleEle.getTextTrim());

             // 设置收件人，对多个收件人的处理放在后面
             Element toEle = (Element) doc.selectSingleNode("/mail/" + type
                     + "/to");
             if (null == toEle || "".equals(toEle.getTextTrim())) {
                 throw new DocumentException("收件人地址不能为空,请检查配置文件SendMail.xml");
             }
             mailInfo.setTo(toEle == null ? "" : toEle.getTextTrim());

             // 设置抄送，对多个抄送人的处理放在后面
             Element ccEle = (Element) doc.selectSingleNode("/mail/" + type
                     + "/cc");
             mailInfo.setCc(ccEle == null ? "" : ccEle.getTextTrim());

             // 设置发件人用户名
             Element nameEle = (Element) doc.selectSingleNode("/mail/" + type
                     + "/username");
             if (null == nameEle || "".equals(nameEle.getTextTrim())) {
                 throw new DocumentException("发件人用户名不能为空,请检查配置文件SendMail.xml");
             }
             mailInfo.setUsername(nameEle == null ? "" : nameEle.getTextTrim());

             // 设置发件人密码
             Element passEle = (Element) doc.selectSingleNode("/mail/" + type
                     + "/password");
             if (null == passEle || "".equals(passEle.getTextTrim())) {
                 throw new DocumentException("发件人密码不能为空,请检查配置文件SendMail.xml");
             }
             mailInfo.setPassword(passEle == null ? "" : passEle.getTextTrim());

         } catch (DocumentException e) {
             e.printStackTrace();
         }
     }

     /**
      * <p>
      * Title: sendMailOfValidate
      * </p>
      * <p>
      * Description:发送邮件的方法,Authenticator类验证
      * </p>
      */
     private void sendMailOfValidate() {
         Properties props = System.getProperties();
         props.put("mail.smtp.host", mailInfo.getHost());// 设置邮件服务器的域名或IP
         props.put("mail.smtp.auth", "true");// 授权邮件,mail.smtp.auth必须设置为true

         //---------安全
         Security.addProvider(new com.sun.net.ssl.internal.ssl.Provider());
         props.put("mail.smtp.socketFactory.fallback", "false");
         props.put("mail.smtp.starttls.enable", "true"); 

         String password = mailInfo.getPassword();// 密码
         try {
             password = Encrypt.DoDecrypt(password);// 如果密码经过加密用此方法对密码进行解密
         } catch (NumberFormatException e1) {
             // 如果密码未经过加密,则对密码不做任何处理
         }
         // 传入发件人的用户名和密码,构造MyAuthenticator对象
         MyAuthenticator myauth = new MyAuthenticator(mailInfo.getUsername(),
                 password);

         // 传入props、myauth对象,构造邮件授权的session对象
         Session session = Session.getDefaultInstance(props, myauth);

         // 将Session对象作为MimeMessage构造方法的参数传入构造message对象
         Message message = new MimeMessage(session);
         try {
             message.setFrom(new InternetAddress(mailInfo.getFrom()));// 发件人

             // 对多个收件人的情况进行处理,配置文件SendMail.xml中每个收件人之间必须用逗号隔开的
             if (mailInfo.getTo() != null && !"".equals(mailInfo.getTo())) {
                 String to[] = mailInfo.getTo().split(",");
 //                for (int i = 0; i < to.length; i++) {
 //                    message.addRecipient(Message.RecipientType.TO,
 //                            new InternetAddress(to[i]));// 收件人
 //                }
                 for(String too : to){
                     message.addRecipient(Message.RecipientType.TO, new InternetAddress(too));

                 }

             }

             // 对多个抄送人的情况进行处理,每个抄送人之间用逗号隔开的
             if (mailInfo.getCc() != null && !"".equals(mailInfo.getCc())) {
                 String cc[] = mailInfo.getCc().split(",");
                 for (int j = 0; j < cc.length; j++) {
                     message.addRecipient(Message.RecipientType.CC,
                             new InternetAddress(cc[j]));// 抄送
                 }
             }
             message.setSubject(mailInfo.getTitle());// 主题

             message.setText(mailInfo.getContent());// 内容

             Transport.send(message);// 调用发送邮件的方法

             log.info("邮件发送成功");
         } catch (AddressException e) {
             e.printStackTrace();
         } catch (MessagingException e) {
             e.printStackTrace();
         }
     }

     /**
      * Title: sendMail Description:外部程序调用的入口
      *
      * @param type 邮件的类型
      *            ,目前有三种，即logmessage、checkmessage、ordermessage,
      *            type只能传这三个值中一个,传其他的任何值都不行
      * @param content邮件的内容
      * @throws Exception
      */
     public void sendMail(String type, String content) throws Exception {
         log.info("入参type=" + type);
         log.info("入参content=" + content);
         if (null == type || "".equals(type) || null == content
                 || "".equals(content)) {
             throw new Exception("方法的入参type和content字段的值都不能为空或null");
         }

         String xml = readXML(XML_PATH);// 获得xml字符串

         parseXML(xml, type);// 解析xml字符串，把对应字段的值放入到mailInfo对象中

         mailInfo.setContent(content);// 设置发送的内容

         sendMailOfValidate();// 发送邮件

     }

     /**
      * 为了方便直接用main方法测试
      *
      * @param args
      * @throws Exception
      */
     public static void main(String args[]) throws Exception {

         SendMail mail = new SendMail();

         // type类型,根据此字段去配置文件SendMail.xml中匹配,然后发到相应的邮箱
         String type = "logmessage";

         // 邮件的内容,实际开发中这个内容是前台传到后台
         String content = "你好，欢迎使用JavaMail包开发邮件功能。fuck，终于成功了..";

         // 在其他类中调用时只能看到sendMail方法,为了保护内部细节,其它的方法都声明为私有的
         mail.sendMail(type, content);
         // 这个项目中没有日志文件,所以我打印一句话来告诉自己程序已经成功运行
         log.info("----邮件发送成功----");

     }

 }

4.5日志记录类

 package com.email.utils;

 import java.util.logging.Logger;

 public class LogManager {
     /**
      * 获取日志对象
      *
      * @param clazz
      *
      */
     public static Logger getLogger(Class clazz) {
         Logger logger = Logger.getLogger(clazz.getName());
         return logger;
     }
 }

4.6xml文件，可以配置邮件发送的一些信息，代码中会解析这个xml文件。但是我自己的考虑是，如果是一个正常的邮件系统，可以用户在客户端进行填写，然后读取到代码中，包括收件人，抄送人等等信息。自己理解，欢迎指正！

<?xml version="1.0" encoding="UTF-8"?>
<mail>
    <logmessage><!--报文的二级节点,为了使传入的type值对大小写不限制,故此处必须用小写 -->
        <host>smtp.qq.com</host><!-- 邮件服务器域名或IP,必填项  smtp.exmail.qq.com  smtp.qq.com   smtp.163.com  -->
        <from>12345@qq.com</from><!-- 发件人 ,必填项    -->
        <to>123@qq.com,456@qq.com,789@qq.com,1245@163.com</to><!-- 收件人,多个收件人之间用英文状态下的逗号隔开,必填项 -->
        <cc>@qq.com</cc><!-- 抄送,多个抄送人之间用英文状态下的逗号隔开-->
        <title>Test JavaMail 001</title><!-- 邮件主题-->
        <username>12345@qq.com</username><!-- 发件人邮箱的用户名,即email的全地址,必填项 -->
        <password>mima</password><!-- 发件人邮箱的密码,像QQ邮箱如果设置了独立密码应输入独立密码,必填项,为了安全起见填写密码之前最好用Encrypt类的DoEncrypt方法加密  -->
    </logmessage>
    <checkmessage>
        <host></host>
        <from></from>
        <to></to>
        <cc></cc>
        <title></title>
        <username></username>
        <password></password>
    </checkmessage>

    <ordermessage>
        <host></host>
        <from></from>
        <to></to>
        <cc></cc>
        <title></title>
        <username></username>
        <password></password>
    </ordermessage>
</mail>

5.遇到的问题及解决方案：

先以163邮箱为例讲解：

为了方便起见，代码的测试时直接使用main()进行的，如果你按照上面的代码和xml配置，都准备完成后，直接执行main()方法，可能会有以下错误：

5.1： 550 User has no permission

这时你需要将你的163邮箱开启pop3\smtp\imap等服务,如图在163邮箱的设置中，在POP3/..处设置开启服务，设置完成后，163会强制你设置 ‘客户端授权密码’，这也是为了安全考虑。然后在程序的xml文件配置时候，这个邮箱的密码就是你设置的 ‘客户端授权密码’ 。

5.2 ： javax.mail.AuthenticationFailedException: 535 Error: authentication failed   这里你需要检查你的账户密码是否正确，尤其是你设置的‘客户端授权码’，这个要代替你原先的邮箱密码。

5.3: ：javax.mail.AuthenticationFailedException: 530 Error: A secure connection is requiered(such as ssl). More information at http://service.mail.qq.com/cgi-bin/help?id=28

这个问题是在qq邮箱中测试出来的。我在网上找了不少的资料看，包括设置邮箱的host，都是不可以的。最后在代码中增加了安全的认证，就ok了。代码中已添加，可以测试。

同样，使用qq邮箱时候，也需要在设置pop3\smtp\imap等服务，这个是在设置-->账户-->然后你就能刚看到了，同样开启哪一个服务，tx也会提供你一个客户端授权码，这个不同于网易的需要你自己设置，你需要记住系统提供你的，在使用客户端收发邮件时候，以其代替密码使用，就ok了。

5.4其他人总结的问题：

 java.lang.NoClassDefFoundError: com/sun/mail/util/LineInputStream
  at javax.mail.Session.loadProvidersFromStream(Session.java:928)
  at javax.mail.Session.access$000(Session.java:174)
  at javax.mail.Session$1.load(Session.java:870)
  at javax.mail.Session.loadResource(Session.java:1084)
  at javax.mail.Session.loadProviders(Session.java:889)
  at javax.mail.Session.<init>(Session.java:210)
  at javax.mail.Session.getDefaultInstance(Session.java:299)
  at mail.SendMail.sendMail(SendMail.java:31)
  at mail.SendMail.main(SendMail.java:50)
 Exception in thread "main"
 解决方案:在myeclipse的安装目录下搜索javaee.jar,然后用压缩软件打开，删除javax下的mail文件夹

 java.lang.NoClassDefFoundError: com/sun/activation/registries/LogSupport
  at javax.activation.MailcapCommandMap.<init>(MailcapCommandMap.java:140)
  at javax.activation.CommandMap.getDefaultCommandMap(CommandMap.java:61)
  at javax.activation.DataHandler.getCommandMap(DataHandler.java:153)
  at javax.activation.DataHandler.getDataContentHandler(DataHandler.java:611)
  at javax.activation.DataHandler.writeTo(DataHandler.java:315)
  at javax.mail.internet.MimeUtility.getEncoding(MimeUtility.java:264)
  at javax.mail.internet.MimeBodyPart.updateHeaders(MimeBodyPart.java:1299)
  at javax.mail.internet.MimeMessage.updateHeaders(MimeMessage.java:2071)
  at javax.mail.internet.MimeMessage.saveChanges(MimeMessage.java:2039)
  at javax.mail.Transport.send(Transport.java:119)
  at mail.SendMail.sendMailNoValidate(SendMail.java:48)
  at mail.SendMail.main(SendMail.java:96)
 Exception in thread "main"
 解决方案:在myeclipse的安装目录下搜索javaee.jar,然后用压缩软件打开，删除javax文件夹下的activation文件夹

 javax.mail.SendFailedException: Sending failed;
   nested exception is:
  javax.mail.MessagingException: 503 Error: need EHLO and AUTH first !

  at javax.mail.Transport.send0(Transport.java:219)
  at javax.mail.Transport.send(Transport.java:81)
  at com.asiainfo.bboss.sendmail.SendMailServiceImpl.sendMailNoValidate(SendMailServiceImpl.java:210)
  at com.asiainfo.bboss.sendmail.SendMailServiceImpl.sendMail(SendMailServiceImpl.java:243)
  at com.asiainfo.bboss.sendmail.SendMailServiceImpl.main(SendMailServiceImpl.java:261)
 解决方案:props.put("mail.smtp.auth", "true");

 javax.mail.SendFailedException: Sending failed;
   nested exception is:
  javax.mail.AuthenticationFailedException
  at javax.mail.Transport.send0(Transport.java:219)
  at javax.mail.Transport.send(Transport.java:81)
  at com.asiainfo.bboss.sendmail.SendMailServiceImpl.sendMailNoValidate(SendMailServiceImpl.java:211)
  at com.asiainfo.bboss.sendmail.SendMailServiceImpl.sendMail(SendMailServiceImpl.java:244)
  at com.asiainfo.bboss.sendmail.SendMailServiceImpl.main(SendMailServiceImpl.java:262)
 解决方案: MyAuthenticator myauth = new MyAuthenticator(mailInfo.getUsername(),password);
  

6.其他

demo能跑起来，现在考虑：1.整合成一个简单的邮箱客户端，能够发送邮件；

　　　　　　　　　　　　　2.增加邮件功能的其他功能项，包括附件，收发功能，增加数据库，登陆页面等等;

　　　　　　　　　　　　　3.参考博文地址： http://www.cnblogs.com/java-pan/archive/2012/03/06/javamail.html

　　　　　　　　　　　　　　　　　　　　　 http://www.jspcn.net/htmlnews/1150019680500144.html　

　　　　　　　　　　　　　4.欢迎加群：413066190 ，交流。

　　　　　　　　　　　　　5.路漫漫其修远兮，吾将上下而求索！