介绍 微软 framework 相对于x来说增加了对FTP的支持以前为了符合我的需求我不等不使用第三方类库来实现FTP功能但是为了可靠还是使 framework的类比较好我的这段代码没有做成可重复使用的类库的形式但它却是比较容易理解的并能满足你的需求它可以实现上传下载删除等任意功能在这篇文章的后面将给大家出 下实现ftp的简单代码使用的语言是c#或许是因为这新增的类又或许是第三方类库已经能很好的实现你的需求 的这部分类库并没有得到足够的关注
背景
作为我的工作的一部分我已经使用了ftp模块但是我只能 中去使用它所以我不能深入的研 下ftp的实现但是我相信ne 下对ftp的支持是非常好的
代码 不要忘记引入命名空间
using SystemNet;
using SystemIO;
下面的几个步骤包括了使用FtpWebRequest类实现ftp功能的一般过程
创建一个FtpWebRequest对象指向ftp服务器的uri
设置ftp的执行方法(上传下载等)
给FtpWebRequest对象设置属性(是否支持ssl是否使用二进制传输等)
设置登录验证(用户名密码)
执行请求
接收相应流(如果需要的话)
如果没有打开的流则关闭ftp请求
开发任何ftp应用程序都需要一个相关的ftp服务器及它的配置信息FtpWebRequest暴露了一些属性来设置这些信息
接下来的代码示例了上传功能
首先设置一个uri地址包括路径和文件名这个uri被使用在FtpWebRequest实例中
然后根据ftp请求设置FtpWebRequest对象的属性
其中一些重要的属性如下
·Credentials 指定登录ftp服务器的用户名和密码
·KeepAlive 指定连接是应该关闭还是在请求完成之后关闭默认为true
·UseBinary 指定文件传输的类型有两种文件传输模式一种是Binary另一种是ASCII两种方法在传输时字节的第位是不同的ASCII使用第位作为错误控制而Binary的位都是有意义的所以当你使用ASCII传输时要小心一些简单的说如果能用记事本读和写的文件用ASCII传输就是安全的而其他的则必须使用Binary模式当然使用Binary模式发送ASCII文件也是非常好的
·UsePassive 指定使用主动模式还是被动模式早先所有客户端都使用主动模式而且工作的很好而现在因为客户端防火墙的存在将会关闭一些端口这样主动模式将会失败在这种情况下就要使用被动模式但是一些端口也可能被服务器的防火墙封掉不过因为ftp服务器需要它的ftp服务连接到一定数量的客户端所以他们总是支持被动模式的这就是我们为什么要使用被动模式的原意为了确保数据可以正确的传输使用被动模式要明显优于主动模式(译者注主动(PORT)模式建立数据传输通道是由服务器端发起的服务器使用端口连接客户端的某一个大于的端口在被动(PASV)模式中数据传输的通道的建立是由FTP客户端发起的他使用一个大于的端口连接服务器的以上的某一个端口)
·ContentLength 设置这个属性对于ftp服务器是有用的但是客户端不使用它因为FtpWebRequest忽略这个属性所以在这种情况下该属性是无效的但是如果我们设置了这个属性ftp服务器将会提前预知文件的大小(在upload时会有这种情况)
·Method 指定当前请求是什么命令(uploaddownloadfilelist等)这个值定义在结构体WebRequestMethodsFtp中
private void Upload(string filename)
{
FileInfo fileInf = new FileInfo(filename);
string uri = ftp:// + ftpServerIP + / + fileInfName;
FtpWebRequest reqFTP;
// 根据uri创建FtpWebRequest对象
reqFTP = (FtpWebRequest)FtpWebRequestCreate(new Uri(ftp:// + ftpServerIP + / + fileInfName));
// ftp用户名和密码
reqFTPCredentials = new NetworkCredential(ftpUserID ftpPassword);
// 默认为true连接不会被关闭
// 在一个命令之后被执行
reqFTPKeepAlive = false;
// 指定执行什么命令
reqFTPMethod = WebRequestMethodsFtpUploadFile;
// 指定数据传输类型
reqFTPUseBinary = true;
// 上传文件时通知服务器文件的大小
reqFTPContentLength = fileInfLength;
// 缓沖大小设置为kb
int buffLength = ;
byte[] buff = new byte[buffLength];
int contentLen;
// 打开一个文件流 (SystemIOFileStream) 去读上传的文件
FileStream fs = fileInfOpenRead();
try
{
// 把上传的文件写入流
Stream strm = reqFTPGetRequestStream();
// 每次读文件流的kb
contentLen = fsRead(buff buffLength);
// 流内容没有结束
while (contentLen != )
{
// 把内容从file stream 写入 upload stream
strmWrite(buff contentLen);
contentLen = fsRead(buff buffLength);
}
// 关闭两个流
strmClose();
fsClose();
}
catch (Exception ex)
{
MessageBoxShow(exMessage Upload Error);
}
}
以上代码简单的示例了ftp的上传功能创建一个指向某ftp服务器的FtpWebRequest对象然后设置其不同的属性CredentialsKeepAliveMethodUseBinaryContentLength
打开本地机器上的文件把其内容写入ftp请求流缓沖的大小为kb无论上传大文件还是小文件这都是一个合适的大小
private void Download(string filePath string fileName)
{
FtpWebRequest reqFTP;
try
{
FileStream outputStream = new FileStream(filePath + \\ + fileName FileModeCreate);
reqFTP = (FtpWebRequest)FtpWebRequestCreate(new Uri(ftp:// + ftpServerIP + / + fileName));
reqFTPMethod = WebRequestMethodsFtpDownloadFile;
reqFTPUseBinary = true;
reqFTPCredentials = new NetworkCredential(ftpUserID ftpPassword);
FtpWebResponse response = (FtpWebResponse)reqFTPGetResponse();
Stream ftpStream = responseGetResponseStream();
long cl = responseContentLength;
int bufferSize = ;
int readCount;
byte[] buffer = new byte[bufferSize];
readCount = ftpStreamRead(buffer bufferSize);
while (readCount > )
{
outputStreamWrite(buffer readCount);
readCount = ftpStreamRead(buffer bufferSize);
}
ftpStreamClose();
outputStreamClose();
responseClose();
}
catch (Exception ex)
{
MessageBoxShow(exMessage);
}
}
上面的代码实现了从ftp服务器上下载文件的功能这不同于之前所提到的上传功能下载需要一个响应流它包含着下载文件的内容这个下载的文件是在FtpWebRequest对象中的uri指定的在得到所请求的文件后通过FtpWebRequest对象的GetResponse()方法下载文件它将把文件作为一个流下载到你的客户端的机器上
注意我们可以设置文件在我们本地机器上的存放路径和名称
public string[] GetFileList()
{
string[] downloadFiles;
StringBuilder result = new StringBuilder();
FtpWebRequest reqFTP;
try
{
reqFTP = (FtpWebRequest)FtpWebRequestCreate(new Uri(ftp:// + ftpServerIP + /));
reqFTPUseBinary = true;
reqFTPCredentials = new NetworkCredential(ftpUserID ftpPassword);
reqFTPMethod = WebRequestMethodsFtpListDirectory;
WebResponse response = reqFTPGetResponse();
StreamReader reader = new StreamReader(responseGetResponseStream());
string line = readerReadLine();
while (line != null)
{
resultAppend(line);
resultAppend(\n);
line = readerReadLine();
}
// to remove the trailing \n
resultRemove(resultToString()LastIndexOf(\n) );
readerClose();
responseClose();
return resultToString()Split(\n);
}
catch (Exception ex)
{
SystemWindowsFormsMessageBoxShow(exMessage);
downloadFiles = null;
return downloadFiles;
}
}
上面的代码示例了如何从ftp服务器上获得文件列表uri指向ftp服务器的地址我们使用StreamReader对象来存储一个流文件名称列表通过\r\n分隔开也就是说每一个文件名称都占一行你可以使用StreamReader对象的ReadToEnd()方法来得到文件列表上面的代码中我们用一个StringBuilder对象来保存文件名称然后把结果通过分隔符分开后作为一个数组返回我确定只是一个比较好的方法
其他的实现如RenameDeleteGetFileSizeFileListDetailsMakeDir等与上面的几段代码类似就不多说了
注意实现重命名的功能时要把新的名字设置给FtpWebRequest对象的RenameTo属性连接指定目录的时候需要在FtpWebRequest对象所使用的uri中指明
需要注意的地方
你在编码时需要注意以下几点
·除非EnableSsl属性被设置成true否作所有数据包括你的用户名和密码都将明文发给服务器任何监视网络的人都可以获取到你连接服务器的验证信息如果你连接的ftp服务器提供了SSL你就应当把EnableSsl属性设置为true
·如果你没有访问ftp服务器的权限将会抛出SecurityException错误
·发送请求到ftp服务器需要调用GetResponse方法当请求的操作完成后一个FtpWebResponse对象将返回这个FtpWebResponse对象提供了操作的状态和已经从ftp服务器上下载的数据FtpWebResponse对象的StatusCode属性提供了ftp服务器返回的最后的状态代码FtpWebResponse对象的StatusDescription属性为这个状态代码的描述