利用 DWR 开发基于 Ajax 的文件上载 portlet-1
|
- UID
- 1066743
|
利用 DWR 开发基于 Ajax 的文件上载 portlet-1
简介Web 门户为用户提供了访问各种资源和服务的中心网关。与此同时，它们还为用户提供了与其他用户进行资源共享的平台。从照片到音频、视频文件再到研究用的科学数据集，用户可以共享任何内容。因此，文件上载是 Web 门户的一种基本的必备功能。
当今的 Web 门户在很大程度上依赖于 Java portlet 技术。虽然很多使用 Ajax 的开发人员都给出了各种各样的文件上载进度条解决方案，但我们还没有听说过哪个是基于 portlet 的。本文展示了如何开发基于 Ajax 的文件上载 portlet，此 portlet 能显示文件上载过程的进度条。此 portlet 对于那些想要共享大型音频、视频和科学文件的人士尤其有用。
要跟上本文的进度，您应该对使用 Java Servlets 和 JavaServer Pages (JSPs) 进行 Web 开发十分熟悉。而且，还必须了解门户和 portlet 技术的开发。当然，如果您对 portlet 技术还不怎么精通，也不要现在就放弃本文，因为您会在本文中看到对 portlet 技术的简单介绍，以及一些有用的资源可用来帮助您加快学习的进程。
developerWorks Ajax 资源中心
请访问 ，这里几乎囊括了关于 Ajax 编程模型的所有信息，包括各种文章和教程、论坛、博客、wikis、活动和新闻。
在测试本文给出的这个文件上载 portlet 前，可以考虑尝试使用一种遵从 JSR 168 规范的门户框架，比如 IBM® WebSphere® Portal Server、Apache Pluto、eXo 平台或 Liferay Portal。我们在本文中使用的是 Apache Pluto 1.0.1、JDK 5.0 Update 10 和 Apache Ant Version 1.6.5。
portlet 的基本概念一般地，可以将 portlet 视为一种 Web 组件。Portlet 与 servlet 类似，但前者更关注于应用程序的表示层。portlet 的典型输出是 HTML 片断，这些片断可由 Web 门户随后再组装起来。Portlet 本身由 portlet 容器管理。portlet 的主要特性包括：
- 多模式：portlet 可以在不同的模式下有不同的视图。例如，除了查看 模式，portlet 还支持编辑 模式以便用户可以设置其自身的首选项。
- 多个窗口状态：portlet 可以最小化、最大化等。
- 可定制参数：portlet 可以定义参数，而这些参数可以由用户定制。
要获得有关 portlet 的更多详细信息，可以参考 Java Portlet Specification 1.0，JSR 168（JSR 168 的后续版本 JSR 286 预计会于 2007 年后半年发布，其中包含了一些改进，比如 portlet 间通信和 portlet 过滤器）。相关链接，请参看 。
开始创建文件上载 portlet文件上载 portlet 的基石是 Apache Commons FileUpload 包（本文也称之为 FileUpload）。除了支持 servlet 内的文件上载外，Apache Commons FileUpload Version 1.1 包还支持 portlet 中的文件上载。本文使用的是 Apache Commons FileUpload 版本 1.2。
基本上，开发文件上载进度条需要两步：
- 在服务器端检索文件上载过程
- 从门户服务器进行客户端的文件上载检索和显示
文件上载过程的服务器端检索FileUpload 包支持使用侦听器检索文件上载过程。在文件上载 portlet 的 doUpload() 方法（称为 uk.ac.dl.esc.gtg.myportlets.fileupload.FileUploadPortlet，包括在本文 下载 部分所提供的源文件中），通过调用 setProgressListener() 方法为 PortletFileUpload 设置过程侦听器，如 所示：
清单 1. 为文件上载包设置过程侦听器1
2
3
4
| DiskFileItemFactory factory = new DiskFileItemFactory();
PortletFileUpload pfu = new PortletFileUpload(factory);
pfu.setSizeMax(uploadMaxSize); // Maximum upload size
pfu.setProgressListener(new FileUploadProgressListener());
|
侦听器 FileUploadProgressListener（参见 ）可实现 org.apache.commons.fileupload.ProgressListener 接口。update() 方法自动由 FileUpload 包调用以刷新有关所传输字节数的最新信息。在本文的实现中，每传输 10KB 数据则更新一次进度。这有助于防止更新进行得太频繁。 getFileUploadStatus() 方法用来计算当前文件上载进度，可由客户机通过 DWR 调用（在下一节讨论）。
清单 2. 检索文件上载过程的文件上载侦听器1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
| package uk.ac.dl.esc.gtg.myportlets.fileupload;
import java.text.NumberFormat;
import org.apache.commons.fileupload.ProgressListener;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
public class FileUploadProgressListener implements ProgressListener {
private static Log log = LogFactory.getLog(FileUploadProgressListener.class);
private static long bytesTransferred = 0;
private static long fileSize = -100;
private long tenKBRead = -1;
public FileUploadProgressListener() {
}
public String getFileUploadStatus() {
// per looks like 0% - 100%, remove % before submission
String per = NumberFormat.getPercentInstance().format(
(double) bytesTransferred / (double) fileSize);
return per.substring(0, per.length() - 1);
}
public void update(long bytesRead, long contentLength, int items) {
// update bytesTransferred and fileSize (if required) every 10 KB is
// read
long tenKB = bytesRead / 10240;
if (tenKBRead == tenKB)
return;
tenKBRead = tenKB;
bytesTransferred = bytesRead;
if (fileSize != contentLength)
fileSize = contentLength;
}
}
|
|
|
|
|
|
|
