/*
* CDDL HEADER START
*
* The contents of this file are subject to the terms of the
* Common Development and Distribution License, Version 1.0 only
* (the "License"). You may not use this file except in compliance
* with the License.
*
* You can obtain a copy of the license at legal-notices/CDDLv1_0.txt
* See the License for the specific language governing permissions
* and limitations under the License.
*
* When distributing Covered Code, include this CDDL HEADER in each
* file and include the License file at legal-notices/CDDLv1_0.txt.
* If applicable, add the following below this CDDL HEADER, with the
* fields enclosed by brackets "[]" replaced with your own identifying
* information:
* Portions Copyright [yyyy] [name of copyright owner]
*
* CDDL HEADER END
*
*
* Copyright 2006-2010 Sun Microsystems, Inc.
*/
/**
* This class represents the DN database, or dn2id, which has one record
* for each entry. The key is the normalized entry DN and the value
* is the entry ID.
*/
{
/**
* The tracer object for the debug logger.
*/
/**
* The key comparator used for the DN database.
*/
private final int prefixRDNComponents;
/**
* Create a DN2ID instance for the DN database in a given entryContainer.
*
* @param name The name of the DN database.
* @param env The JE environment.
* @param entryContainer The entryContainer of the DN database.
* @throws DatabaseException If an error occurs in the JE database.
*/
@SuppressWarnings("unchecked")
throws DatabaseException
{
{
dn2idConfig.setReadOnly(true);
dn2idConfig.setAllowCreate(false);
dn2idConfig.setTransactional(false);
}
{
dn2idConfig.setAllowCreate(true);
dn2idConfig.setTransactional(false);
dn2idConfig.setDeferredWrite(true);
}
else
{
dn2idConfig.setAllowCreate(true);
dn2idConfig.setTransactional(true);
}
this.dbConfig = dn2idConfig;
this.dbConfig.setKeyPrefixing(true);
//This line causes an unchecked cast error if the SuppressWarnings
//annotation is removed at the beginning of this method.
comparator.getClass());
}
/**
* Insert a new record into the DN database.
* @param txn A JE database transaction to be used for the database operation,
* or null if none.
* @param dn The entry DN, which is the key to the record.
* @param id The entry ID, which is the value of the record.
* @return true if the record was inserted, false if a record with that key
* already exists.
* @throws DatabaseException If an error occurred while attempting to insert
* the new record.
*/
throws DatabaseException
{
{
return false;
}
return true;
}
/**
* Write a record to the DN database. If a record with the given key already
* exists, the record will be replaced, otherwise a new record will be
* inserted.
* @param txn A JE database transaction to be used for the database operation,
* or null if none.
* @param dn The entry DN, which is the key to the record.
* @param id The entry ID, which is the value of the record.
* @return true if the record was written, false if it was not written.
* @throws DatabaseException If an error occurred while attempting to write
* the record.
*/
throws DatabaseException
{
{
return false;
}
return true;
}
/**
* Write a record to the DN database, where the key and value are already
* formatted.
* @param txn A JE database transaction to be used for the database operation,
* or null if none.
* @param key A DatabaseEntry containing the record key.
* @param data A DatabaseEntry containing the record value.
* @return true if the record was written, false if it was not written.
* @throws DatabaseException If an error occurred while attempting to write
* the record.
*/
throws DatabaseException
{
}
/**
* Remove a record from the DN database.
* @param txn A JE database transaction to be used for the database operation,
* or null if none.
* @param dn The entry DN, which is the key to the record.
* @return true if the record was removed, false if it was not removed.
* @throws DatabaseException If an error occurred while attempting to remove
* the record.
*/
throws DatabaseException
{
);
{
return false;
}
return true;
}
/**
* {@inheritDoc}
*/
throws DatabaseException
{
}
/**
* Fetch the entry ID for a given DN.
* @param txn A JE database transaction to be used for the database read, or
* null if none is required.
* @param dn The DN for which the entry ID is desired.
* @param lockMode The JE locking mode to be used for the read.
* @return The entry ID, or null if the given DN is not in the DN database.
* @throws DatabaseException If an error occurs in the JE database.
*/
throws DatabaseException
{
);
{
return null;
}
}
/**
* {@inheritDoc}
*/
{
}
/**
* Gets the comparator for records stored in this database.
*
* @return The comparator for records stored in this database.
*/
{
return comparator;
}
}