Index DocHome Next |
iPlanet Application Server Developer's Guide (Java) |
Contents
Preface
Chapter 1 Developing ApplicationsApplication Requirements
About the Application Programming Model
The Presentation Layer
Effective iPlanet Application Guidelines
Servlets
The Business Logic Layer
JSPs
HTML Pages
Client-Side JavaScript
Session Beans
The Data Access Layer
Entity Beans
Presenting Data with Servlets and JSPs
Creating Reusable Application Code
Improving Performance
Scalability Planning
Chapter 2 Controlling Applications with ServletsAbout Servlets
Servlet Data Flow
About the Server Engine
Servlet Types
Instantiating and Removing Servlets
Designing Servlets
Request Handling
Allocating Servlet Engine Resources
Dynamically Reloading Servlets at Runtime
Configuring Servlets for Deployment
Locating Servlet Files
Deploying Servlets
Choosing a Servlet Type
Creating Servlets
Create Standard or Non-Standard Servlets
Planning for Servlet Reuse
Servlet Files for an iPlanet Application
The Servlet's Class File
Invoking Servlets
Creating the Class Declaration
The Servlet's Deployment Descriptor
Overriding Methods
Accessing Parameters and Storing Data
Handling Sessions and Security
Accessing Business Logic Components
Handling Threading Issues
Delivering Client Results
Elements
iPlanet Application Server Optional Features
Changing Configuration Files
Calling a Servlet With a URL
Invoking Specific Application Servlets
Calling a Servlet Programmatically
Invoking Generic Application Servlets
Verifying Servlet Parameters
Chapter 3 Presenting Application Pages with JavaServer PagesIntroducing JSPs
How JSPs Work
Designing JSPs
Choosing a Component
Creating JSPs
Designing for Ease of Maintenance
Designing for Portability
Handling Exceptions
General Syntax
Programming Advanced JSPs
JSP Tags
Directives
Escape Characters
Comments
<%@ page%>
Scripting Elements
<%@ include%>
<%@ taglib... %>
Declarations <%! ... %>
Actions
Expressions <%= ... %>
Scriptlets <%...%>
<jsp:useBean>
Implicit Objects
<jsp:setProperty>
<jsp:getProperty>
<jsp:include>
<jsp:forward>
<jsp:plugin>
Including Other Resources
Deploying JSPs
Using JavaBeans
Accessing Business Objects
Unregistered JSPs
Invoking JSPs
Registered JSPs
Calling a JSP With a URL
JSP 1.1 Tag Summary
Invoking JSPs in a Specific Application
Invoking a JSP From a Servlet
Invoking JSPs in a Generic Application
Directives
Modifying Custom Tags for JSP 1.1
Expressions
Scriptlets
Comments
Bean-Related Actions
Other Actions
Compiling JSPs: The Command-Line Compiler
Value-added Features
Custom Tag Extensions
Database Query Tag Library
JSP Load Balancing
LDAP Tag Library
Conditional Tag Library
Attribute Tag Library
JSP Page Caching
Chapter 4 Introducing Enterprise JavaBeansWhat Enterprise JavaBeans Do
What is an Enterprise JavaBean?
Understanding Client Contracts
Session Beans and Entity Beans
Understanding Component Contracts
Understanding JAR File Contracts
Understanding Session Beans
EJB Role in an iPlanet Application Server Application
Understanding Entity Beans
Designing an Object-Oriented Application
Planning Guidelines
Using Session Beans
Using Entity Beans
Planning for Failover Recovery
Working with Databases
Deploying EJBs
Dynamically Reloading EJBs
Chapter 5 Using Session EJBs to Manage Business RulesIntroducing Session EJBs
Session Bean Components
Creating the Remote Interface
Additional Session Bean Guidelines
Declaring vs. Implementing the Remote Interface
Creating the Class Definition
Session Timeout
Creating the Home Interface
Passivation and Activation
Creating Stateless or Stateful Beans
Accessing iPlanet Application Server Functionality
Serializing Handles and References
Managing Transactions
Committing a Transaction
Accessing Databases
Session Bean Failover
How to Configure a Stateful Bean with Failover
How the Failover Process Works
Failover Guidelines
How Often Is the State Saved?
How the State is Saved
Chapter 6 Building Entity EJBsIntroducing Entity EJBs
How an Entity Bean is Accessed
Entity Bean Components
Creating the Class Definition
Additional Entity Bean Guidelines
Using ejbActivate and ejbPassivate
Creating the Home Interface
Using ejbLoad and ejbStore
Using setEntityContext and unsetEntityContext
Using ejbCreate Methods
Using Finder Methods
Declaring vs. Implementing the Remote Interface
Defining Create Methods
Creating the Remote Interface
Defining Find Methods
Accessing iPlanet Application Server Functionality
Container Managed Persistence
Serializing Handles and References
Managing Transactions
Committing a Transaction
Commit Option C
Handling Concurrent Access
Accessing Databases
Full J2EE Support
Third Party O/R Mapping Tools
Full Example of a CMP Entity Bean
Using the Lightweight CMP Implementation
Creating the Deployment Descriptors by Hand
ejb-jar Deployment Descriptor
Using the Deployment Tool
ias-ejb-jar Deployment Descriptor
CMP Bean Deployment Descriptor
Chapter 7 Handling Transactions with EJBsUnderstanding the Transaction Model
Specifying Transaction Attributes in an EJB
Using Bean Managed Transactions
Chapter 8 Using JDBC for Database AccessIntroducing JDBC
Supported Functionality
Using JDBC in Server Applications
Understanding Database Limitations
Understanding the iPlanet Application Server Limitations
Supported Databases
Using JDBC in EJBs
Handling Connections
Managing Transactions with JDBC or javax.transaction.UserTransaction
Using JDBC in Servlets
Specifying Transaction Isolation Level
Local Connections
Working with JDBC Features
Registering a Local Datasource
Global Connections
Using Resource Managers
Container Managed Local Connections
Registering a Global Datasource
Creating a Global Connection
Registering a Container Managed Local Datasource
Working With Connections
Pooling Connections
Working with ResultSet
Concurrency Support
Working with ResultSetMetaData
Updatable Result Set Support
Working with PreparedStatement
Working with CallableStatement
Handling Batch Updates
Creating Distributed Transactions
Working with RowSet
Using iASRowSet
Using JNDI
Using CachedRowSet
Creating a RowSet
Chapter 9 Developing and Deploying RMI/IIOP-Based ClientsOverview of RMI/IIOP Support
Scenarios
Developing RMI/IIOP Client Applications
Stand-Alone Java Main Program
Architectural Overview
Server-to-Server
iPlanet Value-Added Features
Naming Services
Limitations
Built-in ORB
Basic Authentication and EJB Container Integration
Server-Side Load Balancing
Scalability
High Availability
Minimal Ports Opened in Firewalls
JNDI Lookup for the EJB Home Interface
Packaging RMI/IIOP Client Applications
Specifying the Naming Factory Class
Client Authentication
Specifying the Target RMI/IIOP Bridge
Specifying the JNDI Name of an EJB
A JNDI Example
Sample Principal Class
Client-Side Load Balancing and Failover
Manual Selection from the List of Known Bridges
Round Robin DNS
Using the Assembly Tool GUI
Configuring RMI/IIOP Support
Automating Reassembly Using Ant
Using Application Client Container (ACC)
Server Configuration
Deploying Client Applications
Client Configuration
Configuring a Java 2 Environment and iPlanet ORB
Installing RMI/IIOP Client Support Classes
Client Deployment
Running Client Applications
Deployment Tools
Server CLASSPATH Setting (SP2 and Prior)
Troubleshooting
Performance Tuning RMI/IIOP
Recognizing Performance Issues
Firewall Configuration for RMI/IIOP
Basic Tuning Approaches
Solaris File Descriptor Setting
Enhancing Scalability
Java Heap Settings
Viewing RMI/IIOP Log Messages
Monitoring Logs on Windows
Sample Applications
Monitoring Logs on UNIX
Converter Sample Application
Other RMI/IIOP Sample Applications
Chapter 10 Deployment PackagingOverview of Packaging and Deployment
Introducing XML DTDs
Application Deployment Descriptor
Application XML DTD
Component Deployment Descriptors
Creating Deployment Descriptors
Deployment Descriptors
Document Type Definition
The iPlanet Application Server Registry
A Globally Unique Identifier
J2EE Application DTD
Web Application XML DTD
iPlanet Application Server Application DTD
Sample Application XML DD File
Web Application Overview
EJB XML DTD
Web Application XML DTD
Element for Specifying an iPlanet Application Server Web Application
EJB JAR File Contents
RMI/IIOP Client XML DTD
Specifying Parameter Passing Rules
EJB iPlanet Application Server XML DTD
Elements for Specifying EJB-JAR
Elements for Specifying Enterprise Beans
Elements for Specifying Persistence Manager
Elements for Specifying Pool Manager
Elements for Specifying EJB Reference
Elements for Specifying Resource Reference
Elements for Specifying Role Mapping
Elements for Specifying Roll Implementation
iPlanet Application Server RMI/IIOP Client XML DTD
Resource XML DTD
Elements for Specifying EJB Reference Information
Elements for Specifying Resource Reference Information
Datasource XML DTD
Element for Specifying Datasources
RMI/IIOP Client Datasource XML DTD
Element for Specifying iPlanet Application Server Resources
Elements for Specifying Resources
Elements for Specifying JDBC Datasources
Elements for Specifying Java Client Resources
Elements for Specifying JDBC Settings
Chapter 11 Creating and Managing User SessionsIntroducing Sessions
Sessions and Cookies
How to Use Sessions
Sessions and Security
Creating or Accessing a Session
Examining Session Properties
Binding Data to a Session
Invalidating a Session
Controlling the Session Type
Sharing Sessions with AppLogics
Chapter 12 Writing Secure ApplicationsiPlanet Application Server Security Goals
iPlanet Application Server Specific Security Features
iPlanet Application Server Security Model
Web Client and URL Authorizations
Security Responsibilities Overview
Web Client Invocation of Enterprise Bean Methods
RMI/IIOP Client Invocation of Enterprise Bean Methods
Application Developer
Common Security Terminology
Application Assembler
Application Deployer
Authentication
Container Security
Authorization
Role Mapping
Programmatic Security
User Authentication by Servlets
Declarative Security
Application Level Security
Servlet Level Security
EJB Level Security
HTTP Basic Authentication
User Authorization by Servlets
Secure Socket Layer Mutual Authentication
Form-Based Login
Programmatic Login
Form-Based vs. Programmatic Login
The IProgrammaticLogin Interface
The WebProgrammaticLogin Class
The EjbProgrammaticLogin Class
Defining Roles
User Authorization by EJBs
Referencing Security Roles
Defining Method Permissions
Sample Web Application DD
Defining Roles
User Authentication for Single Sign-on
Defining Method Permissions
Security Role References
How to Configure for Single Sign-on
User Authentication for RMI/IIOP Clients
Single Sign-on Example
Guide to Security Information
User Information
Web Server to Application Server Component Security
Security Roles
Chapter 13 Taking Advantage of the iPlanet Application Server FeaturesAccessing the Servlet Engine
Accessing the Servlet's AppLogic
Caching Servlet Results
Accessing the Server Context
Using a Startup Class
The IStartupClass Interface
Building the Startup Class
Deploying the Startup Class
How kjs Handles the StartupClass Object
Appendix A Using the Java Message ServiceAbout the JMS API
JMS Messaging Styles
Enabling JMS and Integrating Providers
Using JMS in Applications
JNDI and Application Component Deployment
JMS Administration
Connection Factory Proxy
Connection Pooling
User Identity Mapping
About Default Username
About Explicit User ID Map
ConnectionFactoryProxies and Application Created Threads
JMS Features Not Supported
JMS Object Administration Tools
Sample Applications
JNDI Properties for JMS Administration Tools
JMS Object Administration for IBM MQ
Connection Factory Proxy Administration
Creating a Proxy
Deleting a Proxy
Listing Proxy Parameters
User ID Map Administration
Connection Pooling Configuration
JMS Future in the iPlanet Application Server
Default JMS Provider
Message Driven Enterprise Java Beans
Using JMS in distributed transactions
Appendix B Dynamic Reloading
Appendix C Sample Deployment FilesApplication DD XML Files
Glossary
Sample Application DD XML File
Web Application DD XML Files
Sample Web Application DD XML File
EJB-JAR DD XML Files
Sample iPlanet Application Server Web-App DD XML File
Sample J2EE EJB-JAR DD XML File
iPlanet Application Server Client DD XML Files
Sample iPlanet Application Server EJB-JAR DD XML File
RMI/IIOP Client DD XML Files
Resource DD XML Files
Index
Index DocHome Next
Copyright © 2001 Sun Microsystems, Inc. Some preexisting portions Copyright © 2001 Netscape Communications Corp. All rights reserved.
Last Updated June 14, 2001