基於MVC4+EasyUI的Web開發框架造成之旅--附件上傳組件uploadify的使用

時間 2020-01-16

標籤基於 mvc4+easyui mvc easyui web 開發框架造成之旅附件上傳組件 uploadify 使用欄目 HTML 简体版

原文原文鏈接

大概一年前，我還在用Asp.NET開發一些行業管理系統的時候，就曾經使用這個組件做爲文件的上傳操做，在隨筆《Web開發中的文件上傳組件uploadify的使用》中能夠看到，Asp.NET中如何使用這個組件進行文件上傳的，當時上傳文件的處理主要也是使用ashx通常處理程序來進行處理的。本文主要介紹個人Web開發框架中，在MVC4的環境中如何集成這個很是棒的文件上傳組件的。javascript

一、上傳組件uploadify的說明及腳本引用

Uploadify 是 JQuery 一個著名的上傳插件，利用 Flash 技術，Uploadify 越過瀏覽器的限制，控制了整個上傳的處理過程，實現了客戶端無刷新的文件上傳，這樣就實現了在客戶端的上傳進度控制，因此，你首先要肯定瀏覽器中已經安裝了 Adobe 的 Flash 插件。
Uploadify 當前有兩個版本，基於 Flash 是免費的，還有基於 HTML5 的收費版，咱們使用免費版，當前版本爲v3.2.1。css

這個組件須要Jquery庫的支持，通常狀況下，須要添加Jquery的js庫，以下所示html

<script type="text/javascript" src="~/Scripts/jquery-2.0.3.min.js"></script>

不過因爲個人Web開發框架是基於EasyUI的，通常在網頁的開始就會引用相關的類庫，已經包含了Jquery的類庫了，以下所示。java

    @*添加Jquery，EasyUI和easyUI的語言包的JS文件*@
    <script type="text/javascript" src="~/Content/JqueryEasyUI/jquery.min.js"></script>
    <script type="text/javascript" src="~/Content/JqueryEasyUI/jquery.easyui.min.js"></script>
    <script type="text/javascript" src="~/Content/JqueryEasyUI/locale/easyui-lang-zh_CN.js"></script>

因此咱們只須要添加Javascript類庫（jquery.uploadify.js），另外加上他的樣式文件（uploadify.css）便可：jquery

    @*添加對uploadify控件的支持*@
    @*<script type="text/javascript" src="~/Scripts/jquery-2.0.3.min.js"></script>*@
    <script type="text/javascript" src="~/Content/JQueryTools/uploadify/jquery.uploadify.js"></script>
    <link href="~/Content/JQueryTools/uploadify/uploadify.css" rel="stylesheet" type="text/css" />

二、上傳組件uploadify在Web界面的使用

首先咱們須要在HTML代碼中放置兩個控件，一個是用來上傳的控件，一個是用來顯示已上傳列表的控件，還有就是添加上傳和取消上傳的按鈕操做，以下所示。瀏覽器

 <tr>
                        <th>
                            <label for="Attachment_GUID">附件上傳：</label>
                        </th>
                        <td>                            
                            <div>
                                <input class="easyui-validatebox" type="hidden" id="Attachment_GUID" name="Attachment_GUID" />
                                <input id="file_upload" name="file_upload" type="file" multiple="multiple">
                                <a href="javascript:void(0)" class="easyui-linkbutton" id="btnUpload" data-options="plain:true,iconCls:'icon-save'"
                                    onclick="javascript: $('#file_upload').uploadify('upload', '*')">上傳</a>
                                <a href="javascript:void(0)" class="easyui-linkbutton" id="btnCancelUpload" data-options="plain:true,iconCls:'icon-cancel'"
                                    onclick="javascript: $('#file_upload').uploadify('cancel', '*')">取消</a>

                                <div id="fileQueue" class="fileQueue"></div>
                                <div id="div_files"></div>
                                <br />
                            </div>
                        </td>
                    </tr>

界面效果初始化以下所示：框架

