directory-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r856789 [1/2] - in /websites/staging/directory/trunk/content: ./ api/user-guide/
Date Sun, 31 Mar 2013 21:21:26 GMT
Author: buildbot
Date: Sun Mar 31 21:21:26 2013
New Revision: 856789

Log:
Staging update by buildbot for directory

Added:
    websites/staging/directory/trunk/content/api/user-guide/7-requests-responses.html
    websites/staging/directory/trunk/content/api/user-guide/7.1-abandon-request.html
    websites/staging/directory/trunk/content/api/user-guide/8-ldap-rfcs.html
Removed:
    websites/staging/directory/trunk/content/api/user-guide/7-ldap-rfcs.html
Modified:
    websites/staging/directory/trunk/content/   (props changed)
    websites/staging/directory/trunk/content/api/user-guide/2.1-connection-disconnection.html
    websites/staging/directory/trunk/content/api/user-guide/2.4-adding.html
    websites/staging/directory/trunk/content/api/user-guide/2.5-deleting.html
    websites/staging/directory/trunk/content/api/user-guide/3-advanced-ldap-api-usage.html
    websites/staging/directory/trunk/content/api/user-guide/6-ldap-data-structures.html

Propchange: websites/staging/directory/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Sun Mar 31 21:21:26 2013
@@ -1 +1 @@
-1463053
+1463054

Modified: websites/staging/directory/trunk/content/api/user-guide/2.1-connection-disconnection.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/2.1-connection-disconnection.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/2.1-connection-disconnection.html Sun Mar 31 21:21:26 2013
@@ -138,7 +138,7 @@
 
 
 <h1 id="21-connection-and-disconnection">2.1 - Connection and disconnection</h1>
-<p><strong>LDAP</strong> is a protocol which requires the user to be connected - and eventually identified - in order to be able to send requests to the server. We maintain this connection potentially forever. What make the <strong>LDAP</strong> protocol different from, say, the <em>HTTP</em> protocol is that the connection must be issued explicitly. Let's see how we do that.</p>
+<p><strong>LDAP</strong> is a protocol which requires the user to be connected - and eventually identified - in order to be able to send requests to the server. We maintain this connection potentially forever. What make the <strong>LDAP</strong> protocol different from, say, the <strong>HTTP</strong> protocol is that the connection must be issued explicitly. Let's see how we do that.</p>
 <h2 id="opening-a-connection">Opening a connection</h2>
 <p>We can open a secure or a standard connection. </p>
 <h3 id="standard-connection">Standard connection</h3>

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 Mar 31 21:21:26 2013
@@ -162,7 +162,7 @@
 </pre></div>
 
 
-<p>In this basic example, we are adding a new entry, created using some <strong>LDIF</strong> formatted parameters, the first one being the entry's Dn.
+<p>In this basic example, we are adding a new entry, created using some <strong>LDIF</strong> formatted parameters, the first one being the entry's <em>Dn</em>.
 Note that it is possible to use some variables in the <strong>LDIF</strong> instead of pure text. Here is the same example, resulting to the same entry being added:</p>
 <div class="codehilite"><pre><span class="nd">@Test</span>
 <span class="kd">public</span> <span class="kt">void</span> <span class="nf">testAddLdif</span><span class="o">()</span> <span class="kd">throws</span> <span class="n">Exception</span>
@@ -187,8 +187,8 @@ Note that it is possible to use some var
 </pre></div>
 
 
-<p>Down the line, what is important is that the <em>add()</em> operation is taking a full <strong><a href="">Entry</a></strong>. </p>
-<p>We can also create the <strong><a href="">Entry</a></strong> in a different way, which will be exposed in the following paragraphs.</p>
+<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 <strong><a href="">AddRequest</a></strong></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>

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 Mar 31 21:21:26 2013
@@ -138,6 +138,97 @@
 
 
 <h1 id="25-deleting-entries">2.5 - Deleting entries</h1>
