org.opengis.cite.cat30.util.NamespaceBindings Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of ets-cat30 Show documentation

Checks a catalogue service implementation for conformance to "OGC Catalogue Services 3.0 Specification -- HTTP Protocol Binding" (OGC 12-176r6) and related specifications.

There is a newer version: 1.6

Show newest version

package org.opengis.cite.cat30.util;

import java.util.Arrays;
import java.util.Collections;
import java.util.HashMap;
import java.util.Iterator;
import java.util.Map;
import javax.xml.namespace.NamespaceContext;
import org.opengis.cite.cat30.Namespaces;

/**
 * Provides namespace bindings for evaluating XPath 1.0 expressions using the
 * JAXP XPath API. A namespace name (URI) may be bound to only one prefix.
 */
public class NamespaceBindings implements NamespaceContext {

    private Map bindings = new HashMap();

    @Override
    public String getNamespaceURI(String prefix) {
        String nsName = null;
        for (Map.Entry binding : bindings.entrySet()) {
            if (binding.getValue().equals(prefix)) {
                nsName = binding.getKey();
                break;
            }
        }
        return nsName;
    }

    @Override
    public String getPrefix(String namespaceURI) {
        return bindings.get(namespaceURI);
    }

    @Override
    public Iterator getPrefixes(String namespaceURI) {
        return Arrays.asList(getPrefix(namespaceURI)).iterator();
    }

    /**
     * Adds a namespace binding that associates a namespace name with a prefix.
     * If a binding for a given namespace name already exists it will be
     * replaced.
     *
     * @param namespaceURI A String denoting a namespace name (an absolute URI
     * value).
     * @param prefix A prefix associated with the namespace name.
     */
    public void addNamespaceBinding(String namespaceURI, String prefix) {
        bindings.put(namespaceURI, prefix);
    }

    /**
     * Adds all of the supplied namespace bindings to the existing set of
     * entries.
     *
     * @param nsBindings A Map containing a collection of namespace bindings
     * where the key is an absolute URI specifying the namespace name and the
     * value denotes the associated prefix.
     */
    public void addAllBindings(Map nsBindings) {
        if (null != nsBindings) {
            bindings.putAll(nsBindings);
        }
    }

    /**
     * Returns an unmodifiable view of the declared namespace bindings.
     *
     * @return An immutable Map containing zero or more namespace bindings where
     * the key is an absolute URI specifying the namespace name and the value is
     * the associated prefix.
     */
    public Map getAllBindings() {
        return Collections.unmodifiableMap(this.bindings);
    }

    /**
     * Creates a NamespaceBindings object that is configured with the following
     * namespace bindings:
     *
     * 
     * ows: {@value org.opengis.cite.cat30.Namespaces#OWS}
     * ows11: {@value org.opengis.cite.cat30.Namespaces#OWS11}
     * xlink: {@value org.opengis.cite.cat30.Namespaces#XLINK}
     * gml: {@value org.opengis.cite.cat30.Namespaces#GML}
     * csw: {@value org.opengis.cite.cat30.Namespaces#CSW}
     * 
     *
     * @return A NamespaceBindings object.
     */
    public static NamespaceBindings withStandardBindings() {
        NamespaceBindings nsBindings = new NamespaceBindings();
        nsBindings.addNamespaceBinding(Namespaces.OWS, "ows");
        nsBindings.addNamespaceBinding(Namespaces.OWS11, "ows11");
        nsBindings.addNamespaceBinding(Namespaces.XLINK, "xlink");
        nsBindings.addNamespaceBinding(Namespaces.GML, "gml");
        nsBindings.addNamespaceBinding(Namespaces.CSW, "csw");
        return nsBindings;
    }

    @Override
    public String toString() {
        return "NamespaceBindings:\n" + bindings;
    }
}