org.forgerock.opendj.ldap.schema

Class SchemaBuilder

java.lang.Object

org.forgerock.opendj.ldap.schema.SchemaBuilder

public final class SchemaBuilder
extends Object

Schema builders should be used for incremental construction of new schemas.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	SchemaBuilder.SchemaBuilderHook Allows to perform modifications on element's builders before adding the result to this schema builder.

Constructor Summary

Constructors

Constructor and Description
SchemaBuilder() Creates a new schema builder with no schema elements and default compatibility options.
SchemaBuilder(Entry entry) Creates a new schema builder containing all of the schema elements contained in the provided subschema subentry.
SchemaBuilder(Schema schema) Creates a new schema builder containing all of the schema elements from the provided schema and its compatibility options.
SchemaBuilder(String schemaName) Creates a new schema builder with no schema elements and default compatibility options.

Method Summary

Modifier and Type	Method and Description
SchemaBuilder	addAttributeType(String definition, boolean overwrite) Adds the provided attribute type definition to this schema builder.
SchemaBuilder	addDitContentRule(String definition, boolean overwrite) Adds the provided DIT content rule definition to this schema builder.
SchemaBuilder	addDitStructureRule(String definition, boolean overwrite) Adds the provided DIT structure rule definition to this schema builder.
SchemaBuilder	addEnumerationSyntax(String oid, String description, boolean overwrite, String... enumerations) Adds the provided enumeration syntax definition to this schema builder.
SchemaBuilder	addMatchingRule(String definition, boolean overwrite) Adds the provided matching rule definition to this schema builder.
SchemaBuilder	addMatchingRuleUse(String definition, boolean overwrite) Adds the provided matching rule use definition to this schema builder.
SchemaBuilder	addNameForm(String definition, boolean overwrite) Adds the provided name form definition to this schema builder.
SchemaBuilder	addObjectClass(String definition, boolean overwrite) Adds the provided object class definition to this schema builder.
SchemaBuilder	addPatternSyntax(String oid, String description, Pattern pattern, boolean overwrite) Adds the provided pattern syntax definition to this schema builder.
SchemaBuilder	addSchema(Connection connection, Dn name, boolean overwrite) Reads the schema elements contained in the named subschema sub-entry and adds them to this schema builder.
SchemaBuilder	addSchema(Entry entry, boolean overwrite) Adds all of the schema elements contained in the provided subschema subentry to this schema builder.
SchemaBuilder	addSchema(Entry entry, boolean overwrite, SchemaBuilder.SchemaBuilderHook hook) Adds all of the schema elements contained in the provided subschema subentry to this schema builder.
Single<SchemaBuilder>	addSchema(LdapClientSocket socket, Dn name, boolean overwrite) Reads the schema elements contained in the named subschema sub-entry and adds them to this schema builder.
SchemaBuilder	addSchema(Schema schema, boolean overwrite) Adds all of the schema elements in the provided schema to this schema builder.
LdapPromise<SchemaBuilder>	addSchemaAsync(Connection connection, Dn name, boolean overwrite) Asynchronously reads the schema elements contained in the named subschema sub-entry and adds them to this schema builder.
SchemaBuilder	addSchemaForEntry(Connection connection, Dn name, boolean overwrite) Reads the schema elements contained in the subschema sub-entry which applies to the named entry and adds them to this schema builder.
Single<SchemaBuilder>	addSchemaForEntry(LdapClientSocket socket, Dn name, boolean overwrite) Reads the schema elements contained in the subschema sub-entry which applies to the named entry and adds them to this schema builder.
LdapPromise<SchemaBuilder>	addSchemaForEntryAsync(Connection connection, Dn name, boolean overwrite) Asynchronously reads the schema elements contained in the subschema sub-entry which applies to the named entry and adds them to this schema builder.
SchemaBuilder	addSubstitutionSyntax(String oid, String description, String substituteSyntax, boolean overwrite) Adds the provided substitution syntax definition to this schema builder.
SchemaBuilder	addSyntax(String definition, boolean overwrite) Adds the provided syntax definition to this schema builder.
AttributeType.Builder	buildAttributeType(AttributeType attributeType) Returns an attribute type builder whose fields are initialized to the values of the provided attribute type.
AttributeType.Builder	buildAttributeType(String oid) Returns a builder which can be used for incrementally constructing a new attribute type before adding it to the schema.
DitContentRule.Builder	buildDitContentRule(DitContentRule contentRule) Returns a DIT content rule builder whose fields are initialized to the values of the provided DIT content rule.
DitContentRule.Builder	buildDitContentRule(String structuralClassOid) Returns a builder which can be used for incrementally constructing a new DIT content rule before adding it to the schema.
DitStructureRule.Builder	buildDitStructureRule(DitStructureRule structureRule) Returns an DIT structure rule builder whose fields are initialized to the values of the provided rule.
DitStructureRule.Builder	buildDitStructureRule(int ruleId) Returns a builder which can be used for incrementally constructing a new DIT structure rule before adding it to the schema.
MatchingRule.Builder	buildMatchingRule(MatchingRule matchingRule) Returns a matching rule builder whose fields are initialized to the values of the provided matching rule.
MatchingRule.Builder	buildMatchingRule(String oid) Returns a builder which can be used for incrementally constructing a new matching rule before adding it to the schema.
MatchingRuleUse.Builder	buildMatchingRuleUse(MatchingRuleUse matchingRuleUse) Returns a matching rule use builder whose fields are initialized to the values of the provided matching rule use object.
MatchingRuleUse.Builder	buildMatchingRuleUse(String oid) Returns a builder which can be used for incrementally constructing a new matching rule use before adding it to the schema.
NameForm.Builder	buildNameForm(NameForm nameForm) Returns a name form builder whose fields are initialized to the values of the provided name form.
NameForm.Builder	buildNameForm(String oid) Returns a builder which can be used for incrementally constructing a new name form before adding it to the schema.
ObjectClass.Builder	buildObjectClass(ObjectClass objectClass) Returns an object class builder whose fields are initialized to the values of the provided object class.
ObjectClass.Builder	buildObjectClass(String oid) Returns a builder which can be used for incrementally constructing a new object class before adding it to the schema.
Syntax.Builder	buildSyntax(String oid) Returns a builder which can be used for incrementally constructing a new syntax before adding it to the schema.
Syntax.Builder	buildSyntax(Syntax syntax) Returns a syntax builder whose fields are initialized to the values of the provided syntax.
boolean	removeAttributeType(String nameOrOid) Removes the named attribute type from this schema builder.
boolean	removeDitContentRule(String nameOrOid) Removes the named DIT content rule from this schema builder.
boolean	removeDitStructureRule(int ruleId) Removes the specified DIT structure rule from this schema builder.
boolean	removeMatchingRule(String nameOrOid) Removes the named matching rule from this schema builder.
boolean	removeMatchingRuleUse(String nameOrOid) Removes the named matching rule use from this schema builder.
boolean	removeNameForm(String nameOrOid) Removes the named name form from this schema builder.
boolean	removeObjectClass(String nameOrOid) Removes the named object class from this schema builder.
boolean	removeSyntax(String numericOid) Removes the named syntax from this schema builder.
<T> SchemaBuilder	setOption(Option<T> option, T value) Sets a schema option overriding any previous values for the option.
Schema	toSchema() Returns a strict Schema containing all of the schema elements contained in this schema builder as well as the same set of schema compatibility options.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SchemaBuilder

