Java2 Platform Enterprise Edition Platform And Component Specifications

Table of Contents
Java™ 2 Platform, Enterprise Edition: Platform and Component Specifications
By Bill Shannon
, Mark Hapner
, Vlada Matena
, James Davidson
, Eduardo Pelegri-Llopart
, Larry Cable
, Enterprise Team

Publisher: Addison Wesley
Pub Date: May 26, 2000
ISBN: 0-201-70456-0
Pages: 800

    Copyright
    Foreword
    History and Acknowledgements
        About the Authors
    Java™ 2 Platform Enterprise Edition Specification, v1.2 (J2EE)
    Chapter J2EE.1. Introduction
    Acknowledgments
        Chapter J2EE.2. Platform Overview
    Section J2EE.2.1. Architecture
    Section J2EE.2.2. Product Requirements
    Section J2EE.2.3. Product Extensions
    Section J2EE.2.4. Platform Roles
    Section J2EE.2.5. Platform Contracts
        Chapter J2EE.3. Security
    Section J2EE.3.1. Introduction
    Section J2EE.3.2. A Simple Example
    Section J2EE.3.3. Security Architecture
    Section J2EE.3.4. User Authentication Requirements
    Section J2EE.3.5. Authorization Requirements
    Section J2EE.3.6. Deployment Requirements
    Section J2EE.3.7. Future Directions
        Chapter J2EE.4. Transaction Management
    Section J2EE.4.1. Overview
    Section J2EE.4.2. Requirements
    Section J2EE.4.3. Transaction Interoperability
    Section J2EE.4.4. System Administration Tools
        Chapter J2EE.5. Naming
    Section J2EE.5.1. Overview
    Section J2EE.5.2. Java Naming and Directory Interface™ (JNDI) Naming Context
    Section J2EE.5.3. Enterprise JavaBeans™ (EJB) References
    Section J2EE.5.4. Resource Factory References
    Section J2EE.5.5. UserTransaction References
        Chapter J2EE.6. Application Programming Interface
    Section J2EE.6.1. Required APIs
    Section J2EE.6.2. Java 2 Platform, Standard Edition (J2SE) Requirements
    Section J2EE.6.3. JDBC™ 2.0 Standard Extension Requirements
    Section J2EE.6.4. RMI-IIOP 1.0 Requirements
    Section J2EE.6.5. Enterprise JavaBeans™ (EJB) 1.1 Requirements
    Section J2EE.6.6. Servlet 2.2 Requirements
    Section J2EE.6.7. JavaServer Pages™ (JSP) 1.1 Requirements
    Section J2EE.6.8. Java™ Message Service (JMS) 1.0 Requirements
    Section J2EE.6.9. Java Naming and Directory Interface™ (JNDI) 1.2 Requirements
    Section J2EE.6.10. Java™ Transaction API (JTA) 1.0 Requirements
    Section J2EE.6.11. JavaMail™ 1.1 Requirements
    Section J2EE.6.12. JavaBeans™ Activation Framework 1.0 Requirements
        Chapter J2EE.7. Interoperability
    Section J2EE.7.1. Introduction to Interoperability
    Section J2EE.7.2. Interoperability Protocols
        Chapter J2EE.8. Application Assembly and Deployment
    Section J2EE.8.1. Application Development Life Cycle
    Section J2EE.8.2. Application Assembly
    Section J2EE.8.3. Deployment
    Section J2EE.8.4. J2EE:application XML DTD
        Chapter J2EE.9. Application Clients
    Section J2EE.9.1. Overview
    Section J2EE.9.2. Security
    Section J2EE.9.3. Transactions
    Section J2EE.9.4. Naming
    Section J2EE.9.5. Application Programming Interfaces
    Section J2EE.9.6. Packaging and Deployment
    Section J2EE.9.7. J2EE:application-client XML DTD
        Chapter J2EE.10. Service Provider Interface
    Chapter J2EE.11. Future Directions
    Section J2EE.11.1. Java™ Message Service API
    Section J2EE.11.2. Enterprise JavaBeans™ (EJB)/IIOP Protocol
    Section J2EE.11.3. J2EE SPI
    Section J2EE.11.4. Connectors
    Section J2EE.11.5. XML APIs
    Section J2EE.11.6. JDBC RowSets
    Section J2EE.11.7. Security APIs
    Section J2EE.11.8. Deployment APIs
    Section J2EE.11.9. Management APIs
    Section J2EE.11.10. SQLJ Part 0
        Appendix J2EE.A. Revision History
    Section J2EE.A.1. Changes Since Public Draft
    Section J2EE.A.2. Changes Since Public Release 1
    Section J2EE.A.3. Changes Since Public Release 2
        Appendix J2EE.B. Related Documents
        Java™ Servlet Specification, v2.2 (SRV)
    Preface
    Section SRV.P.1. Who Should Read This Specification
    Section SRV.P.2. API Reference
    Section SRV.P.3. Other Java™ Platform Specifications
    Section SRV.P.4. Other Important References
    Section SRV.P.5. Providing Feedback
    Section SRV.P.6. Acknowledgments
        Chapter SRV.1. Overview
    Section SRV.1.1. What Is a Servlet?
    Section SRV.1.2. What Is a Servlet Container?
    Section SRV.1.3. An Example
    Section SRV.1.4. Comparing Servlets with Other Technologies
    Section SRV.1.5. Relationship to Java 2 Enterprise Edition
    Section SRV.1.6. Distributable Servlet Containers
    Section SRV.1.7. Changes Since Version 2.1
        Chapter SRV.2. Terms Used
    Section SRV.2.1. Basic Terms
    Section SRV.2.2. Roles
    Section SRV.2.3. Security Terms
        Chapter SRV.3. The Servlet Interface
    Section SRV.3.1. Request Handling Methods
    Section SRV.3.2. Number of Instances
    Section SRV.3.3. Servlet Life Cycle
        Chapter SRV.4. Servlet Context
    Section SRV.4.1. Scope of a ServletContext
    Section SRV.4.2. Initialization Parameters
    Section SRV.4.3. Context Attributes
    Section SRV.4.4. Resources
    Section SRV.4.5. Multiple Hosts and Servlet Contexts
    Section SRV.4.6. Reloading Considerations
    Section SRV.4.7. Temporary Working Directories
        Chapter SRV.5. The Request
    Section SRV.5.1. Parameters
    Section SRV.5.2. Attributes
    Section SRV.5.3. Headers
    Section SRV.5.4. Request Path Elements
    Section SRV.5.5. Path Translation Methods
    Section SRV.5.6. Cookies
    Section SRV.5.7. SSL Attributes
    Section SRV.5.8. Internationalization
        Chapter SRV.6. The Response
    Section SRV.6.1. Buffering
    Section SRV.6.2. Headers
    Section SRV.6.3. Convenience Methods
    Section SRV.6.4. Internationalization
    Section SRV.6.5. Closure of Response Object
        Chapter SRV.7. Sessions
    Section SRV.7.1. Session Tracking Mechanisms
    Section SRV.7.2. Creating a Session
    Section SRV.7.3. Session Scope
    Section SRV.7.4. Binding Attributes into a Session
    Section SRV.7.5. Session Timeouts
    Section SRV.7.6. Last Accessed Times
    Section SRV.7.7. Important Session Semantics
        Chapter SRV.8. Dispatching Requests
    Section SRV.8.1. Obtaining a RequestDispatcher
    Section SRV.8.2. Using a Request Dispatcher
    Section SRV.8.3. include
    Section SRV.8.4. forward
    Section SRV.8.5. Error Handling
        Chapter SRV.9. Web Applications
    Section SRV.9.1. Relationship to ServletContext
    Section SRV.9.2. Elements of a Web Application
    Section SRV.9.3. Distinction Between Representations
    Section SRV.9.4. Directory Structure
    Section SRV.9.5. Web Application Archive File
    Section SRV.9.6. Web Application Configuration Descriptor
    Section SRV.9.7. Replacing a Web Application
    Section SRV.9.8. Error Handling
    Section SRV.9.9. Web Application Environment
        Chapter SRV.10. Mapping Requests to Servlets
    Section SRV.10.1. Use of URL Paths
    Section SRV.10.2. Specification of Mappings
        Chapter SRV.11. Security
    Section SRV.11.1. Introduction
    Section SRV.11.2. Declarative Security
    Section SRV.11.3. Programmatic Security
    Section SRV.11.4. Roles
    Section SRV.11.5. Authentication
    Section SRV.11.6. Server Tracking of Authentication Information
    Section SRV.11.7. Specifying Security Constraints
        Chapter SRV.12. Application Programming Interface
    Section SRV.12.1. Package javax.servlet
        Chapter SRV.13. Deployment Descriptor
    Section SRV.13.1. Deployment Descriptor Elements
    Section SRV.13.2. DTD
    Section SRV.13.3. Examples
        Chapter SRV.14. Futures
        JavaServer Pages™ Specification, v1.1 (JSP)
    Preface
    Section JSP.P.1. Who Should Read This Document
    Section JSP.P.2. Related Documents
    Section JSP.P.3. Acknowledgments
        Chapter JSP.1. Overview
    Section JSP.1.1. The JavaServer Pages™ Technology
    Section JSP.1.2. What Is a JSP Page?
    Section JSP.1.3. Features in JSP 1.1
    Section JSP.1.4. Overview of JSP Page Semantics
    Section JSP.1.5. Web Applications
    Section JSP.1.6. Application Model
        Chapter JSP.2. Standard Syntax and Semantics
    Section JSP.2.1. General Syntax Rules
    Section JSP.2.2. Error Handling
    Section JSP.2.3. Comments
    Section JSP.2.4. Quoting and Escape Conventions
    Section JSP.2.5. Overview of Semantics
    Section JSP.2.6. Template Text Semantics
    Section JSP.2.7. Directives
    Section JSP.2.8. Implicit Objects
    Section JSP.2.9. The PageContext Object
    Section JSP.2.10. Scripting Elements
    Section JSP.2.11. Actions
    Section JSP.2.12. Tag Attribute Interpretation Semantics
    Section JSP.2.13. Standard Actions
        Chapter JSP.3. The JSP Container
    Section JSP.3.1. The JSP Page Model
    Section JSP.3.2. JSP Page Implementation Class
    Section JSP.3.3. Buffering
    Section JSP.3.4. Precompilation
        Chapter JSP.4. Scripting
    Section JSP.4.1. Overall Structure
    Section JSP.4.2. Declarations Section
    Section JSP.4.3. Initialization Section
    Section JSP.4.4. Main Section
        Chapter JSP.5. Tag Extensions
    Section JSP.5.1. Introduction
    Section JSP.5.2. Tag Library
    Section JSP.5.3. Tag Library Descriptor
    Section JSP.5.4. Tag Handlers
    Section JSP.5.5. Scripting Variables
    Section JSP.5.6. Cooperating Actions
    Section JSP.5.7. Validation
    Section JSP.5.8. Conventions and Other Issues
        Chapter JSP.6. JSP Technology Classes
    Section JSP.6.1. Package javax.servlet.jsp
    Section JSP.6.2. Package javax.servlet.jsp.tagext
        Chapter JSP.7. JSP Pages as XML Documents
    Section JSP.7.1. Why an XML Representation
    Section JSP.7.2. Document Type
    Section JSP.7.3. Directives
    Section JSP.7.4. Scripting Elements
    Section JSP.7.5. Actions
    Section JSP.7.6. Transforming a JSP Page into an XML Document
    Section JSP.7.7. DTD for the XML Document
        Appendix JSP.A. Examples
    Section JSP.A.1. Simple Examples
    Section JSP.A.2. A Set of SQL Tags
        Appendix JSP.B. Implementation Notes
    Section JSP.B.1. Delivering Localized Content
    Section JSP.B.2. Processing taglib Directives
    Section JSP.B.3. Processing Tag Libraries
    Section JSP.B.4. Implementing Buffering
        Appendix JSP.C. Packaging JSP Pages
    Section JSP.C.1. A Very Simple JSP Page
    Section JSP.C.2. The JSP Page Packaged as Source in a WAR File
    Section JSP.C.3. The Servlet for the Compiled JSP Page
    Section JSP.C.4. The Web Application Descriptor
    Section JSP.C.5. The WAR for the Compiled JSP Page
        Appendix JSP.D. Future
    Section JSP.D.1. Meta-Tag Information
    Section JSP.D.2. Standard Tags
    Section JSP.D.3. Additional Application Support
    Section JSP.D.4. JSP, XML, and XSL Technologies
        Appendix JSP.E. Changes
    Section JSP.E.1. Changes Between 1.1 PR2 and 1.1 Final
    Section JSP.E.2. Changes Between 1.1 PR1 and PR2
    Section JSP.E.3. Changes Between 1.1 PD1 and PR1
    Section JSP.E.4. Changes Between 1.0 and 1.1 PD1
            Enterprise JavaBeans™ Specification, v1.1 (EJB)
    Chapter EJB.1. Introduction
    Section EJB.1.1. Target Audience
    Section EJB.1.2. What Is New in EJB 1.1
    Section EJB.1.3. Application Compatibility and Interoperability
    Section EJB.1.4. Acknowledgments
    Section EJB.1.5. Organization
    Section EJB.1.6. Document Conventions
        Chapter EJB.2. Goals
    Section EJB.2.1. Overall Goals
    Section EJB.2.2. Goals for Release 1.0
    Section EJB.2.3. Goals for Release 1.1
        Chapter EJB.3. EJB Architecture Roles and Scenarios
    Section EJB.3.1. EJB Architecture Roles
    Section EJB.3.2. Scenario: Development, Assembly, and Deployment
        Chapter EJB.4. Overview
    Section EJB.4.1. Enterprise Beans as Components
    Section EJB.4.2. Enterprise JavaBeans Architecture Contracts
    Section EJB.4.3. Session and Entity Objects
    Section EJB.4.4. Standard Mapping to CORBA Protocols
        Chapter EJB.5. Client View of a Session Bean
    Section EJB.5.1. Overview
    Section EJB.5.2. EJB Container
    Section EJB.5.3. Home Interface
    Section EJB.5.4. EJBObject
    Section EJB.5.5. Session Object Identity
    Section EJB.5.6. Client View of Session Object's Life Cycle
    Section EJB.5.7. Creating and Using a Session Object
    Section EJB.5.8. Object Identity
    Section EJB.5.9. Type Narrowing
        Chapter EJB.6. Session Bean Component Contract
    Section EJB.6.1. Overview
    Section EJB.6.2. Goals
    Section EJB.6.3. A Container's Management of Its Working Set
    Section EJB.6.4. Conversational State
    Section EJB.6.5. Protocol Between a Session Bean Instance and Its Container
    Section EJB.6.6. Stateful Session Bean State Diagram
    Section EJB.6.7. Object Interaction Diagrams for a Stateful Session Bean
    Section EJB.6.8. Stateless Session Beans
    Section EJB.6.9. Object Interaction Diagrams for a Stateless Session Bean
    Section EJB.6.10. The Responsibilities of the Bean Provider
        Chapter EJB.7. Example Session Scenario
    Section EJB.7.1. Overview
    Section EJB.7.2. Inheritance Relationship
        Chapter EJB.8. Client View of an Entity
    Section EJB.8.1. Overview
    Section EJB.8.2. EJB Container
    Section EJB.8.3. Entity Bean's Home Interface
    Section EJB.8.4. Entity Object's Life Cycle
    Section EJB.8.5. Primary Key and Object Identity
    Section EJB.8.6. Entity Bean's Remote Interface
    Section EJB.8.7. Entity Bean's Handle
    Section EJB.8.8. Entity Home Handles
    Section EJB.8.9. Type Narrowing of Object References
        Chapter EJB.9. Entity Bean Component Contract
    Section EJB.9.1. Concepts
    Section EJB.9.2. Responsibilities of the Enterprise Bean Provider
    Section EJB.9.3. The Responsibilities of the Container Provider
    Section EJB.9.4. Entity Beans with Container-Managed Persistence
    Section EJB.9.5. Object Interaction Diagrams
        Chapter EJB.10. Example Entity Scenario
    Section EJB.10.1. Overview
    Section EJB.10.2. Inheritance Relationship
        Chapter EJB.11. Support for Transactions
    Section EJB.11.1. Overview
    Section EJB.11.2. Sample Scenarios
    Section EJB.11.3. Bean Provider's Responsibilities
    Section EJB.11.4. Application Assembler's Responsibilities
    Section EJB.11.5. Deployer's Responsibilities
    Section EJB.11.6. Container Provider Responsibilities
    Section EJB.11.7. Access from Multiple Clients in the Same Transaction Context
        Chapter EJB.12. Exception Handling
    Section EJB.12.1. Overview and Concepts
    Section EJB.12.2. Bean Provider's Responsibilities
    Section EJB.12.3. Container Provider Responsibilities
    Section EJB.12.4. Client's View of Exceptions
    Section EJB.12.5. System Administrator's Responsibilities
    Section EJB.12.6. Differences from EJB 1.0
        Chapter EJB.13. Support for Distribution
    Section EJB.13.1. Overview
    Section EJB.13.2. Client-Side Objects in Distributed Environment
    Section EJB.13.3. Standard Distribution Protocol
        Chapter EJB.14. Enterprise Bean Environment
    Section EJB.14.1. Overview
    Section EJB.14.2. Bean Environment as JNDI Naming Context
    Section EJB.14.3. EJB References
    Section EJB.14.4. Resource Manager Connection Factory References
    Section EJB.14.5. Deprecated EJBContext.getEnvironment() Method
    Section EJB.14.6. UserTransaction Interface
        Chapter EJB.15. Security Management
    Section EJB.15.1. Overview
    Section EJB.15.2. Bean Provider's Responsibilities
    Section EJB.15.3. Application Assembler's Responsibilities
    Section EJB.15.4. Deployer's Responsibilities
    Section EJB.15.5. EJB Architecture Client Responsibilities
    Section EJB.15.6. EJB Container Provider's Responsibilities
    Section EJB.15.7. System Administrator's Responsibilities
        Chapter EJB.16. Deployment Descriptor
    Section EJB.16.1. Overview
    Section EJB.16.2. Bean Provider's Responsibilities
    Section EJB.16.3. Application Assembler's Responsibility
    Section EJB.16.4. Container Provider's Responsibilities
    Section EJB.16.5. Deployment Descriptor DTD
    Section EJB.16.6. Deployment Descriptor Example
        Chapter EJB.17. EJB JAR File
    Section EJB.17.1. Overview
    Section EJB.17.2. Deployment Descriptor
    Section EJB.17.3. Class Files
    Section EJB.17.4. ejb-client JAR File
    Section EJB.17.5. Deprecated in EJB 1.1
        Chapter EJB.18. Runtime Environment
    Section EJB.18.1. Bean Provider's Responsibilities
    Section EJB.18.2. Container Provider's Responsibility
        Chapter EJB.19. Responsibilities of EJB Architecture Roles
    Section EJB.19.1. Bean Provider's Responsibilities
    Section EJB.19.2. Application Assembler's Responsibilities
    Section EJB.19.3. EJB Container Provider's Responsibilities
    Section EJB.19.4. Deployer's Responsibilities
    Section EJB.19.5. System Administrator's Responsibilities
    Section EJB.19.6. Client Programmer's Responsibilities
        Chapter EJB.20. Enterprise JavaBeans™ API Reference
    Section EJB.20.1. Package javax.ejb
    Section EJB.20.2. Package javax.ejb.deployment
        Chapter EJB.21. Related Documents
    Appendix EJB.A. Features Deferred to Future Releases
    Appendix EJB.B. Frequently Asked Questions
    Section EJB.B.1. Client-Demarcated Transactions
    Section EJB.B.2. Inheritance
    Section EJB.B.3. Entities and Relationships
    Section EJB.B.4. Finder Methods for Entities with Container-Managed Persistence
    Section EJB.B.5. JDK 1.1 or Java 2
    Section EJB.B.6. javax.transaction.UserTransaction Versus javax.jts.UserTransaction
    Section EJB.B.7. How to Obtain Database Connections
    Section EJB.B.8. Session Beans and Primary Key
    Section EJB.B.9. Copying of Parameters Required for EJB Calls Within the Same JVM
        Appendix EJB.C. Revision History
    Section EJB.C.1. Changes Since Release 0.8
    Section EJB.C.2. Changes Since Release 0.9
    Section EJB.C.3. Changes Since Release 0.95
    Section EJB.C.4. Changes Since 1.0
    Section EJB.C.5. Changes Since EBJ.1.1 Draft 1
    Section EJB.C.6. Changes Since EJB.1.1 Draft 2
    Section EJB.C.7. Changes Since EJB 1.1 Draft 3
    Section EJB.C.8. Changes Since EJB 1.1 Public Draft
    Section EJB.C.9. Changes Since EJB 1.1 Public Draft 2
    Section EJB.C.10. Changes Since EJB 1.1 Public Draft 3
    Section EJB.C.11. Changes Since EJB 1.1 Public Release
    Section EJB.C.12. Changes Since EJB 1.1 Public Release
            Glossary
[ directory ]