•

TableofContents

Java™2Platform,EnterpriseEdition:Platform
andComponentSpecifications
By
BillShannon,MarkHapner,VladaMatena,JamesDavidson,EduardoPelegri-Llopart,Larry
Cable,EnterpriseTeam

Publisher

:AddisonWesley

PubDate

:May26,2000

ISBN

:0-201-70456-0

Pages

:800

TheJava2(TM)Platform,EnterpriseEdition(J2EE)definesanew
standardinenterprisesolutionsthroughasimplified,component-based
developmentmodel.Byextendingthe"write-once,run-anywhere(TM)"
benefitsoftheJavaprogramminglanguagetoenterpriseservers,J2EE
addsthescalability,robustness,andsecurityrequiredfortoday'svitalecommerceandenterprisesolutions.TheJava(TM)2Platform,Enterprise

Edition:PlatformandComponentsSpecificationsdefinesthearchitecture
fordevelopingapplicationswithJ2EE.Thisvolumeincludes:
Java(TM)2Platform,EnterpriseEditionSpecification,version1.2
ThisspecificationdefinestheinitialreleaseoftheJ2EEplatform.It


discussesapplicationarchitectureusingJava(TM)Servlets,
JavaServerPages(TM),EnterpriseJavaBeans(TM),andother
technologies.Itspecifiesapplicationaccesstoservicessuchas
JDBC(TM),JavaTransactionAPI,JavaMail(TM),CORBA
connectivity,andothers.ItalsodiscussesJ2EEpoliciesregarding
applicationdeploymentandsecurity.
EnterpriseJavaBeans(TM)Specification,version1.1
EnterpriseJavaBeanstechnologyprovidesthestandardmiddle-tier
componentsintheJ2EEmodel.Thistechnologyprovidessimplified
supportfortransactionmanagementandremoteobjectaccess,and
itfreesenterprisedeveloperstofocusonthebusinesslogicoftheir
applications.Version1.1ofthespecificationincludesanumberof
enhancements,includingmandatoryentitybeansandXML
deploymentdescriptors.
Java(TM)ServletSpecification,version2.2
JavaServletstechnologydefinesastandardfordevelopingserversidebehaviorsinwebapplicationsbasedontheJavaprogramming
language.AspartoftheJ2EEspecifications,servletstechnology
supportsdevelopmentofdynamicwebcontentfore-commerceand
otherenterpriseapplications.
JavaServerPages(TM)Specification,version1.2
TheJavaServerPages(JSP)technologysimplifiesthedevelopment
anddeploymentofinteractivewebapplications.Usinganextensible
markuplanguagebasedonHTMLandtheJavaprogramming
language,JSPdefinesaserver-sidemechanismtoallowcontent

expertsgreaterfreedomincreatinganddisplayingdynamicweb
content.
Developedwiththeinputofawiderangeofindustryexperts,these
specificationsdefineanewstandardforresolvingmanycomplexissues
relatedtodeveloping,deploying,andmanagingmulti-tierenterprise
applications.







•

TableofContents

Java™2Platform,EnterpriseEdition:Platform
andComponentSpecifications
By
BillShannon,MarkHapner,VladaMatena,JamesDavidson,EduardoPelegri-Llopart,Larry
Cable,EnterpriseTeam

Publisher

:AddisonWesley

PubDate

:May26,2000


ISBN

:0-201-70456-0

Pages

:800

Copyright
Foreword
HistoryandAcknowledgements
AbouttheAuthors
Java™2PlatformEnterpriseEditionSpecification,v1.2(J2EE)
ChapterJ2EE.1.
Introduction
Acknowledgments
ChapterJ2EE.2.
PlatformOverview
SectionJ2EE.2.1.
Architecture


SectionJ2EE.2.2.
ProductRequirements
SectionJ2EE.2.3.
ProductExtensions
SectionJ2EE.2.4.
PlatformRoles
SectionJ2EE.2.5.