public SchemaBuilder()

Creates a new schema builder with no schema elements and default compatibility options.

SchemaBuilder

public SchemaBuilder(Entry entry)

Creates a new schema builder containing all of the schema elements contained in the provided subschema subentry. Any problems encountered while parsing the entry can be retrieved using the returned schema's Schema.getWarnings() method.

Parameters:

entry - The subschema subentry to be parsed.

Throws:

NullPointerException - If entry was null.

SchemaBuilder

public SchemaBuilder(Schema schema)

Creates a new schema builder containing all of the schema elements from the provided schema and its compatibility options.

Parameters:

schema - The initial contents of the schema builder.

Throws:

NullPointerException - If schema was null.

SchemaBuilder

public SchemaBuilder(String schemaName)

Creates a new schema builder with no schema elements and default compatibility options.

Parameters:

schemaName - The user-friendly name of this schema which may be used for debugging purposes.

Method Detail

addAttributeType

public SchemaBuilder addAttributeType(String definition,
                                      boolean overwrite)

Adds the provided attribute type definition to this schema builder.

Parameters:

definition - The attribute type definition.

overwrite - true if any existing attribute type with the same OID should be overwritten.

Returns:

A reference to this schema builder.

Throws:

ConflictingSchemaElementException - If overwrite was false and a conflicting schema element was found.

