Module java.jnlp

软件包 javax.jnlp

Interface FileOpenService

public interface FileOpenService

FileOpenService服务允许用户从本地文件系统中选择一个文件，即使是在不受信任的执行环境中运行的应用程序。 JNLP客户端是调解员，因此负责提供具体的实现（如果有的话）。

此服务提供与基于HTML的表单的文件输入字段类似的功能。

从以下版本开始：

1.4.2

另请参见：

FileSaveService ， FileContents

方法摘要

Modifier and Type	方法	描述
FileContents	openFileDialog(String pathHint, String[] extensions)	要求用户选择一个文件。
FileContents[]	openMultiFileDialog(String pathHint, String[] extensions)	要求用户选择一个或多个文件。

方法详细信息

openFileDialog

FileContents openFileDialog(String pathHint,
                            String[] extensions)
                     throws IOException

要求用户选择一个文件。 所选文件的内容将作为FileContents对象返回。 返回的FileContents对象包含内容以及文件的名称。 完整路径不返回。

参数

pathHint - 从应用程序到文件选择器的初始目录的提示。 这可能会被JNLP客户端忽略。

extensions - 在文件选择器中显示的默认扩展名列表。 例如， String[] { "txt", "java" } 。 这可能会被JNLP客户端忽略。

结果

A FileContent对象，其中包含有关所选文件的信息，如果用户未选择文件， null 。

异常

IOException - 如果请求以任何方式失败，除了用户没有选择选择文件。

openMultiFileDialog

FileContents[] openMultiFileDialog(String pathHint,
                                   String[] extensions)
                            throws IOException

要求用户选择一个或多个文件。 所选文件的内容作为FileContents对象的数组返回。 返回的FileContents对象包含内容以及文件的名称。 完整路径不返回。

参数

pathHint - 从应用程序到文件选择器的初始目录的提示。 这可能会被JNLP客户端忽略。

extensions - 在文件选择器中显示的默认扩展名列表。 例如， String[] { "txt", "java" } 。 这可能会被JNLP客户端忽略。

结果

一组 FileContent对象，其中包含有关所选文件的信息，如果用户没有选择文件， null 。

异常

IOException - 如果请求以任何方式失败，除了用户没有选择选择文件。