cyc1111 发表于 2015-8-30 08:18:23

HTTP断点续传控件-PHP开发文档-Xproer.HttpUploader5

  版权所有 2009-2014 荆门泽优软件有限公司
  保留所有权利
  官方网站:http://www.ncmem.com/
  产品首页:http://www.ncmem.com/webplug/http-uploader5/index.asp
  在线演示:http://www.ncmem.com/products/http-uploader5/index.html
  产品介绍:http://www.cnblogs.com/xproer/archive/2012/10/26/2741264.html
  升级日志:http://www.cnblogs.com/xproer/archive/2012/10/26/2741268.html
  开发文档:ASP,ASP.NET,JSP.PHP,
  资源下载:cab安装包(x86),cab安装包(x64),crx安装包,xpi安装包,exe安装包,开发文档,VC运行库,证书补丁,Discuz!X2插件下载,
  示例下载(.NET):ACCESS示例
  示例下载(JSP):ACCESS示例,Sql2005示例,MySQL示例,Oracle示例,
  示例下载(JSP-WebLogic):ACCESS示例(GB2312),ACCESS示例(UTF-8),
  示例下载(PHP):MySQL示例
  联系信箱:1085617561@qq.com
  咨询QQ:1085617561
  更新记录:
                     更新时间
                        描述
                                  2012-2-16
                        增加断点续传章节。
                                  2012-2-17
                        增加自动拼接路径章节
                                  2012-2-24
                        修改上传本地文件示例代码的错误
                                  2012-3-9
                        添加搭建测试环境章节
                                  2012-04-04
                        增加Discuz!X2整合教程
  增加demo-db-utf8示例章节。
                                  2012-04-11
                        为ASP.NET章节增加demo-db-gb2312章节
  更新界面章节。
                                  2012-04-12
                        更新ASP.NET示例。
  更新PHP示例。
                                  2012-04-13
                        更新ASP.NET示例中的数据库信息,ASP.NET支持1000G文件的断点续传操作。
                                  2012-04-17
                        更新PHP示例说明。
                                  2012-05-03
                        更新修改classid和codebase地址章节。
                                  2012-05-21
                        修复Config中的错误。
                                  2012-05-22
                        增加控件升级章节。
                                  2012-05-24
                        增加加截控件错误章节。
                                  2012-05-25
                        增加JSP示例章节。
                                  2012-06-07
                        增加粘贴文件的章节。
                                  2012-07-23
                        增加用户接口-设置文件块大小章节
                                  2012-11-01
                        增加MySQL数据库连接池章节
                                  2012-11-06
                        增加SQL数据库连接池章节。
                                  2013-01-16
                        增加测试包布署说明,tomcat支持cab文件下载教程。
                                  2013-03-14
                        更新章节:让tomcat支持cab文件下载
                                  2013-03-15
                        增加JSP-MYSQL驱动错误章节。
                                  2013-04-25
                        增加删除Chrome,Firefox插件方法
                                  2013-05-03
                        增加章节:
  1.获取指定目录下的文件
  2.获取当前控件版本号
                                  2013-05-20
                        增加SQL2005章节
                                  2013-05-21
                        更新设置附加字段信息章节,增加自定义服务器文件名称章节。
  删除服务器支持章节。
  新增章节:检查本地文件是否存在。
                                  2013-05-24
                        新增获取FF,Chrome控件版本号章节。
                                  2013-06-25
                        增加Oracle示例布署教程。
                                  2013-08-28
                        增加实现跨域访问章节。
                                  2013-11-30
                        增加360安全浏览器卸载教程。
                                  2014-01-14
                        完善示例文件说明。
                                  2014-03-04
                        完善正式包布署说明
                                  2014-03-18
                        更新在本地测试DEMO的说明。
                                  2014-04-02
                        增加自定义用户界面章节。
  增加JSP-SQL2005错误的章节。
                                  2014-06-06
                        完善正式包布署说明章节。
                                  2014-06-09
                        增加使用HttpAnalyzerStd章节。
               

1. 搭建测试环境
  搭建测试环境步骤如下:
  1.搭建Web服务器。IIS,Apatch, Apache Tomcat 6
  2.发布项目,将项目布署到Web服务器中。
  3.修改combinbox.js中的上传地址,将上传地址改为项目的测试地址。
1.1. ACCESS示例

1.2. MySQL示例
  PHP示例:
  1.创建数据表,数据表脚本在xdb_files.sql中

  2.修改数据库配置信息

  3.修改上传地址。

1.5. 文件保存位置
  文件保存位置主要由HttpUploaderCfg.java,HttpUploaderCfg.cs,HttpUploaderCfg.php控制。
  路径格式:项目路径\upload\2013\04\15\md5.rar
  php代码截图:

2. 测试包布署说明
  1.将HttpUploader.cab,HttpUploader64.cab,HttpUploader.xpi,HttpUploader.crx上传到测试服务器中。
  2.修改HttpUploader.js文件中的配置信息。

  Firefox,Chrome,cab(x64)安装包布署方法:

3. 正式包布署说明
  1.将HttpUploader.cab,HttpUploader64.cab,HttpUploader.xpi,HttpUploader.crx上传到正式服务器中。
  2.修改HttpUploader.js文件中的配置信息。

  Firefox,Chrome,cab(x64)布署说明:



1.      搭建测试环境
  说明:
  简单的测试环境没有和数据库整合,和数据库整合的示例请看demo-db-gb2312
  搭建测试环境步骤如下:
  1.搭建Web服务器。IIS,Apatch, Apache Tomcat 6
  2.修改index.html上传地址
  
2.      整合到现有系统中
  主要步骤:
  1.      上传控件相关文件。一般是整个HttpUploader文件夹
  2.      修改cab文件下载地址
  3.      修改classid和codebase地址
  4.      设置服务器编码
  5.      修改文件上传地址
  6.      在引用页面调用
  
2.1.   上传控件相关文件
  上传HttpUploader文件夹
  asp.net//请根据项目类型上传相应的文件夹,如果是PHP项目则上传PHP文件夹,如果是ASP项目则上传asp文件夹
  HttpUploader
  说明:
  请不要手动解压HttpUploader.cab文件,请将完整的HttpUploader.cab文件上传到服务器中。IE浏览器会自动安装CAB。CAB文件相当于是一个自动安装控件的脚本。
  
2.2.   修改文件上传地址
  打开combinbox.js文件,找到Config配置代码
     this.Config = {
           "EncodeType"         : "GB2312"
           , "CompanyLicensed"    : "武汉命运科技有限公司"
           , "FileFilter"         : "*"//文件类型。所有类型:*。自定义类型:jpg,bmp,png,gif,rar,zip,7z,doc。设置允许上传的文件类型,使用英文逗号(,)分隔。
           , "FileSizeLimit"      : "0"//自定义允许上传的文件大小,以字节为单位。表示不限制。
           , "FilesLimit"         : 0//文件选择数限制。表示不限制
           , "AllowMultiSelect"   : 1//多选开关。:开启多选。:关闭多选
           , "RangeSize"          : 131072//文件块大小,以字节为单位。必须为64KB的倍数。推荐大小:128KB。
           , "AppPath"            : ""//网站虚拟目录名称。子文件夹web
           , "CabPath"            : "http://www.ncmem.com/products/http-uploader4/demo/HttpUploader.cab#version=2,7,41,55266"
           , "UrlCreate"          : "http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_create_fid.aspx"//在服务端创建一个文件信息标识地址。
           , "UrlPost"            : "http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_post.aspx"//文件块上传地址
           , "UrlProcess"         : "http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_process.aspx"//文件上传进度信息记录地址。
           , "UrlComplete"      : "http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_complete.aspx"//文件上传完成状态记录地址。
           , "UrlList"            : "http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_list.aspx"//文件列表地址(演示包含已上传完成的文件和未上传完成的文件)。
           , "UrlDel"             : "http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_del.aspx"//删除文件地址
           , "ClsidDroper"      : "1E7C9F05-406F-4de6-8348-53AD96A79600"
           , "ClsidUploader"      : "65D197E1-9CBC-441a-98BC-B6431C6E4617"
           , "ClsidPartition"   : "5412F8C8-BACE-430e-9BD8-4E75F0E21E03"
     };
  修改UrlCreate,UrlPost,UrlProcess,UrlComplete,UrlList,UrlDel。
  注意:
     Url必须为完整地址,请勿使用相对地址。
     UrlCreate = http://www.ncmem.com/upload.aspx//正确地址
     UrlCreate = /upload.aspx//错误地址
  如果希望使用相对地址,请参考自动拼接路径章节
  
