普善园

       Apache James 简称 James, 是 Java Apache Mail Enterprise Server的缩写。James 是100%基于Java的电子邮件服务器。它是一种独立的邮件服务器，并提供了一个完整的电子邮件解决方案，用来收、发电子邮件。

       本文不赘述James服务器的参数细节，这个以后有机会再详细讨论，这里先从服务器搭建开始，用搭建的服务器收、发电子邮件来熟悉一下Apache James。本人也是新手，希望能得到各位高手的指点，使大家能悟到进阶的方向。

       开始之前，先声明一下本文操作的系统环境：

       1. JDK 6u10b

       2. JMail API v1.4.2

       3. JAF API v1.1(JavaBean Activation Framework)

       4. Apache James 2.3.1

       5. Eclipse 3.4 for J2EE Developers

       6. Windows 2000 Server sp4

       1。请下载安装JDK，并设置好其环境变量：JAVA_HOME=…… 、PATH=…… 、CLASSPATH=…… Eclipse 3.4 是目前的最新版本，可以从http://www.eclipse.org/下载。

       2。请下载JMail API、JAF API，可以在www.java.sun.com找到他们，找不到也不要紧，本文附件示例代码免费提供一份（^_^）。

       3。Apache James 的官方网站为：http://james.apache.org/，当前 Server 的最新版为 2.3.1版. 安装非常简单，下载后得到james-binary-2.3.1.zip 文件，解压后即可。这里假设解压到D盘（D:\james-2.3.1）,目录结构如下：

       D:\james-2.3.1

               |--- apps

               |--- bin

               |

       …………

       4。启动 James 服务器

       双击或在命令行下执行D:\james-2.3.1\bin 目录下的 run.bat文件，即可启动 James 服务器。

       启动后能在控制台看到如下信息，说明启动成功：

Using PHOENIX_HOME: D:\james-2.3.1 
Using PHOENIX_TMPDIR: D:\james-2.3.1\temp 
Using JAVA_HOME: D:\Java\jdk1.6.0_10 

Phoenix 4.2 

James Mail Server 2.3.1 
Remote Manager Service started plain:4555 
POP3 Service started plain:110 
SMTP Service started plain:25 
NNTP Service started plain:119 
FetchMail Disabled

       要关闭 James 服务，请使用 Ctrl + C

       说明：启动前请确保您的JDK环境变量如JAVA_HOME等已经设置好；James 启动时，其SMTP 服务默认在 25 端口启动，POP3 服务默认在 110 端口启动， NNTP 服务默认在 119 端口启动, 请确保这些端口未被占用。比如本系统下就已经安装了Microsoft的 SMTP 服务，造成 James无法启动，解决方法为：开始--->设置--->控制面板--->管理工具--->服务，打开后找到“Simple Mail Transport Protocol(SMTP)”服务项，关闭即可。

       5。配置服务

       服务器启动后会在本机配置一个默认的服务，这可以用来在本机上本服务器范围内收发邮件，但是邮件发不到163等外网邮箱。我们这里关注的重点就是配置一个能发到外网如163这样的邮箱的邮件，这样才有价值。不过由于本人是在本机上测试，一时不能获取公司的域名参数，无法测试接收外网邮箱（如163）的邮件，见晾，不过做法都是一样的，至少我们可以向外网邮箱发送邮件，局域网内可以收、发邮件。

        打开D:\james-2.3.1\apps\james\SAR-INF 下的 config.xml 文件，初次启动James之前，不会有这个文件，只有当James服务启动一次之后才自动构件该文件。

        找到

…… 
<postmaster>Postmaster@localhost</postmaster> 
…… 
<servernames autodetect="true" autodetectIP="true"> 
	<servername>localhost</servername> 
</servernames> 
…… 

        把localhost该成你自己想要的邮箱域名， 把自动探测IP属性设置为“false”这里假设改成 zhaipuhong.com 如果开了一个帐号 zph ,那么他的邮件地址就是 zph@zhaipuhong.com (^_^)修改结果如下：

…… 
<postmaster>Postmaster@zhaipuhong.com</postmaster> 
…… 
<servernames autodetect="false" autodetectIP="false"> 
	<servername>zhaipuhong.com</servername> 
