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)