2.3.   修改CAB文件下载地址
  打开combinbox.js文件,找到Config配置代码
     this.Config = {
           "EncodeType"         : "GB2312"
           , "CompanyLicensed"    : "武汉命运科技有限公司"
           , "FileFilter"         : "*"//文件类型。所有类型:*。自定义类型:jpg,bmp,png,gif,rar,zip,7z,doc。设置允许上传的文件类型,使用英文逗号(,)分隔。
           , "FileSizeLimit"      : "0"//自定义允许上传的文件大小,以字节为单位。表示不限制。
           , "FilesLimit"         : 0//文件选择数限制。表示不限制
           , "AllowMultiSelect"   : 1//多选开关。:开启多选。:关闭多选
           , "RangeSize"          : 131072//文件块大小,以字节为单位。必须为64KB的倍数。推荐大小:128KB。
           , "AppPath"            : ""//网站虚拟目录名称。子文件夹web
           , "CabPath"            : "http://www.ncmem.com/products/http-uploader4/demo/HttpUploader.cab#version=2,7,41,55266"
           , "UrlCreate"          : "http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_create_fid.aspx"//在服务端创建一个文件信息标识地址。
           , "UrlPost"            : "http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_post.aspx"//文件块上传地址
           , "UrlProcess"         : "http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_process.aspx"//文件上传进度信息记录地址。
           , "UrlComplete"      : "http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_complete.aspx"//文件上传完成状态记录地址。
           , "UrlList"            : "http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_list.aspx"//文件列表地址(演示包含已上传完成的文件和未上传完成的文件)。
           , "UrlDel"             : "http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_del.aspx"//删除文件地址
           , "ClsidDroper"      : "1E7C9F05-406F-4de6-8348-53AD96A79600"
           , "ClsidUploader"      : "65D197E1-9CBC-441a-98BC-B6431C6E4617"
           , "ClsidPartition"   : "5412F8C8-BACE-430e-9BD8-4E75F0E21E03"
     };
  
2.4.   修改classid和codebase地址
  打开combinbox.js文件,修改控件的classid及codebase地址。
     this.ActiveX = {
           "Uploader"    : "Xproer.HttpUploader4"//这里的Xproer要改为单独生成的名称。
           , "Partition" : "Xproer.HttpPartition4"//这里的Xproer要改为单独生成的名称。
     };
     this.Config = {
           "EncodeType"         : "GB2312"
           , "CompanyLicensed"    : "武汉命运科技有限公司"
           , "FileFilter"         : "*"//文件类型。所有类型:*。自定义类型:jpg,bmp,png,gif,rar,zip,7z,doc。设置允许上传的文件类型,使用英文逗号(,)分隔。
           , "FileSizeLimit"      : "0"//自定义允许上传的文件大小,以字节为单位。表示不限制。
           , "FilesLimit"         : 0//文件选择数限制。表示不限制
           , "AllowMultiSelect"   : 1//多选开关。:开启多选。:关闭多选
           , "RangeSize"          : 131072//文件块大小,以字节为单位。必须为64KB的倍数。推荐大小:128KB。
           , "AppPath"            : ""//网站虚拟目录名称。子文件夹web
           , "CabPath"            : "http://www.ncmem.com/products/http-uploader4/demo/HttpUploader.cab#version=2,7,41,55266"
           , "UrlCreate"          : "http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_create_fid.aspx"//在服务端创建一个文件信息标识地址。
           , "UrlPost"            : "http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_post.aspx"//文件块上传地址
           , "UrlProcess"         : "http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_process.aspx"//文件上传进度信息记录地址。
           , "UrlComplete"      : "http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_complete.aspx"//文件上传完成状态记录地址。
           , "UrlList"            : "http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_list.aspx"//文件列表地址(演示包含已上传完成的文件和未上传完成的文件)。
           , "UrlDel"             : "http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_del.aspx"//删除文件地址
           , "ClsidDroper"      : "1E7C9F05-406F-4de6-8348-53AD96A79600"
           , "ClsidUploader"      : "65D197E1-9CBC-441a-98BC-B6431C6E4617"
           , "ClsidPartition"   : "5412F8C8-BACE-430e-9BD8-4E75F0E21E03"
     };
  说明:
     为了避免与其它公司的控件产生冲突,每个控件的classid值都不相同。在购买产品后,我们会为每个公司单独生成序列号。
     当控件升级(版本号变化)或CAB文件地址更改,必须修改codebase的地址。否则用户的IE浏览器将无法正常加载控件。
     请确保codebase的地址与示例中的地址一致,version字符不能丢失,版本号中间不能有空格。
  如果公司名称是QQ,则ActiveX的ProjID如下:
  QQ.HttpUploader
  QQ.HttpPartition
  
2.5.   设置服务器编码
  打开HttpUploader.js文件,找到Config配置代码
     this.Config = {
           "EncodeType"         : "GB2312"
           , "CompanyLicensed"    : "武汉命运科技有限公司"
           , "FileFilter"         : "*"//文件类型。所有类型:*。自定义类型:jpg,bmp,png,gif,rar,zip,7z,doc。设置允许上传的文件类型,使用英文逗号(,)分隔。
           , "FileSizeLimit"      : "0"//自定义允许上传的文件大小,以字节为单位。表示不限制。
           , "FilesLimit"         : 0//文件选择数限制。表示不限制
           , "AllowMultiSelect"   : 1//多选开关。:开启多选。:关闭多选
           , "RangeSize"          : 131072//文件块大小,以字节为单位。必须为64KB的倍数。推荐大小:128KB。
           , "AppPath"            : ""//网站虚拟目录名称。子文件夹web
           , "CabPath"            : "http://www.ncmem.com/products/http-uploader4/demo/HttpUploader.cab#version=2,7,41,55266"
           , "UrlCreate"          : "http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_create_fid.aspx"//在服务端创建一个文件信息标识地址。
           , "UrlPost"            : "http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_post.aspx"//文件块上传地址
           , "UrlProcess"         : "http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_process.aspx"//文件上传进度信息记录地址。
           , "UrlComplete"      : "http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_complete.aspx"//文件上传完成状态记录地址。
           , "UrlList"            : "http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_list.aspx"//文件列表地址(演示包含已上传完成的文件和未上传完成的文件)。
           , "UrlDel"             : "http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_del.aspx"//删除文件地址
           , "ClsidDroper"      : "1E7C9F05-406F-4de6-8348-53AD96A79600"
           , "ClsidUploader"      : "65D197E1-9CBC-441a-98BC-B6431C6E4617"
           , "ClsidPartition"   : "5412F8C8-BACE-430e-9BD8-4E75F0E21E03"
     };
  修改EncodeType的值。EncodeType为文件上传页面的编码,此编码必须与网站保持一致。因为Http文件上传控件会根据此编码类型来对中文文件名称进行编码处理。示例如下:
  如果网站的编码是GB2312,EncodeType = "GB2312"
  如果网站的编码是UTF-8,EncodeType = "UTF-8"
  