PlatformContracts
ChapterJ2EE.3.
Security
SectionJ2EE.3.1.
Introduction
SectionJ2EE.3.2.
ASimpleExample
SectionJ2EE.3.3.
SecurityArchitecture
SectionJ2EE.3.4.
UserAuthenticationRequirements
SectionJ2EE.3.5.
AuthorizationRequirements
SectionJ2EE.3.6.
DeploymentRequirements
SectionJ2EE.3.7.
FutureDirections
ChapterJ2EE.4.
TransactionManagement
SectionJ2EE.4.1.
Overview
SectionJ2EE.4.2.
Requirements
SectionJ2EE.4.3.
TransactionInteroperability
SectionJ2EE.4.4.
SystemAdministrationTools


ChapterJ2EE.5.

Naming

SectionJ2EE.5.1.
Overview
SectionJ2EE.5.2.
JavaNamingandDirectoryInterface™(JNDI)NamingContext
SectionJ2EE.5.3.
EnterpriseJavaBeans™(EJB)References
SectionJ2EE.5.4.
ResourceFactoryReferences
SectionJ2EE.5.5.

UserTransactionReferences
ChapterJ2EE.6.
ApplicationProgrammingInterface
SectionJ2EE.6.1.
RequiredAPIs
SectionJ2EE.6.2.
Java2Platform,StandardEdition(J2SE)Requirements
SectionJ2EE.6.3.
JDBC™2.0StandardExtensionRequirements
SectionJ2EE.6.4.
RMI-IIOP1.0Requirements
SectionJ2EE.6.5.
EnterpriseJavaBeans™(EJB)1.1Requirements
SectionJ2EE.6.6.
Servlet2.2Requirements
SectionJ2EE.6.7.
JavaServerPages™(JSP)1.1Requirements
SectionJ2EE.6.8.

Java™MessageService(JMS)1.0Requirements
SectionJ2EE.6.9.
JavaNamingandDirectoryInterface™(JNDI)1.2Requirements
SectionJ2EE.6.10.
Java™TransactionAPI(JTA)1.0Requirements
SectionJ2EE.6.11.


JavaMail™1.1Requirements

SectionJ2EE.6.12.
JavaBeans™ActivationFramework1.0Requirements
ChapterJ2EE.7.
Interoperability
SectionJ2EE.7.1.
IntroductiontoInteroperability
SectionJ2EE.7.2.
InteroperabilityProtocols
ChapterJ2EE.8.
ApplicationAssemblyandDeployment
SectionJ2EE.8.1.
ApplicationDevelopmentLifeCycle
SectionJ2EE.8.2.
ApplicationAssembly
SectionJ2EE.8.3.
Deployment
SectionJ2EE.8.4.
J2EE:applicationXMLDTD
ChapterJ2EE.9.
ApplicationClients

SectionJ2EE.9.1.
Overview
SectionJ2EE.9.2.
Security
SectionJ2EE.9.3.
Transactions
SectionJ2EE.9.4.
Naming
SectionJ2EE.9.5.
ApplicationProgrammingInterfaces
SectionJ2EE.9.6.
PackagingandDeployment
SectionJ2EE.9.7.


J2EE:application-clientXMLDTD

ChapterJ2EE.10.
ServiceProviderInterface
ChapterJ2EE.11.
FutureDirections
SectionJ2EE.11.1.
Java™MessageServiceAPI
SectionJ2EE.11.2.
EnterpriseJavaBeans™(EJB)/IIOPProtocol
SectionJ2EE.11.3.
J2EESPI
SectionJ2EE.11.4.
Connectors
SectionJ2EE.11.5.

XMLAPIs
SectionJ2EE.11.6.
JDBCRowSets
SectionJ2EE.11.7.
SecurityAPIs
SectionJ2EE.11.8.
DeploymentAPIs
SectionJ2EE.11.9.
ManagementAPIs
SectionJ2EE.11.10.
SQLJPart0
AppendixJ2EE.A.
RevisionHistory
SectionJ2EE.A.1.
ChangesSincePublicDraft
SectionJ2EE.A.2.
ChangesSincePublicRelease1
SectionJ2EE.A.3.
ChangesSincePublicRelease2
AppendixJ2EE.B.


RelatedDocuments

Java™ServletSpecification,v2.2(SRV)
Preface
SectionSRV.P.1.
WhoShouldReadThisSpecification
SectionSRV.P.2.
APIReference

