Desktop (Java Platform SE 8 )

java.lang.Object
- java.awt.Desktop

```
public class Desktop
extends Object
```
Desktop类允许Java应用程序启动在本机桌面上注册的相关应用程序来处理URI或文件。
支持的操作包括：
- 启动用户默认浏览器以显示指定的URI;
- 启动具有可选的mailto URI的用户默认邮件客户端;
- 启动已注册的应用程序来打开，编辑或打印指定的文件。
该类提供与这些操作相对应的方法。该方法查找在当前平台上注册的关联应用程序，并启动它来处理URI或文件。如果没有关联的应用程序或相关应用程序无法启动，则抛出异常。

应用程序注册到URI或文件类型; 例如， "sxi"文件扩展名通常注册到StarSuite。注册，访问和启动相关应用程序的机制是平台相关的。

每个操作是Desktop.Action类代表的动作类型。

注意：当一些操作被调用并且相关联的应用程序被执行时，它将在与启动Java应用程序的系统相同的系统上执行。
从以下版本开始：

1.6

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`Desktop.Action` 表示动作类型。

方法摘要

所有方法静态方法接口方法具体的方法
Modifier and Type	Method and Description
`void`	`browse(URI uri)` 启动默认浏览器以显示 `URI` 。
`void`	`edit(File file)` 启动相关的编辑器应用程序并打开一个文件进行编辑。
`static Desktop`	`getDesktop()` 返回当前浏览器上下文的 `Desktop`实例。
`static boolean`	`isDesktopSupported()` 测试此类是否在当前平台上得到支持。
`boolean`	`isSupported(Desktop.Action action)` 测试当前平台是否支持操作。
`void`	`mail()` 启动用户默认邮件客户端的邮件组合窗口。
`void`	`mail(URI mailtoURI)` 启动用户默认邮件客户端的邮件组合窗口，填写 `mailto:` URI指定的邮件字段。
`void`	`open(File file)` 启动相关应用程序以打开文件。
`void`	`print(File file)` 使用相关应用程序的打印命令打印本机桌面打印设备的文件。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 方法详细信息
  - getDesktop
```
public static Desktop getDesktop()
```
    返回当前浏览器上下文的Desktop实例。在某些平台上，可能不支持Desktop API; 使用isDesktopSupported()方法来确定当前桌面是否受支持。
    
    结果
    
    当前浏览器上下文的Desktop实例
    
    异常
    
    HeadlessException - 如果 GraphicsEnvironment.isHeadless()返回 true
    
    UnsupportedOperationException - 如果当前平台不支持此类
    
    另请参见：
    
    isDesktopSupported() ， GraphicsEnvironment.isHeadless()
  - isDesktopSupported
```
public static boolean isDesktopSupported()
```
    测试此类是否在当前平台上得到支持。如果支持，请使用getDesktop()检索实例。
    
    结果
    
    true如果在当前平台上支持此类; false否则
    
    另请参见：
    
    getDesktop()
  - isSupported
```
public boolean isSupported(Desktop.Action action)
```
    测试当前平台是否支持操作。
    即使平台支持操作，文件或URI可能没有注册的操作应用程序。例如，大多数平台支持Desktop.Action.OPEN操作。但是对于特定文件，可能没有注册的应用程序来打开它。在这种情况下， isSupported(java.awt.Desktop.Action)可能会返回true ，但是相应的action方法会抛出一个IOException 。
    
    参数
    
    action - 指定的Desktop.Action
    
    结果
    
    true如果当前平台支持指定的动作; false否则
    
    另请参见：
    
    Desktop.Action
  - open
```
public void open(File file)
          throws IOException
```
    启动相关应用程序以打开文件。
    如果指定的文件是目录，则启动当前平台的文件管理器以将其打开。
    
    参数
    
    file - 要与相关应用程序打开的文件
    
    异常
    
    NullPointerException - 如果 file是 null
    
    IllegalArgumentException - 如果指定的文件不存在
    
    UnsupportedOperationException - 如果当前平台不支持 Desktop.Action.OPEN操作
    
    IOException - 如果指定的文件没有关联的应用程序或相关应用程序无法启动
    
    SecurityException - 如果安全管理器存在，并且其 SecurityManager.checkRead(java.lang.String)方法拒绝对该文件的读取访问，或拒绝其 AWTPermission("showWindowWithoutWarningBanner")权限，或者调用线程不允许创建子进程
    
    另请参见：
    
    AWTPermission
  - edit
