JamesJavamail构建邮件服务实现.docx

James+Javamail构建邮件服务（一）
关键字: james
 James+Javamail构建邮件服务

　　本文描述如何使用James搭建具备一定邮件过滤、邮件操作功能的邮件服务器，以及使用Javamail实现对James服务器邮件的收发功能。

1关于James与Javamail
　　Apache James（Java Apache Mail Enterprise Server）是Apache组织的子项目之一，完全采用纯Java技术开发，实现了SMTP、POP3与NNTP等多种邮件相关协议。James是一个邮件应用平台，可以通过Mailet扩充其功能，如Mail2SMS、Mail2Fax等。James提供了比较完善的配置方案，尤其是关于邮件内容存储和用户信息存储部分，可以选择在文件、数据库或其他介质中保存。James性能稳定、可配置性强，还是开源项目，所有源代码不存在版权问题，因此，James在项目中的应用日益广泛。
　　Javamail API是一个用于阅读、编写和发送电子消息的可选包（标准扩展），可以用来建立基于标准的电子邮件客户机，它支持各种因特网邮件协议，包括：SMTP、POP、IMAP、MIME、NNTP、S/MIME及其它协议。
　　在本文档中，我们使用James 2.3.1＋Javamail 1.4.1作为介绍蓝本。

2 James服务器快速入门
　　我们可以从Apache James的官方站点下载到我们所需要的James服务器及源码
　　James服务器（ZIP版）下载地址：

　　James源码下载地址：

　　其他版本的服务器及源码可到官方下载页面下载：
　　http://james.apache.org/download.cgi

2.1启动James
第一步：
　　将james-binary-2.3.1.zip解压到纯英文目录下
第二步：
　　运行bin目录下的run.bat(在运行之前请确保您的Java环境变量已配置成功，否则将提示运行失败)
显示以下内容表示James服务器已启动成功：

　　服务器启动成功后，将自动在apps目录下根据james.sar文件生成相应的James发布文件包，我们后面讨论的配置文件config.xml即存在于此发布文件包中。

2.2用Telnet管理用户
　　用cmd进入MS-DOS，输入telnet localhost 4555 (注：localhost是邮件服务器名，4555是管理端口，可在\apps\james\SAR-INF\config.xml文件中配置，在此我们使用其默认配置)
　　然后输入用户名和密码(在配置文件config.xml中，默认为用户名：root密码：root)
出现如下信息说明登陆成功：

登陆成功后，我们就可以开始对用户信息进行增、删、查、改等操作了。
常用的用户信息操作命令参见下表：
? Currently implemented commands:                  常用实现命令
? help                display this help            显示帮助信息
? listusers           display existing accounts    显示现有账户
? countusers          display the number of existing accounts显示现有账户数量
? adduser [username] [password]   add a new user   添加一个新用户
? verify [username]   verify if specified user exist  核实指定用户是否存在
? deluser [username]   delete existing user        删除存在的用户
? setpassword [username] [password]   sets a user’s password  设置用户密码
? setalias [user] [alias]   locally forwards all email for ‘user’ to ‘alias’ 设置邮箱别名
? showalias [username]   shows a user’s current email alias显示别名
? unsetalias [user]     unsets an alias for ‘user’    删除用户别名
? setforwarding [username] [emailaddress]   forwards a user’s email to another email address      转发用户的电子邮件地址到另一个电子邮件地址
? showforwarding [username] shows a user’s current email forwarding显示用户的当前邮件转发
? unsetforwarding [username]     removes a forward         删除转发
? user [repositoryname]    change to another user repository   改变另一个用户库
? shutdown kills the current JVM (convenient when James is run as a daemon)  关闭当前的服务
? quit                close connection              关闭连接

　　我们可以输入命令：adduser chenfengcn 881213来添加一个的邮件用户，则其用户名为：chenfengcn，密码为：881213，邮箱地址为：chenfengcn@localhost(用户名后的域名跟服务器配置的域名相同，在config.xml文件中配置，我们将在后面部分讨论如何配置邮件服务器域名)。这样，我们就完成了一个最简单的邮件服务器的搭建操作。下面就让我们使用Foxmail来测试一下我们的邮箱帐户是否真正可以使用吧。

