文件上传及几个细节问题

搭建网站时，有一个常用的功能就是文件的上传与下载。在添加一个文件上传功能时，主要有两个步骤：

1、创建一个web页面，填写需要上传文件的相关输入项

1.1通过<input type="file" />标签可以添加一个上传文件，需要注意的是，input标签一定要设置name属性，否则浏览器不会发送上传的文件数据。

1.2另外还需要把form标签的enctype属性设置成multipart/form-data,设置该值后，浏览器将会把文件数据附带在http请求消息体中，并使用MIME协议对上传文件进行描述，以方便接受方对上传文件进行解析和处理

2、创建一个servlet，负责解析上传过来的文件，读取并将其保存至硬盘中

2.1 request提供了一个getInputStream方法，可以获取到客户端提交过来的数据，但由于客户可能同时上传多个文件，在servelt上直接编程将会很麻烦。

2.2 apache组织提供一个用来处理表单文件上传的组件，该组件提供了性能优异的API，方便开发者实现表单文件上传功能。此组件名为：Commons-fileupload

3、使用Commons-fileupload组件，需要导入相关开发jar包，此jar包名为：

Commons-fileupload和commons-io， commons-io不属于文件上传组件的开发jar包，但Commons-fileupload从1.1版本后，需要其支持。

使用此开源组件，开发流程图如下：



4、Servlet核心开发步骤

4.1 创建一个DiskFileItemFactory工厂

DiskFileItemFactory factory = new DiskFileItemFactory();

4.2 创建一个ServletFileUpload对象，此对象将封装对上传文件数据的处理操作

ServletFileUpload upload = new ServletFileUpload(factory);

4.3 通过ServletFileUpload的isMultipartContent方法判断是否是表单文件上传，否则按照正常方式处理

if (!upload.isMultipartContent(request)) {
// 安传统方式读取数据,即表单数据上传的数据 enctype="multipart/form-data"
return;
}
4.4 通过ServletFileUpload的parseRequest方法获取request提交的每项表单数据,每项表单数据将被封装在一个FileItem对象中
List<FileItem> list;
list = (List<FileItem>) upload.parseRequest(request);
4.5 处理每项表单数据，根据FileItem的isFormField方法来区分提交的数据是否是普通表单数据还是文件上传数据，若是文件上传数据，调用FileItem的getInputStream方法可以获取到上传文件的数据。
整体代码示例如下：

