javaWEB知识总结——文件或资源的上传和下载
1.文件的上传
[1] 简介
> 将一个客户端的本地的文件发送到服务器中保存。
> 上传文件是通过流的形式将文件发送给服务器。
[2] 表单的设置
> 向服务器上传一个文件时,表单要使用post请求。
> 表单的默认属性enctype="application/x-www-form-urlencoded"
- 这个属性的意思是请求体中的内容将会使用URL编码
> 上传文件的表单enctype需要设置为 multipart/form-data
- multipart/form-data表示的是表单是一个多部件的表单
- 如果类型设置为它,则我们的每一个表单项都会作为一个单独的部件发送给服务器。
- 多个部件之间使用类似 -----------------------------7df2d08c0892 分割符来分开
> 当表单设置为multipart/form-data时,我们request.getParameter()将失效,我们不能再通过该方法获取请求参数。
[3] FileUpload
> 我们一般情况下使用commons-fileupload-1.3.1.jar这个工具来解析多部件请求。
> fileupload 依赖 commons-io 所以我们要是Filtupload需要同时导入io包。
> 核心类:
DiskFileItemFactory
- 工厂类,用于构建一个解析器实例。
ServletFileUpload
- 解析器类,通过该类实例来解析request中的请求信息。
FileItem
- 工具会将我们请求中每一个部件,都封装为一个FileItem对象,处理文件上传时,只需要调用该对象的方法
- 方法:
boolean isFormField() --> 当前表单项是否是一个普通表单项,true是普通表单项, false是文件表单项
String getContentType() --> 返回的是文件的类型,是MIME值
String getFieldName() --> 获取表单项的name属性值
String getName() --> 获取上传的文件的名字
long getSize() --> 获取文件的大小
String getString(String encoding) --> 获取表单项的value属性值,需要接受一个编码作为参数。
void write(File file) --> 将表单项中的内容写入到磁盘中
> 使用步骤:
1.获取工厂类实例[DiskFileItemFactory]
2.获取解析器类实例[ServletFileUpload]
3.解析request获取FileItem[parseRequest()]
[4] 细节
第一个问题
> 部分浏览器会将文件的完整路径作为文件名发送。
C:\Users\lilichao\Desktop\day20\图片\蒙娜丽莎.jpg
> 像这类文件名我们需要截取一下字符串,只获取名字这部分,而不需要获取路径部分的信息。
通过如下代码对文件名进行截取字符串的操作:
if(name.contains("\\")){ //如果包含则截取字符串 name = name.substring(name.lastIndexOf("\\")+1); }
第二个问题
> 上传的文件有可能出现重名,后上传的文件会将先上传的文件覆盖。
> 解决:给文件名加一个唯一的前缀。
唯一标识_fennu.jpg
UUID_fennu.jpg
第三个问题
> 有些情况需要限制上传文件的大小。
- 设置单个文件大小为50KB:
fileUpload.setFileSizeMax(1024*50);
- 设置完单个文件大小限制以后,一旦上传的文件超过限制,则会抛出如下异常:
FileSizeLimitExceededException
所有可以对该异常进行捕获,当出现该异常时则设置一个错误消息。
- 设置多个文件的总大小为150KB
fileUpload.setSizeMax(1024*150);
- 当多个文件的大小超出范围时,会抛出如下异常
SizeLimitExceededException
第四个问题
> 当用户上传一个空的文件,依然会将文件保存到硬盘上。
> 在保存文件应该先对文件的大小进行判断,如果size为0,则不处理。
2.文件的下载
[1] 简介
> 将服务器中的文件下载到本地。
> 一般情况下资源所在的链接发送给浏览器,浏览器就会自动下载。
但是当浏览器支持当前文件的格式,浏览器会自动打开文件,而不会弹出下载窗口。
> 直接将资源放在项目的目录下,浏览器可以直接访问到资源。
所以一般我们下载的资源不能让浏览器直接访问到。
[2] 下载所需要的内容
1.获取到文件的流
2.设置两个响应头
[3] 下载相关的两个响应头
1) 文件类型 Content-Type --> 文件的MIME类型
Content-Type:告诉浏览器文件的类型,需要设置一个MIME值
response.setContent-Type("MIME值")
通过servletContext.getMimeType(path)方法可以直接获取文件的MIME类型
2) 下载文件的信息 Content-Disposition --> attachment; filename=文件名
Content-Disposition告诉浏览器如何处理文件,
attachment 告诉浏览器这个文件是一个附件的形式发给你的,需要你做下载的操作
filename 告诉浏览器下载文件的名字
3) 乱码的问题,当将文件的名字设置为中文,浏览器正常显示文件的名字。
因为从服务器向浏览器发送中文时,需要对内容进行URL编码。
> 大部分浏览器使用如下方式即可解决乱码问题:URLEncoder.encode(fileName, "utf-8");
> 但是火狐默认以Base64来解码的,所以要为火狐单独处理。
> 可以使用如下代码来判断浏览器的类型,然后进行不同的编码处理
1 //判断当前浏览器是否为火狐 2 3 if(ua.contains("Firefox")){ 4 5 //是火狐浏览器,使用BASE64编码 6 7 fileName = "=?utf-8?b?"+new BASE64Encoder().encode(fileName.getBytes("utf-8"))+"?="; 8 9 }else{ 10 11 //给文件名进行URL编码 12 13 //URLEncoder.encode()需要两个参数,第一个参数时要编码的字符串,第二个是编码所采用的字符集 14 15 fileName = URLEncoder.encode(fileName, "utf-8"); 16 17 }
> 还有一种不太讲理的方式,谁问跟谁急。反正好使
- 向将字符串用gbk进行解码,然后在使用iso8859-1进行编码
fileName = new String(fileName.getBytes("gbk"),"iso8859-1");
3.案例
[1]文件上传:
(1)原生方法实现文件上传
1 public void testUpload(CommonsMultipartFile file,HttpServletRequest request){ 2 //声明输入流和输出流 3 InputStream in=null;OutputStream out=null; 4 //获取ServletContext 5 ServletContext servletContext=request.getServletContext(); 6 //获取文件目录全路径 7 String realPath = servletContext.getRealPath("/WEB-INF/upload"); 8 //获取文件名 9 String fileName=file.getOriginalFilename(); 10 //声明唯一标识,保证每次上传保存的文件名不同,从而使每次上传都可以成功,即使是相同的文件或资源 11 UUID id=UUID.randomUUID(); 12 //将唯一标识与原文件名相加生成新资源文件名 13 fileName=id+"_"+fileName; 14 //通过文件目录全路径新建一个文件对象 15 File file1=new File(realPath); 16 //判断文件目录是否存在 17 if(!file1.exists()){ 18 //如果不存在,则创建目录文件夹 19 file1.mkdirs(); 20 21 } 22 23 try { 24 //设置输入流与输出流 25 in=file.getInputStream(); 27 out=new FileOutputStream(new File(realPath+"\\"+fileName)); 28 //设置缓冲区 29 byte[] buffer=new byte[1024]; 30 31 int len=0; 32 //判断文件资源是否输入完,如果输入晚,则len==-1 33 while((len=in.read(buffer))!=-1){ 34 //通过输出流写入文件 35 out.write(buffer, 0, len); 36 37 } 38 //这是简便方法直接可以将输入流写入输出流 39 /*IOUtils.copy(in, out);*/ 40 41 } catch (IOException e) { 42 43 // TODO Auto-generated catch block 44 45 e.printStackTrace(); 46 47 }finally{ 48 //关闭输入流 49 if(in!=null){ 50 51 try { 52 53 in.close(); 54 55 } catch (IOException e) { 56 57 // TODO Auto-generated catch block 58 59 e.printStackTrace(); 60 61 } 62 63 } 64 //关闭输出流 65 if(out!=null){ 66 67 try { 68 69 out.close(); 70 71 } catch (IOException e) { 72 73 // TODO Auto-generated catch block 74 75 e.printStackTrace(); 76 77 } 78 79 } 80 81 } 82 83 }
(2)通过fileItem实现文件上传
1 protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { 2 3 DiskFileItemFactory dFactory=new DiskFileItemFactory(); 4 5 ServletFileUpload sUpload=new ServletFileUpload(dFactory); 6 7 sUpload.setHeaderEncoding("UTF-8"); 8 9 try { 10 11 sUpload.setFileSizeMax(1024*50);//设置单个上传文件的大小 12 13 sUpload.setSizeMax(1024*1024);//设置总上传文件的大小 14 15 List<FileItem> list = sUpload.parseRequest(request); 16 17 for(FileItem f:list){ 18 19 if(f.isFormField()){ 20 21 String name = f.getFieldName(); 22 23 String string = f.getString(); 24 25 System.out.println(name+":"+string); 26 27 } 28 29 else { 30 31 //获取文件名 32 33 String fileName = f.getName(); 34 35 if(fileName.contains("\\")){ 36 37 fileName = fileName.substring(fileName.lastIndexOf("\\")+1); 38 39 } 40 41 //获取上传路径 42 43 String realPath = getServletContext().getRealPath("/WEB-INF/upload"); 44 45 //检查upload文件夹是否存在,如果不存在则创建 46 47 System.out.println(realPath); 48 49 File file = new File(realPath); 50 51 if(!file.exists()){ 52 53 file.mkdirs(); 54 55 }; 56 57 //为避免重名生成一个uuid作为文件名的前缀 58 59 String prefix = UUID.randomUUID().toString().replace("-", ""); 60 61 //将文件写入到服务器中 62 63 f.write(new File(realPath+"/"+prefix+"_"+fileName)); 64 65 //清楚文件缓存 66 67 f.delete(); 68 69 } 70 71 } 72 73 } catch(FileSizeLimitExceededException e){ 74 75 System.out.println("文件内容太大,无法上传"); 76 77 }catch ( Exception e) { 78 79 // TODO Auto-generated catch block 80 81 e.printStackTrace(); 82 } 83 }
[2]文件下载:
protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { // TODO Auto-generated method stub ServletContext servletContext=request.getServletContext(); String fileName="风吹麦浪.mp3"; String path = servletContext.getRealPath("WEB-INF/"+fileName); File file=new File(path); String type = servletContext.getMimeType(path); InputStream inputStream=new FileInputStream(file); response.setContentType(type); fileName=new String(fileName.getBytes("gbk"),"iso8859-1"); response.setHeader("Content-Disposition","attachment;filename="+fileName); ServletOutputStream outputStream=response.getOutputStream(); IOUtils.copy(inputStream, outputStream); }