java组件SmartUpload和FileUpload实现文件上传功能

本文为大家分享了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组织提供的免费上传组件，可以直接从站点进行下载（http://commons.apache.org/fileupload/）；

FileUpload组件本身依赖于Commons组件包，所以从Apache下载此组件的同时连同Commons组件的IO包一起下载（http://commons.apache.org/io）；

Commons组件包在很多框架开发中都可以直接使用，此包中提供了大量开发类可作为java的有力补充；

将Commons-fileupload-1.2.1.jar和Common-io-1.4.jar配置到lib文件夹中；

使用FileUpload接收上传内容

不论是使用SmartUpload和FileUpload进行上传操作，都是依靠HTML的file控件完成的；

fileupload_demo01.html : 上传表单

									<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>