buri.ddmsence.ddms.security.ism

Class NoticeAttributes

Object

buri.ddmsence.AbstractAttributeGroup

buri.ddmsence.ddms.security.ism.NoticeAttributes

public final class NoticeAttributes
extends AbstractAttributeGroup

Attribute group for the ISM notice markings used on a ddms:resource and ISM:Notice, starting in DDMS 4.0.1.

Attributes
ISM:noticeType: (optional) ISM:noticeReason: (optional) ISM:noticeDate: (optional) ISM:unregisteredNoticeType: (optional) ISM:externalNotice: (optional, starting in DDMS 4.1)

Since:

2.0.0

Author:

Brian Uri!

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	NoticeAttributes.Builder Builder for these attributes.

Field Summary

Fields

Modifier and Type	Field and Description
static String	EXTERNAL_NOTICE_NAME Attribute name
static int	MAX_LENGTH Maximum length of reason and unregistered notice type attributes.
static Set<String>	NON_EXTENSIBLE_NAMES A set of all SecurityAttribute names which should not be converted into ExtensibleAttributes
static String	NOTICE_DATE_NAME Attribute name
static String	NOTICE_REASON_NAME Attribute name
static String	NOTICE_TYPE_NAME Attribute name
static String	UNREGISTERED_NOTICE_TYPE_NAME Attribute name

Constructor Summary

Constructors

Constructor and Description
NoticeAttributes(nu.xom.Element element) Base constructor
NoticeAttributes(String noticeType, String noticeReason, String noticeDate, String unregisteredNoticeType) Deprecated. A new constructor was added for DDMS 4.1 to support ism:externalNotice. This constructor is preserved for backwards compatibility, but may disappear in the next major release.
NoticeAttributes(String noticeType, String noticeReason, String noticeDate, String unregisteredNoticeType, Boolean externalNotice) 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)
static NoticeAttributes	getNonNullInstance(NoticeAttributes noticeAttributes) Returns a non-null instance of notice attributes.
javax.xml.datatype.XMLGregorianCalendar	getNoticeDate() Accessor for the noticeDate attribute.
String	getNoticeReason() Accessor for the noticeReason attribute.
String	getNoticeType() Accessor for the noticeType attribute.
String	getOutput(boolean isHTML, String prefix) Outputs to HTML or Text with a prefix at the beginning of each meta tag or line.
String	getUnregisteredNoticeType() Accessor for the unregisteredNoticeType attribute.
int	hashCode()
boolean	isEmpty() Checks if any attributes have been set.
Boolean	isExternalReference() Accessor for the externalNotice attribute.
protected void	validate() Validates the attribute group.

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

Field Detail

NOTICE_TYPE_NAME

public static final String NOTICE_TYPE_NAME

Attribute name

See Also:

Constant Field Values

NOTICE_REASON_NAME

public static final String NOTICE_REASON_NAME

Attribute name

See Also:

Constant Field Values

NOTICE_DATE_NAME

public static final String NOTICE_DATE_NAME

Attribute name

See Also:

Constant Field Values

UNREGISTERED_NOTICE_TYPE_NAME

public static final String UNREGISTERED_NOTICE_TYPE_NAME

Attribute name

See Also:

Constant Field Values

EXTERNAL_NOTICE_NAME

public static final String EXTERNAL_NOTICE_NAME

Attribute name

See Also:

Constant Field Values

MAX_LENGTH

public static final int MAX_LENGTH

Maximum length of reason and unregistered notice type attributes.

See Also:

Constant Field Values

NON_EXTENSIBLE_NAMES

public static final Set<String> NON_EXTENSIBLE_NAMES

A set of all SecurityAttribute names which should not be converted into ExtensibleAttributes

Constructor Detail

NoticeAttributes

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

Base constructor

Parameters:

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

Throws:

InvalidDDMSException

NoticeAttributes

public NoticeAttributes(String noticeType,
                String noticeReason,
                String noticeDate,
                String unregisteredNoticeType)
                 throws InvalidDDMSException

Deprecated. A new constructor was added for DDMS 4.1 to support ism:externalNotice. This constructor is preserved for backwards compatibility, but may disappear in the next major release.

Constructor which builds from raw data.

Parameters:

noticeType - the notice type (with a value from the CVE)

noticeReason - the reason associated with a notice

noticeDate - the date associated with a notice

unregisteredNoticeType - a notice type not in the CVE

Throws:

InvalidDDMSException - if any required information is missing or malformed

NoticeAttributes

public NoticeAttributes(String noticeType,
                String noticeReason,
                String noticeDate,
                String unregisteredNoticeType,
                Boolean externalNotice)
                 throws InvalidDDMSException

Constructor which builds from raw data.

Parameters:

noticeType - the notice type (with a value from the CVE)

noticeReason - the reason associated with a notice

noticeDate - the date associated with a notice

unregisteredNoticeType - a notice type not in the CVE

externalNotice - true if this notice is for an external resource

Throws:

InvalidDDMSException - if any required information is missing or malformed

Method Detail

getNonNullInstance

public static NoticeAttributes getNonNullInstance(NoticeAttributes noticeAttributes)
                                           throws InvalidDDMSException

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

Parameters:

noticeAttributes - 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

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

Validates the attribute group. Where appropriate the ISMVocabulary enumerations are validated.

Rules

If set, the noticeType attribute must be a valid token. The noticeReason must be shorter than 2048 characters. The unregisteredNoticeType must be shorter than 2048 characters. If set, the noticeDate attribute is a valid xs:date value. These attributes cannot be used until DDMS 4.0.1 or later. The externalNotice attribute cannot be used until DDMS 4.1 or later. Does NOT do any validation on the constraints described in the DES ISM specification.

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()

getNoticeType

public String getNoticeType()

Accessor for the noticeType attribute.

getNoticeReason

public String getNoticeReason()

Accessor for the noticeReason attribute.

getUnregisteredNoticeType

public String getUnregisteredNoticeType()

Accessor for the unregisteredNoticeType attribute.

isExternalReference

public Boolean isExternalReference()

Accessor for the externalNotice attribute. This may be null before DDMS 4.1.

getNoticeDate

public javax.xml.datatype.XMLGregorianCalendar getNoticeDate()

Accessor for the noticeDate attribute. May return null if not set.