Jolt Servlet Connectivity Sample


	BEA Home \| Events \| Solutions \| Partners \| Products \| Services \| Download \| Developer Center \| WebSUPPORT
	http://www.oracle.com/technology/documentation/index.html \| Site Map \| Search \| PDF Files \| Contact \| Glossary

Tuxedo Documentation \| Using BEA Jolt \| Local Topics \| Previous Topic \| Next Topic \| Contents \| Index

The Jolt software includes three sample applications that demonstrate servlet connectivity using the Jolt servlet classes. The three samples are:

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

Viewing the Sample Servlet Applications

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.

SimpApp Sample

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.

Note: The WebLogic Server is used in this example.

Requirements for Running the SimpApp Sample

The requirements for running the SimpApp sample are:

Any Web application server with Servlet JSDK 1.1 or above
BEA Tuxedo 8.0 or later with SimpApp sample running
BEA Jolt

Installing the SimpApp Sample

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.
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.
Put the simpapp.html and simpapp.properties files in the public HTML directory.
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
```

Register "Simpapp" for the SimpAppServlet. Consult your Web application server for details. If you are using BEA WebLogic Server, add the following section of the config.xml file:

<Application
   Deployed="true"
   Name="simpapp"
   Path=".\config\mydomain\applications"
>
   <WebAppComponent
     Name="simpapp"
     Targets="myserver"
     URI="simpapp"
   />
</Application>

To access the SimpApp initial page "simpapp.html," type:
http://mywebserver:8080/simpapp.html

BankApp Sample

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