SectionSRV.P.3.
OtherJava™PlatformSpecifications
SectionSRV.P.4.
OtherImportantReferences
SectionSRV.P.5.
ProvidingFeedback
SectionSRV.P.6.
Acknowledgments
ChapterSRV.1.
Overview
SectionSRV.1.1.
WhatIsaServlet?
SectionSRV.1.2.
WhatIsaServletContainer?
SectionSRV.1.3.
AnExample
SectionSRV.1.4.
ComparingServletswithOtherTechnologies
SectionSRV.1.5.
RelationshiptoJava2EnterpriseEdition
SectionSRV.1.6.
DistributableServletContainers
SectionSRV.1.7.
ChangesSinceVersion2.1
ChapterSRV.2.
TermsUsed
SectionSRV.2.1.
BasicTerms



SectionSRV.2.2.
Roles
SectionSRV.2.3.
SecurityTerms
ChapterSRV.3.
TheServletInterface
SectionSRV.3.1.
RequestHandlingMethods
SectionSRV.3.2.
NumberofInstances
SectionSRV.3.3.
ServletLifeCycle
ChapterSRV.4.
ServletContext
SectionSRV.4.1.
ScopeofaServletContext
SectionSRV.4.2.
InitializationParameters
SectionSRV.4.3.
ContextAttributes
SectionSRV.4.4.
Resources
SectionSRV.4.5.
MultipleHostsandServletContexts
SectionSRV.4.6.
ReloadingConsiderations
SectionSRV.4.7.
TemporaryWorkingDirectories
ChapterSRV.5.
TheRequest

SectionSRV.5.1.
Parameters
SectionSRV.5.2.
Attributes


SectionSRV.5.3.
Headers
SectionSRV.5.4.
RequestPathElements
SectionSRV.5.5.
PathTranslationMethods
SectionSRV.5.6.
Cookies
SectionSRV.5.7.
SSLAttributes
SectionSRV.5.8.
Internationalization
ChapterSRV.6.
TheResponse
SectionSRV.6.1.
Buffering
SectionSRV.6.2.
Headers
SectionSRV.6.3.
ConvenienceMethods
SectionSRV.6.4.
Internationalization
SectionSRV.6.5.
ClosureofResponseObject

ChapterSRV.7.
Sessions
SectionSRV.7.1.
SessionTrackingMechanisms
SectionSRV.7.2.
CreatingaSession
SectionSRV.7.3.
SessionScope
SectionSRV.7.4.
BindingAttributesintoaSession
SectionSRV.7.5.


SessionTimeouts
SectionSRV.7.6.
LastAccessedTimes

SectionSRV.7.7.
ImportantSessionSemantics
ChapterSRV.8.
DispatchingRequests
SectionSRV.8.1.
ObtainingaRequestDispatcher
SectionSRV.8.2.
UsingaRequestDispatcher
SectionSRV.8.3.

include
SectionSRV.8.4.


forward
SectionSRV.8.5.
ErrorHandling
ChapterSRV.9.
WebApplications
SectionSRV.9.1.
RelationshiptoServletContext
SectionSRV.9.2.
ElementsofaWebApplication
SectionSRV.9.3.
DistinctionBetweenRepresentations
SectionSRV.9.4.
DirectoryStructure
SectionSRV.9.5.
WebApplicationArchiveFile
SectionSRV.9.6.
WebApplicationConfigurationDescriptor
SectionSRV.9.7.
ReplacingaWebApplication
SectionSRV.9.8.


ErrorHandling
SectionSRV.9.9.
WebApplicationEnvironment
ChapterSRV.10.
MappingRequeststoServlets
SectionSRV.10.1.
UseofURLPaths
SectionSRV.10.2.

SpecificationofMappings
ChapterSRV.11.
Security
SectionSRV.11.1.
Introduction
SectionSRV.11.2.
DeclarativeSecurity
SectionSRV.11.3.
ProgrammaticSecurity
SectionSRV.11.4.
Roles
SectionSRV.11.5.
Authentication
SectionSRV.11.6.
ServerTrackingofAuthenticationInformation
SectionSRV.11.7.
SpecifyingSecurityConstraints
ChapterSRV.12.
ApplicationProgrammingInterface
SectionSRV.12.1.
Packagejavax.servlet
ChapterSRV.13.
DeploymentDescriptor
SectionSRV.13.1.
DeploymentDescriptorElements
SectionSRV.13.2.


