Web基础了解版12-上传下载
上传
-
用户在页面中选择要上传的文件,然后将请求提交到Servlet
-
Servlet收到请求,解析用户上传的文件,然后将文件存储到服务器
<form action="Servlet" method="post" enctype="multipart/form-data"> <input type="file" name="file" /><br /><br /> <input type="submit" value="上传" /> </form>
-
表单的method属性必须为post
-
表单的enctype属性必须为multipart/form-data
-
注意:Servelet
- 当enctype="multipart/form-data" 时,再使用getParamter()获取到内容永远为空。
- 需要引入解析请求中的参数和文件,这个工具就是commons-fileupload。
它的作用就是可以从request对象中解析出,用户发送的请求参数和上传文件的流。
commons-fileupload包依赖commons-io,两个包需要同时导入。
-
DiskFileItemFactory
-
工厂类,用于创建ServletFileUpload,设置缓存等
-
该类一般直接使用构造器直接创建实例
-
方法:
-
public void setSizeThreshold(int sizeThreshold):用于设置缓存文件的大小(默认值10kb)
-
public void setRepository(File repository):用于设置缓存文件位置(默认系统缓存目录)
-
-
-
ServletFileUpload
-
该类用于解析request对象从而获取用户发送的请求参数(包括普通参数和文件参数)
-
该类需要调用有参构造器创建实例,构造器中需要一个DiskFileItemFactory作为参数
-
方法:
-
public List<FileItem> parseRequest(HttpServletRequest request):解析request对象,获取请求参数,返回的是一个List,List中保存的是一个FileItem对象,一个对象代表一个请求参数。
-
public void setFileSizeMax(long fileSizeMax):设置单个文件的大小限制,单位为B。如果上传文件超出限制,会在parseRequest()抛出异常FileSizeLimitExceededException。
-
public void setSizeMax(long sizeMax):限制请求内容的总大小,单位为B。如果上传文件超出限制,会在parseRequest()抛出异常SizeLimitExceededException。
-
-
-
FileItem
-
该类用于封装用户发送的参数和文件,也就是用户发送来的信息将会被封装成一个FileItem对象,我们通过该对象获取请求参数或上传文件的信息。
-
该类不用我们手动创建,由ServletFileItem解析request后返回。
-
方法:
-
String getFieldName():获取表单项的名字,也就是input当中的name属性的值。
-
String getName():获取上传的文件名,普通的请求参数为null。
-
String getString(String encoding):获取内容,encoding参数需要指定一个字符集。
① 若为文件,将文件的流转换为字符串。
② 若为请求参数,则获取请求参数的value。
-
boolean isFormField():判断当前的FileItem封装的是普通请求参数,还是一个文件。
① 如果为普通参数返回:true
② 如果为文件参数返回:false
-
String getContentType():获取上传文件的MIME类型
-
long getSize():获取内容的大小
-
-
//创建工厂类 DiskFileItemFactory factory = new DiskFileItemFactory(); //创建请求解析器 ServletFileUpload fileUpload = new ServletFileUpload(factory); //设置上传单个文件的的大小 fileUpload.setFileSizeMax(1024*1024*3); //设置上传总文件的大小 fileUpload.setSizeMax(1024*1024*3*10); //设置响应内容的编码 response.setContentType("text/html;charset=utf-8"); try { //解析请求信息,获取FileItem的集合 List<FileItem> items = fileUpload.parseRequest(request); //遍历集合 for (FileItem fileItem : items) { //如果是普通的表单项 if(fileItem.isFormField()){ //获取参数名 String fieldName = fileItem.getFieldName(); //获取参数值 String value = fileItem.getString("utf-8"); System.out.println(fieldName+" = "+value); //如果是文件表单项 }else{ //获取文件名 String fileName = fileItem.getName(); //获取上传路径 String realPath = getServletContext().getRealPath("/WEB-INF/upload"); //检查upload文件夹是否存在,如果不存在则创建 File f = new File(realPath); if(!f.exists()){ f.mkdir(); }; //为避免重名生成一个uuid作为文件名的前缀 String prefix = UUID.randomUUID().toString().replace("-", ""); //将文件写入到服务器中 fileItem.write(new File(realPath+"/"+prefix+"_"+fileName)); //清除文件缓存 fileItem.delete(); }
} } catch (Exception e) { if(e instanceof SizeLimitExceededException){ //文件总大小超出限制 response.getWriter().print("上传文件的总大小不能超过30M"); }else if(e instanceof FileSizeLimitExceededException){ //单个文件大小超出限制 response.getWriter().print("上传单个文件的大小不能超过3M"); } } response.getWriter().print("上传成功");
-
服务器以一个流的形式将文件发送给浏览器。
-
发送流的同时还需要设置几个响应头,来告诉浏览器下载的信息。
-
具体响应头如下:
-
Content-Type
-
下载文件的MIME类型
-
可以通过servletContext. getMimeType(String file)获取
-
也可以直接手动指定
-
使用response.setContentType(String type);
-
响应头样式:Content-Type: audio/mpeg
-
-
Content-Disposition
-
下载文件的名字,主要作用是提供一个默认的用户名
-
通过response.setHeader("Content-Disposition", disposition)设置
-
响应头样式:Content-Disposition: attachment; filename=xxx.mp3
-
-
Content-Length
-
下载文件的长度,用于设置文件的长处(不必须)
-
通过response. setContentLength(int len)设置。
-
设置后样式:Content-Length: 3140995
-
-
-
-
接下来需要以输入流的形式读入硬盘上的文件
-
FileInputStream is = new FileInputStream(file);
-
这个流就是我们一会要发送给浏览器的内容
-
-
通过response获取一个输出流,并将文件(输入流)通过该流发送给浏览器
-
获取输出流:ServletOutputStream out = response.getOutputStream();
-
-
步骤演示
以下步骤都是在同一个Servlet的doGet()方法中编写的
1.获取文件的流:
String realPath = getServletContext().getRealPath("/WEB-INF/mp3/中国话.mp3"); //获取文件的File对象 File file = new File(realPath); //获取文件的输入流 FileInputStream in = new FileInputStream(file);
2.获取头信息:
//获取文件的MIME信息 String contentType = getServletContext().getMimeType(realPath); //设置下载文件的名字 String filename = "zhongguohua.mp3"; //创建Content-Disposition信息 String disposition = "attachment; filename="+ filename ; //获取文件长度 long size = file.length();
3.设置头信息
//设置Content-Type response.setContentType(contentType); //设置Content-Disposition response.setHeader("Content-Disposition", disposition); //设置文件长度 response.setContentLength((int)size);
4.发送文件
//通过response获取输出流,用于向浏览器输出内容 ServletOutputStream out = response.getOutputStream(); //将文件输入流通过输出流输出 byte[] b = new byte[1024]; int len = 0; while((len=is.read(b))> 0){ out.write(b, 0, len); } //最后不要忘记关闭输入流,输出流由Tomcat自己处理,我们不用手动关闭 is.close();
中文文件名会出现乱码问题。解决此问题的方法很简单,在获取文件名之后为文件名进行编码:
filename = java.net.URLEncoder.encode(filename,"utf-8");
火狐浏览器比较特殊需要特殊处理一下。
1.先要获取客户端信息(通过获取请求头中的User-Agent信息)
String ua = request.getHeader("User-Agent");
2.然后判断浏览器版本,做不同的处理
//判断客户端是否为火狐 if(ua.contains("Firefox")){ //若为火狐使用BASE64编码 filename = "=?utf-8?B?"+new BASE64Encoder().encode(filename.getBytes("utf-8"))+"?="; }else{ //否则使用UTF-8 filename = URLEncoder.encode(filename,"utf-8"); }
String string = new String("你好.jpg".getBytes("gbk"), "iso8859-1");