固然，下一步咱們須要添加相應的文件上傳初始化的操做腳本代碼，以下所示。函數

    <script type="text/javascript">
        $(function () {
            //添加界面的附件管理
            $('#file_upload').uploadify({
                'swf': '/Content/JQueryTools/uploadify/uploadify.swf',  //FLash文件路徑
                'buttonText': '瀏  覽',                                 //按鈕文本
                'uploader': '/FileUpload/Upload',                       //處理文件上傳Action
                'queueID': 'fileQueue',                        //隊列的ID
                'queueSizeLimit': 10,                          //隊列最多可上傳文件數量，默認爲999
                'auto': false,                                 //選擇文件後是否自動上傳，默認爲true
                'multi': true,                                 //是否爲多選，默認爲true
                'removeCompleted': true,                       //是否完成後移除序列，默認爲true
                'fileSizeLimit': '10MB',                       //單個文件大小，0爲無限制，可接受KB,MB,GB等單位的字符串值
                'fileTypeDesc': 'Image Files',                 //文件描述
                'fileTypeExts': '*.gif; *.jpg; *.png; *.bmp;*.tif;*.doc;*.xls;*.zip',  //上傳的文件後綴過濾器
                'onQueueComplete': function (event, data) {                 //全部隊列完成後事件
                    ShowUpFiles($("#Attachment_GUID").val(), "div_files");  //完成後更新已上傳的文件列表
                    $.messager.alert("提示", "上傳完畢！");                                     //提示完成           
                },
                'onUploadStart' : function(file) {
                    $("#file_upload").uploadify("settings", 'formData', { 'folder': '政策法規', 'guid': $("#Attachment_GUID").val() }); //動態傳參數
                },
                'onUploadError': function (event, queueId, fileObj, errorObj) {
                    //alert(errorObj.type + "：" + errorObj.info);
                }
            });

    </script>

在上面的腳本中，均有註釋，一看就明白相關的屬性了，不明白的也能夠到官方網站去查找了解。值得注意的就是post

'uploader': '/FileUpload/Upload'

這行就是提交文件給MVC的Action進行處理，咱們在控制器FileUpload的 Upload處理便可。網站

另外，在附件上傳完畢後，咱們須要對所在的界面進行更新，以便顯示已上傳的列表，那麼咱們須要增長下面的函數處理便可。

'onQueueComplete': function (event, data) {

最後說明很是值得注意的地方，就是文件上傳的時候，咱們須要動態獲取界面上的一些元素的值，做爲參數傳遞，那麼咱們就須要在onUploadStart函數中進行以下處理。

$("#file_upload").uploadify("settings", 'formData', { 'folder': '政策法規', 'guid': $("#Attachment_GUID").val() }); //動態傳參數

三、上傳組件uploadify的C#後臺處理代碼

在上面的傳遞參數中，我使用了中文數值，通常狀況下，這樣會在後臺拿到中文亂碼，因此咱們須要在控制器的Action的函數裏面設置它的內容格式，以下所示。

ControllerContext.HttpContext.Request.ContentEncoding = Encoding.GetEncoding("UTF-8");
ControllerContext.HttpContext.Response.ContentEncoding = Encoding.GetEncoding("UTF-8");
ControllerContext.HttpContext.Response.Charset = "UTF-8";

控制器FileUpload的後臺處理Action代碼完整以下所示：

    public class FileUploadController : BaseController
    {
        [AcceptVerbs(HttpVerbs.Post)]
        public ActionResult Upload(HttpPostedFileBase fileData, string guid, string folder)
        {
            if (fileData != null)
            {
                try
                {
                    ControllerContext.HttpContext.Request.ContentEncoding = Encoding.GetEncoding("UTF-8");
                    ControllerContext.HttpContext.Response.ContentEncoding = Encoding.GetEncoding("UTF-8");
                    ControllerContext.HttpContext.Response.Charset = "UTF-8";

                    // 文件上傳後的保存路徑
                    string filePath = Server.MapPath("~/UploadFiles/");
                    DirectoryUtil.AssertDirExist(filePath);

                    string fileName = Path.GetFileName(fileData.FileName);      //原始文件名稱
                    string fileExtension = Path.GetExtension(fileName);         //文件擴展名
                    string saveName = Guid.NewGuid().ToString() + fileExtension; //保存文件名稱

                    FileUploadInfo info = new FileUploadInfo();
                    info.FileData = ReadFileBytes(fileData);
                    if (info.FileData != null)
                    {
                        info.FileSize = info.FileData.Length;
                    }
                    info.Category = folder;
                    info.FileName = fileName;
                    info.FileExtend = fileExtension;
                    info.AttachmentGUID = guid;
                    info.AddTime = DateTime.Now;
                    info.Editor = CurrentUser.Name;//登陸人
                    //info.Owner_ID = OwerId;//所屬主表記錄ID

                    CommonResult result = BLLFactory<FileUpload>.Instance.Upload(info);
                    if (!result.Success)
                    {
                        LogTextHelper.Error("上傳文件失敗:" + result.ErrorMessage);
                    }
                    return Content(result.Success.ToString());
                }
                catch (Exception ex)
                {
                    LogTextHelper.Error(ex);
                    return Content("false");
                }
            }
            else
            {
                return Content("false");
            }
        }

        private byte[] ReadFileBytes(HttpPostedFileBase fileData)
        {
            byte[] data;
            using (Stream inputStream = fileData.InputStream)
            {
                MemoryStream memoryStream = inputStream as MemoryStream;
                if (memoryStream == null)
                {
                    memoryStream = new MemoryStream();
                    inputStream.CopyTo(memoryStream);
                }
                data = memoryStream.ToArray();
            }
            return data;
        }