DTD
SectionSRV.13.3.

Examples

ChapterSRV.14.
Futures
JavaServerPages™Specification,v1.1(JSP)
Preface
SectionJSP.P.1.
WhoShouldReadThisDocument
SectionJSP.P.2.
RelatedDocuments
SectionJSP.P.3.
Acknowledgments
ChapterJSP.1.
Overview
SectionJSP.1.1.
TheJavaServerPages™Technology
SectionJSP.1.2.
WhatIsaJSPPage?
SectionJSP.1.3.
FeaturesinJSP1.1
SectionJSP.1.4.
OverviewofJSPPageSemantics
SectionJSP.1.5.
WebApplications
SectionJSP.1.6.
ApplicationModel
ChapterJSP.2.
StandardSyntaxandSemantics
SectionJSP.2.1.
GeneralSyntaxRules

SectionJSP.2.2.
ErrorHandling
SectionJSP.2.3.


Comments
SectionJSP.2.4.
QuotingandEscapeConventions
SectionJSP.2.5.
OverviewofSemantics
SectionJSP.2.6.
TemplateTextSemantics
SectionJSP.2.7.
Directives
SectionJSP.2.8.
ImplicitObjects
SectionJSP.2.9.
ThePageContextObject
SectionJSP.2.10.
ScriptingElements
SectionJSP.2.11.
Actions
SectionJSP.2.12.
TagAttributeInterpretationSemantics
SectionJSP.2.13.
StandardActions
ChapterJSP.3.
TheJSPContainer
SectionJSP.3.1.
TheJSPPageModel

SectionJSP.3.2.
JSPPageImplementationClass
SectionJSP.3.3.
Buffering
SectionJSP.3.4.
Precompilation
ChapterJSP.4.
Scripting
SectionJSP.4.1.
OverallStructure


SectionJSP.4.2.
DeclarationsSection

SectionJSP.4.3.
InitializationSection
SectionJSP.4.4.
MainSection
ChapterJSP.5.
TagExtensions
SectionJSP.5.1.
Introduction
SectionJSP.5.2.
TagLibrary
SectionJSP.5.3.
TagLibraryDescriptor
SectionJSP.5.4.
TagHandlers
SectionJSP.5.5.

ScriptingVariables
SectionJSP.5.6.
CooperatingActions
SectionJSP.5.7.
Validation
SectionJSP.5.8.
ConventionsandOtherIssues
ChapterJSP.6.
JSPTechnologyClasses
SectionJSP.6.1.
Packagejavax.servlet.jsp
SectionJSP.6.2.
Packagejavax.servlet.jsp.tagext
ChapterJSP.7.
JSPPagesasXMLDocuments
SectionJSP.7.1.
WhyanXMLRepresentation


SectionJSP.7.2.
DocumentType
SectionJSP.7.3.
Directives
SectionJSP.7.4.
ScriptingElements
SectionJSP.7.5.
Actions
SectionJSP.7.6.
TransformingaJSPPageintoanXMLDocument
SectionJSP.7.7.

DTDfortheXMLDocument
AppendixJSP.A.
Examples
SectionJSP.A.1.
SimpleExamples
SectionJSP.A.2.
ASetofSQLTags
AppendixJSP.B.
ImplementationNotes
SectionJSP.B.1.
DeliveringLocalizedContent
SectionJSP.B.2.
ProcessingtaglibDirectives
SectionJSP.B.3.
ProcessingTagLibraries
SectionJSP.B.4.
ImplementingBuffering
AppendixJSP.C.
PackagingJSPPages
SectionJSP.C.1.
AVerySimpleJSPPage
SectionJSP.C.2.
TheJSPPagePackagedasSourceinaWARFile


SectionJSP.C.3.
TheServletfortheCompiledJSPPage
SectionJSP.C.4.
TheWebApplicationDescriptor
SectionJSP.C.5.

