DIV CSS 佈局教程網

Uploadify 3.1 使用說明:含 .NET 後端完整範例
編輯:JQuery特效代碼     

3.1 版主要變更之一是取消了 postData,改為 formData(JSON 格式)。本文以 ASP.NET 為例,示範從前端設定到 ashx 處理端的完整流程。

一、資源連結

  • 官方網站:https://www.uploadify.com/
  • 官方英文文件:https://www.uploadify.com/documentation/

二、前端 JavaScript

$("#id").uploadify({
  height: 30,
  swf: '/uploadify/uploadify.swf',
  uploader: '/Handler/uploadPic.ashx',
  width: 120,
  cancelImg: '/uploadify/uploadify-cancel.png',
  buttonText: '選擇圖片',
  fileTypeExts: '*.gif;*.jpg;*.jpeg;*.png',
  'fileSizeLimit': '6000KB',
  removeCompleted: false,
  'formData': {
    "id": "1"            // 3.1 起以 formData 取代 postData
  },
  onUploadSuccess: function (file, data, response) {
    if (data.indexOf('錯誤提示') > -1) {
      alert(data);
    } else {
      alert("上傳成功!");
    }
  },
  'onUploadError': function (file, errorCode, errorMsg, errorString) {
    alert('檔案:' + file.name + ' 上傳失敗: ' + errorString);
  }
});

三、ASHX 處理端

public class uploadPic : IHttpHandler
{
  // 允許的副檔名清單
  protected string AllowExt = "7z|aiff|asf|avi|bmp|csv|doc|docx|fla|flv|gif|gz|gzip|jpeg|jpg|mid|mov|mp3|mp4|mpc|mpeg|mpg|ods|odt|pdf|png|ppt|pptx|pxd|qt|ram|rar|rm|rmi|rmvb|rtf|sdc|sitd|swf|sxc|sxw|tar|tgz|tif|tiff|txt|vsd|wav|wma|wmv|xls|xlsx|xml|zip";
  int FileMaxSize = 10240;   // 檔案大小上限,單位 KB

  public void ProcessRequest(HttpContext context)
  {
    context.Response.ContentType = "text/plain";
    string ParentID = context.Request.Params["id"];
    HttpPostedFile fileUpload = context.Request.Files[0];

    if (fileUpload != null)
    {
      try
      {
        string UploadDir = "~/upload/";                      // 圖片保存資料夾
        string path = context.Server.MapPath(UploadDir);
        string folder = DateTime.Now.ToString("yyyyMM");     // 每月一個子資料夾

        if (!Directory.Exists(path + folder))
        {
          Directory.CreateDirectory(path + folder);
        }

        string fileExtension = fileUpload.FileName.Substring(fileUpload.FileName.LastIndexOf('.'));

        // 副檔名檢查
        if (!CheckValidExt(fileExtension))
        {
          context.Response.Write("錯誤提示:文件格式不正確!" + fileExtension);
          return;
        }

        // 檔案大小檢查
        if (fileUpload.ContentLength > FileMaxSize * 1024)
        {
          context.Response.Write("錯誤提示:上傳的文件(" + fileUpload.FileName +
                                 ")超過最大限制:" + FileMaxSize + "KB");
          return;
        }

        // 以「時間 + 三位隨機數」重新命名,避免檔名衝突
        string strDateTime = DateTime.Now.ToString("yyMMddhhmmssfff");
        Random ran = new Random();
        string strRan = Convert.ToString(ran.Next(100, 999));
        string saveName = strDateTime + strRan + fileExtension;

        Model.Album uc = new Model.Album();
        uc.Title     = fileUpload.FileName;
        uc.ImagePath = folder + "/" + saveName;
        uc.PostTime  = DateTime.Now;
        uc.Pid       = int.Parse(ParentID);

        bll.Album alb = new bll.Album();
        alb.add(uc);

        fileUpload.SaveAs(path + folder + "/" + saveName);

        // 回傳可存取的相對路徑,前端 onUploadSuccess 的 data 即為此字串
        context.Response.Write(UploadDir + folder + "/" + saveName);
      }
      catch
      {
        context.Response.Write("錯誤提示:上傳失敗");
      }
    }
  }

  public bool IsReusable { get { return false; } }

  /// <summary>
  /// 檢測擴展名的有效性
  /// </summary>
  /// <param name="strExt">文件名擴展名</param>
  /// <returns>有效回傳 true,否則 false</returns>
  public bool CheckValidExt(string strExt)
  {
    bool flag = false;
    string[] arrExt = AllowExt.Split('|');
    foreach (string filetype in arrExt)
    {
      if (filetype.ToLower() == strExt.ToLower().Replace(".", ""))
      {
        flag = true;
        break;
      }
    }
    return flag;
  }
}

四、3.1 版差異與注意事項

  • postData 已改名為 formData,並以 JSON 物件形式傳遞。
  • 後端回傳字串若以「錯誤提示」開頭,前端即可判定為失敗,這種「約定字串」的做法簡單 but 脆弱,正式環境建議改用 HTTP 狀態碼或 JSON 格式回應。
  • 安全性提醒:上例的白名單中包含 swf、html 類型的風險檔案,且完全以副檔名判定型別,並未驗證實際內容。在真實環境中應:把可上傳型別收斂到必要範圍、以 Content-Type 或檔案標頭(magic number)做二次驗證、限制上傳目錄不得執行腳本、並對使用者上傳的檔案加上驗證碼或登入權限檢查,否則會留下任意檔案上傳的風險。
  • 若要把縮圖顯示功能做出來,可在 onUploadSuccess 中把 data 塞進 <img> 的 src,例如 $("#previewImage").attr("src", data).hide().fadeIn(2000);。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved