Contents

Title and Copyright Information

Send Us Your Comments

Preface

Intended Audience

Documentation Accessibility

Related Documentation

Part I Overview of Sample Applications and Contents of Database

1 Creating Applications: Overview

1.1 Overview of OracleAS

1.1.2 Enterprise Portals

1.1.3 Wireless Support

1.2 The Sample Applications

1.3 Database Schema

1.4 Development Steps

1.5 Development Tools

1.6 What This Guide Covers and Does Not Cover

2 Designing the Application

2.1 Design Goals

2.2 Chaining Pages

2.3 Using Model-View-Controller (MVC)

2.3.1 MVC Diagram

2.3.2 Controller

2.3.3 Model (Business Logic)

Part II The First Sample Application

3 The First Sample Application: Requirements and Screenshots

3.1 Requirements for the First Sample Application

3.2 Screenshots of the First Sample Application

4 Implementing Business Logic

4.1 Objects Needed by the First Sample Application

4.2 Other Options Considered But Not Taken

4.2.1 Conditions that Favor Using EJBs

4.2.2 Conditions that Favor Using Servlets

4.2.3 Conditions that Favor Using Normal Java Objects

4.4 Action Handlers

4.5 Employee Data (Entity Bean)

4.5.1 Home Interface

4.5.2 Remote Interface

4.5.3 Persistence

4.5.4 Load Method

4.5.5 EmployeeModel Class

4.5.6 Data Access Object for Employee Bean

4.5.6.1 Interface

4.5.6.2 Implementation

4.5.6.3 Load Method

4.6 Benefit Data (Stateless Session Bean)

4.6.1 Home Interface

4.6.2 Remote Interface

4.6.3 Benefit Details

4.7 EmployeeManager (Stateless Session Bean)

4.7.1 Home Interface

4.7.2 Remote Interface

4.8 Utility Classes

5 Creating Presentation Pages

5.2.1 Automatic Compilation of Servlets

5.2.3 Example: Calling an EJB

5.3.1 Tag Libraries

5.3.2 Minimal Coding in JSPs

5.3.3 Multiple Client Types

6 Tracing Flows Between Clients and Business Logic Objects

6.1 Client Interface to Business Tier Objects

6.2 Query Employee Operation

6.2.1 High-Level Sequence

6.2.2 Querying the Database and Retrieving Data

6.2.3 findByPrimaryKey Method

6.2.4 Getting Benefit Data

6.3 Add and Remove Benefit Operations

6.4 Add Benefit Operation

6.4.1 High-Level Sequence of Events

6.4.2 Getting Benefits That the User Can Add

6.4.3 Updating the Database

6.5 Removing Benefit Operation

6.5.1 High-Level Sequence of Events

6.5.2 Getting Benefits That the User Can Remove

6.5.3 Updating the Database

7 Configuring OracleAS Web Cache for the Application

7.1 Choosing Which Pages to Cache

7.2 Analyzing the Application

7.2.1 Specifying the Pages to Cache

7.2.2 Invalidating Pages

7.2.3 Setting up Triggers on the Underlying Tables

8 Supporting Wireless Clients

8.1 Changes You Need To Make To Your Application

8.2 Presentation Data for Wireless Clients

8.2.1 Screens for the Wireless Application

8.2.2 Differences Between the Wireless and the Browser Application

8.3 Deciding Where to Put the Presentation Data for Wireless Clients

8.3.1 Determining the Origin of a Request

8.3.2 Combining Presentation Data in the Same JSP File

8.3.3 Separating Presentation Data into Separate Files

8.4 Header Information in JSP Files for Wireless Clients

8.4.1 Setting the XML Type

8.4.2 Setting the Content Type

8.5 Operation Details

8.5.1 Query Operation

8.5.2 queryEmployeeWireless.jsp

8.5.3 Add and Remove Benefits Operations

8.6 Accessing the Application

8.6.1 Using a Simulator

8.6.2 Using an Actual Wireless Client

9 Running in a Portal Framework

9.1 How Portal Processes Requests

9.2 Screenshots of the Application in a Portal

9.3 Changes You Need to Make to the Application

9.3.1 Set up a Provider and a Portal Page

9.3.2 Edit the Application

9.4 Update the Links Between Pages Within a Portlet

9.4.1 The parameterizeLink Method

9.4.2 The next_page Parameter

9.4.3 Linking to the ID Page

9.5 Use include instead of the forward Method

9.6 Protect Parameter Names

9.6.1 Retrieving Values

9.6.2 Setting Values

9.7 Make All Paths Absolute

9.7.1 <a> and <link> Tags

9.7.2 <form> Tag

Part III The Second Sample Application

10 Updating EJBs to Use EJB 2.0 Features

10.1 Overview of the Second Sample Application

10.1.1 Business Operations in the Second Sample Application

10.1.2 Design of the Second Application

10.1.3 EJB 2.0 Features Used by the Entity Beans

10.2 Details of employeeCount Method

10.3 Details of listBenefits Method

10.4 Details of addNewBenefit Method

10.5 Details of listBenefitsOfEmployee Method

10.6 Details for countEnrollmentsForBenefit Method

10.7 Entity Beans and Database Tables

10.7.1 Persistent Fields in the ejb-jar.xml File

10.7.2 Persistent Fields in the Local Interface

10.7.3 Persistent Fields in the orion-ejb-jar.xml File

10.8 Relationship Fields in the Entity Beans

11 Enabling Web Services in the Application

11.1 Enabling Web Services in the Second Sample Application

11.1.1 Create the Configuration File for the Web Services Assembly Tool

11.1.2 Run the Web Services Assembly Tool

11.1.3 Deploy the Application

11.1.4 Test the Exposed Methods from the Web Service’s Home Page

11.2 Creating a Web Services Client Application

11.2.1 Design of the Web Services Client

11.2.2 Steps for Developing a Web Services Client

11.2.3 Directory Structure for the Web Services Client

11.2.4 Request Flow in the Web Services Client

11.2.5 Screens for the Web Services Client

A Configuration Files

A.2 default-web-site.xml

A.3 data-sources.xml

Index