directory-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Emmanuel Lecharny (JIRA)" <j...@apache.org>
Subject [jira] [Created] (DIRAPI-306) Add a Control[] parameter in operations, like what we have for lookup()
Date Sat, 30 Dec 2017 05:57:00 GMT
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)

Mime
View raw message