File Upload
一个 FileUploadDialog 是一个模态对话框，旨在允许用户从他们的本地文件系统上传文件。该对话框会阻止应用程序执行，直到用户选择要上传的文件或关闭对话框。
如果您想要一个直接在页面布局中呈现的文件选择器，而不是对话框，请考虑使用 Upload 组件。
Usages
FileUploadDialog 提供了一种选择和上传文件的方式，使用户能够提交应用所需的文档、图像或其他文件类型。使用 showFileUploadDialog() 来显示对话框并捕获上传的文件。
UploadedFile result = OptionDialog.showFileUploadDialog("上传文件");
Result
FileUploadDialog 返回一个 UploadedFile 对象，该对象包含有关上传文件的信息，例如名称、大小和内容。如果用户在未选择文件的情况下关闭对话框，则结果将为 null。
结果字符串将从 show() 方法或等价的 OptionDialog 方法返回，如下所示。
显示代码
- FileUploadDialogBasicView.java
移动上传的文件
默认情况下，webforJ 将上传的文件存储在定期清理的临时文件夹中。如果您不将文件移动到其他位置，它将被删除。要移动文件，请使用 move 方法并指定目标路径。
UploadedFile uploadedFile = OptionDialog.showFileUploadDialog("选择要上传的文件");
try {
File file = uploadedFile.move("my/full/path/" + uploadedFile.getSanitizedClientName());
// ... 对文件执行某些操作
} catch (IOException e) {
// 处理异常
}
使用 getSanitizedClientName 方法获取上传文件名称的清理版本。该方法有助于防止安全风险，例如目录遍历攻击或文件名称中的无效字符，从而确保您的文件存储系统的完整性和安全性。
Filters
FileUploadDialog 允许您设置过滤器以限制可以选择用于上传的文件类型。您可以使用 setFilters(List<FileChooserFilter> filters) 方法配置过滤器。
FileUploadDialog dialog = new FileUploadDialog(
"上传文件",
Arrays.asList(new FileChooserFilter("文本文件", "*.txt")));
UploadedFile result = dialog.show();
服务器不会根据过滤器验证上传的文件。过滤器仅在 UI 中应用，以指导用户的选择。您必须实现服务器端验证，以确保上传的文件符合您的应用要求。
最大大小
可以设置上传的最大文件大小，以确保用户不会上传超出您的应用处理能力的文件。可以使用 setMaxFileSize(long maxSize) 方法进行配置，其中 maxSize 以字节为单位指定。
dialog.setMaxFileSize(2 * 1024 * 1024); // 将最大大小设置为 2 MB
国际化 (i18n)
组件内的标题、描述、标签和消息可以使用 FileUploadI18n 类进行完全自定义。此灵活性允许您根据特定的本地化要求或个性化偏好调整对话框界面。
FileUploadDialog dialog = new FileUploadDialog("上传文件");
FileUploadI18n i18n = new FileUploadI18n();
i18n.setUpload("上传");
i18n.setCancel("取消");
dialog.setI18n(i18n);
UploadedFile result = dialog.show();
最佳实践
- 清晰简洁的提示: 确保提示消息清楚地解释用户被要求上传的内容。
- 适当的过滤器: 设置与所需文件类型匹配的文件过滤器，以确保用户上传相关文件。
- 合逻辑的初始路径: 设置为用户提供有用的文件选择起始点的初始路径。
- 限制目录导航: 在必要时限制对话框到特定目录，以防止用户导航到未经授权的区域。
- 一致的主题: 确保对话框和上传字段的主题与您的应用设计一致，以提供连贯的用户体验。
- 减少过度使用: 应谨慎使用文件上传对话框，以避免用户沮丧。仅在需要用户上传特定文件的操作中保留它们。