directory-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r872082 - in /websites/staging/directory/trunk/content: ./ api/user-guide/6.12-entry.html api/user-guide/6.2-administrative-role.html api/user-guide/6.3-attribute.html
Date Wed, 31 Jul 2013 10:05:10 GMT
Author: buildbot
Date: Wed Jul 31 10:05:10 2013
New Revision: 872082

Log:
Staging update by buildbot for directory

Modified:
    websites/staging/directory/trunk/content/   (props changed)
    websites/staging/directory/trunk/content/api/user-guide/6.12-entry.html
    websites/staging/directory/trunk/content/api/user-guide/6.2-administrative-role.html
    websites/staging/directory/trunk/content/api/user-guide/6.3-attribute.html

Propchange: websites/staging/directory/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Wed Jul 31 10:05:10 2013
@@ -1 +1 @@
-1508795
+1508797

Modified: websites/staging/directory/trunk/content/api/user-guide/6.12-entry.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/6.12-entry.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/6.12-entry.html Wed Jul 31 10:05:10
2013
@@ -227,19 +227,18 @@
 
 
 <p>All in all, the following constructors are available :</p>
-<div class="codehilite"><pre><span class="o">*</span> <span class="n">DefaultEntry</span><span
class="p">()</span> <span class="p">:</span> <span class="n">Default</span>
<span class="n">constructor</span>
-<span class="o">*</span> <span class="n">DefaultEntry</span><span
class="p">(</span><span class="n">SchemaManager</span><span class="p">)</span>
<span class="p">:</span> <span class="n">Default</span> <span class="n">constructor</span>
<span class="k">for</span> <span class="n">a</span> <span class="n">schema</span>
<span class="n">aware</span> <span class="n">entry</span>
-<span class="o">*</span> <span class="n">DefaultEntry</span><span
class="p">(</span><span class="n">String</span><span class="p">)</span>
<span class="p">:</span> <span class="n">Creates</span> <span class="n">an</span>
<span class="n">entry</span> <span class="n">with</span> <span
class="n">a</span> <span class="n">DN</span> <span class="n">as</span>
<span class="n">a</span> <span class="n">String</span>
-<span class="o">*</span> <span class="n">DefaultEntry</span><span
class="p">(</span><span class="n">SchemaManager</span><span class="p">,</span>
<span class="n">String</span><span class="p">)</span> <span class="p">:</span>
<span class="n">Creates</span> <span class="n">a</span> <span class="n">schema</span>
<span class="n">aware</span> <span class="n">entry</span> <span
class="n">with</span> <span class="n">a</span> <span class="n">DN</span>
<span class="n">as</span> <span class="n">a</span> <span class="n">String</span>
-<span class="o">*</span> <span class="n">DefaultEntry</span><span
class="p">(</span><span class="n">Dn</span><span class="p">)</span>
<span class="p">:</span> <span class="n">Creates</span> <span class="n">an</span>
<span class="n">entry</span> <span class="n">with</span> <span
class="n">a</span> <span class="n">DN</span>
-<span class="o">*</span> <span class="n">DefaultEntry</span><span
class="p">(</span><span class="n">SchemaManager</span><span class="p">,</span>
<span class="n">Dn</span><span class="p">)</span> <span class="p">:</span>
<span class="n">Creates</span> <span class="n">a</span> <span class="n">schema</span>
<span class="n">aware</span> <span class="n">entry</span> <span
class="n">with</span> <span class="n">a</span> <span class="n">DN</span>
<span class="n">as</span> <span class="n">a</span> <span class="n">String</span>
-<span class="o">*</span> <span class="n">DefaultEntry</span><span
class="p">(</span><span class="n">Dn</span><span class="p">,</span>
<span class="n">Object</span><span class="p">...)</span> <span
class="p">:</span> <span class="n">Creates</span> <span class="n">an</span>
<span class="n">entry</span> <span class="n">with</span> <span
class="n">a</span> <span class="n">DN</span> <span class="n">and</span>
<span class="n">some</span> <span class="n">attributes</span>
-<span class="o">*</span> <span class="n">DefaultEntry</span><span
class="p">(</span><span class="n">SchemaManager</span><span class="p">,</span>
<span class="n">String</span><span class="p">,</span> <span class="n">Object</span><span
class="p">...)</span> <span class="p">:</span> <span class="n">Creates</span>
<span class="n">a</span> <span class="n">schema</span> <span class="n">aware</span>
<span class="n">entry</span> <span class="n">with</span> <span
class="n">a</span> <span class="n">DN</span> <span class="n">as</span>
<span class="n">a</span> <span class="n">String</span><span class="p">,</span>
<span class="n">and</span> <span class="n">some</span> <span class="n">attributes</span>
-<span class="o">*</span> <span class="n">DefaultEntry</span><span
class="p">(</span><span class="n">SchemaManager</span><span class="p">,</span>
<span class="n">Dn</span><span class="p">,</span> <span class="n">Object</span><span
class="p">...)</span> <span class="p">:</span> <span class="n">Creates</span>
<span class="n">a</span> <span class="n">schema</span> <span class="n">aware</span>
<span class="n">entry</span> <span class="n">with</span> <span
class="n">a</span> <span class="n">DN</span> <span class="n">and</span>
<span class="n">some</span> <span class="n">attributes</span>
-<span class="o">*</span> <span class="n">DefaultEntry</span><span
class="p">(</span><span class="n">SchemaManager</span><span class="p">,</span>
<span class="n">Entry</span><span class="p">)</span> <span class="p">:</span>
<span class="n">Creates</span> <span class="n">an</span> <span
class="n">entry</span> <span class="n">using</span> <span class="n">a</span>
<span class="n">copy</span> <span class="n">of</span> <span class="n">another</span>
<span class="n">entry</span>
-</pre></div>
-
-
+<ul>
+<li>DefaultEntry() : Default constructor</li>
+<li>DefaultEntry(SchemaManager) : Default constructor for a schema aware entry</li>
+<li>DefaultEntry(String) : Creates an entry with a DN as a String</li>
+<li>DefaultEntry(SchemaManager, String) : Creates a schema aware entry with a DN as
a String</li>
+<li>DefaultEntry(Dn) : Creates an entry with a DN</li>
+<li>DefaultEntry(SchemaManager, Dn) : Creates a schema aware entry with a DN as a String</li>
+<li>DefaultEntry(Dn, Object...) : Creates an entry with a DN and some attributes</li>
+<li>DefaultEntry(SchemaManager, String, Object...) : Creates a schema aware entry with
a DN as a String, and some attributes</li>
+<li>DefaultEntry(SchemaManager, Dn, Object...) : Creates a schema aware entry with
a DN and some attributes</li>
+<li>DefaultEntry(SchemaManager, Entry) : Creates an entry using a copy of another entry</li>
+</ul>
 <h2 id="modifying-an-entry">Modifying an Entry</h2>
 <p>We have six methods available that modify the <em>Entry</em> content
