Apache FtpServer扩展【动手实现自己的业务】

Apache FtpServer是当下最热门的走ftp协议的用于用户上传下载的服务器。

官网http://mina.apache.org/ftpserver-project/

 

一般来说，用的话，去官网下载完整的项目文件ftpserver-1.0.6.zip【windows版】和ftpserver-1.0.6.tar.gz【linux版】到本地，解压之后配置一下\ftpserver-1.0.6\apache-ftpserver-1.0.6\res\conf\下的users.properties或者ftpd-full.xml【主要看你走什么样的用户验证方式。users.properties：把用户信息配置在这个文件中。ftpd-full.xml：把用户信息配置在数据库中】

这样去bin目录下启动程序就好了。

 

但是Apache FtpServer从官方文档来看，都没有提及如何改变其中一些功能，只是解释一些它提供的标准功能。

这样对于企业级的应用来说，有些功能并不能满足现有的业务。

 

比如，我想限制每个ftp用户上传文件到他的文件目录下时，我想限制每个用户最多上传文件的总大小不超过50M。因为我不想被恶意用户弄爆我的服务器。我查阅了大量资料，发现标准的官方版里面是没有这样的功能的，在ftpd-full.xml和users.properties这里面也没有任何可以修改的参数来控制这样的业务。最后我决定自己通过编程来实现这样一个专门服务于我的这样的FtpServer。

我有这种想法的原因是，Apache FtpServer是纯java写的服务，而且提供了丰富的java接口。

 

查阅了大量资料后，还是找不到怎么用代码从jar里面启动整个server。

最后用反编译工具反编译整个Apache FtpServer项目后发现了，找到了启动的入口。

 public MyFtpServer() throws FtpException{

         //读取my-ftpd-full.xml，连接数据库和监控配置,然后来启动server
         FileSystemXmlApplicationContext ctx = new FileSystemXmlApplicationContext(xmlPath);
         FtpServer server = null;
         if (ctx.containsBean("server")) {
             server = (FtpServer)ctx.getBean("server");
          } else {
             String[] beanNames = ctx.getBeanNamesForType(FtpServer.class);
             if (beanNames.length == 1) {
                 server = (FtpServer)ctx.getBean(beanNames[0]);
             } else if (beanNames.length > 1) {
                 logger.info("Using the first server defined in the configuration, named " + beanNames[0]);
                 server = (FtpServer)ctx.getBean(beanNames[0]);
             } else {
                 logger.info("XML configuration does not contain a server configuration");
             }
         }

         //ftp服务器启动
         server.start();

         //在jvm关闭的时候，清理函数
         addShutdownHook(server);
     }

     /**
      * 清理的垃圾的钩子函数
      * @param engine
      */
     private void addShutdownHook(final FtpServer engine)
       {
         Runnable shutdownHook = new Runnable() {
           public void run() {
            logger.info("Stopping server...");
             engine.stop();
           }
         };
         Runtime runtime = Runtime.getRuntime();
         runtime.addShutdownHook(new Thread(shutdownHook));
       }

配合上我的研究发现，提供的接口中可以在ftpd-full.xml中配置

 

 

    <ftplets>
        <ftplet name="MyFtplet">
            <beans:bean class="com.shiyi.km.ftpserver.control.MyFtplet">
<!--                 <beans:property name="foo" value="123" /> -->
            </beans:bean>
        </ftplet>
    </ftplets>

类似于监听器的东西，可以监听每个用户在上传或者下载的动作，在这些监听事件里面，我每次都去计算那个用户目录下面的文件size总大小，如果超过限制，就stop，并返回警告代码和消息给用户。

 import java.io.File;
 import java.io.IOException;

 import org.apache.ftpserver.ftplet.DefaultFtpReply;
 import org.apache.ftpserver.ftplet.DefaultFtplet;
 import org.apache.ftpserver.ftplet.FtpException;
 import org.apache.ftpserver.ftplet.FtpRequest;
 import org.apache.ftpserver.ftplet.FtpSession;
 import org.apache.ftpserver.ftplet.FtpletResult;
 import org.apache.ftpserver.ftplet.User;
 import org.apache.log4j.Logger;

 import com.shiyi.km.ftpserver.util.ConfigUtil;
 import com.shiyi.km.ftpserver.util.FileUtil;

 /**
  *
  * @fileName MyFtplet.java
  * @author chenkaideng
  * @date 2015年8月11日
  * @describe 监控事件
  */
 public class MyFtplet extends DefaultFtplet{
     private static final Logger logger = Logger.getLogger(MyFtplet.class);

     @Override
     public FtpletResult onUploadStart(FtpSession session, FtpRequest request)
             throws FtpException, IOException {
         //获取用户信息
         User user = session.getUser();
         logger.info(String.format("用户信息，用户名【%s】，用户工作目录【%s】", user.getName(),user.getHomeDirectory()));
         File file=new File(user.getHomeDirectory());

         //判断传入对象是否为一个文件夹对象
         if(!file.isDirectory()){
             logger.info("用户的HomeDirectory不是一个文件夹，请检查路径是否有误！！");
         }
         else{
             ConfigUtil configUtil = ConfigUtil.getInstance();
             if(FileUtil.overSizeLimit(configUtil.getQuota(), file)){
                 logger.error(String.format("目前用户[%s]目录下的文件总大小超过配额！！！", user.getName()));
                 session.write(new DefaultFtpReply(228, "The files under the directory over quota"));
                 return FtpletResult.DISCONNECT;
             }
         }
         return super.onUploadStart(session, request);
     }
 }

差不多整体的思路是这样的。

 

 

有了这些基础，还可以实现各种各样的不同需求，来管理用户目录或者一些其他的业务。