LocalizedIllegalArgumentException - If the provided attribute type definition could not be parsed.

NullPointerException - If definition was null.

addDitContentRule

public SchemaBuilder addDitContentRule(String definition,
                                       boolean overwrite)

Adds the provided DIT content rule definition to this schema builder.

Parameters:

definition - The DIT content rule definition.

overwrite - true if any existing DIT content rule with the same OID should be overwritten.

Returns:

A reference to this schema builder.

Throws:

ConflictingSchemaElementException - If overwrite was false and a conflicting schema element was found.

LocalizedIllegalArgumentException - If the provided DIT content rule definition could not be parsed.

NullPointerException - If definition was null.

addDitStructureRule

public SchemaBuilder addDitStructureRule(String definition,
                                         boolean overwrite)

Adds the provided DIT structure rule definition to this schema builder.

Parameters:

definition - The DIT structure rule definition.

overwrite - true if any existing DIT structure rule with the same OID should be overwritten.

Returns:

A reference to this schema builder.

Throws:

ConflictingSchemaElementException - If overwrite was false and a conflicting schema element was found.

LocalizedIllegalArgumentException - If the provided DIT structure rule definition could not be parsed.

NullPointerException - If definition was null.

addEnumerationSyntax

public SchemaBuilder addEnumerationSyntax(String oid,
                                          String description,
                                          boolean overwrite,
                                          String... enumerations)

Adds the provided enumeration syntax definition to this schema builder.

Parameters:

oid - The OID of the enumeration syntax definition.

description - The description of the enumeration syntax definition.

overwrite - true if any existing syntax with the same OID should be overwritten.

enumerations - The range of values which attribute values must match in order to be valid.

Returns:

A reference to this schema builder.

Throws:

ConflictingSchemaElementException - If overwrite was false and a conflicting schema element was found.

addMatchingRule

public SchemaBuilder addMatchingRule(String definition,
                                     boolean overwrite)

Adds the provided matching rule definition to this schema builder.

Parameters:

definition - The matching rule definition.

overwrite - true if any existing matching rule with the same OID should be overwritten.

Returns:

A reference to this schema builder.

Throws:

ConflictingSchemaElementException - If overwrite was false and a conflicting schema element was found.

LocalizedIllegalArgumentException - If the provided matching rule definition could not be parsed.

NullPointerException - If definition was null.

addMatchingRuleUse

public SchemaBuilder addMatchingRuleUse(String definition,
                                        boolean overwrite)

Adds the provided matching rule use definition to this schema builder.

Parameters:

definition - The matching rule use definition.

overwrite - true if any existing matching rule use with the same OID should be overwritten.

Returns:

A reference to this schema builder.

Throws:

ConflictingSchemaElementException - If overwrite was false and a conflicting schema element was found.

LocalizedIllegalArgumentException - If the provided matching rule use definition could not be parsed.

NullPointerException - If definition was null.

buildAttributeType

public AttributeType.Builder buildAttributeType(String oid)

Returns a builder which can be used for incrementally constructing a new attribute type before adding it to the schema. Example usage:

 SchemaBuilder builder = ...;
 builder.buildAttributeType("attributetype-oid").name("attribute type name").addToSchema();
 

Parameters:

oid - The OID of the attribute type definition.

Returns:

A builder to continue building the AttributeType.

buildDitStructureRule

public DitStructureRule.Builder buildDitStructureRule(int ruleId)

Returns a builder which can be used for incrementally constructing a new DIT structure rule before adding it to the schema. Example usage:

 SchemaBuilder builder = ...;
 final int myRuleID = ...;
 builder.buildDITStructureRule(myRuleID).name("DIT structure rule name").addToSchema();
 

Parameters:

ruleId - The ID of the DIT structure rule.

Returns:

A builder to continue building the DITStructureRule.

buildMatchingRule

public MatchingRule.Builder buildMatchingRule(String oid)

Returns a builder which can be used for incrementally constructing a new matching rule before adding it to the schema. Example usage:

 SchemaBuilder builder = ...;
 builder.buildMatchingRule("matchingrule-oid").name("matching rule name").addToSchema();
 

Parameters:

oid - The OID of the matching rule definition.

Returns:

A builder to continue building the MatchingRule.

buildMatchingRuleUse

