Servlet3.0开始新增了Part接口,专门用来处理文件上传。
package javax.servlet.http;
import java.io.IOException;
import java.io.InputStream;
import java.util.Collection;
public interface Part {
public InputStream getInputStream() throws IOException;
public String getContentType();//获得内容属性如image/png
public String getName();//获得input name属性值与request.getPart参数值一致
public String getSubmittedFileName();//获得上传文件名
public long getSize();
public void write(String fileName) throws IOException;//将上传内容写入文件
public void delete() throws IOException;
public String getHeader(String name);//根据标头名称返回标头信息
public Collection<String> getHeaders(String name);//根据标头名称返回标头信息集合
public Collection<String> getHeaderNames();//返回标头名称集合
}
比较重要的几个方法:
/** * Obtain the content type passed by the browser. * * @return The content type passed by the browser or <code>null</code> if * not defined. */ public String getContentType();获得文件类型信息,如image/jpeg;image/png。
/** * If this part represents an uploaded file, gets the file name submitted * in the upload. Returns {@code null} if no file name is available or if * this part is not a file upload. * * @return the submitted file name or {@code null}. * * @since Servlet 3.1 */ public String getSubmittedFileName();获得上传文件名称,如test.jpg
/** * A convenience method to write an uploaded part to disk. The client code * is not concerned with whether or not the part is stored in memory, or on * disk in a temporary location. They just want to write the uploaded part * to a file. * * This method is not guaranteed to succeed if called more than once for * the same part. This allows a particular implementation to use, for * example, file renaming, where possible, rather than copying all of the * underlying data, thus gaining a significant performance benefit. * * @param fileName The location into which the uploaded part should be * stored. Relative locations are relative to {@link * javax.servlet.MultipartConfigElement#getLocation()} * * @throws IOException if an I/O occurs while attempting to write the part */ public void write(String fileName) throws IOException;上传文件。
/** * Obtain the size of this part. * * @return The size of the part if bytes */ public long getSize();获得上传文件大小(字节)。
Demo:
upload.html
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>upload</title>
</head>
<body>
<form action="upload.do" method="post" enctype="multipart/form-data">
上传图片:<input type="file" name="photo" value="" />
<br />
<input type="submit" value="上传" name="upload" />
</form>
</body>
</html>
uploadServlet.java
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import javax.servlet.http.Part;
import java.io.IOException;
import java.io.PrintWriter;
import java.time.LocalDate;
import java.time.LocalTime;
import java.time.format.DateTimeFormatter;
//import javax.servlet.annotation.MultipartConfig;
//import javax.servlet.annotation.WebServlet;
/**
* Created by N3verL4nd on 2017/1/9.
*/
//@MultipartConfig(location = "D:/JAVA/IdeaProjects/JavaProj/out/artifacts/jspRun_war_exploded/upload")
//@WebServlet(name = "uploadServlet", urlPatterns = {"/upload.do"})
public class uploadServlet extends HttpServlet {
protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
request.setCharacterEncoding("UTF-8");
response.setContentType("text/html;charset=UTF-8");
PrintWriter out = response.getWriter();
Part part = request.getPart("photo");
//获得上传文件名称(实际过程中应该重命名自己想要的格式)
String filename = part.getSubmittedFileName();
//类型检查如:只要图片格式文件
if (part.getContentType().startsWith("image")) {
String finalFileName = getPreFileName() + filename.substring(filename.indexOf('.', 0), filename.length());
//写入文件
//part.write(finalFileName);
out.println("<h2>" + finalFileName + " 上传成功</h2>");
}
else {
out.println("<h2>上传失败</h2>");
}
//返回input标签name值(与request.getPart参数一致)
//out.println(part.getName());
/*//返回标头名称集合(如content-disposition;content-type)
for (String str : part.getHeaderNames()){
out.println(str + "<br />");
}*/
/*//根据标头名称返回标头详细信息(如form-data; name="photo"; filename="ing.png")
for (String str : part.getHeaders("content-disposition")){
out.println(str + "<br />");
}*/
/*
//返回内容类型
out.println(part.getContentType() + "<br />");
//返回标头信息
out.println(part.getHeader("content-disposition") + "<br />");
//返回上传文件大小
out.println(part.getSize() + " 字节");
//返回上传文件名
out.println(part.getSubmittedFileName());
*/
//out.println(this.getServletContext().getRealPath("upload"));
}
//随机生成文件名
private String getPreFileName(){
StringBuilder stringBuilder = new StringBuilder();
LocalDate date = LocalDate.now();
//格式化日期字符串
stringBuilder.append(date.format(DateTimeFormatter.BASIC_ISO_DATE));
LocalTime time = LocalTime.now().withNano(0);
//格式化时间字符串
stringBuilder.append(time.format(DateTimeFormatter.ofPattern("HHmmss")));
return stringBuilder.toString();
}
}
上传服务器文件名如:20170109214600.png
关于MultipartConfig:
@MultipartConfig
该注解主要是为了辅助 Servlet 3.0 中 HttpServletRequest 提供的对上传文件的支持。该注解标注在 Servlet 上面,以表示该 Servlet 希望处理的请求的 MIME 类型是 multipart/form-data。另外,它还提供了若干属性用于简化对上传文件的处理。具体如下:
表 5. @MultipartConfig 的常用属性
属性名 | 类型 | 是否可选 | 描述 |
---|---|---|---|
fileSizeThreshold | int | 是 | 当数据量大于该值时,内容将被写入文件。 |
location | String | 是 | 存放生成的文件地址。 |
maxFileSize | long | 是 | 允许上传的文件最大值。默认值为 -1,表示没有限制。 |
maxRequestSize | long | 是 | 针对该 multipart/form-data 请求的最大数量,默认值为 -1,表示没有限制。 |