您的位置:首页 > 编程语言 > Java开发

Java带进度条的文件上传

2016-02-04 04:49 483 查看

工作原理:

实时显示上传进度的原理是服务器在处理上传文件的同时,将上传进度的信息例如文件总长度、以上传多少、传输速率等写入Session中。客户浏览器利用Ajax技术再新开一个独立的线程从Session中获取上传进度信息,并实时显示。Ajax技术能够不断刷新页面获取服务器数据。Session课看作是服务器内存,可用于存放少量的客户信息。需要使用commons-fileupload-1.2.1.jar与commons-io-1.4.jar包。

上传进度条:

上传进度条用两个
标签实现,通过控制的css属性就可以显示一个HTML版的进度条。标签连同css样式、JavaScript脚本、Ajax技术,可以实现非常丰富的效果,代码为:

upload.jsp

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>上传文件</title>
<meta http-equiv="keywords" content="keyword1,keyword2,keyword3">
<meta http-equiv="description" content="this is my page">
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<link rel="stylesheet" type="text/css" href="css/style.css">
</head>

<body>
<form action="servlet/UploadServlet" method="post" enctype="multipart/form-data">
<div align="center"><br/>
<fieldset style="width:90%">
<legend>上传文件</legend><br/>
<div class='line'>
<div align='left' class="leftDiv">上传文件一</div>
<div align='left' class="rightDiv">
<input type="file" name="file1" class="text">
</div>
</div>
<div class='line'>
<div align='left' class="leftDiv">上传文件二</div>
<div align='left' class="rightDiv">
<input type="file" name="file2" class="text">
</div>
</div>
<div class='line'>
<div align='left' class="leftDiv">上传文件说明一</div>
<div align='left' class="rightDiv"><input type="text" name="description1" class="text"></div>
</div>
<div class='line'>
<div align='left' class="leftDiv">上传文件说明二</div>
<div align='left' class="rightDiv"><input type="text" name="description2" class="text"></div>
</div>
<div class='line'>
<div align='left' class="leftDiv"></div>
<div align='left' class="rightDiv"><br/>
<input type="submit" value="  上传文件  " class="button">
</div>
</div>
</fieldset>
</div>
</form>
</body>
</html>


要控制进度条的显示进度,只需要用JavaScript控制ID为progressBarItem的百分比宽度。

上传监听器:

commons-fileupload版本1.2支持上传监听,只需要实现一个监听器,并把它添加到上传组件即可。监听器需要实现它的ProgressListener接口,代码如下:

UploadListener.java

package com.helloweenvsfei.servlet.upload;

import org.apache.commons.fileupload.ProgressListener;

public class UploadListener implements ProgressListener {

private UploadStatus status;

public UploadListener(UploadStatus status) {
this.status = status;
}

public void update(long bytesRead, long contentLength, int items) {
status.setBytesRead(bytesRead);
status.setContentLength(contentLength);
status.setItems(items);
}
}


ProgressListener接口只有一个方法:upload(long bytesRead,long contentLength,int items).参数byteRead表示已经上传的字节数,contentLength表示上传的总长度(如果为-1则表示总长度未知),items表示正在上传第几个文件。

添加监听该监听器后,上传组件在上传文件的时会不断回调该方法,回传这些数据。利用这些数字,就可以计算出文件上传的进度,用进度条实时显示出来。因此需要把这些数据保存起来。代码中把数据保存到了一个UploadStatus中。这是一个普通的JavaBean,代码如下:

UploadStatus.java

package com.helloweenvsfei.servlet.upload;

public class UploadStatus {

private long bytesRead;

private long contentLength;

private int items;

private long startTime = System.currentTimeMillis();

public long getBytesRead() {
return bytesRead;
}

public void setBytesRead(long bytesRead) {
this.bytesRead = bytesRead;
}

public long getContentLength() {
return contentLength;
}

public void setContentLength(long contentLength) {
this.contentLength = contentLength;
}

public int getItems() {
return items;
}

public void setItems(int items) {
this.items = items;
}

public long getStartTime() {
return startTime;
}

public void setStartTime(long startTime) {
this.startTime = startTime;
}

}


UploadStatus中还记录了开始上传的时间,用于计算上传速率、估计上传总时间等。

监听上传进度:

处理文件上传的Servlet为ProgressUploadServlet.监听伤处过程需要为ServeltFileUpload安装一个监听器,然后把存有上传进度信息的UploadSatus对象放进Session。上传文件使用的是Post方法,因此需要把代码写到doPost()方法中.


现在使用ProgressUploadServlet来处理文件上传,就能获得到上传开始时间、已上传的字节数、正在上传第几个文件等信息了。只不过这些信息还保存在Session里,需要再写一个程序读取出来。

