Oracle9i Servlet Engine Developer’s Guide

Smith T., Wright B.

This Guide lias been written for several audiences. They include■ Java developers■ Oracle developers not familiar with Java■ managersJava developers who are used to a Java J2EE environment should have very little trouble developing applications for the Oracle Servlet Engine. However, since the 05E rims in a virtual JVM in an Oracle database session, there are concepts and procedures discussed in this Guide that you should understand to facilitate OSE application development.Oracle database developers who are familiar with PL/SQL and other non-Java programming environments should read the overview of Java and object-oriented concepts discussed in the first part of this Guide. For more information about Java, see “Information Resources’ on page -xiv.

---

Table of contents :
Send Us Your Comments……Page 9
Preface……Page 11
1 Oracle Servlet Engine Overview……Page 17
Web Servers and Servlet Engines……Page 18
What Is a Servlet?……Page 19
Kinds of Servlets……Page 20
Advantages of Servlets……Page 21
JavaServer Pages……Page 22
About the Oracle Servlet Engine……Page 23
The Oracle Servlet Engine Namespace……Page 25
Hosting a Web Application……Page 26
Steps in Developing a Web Application……Page 27
2 Oracle Servlet Engine Concepts……Page 29
Getting Started……Page 30
OSE Building Blocks……Page 31
The OSE Session Model……Page 33
Multithreading……Page 34
A Short Introduction to JNDI……Page 36
The OJVM Root Namespace……Page 40
Connecting to an OSE Web Application……Page 43
Connection Using the Oracle HTTP Server as Listener……Page 44
Direct Connection to an Oracle Dispatcher……Page 45
Web Services……Page 47
Single-Domain and Multi-Domain Services……Page 48
The Service Context……Page 49
JNDI Contents of a Web Domain……Page 51
Virtual-Hosted Services……Page 52
Determining the Web Domain……Page 55
Overview……Page 60
Loading and Publishing Servlets……Page 62
Finding the Servlet……Page 63
Thin Driver……Page 71
3 OSE Configuration and Examples……Page 73
Connecting to the OSE……Page 74
Configuring the Oracle Server……Page 75
Oracle Net Configuration……Page 76
Commands……Page 77
Examples……Page 81
Creating Web Domains……Page 83
Creating Servlet Contexts……Page 85
Configuring a Servlet Context……Page 87
Publishing Servlets……Page 93
Summary……Page 95
Creating a Web Service……Page 96
Creating a Web Domain……Page 98
Creating a Servlet……Page 101
Compiling the Servlet……Page 102
Accessing the Servlet……Page 103
Adding Logging Tables……Page 104
Adding Security……Page 105
4 An Apache Module for OSE……Page 107
Apache Architecture……Page 108
Configuration……Page 110
Shared versus Dedicated Servers……Page 111
Servlet Access Using mod_ose……Page 112
Secure Socket Layer Connection……Page 115
Chunking……Page 116
Session ID for Real Application Clusters……Page 117
The AuroraLocationService Directive……Page 118
Topology of a Site Using mod_ose……Page 119
Using mod_osso with mod_ose……Page 120
5 Configuring mod_ose……Page 123
Steps to Take……Page 124
Starting mod_ose……Page 125
httpds.conf……Page 126
ose.conf……Page 127
Including Configuration Files in httpds.conf……Page 130
Oracle Net and Oracle Listener Configuration……Page 131
tnsnames.ora……Page 132
Non-Shared Server Installations……Page 134
exportwebdomain……Page 135
gencfg.pl……Page 136
AuroraLocationService……Page 139
Specifying Stateful and Stateless Handlers in ose.conf……Page 141
SSL Configuration……Page 142
To Configure on the OSE Server Side……Page 144
Securing a Servlet Context with the OSSO Security Servlet……Page 145
Troubleshooting……Page 147
6 Calling EJBs……Page 149
Overview……Page 150
EJB Example……Page 151
Servlet……Page 152
EJB……Page 153
Compiling and Deploying the Example……Page 157
Accessing the Servlet……Page 158
7 Oracle Servlet Engine Security……Page 159
Overview……Page 160
JNDI Security Implementation……Page 161
Servlet Permissions……Page 162
Establishing the Principals……Page 163
Realms……Page 164
Realm Configuration……Page 166
Protecting Web Resources……Page 169
Creating a Security Servlet……Page 172
rdbmsRealm……Page 174
dbUserRealm……Page 175
Troubleshooting……Page 177
8 Oracle WAR Deployment……Page 179
Web Application Servlet Contexts……Page 180
Web Application Hierarchies……Page 181
Web Application Deployment Descriptors……Page 182
Web Application Deployment and WAR Files……Page 184
Distributable Applications and the Oracle Servlet Engine……Page 185
Overview of the Oracle WAR Deployment Tool……Page 186
Security Preparations……Page 188
Database Sessions, Servlet Context Ownership, and Application Privileges……Page 192
Auxiliary Descriptor DTD……Page 195
Auxiliary Descriptor Element and Attribute Descriptions……Page 201
Sample Auxiliary Descriptor……Page 209
Loading Files from the WAR File……Page 213
Creating a Servlet Context……Page 216
Publishing Servlets and JavaServer Pages……Page 217
Securing the Application……Page 220
Oracle WAR Deployment Tool Options and Parameters……Page 221
Vehicles for Invoking the Oracle WAR Deployment Tool……Page 224
Sample Descriptor Files……Page 233
Creating and Deploying the WAR File……Page 235
Current Restrictions……Page 237
9 Writing PL/SQL Servlets……Page 239
Configuring mod_ose to Run PL/SQL Servlets……Page 240
Writing Stateful PL/SQL Stored Procedures……Page 241
Configuring Database Access Descriptors from an Application……Page 243
Package DBMS_EPGC……Page 246
Summary of Subprograms……Page 247
A Abbreviations and Acronyms……Page 253
Index……Page 261