Package net.sf.saxon.s9api

Enum UnprefixedElementMatchingPolicy

java.lang.Object

java.lang.Enum<UnprefixedElementMatchingPolicy>

net.sf.saxon.s9api.UnprefixedElementMatchingPolicy

All Implemented Interfaces:

Serializable, Comparable<UnprefixedElementMatchingPolicy>, java.lang.constant.Constable

public enum UnprefixedElementMatchingPolicy
extends Enum<UnprefixedElementMatchingPolicy>

An enumeration defining possible strategies for resolving unprefixed element names appearing as name tests in the steps of a path expression or XSLT match pattern

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Enum

Enum.EnumDesc<E extends Enum<E>>

Enum Constant Summary

Enum Constants

Enum Constant	Description
ANY_NAMESPACE	Under this policy, unprefixed element names match on the local part only; an element with this local name is matched regardless of its namespace (that is, it can have any namespace, or none)
DEFAULT_NAMESPACE	The standard W3C policy, whereby element names are implicitly qualified by the default namespace for elements and types, as defined in the XPath static context.
DEFAULT_NAMESPACE_OR_NONE	Under this policy, unprefixed element names match provided that (a) the local part of the name matches, and (b) the namespace part of the name is either equal to the default namespace for elements and types, or is absent.

Method Summary

Modifier and Type	Method	Description
static UnprefixedElementMatchingPolicy	valueOf(String name)	Returns the enum constant of this type with the specified name.
static UnprefixedElementMatchingPolicy[]	values()	Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Details

DEFAULT_NAMESPACE

public static final UnprefixedElementMatchingPolicy DEFAULT_NAMESPACE

The standard W3C policy, whereby element names are implicitly qualified by the default namespace for elements and types, as defined in the XPath static context. In XSLT this can be set using the [xsl:]xpath-default-namespace attribute, or programmatically using XsltCompiler.setDefaultElementNamespace(String)

ANY_NAMESPACE

public static final UnprefixedElementMatchingPolicy ANY_NAMESPACE

Under this policy, unprefixed element names match on the local part only; an element with this local name is matched regardless of its namespace (that is, it can have any namespace, or none)

DEFAULT_NAMESPACE_OR_NONE

public static final UnprefixedElementMatchingPolicy DEFAULT_NAMESPACE_OR_NONE

Under this policy, unprefixed element names match provided that (a) the local part of the name matches, and (b) the namespace part of the name is either equal to the default namespace for elements and types, or is absent.

This policy is provided primarily for use with HTML, where it can be unpredictable whether HTML elements are in the XHTML namespace or in no namespace. It is also useful with other vocabularies where instances are sometimes in a namespace and sometimes not. The policy approximates to the special rules defined in the HTML5 specification, which states that unprefixed names are treated as matching names in the XHTML namespace if the context item for a step is "a node in an HTML DOM", and as matching no-namespace names otherwise; since in the XDM data model it is not possible to make a distinction between different kinds of DOM, this policy allows use of unprefixed names both when matching elements in the XHTML namespace and when matching no-namespace elements

Method Details

values

public static UnprefixedElementMatchingPolicy[] values()

Returns an array containing the constants of this enum type, in the order they are declared.

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static UnprefixedElementMatchingPolicy valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null