[jira] [Created] (DIRAPI-306) Add a Control[] parameter in operations, like what we have for lookup()

["Emmanuel Lecharny (JIRA)" <ji...@apache.org>]

Emmanuel Lecharny created DIRAPI-306:
----------------------------------------

             Summary: Add a Control[] parameter in operations, like what we have for lookup()
                 Key: DIRAPI-306
                 URL: https://issues.apache.org/jira/browse/DIRAPI-306
             Project: Directory Client API
          Issue Type: New Feature
    Affects Versions: 1.0.0
            Reporter: Emmanuel Lecharny
             Fix For: 2.0.0


The {{lookup}} operation has the following available signatures :

* {{Entry lookup( Dn dn ) throws LdapException;}}
* {{Entry lookup( Dn dn, String... attributes ) throws LdapException;}}
* {{Entry lookup( Dn dn, Control[] controls, String... attributes ) throws LdapException;}}
* {{Entry lookup( String dn ) throws LdapException;}}
* {{Entry lookup( String dn, String... attributes ) throws LdapException;}}
* {{Entry lookup( String dn, Control[] controls, String... attributes ) throws LdapException;}}

This is convenient, as we can pass an array of controls to the operation. Although the {{lookup}} function internally resolves to a {{search}}, being able to pass a {{Control}} is a plus we should add to the other operations. For instance, the {{Modify}} operation signatures could be extended from :

* {{void modify( Dn dn, Modification... modifications ) throws LdapException;}}
* {{void modify( String dn, Modification... modifications ) throws LdapException;}}
* {{void modify( Entry entry, ModificationOperation modOp ) throws LdapException;}}
* {{ModifyResponse modify( ModifyRequest modRequest ) throws LdapException;}}

to

* {{void modify( Dn dn, Modification... modifications ) throws LdapException;}}
* {{void modify( Dn dn, Control[] controls, Modification... modifications ) throws LdapException;}}
* {{void modify( String dn, Modification... modifications ) throws LdapException;}}
* {{void modify( String dn, Control[] controls, Modification... modifications ) throws LdapException;}}
* {{void modify( Entry entry, ModificationOperation modOp ) throws LdapException;}}
* {{void modify( Entry entry, Control[] controls, ModificationOperation modOp ) throws LdapException;}}
* {{ModifyResponse modify( ModifyRequest modRequest ) throws LdapException;}}
* {{ModifyResponse modify( ModifyRequest modRequest, Control... controls ) throws LdapException;}}




--
This message was sent by Atlassian JIRA
(v6.4.14#64029)