Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy
	http://www.oracle.com/technology/documentation/index.html   |   Site Map   |   Search   |   PDF Files   |   Contact   |   Glossary
Tuxedo Doc Home   |   Jolt   |   Topic List   |   Previous   |   Next   |   Contents   |   Index

   Using BEA Jolt

The JoltBeans Toolkit includes the following beans:

• JoltSessionBean

• JoltServiceBean

• JoltUserEventBean

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 API Reference in Javadoc for specific descriptions of the JoltBeans classes, constructors, and methods.

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

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 user name, 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

Property	Description
AppAddress	Set the IP address (host name) and port number of the JSL or the Jolt Relay. The format is //host:port number (for example, myhost:7000).
AppPassword	Set the BEA Tuxedo application password used at logon, if required.
IdleTimeOut	Set the IDLETIMEOUT value.
inTransaction	Indicate true or false depending if a transaction has been started and not committed or aborted.
LoggedOn	Indicate true or false if a BEA Tuxedo session does or does not exist.
ReceiveTimeOut	Set the RECVTIMEOUT value.
SendTimeOut	Set the SENDTIMEOUT value.
SessionTimeOut	Set the SESSIONTIMEOUT value.
UserName	Indicate the BEA Tuxedo user name, if required.
UserPassword	Indicate the BEA Tuxedo user password, if required.
UserRole	Indicate the BEA Tuxedo user role, if required.

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

Property	Description
ServiceName	The name of the BEA Tuxedo service represented by this JoltServiceBean.
Session	The JoltSessionBean associated with the bean that allows access to the BEA Tuxedo client session.
Transactional	Set to true if this JoltServiceBean is to be included in the transaction that was started by its JoltSessionBean.

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

Property	Description
EventName	Set the name of the user event represented by the bean.
Filter	Set the event filter.
Session	The JoltSessionBean associated with the bean that allows access to the BEA Tuxedo client session.