Return-Path: Delivered-To: apmail-directory-dev-archive@www.apache.org Received: (qmail 86909 invoked from network); 1 Apr 2009 09:40:22 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.3) by minotaur.apache.org with SMTP; 1 Apr 2009 09:40:22 -0000 Received: (qmail 70504 invoked by uid 500); 1 Apr 2009 09:40:22 -0000 Delivered-To: apmail-directory-dev-archive@directory.apache.org Received: (qmail 70418 invoked by uid 500); 1 Apr 2009 09:40:21 -0000 Mailing-List: contact dev-help@directory.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: "Apache Directory Developers List" Delivered-To: mailing list dev@directory.apache.org Received: (qmail 70319 invoked by uid 99); 1 Apr 2009 09:40:21 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 01 Apr 2009 09:40:21 +0000 X-ASF-Spam-Status: No, hits=2.2 required=10.0 tests=HTML_MESSAGE,SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (athena.apache.org: domain of akarasulu@gmail.com designates 74.125.46.29 as permitted sender) Received: from [74.125.46.29] (HELO yw-out-2324.google.com) (74.125.46.29) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 01 Apr 2009 09:40:14 +0000 Received: by yw-out-2324.google.com with SMTP id 5so2074163ywh.55 for ; Wed, 01 Apr 2009 02:39:54 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:mime-version:received:in-reply-to:references :date:message-id:subject:from:to:content-type; bh=Zd+Nyc2eog7z4svgyJaUmzw4CiDeGVudA2kko0XkKvM=; b=TtlkIfVRMIzGQHQCLYJATLhgPulcKok6U+SVb60Q6F7Eamzv+ksIk34R6AOVcE41aX Nkz4gNFcu1OU1gE57XujkRSkdp/2Gn93qwWj/8TELFhJbOXB1UWUmwFqAAjbF4VMAcjc OGTKBcAsbyeIm6T48SFuFa0godyqUcUara3Vc= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :content-type; b=iktvoUKMT71Sn2lgH5irwIqKJ7L5/gJXVsuJ4HSrKenjCUtmamPO2b6qGBlWYdtibW 5Ul7AeqeEnDlUe3W7CW9TwkaGl7pAWn2g2Kb9ENYrEL68Qlj/GfFUsFrNuds34XocRvT G3OLMSVtgWwGUPuxLqxOwOgmW8sVY0gaODhV4= MIME-Version: 1.0 Received: by 10.231.15.74 with SMTP id j10mr1611380iba.30.1238578793771; Wed, 01 Apr 2009 02:39:53 -0700 (PDT) In-Reply-To: <49D28924.5010604@nextury.com> References: <49CF4FE0.9040502@nextury.com> <49CFAC1F.9000308@nextury.com> <49D11DAE.1000109@labeo.de> <49D14DED.5000505@nextury.com> <49D1F37D.1060301@nextury.com> <49D20AFA.1070507@nextury.com> <49D21B16.7080501@gmail.com> <49D28924.5010604@nextury.com> Date: Wed, 1 Apr 2009 11:39:53 +0200 Message-ID: Subject: Re: [Client API] Bind Operation From: Alex Karasulu To: Apache Directory Developers List Content-Type: multipart/alternative; boundary=00221532cba00771d704667b19a0 X-Virus-Checked: Checked by ClamAV on apache.org --00221532cba00771d704667b19a0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Hi Emm, On Tue, Mar 31, 2009 at 11:20 PM, Emmanuel Lecharny wrote: > So here is what I have from now on : > > > Simple bind (blocking) : > public LdapResponse bind() throws LdapException > public LdapResponse bind( String name ) throws Exception > public LdapResponse bind( String name, String credentials ) throws > LdapException > public LdapResponse bind( String name, byte[] credentials ) throws > LdapException > For the common (90%) case perhaps just bind() and bind( String, String ) works no? > > Sasl and other complex operations (blocking and not blocking): > public LdapResponse bind( BindRequest bindRequest ) throws LdapException > public void bind( BindRequest bindRequest, BindListener bindListener ) > throws LdapException > Cool. > I was trying to evaluate if it's a good idea to have bindSasl() methods, > instead of having a generic bind( BindRequest). In this case, we will have > this additional method : > public LdapResponse bindSasl( String name, String mechanism, byte[] > credentials ) throws LdapException > Yeah this helps with the simple case. People are using SASL more and more these days. More common though people are using StartTLS. Maybe that's something to keep in mind. But do we really need this in some kind of simple case? Again we want to balance convenience with congestion to make the API as easy to use and understand as possible. Alex --00221532cba00771d704667b19a0 Content-Type: text/html; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable Hi Emm,

On Tue, Mar 31, 2009 at 11:20 PM,= Emmanuel Lecharny <elecharny@apache.org> wrote:
So here is what I have from now on :


Simple bind (blocking) :
=A0 public LdapResponse bind() =A0throws LdapException
=A0 public LdapResponse bind( String name ) throws Exception
=A0 public LdapResponse bind( String name, String credentials ) throws Lda= pException
=A0 public LdapResponse bind( String name, byte[] credentials ) =A0throws = LdapException


For the common (90%) case perhaps just bind() and= bind( String, String ) works no?
=A0

Sasl and other complex operations (blocking and not blocking):
=A0 public LdapResponse bind( BindRequest bindRequest ) throws LdapExcepti= on
=A0 public void bind( BindRequest bindRequest, BindListener bindListener )= throws LdapException

Cool.


I was trying to evaluate if it's a good idea to have bindSasl() methods= , instead of having a generic bind( BindRequest). In this case, we will hav= e this additional method =A0:
=A0 public LdapResponse bindSasl( String name, String mechanism, byte[] cr= edentials ) =A0throws LdapException
=

Yeah this helps with the simple case.=A0 People= are using SASL more and more these days.=A0 More common though people are = using StartTLS.=A0 Maybe that's something to keep in mind.=A0 But do=A0= we really need this in some kind of simple case?=A0 Again we want to balan= ce convenience with congestion to make the API as easy to use and understan= d as possible.

Alex

=A0

--00221532cba00771d704667b19a0--