com.novell.ldap
Class LDAPResponseQueue

java.lang.Object
  com.novell.ldap.LDAPMessageQueue
      com.novell.ldap.LDAPResponseQueue

public class LDAPResponseQueue
extends LDAPMessageQueue

A mechanism for processing asynchronous messages received from a server. It represents the message queue associated with a particular asynchronous LDAP operation or operations.

Field Summary

Fields inherited from class com.novell.ldap.LDAPMessageQueue

agent, name, nameLock, queueNum

Constructor Summary

LDAPResponseQueue(MessageAgent agent)
Constructs a response queue using the specified message agent

Method Summary

void	merge(LDAPMessageQueue queue2) Merges two message queues.

Methods inherited from class com.novell.ldap.LDAPMessageQueue

getDebugName, getMessageAgent, getMessageIDs, getResponse, getResponse, isComplete, isResponseReceived, isResponseReceived

Methods inherited from class java.lang.Object

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

Constructor Detail

LDAPResponseQueue

LDAPResponseQueue(MessageAgent agent)

Constructs a response queue using the specified message agent

Parameters:

agent - The message agent to associate with this queue

Method Detail

merge

public void merge(LDAPMessageQueue queue2)

Merges two message queues. It appends the current and future contents from another queue to this one.

After the operation, queue2.getMessageIDs() returns an empty array, and its outstanding responses have been removed and appended to this queue

.

Parameters:

queue2 - The queue that is merged from. Following the merge, this queue object will no longer receive any data, and calls made to its methods will fail with a RuntimeException. The queue can be reactivated by using it in an LDAP request, after which it will receive responses for that request..