public MatchingRuleUse.Builder buildMatchingRuleUse(String oid)

Returns a builder which can be used for incrementally constructing a new matching rule use before adding it to the schema. Example usage:

 SchemaBuilder builder = ...;
 builder.buildMatchingRuleUse("matchingrule-oid")
        .name("matching rule use name")
        .addToSchema();
 

Parameters:

oid - The OID of the matching rule definition.

Returns:

A builder to continue building the MatchingRuleUse.

addNameForm

public SchemaBuilder addNameForm(String definition,
                                 boolean overwrite)

Adds the provided name form definition to this schema builder.

Parameters:

definition - The name form definition.

overwrite - true if any existing name form with the same OID should be overwritten.

Returns:

A reference to this schema builder.

Throws:

ConflictingSchemaElementException - If overwrite was false and a conflicting schema element was found.

LocalizedIllegalArgumentException - If the provided name form definition could not be parsed.

NullPointerException - If definition was null.

buildDitContentRule

public DitContentRule.Builder buildDitContentRule(String structuralClassOid)

Returns a builder which can be used for incrementally constructing a new DIT content rule before adding it to the schema. Example usage:

 SchemaBuilder builder = ...;
 builder.buildDITContentRule("structuralobjectclass-oid").name("DIT content rule name").addToSchema();
 

Parameters:

structuralClassOid - The OID of the structural objectclass for the DIT content rule to build.

Returns:

A builder to continue building the DITContentRule.

buildNameForm

public NameForm.Builder buildNameForm(String oid)

Returns a builder which can be used for incrementally constructing a new name form before adding it to the schema. Example usage:

 SchemaBuilder builder = ...;
 builder.buildNameForm("1.2.3.4").name("myNameform").addToSchema();
 

Parameters:

oid - The OID of the name form definition.

Returns:

A builder to continue building the NameForm.

buildObjectClass

public ObjectClass.Builder buildObjectClass(String oid)

Returns a builder which can be used for incrementally constructing a new object class before adding it to the schema. Example usage:

 SchemaBuilder builder = ...;
 builder.buildObjectClass("objectclass-oid").name("object class name").addToSchema();
 

Parameters:

oid - The OID of the object class definition.

Returns:

A builder to continue building the ObjectClass.

buildSyntax

public Syntax.Builder buildSyntax(String oid)

Returns a builder which can be used for incrementally constructing a new syntax before adding it to the schema. Example usage:

 SchemaBuilder builder = ...;
 builder.buildSyntax("1.2.3.4").addToSchema();
 

Parameters:

oid - The OID of the syntax definition.

Returns:

A builder to continue building the syntax.

buildAttributeType

public AttributeType.Builder buildAttributeType(AttributeType attributeType)

Returns an attribute type builder whose fields are initialized to the values of the provided attribute type. This method should be used when duplicating attribute types from external schemas or when modifying existing attribute types.

Parameters:

attributeType - The attribute type source.

Returns:

A builder to continue building the AttributeType.

buildDitContentRule

public DitContentRule.Builder buildDitContentRule(DitContentRule contentRule)

Returns a DIT content rule builder whose fields are initialized to the values of the provided DIT content rule. This method should be used when duplicating DIT content rules from external schemas or when modifying existing DIT content rules.

Parameters:

contentRule - The DIT content rule source.

Returns:

A builder to continue building the DITContentRule.

buildDitStructureRule

public DitStructureRule.Builder buildDitStructureRule(DitStructureRule structureRule)

Returns an DIT structure rule builder whose fields are initialized to the values of the provided rule. This method should be used when duplicating structure rules from external schemas or when modifying existing structure rules.

Parameters:

structureRule - The DIT structure rule source.

Returns:

A builder to continue building the DITStructureRule.

buildMatchingRule

public MatchingRule.Builder buildMatchingRule(MatchingRule matchingRule)

Returns a matching rule builder whose fields are initialized to the values of the provided matching rule. This method should be used when duplicating matching rules from external schemas or when modifying existing matching rules.

Parameters:

matchingRule - The matching rule source.

Returns:

A builder to continue building the MatchingRule.

buildMatchingRuleUse

public MatchingRuleUse.Builder buildMatchingRuleUse(MatchingRuleUse matchingRuleUse)

Returns a matching rule use builder whose fields are initialized to the values of the provided matching rule use object. This method should be used when duplicating matching rule uses from external schemas or when modifying existing matching rule uses.

