org.opengeospatial.cite.wmts10.ets.core.util

Class ServiceMetadataUtils

java.lang.Object

org.opengeospatial.cite.wmts10.ets.core.util.ServiceMetadataUtils

public final class ServiceMetadataUtils
extends Object

Provides various utility methods for accessing service metadata.

Author:

Lyn Goltz (original), Jim Beatty (modified/fixed May/Jun/Jul-2017 for WMS and/or WMTS)

Method Summary

Modifier and Type	Method and Description
static Node	getNode(Node wmtsCapabilities, String xPathAbstract)
static Node	getNode(XPath xPath, Node wmtsCapabilities, String xPathAbstract)
static NodeList	getNodeElements(Node wmtsCapabilities, String xPathAbstract)
static NodeList	getNodeElements(XPath xPath, Node wmtsCapabilities, String xPathAbstract)
static String	getNodeText(Node wmtsCapabilities, String xPathAbstract)
static String	getNodeText(XPath xPath, Node wmtsCapabilities, String xPathAbstract)
static Set<ProtocolBinding>	getOperationBindings(Document wmtsMetadata, String opName) Determines which protocol bindings are supported for a given operation.
static URI	getOperationEndpoint_KVP(Document wmtsMetadata, String opName, ProtocolBinding binding) Extracts a request KVP endpoint from a WMTS capabilities document.
static URI	getOperationEndpoint_REST(Document wmtsMetadata, String opName, ProtocolBinding binding) Extracts a request REST endpoint from a WMTS capabilities document.
static URI	getOperationEndpoint_SOAP(Document wmtsMetadata, String opName, ProtocolBinding binding) Extracts a request SOAP endpoint from a WMTS capabilities document.
static BoundingBox	parseBoundingBox(Node bboxNode, boolean presumedWGS84) Parses the BoundingBox from the layer; either as the WGS84 Bbox, or one of the other listed ones
static NodeList	parseLayerChildElements(Document wmtsCapabilities, String layerName, String childElement) Parses the configured formats for the given operation.
static List<LayerInfo>	parseLayerInfo(Document wmtsCapabilities) Parses all named layers from the capabilities document.
static NodeList	parseLayers(Document wmtsCapabilities)
static NodeList	parseLayers(XPath xPath, Document wmtsCapabilities)
static String	parseNodeElementName(Node nodeElement)
static String	parseNodeElementName(XPath xPath, Node nodeElement)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getOperationEndpoint_KVP

public static URI getOperationEndpoint_KVP(Document wmtsMetadata,
                                           String opName,
                                           ProtocolBinding binding)

Extracts a request KVP endpoint from a WMTS capabilities document. If the request URI contains a query component it is removed (but not from the source document).

Parameters:

wmtsMetadata - the document node containing service metadata (OGC capabilities document).

opName - the operation (request) name

binding - the message binding to use (if null any supported binding will be used)

Returns:

the URI referring to a request endpoint, null if no matching endpoint is found

getOperationEndpoint_REST

public static URI getOperationEndpoint_REST(Document wmtsMetadata,
                                            String opName,
                                            ProtocolBinding binding)

Extracts a request REST endpoint from a WMTS capabilities document. If the request URI contains a query component it is removed (but not from the source document).

Parameters:

wmtsMetadata - the document node containing service metadata (OGC capabilities document).

opName - the operation (request) name

binding - the message binding to use (if null any supported binding will be used)

Returns:

the URI referring to a request endpoint, null if no matching endpoint is found

getOperationEndpoint_SOAP

public static URI getOperationEndpoint_SOAP(Document wmtsMetadata,
                                            String opName,
                                            ProtocolBinding binding)

Extracts a request SOAP endpoint from a WMTS capabilities document. If the request URI contains a query component it is removed (but not from the source document).

Parameters:

wmtsMetadata - the document node containing service metadata (OGC capabilities document).

opName - the operation (request) name

binding - the message binding to use (if null any supported binding will be used)

Returns:

the URI referring to a request endpoint, null if no matching endpoint is found

getOperationBindings

public static Set<ProtocolBinding> getOperationBindings(Document wmtsMetadata,
                                                        String opName)

Determines which protocol bindings are supported for a given operation.

Parameters:

wmtsMetadata - the capabilities document (wmts:Capabilities), never null

opName - the name of the WMTS operation

Returns:

A Set of protocol bindings supported for the operation. May be empty but never null.

getNodeElements

public static NodeList getNodeElements(XPath xPath,
                                       Node wmtsCapabilities,
                                       String xPathAbstract)
                                throws XPathExpressionException

Throws:

XPathExpressionException

getNodeElements

public static NodeList getNodeElements(Node wmtsCapabilities,
                                       String xPathAbstract)
                                throws XPathExpressionException

Throws:

XPathExpressionException

getNode

public static Node getNode(XPath xPath,
                           Node wmtsCapabilities,
                           String xPathAbstract)
                    throws XPathExpressionException

Throws:

XPathExpressionException

getNode

public static Node getNode(Node wmtsCapabilities,
                           String xPathAbstract)
                    throws XPathExpressionException

Throws:

XPathExpressionException

getNodeText

public static String getNodeText(XPath xPath,
                                 Node wmtsCapabilities,
                                 String xPathAbstract)
                          throws XPathExpressionException

Throws:

XPathExpressionException

getNodeText

public static String getNodeText(Node wmtsCapabilities,
                                 String xPathAbstract)
                          throws XPathExpressionException

Throws:

XPathExpressionException

parseLayerChildElements

public static NodeList parseLayerChildElements(Document wmtsCapabilities,
                                               String layerName,
                                               String childElement)

Parses the configured formats for the given operation.

Parameters:

wmtsCapabilities - the capabilities document (wmts:Capabilities), never null

layerName - the name of the selected layer

childElement - the child element(s) of the layer

Returns:

a list of the child elements by the operation, never null

parseLayerInfo

public static List<LayerInfo> parseLayerInfo(Document wmtsCapabilities)

Parses all named layers from the capabilities document.

Parameters:

wmtsCapabilities - the capabilities document (wmts:Capabilities), never null

Returns:

a list of LayerInfos supported by the WMTS, never null

parseLayers

public static NodeList parseLayers(XPath xPath,
                                   Document wmtsCapabilities)

parseLayers

public static NodeList parseLayers(Document wmtsCapabilities)

parseNodeElementName

public static String parseNodeElementName(XPath xPath,
                                          Node nodeElement)
                                   throws XPathExpressionException

Throws:

XPathExpressionException

parseNodeElementName

public static String parseNodeElementName(Node nodeElement)
                                   throws XPathExpressionException

Throws:

XPathExpressionException

parseBoundingBox

public static BoundingBox parseBoundingBox(Node bboxNode,
                                           boolean presumedWGS84)

Parses the BoundingBox from the layer; either as the WGS84 Bbox, or one of the other listed ones

Parameters:

bboxNode - node of the layer, never null wgs84 if parsing the WGS84 bounding box

presumedWGS84 - are we working in WGS84 bounding box or not

Returns:

the BoundingBox - crs is CRS:84 if wgs84 is true, otherwise parse from attribute