net.shibboleth.utilities.java.support.xml

Class AttributeSupport

java.lang.Object

net.shibboleth.utilities.java.support.xml.AttributeSupport

public final class AttributeSupport
extends java.lang.Object

Set of helper methods for working with DOM Attributes.

Constructor Summary

Constructors

Modifier	Constructor and Description
private	AttributeSupport() Constructor.

Method Summary

Modifier and Type	Method and Description
static void	addXMLBase(org.w3c.dom.Element element, java.lang.String base) Adds a xml:base attribute to the given Element.
static void	addXMLId(org.w3c.dom.Element element, java.lang.String id) Adds a xml:id attribute to the given Element.
static void	addXMLLang(org.w3c.dom.Element element, java.lang.String lang) Adds a xml:lang attribute to the given Element.
static void	addXMLSpace(org.w3c.dom.Element element, XMLSpace space) Adds a xml:space attribute to the given Element.
static void	appendAttribute(org.w3c.dom.Element element, javax.xml.namespace.QName attributeName, java.util.List<java.lang.String> attributeValues, boolean isIDAttribute) Adds an attribute name and value to a DOM Element.
static void	appendAttribute(org.w3c.dom.Element element, javax.xml.namespace.QName attributeName, java.lang.String attributeValue) Adds an non-id attribute name and value to a DOM Element.
static void	appendAttribute(org.w3c.dom.Element element, javax.xml.namespace.QName attributeName, java.lang.String attributeValue, boolean isIDAttribute) Adds an attribute name and value to a DOM Element.
static void	appendDateTimeAttribute(org.w3c.dom.Element element, javax.xml.namespace.QName attributeName, long duration) Adds an attribute to the given element.
static void	appendDurationAttribute(org.w3c.dom.Element element, javax.xml.namespace.QName attributeName, long duration) Adds an attribute to given element.
static org.w3c.dom.Attr	constructAttribute(org.w3c.dom.Document owningDocument, javax.xml.namespace.QName attributeName) Constructs an attribute owned by the given document with the given name.
static org.w3c.dom.Attr	constructAttribute(org.w3c.dom.Document document, java.lang.String namespaceURI, java.lang.String localName, java.lang.String prefix) Constructs an attribute owned by the given document with the given name.
static org.w3c.dom.Attr	getAttribute(org.w3c.dom.Element element, javax.xml.namespace.QName attributeName) Gets the attribute with the given name.
static java.lang.String	getAttributeValue(org.w3c.dom.Element element, javax.xml.namespace.QName attributeName) Gets the value of an attribute from an element.
static java.lang.String	getAttributeValue(org.w3c.dom.Element element, java.lang.String namespace, java.lang.String attributeLocalName) Gets the value of an attribute from an element.
static java.lang.Boolean	getAttributeValueAsBoolean(org.w3c.dom.Attr attribute) Parses the attribute's value.
static java.util.List<java.lang.String>	getAttributeValueAsList(org.w3c.dom.Attr attribute) Gets the value of a list-type attribute as a list.
static javax.xml.namespace.QName	getAttributeValueAsQName(org.w3c.dom.Attr attribute) Constructs a QName from an attributes value.
static java.lang.Long	getDateTimeAttributeAsLong(org.w3c.dom.Attr attribute) Gets the value of a dateTime-type attribute in milliseconds since the epoch.
static java.lang.Long	getDurationAttributeValueAsLong(org.w3c.dom.Attr attribute) Gets the value of a duration-type attribute in milliseconds.
static org.w3c.dom.Attr	getIdAttribute(org.w3c.dom.Element element) Gets the ID attribute of a DOM element.
static java.lang.String	getXMLBase(org.w3c.dom.Element element) Gets the xml:base attribute from a given Element.
static java.lang.String	getXMLId(org.w3c.dom.Element element) Gets the xml:id attribute from a given Element.
static java.lang.String	getXMLLang(org.w3c.dom.Element element) Gets the xml:lang attribute from a given Element.
static java.util.Locale	getXMLLangAsLocale(org.w3c.dom.Element element) Gets the locale currently active for the element.
static XMLSpace	getXMLSpace(org.w3c.dom.Element element) Gets the xml:space attribute from a given Element.
static boolean	hasAttribute(org.w3c.dom.Element element, javax.xml.namespace.QName name) Checks if the given attribute has an attribute with the given name.
static boolean	removeAttribute(org.w3c.dom.Element element, javax.xml.namespace.QName attributeName) Removes an attribute from an element.

Methods inherited from class java.lang.Object

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

Constructor Detail

AttributeSupport

private AttributeSupport()

Constructor.

Method Detail

addXMLBase

public static void addXMLBase(@Nonnull
                              org.w3c.dom.Element element,
                              @Nonnull
                              java.lang.String base)

Adds a xml:base attribute to the given Element.

Parameters:

element - the element to which to add the attribute

base - the base value

addXMLId

public static void addXMLId(@Nonnull
                            org.w3c.dom.Element element,
                            @Nonnull
                            java.lang.String id)

