由於項目需要，開發一個可以上傳圖片到服務器的web表單頁面。
一、 需求
Web表單頁面，可以通過表單上傳圖片以及其他文字信息。
二、 圖片上傳的流程
之前沒有做過這類頁面，通過查詢資料。發現比較常見的做法，是先將圖片上傳到服務器端的某個文件目錄下，服務器向前台返回圖片的存儲路徑；之後，前台將圖片存儲路徑以及其他表單信息一起提交到服務器，所有的表單信息存儲在數據庫中。
三、 方法
由於項目需要，我這裡介紹兩種圖片上傳方法，第一種是使用ajax對一個圖片直接上傳；第二種是先在前台將圖片切割為較小的文件，之後使用ajax分別上傳圖片到服務器，服務器實現對文件的拼接。（方法二適合較大文件的上傳）下面我分別對兩種方法做介紹。
方法一： 直接上傳
1 html頁面
<pre name="code" class="html"><!DOCTYPE html>
<head></head>
<body>
<form id="uploadForm" action="/PicSubmit/form" method="post" enctype="multipart/form-data" onsubmit="return submit_check()" class="bootstrap-frm" ></pre><pre name="code" class="html"><input id = "sid" type = "text" name="name" /></pre><pre name="code" class="html"><pre name="code" class="html"><input id = "fileImage" type = "file" name="filename" /></pre><pre name="code" class="html"><input id = "addressid" type = "hidden" name="address" /></pre><pre name="code" class="html"><input id="ajaxsub" type="button" class="button" value="上傳圖片" onclick="fileUpload()<span style="font-family: Arial, Helvetica, sans-serif;">" /> </span></pre><pre name="code" class="html"><input type="submit" class="button" value="提交表單" />
<input type="reset" class="button" value="重置表單" />
</pre></body></html><p></p>
<pre></pre>
<br>
<pre></pre>
這一部分需要注意的是，form表單的enctype屬性必須設置為“multipart/form-data”，在Html5中，如果需要多張圖片一起上傳，可以在<input type="file"> 標簽中，增加multiple屬性，例如：<input type="file" id= “fileImage” multiple />。<br>
<br>
<br>
<p></p>
<p>2 js</p>
<p>（1）js使用ajax提供的ajaxfileupload.js庫。這個庫使用起來還是比較方便的，和普通的ajax函數使用方法幾乎相同。首先，需要ajaxfileupload.js庫文件。這裡需要注意，我之前在網上下載了一個ajaxfileupload.js文件不能用，浪費了很長時間，我直接把js庫文件粘貼到這裡，方便分享。</p>
<p></p><pre name="code" class="javascript">// JavaScript Document</pre><pre name="code" class="javascript">// ajax file uplaod
jQuery.extend({
createUploadIframe: function(id, uri)
{
//create frame
var frameId = 'jUploadFrame' + id;
if(window.ActiveXObject) {
var io = document.createElement('<iframe id="' + frameId + '" name="' + frameId + '" />');
if(typeof uri== 'boolean'){
io.src = 'javascript:false';
}
else if(typeof uri== 'string'){
io.src = uri;
}
}
else {
var io = document.createElement('iframe');
io.id = frameId;
io.name = frameId;
}
io.style.position = 'absolute';
io.style.top = '-1000px';
io.style.left = '-1000px';
document.body.appendChild(io);
return io;
},
createUploadForm: function(id, fileElementId)
{
//create form
var formId = 'jUploadForm' + id;
var fileId = 'jUploadFile' + id;
var form = jQuery('<form action="" method="POST" name="' + formId + '" id="' + formId + '" enctype="multipart/form-data"></form>');
var oldElement = jQuery('#' + fileElementId);
var newElement = jQuery(oldElement).clone();
jQuery(oldElement).attr('id', fileId);
jQuery(oldElement).before(newElement);
jQuery(oldElement).appendTo(form);
//set attributes
jQuery(form).css('position', 'absolute');
jQuery(form).css('top', '-1200px');
jQuery(form).css('left', '-1200px');
jQuery(form).appendTo('body');
return form;
},
ajaxFileUpload: function(s) {
// TODO introduce global settings, allowing the client to modify them for all requests, not only timeout
s = jQuery.extend({}, jQuery.ajaxSettings, s);
var id = s.fileElementId;
var form = jQuery.createUploadForm(id, s.fileElementId);
var io = jQuery.createUploadIframe(id, s.secureuri);
var frameId = 'jUploadFrame' + id;
var formId = 'jUploadForm' + id;
if( s.global && ! jQuery.active++ )
{
// Watch for a new set of requests
jQuery.event.trigger( "ajaxStart" );
}
var requestDone = false;
// Create the request object
var xml = {};
if( s.global )
{
jQuery.event.trigger("ajaxSend", [xml, s]);
}
var uploadCallback = function(isTimeout)
{
// Wait for a response to come back
var io = document.getElementById(frameId);
try
{
if(io.contentWindow)
{
xml.responseText = io.contentWindow.document.body?io.contentWindow.document.body.innerHTML:null;
xml.responseXML = io.contentWindow.document.XMLDocument?io.contentWindow.document.XMLDocument:io.contentWindow.document;
}else if(io.contentDocument)
{
xml.responseText = io.contentDocument.document.body?io.contentDocument.document.body.innerHTML:null;
xml.responseXML = io.contentDocument.document.XMLDocument?io.contentDocument.document.XMLDocument:io.contentDocument.document;
}
}catch(e)
{
jQuery.handleError(s, xml, null, e);
}
if( xml || isTimeout == "timeout")
{
requestDone = true;
var status;
try {
status = isTimeout != "timeout" ? "success" : "error";
// Make sure that the request was successful or notmodified
if( status != "error" )
{
// process the data (runs the xml through httpData regardless of callback)
var data = jQuery.uploadHttpData( xml, s.dataType );
if( s.success )
{
// ifa local callback was specified, fire it and pass it the data
s.success( data, status );
};
if( s.global )
{
// Fire the global callback
jQuery.event.trigger( "ajaxSuccess", [xml, s] );
};
} else
{
jQuery.handleError(s, xml, status);
}
} catch(e)
{
status = "error";
jQuery.handleError(s, xml, status, e);
};
if( s.global )
{
// The request was completed
jQuery.event.trigger( "ajaxComplete", [xml, s] );
};
// Handle the global AJAX counter
if(s.global && ! --jQuery.active)
{
jQuery.event.trigger("ajaxStop");
};
if(s.complete)
{
s.complete(xml, status);
} ;
jQuery(io).unbind();
setTimeout(function()
{ try
{
jQuery(io).remove();
jQuery(form).remove();
} catch(e)
{
jQuery.handleError(s, xml, null, e);
}
}, 100);
xml = null;
};
}
// Timeout checker
if( s.timeout > 0 )
{
setTimeout(function(){
if( !requestDone )
{
// Check to see ifthe request is still happening
uploadCallback( "timeout" );
}
}, s.timeout);
}
try
{
var form = jQuery('#' + formId);
jQuery(form).attr('action', s.url);
jQuery(form).attr('method', 'POST');
jQuery(form).attr('target', frameId);
if(form.encoding)
{
form.encoding = 'multipart/form-data';
}
else
{
form.enctype = 'multipart/form-data';
}
jQuery(form).submit();
} catch(e)
{
jQuery.handleError(s, xml, null, e);
}
if(window.attachEvent){
document.getElementById(frameId).attachEvent('onload', uploadCallback);
}
else{
document.getElementById(frameId).addEventListener('load', uploadCallback, false);
}
return {abort: function () {}};
},
uploadHttpData: function( r, type ) {
var data = !type;
data = type == "xml" || data ? r.responseXML : r.responseText;
// ifthe type is "script", eval it in global context
if( type == "script" )
{
jQuery.globalEval( data );
}
// Get the JavaScript object, ifJSON is used.
if( type == "json" )
{
eval( "data = " + data );
}
// evaluate scripts within html
if( type == "html" )
{
jQuery("<div>").html(data).evalScripts();
}
return data;
},
handleError: function( s, xhr, status, e ) {
// If a local callback was specified, fire it
if ( s.error ) {
s.error.call( s.context || s, xhr, status, e );
}
// Fire the global callback
if ( s.global ) {
(s.context ? jQuery(s.context) : jQuery.event).trigger( "ajaxError", [xhr, s, e] );
}
}
});</pre><p></p>
<p><br>
</p>
（2）之後調用ajaxfileupload.js庫，編寫圖片上傳腳本，這裡命名為ajaxfileuplaod_implement.js
<p></p><pre name="code" class="javascript">function fileUpload() {
var inputObject = $("#fileImage").get(0);
if(inputObject.value == "")
{
alert("清先選擇需要上傳的圖片");
return false;
}
$.ajaxFileUpload({
url: '/PicSubmit/pic', //服務器端請求地址
secureuri: false, //是否需要安全協議，一般設置為false
type: 'post',
fileElementId: 'fileImage', //文件上傳域的ID
dataType: 'text', //返回值類型 一般設置為json
enctype:'multipart/form-data',//注意一定要有該參數
success: function (data, status) //服務器成功響應處理函數
{
data=decodeURI(data);//服務器端使用urlencode將中文字符編碼，所以這裡需要解碼。這樣做的目的是防止中文亂碼
var address = JSON.parse(data);
for(var i=0;i<address.length;i++){
ajaxfile_onSuccess(address[i]); //這裡的success回調函數可以自己定義，但是有一點需要注意，就是需要把服務器返回來的圖片存儲路徑寫入</pre><pre name="code" class="javascript"><span style="white-space:pre"> </span>//hiden標簽的value值中，方法見下面的writeHide函數
}
},
complete: function(xmlHttpRequest)
{<span style="white-space:pre"> </span>//這裡將html中的文件上傳標簽替換為新的標簽，是應為我在開發過程中發現，當ajax執行一次上傳操作之後，再使用file標簽選擇文件時，標簽沒有反應，</pre><pre name="code" class="javascript"><span style="white-space:pre"> </span>//所以暫時使用了這種方法。
inputObject.replaceWith('<input type="file" id="fileImage" name="fileImage" />');
},
error: function (data, status, e)//服務器響應失敗處理函數
{
//alert("無法連接到服務器");
}
})
}</pre><pre name="code" class="javascript"></pre><pre name="code" class="javascript">function writeHide(data){
<span style="white-space:pre"> </span>if($("#addressid").get(0).value == "")
<span style="white-space:pre"> </span>{
<span style="white-space:pre"> </span>$("#addressid").get(0).value = data.newName;
<span style="white-space:pre"> </span>}
<span style="white-space:pre"> </span>else
<span style="white-space:pre"> </span>{
<span style="white-space:pre"> </span>$("#addressid").get(0).value = $("#addressid").get(0).value+","+data.newName;
<span style="white-space:pre"> </span>}
}
</pre><p></p>
<p>3 spring.</p>
<p>完成上面兩個部分之後，前台的主要工作基本就結束了。我後台使用了spring框架。</p>
<p>首先是springMVC的配置文件：viewspace-servlet.xml</p>
<p></p><pre name="code" class="html"><?xml version="1.0" encoding="UTF-8" ?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:p="http://www.springframework.org/schema/p"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:mvc="http://www.springframework.org/schema/mvc"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-3.1.xsd
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc-3.1.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-3.1.xsd">
<!-- 靜態資源 -->
<mvc:resources mapping="/js/**" location="/js/" />
<mvc:resources mapping="/css/**" location="/css/" />
<mvc:resources mapping="/image/**" location="/image/" />
<!-- 掃描web包，應用Spring的注解 -->
<context:component-scan base-package="web"/>
<bean id="defaultAnnotationHandlerMapping"
class="org.springframework.web.servlet.mvc.annotation.DefaultAnnotationHandlerMapping" />
<bean id="annotationMethodHandlerAdapter"
class="org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter" />
<!-- 配置視圖解析器，將ModelAndView及字符串解析為具體的頁面 -->
<bean
class="org.springframework.web.servlet.view.InternalResourceViewResolver"
p:viewClass="org.springframework.web.servlet.view.JstlView"
p:prefix="/WEB-INF/jsp/"
p:suffix=".jsp"/>
<!-- 使springMVC支持圖片上傳 -->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
<!-- 最大上傳尺寸1MB -->
<property name="maxUploadSize" value="10485760"/>
<!-- 默認編碼 -->
<property name="defaultEncoding" value="UTF-8" />
<!-- 上傳文件的解析 -->
<property name="resolveLazily" value="true" />
</bean>
<!-- SpringMVC在超出上傳文件限制時,會拋出org.springframework.web.multipart.MaxUploadSizeExceededException -->
<!-- 該異常是SpringMVC在檢查上傳的文件信息時拋出來的,而且此時還沒有進入到Controller方法中 -->
<bean id="exceptionResolver" class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver" >
<property name="exceptionMappings">
<props>
<!-- 遇到MaxUploadSizeExceededException異常時,自動跳轉到/WEB-INF/jsp/error_toobig.jsp頁面 -->
<prop key="org.springframework.web.multipart.MaxUploadSizeExceededException">error_fileupload</prop>
</props>
</property>
</bean>
</beans></pre>其中，類“org.springframework.web.multipart.commons.CommonsMultipartResolver”的配置是必須的，否則後台無法收到前台傳來的文件。<p></p>
<p><br>
</p>
<p>為了防止文件名中的中文字符傳輸出現問題，在web.xml中做如下配置：</p>
<p></p><pre name="code" class="html"><?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" version="3.0">
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:applicationContext.xml</param-value>
</context-param>
<listener>
<listener-class>
org.springframework.web.context.ContextLoaderListener
</listener-class>
</listener>
<servlet>
<servlet-name>viewspace</servlet-name>
<servlet-class>
org.springframework.web.servlet.DispatcherServlet
</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>viewspace</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
<!-- 支持傳輸中文字符 -->
<filter>
<filter-name>characterEncodingFilter</filter-name>
<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
<init-param>
<param-name>encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
<init-param>
<param-name>forceEncoding</param-name>
<param-value>true</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>characterEncodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
</web-app></pre><p></p>
<p><br>
</p>
接下來是重點，在Controller中，使用如下方式接受前台穿回來的文件。<br>
<pre name="code" class="java"> @RequestMapping(value="/pic")
@ResponseBody
public String submitPic(@RequestParam(value = "filename",required = false) MultipartFile[] fileImage,
HttpServletRequest request){
if(fileImage == null){
return "[]";
}
return picSaveService.savePic(fileImage);
}</pre><br>
其中需要注意的是，如果前端html的input標簽中使用了multiple屬性，則表示標簽支持上傳多個圖片，則controller的參數列表中，文件的類型使用MultipartFile[]，反之，如果沒有使用multiple屬性，表示上傳的是一張圖片，則controller使用MultipartFile類型接收。
<p><br>
</p><p>文件接收完成後，就可以對文件進行存儲了，方法有很多，我這裡舉一個例子如下：</p>
<p></p><pre name="code" class="java"> public String savePic(MultipartFile[] fileImage){
//為圖片改名
String oldName = "";
String newName = "";
String extension = "";
//圖片按照上傳時間命名
SimpleDateFormat sdf = new SimpleDateFormat("yyyyMMddHHmmssSSS");
//存儲每張圖片的信息
List<PicConfirmData> resultList = new ArrayList<PicConfirmData>();
//獲取配置文件中圖片的存儲路徑
String path = Parameters.getInstance().getDatabaseProps().getProperty("pic_save_dir");
//依次將圖片存儲到path路徑下
for(int i=0;i<fileImage.length;i++){
System.out.println(fileImage[i].getOriginalFilename());
oldName = fileImage[i].getOriginalFilename();
extension = oldName.substring(oldName.lastIndexOf("."));
newName = sdf.format(new Date())+extension;
File target = new File(path,newName);
if(!target.exists()){
target.mkdirs();
}
try {
fileImage[i].transferTo(target);
} catch (IllegalStateException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
}
//記錄圖片存儲信息
PicConfirmData pic = null;
try {
//只存名稱，路徑已知，從而節省數據庫空間
//pic = new PicConfirmData(URLEncoder.encode(oldName, "utf-8"), path+newName);
pic = new PicConfirmData(1,URLEncoder.encode(oldName, "utf-8"), newName);
resultList.add(pic);
} catch (UnsupportedEncodingException e) {
e.printStackTrace();
}
}
return ToolJson.getJsonFromPicConfirmData(resultList);
}</pre>這裡將接收到的圖片的原始名稱以及修改後存儲使用的名稱返回給前台，原始名稱用於在前台頁面輸出“存儲成功”的提示信息，修改後的名稱用於給hiden標簽復制，hiden標簽的內容會在之後隨表單中其他信息一起提交到服務端，通過hiden標簽，我們就可以知道與表單關聯的圖片被存儲在什麼地方。<br>
<br>
<p></p>
<p>最後，圖片上傳完成後還需要提交表單，這裡使用SpringMVC實現一個表單接收功能。這裡名為address的參數，存儲的就是圖片的存儲路徑。</p>
<p></p><pre name="code" class="java"> @RequestMapping(value="/form")
public String submitForm(HttpServletRequest request){
String sid = request.getParameter("name");
String address = request.getParameter("address");
if(sid != null && submiter != null && faultTime != null && message != null && address != null){
if(formDataSaveService.saveForm(sid, submiter, message, address, faultTime)){
return "ac";
}
}
return "error";
}</pre><br>
方法二 前台切割上傳（留著後面補充）<p></p>
<p><br>
</p>
<link rel="stylesheet" href="http://static.jb51.net/public/res-min/markdown_views.css?v=1.0">
</pre>
以上所述是小編給大家介紹的Ajax配合Spring實現文件上傳功能代碼，希望對大家有所幫助，如果大家有任何疑問請給我留言，小編會及時回復大家的。在此也非常感謝大家對網站的支持！