The J2EE Tutorial

Foreword......Page 15
Preface......Page 19
Overview......Page 25
Distributed Multitiered Applications......Page 26
J2EE Components......Page 27
Applets......Page 28
J2EE Server Communications......Page 29
Web Components......Page 30
Business Components......Page 31
Container Services......Page 32
Packaging......Page 34
Development Roles......Page 35
Application Component Provider......Page 36
Application Assembler......Page 37
Reference Implementation Software......Page 38
JDBC API 2.0......Page 39
Java Naming and Directory Interface 1.2......Page 40
Java API for XML Processing 1.1......Page 41
Simplified Systems Integration......Page 42
Scripts......Page 43
In This Chapter......Page 45
Getting the Build Tool (ant)......Page 46
Starting the deploytool......Page 47
Coding the Remote Interface......Page 48
Coding the Enterprise Bean Class......Page 49
Packaging the Enterprise Bean......Page 50
Locating the Home Interface......Page 52
Creating an Enterprise Bean Instance......Page 53
ConverterClient Source Code......Page 54
Packaging the J2EE Application Client......Page 55
Coding the Web Client......Page 56
Packaging the Web Client......Page 58
Specifying the JNDI Names......Page 59
Running the J2EE™ Application Client......Page 61
Running the Web Client......Page 62
Modifying a Class File......Page 63
Modifying a Deployment Setting......Page 64
Incorrect XML Parser......Page 65
ant 1.4 Will Not Compile the Example after You Run the Client......Page 66
The Client Throws a NoClassDefFoundError......Page 67
The J2EE Application Has Not Been Deployed......Page 68
Detecting Problems With the Verifier Tool......Page 69
When All Else Fails......Page 70
In This Chapter......Page 71
Benefits of Enterprise Beans......Page 72
What Is a Session Bean?......Page 73
Stateless Session Beans......Page 74
What Is an Entity Bean?......Page 75
Primary Key......Page 76
Abstract Schema......Page 77
Direction in Container-Managed Relationships......Page 79
What Is a Message-Driven Bean?......Page 80
When to Use Message-Driven Beans......Page 81
Remote Access......Page 82
Local Interfaces and Container-Managed Relationships......Page 83
Deciding on Remote or Local Access......Page 84
Granularity of Accessed Data......Page 85
The Contents of an Enterprise Bean......Page 86
The Life Cycles of Enterprise Beans......Page 87
The Life Cycle of a Stateful Session Bean......Page 88
The Life Cycle of an Entity Bean......Page 89
The Life Cycle of a Message-Driven Bean......Page 91
In This Chapter......Page 93
Session Bean Class......Page 94
The ejbCreate Methods......Page 96
Business Methods......Page 97
Home Interface......Page 99
Running the CartEJB Example......Page 100
Accessing Environment Entries......Page 102
Passing an Enterprise Bean’s Object Reference......Page 104
In This Chapter......Page 107
The SavingsAccountEJB Example......Page 108
The ejbCreate Method......Page 109
The ejbRemove Method......Page 111
The ejbLoad and ejbStore Methods......Page 112
The Finder Methods......Page 113
The Business Methods......Page 115
The Home Methods......Page 116
Home Interface......Page 118
Finder Method Definitions......Page 119
Remote Interface......Page 120
Setting Up the Database......Page 121
Running the Client......Page 122
One-to-One Relationships......Page 123
Running the StorageBinEJB Example......Page 126
A Helper Class for the Child Table......Page 127
Running the OrderEJB Example......Page 130
An Entity Bean for the Child Table......Page 131
Many-to-Many Relationships......Page 134
Running the EnrollerEJB Example......Page 136
The Primary Key Class......Page 137
Primary Keys in the Entity Bean Class......Page 138
Getting the Primary Key......Page 139
Handling Exceptions......Page 140
In This Chapter......Page 143
Overview of the RosterApp Application......Page 144
The PlayerEJB Code......Page 145
Differences between Container-Managed and Bean- Managed Code......Page 146
Access Methods......Page 147
Select Methods......Page 148
Business Methods......Page 149
Local Home Interface......Page 150
RosterApp......Page 152
JNDI Names Tab (RosterApp)......Page 153
RosterEJB......Page 154
Relationships Tab (TeamJAR)......Page 155
PlayerEJB......Page 158
1. RosterClient......Page 161
1. RosterClient......Page 162
3. TeamEJB......Page 163
2. RosterEJB......Page 164
2. RosterEJB......Page 165
3. TeamEJB......Page 166
2. RosterEJB......Page 167
3. TeamEJB......Page 168
3. PlayerEJB......Page 169
3. PlayerEJB......Page 170
Setting Up......Page 171
deploytool Tips for Entity Beans With Container-Managed Persistence......Page 172
Defining EJB QL Queries for Finder and Select Methods......Page 173
Specifying the Database JNDI Name, User Name, and Password......Page 174
The Primary Key Class......Page 175
Primary Keys in the Entity Bean Class......Page 176
Generating Primary Key Values......Page 177
In This Chapter......Page 179
Example Application Overview......Page 180
The J2EE™ Application Client......Page 181
The onMessage Method......Page 182
Deploying the Application......Page 183
deploytool Tips for Message-Driven Beans......Page 184
Setting the Message-Driven Bean’s Characteristics......Page 185
deploytool Tips for JMS Clients......Page 186
Specifying the JNDI Names......Page 187
In This Chapter......Page 189
Terminology......Page 190
Simple Finder Queries......Page 191
Finder Queries That Navigate to Related Beans......Page 193
Finder Queries with Other Conditional Expressions......Page 194
Select Queries......Page 196
BNF Grammar of EJB QL......Page 197
FROM Clause......Page 200
Identification Variables......Page 201
Path Expressions......Page 203
Examples......Page 204
Navigation......Page 205
Literals......Page 206
Conditional Expressions......Page 207
BETWEEN Expressions......Page 208
LIKE Expressions......Page 209
Collection Member Expressions......Page 210
Functional Expressions......Page 211
NULL Values......Page 212
Equality Semantics......Page 213
Return Types......Page 214
EJB QL Restrictions......Page 215
Web Clients and Components......Page 217
Web Client Life Cycle......Page 218
Web Application Archives......Page 220
Creating a WAR File......Page 221
Adding a Web Component to a WAR File......Page 222
Context Parameters......Page 224
Error Mapping......Page 225
Initialization Parameters......Page 226
Deploying Web Clients......Page 227
Updating Web Clients......Page 228
Internationalizing Web Clients......Page 230
In This Chapter......Page 233
What Is a Servlet?......Page 234
The Example Servlets......Page 235
Troubleshooting......Page 239
Defining The Listener Class......Page 240
Sharing Information......Page 242
Using Scope Objects......Page 243
Controlling Concurrent Access to Shared Resources......Page 244
Accessing Databases......Page 245
Initializing a Servlet......Page 246
Getting Information from Requests......Page 247
Constructing Responses......Page 249
Filtering Requests and Responses......Page 252
Programming Filters......Page 253
Programming Customized Requests and Responses......Page 255
Specifying Filter Mappings......Page 257
Including Other Resources in the Response......Page 259
Transferring Control to Another Web Component......Page 261
Accessing the Web Context......Page 262
Associating Attributes with a Session......Page 263
Session Management......Page 264
Session Tracking......Page 265
Tracking Service Requests......Page 266
Notifying Methods to Shut Down......Page 267
Creating Polite Long-Running Methods......Page 268
In This Chapter......Page 269
What Is a JSP Page?......Page 270
The Example JSP Pages......Page 273
Translation and Compilation......Page 277
Execution......Page 278
Handling Errors......Page 279
Initializing and Finalizing a JSP Page......Page 280
Using Objects within JSP Pages......Page 281
Implicit Objects......Page 282
Shared Objects......Page 283
Declarations......Page 284
Scriptlets......Page 285
Expressions......Page 286
Including Content in a JSP Page......Page 287
Transferring Control to Another Web Component......Page 288
Including an Applet......Page 289
Extending the JSP Language......Page 291
In This Chapter......Page 293
JavaBeans Component Design Conventions......Page 294
Why Use a JavaBeans Component?......Page 295
Creating and Using a JavaBeans Component......Page 296
Setting JavaBeans Component Properties......Page 297
Retrieving JavaBeans Component Properties......Page 299
Custom Tags in JSP™ Pages......Page 303
What is a Custom Tag?......Page 304
The Example JSP Pages......Page 305
Declaring Tag Libraries......Page 309
Tags With Attributes......Page 310
Tags That Define Scripting Variables......Page 311
Cooperating Tags......Page 312
Tag Handlers......Page 313
Tag Library Descriptors......Page 314
listener Element......Page 315
tag Element......Page 316
body-content Element......Page 317
attribute Element......Page 318
Attribute Validation......Page 319
Tag Handlers......Page 320
Tag Handlers......Page 322
Providing Information about the Scripting Variable......Page 323
Cooperating Tags......Page 326
JSP Page......Page 328
Tag Handler......Page 329
Tag Extra Info Class......Page 331
JSP Page......Page 332
Tag Handlers......Page 334
How Is a Tag Handler Invoked?......Page 337
In This Chapter......Page 339
Container-Managed Transactions......Page 340
Transaction Attributes......Page 341
NotSupported......Page 342
Summary of Transaction Attributes......Page 343
Setting Transaction Attributes......Page 344
Rolling Back a Container-Managed Transaction......Page 345
Synchronizing a Session Bean’s Instance Variables......Page 346
Bean-Managed Transactions......Page 347
JDBC Transactions......Page 348
JTA Transactions......Page 349
Returning without Committing......Page 350
Summary of Transaction Options for Enterprise Beans......Page 351
Transaction Timeouts......Page 352
Updating Multiple Databases......Page 353
Transactions in Web Components......Page 355
In This Chapter......Page 357
Overview......Page 358
Declaring and Linking Role References......Page 359
Protecting Web Resources......Page 361
Form-Based Authentication......Page 362
Configuring Web Resources’ Authentication Mechanism......Page 363
Unprotected Web Resources......Page 364
Using Programmatic Security in the EJB Tier......Page 365
Application Client-Tier Security......Page 366
EIS-Tier Security......Page 367
Component-Managed Sign-On......Page 368
Configuring Resource Adapter Security......Page 369
Propagating Security Identity......Page 370
Configuring Client Authentication......Page 371
J2EE Users, Realms, and Groups......Page 372
Managing J2EE Users and Groups......Page 373
Setting Up a Server Certificate......Page 374
JNDI Names and Resource References......Page 377
Specifying a Resource Reference......Page 378
Mapping a Resource Reference to a JNDI Name......Page 379
Database Connections for Enterprise Beans......Page 380
When to Connect......Page 381
deploytool Tips for Specifying Database Users and Passwords......Page 382
Mail Session Connections......Page 383
Running the Client......Page 385
URL Connections......Page 386
Running the Client......Page 387
In This Chapter......Page 389
Resource Adapter Contracts......Page 390
Administering Resource Adapters......Page 392
Transaction Levels......Page 393
Properties......Page 394
The XA Black Box Adapters......Page 395
Deploying the Resource Adapter......Page 396
Testing the Resource Adapter......Page 397
Overview of the CCI......Page 399
Programming with the CCI......Page 401
Database Stored Procedures......Page 403
Mapping to Stored Procedure Parameters......Page 404
Reading Database Records......Page 406
Inserting Database Records......Page 408
Deploying the Resource Adapter......Page 410
Setting Up the Database......Page 411
Browsing the CoffeeApp Application......Page 412
Deploying and Running the CoffeeApp Application......Page 414
The Duke’s Bank Application......Page 415
Enterprise Beans......Page 417
AccountControllerEJB......Page 418
TxControllerEJB......Page 420
Helper Classes......Page 421
Tables Representing Business Entities......Page 422
Tables That Hold the Next Primary Key......Page 423
Application Client......Page 424
The Classes and Their Relationships......Page 426
main Method......Page 427
EventHandle Class......Page 428
hookupEvents Method......Page 429
Constructor......Page 430
Methods......Page 431
Web Client......Page 433
Design Strategies......Page 434
Initializing the Client Components......Page 435
Request Processing......Page 436
Internationalization......Page 439
Adding Groups and Users to the Realm......Page 441
J2EE Server......Page 442
Packaging the Enterprise Beans......Page 443
Compiling the J2EE Application Client......Page 444
Opening the Enterprise Archive File......Page 445
Reviewing JNDI Names......Page 447
Mapping the Security Roles to Groups......Page 449
Creating the Bank Database......Page 450
Running the J2EE Application Client......Page 451
Running the Web Client......Page 452
In This Appendix......Page 455
HTTP Responses......Page 456
In This Appendix......Page 457
J2EE Administration Tool......Page 458
Cloudscape Server......Page 459
Running the Interactive SQL Tool......Page 460
Cloudscape Server Configuration......Page 461
Deployment Tool......Page 462
Key Tool......Page 463
Example......Page 464
Example......Page 465
Example......Page 466
Example......Page 467
Examples......Page 468
Syntax......Page 469
Accessing a Remote Server......Page 470
Command-Line Verifier......Page 471
Stand-Alone GUI Verifier......Page 472
Examples......Page 473
Glossary......Page 477
Biographies......Page 501
Index......Page 503