: <em>add</em>, <em>clear</em>, <em>put</em>, <em>remove</em>,
<em>removeAttribute</em> and <em>setDn</em>. We will review six four
methods in the following paragraphs.</p>
 <h3 id="adding-attributes">Adding Attributes</h3>
@@ -247,98 +246,98 @@
 <p>In any case, we can add either an empty attribute, or an attribute with some values.
Those values can be <em>Strings</em>, <em>byte[]</em> or <em>Values</em>.
The added attributes can be schema aware, and we can also provide a user provided name for
the attribute type.</p>
 <h5 id="add-methods">add() methods</h5>
 <p>The first method makes it possible to add some existing <em>Attribute</em>
to an <em>Entry</em>. Let's see how it works:</p>
-<div class="codehilite"><pre>    <span class="n">Attribute</span>
<span class="n">cn</span> <span class="o">=</span> <span class="k">new</span>
<span class="n">DefaultAttribute</span><span class="o">(</span> <span
class="s">&quot;cn&quot;</span><span class="o">,</span> <span
class="s">&quot;test&quot;</span> <span class="o">);</span>
-    <span class="n">Attribute</span> <span class="n">cn2</span> <span
class="o">=</span> <span class="k">new</span> <span class="n">DefaultAttribute</span><span
class="o">(</span> <span class="s">&quot;cn&quot;</span><span
class="o">,</span> <span class="s">&quot;test2&quot;</span> <span
class="o">);</span>
+<div class="codehilite"><pre><span class="n">Attribute</span> <span
class="n">cn</span> <span class="o">=</span> <span class="k">new</span>
<span class="n">DefaultAttribute</span><span class="o">(</span> <span
class="s">&quot;cn&quot;</span><span class="o">,</span> <span
class="s">&quot;test&quot;</span> <span class="o">);</span>
+<span class="n">Attribute</span> <span class="n">cn2</span> <span
class="o">=</span> <span class="k">new</span> <span class="n">DefaultAttribute</span><span
class="o">(</span> <span class="s">&quot;cn&quot;</span><span
class="o">,</span> <span class="s">&quot;test2&quot;</span> <span
class="o">);</span>
 