</servernames> 
……

        找到

<mailet match="RemoteAddrNotInNetwork=127.0.0.1" class="ToProcessor"> 
	<processor> relay-denied </processor> 
	<notice>550 - Requested action not taken: relaying denied</notice> 
</mailet>

        将其注释，结果如下：

<!--mailet match="RemoteAddrNotInNetwork=127.0.0.1" class="ToProcessor"> 
	<processor> relay-denied </processor> 
	<notice>550 - Requested action not taken: relaying denied</notice> 
</mailet-->

         找到下面元素，去掉其注释

<authRequired>true</authRequired>

         这样邮箱访问需要帐号验证，你不希望别人用你的帐号收发消息吧……^_^

         如此，James服务配置已经完成。

        6。创建邮件帐号

        创建邮件帐号后，就可以用来收发邮件了。James的账号管理是通过基于Telnet客户机的远程管理器，这点颇为不爽，尤其是我的操作系统下的命令行控制台是不显示telnet命令输入字符的，经常出错。

        现在进入命令行控制台，在telnet localhsot 4555 进入James管理器，操作如下：

C:\Documents and Settings\db2admin>telnet localhost 4555 

        将进入

JAMES Remote Administration Tool 2.3.1 Please enter your login and password Login id:

        默认的登陆id 为root 密码也为 root ，登陆成功后结果如下：

JAMES Remote Administration Tool 2.3.1 
Please enter your login and password 
Login id: 
Password: 
Welcome root. HELP for a list of commands  

       创建新用户的命令是：adduser username password

    这里创建了两个账户来作为演示使用： zhaipuhong/zhangpuhong ;      zph/zph

      说明：你可以输入help来获取命令帮助

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] emoves 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 关闭连接

      账号创建成功后，使用quit退出管理器。现在我们可以开始部署我们的JMail应用了。

      7。用James收发邮件

      现在我们来写两个简单的程序来体验一下如何使用James收发邮件。请注意，示例程序是通用的。关于如何用JMail API收发邮件，这里不详细介绍，如果还没有接触过请参考一下我之前的文章：

      http://zhaipuhong.javaeye.com/admin/blogs/213005

      关于接受邮件部分，我们在代码中通过注释来描述。另外我们来回忆一下上述步骤配置James服务器的参数：

      1。smtp 服务器：192.168.1.98或者localhost     192.168.1.98是我的局域网IP，由于我James服务就装在我的机器上，所以我可以用localhost

      2。两个邮件帐号：zhaipuhong/zhaipuhong   对应邮箱地址： zhaipuhong@zhaipuhong.com

                                zph/zph                            对应邮箱地址： zph@zhaipuhong.com

      注意：邮箱域名我们配置的是zhaipuhong.com

      示例程序：

package com.zhaipuhong.j2ee.jmail;

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

import javax.mail.Authenticator;
import javax.mail.Folder;
import javax.mail.Message;
import javax.mail.MessagingException;
import javax.mail.PasswordAuthentication;
import javax.mail.Session;
import javax.mail.Store;
import javax.mail.Transport;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeMessage;
import javax.mail.internet.MimeUtility;

public class HelloJMail {
	
	//发送邮件
	public static void sendMail() {
		//String host = "192.168.1.98"; // 指定的smtp服务器，本机的局域网IP
		String host = "localhost"; // 本机smtp服务器
		//String host = "smtp.163.com"; // 163的smtp服务器
		String from = "zhaipuhong@zhaipuhong.com"; // 邮件发送人的邮件地址
		String to = "zph@zhaipuhong.com"; // 邮件接收人的邮件地址
		final String username = "zhaipuhong";  //发件人的邮件帐户
		final String password = "zhaipuhong";   //发件人的邮件密码

		// 创建Properties 对象
		Properties props = System.getProperties();

		// 添加smtp服务器属性
		props.put("mail.smtp.host", host);
		props.put("mail.smtp.auth", "true");

		// 创建邮件会话
		Session session = Session.getDefaultInstance(props, new Authenticator(){
			@Override
			public PasswordAuthentication getPasswordAuthentication() {
				return new PasswordAuthentication(username, password);
			}
			
		});

		try {
			// 定义邮件信息
			MimeMessage message = new MimeMessage(session);
			message.setFrom(new InternetAddress(from));
			message.addRecipient(Message.RecipientType.TO, new InternetAddress(
					to));
			//message.setSubject(transferChinese("我有自己的邮件服务器了"));
			message.setSubject("I hava my own mail server");
			message.setText("From now, you have your own mail server, congratulation!");

			// 发送消息
			session.getTransport("smtp").send(message);  
			//Transport.send(message); //也可以这样创建Transport对象发送
			System.out.println("SendMail Process Over!");

		} catch (MessagingException e) {
			e.printStackTrace();
		}
	}
	
