Package examples.wireless.stockDemo

See:
          Description

StockDemo Example Summary
DisplayStockAlertAction.java	Displays the initial page for the "stockDemo" application.
StockAlertAction.java	This class does the actual work of getting the stock quote. It then returns the *ML specific displayPrice.jsp to the requesting mobile device.
ControllerServlet.java	This is the controlling servlet that handles all incoming requests.
ApplicationSessionManager.java	This class is used for simple session management.
ApplicationSession.java	This class is used for simple session management.
error.jsp	Default Error page for the StockDemo Application. There are also separate copies of this file for each markup language. (WML, HDML, cHTML, HTML).
stockAlert.jsp	source page for the initial jsp that is invoked from the client requesting the ticker symbol. There is a separate copy of this file for each markup language. (WML, HDML, cHTML, HTML).
displayPrice.jsp	source page for the jsp that is used to display information to the client. There is a separate copy of this file for each markup language. (WML, HDML, cHTML, HTML).
web.xml	Web Application deployment descriptor.
CategoryDefinitions.xml	Descriptor file for the underlying framework which defines categories of devices.
DeviceDefinitions.xml	Descriptor file for the underlying framework which defines attributes of the devices.
JSPSelectionRules.xml	Descriptor file for the underlying framework which defines selection rules for the jsp pages.

 

Package wireless.stockDemo Description

This example illustrates:

• Connectivity between WebLogic Server and a mobile terminal (examples: cell phone, PDA, pager, etc.).
• Generating markup language documents specific to the requesting device from within a JSP.

In this example, stockAlert.jsp is requested by the mobile client. The JSP generates a page requesting a ticker symbol. The result is a stock quote displayed on the mobile client's display. This application will work properly on a client device that supports HTML, WML, HDML or cHTML. A request is received from the client by the HTTP Servlet which then forwards to the correct stockAlert.jsp running on WebLogic Server for the markup language needed by the device. displayPrice.jsp responds by sending a generated *ML document to the device.

Perform the following steps in order to configure and run the example:

1. Build the example
2. Configure the Server
3. Run the Example

Build the example

1. Set up your development shell as described in Setting up your environment.

   We provide a build script for you to build the example, called build.xml.

2. Run the build script using the following Java ant command:
           $ ant

The script will build the example and place the files in the correct locations in your WebLogic Server distribution.

Configure the Server

1. MIME types for WML, HTML, HDML, cHTML, etc. are already registered with the Examples Web Application.

2. The following JSP parameters are already registered with the Examples Web Application and are included here for information only.

   Parameter	Value
   compile command	JAVA_HOME/bin/javac
   pageCheckSeconds	1
   verbose	true

3. Modify the startExamplesServer.cmd and add the following jar file to the end of the CLASSPATH: .\config\examples\applications\webFramework.jar
4. Start the Administration Console and use it as described in the steps that follow to create and statically deploy this example.
5. In the left-hand frame of the Administration Console, click Examples/Deployments/Web Applications.
6. In the right-hand frame of the Administration Console, click Configure a new Web Application.
7. In the right-hand frame of the Console, enter values for the Name, URI, and Path for the stockDemo application.

   Name=stockDemo

   URI=stockDemo

   Path=./config/examples

   Make sure that the Deployed option is checked, and click Create.

8. In the right-hand frame, click the Target tab to display available servers. Select examplesServer, click the right arrow, and click Apply.

Run the Example

1. Start the WebLogic Server with the examples configuration.
2. Load the stockDemo Application into a browser using a URL such as:

   http://hostname:7001/stockDemo/Stock

   where:

   hostname

   Host name of the WebLogic Server.

   port

   Port where the WebLogic Server is listening for connections (weblogic.system.ListenPort).

Note, if this is not using a locally hosted and configured wireless gateway, a port other than 7001 may have to be used. The safest and most common port that most carriers support is port 80.

There's More...

Read more about:

• Framework used for this example.
• Programming WebLogic JSP.
• Programming WebLogic HTTP Servlets.
• Assembling and Configuring Web Applications