找了好一陣子,終於在網上找到以 Ajax 非同步上傳檔案的做法。網上的範例大多是 PHP 寫的,我把它改成 Struts2 版本,大同小異,希望對寫 Java 的朋友有幫助。這裡以音樂檔為例。
這個 js 檔是主角,一定要引入。它會幫你把 file input 的值取出、建立隱藏 iframe、以 form submit 模擬非同步上傳。
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%
String path = request.getContextPath();
String basePath = request.getScheme() + "://" + request.getServerName()
+ ":" + request.getServerPort() + path + "/";
%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<base href="<%=basePath%>">
<title>Uploadify</title>
<style type="text/css">
#div1{ display:none; color:#000; background:#fff; font-size:12px;
border:1px solid #74B3DC; }
</style>
<script type="text/javascript" src="js/jquery-1.3.2.min.js"></script>
<script type="text/javascript" src="js/ajaxfileupload.js"></script>
<script type="text/javascript">
function ajaxFileUpload(){
$.ajaxFileUpload({
url: 'uploadAction.action', // 伺服器端位址
secureuri: false,
fileElementId: 'upload', // file input 的 id
dataType: 'json',
success: function (data, status) {
// 後端回傳的是以分號串接的字串
var mp3Name = data.split(";");
$('#songName').val(mp3Name[0]);
$('#songsiger').val(mp3Name[1]);
$('#result').html('添加成功');
},
error: function (data, status, e) {
$('#result').html('添加失敗');
}
});
// 順手做個 div 顯示/隱藏切換
var target = document.getElementById('div1');
target.style.display = (target.style.display == "block") ? "none" : "block";
}
</script>
</head>
<body>
<form method="post" action="uploadAction.action" enctype="multipart/form-data">
<input type="file" id="upload" name="upload" />
<input type="button" value="上傳文檔" onclick="ajaxFileUpload()" />
<div id="result"></div>
<div id="div1">
歌曲 <input type="text" id="songName" name="songName" value="" />
歌手 <input type="text" id="songsiger" name="songsiger" value="" />
<input type="button" value="提交文檔信息" />
</div>
</form>
</body>
</html>
這裡示範的特別之處是:上傳完成後不只存檔,還順手用 MP3 標籤庫把專輯、歌名、歌手讀出來回傳給前端。
package action;
import java.io.File;
import java.io.IOException;
import org.apache.commons.io.FileUtils;
import org.farng.mp3.MP3File;
import org.farng.mp3.TagException;
import org.farng.mp3.id3.AbstractID3v2;
import org.farng.mp3.id3.ID3v1;
import org.farng.mp3.lyrics3.AbstractLyrics3;
import com.base.BaseAction;
public class Upload extends BaseAction {
private static final long serialVersionUID = -4848248679889814408L;
private String fileName;
private File upload;
public File getUpload() { return upload; }
public void setUpload(File upload) { this.upload = upload; }
public void setUploadFileName(String fileName) { this.fileName = fileName; }
/** 歌曲上傳 */
public void uploadAction() throws IOException {
String targetDirectory = "D:\\upload";
File target = new File(targetDirectory, fileName);
FileUtils.copyFile(upload, target);
String path = targetDirectory + "\\" + fileName;
try {
MP3File file = new MP3File(path);
AbstractID3v2 id3v2 = file.getID3v2Tag();
ID3v1 id3v1 = file.getID3v1Tag();
if (id3v2 != null) {
String ss = id3v2.getAlbumTitle() + ";" + id3v2.getSongTitle()
+ ";" + id3v2.getLeadArtist();
outPut(ss);
} else if (id3v1 != null) {
outPut(id3v1.getAlbumTitle() + ";" + id3v1.getSongTitle()
+ ";" + id3v1.getLeadArtist());
}
AbstractLyrics3 lrc3Tag = file.getLyrics3Tag();
if (lrc3Tag != null) {
System.out.println(lrc3Tag.getSongLyric());
}
} catch (IOException e) {
e.printStackTrace();
} catch (TagException e) {
e.printStackTrace();
}
}
}
別忘了上限設定,預設值通常不夠用。
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
"https://struts.apache.org/dtds/struts-2.0.dtd">
<struts>
<constant name="struts.i18n.encoding" value="UTF-8"/>
<!-- 上傳檔案大小上限:10MB -->
<constant name="struts.multipart.maxSize" value="10485760"/>
<package name="upload" namespace="/" extends="struts-default">
<action name="uploadAction" class="action.Upload" method="uploadAction">
<result name="success">/index.jsp</result>
</action>
</package>
</struts>
後來在實測中發現 Firefox 與 IE 的行為不一致,導致拿不到預期結果,於是回頭修改了 ajaxfileupload.js 的源碼(主要是 iframe 建立與 onload 時序的處理)。這類第三方小檔案在不同瀏覽器上的相容問題,通常都得自己動手補。
以上,希望對需要處理檔案上傳的朋友有參考價值。