Index DocHome Next |
iPlanet Application Server Programmer's Guide (Java) |
Contents
PrefaceUsing the Documentation
What You Should Already Know
How This Guide Is Organized
Documentation Conventions
Related Information
Programming with Servlets and JSPs
Programming with EJBs
Programming with JDBC
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
Updating 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 iPlanet Application
The Servlet's Class File
Invoking Servlets
Creating the Class Declaration
About 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
Accessing iPlanet Application Server Optional Features
Calling a Servlet With a URL
Invoking Specific Application Servlets
Calling a Servlet Programmatically
Invoking Generic Application Servlets
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
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
Value-added Features
Expressions
Scriptlets
Comments
Bean-Related Actions
Other Actions
PagePath
JSP Load Balancing
Custom Tag Extensions
Database Query Tag Library
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
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
Serializing Handles and References
Managing Transactions
Committing a Transaction
Commit Options B and C
Handling Concurrent Access
Accessing Databases
Container Managed Persistence
How Container Managed Persistence Works
Pluggable Container Managed Persistence
How to Use Persistence Managers in the iPlanet Application Server
iPlanet Application Server Persistence Manager Reference Implementation
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 Resouce 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 Rich ClientRich Client Overview
Rich Client Architecture and Use Cases
Use Cases
Value-added Features
Load Balancing
Developing for a Rich Client
Failover
Security
Server Side
Sample Client Code
Client Side
Application Client Container
Sample Principal Class
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
Rich 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 Rich 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
Rich 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
Rich 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
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
Realm
How to Configure for Single Sign-on
User Authentication for Rich Client
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 Application Events
The Application Events API
Sending and Receiving Email
The IAppEventMgr Interface
Creating a New Application Event
The IAppEventObj Interface
Accessing the Controlling AppLogic
iPlanet Application Server Application Builder Features
Receiving Email
To Receive Email
Sending Email
To Send Email
Validating Form Field Data
Validation Methods
Creating Named Form Action Handlers
Validation Rules
Error Handlers
Example Validation Rules
Example Validation and Form Action Handler
Appendix A Using the Java Message ServiceAbout the JMS API
JMS Messaging Styles
Enabling JMS and Integrating Providers
Enabling JMS Connection Pooling
Using JMS in Applications
Enabling the IBM MQ Provider
Enabling the Sun JMQ Provider
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 ReloadingHow Dynamic Reloading Works
Related Registry Entries Summary
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
Rich Client DD XML Files
Resource DD XML Files
Index
Index DocHome Next
Copyright © 2000 Sun Microsystems, Inc. Some preexisting portions Copyright © 2000 Netscape Communications Corp. All rights reserved.
Last Updated January 25, 2001