+<p>Deleting an entry is really easy. It's just a matter to know its <strong><a href="">Dn</a></strong>. 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>
+<p>We can ask the deletion by providing the entry's <strong><a href="">Dn</a></strong>, 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>
+<span class="o">{</span>
+    <span class="n">assertTrue</span><span class="o">(</span> <span class="n">session</span><span class="o">.</span><span class="na">exists</span><span class="o">(</span> <span class="s">&quot;cn=child1,cn=parent,ou=system&quot;</span> <span class="o">)</span> <span class="o">);</span>
+
+    <span class="n">DeleteResponse</span> <span class="n">response</span> <span class="o">=</span> <span class="n">connection</span><span class="o">.</span><span class="na">delete</span><span class="o">(</span> <span class="s">&quot;cn=child1,cn=parent,ou=system&quot;</span> <span class="o">);</span>
+    <span class="n">assertNotNull</span><span class="o">(</span> <span class="n">response</span> <span class="o">);</span>
+    <span class="n">assertEquals</span><span class="o">(</span> <span class="n">ResultCodeEnum</span><span class="o">.</span><span class="na">SUCCESS</span><span class="o">,</span> <span class="n">response</span><span class="o">.</span><span class="na">getLdapResult</span><span class="o">().</span><span class="na">getResultCode</span><span class="o">()</span> <span class="o">);</span>
+
+    <span class="n">assertFalse</span><span class="o">(</span> <span class="n">session</span><span class="o">.</span><span class="na">exists</span><span class="o">(</span> <span class="s">&quot;cn=child1,cn=parent,ou=system&quot;</span> <span class="o">)</span> <span class="o">);</span>
+<span class="o">}</span>
+</pre></div>
+
+
+<p>Trying to delete the parent alone would leads to an error (NOT_ALLOWED_ON_NON_LEAF) :</p>
+<div class="codehilite"><pre><span class="nd">@Test</span>
+<span class="kd">public</span> <span class="kt">void</span> <span class="nf">testDeleteNonLeafFailure</span><span class="o">()</span> <span class="kd">throws</span> <span class="n">Exception</span>
+<span class="o">{</span>
+    <span class="n">assertTrue</span><span class="o">(</span> <span class="n">session</span><span class="o">.</span><span class="na">exists</span><span class="o">(</span> <span class="s">&quot;cn=parent,ou=system&quot;</span> <span class="o">)</span> <span class="o">);</span>
+
+    <span class="n">DeleteResponse</span> <span class="n">response</span> <span class="o">=</span> <span class="n">connection</span><span class="o">.</span><span class="na">delete</span><span class="o">(</span> <span class="s">&quot;cn=parent,ou=system&quot;</span> <span class="o">);</span>
+    <span class="n">assertNotNull</span><span class="o">(</span> <span class="n">response</span> <span class="o">);</span>
+    <span class="n">assertEquals</span><span class="o">(</span> <span class="n">ResultCodeEnum</span><span class="o">.</span><span class="na">NOT_ALLOWED_ON_NON_LEAF</span><span class="o">,</span> <span class="n">response</span><span class="o">.</span><span class="na">getLdapResult</span><span class="o">().</span><span class="na">getResultCode</span><span class="o">()</span> <span class="o">);</span>
+
+    <span class="n">assertTrue</span><span class="o">(</span> <span class="n">session</span><span class="o">.</span><span class="na">exists</span><span class="o">(</span> <span class="s">&quot;cn=parent,ou=system&quot;</span> <span class="o">)</span> <span class="o">);</span>
+<span class="o">}</span>
+</pre></div>
+
+
+<h2 id="recursive-deletion-of-entries">Recursive deletion of entries</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>
+<span class="o">{</span>
+    <span class="n">assertTrue</span><span class="o">(</span> <span class="n">session</span><span class="o">.</span><span class="na">exists</span><span class="o">(</span> <span class="s">&quot;cn=parent,ou=system&quot;</span> <span class="o">)</span> <span class="o">);</span>
+
+    <span class="n">DeleteResponse</span> <span class="n">response</span> <span class="o">=</span> <span class="n">connection</span><span class="o">.</span><span class="na">deleteTree</span><span class="o">(</span> <span class="s">&quot;cn=parent,ou=system&quot;</span> <span class="o">);</span>
+    <span class="n">assertNotNull</span><span class="o">(</span> <span class="n">response</span> <span class="o">);</span>
+    <span class="n">assertEquals</span><span class="o">(</span> <span class="n">ResultCodeEnum</span><span class="o">.</span><span class="na">SUCCESS</span><span class="o">,</span> <span class="n">response</span><span class="o">.</span><span class="na">getLdapResult</span><span class="o">().</span><span class="na">getResultCode</span><span class="o">()</span> <span class="o">);</span>
+
+    <span class="n">assertFalse</span><span class="o">(</span> <span class="n">session</span><span class="o">.</span><span class="na">exists</span><span class="o">(</span> <span class="s">&quot;cn=parent,ou=system&quot;</span> <span class="o">)</span> <span class="o">);</span>
+<span class="o">}</span>
+</pre></div>
+
+
+<h2 id="sending-a-deleterequest-with-a-control">Sending a DeleteRequest with a control</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 <strong><a href="">DelRequest</a></strong> 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>
+<span class="o">{</span>
+    <span class="n">assertTrue</span><span class="o">(</span> <span class="n">session</span><span class="o">.</span><span class="na">exists</span><span class="o">(</span> <span class="s">&quot;cn=parent,ou=system&quot;</span> <span class="o">)</span> <span class="o">);</span>
+
+    <span class="k">if</span> <span class="o">(</span> <span class="n">connection</span><span class="o">.</span><span class="na">isControlSupported</span><span class="o">(</span> <span class="s">&quot;1.2.840.113556.1.4.805&quot;</span> <span class="o">)</span> <span class="o">)</span>
+    <span class="o">{</span>
+        <span class="n">DeleteRequest</span> <span class="n">deleteRequest</span> <span class="o">=</span> <span class="k">new</span> <span class="n">DeleteRequestImpl</span><span class="o">();</span>
+        <span class="n">deleteRequest</span><span class="o">.</span><span class="na">setName</span><span class="o">(</span> <span class="k">new</span> <span class="n">Dn</span><span class="o">(</span> <span class="s">&quot;cn=parent,ou=system&quot;</span> <span class="o">)</span> <span class="o">);</span>
+        <span class="n">Control</span> <span class="n">deleteTreeControl</span> <span class="o">=</span> <span class="k">new</span> <span class="n">OpaqueControl</span><span class="o">(</span> <span class="s">&quot;1.2.840.113556.1.4.805&quot;</span> <span class="o">);</span>
+        <span class="n">deleteRequest</span><span class="o">.</span><span class="na">addControl</span><span class="o">(</span> <span class="n">deleteTreeControl</span> <span class="o">);</span>
+
+        <span class="n">DeleteResponse</span> <span class="n">deleteResponse</span> <span class="o">=</span> <span class="n">connection</span><span class="o">.</span><span class="na">delete</span><span class="o">(</span> <span class="n">deleteRequest</span> <span class="o">);</span>
+
+        <span class="n">assertNotNull</span><span class="o">(</span> <span class="n">deleteResponse</span> <span class="o">);</span>
+        <span class="n">assertEquals</span><span class="o">(</span> <span class="n">ResultCodeEnum</span><span class="o">.</span><span class="na">SUCCESS</span><span class="o">,</span> <span class="n">deleteResponse</span><span class="o">.</span><span class="na">getLdapResult</span><span class="o">().</span><span class="na">getResultCode</span><span class="o">()</span> <span class="o">);</span>
+        <span class="n">assertFalse</span><span class="o">(</span> <span class="n">session</span><span class="o">.</span><span class="na">exists</span><span class="o">(</span> <span class="s">&quot;cn=parent,ou=system&quot;</span> <span class="o">)</span> <span class="o">);</span>
+    <span class="o">}</span>
+<span class="o">}</span>
+</pre></div>
+
+
+<h2 id="asynchronous-delete">Asynchronous delete</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>
+<span class="o">{</span>
+    <span class="n">assertTrue</span><span class="o">(</span> <span class="n">session</span><span class="o">.</span><span class="na">exists</span><span class="o">(</span> <span class="s">&quot;cn=child,cn=parent,ou=system&quot;</span> <span class="o">)</span> <span class="o">);</span>
+
+    <span class="n">DeleteRequest</span> <span class="n">deleteRequest</span> <span class="o">=</span> <span class="k">new</span> <span class="n">DeleteRequestImpl</span><span class="o">();</span>
+    <span class="n">deleteRequest</span><span class="o">.</span><span class="na">setName</span><span class="o">(</span> <span class="k">new</span> <span class="n">Dn</span><span class="o">(</span> <span class="s">&quot;cn=child,cn=parent,ou=system&quot;</span> <span class="o">)</span> <span class="o">);</span>
+
+    <span class="n">DeleteFuture</span> <span class="n">deleteFuture</span> <span class="o">=</span> <span class="n">connection</span><span class="o">.</span><span class="na">deleteAsync</span><span class="o">(</span> <span class="n">deleteRequest</span> <span class="o">);</span>
+
+    <span class="n">DeleteResponse</span> <span class="n">deleteResponse</span> <span class="o">=</span> <span class="n">deleteFuture</span><span class="o">.</span><span class="na">get</span><span class="o">(</span> <span class="mi">1000</span><span class="o">,</span> <span class="n">TimeUnit</span><span class="o">.</span><span class="na">MILLISECONDS</span> <span class="o">);</span>
+
+    <span class="n">assertNotNull</span><span class="o">(</span> <span class="n">deleteResponse</span> <span class="o">);</span>
+    <span class="n">assertEquals</span><span class="o">(</span> <span class="n">ResultCodeEnum</span><span class="o">.</span><span class="na">SUCCESS</span><span class="o">,</span> <span class="n">deleteResponse</span><span class="o">.</span><span class="na">getLdapResult</span><span class="o">().</span><span class="na">getResultCode</span><span class="o">()</span> <span class="o">);</span>
+    <span class="n">assertFalse</span><span class="o">(</span> <span class="n">session</span><span class="o">.</span><span class="na">exists</span><span class="o">(</span> <span class="s">&quot;cn=child,cn=parent,ou=system&quot;</span> <span class="o">)</span> <span class="o">);</span>
+<span class="o">}</span>
+</pre></div>
 
 
     <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 Mar 31 21:21:26 2013
