Class DITStructureRuleDefinition

    • Constructor Summary

      Constructors 
      Constructor Description
      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

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      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.
      SchemaElementType getSchemaElementType()
      Retrieves the type of schema element that this object represents.
      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 java.lang.Object

        clone, finalize, getClass, notify, notifyAll, wait, wait, wait
    • Constructor Detail

      • DITStructureRuleDefinition

        public DITStructureRuleDefinition​(@NotNull
                                          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,
                                          @Nullable
                                          java.lang.String name,
                                          @Nullable
                                          java.lang.String description,
                                          @NotNull
                                          java.lang.String nameFormID,
                                          @Nullable
                                          java.lang.Integer superiorRuleID,
                                          @Nullable
                                          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,
                                          @Nullable
                                          java.lang.String[] names,
                                          @Nullable
                                          java.lang.String description,
                                          boolean isObsolete,
                                          @NotNull
                                          java.lang.String nameFormID,
                                          @Nullable
                                          int[] superiorRuleIDs,
                                          @Nullable
                                          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

        @NotNull
        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

        @NotNull
        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​(@NotNull
                                       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

        @Nullable
        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

        @NotNull
        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

        @NotNull
        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

        @NotNull
        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​(@Nullable
                              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

        @NotNull
        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.