Skip to content
A JUnit rule for running an embedded LDAP server in your JUnit test
Branch: master
Clone or download
Latest commit 9361bf9 Nov 2, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src
.gitignore ignore IDEA files Feb 27, 2015
.travis.yml
LICENSE
README.md
pom.xml

README.md

embedded-ldap-junit

Build Status Coverage Status Maven Central Libraries.io for GitHub Analytics

A JUnit Rule for running an embedded LDAP server in your JUnit test based on the wonderful UnboundID LDAP SDK. Inspired by the Embedded Database JUnit Rule.

Why?

  • you want to test your LDAP integration code without affecting your LDAP server
  • you are working with LDAP schema changes that you would like to test without changing the schema at the shared LDAP server
  • you are refactoring legacy code where LDAP calls are tightly coupled with your business logic and wants to start by testing the legacy code from the "outside" (as suggested by Michael Feathers)
    • for this exact reason most instances returned from the EmbeddedLdapRule is instrumented to suppress "close" calls so that your legacy code will not destroy the current Context/DirContext or LdapInterface
    • note: if you used the new unsharedLdapConnection() method, the returned instance will not have this guarantee as it returns a instance of UnboundID LDAPConnection which is declared 'final'.

Status

This library is distributed through the Sonatype OSS repo and should thus be widely available. Java 7 or higher is required. It has proven pretty useful for several users and should be considered safe for running tests for all kinds of LDAP integrating code.

Changelog

  • version 0.7: changelog
  • version 0.6: changelog
  • version 0.5.2: changelog
  • version 0.5.1: changelog
  • version 0.5: changelog
  • version 0.4: changelog
  • version 0.3: solves issue #1 - give access to the LDAPConnection object from the UnboundID LDAP SDK
  • version 0.2:
    • support for defining schema definitions using the "withSchema(String...)" method on the EmbeddedLdapRuleBuilder
    • added the possibility to define multiple root DSNs
  • version 0.1: support for both UnboundID LDAP SDK and traditional JNDI LDAP integrations

Usage

Add dependency

Maven

<dependency>
    <groupId>org.zapodot</groupId>
    <artifactId>embedded-ldap-junit</artifactId>
    <version>0.7</version>
</dependency>

SBT

libraryDependencies += "org.zapodot" % "embedded-ldap-junit" % "0.7"

Add to Junit test

import com.unboundid.ldap.sdk.LDAPInterface;
import javax.naming.Context;
import javax.naming.NamingEnumeration;
...

@Rule
public EmbeddedLdapRule embeddedLdapRule = EmbeddedLdapRuleBuilder
        .newInstance()
        .usingDomainDsn("dc=example,dc=com")
        .importingLdifs("example.ldif")
        .build();

@Test
public void testLdapInteface() throws Exception {
    // Test using the UnboundID LDAP SDK directly
    final LdapInterface ldapConnection = embeddedLdapRule.ldapConnection();
    final SearchResult searchResult = ldapConnection.search(DOMAIN_DSN, SearchScope.SUB, "(objectClass=person)");
    assertEquals(1, searchResult.getEntryCount());
}

@Test
public void testUnsharedLdapConnection() throws Exception {
    // Test using the UnboundID LDAP SDK directly by using the UnboundID LDAPConnection type
    final LDAPConnection ldapConnection = embeddedLdapRule.unsharedLdapConnection();
    final SearchResult searchResult = ldapConnection.search(DOMAIN_DSN, SearchScope.SUB, "(objectClass=person)");
    assertEquals(1, searchResult.getEntryCount());
}

@Test
public void testDirContext() throws Exception {

    // Test using the good ol' JDNI-LDAP integration
    final DirContext dirContext = embeddedLdapRule.dirContext();
    final SearchControls searchControls = new SearchControls();
    searchControls.setSearchScope(SearchControls.SUBTREE_SCOPE);
    final NamingEnumeration<javax.naming.directory.SearchResult> resultNamingEnumeration =
            dirContext.search(DOMAIN_DSN, "(objectClass=person)", searchControls);
    assertEquals(1, Iterators.size(Iterators.forEnumeration(resultNamingEnumeration)));
}
@Test
public void testContext() throws Exception {

    // Another test using the good ol' JDNI-LDAP integration, this time with the Context interface
    final Context context = embeddedLdapRule.context();
    final Object user = context.lookup("cn=John Doe,ou=people,dc=example,dc=com");
    assertNotNull(user);
}
You can’t perform that action at this time.