@@ -144,8 +144,8 @@
 <li><a href="3.2-extended-operations.html">Extended operations (e)</a></li>
 <li><a href="3.3-referrals.html">Referrals (e)</a></li>
 <li><a href="3.4-aliases.html">Aliases (e)</a></li>
-<li><a href="3.5-aliases.html">LDIF, DSML (...)</a></li>
-<li><a href="3.6-ldif-dsml.html">Abandonning an operation (e)</a></li>
+<li><a href="3.5-ldif-dsml.html">LDIF, DSML (...)</a></li>
+<li><a href="3.6-abandonning.html">Abandonning an operation (e)</a></li>
 <li><a href="3.7-server-informations.html">Server informations (e)</a></li>
 </ul>
 

Modified: websites/staging/directory/trunk/content/api/user-guide/6-ldap-data-structures.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/6-ldap-data-structures.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/6-ldap-data-structures.html Sun Mar 31 21:21:26 2013
@@ -130,7 +130,7 @@
         </div>
         <div class="nav_next">
         
-            <a href="7-ldap-rfcs.html">7 - LDAP Related RFCs</a>
+            <a href="7-requests-response.html">7 - Requests and Responses</a>
 		
         </div>
         <div class="clearfix"></div>
@@ -191,7 +191,7 @@
         </div>
         <div class="nav_next">
         
-            <a href="7-ldap-rfcs.html">7 - LDAP Related RFCs</a>
+            <a href="7-requests-response.html">7 - Requests and Responses</a>
 		
         </div>
         <div class="clearfix"></div>

