FTP文件上传控件开发文档-Xproer.FtpUploader2

绝对绿茶

版权所有 2009-2012 武汉命运科技有限公司
保留所有权利
产品博客：http://www.iyunv.com/xproer/
官方网站：http://www.ncmem.com/
产品首页：http://www.ncmem.com/webplug/ftp-uploader2/index.aspx
在线演示：http://www.ncmem.com/products/file-uploader/demo/index.html
开发文档：http://www.iyunv.com/xproer/archive/2011/03/15/1984413.html
升级日志：http://www.iyunv.com/xproer/archive/2011/04/04/2005251.html


资源下载：cab安装包,开发文档,示例下载,VC库
联系信箱：1085617561@qq.com
联系QQ：1085617561

1.      概述
FtpUploader2在FtpUploader的基础上进行了大幅度调整和优化。
首先在FtpUploader中是使用单独的线程来计算即时上传速度的，在某些情况下计算结果可能会出现较大的误差。在FtpUploader2中我们取消了单独的速度计算线程，将速度计算与上传模块整合在一起，使速度计算更加精确。
在客户端调用方面(JavaScript)我们在COM组件中提供了一个JS对象指针，用来保存客户端的FtpUploader对象，在组件事件中将这个JS对象指针传给客户端，这样极大的简化了客户端开发模式。
在即时速度计算方面，我们取消了JS的定时调用，装饰速度计算的任务完全交给COM组件来进行。降低了线程同步访问的风险。
与FtpUploader相比FtpUploader2更稳定，更高效，开发也更简单。

2.      快速开始
2.1.   架设FTP服务器
新颖网络FTP文件上传插件支持Microsoft FTP，Serv-U和FileZilla。
以下分别为FTP服务器的架设教程：
安装ServU—7.1：http://www.iyunv.com/xproer/archive/2010/11/20/1882370.html
安装ServU-6.4.0.6：http://www.iyunv.com/xproer/archive/2011/03/28/1998042.html
安装FileZilla Server：http://www.iyunv.com/xproer/archive/2010/12/23/1914588.html
安装Microsoft FTP Server：http://www.iyunv.com/xproer/archive/2011/03/06/1972192.html

2.2.   添加测试帐号
由于测试版FtpUploader只能连接127.0.0.1服务器，且只能以test帐号登陆，所以在演示时需要添加test帐号。
帐号：test
密码：test

2.3.   配置FTP信息

var manager = new FileTransferManager("FilePostLister");

manager.Config["Server"] = "127.0.0.1";//测试版插件只能连接这个IP

manager.Config["UserName"] = "test";//设置FTP用户名

manager.Config["UserPass"] = "test";//设置FTP密码

manager.Config["RemoteFolder"] = "upload";//设置FTP上传目录

2.4.   运行示例
在IE中打开文件FtpUploader.html

3.      JavaScript对象
3.1.   FileUploader对象
类型：JavaScript
文件上传对象的包装类，用户在实际的项目中只需要创建FileUploader对象，然后通过FileUploader对象就可以进行文件上传操作。

语法：

JavaScript（声明）
function FileUploader() { }

方法

	名称	说明
	Ready	指示文件上传对象准备完毕
	Post	开始上传文件
	Stop	停止文件上传
	PostNext	继续传输上传队列中的下一个文件

Ready方法
将上传任务状态设置为准备状态。
Post方法
开始上传文件。
说明：此函数将会自动实现断点续传功能。如果当前任务文件只上传了一半，则在下次开始时XSUploader组件将会自动定位到上次上传的位置继续上传数据。
Stop方法
停止上传任务。
PostNext方法
继续上传队列中下一个任务。

属性

	名称	说明
	pMsg	消息对象。是一个DIV
	pProcess	上传进度条对象。是一个DIV
	pPercent	上传进度百分比对象。是一个DIV
	pButton	控制按钮对象。是一个A
	LocalFile	包含完整路径的本地文件名称。例：C:\qq.exe

3.2.   FileTransferManager对象
类型：JavaScript
文件上传管理类。

构造函数
FileTransferManager(fileListDivId)
参数：
fileListDiv
     上传列表的DIV对象ID名称。文件上传管理对象会将每一个文件的上传信息添加到此DIV中。
     注意：此DIV必须存在，此DIV的ID必须唯一。

方法
AddFile方法
添加一个文件到上传对列中

语法：
void AddFile(fid);

参数：
fid
新上传任务的文件ID，此ID用来区域不同的上传任务。必须保证唯一。

PostFirst方法
开始上传队列中的第一个文件。

语法：
void PostFirst()

Exist方法
检查上传队列中是否存在指定文件。

语法：
bool Exist();

返回值：
     true
表示存在。
     false
不存在。

说明：此函数是根据本地文件的完整路径来检测的。
属性
Config属性
提供插件的全局配置信息。在项目如果需要修改插件的配置信息，只需要通Config属性来控件即可。

语法：

this.Config = {

         "Server"      : "127.0.0.1"

         , "UserName"  : "test"

         , "UserPass"  : "test"

         , "RemoteFolder": ""

         , "Port"      : 21

     };

示例-设置插件信息

    var manager = new FileTransferManager("FilePostLister");

    manager.Config["Server"] = "tel.ftp.u.115.com:21";

    manager.Config["UserName"] = "1199925";

    manager.Config["UserPass"] = "4b29da413f";

    manager.Config["RemoteFolder"] = "upload";

4.      ActiveX对象
4.1.   Xproer.UploaderPartition2对象
CLSID：9463F939-F485-404f-9FB0-8729E82DE11F
类型：ActiveX
多文件选择对象。弹出一个文件选择对话框，为用户提供选择多个文件的功能。
方法

	名称	说明
	ShowDialog	弹出文件选择对话框
	GetSelectedFiles	获取用户选择的文件列表

GetSelectedFiles方法
获取用户选择的文件列表数组。

示例
下面的代码示例将会创建一个文件选择框，并弹出用户所选择的文件名称。

JavaScript：

     function ShowSelectFileDlg()

     {

         var manager = new FileTransferManager("FilePostLister");

         var obj = new ActiveXObject("Xproer.UploaderPartition2");//创建文件选择对话框

         if (!obj.ShowDialog()) return;

         var list = obj.GetSelectedFiles();//获取用户选择的文件

         if (list.lbound(1) == null) return;

         for (var index = list.lbound(1); index

     var obj = document.getElementById("FilePanel1");

     obj.OnFileDrop = EventFileDrop;

     function EventFileDrop()

     {

         var lister = document.getElementById("divFileLister");

         var list = obj.GetSelectedFiles();//获取选择的文件

         for (var index = list.lbound(1); index