-    <span class="n">Entry</span> <span class="n">entry</span> <span
class="o">=</span> <span class="k">new</span> <span class="n">DefaultEntry</span><span
class="o">(</span> 
-        <span class="s">&quot;dc=example, dc=com&quot;</span><span
class="o">,</span>
-        <span class="s">&quot;objectClass: top&quot;</span><span class="o">,</span>
-        <span class="s">&quot;objectClass: person&quot;</span><span
class="o">,</span>
-        <span class="s">&quot;sn: test&quot;</span> <span class="o">);</span>
+<span class="n">Entry</span> <span class="n">entry</span> <span
class="o">=</span> <span class="k">new</span> <span class="n">DefaultEntry</span><span
class="o">(</span> 
+    <span class="s">&quot;dc=example, dc=com&quot;</span><span class="o">,</span>
+    <span class="s">&quot;objectClass: top&quot;</span><span class="o">,</span>
+    <span class="s">&quot;objectClass: person&quot;</span><span class="o">,</span>
+    <span class="s">&quot;sn: test&quot;</span> <span class="o">);</span>
 
-    <span class="c1">// Add the new attribute</span>
-    <span class="n">entry</span><span class="o">.</span><span
class="na">add</span><span class="o">(</span> <span class="n">cn</span>
<span class="o">);</span>
+<span class="c1">// Add the new attribute</span>
+<span class="n">entry</span><span class="o">.</span><span class="na">add</span><span
class="o">(</span> <span class="n">cn</span> <span class="o">);</span>
 
-    <span class="c1">// Try to add a second value</span>
-    <span class="n">entry</span><span class="o">.</span><span
class="na">add</span><span class="o">(</span> <span class="n">cn2</span>
<span class="o">);</span>
+<span class="c1">// Try to add a second value</span>
+<span class="n">entry</span><span class="o">.</span><span class="na">add</span><span
class="o">(</span> <span class="n">cn2</span> <span class="o">);</span>
 </pre></div>
 
 
 <p>Otherwise, we can add a new attribute and values into the <em>Entry</em>
by passing both parameters. We can also pass an <em>AttributeType</em> to the
<em>add()</em> method, making the added attribute schema aware. Note that if the
<em>Entry</em> itself is already schema aware, this is not necessary.</p>
 <p>Here are some examples, the first one with a schema aware <em>Entry</em>,
the second one with a schema agnostic <em>Entry</em>:</p>
 <p>For a schema aware entry :</p>
-<div class="codehilite"><pre>    <span class="n">Entry</span> <span
class="n">entry</span> <span class="o">=</span> <span class="k">new</span>
<span class="n">DefaultEntry</span><span class="o">(</span> 
-        <span class="n">schemaManager</span><span class="o">,</span>
-        <span class="s">&quot;dc=example, dc=com&quot;</span><span
class="o">,</span>
-        <span class="s">&quot;objectClass: top&quot;</span><span class="o">,</span>
-        <span class="s">&quot;objectClass: person&quot;</span><span
class="o">,</span>
-        <span class="s">&quot;sn: test&quot;</span> <span class="o">);</span>
-
-    <span class="c1">// Add the new attribute</span>
-    <span class="n">entry</span><span class="o">.</span><span
class="na">add</span><span class="o">(</span> <span class="s">&quot;cn&quot;</span><span
class="o">,</span> <span class="s">&quot;test&quot;</span> <span
class="o">);</span>
+<div class="codehilite"><pre><span class="n">Entry</span> <span
class="n">entry</span> <span class="o">=</span> <span class="k">new</span>
<span class="n">DefaultEntry</span><span class="o">(</span> 
+    <span class="n">schemaManager</span><span class="o">,</span>
+    <span class="s">&quot;dc=example, dc=com&quot;</span><span class="o">,</span>
+    <span class="s">&quot;objectClass: top&quot;</span><span class="o">,</span>
+    <span class="s">&quot;objectClass: person&quot;</span><span class="o">,</span>
+    <span class="s">&quot;sn: test&quot;</span> <span class="o">);</span>
+
+<span class="c1">// Add the new attribute</span>
+<span class="n">entry</span><span class="o">.</span><span class="na">add</span><span
class="o">(</span> <span class="s">&quot;cn&quot;</span><span
class="o">,</span> <span class="s">&quot;test&quot;</span> <span
class="o">);</span>
 
-    <span class="c1">// Try to add a second value</span>
-    <span class="n">entry</span><span class="o">.</span><span
class="na">add</span><span class="o">(</span> <span class="s">&quot;cn&quot;</span><span
class="o">,</span> <span class="s">&quot;A  second test   &quot;</span>
<span class="o">);</span>
+<span class="c1">// Try to add a second value</span>
+<span class="n">entry</span><span class="o">.</span><span class="na">add</span><span
class="o">(</span> <span class="s">&quot;cn&quot;</span><span
class="o">,</span> <span class="s">&quot;A  second test   &quot;</span>
<span class="o">);</span>
 
-    <span class="c1">// We can also add a value to an existing Attribute </span>
-    <span class="n">entry</span><span class="o">.</span><span
class="na">add</span><span class="o">(</span> <span class="s">&quot;sn&quot;</span><span
class="o">,</span> <span class="s">&quot;Another SN&quot;</span>
<span class="o">);</span>
+<span class="c1">// We can also add a value to an existing Attribute </span>
+<span class="n">entry</span><span class="o">.</span><span class="na">add</span><span
class="o">(</span> <span class="s">&quot;sn&quot;</span><span
class="o">,</span> <span class="s">&quot;Another SN&quot;</span>
<span class="o">);</span>
 
