使用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