TibrvCmListener

Class

Declaration

class com.tibco.tibrv.TibrvCmListener
  extends TibrvListener

Purpose

A certified delivery listener object listens for labeled messages and certified messages.

Remarks

Each call to the constructor TibrvCmListener() results in a new certified delivery listener, which represents your program’s listening interest in a stream of labeled messages and certified messages. Rendezvous software uses the same listener object to signal each occurrence of such an event.

We recommend that programs explicitly destroy each certified delivery listener object using TibrvCmListener.destroy(). Destroying a certified listener object cancels the program’s immediate interest in that event, and frees its storage; nonetheless, a parameter to the destroy call determines whether certified delivery agreements continue to persist beyond the destroy call.

Programs must destroy instances of this class. Rendezvous software keeps internal references to these objects, so the Java garbage collector does not delete them automatically.

Destroying the queue or the certified delivery transport of a listener object automatically destroys the listener as well (but certified delivery agreements continue to persist).

Method

Description

TibrvCmListener()

Listen for messages that match the subject, and request certified delivery when available.

TibrvCmListener.destroy()

Destroy a certified delivery listener.

TibrvCmListener.confirmMsg()

Explicitly confirm delivery of a certified message.

TibrvCmListener.isExplicitConfirm()

Test whether this listener expects explicit confirmation of delivery.

TibrvCmListener.setExplicitConfirm()

Override automatic confirmation of delivery for this listener.

Inherited Methods

TibrvListener.getSubject()

TibrvListener.getTransport()

TibrvEvent.getClosure()

TibrvEvent.getQueue()

TibrvEvent.isValid()

java.lang.Object.equals

java.lang.Object.getClass

java.lang.Object.hashCode

java.lang.Object.notify

java.lang.Object.notifyAll

java.lang.Object.toString (override)

java.lang.Object.wait

Related Classes

TibrvEvent

TibrvListener