45  * program to set request controls for LDAP operations that are executed
51  * to correctly use request and response controls.
55  * There are two types of request controls:
64  * distinction between these two types of request controls is necessary
73  * it uses the <em>connection request controls</em>, while for the normal
74  * LDAP operations, it uses the <em>context request controls</em>.
75  *<p>Unless explicitly qualified, the term "request controls" refers to
76  * context request controls.
79  * There are two ways in which a context instance gets its request controls:
88  * means no request controls.
91  * updates an existing context instance's request controls to <tt>reqCtls</tt>.
93  * Unlike environment properties, request controls of a context instance
96  * request controls.  You must set the request controls of a derived context
99  * A context instance's request controls are retrieved using
103  * There are three ways in which connection request controls are set:
116  * means no connection request controls.
118  * Like environment properties, connection request controls of a context
120  * Typically, you initialize the connection request controls using the
123  * request controls are inherited by contexts that share the same
127  * Use <tt>reconnect()</tt> to change the connection request controls of
133  * connection request controls must be explicitly changed and is not
134  * affected by changes to another context's connection request
137  * A context instance's connection request controls are retrieved using
142  * A service provider supports connection and context request controls
143  * in the following ways.  Context request controls must be associated on
144  * a per context instance basis while connection request controls must be
146  * must look for the connection request controls in the environment
184     * @param request The non-null request to be performed.
190     public ExtendedResponse extendedOperation(ExtendedRequest request)
194      * Creates a new instance of this context initialized using request controls.
199      * request controls,
201      * and set/get context request controls without having to synchronize with other
205      * request controls as this context. See the class description for details.
210      * @param requestControls The possibly null request controls
212      * If null, the context is initialized with no request controls.
227      * For example, you can use this method to set request controls for
232      * to be its new connection request controls. This context's
233      * context request controls are not affected.
237      * connection request controls for new context instances derived from this
239      * These connection request controls are not
253      * Retrieves the connection request controls in effect for this context.
260      * @exception NamingException If an error occurred while getting the request
266      * Sets the request controls for methods subsequently
268      * The request controls are owned by the JNDI implementation and are
272      * This removes any previous request controls and adds
275      * This method does not affect this context's connection request controls.
282      * To check what request controls are in effect for this context, use
287      * request controls.
294      * Retrieves the request controls in effect for this context.
295      * The request controls are owned by the JNDI implementation and are
299      * @return A possibly-null array of controls. null means no request controls
301      * @exception NamingException If an error occurred while getting the request

Indexes created Tue Jul 24 14:28:13 CEST 2018