2.6.   在页面中引用
  1.添加头文件
  2.添加引用代码
  
  在<head></head>标签中间添加下列代码
      <link href=&quot;css/HttpUploader.css&quot; type=&quot;text/css&quot; rel=&quot;Stylesheet&quot;/>
      <script type=&quot;text/javascript&quot; src=&quot;js/FileLister.js&quot;></script>
      <script type=&quot;text/javascript&quot; src=&quot;js/HttpUploader.js&quot;></script>
      <script type=&quot;text/javascript&quot; src=&quot;js/combinbox.js&quot;></script>
      <script type=&quot;text/javascript&quot; src=&quot;js/jquery-1.3.2.min.js&quot;></script>
      <script language=&quot;javascript&quot; type=&quot;text/javascript&quot;>
      var cbItemLast = null;
      var cbMgr = new CombinBoxMgr();
  
      $(document).ready(function()
      {
           cbMgr.LoadInControl(&quot;FilePanel&quot;);//在指定的DIV中加截控件
           cbMgr.Init();
      });
  </script>
  
  在<body></body>标签中间的适当位置添加下列代码:
  <div id=&quot;FilePanel&quot;></div>
  
3.      自动拼接路径
  如果域名会经常变动不是固定域名,可以使用自动拼接路径函数InitPath()来简化控件布署。
  以下示例演示如何使用自动拼接路径
  修改combinbox.js中的路径
     this.Config = {
           &quot;EncodeType&quot;       : &quot;UTF-8&quot;
           ,&quot;CompanyLicensed&quot; :&quot;武汉命运科技有限公司&quot;
           , &quot;FileFilter&quot;   : &quot;*&quot;//文件类型
           , &quot;AppPath&quot;      : &quot;&quot;//网站虚拟目录名称。子文件夹 web
           , &quot;CabPath&quot;      : &quot;HttpUploader/HttpUploader.cab#version=2,4,11,45688&quot;//CAB文件地址。使用自动拼接路径时只写CAB地址的相对路径。
           , &quot;PostUrl&quot;      : &quot;upload.aspx&quot;//文件上传路径,使用自动拼接路径时只写上传地址的相对路径
           , &quot;ClsidDroper&quot;    : &quot;4D2454F8-EB25-465f-B867-C2A3E9F3D4B4&quot;//拖拽控件
           , &quot;ClsidUploader&quot;: &quot;7AAE6FD3-C2F2-49d5-A790-1103848B3531&quot;//文件上传控件
           , &quot;ClsidPartition&quot; : &quot;6F3EB4AF-FC9C-4570-A686-88B4B427C6FE&quot;//文件选择控件
     };
  在Load函数中调用InitPath
     //在外部调用。
     this.Load = function()
     {
        this.InitPath();//自动拼接路径
      }
  
  在页面引用代码中设置AppPath值
  <script type=&quot;text/javascript&quot; language=&quot;javascript&quot;>
      var imgUploader = new ImageUploader();
      imgUploader.Config[&quot;AppPath&quot;] = &quot;/www/&quot;;//设置网站目录
     imgUploader.Load();
  
     window.onload = function()
     {
           imgUploader.Init();
     };
  </script>
  
  调用InitPath()后,PostUrl和CabPath将会被自动拼接成下列字符串
  PostUrl = http://www.ncmem.com/upload.aspx
  CabPath = http://www.ncmem.com/HttpUploader/HttpUploader.cab#version=2,4,11,45688
  
1.      控件升级
  一般情况下控件升级后只需要更新服务器的HttpUploader.cab文件和修改HttpUploader.js中的控件版本号。用户打开浏览器时IE会自动提示用户安装最新的控件。效果图如下:
  
  主要步骤如下:
  1.重新上传HttpUploader.cab文件
  2.修改HttpUploader.js中的控件版本号。
  
1.1.   重新上传HttpUploader.cab文件
  在控件升级后,我们会将最新的HttpUploader.cab文件发给开发人员。开发人员只需要将最新的HttpUploader.cab文件上传到服务器即可。
  
1.2.   修改HttpUploader.js中的控件版本号
  一般情况下,控件更新后版本号也会更新。在重新上传HttpUploader.cab后,需要修改控件的版本号。
  请找到类似以下代码后,修改version后面的版本号。
     this.Config = {
           &quot;EncodeType&quot;       : &quot;UTF-8&quot;
           ,&quot;CompanyLicensed&quot; :&quot;武汉命运科技有限公司&quot;//请勿修改此处授权名称,如果需要修改请与我们联系。
           , &quot;FileFilter&quot;   : &quot;*&quot;//文件类型。所有类型:*。自定义类型:jpg,png,gif,bmp
           , &quot;AllowMultiSelect&quot;: 0//多选开关。1:开启多选。0:关闭多选
           , &quot;AppPath&quot;      : &quot;&quot;//网站虚拟目录名称。子文件夹 web
           , &quot;CabPath&quot;      : &quot;http://www.ncmem.com/httpUploader/HttpUploader.cab#version=2,4,11,45688&quot;//CAB文件地址
           , &quot;PostUrl&quot;      : &quot;http://localhost:1591/asp.net/upload.aspx&quot;//文件上传路径
           , &quot;ClsidDroper&quot;    : &quot;4D2454F8-EB25-465f-B867-C2A3E9F3D4B4&quot;//拖拽控件
           , &quot;ClsidUploader&quot;: &quot;7AAE6FD3-C2F2-49d5-A790-1103848B3531&quot;//文件上传控件
           , &quot;ClsidPartition&quot; : &quot;6F3EB4AF-FC9C-4570-A686-88B4B427C6FE&quot;//文件选择控件
     };
  
2.      用户接口
2.1.   配置上传地址
  文件上传地址一般都在combinbox.js文件中配置
     this.Config = {
           &quot;EncodeType&quot;         : &quot;GB2312&quot;
           , &quot;CompanyLicensed&quot;    : &quot;武汉命运科技有限公司&quot;
           , &quot;FileFilter&quot;         : &quot;*&quot;//文件类型。所有类型:*。自定义类型:jpg,bmp,png,gif,rar,zip,7z,doc
           , &quot;FileSizeLimit&quot;      : &quot;0&quot;//自定义允许上传的文件大小,以字节为单位。表示不限制。
           , &quot;FilesLimit&quot;         : 0//文件选择数限制。表示不限制
           , &quot;AllowMultiSelect&quot;   : 1//多选开关。:开启多选。:关闭多选
           , &quot;RangeSize&quot;          : 131072//文件块大小,以字节为单位。必须为64KB的倍数。推荐大小:128KB。
           , &quot;AppPath&quot;            : &quot;&quot;//网站虚拟目录名称。子文件夹web
           , &quot;CabPath&quot;            : &quot;http://www.ncmem.com/products/http-uploader4/demo/HttpUploader.cab#version=2,7,41,55266&quot;
           , &quot;UrlCreate&quot;          : &quot;http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_create_fid.aspx&quot;//在服务端创建一个文件信息标识地址。
           , &quot;UrlPost&quot;            : &quot;http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_post.aspx&quot;//文件块上传地址
           , &quot;UrlProcess&quot;         : &quot;http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_process.aspx&quot;//文件上传进度信息记录地址。
           , &quot;UrlComplete&quot;      : &quot;http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_complete.aspx&quot;//文件上传完成状态记录地址。
           , &quot;UrlList&quot;            : &quot;http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_list.aspx&quot;//文件列表地址(演示包含已上传完成的文件和未上传完成的文件)。
           , &quot;UrlDel&quot;             : &quot;http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_del.aspx&quot;//删除文件地址
           , &quot;ClsidDroper&quot;      : &quot;1E7C9F05-406F-4de6-8348-53AD96A79600&quot;
           , &quot;ClsidUploader&quot;      : &quot;65D197E1-9CBC-441a-98BC-B6431C6E4617&quot;
           , &quot;ClsidPartition&quot;   : &quot;5412F8C8-BACE-430e-9BD8-4E75F0E21E03&quot;
     };
  
