Класс HeadlessException

java.awt.HeadlessException

Все реализуемые интерфейсы:: Serializable

public class HeadlessException extends UnsupportedOperationException

Выбрасывается при вызове кода, зависящего от клавиатуры, дисплея или мыши, в среде, не поддерживающей клавиатуру, дисплей или мышь. Код, зависящий от любого из этих устройств, должен предварительно проверить их доступность с помощью метода GraphicsEnvironment.isHeadless() и выбросить HeadlessException, если этот метод возвращает true.

Начиная с:

1.4

См. также:

Краткое описание конструкторов

Конструктор	Описание
`HeadlessException()`	Создает новый `HeadlessException` с сообщением `null` в качестве подробного сообщения.
`HeadlessException(String msg)`	Создает новый экземпляр с указанным подробным сообщением об ошибке.

Краткое описание методов

Модификатор и тип	Метод	Описание
`String`	`getMessage()`	Возвращает строку подробного сообщения этого `HeadlessException`.

Методы, объявленные в классе Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Модификатор и тип	Метод	Описание
`final void`	`addSuppressed(Throwable exception)`	Добавляет указанное исключение к исключениям, подавленным для передачи этого исключения.
`Throwable`	`fillInStackTrace()`	Заполняет трассировку стека выполнения.
`Throwable`	`getCause()`	Возвращает причину этого объекта throwable или `null`, если причина отсутствует или неизвестна.
`String`	`getLocalizedMessage()`	Создает локализованное описание этого объекта throwable.
`StackTraceElement[]`	`getStackTrace()`	Предоставляет программный доступ к сведениям о трассировке стека, выводимым методом `Throwable.printStackTrace()`.
`final Throwable[]`	`getSuppressed()`	Возвращает массив, содержащий все исключения, которые были подавлены, обычно оператором `try`, для передачи этого исключения.
`Throwable`	`initCause(Throwable cause)`	Инициализирует причину этого объекта throwable указанным значением.
`void`	`printStackTrace()`	Выводит этот объект throwable и его трассировку в стандартный поток ошибок.
`void`	`printStackTrace(PrintStream s)`	Выводит этот объект throwable и его трассировку в указанный поток печати.
`void`	`printStackTrace(PrintWriter s)`	Выводит этот объект throwable и его трассировку в указанный объект PrintWriter.
`void`	`setStackTrace(StackTraceElement[] stackTrace)`	Задает элементы трассировки стека, которые будут возвращены методом `Throwable.getStackTrace()` и выведены методами `Throwable.printStackTrace()` и связанными с ними.
`String`	`toString()`	Возвращает краткое описание этого объекта throwable.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект какому-либо другому объекту.
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API может быть удален в будущей версии. Финализация устарела и может быть удалена в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс среды выполнения этого `Object`.
`int`	`hashCode()`	Возвращает значение хеш-кода для этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо до истечения определенного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо до истечения определенного промежутка реального времени.

Подробное описание конструкторов

HeadlessException

public HeadlessException()

Создает новый HeadlessException с сообщением null в качестве подробного сообщения. В некоторых случаях вместо null может использоваться сообщение об отсутствии графической среды по умолчанию, как описано ниже.

Для таких HeadlessException на некоторых платформах сообщение об отсутствии графической среды по умолчанию может генерироваться автоматически. Текст сообщения по умолчанию может зависеть от того, действительно ли GraphicsEnvironment работает без графической среды. Иными словами, сообщение об отсутствии графической среды по умолчанию зависит как от системы, так и от среды.

HeadlessException

public HeadlessException(String msg)

Создает новый экземпляр с указанным подробным сообщением об ошибке. На некоторых платформах в конце указанного сообщения может добавляться сообщение об отсутствии графической среды по умолчанию. Текст сообщения по умолчанию может зависеть от того, действительно ли GraphicsEnvironment работает без графической среды. Иными словами, сообщение об отсутствии графической среды по умолчанию зависит как от системы, так и от среды.

Параметры:: msg — сообщение об ошибке

Подробное описание методов

getMessage

public String getMessage()

Возвращает строку подробного сообщения этого HeadlessException. В зависимости от платформы после сообщения, указанного в конструкторе, может добавляться сообщение об отсутствии графической среды по умолчанию. Текст сообщения по умолчанию может зависеть от того, действительно ли GraphicsEnvironment работает без графической среды. Иными словами, сообщение об отсутствии графической среды по умолчанию зависит как от системы, так и от среды.

Переопределяет:: getMessage в классе Throwable
Возвращает:: строку подробного сообщения этого экземпляра HeadlessException (которая может быть null).

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.