TheWARfortheCompiledJSPPage
AppendixJSP.D.
Future
SectionJSP.D.1.
Meta-TagInformation
SectionJSP.D.2.
StandardTags
SectionJSP.D.3.
AdditionalApplicationSupport
SectionJSP.D.4.
JSP,XML,andXSLTechnologies
AppendixJSP.E.
Changes
SectionJSP.E.1.
ChangesBetween1.1PR2and1.1Final
SectionJSP.E.2.
ChangesBetween1.1PR1andPR2
SectionJSP.E.3.
ChangesBetween1.1PD1andPR1
SectionJSP.E.4.
ChangesBetween1.0and1.1PD1
EnterpriseJavaBeans™Specification,v1.1(EJB)
ChapterEJB.1.
Introduction
SectionEJB.1.1.
TargetAudience
SectionEJB.1.2.
WhatIsNewinEJB1.1
SectionEJB.1.3.
ApplicationCompatibilityandInteroperability



SectionEJB.1.4.
Acknowledgments
SectionEJB.1.5.
Organization
SectionEJB.1.6.
DocumentConventions
ChapterEJB.2.
Goals
SectionEJB.2.1.
OverallGoals
SectionEJB.2.2.
GoalsforRelease1.0
SectionEJB.2.3.
GoalsforRelease1.1
ChapterEJB.3.
EJBArchitectureRolesandScenarios
SectionEJB.3.1.
EJBArchitectureRoles
SectionEJB.3.2.
Scenario:Development,Assembly,andDeployment
ChapterEJB.4.
Overview
SectionEJB.4.1.
EnterpriseBeansasComponents
SectionEJB.4.2.
EnterpriseJavaBeansArchitectureContracts
SectionEJB.4.3.
SessionandEntityObjects

SectionEJB.4.4.
StandardMappingtoCORBAProtocols
ChapterEJB.5.
ClientViewofaSessionBean
SectionEJB.5.1.
Overview
SectionEJB.5.2.


EJBContainer

SectionEJB.5.3.
HomeInterface
SectionEJB.5.4.
EJBObject
SectionEJB.5.5.
SessionObjectIdentity
SectionEJB.5.6.
ClientViewofSessionObject'sLifeCycle
SectionEJB.5.7.
CreatingandUsingaSessionObject
SectionEJB.5.8.
ObjectIdentity
SectionEJB.5.9.
TypeNarrowing
ChapterEJB.6.
SessionBeanComponentContract
SectionEJB.6.1.
Overview
SectionEJB.6.2.

Goals
SectionEJB.6.3.
AContainer'sManagementofItsWorkingSet
SectionEJB.6.4.
ConversationalState
SectionEJB.6.5.
ProtocolBetweenaSessionBeanInstanceandItsContainer
SectionEJB.6.6.
StatefulSessionBeanStateDiagram
SectionEJB.6.7.
ObjectInteractionDiagramsforaStatefulSessionBean
SectionEJB.6.8.
StatelessSessionBeans
SectionEJB.6.9.


ObjectInteractionDiagramsforaStatelessSessionBean
SectionEJB.6.10.
TheResponsibilitiesoftheBeanProvider
ChapterEJB.7.
ExampleSessionScenario

SectionEJB.7.1.
Overview
SectionEJB.7.2.
InheritanceRelationship
ChapterEJB.8.
ClientViewofanEntity
SectionEJB.8.1.
Overview

SectionEJB.8.2.
EJBContainer
SectionEJB.8.3.
EntityBean'sHomeInterface
SectionEJB.8.4.
EntityObject'sLifeCycle
SectionEJB.8.5.
PrimaryKeyandObjectIdentity
SectionEJB.8.6.
EntityBean'sRemoteInterface
SectionEJB.8.7.
EntityBean'sHandle
SectionEJB.8.8.
EntityHomeHandles
SectionEJB.8.9.
TypeNarrowingofObjectReferences
ChapterEJB.9.
EntityBeanComponentContract
SectionEJB.9.1.
Concepts
SectionEJB.9.2.


ResponsibilitiesoftheEnterpriseBeanProvider
SectionEJB.9.3.
TheResponsibilitiesoftheContainerProvider
SectionEJB.9.4.
EntityBeanswithContainer-ManagedPersistence
SectionEJB.9.5.
ObjectInteractionDiagrams

