org.opends.server.schema

Class CountryStringSyntax

java.lang.Object

org.opends.server.api.AttributeSyntax<CountryStringAttributeSyntaxCfg>

org.opends.server.schema.CountryStringSyntax

All Implemented Interfaces:

ConfigurationChangeListener<CountryStringAttributeSyntaxCfg>

public class CountryStringSyntax
extends AttributeSyntax<CountryStringAttributeSyntaxCfg>
implements ConfigurationChangeListener<CountryStringAttributeSyntaxCfg>

This class defines the country string attribute syntax, which should be a two-character ISO 3166 country code. However, for maintainability, it will accept any value consisting entirely of two printable characters. In most ways, it will behave like the directory string attribute syntax.

Constructor Summary

Constructors

Constructor and Description
CountryStringSyntax() Creates a new instance of this syntax.

Method Summary

Methods

Modifier and Type	Method and Description
org.forgerock.opendj.config.server.ConfigChangeResult	applyConfigurationChange(CountryStringAttributeSyntaxCfg configuration) Applies the configuration changes to this change listener.
String	getDescription() Retrieves a description for this attribute syntax.
String	getName() Retrieves the common name for this attribute syntax.
String	getOID() Retrieves the OID for this attribute syntax.
org.forgerock.opendj.ldap.schema.Syntax	getSDKSyntax(org.forgerock.opendj.ldap.schema.Schema schema) Returns the SDK Syntax equivalent to this syntax.
void	initializeSyntax(CountryStringAttributeSyntaxCfg configuration, ServerContext serverContext) Initializes this attribute syntax based on the information in the provided configuration entry.
boolean	isConfigurationChangeAcceptable(CountryStringAttributeSyntaxCfg configuration, List<LocalizableMessage> unacceptableReasons) Indicates whether the proposed change to the configuration is acceptable to this change listener.

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

equals, finalizeSyntax, getApproximateMatchingRule, getEqualityMatchingRule, getOrderingMatchingRule, getSubstringMatchingRule, hashCode, isBEREncodingRequired, isConfigurationAcceptable, isHumanReadable, toString, toString, valueIsAcceptable

Methods inherited from class java.lang.Object

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

Constructor Detail

CountryStringSyntax

public CountryStringSyntax()

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(CountryStringAttributeSyntaxCfg configuration,
                    ServerContext serverContext)
                      throws org.forgerock.opendj.config.server.ConfigException

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

Overrides:

initializeSyntax in class AttributeSyntax<CountryStringAttributeSyntaxCfg>

Parameters:

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

serverContext - The server context.

Throws:

org.forgerock.opendj.config.server.ConfigException - If an unrecoverable problem arises in the process of performing the initialization.

getSDKSyntax

public org.forgerock.opendj.ldap.schema.Syntax getSDKSyntax(org.forgerock.opendj.ldap.schema.Schema schema)

Returns the SDK Syntax equivalent to this syntax.

This method allow smooth migration to SDK syntax. It will disappear once the the migration to SDK schema is complete, together with this class and all its implementation.

Specified by:

getSDKSyntax in class AttributeSyntax<CountryStringAttributeSyntaxCfg>

Parameters:

schema - Schema to use to retrieve the syntax

Returns:

the equivalent SDK syntax.

isConfigurationChangeAcceptable

public boolean isConfigurationChangeAcceptable(CountryStringAttributeSyntaxCfg configuration,
                                      List<LocalizableMessage> unacceptableReasons)

Indicates whether the proposed change to the configuration is acceptable to this change listener.

Specified by:

isConfigurationChangeAcceptable in interface ConfigurationChangeListener<CountryStringAttributeSyntaxCfg>

Parameters:

configuration - The new configuration containing the changes.

unacceptableReasons - A list that can be used to hold messages about why the provided configuration is not acceptable.

Returns:

Returns true if the proposed change is acceptable, or false if it is not.

applyConfigurationChange

public org.forgerock.opendj.config.server.ConfigChangeResult applyConfigurationChange(CountryStringAttributeSyntaxCfg configuration)

Applies the configuration changes to this change listener.

Specified by:

applyConfigurationChange in interface ConfigurationChangeListener<CountryStringAttributeSyntaxCfg>

Parameters:

configuration - The new configuration containing the changes.

Returns:

Returns information about the result of changing the configuration.

getName

public String getName()

Retrieves the common name for this attribute syntax.

Specified by:

getName in class AttributeSyntax<CountryStringAttributeSyntaxCfg>

Returns:

The common name for this attribute syntax.

getOID

public String getOID()

Retrieves the OID for this attribute syntax.

Specified by:

getOID in class AttributeSyntax<CountryStringAttributeSyntaxCfg>

Returns:

The OID for this attribute syntax.

getDescription

public String getDescription()

Retrieves a description for this attribute syntax.

Specified by:

getDescription in class AttributeSyntax<CountryStringAttributeSyntaxCfg>

Returns:

A description for this attribute syntax.