Adds a xml:id attribute to the given Element.

Parameters:

element - the element to which to add the attribute

id - the Id value

addXMLLang

public static void addXMLLang(@Nonnull
                              org.w3c.dom.Element element,
                              @Nonnull
                              java.lang.String lang)

Adds a xml:lang attribute to the given Element.

Parameters:

element - the element to which to add the attribute

lang - the lang value

addXMLSpace

public static void addXMLSpace(@Nonnull
                               org.w3c.dom.Element element,
                               @Nonnull
                               XMLSpace space)

Adds a xml:space attribute to the given Element.

Parameters:

element - the element to which to add the attribute

space - the space value

appendAttribute

public static void appendAttribute(@Nonnull
                                   org.w3c.dom.Element element,
                                   @Nonnull
                                   javax.xml.namespace.QName attributeName,
                                   java.util.List<java.lang.String> attributeValues,
                                   boolean isIDAttribute)

Adds an attribute name and value to a DOM Element. This is particularly useful for attributes whose names appear in namespace-qualified form.

Parameters:

attributeName - the attribute name in QName form

attributeValues - the attribute values

element - the target element to which to marshall

isIDAttribute - flag indicating whether the attribute being marshalled should be handled as an ID-typed attribute

appendAttribute

public static void appendAttribute(@Nonnull
                                   org.w3c.dom.Element element,
                                   @Nonnull
                                   javax.xml.namespace.QName attributeName,
                                   @Nonnull
                                   java.lang.String attributeValue)

Adds an non-id attribute name and value to a DOM Element. This is particularly useful for attributes whose names appear in namespace-qualified form.

Parameters:

attributeName - the attribute name in QName form

attributeValue - the attribute values

element - the target element to which to marshall

appendAttribute

public static void appendAttribute(@Nonnull
                                   org.w3c.dom.Element element,
                                   @Nonnull
                                   javax.xml.namespace.QName attributeName,
                                   @Nonnull
                                   java.lang.String attributeValue,
                                   boolean isIDAttribute)

Adds an attribute name and value to a DOM Element. This is particularly useful for attributes whose names appear in namespace-qualified form.

Parameters:

attributeName - the attribute name in QName form

attributeValue - the attribute value

element - the target element to which to marshall

isIDAttribute - flag indicating whether the attribute being marshalled should be handled as an ID-typed attribute

appendDateTimeAttribute

public static void appendDateTimeAttribute(@Nonnull
                                           org.w3c.dom.Element element,
                                           @Nonnull
                                           javax.xml.namespace.QName attributeName,
                                           long duration)

Adds an attribute to the given element. The value of the attribute is the instant now + the given duration expressed in XML dateTime format.

Parameters:

element - element to which the attribute will be added, not null

attributeName - name of the attribute, not null

duration - duration, in milliseconds, must be greater than 0

appendDurationAttribute

public static void appendDurationAttribute(@Nonnull
                                           org.w3c.dom.Element element,
                                           @Nonnull
                                           javax.xml.namespace.QName attributeName,
                                           long duration)

Adds an attribute to given element. The value of the attribute is the given duration in XML duration format.

Parameters:

element - element to which the attribute will be added, not null

attributeName - name of the attribute, not null

duration - duration, in milliseconds, must be greater than 0

constructAttribute

@Nonnull
public static org.w3c.dom.Attr constructAttribute(@Nonnull
                                                           org.w3c.dom.Document owningDocument,
                                                           @Nonnull
                                                           javax.xml.namespace.QName attributeName)

Constructs an attribute owned by the given document with the given name.

Parameters:

owningDocument - the owning document

attributeName - the name of that attribute

Returns:

the constructed attribute

constructAttribute

@Nonnull
public static org.w3c.dom.Attr constructAttribute(@Nonnull
                                                           org.w3c.dom.Document document,
                                                           @Nullable
                                                           java.lang.String namespaceURI,
                                                           @Nonnull
                                                           java.lang.String localName,
                                                           @Nullable
                                                           java.lang.String prefix)

Constructs an attribute owned by the given document with the given name.

Parameters:

document - the owning document

namespaceURI - the URI for the namespace the attribute is in

localName - the local name

prefix - the prefix of the namespace that attribute is in

Returns:

the constructed attribute

getAttribute

@Nonnull
public static org.w3c.dom.Attr getAttribute(@Nullable
                                                     org.w3c.dom.Element element,
                                                     @Nullable
                                                     javax.xml.namespace.QName attributeName)

Gets the attribute with the given name.

Parameters:

element - element that may contain the attribute, may be null

attributeName - name of the attribute, may be null

Returns:

the attribute or null if the given element or attribute was null or the given attribute did not contain an attribute with the given name

getAttributeValue

@Nullable
public static java.lang.String getAttributeValue(@Nullable
                                                           org.w3c.dom.Element element,
                                                           @Nullable
                                                           javax.xml.namespace.QName attributeName)

Gets the value of an attribute from an element.

Parameters:

element - the element from which to retrieve the attribute value

attributeName - the name of the attribute