ChapterEJB.10.
ExampleEntityScenario
SectionEJB.10.1.
Overview
SectionEJB.10.2.
InheritanceRelationship
ChapterEJB.11.
SupportforTransactions
SectionEJB.11.1.
Overview
SectionEJB.11.2.
SampleScenarios
SectionEJB.11.3.
BeanProvider'sResponsibilities
SectionEJB.11.4.
ApplicationAssembler'sResponsibilities
SectionEJB.11.5.
Deployer'sResponsibilities
SectionEJB.11.6.
ContainerProviderResponsibilities
SectionEJB.11.7.
AccessfromMultipleClientsintheSameTransactionContext
ChapterEJB.12.
ExceptionHandling
SectionEJB.12.1.
OverviewandConcepts
SectionEJB.12.2.


BeanProvider'sResponsibilities

SectionEJB.12.3.
ContainerProviderResponsibilities

SectionEJB.12.4.
Client'sViewofExceptions
SectionEJB.12.5.
SystemAdministrator'sResponsibilities
SectionEJB.12.6.
DifferencesfromEJB1.0
ChapterEJB.13.
SupportforDistribution
SectionEJB.13.1.
Overview
SectionEJB.13.2.
Client-SideObjectsinDistributedEnvironment
SectionEJB.13.3.
StandardDistributionProtocol
ChapterEJB.14.
EnterpriseBeanEnvironment
SectionEJB.14.1.
Overview
SectionEJB.14.2.
BeanEnvironmentasJNDINamingContext
SectionEJB.14.3.
EJBReferences
SectionEJB.14.4.
ResourceManagerConnectionFactoryReferences
SectionEJB.14.5.
DeprecatedEJBContext.getEnvironment()Method
SectionEJB.14.6.


UserTransactionInterface
ChapterEJB.15.
SecurityManagement
SectionEJB.15.1.


Overview
SectionEJB.15.2.
BeanProvider'sResponsibilities
SectionEJB.15.3.
ApplicationAssembler'sResponsibilities
SectionEJB.15.4.
Deployer'sResponsibilities
SectionEJB.15.5.
EJBArchitectureClientResponsibilities
SectionEJB.15.6.
EJBContainerProvider'sResponsibilities
SectionEJB.15.7.
SystemAdministrator'sResponsibilities
ChapterEJB.16.
DeploymentDescriptor
SectionEJB.16.1.
Overview
SectionEJB.16.2.
BeanProvider'sResponsibilities
SectionEJB.16.3.
ApplicationAssembler'sResponsibility
SectionEJB.16.4.
ContainerProvider'sResponsibilities

SectionEJB.16.5.
DeploymentDescriptorDTD
SectionEJB.16.6.
DeploymentDescriptorExample
ChapterEJB.17.
EJBJARFile
SectionEJB.17.1.
Overview
SectionEJB.17.2.
DeploymentDescriptor
SectionEJB.17.3.


ClassFiles
SectionEJB.17.4.
ejb-clientJARFile
SectionEJB.17.5.
DeprecatedinEJB1.1
ChapterEJB.18.
RuntimeEnvironment
SectionEJB.18.1.
BeanProvider'sResponsibilities
SectionEJB.18.2.
ContainerProvider'sResponsibility
ChapterEJB.19.
ResponsibilitiesofEJBArchitectureRoles
SectionEJB.19.1.
BeanProvider'sResponsibilities
SectionEJB.19.2.
ApplicationAssembler'sResponsibilities

SectionEJB.19.3.
EJBContainerProvider'sResponsibilities
SectionEJB.19.4.
Deployer'sResponsibilities
SectionEJB.19.5.
SystemAdministrator'sResponsibilities
SectionEJB.19.6.
ClientProgrammer'sResponsibilities
ChapterEJB.20.
EnterpriseJavaBeans™APIReference
SectionEJB.20.1.
Packagejavax.ejb
SectionEJB.20.2.
Packagejavax.ejb.deployment
ChapterEJB.21.
RelatedDocuments
AppendixEJB.A.