/*
 * Copyright Amherst College
 *
 * Licensed 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 edu.amherst.acdc.trellis.spi;

import java.util.Map;

/**
 * Namespaces may be stored globally across the repository, and the NamespaceService
 * provides a mechanism for retrieving and setting namespace values.
 *
 * @author acoburn
 */
public interface NamespaceService {

    /**
     * Fetch the entire namespace mapping
     * @return the namespace mapping
     */
    Map<String, String> getNamespaces();

    /**
     * Fetch the namespace for a particular prefix
     * @param prefix the prefix
     * @return the corresponding namespace
     */
    String getNamespace(String prefix);

    /**
     * Set the namespace for a given prefix
     * @param prefix the prefix
     * @param namespace the namespace
     */
    void setNamespace(String prefix, String namespace);

}

@@ -647,16 +647,43 @@
 til.Map;
+%0Aimport java.util.Optional;
 %0A%0A/**%0A *
@@ -979,24 +979,51 @@
 pace mapping
+ as prefix, namespace pairs
 %0A     */%0A   
@@ -1207,22 +1207,32 @@
  */%0A    
+Optional%3C
 String
+%3E
  getName
@@ -1250,24 +1250,220 @@
 g prefix);%0A%0A
+    /**%0A     * Fetch the prefix for a particular namespace%0A     * @param namespace the namespace%0A     * @return the corresponding prefix%0A     */%0A    Optional%3CString%3E getPrefix(String namespace);%0A%0A
     /**%0A    
@@ -1582,31 +1582,77 @@
    *
-/%0A    void setNamespace
+ @return whether the new prefix was set%0A     */%0A    Boolean setPrefix
 (Str

update NS service API