/*

   Licensed to the Apache Software Foundation (ASF) under one or more
   contributor license agreements.  See the NOTICE file distributed with
   this work for additional information regarding copyright ownership.
   The ASF licenses this file to You under the Apache License, Version 2.0
   (the "License"); you may not use this file except in compliance with
   the License.  You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.

 */
package org.apache.batik.dom;

import org.apache.batik.dom.util.DOMUtilities;
import org.apache.batik.dom.util.XMLSupport;
import org.w3c.dom.DOMException;
import org.w3c.dom.Node;

This class implements the Element interface. 
Author:
Stephane Hillion
Version:
$Id: AbstractElementNS.java 1802297 2017-07-18 13:58:12Z ssteiner $/**
 * This class implements the {@link org.w3c.dom.Element} interface.
 *
 * @author <a href="mailto:stephane@hillion.org">Stephane Hillion</a>
 * @version $Id: AbstractElementNS.java 1802297 2017-07-18 13:58:12Z ssteiner $
 */
public abstract class AbstractElementNS extends AbstractElement {

    
The namespace URI
/**
     * The namespace URI
     */
    protected String namespaceURI;

    
Creates a new AbstractElementNS object.
/**
     * Creates a new AbstractElementNS object.
     */
    protected AbstractElementNS() {
    }

    
Creates a new AbstractElementNS object.
Params:
nsURI – The element namespace URI.
qname – The element qualified name for validation purposes.
owner – The owner document.
Throws:
DOMException – 
   INVALID_CHARACTER_ERR: Raised if the specified qualified name 
  contains an illegal character.
  
 NAMESPACE_ERR: Raised if the qualifiedName is 
  malformed, if the qualifiedName has a prefix and the 
  namespaceURI is null or an empty string, 
  or if the qualifiedName has a prefix that is "xml" and 
  the namespaceURI is different from 
  "http://www.w3.org/XML/1998/namespace"  ./**
     * Creates a new AbstractElementNS object.
     * @param nsURI The element namespace URI.
     * @param qname The element qualified name for validation purposes.
     * @param owner The owner document.
     * @exception DOMException
     *    INVALID_CHARACTER_ERR: Raised if the specified qualified name 
     *   contains an illegal character.
     *   <br> NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is 
     *   malformed, if the <code>qualifiedName</code> has a prefix and the 
     *   <code>namespaceURI</code> is <code>null</code> or an empty string, 
     *   or if the <code>qualifiedName</code> has a prefix that is "xml" and 
     *   the <code>namespaceURI</code> is different from 
     *   "http://www.w3.org/XML/1998/namespace"  .
     */
    protected AbstractElementNS(String nsURI, String qname,
                                AbstractDocument owner)
        throws DOMException {
        super(qname, owner);
        if (nsURI != null && nsURI.length() == 0) {
            nsURI = null;
        }
        namespaceURI = nsURI;
        String prefix = DOMUtilities.getPrefix(qname);
        if (prefix != null) {
            if (nsURI == null ||
                ("xml".equals(prefix) &&
                 !XMLSupport.XML_NAMESPACE_URI.equals(nsURI))) {
                throw createDOMException
                    (DOMException.NAMESPACE_ERR,
                     "namespace.uri",
                     new Object[] {(int) getNodeType(),
                                    getNodeName(),
                                    nsURI });
            }
        }
    }

    
DOM: Implements Node.getNamespaceURI(). 
Returns:
namespaceURI./**
     * <b>DOM</b>: Implements {@link org.w3c.dom.Node#getNamespaceURI()}.
     * @return {@link #namespaceURI}.
     */
    public String getNamespaceURI() {
        return namespaceURI;
    }

    
Exports this node to the given document.
/**
     * Exports this node to the given document.
     */
    protected Node export(Node n, AbstractDocument d) {
        super.export(n, d);
        AbstractElementNS ae = (AbstractElementNS)n;
        ae.namespaceURI = namespaceURI;
        return n;
    }

    
Deeply exports this node to the given document.
/**
     * Deeply exports this node to the given document.
     */
    protected Node deepExport(Node n, AbstractDocument d) {
        super.deepExport(n, d);
        AbstractElementNS ae = (AbstractElementNS)n;
        ae.namespaceURI = namespaceURI;
        return n;
    }

    
Copy the fields of the current node into the given node.
Params:
n – a node of the type of this./**
     * Copy the fields of the current node into the given node.
     * @param n a node of the type of this.
     */
    protected Node copyInto(Node n) {
        super.copyInto(n);
        AbstractElementNS ae = (AbstractElementNS)n;
        ae.namespaceURI = namespaceURI;
        return n;
    }

    
Deeply copy the fields of the current node into the given node.
Params:
n – a node of the type of this./**
     * Deeply copy the fields of the current node into the given node.
     * @param n a node of the type of this.
     */
    protected Node deepCopyInto(Node n) {
        super.deepCopyInto(n);
        AbstractElementNS ae = (AbstractElementNS)n;
        ae.namespaceURI = namespaceURI;
        return n;
    }
}