在之前介紹的附件管理模塊里面《Winform開發框架之通用附件管理模塊》以及《Winform開發框架之附件管理應用》，介紹了附件的管理功能，通過對數據庫記錄的處理和文件的管理，實現了附件文件和記錄的整合管理，可以運用在單機版的WInform框架，也可以使用在分布式的混合式開發框架中，隨著一些開發場景的豐富，我們需要以FTP方式上傳文件，因此對這個附件管理模塊進行擴展，以便適合更多的實際項目需求。

1、FTP上傳、HTTP文件預覽實現思路

我們設想的附件管理，底層都是需要在Winform、Web等開發項目上重用的，因此底層的設計需要考慮好對應的處理，另外后面可以利用WInform的HTML編輯控件、或者Web的HTML編輯控件進行集成，附件則是統一在一個組件里面實現的。
借助FTP的文件上傳，我們單機版本或者基于局域網的Winform界面程序，也可以單獨構建一個FTP服務器，實現文件的共享；而分布式的混合式開發框架中，對于文件的上傳，可以選擇基于服務的文件系統寫入，同時也可以基于FTP的方式上傳。
基于混合式框架的FTP方式上傳文件，其邏輯關系如下所示。

這樣文件通過FTP方式上傳的文件系統后，我們在文件系統里面搭建一個HTTP服務，這樣對應上的HTTP地址就可以實現文件的下載，以及圖片的查看等操作了（可以在HTML編輯器中實現）。

2、引入FTP組件實現文件上傳

使用FTP上傳，雖然在自己的公用類庫里面有FTPHelper類可以使用，不過相對來說，我更愿意引入更為完善強大的FTP開源組件進行相關的處理，這里我們使用FluentFTP這個組件（GitHub地址：https://github.com/hgupta9/FluentFTP ），這個是一個應用很廣，功能很強大的FTP組件。
FluentFTP是一款老外開發的基于.Net的支持FTP及的FTPS 的FTP類庫，FluentFTP是完全托管的FTP客戶端，被設計為易于使用和易于擴展。它支持文件和目錄列表，上傳和下載文件和SSL / TLS連接。它可以連接到Unix和Windows IIS建立FTP服務器。這個項目是完全開發托管C #。
這個組件的使用代碼，這里粘貼一下，以便總體有一個直觀的了解吧。

// create an FTP client
FtpClient client = new FtpClient("123.123.123.123");

// if you don't specify login credentials, we use the "anonymous" user account
client.Credentials = new NetworkCredential("david", "pass123");

// begin connecting to the server
client.Connect();

// get a list of files and directories in the "/htdocs" folder
foreach (FtpListItem item in client.GetListing("/htdocs")) {
    
    // if this is a file
    if (item.Type == FtpFileSystemObjectType.File){
        
        // get the file size
        long size = client.GetFileSize(item.FullName);
        
    }
    
    // get modified date/time of the file or folder
    DateTime time = client.GetModifiedTime(item.FullName);
    
    // calculate a hash for the file on the server side (default algorithm)
    FtpHash hash = client.GetHash(item.FullName);
    
}

// upload a file
client.UploadFile(@"C:\MyVideo.mp4", "/htdocs/big.txt");

// rename the uploaded file
client.Rename("/htdocs/big.txt", "/htdocs/big2.txt");

// download the file again
client.DownloadFile(@"C:\MyVideo_2.mp4", "/htdocs/big2.txt");

// delete the file
client.DeleteFile("/htdocs/big2.txt");

// delete a folder recursively
client.DeleteDirectory("/htdocs/extras/");

// check if a file exists
if (client.FileExists("/htdocs/big2.txt")){ }

// check if a folder exists
if (client.DirectoryExists("/htdocs/extras/")){ }

// upload a file and retry 3 times before giving up
client.RetryAttempts = 3;
client.UploadFile(@"C:\MyVideo.mp4", "/htdocs/big.txt", FtpExists.Overwrite, false, FtpVerify.Retry);

