/*
|
* The contents of this file are subject to the terms of the Common Development and
|
* Distribution License (the License). You may not use this file except in compliance with the
|
* License.
|
*
|
* You can obtain a copy of the License at legal/CDDLv1.0.txt. See the License for the
|
* specific language governing permission and limitations under the License.
|
*
|
* When distributing Covered Software, include this CDDL Header Notice in each file and include
|
* the License file at legal/CDDLv1.0.txt. If applicable, add the following below the CDDL
|
* Header, with the fields enclosed by brackets [] replaced by your own identifying
|
* information: "Portions Copyright [year] [name of copyright owner]".
|
*
|
* Copyright 2008 Sun Microsystems, Inc.
|
*/
|
package org.opends.server.admin.client.ldap;
|
|
|
import java.util.Collection;
|
|
import javax.naming.NamingException;
|
import javax.naming.directory.Attributes;
|
import javax.naming.ldap.LdapName;
|
|
|
|
/**
|
* An LDAP connection adaptor interface which is used to perform LDAP
|
* client operations.
|
* <p>
|
* This interface is provided in order to make it easier to keep track
|
* of which JNDI DirContext methods we require and also to facilitate
|
* implementation of mock JNDI contexts for unit-testing.
|
*/
|
public abstract class LDAPConnection {
|
|
/**
|
* Create a new LDAP connection.
|
*/
|
protected LDAPConnection() {
|
// No implementation required.
|
}
|
|
|
|
/**
|
* Creates a new entry with the specified set of attributes.
|
*
|
* @param dn
|
* The name of the entry to be created.
|
* @param attributes
|
* The set of attributes.
|
* @throws NamingException
|
* If an error occurred whilst creating the entry.
|
*/
|
public abstract void createEntry(LdapName dn, Attributes attributes)
|
throws NamingException;
|
|
|
|
/**
|
* Deletes the named subtree.
|
*
|
* @param dn
|
* The name of the subtree to be deleted.
|
* @throws NamingException
|
* If an error occurred whilst deleting the subtree.
|
*/
|
public abstract void deleteSubtree(LdapName dn) throws NamingException;
|
|
|
|
/**
|
* Determines whether or not the named entry exists.
|
*
|
* @param dn
|
* The name of the entry.
|
* @return Returns <code>true</code> if the entry exists.
|
* @throws NamingException
|
* If an error occurred whilst making the determination.
|
*/
|
public abstract boolean entryExists(LdapName dn) throws NamingException;
|
|
|
|
/**
|
* Lists the children of the named entry.
|
*
|
* @param dn
|
* The name of the entry to list.
|
* @param filter
|
* An LDAP filter string, or <code>null</code> indicating
|
* the default filter of <code>(objectclass=*)</code>.
|
* @return Returns the names of the children.
|
* @throws NamingException
|
* If an error occurred whilst listing the children.
|
*/
|
public abstract Collection<LdapName> listEntries(LdapName dn, String filter)
|
throws NamingException;
|
|
|
|
/**
|
* Modifies the attributes of the named entry.
|
*
|
* @param dn
|
* The name of the entry to be modified.
|
* @param mods
|
* The list of attributes which need replacing.
|
* @throws NamingException
|
* If an error occurred whilst applying the modifications.
|
*/
|
public abstract void modifyEntry(LdapName dn, Attributes mods)
|
throws NamingException;
|
|
|
|
/**
|
* Reads the attributes of the named entry.
|
*
|
* @param dn
|
* The name of the entry to be read.
|
* @param attrIds
|
* The list of attributes to be retrievd.
|
* @return Returns the attributes of the requested entry.
|
* @throws NamingException
|
* If an error occurred whilst reading the entry.
|
*/
|
public abstract Attributes readEntry(LdapName dn, Collection<String> attrIds)
|
throws NamingException;
|
|
|
|
/**
|
* Closes the LDAP connection.
|
*/
|
public abstract void unbind();
|
}
|