-    <span class="c1">// And even add many values in one shot</span>
-    <span class="n">entry</span><span class="o">.</span><span
class="na">add</span><span class="o">(</span> <span class="s">&quot;cn&quot;</span><span
class="o">,</span> <span class="s">&quot;value1&quot;</span><span
class="o">,</span> <span class="s">&quot;value2&quot;</span>
<span class="o">);</span>
+<span class="c1">// And even add many values in one shot</span>
+<span class="n">entry</span><span class="o">.</span><span class="na">add</span><span
class="o">(</span> <span class="s">&quot;cn&quot;</span><span
class="o">,</span> <span class="s">&quot;value1&quot;</span><span
class="o">,</span> <span class="s">&quot;value2&quot;</span>
<span class="o">);</span>
 </pre></div>
 
 
 <p>For a schema agnostic entry :</p>
-<div class="codehilite"><pre>    <span class="n">Entry</span> <span
class="n">entry</span> <span class="o">=</span> <span class="k">new</span>
<span class="n">DefaultEntry</span><span class="o">(</span> 
-        <span class="s">&quot;dc=example, dc=com&quot;</span><span
class="o">,</span>
-        <span class="s">&quot;objectClass: top&quot;</span><span class="o">,</span>
-        <span class="s">&quot;objectClass: person&quot;</span><span
class="o">,</span>
-        <span class="s">&quot;sn: test&quot;</span> <span class="o">);</span>
+<div class="codehilite"><pre><span class="n">Entry</span> <span
class="n">entry</span> <span class="o">=</span> <span class="k">new</span>
<span class="n">DefaultEntry</span><span class="o">(</span> 
+    <span class="s">&quot;dc=example, dc=com&quot;</span><span class="o">,</span>
+    <span class="s">&quot;objectClass: top&quot;</span><span class="o">,</span>
+    <span class="s">&quot;objectClass: person&quot;</span><span class="o">,</span>
+    <span class="s">&quot;sn: test&quot;</span> <span class="o">);</span>
 
-    <span class="c1">// Add the new attribute</span>
-    <span class="n">entry</span><span class="o">.</span><span
class="na">add</span><span class="o">(</span> <span class="s">&quot;cn&quot;</span><span
class="o">,</span> <span class="s">&quot;test&quot;</span> <span
class="o">);</span>
+<span class="c1">// Add the new attribute</span>
+<span class="n">entry</span><span class="o">.</span><span class="na">add</span><span
class="o">(</span> <span class="s">&quot;cn&quot;</span><span
class="o">,</span> <span class="s">&quot;test&quot;</span> <span
class="o">);</span>
 
-    <span class="c1">// Try to add a second value</span>
-    <span class="n">entry</span><span class="o">.</span><span
class="na">add</span><span class="o">(</span> <span class="s">&quot;cn&quot;</span><span
class="o">,</span> <span class="s">&quot;A  second  test&quot;</span>
<span class="o">);</span>
+<span class="c1">// Try to add a second value</span>
+<span class="n">entry</span><span class="o">.</span><span class="na">add</span><span
class="o">(</span> <span class="s">&quot;cn&quot;</span><span
class="o">,</span> <span class="s">&quot;A  second  test&quot;</span>
<span class="o">);</span>
 </pre></div>
 
 
 <p>As you can see, there is no real difference between those two methods, except that
we pass the <em>schemaManager</em> in the first one.</p>
 <h5 id="put-methods">put() methods</h5>
 <p>The big difference with the <em>add</em> method is that the attribute
is not added, it will replace an existing one. let's see with an example :</p>
-<div class="codehilite"><pre>    <span class="n">Entry</span> <span
class="n">entry</span> <span class="o">=</span> <span class="k">new</span>
<span class="n">DefaultEntry</span><span class="o">(</span> 
-        <span class="n">schemaManager</span><span class="o">,</span>

-        <span class="s">&quot;dc=example, dc=com&quot;</span><span
class="o">,</span>
-        <span class="s">&quot;objectClass: top&quot;</span><span class="o">,</span>
-        <span class="s">&quot;objectClass: person&quot;</span><span
class="o">,</span>
-        <span class="s">&quot;sn: test&quot;</span> <span class="o">);</span>
+<div class="codehilite"><pre><span class="n">Entry</span> <span
class="n">entry</span> <span class="o">=</span> <span class="k">new</span>
<span class="n">DefaultEntry</span><span class="o">(</span> 
+    <span class="n">schemaManager</span><span class="o">,</span>

+    <span class="s">&quot;dc=example, dc=com&quot;</span><span class="o">,</span>
+    <span class="s">&quot;objectClass: top&quot;</span><span class="o">,</span>
+    <span class="s">&quot;objectClass: person&quot;</span><span class="o">,</span>
+    <span class="s">&quot;sn: test&quot;</span> <span class="o">);</span>
 