Returns:

the value of the attribute or null if the element does not have such an attribute

getAttributeValue

@Nullable
public static java.lang.String getAttributeValue(@Nullable
                                                           org.w3c.dom.Element element,
                                                           @Nullable
                                                           java.lang.String namespace,
                                                           @Nullable
                                                           java.lang.String attributeLocalName)

Gets the value of an attribute from an element.

Parameters:

element - the element from which to retrieve the attribute value

namespace - the namespace URI of the attribute

attributeLocalName - the local (unqualified) attribute name

Returns:

the value of the attribute or null if the element does not have such an attribute

getAttributeValueAsBoolean

@Nullable
public static java.lang.Boolean getAttributeValueAsBoolean(@Nullable
                                                                     org.w3c.dom.Attr attribute)

Parses the attribute's value. If the value is 0 or "false" then false is returned, if the value is 1 or "true" then true is returned, if the value is anything else then null returned.

Parameters:

attribute - attribute whose value will be converted to a boolean

Returns:

boolean value of the attribute or null late enough to allow property replacement.

getAttributeValueAsList

@Nonnull
public static java.util.List<java.lang.String> getAttributeValueAsList(@Nullable
                                                                                org.w3c.dom.Attr attribute)

Gets the value of a list-type attribute as a list.

Parameters:

attribute - attribute whose value will be turned into a list

Returns:

list of values, never null

getAttributeValueAsQName

@Nullable
public static javax.xml.namespace.QName getAttributeValueAsQName(@Nullable
                                                                           org.w3c.dom.Attr attribute)

Constructs a QName from an attributes value.

Parameters:

attribute - the attribute with a QName value

Returns:

a QName from an attributes value, or null if the given attribute is null

getDateTimeAttributeAsLong

@Nullable
public static java.lang.Long getDateTimeAttributeAsLong(@Nullable
                                                                  org.w3c.dom.Attr attribute)

Gets the value of a dateTime-type attribute in milliseconds since the epoch.

Parameters:

attribute - attribute from which to extract the value, may be null

Returns:

date/time in millisecond since the epoch, or null if the attribute was null

getDurationAttributeValueAsLong

@Nullable
public static java.lang.Long getDurationAttributeValueAsLong(@Nullable
                                                                       org.w3c.dom.Attr attribute)

Gets the value of a duration-type attribute in milliseconds.

Parameters:

attribute - attribute from which to extract the value, may be null

Returns:

duration, in millisecond, or null if the attribute was null

getIdAttribute

@Nullable
public static org.w3c.dom.Attr getIdAttribute(@Nullable
                                                        org.w3c.dom.Element element)

Gets the ID attribute of a DOM element.

Parameters:

element - the DOM element

Returns:

the ID attribute or null if there isn't one

getXMLBase

@Nullable
public static java.lang.String getXMLBase(@Nullable
                                                    org.w3c.dom.Element element)

Gets the xml:base attribute from a given Element.

Parameters:

element - the element from which to extract the attribute

Returns:

the value of the xml:base attribute, or null if not present

getXMLId

@Nullable
public static java.lang.String getXMLId(@Nullable
                                                  org.w3c.dom.Element element)

Gets the xml:id attribute from a given Element.

Parameters:

element - the element from which to extract the attribute

Returns:

the value of the xml:id attribute, or null if not present

getXMLLang

@Nullable
public static java.lang.String getXMLLang(@Nullable
                                                    org.w3c.dom.Element element)

Gets the xml:lang attribute from a given Element.

Parameters:

element - the element from which to extract the attribute

Returns:

the value of the xml:lang attribute, or null if not present

getXMLLangAsLocale

@Nullable
public static java.util.Locale getXMLLangAsLocale(@Nullable
                                                            org.w3c.dom.Element element)

Gets the locale currently active for the element. This is done by looking for an xml:lang attribute and parsing its content. If no xml:lang attribute is present the default locale is returned. This method only uses the language primary tag, as defined by RFC3066.

Parameters:

element - element to retrieve local information for

Returns:

the active local of the element

getXMLSpace

@Nullable
public static XMLSpace getXMLSpace(@Nullable
                                             org.w3c.dom.Element element)

Gets the xml:space attribute from a given Element.

Parameters:

element - the element from which to extract the attribute

Returns:

the value of the xml:space attribute, or null if not present

hasAttribute

public static boolean hasAttribute(@Nullable
                                   org.w3c.dom.Element element,
                                   @Nullable
                                   javax.xml.namespace.QName name)

Checks if the given attribute has an attribute with the given name.

Parameters:

element - element to check

name - name of the attribute

Returns:

true if the element has an attribute with the given name, false otherwise

removeAttribute

public static boolean removeAttribute(@Nullable
                                      org.w3c.dom.Element element,
                                      @Nullable
                                      javax.xml.namespace.QName attributeName)

Removes an attribute from an element.

Parameters:

element - element from which the attribute should be removed

attributeName - name of the attribute to be removed

Returns:

true if the element contained the attribute and it was removed, false if the element did not contain such an attribute