Parameters:

matchingRuleUse - The matching rule use source.

Returns:

A builder to continue building the MatchingRuleUse.

buildNameForm

public NameForm.Builder buildNameForm(NameForm nameForm)

Returns a name form builder whose fields are initialized to the values of the provided name form. This method should be used when duplicating name forms from external schemas or when modifying existing names forms.

Parameters:

nameForm - The name form source.

Returns:

A builder to continue building the NameForm.

buildObjectClass

public ObjectClass.Builder buildObjectClass(ObjectClass objectClass)

Returns an object class builder whose fields are initialized to the values of the provided object class. This method should be used when duplicating object classes from external schemas or when modifying existing object classes.

Parameters:

objectClass - The object class source.

Returns:

A builder to continue building the ObjectClass.

buildSyntax

public Syntax.Builder buildSyntax(Syntax syntax)

Returns a syntax builder whose fields are initialized to the values of the provided syntax. This method should be used when duplicating syntaxes from external schemas or when modifying existing syntaxes.

Parameters:

syntax - The syntax source.

Returns:

A builder to continue building the Syntax.

addObjectClass

public SchemaBuilder addObjectClass(String definition,
                                    boolean overwrite)

Adds the provided object class definition to this schema builder.

Parameters:

definition - The object class definition.

overwrite - true if any existing object class with the same OID should be overwritten.

Returns:

A reference to this schema builder.

Throws:

ConflictingSchemaElementException - If overwrite was false and a conflicting schema element was found.

LocalizedIllegalArgumentException - If the provided object class definition could not be parsed.

NullPointerException - If definition was null.

addPatternSyntax

public SchemaBuilder addPatternSyntax(String oid,
                                      String description,
                                      Pattern pattern,
                                      boolean overwrite)

Adds the provided pattern syntax definition to this schema builder.

Parameters:

oid - The OID of the pattern syntax definition.

description - The description of the pattern syntax definition.

pattern - The regular expression pattern which attribute values must match in order to be valid.

overwrite - true if any existing syntax with the same OID should be overwritten.

Returns:

A reference to this schema builder.

Throws:

ConflictingSchemaElementException - If overwrite was false and a conflicting schema element was found.

addSchema

public SchemaBuilder addSchema(Connection connection,
                               Dn name,
                               boolean overwrite)
                        throws LdapException

Reads the schema elements contained in the named subschema sub-entry and adds them to this schema builder.

If the requested schema is not returned by the Directory Server then the request will fail with an EntryNotFoundException.

Parameters:

connection - A connection to the Directory Server whose schema is to be read.

name - The distinguished name of the subschema sub-entry.

overwrite - true if existing schema elements with the same conflicting OIDs should be overwritten.

Returns:

A reference to this schema builder.

Throws:

LdapException - If the result code indicates that the request failed for some reason.

UnsupportedOperationException - If the connection does not support search operations.

IllegalStateException - If the connection has already been closed, i.e. if isClosed() == true.

NullPointerException - If the connection or name was null.

addSchema

public SchemaBuilder addSchema(Entry entry,
                               boolean overwrite)

Adds all of the schema elements contained in the provided subschema subentry to this schema builder. Any problems encountered while parsing the entry can be retrieved using the returned schema's Schema.getWarnings() method.

Parameters:

entry - The subschema subentry to be parsed.

overwrite - true if existing schema elements with the same conflicting OIDs should be overwritten.

Returns:

A reference to this schema builder.

Throws:

NullPointerException - If entry was null.

addSchema

public SchemaBuilder addSchema(Entry entry,
                               boolean overwrite,
                               SchemaBuilder.SchemaBuilderHook hook)

Adds all of the schema elements contained in the provided subschema subentry to this schema builder. Any problems encountered while parsing the entry can be retrieved using the returned schema's Schema.getWarnings() method.

Parameters:

entry - The subschema subentry to be parsed.

overwrite - true if existing schema elements with the same conflicting OIDs should be overwritten.

hook - Allows to perform modifications on element's builders before adding the result to this schema builder.

Returns:

A reference to this schema builder.

Throws:

NullPointerException - If entry was null.

addSchema

public SchemaBuilder addSchema(Schema schema,
                               boolean overwrite)

Adds all of the schema elements in the provided schema to this schema builder.

Parameters:

schema - The schema to be copied into this schema builder.

overwrite - true if existing schema elements with the same conflicting OIDs should be overwritten.

Returns:

A reference to this schema builder.

Throws:

ConflictingSchemaElementException - If overwrite was false and conflicting schema elements were found.

NullPointerException - If schema was null.

addSchemaAsync

public LdapPromise<SchemaBuilder> addSchemaAsync(Connection connection,
                                                 Dn name,
                                                 boolean overwrite)

Asynchronously reads the schema elements contained in the named subschema sub-entry and adds them to this schema builder.

If the requested schema is not returned by the Directory Server then the request will fail with an EntryNotFoundException.

Parameters:

connection - A connection to the Directory Server whose schema is to be read.

name - The distinguished name of the subschema sub-entry. the operation result when it is received, may be null.

overwrite - true if existing schema elements with the same conflicting OIDs should be overwritten.

Returns:

A promise representing the updated schema builder.

Throws:

UnsupportedOperationException - If the connection does not support search operations.

IllegalStateException - If the connection has already been closed, i.e. if connection.isClosed() == true.

NullPointerException - If the connection or name was null.

addSchema

public Single<SchemaBuilder> addSchema(LdapClientSocket socket,
                                       Dn name,
                                       boolean overwrite)

Reads the schema elements contained in the named subschema sub-entry and adds them to this schema builder.

If the requested schema is not returned by the Directory Server then the request will fail with an EntryNotFoundException.

Note that the schema elements will only be read when the returned Single has been subscribed.

Parameters:

socket - A socket to the Directory Server whose schema is to be read.

name - The distinguished name of the entry whose schema is to be located.

overwrite - true if existing schema elements with the same conflicting OIDs should be overwritten.

Returns:

A Single wrapping the updated schema builder.

Throws:

UnsupportedOperationException - If the connection does not support search operations.

IllegalStateException - If the socket has already been closed, i.e. if socket.isClosed() == true.

NullPointerException - If the socket or name was null.

addSchemaForEntry

public SchemaBuilder addSchemaForEntry(Connection connection,
                                       Dn name,
                                       boolean overwrite)
                                throws LdapException

Reads the schema elements contained in the subschema sub-entry which applies to the named entry and adds them to this schema builder.

If the requested entry or its associated schema are not returned by the Directory Server then the request will fail with an EntryNotFoundException.

This implementation first reads the subschemaSubentry attribute of the entry in order to identify the schema and then invokes addSchemaForEntry(Connection, Dn, boolean) to read the schema.

Parameters:

connection - A connection to the Directory Server whose schema is to be read.

name - The distinguished name of the entry whose schema is to be located.

overwrite - true if existing schema elements with the same conflicting OIDs should be overwritten.

Returns:

A reference to this schema builder.

Throws:

LdapException - If the result code indicates that the request failed for some reason.

UnsupportedOperationException - If the connection does not support search operations.

IllegalStateException - If the connection has already been closed, i.e. if connection.isClosed() == true.

NullPointerException - If the connection or name was null.

addSchemaForEntryAsync

public LdapPromise<SchemaBuilder> addSchemaForEntryAsync(Connection connection,
                                                         Dn name,
                                                         boolean overwrite)

Asynchronously reads the schema elements contained in the subschema sub-entry which applies to the named entry and adds them to this schema builder.

If the requested entry or its associated schema are not returned by the Directory Server then the request will fail with an EntryNotFoundException.

This implementation first reads the subschemaSubentry attribute of the entry in order to identify the schema and then invokes addSchemaAsync(Connection, Dn, boolean) to read the schema.

Parameters:

connection - A connection to the Directory Server whose schema is to be read.

name - The distinguished name of the entry whose schema is to be located.

overwrite - true if existing schema elements with the same conflicting OIDs should be overwritten.

Returns:

A promise representing the updated schema builder.

Throws:

UnsupportedOperationException - If the connection does not support search operations.

IllegalStateException - If the connection has already been closed, i.e. if connection.isClosed() == true.

NullPointerException - If the connection or name was null.

addSchemaForEntry

public Single<SchemaBuilder> addSchemaForEntry(LdapClientSocket socket,
                                               Dn name,
                                               boolean overwrite)

Reads the schema elements contained in the subschema sub-entry which applies to the named entry and adds them to this schema builder.

If the requested entry or its associated schema are not returned by the Directory Server then the request will fail with an EntryNotFoundException.

