You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@directory.apache.org by bu...@apache.org on 2015/07/06 00:34:38 UTC
svn commit: r957126 [10/18] - in /websites/staging/directory/trunk/content:
./ apacheds/ apacheds/advanced-ug/ apacheds/basic-ug/
apacheds/configuration/ apacheds/kerberos-ug/ api/ api/download/
api/groovy-api/ api/user-guide/ escimo/ fortress/ fortres...
Modified: websites/staging/directory/trunk/content/api/user-guide/2.11-filter-builder.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/2.11-filter-builder.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/2.11-filter-builder.html Sun Jul 5 22:34:35 2015
@@ -104,7 +104,7 @@
</ul>
<h5>Downloads</h5>
<ul>
- <li><a href="./../../api/downloads.html">Version 1.0.0-M30</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+ <li><a href="./../../api/downloads.html">Version 1.0.0-M31</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
<li><a href="./../../api/download-old-versions.html">Older versions</a></li>
</ul>
<h5>Getting Started</h5>
@@ -173,7 +173,18 @@
</div>
-<h1 id="211-the-filterbuildere">2.11 - The FilterBuilder(e)</h1>
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+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="211-the-filterbuildere">2.11 - The FilterBuilder(e)<a class="headerlink" href="#211-the-filterbuildere" title="Permanent link">¶</a></h1>
<p>This class is a builder for constructing well formed search filters according to <a href="https://tools.ietf.org/html/rfc4515.html">RFC 4515</a>. This builder is most convenient when you use static imports. For example:</p>
<div class="codehilite"><pre> <span class="n">import</span> <span class="n">static</span> <span class="n">org</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">directory</span><span class="p">.</span><span class="n">ldap</span><span class="p">.</span><span class="n">client</span><span class="p">.</span><span class="n">api</span><span class="p">.</span><span class="n">search</span><span class="p">.</span><span class="n">FilterBuilder</span><span class="p">.</span><span class="n">and</span><span class="p">;</span>
<span class="n">import</span> <span class="n">static</span> <span class="n">org</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">directory</span><span class="p">.</span><span class="n">ldap</span><span class="p">.</span><span class="n">client</span><span class="p">.</span><span class="n">api</span><span class="p">.</span><span class="n">search</span><span class="p">.</span><span class="n">FilterBuilder</span><span class="p">.</span><span class="n">equal</span><span class="p">;</span>
@@ -193,7 +204,7 @@
</pre></div>
-<h2 id="and-filter">And filter</h2>
+<h2 id="and-filter">And filter<a class="headerlink" href="#and-filter" title="Permanent link">¶</a></h2>
<p>Returns a new FilterBuilder that will & together all of the supplied filters. For example:</p>
<div class="codehilite"><pre><span class="n">and</span><span class="p">(</span> <span class="n">equal</span><span class="p">(</span> "<span class="n">givenName</span>"<span class="p">,</span> "<span class="n">kermit</span>" <span class="p">),</span> <span class="n">equal</span><span class="p">(</span> "<span class="n">sn</span>"<span class="p">,</span> "<span class="n">the</span> <span class="n">frog</span>" <span class="p">)</span> <span class="p">).</span><span class="n">toString</span><span class="p">()</span>
</pre></div>
@@ -201,7 +212,7 @@
<p>would result in the string: <em>(&(givenName=kermit)(sn=the frog))</em></p>
<p>Which would match all entries with a given name of kermit and a surname the frog.</p>
-<h2 id="or-filter">Or filter</h2>
+<h2 id="or-filter">Or filter<a class="headerlink" href="#or-filter" title="Permanent link">¶</a></h2>
<p>Returns a new FilterBuilder that will | together all of the supplied filters. For example:</p>
<div class="codehilite"><pre><span class="n">or</span><span class="p">(</span> <span class="n">equal</span><span class="p">(</span> "<span class="n">givenName</span>"<span class="p">,</span> "<span class="n">kermit</span>" <span class="p">),</span> <span class="n">equal</span><span class="p">(</span> "<span class="n">givenName</span>"<span class="p">,</span> "<span class="n">walter</span>" <span class="p">)</span> <span class="p">).</span><span class="n">toString</span><span class="p">()</span>
</pre></div>
@@ -209,14 +220,14 @@
<p>would result in the string: <em>(|(givenName=kermit)(givenName=walter))</em></p>
<p>Which would match any entry with the givenName of either kermit or walter.</p>
-<h2 id="not-filter">Not filter</h2>
+<h2 id="not-filter">Not filter<a class="headerlink" href="#not-filter" title="Permanent link">¶</a></h2>
<p>Returns a new FilterBuilder for negating another filter. For example:</p>
<div class="codehilite"><pre><span class="n">not</span><span class="p">(</span> <span class="n">present</span><span class="p">(</span> "<span class="n">givenName</span>" <span class="p">)</span> <span class="p">).</span><span class="n">toString</span><span class="p">();</span>
</pre></div>
<p>would result in the string: <em>(!(givenName=*))</em></p>
-<h2 id="present-filter">Present Filter</h2>
+<h2 id="present-filter">Present Filter<a class="headerlink" href="#present-filter" title="Permanent link">¶</a></h2>
<p>Returns a new FilterBuilder for testing the presence of an attributes. For example:</p>
<div class="codehilite"><pre><span class="n">present</span><span class="p">(</span> "<span class="n">givenName</span>" <span class="p">).</span><span class="n">toString</span><span class="p">();</span>
</pre></div>
@@ -224,7 +235,7 @@
<p>would result in the string: <em>(givenName=*)</em></p>
<p>Which would match any entry that has a givenName attribute.</p>
-<h2 id="equal-filter">Equal Filter</h2>
+<h2 id="equal-filter">Equal Filter<a class="headerlink" href="#equal-filter" title="Permanent link">¶</a></h2>
<p>Returns a new FilterBuilder for testing equality of an attribute. For example:</p>
<div class="codehilite"><pre><span class="n">equal</span><span class="p">(</span> "<span class="n">cn</span>"<span class="p">,</span> "<span class="n">Kermit</span> <span class="n">The</span> <span class="n">Frog</span>" <span class="p">).</span><span class="n">toString</span><span class="p">();</span>
</pre></div>
@@ -232,7 +243,7 @@
<p>would result in the string: <em>(cn=Kermit The Frog)</em></p>
<p>Which would match entries with the common name Kermit The Frog. Be careful when using the equal filter as it is an <em>EXACT MATCH</em> filter. While it may seem natural to use * as a wildcard, it will actually be escaped using this filter. If you meant to use a wildcard in your filter, you should use one of <a href="#startswith-filter">startsWith</a>, <a href="#endswith-filter">endsWith</a>, <a href="#contains-filter">contains</a>, or <a href="#substring-filter">substring</a>, .</p>
-<h2 id="extensible-filter">Extensible Filter</h2>
+<h2 id="extensible-filter">Extensible Filter<a class="headerlink" href="#extensible-filter" title="Permanent link">¶</a></h2>
<p>Returns a new FilterBuilder for testing equality using specified matching rules.
For example:</p>
<div class="codehilite"><pre><span class="n">extensible</span><span class="p">(</span> "<span class="n">cn</span>"<span class="p">,</span> "<span class="n">Kermit</span> <span class="n">The</span> <span class="n">Frog</span>" <span class="p">).</span><span class="n">toString</span><span class="p">();</span>
@@ -278,7 +289,7 @@ sensitive matcher even if the name was o
<p>would result in the string: <em>(:1.2.3.4.5.6.7:=Kermit The Frog)</em></p>
<p>Which would match entries with any attribute whose value is Kermit The Frog,
using the <em>hypothetical</em> matching rule indicated by the oid 1.2.3.4.5.6.7.</p>
-<h2 id="less-or-equal-filter">Less Or Equal Filter</h2>
+<h2 id="less-or-equal-filter">Less Or Equal Filter<a class="headerlink" href="#less-or-equal-filter" title="Permanent link">¶</a></h2>
<p>Returns a new FilterBuilder for testing lexicographical less than. For example:</p>
<div class="codehilite"><pre><span class="n">lessThanOrEqual</span><span class="p">(</span> "<span class="n">sn</span>"<span class="p">,</span> "<span class="n">mzzzzzz</span>" <span class="p">).</span><span class="n">toString</span><span class="p">();</span>
</pre></div>
@@ -286,7 +297,7 @@ using the <em>hypothetical</em> matching
<p>would result in the string: <em>(sn<=mzzzzzz)</em></p>
<p>which would match results whose surname starts with the first half of the alphabet. Note, this is not perfect, but if you know anybody with a last name that starts with an <em>m</em> followed by six _z's__...</p>
-<h2 id="greater-or-equal-filter">Greater Or Equal Filter</h2>
+<h2 id="greater-or-equal-filter">Greater Or Equal Filter<a class="headerlink" href="#greater-or-equal-filter" title="Permanent link">¶</a></h2>
<p>Returns a new FilterBuilder for testing lexicographical greater than. For example:</p>
<div class="codehilite"><pre><span class="n">greaterThanOrEqual</span><span class="p">(</span> "<span class="n">sn</span>"<span class="p">,</span> "<span class="n">n</span>" <span class="p">).</span><span class="n">toString</span><span class="p">();</span>
</pre></div>
@@ -294,7 +305,7 @@ using the <em>hypothetical</em> matching
<p>would result in the string: <em>(sn>=n)</em></p>
<p>which would match results whose surname starts with the second half of the alphabet.</p>
-<h2 id="approximate-filter">Approximate Filter</h2>
+<h2 id="approximate-filter">Approximate Filter<a class="headerlink" href="#approximate-filter" title="Permanent link">¶</a></h2>
<p>Returns a new FilterBuilder for testing the approximate equality of an attribute. For example:</p>
<div class="codehilite"><pre><span class="n">approximatelyEqual</span><span class="p">(</span> "<span class="n">l</span>"<span class="p">,</span> "<span class="n">san</span> <span class="n">fransico</span>" <span class="p">).</span><span class="n">toString</span><span class="p">();</span>
</pre></div>
@@ -302,7 +313,7 @@ using the <em>hypothetical</em> matching
<p>would result in the string: <em>(l~=san fransico)</em></p>
<p>Which MIGHT match results whose locality is San Francisco. The matching rule used to apply this filter is dependent on the server implementation.</p>
-<h2 id="startswith-filter">StartsWith Filter</h2>
+<h2 id="startswith-filter">StartsWith Filter<a class="headerlink" href="#startswith-filter" title="Permanent link">¶</a></h2>
<p>Returns a new FilterBuilder that will construct a SubString filter with an initial part, zero or more any parts, but no final part. For instance:</p>
<div class="codehilite"><pre><span class="n">startsWith</span><span class="p">(</span> "<span class="n">sn</span>"<span class="p">,</span> "<span class="n">Th</span>"<span class="p">,</span> "<span class="n">Soft</span>"<span class="p">,</span> "<span class="n">Foun</span>" <span class="p">)).</span><span class="n">toString</span><span class="p">()</span>
</pre></div>
@@ -310,7 +321,7 @@ using the <em>hypothetical</em> matching
<p>would result in the string: <em>(sn=Th*Soft*Foun*)</em></p>
<p>Which would match any entry with an sn starting with the string 'Th', followed by 'Soft', then 'Foun', like 'The Apache Software Foundation'.</p>
-<h2 id="endswith-filter">EndsWith Filter</h2>
+<h2 id="endswith-filter">EndsWith Filter<a class="headerlink" href="#endswith-filter" title="Permanent link">¶</a></h2>
<p>Returns a new FilterBuilder that will construct a SubString filter with no initial part, zero or more any parts, and a final part. For instance:</p>
<div class="codehilite"><pre><span class="n">endsWith</span><span class="p">(</span> "<span class="n">sn</span>"<span class="p">,</span> "<span class="n">Soft</span>"<span class="p">,</span> "<span class="n">Foun</span>"<span class="p">,</span> "<span class="n">ion</span>" <span class="p">)).</span><span class="n">toString</span><span class="p">()</span>
</pre></div>
@@ -318,7 +329,7 @@ using the <em>hypothetical</em> matching
<p>would result in the string: <em>(sn=*Soft*Foun*ion)</em></p>
<p>Which would match any entry with an sn containing the string 'Soft' followed by 'Foun' ending in 'ion', like 'The Apache Software Foundation'.</p>
-<h2 id="contains-filter">Contains Filter</h2>
+<h2 id="contains-filter">Contains Filter<a class="headerlink" href="#contains-filter" title="Permanent link">¶</a></h2>
<p>Returns a new FilterBuilder that will construct a SubString filter with no initial part, zero or more any parts, and no final part. For instance:</p>
<div class="codehilite"><pre><span class="n">contains</span><span class="p">(</span> "<span class="n">sn</span>"<span class="p">,</span> "<span class="n">Soft</span>"<span class="p">,</span> "<span class="n">Foun</span>" <span class="p">)).</span><span class="n">toString</span><span class="p">()</span>
</pre></div>
@@ -326,7 +337,7 @@ using the <em>hypothetical</em> matching
<p>would result in the string: <em>(sn=*Soft*Foun*)</em></p>
<p>Which would match any entry with an sn containing the string 'Soft' followed by 'Foun', like 'The Apache Software Foundation'.</p>
-<h2 id="substring-filter">Substring Filter</h2>
+<h2 id="substring-filter">Substring Filter<a class="headerlink" href="#substring-filter" title="Permanent link">¶</a></h2>
<p>Returns a new FilterBuilder that will construct a SubString filter with an initial part, zero or more any parts, and a final part. For instance:</p>
<div class="codehilite"><pre><span class="n">substring</span><span class="p">(</span> "<span class="n">sn</span>"<span class="p">,</span> "<span class="n">The</span>"<span class="p">,</span> "<span class="n">Soft</span>"<span class="p">,</span> "<span class="n">Foun</span>"<span class="p">,</span> "<span class="n">ion</span>" <span class="p">)).</span><span class="n">toString</span><span class="p">()</span>
</pre></div>
Modified: websites/staging/directory/trunk/content/api/user-guide/2.2-binding-unbinding.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/2.2-binding-unbinding.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/2.2-binding-unbinding.html Sun Jul 5 22:34:35 2015
@@ -104,7 +104,7 @@
</ul>
<h5>Downloads</h5>
<ul>
- <li><a href="./../../api/downloads.html">Version 1.0.0-M30</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+ <li><a href="./../../api/downloads.html">Version 1.0.0-M31</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
<li><a href="./../../api/download-old-versions.html">Older versions</a></li>
</ul>
<h5>Getting Started</h5>
@@ -173,13 +173,24 @@
</div>
-<h1 id="22-binding-and-unbinding">2.2 - Binding and unbinding (...)</h1>
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+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="22-binding-and-unbinding">2.2 - Binding and unbinding (...)<a class="headerlink" href="#22-binding-and-unbinding" title="Permanent link">¶</a></h1>
<p>In <strong>LDAP</strong>, if one wants to access the data in the base, the common way to do it is to bind on the server. However, it's important to understand that binding is a different beast than connection.</p>
<p>Creating a connection to a <strong>LDAP</strong> server is just about opening a socket between the client and the server. You just need to provide the address and the port. </p>
<p>The <strong>bind</strong> operation, on the other hand, create a <em>Session</em> which will hold some user's information for the time being of the session. Those information are quite limited, they include the user's credentials.</p>
<p>But it's important to know that it's possible to bind as anonymous, providing no name and password, and still be able to request the server (note though that the server can forbid such anonymous bind).</p>
<p>Once the user has finished to request the server, then he can unbind, destroying his session on the server. That does not close the connection, because, one more time, <em>bind != connection</em>.</p>
-<h2 id="binding">Binding</h2>
+<h2 id="binding">Binding<a class="headerlink" href="#binding" title="Permanent link">¶</a></h2>
<p>You have two possible types of binds in <em>LDAP</em> :</p>
<ul>
<li><strong>Simple</strong></li>
@@ -187,7 +198,7 @@
</ul>
<p>The first one is based on a user/password being send to the server, which check that they are valid. It's also possible to proceed an Anonymous bind explicitly.</p>
<p>The second one is more complex, and is used if you want to proceed an authentication with some specific mechanism, like <strong>DIGEST-MD5</strong>, <strong>Kerberos</strong> or certificate based.</p>
-<h3 id="simple-bind">Simple Bind</h3>
+<h3 id="simple-bind">Simple Bind<a class="headerlink" href="#simple-bind" title="Permanent link">¶</a></h3>
<p>One can issue three kind of Simple bind :
<em> <em>anonymous bind</em></em> <em>name/password bind</em>
* <em>unauthenticated authentication bind</em></p>
@@ -225,9 +236,9 @@
</pre></div>
-<h3 id="sasl-bind">SASL Bind</h3>
+<h3 id="sasl-bind">SASL Bind<a class="headerlink" href="#sasl-bind" title="Permanent link">¶</a></h3>
<p>TO BE COMPLETED</p>
-<h3 id="unbinding">Unbinding</h3>
+<h3 id="unbinding">Unbinding<a class="headerlink" href="#unbinding" title="Permanent link">¶</a></h3>
<p>This is a trivial operation : you just send an <strong>UnbindRequest</strong> to the server, which will invalidate your session. </p>
<p>It's important to know that when you issue an <strong>Unbind</strong>, the connection is dropped. However, if you immediately try another bind, the <strong>API</strong> will open the connection again, using the information provided when the connection has been created. You can then do such a thing :</p>
<div class="codehilite"><pre><span class="nd">@Test</span>
Modified: websites/staging/directory/trunk/content/api/user-guide/2.3-searching.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/2.3-searching.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/2.3-searching.html Sun Jul 5 22:34:35 2015
@@ -104,7 +104,7 @@
</ul>
<h5>Downloads</h5>
<ul>
- <li><a href="./../../api/downloads.html">Version 1.0.0-M30</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+ <li><a href="./../../api/downloads.html">Version 1.0.0-M31</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
<li><a href="./../../api/download-old-versions.html">Older versions</a></li>
</ul>
<h5>Getting Started</h5>
@@ -173,10 +173,21 @@
</div>
-<h1 id="23-searching">2.3 - Searching (...)</h1>
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+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="23-searching">2.3 - Searching (...)<a class="headerlink" href="#23-searching" title="Permanent link">¶</a></h1>
<p>Searching is the most important operation in <strong>LDAP</strong>. It has to be fast, very fast. On the other hand, as the server does not a lot of processing while looking for entries, the client has to provide many information in order to get some accurate results.</p>
<p>The idea is to define a search <strong>API</strong> which is easy to use in the simplest cases, but provides all the necessary bolts if you need to send complex search requests.</p>
-<h2 id="simple-search">Simple search</h2>
+<h2 id="simple-search">Simple search<a class="headerlink" href="#simple-search" title="Permanent link">¶</a></h2>
<p>Let's first look at a simple search. What we basically need to process a search is a starting point in the tree, a filter, a scope. Here is an example :</p>
<div class="codehilite"><pre><span class="n">EntryCursor</span> <span class="n">cursor</span> <span class="o">=</span> <span class="n">connection</span><span class="o">.</span><span class="na">search</span><span class="o">(</span> <span class="s">"ou=system"</span><span class="o">,</span> <span class="s">"(objectclass=*)"</span><span class="o">,</span> <span class="n">SearchScope</span><span class="o">.</span><span class="na">ONELEVEL</span> <span class="o">);</span>
@@ -198,7 +209,7 @@
<blockquote>
<p><strong>Note</strong> Don't forget to close the cursor, otherwise the associated data will remain in memory foreever !</p>
</blockquote>
-<h3 id="searching-using-a-dn">Searching using a DN</h3>
+<h3 id="searching-using-a-dn">Searching using a DN<a class="headerlink" href="#searching-using-a-dn" title="Permanent link">¶</a></h3>
<p>In the previous sample, we used a String to define the starting point of the search. Sometime, you will find it more convenient to start a search using a DN (for instance because you got back a DN from an other operation). In this case, no need to transform the DN into a String before doing your search : simply use the DN !</p>
<div class="codehilite"><pre><span class="n">DN</span> <span class="n">systemDn</span> <span class="o">=</span> <span class="k">new</span> <span class="n">Dn</span><span class="o">(</span> <span class="s">"ou=system"</span> <span class="o">);</span>
<span class="o">...</span>
@@ -216,12 +227,12 @@
<p>This is it !</p>
-<h3 id="scope">Scope</h3>
+<h3 id="scope">Scope<a class="headerlink" href="#scope" title="Permanent link">¶</a></h3>
<p>There are three different different scopes you can use to search for data :
* SearchScope.OBJECT : you will just get back the entry for the given DN, if it exists. Note that you could use a lookup if the filter is irrelevent.
* SearchScope.ONELEVEL : you will get back all the elements just under the current DN, but not the element associated with the DN.
* SearchScope.SUBLEVEL : you will get back all the elements starting from the given DN, including the element associated with the DN, whatever the depth of the tree.</p>
-<h3 id="filter">Filter</h3>
+<h3 id="filter">Filter<a class="headerlink" href="#filter" title="Permanent link">¶</a></h3>
<p>The filter is used to define the elements that will be selected. There are various possibilities to construct a filter, using one or more connectors,a nd one or more expression nodes.</p>
<p>Connrectors are using a prefix notation, followed by as many expression node as necessary, like in (& (node1) (node2) ... (nodeN))</p>
<p>Expression nodes are always contane din parenthesis, with a left part - the attributeType and a right part - the value -.</p>
@@ -244,7 +255,7 @@
<blockquote>
<p><strong>Note:</strong> As of Apache DS 2.0, we don't support approx matches not extensible matches.</p>
</blockquote>
-<h2 id="more-complex-searches">More complex searches</h2>
+<h2 id="more-complex-searches">More complex searches<a class="headerlink" href="#more-complex-searches" title="Permanent link">¶</a></h2>
<p>Sometime, you way want to have more control on the search opetation, either on the parameters you want to use, or on the results you get.</p>
<p>A search can return something else than an entry. In fact, you can get three different kind of response</p>
<div class="codehilite"><pre><span class="o">*</span> <span class="n">When</span> <span class="n">it</span><span class="o">'</span><span class="n">s</span> <span class="n">done</span><span class="p">,</span> <span class="n">you</span> <span class="n">will</span> <span class="n">receive</span> <span class="n">a</span> <span class="n">SearchResultDone</span>
Modified: websites/staging/directory/trunk/content/api/user-guide/2.4-adding.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/2.4-adding.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/2.4-adding.html Sun Jul 5 22:34:35 2015
@@ -104,7 +104,7 @@
</ul>
<h5>Downloads</h5>
<ul>
- <li><a href="./../../api/downloads.html">Version 1.0.0-M30</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+ <li><a href="./../../api/downloads.html">Version 1.0.0-M31</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
<li><a href="./../../api/download-old-versions.html">Older versions</a></li>
</ul>
<h5>Getting Started</h5>
@@ -173,9 +173,20 @@
</div>
-<h1 id="24-adding-entries">2.4 - Adding entries</h1>
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+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="24-adding-entries">2.4 - Adding entries<a class="headerlink" href="#24-adding-entries" title="Permanent link">¶</a></h1>
<p>Adding entries is one of the base operation a user can do on a <strong>LDAP</strong> server. Nevertheless, such an operation implies a lot of checks, and frequently the user gets some weird error messages. We will see how we can add an entry using the <strong>LDAP API</strong>, and then analyze the different error cases we can face.</p>
-<h2 id="adding-an-entry">Adding an entry</h2>
+<h2 id="adding-an-entry">Adding an entry<a class="headerlink" href="#adding-an-entry" title="Permanent link">¶</a></h2>
<p>We will first see the easiest way to add an entry into the server, assuming that the entry is correct. In order to add an entry, you only have to provide the place where this entry will be stored (its <em>Dn</em>) and the list of its <em>Attributes</em>.</p>
<p>Here is two examples where we inject the entry using <strong>LDIF</strong> :</p>
<div class="codehilite"><pre><span class="nd">@Test</span>
@@ -225,7 +236,7 @@ Note that it is possible to use some var
<p>Down the line, what is important is that the <em>add()</em> operation is taking a full <strong><a href="6.12-entry.html">Entry</a></strong>. </p>
<p>We can also create the <strong><a href="6.12-entry.html">Entry</a></strong> in a different way, which will be exposed in the following paragraphs.</p>
-<h2 id="sending-an-addrequest">Sending an <em>AddRequest</em></h2>
+<h2 id="sending-an-addrequest">Sending an <em>AddRequest</em><a class="headerlink" href="#sending-an-addrequest" title="Permanent link">¶</a></h2>
<p>Sometimes, we want more control. We can ask the server to add an entry by sending an <strong><a href="">AddRequest</a></strong>, which allows you to send a <strong><a href="">Control</a></strong> at the same time.</p>
<p>Here is an example (note that the control is just injected to demonstrate the feature, it simply does nothing in this case):</p>
<div class="codehilite"><pre><span class="nd">@Test</span>
@@ -255,7 +266,7 @@ Note that it is possible to use some var
</pre></div>
-<h3 id="asynchronous-addition">Asynchronous addition</h3>
+<h3 id="asynchronous-addition">Asynchronous addition<a class="headerlink" href="#asynchronous-addition" title="Permanent link">¶</a></h3>
<p>Some may want to add an entry, but will not check the result immediately. It's just a matter of calling the <em>addAsync()</em> method, which will return a <em>Future</em> that can be checked somewhere else in the code:</p>
<div class="codehilite"><pre><span class="nd">@Test</span>
<span class="kd">public</span> <span class="kt">void</span> <span class="nf">testAddAsyncLdif</span><span class="o">()</span> <span class="kd">throws</span> <span class="n">Exception</span>
@@ -284,7 +295,7 @@ Note that it is possible to use some var
</pre></div>
-<h2 id="do-dont">Do, Don't</h2>
+<h2 id="do-dont">Do, Don't<a class="headerlink" href="#do-dont" title="Permanent link">¶</a></h2>
<p>Successfully adding an entry assume that the entry is correct, ie that the attributes and the value are compatible with the schema. There are many things checked by the server. Here is a list of constraints that you should respect in order to get your entry injected:</p>
<ul>
<li>The entry must have at least one <strong>Structural</strong> <em>ObjectClass</em></li>
@@ -298,7 +309,7 @@ Note that it is possible to use some var
</ul>
<p>There are also some other constraints, depending on the server, if it implements <em>NameForms</em>, <em>DITStructureRules</em> or <em>DITContentRules</em>.</p>
<p>One other reason your entry can be rejected is that you don't have enough privilege to add it. You have to check that the server configuration allows you to add an entry where you want to add it.</p>
-<h2 id="errors">Errors</h2>
+<h2 id="errors">Errors<a class="headerlink" href="#errors" title="Permanent link">¶</a></h2>
<DIV class="note" markdown="1">
At first, you might expect to get an exception if the entry addition has failed. If the server is rejecting the addition, *you will get NO exception*. Exceptions are only thrown client side if the entry is not built correctly, or if the connection is not opened.
Modified: websites/staging/directory/trunk/content/api/user-guide/2.5-deleting.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/2.5-deleting.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/2.5-deleting.html Sun Jul 5 22:34:35 2015
@@ -104,7 +104,7 @@
</ul>
<h5>Downloads</h5>
<ul>
- <li><a href="./../../api/downloads.html">Version 1.0.0-M30</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+ <li><a href="./../../api/downloads.html">Version 1.0.0-M31</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
<li><a href="./../../api/download-old-versions.html">Older versions</a></li>
</ul>
<h5>Getting Started</h5>
@@ -173,9 +173,20 @@
</div>
-<h1 id="25-deleting-entries">2.5 - Deleting entries</h1>
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+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="25-deleting-entries">2.5 - Deleting entries<a class="headerlink" href="#25-deleting-entries" title="Permanent link">¶</a></h1>
<p>Deleting an entry is really easy. It's just a matter to know its <em>DN</em>. There is one important thing to understand though : if this entry has some children, it won't be deleted.</p>
-<h2 id="simple-entry-deletion">Simple entry deletion</h2>
+<h2 id="simple-entry-deletion">Simple entry deletion<a class="headerlink" href="#simple-entry-deletion" title="Permanent link">¶</a></h2>
<p>We can ask the deletion by providing the entry's <em>DN</em>, like what is done in the following example :</p>
<div class="codehilite"><pre><span class="nd">@Test</span>
<span class="kd">public</span> <span class="kt">void</span> <span class="nf">testDeleteLeafNode</span><span class="o">()</span> <span class="kd">throws</span> <span class="n">Exception</span>
@@ -206,7 +217,7 @@
</pre></div>
-<h2 id="recursive-deletion-of-entries">Recursive deletion of entries</h2>
+<h2 id="recursive-deletion-of-entries">Recursive deletion of entries<a class="headerlink" href="#recursive-deletion-of-entries" title="Permanent link">¶</a></h2>
<p>Usually, you can't delete an entry and all of its children. However, some server accept such a request if you send a delete request and a TreeDelete control. This control is a <a href="http://tools.ietf.org/html/draft-armijo-ldap-treedelete-02">draft</a>, which has been implemented by <strong>Microsoft</strong>, <strong>OpenDS</strong>, <strong>OpenDJ</strong>. It will delete all the children and the entry itself. We don't use a normal <em>delete()</em> method, there is a specific method, <em>deleteTree()</em>. Here is an example :</p>
<div class="codehilite"><pre><span class="nd">@Test</span>
<span class="kd">public</span> <span class="kt">void</span> <span class="nf">testDeleteWithCascadeControl</span><span class="o">()</span> <span class="kd">throws</span> <span class="n">Exception</span>
@@ -223,7 +234,7 @@
</pre></div>
-<h2 id="sending-a-deleterequest-with-a-control">Sending a DeleteRequest with a control</h2>
+<h2 id="sending-a-deleterequest-with-a-control">Sending a DeleteRequest with a control<a class="headerlink" href="#sending-a-deleterequest-with-a-control" title="Permanent link">¶</a></h2>
<p>It's also possible to associate a <strong>[Control]</strong> with the delete request. In order to do that, you have to create a <em>DelRequest</em> instance. In the following example, we will add the Delete Tree control (this make this call equivalent to the <em>deleteTree()</em> method).</p>
<div class="codehilite"><pre><span class="nd">@Test</span>
<span class="kd">public</span> <span class="kt">void</span> <span class="nf">testDeleteWithControl</span><span class="o">()</span> <span class="kd">throws</span> <span class="n">Exception</span>
@@ -247,7 +258,7 @@
</pre></div>
-<h2 id="asynchronous-delete">Asynchronous delete</h2>
+<h2 id="asynchronous-delete">Asynchronous delete<a class="headerlink" href="#asynchronous-delete" title="Permanent link">¶</a></h2>
<p>You can also decide to send an asynchronous delete request : the method will return a Future that you can check later. You have to construct a <strong>[DeleteRequest]</strong> instance. Here is an example :</p>
<div class="codehilite"><pre><span class="nd">@Test</span>
<span class="kd">public</span> <span class="kt">void</span> <span class="nf">testDeleteAsync</span><span class="o">()</span> <span class="kd">throws</span> <span class="n">Exception</span>
Modified: websites/staging/directory/trunk/content/api/user-guide/2.6-modifying.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/2.6-modifying.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/2.6-modifying.html Sun Jul 5 22:34:35 2015
@@ -104,7 +104,7 @@
</ul>
<h5>Downloads</h5>
<ul>
- <li><a href="./../../api/downloads.html">Version 1.0.0-M30</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+ <li><a href="./../../api/downloads.html">Version 1.0.0-M31</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
<li><a href="./../../api/download-old-versions.html">Older versions</a></li>
</ul>
<h5>Getting Started</h5>
@@ -173,10 +173,21 @@
</div>
-<h1 id="26-modifying-entries">2.6 - Modifying entries</h1>
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+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="26-modifying-entries">2.6 - Modifying entries<a class="headerlink" href="#26-modifying-entries" title="Permanent link">¶</a></h1>
<p>There are several ways an entry can be modified. Mainly, it's about adding or deleting an attribute, or it's about modifying the values associated with an existing attribute.</p>
<p>It's important to understand that many modifications can be applied on a single entry. All those modifications will be applied in a all or none fashion. For instance, if any of the modifications is invalid, then none of the modifications will be applied. Also if the server crashes while applying the modifications, it's guaranteed that the entry will remain consistent.</p>
-<h2 id="how-it-works">How it works ?</h2>
+<h2 id="how-it-works">How it works ?<a class="headerlink" href="#how-it-works" title="Permanent link">¶</a></h2>
<p>Each modification to be applied on an entry is encapsulated in an intermediate class : a <em>Modification</em> instance, which can be created as :</p>
<div class="codehilite"><pre><span class="n">Modification</span> <span class="n">addedGivenName</span> <span class="o">=</span> <span class="k">new</span> <span class="n">DefaultModification</span><span class="o">(</span> <span class="n">ModificationOperation</span><span class="o">.</span><span class="na">ADD_ATTRIBUTE</span><span class="o">,</span> <span class="s">"givenName"</span><span class="o">,</span> <span class="s">"John"</span><span class="o">,</span> <span class="s">"Peter"</span> <span class="o">);</span>
</pre></div>
@@ -189,9 +200,9 @@
<li>ModificationOperation.REMOVE_ATTRIBUTE : remove an attribute and values from an entry</li>
<li>ModificationOperation.REPLACE_ATTRIBUTE : replace some existing values from an entry</li>
</ul>
-<h2 id="adding-or-removing-full-attributes">Adding or removing full attributes</h2>
+<h2 id="adding-or-removing-full-attributes">Adding or removing full attributes<a class="headerlink" href="#adding-or-removing-full-attributes" title="Permanent link">¶</a></h2>
<p>The two following operations are dealing with complete addition or removal of attributes.</p>
-<h3 id="adding-new-attributes">Adding new attributes</h3>
+<h3 id="adding-new-attributes">Adding new attributes<a class="headerlink" href="#adding-new-attributes" title="Permanent link">¶</a></h3>
<p>First of all, let's see how we proceed when it comes to adding an attribute. You need to know the entry you want to modify, which means you have to know its Dn. Then, you have to create the <em>Modification</em> instance that will be applied on the entry. Here is the code that is used to add a <em>givenName</em> attribute to an existing entry :</p>
<div class="codehilite"><pre><span class="o">...</span>
<span class="n">Modification</span> <span class="n">addedGivenName</span> <span class="o">=</span> <span class="k">new</span> <span class="n">DefaultModification</span><span class="o">(</span> <span class="n">ModificationOperation</span><span class="o">.</span><span class="na">ADD_ATTRIBUTE</span><span class="o">,</span> <span class="s">"givenName"</span><span class="o">,</span>
@@ -202,7 +213,7 @@
</pre></div>
-<h4 id="adding-more-than-one-attribute">Adding more than one attribute</h4>
+<h4 id="adding-more-than-one-attribute">Adding more than one attribute<a class="headerlink" href="#adding-more-than-one-attribute" title="Permanent link">¶</a></h4>
<p>What if you want to apply more than one modification to the entry ?</p>
<p>Easy : create more than one <em>Modification</em> instance, and add them before calling the <em>modify</em> method :</p>
<div class="codehilite"><pre><span class="o">...</span>
@@ -217,7 +228,7 @@
<p>You can add as many <em>Modification</em> instances as needed.</p>
-<h4 id="errors">Errors</h4>
+<h4 id="errors">Errors<a class="headerlink" href="#errors" title="Permanent link">¶</a></h4>
<p>If you try to add an attribute that already exists, you will get an error, like this one :</p>
<div class="codehilite"><pre><span class="o">...</span>
<span class="n">Modification</span> <span class="n">addedGivenName</span> <span class="o">=</span> <span class="k">new</span> <span class="n">DefaultModification</span><span class="o">(</span> <span class="n">ModificationOperation</span><span class="o">.</span><span class="na">ADD_ATTRIBUTE</span><span class="o">,</span> <span class="s">"givenName"</span><span class="o">,</span>
@@ -256,7 +267,7 @@
as expected.</p>
<p>Anothe potential error you can get is when you try to add an attribute that is not allowed in an entry. This can be because the Entry's ObjectClass does not allow such an attribute, or because the server forbid you to modify the entry, due to the ACIs applied on this entry.</p>
<p>Last, not least, but this is quite obvious, the entry <em>must</em> exist !</p>
-<h3 id="removing-an-attribute">Removing an attribute</h3>
+<h3 id="removing-an-attribute">Removing an attribute<a class="headerlink" href="#removing-an-attribute" title="Permanent link">¶</a></h3>
<p>Removing an attribute is actually a bit simpler than adding an attribute, as you don't have to specify the values of the attribute to remove. Here is an example where we will remove the <em>giveName</em> attrinute from an entry :</p>
<div class="codehilite"><pre><span class="o">...</span>
<span class="n">Modification</span> <span class="n">deletedGivenName</span> <span class="o">=</span> <span class="k">new</span> <span class="n">DefaultModification</span><span class="o">(</span> <span class="n">ModificationOperation</span><span class="o">.</span><span class="na">REMOVE_ATTRIBUTE</span><span class="o">,</span> <span class="s">"givenName"</span> <span class="o">);</span>
@@ -268,7 +279,7 @@ as expected.</p>
<p>Here, we have created a modification, specifying that the <em>givenName</em> attribute has to be removed, and we applied the modification on the entry.</p>
<p>Again, you can delete more than one attribute from an entry, it's just a matter of creating more than one <em>Modification</em> instances and applying them to the entry.</p>
-<h4 id="errors_1">Errors</h4>
+<h4 id="errors_1">Errors<a class="headerlink" href="#errors_1" title="Permanent link">¶</a></h4>
<p>If you try to delete an attribute that does not exist in the entry, you will get this error :</p>
<div class="codehilite"><pre><span class="n">org</span><span class="o">.</span><span class="na">apache</span><span class="o">.</span><span class="na">directory</span><span class="o">.</span><span class="na">api</span><span class="o">.</span><span class="na">ldap</span><span class="o">.</span><span class="na">model</span><span class="o">.</span><span class="na">exception</span><span class="o">.</span><span class="na">LdapNoSuchAttributeException</span><span class="o">:</span> <span class="nl">NO_SUCH_ATTRIBUTE:</span> <span class="n">failed</span> <span class="k">for</span> <span class="n">MessageType</span> <span class="o">:</span> <span class="n">MODIFY_REQUEST</span>
<span class="n">Message</span> <span class="n">ID</span> <span class="o">:</span> <span class="mi">3</span>
@@ -298,7 +309,7 @@ as expected.</p>
<p>Anothe potential error you can get is when you try to remove an attribute which is a mandatory attribute, per the entry's ObjectClass constraints.</p>
<p>Otherwise, the server might forbid you to modify the entry, due to the ACIs that are applicable to this entry.</p>
<p>Again the entry <em>must</em> exist before performing a modification!</p>
-<h2 id="adding-removing-or-replacing-attribute-values">Adding, removing or replacing attribute values</h2>
+<h2 id="adding-removing-or-replacing-attribute-values">Adding, removing or replacing attribute values<a class="headerlink" href="#adding-removing-or-replacing-attribute-values" title="Permanent link">¶</a></h2>
<p>You can now update an attribute's values themselves, atomically, instead of removing a full attribute, and add it back but with updated values. We use the exact same <em>Modification</em> instance, with the same three <em>ModificationOperation</em>, except that the semantics slightly differ.</p>
<p>Typically, here is what happens when you use one of the three <em>ModificationOperation</em> on an attribute :</p>
<ul>
@@ -306,7 +317,7 @@ as expected.</p>
<li>ModificationOperation.REMOVE_ATTRIBUTE : remove values from an attribute.</li>
<li>ModificationOperation.REPLACE_ATTRIBUTE : replace all the values from an attribute by the provided new values</li>
</ul>
-<h3 id="add-values">Add values</h3>
+<h3 id="add-values">Add values<a class="headerlink" href="#add-values" title="Permanent link">¶</a></h3>
<p>Let's see with the addition of values. Here, we will assume we have an entry like :</p>
<div class="codehilite"><pre><span class="n">dn</span><span class="o">:</span> <span class="n">uid</span><span class="o">=</span><span class="n">jDoe</span><span class="o">,</span><span class="n">dc</span><span class="o">=</span><span class="n">acme</span><span class="o">,</span><span class="n">dc</span><span class="o">=</span><span class="n">com</span>
<span class="n">objectClass</span><span class="o">:</span> <span class="n">person</span>
@@ -343,7 +354,7 @@ as expected.</p>
</pre></div>
-<h4 id="errors_2">Errors</h4>
+<h4 id="errors_2">Errors<a class="headerlink" href="#errors_2" title="Permanent link">¶</a></h4>
<p>Again, such an operation might fail for many reasons. Let's see what are the possible errors :</p>
<p>First, the attribute's value already exists. You will get such an error :</p>
<div class="codehilite"><pre><span class="n">org</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">directory</span><span class="p">.</span><span class="n">api</span><span class="p">.</span><span class="n">ldap</span><span class="p">.</span><span class="n">model</span><span class="p">.</span><span class="n">exception</span><span class="p">.</span><span class="n">LdapAttributeInUseException</span><span class="p">:</span> <span class="n">ATTRIBUTE_OR_VALUE_EXISTS</span><span class="p">:</span> <span class="n">failed</span> <span class="k">for</span> <span class="n">MessageType</span> <span class="p">:</span>
@@ -382,7 +393,7 @@ as expected.</p>
<p>Third, the ACIs you have set on the server may not allow you to update an entry or an attribute.</p>
-<h3 id="remove-values">Remove values</h3>
+<h3 id="remove-values">Remove values<a class="headerlink" href="#remove-values" title="Permanent link">¶</a></h3>
<p>Removing values follow the same scheme : select the entry, chose the attribute, and list the values you want to be removed from this attribute. Here is an exemple :</p>
<div class="codehilite"><pre><span class="o">...</span>
<span class="n">Modification</span> <span class="n">removedGivenNameValue</span> <span class="o">=</span> <span class="k">new</span> <span class="n">DefaultModification</span><span class="o">(</span> <span class="n">ModificationOperation</span><span class="o">.</span><span class="na">REMOVE_ATTRIBUTE</span><span class="o">,</span> <span class="s">"givenName"</span><span class="o">,</span> <span class="s">"Tom"</span> <span class="o">);</span>
@@ -394,7 +405,7 @@ as expected.</p>
<p>The value 'Tom' we just have added should now be removed from the <em>givenName</em> attribute, but the value 'John' should still be present.</p>
<p>Whet if you remove the last value of an attribute ? That quite simple : the attribute itself will be removed from the entry, if this is allowed (see below).</p>
-<h4 id="errors_3">Errors</h4>
+<h4 id="errors_3">Errors<a class="headerlink" href="#errors_3" title="Permanent link">¶</a></h4>
<p>There are more potential erros with this operation. let's list all of them.</p>
<p>First, the value you want to remove does not exist. You will get such an error :</p>
<div class="codehilite"><pre><span class="n">org</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">directory</span><span class="p">.</span><span class="n">api</span><span class="p">.</span><span class="n">ldap</span><span class="p">.</span><span class="n">model</span><span class="p">.</span><span class="n">exception</span><span class="p">.</span><span class="n">LdapNoSuchAttributeException</span><span class="p">:</span> <span class="n">NO_SUCH_ATTRIBUTE</span><span class="p">:</span> <span class="n">failed</span> <span class="k">for</span> <span class="n">MessageType</span> <span class="p">:</span>
@@ -459,7 +470,7 @@ as expected.</p>
<p>Then you have the classical errors : the ACLs forbids you to remove a velue, or the entry simply does not exist.</p>
-<h3 id="replace-values">Replace values</h3>
+<h3 id="replace-values">Replace values<a class="headerlink" href="#replace-values" title="Permanent link">¶</a></h3>
<p>Here, what we want to do is to replaces all the values from an attribute with some new values. All in all, this is equivalent to first remove the values, then inject the new values, using modifications, except that in some cases, doing so will not work.</p>
<p>An exemple where such an operation is mandatory is when you want to replace the value of a mandatory attribute with something different : with two successive operation, that would fail. A replace will work.</p>
<p>What is important here is that the operation simply replace <em>all the existing values</em> by new ones, removing the previous ones.</p>
@@ -487,7 +498,7 @@ as expected.</p>
<p>The modified entry will have its <em>givenName</em> value replaced by 'Jack', the two previous values will have been removed.</p>
<p>There is one corner case with this operation : if you create a <em>Modification</em> instances where you specify an Attribute with no value, then the attribute will be removed from the entry.</p>
-<h4 id="errors_4">Errors</h4>
+<h4 id="errors_4">Errors<a class="headerlink" href="#errors_4" title="Permanent link">¶</a></h4>
<p>You will get the same errors seen in the two previous operation (ADD and REMOVE) for the very same use cases. Be sure you don't :</p>
<ul>
<li>inject more than one value in a SINGLE_VALUE attribute</li>
Modified: websites/staging/directory/trunk/content/api/user-guide/2.7-moving-renaming.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/2.7-moving-renaming.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/2.7-moving-renaming.html Sun Jul 5 22:34:35 2015
@@ -104,7 +104,7 @@
</ul>
<h5>Downloads</h5>
<ul>
- <li><a href="./../../api/downloads.html">Version 1.0.0-M30</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+ <li><a href="./../../api/downloads.html">Version 1.0.0-M31</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
<li><a href="./../../api/download-old-versions.html">Older versions</a></li>
</ul>
<h5>Getting Started</h5>
@@ -173,7 +173,18 @@
</div>
-<h1 id="27-moving-an-renaming-entries-e">2.7 - Moving an renaming entries (e)</h1>
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+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="27-moving-an-renaming-entries-e">2.7 - Moving an renaming entries (e)<a class="headerlink" href="#27-moving-an-renaming-entries-e" title="Permanent link">¶</a></h1>
<div class="nav">
Modified: websites/staging/directory/trunk/content/api/user-guide/2.8-comparing.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/2.8-comparing.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/2.8-comparing.html Sun Jul 5 22:34:35 2015
@@ -104,7 +104,7 @@
</ul>
<h5>Downloads</h5>
<ul>
- <li><a href="./../../api/downloads.html">Version 1.0.0-M30</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+ <li><a href="./../../api/downloads.html">Version 1.0.0-M31</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
<li><a href="./../../api/download-old-versions.html">Older versions</a></li>
</ul>
<h5>Getting Started</h5>
@@ -173,7 +173,18 @@
</div>
-<h1 id="28-comparing-entries-e">2.8 - Comparing entries (e)</h1>
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+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="28-comparing-entries-e">2.8 - Comparing entries (e)<a class="headerlink" href="#28-comparing-entries-e" title="Permanent link">¶</a></h1>
<div class="nav">
Modified: websites/staging/directory/trunk/content/api/user-guide/2.9-exception-management.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/2.9-exception-management.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/2.9-exception-management.html Sun Jul 5 22:34:35 2015
@@ -104,7 +104,7 @@
</ul>
<h5>Downloads</h5>
<ul>
- <li><a href="./../../api/downloads.html">Version 1.0.0-M30</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+ <li><a href="./../../api/downloads.html">Version 1.0.0-M31</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
<li><a href="./../../api/download-old-versions.html">Older versions</a></li>
</ul>
<h5>Getting Started</h5>
@@ -173,7 +173,18 @@
</div>
-<h1 id="29-exception-management">2.9 - Exception management (...)</h1>
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+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="29-exception-management">2.9 - Exception management (...)<a class="headerlink" href="#29-exception-management" title="Permanent link">¶</a></h1>
<div class="nav">
Modified: websites/staging/directory/trunk/content/api/user-guide/3-advanced-ldap-api-usage.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/3-advanced-ldap-api-usage.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/3-advanced-ldap-api-usage.html Sun Jul 5 22:34:35 2015
@@ -104,7 +104,7 @@
</ul>
<h5>Downloads</h5>
<ul>
- <li><a href="./../../api/downloads.html">Version 1.0.0-M30</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+ <li><a href="./../../api/downloads.html">Version 1.0.0-M31</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
<li><a href="./../../api/download-old-versions.html">Older versions</a></li>
</ul>
<h5>Getting Started</h5>
@@ -173,8 +173,19 @@
</div>
-<h1 id="3-advanced-ldap-api-usage">3 - Advanced LDAP API Usage (...)</h1>
-<h2 id="contents">Contents</h2>
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+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="3-advanced-ldap-api-usage">3 - Advanced LDAP API Usage (...)<a class="headerlink" href="#3-advanced-ldap-api-usage" title="Permanent link">¶</a></h1>
+<h2 id="contents">Contents<a class="headerlink" href="#contents" title="Permanent link">¶</a></h2>
<ul>
<li><a href="3.1-controls.html">Controls (...)</a></li>
<li><a href="3.2-extended-operations.html">Extended operations (e)</a></li>
Modified: websites/staging/directory/trunk/content/api/user-guide/3.1-controls.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/3.1-controls.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/3.1-controls.html Sun Jul 5 22:34:35 2015
@@ -104,7 +104,7 @@
</ul>
<h5>Downloads</h5>
<ul>
- <li><a href="./../../api/downloads.html">Version 1.0.0-M30</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+ <li><a href="./../../api/downloads.html">Version 1.0.0-M31</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
<li><a href="./../../api/download-old-versions.html">Older versions</a></li>
</ul>
<h5>Getting Started</h5>
@@ -173,7 +173,18 @@
</div>
-<h1 id="31-controls">3.1 - Controls</h1>
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+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="31-controls">3.1 - Controls<a class="headerlink" href="#31-controls" title="Permanent link">¶</a></h1>
<div class="nav">
Modified: websites/staging/directory/trunk/content/api/user-guide/3.2-extended-operations.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/3.2-extended-operations.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/3.2-extended-operations.html Sun Jul 5 22:34:35 2015
@@ -104,7 +104,7 @@
</ul>
<h5>Downloads</h5>
<ul>
- <li><a href="./../../api/downloads.html">Version 1.0.0-M30</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+ <li><a href="./../../api/downloads.html">Version 1.0.0-M31</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
<li><a href="./../../api/download-old-versions.html">Older versions</a></li>
</ul>
<h5>Getting Started</h5>
@@ -173,7 +173,18 @@
</div>
-<h1 id="32-extended-operations">3.2 - Extended Operations</h1>
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+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="32-extended-operations">3.2 - Extended Operations<a class="headerlink" href="#32-extended-operations" title="Permanent link">¶</a></h1>
<div class="nav">
Modified: websites/staging/directory/trunk/content/api/user-guide/3.3-referrals.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/3.3-referrals.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/3.3-referrals.html Sun Jul 5 22:34:35 2015
@@ -104,7 +104,7 @@
</ul>
<h5>Downloads</h5>
<ul>
- <li><a href="./../../api/downloads.html">Version 1.0.0-M30</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+ <li><a href="./../../api/downloads.html">Version 1.0.0-M31</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
<li><a href="./../../api/download-old-versions.html">Older versions</a></li>
</ul>
<h5>Getting Started</h5>
@@ -173,7 +173,18 @@
</div>
-<h1 id="33-referrals">3.3 - Referrals</h1>
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+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="33-referrals">3.3 - Referrals<a class="headerlink" href="#33-referrals" title="Permanent link">¶</a></h1>
<div class="nav">
Modified: websites/staging/directory/trunk/content/api/user-guide/3.4-aliases.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/3.4-aliases.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/3.4-aliases.html Sun Jul 5 22:34:35 2015
@@ -104,7 +104,7 @@
</ul>
<h5>Downloads</h5>
<ul>
- <li><a href="./../../api/downloads.html">Version 1.0.0-M30</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+ <li><a href="./../../api/downloads.html">Version 1.0.0-M31</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
<li><a href="./../../api/download-old-versions.html">Older versions</a></li>
</ul>
<h5>Getting Started</h5>
@@ -173,7 +173,18 @@
</div>
-<h1 id="34-aliases">3.4 - Aliases</h1>
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+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="34-aliases">3.4 - Aliases<a class="headerlink" href="#34-aliases" title="Permanent link">¶</a></h1>
<div class="nav">
Modified: websites/staging/directory/trunk/content/api/user-guide/3.5-ldif-dsml.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/3.5-ldif-dsml.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/3.5-ldif-dsml.html Sun Jul 5 22:34:35 2015
@@ -104,7 +104,7 @@
</ul>
<h5>Downloads</h5>
<ul>
- <li><a href="./../../api/downloads.html">Version 1.0.0-M30</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+ <li><a href="./../../api/downloads.html">Version 1.0.0-M31</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
<li><a href="./../../api/download-old-versions.html">Older versions</a></li>
</ul>
<h5>Getting Started</h5>
@@ -173,7 +173,18 @@
</div>
-<h1 id="35-ldif-and-dsml">3.5 - LDIF and DSML</h1>
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+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="35-ldif-and-dsml">3.5 - LDIF and DSML<a class="headerlink" href="#35-ldif-and-dsml" title="Permanent link">¶</a></h1>
<div class="nav">
Modified: websites/staging/directory/trunk/content/api/user-guide/3.6-abandonning.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/3.6-abandonning.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/3.6-abandonning.html Sun Jul 5 22:34:35 2015
@@ -104,7 +104,7 @@
</ul>
<h5>Downloads</h5>
<ul>
- <li><a href="./../../api/downloads.html">Version 1.0.0-M30</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+ <li><a href="./../../api/downloads.html">Version 1.0.0-M31</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
<li><a href="./../../api/download-old-versions.html">Older versions</a></li>
</ul>
<h5>Getting Started</h5>
@@ -173,7 +173,18 @@
</div>
-<h1 id="36-abandonning-an-operation">3.6 - Abandonning an operation</h1>
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+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="36-abandonning-an-operation">3.6 - Abandonning an operation<a class="headerlink" href="#36-abandonning-an-operation" title="Permanent link">¶</a></h1>
<div class="nav">
Modified: websites/staging/directory/trunk/content/api/user-guide/3.7-server-informations.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/3.7-server-informations.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/3.7-server-informations.html Sun Jul 5 22:34:35 2015
@@ -104,7 +104,7 @@
</ul>
<h5>Downloads</h5>
<ul>
- <li><a href="./../../api/downloads.html">Version 1.0.0-M30</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+ <li><a href="./../../api/downloads.html">Version 1.0.0-M31</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
<li><a href="./../../api/download-old-versions.html">Older versions</a></li>
</ul>
<h5>Getting Started</h5>
@@ -173,7 +173,18 @@
</div>
-<h1 id="37-server-informations">3.7 - Server informations</h1>
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+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="37-server-informations">3.7 - Server informations<a class="headerlink" href="#37-server-informations" title="Permanent link">¶</a></h1>
<div class="nav">
Modified: websites/staging/directory/trunk/content/api/user-guide/4-schema-management.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/4-schema-management.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/4-schema-management.html Sun Jul 5 22:34:35 2015
@@ -104,7 +104,7 @@
</ul>
<h5>Downloads</h5>
<ul>
- <li><a href="./../../api/downloads.html">Version 1.0.0-M30</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+ <li><a href="./../../api/downloads.html">Version 1.0.0-M31</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
<li><a href="./../../api/download-old-versions.html">Older versions</a></li>
</ul>
<h5>Getting Started</h5>
@@ -173,8 +173,19 @@
</div>
-<h1 id="4-schema-management">4 - Schema Management (...)</h1>
-<h2 id="contents">Contents</h2>
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+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="4-schema-management">4 - Schema Management (...)<a class="headerlink" href="#4-schema-management" title="Permanent link">¶</a></h1>
+<h2 id="contents">Contents<a class="headerlink" href="#contents" title="Permanent link">¶</a></h2>
<ul>
<li><a href="4.1-schema-manager.html">SchemaManager</a></li>
<li><a href="4.2-attribute-types.html">AttributeTypes</a></li>
Modified: websites/staging/directory/trunk/content/api/user-guide/4.1-schema-manager.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/4.1-schema-manager.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/4.1-schema-manager.html Sun Jul 5 22:34:35 2015
@@ -104,7 +104,7 @@
</ul>
<h5>Downloads</h5>
<ul>
- <li><a href="./../../api/downloads.html">Version 1.0.0-M30</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+ <li><a href="./../../api/downloads.html">Version 1.0.0-M31</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
<li><a href="./../../api/download-old-versions.html">Older versions</a></li>
</ul>
<h5>Getting Started</h5>
@@ -173,13 +173,24 @@
</div>
-<h1 id="41-schema-manager">4.1 - Schema Manager (...)</h1>
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+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="41-schema-manager">4.1 - Schema Manager (...)<a class="headerlink" href="#41-schema-manager" title="Permanent link">¶</a></h1>
<p>Apache DS has to keep the schema elements available from all the parts of the server. This is done through what we call the <strong>SchemaManager</strong>. It hides all the internal structure from the users.</p>
-<h2 id="description">Description</h2>
+<h2 id="description">Description<a class="headerlink" href="#description" title="Permanent link">¶</a></h2>
<p>The <strong>SchemaManager</strong> stores all the Schema elements (<strong><a href="">AttributeTypes (e)</a></strong>, <strong><a href="">ObjectClasses (e)</a></strong>, ... Internally, we store those elements into the <strong>Registries</strong>, which are hives where each Schema Objects are stored.</p>
<p>From the user point of view, the <strong>SchemaManager</strong> is seen as a representation of the available schemas. It can of course be extended, or modified, by adding or removing some schema elements.</p>
<p>The server has one instance of a <strong>SchemaManager</strong>, which is used internally, and a user won't control it, in any case. On the client side, we can load a <strong>SchemaManager</strong> either from the server (and then we have a duplicated instance), or from existing schema files. We can even create a brand new <strong>SchemaManager</strong> and fill it with all what we need.</p>
-<h2 id="contents">Contents</h2>
+<h2 id="contents">Contents<a class="headerlink" href="#contents" title="Permanent link">¶</a></h2>
<p>The <strong>SchemaManager</strong> stores all the 11 kind of schema elements :</p>
<table>
<thead>
@@ -226,7 +237,7 @@
<p>The last three elements are ApacheDS specific.</p>
<p>All those elements have some tight relationships. The following schema expose all the relations between all those elements :</p>
<p><img alt="" src="../../images/SchemaObjects.png" /></p>
-<h2 id="using-a-schemamanager">Using a SchemaManager</h2>
+<h2 id="using-a-schemamanager">Using a SchemaManager<a class="headerlink" href="#using-a-schemamanager" title="Permanent link">¶</a></h2>
<p>...</p>
Modified: websites/staging/directory/trunk/content/api/user-guide/4.2-attribute-types.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/4.2-attribute-types.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/4.2-attribute-types.html Sun Jul 5 22:34:35 2015
@@ -104,7 +104,7 @@
</ul>
<h5>Downloads</h5>
<ul>
- <li><a href="./../../api/downloads.html">Version 1.0.0-M30</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+ <li><a href="./../../api/downloads.html">Version 1.0.0-M31</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
<li><a href="./../../api/download-old-versions.html">Older versions</a></li>
</ul>
<h5>Getting Started</h5>
@@ -173,7 +173,18 @@
</div>
-<h1 id="42-attributetypes">4.2 - AttributeTypes</h1>
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+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="42-attributetypes">4.2 - AttributeTypes<a class="headerlink" href="#42-attributetypes" title="Permanent link">¶</a></h1>
<blockquote>
<p><strong>Note:</strong> Contents for this page will be added soon...</p>
</blockquote>
Modified: websites/staging/directory/trunk/content/api/user-guide/4.3-dit-content-rules.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/4.3-dit-content-rules.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/4.3-dit-content-rules.html Sun Jul 5 22:34:35 2015
@@ -104,7 +104,7 @@
</ul>
<h5>Downloads</h5>
<ul>
- <li><a href="./../../api/downloads.html">Version 1.0.0-M30</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+ <li><a href="./../../api/downloads.html">Version 1.0.0-M31</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
<li><a href="./../../api/download-old-versions.html">Older versions</a></li>
</ul>
<h5>Getting Started</h5>
@@ -173,7 +173,18 @@
</div>
-<h1 id="43-ditcontentrules">4.3 - DITContentRules</h1>
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+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="43-ditcontentrules">4.3 - DITContentRules<a class="headerlink" href="#43-ditcontentrules" title="Permanent link">¶</a></h1>
<blockquote>
<p><strong>Note:</strong> Contents for this page will be added soon...</p>
</blockquote>
Modified: websites/staging/directory/trunk/content/api/user-guide/4.4-dit-structure-rules.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/4.4-dit-structure-rules.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/4.4-dit-structure-rules.html Sun Jul 5 22:34:35 2015
@@ -104,7 +104,7 @@
</ul>
<h5>Downloads</h5>
<ul>
- <li><a href="./../../api/downloads.html">Version 1.0.0-M30</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+ <li><a href="./../../api/downloads.html">Version 1.0.0-M31</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
<li><a href="./../../api/download-old-versions.html">Older versions</a></li>
</ul>
<h5>Getting Started</h5>
@@ -173,7 +173,18 @@
</div>
-<h1 id="44-ditstructurerules">4.4 - DITStructureRules</h1>
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+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="44-ditstructurerules">4.4 - DITStructureRules<a class="headerlink" href="#44-ditstructurerules" title="Permanent link">¶</a></h1>
<blockquote>
<p><strong>Note:</strong> Contents for this page will be added soon...</p>
</blockquote>
Modified: websites/staging/directory/trunk/content/api/user-guide/4.5-matching-rules.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/4.5-matching-rules.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/4.5-matching-rules.html Sun Jul 5 22:34:35 2015
@@ -104,7 +104,7 @@
</ul>
<h5>Downloads</h5>
<ul>
- <li><a href="./../../api/downloads.html">Version 1.0.0-M30</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+ <li><a href="./../../api/downloads.html">Version 1.0.0-M31</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
<li><a href="./../../api/download-old-versions.html">Older versions</a></li>
</ul>
<h5>Getting Started</h5>
@@ -173,7 +173,18 @@
</div>
-<h1 id="45-matchingrules">4.5 - MatchingRules</h1>
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+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="45-matchingrules">4.5 - MatchingRules<a class="headerlink" href="#45-matchingrules" title="Permanent link">¶</a></h1>
<blockquote>
<p><strong>Note:</strong> Contents for this page will be added soon...</p>
</blockquote>
Modified: websites/staging/directory/trunk/content/api/user-guide/4.6-matching-rule-uses.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/4.6-matching-rule-uses.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/4.6-matching-rule-uses.html Sun Jul 5 22:34:35 2015
@@ -104,7 +104,7 @@
</ul>
<h5>Downloads</h5>
<ul>
- <li><a href="./../../api/downloads.html">Version 1.0.0-M30</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+ <li><a href="./../../api/downloads.html">Version 1.0.0-M31</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
<li><a href="./../../api/download-old-versions.html">Older versions</a></li>
</ul>
<h5>Getting Started</h5>
@@ -173,7 +173,18 @@
</div>
-<h1 id="46-matchingruleuses">4.6 - MatchingRuleUses</h1>
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+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="46-matchingruleuses">4.6 - MatchingRuleUses<a class="headerlink" href="#46-matchingruleuses" title="Permanent link">¶</a></h1>
<blockquote>
<p><strong>Note:</strong> Contents for this page will be added soon...</p>
</blockquote>
Modified: websites/staging/directory/trunk/content/api/user-guide/4.7-object-classes.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/4.7-object-classes.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/4.7-object-classes.html Sun Jul 5 22:34:35 2015
@@ -104,7 +104,7 @@
</ul>
<h5>Downloads</h5>
<ul>
- <li><a href="./../../api/downloads.html">Version 1.0.0-M30</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+ <li><a href="./../../api/downloads.html">Version 1.0.0-M31</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
<li><a href="./../../api/download-old-versions.html">Older versions</a></li>
</ul>
<h5>Getting Started</h5>
@@ -173,7 +173,18 @@
</div>
-<h1 id="47-objectclasses-e">4.7 - ObjectClasses (e)</h1>
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+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="47-objectclasses-e">4.7 - ObjectClasses (e)<a class="headerlink" href="#47-objectclasses-e" title="Permanent link">¶</a></h1>
<blockquote>
<p><strong>Note:</strong> Contents for this page will be added soon...</p>
</blockquote>
Modified: websites/staging/directory/trunk/content/api/user-guide/4.8-name-forms.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/4.8-name-forms.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/4.8-name-forms.html Sun Jul 5 22:34:35 2015
@@ -104,7 +104,7 @@
</ul>
<h5>Downloads</h5>
<ul>
- <li><a href="./../../api/downloads.html">Version 1.0.0-M30</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
+ <li><a href="./../../api/downloads.html">Version 1.0.0-M31</a> <IMG src="./../../images/new_badge.gif" alt="" style="margin-bottom:-3px;" border="0"></li>
<li><a href="./../../api/download-old-versions.html">Older versions</a></li>
</ul>
<h5>Getting Started</h5>
@@ -173,7 +173,18 @@
</div>
-<h1 id="48-nameforms">4.8 - NameForms</h1>
+<style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+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="48-nameforms">4.8 - NameForms<a class="headerlink" href="#48-nameforms" title="Permanent link">¶</a></h1>
<blockquote>
<p><strong>Note:</strong> Contents for this page will be added soon...</p>
</blockquote>