2.3使用Foxmail测试邮箱帐户
　　打开Foxmail，点击“邮箱”－＞“新建邮箱帐户”
　　电子邮件地址：chenfengcn@localhost
　　密码为：881213
　　POP3服务器：localhost
　　SMTP服务器：localhost
　　其余选项均使用默认即可，新建完成后，Foxmail将发送一测试邮件到我们新建的邮箱里，点击“收取”，即可收取我们邮件帐户里面的邮件了。当收到Foxmail发送的测试邮件，就说明我们的邮件帐户可以正常使用了。
　　作为程序设计人员，我们当然希望能使用自己写的程序来测试我们的邮件服务器是否搭建成功，而不是Foxmail。下面就让我们用Javamail来实现这一切吧。

James+Javamail构建邮件服务（二）
电子邮件开发2009-11-30 10:15:30阅读21评论0字号：大中小
3 Javamail快速入门
　　进行Javamail开发需要用到两个包：mail.jar和activation.jar，在开始Javamail编程之前，请自己将这两个包添加到IDE的Build path中或将这两个包的路径配置到环境变量中。
3.1使用Javamail向James的邮箱帐户发送邮件
3.1.1业务描述
　　本例将使用Javamail实现邮件的发送功能。发送邮件需要配置邮件服务器属性信息，配置邮件接收地址，使用SMTP认证获得会话（Session），构建邮件体（MimeMessage），发送邮件。具体编码如下：
3.1.2编码实现
　　发送邮件需要两个类：一个是SMTP用户身份认证类（James在默认情况下，是需要SMTP身份认证的）；另一个就是我们的邮件发送类，为简单起见，我们直接将邮件的相关信息，如：标题、内容、发送者、接收者等信息直接写在类中，运行main()函数即发送。当然，你同样可以为自己的邮件发送系统构造一个邮件发送介面，通过Servlet将相关参数传递至后台进行处理与发送。其主要代码也就是此main()函数中的内容，故不赘述。

SmtpAuth.java用户身份认证代码
Java代码
package com.newland.javamail.sample1;      

/**    
 * 用于身份认证    
 * @author Chen.Feng(Kevin)<br>    
 *         mail:chenfengcn@<br>    
 *         qq:67758633    
*/     
class SmtpAuth extends javax.mail.Authenticator {      
    private String user, password;      

    /**    
     *     
     * @param getuser    
     * @param getpassword    
     */     
    public void setUserinfo(String getuser, String getpassword) {      
        user = getuser;      
        password = getpassword;      
    }      
    protected javax.mail.PasswordAuthentication getPasswordAuthentication() {      
        return new javax.mail.PasswordAuthentication(user, password);      
    }      
    public String getPassword() {      
        return password;      
    }      
    public void setPassword(String password) {      
        this.password = password;      
    }      
    public String getUser() {      
        return user;      
    }      
    public void setUser(String user) {      
        this.user = user;      
    }      
}   
package com.newland.javamail.sample1;

