org.opengis.cite.kml22

Class ETSAssert

java.lang.Object

org.opengis.cite.kml22.ETSAssert

public class ETSAssert
extends Object

Provides a set of custom assertion methods.

Method Summary

Methods

Modifier and Type	Method and Description
static void	assertDescendantElementCount(Document xmlEntity, QName elementName, int expectedCount) Asserts that the given XML entity contains the expected number of descendant elements having the specified name.
static void	assertQualifiedName(Node node, QName qName) Asserts that the qualified name of a DOM Node matches the expected value.
static void	assertReferentExists(String xpath, Node linkNode, com.sun.jersey.api.client.Client httpClient, String... mediaTypes) Asserts that the resource identified by the given link element exists.
static void	assertReferentExists(URI uriRef, String baseURI, com.sun.jersey.api.client.Client httpClient, String... mediaTypes) Asserts that the resource identified by the given URI reference exists.
static void	assertSchematronValid(URL schemaRef, Source xmlSource) Asserts that an XML resource satisfies all applicable constraints specified in a Schematron (ISO 19757-3) schema.
static void	assertSchemaValid(Validator validator, Source source) Asserts that an XML resource is schema-valid.
static void	assertValidUpdate(Node updateNode) Asserts that the given kml:Update element is valid.
static void	assertXPath(String expr, Node context, Map<String,String> namespaceBindings) Asserts that an XPath 1.0 expression holds true for the given evaluation context.
static void	assertXPath2(String expr, Source source, Map<String,String> namespaceBindings) Asserts that an XPath 2.0 expression evaluates to true for the given XML source.

Methods inherited from class java.lang.Object

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

Method Detail

assertQualifiedName

public static void assertQualifiedName(Node node,
                       QName qName)

Asserts that the qualified name of a DOM Node matches the expected value.

Parameters:

node - The Node to check.

qName - A QName object containing a namespace name (URI) and a local part.

assertXPath

public static void assertXPath(String expr,
               Node context,
               Map<String,String> namespaceBindings)

Asserts that an XPath 1.0 expression holds true for the given evaluation context. The following standard namespace bindings do not need to be explicitly declared:

• ows: "http://www.opengis.net/ows/1.1"
• xlink: "http://www.w3.org/1999/xlink"
• gml: "http://www.opengis.net/gml/3.2"

Parameters:

expr - A valid XPath 1.0 expression.

context - The context node.

namespaceBindings - A collection of namespace bindings for the XPath expression, where each entry maps a namespace URI (key) to a prefix (value). It may be null.

assertXPath2

public static void assertXPath2(String expr,
                Source source,
                Map<String,String> namespaceBindings)

Asserts that an XPath 2.0 expression evaluates to true for the given XML source. That is, the result set is not empty.

Parameters:

expr - An XPath 2.0 expression.

source - A Source object representing an XML resource.

namespaceBindings - A collection of namespace bindings for the XPath expression, where each entry maps a namespace URI (key) to a prefix (value). It may be null.

assertSchemaValid

public static void assertSchemaValid(Validator validator,
                     Source source)

Asserts that an XML resource is schema-valid.

Parameters:

validator - The Validator to use.

source - The XML Source to be validated.

assertSchematronValid

public static void assertSchematronValid(URL schemaRef,
                         Source xmlSource)

Asserts that an XML resource satisfies all applicable constraints specified in a Schematron (ISO 19757-3) schema. The "xslt2" query language binding is supported. All patterns are checked.

Parameters:

schemaRef - A URL that denotes the location of a Schematron schema.

xmlSource - The XML Source to be validated.

assertDescendantElementCount

public static void assertDescendantElementCount(Document xmlEntity,
                                QName elementName,
                                int expectedCount)

Asserts that the given XML entity contains the expected number of descendant elements having the specified name.

Parameters:

xmlEntity - A Document representing an XML entity.

elementName - The qualified name of the element.

expectedCount - The expected number of occurrences.

assertReferentExists

public static void assertReferentExists(String xpath,
                        Node linkNode,
                        com.sun.jersey.api.client.Client httpClient,
                        String... mediaTypes)

Asserts that the resource identified by the given link element exists.

Parameters:

xpath - An XPath expression that is evaluated against the given linkNode to yield a URI reference.

linkNode - A DOM node containing a URI reference (e.g. kml:Link, kml:Icon).

httpClient - An HTTP client component. If null, one will be created.

mediaTypes - An array or sequence of String values that describe the expected media type(s) of the target resource.

assertReferentExists

public static void assertReferentExists(URI uriRef,
                        String baseURI,
                        com.sun.jersey.api.client.Client httpClient,
                        String... mediaTypes)

Asserts that the resource identified by the given URI reference exists.

Parameters:

uriRef - A URI reference.

baseURI - A base URI for resolving a relative URI reference.

httpClient - An HTTP client component. If null, one will be created.

mediaTypes - An array or sequence of String values that describe the expected media type(s) of the target resource.

assertValidUpdate

public static void assertValidUpdate(Node updateNode)

Asserts that the given kml:Update element is valid. More precisely, for each targetId attribute appearing in the update, the expression //kml:*[ @id = targetId] must evaluate to true when evaluated against the referenced data (kml:targetHref).

Parameters:

updateNode - A node representing a kml:Update element.