-    <span class="c1">// Add the new attribute</span>
-    <span class="n">entry</span><span class="o">.</span><span
class="na">put</span><span class="o">(</span> <span class="s">&quot;cn&quot;</span><span
class="o">,</span> <span class="s">&quot;test&quot;</span> <span
class="o">);</span>
+<span class="c1">// Add the new attribute</span>
+<span class="n">entry</span><span class="o">.</span><span class="na">put</span><span
class="o">(</span> <span class="s">&quot;cn&quot;</span><span
class="o">,</span> <span class="s">&quot;test&quot;</span> <span
class="o">);</span>
 
-    <span class="c1">// Try to add a second value : the &#39;cn&#39; attribute
will now contain only &#39;test2&#39;</span>
-    <span class="n">entry</span><span class="o">.</span><span
class="na">put</span><span class="o">(</span> <span class="s">&quot;cn&quot;</span><span
class="o">,</span> <span class="s">&quot;test2&quot;</span> <span
class="o">);</span>
+<span class="c1">// Try to add a second value : the &#39;cn&#39; attribute
will now contain only &#39;test2&#39;</span>
+<span class="n">entry</span><span class="o">.</span><span class="na">put</span><span
class="o">(</span> <span class="s">&quot;cn&quot;</span><span
class="o">,</span> <span class="s">&quot;test2&quot;</span> <span
class="o">);</span>
 </pre></div>
 
 
 <h3 id="removing-attributes">Removing Attributes</h3>
 <p>We can remove either an attribute having a specific value, or an entire attribute.
In order to remove a complete attribute, you just have to provide the attribute's name, and
use the <em>removeAttributes</em> method.</p>
 <p>Here are some example for both usages :</p>
-<div class="codehilite"><pre>    <span class="n">Entry</span> <span
class="n">entry</span> <span class="o">=</span> <span class="k">new</span>
<span class="n">DefaultEntry</span><span class="o">(</span> 
-        <span class="n">schemaManager</span><span class="o">,</span>
-        <span class="s">&quot;dc=example, dc=com&quot;</span><span
class="o">,</span>
-        <span class="s">&quot;objectClass: top&quot;</span><span class="o">,</span>
-        <span class="s">&quot;objectClass: person&quot;</span><span
class="o">,</span>
-        <span class="s">&quot;sn: test&quot;</span><span class="o">,</span>
-        <span class="s">&quot;cn: test1&quot;</span><span class="o">,</span>
-        <span class="s">&quot;cn: test2&quot;</span><span class="o">,</span>
-        <span class="s">&quot;cn: test3&quot;</span> <span class="o">);</span>
+<div class="codehilite"><pre><span class="n">Entry</span> <span
class="n">entry</span> <span class="o">=</span> <span class="k">new</span>
<span class="n">DefaultEntry</span><span class="o">(</span> 
+    <span class="n">schemaManager</span><span class="o">,</span>
+    <span class="s">&quot;dc=example, dc=com&quot;</span><span class="o">,</span>
+    <span class="s">&quot;objectClass: top&quot;</span><span class="o">,</span>
+    <span class="s">&quot;objectClass: person&quot;</span><span class="o">,</span>
+    <span class="s">&quot;sn: test&quot;</span><span class="o">,</span>
+    <span class="s">&quot;cn: test1&quot;</span><span class="o">,</span>
+    <span class="s">&quot;cn: test2&quot;</span><span class="o">,</span>
+    <span class="s">&quot;cn: test3&quot;</span> <span class="o">);</span>
 
-    <span class="c1">// Remove the &quot;test2&quot; value</span>
-    <span class="n">entry</span><span class="o">.</span><span
class="na">remove</span><span class="o">(</span> <span class="s">&quot;cn&quot;</span><span
class="o">,</span> <span class="s">&quot;test2&quot;</span> <span
class="o">);</span>
+<span class="c1">// Remove the &quot;test2&quot; value</span>
+<span class="n">entry</span><span class="o">.</span><span class="na">remove</span><span
class="o">(</span> <span class="s">&quot;cn&quot;</span><span
class="o">,</span> <span class="s">&quot;test2&quot;</span> <span
class="o">);</span>
 
-    <span class="c1">// Try to remove the full attribute</span>
-    <span class="n">entry</span><span class="o">.</span><span
class="na">removeAttributes</span><span class="o">(</span> <span class="s">&quot;cn&quot;</span>
<span class="o">);</span>
+<span class="c1">// Try to remove the full attribute</span>
+<span class="n">entry</span><span class="o">.</span><span class="na">removeAttributes</span><span
class="o">(</span> <span class="s">&quot;cn&quot;</span> <span
class="o">);</span>
 </pre></div>
 
 