// disconnect! good bye!
client.Disconnect();

有了這些了解，我們在普通Winform程序或者混合式框架的的程序中，我們通過配置指定FTP的相關信息，就可以在代碼里面加載這些信息，進行FTP的登陸、文件上傳、下載等操作了。

3、附件管理模塊實現

有了上面的思路和組件的輔助，我們對原來的附件管理模塊進行相關的升級處理即可實現FTP上傳模式的處理了。

首先為了方便，我們先定義一個獲取FTP服務器、用戶名、密碼等參數的配置實體類，如下所示。

    /// <summary>
    /// FTP配置信息
    /// </summary>
    [DataContract]
    [Serializable]
    public class FTPInfo
    {
        /// <summary>
        /// 默認構造函數
        /// </summary>
        public FTPInfo()
        {

        }

        /// <summary>
        /// 參數化構造函數
        /// </summary>
        /// <param name="server"></param>
        /// <param name="user"></param>
        /// <param name="password"></param>
        public FTPInfo(string server, string user, string password, string baseUrl)
        {
            this.Server = server;
            this.User = user;
            this.Password = password;
            this.BaseUrl = baseUrl;
        }

        /// <summary>
        /// FTP服務地址
        /// </summary>
        [DataMember]
        public string Server { get; set; }

        /// <summary>
        /// FTP用戶名
        /// </summary>
        [DataMember]
        public string User { get; set; }

        /// <summary>
        /// FTP密碼
        /// </summary>
        [DataMember]
        public string Password { get; set; }

        /// <summary>
        /// FTP的基礎路徑，如可以指定為IIS的路徑：http://www.iqidi.com:8000 ,方便下載打開
        /// </summary>
        [DataMember]
        public string BaseUrl { get; set; }
    }

定義一個函數，專門用來提取配置文件里面的相關FTP參數的，如下所示。

/// <summary>
/// 獲取配置的FTP配置參數
/// </summary>
/// <returns></returns>
private FTPInfo GetFTPConfig()
{
    var ftp_server = config.AppConfigGet("ftp_server");
    var ftp_user = config.AppConfigGet("ftp_user");
    var ftp_pass = config.AppConfigGet("ftp_password");
    var ftp_baseurl = config.AppConfigGet("ftp_baseurl");

    return new FTPInfo(ftp_server, ftp_user, ftp_pass, ftp_baseurl);
}

其中我們的配置文件如下所示。

使用FluentFTP的組件代碼如下所示。

//使用FluentFTP操作FTP文件
FtpClient client = new FtpClient(ftpInfo.Server, ftpInfo.User, ftpInfo.Password);

然后調用FTP組件對目錄進行判斷，無則創建一個即可。

//確定日期時間目錄（格式：yyyy-MM），不存在則創建
string savePath = string.Format("/{0}-{1:D2}/{2}", DateTime.Now.Year, DateTime.Now.Month, category);
bool isExistDir = client.DirectoryExists(savePath);
if(!isExistDir)
{
    client.CreateDirectory(savePath);
}

最后使用組件上傳文件即可，這里上傳文件，由于前面FileUploadInfo實體類里面存儲的是字節數組，因此也是采用FTP組件直接上傳字節數組即可。

//使用FTP上傳文件
//避免文件重復，使用GUID命名
var ext = FileUtil.GetExtension(info.FileName);
var newFileName = string.Format("{0}{1}", Guid.NewGuid().ToString(), ext);//FileUtil.GetFileName(file);

savePath = savePath.UriCombine(newFileName);
bool uploaded = client.Upload(info.FileData, savePath, FtpExists.Overwrite, true);

文件上傳到文件服務器后，剩下的就是把相關的信息存儲到附件管理模塊的數據表里面即可，這樣可以在使用的時候，直接使用數據庫里面的信息，如果是需要查看圖片或者下載文件，那么拼接好相關的HTTP地址即可，我們來看看對應的數據庫記錄截圖如下所示。