1adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project/* 2320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * Copyright (c) 2004 World Wide Web Consortium, 3320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * 4320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * (Massachusetts Institute of Technology, European Research Consortium for 5320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * Informatics and Mathematics, Keio University). All Rights Reserved. This 6320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * work is distributed under the W3C(r) Software License [1] in the hope that 7320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * it will be useful, but WITHOUT ANY WARRANTY; without even the implied 8320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. 9320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * 10320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * [1] http://www.w3.org/Consortium/Legal/2002/copyright-software-20021231 11adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 12adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 13adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectpackage org.w3c.dom; 14adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 15adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project/** 16f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * <code>EntityReference</code> nodes may be used to represent an entity 17f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * reference in the tree. Note that character references and references to 18f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * predefined entities are considered to be expanded by the HTML or XML 19f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * processor so that characters are represented by their Unicode equivalent 20f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * rather than by an entity reference. Moreover, the XML processor may 21f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * completely expand references to entities while building the 22f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * <code>Document</code>, instead of providing <code>EntityReference</code> 23f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * nodes. If it does provide such nodes, then for an 24f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * <code>EntityReference</code> node that represents a reference to a known 25f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * entity an <code>Entity</code> exists, and the subtree of the 26f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * <code>EntityReference</code> node is a copy of the <code>Entity</code> 27f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * node subtree. However, the latter may not be true when an entity contains 28f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * an unbound namespace prefix. In such a case, because the namespace prefix 29f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * resolution depends on where the entity reference is, the descendants of 30f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * the <code>EntityReference</code> node may be bound to different namespace 31f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * URIs. When an <code>EntityReference</code> node represents a reference to 32f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * an unknown entity, the node has no children and its replacement value, 33320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * when used by <code>Attr.value</code> for example, is empty. 34f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * <p>As for <code>Entity</code> nodes, <code>EntityReference</code> nodes and 35adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * all their descendants are readonly. 36f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * <p ><b>Note:</b> <code>EntityReference</code> nodes may cause element 37f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * content and attribute value normalization problems when, such as in XML 38f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 1.0 and XML Schema, the normalization is performed after entity reference 39320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * are expanded. 40320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>Document Object Model (DOM) Level 3 Core Specification</a>. 41adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 42adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectpublic interface EntityReference extends Node { 43adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project} 44