使用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("");               return;            }            // 按照规则准备文件名按规则            String fname = new Date().getTime()                   + (newRandom().nextInt(900) + 100) + "."                   + file.getFileExt();            // 把文件从缓存区转移到指定目录中            file.saveAs(path + "/" + fname);            out.println("");          } catch (SecurityException e) {            e.printStackTrace();            // 违反上传限制的异常处理            out.println("");        } catch (SmartUploadException e) {            e.printStackTrace();            out.println("");        }     } }

 

以上代码实现了单文件上传处理，添加了注释方便阅读。其中核心就是使用了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