All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class bea.jolt.JoltUserEvent 

java.lang.Object
   |
   +----bea.jolt.JoltEvent
           |
           +----bea.jolt.JoltUserEvent
public class JoltUserEvent
extends JoltEvent
The JoltUserEvent class implements a subscription to an asynchronous notification event. An asynchronous notification is either an unsolicited event notification or an event notification from the TUXEDO Event Broker. Unsolicited notifications are produced in response to a TUXEDO tpnotify() call or a TUXEDO tpbroadcast() call. Event notifications are produced as a result of a TUXEDO tppost() call. Handling of unsolicited notification and event notification is done in the Session object. This class uses a thread to monitor any messages.

See Also:
JoltSession, JoltMessage, JoltReply

Variable Index

o UNSOLMSG
The regular expression constant to request unsolicited messages.

Constructor Index

o JoltUserEvent(String, String, Session)
This constructor subscribes the specific asynchronous notification.

Variables

o UNSOLMSG 
 public static final String UNSOLMSG
The regular expression constant to request unsolicited messages.

Constructors

o JoltUserEvent 
 public JoltUserEvent(String expr,
                      String filter,
                      Session session) throws EventException, SessionException
This constructor subscribes the specific asynchronous notification. An asynchronous notification can be an unsolicited notification or an event notification. If expr is JoltUserEvent.UNSOLMSG, the filter must be null. Otherwise, the filter can be either null or it can be a a boolean expression (see Fboolco(3) in the TUXEDO Reference Manual).

Parameters:
expr - A string containing a regular expression in the same format as the event expression used in tpsubscribe(). The maximum length of this parameter is 255 characters. Setting this parameter to the constant JoltUserEvent.UNSOLMSG allows the client to receive unsolicited messages (generated as a result of tpnotify() or tpbroadcast()).
filter - Null or Boolean expression. This parameter is a string in the same format as the filter parameter passed to tpsubscribe(). The maximum length of this parameter is 255 characters. Filter rules are specific to the buffers to which they are applied. Refer to TUXEDO documentation for a complete explanation of the filtering function. Filtering is done on the TUXEDO server, not the Jolt client.
session - A JoltSession object, the Jolt session to which the subscription is bound. An event is bound to a a single session.
Throws: SessionException
Invalid session or a session error.
Throws: EventException
Indicates that the filter for unsolicited subscription is not null, or event subscription failed. 
All Packages  Class Hierarchy  This Package  Previous  Next  Index