Mailing-List: contact dev-help@directory.apache.org; run by ezmlm
Precedence: bulk
Reply-To: "Apache Directory Developers List" <dev@directory.apache.org>
Received-SPF: pass (nike.apache.org: domain of elecharny@gmail.com designates
 74.125.82.42 as permitted sender)
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=message-id:date:from:reply-to:user-agent:mime-version:to:subject
         :content-type:content-transfer-encoding;
        b=guUjSOMZa/3zSiCbayC7vXle681+AgXP0Diz6Y67C/kiIr8zJkeIyBntzbqe/Ao9+b
         hcR8UgLxYaJFwWi86mDkwlZBgSTozzJnhVgAtyCI9564hPglOJarv/aS13eFmK5ztKjQ
         /BrwzzYxeVtI/F+Unl3T7hexWDmfTdSM5D7cU=
Message-ID: <4DCAB87C.9030202@gmail.com>
Date: Wed, 11 May 2011 18:25:32 +0200
From: Emmanuel Lecharny <elecharny@gmail.com>
Reply-To: elecharny@apache.org
User-Agent: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.6; en-US;
 rv:1.9.2.17) Gecko/20110414 Thunderbird/3.1.10
MIME-Version: 1.0
To: Apache Directory Developers List <dev@directory.apache.org>
Subject: API evolution
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 8bit

Hi guys,

those last three days, I made some modifications in the API following 
the discussions we has 2 weeks ago. Namely :
1) The 'simple' requests are not anymore returning a Response. If 
somethng went wrong, an exception will be thrown.

For instance, instead of doing :

BindResponse bindResponse = connection.bing( "jdoe", secret" );

if ( bindResponse.getResultCode() == ResultCodeEnum.SUCCESS )
{
     // do something
}

we now do :

try
{
     connection.bing( "jdoe", secret" );
}
catch ( LdapException le )
{
     // Deal with the issue
}

Note that if you do a connection.bind( BindRequest ), then you get back 
a BindResponse.


2) The search request is now returning a EntryCursor for 'simple' searches.

The code now looks like :

          EntryCursor cursor = connection.search( "ou=system", "(objectClass=*)", SearchScope.SUBTREE, "*" );

          while ( cursor.next() )
          {
              Entry result = cursor.get();
              // do something with the Entry

          }

instead of :

          Cursor<Response>  cursor = connection.search( "ou=system", "(objectClass=*)", SearchScope.SUBTREE, "*" );

          while ( cursor.next() )
          {
              Entry result = ( ( SearchResultEntry ) cursor.get() ).getEntry();
              // do something with the Entry
          }

Again, using a connection.search( SearchRequest ), you get back a Cursor<Response>  as a result.


-- 
Regards,
Cordialement,
Emmanuel Lécharny
www.iktek.com