@@ -346,18 +345,18 @@
 <p>It's also possible to store a new <em>Dn</em> into the Entry, using
the <em>setDn() method. It will replace an existing _Dn</em> This method takes
either a <em>Dn</em> instance, or a <em>String</em> representing a
valid <em>Dn</em>.</p>
 <h3 id="clearing-the-entry">Clearing the Entry</h3>
 <p>You can remove all the <em>Attribute</em> from the entry, using the
<em>clear()</em> method :</p>
-<div class="codehilite"><pre>    <span class="n">Entry</span> <span
class="n">entry</span> <span class="o">=</span> <span class="k">new</span>
<span class="n">DefaultEntry</span><span class="o">(</span> 
-        <span class="n">schemaManager</span><span class="o">,</span>
-        <span class="s">&quot;dc=example, dc=com&quot;</span><span
class="o">,</span>
-        <span class="s">&quot;objectClass: top&quot;</span><span class="o">,</span>
-        <span class="s">&quot;objectClass: person&quot;</span><span
class="o">,</span>
-        <span class="s">&quot;sn: test&quot;</span><span class="o">,</span>
-        <span class="s">&quot;cn: test1&quot;</span><span class="o">,</span>
-        <span class="s">&quot;cn: test2&quot;</span><span class="o">,</span>
-        <span class="s">&quot;cn: test3&quot;</span> <span class="o">);</span>
+<div class="codehilite"><pre><span class="n">Entry</span> <span
class="n">entry</span> <span class="o">=</span> <span class="k">new</span>
<span class="n">DefaultEntry</span><span class="o">(</span> 
+    <span class="n">schemaManager</span><span class="o">,</span>
+    <span class="s">&quot;dc=example, dc=com&quot;</span><span class="o">,</span>
+    <span class="s">&quot;objectClass: top&quot;</span><span class="o">,</span>
+    <span class="s">&quot;objectClass: person&quot;</span><span class="o">,</span>
+    <span class="s">&quot;sn: test&quot;</span><span class="o">,</span>
+    <span class="s">&quot;cn: test1&quot;</span><span class="o">,</span>
+    <span class="s">&quot;cn: test2&quot;</span><span class="o">,</span>
+    <span class="s">&quot;cn: test3&quot;</span> <span class="o">);</span>
 
-    <span class="c1">// Remove all the attributes</span>
-    <span class="n">entry</span><span class="o">.</span><span
class="na">clear</span><span class="o">();</span>
+<span class="c1">// Remove all the attributes</span>
+<span class="n">entry</span><span class="o">.</span><span class="na">clear</span><span
class="o">();</span>
 </pre></div>
 
 
@@ -388,22 +387,21 @@
 <p>Note that if one value does not exist, the _contains() method will return false.</p>
 <h3 id="getattributes-and-get-methods">getAttributes() and get() methods</h3>
 <p>Returns the <em>Attribute</em> having the given name if it exists. The
following test demonstrates its usage:</p>
-<div class="codehilite"><pre><span class="nd">@Test</span>
-    <span class="n">Entry</span> <span class="n">entry</span> <span
class="o">=</span> <span class="k">new</span> <span class="n">DefaultEntry</span><span
class="o">(</span> 
-        <span class="n">schemaManager</span><span class="o">,</span>
-        <span class="s">&quot;dc=example, dc=com&quot;</span><span
class="o">,</span>
-        <span class="s">&quot;objectClass: top&quot;</span><span class="o">,</span>
-        <span class="s">&quot;objectClass: person&quot;</span><span
class="o">,</span>
-        <span class="s">&quot;sn: test&quot;</span><span class="o">,</span>
-        <span class="s">&quot;cn: test1&quot;</span><span class="o">,</span>
-        <span class="s">&quot;cn: test2&quot;</span><span class="o">,</span>
-        <span class="s">&quot;cn: test3&quot;</span> <span class="o">);</span>
+<div class="codehilite"><pre><span class="n">Entry</span> <span
class="n">entry</span> <span class="o">=</span> <span class="k">new</span>
<span class="n">DefaultEntry</span><span class="o">(</span> 
+    <span class="n">schemaManager</span><span class="o">,</span>
+    <span class="s">&quot;dc=example, dc=com&quot;</span><span class="o">,</span>
+    <span class="s">&quot;objectClass: top&quot;</span><span class="o">,</span>
+    <span class="s">&quot;objectClass: person&quot;</span><span class="o">,</span>
+    <span class="s">&quot;sn: test&quot;</span><span class="o">,</span>
+    <span class="s">&quot;cn: test1&quot;</span><span class="o">,</span>
+    <span class="s">&quot;cn: test2&quot;</span><span class="o">,</span>
+    <span class="s">&quot;cn: test3&quot;</span> <span class="o">);</span>
 
