Home > Article > Java > How do the java components SmartUpload and FileUpload implement the file upload function?

How do the java components SmartUpload and FileUpload implement the file upload function?

王林forward: 2023-05-12 15:04:061082browse

1 SmartUpload上传组件

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

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

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

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

上传单个文件

要进行上传，必须使用HTML中提供给的file空间，而且

必须使用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");%>
<h3>姓名：<%=name%></h3>
<h3>request无法取得 ： <%=request.getParameter("uname")%> </h3>
</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)$")%>
<h3>姓名：<%=name%></h3>
<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组织提供的免费上传组件，可以直接从站点进行下载；

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 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><h5><%=fieldName%> --> <%=item.isFormField()%></h5>
<%
    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><h5><%=fieldName%> --> <%=item.isFormField()%></h5>
<%
    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 所有的上传文件度需要进行一次的判断，才能够分别保存，不能一次性批量保存；

The above is the detailed content of How do the java components SmartUpload and FileUpload implement the file upload function?. For more information, please follow other related articles on the PHP Chinese website!

Java html 封装循环对象 this apache http

Statement：

This article is reproduced at:yisu.com. If there is any infringement, please contact admin@php.cn delete

Previous article：How to use @Configuration and @bean annotations in SpringbootNext article：How to use @Configuration and @bean annotations in Springboot

See more

How do the java components SmartUpload and FileUpload implement the file upload function?

Related articles