Spec-Zone.ru › OpenJDK 17

Класс DOMException

java.lang.Object
java.lang.Throwable
java.lang.Exception
java.lang.RuntimeException
org.w3c.dom.DOMException
Все реализованные интерфейсы:
Serializable
public class DOMException extends RuntimeException
Операции DOM поднимают исключения только в "исключительных" случаях, то есть когда операцию невозможно выполнить (по логическим причинам, из-за потери данных или из-за того, что реализация стала нестабильной). В общем случае, методы DOM возвращают определённые значения ошибок в обычных ситуациях обработки, например, при ошибках выхода за пределы диапазона при использовании NodeList.

Реализации должны поднимать другие исключения в других обстоятельствах. Например, реализации должны поднимать зависимое от реализации исключение, если передаётся null аргумент, когда null не ожидался.

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

См. также Спецификацию уровня 3 Core Объектной модели документа (DOM).

См. также:
  • Сериализованная форма

Краткое описание полей

Модификатор и тип Поле Описание
short code
static final short DOMSTRING_SIZE_ERR
Если заданный диапазон текста не помещается в DOMString.
static final short HIERARCHY_REQUEST_ERR
Если какой-либо Node вставлен не туда, где нужно.
static final short INDEX_SIZE_ERR
Если индекс или размер отрицательные, или больше разрешённого значения.
static final short INUSE_ATTRIBUTE_ERR
Если попытка добавить атрибут, который уже используется в другом месте.
static final short INVALID_ACCESS_ERR
Если параметр или операция не поддерживаются базовым объектом.
static final short INVALID_CHARACTER_ERR
Если указан недопустимый или незаконный символ, например, в имени XML.
static final short INVALID_MODIFICATION_ERR
Если попытка изменить тип базового объекта.
static final short INVALID_STATE_ERR
Если попытка использовать объект, который не используется или больше не используется.
static final short NAMESPACE_ERR
Если попытка создать или изменить объект некорректно с точки зрения пространств имён.
static final short NO_DATA_ALLOWED_ERR
Если данные указаны для Node, который не поддерживает данные.
static final short NO_MODIFICATION_ALLOWED_ERR
Если попытка изменить объект, где изменения запрещены.
static final short NOT_FOUND_ERR
Если попытка обратиться к Node в контексте, где он не существует.
static final short NOT_SUPPORTED_ERR
Если реализация не поддерживает запрашиваемый тип объекта или операцию.
static final short SYNTAX_ERR
Если указана недопустимая или незаконная строка.
static final short TYPE_MISMATCH_ERR
Если тип объекта несовместим с ожидаемым типом параметра, связанного с объектом.
static final short VALIDATION_ERR
Если вызов метода, такого как insertBefore или removeChild, сделает Node недопустимым с точки зрения «частичной валидности», это исключение будет поднято, и операция не будет выполнена.
static final short WRONG_DOCUMENT_ERR
Если Node используется в другом документе, отличном от того, который его создал (который его не поддерживает).

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

Конструктор Описание
DOMException(short code, String message)

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

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

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

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

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

Подробное описание полей

code

public short code

INDEX_SIZE_ERR

public static final short INDEX_SIZE_ERR
Если индекс или размер отрицательные или больше допустимого значения.
См. также:
  • Значения константных полей

DOMSTRING_SIZE_ERR

public static final short DOMSTRING_SIZE_ERR
Если указанный диапазон текста не помещается в DOMString.
См. также:
  • Значения константных полей

HIERARCHY_REQUEST_ERR

public static final short HIERARCHY_REQUEST_ERR
Если любой Node вставлен не в то место.
См. также:
  • Значения константных полей

WRONG_DOCUMENT_ERR

public static final short WRONG_DOCUMENT_ERR
Если Node используется в другом документе, а не в том, который его создал (который его не поддерживает).
См. также:
  • Значения константных полей

INVALID_CHARACTER_ERR

public static final short INVALID_CHARACTER_ERR
Если указан недопустимый или незаконный символ, например, в имени XML.
См. также:
  • Значения константных полей

NO_DATA_ALLOWED_ERR

public static final short NO_DATA_ALLOWED_ERR
Если данные указаны для Node, который не поддерживает данные.
См. также:
  • Значения константных полей

NO_MODIFICATION_ALLOWED_ERR

public static final short NO_MODIFICATION_ALLOWED_ERR
Если попытка изменить объект, где изменения запрещены.
См. также:
  • Значения константных полей

NOT_FOUND_ERR

public static final short NOT_FOUND_ERR
Если попытка обратиться к Node в контексте, где его нет.
См. также:
  • Значения константных полей

NOT_SUPPORTED_ERR

public static final short NOT_SUPPORTED_ERR
Если реализация не поддерживает запрашиваемый тип объекта или операции.
См. также:
  • Значения константных полей

INUSE_ATTRIBUTE_ERR

public static final short INUSE_ATTRIBUTE_ERR
Если попытка добавить атрибут, который уже используется где-то в другом месте.
См. также:
  • Значения константных полей

INVALID_STATE_ERR

public static final short INVALID_STATE_ERR
Если попытка использовать объект, который не используется или больше не используется.
С тех пор:
1.4, DOM Level 2
См. также:
  • Значения константных полей

SYNTAX_ERR

public static final short SYNTAX_ERR
Если указана недопустимая или незаконная строка.
С тех пор:
1.4, DOM Level 2
См. также:
  • Значения константных полей

INVALID_MODIFICATION_ERR

public static final short INVALID_MODIFICATION_ERR
Если попытка изменить тип базового объекта.
С тех пор:
1.4, DOM Level 2
См. также:
  • Значения константных полей

NAMESPACE_ERR

public static final short NAMESPACE_ERR
Если попытка создать или изменить объект таким образом, что это будет неверно в отношении пространств имен.
С тех пор:
1.4, DOM Level 2
См. также:
  • Значения константных полей

INVALID_ACCESS_ERR

public static final short INVALID_ACCESS_ERR
Если параметр или операция не поддерживаются базовым объектом.
С тех пор:
1.4, DOM Level 2
См. также:
  • Значения константных полей

VALIDATION_ERR

public static final short VALIDATION_ERR
Если вызов метода, такого как insertBefore или removeChild, сделает Node недопустимым с точки зрения «частичной валидности», это исключение будет поднято, и операция не будет выполнена. Этот код используется в [DOM Level 3 Validation] . Обратитесь к этому спецификации для получения дополнительной информации.
С тех пор:
1.5, DOM Level 3
См. также:
  • Значения константных полей

TYPE_MISMATCH_ERR

public static final short TYPE_MISMATCH_ERR
Если тип объекта несовместим с ожидаемым типом параметра, связанного с объектом.
С тех пор:
1.5, DOM Level 3
См. также:
  • Значения константных полей

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

DOMException

public DOMException(short code, String message)

© 1993, 2021, 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.
https://docs.oracle.com/en/java/javase/17/docs/api/java.xml/org/w3c/dom/DOMException.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API