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

Class OidRegistry<T extends SchemaObject>

java.lang.Object

org.apache.directory.api.ldap.model.schema.registries.OidRegistry<T>

Type Parameters:

T - The type of SchemaObject

All Implemented Interfaces:

Iterable<T>

public class OidRegistry<T extends SchemaObject>
extends Object
implements Iterable<T>

Object identifier registry. It stores the OIDs for AT, OC, MR, LS, MRU, DSR, DCR and NF. An OID is unique, and associated with a SO.

Author:

Apache Directory Project

Field Summary

Fields

Modifier and Type	Field and Description
private Map<String,T>	byOid Maps OID to a type of SchemaObject
private SchemaErrorHandler	errorHandler
private boolean	isRelaxed A flag indicating that the Registry is relaxed or not
private static org.slf4j.Logger	LOG static class logger

Constructor Summary

Constructors

Constructor and Description
OidRegistry()

Method Summary

Modifier and Type	Method and Description
void	clear() Empty the byOid map
boolean	contains(String oid) Tells if the given OID is present on this registry
OidRegistry<T>	copy() Copy the OidRegistry, without the contained values
SchemaErrorHandler	getErrorHandler()
List<String>	getNameSet(String oid) Gets the names associated with an OID.
String	getPrimaryName(String oid) Gets the primary name associated with an OID.
T	getSchemaObject(String oid) Gets the SchemaObject associated with an OID.
boolean	isRelaxed() Tells if the Registry is permissive or if it must be checked against inconsistencies.
boolean	isStrict() Tells if the Registry is strict.
Iterator<T>	iterator() Lists all the SchemaObjects within the registry.
Iterator<String>	iteratorOids() Lists all the OIDs within the registry.
(package private) void	put(T schemaObject) Store the given SchemaObject into the OidRegistry.
void	register(T schemaObject) Adds an OID name pair to the registry.
void	setErrorHandler(SchemaErrorHandler errorHandler)
void	setRelaxed() Change the Registry to a relaxed mode, where invalid SchemaObjects can be registered.
void	setStrict() Change the Registry to a strict mode, where invalid SchemaObjects cannot be registered.
int	size()
String	toString()
void	unregister(String oid) Removes an oid from this registry.

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Field Detail

LOG

private static final org.slf4j.Logger LOG

static class logger

byOid

private Map<String,T extends SchemaObject> byOid

Maps OID to a type of SchemaObject

isRelaxed

private boolean isRelaxed

A flag indicating that the Registry is relaxed or not

errorHandler

private SchemaErrorHandler errorHandler

Constructor Detail

OidRegistry

public OidRegistry()

Method Detail

contains

public boolean contains(String oid)

Tells if the given OID is present on this registry

Parameters:

oid - The OID to lookup

Returns:

true if the OID already exists

getPrimaryName

public String getPrimaryName(String oid)
                      throws LdapException

Gets the primary name associated with an OID. The primary name is the first name specified for the OID.

Parameters:

oid - the object identifier

Returns:

the primary name

Throws:

LdapException - if oid does not exist

getSchemaObject

public T getSchemaObject(String oid)
                  throws LdapException

Gets the SchemaObject associated with an OID.

Parameters:

oid - the object identifier

Returns:

the associated SchemaObject

Throws:

LdapException - if oid does not exist

getNameSet

public List<String> getNameSet(String oid)
                        throws LdapException

Gets the names associated with an OID. An OID is unique however it may have many names used to refer to it. A good example is the cn and commonName attribute names for OID 2.5.4.3. Within a server one name within the set must be chosen as the primary name. This is used to name certain things within the server internally. If there is more than one name then the first name is taken to be the primary.

Parameters:

oid - the OID for which we return the set of common names

Returns:

a sorted set of names

Throws:

LdapException - if oid does not exist

iteratorOids

public Iterator<String> iteratorOids()

Lists all the OIDs within the registry. This may be a really big list.

Returns:

all the OIDs registered

iterator

public Iterator<T> iterator()

Lists all the SchemaObjects within the registry. This may be a really big list.

Specified by:

iterator in interface Iterable<T extends SchemaObject>

Returns:

all the SchemaObject registered

isRelaxed

public boolean isRelaxed()

Tells if the Registry is permissive or if it must be checked against inconsistencies.

Returns:

True if SchemaObjects can be added even if they break the consistency

isStrict

public boolean isStrict()

Tells if the Registry is strict.

Returns:

True if SchemaObjects cannot be added if they break the consistency

setRelaxed

public void setRelaxed()

Change the Registry to a relaxed mode, where invalid SchemaObjects can be registered.

setStrict

public void setStrict()

Change the Registry to a strict mode, where invalid SchemaObjects cannot be registered.

getErrorHandler

public SchemaErrorHandler getErrorHandler()

setErrorHandler

public void setErrorHandler(SchemaErrorHandler errorHandler)

register

public void register(T schemaObject)
              throws LdapException

Adds an OID name pair to the registry.

Parameters:

schemaObject - The SchemaObject the oid belongs to

Throws:

LdapException - If something went wrong

put

void put(T schemaObject)

Store the given SchemaObject into the OidRegistry. Available only to the current package. A weak form (no check is done) of the register method, define for clone methods.

Parameters:

schemaObject - The SchemaObject to inject into the OidRegistry

unregister

public void unregister(String oid)
                throws LdapException

Removes an oid from this registry.

Parameters:

oid - the numeric identifier for the object

Throws:

LdapException - if the identifier is not numeric

copy

public OidRegistry<T> copy()

Copy the OidRegistry, without the contained values

Returns:

A new OidRegistry instance

size

public int size()

Returns:

The number of stored OIDs

clear

public void clear()

Empty the byOid map

toString

public String toString()

Overrides:

toString in class Object

See Also:

Object.toString()