-    <span class="c1">// Get the &#39;cn&#39; Attribute</span>
-    <span class="n">Attribute</span> <span class="n">cn</span> <span
class="o">=</span> <span class="n">entry</span><span class="o">.</span><span
class="na">get</span><span class="o">(</span> <span class="s">&quot;cn&quot;</span>
<span class="o">)</span> <span class="o">);</span>
+<span class="c1">// Get the &#39;cn&#39; Attribute</span>
+<span class="n">Attribute</span> <span class="n">cn</span> <span
class="o">=</span> <span class="n">entry</span><span class="o">.</span><span
class="na">get</span><span class="o">(</span> <span class="s">&quot;cn&quot;</span>
<span class="o">)</span> <span class="o">);</span>
 
-    <span class="c1">// Get all the Attributes</span>
-    <span class="n">Collection</span><span class="o">&lt;</span><span
class="n">Attribute</span><span class="o">&gt;</span> <span class="n">attributes</span>
<span class="o">=</span> <span class="n">entry</span><span class="o">.</span><span
class="na">getAttributes</span><span class="o">();</span>
+<span class="c1">// Get all the Attributes</span>
+<span class="n">Collection</span><span class="o">&lt;</span><span
class="n">Attribute</span><span class="o">&gt;</span> <span class="n">attributes</span>
<span class="o">=</span> <span class="n">entry</span><span class="o">.</span><span
class="na">getAttributes</span><span class="o">();</span>
 </pre></div>
 
 

Modified: websites/staging/directory/trunk/content/api/user-guide/6.2-administrative-role.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/6.2-administrative-role.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/6.2-administrative-role.html Wed
Jul 31 10:05:10 2013
@@ -17,7 +17,7 @@
 -->
 <html>
 	<head>
-		<title>6.3 - AdministrativeRole &mdash; Apache Directory</title>
+		<title>6.2 - AdministrativeRole &mdash; Apache Directory</title>
 		
 	    <link href="./../../css/common.css" rel="stylesheet" type="text/css">
 	    <link href="./../../css/brown.css" rel="stylesheet" type="text/css">
@@ -120,7 +120,7 @@
     <div class="nav">
         <div class="nav_prev">
         
-            <a href="6.2-administrative-point.html">6.2 - AdministrativePoint</a>
+            <a href="6.1-administrative-point.html">6.1 - AdministrativePoint</a>
 		
         </div>
         <div class="nav_up">
@@ -143,29 +143,29 @@ Those classes are currently only used by
 </DIV>
 
 <p>The <em>AdministrativeRole</em> structure is a <strong>enum</strong>
listing the possible roles we can select for an <em>AdministrativePoint</em>.
We currently support 4 different roles :</p>
-<div class="codehilite"><pre><span class="o">*</span> <span class="n">Access</span>
<span class="n">Control</span>
-<span class="o">*</span> <span class="n">Collective</span> <span
class="n">Attributes</span>
-<span class="o">*</span> <span class="n">SubSchema</span>
-<span class="o">*</span> <span class="n">Triggers</span>
-</pre></div>
-
-
+<ul>
+<li>Access Control</li>
+<li>Collective Attributes</li>
+<li>SubSchema</li>
+<li>Triggers</li>
+</ul>
 <p>And each of those roles can be combine with their scope :</p>
-<div class="codehilite"><pre><span class="o">*</span> <span class="n">AutonomousArea</span>
-<span class="o">*</span> <span class="n">AccessControlSpecificArea</span>
-<span class="o">*</span> <span class="n">AccessControlInnerArea</span>
-<span class="o">*</span> <span class="n">CollectiveAttributeSpecificArea</span>
-<span class="o">*</span> <span class="n">CollectiveAttributeInnerArea</span>
-<span class="o">*</span> <span class="n">SubSchemaSpecificArea</span>
-<span class="o">*</span> <span class="n">TriggerExecutionSpecificArea</span>
-<span class="o">*</span> <span class="n">TriggerExecutionInnerArea</span>
-</pre></div>
+<ul>
+<li>AutonomousArea</li>
+<li>AccessControlSpecificArea</li>
+<li>AccessControlInnerArea</li>
+<li>CollectiveAttributeSpecificArea</li>
+<li>CollectiveAttributeInnerArea</li>
+<li>SubSchemaSpecificArea</li>
+<li>TriggerExecutionSpecificArea</li>
+<li>TriggerExecutionInnerArea</li>
+</ul>
 
 
     <div class="nav">
         <div class="nav_prev">
         
-            <a href="6.2-administrative-point.html">6.2 - AdministrativePoint</a>
+            <a href="6.1-administrative-point.html">6.1 - AdministrativePoint</a>
 		
         </div>
         <div class="nav_up">

