web server - Borland Technical Publications

Entity beans . . . . . . . . . . . . . . . . . . 87
Find methods and primary key class . . . . . . 88
Create and remove methods . . . . . . . . . . 88
Invoking methods . . . . . . . . . . . . . . . . . 88
Removing bean instances . . . . . . . . . . . . . 89
Using a bean's handle . . . . . . . . . . . . . . . 89
Managing transactions . . . . . . . . . . . . . . . . 90
Getting information about an enterprise bean . . . . 91
Support for JNDI . . . . . . . . . . . . . . . . . . . 92
EJB to CORBA mapping . . . . . . . . . . . . . . . 92
Mapping for distribution . . . . . . . . . . . . . . 93
Mapping for naming . . . . . . . . . . . . . . . . 93
Mapping for transaction . . . . . . . . . . . . . . 94
Mapping for security . . . . . . . . . . . . . . . . 95
Chapter 12
The VisiClient Container 97
Application Client architecture . . . . . . . . . . . . 97
Packaging and deployment . . . . . . . . . . . . 98
Benefits of the VisiClient Container . . . . . . . . 98
Document Type Definitions (DTDs) . . . . . . . . . . 99
Example XML using the DTD . . . . . . . . . . . 99
Support of references and links. . . . . . . . . . . 101
Using the VisiClient Container . . . . . . . . . . 101
VisiClient Container usage example . . . . . . . 102
Running a J2EE client application
on machines not running BES . . . . . . . . . 102
Embedding VisiClient Container
functionality into an existing application . . . . . . 103
Use of Manifest files . . . . . . . . . . . . . . . . 104
Example of a Manifest file . . . . . . . . . . . . 104
Exception handling . . . . . . . . . . . . . . . . . 104
Using resource-reference factory types. . . . . . . 104
Other features. . . . . . . . . . . . . . . . . . . . 105
Using the Client Verify tool. . . . . . . . . . . . 105
Chapter 13
Caching of Stateful Session Beans 107
Passivating Session Beans . . . . . . . . . . . . . 107
Simple Passivation. . . . . . . . . . . . . . . . 107
Aggressive Passivation . . . . . . . . . . . . . 108
Sessions in secondary storage . . . . . . . . . . . 108
Setting the keep alive timeout in Containers. . . 109
Setting the keep alive timeout for a
particular session bean . . . . . . . . . . . . 109
Chapter 14
Entity Beans and CMP 1.1 in
Borland Enterprise Server 111
Entity Beans . . . . . . . . . . . . . . . . . . . . 111
Container-managed persistence and
Relationships . . . . . . . . . . . . . . . . . . . 112
Implementing an entity bean . . . . . . . . . . . . 112
Packaging Requirements . . . . . . . . . . . . 112
Entity Bean Primary Keys . . . . . . . . . . . . 113
Generating primary keys from a
user class . . . . . . . . . . . . . . . . . . 113
Generating primary keys from a
custom class . . . . . . . . . . . . . . . . 114
Support for composite keys . . . . . . . . . . 114
Reentrancy . . . . . . . . . . . . . . . . . . . . 114
Container-Managed Persistence in
Borland Enterprise Server . . . . . . . . . . . . . 115
BES CMP engine's CMP 1.1 implementation . . 115
Providing CMP metadata to the Container . . 115
Constructing finder methods . . . . . . . . . 116
Constructing the where clause . . . . . . . . 116
Parameter substitution . . . . . . . . . . . . 117
Compound parameters . . . . . . . . . . . . 117
Entity beans as parameters . . . . . . . . . . 117
Specifying relationships between entities . . . 118
Container-managed field names . . . . . . . 119
Setting Properties . . . . . . . . . . . . . . . . . . 120
Using the Deployment Descriptor Editor . . . . . 120
J2EE 1.2 Entity Bean using
BMP or CMP 1.1. . . . . . . . . . . . . . . 120
Container-managed data access support . . . . 121
Using SQL keywords . . . . . . . . . . . . . 122
Using null values . . . . . . . . . . . . . . . 122
Establishing a database connection. . . . . . 122
Container-created tables . . . . . . . . . . . 122
Mapping Java types to SQL types. . . . . . . 123
Automatic table mapping . . . . . . . . . . . . . 124
Chapter 15
Entity Beans and Table Mapping
for CMP 2.0 127
Entity Beans . . . . . . . . . . . . . . . . . . . . . 127
Container-managed persistence
and Relationships . . . . . . . . . . . . . . . . . 128
Packaging Requirements . . . . . . . . . . . . . 128
A note on reentrancy . . . . . . . . . . . . . . . 129
Container-Managed Persistence in
Borland Enterprise Server . . . . . . . . . . . . . 129
About the Persistence Manager . . . . . . . . . 129
Borland CMP engine's
CMP 2.0 implementation . . . . . . . . . . . . 130
Optimistic Concurrency Behavior. . . . . . . . . 130
Pessimistic Behavior . . . . . . . . . . . . . 131
Optimistic Concurrency . . . . . . . . . . . . 131
Persistence Schema . . . . . . . . . . . . . . . 132
Specifying tables and datasources . . . . . . 132
Basic Mapping of CMP fields to columns . . . 133
Mapping one field to multiple columns . . . . 134
Mapping CMP fields to multiple tables . . . . 135
Specifying relationships between tables . . . 136
Using cascade delete and database
cascade delete . . . . . . . . . . . . . . . . . 139
Database cascade delete support . . . . . . 140
Chapter 16
Using BES Properties for CMP 2.x 143
Setting Properties . . . . . . . . . . . . . . . . . . 143
Using the Deployment Descriptor Editor . . . . . 143
The EJB Designer . . . . . . . . . . . . . . . . 143
J2EE 1.3 Entity Bean . . . . . . . . . . . . . 144
Setting CMP 2.x Properties . . . . . . . . . . . 144
Editing Entity properties . . . . . . . . . . . . . 145
iii