Launches the default browser to display a URI.

  Launches the default browser to display a URI. If the default browser is not able to handle the specified URI, the application registered for handling URIs of the specified type is invoked. The application is determined from the protocol and path of the URI, as defined by the URI class.

If the calling thread does not have the necessary permissions, and this is invoked from within an applet, AppletContext.showDocument() is used. Similarly, if the calling does not have the necessary permissions, and this is invoked from within a Java Web Started application, BasicService.showDocument() is used.
Parameters:
- uri - the URI to be displayed in the user default browser
Throws:
- NullPointerException - if {@code uri} is {@code null}
- UnsupportedOperationException - if the current platform does not support the {@link Desktop.Action#BROWSE} action
- IOException - if the user default browser is not found, or it fails to be launched, or the default handler application failed to be launched
- SecurityException - if a security manager exists and it denies the AWTPermission("showWindowWithoutWarningBanner") permission, or the calling thread is not allowed to create a subprocess; and not invoked from within an applet or Java Web Started application
- IllegalArgumentException - if the necessary permissions are not available and the URI can not be converted to a {@code URL}
See Also: URI, AWTPermission, AppletContext,

  Launches the associated editor application and opens a file for editing.

  Launches the associated editor application and opens a file for
editing.
Parameters:
- file - the file to be opened for editing
Throws:
- NullPointerException - if the specified file is {@code null}
- IllegalArgumentException - if the specified file doesn't exist
- UnsupportedOperationException - if the current platform does not support the {@link Desktop.Action#EDIT} action
- IOException - if the specified file has no associated editor, or the associated application fails to be launched
- SecurityException - if a security manager exists and its {@link java.lang.SecurityManager#checkRead(java.lang.String)} method denies read access to the file, or {@link java.lang.SecurityManager#checkWrite(java.lang.String)} method denies write access to the file, or it denies the AWTPermission("showWindowWithoutWarningBanner") permission, or the calling thread is not allowed to create a subprocess
See Also: AWTPermission,

  Returns the Desktop instance of the current browser context.

  Returns the Desktop instance of the current
browser context. On some platforms the Desktop API may not be
supported; use the Desktop.isDesktopSupported() method to
determine if the current desktop is supported.
Returns: the Desktop instance of the current browser context
Throws:
- HeadlessException - if {@link GraphicsEnvironment#isHeadless()} returns {@code true}
- UnsupportedOperationException - if this class is not supported on the current platform
See Also: Desktop.isDesktopSupported(), GraphicsEnvironment.isHeadless(),

  Tests whether this class is supported on the current platform.

  Tests whether this class is supported on the current platform.
If it's supported, use Desktop.getDesktop() to retrieve an
instance.
Returns: true if this class is supported on the current platform; false otherwise
See Also: Desktop.getDesktop(),

  Tests whether an action is supported on the current platform.

  Tests whether an action is supported on the current platform.

Even when the platform supports an action, a file or URI may not have a registered application for the action. For example, most of the platforms support the Desktop.Action.OPEN action. But for a specific file, there may not be an application registered to open it. In this case, Desktop.isSupported(java.awt.Desktop.Action) may return true, but the corresponding action method will throw an IOException.
Returns: true if the specified action is supported on the current platform; false otherwise
Parameters:
- action - the specified {@link Action}
See Also: Desktop.Action,

  Launches the mail composing window of the user default mail client.

  Launches the mail composing window of the user default mail
client.
Throws:
- UnsupportedOperationException - if the current platform does not support the {@link Desktop.Action#MAIL} action
- IOException - if the user default mail client is not found, or it fails to be launched
- SecurityException - if a security manager exists and it denies the AWTPermission("showWindowWithoutWarningBanner") permission, or the calling thread is not allowed to create a subprocess
See Also: AWTPermission,

  Launches the mail composing window of the user default mail client, filling the message fields specified by a mailto: URI.

  Launches the mail composing window of the user default mail client, filling the message fields specified by a mailto: URI.

A mailto: URI can specify message fields including "to", "cc", "subject", "body", etc. See The mailto URL scheme (RFC 2368) for the mailto: URI specification details.
Parameters:
- mailtoURI - the specified {@code mailto:} URI
Throws:
- NullPointerException - if the specified URI is {@code null}
- IllegalArgumentException - if the URI scheme is not "mailto"
- UnsupportedOperationException - if the current platform does not support the {@link Desktop.Action#MAIL} action
- IOException - if the user default mail client is not found or fails to be launched
- SecurityException - if a security manager exists and it denies the AWTPermission("showWindowWithoutWarningBanner") permission, or the calling thread is not allowed to create a subprocess
See Also: URI, AWTPermission,

  Launches the associated application to open the file.

  Launches the associated application to open the file.

If the specified file is a directory, the file manager of the current platform is launched to open it.
Parameters:
- file - the file to be opened with the associated application
Throws:
- NullPointerException - if {@code file} is {@code null}
- IllegalArgumentException - if the specified file dosen't exist
- UnsupportedOperationException - if the current platform does not support the {@link Desktop.Action#OPEN} action
- IOException - if the specified file has no associated application or the associated application fails to be launched
- SecurityException - if a security manager exists and its {@link java.lang.SecurityManager#checkRead(java.lang.String)} method denies read access to the file, or it denies the AWTPermission("showWindowWithoutWarningBanner") permission, or the calling thread is not allowed to create a subprocess
See Also: AWTPermission,

  Prints a file with the native desktop printing facility, using the associated application's print command.

  Prints a file with the native desktop printing facility, using
the associated application's print command.
Parameters:
- file - the file to be printed
Throws:
- NullPointerException - if the specified file is {@code null}
- IllegalArgumentException - if the specified file doesn't exist
- UnsupportedOperationException - if the current platform does not support the {@link Desktop.Action#PRINT} action
- IOException - if the specified file has no associated application that can be used to print it
- SecurityException - if a security manager exists and its {@link java.lang.SecurityManager#checkRead(java.lang.String)} method denies read access to the file, or its {@link java.lang.SecurityManager#checkPrintJobAccess()} method denies the permission to print the file, or the calling thread is not allowed to create a subprocess