Класс NullPointerException

java.lang.NullPointerException

Все реализованные интерфейсы:: Serializable

public class NullPointerException extends RuntimeException

Выбрасывается, когда приложение пытается использовать null в ситуации, когда требуется объект. К таким случаям относятся:

Вызов метода экземпляра у объекта null.
Обращение к полю объекта null или его изменение.
Получение длины null, как если бы это был массив.
Обращение к элементам null или их изменение, как если бы это был массив.
Выбрасывание null, как если бы оно было значением Throwable.

Приложения должны выбрасывать экземпляры этого класса, чтобы указать на другие недопустимые способы использования объекта null. Объекты NullPointerException могут создаваться виртуальной машиной так, как если бы подавление исключений было отключено и/или запись трассировки стека была невозможна.

Начиная с версии:

1.0

См. также:

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

Конструктор	Описание
`NullPointerException()`	Создает `NullPointerException` без подробного сообщения.
`NullPointerException(String s)`	Создает `NullPointerException` с указанным подробным сообщением.

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

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

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

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

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

Методы, объявленные в классе 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()`	Приостанавливает текущий поток до его пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Приостанавливает текущий поток до его пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Приостанавливает текущий поток до его пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

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

NullPointerException

public NullPointerException()

Создает NullPointerException без подробного сообщения.

NullPointerException

public NullPointerException(String s)

Создает NullPointerException с указанным подробным сообщением.

Параметры:: s — подробное сообщение.

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

getMessage

public String getMessage()

Возвращает строку подробного сообщения этого объекта исключения.

Если в конструктор было передано ненулевое сообщение, возвращается оно. В противном случае возвращается сообщение, определяемое реализацией, или null.

Переопределяет:: getMessage в классе Throwable
Примечание по реализации:: Если в конструктор не было передано явное сообщение и доступна определенная внутренняя информация, возвращается подробное описание нулевой ссылки. Эта внутренняя информация недоступна в десериализованных объектах NullPointerException.
Возвращает:: строку подробного сообщения, которая может быть 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.