java组件实现文件上传功能 java组件SmartUpload和FileUpload实现文件上传功能
bug诗 人气:0本文为大家分享了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>
以上代码中，首先会将所有的上传文件设置到临时文件夹中；
如果发现取得的表单是上传文件，则使用InputStream，从FileItem类中取得文件的输入流；
在使用OutputStream将内容依次取出，保存在具体的文件路径中；
FileUpload在建的不便之处：
1 无法像使用request.getParameter()方法那样准确地取得提交的参数；
2 无法像使用request.getParameterValues()那样准确的取得一组提交参数；
3 所有的上传文件度需要进行一次的判断，才能够分别保存，不能一次性批量保存；
加载全部内容