Added: websites/staging/directory/trunk/content/api/user-guide/7-requests-responses.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/7-requests-responses.html (added)
+++ websites/staging/directory/trunk/content/api/user-guide/7-requests-responses.html Sun Mar 31 21:21:26 2013
@@ -0,0 +1,294 @@
+<!DOCTYPE html>
+<!--
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version 2.0
+    (the "License"); you may not use this file except in compliance with
+    the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<html>
+	<head>
+		<title>7 - Requests and Responses &mdash; Apache Directory</title>
+		
+	    <link href="./../../css/common.css" rel="stylesheet" type="text/css">
+	    <link href="./../../css/brown.css" rel="stylesheet" type="text/css">
+    
+        
+        <link rel="shortcut icon" href="./../../images/api-icon_16x16.png">
+    
+        <!-- Google Analytics -->
+        <script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script>
+        <script type="text/javascript">
+            _uacct = "UA-1358462-1";
+            urchinTracker();
+        </script>
+	</head>
+	<body>
+	    <div id="container">
+            <div id="header">
+                <div id="subProjectsNavBar">
+                    <a href="./../../">
+                        
+                        Apache Directory Project
+                        
+                    </a>
+                    &nbsp;|&nbsp;
+                    <a href="./../../apacheds">
+                        
+                        ApacheDS
+                        
+                    </a>
+                    &nbsp;|&nbsp;
+                    <a href="./../../studio">
+                        
+                        Apache Directory Studio
+                        
+                    </a>
+                    &nbsp;|&nbsp;
+                    <a href="./../../api">
+                        
+                        <STRONG>Apache LDAP API</STRONG>
+                        
+                    </a>
+                </div><!-- subProjectsNavBar -->
+            </div><!-- header -->
+            <div id="content">
+                <div id="leftColumn">
+                    
+<div id="navigation">
+    
+    <h5>Downloads</h5>
+    <ul>
+	    <li><a href="./../../api/downloads.html">Version 1.0.0-M16</a>&nbsp;&nbsp;<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>
+    <ul>
+        <li><a href="./../../api/vision.html">Vision</a></li>
+        <li><a href="./../../api/java-api.html">Java API</a></li>
+        <li><a href="./../../api/groovy-ldap.html">Groovy API</a></li>
+    </ul>
+    <h5>Documentation</h5>
+    <ul>
+	    <li><a href="./../../api/five-minutes-tutorial.html">Five minutes tutorial</a></li>
+	    <li><a href="./../../api/user-guide.html">User Guide</a></li>
+        <li><a href="./../../api/gen-docs/latest/apidocs/">JavaDocs</a></li>
+        <!--li><a href="./../../api/gen-docs/latest/">Generated Reports</a></li-->
+        <li><a href="./../../api/developer-guide.html">Developer Guide</a></li>
+    </ul>
+    
+    
+    <h5>Support</h5>
+    <ul>
+        <li><a href="./../../mailing-lists-and-irc.html">Mailing Lists &amp; IRC</a></li>
+        <li><a href="./../../sources.html">Sources</a></li>
+        <li><a href="./../../issue-tracking.html">Issue Tracking</a></li>
+        <li><a href="./../../commercial-support.html">Commercial Support</a></li>
+    </ul>
+    <h5>Community</h5>
+    <ul>
+        <li><a href="./../../contribute.html">How to Contribute</a></li>
+        <li><a href="./../../team.html">Team</a></li>
+        <li><a href="./../../original-project-proposal.html">Original Project Proposal</a></li>
+        <li><a href="./../../special-thanks.html" class="external-link" rel="nofollow">Special Thanks</a></li>
+    </ul>
+    <h5>About Apache</h5>
+    <ul>
+        <li><a href="http://www.apache.org/">Apache</a></li>
+        <li><a href="http://www.apache.org/licenses/">License</a></li>
+        <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+        <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+        <li><a href="http://www.apache.org/security/">Security</a></li>
+    </ul>
+    <a href="http://acna13.eventbrite.com/?ref=ecount"><img src="http://holdenweb.com/static/images/BannerSquareSmall.png" width="168" height="140"></a>
+    
+</div><!-- navigation -->
+
+                </div><!-- leftColumn -->
+                <div id="rightColumn">
+
+
+    <div class="nav">
+        <div class="nav_prev">
+        
+            <a href="6-ldap-data-structures.html">6 - LDAP Data Structures</a>
+		
+        </div>
+        <div class="nav_up">
+        
+            <a href="../user-guide.html">User Guide</a>
+		
+        </div>
+        <div class="nav_next">
+        
+            <a href="8-ldap-rfcs.html">8 - LDAP Related RFCs</a>
+		
+        </div>
+        <div class="clearfix"></div>
+    </div>
+
+
+<h1 id="7-requests-and-responses">7 - Requests and Responses (...)</h1>
+<p>We will describe all the Java structure we use for each LDAP message (Requests and Responses). This can be useful when one want to send a message or process a response, using all the possible options.</p>
+<h2 id="inherited-classes">Inherited classes</h2>
+<p>All the messages inherit from a few classes that are describe here. They gather the common fields that can be used by most of the specific messages.</p>
+<h3 id="the-message-interface">The Message interface</h3>
+<p>This is the mother of all the hierarchy. A message has a few characteristics that are available to all the inherited classes :</p>
+<div class="codehilite"><pre><span class="o">*</span> <span class="n">Id</span> <span class="p">:</span> <span class="n">the</span> <span class="n">message</span> <span class="n">ID</span> <span class="n">which</span> <span class="n">is</span> <span class="n">generated</span> <span class="n">by</span> <span class="n">the</span> <span class="n">server</span> <span class="ow">or</span> <span class="n">the</span> <span class="n">client</span><span class="o">.</span> <span class="n">You</span> <span class="n">should</span> <span class="n">never</span> <span class="n">add</span> <span class="n">it</span>
+<span class="o">*</span> <span class="n">Controls</span> <span class="p">:</span> <span class="n">The</span> <span class="n">list</span> <span class="n">of</span> <span class="n">controls</span> <span class="n">you</span> <span class="n">add</span> <span class="n">to</span> <span class="n">a</span> <span class="n">request</span> <span class="ow">or</span> <span class="n">that</span> <span class="n">get</span> <span class="n">added</span> <span class="n">by</span> <span class="n">the</span> <span class="n">response</span>
+</pre></div>
+
+
+<p>Here is the Message interface :</p>
+<div class="codehilite"><pre><span class="cm">/**</span>
+<span class="cm"> * Root interface for all LDAP message type interfaces.</span>
+<span class="cm"> * </span>
+<span class="cm"> * @author &lt;a href=&quot;mailto:dev@directory.apache.org&quot;&gt;Apache Directory Project&lt;/a&gt;</span>
+<span class="cm"> */</span>
+<span class="kd">public</span> <span class="kd">interface</span> <span class="nc">Message</span>
+<span class="o">{</span>
+    <span class="cm">/**</span>
+<span class="cm">     * Gets the LDAP message type code associated with this Message. Each</span>
+<span class="cm">     * request and response type has a unique message type code defined by the</span>
+<span class="cm">     * protocol in &lt;a href=&quot;http://www.faqs.org/rfcs/rfc2251.html&quot;&gt;RFC 2251&lt;/a&gt;.</span>
+<span class="cm">     * </span>
+<span class="cm">     * @return the message type code.</span>
+<span class="cm">     */</span>
+    <span class="n">MessageTypeEnum</span> <span class="nf">getType</span><span class="o">();</span>
+
+    <span class="cm">/**</span>
+<span class="cm">     * Gets the controls associated with this message mapped by OID.</span>
+<span class="cm">     * </span>
+<span class="cm">     * @return Map of OID strings to Control object instances.</span>
+<span class="cm">     */</span>
+    <span class="n">Map</span><span class="o">&lt;</span><span class="n">String</span><span class="o">,</span> <span class="n">Control</span><span class="o">&gt;</span> <span class="n">getControls</span><span class="o">();</span>
+
+    <span class="cm">/**</span>
+<span class="cm">     * Gets the control associated with the given OID.</span>
+<span class="cm">     * </span>
+<span class="cm">     * @param oid The Cntrol&#39;s OID we are looking for</span>
+<span class="cm">     * @return The Control object instance with the OID.</span>
+<span class="cm">     */</span>
+    <span class="n">Control</span> <span class="nf">getControl</span><span class="o">(</span> <span class="n">String</span> <span class="n">oid</span> <span class="o">);</span>
+
+    <span class="cm">/**</span>
+<span class="cm">     * Checks whether or not this message has the specified control.</span>
+<span class="cm">     *</span>
+<span class="cm">     * @param oid the OID of the control</span>
+<span class="cm">     * @return true if this message has the control, false if it does not</span>
+<span class="cm">     */</span>
+    <span class="kt">boolean</span> <span class="nf">hasControl</span><span class="o">(</span> <span class="n">String</span> <span class="n">oid</span> <span class="o">);</span>
+
+    <span class="cm">/**</span>
+<span class="cm">     * Adds a control to this Message.</span>
+<span class="cm">     * </span>
+<span class="cm">     * @param control the control to add.</span>
+<span class="cm">     * @return A Message reference</span>
+<span class="cm">     * @throws org.apache.directory.shared.ldap.model.exception.MessageException if controls cannot be added to this Message or the control is</span>
+<span class="cm">     *             not known etc.</span>
+<span class="cm">     */</span>
+    <span class="n">Message</span> <span class="nf">addControl</span><span class="o">(</span> <span class="n">Control</span> <span class="n">control</span> <span class="o">)</span> <span class="kd">throws</span> <span class="n">MessageException</span><span class="o">;</span>
+
+    <span class="cm">/**</span>
+<span class="cm">     * Adds an array of controls to this Message.</span>
+<span class="cm">     * </span>
+<span class="cm">     * @param controls the controls to add.</span>
+<span class="cm">     * @return A Message reference</span>
+<span class="cm">     * @throws MessageException if controls cannot be added to this Message or they are not known etc.</span>
+<span class="cm">     */</span>
+    <span class="n">Message</span> <span class="nf">addAllControls</span><span class="o">(</span> <span class="n">Control</span><span class="o">[]</span> <span class="n">controls</span> <span class="o">)</span> <span class="kd">throws</span> <span class="n">MessageException</span><span class="o">;</span>
+
+    <span class="cm">/**</span>
+<span class="cm">     * Deletes a control removing it from this Message.</span>
+<span class="cm">     * </span>
+<span class="cm">     * @param control the control to remove.</span>
+<span class="cm">     * @return A Message reference</span>
+<span class="cm">     * @throws MessageException if controls cannot be added to this Message or the control is</span>
+<span class="cm">     *             not known etc.</span>
+<span class="cm">     */</span>
+    <span class="n">Message</span> <span class="nf">removeControl</span><span class="o">(</span> <span class="n">Control</span> <span class="n">control</span> <span class="o">)</span> <span class="kd">throws</span> <span class="n">MessageException</span><span class="o">;</span>
+
+    <span class="cm">/**</span>
+<span class="cm">     * Gets the session unique message sequence id for this message. Requests</span>
+<span class="cm">     * and their responses if any have the same message id. Clients at the</span>
+<span class="cm">     * initialization of a session start with the first message&#39;s id set to 1</span>
+<span class="cm">     * and increment it with each transaction.</span>
+<span class="cm">     * </span>
+<span class="cm">     * @return the session unique message id.</span>
+<span class="cm">     */</span>
+    <span class="kt">int</span> <span class="nf">getMessageId</span><span class="o">();</span>
+
+    <span class="cm">/**</span>
+<span class="cm">     * Sets the Message ID for this request</span>
+<span class="cm">     * @param messageId The message Id</span>
+<span class="cm">     * @return A Message reference</span>
+<span class="cm">     */</span>
+    <span class="n">Message</span> <span class="nf">setMessageId</span><span class="o">(</span> <span class="kt">int</span> <span class="n">messageId</span> <span class="o">);</span>
+<span class="o">}</span>
+</pre></div>
+
+
+<h2 id="contents">Contents</h2>
+<div class="codehilite"><pre><span class="o">*</span> <span class="p">[</span><span class="mf">7.1</span> <span class="o">-</span> <span class="n">AbandonRequest</span><span class="p">](</span><span class="mf">7.1</span><span class="o">-</span><span class="n">abandon</span><span class="o">-</span><span class="n">request</span><span class="o">.</span><span class="n">html</span><span class="p">)</span>
+<span class="o">*</span> <span class="p">[</span><span class="mf">7.2</span> <span class="o">-</span> <span class="n">AddRequest</span><span class="p">](</span><span class="mf">7.2</span><span class="o">-</span><span class="n">add</span><span class="o">-</span><span class="n">request</span><span class="o">.</span><span class="n">html</span><span class="p">)</span>
+<span class="o">*</span> <span class="p">[</span><span class="mf">7.3</span> <span class="o">-</span> <span class="n">AddResponse</span><span class="p">](</span><span class="mf">7.3</span><span class="o">-</span><span class="n">add</span><span class="o">-</span><span class="n">response</span><span class="o">.</span><span class="n">html</span><span class="p">)</span>
+<span class="o">*</span> <span class="p">[</span><span class="mf">7.4</span> <span class="o">-</span> <span class="n">BindRequest</span><span class="p">](</span><span class="mf">7.4</span><span class="o">-</span><span class="nb">bind</span><span class="o">-</span><span class="n">request</span><span class="o">.</span><span class="n">html</span><span class="p">)</span>
+<span class="o">*</span> <span class="p">[</span><span class="mf">7.5</span> <span class="o">-</span> <span class="n">BindResponse</span><span class="p">](</span><span class="mf">7.5</span><span class="o">-</span><span class="nb">bind</span><span class="o">-</span><span class="n">response</span><span class="o">.</span><span class="n">html</span><span class="p">)</span>
+<span class="o">*</span> <span class="p">[</span><span class="mf">7.6</span> <span class="o">-</span> <span class="n">CompareRequest</span><span class="p">](</span><span class="mf">7.6</span><span class="o">-</span><span class="n">compare</span><span class="o">-</span><span class="n">request</span><span class="o">.</span><span class="n">html</span><span class="p">)</span>
+<span class="o">*</span> <span class="p">[</span><span class="mf">7.7</span> <span class="o">-</span> <span class="n">CompareResponse</span><span class="p">](</span><span class="mf">7.7</span><span class="o">-</span><span class="n">compare</span><span class="o">-</span><span class="n">response</span><span class="o">.</span><span class="n">html</span><span class="p">)</span>
+<span class="o">*</span> <span class="p">[</span><span class="mf">7.8</span> <span class="o">-</span> <span class="n">DelRequest</span><span class="p">](</span><span class="mf">7.8</span><span class="o">-</span><span class="n">del</span><span class="o">-</span><span class="n">request</span><span class="o">.</span><span class="n">html</span><span class="p">)</span>
+<span class="o">*</span> <span class="p">[</span><span class="mf">7.9</span> <span class="o">-</span> <span class="n">DelResponse</span><span class="p">](</span><span class="mf">7.9</span><span class="o">-</span><span class="n">del</span><span class="o">-</span><span class="n">response</span><span class="o">.</span><span class="n">html</span><span class="p">)</span>
+<span class="o">*</span> <span class="p">[</span><span class="mf">7.10</span> <span class="o">-</span> <span class="n">ExtendedRequest</span><span class="p">](</span><span class="mf">7.10</span><span class="o">-</span><span class="n">extended</span><span class="o">-</span><span class="n">request</span><span class="o">.</span><span class="n">html</span><span class="p">)</span>
+<span class="o">*</span> <span class="p">[</span><span class="mf">7.11</span> <span class="o">-</span> <span class="n">ExtendedResponse</span><span class="p">](</span><span class="mf">7.11</span><span class="o">-</span><span class="n">extended</span><span class="o">-</span><span class="n">response</span><span class="o">.</span><span class="n">html</span><span class="p">)</span>
+<span class="o">*</span> <span class="p">[</span><span class="mf">7.12</span> <span class="o">-</span> <span class="n">IntermediateResponse</span><span class="p">](</span><span class="mf">7.12</span><span class="o">-</span><span class="n">intermediate</span><span class="o">-</span><span class="n">response</span><span class="o">.</span><span class="n">html</span><span class="p">)</span>
+<span class="o">*</span> <span class="p">[</span><span class="mi">7</span><span class="o">.</span> <span class="o">-</span> <span class="n">Message</span> <span class="n">Interface</span><span class="p">](</span><span class="mi">7</span><span class="o">.</span><span class="n">message</span><span class="o">-</span><span class="n">interface</span><span class="o">.</span><span class="n">html</span><span class="p">)</span>
+<span class="o">*</span> <span class="p">[</span><span class="mf">7.13</span> <span class="o">-</span> <span class="n">ModDnRequest</span><span class="p">](</span><span class="mf">7.13</span><span class="o">-</span><span class="n">mod</span><span class="o">-</span><span class="n">dn</span><span class="o">-</span><span class="n">request</span><span class="o">.</span><span class="n">html</span><span class="p">)</span>
+<span class="o">*</span> <span class="p">[</span><span class="mf">7.14</span> <span class="o">-</span> <span class="n">ModDnResponse</span><span class="p">](</span><span class="mf">7.14</span><span class="o">-</span><span class="n">mod</span><span class="o">-</span><span class="n">dn</span><span class="o">-</span><span class="n">response</span><span class="o">.</span><span class="n">html</span><span class="p">)</span>
+<span class="o">*</span> <span class="p">[</span><span class="mf">7.15</span> <span class="o">-</span> <span class="n">ModifyRequest</span><span class="p">](</span><span class="mf">7.15</span><span class="o">-</span><span class="n">modify</span><span class="o">-</span><span class="n">request</span><span class="o">.</span><span class="n">html</span><span class="p">)</span>
+<span class="o">*</span> <span class="p">[</span><span class="mf">7.16</span> <span class="o">-</span> <span class="n">ModifyResponse</span><span class="p">](</span><span class="mf">7.16</span><span class="o">-</span><span class="n">modify</span><span class="o">-</span><span class="n">response</span><span class="o">..</span><span class="n">html</span><span class="p">)</span>
+<span class="o">*</span> <span class="p">[</span><span class="mf">7.17</span> <span class="o">-</span> <span class="n">SearchRequest</span><span class="p">](</span><span class="mf">7.17</span><span class="o">-</span><span class="n">search</span><span class="o">-</span><span class="n">request</span><span class="o">.</span><span class="n">html</span><span class="p">)</span>
+<span class="o">*</span> <span class="p">[</span><span class="mf">7.18</span> <span class="o">-</span> <span class="n">SearchResultDone</span><span class="p">](</span><span class="mf">7.18</span><span class="o">-</span><span class="n">search</span><span class="o">-</span><span class="n">result</span><span class="o">-</span><span class="n">done</span><span class="o">.</span><span class="n">html</span><span class="p">)</span>
+<span class="o">*</span> <span class="p">[</span><span class="mf">7.19</span> <span class="o">-</span> <span class="n">SearchResultEntry</span><span class="p">](</span><span class="mf">7.19</span><span class="o">-</span><span class="n">search</span><span class="o">-</span><span class="n">result</span><span class="o">-</span><span class="n">entry</span><span class="o">.</span><span class="n">html</span><span class="p">)</span>
+<span class="o">*</span> <span class="p">[</span><span class="mf">7.20</span> <span class="o">-</span> <span class="n">SearchResultReference</span><span class="p">](</span><span class="mf">7.20</span><span class="o">-</span><span class="n">search</span><span class="o">-</span><span class="n">result</span><span class="o">-</span><span class="n">reference</span><span class="o">.</span><span class="n">html</span><span class="p">)</span>
+<span class="o">*</span> <span class="p">[</span><span class="mf">7.21</span> <span class="o">-</span> <span class="n">UnbindRequest</span><span class="p">](</span><span class="mf">7.21</span><span class="o">-</span><span class="n">unbind</span><span class="o">-</span><span class="n">request</span><span class="o">.</span><span class="n">html</span><span class="p">)</span>
+</pre></div>
+
+
+    <div class="nav">
+        <div class="nav_prev">
+        
+            <a href="6-ldap-data-structures.html">6 - LDAP Data Structures</a>
+		
+        </div>
+        <div class="nav_up">
+        
+            <a href="../user-guide.html">User Guide</a>
+		
+        </div>
+        <div class="nav_next">
+        
+            <a href="8-ldap-rfcs.html">8 - LDAP Related RFCs</a>
+		
+        </div>
+        <div class="clearfix"></div>
+    </div>
+
+
+                </div><!-- rightColumn -->
+                <div id="endContent"></div>
+            </div><!-- content -->
+            <div id="footer">&copy; 2003-2012, <a href="http://www.apache.org">The Apache Software Foundation</a> - <a href="./../../privacy-policy.html">Privacy Policy</a><br />
+                Apache Directory, ApacheDS, Apache Directory Server, Apache Directory Studio, Apache LDAP API, Apache Triplesec, Triplesec, Apache, the Apache feather logo, and the Apache Directory project logos are trademarks of The Apache Software Foundation.
+            </div>
+        </div><!-- container -->
+    </body>
+</html>
\ No newline at end of file

