Spring/spring-ldap
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #392 from eddumelendez/gh-321

Browse Source 
Add documentation for Testing
This commit is contained in:
Rob Winch
2016-03-20 11:04:03 -05:00
parent af0f790555 0551d7eac6
commit 37c4eb0420
1 changed files with 67 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

67
src/docs/asciidoc/index.adoc
View File

@@ -2359,3 +2359,70 @@ Attributes attrs = DefaultIncrementalAttributeMapper.lookupAttributes(ldapTempla
----
This will parse any returned attribute range markers and make repeated requests as necessary until all values for all requested attributes have been retrieved.
== Testing
==== Using Embedded Server
`spring-ldap-test` bring an embedded ldap server based on ApacheDS.
NOTE: `spring-ldap-test` is compatible with ApacheDS 1.5.5. New versions of ApacheDS are not supported.
Download the dependency below:
Maven:
[source,xml]
----
<dependency>
<groupId>org.springframework.ldap</groupId>
<artifactId>spring-ldap-test</artifactId>
<version>${version}</version>
</dependency>
----
Gradle:
[source,groovy]
[subs="verbatim,quotes"]
----
testCompile "org.springframework.ldap:spring-ldap-test:$version"
----
An embedded ldap server is created using the bean below:
[source,xml]
----
<bean id="embeddedLdapServer" class="org.springframework.ldap.test.EmbeddedLdapServerFactoryBean">
<property name="partitionName" value="example"/>
<property name="partitionSuffix" value="dc=261consulting,dc=com" />
<property name="port" value="9321" />
</bean>
----
`spring-ldap-test` provided a mechanism to populate the ldap server using `org.springframework.ldap.test.LdifPopulator`. Create the bean as follow:
[source,xml]
----
<bean class="org.springframework.ldap.test.LdifPopulator" depends-on="embeddedLdapServer">
<property name="contextSource" ref="contextSource" />
<property name="resource" value="classpath:/setup_data.ldif" />
<property name="base" value="dc=jayway,dc=se" />
<property name="clean" value="true" />
<property name="defaultBase" value="dc=jayway,dc=se" />
</bean>
----
Another way to work against an embedded ldap server is using `org.springframework.ldap.test.TestContextSourceFactoryBean` which allow to use and populate it.
[source,xml]
----
<bean id="contextSource" class="org.springframework.ldap.test.TestContextSourceFactoryBean">
<property name="defaultPartitionSuffix" value="dc=jayway,dc=se" />
<property name="defaultPartitionName" value="jayway" />
<property name="principal" value="uid=admin,ou=system" />
<property name="password" value="secret" />
<property name="ldifFile" value="classpath:/setup_data.ldif" />
<property name="port" value="1888" />
</bean>
----
Also, `org.springframework.ldap.test.LdapTestUtils` provide methods to work with embedded ldap server programmatically.