使用C#客户端访问FTP服务的一个解决方案

北战南征 提交于 2020-01-07 16:20:09

【推荐】2019 Java 开发者跳槽指南.pdf(吐血整理) >>>

一、写在前面

最近工作中遇到了一个场景,要用C#客户端访问FTP服务器,并实现文件下载功能。之前我使用了一种非常简单粗暴的方法,因为客户端之前就用到了Xilium.CefGlue(可以理解为一个WebKit内核)来实现浏览网页的功能,客户的需求又仅停留在登录FTP对部分压缩包和doc文件进行下载,我索性直接建了个页面,用这个WebKit内核实现对FTP进行访问,效果和Chrome浏览器访问FTP相似。

不过,这个方法有下面三个缺点:

1、Xilium.CefGlue类库占用的空间很大,如果就为了实现客户端访问FTP服务器,放入一个WebKit内核,平白增加了几十MB的空间占用,是非常不划算的。

2、Xilium.CefGlue打开FTP类似Chrome的打开方式,遇到txt、sql等扩展名的文件时,会直接在浏览器中打开,遇到pdf扩展名的文件时,会使用相关插件打开(或因无相关处理工具而进入错误页)。遇到其他扩展名的文件时,如exe、rar、zip、doc等,才会提示下载。

3、无法满足许多用户定制化的需求(虽然内核是开源的,但你敢改么?)。

所以说,使用C#客户端访问FTP服务器,最好的办法还是自己写一套工具类,实现FTP协议下的上传、下载、创建目录、查询目录下文件列表等操作。

二、使用Serv-U建立本地FTP

使用Serv-U工具可以在本机自建一个FTP服务,方法如下:

1、安装Serv-U并注册(试用版可以使用30天,我用的版本是10.3.0.1)

2、找到“新建域”按钮,新建一个FTP服务

3、新建域向导第一步:建立FTP域名,填写说明信息

4、新建域向导第二步:设置各协议端口号,一般来说使用默认端口号即可

4、新建域向导第三步:也使用默认设置

5、新建域向导第四步:设置密码加密模式,选择“使用服务器设置”

6、Serv-U询问是否要建立用户,点击“是”即可

7、建立用户向导第一步:设置用户登录ID为tsybius

8、建立用户向导第二步:设置密码,这里设置为123456

9、建立用户向导第三步:设置用户登录FTP后看到的根目录

10、建立用户向导第四步:设置访问权限,有只读访问和完全访问两种,这里我选择了完全访问

11、FTP建立完毕,在浏览器地址栏(或资源管理器地址栏)输入下面地址即可登录FTP:

ftp://tsybius:123456@localhost/

三、使用C#程序访问FTP

一般来说,使用C#程序访问FTP,只需要支持以下几个功能就足够了:

1、给定FTP下某一目录地址,获取该地址下所有的文件和目录及它们的详细信息

2、向FTP上传文件

3、从FTP下载文件

4、其他辅助功能(如刷新等)

我们要实现的功能可以参考Xftp,即XShell打开的FTP访问工具

C#中调用FTP的方法是相似的,如获取指定目录下所有文件的详细信息可以写成:

using System;
using System.Collections;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Net;
using System.Text;

namespace FTPManager
{
    class FtpHelper
    {
        public static FtpFileInfo[] GetFtpFileInfos(string ftpPath, string userName, string passWord)
        {
            LinkedList<FtpFileInfo> linkedList = new LinkedList<FtpFileInfo>();
            var reqFtp = (FtpWebRequest)WebRequest.Create(new Uri(ftpPath));
            reqFtp.UsePassive = false;
            reqFtp.UseBinary = true;
            //reqFTP.EnableSsl = true;//加密方式传送数据 FTP 服务器要支持
            reqFtp.Credentials = new NetworkCredential(userName, passWord);
            reqFtp.Method = WebRequestMethods.Ftp.ListDirectoryDetails;
            var response = (FtpWebResponse)reqFtp.GetResponse();
            var reader = new StreamReader(response.GetResponseStream(), Encoding.UTF8);
            string fileDetail = reader.ReadLine();
            while (fileDetail != null)
            {
                linkedList.AddLast(new FtpFileInfo(fileDetail));
                fileDetail = reader.ReadLine();
            }
            reader.Close();
            response.Close();
            return linkedList.ToArray();
        }
    }
}

