DIV CSS 佈局教程網

用 jQuery 實作 Ajax 非同步檔案上傳(Struts2 版)
編輯:AJAX基礎知識     

找了好一陣子,終於在網上找到以 Ajax 非同步上傳檔案的做法。網上的範例大多是 PHP 寫的,我把它改成 Struts2 版本,大同小異,希望對寫 Java 的朋友有幫助。這裡以音樂檔為例。

關鍵:ajaxfileupload.js

這個 js 檔是主角,一定要引入。它會幫你把 file input 的值取出、建立隱藏 iframe、以 form submit 模擬非同步上傳。

JSP 頁面

<%@ 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>

Action:接收檔案並解析 ID3

這裡示範的特別之處是:上傳完成後不只存檔,還順手用 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();
        }
    }
}

struts.xml 設定

別忘了上限設定,預設值通常不夠用。

<?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 時序的處理)。這類第三方小檔案在不同瀏覽器上的相容問題,通常都得自己動手補。

以上,希望對需要處理檔案上傳的朋友有參考價值。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved