org.opends.server.schema
Class UTCTimeSyntax

java.lang.Object
  org.opends.server.api.AttributeSyntax<AttributeSyntaxCfg>
      org.opends.server.schema.UTCTimeSyntax

public class UTCTimeSyntax
extends AttributeSyntax<AttributeSyntaxCfg>

This class implements the UTC time attribute syntax. This is very similar to the generalized time syntax (and actually has been deprecated in favor of that), but requires that the minute be provided and does not allow for sub-second times. All matching will be performed using the generalized time matching rules, and equality, ordering, and substring matching will be allowed.

Constructor Summary

UTCTimeSyntax()
Creates a new instance of this syntax.

Method Summary

static AttributeValue	createUTCTimeValue(java.util.Date d) Retrieves an attribute value containing a UTC time representation of the provided date.
static java.util.Date	decodeUTCTimeValue(ByteString normalizedValue) Decodes the provided normalized value as a UTC time value and retrieves a Java Date object containing its representation.
ApproximateMatchingRule	getApproximateMatchingRule() Retrieves the default approximate matching rule that will be used for attributes with this syntax.
java.lang.String	getDescription() Retrieves a description for this attribute syntax.
EqualityMatchingRule	getEqualityMatchingRule() Retrieves the default equality matching rule that will be used for attributes with this syntax.
java.lang.String	getOID() Retrieves the OID for this attribute syntax.
OrderingMatchingRule	getOrderingMatchingRule() Retrieves the default ordering matching rule that will be used for attributes with this syntax.
SubstringMatchingRule	getSubstringMatchingRule() Retrieves the default substring matching rule that will be used for attributes with this syntax.
java.lang.String	getSyntaxName() Retrieves the common name for this attribute syntax.
void	initializeSyntax(AttributeSyntaxCfg configuration) Initializes this attribute syntax based on the information in the provided configuration entry.
boolean	valueIsAcceptable(ByteString value, MessageBuilder invalidReason) Indicates whether the provided value is acceptable for use in an attribute with this syntax.

Methods inherited from class org.opends.server.api.AttributeSyntax

equals, finalizeSyntax, hashCode, isConfigurationAcceptable, toString, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

UTCTimeSyntax

public UTCTimeSyntax()

Creates a new instance of this syntax. Note that the only thing that should be done here is to invoke the default constructor for the superclass. All initialization should be performed in the initializeSyntax method.

Method Detail

initializeSyntax

public void initializeSyntax(AttributeSyntaxCfg configuration)
                      throws ConfigException

Initializes this attribute syntax based on the information in the provided configuration entry.

Specified by:

initializeSyntax in class AttributeSyntax<AttributeSyntaxCfg>

Parameters:

configuration - The configuration to use to initialize this attribute syntax.

Throws:

ConfigException - If an unrecoverable problem arises in the process of performing the initialization.

getSyntaxName

public java.lang.String getSyntaxName()

Retrieves the common name for this attribute syntax.

Specified by:

getSyntaxName in class AttributeSyntax<AttributeSyntaxCfg>

Returns:

The common name for this attribute syntax.

getOID

public java.lang.String getOID()

Retrieves the OID for this attribute syntax.

Specified by:

getOID in class AttributeSyntax<AttributeSyntaxCfg>

Returns:

The OID for this attribute syntax.

getDescription

public java.lang.String getDescription()

Retrieves a description for this attribute syntax.

Specified by:

getDescription in class AttributeSyntax<AttributeSyntaxCfg>

Returns:

A description for this attribute syntax.

getEqualityMatchingRule

public EqualityMatchingRule getEqualityMatchingRule()

Retrieves the default equality matching rule that will be used for attributes with this syntax.

Specified by:

getEqualityMatchingRule in class AttributeSyntax<AttributeSyntaxCfg>

Returns:

The default equality matching rule that will be used for attributes with this syntax, or null if equality matches will not be allowed for this type by default.

getOrderingMatchingRule

public OrderingMatchingRule getOrderingMatchingRule()

Retrieves the default ordering matching rule that will be used for attributes with this syntax.

Specified by:

getOrderingMatchingRule in class AttributeSyntax<AttributeSyntaxCfg>

Returns:

The default ordering matching rule that will be used for attributes with this syntax, or null if ordering matches will not be allowed for this type by default.

getSubstringMatchingRule

public SubstringMatchingRule getSubstringMatchingRule()

Retrieves the default substring matching rule that will be used for attributes with this syntax.

Specified by:

getSubstringMatchingRule in class AttributeSyntax<AttributeSyntaxCfg>

Returns:

The default substring matching rule that will be used for attributes with this syntax, or null if substring matches will not be allowed for this type by default.

getApproximateMatchingRule

public ApproximateMatchingRule getApproximateMatchingRule()

Retrieves the default approximate matching rule that will be used for attributes with this syntax.

Specified by:

getApproximateMatchingRule in class AttributeSyntax<AttributeSyntaxCfg>

Returns:

The default approximate matching rule that will be used for attributes with this syntax, or null if approximate matches will not be allowed for this type by default.

valueIsAcceptable

public boolean valueIsAcceptable(ByteString value,
                                 MessageBuilder invalidReason)

Indicates whether the provided value is acceptable for use in an attribute with this syntax. If it is not, then the reason may be appended to the provided buffer.

Specified by:

valueIsAcceptable in class AttributeSyntax<AttributeSyntaxCfg>

Parameters:

value - The value for which to make the determination.

invalidReason - The buffer to which the invalid reason should be appended.

Returns:

true if the provided value is acceptable for use with this syntax, or false if not.

createUTCTimeValue

public static AttributeValue createUTCTimeValue(java.util.Date d)

Retrieves an attribute value containing a UTC time representation of the provided date.

Parameters:

d - The date for which to retrieve the UTC time value.

Returns:

The attribute value created from the date.

decodeUTCTimeValue

public static java.util.Date decodeUTCTimeValue(ByteString normalizedValue)
                                         throws DirectoryException

Decodes the provided normalized value as a UTC time value and retrieves a Java Date object containing its representation.

Parameters:

normalizedValue - The normalized UTC time value to decode to a Java Date.

Returns:

The Java Date created from the provided UTC time value.

Throws:

DirectoryException - If the provided value cannot be parsed as a valid UTC time string.