javaWeb开发小工具---MailUtils及其单元测试

     本次介绍的是，在javaWeb开发中，我们不免会遇到发送邮件的需求，比如：用户注册账号，需要激活登录，以及服务器定期向会员发送礼品信息等。所以参考有关资料，写了这个MailUtils工具类。

1.MailUtils的概述

     这个MailUtils工具类底层使用了javax.mail包里面的API。所以我们要导入依赖的jar包----mail.jar和activation.jar两个jar包。

　　一封邮件基本由发件人、收件人、抄送人（可选）、标题、正文、附件组成。这里我们要介绍的是邮件的发送。

在这个工具类中，主要有两个方法，

- createSession(String host,final String userName,final String passWord)

用来创建一个Session对象，参数为服务器主机，用户名，登录密码。在方法里面经过设定主机、指定邮件协议、验证登录用户、密码等，以此完成Session的创建。

- send(Session session,final Mail mail)

通过创建的Session和Mail对象，来发送邮件，Mail对象中存放发件人的邮箱和收件人的邮箱。

2.MailUtils的实现

在编写工具类过程中，我们要创建Mail邮件和AttachBean附件两个实体对象。

【代码清单--1】Mail.java

package com.lxf.bean;

import java.util.ArrayList;
import java.util.List;

/**
 * 邮件类
 * 包括：发件人，收件人，抄送（可选），主题，正文，附件
 * @author Administrator
 *
 */
public class Mail 
{
    //发件人
    private String from;
    //收件人
    private StringBuilder toAddress = new StringBuilder();
    //抄送
    private StringBuilder ccAddress = new StringBuilder();
    //主题
    private String subject;
    //正文
    private String content;
    //附件列表
    private List<AttachBean> list = new ArrayList<AttachBean>();
    
    public Mail()
    {
    }
    
    public Mail(String from, String to) 
    {
        this(from,to,null,null);
    }

    public Mail(String from,String to,String subject,String content)
    {
        this.from = from;
        this.toAddress.append(to);
        this.subject = subject;
        this.content = content;
    }
    
    public String getFrom() 
    {
        return from;
    }
    public void setFrom(String from)
    {
        this.from = from;
    }
    
    public String getToAddress()
    {
        return toAddress.toString();
    }
    
    public void ADDToAddress(String to)
    {
        if(this.toAddress.length() > 0)
        {
            toAddress.append(",");
        }
        this.toAddress .append(to);
    }
    
    public String getCcAddress() 
    {
        return ccAddress.toString();
    }
    public void addCcAddress(String cc)
    {
        if(this.ccAddress.length() > 0)
        {
            this.ccAddress.append(",");
        }
        this.ccAddress.append(cc);
    }
    
    public String getSubject() 
    {
        return subject;
    }
    public void setSubject(String subject)
    {
        this.subject = subject;
    }
    public String getContent() 
    {
        return content;
    }
    public void setContent(String content)
    {
        this.content = content;
    }
    public List<AttachBean> getAttachs() 
    {
        return list;
    }
    public void setList(AttachBean attachBean)
    {
        this.list.add(attachBean);
    }

}

【代码清单--2】 AttachBean.java(附件：文件序号、文件、文件名)

package com.lxf.bean;

import java.io.File;

public class AttachBean 
{
    //序号，文件，文件名
    private String cid;
    private File file;
    private String fileName;
    
    public AttachBean()
    {
    }

    public AttachBean(String cid, File file, String fileName) 
    {
        super();
        this.cid = cid;
        this.file = file;
        this.fileName = fileName;
    }

    public String getCid() 
    {
        return cid;
    }

    public void setCid(String cid)
    {
        this.cid = cid;
    }

    public File getFile() 
    {
        return file;
    }

    public void setFile(File file) 
    {
        this.file = file;
    }

    public String getFileName() 
    {
        return fileName;
    }

    public void setFileName(String fileName)
    {
        this.fileName = fileName;
    }

}

【代码清单--3】MailUtils.java 邮件工具类 ---用来发送邮件

package com.lxf.myCommonUtils;

import java.io.IOException;
import java.util.List;
import java.util.Properties;

import javax.mail.Authenticator;
import javax.mail.Message.RecipientType;
import javax.mail.MessagingException;
import javax.mail.PasswordAuthentication;
import javax.mail.Session;
import javax.mail.Transport;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeBodyPart;
import javax.mail.internet.MimeMessage;
import javax.mail.internet.MimeMultipart;
import javax.mail.internet.MimeUtility;

