org.apache.directory.ldap.client.api.future

Class MultipleResponseFuture<R extends org.apache.directory.api.ldap.model.message.Response>

java.lang.Object

org.apache.directory.ldap.client.api.future.MultipleResponseFuture<R>

Type Parameters:

R - The result type returned by this Future's get method

All Implemented Interfaces:

Future<R>, ResponseFuture<R>

Direct Known Subclasses:

BindFuture, ExtendedFuture, SearchFuture

public abstract class MultipleResponseFuture<R extends org.apache.directory.api.ldap.model.message.Response>
extends Object
implements ResponseFuture<R>

A Future implementation used in LdapConnection operations.

Author:

Apache Directory Project

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	cancelled flag to determine if this future is cancelled
protected Throwable	cause If the request has been cancelled because of an exception it will be stored here
protected LdapConnection	connection The connection used by the request
protected int	messageId The messageID for this future
protected BlockingQueue<R>	queue the blocking queue holding LDAP responses

Constructor Summary

Constructors

Constructor and Description
MultipleResponseFuture(LdapConnection connection, int messageId) Creates a new instance of ResponseFuture.

Method Summary

Modifier and Type	Method and Description
void	cancel() Cancel the Future
boolean	cancel(boolean mayInterruptIfRunning)
R	get()
R	get(long timeout, TimeUnit unit)
Throwable	getCause()
boolean	isCancelled()
boolean	isDone() This operation is not supported in this implementation of Future.
void	set(R response) Set the associated Response in this Future
void	setCause(Throwable cause) Associate a cause to the ResponseFuture
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

queue

protected BlockingQueue<R extends org.apache.directory.api.ldap.model.message.Response> queue

the blocking queue holding LDAP responses

cancelled

protected boolean cancelled

flag to determine if this future is cancelled

cause

protected Throwable cause

If the request has been cancelled because of an exception it will be stored here

messageId

protected int messageId

The messageID for this future

connection

protected LdapConnection connection

The connection used by the request

Constructor Detail

MultipleResponseFuture

public MultipleResponseFuture(LdapConnection connection,
                              int messageId)

Creates a new instance of ResponseFuture.

Parameters:

connection - The LdapConnection used by the request

messageId - The associated message ID

Method Detail

cancel

public boolean cancel(boolean mayInterruptIfRunning)

Specified by:

cancel in interface Future<R extends org.apache.directory.api.ldap.model.message.Response>

get

public R get()
      throws InterruptedException

Specified by:

get in interface Future<R extends org.apache.directory.api.ldap.model.message.Response>

Throws:

InterruptedException - if the operation has been cancelled by client

set

public void set(R response)
         throws InterruptedException

Set the associated Response in this Future

Specified by:

set in interface ResponseFuture<R extends org.apache.directory.api.ldap.model.message.Response>

Parameters:

response - The response to add into the Future

Throws:

InterruptedException - if the operation has been cancelled by client

get

public R get(long timeout,
             TimeUnit unit)
      throws InterruptedException

Specified by:

get in interface Future<R extends org.apache.directory.api.ldap.model.message.Response>

Throws:

InterruptedException - if the operation has been cancelled by client

isCancelled

public boolean isCancelled()

Specified by:

isCancelled in interface Future<R extends org.apache.directory.api.ldap.model.message.Response>

isDone

public boolean isDone()

This operation is not supported in this implementation of Future.

Specified by:

isDone in interface Future<R extends org.apache.directory.api.ldap.model.message.Response>

getCause

public Throwable getCause()

Specified by:

getCause in interface ResponseFuture<R extends org.apache.directory.api.ldap.model.message.Response>

Returns:

the cause

setCause

public void setCause(Throwable cause)

Associate a cause to the ResponseFuture

Specified by:

setCause in interface ResponseFuture<R extends org.apache.directory.api.ldap.model.message.Response>

Parameters:

cause - the cause to set

cancel

public void cancel()

Cancel the Future

Specified by:

cancel in interface ResponseFuture<R extends org.apache.directory.api.ldap.model.message.Response>

toString

public String toString()

Overrides:

toString in class Object