2.2.   设置服务器编码方式
  服务器编码设置一般都在combinbox.js文件中配置
     this.Config = {
           &quot;EncodeType&quot;         : &quot;GB2312&quot;//设置上传编码。必须与网站配置相同。建议在HttpUploader.js中设置,这样可以在多个页面引用,而不需要再次设置。
           , &quot;CompanyLicensed&quot;    : &quot;武汉命运科技有限公司&quot;
           , &quot;FileFilter&quot;         : &quot;*&quot;//文件类型。所有类型:*。自定义类型:jpg,bmp,png,gif,rar,zip,7z,doc
           , &quot;FileSizeLimit&quot;      : &quot;0&quot;//自定义允许上传的文件大小,以字节为单位。表示不限制。
           , &quot;FilesLimit&quot;         : 0//文件选择数限制。表示不限制
           , &quot;AllowMultiSelect&quot;   : 1//多选开关。:开启多选。:关闭多选
           , &quot;RangeSize&quot;          : 131072//文件块大小,以字节为单位。必须为64KB的倍数。推荐大小:128KB。
           , &quot;AppPath&quot;            : &quot;&quot;//网站虚拟目录名称。子文件夹web
           , &quot;CabPath&quot;            : &quot;http://www.ncmem.com/products/http-uploader4/demo/HttpUploader.cab#version=2,7,41,55266&quot;
           , &quot;UrlCreate&quot;          : &quot;http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_create_fid.aspx&quot;//在服务端创建一个文件信息标识地址。
           , &quot;UrlPost&quot;            : &quot;http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_post.aspx&quot;//文件块上传地址
           , &quot;UrlProcess&quot;         : &quot;http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_process.aspx&quot;//文件上传进度信息记录地址。
           , &quot;UrlComplete&quot;      : &quot;http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_complete.aspx&quot;//文件上传完成状态记录地址。
           , &quot;UrlList&quot;            : &quot;http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_list.aspx&quot;//文件列表地址(演示包含已上传完成的文件和未上传完成的文件)。
           , &quot;UrlDel&quot;             : &quot;http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_del.aspx&quot;//删除文件地址
           , &quot;ClsidDroper&quot;      : &quot;1E7C9F05-406F-4de6-8348-53AD96A79600&quot;
           , &quot;ClsidUploader&quot;      : &quot;65D197E1-9CBC-441a-98BC-B6431C6E4617&quot;
           , &quot;ClsidPartition&quot;   : &quot;5412F8C8-BACE-430e-9BD8-4E75F0E21E03&quot;
     };
  
2.3.   设置允许上传的文件类型
  文件上传地址一般都在combinbox.js文件中配置
     this.Config = {
           &quot;EncodeType&quot;         : &quot;GB2312&quot;
           , &quot;CompanyLicensed&quot;    : &quot;武汉命运科技有限公司&quot;
           , &quot;FileFilter&quot;         : &quot;*&quot;//文件类型。所有类型:*。自定义类型:jpg,bmp,png,gif,rar,zip,7z,doc。设置允许上传的文件类型,使用英文逗号(,)分隔。
           , &quot;FileSizeLimit&quot;      : &quot;0&quot;//自定义允许上传的文件大小,以字节为单位。表示不限制。
           , &quot;FilesLimit&quot;         : 0//文件选择数限制。表示不限制
           , &quot;AllowMultiSelect&quot;   : 1//多选开关。:开启多选。:关闭多选
           , &quot;RangeSize&quot;          : 131072//文件块大小,以字节为单位。必须为64KB的倍数。推荐大小:128KB。
           , &quot;AppPath&quot;            : &quot;&quot;//网站虚拟目录名称。子文件夹web
           , &quot;CabPath&quot;            : &quot;http://www.ncmem.com/products/http-uploader4/demo/HttpUploader.cab#version=2,7,41,55266&quot;
           , &quot;UrlCreate&quot;          : &quot;http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_create_fid.aspx&quot;//在服务端创建一个文件信息标识地址。
           , &quot;UrlPost&quot;            : &quot;http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_post.aspx&quot;//文件块上传地址
           , &quot;UrlProcess&quot;         : &quot;http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_process.aspx&quot;//文件上传进度信息记录地址。
           , &quot;UrlComplete&quot;      : &quot;http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_complete.aspx&quot;//文件上传完成状态记录地址。
           , &quot;UrlList&quot;            : &quot;http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_list.aspx&quot;//文件列表地址(演示包含已上传完成的文件和未上传完成的文件)。
           , &quot;UrlDel&quot;             : &quot;http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_del.aspx&quot;//删除文件地址
           , &quot;ClsidDroper&quot;      : &quot;1E7C9F05-406F-4de6-8348-53AD96A79600&quot;
           , &quot;ClsidUploader&quot;      : &quot;65D197E1-9CBC-441a-98BC-B6431C6E4617&quot;
           , &quot;ClsidPartition&quot;   : &quot;5412F8C8-BACE-430e-9BD8-4E75F0E21E03&quot;
     };
  
  假设我们设置允许上传的文件类型为jpg,bmp,png,gif,则效果图如下:
  
  
2.4.   设置允许上传的文件大小
  在线字节计算工具:http://www.beesky.com/newsite/bit_byte.htm
  允许上传的文件大小一般都在combinbox.js文件中配置
     this.Config = {
           &quot;EncodeType&quot;         : &quot;GB2312&quot;
           , &quot;CompanyLicensed&quot;    : &quot;武汉命运科技有限公司&quot;
           , &quot;FileFilter&quot;         : &quot;*&quot;//文件类型。所有类型:*。自定义类型:jpg,bmp,png,gif,rar,zip,7z,doc。设置允许上传的文件类型,使用英文逗号(,)分隔。
           , &quot;FileSizeLimit&quot;      : &quot;0&quot;//自定义允许上传的文件大小,以字节为单位。表示不限制。
           , &quot;FilesLimit&quot;         : 0//文件选择数限制。表示不限制
           , &quot;AllowMultiSelect&quot;   : 1//多选开关。:开启多选。:关闭多选
           , &quot;RangeSize&quot;          : 131072//文件块大小,以字节为单位。必须为64KB的倍数。推荐大小:128KB。
           , &quot;AppPath&quot;            : &quot;&quot;//网站虚拟目录名称。子文件夹web
           , &quot;CabPath&quot;            : &quot;http://www.ncmem.com/products/http-uploader4/demo/HttpUploader.cab#version=2,7,41,55266&quot;
           , &quot;UrlCreate&quot;          : &quot;http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_create_fid.aspx&quot;//在服务端创建一个文件信息标识地址。
           , &quot;UrlPost&quot;            : &quot;http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_post.aspx&quot;//文件块上传地址
           , &quot;UrlProcess&quot;         : &quot;http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_process.aspx&quot;//文件上传进度信息记录地址。
           , &quot;UrlComplete&quot;      : &quot;http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_complete.aspx&quot;//文件上传完成状态记录地址。
           , &quot;UrlList&quot;            : &quot;http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_list.aspx&quot;//文件列表地址(演示包含已上传完成的文件和未上传完成的文件)。
           , &quot;UrlDel&quot;             : &quot;http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_del.aspx&quot;//删除文件地址
           , &quot;ClsidDroper&quot;      : &quot;1E7C9F05-406F-4de6-8348-53AD96A79600&quot;
           , &quot;ClsidUploader&quot;      : &quot;65D197E1-9CBC-441a-98BC-B6431C6E4617&quot;
           , &quot;ClsidPartition&quot;   : &quot;5412F8C8-BACE-430e-9BD8-4E75F0E21E03&quot;
     };
  
2.5.   设置文件块大小
  在线字节计算工具:http://www.beesky.com/newsite/bit_byte.htm
  文件块大小一般都在combinbox.js文件中配置。
  一般情况下推荐设置为128KB,这是为了保证在网络环境不稳定的情况下,控件能够正常上传。如果用户的网络环境比较稳定,可适当调大这个值。
     this.Config = {
           &quot;EncodeType&quot;         : &quot;GB2312&quot;
           , &quot;CompanyLicensed&quot;    : &quot;武汉命运科技有限公司&quot;
           , &quot;FileFilter&quot;         : &quot;*&quot;//文件类型。所有类型:*。自定义类型:jpg,bmp,png,gif,rar,zip,7z,doc。设置允许上传的文件类型,使用英文逗号(,)分隔。
           , &quot;FileSizeLimit&quot;      : &quot;0&quot;//自定义允许上传的文件大小,以字节为单位。表示不限制。
           , &quot;FilesLimit&quot;         : 0//文件选择数限制。表示不限制
           , &quot;AllowMultiSelect&quot;   : 1//多选开关。:开启多选。:关闭多选
           , &quot;RangeSize&quot;          : 131072//文件块大小,以字节为单位。必须为64KB的倍数。推荐大小:128KB。
           , &quot;AppPath&quot;            : &quot;&quot;//网站虚拟目录名称。子文件夹web
           , &quot;CabPath&quot;            : &quot;http://www.ncmem.com/products/http-uploader4/demo/HttpUploader.cab#version=2,7,41,55266&quot;
           , &quot;UrlCreate&quot;          : &quot;http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_create_fid.aspx&quot;//在服务端创建一个文件信息标识地址。
           , &quot;UrlPost&quot;            : &quot;http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_post.aspx&quot;//文件块上传地址
           , &quot;UrlProcess&quot;         : &quot;http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_process.aspx&quot;//文件上传进度信息记录地址。
           , &quot;UrlComplete&quot;      : &quot;http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_complete.aspx&quot;//文件上传完成状态记录地址。
           , &quot;UrlList&quot;            : &quot;http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_list.aspx&quot;//文件列表地址(演示包含已上传完成的文件和未上传完成的文件)。
           , &quot;UrlDel&quot;             : &quot;http://localhost:1591/asp.net/demo-db-gb2312/db/ajax_del.aspx&quot;//删除文件地址
           , &quot;ClsidDroper&quot;      : &quot;1E7C9F05-406F-4de6-8348-53AD96A79600&quot;
           , &quot;ClsidUploader&quot;      : &quot;65D197E1-9CBC-441a-98BC-B6431C6E4617&quot;
           , &quot;ClsidPartition&quot;   : &quot;5412F8C8-BACE-430e-9BD8-4E75F0E21E03&quot;
     };
  
4.4.   设置附加信息

附加信息的作用就是在上传图片的同时向服务器提交额外的字段信息。比如当用户向服务器上传截图时,服务器需要知道是哪位用户上传的截图,这时可以将用户ID添加到附加信息中,这样服务器在获取截图信息的同时也能够根据附加信息知道是哪位用户上传的截图。
客户端:
uploaderMgr.Fields[&quot;UserName&quot;] = &quot;test&quot;;
服务端:
string fname = Request.Form[&quot;UserName&quot;];
   
开发人员可以根据自已的业务需求来扩展附加信息:
客户端:
uploaderMgr.Fields[&quot;f1&quot;] = &quot;f1&quot;;
uploaderMgr.Fields[&quot;f2&quot;] = &quot;f2&quot;;
uploaderMgr.Fields[&quot;f3&quot;] = &quot;f3&quot;;
uploaderMgr.Fields[&quot;f4&quot;] = &quot;f4&quot;;
uploaderMgr.Fields[&quot;f5&quot;] = &quot;f5&quot;;
服务端(ASP.NET):
string f1 = Request.Form[&quot;f1&quot;];
string f1 = Request.Form[&quot;f2&quot;];
string f1 = Request.Form[&quot;f3&quot;];
string f1 = Request.Form[&quot;f4&quot;];
string f1 = Request.Form[&quot;f5&quot;];
   
4.5.   上传本地文件
请要步骤如下:
1.调用AddFile函数添加本地文件,注意路径需要使用双斜框(\\)
2.调用PostFirst函数开始上传文件。
<script type=&quot;text/javascript&quot; language=&quot;javascript&quot;>
    var uploaderMgr = new HttpUploaderMgr();
    uploaderMgr.Load();//加载控件
   
    window.onload = function()
    {
         uploaderMgr.Init();
         uploaderMgr.AddFile(&quot;D:\\Soft\\QQ2010.exe&quot;);
         uploaderMgr.PostFirst();
    };
</script>
   
5.      断点续传
HttpUploader会以POST方式每次向服务器提交128KB的文件数据和以下附加信息字段                   
字段名称                      
类型                      
长度                      
可能的值                      
说明                                
complete                      
string                      
5                      
true,false                      
表示文件数据块已传完                                
FileName                      
string                      
255                      
d:\\soft\\QQ2010.exe                      
上传的文件名称。包含本地文件路径。                                
FileSize                      
long                      
                      
1000                      
文件总大小,以字节为单位                                
RangePos                      
long                      
                      
0                      
文件块索引。服务根据此值来保存文件块数据。                                
md5                      
string                      
32                      
4b213776e6f72c3daa727524f8234115                      
文件MD5,用来验证服务器是否存在相同文件。             
   
如果开发人员希望用户关闭IE后再次打开IE时,用户仍然能够继续上传关闭IE前未上传完成的文件,开发人员应该将上面的相关信息保存在数据库中。在打开页面时从数据库读取数据然后调用AddResumeFile方法,添加需要续传的文件。
   
以下示例演示从100字节的位置开始续传QQ2010.exe文件   
<script type=&quot;text/javascript&quot; language=&quot;javascript&quot;>
    var uploaderMgr = new HttpUploaderMgr();
    uploaderMgr.Load();//加载控件
   
    window.onload = function()
    {
    uploaderMgr.Init();//初始化控件
         //添加续传文件
         uploaderMgr.AddResumeFile(&quot;D:\\Soft\\QQ2010.exe&quot;,&quot;100&quot;,&quot;10%&quot;,&quot;370aabaec9ef9a812fc665a617ee368b&quot;);
         uploaderMgr.PostFirst();
    }
</script>
     

1.      JavaScript对象
1.1.   HttpUploader对象
类型:JavaScript
文件上传对象的包装类,用户在实际的项目中只需要创建HttpUploader对象,然后通过HttpUploader对象就可以进行文件上传操作。
   
语法:
   
JavaScript(声明)   
function HttpUploader() { }
   
方法                           
                            
名称                            
说明                                           
                   
Ready                            
指示文件上传对象准备完毕                                           
                   
Post                            
开始上传文件                                           
                   
Stop                            
停止文件上传                                           
                   
PostNext                            
继续传输上传队列中的下一个文件                   

   
Ready方法
将上传任务状态设置为准备状态。
Post方法
开始上传文件。
说明:此函数将会自动实现断点续传功能。如果当前任务文件只上传了一半,则在下次开始时XSUploader组件将会自动定位到上次上传的位置继续上传数据。
Stop方法
停止上传任务。
PostNext方法
继续上传队列中下一个任务。
   
属性                           
                            
名称                            
说明                                           
                   
pMsg                            
消息对象。                                           
                   
pProcess                            
上传进度条对象                                           
                   
pPercent                            
上传进度百分比。                                           
                   
pButton                            
控制按钮                                           
                   
TimeOutID                            
定时器                                           
                   
Ext                            
文件扩展名。例:                                           
                   
LocalFile                            
不包含路径的文件名称。例:qq.exe                                           
                   
LocalFileName                            
包含完整路径的本地文件名称。例:C:\qq.exe                                           
                   
FileLength                            
文件大小。以字节为单位。            
1GB=1024MB            
1MB=1024KB            
1KB=1024byte                   

   
1.2.   HttpUploaderMgr对象
类型:JavaScript
上传文件管理类。
   