public class FileUploadServlet extends HttpServlet {

public void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {

// request是安装MIME协议传输，不能再以request.getParameter方式读取
String savePath = this.getServletContext().getRealPath(
"/WEB-INF/upload");

//1、解决表单名和上传文件名中文乱码问题
// request.setCharacterEncoding("UTF-8");
try {
DiskFileItemFactory factory = new DiskFileItemFactory();
ServletFileUpload upload = new ServletFileUpload(factory);

//方法二:解决上传文件名中文乱码问题
upload.setHeaderEncoding("UTF-8");

if (!upload.isMultipartContent(request)) {
// 安传统方式读取数据,即表单数据上传的数据 enctype="multipart/form-data"
return;
}

//上传的数据时按照enctype="multipart/form-data"方式传上来的，其数据时按照MIME协议上传的
List<FileItem> list;
list = (List<FileItem>) upload.parseRequest(request);

for (FileItem item : list) {
if (item.isFormField()) {
String name = item.getFieldName();
//方法一:数据表单内容的中文乱码问题，按照multipart/form-data上传的数据，都按照iso8859-1进行编码
// 要解决此中文乱码问题，需要先对获取到的数据进行iso8859-1进行解码，在按照UTF-8进行编码
// String value = item.getString();
// value = new String(value.getBytes("iso8859-1"), "UTF-8");

//方法二:解决数据表单内容的中文乱码问题，采用FiltItem类中的getString(Charset）方法，此方法重载了getString
//获取到的数据将按照指定的编码方式进行编码
String value = item.getString("utf-8");

System.out.println(name + ":" + value);
} else {
String fileName = item.getName();
// 不同浏览器通过request上传的文件名不一致，有是完整路径，有点是文件名： c:\a\b\1.txt or
// 1.txt
fileName = fileName
.substring((fileName.lastIndexOf("\\") + 1));
InputStream in = item.getInputStream();

//FileOutputStream out = new FileOutputStream(savePath + "\\"
// + fileName);
//解决上传文件重名问题
String saveName = makeFileName(fileName);
// FileOutputStream out = new FileOutputStream(savePath + "\\"
// +saveName);

//文件打散算法
String realSavePath = makeSavePath(savePath, fileName);
FileOutputStream out = new FileOutputStream(realSavePath + "\\"
+saveName);

byte[] buf = new byte[1024];
int len = 0;
while ((len = in.read(buf)) > 0) {
out.write(buf);
}

out.close();
in.close();
}
}
} catch (FileUploadException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}

}

public void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {

doGet(request, response);
}

//解决上传文件重名导致文件覆盖问题
private String makeFileName(String fileName){
return UUID.randomUUID()+"_"+fileName;
}

//文件打散问题，解决一个文件下文件过多的问题
private String makeSavePath(String savePath, String fileName){
if(fileName==null || savePath==null){
return null;
}

int hCode = fileName.hashCode();
int dir1 = hCode&0x0f;
int dir2 = (hCode&0xf0)>>4;

String dir = savePath+"\\"+dir1+"\\"+dir2;

//文件要是不存在，创建此文件
File f = new File(dir);
if(!f.exists()){
f.mkdirs();
}

return dir;
}

}
5 上面的示例代码还解决了几个文件上传中的细节问题

5.1 表单名和上传文件名中文乱码问题

解决此问题有两种方法

一：通过request.setCharacterEncoding("UTF-8")来设置中文编码

二：通过ServletFileUpload的setHeaderEncoding方法来设置中文编码

ServletFileUpload upload = new ServletFileUpload(factory);

//方法二:解决上传文件名中文乱码问题
upload.setHeaderEncoding("UTF-8");
5.2 提交的表单内容中文乱码问题

由于设置了form标签的enctype属性值为multipart/form-data，其将通过MIME协议向服务器提交数据，所有表单数据都是通过iso8859-1来编码的。解决此中文乱码问题有两种方法

一：将表单数据通过iso8859-1进行解码，得到源字节码，在通过UTF-8编码

if (item.isFormField()) {
String name = item.getFieldName();
//方法一:数据表单内容的中文乱码问题，按照multipart/form-data上传的数据，都按照iso8859-1进行编码
// 要解决此中文乱码问题，需要先对获取到的数据进行iso8859-1进行解码，在按照UTF-8进行编码
// String value = item.getString();
// value = new String(value.getBytes("iso8859-1"), "UTF-8");

//方法二:解决数据表单内容的中文乱码问题，采用FiltItem类中的getString(Charset）方法，此方法重载了getString
//获取到的数据将按照指定的编码方式进行编码
String value = item.getString("utf-8");

System.out.println(name + ":" + value);
二:通过调用FileItem的getString(Charset charset)来获取表单内容。

5.3 上传文件重名问题

使用UUID方法重写文件名

//解决上传文件重名导致文件覆盖问题
private String makeFileName(String fileName){
return UUID.randomUUID()+"_"+fileName;
}
5.4 上传文件打散问题

使用文件名在内存中的地址(hashcode)来创建存储路径，总共两级目录，第一级目录名为filename 哈希值最低0-4位值，第二级目录名为哈希值低5-8位。

private String makeSavePath(String savePath, String fileName){
if(fileName==null || savePath==null){
return null;
}

int hCode = fileName.hashCode();
int dir1 = hCode&0x0f;
int dir2 = (hCode&0xf0)>>4;

String dir = savePath+"\\"+dir1+"\\"+dir2;

//文件要是不存在，创建此文件
File f = new File(dir);
if(!f.exists()){
f.mkdirs();
}

return dir;
}