你的位置:首页 > Java教程

[Java教程]文件上传

1 SmartUpload上传组件

SmartUpload上传组件包,可以轻松的实现文件的上传和下载功能;

使用简单,实现上传文件类型的限制,也可以轻易的取得上传文件的名称、后缀、大小等;

SmartUpload本身是系统提供的jar包,将此包考入到lib文件夹中;

此组件的提供方网站已关闭,SmartUpload在非框架中开发中较为好用;

上传单个文件

要进行上传,必须使用HTML中提供给的file空间,而且<form>必须使用enctype属性进行封装;

smartupload_demo01.html : 上传表单

<html><head><title>上传表单</title></head><body><form action="smartupload_demo01.jsp" method="post" enctype="multipart/form-data"> 请选择要上传的文件:<input type="file" name="pic"> <input type="submit" value="上传"></form></body></html>

在form上使用enctype进行了表单封装,表示表单将按二进制的方式提交,即所有的表单此时不在是分别提交,而是将所有的内容都按照二进制的方式提交;

smartupload_demo01.jsp : 接收图片,保存在根目录中的upload文件夹中

<%@ page contentType="text/html" pageEncoding="GBK"%><%@ page import="org.bug.smart.*"%><html><head><title>接收图片,保存在根目录中的upload文件夹中</title></head><body><% SmartUpload smart = new SmartUpload() ; smart.initialize(pageContext) ; // 初始化上传操作 smart.upload() ;   // 上传准备 smart.save("upload") ; // 文件保存%></body></html>

使用SmartUpload时必须严格按照如上程序进行,最后在保存时只是写了一个upload,表示上传文件的保存文件夹,此文件要在根目录中手工建立;

保存的名称和上传的文件一样,所以如果出现相同的文件名称,将出现覆盖的情况;

混合表单

当一个表单使用了enctyoe封装后,其它文件类的表单控件的内容将无法通过request内置对象取得;

此时,必须通过SmartUpload类中提供的getRequest()方法取得全部的请求参数;

smartupload_demo02.html ; 混合表单

<html><head><title>混合表单</title></head><body><form action="smartupload_demo02.jsp" method="post" enctype="multipart/form-data"> 姓名:<input type="text" name="uname"><br> 照片:<input type="file" name="pic"><br> <input type="submit" value="上传"> <input type="reset" value="重置"></form></body></html>

以上表单中包含了文本和文件两个控件;

smartupload_demo02.jsp : 接收封装表单的文本数据

<%@ page contentType="text/html" pageEncoding="GBK"%><%@ page import="org.bug.smart.*"%><%@ page import="cn.com.bug.util.*"%><html><head><title>接收封装表单的文本数据</title></head><body><% request.setCharacterEncoding("GBK") ;%><% SmartUpload smart = new SmartUpload() ; smart.initialize(pageContext) ; // 初始化上传操作 smart.upload() ;   // 上传准备 String name = smart.getRequest().getParameter("uname") ; smart.upload("upload");%><h2>姓名:<%=name%></h2><h2>request无法取得 : <%=request.getParameter("uname")%> </h2>
</body></html>

表单进行了二进制封装,单靠request对象是无法取得提交参数的,必须依靠SmartUpload类中的getRequest().getParameter()方法才能取得请求的参数;

由于是通过SmartUpload完成参数接收,所以smart.getRequest()方法一定要在执行完upload()方法后才可使用;

为上传文件自动命名

为了解决文件名称相同而出现覆盖的情况,可以采用为上传文件自动命名的方式;

自动命名可采用格式: IP地址+时间戳+三位随机数

IPTimeStamp.java : 定义取得IP时间戳的操作类

