Spring MVC使用commons fileupload实现文件上传功能

通过Maven建立Spring MVC项目，引入了Spring相关jar依赖。

1、为了使用commons fileupload组件，需要在pom.xml中添加依赖；

<properties>
		<spring.version>3.0.7.RELEASE </spring.version>
		<junit.version>3.8.1</junit.version>
		<fileupload.version>1.2.2</fileupload.version>
	</properties>
	<dependency>
		<groupId>commons-fileupload</groupId>
		<artifactId>commons-fileupload</artifactId>
		<version>${fileupload.version}</version>
	</dependency>

2、配置Spring MVC，项目成功启动后，编写jsp页面；

<%@ page language="java" contentType="text/html; charset=UTF-8"
	pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
	<head>
		<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
		<title>Errors导入Excel</title>
	</head>
	<body>
		<div>
			<!--只有将表单的enctype设置为multipart/form-data，才能实现文件上传；表单enctype的默认值为：application/x-www-form-urlencoded-->
			<!--只有POST方法才会被解析为文件上传请求    -->
			<form action="./fileupload" method="post" enctype="multipart/form-data">
				<!-- 不知道为啥，type="file"这一标签必须同时添加name属性，否则在处理上传时，无法检测到上传文件 -->
				<input type="file" name="fileField"/>
				<input type="submit" value="上传"/>				 
			</form>
			<p><font color="red">上传文件大小限制在1M之内</font></p>
		</div>
	</body>
</html>

注：注释当中的内容还是很重要的，使用时遇到了比较多奇葩的问题，暂时还未弄明白原因，留待日后解决。

注：实现上传文件的表单，需要指定method="post"且enctype="multipart/form-data"，否则无法通过fileupload组件解析为上传请求。

3、编写Controller，名为FileUploadController，在Controller中对上传文件进行处理；

@Controller
public class FileUploadController {
	
	@RequestMapping("/fileupload")
	public String handleFileUpload(HttpServletRequest request){
		boolean flag = false;
		
		//判断是否是文件上传请求
		if(ServletFileUpload.isMultipartContent(request)){
			// 创建文件上传处理器
			ServletFileUpload upload = new ServletFileUpload();
			//限制单个上传文件的大小
			upload.setFileSizeMax(1L<<24);
			
			try {
				// 解析请求
				FileItemIterator iter = upload.getItemIterator(request);
				
				while (iter.hasNext()) {
				    FileItemStream item = iter.next();
				    
				    if (!item.isFormField()) {
				    	//是文件上传对象，获取上传文件的输入流
				    	InputStream srcinInputStream = item.openStream();
				    	/*对上传文件的输入流进行处理，跟本地的文件流处理方式相同*/
				        
				    }
				}
			} catch (FileUploadException e) {
				System.out.println("上传文件过大");
			} catch (IOException e) {
				System.out.println("文件读取出现问题");
			}
		}
		
		return flag? "success":"error";
	}
}

注：commons fileupload的用户指南 http://commons.apache.org/proper/commons-fileupload/using.html；

注：判断上传请求及处理使用了Streaming API http://commons.apache.org/proper/commons-fileupload/streaming.html；

内容如下：

注：第一次看commons fileupload组件的用户指南时，感觉无从下手，其实User Guide的Parsing the request部分已经给出了很明确的说明。可以通过在对应的请求处理方法中直接通过ServletFileUpload.isMultipartContent(request)来判断是否是文件上传请求，通过 !item.isFormField() 来判断是否是文件上传对象；

4、fileupload组件上传文件时，获取普通域参数值和文件域输入流；

html元素的form表单的enctype属性规定在发送到服务器之前应该如何对表单数据进行编码。表单的enctype默认值为 "application/x-www-form-urlencoded"，在表单发送到服务器之前，所有字符都会进行编码（空格转换为 "+" 加号，特殊符号转换为 ASCII HEX 值）；对于文件上传，form表单的enctype="multipart/form-data"，此时form表单不对字符编码，此时在请求的处理函数中无法通过request.getParameter("parameterName")来获取参数值；

但是可以通过其他方式来获取参数值；

/**
	 * 获取页面传递的参数，以Map存储，以fieldName为键值，普通域存储value，文件上传域存储文件输入流
	 * @param request
	 * @return
	 */
	private Map<String, Object> getParameters(HttpServletRequest request){
		Map<String, Object> parameters = new HashMap<String, Object>();
		
		// 默认最多允许存储1024个字节
		DiskFileItemFactory factory = new DiskFileItemFactory();
		
		if(ServletFileUpload.isMultipartContent(request)){
			ServletFileUpload upload = new ServletFileUpload(factory);
			
			try{
				List<FileItem> items =upload.parseRequest(request);
			
				for(Iterator<FileItem> iter = items.iterator(); iter.hasNext();){
					FileItem item = iter.next();
					
					if(item.isFormField()){
						//普通域，取参数值
						parameters.put(item.getFieldName(), item.getString());
					}else{
						//文件上传域，取输入流
						parameters.put(item.getFieldName(), item.getInputStream());
					}
				}
			}catch(Exception exception){
				exception.printStackTrace();
			}
		}
		
		return parameters;
	}

Spring MVC使用commons fileupload实现文件上传功能

猜你喜欢