方法
AddFile方法
添加一个文件到上传对列中
语法:
void AddFile(fid);
参数:
   fid   
新上传任务的唯一文件ID,此ID用来区域不同的上传任务。
   
AddFeidl方法
   
AddResumeFile方法
添加一个续传文件。
语法:
this.AddResumeFile = function(filePath, postedLength, postedPercent, md5)
参数:
filePath
包含本地文件路径的文件名称。示例:D:\\Soft\\QQ2010.exe
postedLength
已上传文件大小(以字节为单位),即续传起点。示例:10020
说明:此值一般保存在数据库中。在页面加载时可从数据库读取此值然后传给控件。
postedPercent
已上传百分比。示例:50%
md5
文件MD5。一般从服务器读取。
   
PostFirst方法
开始上传队列中的第一个文件。
语法:
void PostFirst()
   
Exist方法
检查上传队列中是否存在指定文件。
说明:此函数是根据本地文件的完整路径来检测的。
bool Exist();
返回值:
   true   
表示存在。
   false   
不存在。
SetFileFilter方法
设置过滤的文件类型。
语法:
void SetFileFilter(filter)
参数:
   filter 文件类型字符串。由逗号分隔。示例:exe,jpg,php
   
属性
Fields属性
上传时附加的额外信息。
   
注意:此属性暂时不支持中文字符串。
   
以下示例演示上传时添加用户名和密码的额外信息:
var uploaderMgr = new HttpUploaderMgr();
uploaderMgr.Fields[&quot;UserName&quot;] = &quot;test&quot;;
uploaderMgr.Fields[&quot;UserPass&quot;] = &quot;test&quot;;
   
Config属性
提供全局配置信息。
   
语法:
   this.Config = {
   &quot;EncodeType&quot;: &quot;UTF-8&quot;
         ,&quot;CompanyLicensed&quot;:&quot;北京新颖网络&quot;
         , &quot;FileFilter&quot;: &quot;*&quot;//文件类型
         , &quot;AppPath&quot;: &quot;&quot;//网站虚拟目录名称。子文件夹 web
         , &quot;CabPath&quot;: &quot;/products/http-uploader/demo2/HttpUploader.cab#version=2,4,11,45688&quot;
         , &quot;PostUrl&quot;: &quot;/asp.net/upload.aspx&quot;
         , &quot;ClsidDroper&quot;: &quot;4D2454F8-EB25-465f-B867-C2A3E9F3D4B4&quot;
         , &quot;ClsidUploader&quot;: &quot;7AAE6FD3-C2F2-49d5-A790-1103848B3531&quot;
         , &quot;ClsidPartition&quot;: &quot;6F3EB4AF-FC9C-4570-A686-88B4B427C6FE&quot;
   };
   
EncodeType值
服务器编码方式。
此属性必须和web.config配置文件对应。
   
如果服务器端编码方式是UTF-8
<globalizationrequestEncoding=&quot;utf-8&quot;responseEncoding=&quot;utf-8&quot;/>
则客户端也必须是UTF-8
var uploaderMgr = new HttpUploaderMgr();
uploaderMgr.Config[&quot;EncodeType&quot;] = &quot;UTF-8&quot;;
   
如果服务端编码方式是GB2312
<globalizationrequestEncoding=&quot;gb2312&quot;responseEncoding=&quot;gb2312&quot;/>
则客户端也必须是GB2312
var uploaderMgr = new HttpUploaderMgr();
uploaderMgr.Config[&quot;EncodeType&quot;] = &quot;GB2312&quot;;
   
PostUrl值
接收处理上传文件的URL。
   
2.      ActiveX对象
2.1.   Xproer.HttpDroper对象
CLSID:7193B258-CA68-4eee-A64A-43C7E3BD1857
类型:ActiveX
文件拖放面板,为用户提供文件的拖放功能。
   
事件
OnFileDrop事件
文件拖放事件。当用户从资源管理器向拖放面板中拖放文件时此事件将会自动被调用。
   
示例
<HTML>
<HEAD>
<TITLE>New Page</TITLE>
</HEAD>
<BODY>
   
<OBJECT ID=&quot;FilePanel1&quot; WIDTH=192 HEIGHT=192 CLASSID=&quot;clsid: AF145FF6-EF91-4C91-BD85-D4ECCA224D27&quot; DATA=&quot;DATA:application/x-oleobject;BASE64,P0yJ/coEwUiWnGww8Tau4AADAADYEwAA2BMAAA==&quot;>
</OBJECT>
<div id=&quot;divFileLister&quot;></div>
<script language=&quot;javascript&quot; type=&quot;text/javascript&quot;>
   var obj = document.getElementById(&quot;FilePanel1&quot;);
   obj.OnFileDrop = EventFileDrop;
   function EventFileDrop()
   {
         var lister = document.getElementById(&quot;divFileLister&quot;);
         var list = obj.GetSelectedFiles();//获取选择的文件
         for (var index = list.lbound(1); index <= list.ubound(1); ++index)
         {
            lister.innerHTML += &quot;<p>文件名:&quot; + list.getItem(index) + &quot;</p>&quot;;
         }
   }
</script>
</BODY>
</HTML>
2.2.   Xproer.HttpPartition对象
CLSID:BC5E2E5D-49E2-4d34-A606-902640DB92AC
类型:ActiveX
多文件选择对象。弹出一个文件选择对话框,为用户提供选择多个文件的功能。
方法                           
                            
名称                            
说明                                           
                   
ShowDialog                            
弹出文件选择对话框                                           
                   
GetSelectedFiles                            
获取用户选择的文件列表                   

   
GetSelectedFiles方法
获取用户选择的文件列表数组。
   
属性                           
                            
名称                            
说明                                           
                   
FileFilter                            
允许上传的文件扩展名。使用逗号分隔不同类型名称。            
允许上传指定类型文件示例:jpg,gif,png,bmp,doc,exe,txt            
如果允许上传任意类型示例:*                   

   
   
示例
下面的代码示例将会创建一个文件选择框,并弹出用户所选择的文件名称。
   
JavaScript:   
<script type=&quot;text/javascript&quot; language=&quot;javascript&quot;>
   function ShowSelectFileDlg()
   {
         var manager = new HttpUploaderMgr();
         var obj = new ActiveXObject(manager.ActiveX[&quot;Partition&quot;]);;//创建文件选择对话框
   
         if (!obj.ShowDialog()) return;
         var list = obj.GetSelectedFiles();//获取用户选择的文件
         if (list == null) return;
         if (list.lbound(1) == null) return;
   
         for (var index = list.lbound(1); index <= list.ubound(1); index++)
         {
            if (!manager.Exist(list.getItem(index)))
            {
                   manager.AddFile(list.getItem(index));
            }
         }
         manager.PostFirst();
   }
</script>
2.3.   Xproer.HttpUploader对象
CLSID:33A128F3-9CA3-4a7f-A1FE-1DB6BF5156AA
类型:ActiveX
HTTP文件上传对象,负责文件具体的上传和续传工作。
   
属性                           
                            
类型                            
名称                            
说明                                           
                   
int                            
FileID                            
文件ID。必须唯一。                                           
                   
long                            
PostedLength                            
已上传的文件大小。以字节为单位。最大约为2G大小            
此参数主要提供给断点续传功能使用。            
如果指定了此参数,则控件将会从此位置处开始上传文件。                                           
                   
string                            
LocalFile                            
包含完整路径的本地文件名称。例:D:\QQ.exe                                           
                   
string                            
FileLength                            
文件大小,以字节为单件的字符串。                                           
                   
string                            
FileSize                            
文件大小,格式化后的文件大小字符串。示例:10MB,10.20MB,3KB                                           
                   
string                            
MD5                            
文件MD5值。一般在续传时用到。                   

   
事件                           
                            
名称                            
说明                                           
                   
OnComplete                            
在文件上传完成时发生                                           
                   
