19f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson/* 29f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * Licensed to the Apache Software Foundation (ASF) under one 39f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * or more contributor license agreements. See the NOTICE file 49f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * distributed with this work for additional information 59f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * regarding copyright ownership. The ASF licenses this file 69f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * to you under the Apache License, Version 2.0 (the "License"); 79f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * you may not use this file except in compliance with the License. 89f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * You may obtain a copy of the License at 99f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * 109f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * http://www.apache.org/licenses/LICENSE-2.0 119f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * 129f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * Unless required by applicable law or agreed to in writing, software 139f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * distributed under the License is distributed on an "AS IS" BASIS, 149f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 159f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * See the License for the specific language governing permissions and 169f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * limitations under the License. 179f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */ 189f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson/* 199f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * $Id: PrefixResolver.java 468655 2006-10-28 07:12:06Z minchau $ 209f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */ 219f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilsonpackage org.apache.xml.utils; 229f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson 239f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson/** 249f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * The class that implements this interface can resolve prefixes to 259f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * namespaces. Examples would include resolving the meaning of a 269f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * prefix at a particular point in a document, or mapping the prefixes 279f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * used in an XPath expression. 289f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * @xsl.usage advanced 299f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */ 309f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilsonpublic interface PrefixResolver 319f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson{ 329f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson 339f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson /** 349f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * Given a namespace, get the corrisponding prefix. This assumes that 359f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * the PrefixResolver holds its own namespace context, or is a namespace 369f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * context itself. 379f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * 389f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * @param prefix The prefix to look up, which may be an empty string ("") for the default Namespace. 399f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * 409f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * @return The associated Namespace URI, or null if the prefix 419f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * is undeclared in this context. 429f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */ 439f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson String getNamespaceForPrefix(String prefix); 449f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson 459f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson /** 469f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * Given a namespace, get the corresponding prefix, based on the context node. 479f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * 489f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * @param prefix The prefix to look up, which may be an empty string ("") for the default Namespace. 499f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * @param context The node context from which to look up the URI. 509f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * 519f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * @return The associated Namespace URI as a string, or null if the prefix 529f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * is undeclared in this context. 539f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */ 549f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson String getNamespaceForPrefix(String prefix, org.w3c.dom.Node context); 559f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson 569f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson /** 579f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * Return the base identifier. 589f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * 599f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * @return The base identifier from where relative URIs should be absolutized, or null 609f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * if the base ID is unknown. 619f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * <p> 629f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * CAVEAT: Note that the base URI in an XML document may vary with where 639f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * you are in the document, if part of the doc's contents were brought in 649f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * via an external entity reference or if mechanisms such as xml:base have 659f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * been used. Unless this PrefixResolver is bound to a specific portion of 669f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * the document, or has been kept up to date via some other mechanism, it 679f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * may not accurately reflect that context information. 689f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */ 699f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson public String getBaseIdentifier(); 709f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson 719f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson public boolean handlesNullPrefixes(); 729f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson} 73