瀏覽器的檔案上傳元件只能選本機檔案,無法瀏覽伺服器上的目錄結構。若應用需要「從伺服器既有的媒體庫中挑一個檔案」,就得自己做一個。以下示範如何用 XML 傳遞目錄資訊、FSO 讀取伺服器檔案系統、再用 JavaScript 在頁面中呈現一個類似 Windows 檔案總管的介面。
作者:Linzhang Chen,2003-04-20
getfolder.asp 接受一個 folder 參數,回傳該目錄下的子目錄與符合條件的檔案清單:
<%
response.write "<?xml version=""1.0"" encoding=""GB2312""?>" & chr(13)
response.write "<mediafile>" & chr(13)
folders = request("folder")
if folders = "/" then folders = ""
dim count
count = 0
folders = replace(folders, "..", "") ' 去除上跳目錄的嘗試
basefolder = "../media/" ' 基準的媒體庫路徑
newfolder = basefolder & folders
Set fso = server.CreateObject("Scripting.FileSystemObject")
Set f = fso.getfolder(server.mappath(newfolder))
Set sf = f.subfolders
for each fd in sf ' 子目錄
response.write "<file>" & chr(13)
response.write "<ftype>folder</ftype>" & chr(13)
response.write "<fname>" & fd.name & "</fname>" & chr(13)
response.write "</file>" & chr(13)
count = count + 1
next
Set sf = nothing
Set ff = f.Files ' 檔案,僅限指定類型
for each fi in ff
fname = fi.name
if instr("asf,wma,wmv", lcase(mid(fname, instrrev(fname, ".") + 1))) > 0 then
response.write "<file>" & chr(13)
response.write "<ftype>file</ftype>" & chr(13)
response.write "<fname>" & fname & "</fname>" & chr(13)
response.write "</file>" & chr(13)
count = count + 1
end if
next
if count = 0 then ' 空目錄也要回報,前端才不會卡在載入中
response.write "<file>" & chr(13)
response.write "<ftype>empty</ftype>" & chr(13)
response.write "<fname>0</fname>" & chr(13)
response.write "</file>" & chr(13)
end if
response.write "</mediafile>"
Set ff = nothing
Set f = nothing
Set fso = nothing
%>
三個設計細節值得留意。副檔名白名單用 instr 檢查,只放行 asf、wma、wmv 三種串流格式,避免原始碼或設定檔被瀏覽下載。空目錄也要回傳一個 empty 節點,否則前端會一直停在「正在載入」。去掉 ".." 是為了避免目錄上跳,但這道防線並不完整——正式環境應該用正則表達式嚴格驗證路徑,或直接比對解析後的絕對路徑是否仍位於基準目錄之下。
selectfile.asp 是選擇器主體。核心邏輯包含幾個部分:
function getuserlist(url) {
var oXMLDoc = new ActiveXObject('MSXML');
oXMLDoc.url = url;
return oXMLDoc.root;
}
把 URL 直接指定給 XMLDOM 的 url 屬性,解析器會自行抓取並解析,回傳根節點。這種寫法比手動 XMLHTTP 簡短,但同樣是 IE 專屬。
用一個陣列當堆疊記錄瀏覽路徑,hisi 為目前的指標。往前點擊時 hisi 遞增、往後時遞減,並據此決定返回箭頭圖示該顯示為可用還是灰色:
var arrhistory = new Array();
var hisi = 0;
// ...
hisi += ti;
arrhistory[hisi] = folders;
if (hisi == 0) {
arrow.innerHtml = '<img src="images/grayarrow.gif">';
} else {
arrow.innerHtml = '<img src="images/arrow.gif" ... onclick="userlist(\''
+ arrhistory[hisi - 1] + '\', -1)" ...>';
}
解析出的每個 file 節點都含 ftype 與 fname 兩個子節點。依 ftype 的值決定渲染成可點擊的目錄連結還是檔案連結:
for (i = 0; i < len; i++) {
oItem = oRoot.children.item(i);
if (oItem.children.item(0).text == "folder") {
arrff[i] = '<A href="Javascript:parent.userlist(\'' + folders
+ oItem.children.item(1).text + '/\',1)">'
+ '<img src="images/mediafolder.gif" border=0>'
+ oItem.children.item(1).text + '</A>';
} else {
arrff[i] = '<A href="Javascript:parent.addfile(\''
+ oItem.children.item(1).text + '\')">'
+ '<img src="images/mediafile.gif" border=0>'
+ oItem.children.item(1).text + '</A>';
}
}
接著按六欄排版輸出成表格,不足的位置補空白單元格。點選檔案時 addfile() 把檔名寫入文字框;點擊「開啟」則由 check() 把「目前路徑 + 檔名」存入 window.returnValue 後關閉視窗。
最後用 showModalDialog 開啟選擇器,選好後回傳完整路徑:
function selectfile() {
var arr = showModalDialog("selectfile.asp?temp=" + Math.random(), "",
"dialogWidth:453px; dialogHeight:252px; status:0; help:1");
if (arr != null) {
return arr;
}
}
URL 後面掛一個 Math.random() 是為了避免快取,確保每次開啟都拿到最新的目錄狀態。介面所需的箭頭、資料夾、檔案圖示,可以從 Windows 的檔案選擇框自行擷取。
這份程式寫於 2003 年,思路清晰,但技術基礎已經過時。若要在現代環境重做同樣的功能,有幾點必須改:
fetch() 或 XMLHttpRequest,後者應改用 <dialog> 元素或自建的 Modal 元件。document.createElement 搭配 textContent 建立節點,或至少對檔名做完整轉義。& 會讓 XML 失效,應改用 XMLDOM 建立節點輸出,讓解析器自動處理轉義。整體架構——伺服器輸出目錄 XML、前端解析渲染、堆疊實作瀏覽歷史——放到今天仍然成立,只是構件該換成 fetch、標準 DOM API 與安全的路徑驗證。這正是閱讀老程式碼的價值:看出哪些設計是耐用的,哪些只是當時環境的限制。