[BAEL-4806] - How to test an LDAP connection from a client: code (#11664)

* working code

* added unit test

* [BAEL-4806] - How to test an LDAP connection from a client

Ticket: http://jira.baeldung.com/browse/BAEL-4806
Draft: https://drafts.baeldung.com/wp-admin/post.php?post=125004&action=edit

* removing draft project

* applying requested changes

* 1. renaming package to comply with java conventions;
* 2. breaking class into methods to enhance readability;
* 3. creating an 'execute' method so it's not necessary to call 'main';

* requested changes

* 1. adding final keyword to constants;
* 2. using diamond operator;

* Update LdapConnectionToolManualTest.java

core-java-modules/core-java-jndi/src/test/java/com/baeldung/jndi/ldap/connection/tool/LdapConnectionToolManualTest.java

@@ -0,0 +1,87 @@
+package com.baeldung.jndi.ldap.connection.tool;
+
+import static org.assertj.core.api.Assertions.assertThatCode;
+import static org.assertj.core.api.Assertions.assertThatExceptionOfType;
+
+import javax.naming.NamingException;
+
+import org.apache.directory.server.annotations.CreateLdapServer;
+import org.apache.directory.server.annotations.CreateTransport;
+import org.apache.directory.server.core.annotations.ApplyLdifFiles;
+import org.apache.directory.server.core.annotations.CreateDS;
+import org.apache.directory.server.core.annotations.CreatePartition;
+import org.apache.directory.server.core.integ.AbstractLdapTestUnit;
+import org.apache.directory.server.core.integ.FrameworkRunner;
+import org.junit.Before;
+import org.junit.Test;
+import org.junit.runner.RunWith;
+
+@RunWith(FrameworkRunner.class)
+@CreateLdapServer(allowAnonymousAccess = true, transports = { @CreateTransport(protocol = "LDAP", address = "localhost", port = 10389) })
+@CreateDS(allowAnonAccess = true, partitions = { @CreatePartition(name = "ldap-connection-tool", suffix = "dc=baeldung,dc=com") })
+@ApplyLdifFiles({ "ldap-connection-tool.ldif" })
+// class marked as manual test, as it has to run independently of other unit tests in the module
+public class LdapConnectionToolManualTest extends AbstractLdapTestUnit {
+    @Before
+    public void init() {
+        System.setProperty("debug.mode", "true");
+        System.clearProperty("url");
+        System.clearProperty("user");
+        System.clearProperty("password");
+        System.clearProperty("query");
+    }
+
+    @Test
+    public void whenNoUrlProvided_thenConnectionFails() throws Exception {
+        assertThatExceptionOfType(IllegalArgumentException.class).isThrownBy(() -> LdapConnectionTool.execute());
+    }
+
+    @Test
+    public void givenUrlProvided_whenValidUrl_thenConnectionSucceeds() throws Exception {
+        System.setProperty("url", "ldap://localhost:10389");
+
+        assertThatCode(() -> LdapConnectionTool.execute()).doesNotThrowAnyException();
+    }
+
+    @Test
+    public void givenUrlProvided_whenInvalidUrl_thenConnectionFails() throws Exception {
+        System.setProperty("url", "ldap://unkownhost:10389");
+
+        assertThatExceptionOfType(NamingException.class).isThrownBy(() -> LdapConnectionTool.execute());
+    }
+
+    @Test
+    public void givenUserProvided_whenCorrectPassword_thenConnectionSucceeds() throws Exception {
+        System.setProperty("url", "ldap://localhost:10389");
+        System.setProperty("user", "uid=gauss,dc=baeldung,dc=com");
+        System.setProperty("password", "password");
+
+        assertThatCode(() -> LdapConnectionTool.execute()).doesNotThrowAnyException();
+    }
+
+    @Test
+    public void givenUserProvided_whenPasswordIsNull_thenConnectionFails() throws Exception {
+        System.setProperty("url", "ldap://localhost:10389");
+        System.setProperty("user", "uid=gauss,dc=baeldung,dc=com");
+
+        assertThatExceptionOfType(IllegalArgumentException.class).isThrownBy(() -> LdapConnectionTool.execute());
+    }
+
+    @Test
+    public void whenOnlyValidQueryProvided_thenConnectionSucceeds() throws Exception {
+        System.setProperty("url", "ldap://localhost:10389");
+        System.setProperty("query", "uid=gauss,dc=baeldung,dc=com");
+
+        assertThatCode(() -> LdapConnectionTool.execute()).doesNotThrowAnyException();
+    }
+
+    @Test
+    public void givenUserProvided_whenQueryProvided_thenConnectionSucceeds() throws Exception {
+        System.setProperty("url", "ldap://localhost:10389");
+        System.setProperty("user", "uid=gauss,dc=baeldung,dc=com");
+        System.setProperty("password", "password");
+        System.setProperty("query", "uid=newton,dc=baeldung,dc=com");
+
+        assertThatCode(() -> LdapConnectionTool.execute()).doesNotThrowAnyException();
+    }
+}

core-java-modules/core-java-jndi/src/test/resources/ldap-connection-tool.ldif

@@ -0,0 +1,34 @@
+version: 1
+dn: dc=baeldung,dc=com
+objectClass: top
+objectClass: dcObject
+objectClass: organization
+dc: baeldung
+o: baeldung.com
+
+dn: cn=admin,dc=baeldung,dc=com
+objectClass: simpleSecurityObject
+objectClass: organizationalRole
+cn: admin
+description: LDAP administrator
+userPassword: password
+
+dn: uid=newton,dc=baeldung,dc=com
+objectClass: inetOrgPerson
+objectClass: organizationalPerson
+objectClass: person
+objectClass: top
+cn: Isaac Newton
+sn: Newton
+uid: newton
+userPassword: password
+
+dn: uid=gauss,dc=baeldung,dc=com
+objectClass: inetOrgPerson
+objectClass: organizationalPerson
+objectClass: person
+objectClass: top
+cn: Carl Friedrich Gauss
+sn: Gauss
+uid: gauss
+userPassword: password