```
public void edit(File file)
          throws IOException
```
    启动相关的编辑器应用程序并打开一个文件进行编辑。
    
    参数
    
    file - 要打开进行编辑的文件
    
    异常
    
    NullPointerException - 如果指定的文件是 null
    
    IllegalArgumentException - 如果指定的文件不存在
    
    UnsupportedOperationException - 如果当前平台不支持 Desktop.Action.EDIT操作
    
    IOException - 如果指定的文件没有关联的编辑器，或相关的应用程序无法启动
    
    SecurityException -如果存在安全管理及其 SecurityManager.checkRead(java.lang.String)方法拒绝读取访问该文件，或 SecurityManager.checkWrite(java.lang.String)方法拒绝写访问该文件，或者它拒绝 AWTPermission("showWindowWithoutWarningBanner")权限，或者调用线程不允许创建子进程
    
    另请参见：
    
    AWTPermission
  - print
```
public void print(File file)
           throws IOException
```
    使用相关应用程序的打印命令打印本机桌面打印设备的文件。
    
    参数
    
    file - 要打印的文件
    
    异常
    
    NullPointerException - 如果指定的文件是 null
    
    IllegalArgumentException - 如果指定的文件不存在
    
    UnsupportedOperationException - 如果当前平台不支持 Desktop.Action.PRINT操作
    
    IOException - 如果指定的文件没有可用于打印的关联应用程序
    
    SecurityException - 如果安全管理器存在，并且其 SecurityManager.checkRead(java.lang.String)方法拒绝对该文件的读取访问，或者其 SecurityManager.checkPrintJobAccess()方法拒绝打印文件的权限，或者调用线程不允许创建子进程
  - browse
```
public void browse(URI uri)
            throws IOException
```
    启动默认浏览器以显示URI 。如果默认浏览器无法处理指定的URI ，则调用注册处理指定类型的URIs的应用程序。该应用程序是从的协议和路径确定URI ，由所限定URI类。
    如果调用线程没有必要的权限，并且这是从applet内调用的， AppletContext.showDocument()使用AppletContext.showDocument() 。类似地，如果调用没有必要的权限，并且这是从Java Web Started应用程序中调用的，则使用BasicService.showDocument() 。
    
    参数
    
    uri - 要在用户默认浏览器中显示的URI
    
    异常
    
    NullPointerException - 如果 uri是 null
    
    UnsupportedOperationException - 如果当前平台不支持 Desktop.Action.BROWSE操作
    
    IOException - 如果未找到用户默认浏览器，或无法启动，或默认处理程序应用程序无法启动
    
    SecurityException - 如果安全管理器存在，并且拒绝AWTPermission("showWindowWithoutWarningBanner")权限，或者调用线程不允许创建子进程; 而不是从applet或Java Web Started应用程序中调用
    
    IllegalArgumentException - 如果必要的权限不可用，URI无法转换为 URL
    
    另请参见：
    
    URI ， AWTPermission ， AppletContext
  - mail
```
public void mail()
          throws IOException
```
    启动用户默认邮件客户端的邮件组合窗口。
    
    异常
    
    UnsupportedOperationException - 如果当前平台不支持 Desktop.Action.MAIL操作
    
    IOException - 如果未找到用户默认邮件客户端，或者无法启动
    
    SecurityException - 如果一个安全管理器存在，并拒绝 AWTPermission("showWindowWithoutWarningBanner")权限，或者调用线程不允许创建一个子进程
    
    另请参见：
    
    AWTPermission
  - mail
```
public void mail(URI mailtoURI)
          throws IOException
```
    启动用户默认邮件客户端的邮件组合窗口，填写mailto: URI指定的邮件字段。
    A mailto: URI可以指定包括“to” ， “cc” ， “subject” ， “body”等的消息字段。有关mailto: URI规范的详细信息，请参见The mailto URL scheme (RFC 2368) 。
    
    参数
    
    mailtoURI - 指定的 mailto: URI
    
    异常
    
    NullPointerException - 如果指定的URI是 null
    
    IllegalArgumentException - 如果URI方案不是 "mailto"
    
    UnsupportedOperationException - 如果当前平台不支持 Desktop.Action.MAIL操作
    
    IOException - 如果用户默认邮件客户端未找到或无法启动
    
    SecurityException - 如果安全管理器存在，并拒绝 AWTPermission("showWindowWithoutWarningBanner")权限，或者调用线程不允许创建子进程
    
    另请参见：
    
    URI ， AWTPermission

Class Desktop

Nested Class Summary

方法摘要

Methods inherited from class java.lang.Object

方法详细信息

getDesktop

isDesktopSupported

isSupported

open

edit

print

browse

mail

mail