org.sakaiproject.unboundid.LdapConnectionManagerConfig Maven / Gradle / Ivy
The newest version!
/**********************************************************************************
* $URL$
* $Id$
***********************************************************************************
*
* Copyright (c) 2003, 2004, 2005, 2006, 2007, 2008 The Sakai Foundation
*
* Licensed under the Educational Community License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.opensource.org/licenses/ECL-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
**********************************************************************************/
package org.sakaiproject.unboundid;
/**
* Bean interface for collecting {@link LdapConnectionManager} configuration.
*
*
* This interface was introduced to retain forward compatibility of
* <=2.3.0 config files, which configure a single {@link UnboundidDirectoryProvider}
* bean. As of this writing, that class now implements this interface as a
* mixin and makes itself available to the {@link LdapConnectionManager}
* as a side-effect of {@link UnboundidDirectoryProvider#init()}.
*
*
* @author Dan McCallum, Unicon Inc
*
*/
public interface LdapConnectionManagerConfig {
/**
* If true, connect to LDAP over a secure protocol.
*/
public boolean isSecureConnection();
/**
* Set to true if LDAP connections
* should occur over a secure protocol.
*/
public void setSecureConnection(boolean secureConnection);
/**
* @return the directory operation timeout
*/
public int getOperationTimeout();
/**
* @param operationTimeout
* the directory operation timeout to set.
*/
public void setOperationTimeout(int operationTimeout);
/**
* @return the LDAP host address or name.
*/
public String[] getLdapHost();
/**
* @param ldapHost
* The LDAP host address or name.
*/
public void setLdapHost(String[] ldapHost);
/**
* @return the LDAP connection port.
*/
public int[] getLdapPort();
/**
* @param ldapPort
* The LDAP connection port to set.
*/
public void setLdapPort(int[] ldapPort);
/**
* @return the LDAP user to bind as, typically a manager acct.
*/
public String getLdapUser();
/**
* @param ldapUser The user to bind to LDAP as, typically a manager acct,
* leave blank for anonymous.
*/
public void setLdapUser(String ldapUser);
/**
* @see #getLdapUser()
* @return Returns the LDAP password corresponding to the
* current default bind-as user.
*/
public String getLdapPassword();
/**
* @param ldapPassword the LDAP password corresponding to the
* current default bind-as user.
*/
public void setLdapPassword(String ldapPassword);
/**
* Access LDAP referral following configuration
*
* @return if true, directory accesses will
* follow referrals
*/
public boolean isFollowReferrals();
/**
* Configures LDAP referral following
*
* @param followReferrals if true, directory
* accesses will follow referrals
*/
public void setFollowReferrals(boolean followReferrals);
/**
* Access the LDAP auto-bind configuration
*
* @return if true connection allocation
* ({@link LdapConnectionManager#getConnection()}) will include a
* bind attempt
*/
public boolean isAutoBind();
/**
* Configure the LDAP auto-bind configuration
*
* param autoBind if true connection allocation
* ({@link LdapConnectionManager#getConnection()}) will include a
* bind attempt
*/
public void setAutoBind(boolean autoBind);
/**
* @return The maximum number of physical connections in the pool
*/
public int getPoolMaxConns();
/**
* @param maxConns The maximum number of physical connections in the pool
*/
public void setPoolMaxConns(int maxConns);
/**
* @return The maximum number of objects to lookup in one query.
*/
public int getBatchSize();
/**
* @param batchSize The maximum number objects to lookup in one query.
*/
public void setBatchSize(int batchSize);
/**
* @return The maximum number of results to ever get back from LDAP.
*/
public int getMaxResultSize();
/**
* @param maxResultSize The maximum number of results to ever get back from LDAP.
*/
public void setMaxResultSize(int maxResultSize);
/**
* @param enable If true then perform searches for users by Authentication ID.
*/
public void setEnableAid(boolean enable);
}