directory-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r836982 - in /websites/staging/directory/trunk/content: ./ api/groovy-ldap.html api/java-api.html api/user-guide.html api/user-guide/ api/user-guide/1-introduction.html api/vision.html
Date Fri, 02 Nov 2012 06:58:00 GMT
Author: buildbot
Date: Fri Nov  2 06:58:00 2012
New Revision: 836982

Log:
Staging update by buildbot for directory

Added:
    websites/staging/directory/trunk/content/api/java-api.html
    websites/staging/directory/trunk/content/api/user-guide/
    websites/staging/directory/trunk/content/api/user-guide.html
    websites/staging/directory/trunk/content/api/user-guide/1-introduction.html
    websites/staging/directory/trunk/content/api/vision.html
Modified:
    websites/staging/directory/trunk/content/   (props changed)
    websites/staging/directory/trunk/content/api/groovy-ldap.html

Propchange: websites/staging/directory/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Fri Nov  2 06:58:00 2012
@@ -1 +1 @@
-1404286
+1404885

Modified: websites/staging/directory/trunk/content/api/groovy-ldap.html
==============================================================================
--- websites/staging/directory/trunk/content/api/groovy-ldap.html (original)
+++ websites/staging/directory/trunk/content/api/groovy-ldap.html Fri Nov  2 06:58:00 2012
@@ -17,7 +17,7 @@
 -->
 <html>
 	<head>
-		<title>Five Minutes Tutorial &mdash; Apache Directory</title>
+		<title>Groovy LDAP &mdash; Apache Directory</title>
 		
 	    <link href="./../css/common.css" rel="stylesheet" type="text/css">
 	    <link href="./../css/brown.css" rel="stylesheet" type="text/css">

