《Ext详解与实践》节选：文件上传
Ext没提供上传组件？很多人都会有这疑问。
其实Ext.form.TextField就是Ext的上传组件的，只要将其配置参数inputType设置为“file”就行了。上传文件除了文件输入框，还有一个重要的设置，就是需要将form的enctype属性设置为“multipart/form-data”。这个也很简单，在定义FormPanel的时候加入BasicForm的配置参数fileUpload，并设置为true就行了。
在Ext中使用标准上传方式最大的缺点就是文件输入框的宽度很难控制，与界面不是太协调，而且在不同浏览器中的显示是不同的。在Ext官方论坛中有很多替代办法，笔者比较喜欢的是SWFUpload。
SWFUpload使用Flash作为上传组件，文件选择可以设置为单选，也可以设置多选，而且可以控制选择文件的类型。执行文件选择不依赖于标准文件输入框，可以使用按钮、链接等多种方式执行，从而可以根据需要设置界面。SWFUpload的提交不依赖Form，其模式类似于Ajax提交，可以很容易的实现对上传的控制和显示上传进度。
SWFUpload的官方地址是：http://www.swfupload.org/。
在SWFUpload中有两个主要对象：file和Stats。
file对象主要是保存文件的一些基本信息，其结构如下：
- {
- id : string, // SWFUpload 的文件编号，作为开始上传、取消上传的句柄
- index : number, // 文件在上传队列中的索引
- name : string, // 文件名，不包含路径
- size : number, // 文件大小，单位为字节
- type : string, // 文件类型
- creationdate : Date, // 文件创建日期
- modificationdate : Date, // 文件最后编辑日期
- filestatus : number, // 文件状态
- }
Stats对象主要提供上传队列中的信息，其结构如下：
- {
- in_progress : number // 1表示正在上传文件，0表示则不是
- files_queued : number // 上传队列中的文件数量
- successful_uploads : number // 已成功上传的文件数量
- upload_errors : number // 上传失败的文件数量
- upload_cancelled : number // 取消上传的文件数量
- queue_errors : number // 触发了fileQueueError事件的文件数量
- }
表1列出了SWFUpload的主要配置参数。
表2列出了SWFUpload的主要方法。
要使用SWFUpload，需要在页面加载swfupload.js文件并设置好参数，尤其要注意Flash文件的路径。具体使用方法请看下面例子：
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
- <html debug='true'>
- <head>
- <title>上传文件</title>
- <meta http-equiv="content-type" content="text/html; charset=utf-8">
- <link rel="stylesheet" type="text/css" href="../lib/ext/resources/css/ext-all.css" />
- <script type="text/javascript" src="../lib/ext/ext-base.js"></script>
- <script type="text/javascript" src="../lib/ext/ext-all.js"></script>
- <script type="text/javascript" src="../lib/ext/radiogroup.js"></script>
- <script type="text/javascript" src="../lib/ext/locale/ext-lang-zh_CN.js"></script>
- <script type="text/javascript" src="swfupload.js"></script>
- </head>
- <body>
- <h1 style="margin:20px 0px 0px 20px;">第4章 上传文件</h1>
- <br />
- <div style="padding-left:20px;">
- <p>
- <div id="form1"></div><br>
- <div >执行操作：</div>
- <textarea id='op' rows="10" style="width:800px;"></textarea>
- </p>
- <br />
- </div>
- <script>
- var app={};
- var swfu;
- Ext.onReady(function(){
- Ext.QuickTips.init();
- Ext.form.Field.prototype.msgTarget = 'under';
- swfu=new SWFUpload({
- upload_url : "upload.ashx",
- flash_url : "swfupload_f9.swf" ,
- file_size_limit : "10240",
- file_types : "*.jpg;*.gif",
- file_post_name : "Filedata",
- requeue_on_error : false,
- post_params : {},
- file_types_description:'图片',
- flash_color : "#FFFFFF",
- file_queued_handler : function(file){
- var filetype=(file.type.substr(1)).toUpperCase();
- if(filetype=='JPG' | filetype=='GIF'){
- swfu.startUpload();
- }else{
- Ext.Msg.alert('错误','只能上传JPG或GIF格式文件')
- }
- },
- upload_start_handler:function(file){Ext.Msg.progress('上传文件','正在上传文件：'+file.name,'0%');return true;},
- upload_progress_handler:function(file,bytesloaded){
- var percent = Math.ceil((bytesloaded / file.size) * 100);
- Ext.Msg.updateProgress(percent/100,percent+'%');
- },
- upload_success_handler:function(file, server_data){
- var msg=Ext.decode(server_data);
- if(msg){
- if(msg.success){
- Ext.getCmp('imagePane').body.dom.innerHTML="<img width='100' src='upload/"+msg.file+"'>"
- Ext.get('op').dom.value+="----------------------------/n"
- +"执行回调函数：success/n"
- +"返回值："+server_data+'/n';
- var stats=swfu.getStats();
- if(stats.files_queued>0)
- swfu.startUpload();
- Ext.Msg.hide();
- }else{
- Ext.Msg.alert('错误',msg.msg);
- }
- }else{
- Ext.Msg.alert('错误','上传错误！')
- }
- },
- upload_error_handler:function(file,error_code,message){
- Ext.Msg.alert('错误','上传文件“'+file.name+'”发生错误。<br>错误代码：'+error_code+'<br>'+'错误信息：'+message);
- },
- file_queue_error_handler:function(file,error_code,message){
- switch (error_code) {
- case SWFUpload.QUEUE_ERROR.FILE_EXCEEDS_SIZE_LIMIT:
- Ext.Msg.alert('错误',"文件不允许超过300k！<br> 文件名: " + file.name + "<br> 大小: " + file.size );
- break;
- case SWFUpload.QUEUE_ERROR.ZERO_BYTE_FILE:
- Ext.Msg.alert('错误',"不允许上传0字节文件！<br> 文件名: " + file.name + "<br> 大小: " + file.size );
- break;
- case SWFUpload.QUEUE_ERROR.QUEUE_LIMIT_EXCEEDED:
- Ext.Msg.alert('错误',"已超出上传文件数量！<br> 文件名: " + file.name + "<br> 大小: " + file.size );
- break;
- case SWFUpload.QUEUE_ERROR.INVALID_FILETYPE:
- Ext.Msg.alert('错误',"不允许上传该类文件！<br> 文件名: " + file.name + "<br> 大小: " + file.size );
- break;
- default:
- Ext.Msg.alert('错误',"发生未知错误，错误代码:"+error_code+"！<br> 文件名: " + file.name + "<br> 大小: " + file.size );
- break;
- }
- }
- });
- var frm = new Ext.form.FormPanel({
- applyTo: "form1",
- width: 400,
- height:300,
- frame: true,
- labelWidth:80,
- labelSeparator:"：",
- title:'上传文件',
- fileUpload:true,
- items:[
- {
- xtype:'textfield',
- name:'title',
- fieldLabel:'标题',
- anchor:'-30',
- allowBlank:false
- },
- {
- xtype:'textfield',
- name:'Filedata',
- fieldLabel:'文件',
- anchor:'-30',
- allowBlank:false,
- inputType:'file'
- },
- {layout:'column',border:false,items:[
- {columnWidth:.4,border:false,items: [
- {
- xtype:'button',
- text:'上传文件',
- handler:function(){
- swfu.setPostParams({title:frm.form.findField("title").getValue()});
- swfu.selectFile();
- }
- }
- ]},
- {columnWidth:.1,border:false,items: [
- {xtype:'panel',html:' ',height:26,border:false}
- ]},
- {columnWidth:.4,layout: 'form',border:false,items: [
- {
- xtype:'button',
- text:'上传多个文件',
- handler:function(){
- swfu.setPostParams({title:frm.form.findField("title").getValue()});
- swfu.selectFiles();
- }
- }
- ]}
- ]},
- {
- xtype:'panel',
- id:'imagePane',
- bodyStyle:'padding:5px',
- html:' ',
- height:120,
- width:120
- }
- ],
- buttons: [{
- text: '保存',
- scope:this,
- handler:function(){
- if(frm.form.isValid()){
- frm.form.doAction('submit',{
- waitTitle:'上传文件',
- waitMsg:'正在上传文件……',
- url:'upload.ashx',
- method:'post',
- params:'',
- success:function(form,action){
- Ext.getCmp('imagePane').body.dom.innerHTML="<img width='100' src='upload/"+action.result.file+"'>"
- Ext.get('op').dom.value+="----------------------------/n"
- +"执行回调函数：success/n"
- +"返回值："+Ext.encode(action.result)+'/n';
- },
- failure:function(form,action){
- Ext.get('op').dom.value+="----------------------------/n"
- +"执行回调函数：failure/n"
- +"返回值："+Ext.encode(action.result)+'/n';
- }
- });
- }
- }
- },{
- text: '取消',
- scope:this,
- handler:function(){frm.form.reset();}
- }],
- listeners:{
- render:function(fp){
- fpfp.form.waitMsgTarget = fp.getEl();
- }
- }
- });
- })
- </script>
- </body>
- </html>
例子中使用了两种方式实现文件上传，一种是标准方式，使用Form提交，一种使用SWFUpload。
标准方式的定义比较简单，在FormPanel定义中加入fileUpload参数并设置为true，然后将一个TextField的inputType设置为file就行了。保存的提交方式与一般的Form提交没什么区别。
SWFUpload的定义稍微复杂一点。首先在onReady函数外定义了一个swfu的全局变量，主要目的是使swfu成为一个全局的SWFUpload实例，以便在内部函数中能使用该实例。
本例子使用的Flash 9版本，而且swf文件与页面文件在同一目录，所以设置flash_url为swfupload_f9.swf。允许上传的文件大小限制为10兆，只能上传JPG和GIF文件，服务器端接收文件的参数名称为Filedata。
在file_queued_handler函数中先判别上传文件的扩展名是否符合要求，如果符合则执行startUpload方法开始上传文件。
upload_start_handler函数在文件开始时显示一个Ext进度条。
upload_progress_handler函数则根据已上传字节数计算上传进度并更新进度条。
upload_success_handler函数根据服务器端返回信息更新页面显示，并判断上传队列中是否还有文件未上传，如果有则继续上传。
upload_error_handler函数与file_queue_error_handler函数则在发生错误时显示错误信息。
在FormPanel中有两个按钮，一个用来演示上传单文件，一个用来演示上传多文件。单击后先根据标题输入框的值，设置一个附加提交参数title，然后执行selectFile方法或selectFiles方法打开文件选择对话框。对话框关闭后执行file_queued_handler函数开始上传文件。
文件上传后会在id为“'imagePane'”的Panel显示上传图片的缩略图。执行操作中也会显示返回的结果。
下面看看服务器端代码如下：
- <%@ WebHandler Language="C#" Class="upload" %>
- using System;
- using System.Web;
- using System.Collections;
- using System.IO;
- using System.Data.Common;
- using System.Data;
- public class upload : IHttpHandler {
- public void ProcessRequest (HttpContext context) {
- string outputStr = "{success:false,data:''}";
- HttpPostedFile jpeg_image_upload = context.Request.Files["Filedata"];
- string title= context.Request.Form["title"];
- string original_fielname = jpeg_image_upload.FileName.ToLower();
- string extname=original_fielname.Substring(original_fielname.LastIndexOf(".")+1,3);
- if (extname == "gif" | extname == "jpg")
- {
- try
- {
- string path = context.Server.MapPath("./upload");
- DateTime dt = DateTime.Now;
- string newFilename = dt.ToString("yyyyMMddHHmmssfff")+"."+extname;
- jpeg_image_upload.SaveAs(path+"//"+newFilename);
- outputStr = string.Format("{{success:true,data:'文件“{0}”上传成功，文件名：{1}',file:'{1}'}}",title,newFilename);
- }
- catch(Exception e)
- {
- outputStr = string.Format("{{success:false,data:'{0}'}}",e.Message);
- }
- }
- else
- {
- outputStr = "{success:false,data:'错误的文件类型！'}";
- }
- context.Response.Write(outputStr);
- }
- public bool IsReusable {
- get {
- return false;
- }
- }
- }
一个很简单的只接收单文件的服务器端代码。代码中使用了客户端设置的参数Filedata接受文件数据：
|
HttpPostedFile jpeg_image_upload = context.Request.Files["Filedata"];
|
代码中对文件扩展名进行了判断，如果是GIF或JPG则保存文件，否则返回错误。服务器端返回格式使用了Ext的返回格式。
图1是例子的运行结果。
先测试标准方式上传，在标题输入测试，然后单击“选择”按钮选择一幅图片，单击保存按钮。
图2是文件上传后的显示。
根据返回值，参数title和文件都已成功上传。
继续单击“上传文件”按钮选择一幅图片。当选择文件窗口关闭，会出现一个进度条，可能会是一闪而过，看看返回值：
|
----------------------------
执行回调函数：success
返回值：{success:true,data:'文件“测试”上传成功，文件名：20080730174659265.jpg',file:'20080730174659265.jpg'}
|
参数titile与文件也同样正确上传。
可以继续单击“上传多个文件”测试上传多个文件的情况，这里就不再赘述了。
SWFUpload和标准模式不同，上传多个文件时是一个一个的文件上传的，而不是标准模式使用不同的参数同时上传。
SWFUpload最大的缺点是受浏览器Flash插件版本的限制，低于版本8的Flash插件不起作用。如果使用版本9的swf文件，则需要Flash插件版本为9以上才能用。