jspSmartUpload 使用教程

### jspSmartUpload 使用教程 #### 一、安装与配置 **jspSmartUpload** 是一个功能强大的文件上传组件，主要用于简化Java Web应用中的文件上传流程。为了能够在项目中使用此组件，首先需要按照一定的步骤进行安装与配置。 1. **下载与解压：** - 访问官方网站 [www.jspsmart.com](http://www.jspsmart.com/) 下载 jspSmartUpload 组件，文件名为 jspSmartUpload.zip。 - 使用 WinRAR 或其他解压工具将 jspSmartUpload.zip 解压至 Tomcat 的 webapps 目录下。 2. **目录名称修改：** - 将解压后的目录中的子目录 `Web-inf` 改名为全部大写的 `WEB-INF`，这是因为 Tomcat 对文件名大小写敏感，并且要求 Web 应用程序的相关类所在的目录为 `WEB-INF` 且必须是大写。 - 重启 Tomcat 服务器后，即可在 JSP 文件中使用 jspSmartUpload 组件。 3. **全局应用配置：** - 如果希望 Tomcat 服务器的所有 Web 应用程序都能够使用 jspSmartUpload 组件，需要进一步配置： 1. 进入命令行状态，将目录切换到 Tomcat 的 webapps/jspsmartupload/WEB-INF 目录下。 2. 运行 JAR 打包命令：`jar cvf jspSmartUpload.jar com`。（或者使用 WinZip 将 `com` 目录下的所有文件压缩成 jspSmartUpload.zip，然后将 jspSmartUpload.zip 改名为 jspSmartUpload.jar。） 3. 将 jspSmartUpload.jar 拷贝到 Tomcat 的 shared/lib 目录下。 #### 二、相关类说明篇 本部分将详细介绍 jspSmartUpload 中的核心类——`File` 类及其常用方法。 ##### ㈠ File 类 `File` 类封装了一个上传文件的所有信息，包括文件名、文件大小、扩展名以及文件数据等信息。下面列出了一些重要的方法： 1. **saveAs：** 用于将文件另存为指定的文件名。 - 原型：`public void saveAs(String destFilePathName)` - 另一种形式：`public void saveAs(String destFilePathName, int optionSaveAs)` - 其中 `destFilePathName` 表示新的文件路径和文件名；`optionSaveAs` 是一个选项参数，有三个可选值： - `SAVEAS_PHYSICAL`：表示以操作系统的根目录为文件根目录另存文件。 - `SAVEAS_VIRTUAL`：表示以 Web 应用程序的根目录为文件根目录另存文件。 - `SAVEAS_AUTO`：表示让组件自动决定保存方式，如果 Web 应用程序的根目录下存在另存文件的目录，则选择 `SAVEAS_VIRTUAL`，否则选择 `SAVEAS_PHYSICAL`。 - 示例： - `saveAs("/upload/sample.zip", SAVEAS_PHYSICAL)`：如果 Web 服务器安装在 C 盘，则最终的文件路径为 `C:\upload\sample.zip`。 - `saveAs("/upload/sample.zip", SAVEAS_VIRTUAL)`：如果 Web 应用程序的根目录为 `webapps/jspsmartupload`，则最终的文件路径为 `webapps/jspsmartupload/upload/sample.zip`。 - `saveAs("/upload/sample.zip", SAVEAS_AUTO)`：如果 Web 应用程序根目录下存在 `upload` 目录，则效果与 `SAVEAS_VIRTUAL` 相同，否则与 `SAVEAS_PHYSICAL` 相同。 - **建议：** 对于 Web 程序开发而言，推荐使用 `SAVEAS_VIRTUAL`，以提高代码的移植性。 2. **isMissing：** 用于判断用户是否选择了文件。 - 原型：`public boolean isMissing()` - 如果用户选择了文件，则返回 false；否则返回 true。 3. **getFieldName：** 获取 HTML 表单中与上传文件对应的表单项的名字。 - 原型：`public String getFieldName()` 4. **getFileName：** 获取文件名（不包含路径信息）。 - 原型：`public String getFileName()` 5. **getFilePathName：** 获取文件的完整路径名（包含路径信息）。 - 原型：`public String getFilePathName()` 6. **getFileExt：** 获取文件扩展名（即文件后缀）。 - 原型：`public String getFileExt()` 7. **getSize：** 获取文件大小（以字节为单位）。 - 原型：`public int getSize()` 8. **getBinaryData：** 获取文件数据中指定位置的一个字节，通常用于文件检测等操作。 - 原型：`public byte getBinaryData(int index)` - 其中 `index` 表示要获取的字节的位置索引。 以上介绍的方法是 `File` 类中最为常用的部分。通过这些方法，开发者可以方便地实现文件上传、保存以及获取文件相关信息等功能。掌握这些方法对于高效地使用 jspSmartUpload 组件至关重要。