org.opends.server.api

Class CompressedSchema

java.lang.Object

org.opends.server.api.CompressedSchema

Direct Known Subclasses:

DefaultCompressedSchema

@PublicAPI(stability=UNCOMMITTED,
           mayInstantiate=false,
           mayExtend=true,
           mayInvoke=false)
public class CompressedSchema
extends Object

This class provides a utility for interacting with compressed representations of schema elements. The default implementation does not persist encoded attributes and object classes.

Constructor Summary

Constructors

Constructor and Description
CompressedSchema()

Method Summary

Methods

Modifier and Type	Method and Description
Attribute	decodeAttribute(org.forgerock.opendj.ldap.ByteSequenceReader reader) Decodes the contents of the provided array as an attribute at the current position.
Map<ObjectClass,String>	decodeObjectClasses(org.forgerock.opendj.ldap.ByteSequenceReader reader) Decodes an object class set from the provided byte string.
void	encodeAttribute(org.forgerock.opendj.ldap.ByteStringBuilder builder, Attribute attribute) Encodes the information in the provided attribute to a byte array.
void	encodeObjectClasses(org.forgerock.opendj.ldap.ByteStringBuilder builder, Map<ObjectClass,String> objectClasses) Encodes the provided set of object classes to a byte array.
protected Iterable<Map.Entry<byte[],Map.Entry<String,Collection<String>>>>	getAllAttributes() Returns a view of the encoded attributes in this compressed schema which can be used for saving the entire content to disk.
protected Iterable<Map.Entry<byte[],Collection<String>>>	getAllObjectClasses() Returns a view of the encoded object classes in this compressed schema which can be used for saving the entire content to disk.
protected Map.Entry<AttributeType,Set<String>>	loadAttribute(byte[] encodedAttribute, String attributeName, Collection<String> attributeOptions) Loads an encoded attribute into this compressed schema.
protected Map<ObjectClass,String>	loadObjectClasses(byte[] encodedObjectClasses, Collection<String> objectClassNames) Loads an encoded object class into this compressed schema.
protected void	storeAttribute(byte[] encodedAttribute, String attributeName, Collection<String> attributeOptions) Persists the provided encoded attribute.
protected void	storeObjectClasses(byte[] encodedObjectClasses, Collection<String> objectClassNames) Persists the provided encoded object classes.

Methods inherited from class java.lang.Object

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

Constructor Detail

CompressedSchema

public CompressedSchema()

Method Detail

decodeAttribute

public final Attribute decodeAttribute(org.forgerock.opendj.ldap.ByteSequenceReader reader)
                                throws DirectoryException

Decodes the contents of the provided array as an attribute at the current position.

Parameters:

reader - The byte string reader containing the encoded entry.

Returns:

The decoded attribute.

Throws:

DirectoryException - If the attribute could not be decoded properly for some reason.

decodeObjectClasses

public final Map<ObjectClass,String> decodeObjectClasses(org.forgerock.opendj.ldap.ByteSequenceReader reader)
                                                  throws DirectoryException

Decodes an object class set from the provided byte string.

Parameters:

reader - The byte string reader containing the object class set identifier.

Returns:

The decoded object class set.

Throws:

DirectoryException - If the provided byte string reader cannot be decoded as an object class set.

encodeAttribute

public final void encodeAttribute(org.forgerock.opendj.ldap.ByteStringBuilder builder,
                   Attribute attribute)
                           throws DirectoryException

Encodes the information in the provided attribute to a byte array.

Parameters:

builder - The buffer to encode the attribute to.

attribute - The attribute to be encoded.

Throws:

DirectoryException - If a problem occurs while attempting to determine the appropriate identifier.

encodeObjectClasses

public final void encodeObjectClasses(org.forgerock.opendj.ldap.ByteStringBuilder builder,
                       Map<ObjectClass,String> objectClasses)
                               throws DirectoryException

Encodes the provided set of object classes to a byte array. If the same set had been previously encoded, then the cached value will be used. Otherwise, a new value will be created.

Parameters:

builder - The buffer to encode the object classes to.

objectClasses - The set of object classes for which to retrieve the corresponding byte array token.

Throws:

DirectoryException - If a problem occurs while attempting to determine the appropriate identifier.

getAllAttributes

protected final Iterable<Map.Entry<byte[],Map.Entry<String,Collection<String>>>> getAllAttributes()

Returns a view of the encoded attributes in this compressed schema which can be used for saving the entire content to disk. The iterator returned by this method is not thread safe.

Returns:

A view of the encoded attributes in this compressed schema.

getAllObjectClasses

protected final Iterable<Map.Entry<byte[],Collection<String>>> getAllObjectClasses()

Returns a view of the encoded object classes in this compressed schema which can be used for saving the entire content to disk. The iterator returned by this method is not thread safe.

Returns:

A view of the encoded object classes in this compressed schema.

loadAttribute

protected final Map.Entry<AttributeType,Set<String>> loadAttribute(byte[] encodedAttribute,
                                                 String attributeName,
                                                 Collection<String> attributeOptions)

Loads an encoded attribute into this compressed schema. This method may called by implementations during initialization when loading content from disk.

Parameters:

encodedAttribute - The encoded attribute description.

attributeName - The user provided attribute type name.

attributeOptions - The non-null but possibly empty set of attribute options.

Returns:

The attribute type description.

loadObjectClasses

protected final Map<ObjectClass,String> loadObjectClasses(byte[] encodedObjectClasses,
                                        Collection<String> objectClassNames)

Loads an encoded object class into this compressed schema. This method may called by implementations during initialization when loading content from disk.

Parameters:

encodedObjectClasses - The encoded object classes.

objectClassNames - The user provided set of object class names.

Returns:

The object class set.

storeAttribute

protected void storeAttribute(byte[] encodedAttribute,
                  String attributeName,
                  Collection<String> attributeOptions)
                       throws DirectoryException

Persists the provided encoded attribute. The default implementation is to do nothing. Calls to this method are synchronized, so implementations can assume that this method is not being called by other threads. Note that this method is not thread-safe with respect to storeObjectClasses(byte[], Collection).

Parameters:

encodedAttribute - The encoded attribute description.

attributeName - The user provided attribute type name.

attributeOptions - The non-null but possibly empty set of attribute options.

Throws:

DirectoryException - If an error occurred while persisting the encoded attribute.

storeObjectClasses

protected void storeObjectClasses(byte[] encodedObjectClasses,
                      Collection<String> objectClassNames)
                           throws DirectoryException

Persists the provided encoded object classes. The default implementation is to do nothing. Calls to this method are synchronized, so implementations can assume that this method is not being called by other threads. Note that this method is not thread-safe with respect to storeAttribute(byte[], String, Collection).

Parameters:

encodedObjectClasses - The encoded object classes.

objectClassNames - The user provided set of object class names.

Throws:

DirectoryException - If an error occurred while persisting the encoded object classes.