1f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 2f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Copyright (c) 2000 World Wide Web Consortium, 3f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * (Massachusetts Institute of Technology, Institut National de 4f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Recherche en Informatique et en Automatique, Keio University). All 5f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Rights Reserved. This program is distributed under the W3C's Software 6f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Intellectual Property License. This program is distributed in the 7f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * hope that it will be useful, but WITHOUT ANY WARRANTY; without even 8f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR 9f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * PURPOSE. 10f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * See W3C License http://www.w3.org/Consortium/Legal/ for more details. 11f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 12f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 13f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectpackage org.w3c.dom; 14f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 15f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project//BEGIN android-note 16f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project//Filled some gaps in the documentation and refactored parts of the existing 17f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project//documentation to make the Doclet happy. 18f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project//END android-note 19f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 20f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/** 21f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * DOM operations only raise exceptions in "exceptional" circumstances, i.e., 22f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * when an operation is impossible to perform (either for logical reasons, 23f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * because data is lost, or because the implementation has become unstable). 24f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * In general, DOM methods return specific error values in ordinary 25f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * processing situations, such as out-of-bound errors when using 26f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * <code>NodeList</code>. 27f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * <p>Implementations should raise other exceptions under other circumstances. 28f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * For example, implementations should raise an implementation-dependent 29f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * exception if a <code>null</code> argument is passed. 30f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * <p>Some languages and object systems do not support the concept of 31f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * exceptions. For such systems, error conditions may be indicated using 32f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * native error reporting mechanisms. For some bindings, for example, 33f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * methods may return error codes similar to those listed in the 34f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * corresponding method descriptions. 35f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113'>Document Object Model (DOM) Level 2 Core Specification</a>. 36f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 37f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectpublic class DOMException extends RuntimeException { 38f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 39f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Creates a new <code>DOMException</code> with the given error code and 40f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * human-readable message. 41f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @param code the error code. 42f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @param message the human-readable message. 43f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 44f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public DOMException(short code, String message) { 45f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project super(message); 46f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project this.code = code; 47f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 48f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 49f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Holds the error code of the <code>DOMException</code>. 50f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 51f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public short code; 52f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project // ExceptionCode 53f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 54f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * If index or size is negative, or greater than the allowed value 55f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 56f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public static final short INDEX_SIZE_ERR = 1; 57f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 58f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * If the specified range of text does not fit into a DOMString 59f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 60f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public static final short DOMSTRING_SIZE_ERR = 2; 61f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 62f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * If any node is inserted somewhere it doesn't belong 63f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 64f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public static final short HIERARCHY_REQUEST_ERR = 3; 65f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 66f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * If a node is used in a different document than the one that created it 67f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * (that doesn't support it) 68f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 69f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public static final short WRONG_DOCUMENT_ERR = 4; 70f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 71f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * If an invalid or illegal character is specified, such as in a name. See 72f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * production 2 in the XML specification for the definition of a legal 73f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * character, and production 5 for the definition of a legal name 74f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * character. 75f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 76f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public static final short INVALID_CHARACTER_ERR = 5; 77f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 78f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * If data is specified for a node which does not support data 79f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 80f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public static final short NO_DATA_ALLOWED_ERR = 6; 81f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 82f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * If an attempt is made to modify an object where modifications are not 83f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * allowed 84f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 85f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public static final short NO_MODIFICATION_ALLOWED_ERR = 7; 86f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 87f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * If an attempt is made to reference a node in a context where it does 88f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * not exist 89f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 90f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public static final short NOT_FOUND_ERR = 8; 91f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 92f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * If the implementation does not support the requested type of object or 93f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * operation. 94f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 95f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public static final short NOT_SUPPORTED_ERR = 9; 96f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 97f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * If an attempt is made to add an attribute that is already in use 98f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * elsewhere 99f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 100f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public static final short INUSE_ATTRIBUTE_ERR = 10; 101f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 102f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * If an attempt is made to use an object that is not, or is no longer, 103f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * usable. 104f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @since DOM Level 2 105f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 106f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public static final short INVALID_STATE_ERR = 11; 107f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 108f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * If an invalid or illegal string is specified. 109f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @since DOM Level 2 110f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 111f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public static final short SYNTAX_ERR = 12; 112f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 113f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * If an attempt is made to modify the type of the underlying object. 114f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @since DOM Level 2 115f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 116f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public static final short INVALID_MODIFICATION_ERR = 13; 117f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 118f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * If an attempt is made to create or change an object in a way which is 119f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * incorrect with regard to namespaces. 120f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @since DOM Level 2 121f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 122f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public static final short NAMESPACE_ERR = 14; 123f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 124f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * If a parameter or an operation is not supported by the underlying 125f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * object. 126f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @since DOM Level 2 127f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 128f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public static final short INVALID_ACCESS_ERR = 15; 129f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 130f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project} 131