buri.ddmsence.ddms.extensible

Class ExtensibleAttributes

Object

buri.ddmsence.AbstractAttributeGroup

buri.ddmsence.ddms.extensible.ExtensibleAttributes

public final class ExtensibleAttributes
extends AbstractAttributeGroup

Attribute group representing the xs:anyAttribute tag which appears on various DDMS components.

Starting in DDMS 3.0, this attribute group can decorate Organization, Person, Service, Unknown, Keyword, Category, or the Resource itself. In DDMS 2.0, this attribute group can only decorate Organization, Person, Service, or the Resource.

No validation or processing of any kind is performed by DDMSence on extensible attributes, other than the base validation used when loading attributes from an XML file, and a check to confirm that extensible attributes do not collide with existing attributes. This class merely exposes a getAttributes() method which returns a read-only List of XOM Attributes that can be manipulated in business-specific ways.

For example, this ddms:Keyword would have an ExtensibleAttributes instance containing 2 attributes (assuming that the "opensearch" namespace was defined earlier in the file):

<ddms:Keyword ddms:value="xml" opensearch:relevance="95" opensearch:confidence="82" />

XOM attributes can be created as follows:

Attribute attribute = new Attribute("opensearch:relevance", "http://opensearch.namespace/", "95");
Attribute attribute = new Attribute("opensearch:confidence", "http://opensearch.namespace/", "82");

The DDMS documentation does not provide sample HTML/Text output for extensible attributes, so the following approach is used. In general, the HTML/Text output of extensible attributes will be prefixed with the name of the element being marked. For example:

keyword opensearch:relevance: 95
keyword opensearch:confidence: 82
<meta name="subjectCoverage.Subject.keyword.opensearch.relevance" content="95" />
<meta name="subjectCoverage.Subject.keyword.opensearch.confidence" content="82" />


Details about the XOM Attribute class can be found at: http://www.xom.nu/apidocs/index.html?nu/xom/Attribute.html

Since:

1.1.0

Author:

Brian Uri!

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ExtensibleAttributes.AttributeBuilder Builder for a XOM attribute.
static class	ExtensibleAttributes.Builder Builder for these attributes.

Constructor Summary

Constructors

Constructor and Description
ExtensibleAttributes(nu.xom.Element element) Base constructor
ExtensibleAttributes(List<nu.xom.Attribute> attributes) Constructor which builds from raw data.

Method Summary

Methods

Modifier and Type	Method and Description
void	addTo(nu.xom.Element element) Convenience method to add these attributes onto an existing XOM Element
boolean	equals(Object obj)
List<nu.xom.Attribute>	getAttributes() Accessor for the attributes.
static ExtensibleAttributes	getNonNullInstance(ExtensibleAttributes extensibleAttributes) Returns a non-null instance of extensible attributes.
String	getOutput(boolean isHTML, String prefix) Outputs to HTML or Text with a prefix at the beginning of each meta tag or line.
int	hashCode()
boolean	isEmpty() Checks if any attributes have been set.
protected void	validate() Currently, no further validation is performed.

Methods inherited from class buri.ddmsence.AbstractAttributeGroup

getDDMSVersion, getValidationWarnings, getWarnings, validateSameVersion

Methods inherited from class Object

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

Constructor Detail

ExtensibleAttributes

public ExtensibleAttributes(nu.xom.Element element)
                     throws InvalidDDMSException

Base constructor

Will only load attributes from a different namespace than DDMS (##other) and will also skip any Resource attributes that are reserved.

Parameters:

element - the XOM element which is decorated with these attributes.

Throws:

InvalidDDMSException

ExtensibleAttributes

public ExtensibleAttributes(List<nu.xom.Attribute> attributes)
                     throws InvalidDDMSException

Constructor which builds from raw data. Because the parent is not known at this time, will accept all attributes. The method, addTo() will confirm that the names do not clash with existing or reserved names on the element.

Parameters:

attributes - a list of extensible attributes

Throws:

InvalidDDMSException - if any required information is missing or malformed

Method Detail

getNonNullInstance

public static ExtensibleAttributes getNonNullInstance(ExtensibleAttributes extensibleAttributes)
                                               throws InvalidDDMSException

Returns a non-null instance of extensible attributes. If the instance passed in is not null, it will be returned.

Parameters:

extensibleAttributes - the attributes to return by default

Returns:

a non-null attributes instance

Throws:

InvalidDDMSException - if there are problems creating the empty attributes instance

addTo

public void addTo(nu.xom.Element element)
           throws InvalidDDMSException

Convenience method to add these attributes onto an existing XOM Element

Parameters:

element - the element to decorate

Throws:

InvalidDDMSException - if the attribute already exists

isEmpty

public boolean isEmpty()

Checks if any attributes have been set.

Returns:

true if no attributes have values, false otherwise

validate

protected void validate()
                 throws InvalidDDMSException

Currently, no further validation is performed.

Overrides:

validate in class AbstractAttributeGroup

Throws:

InvalidDDMSException - if any required information is missing or malformed

getOutput

public String getOutput(boolean isHTML,
               String prefix)

Description copied from class: AbstractAttributeGroup

Outputs to HTML or Text with a prefix at the beginning of each meta tag or line.

Specified by:

getOutput in class AbstractAttributeGroup

Parameters:

isHTML - true for HTML, false for Text

prefix - the prefix to add

Returns:

the HTML or Text output

See Also:

AbstractAttributeGroup.getOutput(boolean, String)

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

See Also:

Object.equals(Object)

hashCode

public int hashCode()

Overrides:

hashCode in class Object

See Also:

Object.hashCode()

getAttributes

public List<nu.xom.Attribute> getAttributes()

Accessor for the attributes. Returns a copy.