org.apache.directory.api.ldap.model.schema

Class DitStructureRule

java.lang.Object

org.apache.directory.api.ldap.model.schema.AbstractSchemaObject

org.apache.directory.api.ldap.model.schema.DitStructureRule

All Implemented Interfaces:

java.io.Serializable, SchemaObject

public class DitStructureRule
extends AbstractSchemaObject

A dITStructureRule definition. A dITStructureRules is a rule governing the structure of the DIT by specifying a permitted superior to subordinate entry relationship. A structure rule relates a nameForm, and therefore a STRUCTURAL objectClass, to superior dITStructureRules. This permits entries of the STRUCTURAL objectClass identified by the nameForm to exist in the DIT as subordinates to entries governed by the indicated superior dITStructureRules. Hence dITStructureRules only apply to structural object classes.

According to ldapbis [MODELS]:

  DIT structure rule descriptions are written according to the ABNF:
  
    DITStructureRuleDescription = LPAREN WSP
        ruleid                    ; rule identifier
        [ SP "NAME" SP qdescrs ]  ; short names (descriptors)
        [ SP "DESC" SP qdstring ] ; description
        [ SP "OBSOLETE" ]         ; not active
        SP "FORM" SP oid          ; NameForm
        [ SP "SUP" ruleids ]      ; superior rules
        extensions WSP RPAREN     ; extensions
 
    ruleids = ruleid / ( LPAREN WSP ruleidlist WSP RPAREN )
 
    ruleidlist = ruleid *( SP ruleid )
 
    ruleid = number
 
  where:
    [ruleid] is the rule identifier of this DIT structure rule;
    NAME [qdescrs] are short names (descriptors) identifying this DIT
        structure rule;
    DESC [qdstring] is a short descriptive string;
    OBSOLETE indicates this DIT structure rule use is not active;
    FORM is specifies the name form associated with this DIT structure
        rule;
    SUP identifies superior rules (by rule id); and
    [extensions] describe extensions.
  
  If no superior rules are identified, the DIT structure rule applies
  to an autonomous administrative point (e.g. the root vertex of the
  subtree controlled by the subschema) [X.501].
 

See Also:

RFC2252 Section 6.33, ldapbis [MODELS], DescriptionUtils#getDescription(DitStructureRule), Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.String	form The associated NameForm
private int	ruleId The rule ID.
static long	serialVersionUID The mandatory serialVersionUID
private java.util.List<java.lang.Integer>	superRules The list of superiors rules

Fields inherited from class org.apache.directory.api.ldap.model.schema.AbstractSchemaObject

description, extensions, isEnabled, isObsolete, isReadOnly, locked, names, objectType, oid, schemaName, specification

Constructor Summary

Constructors

Constructor and Description
DitStructureRule(int ruleId) Creates a new instance of DitStructureRule

Method Summary

Modifier and Type	Method and Description
void	addSuperRule(java.lang.Integer superRule) Adds a new superior RuleId
void	clear() Clear the current SchemaObject : remove all the references to other objects, and all the Maps.
DitStructureRule	copy() Copy the current SchemaObject on place
boolean	equals(java.lang.Object o)
java.lang.String	getForm()
java.lang.String	getOid() The DIT structure rule does not have an OID Gets usually what is the numeric object identifier assigned to this SchemaObject.
int	getRuleId()
java.util.List<java.lang.Integer>	getSuperRules()
void	setForm(java.lang.String form) Sets the associated NameForm's OID
void	setRuleId(int ruleId) Sets the rule identifier of this DIT structure rule;
void	setSuperRules(java.util.List<java.lang.Integer> superRules) Sets the list of superior RuleIds
java.lang.String	toString()

Methods inherited from class org.apache.directory.api.ldap.model.schema.AbstractSchemaObject

addExtension, addExtension, addName, compareOid, copy, getDescription, getExtension, getExtensions, getName, getNames, getObjectType, getSchemaName, getSpecification, hasExtension, hashCode, isDisabled, isEnabled, isObsolete, isReadOnly, lock, setDescription, setEnabled, setExtensions, setNames, setNames, setObsolete, setOid, setReadOnly, setSchemaName, setSpecification, unlock

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

public static final long serialVersionUID

The mandatory serialVersionUID

See Also:

Constant Field Values

ruleId

private int ruleId

The rule ID. A DSR does not have an OID

form

private java.lang.String form

The associated NameForm

superRules

private java.util.List<java.lang.Integer> superRules

The list of superiors rules

Constructor Detail

DitStructureRule

public DitStructureRule(int ruleId)

Creates a new instance of DitStructureRule

Method Detail

getForm

public java.lang.String getForm()

Returns:

The associated NameForm's OID

setForm

public void setForm(java.lang.String form)

Sets the associated NameForm's OID

Parameters:

form - The NameForm's OID

getRuleId

public int getRuleId()

Returns:

The Rule ID

setRuleId

public void setRuleId(int ruleId)

Sets the rule identifier of this DIT structure rule;

Parameters:

ruleId - the rule identifier of this DIT structure rule;

getSuperRules

public java.util.List<java.lang.Integer> getSuperRules()

Returns:

The list of superiors RuleIDs

setSuperRules

public void setSuperRules(java.util.List<java.lang.Integer> superRules)

Sets the list of superior RuleIds

Parameters:

superRules - the list of superior RuleIds

addSuperRule

public void addSuperRule(java.lang.Integer superRule)

Adds a new superior RuleId

Parameters:

superRule - The superior RuleID to add

getOid

public java.lang.String getOid()

The DIT structure rule does not have an OID Gets usually what is the numeric object identifier assigned to this SchemaObject. All schema objects except for MatchingRuleUses have an OID assigned specifically to then. A MatchingRuleUse's OID really is the OID of it's MatchingRule and not specific to the MatchingRuleUse. This effects how MatchingRuleUse objects are maintained by the system.

Specified by:

getOid in interface SchemaObject

Overrides:

getOid in class AbstractSchemaObject

Returns:

an OID for this SchemaObject or its MatchingRule if this SchemaObject is a MatchingRuleUse object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

copy

public DitStructureRule copy()

Copy the current SchemaObject on place

Specified by:

copy in interface SchemaObject

Specified by:

copy in class AbstractSchemaObject

Returns:

The copied SchemaObject

equals

public boolean equals(java.lang.Object o)

Specified by:

equals in interface SchemaObject

Overrides:

equals in class AbstractSchemaObject

clear

public void clear()

Clear the current SchemaObject : remove all the references to other objects, and all the Maps.

Specified by:

clear in interface SchemaObject

Overrides:

clear in class AbstractSchemaObject