svn commit: r1003792 - in /websites/staging/directory/trunk/content: ./ api/user-guide/1.1-java-and-ldap.html

[bu...@apache.org]

Author: buildbot
Date: Fri Dec 30 23:18:29 2016
New Revision: 1003792

Log:
Staging update by buildbot for directory

Modified:
    websites/staging/directory/trunk/content/   (props changed)
    websites/staging/directory/trunk/content/api/user-guide/1.1-java-and-ldap.html

Propchange: websites/staging/directory/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Fri Dec 30 23:18:29 2016
@@ -1 +1 @@
-1776656
+1776658

Modified: websites/staging/directory/trunk/content/api/user-guide/1.1-java-and-ldap.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/1.1-java-and-ldap.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/1.1-java-and-ldap.html Fri Dec 30 23:18:29 2016
@@ -184,10 +184,10 @@
 }
 h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
 <h1 id="11-java-and-ldap">1.1 - Java and LDAP<a class="headerlink" href="#11-java-and-ldap" title="Permanent link">&para;</a></h1>
-<p>Most developers will, at some point, face the tricky task to communicate with a <strong>LDAP</strong> server. <strong>LDAP</strong> seems to be a very simple technology, but when you get deep into it, you realize that many aspects are not well known, and not easy to deal with.</p>
-<p>Java is one of the most commonly used languages used in the enterprise. Some even call it the new <strong>Cobol</strong>!</p>
-<p>Those two facts make it necessary to be able to communicate with a <strong>LDAP</strong> server using <strong>Java</strong>. This is where a convenient <strong>API</strong> is useful, which is why we decided to provide this <strong>API</strong>.</p>
-<p>Of course, there are alternatives, like <strong>JNDI</strong>. We believe that the others don't help users cope with <strong>LDAP</strong>'s inherent complexities. <strong>JNDI</strong>'s semantics are very different than what's required for proper <strong>LDAP</strong> usage. For example:</p>
+<p>Most developers will at some point need to learn how to communicate with an <strong>LDAP</strong> server. It should be a very simple technology to use but isn't because many aspects are not well known.</p>
+<p>Java is one of the most commonly used languages in the enterprise. Some call it the new <strong>Cobol</strong>!</p>
+<p>These facts mean it's necessary to communicate over <strong>LDAP</strong> using <strong>Java</strong>. This is why a convenient <strong>API</strong> is necessary, so we created this <strong>API</strong> to fill the necessary gaps.</p>
+<p>There are alternatives, like <strong>JNDI</strong>. But the alternatives aren't effective helping users cope with <strong>LDAP</strong>'s inherent complexities. <strong>JNDI</strong>'s semantics are very different from what's required for proper <strong>LDAP</strong> usage. For example:</p>
 <ul>
 <li><strong>Bind</strong> : used in <strong>LDAP</strong> to authenticate a user but creates an entry in <strong>JNDI</strong></li>
 <li><strong>Unbind</strong> : closes the <strong>LDAP</strong> session in <strong>LDAP</strong> but deletes an entry in <strong>JNDI</strong></li>
@@ -197,7 +197,7 @@ h2:hover > .headerlink, h3:hover > .head
 <li><strong>Name</strong> in <strong>JNDI</strong> can't do a valid comparison in <strong>JNDI</strong></li>
 <li><strong>NamingEnumeration</strong> must be explcitly closed in <strong>JNDI</strong>, and don't close automatically upon disconnect, which causes resource leakage to occur.</li>
 </ul>
-<p>Some of those problems are also true for the existing <strong>LDAP API</strong>.</p>
+<p>Some of these same problems exist for the other <strong>LDAP API</strong>s.  Other alternatives are no longer supported and/or lack a permissive license.</p>
 <p>All in all, writing applications to perform basic <strong>LDAP</strong> operations in <strong>Java</strong> is a painful task for most developers.</p>
 <p>Our target is to provide a better <strong>API</strong>, one that leads to correct and efficient usage of <strong>LDAP</strong> operation.</p>