Using Oracle Tuxedo Event Subscription and Notification with JoltBeans

Oracle Tuxedo supports brokered and unsolicited event notification. Jolt provides a mechanism for Jolt clients to receive Oracle Tuxedo events. JoltBeans also include this capability.

Note:

Oracle Tuxedo event subscription and notification is different from JavaBeans events.

The following procedure illustrates how the Oracle Tuxedo asynchronous notification mechanism is used in JoltBeans applications.

  1. Use the setEventName() and setFilter() methods of the JoltUserEventBean to specify the Oracle Tuxedo event to which you want to subscribe.
  2. The component that receives the event notifications registers itself as a JoltOutputListener to the JoltSessionBean.
  3. The subscribe() method is called on JoltUserEventBean.
  4. When the actual Oracle Tuxedo event notification arrives, JoltSessionBean sends a JoltOutputEvent to its listeners by calling serviceReturned() on them. The JoltOutputEvent object contains the data of the Oracle Tuxedo event.

When the client no longer needs to receive the event, it calls unsubscribe() on the JoltUserEventBean.

Note:

If the client will only subscribe to unsolicited events, use setEventName ("\\.UNSOLMSG"), which can be set using the property sheet. EventName and Filter are properties of the JoltUserEventBean.