上传文件

本章节介绍如何使用 UI 组件从用户的电脑上传文件。如需了解如何通过 REST API 上传文件，请参阅 文件 API 部分。

文件上传组件

Jmix 提供一组 UI 组件用于上传文件。所有组件都包含一个按钮，当点击该按钮时，展示文件系统对话框用于选取文件。下面是关于这几个组件不同之处的介绍。关于组件的全部信息，请参阅相应的组件章节。

fileUploadField 和 fileStorageUploadField 可以在按钮旁边展示上传文件的名称，文件名同时还作为文件的下载链接使用。

fileUploadField 和 fileStorageUploadField 可以支持 “拖放区域” 和 “粘贴区域”，通过拖放或粘贴文件的方式上传。

使用临时存储

fileStorageUploadField 组件的 fileStoragePutMode 属性默认值为 IMMEDIATE。如果设置该属性为 MANUAL，则组件会将上传的文件保存在应用程序所在文件系统的临时存储区，并提供对上传文件的完全控制：可以直接转移至永久文件存储；对文件进行预处理或者其他方式处理，而无需将文件保存至文件存储。

TemporaryStorage 接口提供 API 用于创建临时文件、将临时文件保存至文件存储或删除临时文件。

下面是 fileStorageUploadField 手动模式的示例，将上传至临时存储的文件转移至文件存储。

<fileStorageUploadField id="fileField" fileStoragePutMode="MANUAL"/>
@ViewComponent
private FileStorageUploadField fileField;

@Autowired
private TemporaryStorage temporaryStorage;

@Subscribe("fileField")
public void onFileFieldFileUploadSucceeded(final FileUploadSucceededEvent<FileStorageUploadField> event) {
    if (event.getReceiver() instanceof FileTemporaryStorageBuffer buffer) {
        UUID fileId = buffer.getFileData().getFileInfo().getId();
        File file = temporaryStorage.getFile(fileId); (1)
        if (file != null) {
            FileRef fileRef = temporaryStorage.putFileIntoStorage(fileId, event.getFileName()); (2)
            fileField.setValue(fileRef);
        }
    }
}
1 通过由上传事件提供的文件 id 从临时存储获取文件。
2 将文件保存至文件存储。

putFileIntoStorage() 方法也会同时删除临时文件。

如果仅需要处理临时文件，不需要保存至文件存储，可以在处理完后调用 TemporaryStorage 的 deleteFile() 方法，示例：

File file = temporaryStorage.getFile(fileId);
if (file != null) {
    processFile(file);
    temporaryStorage.deleteFile(fileId);
}

临时文件存储会慢慢积累很多由于各种原因没有删掉的文件。因此，框架提供 JMX 接口用于删除这些没有用到的旧文件。

MBean 的 clearTempDirectory() 方法会删除应用程序临时文件夹（默认 .jmix/temp）内所有超过 2 天的文件。可以手动调用这个方法或通过 Quartz 任务周期性调用，在任务中注入 TemporaryStorageManagementFacade bean，调用 clearTempDirectory() 方法。