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 Jolt software includes three sample applications that demonstrate servlet connectivity using the Jolt servlet classes. The three samples are:

• SimpApp Sample

• BankApp Sample

• Admin Sample

Refer to these samples in to see code examples of how to use the Jolt servlet classes in your own servlets.

To view the code for the Jolt sample applications, you need to install the Jolt API client classes (usually chosen as an option when installing Jolt). Once the classes are installed in your directory of choice, navigate to the following directory to see the sample application files:

<Installation directory>\udataobj\jolt\examples\servlet

To view the sample code, use a text editor such as Microsoft Notepad to open the Java files for each sample application.

A sample application named "Simpapp" is included with Jolt. The Simpapp application illustrates how the servlet uses Servlet Connectivity for BEA Tuxedo. The following servlet tasks are illustrated by the Simpapp sample:

• Using a property file to create a session pool

• Getting the session pool manager

• Retrieving the session pool by name

• Invoking a BEA Tuxedo service

• Processing the result set

This example demonstrates how a servlet can connect to BEA Tuxedo and call upon one of its services; it should be invoked from the simpapp.html file. The servlet creates a session pool manager at initialization, which is used to obtain a session when the doPost() method is invoked. This session is used to connect to a service in BEA Tuxedo with a name described by the posted "SVCNAME" argument. In this example the service is called "TOUPPER", which transposes the posted "STRING" argument text into uppercase, and returns the result to the client browser within some generated HTML.

The requirements for running the Simpapp sample are:

• Any Web application server with Servlet JSDK 1.1 or above.

• BEA Tuxedo 7.1 or above with SimpApp sample running.

• Jolt.

Installing the SimpApp Sample

1. Install the Jolt class library (jolt.jar) and Servlet Connectivity for BEA Tuxedo class library (joltjse.jar) on the Web application server. Extract the class files if it is required by your Web application server.

2. Compile the SimpAppServlet.java. Make sure that you include the standard JDK 1.1.x classes.zip, JSDK 1.1 classes, Jolt class library, and Servlet Connectivity for BEA Tuxedo class library in the classpath.

   javac -classpath $(JAVA_HOME)/lib/classes.zip:$(JSDK)/lib/servlet.jar:

   	$(JOLTHOME)/jolt.jar:$(JOLTHOME)/joltjse.jar:./classes

   		-d ./classes SimpAppServlet.java

   Note: The package name of the SimpAppServlet is examples.jolt.servlet.simpapp.

3. Put the simpapp.html and simpapp.properties files in the public HTML directory.

4. Modify the simpapp.properties file. Change the "appaddrlist" and "failoverlist" with the proper Jolt server hosts and ports. Specify the proper BEA Tuxedo authentication information if the SimpApp has security turned on. For example:

   	#simpapp

   	#Fri Apr 16 00:43:30 PDT 1999

   	poolname=simpapp

   	appaddrlist=//host:7000,//host:8000

   	failoverlist=//backup:9000

   	minpoolsize=1

   	maxpoolsize=3

   	userrole=tester

   	apppassword=appPass

   	username=guest

   	userpassword=myPass

5. Register "Simpapp" for the SimpAppServlet. Consult your Web application server for details. If you are using WebLogic, add the following line to the weblogic.properties file:

   weblogic.httpd.register.simpapp=examples.jolt.servlet.SimpAppServlet

6. To access the SimpApp initial page "simpapp.html," type:

   http://mywebserver:8080/simpapp.html

The "Bankapp" application illustrates how the servlet is written with PageCompiledServlet with Servlet Connectivity for BEA Tuxedo. Bankapp illustrates how to:

• Use a property file to create a session pool

• Get the session pool manager

• Retrieve a session pool by name

• Invoke a BEA Tuxedo service

• Process the result set

Requirements for Running the Bankapp Sample

Following are the requirements for running the Bankapp sample:

• Any Web application server with Servlet JSDK 1.1 or above

• BEA Tuxedo 7.1 with BankApp sample running

• Jolt

Installation Instructions

1. Install the Jolt class library (jolt.jar) and Servlet Connectivity for BEA Tuxedo class library (joltjse.jar) to the Web application server. Extract the class files if it is required by your Web application server.

2. Copy all HTML, JHTML and bankapp.properties files to the public HTML directory of the Web application server (for example, $WEBLOGIC/myserver/public_html for WebLogic):

   	bankapp.properties

   	tellerForm.html

   	inquiryForm.html

   	depositForm.html

   	withdrawalForm.html

   	transferForm.html

   	InquiryServlet.jhtml

   	DepositServlet.jhtml

   	WithdrawalServlet.jhtml

   	TransferServlet.jhtml

3. Modify the bankapp.properties file. Change the "appaddrlist" and "failoverlist" with the proper Jolt server hosts and ports. Specify the proper BEA Tuxedo authentication information if the BankApp has security turned on. For example:

   	#bankapp

   	#Fri Apr 16 00:43:30 PDT 1999

   	poolname=bankapp

   	appaddrlist=//host:8000,//host:7000

   	failoverlist=//backup:9000

   	minpoolsize=2

   	maxpoolsize=10

   	userrole=teller

   	apppassword=appPass

   	username=JaneDoe

   	userpassword=myPass

4. If applicable, turn on the automatic page compilation for JHTML from your servlet engine. Consult the user manual of your Web application server for details.

5. To access BankApp through Servlet Connectivity for BEA Tuxedo, use the following URL in your favorite browser:

   http://mywebserver:8080/tellerForm.html

The "Admin" sample application illustrates the following servlet tasks:

• Using the administrative API to control the session pools

• Retrieving the statistics through PageCompiledServlet in Servlet Connectivity for BEA Tuxedo

Requirements for Running the Admin Sample

Following are the requirements for running the Admin sample:

• Any Web application server with Servlet JSDK 1.1 or above

• Jolt

Installation Instructions

1. Install the Jolt class library and Servlet Connectivity for BEA Tuxedo class library on the Web application server.

2. Copy all JHTML files to the public HTML directory (for example, $WEBLOGIC/myserver/public_html for WebLogic):

	PoolList.jhtml

	PoolAdmin.jhtml

3. To get a list of session pools, use the following URL in your favorite browser:

http://mywebserver:8080/PoolList.jhtml