javax.jnlp
Interface FileOpenService


public interface FileOpenService

FileOpenService service allows the user to choose a file from the local file system, even for applications that are running in the untrusted execution environment. The JNLP Client is the mediator and is therefore responsible for providing the specific implementation of this, if any.

This service provides a similar function as the file input field for HTML-based forms.

Since:
1.0
See Also:
FileSaveService, FileContents

Method Summary
 FileContents openFileDialog(java.lang.String pathHint, java.lang.String[] extensions)
          Asks the user to choose a single file.
 FileContents[] openMultiFileDialog(java.lang.String pathHint, java.lang.String[] extensions)
          Asks the user to choose one or more files.
 

Method Detail

openFileDialog

FileContents openFileDialog(java.lang.String pathHint,
                            java.lang.String[] extensions)
                            throws java.io.IOException
Asks the user to choose a single file. The contents of a potential selected file is returned as a FileContents object. The returned FileContents object contains the contents along with the name of the file. The full path is not returned.

Parameters:
pathHint - A hint from the application to the initial directory for the file chooser. This might be ignored by the JNLP Client.
extensions - A list of default extensions to show in the file chooser. For example, String[] { "txt", "java" }. This might be ignored by the JNLP Client.
Returns:
A FileContent object with information about the chosen file, or null if the user did not choose a file.
Throws:
IOException - if the request failed in any way other than the user did not choose to select a file.
java.io.IOException

openMultiFileDialog

FileContents[] openMultiFileDialog(java.lang.String pathHint,
                                   java.lang.String[] extensions)
                                   throws java.io.IOException
Asks the user to choose one or more files. Otherwise similar to openFileDialog(java.lang.String, java.lang.String[])

Throws:
java.io.IOException


Copyright © 1998, 2011, Oracle and/or its affiliates. All rights reserved.