Class ImmutableMatchingRuleUseRegistry
- java.lang.Object
-
- org.apache.directory.api.ldap.model.schema.registries.ImmutableMatchingRuleUseRegistry
-
- All Implemented Interfaces:
Iterable<MatchingRuleUse>
,MatchingRuleUseRegistry
,SchemaObjectRegistry<MatchingRuleUse>
public class ImmutableMatchingRuleUseRegistry extends Object implements MatchingRuleUseRegistry
An immutable wrapper of the MatchingRuleUse registry.- Author:
- Apache Directory Project
-
-
Constructor Summary
Constructors Constructor Description ImmutableMatchingRuleUseRegistry(MatchingRuleUseRegistry matchingRuleUseRegistry)
Creates a new instance of ImmutableMatchingRuleUseRegistry.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
clear()
Clear the registry from all its contentboolean
contains(String oid)
Checks to see if an SchemaObject exists in the registry, by its OID or name.ImmutableMatchingRuleUseRegistry
copy()
Copy the MatchingRuleUseRegistryMatchingRuleUse
get(String oid)
Gets the SchemaObject associated with a given OID.String
getOidByName(String name)
Gets the numericOid for a name/alias if one is associated.String
getSchemaName(String oid)
Gets the name of the schema this schema object is associated with.SchemaObjectType
getType()
Iterator<MatchingRuleUse>
iterator()
Gets an iterator over the registered schema objects in the registry.MatchingRuleUse
lookup(String oid)
Looks up a SchemaObject by its unique Object Identifier or by name.Iterator<String>
oidsIterator()
Gets an iterator over the registered schema objects'OID in the registry.void
register(MatchingRuleUse schemaObject)
Registers a new SchemaObject with this registry.void
renameSchema(String originalSchemaName, String newSchemaName)
Modify all the SchemaObject using a schemaName when this name changes.int
size()
MatchingRuleUse
unregister(String numericOid)
Removes the SchemaObject registered with this registry, using its numeric OID.MatchingRuleUse
unregister(MatchingRuleUse schemaObject)
Removes the SchemaObject registered with this registry.void
unregisterSchemaElements(String schemaName)
Unregisters all SchemaObjects defined for a specific schema from this registry.-
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface java.lang.Iterable
forEach, spliterator
-
-
-
-
Constructor Detail
-
ImmutableMatchingRuleUseRegistry
public ImmutableMatchingRuleUseRegistry(MatchingRuleUseRegistry matchingRuleUseRegistry)
Creates a new instance of ImmutableMatchingRuleUseRegistry.- Parameters:
matchingRuleUseRegistry
- The wrapped MatchingRuleUse registry
-
-
Method Detail
-
copy
public ImmutableMatchingRuleUseRegistry copy()
Copy the MatchingRuleUseRegistry- Specified by:
copy
in interfaceMatchingRuleUseRegistry
- Specified by:
copy
in interfaceSchemaObjectRegistry<MatchingRuleUse>
- Returns:
- The copied registry
-
size
public int size()
- Specified by:
size
in interfaceSchemaObjectRegistry<MatchingRuleUse>
- Returns:
- The number of AttributeType stored
-
contains
public boolean contains(String oid)
Checks to see if an SchemaObject exists in the registry, by its OID or name.- Specified by:
contains
in interfaceSchemaObjectRegistry<MatchingRuleUse>
- Parameters:
oid
- the object identifier or name of the SchemaObject- Returns:
- true if a SchemaObject definition exists for the oid, false otherwise
-
getOidByName
public String getOidByName(String name) throws LdapException
Gets the numericOid for a name/alias if one is associated. To prevent lookup failures due to case variance in the name, a failure to lookup the OID, will trigger a lookup using a lower cased version of the name and the name that failed to match will automatically be associated with the OID.- Specified by:
getOidByName
in interfaceSchemaObjectRegistry<MatchingRuleUse>
- Parameters:
name
- The name we are looking the oid for- Returns:
- The numericOID associated with this name
- Throws:
LdapException
- If the OID can't be found
-
getSchemaName
public String getSchemaName(String oid) throws LdapException
Gets the name of the schema this schema object is associated with.- Specified by:
getSchemaName
in interfaceSchemaObjectRegistry<MatchingRuleUse>
- Parameters:
oid
- the object identifier or the name- Returns:
- the schema name
- Throws:
LdapException
- if the schema object does not exist
-
getType
public SchemaObjectType getType()
- Specified by:
getType
in interfaceSchemaObjectRegistry<MatchingRuleUse>
- Returns:
- the type
-
iterator
public Iterator<MatchingRuleUse> iterator()
Gets an iterator over the registered schema objects in the registry.- Specified by:
iterator
in interfaceIterable<MatchingRuleUse>
- Specified by:
iterator
in interfaceSchemaObjectRegistry<MatchingRuleUse>
- Returns:
- an Iterator of homogeneous schema objects
-
lookup
public MatchingRuleUse lookup(String oid) throws LdapException
Looks up a SchemaObject by its unique Object Identifier or by name.- Specified by:
lookup
in interfaceSchemaObjectRegistry<MatchingRuleUse>
- Parameters:
oid
- the object identifier or name- Returns:
- the SchemaObject instance for the id
- Throws:
LdapException
- if the SchemaObject does not exist
-
oidsIterator
public Iterator<String> oidsIterator()
Gets an iterator over the registered schema objects'OID in the registry.- Specified by:
oidsIterator
in interfaceSchemaObjectRegistry<MatchingRuleUse>
- Returns:
- an Iterator of OIDs
-
register
public void register(MatchingRuleUse schemaObject) throws LdapException
Registers a new SchemaObject with this registry.- Specified by:
register
in interfaceSchemaObjectRegistry<MatchingRuleUse>
- Parameters:
schemaObject
- the SchemaObject to register- Throws:
LdapException
- if the SchemaObject is already registered or the registration operation is not supported
-
renameSchema
public void renameSchema(String originalSchemaName, String newSchemaName) throws LdapException
Modify all the SchemaObject using a schemaName when this name changes.- Specified by:
renameSchema
in interfaceSchemaObjectRegistry<MatchingRuleUse>
- Parameters:
originalSchemaName
- The original Schema namenewSchemaName
- The new Schema name- Throws:
LdapException
- if the schema object does not exist
-
unregister
public MatchingRuleUse unregister(String numericOid) throws LdapException
Removes the SchemaObject registered with this registry, using its numeric OID.- Specified by:
unregister
in interfaceSchemaObjectRegistry<MatchingRuleUse>
- Parameters:
numericOid
- the numeric identifier- Returns:
- The unregistred schema object
- Throws:
LdapException
- if the numeric identifier is invalid
-
unregisterSchemaElements
public void unregisterSchemaElements(String schemaName) throws LdapException
Unregisters all SchemaObjects defined for a specific schema from this registry.- Specified by:
unregisterSchemaElements
in interfaceSchemaObjectRegistry<MatchingRuleUse>
- Parameters:
schemaName
- the name of the schema whose SchemaObjects will be removed from- Throws:
LdapException
- If we had a problem while unregistering the schema
-
get
public MatchingRuleUse get(String oid)
Gets the SchemaObject associated with a given OID.- Specified by:
get
in interfaceSchemaObjectRegistry<MatchingRuleUse>
- Parameters:
oid
- The SchemaObject's OID we are looking for- Returns:
- The SchemaObject, if any. Null otherwise
-
clear
public void clear() throws LdapException
Clear the registry from all its content- Specified by:
clear
in interfaceSchemaObjectRegistry<MatchingRuleUse>
- Throws:
LdapException
- If we had a failure while clearing the registry
-
unregister
public MatchingRuleUse unregister(MatchingRuleUse schemaObject) throws LdapException
Removes the SchemaObject registered with this registry.- Specified by:
unregister
in interfaceSchemaObjectRegistry<MatchingRuleUse>
- Parameters:
schemaObject
- the schemaObject to unregister- Returns:
- The unregistred schema object
- Throws:
LdapException
- if the schemaObject can't be unregistered is invalid
-
-