[CAMEL-1499] LDAP documentation could be improved

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 1.6.0, 2.0-M1
• Fix Version/s: 1.6.0, 2.0-M1
• Component/s: camel-ldap

Environment

Wiki pages

• Assignee: Unassigned
• Reporter: Christopher Hunt
• Created: 29/Mar/09 11:30
• Updated: 31/Jul/09 06:34
• Resolved: 05/May/09 13:19

Description

On familiarising myself with the ldap component I found that I had to trawl through the source code to gain a good understanding of how it should be used.

For example (http://camel.apache.org/ldap.html):

"In the sample below we fetch the rows from the customer table.
First we register our datasource in the Camel registry as testdb:"

is entirely incorrect. Perhaps it should say:

"In the sample below we create a JNDI DirContext and register it with our Camel context's JNDI registry. The key used for registration is the remaining part of the ldap URI i.e. the part without the ldap: and URI parameters. The DirContext should establish any authentication requirements with the LDAP repository."

I then think that the example should illustrate how an anonymous DirContext can be established outside of any ApacheDS dependencies e.g.:

		Hashtable<Object, Object> env = new Hashtable<Object, Object>();
		env.put(Context.INITIAL_CONTEXT_FACTORY, initialContextFactory);
		env.put(Context.PROVIDER_URL, providerURL);
		env.put(Context.SECURITY_AUTHENTICATION, "none");

		DirContext ctx = new InitialDirContext(env);