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

• Type: New Feature
• Status: Resolved
• Priority: Major
• Resolution: Won't Fix
• Affects Version/s: 1.0.0
• Fix Version/s: 2.0.0.AM3
• Assignee: Unassigned
• Reporter: Emmanuel Lécharny
• Created: 30/Dec/17 05:56
• Updated: 12/May/19 05:55
• Resolved: 08/Jan/19 10:31

Description

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;