package cn.com.bug.util ;import java.text.SimpleDateFormat ;import java.util.Date ;import java.util.Random ;public class IPTimeStamp { private SimpleDateFormat sdf = null ; //定义SimpleDateFormat对象 private String ip = null ; //接收IP地址 public IPTimeStamp(){ } public IPTimeStamp(String ip){ //得到IP地址+时间戳+三位随机数  this.ip = ip ; } public String getIPTimeRand(){  StringBuffer buf = new StringBuffer() ; //实例化StringBuffer对象  if(this.ip != null){   String s[] = this.ip.split("\\.") ; //进行拆分操作   for(int i=0;i<s.length;i++){ //循环设置IP地址    buf.append(this.addZero(s[i],3)) ; //不够三位要补0   }  }  buf.append(this.getTimeStamp()) ; //取得时间戳  Random r = new Random() ; //定义Random对象,已产生随机数  for(int i=0;i<3;i++){ //循环三次   buf.append(r.nextInt(10)) ; //增加随机数  }  return buf.toString() //返回名称 } public String getDate(){ //取得当前系统的时间  this.sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss.SSS") ;  return this.sdf.format(new Date()) ; } public String getTimeStamp(){ //取得时间戳  this.sdf = new SimpleDateFormat("yyyyMMddHHmmssSSS") ;  return this.sdf.format(new Date()) ; } private String addZero(String str,int len){ //补0操作  StringBuffer s = new StringBuffer() ;  s.append(str) ;  while(s.length() < len){   s.insert(0,"0") ;  }  return s.toString() ; } public static void main(String args[]){  System.out.println(new IPTimeStamp("192.168.1.1").getIPTimeRand()) ; }}

直接修改上传的操作页,在上传的操作页中不直接使用save()方法保存;

而是取得一个具体上传文件对象才可以保存,由于上传文件时文件的后缀需要统一,所以可以使用getFileExt()方法取得文件的后缀;

smartupload_demo02.jsp : 增加自动命名的功能;

<%@ page contentType="text/html" pageEncoding="GBK"%><%@ page import="org.bug.smart.*"%><%@ page import="cn.com.bug.util.*"%><html><head><title>修改后的smartuoload.jsp</title></head><body><% request.setCharacterEncoding("GBK") ;%><% SmartUpload smart = new SmartUpload() ; smart.initialize(pageContext) ; // 初始化上传操作 smart.upload() ;   // 上传准备 String name = smart.getRequest().getParameter("uname") ; IPTimeStamp its = new IPTimeStamp(request.getRemoteAddr()) ; // 取得客户端的IP地址 String ext = smart.getFiles().getFile(0).getFileExt() ; // 扩展名称 String fileName = its.getIPTimeRand() + "." + ext ; smart.getFiles().getFile(0).saveAs(this.getServletContext().getRealPath("/")+"upload"+java.io.File.separator + fileName) ;%><%=smart.getFiles().getFile(0).getFileName().matches("^\\w+.(jpg|gif)$")%><h2>姓名:<%=name%></h2><img src="../upload/<%=fileName%>"></body></html>

由于SmartUpload可以同时接收多个文件;

此时通过smart.getFiles().getFile(0).getFileExt()取得第一个上传文件的文件后缀,在与之前IPTimeStampl类生成的文件名称一起拼凑出一个新的文件名;

此时要用的新的文件名称保存上传文件,所以要通过smart.getFiles().getFile(0).saveAs()方法进行收工保存;

以上代码没有对上传文件的类型进行限制,可以通过正则判断文件的后缀是否合法;

eg:验证上传文件的合法性代码片段

if(smart.getFiles().getFile(0).getFileName().matches("^\\w+\\.(jsp|gif)$")){  //表示只允许后缀为jpg或gif的文件上传;}

批量上传

 smart.getFiles().getFile(0).saveAs(this.getServletContext().getRealPath("/")+"upload"+java.io.File.separator + fileName) ;

以上证明可以一次性提交多个上传文件;

smartupload_demo03.jsp : 编写表单,上传3个文件

<html><head><title>编写表单,上传3个文件</title></head><body><form action="smartupload_demo03.jsp" method="post" enctype="multipart/form-data"> 照片1:<input type="file" name="pic1"><br> 照片2:<input type="file" name="pic2"><br> 照片3:<input type="file" name="pic3"><br> <input type="submit" value="上传"> <input type="reset" value="重置"></form></body></html>

如果要完成批量上传,则肯定要使用循环的方式进行,必须通过以下方式取得上传文件数量;

取得上传文件的数量:smart.getFiles().getCount();

smartupload_demo03.jsp : 批量上传

<%@ page contentType="text/html" pageEncoding="GBK"%><%@ page import="org.bug.smart.*"%><%@ page import="cn.com.bug.util.*"%><html><head><title>批量上传</title></head><body><% request.setCharacterEncoding("GBK") ;%><% SmartUpload smart = new SmartUpload() ; smart.initialize(pageContext) ; // 初始化上传操作 smart.upload() ;   // 上传准备 String name = smart.getRequest().getParameter("uname") ; IPTimeStamp its = new IPTimeStamp(request.getRemoteAddr()) ; // 取得客户端的IP地址 for(int x=0;x<smart.getFiles().getCount();x++){  String ext = smart.getFiles().getFile(x).getFileExt() ; // 扩展名称  String fileName = its.getIPTimeRand() + "." + ext ;  smart.getFiles().getFile(x).saveAs(this.getServletContext().getRealPath("/")+"upload"+java.io.File.separator + fileName) ; }%></body></html>

 

2 FileUpload

FileUpload是Apache组织提供的免费上传组件,可以直接从站点进行下载 : 上传表单

<html><head><title>上传表单</title></head><body><form action="fileupload_demo01.jsp" method="post" enctype="multipart/form-data">  姓名:<input type="text" name="uname"><br> 照片:<input type="file" name="pic"><br> <input type="submit" value="上传"> <input type="reset" value="重置"></form></body></html>

FileUpload的具体上传操作与SmartUpload相比有着很高的复杂度;

以下是FileUpload上传的步骤:

   1 创建磁盘工厂:DiskFileItemFactory factory = new DiskFileFactory();

   2 创建处理工具:ServletFileUpload upload =new ServletFileUpload(factory);

   3 设置文件的上传大小:upload.setFileSizeMax(3145728); 

   4 接收全部的内容:List<FileItem> items = upload.parseRequest(request);

FileUpload对所有的上传内容都采用同样的方式操作;

与SmartUpload不同的是,会将所有的上传内容一起(包括文件和普通参数)接收;

所以需要依次判断你每一次上传的内容是文件还是普通文本;

fileupload_demo01.jsp : 接收上传文件

<%@ page contentType="text/html" pageEncoding="GBK"%><%@ page import="java.util.*"%><%@ page import="org.apache.commons.fileupload.*"%><%@ page import="org.apache.commons.fileupload.disk.*"%><%@ page import="org.apache.commons.fileupload.servlet.*"%><html><head><title>接收上传文件</title></head><body><% DiskFileItemFactory factory = new DiskFileItemFactory() ; ServletFileUpload upload = new ServletFileUpload(factory) ; upload.setFileSizeMax(3 * 1024 * 1024) ; // 只能上传3M List<FileItem> items = upload.parseRequest(request) ; // 接收全部内容 Iterator<FileItem> iter = items.iterator() ;//将全部的内容变为Iterator实例 while(iter.hasNext()){ //依次取出每一个内容  FileItem item = iter.next() ; //取出每一个上传的文件  String fieldName = item.getFieldName() ; // 取得表单控件的名称%>  <ul><h4><%=fieldName%> --> <%=item.isFormField()%></h4><%  if(!item.isFormField()){  // 不是普通文本   String fileName = item.getName() ; // 取得文件的名称   String contentType = item.getContentType() ; // 文件类型   long sizeInBytes = item.getSize() ;//文件大小%>   <li>上传文件名称:<%=fileName%>   <li>上传文件类型:<%=contentType%>   <li>上传文件大小:<%=sizeInBytes%><%  } else {   String value = item.getString() ;%>   <li>普通参数:<%=value%><%  }%>  </ul><% }%></body></html>

FileUpload组件接收完全部的数据后,所有的数据都保存在List集合中,则需要使用Iterator取出每一个数据;

但是由于其中既有普通的文本数据又有上传的文件,每一个上传内容都使用一个FileItem类对象表示;

所以当使用Iterator依次取出每一个FileItem对象时,就可以使用FileItem类中的isFormField()方法来判断当前操作的内容是普通的文本还是附件上传;

如果是上传文件,则将文件的内容依次取出;如果是普通的文本,则直接通过getString()方法取得具体的信息;

保存上传内容

以上完成了接收上传文件内容的操作,但是所上传的文件现在并没有真正的保存在服务器上;

而要进行文件的保存,在FileUpload中就必须通过java.io包中InputStream和outputStream两个类完成文件的自动命名操作;

InputStream和OutputStream为两个抽象类,必须依靠FileInputStream和OutputStream类进行对象的实例化操作;

fileupload_demo02.html : 定义上传表单,可以同时上传多个文件

<html><head><title>定义表单,可以同时上传多个文件</title></head><body><form action="fileupload_demo02.jsp" method="post" enctype="multipart/form-data">  姓名:<input type="text" name="uname"><br> 照片:<input type="file" name="pic1"><br> 照片:<input type="file" name="pic2"><br> 照片:<input type="file" name="pic3"><br> <input type="submit" value="上传"> <input type="reset" value="重置"></form></body></html>

fileupload_demo02.jsp : 保存上传的内容

<%@ page contentType="text/html" pageEncoding="GBK"%><%@ page import="java.util.*,java.io.*"%><%@ page import="org.apache.commons.fileupload.*"%><%@ page import="org.apache.commons.fileupload.disk.*"%><%@ page import="org.apache.commons.fileupload.servlet.*"%><%@ page import="cn.com.bug.util.*"%><html><head><title>保存上传内容</title></head><body><% DiskFileItemFactory factory = new DiskFileItemFactory() ; factory.setRepository(new File(this.getServletContext().getRealPath("/") + "uploadtemp")) ;  // 设置一个临时文件 ServletFileUpload upload = new ServletFileUpload(factory) ; upload.setFileSizeMax(3 * 1024 * 1024) ; // 只能上传3M List<FileItem> items = upload.parseRequest(request) ; // 接收全部内容 Iterator<FileItem> iter = items.iterator() ; //将全部的内容转换为Iterator实例 IPTimeStamp its = new IPTimeStamp(request.getRemoteAddr()) ;//实例化IP时间戳对象 while(iter.hasNext()){//依次取出每一个内容  FileItem item = iter.next() ; //取出每一个上传的文件  String fieldName = item.getFieldName() ; // 取得表单控件的名称%>  <ul><h4><%=fieldName%> --> <%=item.isFormField()%></h4><%  if(!item.isFormField()){  // 不是普通文本,是上传文件   File saveFile = null ;  //定义保存的文件   InputStream input = null ;   OutputStream output = null ;   input = item.getInputStream() ;   output = new FileOutputStream(new File(this.getServletContext().getRealPath("/")+"upload"+File.separator+its.getIPTimeRand()+               "."+item.getName().split("\\.")[1])) ;//定义输入文件的路径   int temp = 0 ;   byte data[] = new byte[512] ;   while((temp=input.read(data,0,512))!=-1){ //依次读取内容    output.write(data) ; // 分块保存   }   input.close() ;   output.close() ;  } else {   String value = item.getString() ;//取出表单的内容%>   <li>普通参数:<%=value%><%  }%>  </ul><% }%></body></html>

以上代码中,首先会将所有的上传文件设置到临时文件夹中;

如果发现取得的表单是上传文件,则使用InputStream,从FileItem类中取得文件的输入流;

在使用OutputStream将内容依次取出,保存在具体的文件路径中;

 

FileUpload在建的不便之处:

1 无法像使用request.getParameter()方法那样准确地取得提交的参数;

2 无法像使用request.getParameterValues()那样准确的取得一组提交参数;

3 所有的上传文件度需要进行一次的判断,才能够分别保存,不能一次性批量保存;