其中FtpFileInfo是我设计的一个用于管理FTP文件信息的类。下面贴出的代码只是一个非常简陋的版本,并没有经过多少测试,不过可被看做一个解决问题的思路:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

namespace FTPManager
{
    public class FtpFileInfo
    {
        public string UnixFileType { get; set; }
        public string Permission { get; set; }
        public string NumberOfHardLinks { get; set; }
        public string Owner { get; set; }
        public string Group { get; set; }
        public string Size { get; set; }
        public string LastModifiedDate { get; set; }
        public string FileName { get; set; }
        public string FileDetail { get; set; }

        public FtpFileInfo(string fileDetail)
        {
            this.FileDetail = fileDetail;
            int counter = 1;
            string[] propertyBlocks = fileDetail.Split(' ');
            foreach (string propertyBlock in propertyBlocks)
            {
                switch (counter)
                {
                    case 1:
                        {
                            //unix file types & permissions
                            if (string.IsNullOrWhiteSpace(propertyBlock))
                            {
                                continue;
                            }
                            else
                            {
                                if (propertyBlock.Length == 10)
                                {
                                    UnixFileType = propertyBlock[0].ToString();
                                    Permission = propertyBlock.Substring(1);
                                }
                                counter++;
                            }
                        }
                        break;
                    case 2: 
                        {
                            //number of hard links
                            if (string.IsNullOrWhiteSpace(propertyBlock))
                            {
                                continue;
                            }
                            else
                            {
                                NumberOfHardLinks = propertyBlock;
                                counter++;
                            }
                        }
                        break;
                    case 3:
                        {
                            //owner
                            if (string.IsNullOrWhiteSpace(propertyBlock))
                            {
                                continue;
                            }
                            else
                            {
                                Owner = propertyBlock;
                                counter++;
                            }
                        }
                        break;
                    case 4:
                        {
                            //group
                            if (string.IsNullOrWhiteSpace(propertyBlock))
                            {
                                continue;
                            }
                            else
                            {
                                Group = propertyBlock;
                                counter++;
                            }
                        }
                        break;
                    case 5:
                        {
                            //size
                            if (string.IsNullOrWhiteSpace(propertyBlock))
                            {
                                continue;
                            }
                            else
                            {
                                Size = propertyBlock;
                                counter++;
                            }
                        }
                        break;
                    case 6:
                    case 7:
                    case 8:
                        {
                            //last-modified date
                            if (string.IsNullOrWhiteSpace(propertyBlock))
                            {
                                continue;
                            }
                            else
                            {
                                LastModifiedDate += propertyBlock + " ";
                                counter++;
                            }
                        }
                        break;
                    case 9:
                        {
                            //file name
                            if (string.IsNullOrWhiteSpace(propertyBlock))
                            {
                                FileName += " ";
                            }
                            else
                            {
                                FileName += propertyBlock;
                            }
                        }
                        break;
                }
            }
            LastModifiedDate = LastModifiedDate.Trim();
            FileName = FileName.Trim();
        }
    }
}

根据reqFtp.Method的不同,返回的流内容也会不同,我们需要对返回流的内容进行解析。reqFtp.Method一共支持以下几种枚举类型:

