使用XWAF框架——上传文件

Posted 2021-01-17 xuzy630

       XWAF提供了上传文件的HttpFileUploader工具类，具备强大的多文件上传、文件类型过滤、文件大小限制、存储目录设置、文件名称更改等功能，简化了Web应用开发的编程工作。

它能同时解析表单参数和文件域，不仅能够将文件保存到服务器上，还能同时提取表单参数的值。

  如果要在保存上传文件之前提取参数值，就需要先调用“parseRequest()”方法，并使用该方法返回的对象替换request变量，然后再使用getParameter(name) 方法提取参数值。

参考代码如下：

private ServletConfig config = null;

public void init(ServletConfig config) throws ServletException {

         this.config = config;

 }

       protected void doPost(HttpServletRequest request,  HttpServletResponse response)

                         throws ServletException, IOException {

    ......

    HttpFileUploader hfu = new HttpFileUploader(config, request);        

    request = hfu.parseRequest();

    request.getParameter(“name”); 

    ......

    hfu.saveFilesAndParameters(true);

      }

 

2.1  上传文件类型过滤

  调用上传文件处理器的setFileFilter()方法，参考代码如下：

hfu.setFileFilter(“*.jpg|*.png|*.gif”);

2.2  限制上传文件的大小

  调用上传文件处理器的setOneFileSize()方法限制单个文件的大小(单位：M)，调用setTotalFileSize()方法限制多个文件的总大小。参考代码如下：

hfu.setOneFileSize(4);     // 单个文件不能大于4兆。

hfu.setTotalFileSize(50);  // 总文件大小不能大于50兆。

2.3  设置文件存储目录

  调用上传文件处理器的setStoredFilesFold(“总目录名称”)方法设置存储上传文件的总目录，处理器会自动在总目录下面创建三个子目录：Musics、Photos、Videos分别用于存放音频文件、图片文件和视频文件。

  如果程序员没有设置总目录，处理器会在网站根目录创建如下默认的目录结构：Uploads、Uploads/Musics、Uploads/Photos、Uploads/Videos等，用于存放上传文件。

参考代码： 

hfu.setStoredFilesFold(“MyUploads”);

2.4  设置上传文件的名称

  上传文件处理器默认是采用原文件名，根据文件的类型分别存放到对应的子目录。但是，程序员可以使用setFileNameSetType()方法，选择多种方式给文件命名，这些方式以如下枚举值来表示：

hfu.setFileNameSetType(FileNameSetType.UseOldName);

    说明：使用原文件名称。

hfu.setFileNameSetType(FileNameSetType.UseTimes);  

    说明：使用时间戳命名。

hfu.setFileNameSetType(FileNameSetType.UsePrefix);  

    说明：在原文件名称前使用前缀字符。

hfu.setFileNameSetType(FileNameSetType.UsePrefixTimes);

    说明：使用前缀和时间戳命名上传文件。

hfu.setFileNameSetType(FileNameSetType.UseOldNameTimes);

    说明：在原文件名称后添加时间戳。

hfu.setFileNameSetType(FileNameSetType.UsePrefixOldNameTimes);

    说明：在原文件名称前面加前缀，在后面加时间戳。

hfu.setFileNameSetType(FileNameSetType.UseCustom);

    说明：使用自定义的文件名！

如果选择了与前缀相关的命名方式，就必须设置前缀属性值才有效。参考代码如下：

hfu.setFileNamePrefix("upf_"); // 设置默认前缀！

hfu.setImageFilePrefix("img_"); // 图片文件前缀，若不设置就使用默认前缀！

hfu.setVideoFilePrefix("vid_"); // 视频文件前缀，若不设置就使用默认前缀！

hfu.setMusicFilePrefix("msc_"); // 音频文件前缀，若不设置就使用默认前缀！

如果设置为用户自定义文件名称，就要同时在页面文件中提供用户编辑文件名称的文本域标记，并在HttpHandler文件中提取对应的文本域参数值，再调用上传文件处理器的setCustomFileName()方法，参考代码如下：

String strPVal = request.getParameter("MyPhotoCustom");

hfu.setCustomFileName("MyPhoto", strPVal);

如果程序员没有调用setCustomFileName()方法设置自定义文件名，处理器将自动使用原文件名称。

2.5  获取上传文件在服务器的路径和名称

  调用保存上传文件的方法之后，程序员可以使用如下语句：

         Map<String, String> savedFilePaths = hfu.getUploadFilePaths();

  获取全部上传文件的服务器存储路径和文件名称集合（Map），该Map的key值是文件域的name属性值，value值是存储到服务器上的相对路径和文件名。程序员还可以调用方法：

         String  strFilePath = hfu.getUploadFilePath(“MyPhoto”);

  获取指定文件域的上传文件在服务器的存储路径和名称。

2.6  设置统一的上传文件限制条件

  用户可以在使用XWAG生成代码之后，设置或修改XwafConfig.xml配置文件中与文件上传相关的各个参数项，节点如下所示：

<!-- 设置文件上传的限制条件 -->

  <uploadFile>

    <storedFold>/Uploads</storedFold>

    <oneFileSize>4</oneFileSize>

    <totalFileSize>100</totalFileSize>

    <coverOldFile>true</coverOldFile>

    <fileFilter>*.*</fileFilter>

  </uploadFile>

2.7  文件上传与数据库更新

  在实际项目开发中，开发人员往往使用数据字段记录一个资源文件的路径，文件本身独立存放在一个子目录中。如果编辑包含这种资源文件路径的数据记录，可能就需要使用“file”文件域上传新文件，并同时将上传到服务器的文件路径和名称保存到数据字段中。XWAF框架可以帮助服务器代码实现这样的功能。

  由于用户对编辑页面中“file”文件域的操作，可能没有选择任何要上传文件，服务器该如何处理呢？

     XWAF框架约定如下：

     1）如果用户当前操作是新增记录，则与file标记绑定的数据字段将被赋予null值；

     2）如果是更新记录，则服务器将忽略该file参数，服务器端代码也无法访问没有上传文件的file元素，与file绑定的数据字段将保存原值不变！