/* * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this * particular file as subject to the "Classpath" exception as provided * by Oracle in the LICENSE file that accompanied this code. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. */ /* * This file is available under and governed by the GNU General Public * License version 2 only, as published by the Free Software Foundation. * However, the following notice accompanied the original version of this * file and, per its terms, should not be removed: * * Copyright (c) 2002 World Wide Web Consortium, * (Massachusetts Institute of Technology, Institut National de * Recherche en Informatique et en Automatique, Keio University). All * Rights Reserved. This program is distributed under the W3C's Software * Intellectual Property License. This program is distributed in the * hope that it will be useful, but WITHOUT ANY WARRANTY; without even * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR * PURPOSE. * See W3C License http://www.w3.org/Consortium/Legal/ for more details. */ package org.w3c.dom.xpath; import org.w3c.dom.Element; import org.w3c.dom.Node; /** * The XPathNamespace interface is returned by * XPathResult interfaces to represent the XPath namespace node * type that DOM lacks. There is no public constructor for this node type. * Attempts to place it into a hierarchy or a NamedNodeMap result in a * DOMException with the code HIERARCHY_REQUEST_ERR * . This node is read only, so methods or setting of attributes that would * mutate the node result in a DOMException with the code * NO_MODIFICATION_ALLOWED_ERR. *

The core specification describes attributes of the Node * interface that are different for different node node types but does not * describe XPATH_NAMESPACE_NODE, so here is a description of * those attributes for this node type. All attributes of Node * not described in this section have a null or * false value. *

ownerDocument matches the ownerDocument of the * ownerElement even if the element is later adopted. *

prefix is the prefix of the namespace represented by the * node. *

nodeName is the same as prefix. *

nodeType is equal to XPATH_NAMESPACE_NODE. *

namespaceURI is the namespace URI of the namespace * represented by the node. *

adoptNode, cloneNode, and * importNode fail on this node type by raising a * DOMException with the code NOT_SUPPORTED_ERR.In * future versions of the XPath specification, the definition of a namespace * node may be changed incomatibly, in which case incompatible changes to * field values may be required to implement versions beyond XPath 1.0. *

See also the Document Object Model (DOM) Level 3 XPath Specification. */ public interface XPathNamespace extends Node { // XPathNodeType /** * The node is a Namespace. */ public static final short XPATH_NAMESPACE_NODE = 13; /** * The Element on which the namespace was in scope when it * was requested. This does not change on a returned namespace node even * if the document changes such that the namespace goes out of scope on * that element and this node is no longer found there by XPath. */ public Element getOwnerElement(); }