This implementation first reads the subschemaSubentry attribute of the entry in order to identify the schema and then invokes addSchema(LdapClientSocket, Dn, boolean) to read the schema.

Note that the request will only be sent when the returned Single has been subscribed.

Parameters:

socket - A socket to the Directory Server whose schema is to be read.

name - The distinguished name of the entry whose schema is to be located.

overwrite - true if existing schema elements with the same conflicting OIDs should be overwritten.

Returns:

A Single representing the updated schema builder.

Throws:

UnsupportedOperationException - If the connection does not support search operations.

IllegalStateException - If the socket has already been closed, i.e. if socket.isClosed() == true.

NullPointerException - If the socket or name was null.

addSubstitutionSyntax

public SchemaBuilder addSubstitutionSyntax(String oid,
                                           String description,
                                           String substituteSyntax,
                                           boolean overwrite)

Adds the provided substitution syntax definition to this schema builder.

Parameters:

oid - The OID of the substitution syntax definition.

description - The description of the substitution syntax definition.

substituteSyntax - The OID of the syntax whose implementation should be substituted.

overwrite - true if any existing syntax with the same OID should be overwritten.

Returns:

A reference to this schema builder.

Throws:

ConflictingSchemaElementException - If overwrite was false and a conflicting schema element was found.

addSyntax

public SchemaBuilder addSyntax(String definition,
                               boolean overwrite)

Adds the provided syntax definition to this schema builder.

Parameters:

definition - The syntax definition.

overwrite - true if any existing syntax with the same OID should be overwritten.

Returns:

A reference to this schema builder.

Throws:

ConflictingSchemaElementException - If overwrite was false and a conflicting schema element was found.

LocalizedIllegalArgumentException - If the provided syntax definition could not be parsed.

NullPointerException - If definition was null.

removeAttributeType

public boolean removeAttributeType(String nameOrOid)

Removes the named attribute type from this schema builder.

Parameters:

nameOrOid - The name or OID of the attribute type to be removed.

Returns:

true if the attribute type was found.

removeDitContentRule

public boolean removeDitContentRule(String nameOrOid)

Removes the named DIT content rule from this schema builder.

Parameters:

nameOrOid - The name or OID of the DIT content rule to be removed.

Returns:

true if the DIT content rule was found.

removeDitStructureRule

public boolean removeDitStructureRule(int ruleId)

Removes the specified DIT structure rule from this schema builder.

Parameters:

ruleId - The ID of the DIT structure rule to be removed.

Returns:

true if the DIT structure rule was found.

removeMatchingRule

public boolean removeMatchingRule(String nameOrOid)

Removes the named matching rule from this schema builder.

Parameters:

nameOrOid - The name or OID of the matching rule to be removed.

Returns:

true if the matching rule was found.

removeMatchingRuleUse

public boolean removeMatchingRuleUse(String nameOrOid)

Removes the named matching rule use from this schema builder.

Parameters:

nameOrOid - The name or OID of the matching rule use to be removed.

Returns:

true if the matching rule use was found.

removeNameForm

public boolean removeNameForm(String nameOrOid)

Removes the named name form from this schema builder.

Parameters:

nameOrOid - The name or OID of the name form to be removed.

Returns:

true if the name form was found.

removeObjectClass

public boolean removeObjectClass(String nameOrOid)

Removes the named object class from this schema builder.

Parameters:

nameOrOid - The name or OID of the object class to be removed.

Returns:

true if the object class was found.

removeSyntax

public boolean removeSyntax(String numericOid)

Removes the named syntax from this schema builder.

Parameters:

numericOid - The name of the syntax to be removed.

Returns:

true if the syntax was found.

setOption

public <T> SchemaBuilder setOption(Option<T> option,
                                   T value)

Sets a schema option overriding any previous values for the option.

Type Parameters:

T - The option type.

Parameters:

option - Option with which the specified value is to be associated.

value - Value to be associated with the specified option.

Returns:

A reference to this schema builder.

Throws:

UnsupportedOperationException - If the schema builder options are read only.

toSchema

public Schema toSchema()

Returns a strict Schema containing all of the schema elements contained in this schema builder as well as the same set of schema compatibility options.

This method does not alter the contents of this schema builder.

Returns:

A Schema containing all of the schema elements contained in this schema builder as well as the same set of schema compatibility options