正文
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.后期补充。
