The JoltBeans Toolkit

The JoltBeans Toolkit includes the following beans:

These components transform the complete Jolt Class Library into beans components, with all of the features of any typical JavaBean, including easy reuse and graphic development.

Refer to the online BEA Jolt API Reference for specific descriptions of the JoltBeans classes, constructors, and methods.

The following sections provide information about the properties of each bean.

JoltSessionBean

The JoltSessionBean, which represents the BEA Tuxedo session, encapsulates the functionality of the JoltSession, JoltSessionAttributes, and JoltTransaction classes. The JoltSessionBean has properties that you use to set session and security attributes, such as sending a timeout or a BEA Tuxedo username, as well as methods to open and close a BEA Tuxedo session.

The JoltSessionBean sends a PropertyChange event when the BEA Tuxedo session is established or closed. PropertyChange is a standard bean event defined in the java.beans package. The purpose of this event is to signal other beans about a change of the value of a property in the source bean. In this case, the source is the JoltSessionBean; the targets are JoltServiceBeans or JoltUserEventBeans; and the property changing is the LoggedOn property of the JoltSessionBean. When a logon is successful and a session is established, LoggedOn is set to true. After the logoff is successful and the session is closed, the LoggedOn property is set to false.

The JoltSessionBean provides methods to control transactions, including beginTransaction(), commitTransaction(), and rollbackTransaction().

The following table shows the JoltSessionBean properties and descriptions.

JoltSessionBean Properties and Descriptions

JoltServiceBean

The JoltServiceBean represents a remote BEA Tuxedo service. The name of the service is set as a property of the JoltServiceBean. The JoltServiceBean listens to JoltInputEvents from other beans to populate its input buffer. JoltServiceBean offers the callService() method to invoke the service. JoltServiceBean is an event source for JoltOutputEvents that carry information about the output of the service. After a successful callService(), listener beans are notified via a JoltOutputEvent that carries the reply message.

Although the primary way of changing and querying the underlying message buffer of the JoltServiceBean is via events, the JoltServiceBean also provides methods to access the underlying message buffer directly (setInputValue(), getOutputValue()).

The following table shows the JoltServiceBean properties and descriptions.

JoltServiceBean Properties and Descriptions

JoltUserEventBean

The JoltUserEventBean provides access to BEA Tuxedo events. You define the BEA Tuxedo event to which you subscribe or unsubscribe by setting the appropriate properties of this bean (event name and event filter). The actual event notification is delivered in the form of a JoltOutputEvent from the JoltSessionBean.

The following table shows the JoltUserEventBean properties and descriptions.

JoltUserEventBean Properties and Descriptions