使用SmartUpload组件实现文件上传

文件上传是做JavaWeb项目中经常使用的功能，而SmartUpload是一个可免费使用的全功能的文件上传下载组件。虽然此组件最近很少有更新，但由于其简单易用，对于一般的项目来说还是一个很好的选择。下面以一个具体的例子来说明此组件的使用。

首先，将SmartUplaod的jar文件放入项目的lib目录中。

然后，我们开发上传用的JSP页面，为了简单起见，本表单中仅包含了用户上传文件的文件域和一个上传按钮。效果如下：

需要注意的是，表单中使用了文件域，则表单提交类型（method）必须为post而且添加enctype="multipart/form-data"。

有了上传页面，下面编写处理上传的Servlet，代码如下：

 

publicclassUploadServletextendsHttpServlet {      privatestaticfinallongserialVersionUID = 1L;      protectedvoiddoPost(HttpServletRequest request,             HttpServletResponse response) throwsServletException, IOException {         // 对象输出声明         response.setContentType("text/html;charset=utf-8");         PrintWriter out = response.getWriter();         // 准备上传的目录         String path = this.getServletContext().getRealPath("photo");         File fpath = new File(path);         if (!fpath.exists()) {             fpath.mkdir();         }         // 实例化组件         SmartUploadsu = newSmartUpload("utf-8");         // 初始化组件         su.initialize(this.getServletConfig(), request, response);         // 上传限制         su.setMaxFileSize(50 * 1024); // 设置大小50K         su.setAllowedFilesList("gif,png,jpg"); // 设置上传类型         try {             // 上传文件             su.upload();             // 获取上传的第一个文件             SmartFile file =   su.getFiles().getFile(0);             // 判断是否有文件上传，没有选择文件则提示用户             if (file.isMissing()) {                out.println("<script>alert('请选择要上传的文件！');location.href='upload.jsp';</script>");                return;             }             // 按照规则准备文件名按规则             String fname = new Date().getTime()                   + (newRandom().nextInt(900) + 100) + "."                    + file.getFileExt();            // 把文件从缓存区转移到指定目录中             file.saveAs(path + "/" + fname);            out.println("<script>alert('文件上传成功！');location.href='upload01.jsp';</script>");         } catch (SecurityException e) {             e.printStackTrace();             // 违反上传限制的异常处理             out.println("<script>alert('请选择合法的文件！');location.href='upload01.jsp';</script>");         } catch (SmartUploadException e) {             e.printStackTrace();             out.println("<script>alert('文件上传失败！');location.href='upload01.jsp';</script>");         }      }  }

以上代码实现了单文件上传处理，添加了注释方便阅读。其中核心就是使用了SmartFile类，这个类的主要方法如下：

1、saveAs作用：将文件换名另存。

原型：

public void
saveAs(java.lang.StringdestFilePathName)

或

public void
saveAs(java.lang.StringdestFilePathName, intoptionSaveAs)

其中，destFilePathName是另存的文件名，optionSaveAs是另存的选项，该选项有三个值，分别是SAVEAS_PHYSICAL,SAVEAS_VIRTUAL，SAVEAS_AUTO。SAVEAS_PHYSICAL表明以操作系统的根目录为文件根目录另存文件，SAVEAS_VIRTUAL表明以Web应用程序的根目录为文件根目录另存文件，SAVEAS_AUTO则表示让组件决定，当Web应用程序的根目录存在另存文件的目录时，它会选择SAVEAS_VIRTUAL，否则会选择SAVEAS_PHYSICAL。

2、isMissing

作用：这个方法用于判断用户是否选择了文件，也即对应的表单项是否有值。选择了文件时，它返回false。未选文件时，它返回true。

原型：publicbooleanisMissing()

3、getFieldName

作用：取HTML表单中对应于此上传文件的表单项的名字。

原型：public String getFieldName()

4、getFileName

作用：取文件名（不含目录信息）

原型：public String getFileName()

5、getFilePathName

作用：取文件全名（带目录）

原型：public String getFilePathName

6、getFileExt

作用：取文件扩展名（后缀）

原型：public String getFileExt()

7、getSize

作用：取文件长度（以字节计）

原型：publicintgetSize()

8、getBinaryData

作用：取文件数据中指定位移处的一个字节，用于检测文件等处理。

原型：public byte getBinaryData(int index)。其中，index表示位移，其值在0到getSize()-1之间。

上传效果如下：

 

当然，此例只实现了单文件的处理，如果需要多文件上传只需要在表单中提供多个文件域，并在servlet中循环处理即可。本文中提到的jspSmartupload组件可以在网上进行下载，资源比较多此处不再提供下载地址。

作者：中软卓越天津ETC