	//接受邮件
	public static void getMail(){
		String host = "localhost";
	    final String username = "zph";
		final String password = "zph";

		// 创建Properties 对象
	    Properties props = new Properties();

		// 创建邮件会话
		Session session = Session.getDefaultInstance(props, new Authenticator(){
			@Override
			public PasswordAuthentication getPasswordAuthentication() {
				return new PasswordAuthentication(username, password);
			}
			
		});

	    
		try {
			// 获取邮箱的pop3存储
			Store store = session.getStore("pop3");
			store.connect(host, username, password);

	        // 获取inbox文件
		    Folder folder = store.getFolder("INBOX");
		    folder.open(Folder.READ_ONLY);  //打开，打开后才能读取邮件信息

		    // 获取邮件消息
		    Message message[] = folder.getMessages();

		    for (int i=0, n=message.length; i<n; i++) {
		    	System.out.println(i + ": " + message[i].getFrom()[0]
		    	                               + "\t" + message[i].getSubject());
		    	try {
					message[i].writeTo(System.out);
				} catch (IOException e) {
					e.printStackTrace();
				}

		    }

		    // 关闭资源
		    folder.close(false);
		    store.close();
		    
		} catch (MessagingException e) {
			e.printStackTrace();
		}
		
		System.out.println("GetMail Process Over!");

	}
	
	//邮件主题中文字符转换
	public static String transferChinese(String strText){
		try{
			strText = MimeUtility.encodeText(new String(strText.getBytes(), "GB2312"), "GB2312", "B");
		}catch(Exception ex){
			ex.printStackTrace();
		}
		return strText;
	}

	public static void main(String[] args) {
		HelloJMail.sendMail();
		//HelloJMail.getMail();
	}

}

      说明： 执行测试时，先执行发送，在main方法中注释掉邮件接受方法调用，等待片刻，再注释掉邮件发送方法调用，执行邮件接受方法调用。因为就算163这样优秀的企业级邮箱也不可能瞬间就能收到发送的邮件。

      在邮件发送方法中：sendMail(), 可以尝试一下又本邮件服务器向163邮箱发送邮件，如果想通过163邮件服务器想本地发送邮件，你需要配置DSN。

       以下为本机接收James邮件服务器提供服务的邮件结果：

0: zhaipuhong@zhaipuhong.com	I hava my own mail server
Return-Path: <zhaipuhong@zhaipuhong.com>
Delivered-To: zph@zhaipuhong.com
Received: from 127.0.0.1 ([127.0.0.1])
          by ZPH (JAMES SMTP Server 2.3.1) with SMTP ID 693
          for <zph@zhaipuhong.com>;
          Wed, 9 Jul 2008 19:58:38 +0800 (CST)
Date: Wed, 9 Jul 2008 19:58:38 +0800 (CST)
From: zhaipuhong@zhaipuhong.com
To: zph@zhaipuhong.com
Message-ID: <11627000.01215604718796.JavaMail.db2admin@ZPH>
Subject: I hava my own mail server
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit

From now, you have your own mail server, congratulation!

       从上面的结果可以看出，该邮件是由zhaipuhong@zhaipuhong.com 发给 zph@zhaipuhong.com 的。

       多发几封电子邮件，就会发现，James 的邮件接收是一个栈结构，最近收到的邮件编号为0，依次类推……