对话框消息 - CUBA 框架开发者手册

3.6.3.1. 对话框消息

对 v.7.0 之后的新版本 API，请参阅对话框消息。

通用对话框

通用对话框可以通过 Frame 接口的 showMessageDialog() 和 showOptionDialog() 方法来调用。由于界面控制器都实现了这个接口，所以可以直接在界面控制器调用这些方法。

showMessageDialog() 用来展示一条消息，此方法有下列参数：
- title – 窗口标题
- message - 消息内容。对于 HTML 类型的消息，可以使用 HTML 标签来格式化消息内容。使用 HTML 时，确保对数据库取出的数据进行转义保护，避免 web 客户端进行代码注入。在非 HTML 格式的消息中可以使用 \n 来换行。
- messageType – 消息类型。可能的类型：
  - CONFIRMATION 、 CONFIRMATION_HTML – 确认窗口。
  - WARNING 、 WARNING_HTML – 警告窗口
    
    消息类型的不同只反映在桌面客户端。
    
    也可以通过参数设置消息类型：
    
    width - 窗口宽度。
    
    modal - 窗口是否模态弹出。
    
    maximized - 对话框是否最大化到整个界面。
    
    closeOnClickOutside - 对话框是否可以通过点击界面对话框外面的部分进行关闭。
    
    显示对话框消息示例：
    
    showMessageDialog("Warning", "Something is wrong", MessageType.WARNING.modal(true).closeOnClickOutside(true));

showOptionDialog() 用来展示消息以及一些用户可以操作的按钮。除了上面提到的 showMessageDialog() 的参数外，这个方法还可以接收一个 action 的数组或者列表，并且会为每个 action 创建一个按钮。当按钮点击后，窗口调用相应操作的 actionPerform() 方法然后关闭。

对于采用标准名称和图标的按钮来说，使用匿名类继承 DialogAction 很方便，支持使用 DialogAction.Type 枚举类型定义的五种动作：OK 、CANCEL 、YES 、 NO 、 CLOSE。相应的按钮名称从主语言包中取得。

下面这个例子是一个有 Yes 和 No 按钮的消息对话框，并且从语言包中获取到当前界面的标题和消息文本：
```
showOptionDialog(
    getMessage("confirmCopy.title"),
    getMessage("confirmCopy.msg"),
    MessageType.CONFIRMATION,
    new Action[] {
        new DialogAction(DialogAction.Type.YES, Status.PRIMARY).withHandler(e -> copySettings()),
        new DialogAction(DialogAction.Type.NO, Status.NORMAL)
    }
);
```
DialogAction 的 Status 参数用来给动作的按钮设置特殊的显示样式。Status.PRIMARY 会使相应的按钮高亮并且被选中。Status 参数也可以省去，这样的话会默认的高亮样式。如果给 showOptionDialog 传递了多个 Status.PRIMARY 的操作，只有第一个动作的按钮会被设置成 cuba-primary-action 样式并且被选中。

文件上传对话框

使用 FileUploadDialog 窗口来提供上传文件到临时存储的基本功能。这个窗口包含了一个可以投放文件的区域，可以通过拖拽的方式从浏览器外将文件投放到指定区域进行上传，同时也提供了一个上传文件的按钮。

上传窗口是通过 openWindow() 方法打开的，当上传成功的时候，窗口关闭会返回 COMMIT_ACTION_ID。可以通过 CloseListener 或者 CloseWithCommitListener 监听器来跟踪窗口的关闭动作，然后用 getFileId() 和 getFileName() 方法来取到上传文件的 UUID 和名称。之后可以创建一个 FileDescriptor 对象用来作为这个文件在数据模型层的引用，可以用这个对象来实现其它业务逻辑。

FileUploadDialog dialog = (FileUploadDialog) openWindow("fileUploadDialog", OpenType.DIALOG);
dialog.addCloseWithCommitListener(() -> {
    UUID fileId = dialog.getFileId();
    String fileName = dialog.getFileName();

    FileDescriptor fileDescriptor = fileUploadingAPI.getFileDescriptor(fileId, fileName);
    // your logic here
});