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绑定的数据字段将保存原值不变!