Modified: websites/staging/directory/trunk/content/api/user-guide/6.3-attribute.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/6.3-attribute.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/6.3-attribute.html Wed Jul 31
10:05:10 2013
@@ -143,11 +143,10 @@
 <p>The <em>Attribute</em> has a interned <em>AttributeType</em>
which is usually defined using its name. This name is case insensitive, and we can also use
the <em>AttributeType</em> <em>OID</em>.</p>
 <h2 id="creating-an-attribute">Creating an Attribute</h2>
 <p>Creating an <em>Attribute</em> is not really a complex operation. Again,
we split the API into two categories:</p>
-<div class="codehilite"><pre><span class="o">*</span> <span class="n">the</span>
<span class="n">schema</span> <span class="n">agnostic</span> <span
class="n">_Attributes_</span>
-<span class="o">*</span> <span class="n">the</span> <span class="n">schema</span>
<span class="n">aware</span> <span class="n">_Attributes_</span>
-</pre></div>
-
-
+<ul>
+<li>the schema agnostic <em>Attributes</em></li>
+<li>the schema aware <em>Attributes</em></li>
+</ul>
 <h3 id="schema-agnostic-attribute">Schema agnostic Attribute</h3>
 <p>If we don't inject a <em>SchemaManager</em> in the constructor, then
the <em>Attribute</em> will have no way to control that the <em>AttributeType</em>
exists, nor that the <em>Values</em> are valid.</p>
 <p>Let's see how we can create <em>Attributes</em>. Basically, all what
you need is to provide the <em>AttributeType</em> as a String, and some <em>Values</em>
(it's optional). Here is an example:</p>
@@ -263,15 +262,15 @@ The following test shows that:</p>
 <p>Checks if the given values are present in the <em>Attribute</em>. We
can check for more than one value, but in this case, the method returns <em>true</em>
only if <strong>all</strong> the values are present.</p>
 <p>If the <em>Attribute</em> is schema aware, then the check uses the <em>AttributeType</em>
to compare the given values with the interned values, otherwise, we do a strict comparison.</p>
 <p>Here is an example:</p>
-<div class="codehilite"><pre>    <span class="n">Attribute</span>
<span class="n">attribute1</span> <span class="o">=</span> <span
class="k">new</span> <span class="n">DefaultAttribute</span><span
class="o">(</span> <span class="n">atCn</span> <span class="o">);</span>
+<div class="codehilite"><pre><span class="n">Attribute</span> <span
class="n">attribute1</span> <span class="o">=</span> <span class="k">new</span>
<span class="n">DefaultAttribute</span><span class="o">(</span> <span
class="n">atCn</span> <span class="o">);</span>
 
-    <span class="c1">// Add three values</span>
-    <span class="n">attribute1</span><span class="o">.</span><span
class="na">add</span><span class="o">(</span> <span class="s">&quot;test
1&quot;</span><span class="o">,</span> <span class="s">&quot;test
2&quot;</span><span class="o">,</span> <span class="s">&quot;test
3&quot;</span> <span class="o">);</span>
+<span class="c1">// Add three values</span>
+<span class="n">attribute1</span><span class="o">.</span><span
class="na">add</span><span class="o">(</span> <span class="s">&quot;test
1&quot;</span><span class="o">,</span> <span class="s">&quot;test
2&quot;</span><span class="o">,</span> <span class="s">&quot;test
3&quot;</span> <span class="o">);</span>
 
-    <span class="n">Attribute</span> <span class="n">attribute2</span>
<span class="o">=</span> <span class="k">new</span> <span class="n">DefaultAttribute</span><span
class="o">(</span> <span class="s">&quot;cn&quot;</span> <span
class="o">);</span>
+<span class="n">Attribute</span> <span class="n">attribute2</span>
<span class="o">=</span> <span class="k">new</span> <span class="n">DefaultAttribute</span><span
class="o">(</span> <span class="s">&quot;cn&quot;</span> <span
class="o">);</span>
 
-    <span class="c1">// Add three values</span>
-    <span class="n">attribute2</span><span class="o">.</span><span
class="na">add</span><span class="o">(</span> <span class="s">&quot;test
1&quot;</span><span class="o">,</span> <span class="s">&quot;test
2&quot;</span><span class="o">,</span> <span class="s">&quot;test
3&quot;</span> <span class="o">);</span>
+<span class="c1">// Add three values</span>
+<span class="n">attribute2</span><span class="o">.</span><span
class="na">add</span><span class="o">(</span> <span class="s">&quot;test
1&quot;</span><span class="o">,</span> <span class="s">&quot;test
2&quot;</span><span class="o">,</span> <span class="s">&quot;test
3&quot;</span> <span class="o">);</span>
 </pre></div>
 
 



Mime
View raw message