Moving to root below branch label

git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/HEAD/root@2005 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261

source/java/org/alfresco/service/namespace/NamespacePrefixResolver.java

@@ -0,0 +1,63 @@
+/*
+ * Copyright (C) 2005 Alfresco, Inc.
+ *
+ * Licensed under the Mozilla Public License version 1.1 
+ * with a permitted attribution clause. You may obtain a
+ * copy of the License at
+ *
+ *   http://www.alfresco.org/legal/license.txt
+ *
+ * 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.alfresco.service.namespace;
+
+import java.util.Collection;
+
+/**
+ * The <code>NamespacePrefixResolver</code> provides a mapping between
+ * namespace prefixes and namespace URIs.
+ * 
+ * @author David Caruana
+ */
+public interface NamespacePrefixResolver
+{
+    /**
+     * Gets the namespace URI registered for the given prefix
+     * 
+     * @param prefix  prefix to lookup
+     * @return  the namespace
+     * @throws NamespaceException  if prefix has not been registered  
+     */
+    public String getNamespaceURI(String prefix)
+        throws NamespaceException;
+    
+    /**
+     * Gets the registered prefixes for the given namespace URI
+     * 
+     * @param namespaceURI  namespace URI to lookup
+     * @return  the prefixes (or empty collection, if no prefixes registered against URI)
+     * @throws NamespaceException  if URI has not been registered 
+     */
+    public Collection<String> getPrefixes(String namespaceURI)
+        throws NamespaceException;
+    
+    /**
+     * Gets all registered Prefixes
+     * 
+     * @return collection of all registered namespace prefixes
+     */
+    Collection<String> getPrefixes();
+
+    /**
+     * Gets all registered Uris
+     * 
+     * @return collection of all registered namespace uris
+     */
+    Collection<String> getURIs();
+
+}