com.unboundid.ldap.sdk.schema
Class DITStructureRuleDefinition

java.lang.Object
  com.unboundid.ldap.sdk.schema.SchemaElement
      com.unboundid.ldap.sdk.schema.DITStructureRuleDefinition

All Implemented Interfaces:

java.io.Serializable

@NotMutable
@ThreadSafety(level=COMPLETELY_THREADSAFE)
public final class DITStructureRuleDefinition
extends SchemaElement

This class provides a data structure that describes an LDAP DIT structure rule schema element.

See Also:

Serialized Form

Constructor Summary

DITStructureRuleDefinition(int ruleID, java.lang.String[] names, java.lang.String description, boolean isObsolete, java.lang.String nameFormID, int[] superiorRuleIDs, java.util.Map<java.lang.String,java.lang.String[]> extensions)
Creates a new DIT structure rule with the provided information.

DITStructureRuleDefinition(int ruleID, java.lang.String name, java.lang.String description, java.lang.String nameFormID, java.lang.Integer superiorRuleID, java.util.Map<java.lang.String,java.lang.String[]> extensions)
Creates a new DIT structure rule with the provided information.

DITStructureRuleDefinition(java.lang.String s)
Creates a new DIT structure rule from the provided string representation.

Method Summary

boolean	equals(java.lang.Object o) Indicates whether the provided object is equal to this schema element.
java.lang.String	getDescription() Retrieves the description for this DIT structure rule, if available.
java.util.Map<java.lang.String,java.lang.String[]>	getExtensions() Retrieves the set of extensions for this DIT structure rule.
java.lang.String	getNameFormID() Retrieves the name or OID of the name form with which this DIT structure rule is associated.
java.lang.String	getNameOrRuleID() Retrieves the primary name that can be used to reference this DIT structure rule.
java.lang.String[]	getNames() Retrieves the set of names for this DIT structure rule.
int	getRuleID() Retrieves the rule ID for this DIT structure rule.
int[]	getSuperiorRuleIDs() Retrieves the rule IDs of the superior rules for this DIT structure rule.
int	hashCode() Retrieves a hash code for this schema element.
boolean	hasNameOrRuleID(java.lang.String s) Indicates whether the provided string matches the rule ID or any of the names for this DIT structure rule.
boolean	isObsolete() Indicates whether this DIT structure rule is declared obsolete.
java.lang.String	toString() Retrieves a string representation of this DIT structure rule definition, in the format described in RFC 4512 section 4.1.7.1.

Methods inherited from class com.unboundid.ldap.sdk.schema.SchemaElement

extensionsEqual

Methods inherited from class java.lang.Object

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

Constructor Detail

DITStructureRuleDefinition

public DITStructureRuleDefinition(java.lang.String s)
                           throws LDAPException

Creates a new DIT structure rule from the provided string representation.

Parameters:

s - The string representation of the DIT structure rule to create, using the syntax described in RFC 4512 section 4.1.7.1. It must not be null.

Throws:

LDAPException - If the provided string cannot be decoded as a DIT structure rule definition.

DITStructureRuleDefinition

public DITStructureRuleDefinition(int ruleID,
                                  java.lang.String name,
                                  java.lang.String description,
                                  java.lang.String nameFormID,
                                  java.lang.Integer superiorRuleID,
                                  java.util.Map<java.lang.String,java.lang.String[]> extensions)

Creates a new DIT structure rule with the provided information.

Parameters:

ruleID - The rule ID for this DIT structure rule.

name - The name for this DIT structure rule. It may be null if the DIT structure rule should only be referenced by rule ID.

description - The description for this DIT structure rule. It may be null if there is no description.

nameFormID - The name or OID of the name form with which this DIT structure rule is associated. It must not be null.

superiorRuleID - The superior rule ID for this DIT structure rule. It may be null if there are no superior rule IDs.

extensions - The set of extensions for this DIT structure rule. It may be null or empty if there are no extensions.

DITStructureRuleDefinition

public DITStructureRuleDefinition(int ruleID,
                                  java.lang.String[] names,
                                  java.lang.String description,
                                  boolean isObsolete,
                                  java.lang.String nameFormID,
                                  int[] superiorRuleIDs,
                                  java.util.Map<java.lang.String,java.lang.String[]> extensions)

Creates a new DIT structure rule with the provided information.

Parameters:

ruleID - The rule ID for this DIT structure rule.

names - The set of names for this DIT structure rule. It may be null or empty if the DIT structure rule should only be referenced by rule ID.

description - The description for this DIT structure rule. It may be null if there is no description.

isObsolete - Indicates whether this DIT structure rule is declared obsolete.

nameFormID - The name or OID of the name form with which this DIT structure rule is associated. It must not be null.

superiorRuleIDs - The superior rule IDs for this DIT structure rule. It may be null or empty if there are no superior rule IDs.

extensions - The set of extensions for this DIT structure rule. It may be null or empty if there are no extensions.

Method Detail

getRuleID

public int getRuleID()

Retrieves the rule ID for this DIT structure rule.

Returns:

The rule ID for this DIT structure rule.

getNames

public java.lang.String[] getNames()

Retrieves the set of names for this DIT structure rule.

Returns:

The set of names for this DIT structure rule, or an empty array if it does not have any names.

getNameOrRuleID

public java.lang.String getNameOrRuleID()

Retrieves the primary name that can be used to reference this DIT structure rule. If one or more names are defined, then the first name will be used. Otherwise, the string representation of the rule ID will be returned.

Returns:

The primary name that can be used to reference this DIT structure rule.

hasNameOrRuleID

public boolean hasNameOrRuleID(java.lang.String s)

Indicates whether the provided string matches the rule ID or any of the names for this DIT structure rule.

Parameters:

s - The string for which to make the determination. It must not be null.

Returns:

true if the provided string matches the rule ID or any of the names for this DIT structure rule, or false if not.

getDescription

public java.lang.String getDescription()

Retrieves the description for this DIT structure rule, if available.

Returns:

The description for this DIT structure rule, or null if there is no description defined.

isObsolete

public boolean isObsolete()

Indicates whether this DIT structure rule is declared obsolete.

Returns:

true if this DIT structure rule is declared obsolete, or false if it is not.

getNameFormID

public java.lang.String getNameFormID()

Retrieves the name or OID of the name form with which this DIT structure rule is associated.

Returns:

The name or OID of the name form with which this DIT structure rule is associated.

getSuperiorRuleIDs

public int[] getSuperiorRuleIDs()

Retrieves the rule IDs of the superior rules for this DIT structure rule.

Returns:

The rule IDs of the superior rules for this DIT structure rule, or an empty array if there are no superior rule IDs.

getExtensions

public java.util.Map<java.lang.String,java.lang.String[]> getExtensions()

Retrieves the set of extensions for this DIT structure rule. They will be mapped from the extension name (which should start with "X-") to the set of values for that extension.

Returns:

The set of extensions for this DIT structure rule.

hashCode

public int hashCode()

Retrieves a hash code for this schema element.

Specified by:

hashCode in class SchemaElement

Returns:

A hash code for this schema element.

equals

public boolean equals(java.lang.Object o)

Indicates whether the provided object is equal to this schema element.

Specified by:

equals in class SchemaElement

Parameters:

o - The object for which to make the determination.

Returns:

true if the provided object may be considered equal to this schema element, or false if not.

toString

public java.lang.String toString()

Retrieves a string representation of this DIT structure rule definition, in the format described in RFC 4512 section 4.1.7.1.

Specified by:

toString in class SchemaElement

Returns:

A string representation of this DIT structure rule definition.