OnPost                            
每当向服务器传输成功一部分数据时发生                                           
                   
OnStop                            
在文件上传停止时发生                                           
                   
OnError                            
在文件上传出现错误时发生                   

   
OnComplete事件
传输完成事件,当文件成功上传完毕后,系统将会调用此方法   
参数:
   arguments
         文件ID。
OnPost事件
传输数据事件。每当HttpUploader插件成功向服务器传输二进制数据后将触发此事件。
参数:
obj
HttpUploader JS对象
speed
传输速度
postedLength
已上传字节
percent
已上传百分比。
time
剩余完成时间
   
OnStop事件
传输停止事件,当上传任务停止时系统将会自动调用此方法
参数:
arguments
文件ID。
OnError事件
传输错误事件,当传输出现错误时系统将会自动调用此事件。
参数:
arguments
文件ID。
arguments
错误码                           
0                            
连接服务器错误                                        
1                            
发送数据错误                                        
2                            
接收数据错误                                        
3                            
未设置本地文件                                        
4                            
本地文件不存在                                        
5                            
打开本地文件错误                                        
6                            
不能读取本地文件                                        
7                            
公司未授权                                        
8                            
未设置IP                                        
9                            
域名未授权                                        
10                            
文件大小超过限制                                        
200                            
无打打开文件                                        
201                            
文件大小为0                   

   
示例
下面的代码将会创建一个上传项,并将本地C盘下的myfile.txt文件上传到服务端,并以myfile.txt保存。
   
JavaScript   
var upFile = new FileUploader(1);//这里创建了一个文件上传任务,并将文件ID设置为1
upFile.ATL.PostUrl = &quot;http://www.ncmem.com/upload.aspx&quot;;//设置上传地址
upFile.ATL.LocalFileName = &quot;C:\\myfile.txt&quot;;//设置要上传的本地文件
//设置事件,这些事件必须设置,否则上传任务将无法执行
upFile.ATL.OnComplete = function() { }
upFile.ATL.OnPost = function() { }
upFile.ATL.OnStop = function() { }
upFile.ATL.OnError = function() { }
upFile.Post(); //开始上传
   
3.      UI模板
您可以根据实际需求来修改以下模板。
   
   
HTML:   
<div class=&quot;UploaderItem&quot; id=&quot;UploaderTemplate&quot;>
   <div class=&quot;UploaderItemLeft&quot;>
         <div class=&quot;FileName top-space&quot;>HttpUploader程序开发.pdf</div>
         <div class=&quot;ProcessBorder top-space&quot;>
            <div class=&quot;Process&quot;></div>
         </div>
         <div class=&quot;PostInf top-space&quot;>已上传:15.3MB 速度:20KB/S 剩余时间:10:02:00</div>
   </div>
   <div class=&quot;UploaderItemRight&quot;>
         <a class=&quot;Btn&quot; href=&quot;javascript:void(0)&quot;>取消</a>
         <div class=&quot;ProcessNum&quot;>35%</div>
   </div>
</div>
   
4.      HTML示例
以下示例将会弹出一个对话框并将用户选定的文件上传到服务器中。
   
JavaScript:   
<script type=&quot;text/javascript&quot; language=&quot;javascript&quot;>
    function ShowSelectFileDlg()
    {
      var manager = new HttpUploaderMgr();
      var obj = new ActiveXObject(manager.ActiveX[&quot;Partition&quot;]);
      if (!obj.ShowDialog()) return;//打开选择文件对话框
         
      var list = obj.GetSelectedFiles();//获取用户选择的文件
      if (list == null) return;
      if (list.lbound(1) == null) return;
      for (var index = list.lbound(1); index <= list.ubound(1); index++)
      {
         if (!manager.Exist(list.getItem(index)))
            {
                manager.AddFile(list.getItem(index));
            }
      }
      manager.PostFirst();
    }
</script>  
1.      PHP示例(demo-db-utf8)
  说明:
  由于PHP中没有int64类型,整型的最大范围只支持2147483648,所以只能支持2G以下文件的续传。因为续传文件时需要使用fseek函数来定位,fseek函数的第二个参数是int型,在PHP中int型的最大范围是2147483648,即2G,如果文件大小超过了2G,fseek就没办法定位。
      示例中的数据库访问模块是使用mysqli写的,所以需要在服务端开启mysqli.dll扩展支持。
  
  测试环境搭建步骤:
  1.创建xdb_files数据表。
  2.配置数据库访问信息。
  3.配置访问地址。
  4.服务端开启mysqli.dll扩展支持。
  
1.1.   文件说明
                             文件名称
                              描述
                                          db/ajax_complete.php
                              负责更新文件上传状态,为文件项设置已完成标志。
  引用位置:当文件上传完后由HttpUploader.js的HttpUploader_Complete函数中通过AJAX方式向此页面发送信息
                                          db/ajax_create_fid.php
                              负责向数据库添加新的文件项信息,并返回文件项的fid
  引用位置:文件MD5值计算完毕后在HttpUploader.js的HttpUploader_MD5_Complete中通过AJAX方向请求
                                          db/ajax_del.php
                              负责更新数据表中文件项的删除状态,为文件项设置已删除标志。
  引用位置:在FileLister.js的FileItemRemove函数中引用
                                          db/ajax_list.php
                              负责列出所有未完成的文件列表。
  引用位置:在FileLister.js的LoadData函数中引用。
                                          db/ajax_post.php
                              负责接收上传控件上传的文件块,并将文件块拼接成完整文件,同时更新数据库中的文件项进度信息。
  引用位置:在HttpUploader.js的HttpUploader中创建,并将此页面传给HTTP断点续传控件。
                                          db/FileDown.class.php
                              文件断点下载类
                                          db/FileDown.php
                              文件断点下载页面。
                                          db/FileResumer.php
                              负责对文件块进行拼接操作。
                                          db/HttpUploaderConfig.php
                              文件上传目录配置文件。负责创建上传文件夹。
                                          db/HttpUploaderDB.php
                              数据库操作类。
                                          HttpUploader/combinbox.js
                              组合框组件,封装了文件列表和文件上传列表。
                                          HttpUploader/FileLister.js
                              文件列表组件。
                                          HttpUploader/HttpUploader.js
                              文件上传列表组件。
                                          HttpUploader/jquery-1.3.2.min.js
                              JQuery压缩文件。
                   
  
