org.opengis.cite.kml2

Class ETSAssert

java.lang.Object

org.opengis.cite.kml2.ETSAssert

public class ETSAssert
extends Object

Provides a set of custom assertion methods.

Method Summary

Modifier and Type	Method and Description
static void	assertDescendantElementCount(Node node, QName elementName, int expectedCount) Asserts that the given DOM node contains the expected number of descendant elements having the specified name.
static void	assertQualifiedName(Node node, QName... expectedNames) Asserts that the qualified name of a DOM node matches one of the expected values.
static void	assertReferentExists(URI uri, javax.ws.rs.core.MediaType... acceptableTypes) Asserts that the resource referenced by the given URI exists and is compatible with one of the acceptable media types.
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	assertSchematronValid(URL schemaRef, Source xmlSource, String activePhase) Asserts that an XML resource satisfies all applicable constraints defined for the specified phase in a Schematron (ISO 19757-3) schema.
static void	assertSchemaValid(Validator validator, Source source) Asserts that an XML resource is schema-valid.
static void	assertValidAltitudeMode(Element kmlElement) Asserts that the value of the child element kml:altitudeMode is correct according to the values of the kml:tessellate and kml:extrude elements.
static void	assertValidEmailAddress(String emailAddr) Asserts that a given email address conforms to the "addr-spec" production in RFC 5322.
static void	assertValidIRI(String id) Asserts that a resource identifier is a valid internationalized resource identifier (IRI).
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.

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... expectedNames)

Asserts that the qualified name of a DOM node matches one of the expected values.

Parameters:

node - The Node to check.

expectedNames - A collection of QName objects.

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.

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. All patterns are checked.

Parameters:

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

xmlSource - The XML Source to be validated.

assertSchematronValid

public static void assertSchematronValid(URL schemaRef,
                                         Source xmlSource,
                                         String activePhase)

Asserts that an XML resource satisfies all applicable constraints defined for the specified phase in a Schematron (ISO 19757-3) schema. The "xslt2" query language binding is supported. Two phase names have special meanings:

• "#ALL": All patterns are active
• "#DEFAULT": The phase identified by the defaultPhase attribute on the schema element should be used.

Parameters:

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

xmlSource - The XML Source to be validated.

activePhase - The active phase (pattern set) whose patterns are used for validation; this is set to "#ALL" if not specified.

assertDescendantElementCount

public static void assertDescendantElementCount(Node node,
                                                QName elementName,
                                                int expectedCount)

Asserts that the given DOM node contains the expected number of descendant elements having the specified name.

Parameters:

node - A Document or Element node.

elementName - The qualified name of the element.

expectedCount - The expected number of occurrences.

assertValidAltitudeMode

public static void assertValidAltitudeMode(Element kmlElement)

Asserts that the value of the child element kml:altitudeMode is correct according to the values of the kml:tessellate and kml:extrude elements.

Parameters:

kmlElement - A KML (geometry) element.

See Also:

"ATC-112: Geometry extrusion", "ATC-113: Geometry tessellation"

assertReferentExists

public static void assertReferentExists(URI uri,
                                        javax.ws.rs.core.MediaType... acceptableTypes)

Asserts that the resource referenced by the given URI exists and is compatible with one of the acceptable media types.

Parameters:

uri - An absolute URI based on the 'file' or 'http(s)' schemes.

acceptableTypes - A list of acceptable media types; if empty the media range is unconstrained (any type).

assertValidEmailAddress

public static void assertValidEmailAddress(String emailAddr)

Asserts that a given email address conforms to the "addr-spec" production in RFC 5322.

Parameters:

emailAddr - A String denoting an email address.

See Also:

RFC 5322: Internet Message Format - Addr-Spec Specification

assertValidIRI

public static void assertValidIRI(String id)

Asserts that a resource identifier is a valid internationalized resource identifier (IRI). An IRI is a sequence of characters from the Universal Character Set (Unicode/ISO 10646).

Parameters:

id - A String representing a resource identifier.

See Also:

RFC 3987: Internationalized Resource Identifiers (IRIs)