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
-
UNSOLMSG
- The regular expression constant to request unsolicited messages.
-
JoltUserEvent(String, String, Session)
- This constructor subscribes the specific asynchronous notification.
UNSOLMSG
public static final String UNSOLMSG
- The regular expression constant to request unsolicited messages.
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