1.2.   xdb_files数据表
                             字段名称
                              类型
                              长度
                              描述
                                          fid
                              自动编号
                              
                              文件ID,唯一。
                                          uid
                              int
                              
                              用户ID
                                          FileNameLocal
                              varchar
                              255
                              文件在本地电脑中的名称。例:QQ.exe
                                          FileNameRemote
                              varchar
                              255
                              文件在服务器中的名称。一般为文件MD5+扩展名。
                                          FilePathLocal
                              varchar
                              512
                              文件在本地电脑中的完整路径。
  示例:D:\Soft\QQ.exe
                                          FilePathRemote
                              varchar
                              512
                              文件在服务器中的完整路径。
  示例:F:\ftp\user1\QQ2012.exe
                                          FilePathRelative
                              varhcar
                              512
                              文件在服务器中的相对路径。
  示例:/www/web/upload/QQ2012.exe
                                          FileMD5
                              varchar
                              32
                              文件MD5
                                          FileLength
                              int
                              
                              文件总长度。以字节为单位
                                          FileSize
                              varchar
                              10
                              格式化的文件尺寸。示例:10MB
                                          FilePos
                              int
                              
                              文件续传位置。
  2G大小
                                          PostedLength
                              int
                              
                              已上传长度。以字节为单位。
  2G大小
                                          PostedPercent
                              varchar
                              6
                              已上传百分比。示例:10%
                                          PostComplete
                              tinyint
                              1
                              是否已上传完毕。
                                          PostedTime
                              datetime
                              
                              文件上传时间
                                          IsDeleted
                              tinyint
                              1
                              是否已删除。
                   
  
  MySQL创建语句
  CREATE TABLE `xdb_files` (
  `fid` int(11) NOT NULL auto_increment,
  `uid` int(11) NOT NULL,
  `FileNameLocal` varchar(255) NOT NULL,
  `FileNameRemote` varchar(255) NOT NULL,
  `FilePathLocal` varchar(512) NOT NULL,
  `FilePathRemote` varchar(512) NOT NULL,
  `FilePathRelative` varchar(512) NOT NULL,
  `FileMD5` varchar(32) NOT NULL,
  `FileLength` int(11) NOT NULL,
  `FileSize` varchar(10) NOT NULL,
  `FilePos` int(11) NULL default 0,
  `PostedLength` int(11) NULL default 0,
  `PostedPercent` varchar(6) NULL default '0%',
  `PostComplete` tinyint(1) NULL default 0,
  `PostedTime` timestamp NULL default CURRENT_TIMESTAMP on update CURRENT_TIMESTAMP,
  `IsDeleted` tinyint(1) NULL default 0,
  PRIMARY KEY(`fid`)
  ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='HttpUploader文件表' AUTO_INCREMENT=1 ;
  
  
1.3.   创建xdb_files数据表
  在MySQL中创建数据表
  CREATE TABLE `xdb_files` (
  `fid` int(11) NOT NULL auto_increment,
  `uid` int(11) NOT NULL,
  `FileNameLocal` varchar(255) NOT NULL,
  `FileNameRemote` varchar(255) NOT NULL,
  `FilePathLocal` varchar(512) NOT NULL,
  `FilePathRemote` varchar(512) NOT NULL,
  `FilePathRelative` varchar(512) NOT NULL,
  `FileMD5` varchar(32) NOT NULL,
  `FileLength` int(11) NOT NULL,
  `FileSize` varchar(10) NOT NULL,
  `FilePos` int(11) NULL default 0,
  `PostedLength` int(11) NULL default 0,
  `PostedPercent` varchar(6) NULL default '0%',
  `PostComplete` tinyint(1) NULL default 0,
  `PostedTime` timestamp NULL default CURRENT_TIMESTAMP on update CURRENT_TIMESTAMP,
  `IsDeleted` tinyint(1) NULL default 0,
  PRIMARY KEY(`fid`)
  ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='HttpUploader文件表' AUTO_INCREMENT=1 ;
  
1.4.   配置数据库访问信息
  打开文件php/demo-db-utf8/db/HttpUploaderDB.php,为下列参数设置正确的值
     function __construct()
     {
        $this->m_DbName = &quot;ultrax&quot;;//数据库名称
           $this->m_TableName = &quot;xdb_files&quot;;//数据表名称
           $this->m_Host = &quot;localhost&quot;;//数据库地址
           $this->m_UserName = &quot;root&quot;;//管理员帐号
           $this->m_UserPass = &quot;&quot;;//密码
     }
  
1.5.   配置访问地址
  打开文件php/demo-db-utf8/HttpUploader/combinbox.js,找到Config属性代码,设置正确的地址。
     this.Config = {
           &quot;EncodeType&quot;         : &quot;UTF-8&quot;
           , &quot;CompanyLicensed&quot;    : &quot;武汉命运科技有限公司&quot;
           , &quot;FileFilter&quot;         : &quot;*&quot;//文件类型
           , &quot;AllowMultiSelect&quot;   : 1//多选开关。1:开启多选。0:关闭多选
           , &quot;AppPath&quot;            : &quot;&quot;//网站虚拟目录名称。子文件夹 web
           , &quot;CabPath&quot;            : &quot;http://www.ncmem.com/products/http-uploader4/demo/HttpUploader.cab#version=2,5,19,54681&quot;
           , &quot;UrlCreate&quot;          : &quot;http://localhost:81/httpuploader3/db/ajax_create_fid.php&quot;//MD5验证地址
           , &quot;UrlPost&quot;            : &quot;http://localhost:81/httpuploader3/db/ajax_post.php&quot;//文件上传地址
           , &quot;UrlComplete&quot;      : &quot;http://localhost:81/httpuploader3/db/ajax_complete.php&quot;//上传完成后更新服务器信息地址
           , &quot;UrlList&quot;            : &quot;http://localhost:81/httpuploader3/db/ajax_list.php&quot;//从服务器获取文件列表地址
           , &quot;UrlDel&quot;             : &quot;http://localhost:81/httpuploader3/db/ajax_del.php&quot;//从服务器删除文件地址
           , &quot;ClsidPartition&quot;   : &quot;A6E74589-C2C6-48a2-B39E-B6C6A1A03AF0&quot;
           , &quot;ClsidDroper&quot;      : &quot;5A382701-5FCC-4aeb-B301-E365F7138FDB&quot;
           , &quot;ClsidUploader&quot;      : &quot;EC049103-5ABF-47fc-A8C9-7C48BB864449&quot;
     };
  
1.6.   与现有系统整合-将文件与用户ID对应
  主要步骤如下:
  1.在引用页面设置CombinBoxMgr.Fields的值
  2.在HttpUploader.js的HttpUploader_MD5_Complete方法中增加Fields属性
  3.在ajax_create_fid.jsp页面中接收附加信息
  
  在combinbox.js文件中有一个字段Fields属性,可通过扩展这个属性的字段向服务器上传特殊标识信息
     //附加参数
     this.Fields = {
           &quot;UserName&quot;: &quot;test&quot;
           , &quot;UserPass&quot;: &quot;test&quot;
           ,&quot;uid&quot;:0//可以设置这个属性的值
           ,&quot;fid&quot;:0
     };
  
  1.在引用页面可以设置uid的值
  <script language=&quot;javascript&quot; type=&quot;text/javascript&quot;>
      var cbItemLast = null;
      var cbMgr = new CombinBoxMgr();
  cbMgr.Fields[&quot;uid&quot;] = 2;//在这里可以设置为当前用户ID的值
  //也可以动态添加其它字段
  cbMgr.Fields[&quot;Category&quot;] = &quot;soft&quot;;
  
      $(document).ready(function()
      {
           cbMgr.LoadInControl(&quot;FilePanel&quot;);
           cbMgr.Init();
      });
      </script>
  
  2.在HttpUploader.js的HttpUploader_MD5_Complete方法中增加Fields属性
  //MD5计算完毕
  function HttpUploader_MD5_Complete(obj)
  {
     var md5 = obj.ATL.MD5;
     obj.MD5 = md5;
     //在此处增加服务器验证代码。
     obj.pMsg.innerText = &quot;MD5计算完毕,开始连接服务器...&quot;;
  
     $.ajax({
           type: &quot;POST&quot;
           , url: obj.Config[&quot;UrlCreate&quot;]
           , data: { md5: obj.MD5, uid: obj.Fields[&quot;uid&quot;], fileLength: obj.FileLength, fileSize: obj.FileSize, pathLocal: obj.PathLocal, time: Date() }
           , success:
           function(msg)
           {
              var json = eval(msg)
              json = json;
              obj.fid = json.fid;
              obj.ResetFields();
              //服务器已存在相同文件,且已上传完成
              if (&quot;True&quot; == json.PostComplete)
              {
                     obj.QuickComplete();
              } //服务器文件没有上传完成
              else
              {
                     obj.ATL.PostedLength = json.PostedLength;
                     obj.pProcess.style.width = json.PostedPercent;
                     obj.pPercent.innerText = json.PostedPercent;
                     obj.Upload();
              }
           }
        , error: function() { alert(&quot;向服务器发送MD5信息错误!&quot;); }
  
     });
  }
  
  3.在ajax_create_fid.php中接收附加信息值
  $uid = $_POST['md5'];
页: [1]
查看完整版本: HTTP断点续传控件-PHP开发文档-Xproer.HttpUploader5