读取上传进度:

上传进度保存在Session中的UploadStatus属性中,从该属性中获取UploadStatus对象,并将上传进度信息读取出来。上传文件只会使用ProgressUploadServletd的doPost()方法而没有占用doGet()方法,因此这里使用doGet()方法来读取上传进度。也就是说,如果以Post方式访问ProgressUploadServlet,会执行上传代码;如果以Get方式访问ProgressUploadServlet,会执行读取上传进度的代码。

根据上传开始时间、已上传字节数、总的字节数等原始数据,可以计算出已传输时间、传输速率、传输总时间、剩余时间、已完成百分比等。这些数据最终要被Ajax程序读取、以进度条形式显示,因此最后将他们用分隔符“||”分开,便于程序处理。

现在上传文件时用快捷键Ctrl+N新开一个子窗口访问ProgressUploadServlet,就可以看到文字版的上传进度。不断刷新,就能不断地更新。不过手工查看上传进度太笨拙了,下一步要写一个Ajax程序,自动获取该Servlet返回的数据、将数据显示在进度条上,并且每一秒自动更新一次。

显示上传进度:

上传文件时,如果不对表单做特别处理,提交表单后会转到另一个页面,造成页面的刷新。而且新页面显示之前,浏览器会因等待而显示白屏。如果上传的文件很大,白屏时间会很长。因此需要对表单做一些特别处理,使提交表单后的原页面内容不变,同时显示进度条,知道文件上传结束,从而避免出现白屏。方式更改Form的target属性。代码如下:
progressUpload.jsp


<%@ page language="java" contentType="text/html; charset=UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
<style type="text/css">
body, td, div {font-size: 12px; font-familly: 宋体; }
#progressBar {width: 400px; height: 12px; background: #FFFFFF; border: 1px solid #000000; padding: 1px; }
#progressBarItem {width: 30%; height: 100%; background: #FF0000; }
</style>
</head>

<body>

<iframe name=upload_iframe width=0 height=0></iframe>

<form action="servlet/ProgressUploadServlet" method="post" enctype="multipart/form-data" target="upload_iframe" onsubmit="showStatus(); ">

<input type="file" name="file1" style="width: 350px; "> <br />
<input type="file" name="file2" style="width: 350px; "> <br />
<input type="file" name="file3" style="width: 350px; "> <br />
<input type="file" name="file4" style="width: 350px; "> <input type="submit"
value=" 开始上传 " id="btnSubmit"></form>

<div id="status" style="display: none; ">
上传进度条:
<div id="progressBar"><div id="progressBarItem"></div></div>
<div id="statusInfo"></div>
</div>

<br/>
<br/>
<br/>
<br/>
<br/>

<script type="text/javascript">

var _finished = true;

function $(obj){
return document.getElementById(obj);
}

function showStatus(){
_finished = false;
$('status').style.display = 'block';
$('progressBarItem').style.width = '1%';
$('btnSubmit').disabled = true;

setTimeout("requestStatus()", 1000);
}

function requestStatus(){

if(_finished)   return;

var req = createRequest();

req.open("GET", "servlet/ProgressUploadServlet");
req.onreadystatechange=function(){callback(req);}
req.send(null);

setTimeout("requestStatus()", 1000);
}

function createRequest()
{
if(window.XMLHttpRequest)//ns
{
return new XMLHttpRequest();
}else//IE
{
try{
return new ActiveXObject("Msxml2.XMLHTTP");
}catch(e){
return new ActiveXObject("Microsoft.XMLHTTP");
}
}
return null;
}
function callback(req){

if(req.readyState == 4) {
if(req.status != 200){
_debug("发生错误。 req.status: " + req.status + "");
return;
}

_debug("status.jsp 返回值:" + req.responseText);

var ss = req.responseText.split("||");

// 格式:百分比||已完成数(M)||文件总长度(M)||传输速率(K)||已用时间(s)||估计总时间(s)||估计剩余时间(s)||正在上传第几个文件
$('progressBarItem').style.width = '' + ss[0] + '%';
$('statusInfo').innerHTML = '已完成百分比: ' + ss[0] + '% <br />已完成数(M): ' + ss[1] + '<br/>文件总长度(M): ' + ss[2] + '<br/>传输速率(K): ' + ss[3] + '<br/>已用时间(s): ' + ss[4] + '<br/>估计总时间(s): ' + ss[5] + '<br/>估计剩余时间(s): ' + ss[6] + '<br/>正在上传第几个文件: ' + ss[7];

if(ss[1] == ss[2]){
_finished = true;
$('statusInfo').innerHTML += "<br/><br/><br/>上传已完成。";
$('btnSubmit').disabled = false;
}
}
}
function _debug(obj){
var div = document.createElement("DIV");
div.innerHTML = "[debug]: " + obj;
document.body.appendChild(div);
}

