| /* |
| * The Apache Software License, Version 1.1 |
| * |
| * |
| * Copyright (c) 2001 The Apache Software Foundation. All rights |
| * reserved. |
| * |
| * Redistribution and use in source and binary forms, with or without |
| * modification, are permitted provided that the following conditions |
| * are met: |
| * |
| * 1. Redistributions of source code must retain the above copyright |
| * notice, this list of conditions and the following disclaimer. |
| * |
| * 2. Redistributions in binary form must reproduce the above copyright |
| * notice, this list of conditions and the following disclaimer in |
| * the documentation and/or other materials provided with the |
| * distribution. |
| * |
| * 3. The end-user documentation included with the redistribution, |
| * if any, must include the following acknowledgment: |
| * "This product includes software developed by the |
| * Apache Software Foundation (http://www.apache.org/)." |
| * Alternately, this acknowledgment may appear in the software itself, |
| * if and wherever such third-party acknowledgments normally appear. |
| * |
| * 4. The names "Xerces" and "Apache Software Foundation" must |
| * not be used to endorse or promote products derived from this |
| * software without prior written permission. For written |
| * permission, please contact apache@apache.org. |
| * |
| * 5. Products derived from this software may not be called "Apache", |
| * nor may "Apache" appear in their name, without prior written |
| * permission of the Apache Software Foundation. |
| * |
| * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED |
| * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES |
| * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE |
| * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR |
| * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
| * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
| * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF |
| * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND |
| * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, |
| * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT |
| * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF |
| * SUCH DAMAGE. |
| * ==================================================================== |
| * |
| * This software consists of voluntary contributions made by many |
| * individuals on behalf of the Apache Software Foundation and was |
| * originally based on software copyright (c) 1999, International |
| * Business Machines, Inc., http://www.apache.org. For more |
| * information on the Apache Software Foundation, please see |
| * <http://www.apache.org/>. |
| */ |
| |
| package org.apache.xerces.xni; |
| |
| /** |
| * Represents an interface to query namespace information. |
| * |
| * @author Andy Clark, IBM |
| * |
| * @version $Id$ |
| */ |
| public interface NamespaceContext { |
| |
| // |
| // Constants |
| // |
| |
| /** |
| * The XML Namespace ("http://www.w3.org/XML/1998/namespace"). This is |
| * the Namespace URI that is automatically mapped to the "xml" prefix. |
| */ |
| public final static String XML_URI = "http://www.w3.org/XML/1998/namespace"; |
| |
| /** |
| * XML Information Set REC |
| * all namespace attributes (including those named xmlns, |
| * whose [prefix] property has no value) have a namespace URI of http://www.w3.org/2000/xmlns/ |
| */ |
| public final static String XMLNS_URI = "http://www.w3.org/2000/xmlns/"; |
| |
| // |
| // NamespaceContext methods |
| // |
| |
| /** |
| * Look up a prefix and get the currently-mapped Namespace URI. |
| * <p> |
| * This method looks up the prefix in the current context. |
| * Use the empty string ("") for the default Namespace. |
| * |
| * @param prefix The prefix to look up. |
| * |
| * @return The associated Namespace URI, or null if the prefix |
| * is undeclared in this context. |
| */ |
| public String getURI(String prefix); |
| |
| /** |
| * Return a count of all prefixes currently declared, including |
| * the default prefix if bound. |
| */ |
| public int getDeclaredPrefixCount(); |
| |
| /** |
| * Returns the prefix at the specified index in the current context. |
| */ |
| public String getDeclaredPrefixAt(int index); |
| |
| /** |
| * Returns the parent namespace context or null if there is no |
| * parent context. The total depth of the namespace contexts |
| * matches the element depth in the document. |
| * <p> |
| * <strong>Note:</strong> This method <em>may</em> return the same |
| * NamespaceContext object reference. The caller is responsible for |
| * saving the declared prefix mappings before calling this method. |
| */ |
| public NamespaceContext getParentContext(); |
| |
| } // interface NamespaceContext |