// 摘要:
//     表示可与 FTP 请求一起使用的 FTP 协议方法的类型。无法继承此类。
public static class Ftp
{
    // 摘要:
    //     表示要用于将文件追加到 FTP 服务器上的现有文件的 FTP APPE 协议方法。
    public const string AppendFile = "APPE";
    //
    // 摘要:
    //     表示要用于删除 FTP 服务器上的文件的 FTP DELE 协议方法。
    public const string DeleteFile = "DELE";
    //
    // 摘要:
    //     表示要用于从 FTP 服务器下载文件的 FTP RETR 协议方法。
    public const string DownloadFile = "RETR";
    //
    // 摘要:
    //     表示要用于从 FTP 服务器上的文件检索日期时间戳的 FTP MDTM 协议方法。
    public const string GetDateTimestamp = "MDTM";
    //
    // 摘要:
    //     表示要用于检索 FTP 服务器上的文件大小的 FTP SIZE 协议方法。
    public const string GetFileSize = "SIZE";
    //
    // 摘要:
    //     表示获取 FTP 服务器上的文件的简短列表的 FTP NLIST 协议方法。
    public const string ListDirectory = "NLST";
    //
    // 摘要:
    //     表示获取 FTP 服务器上的文件的详细列表的 FTP LIST 协议方法。
    public const string ListDirectoryDetails = "LIST";
    //
    // 摘要:
    //     表示在 FTP 服务器上创建目录的 FTP MKD 协议方法。
    public const string MakeDirectory = "MKD";
    //
    // 摘要:
    //     表示打印当前工作目录的名称的 FTP PWD 协议方法。
    public const string PrintWorkingDirectory = "PWD";
    //
    // 摘要:
    //     表示移除目录的 FTP RMD 协议方法。
    public const string RemoveDirectory = "RMD";
    //
    // 摘要:
    //     表示重命名目录的 FTP RENAME 协议方法。
    public const string Rename = "RENAME";
    //
    // 摘要:
    //     表示将文件上载到 FTP 服务器的 FTP STOR 协议方法。
    public const string UploadFile = "STOR";
    //
    // 摘要:
    //     表示将具有唯一名称的文件上载到 FTP 服务器的 FTP STOU 协议方法。
    public const string UploadFileWithUniqueName = "STOU";
}

更详细的说明可参考MSDN页面:https://msdn.microsoft.com/zh-cn/library/ms144320.aspx

前面代码中使用到的是WebRequestMethods.Ftp.ListDirectoryDetails,因此返回流的内容为

返回的内容和Linux中命令“ls -l”是一样的,从左到右依次是:

Unix file types(Unix文件类型)、permissions(各用户权限)、number of hard links(硬连接数)、owner(所有者)、group(所属组)、size(文件大小)、last-modified date(文件最后更改时间)、filename(文件名)

关于Linux中ls命令的细节,可以参考维基百科页面:https://en.wikipedia.org/wiki/Ls

在主窗体下,写如下代码即可调用我们刚才实现的FtpHelper.GetFtpFileInfos:

private void FormMain_Load(object sender, EventArgs e)
{
    try
    {
        FtpFileInfo[] ftpFileInfos = FtpHelper.GetFtpFileInfos("ftp://localhost/", "tsybius", "123456");
        dgvFileList.DataSource = ftpFileInfos;
    }
    catch (Exception ex)
    {
        MessageBox.Show(ex.Message);
    }
}

(其中dgvFileList为一个DataGridView控件)

代码执行效果如下:

上面代码应注意之处有:

1、DataGridView的相关样式设定这里不再赘述,我手动添加了四列,并为每列设置了DataPropertyName与FtpFileInfo字段相对应。

2、可以看出直接显示在DataGridView上的内容并不适合人阅读,文件类型、文件大小可以通过自己写两个继承自DataGridViewTextBoxColumn的类来实现令人舒服一些的显示。

3、上面的例子中,我们把数组传入DataGridView的DataSource,这样做有一个弊端是不能点击各列列头对数据进行排序。如果希望对数据排序,可将结果集转换成DataTable格式。

另附上我在网上找的几段C#访问FTP的代码,可供参考:

http://blog.csdn.net/chr23899/article/details/41787863

http://www.cnblogs.com/wang726zq/archive/2012/07/30/ftp.html

END

易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!