/** finalize */
protected final void finalize() throws Throwable {
if (Debug.LDAP_DEBUG) {
Debug.trace(Debug.messages, name + "finalize");
}
super.finalize();
cleanup();
return;
}
/* package */
void abandon(LDAPConstraints cons, InterThreadException informUserEx) {
if (!waitForReply) {
Debug.trace(Debug.messages, name + "Abandon request ignored");
return;
}
if (Debug.LDAP_DEBUG) {
Debug.trace(
Debug.messages,
name
+ "Abandon request, complete="
+ complete
+ ", bind="
+ (bindprops != null)
+ ", informUser="******", waitForReply="
+ waitForReply);
}
acceptReplies = false; // don't listen to anyone
waitForReply = false; // don't let sleeping threads lie
if (!complete) {
try {
// If a bind, release bind semaphore & wake up waiting threads
// Must do before writing abandon message, otherwise deadlock
if (bindprops != null) {
int id;
if (conn.isBindSemIdClear()) {
// Semaphore id for normal operations
id = msgId;
} else {
// Semaphore id for sasl bind
id = conn.getBindSemId();
conn.clearBindSemId();
}
conn.freeWriteSemaphore(id);
}
if (Debug.LDAP_DEBUG) {
Debug.trace(Debug.messages, name + "Sending abandon request");
}
// Create the abandon message, but don't track it.
LDAPControl[] cont = null;
if (cons != null) {
cont = cons.getControls();
}
LDAPMessage msg = new LDAPAbandonRequest(msgId, cont);
// Send abandon message to server
conn.writeMessage(msg);
} catch (LDAPException ex) {; // do nothing
}
// If not informing user, remove message from agent
if (informUserEx == null) {
agent.abandon(msgId, null);
}
conn.removeMessage(this);
}
// Get rid of all replies queued
if (informUserEx != null) {
replies.addElement(new LDAPResponse(informUserEx, conn.getActiveReferral()));
if (Debug.LDAP_DEBUG) {
Debug.trace(
Debug.messages,
name
+ "Queued exception as LDAPResponse ("
+ replies.size()
+ " in queue):"
+ " following referral="
+ (conn.getActiveReferral() != null)
+ "\n\texception: "
+ informUserEx.getLDAPErrorMessage());
}
stopTimer();
// wake up waiting threads to receive exception
sleepersAwake();
// Message will get cleaned up when last response removed from queue
} else {
// Wake up any waiting threads, so they can terminate.
// If informing the user, we wake sleepers after
// caller queues dummy response with error status
sleepersAwake();
cleanup();
}
return;
}