/**
* 用于身份认证
* @author Chen.Feng(Kevin)<br>
* mail:chenfengcn@<br>
* qq:67758633
*/
class SmtpAuth extends javax.mail.Authenticator {
private String user, password;

/**
*
* @param getuser
* @param getpassword
*/
public void setUserinfo(String getuser, String getpassword) {
user = getuser;
password = getpassword;
}
protected javax.mail.PasswordAuthentication getPasswordAuthentication() {
return new javax.mail.PasswordAuthentication(user, password);
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
public String getUser() {
return user;
}
public void setUser(String user) {
this.user = user;
}
}
 SendMail.java发送邮件代码
Java代码
package com.newland.javamail.sample1;      

import java.util.Properties;      
import javax.activation.DataHandler;      
import javax.activation.DataSource;      
import javax.activation.FileDataSource;      
import javax.mail.Message;      
import javax.mail.MessagingException;      
import javax.mail.Session;      
import javax.mail.Transport;      
import javax.mail.URLName;      
import javax.mail.internet.AddressException;      
import javax.mail.internet.InternetAddress;      
import javax.mail.internet.MimeBodyPart;      
import javax.mail.internet.MimeMessage;      
import javax.mail.internet.MimeMultipart;      

/**    
 * 使用Javamail实现邮件发送功能    
 * @author Chen.Feng(Kevin)<br>    
 *         mail:chenfengcn@<br>    
 *         qq:67758633    
 *    
 */     
public class SendMail {      
    public SendMail() {      
        // TODO Auto-generated constructor stub      
    }      
    public static void main(String[] args) {      
        // 初始化信息      
        String sender = “chenfengcn”;      
        String password = “881213”;      
        String smtpServer = “localhost”;      
        String recipient = “chenfengcn@localhost”;      
        String subject = “测试邮件主题”;      
        String fileAttachment = “”;   //附件      
        String content = “测试邮件内容”;      
        // 配置服务器属性      
        Properties proper = new Properties();      
        proper.put(“mail.smtp.host”, smtpServer); // smtp服务器      
        proper.put(“mail.smtp.auth”, “true”); // 是否smtp认证      
        proper.put(“mail.smtp.port”, “25”); // 设置smtp端口      
        proper.put(“mail.transport.protocol”, “smtp”); // 发邮件协议      
        proper.put(“mail.store.protocol”, “pop3”); // 收邮件协议      
        // 配置邮件接收地址      
        InternetAddress[] receiveAddress = new InternetAddress[1];      
        try {      
            receiveAddress[0] = new InternetAddress(recipient);      
        } catch (AddressException e) {      
            // TODO Auto-generated catch block      
            e.printStackTrace();      
        }      
        // smtp认证，获取Session      
        SmtpAuth sa = new SmtpAuth();      
        sa.setUserinfo(sender, password);      
        Session session = Session.getInstance(proper, sa);      
        session.setPasswordAuthentication(new URLName(smtpServer), sa      
                .getPasswordAuthentication());      
        // 构建邮件体      
        MimeMessage sendMess = new MimeMessage(session);      
        MimeBodyPart mbp = new MimeBodyPart();      
        MimeMultipart mmp = new MimeMultipart();      
        try {      
            // 邮件文本内容      
            mbp.setContent(content, “text/plain; charset=GBK”);      
            mmp.addBodyPart(mbp);      
            // 附件处理      
            if(fileAttachment!=null&&fileAttachment!=””){      
                DataSource source = new FileDataSource(fileAttachment);      
                String name = source.getName();      
                mbp = new MimeBodyPart();      
                mbp.setDataHandler(new DataHandler(source));      
                mbp.setFileName(name);      
                mmp.addBodyPart(mbp);      
            }      
            // 邮件整体      
            sendMess.setSubject(subject);      
            sendMess.setContent(mmp);      
            // 发送邮件      
            sendMess.setFrom(new InternetAddress(sender));      
            sendMess.setRecipients(Message.RecipientType.TO, receiveAddress);      
            Transport.send(sendMess);      
            System.out.println(“发送成功”);      
        } catch (MessagingException ex) {      
            ex.printStackTrace();      
        }      
    }      
}   
package com.newland.javamail.sample1;

import java.util.Properties;
import javax.activation.DataHandler;
import javax.activation.DataSource;
import javax.activation.FileDataSource;
import javax.mail.Message;
import javax.mail.MessagingException;
import javax.mail.Session;
import javax.mail.Transport;
import javax.mail.URLName;
import javax.mail.internet.AddressException;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeBodyPart;
import javax.mail.internet.MimeMessage;
import javax.mail.internet.MimeMultipart;

/**
* 使用Javamail实现邮件发送功能
* @author Chen.Feng(Kevin)<br>
* mail:chenfengcn@<br>
* qq:67758633
*
*/
public class SendMail {
public SendMail() {
// TODO Auto-generated constructor stub
}
public static void main(String[] args) {
// 初始化信息
String sender = “chenfengcn”;
String password = “881213”;
String smtpServer = “localhost”;
String recipient = “chenfengcn@localhost”;
String subject = “测试邮件主题”;
String fileAttachment = “”; //附件
String content = “测试邮件内容”;
// 配置服务器属性
Properties proper = new Properties();
proper.put(“mail.smtp.host”, smtpServer); // smtp服务器
proper.put(“mail.smtp.auth”, “true”); // 是否smtp认证
proper.put(“mail.smtp.port”, “25”); // 设置smtp端口
proper.put(“mail.transport.protocol”, “smtp”); // 发邮件协议
proper.put(“mail.store.protocol”, “pop3”); // 收邮件协议
// 配置邮件接收地址
InternetAddress[] receiveAddress = new InternetAddress[1];
try {
receiveAddress[0] = new InternetAddress(recipient);
} catch (AddressException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
// smtp认证，获取Session
SmtpAuth sa = new SmtpAuth();
sa.setUserinfo(sender, password);
Session session = Session.getInstance(proper, sa);
session.setPasswordAuthentication(new URLName(smtpServer), sa
.getPasswordAuthentication());
// 构建邮件体
MimeMessage sendMess = new MimeMessage(session);
MimeBodyPart mbp = new MimeBodyPart();
MimeMultipart mmp = new MimeMultipart();
try {
// 邮件文本内容
mbp.setContent(content, “text/plain; charset=GBK”);
mmp.addBodyPart(mbp);
// 附件处理
if(fileAttachment!=null&&fileAttachment!=””){
DataSource source = new FileDataSource(fileAttachment);
String name = source.getName();
mbp = new MimeBodyPart();
mbp.setDataHandler(new DataHandler(source));
mbp.setFileName(name);
mmp.addBodyPart(mbp);
}
// 邮件整体
sendMess.setSubject(subject);
sendMess.setContent(mmp);
// 发送邮件
sendMess.setFrom(new InternetAddress(sender));
sendMess.setRecipients(Message.RecipientType.TO, receiveAddress);
Transport.send(sendMess);
System.out.println(“发送成功”);
} catch (MessagingException ex) {
ex.printStackTrace();
}
}
}

值得一提的是，本程序已经实现了带附件邮件的发送功能，如果要发送带附件的邮件，则只需要将附件的路径传到fileAttachment变量中就可以了。邮件发送成功后，程序将在后台打印出“发送成功”，这样我们就完成了邮件发送功能。那么，我们应该如何检验服务器是否确实收到我们发送的测试邮件呢？Javamail可以发送邮件，当然也能接收邮件啦，下面让我们一起使用Javamail编写邮件接收功能来检验吧。

3.2使用Javamail接收邮件
3.2.1业务描述
　　在上一节，我们已经向James的chenfengcn用户发送了一封测试邮件，我们应该如何使用Javamail来收取这封邮件呢？
　　为读取邮件，必须首先设置服务器属性(Properties)，获取一个会话(Session)，然后获取并连接邮箱所在的存储器（Store对象），打开该用户的邮箱(Folder)，获取所希望阅读的消息，最后关闭目录和连接。
　　下面的程序实现了接收chenfengcn@localhost邮箱中所有邮件，并将发送人和主题打印出来。

3.2.2编码实现
Java代码
package com.newland.javamail.sample1;      

import java.util.Properties;      
import javax.mail.Folder;      
import javax.mail.Message;      
import javax.mail.MessagingException;      
import javax.mail.NoSuchProviderException;      
import javax.mail.Session;      
import javax.mail.Store;      

/**    
 * 使用Javamail实现邮件接收功能    
 * @author Chen.Feng(Kevin)<br>    
 *         mail:chenfengcn@<br>    
 *         qq:67758633    
 *    
 */     
public class ReceiveMail {      
    public ReceiveMail() {      
    }      
    public static void main(String[] args) {      
        // 初始化主机      
        String host = “localhost”;      
        String username = “chenfengcn”;      
        String password = “881213”;      
        // 配置服务器属性      
        Properties props = new Properties();      
        props.put(“mail.smtp.host”, “localhost”); // smtp服务器      
        props.put(“mail.smtp.auth”, “true”); // 是否smtp认证      
        props.put(“mail.smtp.port”, “25”); // 设置smtp端口      
        props.put(“mail.transport.protocol”,