Contents

Title and Copyright Information

Send Us Your Comments

Preface

Conventions

1 Oracle Servlet Engine Overview

Web Servers and Servlet Engines

A Brief Introduction to Servlets

What Is a Servlet?

Kinds of Servlets

Advantages of Servlets

JavaServer Pages

About the Oracle Servlet Engine

The Oracle Servlet Engine Namespace

Hosting a Web Application

Steps in Developing a Web Application

2 Oracle Servlet Engine Concepts

Getting Started

OSE Building Blocks

The OSE Session Model

Servlet Activation

Multithreading

The OSE Namespace

A Short Introduction to JNDI

The OJVM Root Namespace

Connecting to an OSE Web Application

Connection Using the Oracle HTTP Server as Listener

Direct Connection To an Oracle Listener

Direct Connection to an Oracle Dispatcher

Web Services

Single-Domain and Multi-Domain Services

Creating a Web Service

The Service Context

Web Domains

JNDI Contents of a Web Domain

Virtual-Hosted Services

Determining the Web Domain

Servlet Contexts

Overview

Loading and Publishing Servlets

Finding the Servlet

Accessing the Oracle Database

Server-side Internal Driver

Thin Driver

3 OSE Configuration and Examples

Connecting to the OSE

Configuration Steps

Configuring the Oracle Server

Oracle Net Configuration

Creating a Web Service

Commands

Creating Multi-Domain Web Services

Examples

Creating Web Domains

Creating Servlet Contexts

Configuring a Servlet Context

Publishing Servlets

Summary

Creating a Web Service

Creating a Web Domain

Creating a Servlet Context

Creating a Servlet

Compiling the Servlet

Loading the Servlet into the Database

Publishing the Servlet

Accessing the Servlet

Adding Logging Tables

Adding Security

4 An Apache Module for OSE

Overview

Why Use mod_ose?

Apache Architecture

Configuration

Requirements

Shared versus Dedicated Servers

mod_ose Connections

Servlet Access Using mod_ose

Secure Socket Layer Connection

HTTP Request and Response Processing

Processing the URL

Chunking

Session ID for Real Application Clusters

The AuroraLocationService Directive

Topology of a Site Using mod_ose

Using mod_osso with mod_ose

5 Configuring mod_ose

Steps to Take

Starting mod_ose

Configuration Files

httpds.conf

ose.conf

Including Configuration Files in httpds.conf

Oracle Net and Oracle Listener Configuration

Generating a Configuration File

tnsnames.ora

Non-Shared Server Installations

Configuration Utilities

exportwebdomain

gencfg.pl

AuroraLocationService

Specifying Stateful and Stateless Handlers in ose.conf

SSL Configuration

Configuring mod_osso

To Configure on the Apache Side

To Configure on the OSE Server Side

Securing a Servlet Context with the OSSO Security Servlet

Troubleshooting

6 Calling EJBs

Overview

EJB Example

Servlet

EJB

Compiling and Deploying the Example

Accessing the Servlet

7 Oracle Servlet Engine Security

Overview

JNDI Security

JNDI Security Implementation

Servlet Permissions

HTTP Security

Establishing the Principals

Realms

The Session Shell Realm Commands

Realm Configuration

Protecting Web Resources

Declaring A Security Servlet

Creating a Security Servlet

Examples

rdbmsRealm

dbUserRealm

Troubleshooting

8 Oracle WAR Deployment

Standard Web Applications and Hierarchies

Web Application Servlet Contexts

Web Application Hierarchies

Web Application Deployment Descriptors

Web Application Deployment and WAR Files

Overview of WAR Deployment to the Oracle9i Database

Distributable Applications and the Oracle Servlet Engine

Overview of the Oracle Auxiliary Descriptor

Overview of the Oracle WAR Deployment Tool

Security Preparations

Database Sessions, Servlet Context Ownership, and Application Privileges

Oracle Auxiliary Descriptor

Auxiliary Descriptor DTD

Auxiliary Descriptor Element and Attribute Descriptions

Sample Auxiliary Descriptor

Oracle WAR Deployment Tool Functionality

Loading Files from the WAR File

Creating a Servlet Context

Publishing Servlets and JavaServer Pages

Securing the Application

Oracle WAR Deployment Tool Usage

Oracle WAR Deployment Tool Options and Parameters

Vehicles for Invoking the Oracle WAR Deployment Tool

Sample Application Hierarchy and Descriptor Files

Sample Hierarchy

Sample Descriptor Files

Creating and Deploying the WAR File

Current Restrictions

9 Writing PL/SQL Servlets

Overview of PL/SQL Servlets

Configuring mod_ose to Run PL/SQL Servlets

Writing Stateful PL/SQL Stored Procedures

Configuring Database Access Descriptors from an Application

Package DBMS_EPGC

Summary of Subprograms

A Abbreviations and Acronyms

Index