Класс Desktop

public class Desktop
extends Object

Класс Desktop позволяет Java-приложению запускать связанные приложения, зарегистрированные на локальном рабочем столе, для обработки URI или файла.

Поддерживаемые операции включают:

• запуск браузера по умолчанию для отображения указанного URI;
• запуск почтового клиента по умолчанию с необязательным mailto URI;
• запуск зарегистрированного приложения для открытия, редактирования или печати указанного файла.

Этот класс предоставляет методы, соответствующие этим операциям. Методы ищут связанное приложение, зарегистрированное в текущей системе, и запускают его для обработки URI или файла. Если связанное приложение отсутствует или не запускается, генерируется исключение.

Приложение регистрируется для определенного типа URI или файла; например, расширение файла "sxi" обычно регистрируется для StarOffice. Механизм регистрации, доступа и запуска связанного приложения зависит от платформы.

Каждая операция — это тип действия, представленный классом Desktop.Action.

Примечание: при вызове операции и выполнении связанного приложения, оно будет выполнено на той же системе, что и Java-приложение.

Методы

getDesktop

public static Desktop getDesktop()

Возвращает экземпляр 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)

Параметры:

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, который должен быть отображен в браузере по умолчанию

Выбрасывает:

NullPointerException - если uri равно null

UnsupportedOperationException - если текущая платформа не поддерживает действие Desktop.Action.BROWSE

IOException - если браузер по умолчанию не найден, или он не может быть запущен, или приложение по умолчанию не может быть запущено

SecurityException - если менеджер безопасности существует и отклоняет разрешение AWTPermission("showWindowWithoutWarningBanner"), или вызывающий поток не имеет права создавать дочерний процесс; и не вызван из апплета или приложения 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

Параметры:

mailtoURI - указанный mailto: URI

Выбрасывает:

NullPointerException - если указанный URI является null

IllegalArgumentException - если схема URI не "mailto"

UnsupportedOperationException - если текущая платформа не поддерживает действие Desktop.Action.MAIL

IOException - если почтовый клиент по умолчанию не найден или не может быть запущен

SecurityException - если менеджер безопасности существует и отклоняет разрешение AWTPermission("showWindowWithoutWarningBanner"), или вызывающий поток не имеет права создавать дочерний процесс

См. также:

URI, AWTPermission