Added: websites/staging/directory/trunk/content/api/user-guide/7.1-abandon-request.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/7.1-abandon-request.html (added)
+++ websites/staging/directory/trunk/content/api/user-guide/7.1-abandon-request.html Sun Mar 31 21:21:26 2013
@@ -0,0 +1,218 @@
+<!DOCTYPE html>
+<!--
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version 2.0
+    (the "License"); you may not use this file except in compliance with
+    the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<html>
+	<head>
+		<title>7.1 - AbandonRequest &mdash; Apache Directory</title>
+		
+	    <link href="./../../css/common.css" rel="stylesheet" type="text/css">
+	    <link href="./../../css/brown.css" rel="stylesheet" type="text/css">
+    
+        
+        <link rel="shortcut icon" href="./../../images/api-icon_16x16.png">
+    
+        <!-- Google Analytics -->
+        <script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script>
+        <script type="text/javascript">
+            _uacct = "UA-1358462-1";
+            urchinTracker();
+        </script>
+	</head>
+	<body>
+	    <div id="container">
+            <div id="header">
+                <div id="subProjectsNavBar">
+                    <a href="./../../">
+                        
+                        Apache Directory Project
+                        
+                    </a>
+                    &nbsp;|&nbsp;
+                    <a href="./../../apacheds">
+                        
+                        ApacheDS
+                        
+                    </a>
+                    &nbsp;|&nbsp;
+                    <a href="./../../studio">
+                        
+                        Apache Directory Studio
+                        
+                    </a>
+                    &nbsp;|&nbsp;
+                    <a href="./../../api">
+                        
+                        <STRONG>Apache LDAP API</STRONG>
+                        
+                    </a>
+                </div><!-- subProjectsNavBar -->
+            </div><!-- header -->
+            <div id="content">
+                <div id="leftColumn">
+                    
+<div id="navigation">
+    
+    <h5>Downloads</h5>
+    <ul>
+	    <li><a href="./../../api/downloads.html">Version 1.0.0-M16</a>&nbsp;&nbsp;<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>
+    <ul>
+        <li><a href="./../../api/vision.html">Vision</a></li>
+        <li><a href="./../../api/java-api.html">Java API</a></li>
+        <li><a href="./../../api/groovy-ldap.html">Groovy API</a></li>
+    </ul>
+    <h5>Documentation</h5>
+    <ul>
+	    <li><a href="./../../api/five-minutes-tutorial.html">Five minutes tutorial</a></li>
+	    <li><a href="./../../api/user-guide.html">User Guide</a></li>
+        <li><a href="./../../api/gen-docs/latest/apidocs/">JavaDocs</a></li>
+        <!--li><a href="./../../api/gen-docs/latest/">Generated Reports</a></li-->
+        <li><a href="./../../api/developer-guide.html">Developer Guide</a></li>
+    </ul>
+    
+    
+    <h5>Support</h5>
+    <ul>
+        <li><a href="./../../mailing-lists-and-irc.html">Mailing Lists &amp; IRC</a></li>
+        <li><a href="./../../sources.html">Sources</a></li>
+        <li><a href="./../../issue-tracking.html">Issue Tracking</a></li>
+        <li><a href="./../../commercial-support.html">Commercial Support</a></li>
+    </ul>
+    <h5>Community</h5>
+    <ul>
+        <li><a href="./../../contribute.html">How to Contribute</a></li>
+        <li><a href="./../../team.html">Team</a></li>
+        <li><a href="./../../original-project-proposal.html">Original Project Proposal</a></li>
+        <li><a href="./../../special-thanks.html" class="external-link" rel="nofollow">Special Thanks</a></li>
+    </ul>
+    <h5>About Apache</h5>
+    <ul>
+        <li><a href="http://www.apache.org/">Apache</a></li>
+        <li><a href="http://www.apache.org/licenses/">License</a></li>
+        <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+        <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+        <li><a href="http://www.apache.org/security/">Security</a></li>
+    </ul>
+    <a href="http://acna13.eventbrite.com/?ref=ecount"><img src="http://holdenweb.com/static/images/BannerSquareSmall.png" width="168" height="140"></a>
+    
+</div><!-- navigation -->
+
+                </div><!-- leftColumn -->
+                <div id="rightColumn">
+
+
+    <div class="nav">
+        <div class="nav_prev">
+        
+            <a href="7-requests-responses.html">7 - Requests and Responses</a>
+		
+        </div>
+        <div class="nav_up">
+        
+            <a href="7-requests-responses.html">7 - Requests and Responses</a>
+		
+        </div>
+        <div class="nav_next">
+        
+            <a href="7.2-add-request.html">7.2 - AddRequest</a>
+		
+        </div>
+        <div class="clearfix"></div>
+    </div>
+
+
+<h1 id="71-abandonrequest">7.1 AbandonRequest</h1>
+<p>This request is used to tell the server that a given previous request must be abandonned. The only needed parameter is the <em>ID</em> of the request you want to stop. </p>
+<div class="codehilite"><pre><span class="kd">public</span> <span class="kd">interface</span> <span class="nc">AbandonRequest</span> <span class="kd">extends</span> <span class="n">Request</span>
+<span class="o">{</span>
+    <span class="cm">/**</span>
+<span class="cm">     * Gets the id of the request operation to terminate.</span>
+<span class="cm">     * </span>
+<span class="cm">     * @return the id of the request message to abandon</span>
+<span class="cm">     */</span>
+    <span class="kt">int</span> <span class="nf">getAbandoned</span><span class="o">();</span>
+
+    <span class="cm">/**</span>
+<span class="cm">     * Sets the id of the request operation to terminate.</span>
+<span class="cm">     * </span>
+<span class="cm">     * @param requestId the sequence id of the request message to abandon</span>
+<span class="cm">     * @return The AbandonRequest instance</span>
+<span class="cm">     */</span>
+    <span class="n">AbandonRequest</span> <span class="nf">setAbandoned</span><span class="o">(</span> <span class="kt">int</span> <span class="n">requestId</span> <span class="o">);</span>
+<span class="o">}</span>
+</pre></div>
+
+
+<p>There are two existing implementations you can use :</p>
+<ul>
+<li><em>AbandonRequestImpl</em> : The default implementation.</li>
+<li><em>AbandonRequestDsml</em> : An implementation used when you want to generate a DSML request</li>
+</ul>
+<p>The <em>AbandonRequest</em> message does not have a response, the abandonned request will just be stopped.</p>
+<h2 id="usage">Usage</h2>
+<p>It's pretty easy. You just have inject the ID of the request you want to abandon :</p>
+<div class="codehilite"><pre><span class="n">connection</span><span class="o">.</span><span class="na">abandon</span><span class="o">(</span> <span class="n">messageId</span> <span class="o">);</span>
+</pre></div>
+
+
+<p>This will interrupt the request which ID is <em>messageId</em>.</p>
+<h3 id="adding-some-controls">Adding some controls</h3>
+<p>You can add a control in the <em>AbandonRequest</em>, as soon as you create an instance of _AbandonRequestImpl :</p>
+<div class="codehilite"><pre><span class="n">AbandonRequest</span> <span class="n">abandonRequest</span> <span class="o">=</span> <span class="k">new</span> <span class="n">AbandonRequestImpl</span><span class="o">(</span> <span class="n">messageId</span> <span class="o">);</span>
+
+<span class="c1">// Add your control </span>
+<span class="n">abandonRequest</span><span class="o">.</span><span class="na">addControl</span><span class="o">(</span> <span class="n">control</span> <span class="o">);</span>
+
+<span class="c1">// Send the request</span>
+<span class="n">connection</span><span class="o">.</span><span class="na">abandon</span><span class="o">(</span> <span class="n">abandonRequest</span> <span class="o">);</span>
+</pre></div>
+
+
+<p>_</p>
+
+
+    <div class="nav">
+        <div class="nav_prev">
+        
+            <a href="7-requests-responses.html">7 - Requests and Responses</a>
+		
+        </div>
+        <div class="nav_up">
+        
+            <a href="7-requests-responses.html">7 - Requests and Responses</a>
+		
+        </div>
+        <div class="nav_next">
+        
+            <a href="7.2-add-request.html">7.2 - AddRequest</a>
+		
+        </div>
+        <div class="clearfix"></div>
+    </div>
+
+
+                </div><!-- rightColumn -->
+                <div id="endContent"></div>
+            </div><!-- content -->
+            <div id="footer">&copy; 2003-2012, <a href="http://www.apache.org">The Apache Software Foundation</a> - <a href="./../../privacy-policy.html">Privacy Policy</a><br />
+                Apache Directory, ApacheDS, Apache Directory Server, Apache Directory Studio, Apache LDAP API, Apache Triplesec, Triplesec, Apache, the Apache feather logo, and the Apache Directory project logos are trademarks of The Apache Software Foundation.
+            </div>
+        </div><!-- container -->
+    </body>
+</html>
\ No newline at end of file



Mime
View raw message