Added: websites/staging/directory/trunk/content/api/java-api.html
==============================================================================
--- websites/staging/directory/trunk/content/api/java-api.html (added)
+++ websites/staging/directory/trunk/content/api/java-api.html Fri Nov  2 06:58:00 2012
@@ -0,0 +1,176 @@
+<!DOCTYPE html>
+<!--
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version 2.0
+    (the "License"); you may not use this file except in compliance with
+    the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<html>
+	<head>
+		<title>LDAP Java API &mdash; Apache Directory</title>
+		
+	    <link href="./../css/common.css" rel="stylesheet" type="text/css">
+	    <link href="./../css/brown.css" rel="stylesheet" type="text/css">
+    
+	</head>
+	<body>
+	    <div id="container">
+            <div id="header">
+                <div id="subProjectsNavBar">
+                    <a href="./../">
+                        
+                        Apache Directory Project
+                        
+                    </a>
+                    &nbsp;|&nbsp;
+                    <a href="./../apacheds">
+                        
+                        ApacheDS
+                        
+                    </a>
+                    &nbsp;|&nbsp;
+                    <a href="./../studio">
+                        
+                        Apache Directory Studio
+                        
+                    </a>
+                    &nbsp;|&nbsp;
+                    <a href="./../api">
+                        
+                        <STRONG>Apache LDAP API</STRONG>
+                        
+                    </a>
+                </div><!-- subProjectsNavBar -->
+            </div><!-- header -->
+            <div id="content">
+                <div id="leftColumn">
+                    
+<div id="navigation">
+    
+    <h5>Latest Downloads</h5>
+    <ul>
+	    <li><a href="./../api/downloads.html">Version 1.0.0-M13</a>&nbsp;&nbsp;<IMG
src="./../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+    </ul>
+    <h5>Getting Started</h5>
+    <ul>
+        <li><a href="./../api/vision.html">Vision</a></li>
+        <li><a href="./../api/java-api.html">Java API</a></li>
+        <li><a href="./../api/groovy-ldap.html">Groovy API</a></li>
+    </ul>
+    <h5>Documentation</h5>
+    <ul>
+	    <li><a href="./../api/five-minutes-tutorial.html">Five minutes tutorial</a></li>
+	    <li><a href="./../api/user-guide.html">User Guide</a></li>
+        <li><a href="./../api/gen-docs/latest/apidocs/">JavaDocs</a></li>
+        <li><a href="./../api/gen-docs/latest/">Generated Reports</a></li>
+        <li><a href="./../api/developer-guide.html">Developer Guide</a></li>
+    </ul>
+    
+    
+    <h5>Support</h5>
+    <ul>
+        <li><a href="./../mailing-lists-and-irc.html">Mailing Lists &amp;
IRC</a></li>
+        <li><a href="./../sources.html">Sources</a></li>
+        <li><a href="./../issue-tracking.html">Issue Tracking</a></li>
+        <li><a href="./../commercial-support.html">Commercial Support</a></li>
+    </ul>
+    <h5>Community</h5>
+    <ul>
+        <li><a href="./../contribute.html">How to Contribute</a></li>
+        <li><a href="./../team.html">Team</a></li>
+        <li><a href="./../original-project-proposal.html">Original Project Proposal</a></li>
+        <li><a href="./../special-thanks.html" class="external-link" rel="nofollow">Special
Thanks</a></li>
+    </ul>
+    <h5>About Apache</h5>
+    <ul>
+        <li><a href="http://www.apache.org/">Apache</a></li>
+        <li><a href="http://www.apache.org/licenses/">License</a></li>
+        <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+        <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+        <li><a href="http://www.apache.org/security/">Security</a></li>
+    </ul>
+    
+</div><!-- navigation -->
+
+                </div><!-- leftColumn -->
+                <div id="rightColumn">
+
+
+
+<h1 id="ldap-java-api">LDAP Java API</h1>
+<p>This is the Java implementation of a new LDAP API. This effort was initially conducted
with the OpenDS team.</p>
+<h2 id="background">Background</h2>
+<p>There are a few existing LDAP API around there. Here is a short list and description.</p>
+<table>
+<thead>
+<tr>
+<th>API</th>
+<th>Version</th>
+<th>License</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><a href="http://directory.apache.org/api/">Apache Directory Client API</a></td>
+<td>1.0-M13</td>
+<td>ASL 2.0</td>
+<td>The Apache Directory Server CLient API.</td>
+</tr>
+<tr>
+<td><a href="http://www.openldap.org/jldap/">jLDAP</a></td>
+<td>2008_03-01-1</td>
+<td>OpenLDAP Public License</td>
+<td>A Novell contribution to the OpenLDAP project</td>
+</tr>
+<tr>
+<td><a href="http://java.sun.com/products/jndi/reference/docs/index.html">JNDI</a></td>
+<td>1.2</td>
+<td>Sun license</td>
+<td>This is not a pure LDAP API, however it's included in J2SE since Java 5. Probably
the API selected by many developers</td>
+</tr>
+<tr>
+<td><a href="http://www.mozilla.org/directory/javasdk.html">ldapSDK</a></td>
+<td>4.17</td>
+<td>Netscape Public License</td>
+<td>The Mozilla API, formally the Netscape LDAP API</td>
+</tr>
+<tr>
+<td><a href="https://www.opends.org/wiki/page/ClientAPI">OpenDS client API</a></td>
+<td>N/A</td>
+<td>CDDL</td>
+<td>The OpenDS API</td>
+</tr>
+<tr>
+<td><a href="http://www.unboundid.com/products/ldapsdk/">UnboundID API</a></td>
+<td>0.9.10</td>
+<td>GPLv2</td>
+<td>A new API developed by the UnboundID company</td>
+</tr>
+</tbody>
+</table>
+<p>(There may be some more we don't know about)</p>
+<h2 id="features">Features</h2>
+<p>The <a href="user-guide.html">User Guide</a> pages gives the list of
features the API provides.</p>
+
+
+
+                </div><!-- rightColumn -->
+                <div id="endContent"></div>
+            </div><!-- content -->
+            <div id="footer">&copy; 2003-2012, <a href="http://www.apache.org">The
Apache Software Foundation</a> - <a href="./../privacy-policy.html">Privacy Policy</a><br
/>
+                Apache Directory, ApacheDS, Apache Directory Server, Apache Directory Studio,
Apache LDAP API, Apache Triplesec, Triplesec, Apache, the Apache feather logo, and the Apache
Directory project logos are trademarks of The Apache Software Foundation.
+            </div>
+        </div><!-- container -->
+    </body>
+</html>
\ No newline at end of file

Added: websites/staging/directory/trunk/content/api/user-guide.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide.html (added)
+++ websites/staging/directory/trunk/content/api/user-guide.html Fri Nov  2 06:58:00 2012
@@ -0,0 +1,227 @@
+<!DOCTYPE html>
+<!--
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version 2.0
+    (the "License"); you may not use this file except in compliance with
+    the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<html>
+	<head>
+		<title>Users Guide &mdash; Apache Directory</title>
+		
+	    <link href="./../css/common.css" rel="stylesheet" type="text/css">
+	    <link href="./../css/brown.css" rel="stylesheet" type="text/css">
+    
+	</head>
+	<body>
+	    <div id="container">
+            <div id="header">
+                <div id="subProjectsNavBar">
+                    <a href="./../">
+                        
+                        Apache Directory Project
+                        
+                    </a>
+                    &nbsp;|&nbsp;
+                    <a href="./../apacheds">
+                        
+                        ApacheDS
+                        
+                    </a>
+                    &nbsp;|&nbsp;
+                    <a href="./../studio">
+                        
+                        Apache Directory Studio
+                        
+                    </a>
+                    &nbsp;|&nbsp;
+                    <a href="./../api">
+                        
+                        <STRONG>Apache LDAP API</STRONG>
+                        
+                    </a>
+                </div><!-- subProjectsNavBar -->
+            </div><!-- header -->
+            <div id="content">
+                <div id="leftColumn">
+                    
+<div id="navigation">
+    
+    <h5>Latest Downloads</h5>
+    <ul>
+	    <li><a href="./../api/downloads.html">Version 1.0.0-M13</a>&nbsp;&nbsp;<IMG
src="./../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+    </ul>
+    <h5>Getting Started</h5>
+    <ul>
+        <li><a href="./../api/vision.html">Vision</a></li>
+        <li><a href="./../api/java-api.html">Java API</a></li>
+        <li><a href="./../api/groovy-ldap.html">Groovy API</a></li>
+    </ul>
+    <h5>Documentation</h5>
+    <ul>
+	    <li><a href="./../api/five-minutes-tutorial.html">Five minutes tutorial</a></li>
+	    <li><a href="./../api/user-guide.html">User Guide</a></li>
+        <li><a href="./../api/gen-docs/latest/apidocs/">JavaDocs</a></li>
+        <li><a href="./../api/gen-docs/latest/">Generated Reports</a></li>
+        <li><a href="./../api/developer-guide.html">Developer Guide</a></li>
+    </ul>
+    
+    
+    <h5>Support</h5>
+    <ul>
+        <li><a href="./../mailing-lists-and-irc.html">Mailing Lists &amp;
IRC</a></li>
+        <li><a href="./../sources.html">Sources</a></li>
+        <li><a href="./../issue-tracking.html">Issue Tracking</a></li>
+        <li><a href="./../commercial-support.html">Commercial Support</a></li>
+    </ul>
+    <h5>Community</h5>
+    <ul>
+        <li><a href="./../contribute.html">How to Contribute</a></li>
+        <li><a href="./../team.html">Team</a></li>
+        <li><a href="./../original-project-proposal.html">Original Project Proposal</a></li>
+        <li><a href="./../special-thanks.html" class="external-link" rel="nofollow">Special
Thanks</a></li>
+    </ul>
+    <h5>About Apache</h5>
+    <ul>
+        <li><a href="http://www.apache.org/">Apache</a></li>
+        <li><a href="http://www.apache.org/licenses/">License</a></li>
+        <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+        <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+        <li><a href="http://www.apache.org/security/">Security</a></li>
+    </ul>
+    
+</div><!-- navigation -->
+
+                </div><!-- leftColumn -->
+                <div id="rightColumn">
+
+
+
+<h1 id="users-guide">Users guide</h1>
+<p><DIV class="note" markdown="1">
+<strong>Work in progress</strong></p>
+<p>This is a very preliminary version...</p>
+<p>Pages with a (e) at the end of the title are empty pages
+Pages with a (...) ate the end of the title are not completed yet
+Other pages are finished (but may be reviewed)
+</DIV></p>
+<p>This documentation is about the newly LDAP API developped at the Apache Software
Foundation. We expect this API will be a replacement for all the ancient API (<a href="http://www.openldap.org/jldap/">jLdap</a>,
<a href="http://www.mozilla.org/directory/">Mozilla LDAP SDK</a> and <a href="http://www.oracle.com/technetwork/java/jndi/index.html">JNDI</a>).</p>
+<h2 id="about-this-guide">About this guide</h2>
+<p>Getting started. Learn how to use the LDAP API, connect to various LDAP server,
manipulate the data within your directory. </p>
+<h3 id="audience">Audience</h3>
+<p>This guide is primarily for people new to the LDAP API. If you plan to use the API
as is, maybe even for your first LDAP experience, you'll (hopefully) find all information
necessary to do so. Only basic tasks are covered. Learn more about the options you have (and
many other things) in the [Advanced User's Guide].</p>
+<h3 id="feedback-welcome">Feedback welcome!</h3>
+<p>We are quite interested to improve the content of this guide. Feel free to provide
us feedback:
+!email.png! <a href="mailto:users@directory.apache.org">mailto:users@directory.apache.org</a></p>
+<h3 id="table-of-contents">Table of contents</h3>
+<ul>
+<li>
+<p><a href="1-introduction.html">1 - Introduction</a></p>
+<p>Java and LDAP
+LDAP in a few words
+The Apache LDAP API rational
+Preparation to code</p>
+</li>
+</ul>
+<p>Basic LDAP API usage (...)</p>
+<div class="codehilite"><pre><span class="n">Connection</span> <span
class="ow">and</span> <span class="n">disconnection</span>
+<span class="n">Binding</span> <span class="ow">and</span> <span
class="n">unbinding</span> <span class="p">(</span><span class="o">...</span><span
class="p">)</span>
+<span class="n">Searching</span> <span class="p">(</span><span
class="o">...</span><span class="p">)</span>
+<span class="n">Adding</span> <span class="n">entries</span>
+<span class="n">Deleting</span> <span class="n">entries</span>
+<span class="n">Modifying</span> <span class="n">entries</span> <span
class="p">(</span><span class="n">e</span><span class="p">)</span>
+<span class="n">Moving</span> <span class="n">an</span> <span
class="n">renaming</span> <span class="n">entries</span> <span class="p">(</span><span
class="n">e</span><span class="p">)</span>
+<span class="n">Comparing</span> <span class="n">entries</span> <span
class="p">(</span><span class="n">e</span><span class="p">)</span>
+<span class="n">Exception</span> <span class="n">management</span>
<span class="p">(</span><span class="o">...</span><span class="p">)</span>
+</pre></div>
+
+
+<p>Advanced LDAP API usage (...)</p>
+<div class="codehilite"><pre><span class="n">Controls</span> <span
class="p">(</span><span class="o">...</span><span class="p">)</span>
+<span class="n">Extended</span> <span class="n">operations</span>
<span class="p">(</span><span class="n">e</span><span class="p">)</span>
+<span class="n">Referrals</span> <span class="p">(</span><span
class="n">e</span><span class="p">)</span>
+<span class="n">Aliases</span> <span class="p">(</span><span class="n">e</span><span
class="p">)</span>
+<span class="n">LDIF</span><span class="p">,</span> <span class="n">DSML</span>
<span class="p">(</span><span class="o">...</span><span class="p">)</span>
+<span class="n">Abandonning</span> <span class="n">an</span> <span
class="n">operation</span> <span class="p">(</span><span class="n">e</span><span
class="p">)</span>
+<span class="n">Server</span> <span class="n">informations</span>
<span class="p">(</span><span class="n">e</span><span class="p">)</span>
+</pre></div>
+
+
+<p>SchemaManagement (...)</p>
+<div class="codehilite"><pre><span class="n">SchemaManager</span>
<span class="p">(</span><span class="o">...</span><span class="p">)</span>
+<span class="n">AttributeTypes</span> <span class="p">(</span><span
class="n">e</span><span class="p">)</span>
+<span class="n">ObjectClasses</span> <span class="p">(</span><span
class="n">e</span><span class="p">)</span>
+<span class="n">MatchingRules</span> <span class="p">(</span><span
class="n">e</span><span class="p">)</span>
+<span class="n">Syntaxes</span> <span class="p">(</span><span
class="n">e</span><span class="p">)</span>
+<span class="n">NameForms</span> <span class="p">(</span><span
class="n">e</span><span class="p">)</span>
+<span class="n">DITContentRules</span> <span class="p">(</span><span
class="n">e</span><span class="p">)</span>
+<span class="n">DITStructureRules</span> <span class="p">(</span><span
class="n">e</span><span class="p">)</span>
+<span class="n">MatchingRuleUses</span> <span class="p">(</span><span
class="n">e</span><span class="p">)</span>
+</pre></div>
+
+
+<p>LDAP security (e)</p>
+<div class="codehilite"><pre><span class="n">ACI</span> <span
class="ow">and</span> <span class="n">ACLs</span> <span class="p">(</span><span
class="n">e</span><span class="p">)</span>
+<span class="n">SSL</span> <span class="p">(</span><span class="n">e</span><span
class="p">)</span>
+<span class="n">StartTLS</span> <span class="p">(</span><span
class="n">e</span><span class="p">)</span>
+</pre></div>
+
+
+<p>LDAP data structures (...)</p>
+<div class="codehilite"><pre><span class="n">Entry</span>
+<span class="n">Attribute</span>
+<span class="n">Dn</span>
+<span class="n">Rdn</span>
+<span class="n">Ava</span>
+<span class="n">Value</span>
+<span class="n">Modification</span>
+<span class="n">LdifEntry</span>
+<span class="n">LdifControl</span> <span class="p">(</span><span
class="n">e</span><span class="p">)</span>
+<span class="n">Oid</span>
+<span class="n">Csn</span>
+<span class="n">ObjectClass</span> <span class="p">(</span><span
class="n">e</span><span class="p">)</span>
+<span class="n">NameForm</span> <span class="p">(</span><span
class="n">e</span><span class="p">)</span>
+<span class="n">Message</span> <span class="p">(</span><span class="o">...</span><span
class="p">)</span>
+<span class="n">LdapResult</span>
+<span class="n">Referral</span> <span class="p">(</span><span
class="n">e</span><span class="p">)</span>
+<span class="n">Node</span> <span class="p">(</span><span class="n">e</span><span
class="p">)</span>
+<span class="n">LdapUrl</span> <span class="p">(</span><span class="o">...</span><span
class="p">)</span>
+<span class="n">Cursor</span> <span class="p">(</span><span class="n">e</span><span
class="p">)</span>
+<span class="n">AdministrativePoint</span> <span class="p">(</span><span
class="n">e</span><span class="p">)</span>
+<span class="n">Refinment</span> <span class="p">(</span><span
class="n">e</span><span class="p">)</span>
+<span class="n">SubtreeSpecification</span> <span class="p">(</span><span
class="n">e</span><span class="p">)</span>
+<span class="n">AttributeType</span> <span class="p">(</span><span
class="o">...</span><span class="p">)</span>
+<span class="n">DITContentRule</span> <span class="p">(</span><span
class="n">e</span><span class="p">)</span>
+<span class="n">DITStructureRule</span> <span class="p">(</span><span
class="n">e</span><span class="p">)</span>
+<span class="n">LdapSyntax</span> <span class="p">(</span><span
class="n">e</span><span class="p">)</span>
+<span class="n">LdapComparator</span> <span class="p">(</span><span
class="n">e</span><span class="p">)</span>
+<span class="n">Normalizer</span> <span class="p">(</span><span
class="n">e</span><span class="p">)</span>
+<span class="n">SyntaxChecker</span> <span class="p">(</span><span
class="n">e</span><span class="p">)</span>
+<span class="n">MatchingRule</span> <span class="p">(</span><span
class="n">e</span><span class="p">)</span>
+<span class="n">MatchingRuleUse</span> <span class="p">(</span><span
class="n">e</span><span class="p">)</span>
+</pre></div>
+
+
+<p>LDAP related RFCs</p>
+
+
+
+                </div><!-- rightColumn -->
+                <div id="endContent"></div>
+            </div><!-- content -->
+            <div id="footer">&copy; 2003-2012, <a href="http://www.apache.org">The
Apache Software Foundation</a> - <a href="./../privacy-policy.html">Privacy Policy</a><br
/>
+                Apache Directory, ApacheDS, Apache Directory Server, Apache Directory Studio,
Apache LDAP API, Apache Triplesec, Triplesec, Apache, the Apache feather logo, and the Apache
Directory project logos are trademarks of The Apache Software Foundation.
+            </div>
+        </div><!-- container -->
+    </body>
+</html>
\ No newline at end of file

Added: websites/staging/directory/trunk/content/api/user-guide/1-introduction.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/1-introduction.html (added)
+++ websites/staging/directory/trunk/content/api/user-guide/1-introduction.html Fri Nov  2
06:58:00 2012
@@ -0,0 +1,162 @@
+<!DOCTYPE html>
+<!--
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version 2.0
+    (the "License"); you may not use this file except in compliance with
+    the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<html>
+	<head>
+		<title>1 - Introduction &mdash; Apache Directory</title>
+		
+	    <link href="./../../css/common.css" rel="stylesheet" type="text/css">
+	    <link href="./../../css/brown.css" rel="stylesheet" type="text/css">
+    
+	</head>
+	<body>
+	    <div id="container">
+            <div id="header">
+                <div id="subProjectsNavBar">
+                    <a href="./../../">
+                        
+                        Apache Directory Project
+                        
+                    </a>
+                    &nbsp;|&nbsp;
+                    <a href="./../../apacheds">
+                        
+                        ApacheDS
+                        
+                    </a>
+                    &nbsp;|&nbsp;
+                    <a href="./../../studio">
+                        
+                        Apache Directory Studio
+                        
+                    </a>
+                    &nbsp;|&nbsp;
+                    <a href="./../../api">
+                        
+                        <STRONG>Apache LDAP API</STRONG>
+                        
+                    </a>
+                </div><!-- subProjectsNavBar -->
+            </div><!-- header -->
+            <div id="content">
+                <div id="leftColumn">
+                    
+<div id="navigation">
+    
+    <h5>Latest Downloads</h5>
+    <ul>
+	    <li><a href="./../../api/downloads.html">Version 1.0.0-M13</a>&nbsp;&nbsp;<IMG
src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+    </ul>
+    <h5>Getting Started</h5>
+    <ul>
+        <li><a href="./../../api/vision.html">Vision</a></li>
+        <li><a href="./../../api/java-api.html">Java API</a></li>
+        <li><a href="./../../api/groovy-ldap.html">Groovy API</a></li>
+    </ul>
+    <h5>Documentation</h5>
+    <ul>
+	    <li><a href="./../../api/five-minutes-tutorial.html">Five minutes tutorial</a></li>
+	    <li><a href="./../../api/user-guide.html">User Guide</a></li>
+        <li><a href="./../../api/gen-docs/latest/apidocs/">JavaDocs</a></li>
+        <li><a href="./../../api/gen-docs/latest/">Generated Reports</a></li>
+        <li><a href="./../../api/developer-guide.html">Developer Guide</a></li>
+    </ul>
+    
+    
+    <h5>Support</h5>
+    <ul>
+        <li><a href="./../../mailing-lists-and-irc.html">Mailing Lists &amp;
IRC</a></li>
+        <li><a href="./../../sources.html">Sources</a></li>
+        <li><a href="./../../issue-tracking.html">Issue Tracking</a></li>
+        <li><a href="./../../commercial-support.html">Commercial Support</a></li>
+    </ul>
+    <h5>Community</h5>
+    <ul>
+        <li><a href="./../../contribute.html">How to Contribute</a></li>
+        <li><a href="./../../team.html">Team</a></li>
+        <li><a href="./../../original-project-proposal.html">Original Project
Proposal</a></li>
+        <li><a href="./../../special-thanks.html" class="external-link" rel="nofollow">Special
Thanks</a></li>
+    </ul>
+    <h5>About Apache</h5>
+    <ul>
+        <li><a href="http://www.apache.org/">Apache</a></li>
+        <li><a href="http://www.apache.org/licenses/">License</a></li>
+        <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+        <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+        <li><a href="http://www.apache.org/security/">Security</a></li>
+    </ul>
+    
+</div><!-- navigation -->
+
+                </div><!-- leftColumn -->
+                <div id="rightColumn">
+
+
+    <div class="nav">
+        <div class="nav_prev">
+        
+			&nbsp;
+        
+        </div>
+        <div class="nav_up">
+        
+            <a href="../user-guide.html">User Guide</a>
+		
+        </div>
+        <div class="nav_next">
+        
+            <a href="2-basic-ldap-api-usage.html">2 - Basic LDAP API Usage</a>
+		
+        </div>
+        <div class="clearfix"></div>
+    </div>
+
+
+<h1 id="1-introduction">1 - Introduction</h1>
+<p>This User Guide goal is to provide some clue for any developer wanting to use the
LDAP API. We have mixed some description of each important features with some tested snippet
of code (all of them has been integrated as tests in the API code).</p>
+<p>We hope it will be enough for you to quickly get started, but in any case, if you
feel like improving this document, feel free to post your suggestion to the Apache Directory
mailing list : any contribution is welcomed !</p>
+
+
+    <div class="nav">
+        <div class="nav_prev">
+        
+			&nbsp;
+        
+        </div>
+        <div class="nav_up">
+        
+            <a href="../user-guide.html">User Guide</a>
+		
+        </div>
+        <div class="nav_next">
+        
+            <a href="2-basic-ldap-api-usage.html">2 - Basic LDAP API Usage</a>
+		
+        </div>
+        <div class="clearfix"></div>
+    </div>
+
+
+                </div><!-- rightColumn -->
+                <div id="endContent"></div>
+            </div><!-- content -->
+            <div id="footer">&copy; 2003-2012, <a href="http://www.apache.org">The
Apache Software Foundation</a> - <a href="./../../privacy-policy.html">Privacy
Policy</a><br />
+                Apache Directory, ApacheDS, Apache Directory Server, Apache Directory Studio,
Apache LDAP API, Apache Triplesec, Triplesec, Apache, the Apache feather logo, and the Apache
Directory project logos are trademarks of The Apache Software Foundation.
+            </div>
+        </div><!-- container -->
+    </body>
+</html>
\ No newline at end of file

Added: websites/staging/directory/trunk/content/api/vision.html
==============================================================================
--- websites/staging/directory/trunk/content/api/vision.html (added)
+++ websites/staging/directory/trunk/content/api/vision.html Fri Nov  2 06:58:00 2012
@@ -0,0 +1,128 @@
+<!DOCTYPE html>
+<!--
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version 2.0
+    (the "License"); you may not use this file except in compliance with
+    the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<html>
+	<head>
+		<title>LDAP API - Vision &mdash; Apache Directory</title>
+		
+	    <link href="./../css/common.css" rel="stylesheet" type="text/css">
+	    <link href="./../css/brown.css" rel="stylesheet" type="text/css">
+    
+	</head>
+	<body>
+	    <div id="container">
+            <div id="header">
+                <div id="subProjectsNavBar">
+                    <a href="./../">
+                        
+                        Apache Directory Project
+                        
+                    </a>
+                    &nbsp;|&nbsp;
+                    <a href="./../apacheds">
+                        
+                        ApacheDS
+                        
+                    </a>
+                    &nbsp;|&nbsp;
+                    <a href="./../studio">
+                        
+                        Apache Directory Studio
+                        
+                    </a>
+                    &nbsp;|&nbsp;
+                    <a href="./../api">
+                        
+                        <STRONG>Apache LDAP API</STRONG>
+                        
+                    </a>
+                </div><!-- subProjectsNavBar -->
+            </div><!-- header -->
+            <div id="content">
+                <div id="leftColumn">
+                    
+<div id="navigation">
+    
+    <h5>Latest Downloads</h5>
+    <ul>
+	    <li><a href="./../api/downloads.html">Version 1.0.0-M13</a>&nbsp;&nbsp;<IMG
src="./../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+    </ul>
+    <h5>Getting Started</h5>
+    <ul>
+        <li><a href="./../api/vision.html">Vision</a></li>
+        <li><a href="./../api/java-api.html">Java API</a></li>
+        <li><a href="./../api/groovy-ldap.html">Groovy API</a></li>
+    </ul>
+    <h5>Documentation</h5>
+    <ul>
+	    <li><a href="./../api/five-minutes-tutorial.html">Five minutes tutorial</a></li>
+	    <li><a href="./../api/user-guide.html">User Guide</a></li>
+        <li><a href="./../api/gen-docs/latest/apidocs/">JavaDocs</a></li>
+        <li><a href="./../api/gen-docs/latest/">Generated Reports</a></li>
+        <li><a href="./../api/developer-guide.html">Developer Guide</a></li>
+    </ul>
+    
+    
+    <h5>Support</h5>
+    <ul>
+        <li><a href="./../mailing-lists-and-irc.html">Mailing Lists &amp;
IRC</a></li>
+        <li><a href="./../sources.html">Sources</a></li>
+        <li><a href="./../issue-tracking.html">Issue Tracking</a></li>
+        <li><a href="./../commercial-support.html">Commercial Support</a></li>
+    </ul>
+    <h5>Community</h5>
+    <ul>
+        <li><a href="./../contribute.html">How to Contribute</a></li>
+        <li><a href="./../team.html">Team</a></li>
+        <li><a href="./../original-project-proposal.html">Original Project Proposal</a></li>
+        <li><a href="./../special-thanks.html" class="external-link" rel="nofollow">Special
Thanks</a></li>
+    </ul>
+    <h5>About Apache</h5>
+    <ul>
+        <li><a href="http://www.apache.org/">Apache</a></li>
+        <li><a href="http://www.apache.org/licenses/">License</a></li>
+        <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+        <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+        <li><a href="http://www.apache.org/security/">Security</a></li>
+    </ul>
+    
+</div><!-- navigation -->
+
+                </div><!-- leftColumn -->
+                <div id="rightColumn">
+
+
+
+<h1 id="vision">Vision</h1>
+<p>When we started to work on replication implementation, we needed a client API in
order to communicate using the LDAP protocol with remote LDAP servers. We could have used
some existing LDAP API, but as we have already defined a lot of base classes we would have
had to convert back and forth, we thought it would be better to build the missing pieces and
define our own complete LDAP API.</p>
+<p>This is one of the reasons we started this sub-project.</p>
+<p>Another reason is that we worked with Sun a few years ago to draw a new version
of JNDI, an aborted effort, sadly. We also have been contacted by the OpenLDAP team as they
wanted to know if we were ready to maintain jLDAP, as it needed some patches, and as they
didn't have enough workforce to do so. Last, not least, OpenDS team is also interested to
see if we can avoid duplication of efforts, as they are also defining an LDAP API.</p>
+<p>All those events make it interesting to try to find a common way to define a new
LDAP API, gathering the interest of the largest developer base possible.</p>
+<p>As we have not finished to implement all the needed features, it's easy for us to
try to figure which parts can be shared with other projects, and which parts must be configurable.
A clear example is the underlying network layer: OpenDS will use Grizzly, while we will use
MINA. This should be transparent for developers.</p>
+<p>Last, not least, no one can claim to be better than all the other great people out
there, and claim to be able to define the best possible API. We at The ASF believe that collaboration
within a community is better than working alone. We are pleased to share what we have already
done, ready to move forward in better directions if it allows the API to be more reliable,
usable and at the end, easier to use for devlopers.</p>
+
+
+
+                </div><!-- rightColumn -->
+                <div id="endContent"></div>
+            </div><!-- content -->
+            <div id="footer">&copy; 2003-2012, <a href="http://www.apache.org">The
Apache Software Foundation</a> - <a href="./../privacy-policy.html">Privacy Policy</a><br
/>
+                Apache Directory, ApacheDS, Apache Directory Server, Apache Directory Studio,
Apache LDAP API, Apache Triplesec, Triplesec, Apache, the Apache feather logo, and the Apache
Directory project logos are trademarks of The Apache Software Foundation.
+            </div>
+        </div><!-- container -->
+    </body>
+</html>
\ No newline at end of file



Mime
View raw message