import com.lxf.bean.AttachBean;
import com.lxf.bean.Mail;

/**
 * 邮件工具类 ---用来发送邮件
 * 该工具类底层运用到了javaMail,因此需要引入两个jar包
 * 
 * mail.jar  activator.jar
 * @author Administrator
 *
 */
public class MailUtils 
{
    //创建session对象。
    public static Session createSession(String host,final String userName,final String passWord)
    {
        Properties prop = new Properties();
        //设定主机
        prop.setProperty("mail.host", host);
        //指定邮件协议，验证为true
        prop.setProperty("mail.smtp.auth", "true");
        
        //创建验证器
        Authenticator auth = new Authenticator(){
            public PasswordAuthentication getPasswordAuthenticator()
            {
                return new PasswordAuthentication(userName,passWord);
            }
        };
        return Session.getInstance(prop, auth);
    }
    
    public static void send(Session session,final Mail mail) throws MessagingException, MessagingException, IOException
    {
        //创建邮件对象
        MimeMessage msg = new MimeMessage(session);
        //设置发件人
        msg.setFrom(new InternetAddress(mail.getFrom()));
        msg.addRecipients(RecipientType.TO, mail.getToAddress());
        
        //设置抄送
        String cc = mail.getCcAddress();
        if(!cc.isEmpty())
        {
            msg.addRecipients(RecipientType.CC, cc);
        }
        
        //设置主题
        msg.setSubject(mail.getSubject());
        
        //创建部件集对象
        MimeMultipart parts = new MimeMultipart();
        
        //创建一个部件
        MimeBodyPart part = new MimeBodyPart();
        
        //设置邮件正文内容
        part.setContent(mail.getContent(),"text/html;charset=utf-8");
        //把部件加到部件集中
        parts.addBodyPart(part);
        
        //获取所有附件
        List<AttachBean> list = mail.getAttachs();
        if(null != list)
        {
            for(AttachBean attach :list)
            {
                //创建一个部件
                MimeBodyPart attachPart = new MimeBodyPart();
                //设置附件文件
                attachPart.attachFile(attach.getFile());
                //设置附件文件名
                attachPart.setFileName(MimeUtility.encodeText(attach.getFileName()));
                String cid = attach.getCid();
                if(cid != null)
                {
                    attachPart.setContentID(cid);
                }
                parts.addBodyPart(attachPart);
            }
        }
        //给邮件设置内容
        msg.setContent(parts);
        Transport.send(msg);
    }
}

3.MailUtils的测试

这里要测试的就是邮件的正确发送，主要验证send()方法。

【代码清单--4】

package com.lxf.test;

import java.io.IOException;

import javax.mail.MessagingException;
import javax.mail.Session;

import org.junit.Test;

import com.lxf.bean.Mail;
import com.lxf.myCommonUtils.MailUtils;


/**
 * 邮件测试类
 * @author Administrator
 *
 */
public class MailTest 
{
    @Test
    public void testSend() throws MessagingException, IOException
    {
        //创建Session对象，指定主机，用户名，密码
        //这里假设用163邮箱，smtp是邮件协议。
        Session session = MailUtils.createSession("smtp.163.com", "这里输入邮箱@前面的信息", "邮箱密码");
        
        //创建一个Mail对象，设置发件人和收件人
        Mail mail = new Mail("你的邮箱完整信息","对方邮箱完整信息");
        //设置主题
        mail.setSubject("给**的100封信");
        //设置正文
        mail.setContent("这时第1封信");
        //发送邮件
        MailUtils.send(session, mail);
    }
}

 这里要说的是，当你在测试的话，可能会下面抛出这个异常。

这时因为你的邮箱在注册的时候没有勾选开启，用代码发送邮件的协议，也就是上面的那个smtp协议，所有，我们要正确开启，才能把邮件发送出去。

这里我已QQ邮箱为例，来介绍一下怎么开启smtp协议。

1.打开你的qq邮箱，点击你的用户名，则进入【邮箱设置】界面；

2.在【账户】信息栏，下拉，找到“POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务”项。

大家可以看到，SMTP服务是默认关闭的，此时我们就要申请把它打开。

最后大家在测试的话吗，邮件就会发送成功。

4.后期补充。