Package netscape.ldap

Class LDAPSyntaxSchema

  • All Implemented Interfaces:
    java.io.Serializable
    public class LDAPSyntaxSchema
extends LDAPSchemaElement
    The definition of a syntax type in the schema. RFC 2252, Lightweight Directory Access Protocol (v3): LDAP Subschema Attribute covers the types of information to specify when defining a syntax. The description of a syntax can include the following:

    • an OID identifying the syntax
    • a description of the attribute type

    When you construct an LDAPSyntaxSchema object, you can specify these types of information as arguments to the constructor or in the ldapSyntaxes format specified in RFC 2252. When an LDAP client searches an LDAP server for the schema, the server returns schema information as an object with attribute values in this format.

    RFC 2252 defines SyntaxDescription as follows: 

         SyntaxDescription = "(" whsp
        numericoid whsp
        [ "DESC" qdstring ]
        whsp ")"

    Syntax definitions do not have a name, so the getName method inherited from LDAPSchemaElement returns "". To get the OID and description of this syntax type definition, use the getOID and getDescription methods inherited from the abstract class LDAPSchemaElement.

    To add or remove this syntax type definition from the schema, use the add and remove methods, which this class inherits from the LDAPSchemaElement abstract class.

    Version:
    1.0
    See Also:
    LDAPSchemaElement, Serialized Form

    • Field Detail

      • syntaxElement

        protected netscape.ldap.LDAPSyntaxSchemaElement syntaxElement

    • Constructor Detail

      • LDAPSyntaxSchema

        protected LDAPSyntaxSchema()
        Constructs a blank element.

      • LDAPSyntaxSchema

        public LDAPSyntaxSchema​(java.lang.String oid,
                        java.lang.String description)
        Constructs a syntax type definition, using the specified information.
        Parameters:
        oid - object identifier (OID) of the syntax type in dotted-string format (for example, "1.2.3.4")
        description - description of syntax type

      • LDAPSyntaxSchema

        public LDAPSyntaxSchema​(java.lang.String raw)
        Constructs a syntax type definition based on a description in the ldapSyntaxes format. For information on this format, (see RFC 2252, Lightweight Directory Access Protocol (v3): LDAP Subschema Attribute. This is the format that LDAP servers and clients use to exchange schema information. (For example, when you search an LDAP server for its schema, the server returns an entry with the syntaxs "objectclasses" and "ldapSyntaxes". The values of "ldapSyntaxes" are syntax type descriptions in this format.)

        Parameters:
        raw - definition of the syntax type in the ldapSyntaxes format

    • Method Detail

      • getSyntax

        public int getSyntax()
        Gets the syntax of the schema element
        Returns:
        one of the following values:
        • cis (case-insensitive string)
        • ces (case-exact string)
        • binary (binary data)
        • int (integer)
        • telephone (telephone number -- identical to cis, but blanks and dashes are ignored during comparisons)
        • dn (distinguished name)
        • unknown (not a known syntax)

      • getSyntaxString

        public java.lang.String getSyntaxString()
        Gets the syntax of the syntax type in dotted-decimal format, for example "1.2.3.4.5"
        Returns:
        The syntax syntax in dotted-decimal format.

      • getValue

        public java.lang.String getValue()
        Prepares a value in RFC 2252 format for submission to a server
        Overrides:
        getValue in class LDAPSchemaElement
        Returns:
        a String ready for submission to an LDAP server.

      • toString

        public java.lang.String toString()
        Gets the definition of the syntax type in a user friendly format. This is the format that the syntax type definition uses when printing the syntax type or the schema.
        Overrides:
        toString in class java.lang.Object
        Returns:
        definition of the syntax type in a user friendly format.