</script>

</body>
</html>


target属性默认为_self.如果target为默认值,则提交后的新页面会在当前窗口显示,造成当前窗口短暂地白屏。在页面内添加一个隐藏的iframe(通过制定iframe的宽高为0实现隐藏),把target属性指定为该iframe,则提交后的新页面会在iframe内显示,iframe内会短暂白屏。因为iframe是隐藏的,所以上传文件的时候当前页面看不到任何变化。

注意上传文件的表单要指定method=”POST”与enctype=”multipart/form-data”.另外为表单添加一个onsubmit=”showStatus();”事件,表单提交时会执行页面内的showStatus()方法。这是一段JavaScript程序代码。该方法显示进度条,并用Ajax读取Session里保存的上传进度,实时刷新进度条。showStatus()如上代码所示。

Ajax能够不刷新页面改变页面内容。它的原理是创建一个request,用这个request获取其他页面内容,并显示到页面上。因为没有在浏览器上输入新的地址,所以页面不会有刷新、抖动等。

Ajax的核心就是这个request,学名为XMLHttpRequest,需要浏览器支持。目前所有的主流的浏览器都能提供XMLHttpRequest.

progressUpload.jsp代码如下:

<%@ page language="java" contentType="text/html; charset=UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
<style type="text/css">
body, td, div {font-size: 12px; font-familly: 宋体; }
#progressBar {width: 400px; height: 12px; background: #FFFFFF; border: 1px solid #000000; padding: 1px; }
#progressBarItem {width: 30%; height: 100%; background: #FF0000; }
</style>
</head>

<body>

<iframe name=upload_iframe width=0 height=0></iframe>

<form action="servlet/ProgressUploadServlet" method="post" enctype="multipart/form-data" target="upload_iframe" onsubmit="showStatus(); ">

<input type="file" name="file1" style="width: 350px; "> <br />
<input type="file" name="file2" style="width: 350px; "> <br />
<input type="file" name="file3" style="width: 350px; "> <br />
<input type="file" name="file4" style="width: 350px; "> <input type="submit"
value=" 开始上传 " id="btnSubmit"></form>

<div id="status" style="display: none; ">
上传进度条:
<div id="progressBar"><div id="progressBarItem"></div></div>
<div id="statusInfo"></div>
</div>

<br/>
<br/>
<br/>
<br/>
<br/>

<script type="text/javascript">

var _finished = true;

function $(obj){
return document.getElementById(obj);
}

function showStatus(){
_finished = false;
$('status').style.display = 'block';
$('progressBarItem').style.width = '1%';
$('btnSubmit').disabled = true;

setTimeout("requestStatus()", 1000);
}

function requestStatus(){

if(_finished)   return;

var req = createRequest();

req.open("GET", "servlet/ProgressUploadServlet");
req.onreadystatechange=function(){callback(req);}
req.send(null);

setTimeout("requestStatus()", 1000);
}

function createRequest()
{
if(window.XMLHttpRequest)//ns
{
return new XMLHttpRequest();
}else//IE
{
try{
return new ActiveXObject("Msxml2.XMLHTTP");
}catch(e){
return new ActiveXObject("Microsoft.XMLHTTP");
}
}
return null;
}
function callback(req){

if(req.readyState == 4) {
if(req.status != 200){
_debug("发生错误。 req.status: " + req.status + "");
return;
}

_debug("status.jsp 返回值:" + req.responseText);

var ss = req.responseText.split("||");

// 格式:百分比||已完成数(M)||文件总长度(M)||传输速率(K)||已用时间(s)||估计总时间(s)||估计剩余时间(s)||正在上传第几个文件
$('progressBarItem').style.width = '' + ss[0] + '%';
$('statusInfo').innerHTML = '已完成百分比: ' + ss[0] + '% <br />已完成数(M): ' + ss[1] + '<br/>文件总长度(M): ' + ss[2] + '<br/>传输速率(K): ' + ss[3] + '<br/>已用时间(s): ' + ss[4] + '<br/>估计总时间(s): ' + ss[5] + '<br/>估计剩余时间(s): ' + ss[6] + '<br/>正在上传第几个文件: ' + ss[7];

if(ss[1] == ss[2]){
_finished = true;
$('statusInfo').innerHTML += "<br/><br/><br/>上传已完成。";
$('btnSubmit').disabled = false;
}
}
}
function _debug(obj){
var div = document.createElement("DIV");
div.innerHTML = "[debug]: " + obj;
document.body.appendChild(div);
}

</script>

</body>
</html>


运行效果如图所示:

内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: