• 基本介绍及配置

James 是一个企业级的邮件服务器,它完全实现了smtp 和 pops 以及nntp 协议(不支持IMAP)。同时,james服务器又是一个邮件应用程序平台。James的核心是Mailet API,而james 服务齐是一个mailet的容器。它可以让你非常容易的实现出很强大的邮件应用程序。James开源项目被广泛的应用于与邮件有关的项目中。你可以通过它来搭建自己的邮件服务器。我们可以利用Mailet API,编程接口来实现自己所需的业务。James集成了Avalon 应用程序框架以及Phoenix Avalon 框架容器。Phoenix为james 服务器提供了强大的支持。需要说明的是Avalon开源项目目前已经关闭。

1.配置邮件服务器? 
    (1)设置服务器 
    <servernames autodetect="true" autodetectIP="true"> 
        <servername>localhost</servername> 
    </servernames> 
    将localhost修改为你的服务器地址。 
    (2)设置邮件管理者的邮件地址 
    <postmaster>Postmaster@localhost</postmaster> 
    将localhost改成上面设置的服务器地址。 
    (3)设置验证 
    <authRequired>true</authRequired> 
    找到此行,去掉注释。 
2.如何获取发送失败的错误信息? 
    打开文件SAF-INF/config.xml。 
    (1)找到<processor name="relay-denied" >,去掉以下行的注释。 
        <mailet match="All" class="Bounce"> 
            <attachment>none</attachment> 
        </mailet> 
        <mailet match="All" class="NotifyPostmaster"/> 
    (2)如果打开smtp authorized,去掉以下行的注释。 
        <mailet match="RemoteAddrNotInNetwork=127.0.0.1" class="ToProcessor"> 
            <processor> relay-denied </processor> 
            <notice>550 - Requested action not taken: relaying denied</notice> 
        </mailet> 
3.增加用户? 
    telnet [邮件服务器地址]   4555 
    用户名:root   (默认) 
    密码:root  (默认) 
    使用addusers命令加入用户。

 其他常用命令:

 

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

 

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

  • 用户信息的数据库存储

 James邮件用户的用户信息默认保存在appsjamesvarusers目录下,通过修改配置文件appsjamesSAR-INFconfig.xml,可以把用户信息保存到数据库中,配置方法如下:

第一步:在MySQL中新建一个数据库mail,用户名root,密码为空;

第二步:打开config.xml,找到<users-store>这一项,此面默认的内容为:

 

<repository name="LocalUsers" class="org.apache.james.userrepository.UsersFileRepository">
          <destination URL="file://var/users/"/>
</repository>


需要修改为:

 

<repository name="LocalUsers" class="org.apache.james.userrepository.JamesUsersJdbcRepository" destinationURL="db://maildb/users">
          <sqlFile>file://conf/sqlResources.xml</sqlFile>
       </repository>


通过修改,我们就把用户信息的存储介质从file改成了db,<sqlFile>是指明了在db中的数据表结构及相关数据库信息。

第三步:仍然是config.xml,找到<data-sources>项,默认内容为空,把此项内容修改为:

 

<data-source name="maildb" class="org.apache.james.util.mordred.JdbcDataSource">
                            <driver>org.gjt.mm.mysql.Driver</driver>
                             <dburl>jdbc:mysql://127.0.0.1/mail</dburl>
                             <user>root</user>
                             <password></password>
                             <max>20</max>
</data-source>


<driver>是指MySQL的JDBC驱动,<dburl>指数据库的访问路径,IP后的mail即MySQL中新建数据库名,接下来是用户名、密码及最大连接数。

至此,数据库配置完成,启动James,若正常无误,请通过telnet添加一个新用户,比如adduser holen 123456,然后检查MySQL中的mail数据库,下面将有一个表users,这是James根据file://conf/sqlResources.xml的内容创建的。

通过以上配置,James的用户信息就可以保存在数据库中了。

  • 密码问题

当你通过telnet添加新用户时,比如adduser holen 123456,你可以查看数据库中的记录,第一个字段是holen,第二字段是密码,但密码并非123456,而一串“乱码”(zhwQUMTwdMqWfm/h0biB51Gf)??这是加密码后的密码内容,再看后面的字段是“SHA”,显然用的是SHA加密方式。

通过telnet方式添加新用户,用户密码将自动加密,然后插入数据库中。但通过telnet方式进行用户管理有着诸多不便,尽管你可以借助James的一个RMI工具包,提高效率,但仍然没有本质改变,当需要用作商业用途时,你更不能要求你的客户熟记那一堆命令符。

一般我们可以做一个Web前端,通过网页形式,添加修改用户,界面友好,傻瓜化使用,如263或163一样。若这样做,我们就需要直接操作数据库,添加用户记录或修改删除用户记录了。但别忘了,James默认对用户密码是加密的,既然我们要直接操作数据库,那么我们只有两个选择:要么我们研究其密码机制,添加记录时,我们对新增用户的密码进行同样加密,要么我们去掉James的加密机制,使其明码保存。

幸好,这两种选择都是可行的。我们从Apache网站下载James的源码包,下载后的文件为james-2.1-src.zip,接近8M,通过分析源码,我们发现,与用户密码相关的文件是DefaultUser.java,部分源码如下:

 

package org.apache.james.userrepository;
……
/**
      *   Method to verify passwords.
      *
      * @param pass the String that is claimed to be the password for this user
      * @return true if the hash of pass with the current algorithm matches
      * the stored hash.
      */
     public boolean verifyPassword(String pass) {
         try {
             String hashGuess = DigestUtil.digestString(pass, algorithm);
             return hashedPassword.equals(hashGuess);
         } catch (NoSuchAlgorithmException nsae) {
         throw new RuntimeException("Security error: " + nsae);
     }
     }

     /**
      * Sets new password from String. No checks made on guessability of
      * password.
      *
      * @param newPass the String that is the new password.
      * @return true if newPass successfuly hashed
      */
     public boolean setPassword(String newPass) {
         try {
             hashedPassword = DigestUtil.digestString(newPass, algorithm);
             return true;
         } catch (NoSuchAlgorithmException nsae) {
             throw new RuntimeException("Security error: " + nsae);
         }
}
……




第一个方法verifyPassword()是用来做密码认证,传入的参数是明文密码,通过DigestUtil.digestString()方法,转换成密文密码,然后与数据库中密码作比较,返回比较结果。请注意这里的DigestUtil.digestString()方法,在后面还在提到。

第二个方法setPassword()是用于密码转换的,把明文转成密文,用的同样是DigestUtil.digestString()方法。

谈到这里,相信你应该知道怎么在自己的程序中进行密码转换和密码认证了吧!其实并不是要你自己去写一个SHA的加密算法,既然James已经提供了此功能,你调用便是了。

还有一种情况,开发者需要在数据库中必须用明文保存密码,这样就不必在自己写的程序中进行密码转换了,而且当多个应用系统采用统一用户模型时,最好只有一个用户实例。要实现这个需求,就只能修改James源代码了,把verifyPassword()方法和setPassword()改成:


 

public boolean verifyPassword(String pass) {       
             return hashedPassword.equals(pass);       
}   
public boolean setPassword(String newPass) {      
             hashedPassword = newPass;
             return true;       
}




其实就是把转换过程去掉,保存和认证就都采用明文进行了。

你要是觉得SHA方式不妥,也可以挂接别的加密方式,同样是修改这两个方法。

注意,当你修改了James的源码后,你需要用Ant重新build James项目,build后将在james-2.1-srcdistjames-2.1apps下面找到新生成的james.sar文件。把该文件覆盖James原来james.sar,并删除与james.sar同级的james目录,重启动james即可。建议保留原来的config.xml,免得又配一次。

通过以上探讨,我们明白了如何通过Web方式进行用户注册和用户登记等。需要说明一点是,James自动生成的users表中只有7个字段,而且都是系统需要使用的。一般注册时需要输入的信息项比较多,这时建议开发者自己再建一个新表USERINFO,用username把两个表关联起来,不建议修改users表的内容(如果想试试,请参file://conf/sqlResources.xml)。

--------------------------------------------------------------------------------------------------------------------------------

说白了就是把里面的代码拷过来,自己写一个明文转密文的方法,如下:

package struts.action;

import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.io.OutputStream;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;

import javax.mail.MessagingException;
import javax.mail.internet.MimeUtility;

//用作SHA加密
public class PwdSecurity {
	public static String digestString(String pass, String algorithm)
			throws NoSuchAlgorithmException {

		MessageDigest md;
		ByteArrayOutputStream bos;

		try {
			md = MessageDigest.getInstance(algorithm);
			byte[] digest = md.digest(pass.getBytes("iso-8859-1"));
			bos = new ByteArrayOutputStream();
			OutputStream encodedStream = MimeUtility.encode(bos, "base64");
			encodedStream.write(digest);
			return bos.toString("iso-8859-1");
		} catch (IOException ioe) {
			throw new RuntimeException("Fatal error: " + ioe);
		} catch (MessagingException me) {
			throw new RuntimeException("Fatal error: " + me);
		}
	}
}

 

 

会有如下报错:Exception in thread "main" java.lang.NoClassDefFoundError: com/sun/mail/util/LineInputStream

 

原因:javax.mail和javax.activation这两个包已经在javaEE5当中属于基础包了,就是JDK中自带了已经,但是里面的方法与现在外面的mail.jar和activation.jar有一些出入

 

解决方法:进到

X:/Program Files/MyEclipse 6.0/myeclipse/eclipse/plugins/com.genuitec.eclipse.j2eedt.core_6.0.1.zmyeclipse601200710/data/libraryset/EE_5/javaee.jar
(注意我用的是6.0)
这个路径里,可以看到javaee.jar,用rar把这个文件打开,然后进到javax文件夹里,删除mail.jar和activation.jar(我的javaee.jar里,这两个东西是文件夹,总之删掉就OK,不过要注意备份一下

Logo

权威|前沿|技术|干货|国内首个API全生命周期开发者社区

更多推荐