org.springframework.security.ldap.server

Class ApacheDSContainer

java.lang.Object

org.springframework.security.ldap.server.ApacheDSContainer

All Implemented Interfaces:

Aware, DisposableBean, InitializingBean, ApplicationContextAware, Lifecycle

public class ApacheDSContainer
extends Object
implements InitializingBean, DisposableBean, Lifecycle, ApplicationContextAware

Provides lifecycle services for the embedded apacheDS server defined by the supplied configuration. Used by LdapServerBeanDefinitionParser. An instance will be stored in the application context for each embedded server instance. It will start the server when the context is initialized and shut it down when it is closed. It is intended for temporary embedded use and will not retain changes across start/stop boundaries. The working directory is deleted on shutdown.

If used repeatedly in a single JVM process with the same configuration (for example, when repeatedly loading an application context during testing), it's important that the application context is closed to allow the bean to be disposed of and the server shutdown prior to attempting to start it again.

This class is intended for testing and internal security namespace use, only, and is not considered part of the framework's public API.

Constructor Summary

Constructors

Constructor and Description
ApacheDSContainer(String root, String ldifs)

Method Summary

Modifier and Type	Method and Description
void	afterPropertiesSet()
void	destroy()
org.apache.directory.server.core.DefaultDirectoryService	getService()
boolean	isRunning()
void	setApplicationContext(ApplicationContext applicationContext)
void	setCertificatePassord(String certificatePassord) Will set the certificate password on the underlying LdapServer.
void	setKeyStoreFile(File keyStoreFile) The keyStore must not be null and must be a valid file.
void	setLdapOverSslEnabled(boolean ldapOverSslEnabled) If set to true will enable LDAP over SSL (LDAPs).
void	setPort(int port)
void	setWorkingDirectory(File workingDir)
void	start()
void	stop()

Methods inherited from class java.lang.Object

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

Constructor Detail

ApacheDSContainer

public ApacheDSContainer(String root,
                         String ldifs)
                  throws Exception

Throws:

Exception

Method Detail

afterPropertiesSet

public void afterPropertiesSet()
                        throws Exception

Specified by:

afterPropertiesSet in interface InitializingBean

Throws:

Exception

destroy

public void destroy()
             throws Exception

Specified by:

destroy in interface DisposableBean

Throws:

Exception

setApplicationContext

public void setApplicationContext(ApplicationContext applicationContext)
                           throws BeansException

Specified by:

setApplicationContext in interface ApplicationContextAware

Throws:

BeansException

setWorkingDirectory

public void setWorkingDirectory(File workingDir)

setPort

public void setPort(int port)

setLdapOverSslEnabled

public void setLdapOverSslEnabled(boolean ldapOverSslEnabled)

If set to true will enable LDAP over SSL (LDAPs). If set to true setCertificatePassord(String) must be set as well.

Parameters:

ldapOverSslEnabled - If not set, will default to false

setKeyStoreFile

public void setKeyStoreFile(File keyStoreFile)

The keyStore must not be null and must be a valid file. Will set the keyStore file on the underlying LdapServer.

Parameters:

keyStoreFile - Mandatory if LDAPs is enabled

setCertificatePassord

public void setCertificatePassord(String certificatePassord)

Will set the certificate password on the underlying LdapServer.

Parameters:

certificatePassord - May be null

getService

public org.apache.directory.server.core.DefaultDirectoryService getService()

start

public void start()

Specified by:

start in interface Lifecycle

stop

public void stop()

Specified by:

stop in interface Lifecycle

isRunning

public boolean isRunning()

Specified by:

isRunning in interface Lifecycle