user manual

iii
Java:RPC provider . . . . . . . . . . . . 89
Java:EJB provider. . . . . . . . . . . . . 89
Java:VISIBROKER provider . . . . . . . 90
Java:MDB provider . . . . . . . . . . . . 92
How Borland Web Services work . . . . . . . . 92
Web Service Deployment Descriptors. . . . . . 93
Creating a server-config.wsdd file . . . . . . 94
Viewing and Editing WSDD Properties . . . 94
Packaging Web Service Application Archives. . 94
Borland Web Services examples . . . . . . . . 95
Using the Web Service provider examples. . 95
Steps to build, deploy, and run the examples
95
Apache Axis Web Service samples . . . . . 96
Tools Overview . . . . . . . . . . . . . . . . . 96
Apache ANT tool . . . . . . . . . . . . . . . 96
Java2WSDL tool . . . . . . . . . . . . . . . 96
WSDL2Java tool . . . . . . . . . . . . . . . 97
Axis Admin tool. . . . . . . . . . . . . . . . 97
Chapter 10
Web applications bundled with BES 99
About Cocoon . . . . . . . . . . . . . . . . . . 99
Chapter 11
Writing enterprise bean clients 101
Client view of an enterprise bean . . . . . . . 101
Initializing the client . . . . . . . . . . . . 102
Locating the home interface . . . . . . . . 102
Obtaining the remote interface . . . . . . . 103
Session beans . . . . . . . . . . . . . 103
Entity beans . . . . . . . . . . . . . . . 104
Find methods and primary key class . . 104
Create and remove methods . . . . . . 105
Invoking methods . . . . . . . . . . . . . 105
Removing bean instances . . . . . . . . . 106
Using a bean's handle . . . . . . . . . . . 106
Managing transactions . . . . . . . . . . . . 108
Getting information about an enterprise bean. 109
Support for JNDI . . . . . . . . . . . . . . . 109
EJB to CORBA mapping . . . . . . . . . . . 110
Mapping for distribution . . . . . . . . . . 110
Mapping for naming . . . . . . . . . . . . 111
Mapping for transaction . . . . . . . . . . 112
Mapping for security . . . . . . . . . . . . 113
Chapter 12
The VisiClient Container 115
Application Client architecture. . . . . . . . . 115
Packaging and deployment . . . . . . . . .116
Benefits of the VisiClient Container . . . . . 117
Document Type Definitions (DTDs) . . . . . . . 117
Example XML using the DTD . . . . . . . . 118
Support of references and links. . . . . . . . . 120
Using the VisiClient Container . . . . . . . . 121
VisiClient Container usage example. . . . . 121
Running a J2EE client application on machines
not running BES . . . . . . . . . . . . . . 121
Embedding VisiClient Container functionality into
an existing application. . . . . . . . . . . . .122
Use of Manifest files . . . . . . . . . . . . . . 123
Example of a Manifest file . . . . . . . . . . 123
Exception handling . . . . . . . . . . . . . . . 124
Using resource-reference factory types. . . . . 124
Other features. . . . . . . . . . . . . . . . . . 124
Using the Client Verify tool. . . . . . . . . . 125
Chapter 13
Caching of Stateful Session Beans 127
Passivating Session Beans . . . . . . . . . . .127
Simple Passivation. . . . . . . . . . . . . . 128
Aggressive Passivation . . . . . . . . . . . 128
Sessions in secondary storage . . . . . . . . . 129
Setting the keep alive timeout in Containers. 129
Setting the keep alive timeout for a particular
session bean . . . . . . . . . . . . . . . . 130
Chapter 14
Entity Beans and CMP 1.1 in Borland
Enterprise Server 131
Entity Beans . . . . . . . . . . . . . . . . . . 131
Container-managed persistence and Relationships
132
Implementing an entity bean . . . . . . . . . . 132
Packaging Requirements . . . . . . . . . . 133
Entity Bean Primary Keys . . . . . . . . . . 133
Generating primary keys from a user class .
134
Generating primary keys from a custom class
134
Support for composite keys. . . . . . . . 134
Reentrancy . . . . . . . . . . . . . . . . . 135
Container-Managed Persistence in Borland
Enterprise Server . . . . . . . . . . . . . . . 135
BES CMP engine's CMP 1.1 implementation . .
136
Providing CMP metadata to the Container . .
137