Oracle Fusion Middleware Online Documentation Library

Oracle® Fusion Middleware
Programming Enterprise JavaBeans for Oracle WebLogic
Server
11g Release 1 (10.3.5)
E13719-05

April 2011
This document is a resource for software developers who
develop applications that include WebLogic Server
Enterprise JavaBeans (EJBs).

Oracle Fusion Middleware Programming Enterprise JavaBeans for Oracle WebLogic Server, 11g Release 1
(10.3.5)
E13719-05
Copyright © 2007, 2011, Oracle and/or its affiliates. All rights reserved.
This software and related documentation are provided under a license agreement containing restrictions on
use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your
license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license,
transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse
engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is
prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If
you find any errors, please report them to us in writing.
If this software or related documentation is delivered to the U.S. Government or anyone licensing it on
behalf of the U.S. Government, the following notice is applicable:
U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data
delivered to U.S. Government customers are "commercial computer software" or "commercial technical data"
pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As
such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and
license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of
the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software
License (December 2007). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.
This software is developed for general use in a variety of information management applications. It is not
developed or intended for use in any inherently dangerous applications, including applications which may
create a risk of personal injury. If you use this software in dangerous applications, then you shall be
responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure the safe use
of this software. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of
this software in dangerous applications.
Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks
of their respective owners.
This software and documentation may provide access to or information on content, products, and services

from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all
warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and
its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of
third-party content, products, or services.

Contents
Preface ............................................................................................................................................................ xxvii
Documentation Accessibility ................................................................................................................
Conventions ............................................................................................................................................

xxvii
xxvii

1 Introduction and Roadmap
1.1
1.2
1.3
1.4
1.4.1
1.4.2

1.5

Document Scope and Audience................................................................................................
Guide to this Document .............................................................................................................
Related Documentation..............................................................................................................
Samples and Tutorials for the EJB Developer.........................................................................
Avitek Medical Records Application (MedRec) and Tutorials.....................................
EJB Examples in the WebLogic Server Distribution .......................................................
New and Changed Features in This Release ..........................................................................

1-1
1-1
1-2
1-3
1-3
1-3
1-3

2 Understanding Enterprise JavaBeans
2.1

2.1.1
2.1.1.1
2.1.1.2
2.1.2
2.1.3
2.2
2.2.1
2.2.2
2.2.3
2.2.4
2.2.4.1
2.2.4.2
2.3
2.3.1
2.4
2.5
2.5.1
2.5.2
2.5.3
2.5.4

How Do Applications Use EJBs? ..............................................................................................
Session EJBs Implement Business Logic...........................................................................
Stateless Session Beans ................................................................................................
Stateful Session Beans .................................................................................................
Entity EJBs Maintain Persistent Data ...............................................................................
Message-Driven Beans Implement Loosely Coupled Business Logic .........................
EJB Anatomy and Environment ...............................................................................................
EJB Components ..................................................................................................................
The EJB Container................................................................................................................
EJB Deployment Descriptors..............................................................................................
Key Deployment Element Mappings................................................................................
Bean and Resource References ...................................................................................
Security Roles ................................................................................................................
EJBs, Clients, and Application Objects ....................................................................................
EJB Communications...........................................................................................................
EJBs and Message Destination References ..............................................................................
WebLogic Server Value-Added EJB Features.........................................................................
Performance-Enhancing Features for WebLogic Server EJBs .......................................
Pooling Improves EJB Response Time .............................................................................

Caching Improves EJB Performance.................................................................................
Additional Caching Capabilities for CMP Entities ........................................................

2-1
2-1
2-1
2-2
2-2
2-2
2-3
2-3
2-4
2-4
2-4
2-5
2-5
2-6
2-7
2-7
2-8

2-8
2-8
2-8
2-9

iii

2.5.5
Field Groups for Efficient Queries (CMP Entities) ......................................................... 2-9
2.5.6
Configurable Write Behaviors .......................................................................................... 2-9
2.5.7
Operation Ordering and Batching (CMP Entities).......................................................... 2-9
2.5.8
Optimized Database Updates (CMP Entities) ................................................................. 2-9
2.5.9
Read-Only Pattern and Read-Only Invalidation (CMP Entities) ................................. 2-9
2.5.10
CMP Beans Increase Developer Productivity .............................................................. 2-10
2.5.11

Automatic Primary Key Generation (CMP Entities) ................................................... 2-10
2.5.12
Automatic Table Creation (CMP Entities) .................................................................... 2-10
2.5.13
Dynamic Queries (CMP Entities) ................................................................................... 2-10
2.5.14
Reliability and Availability Features ............................................................................. 2-10
2.5.15
Load Balancing Among Clustered EJBs Increases Scalability.................................... 2-11
2.5.16
Failover for Clustered EJBs Increases Reliability ........................................................ 2-11
2.6
Securing EJBs ............................................................................................................................ 2-12

3 Designing Enterprise JavaBeans
3.1
Choosing the Right Bean Type..................................................................................................
3.1.1
Session Bean Features .........................................................................................................
3.1.2

Stateful Session Beans .........................................................................................................
3.1.3
Stateless Session Beans........................................................................................................
3.1.3.1
Stateless Beans Offer Performance and Scalability Advantages ..........................
3.1.3.2
Exposing Stateless Session Beans as Web Services..................................................
3.1.4
Entity Bean Features............................................................................................................
3.1.4.1
Key Features of Entity Beans ......................................................................................
3.1.4.2
Read-Write versus Read-Only Entity Beans.............................................................
3.1.4.3
Entity Bean Performance and Data Consistency Characteristics ..........................
3.1.4.3.1
Use Read-Only Beans to Improve Performance If Stale Data Is Tolerable ...
3.1.4.3.2
Use Read-Write Beans for Higher Data Consistency .......................................
3.1.4.3.3

Combine Read-Only and Read-Write Beans to Optimize Performance .......
3.1.4.3.4
Use Session Facades to Optimize Performance for Remote Entity Beans.....
3.1.4.3.5
Avoid the Use of Transfer Objects .....................................................................
3.1.5
Message-Driven Beans ........................................................................................................
3.2
Persistence Management Alternatives.....................................................................................
3.2.1
Use Container-Managed Persistence (CMP) for Productivity and Portability...........
3.2.2
Use Bean-Managed Persistence (BMP) Only When Necessary ....................................
3.3
Transaction Design and Management Options ......................................................................
3.3.1
Understanding Transaction Demarcation Strategies and Performance ......................
3.3.2
Demarcating Transactions at the Server Level is Most Efficient ..................................
3.3.3

Container-Managed Transactions Are Simpler to Develop and Perform Well..........
3.3.3.1
Rollback..........................................................................................................................
3.3.3.2
Transaction Boundaries ...............................................................................................
3.3.3.3
Distributing Transactions Across Beans ...................................................................
3.3.3.4
Costly Option: Distributing Transactions Across Databases ................................
3.3.4
Bean-Level Transaction Management .............................................................................
3.3.4.1
When to Use Bean-Managed Transactions ...............................................................
3.3.4.2
Keep Bean-Managed Transactions Short ..................................................................
3.3.5
Client-Level Transaction Management is Costly ............................................................
3.3.6
Transaction Isolation: A Performance vs. Data Consistency Choice ...........................

iv

3-1
3-1
3-2
3-2
3-2
3-3
3-3
3-3
3-3
3-4
3-4
3-4
3-4
3-4
3-5
3-5
3-5
3-5
3-6
3-6
3-6
3-6
3-6
3-7
3-7
3-7
3-7
3-7
3-8
3-8
3-8
3-8

3.4

Satisfying Application Requirements with WebLogic Server EJBs ..................................... 3-9

4 Implementing Enterprise JavaBeans
4.1
Overview of the EJB Development Process ............................................................................ 4-1
4.2
Create a Source Directory .......................................................................................................... 4-3
4.3
Create EJB Classes and Interfaces............................................................................................. 4-4
4.3.1
Using WebLogic Server Generic Bean Templates........................................................... 4-4
4.3.2
Programming Client Access to EJBs ................................................................................. 4-4
4.3.3
Programming Client to Obtain Initial Context ............................................................... 4-4
4.3.4
Programming Client to Look Up a Home Interface ...................................................... 4-5
4.3.4.1
Using EJB Links ............................................................................................................ 4-5
4.3.5
Configuring EJBs to Send Requests to a URL.................................................................. 4-5
4.3.6
Specifying an HTTP Resource by URL ............................................................................ 4-5
4.3.7
Specifying an HTTP Resource by Its JNDI Name........................................................... 4-6
4.3.8
Accessing HTTP Resources from Bean Code .................................................................. 4-6
4.3.9
Configuring Network Communications for an EJB........................................................ 4-6
4.3.10
Programming and Configuring Transactions ................................................................. 4-6
4.3.11
Programming Container-Managed Transactions .......................................................... 4-7
4.3.12
Configuring Automatic Retry of Container-Managed Transactions ........................... 4-7
4.3.13
Programming Bean-Managed Transactions .................................................................... 4-8
4.3.14
Programming Transactions That Are Distributed Across EJBs ................................. 4-10
4.3.14.1
Calling multiple EJBs from a client's transaction context.................................... 4-10
4.3.14.2
Using an EJB "Wrapper" to Encapsulate a Cross-EJB Transaction..................... 4-10
4.4
Programming the EJB Timer Service..................................................................................... 4-10
4.4.1
Clustered Versus Local EJB Timer Services .................................................................. 4-11
4.4.2
Clustered EJB Timer Services.......................................................................................... 4-11
4.4.3
Local EJB Timer Services ................................................................................................. 4-11
4.4.4
Using Java Programming Interfaces to Program Timer Objects................................ 4-11
4.4.5
EJB 2.1 Timer-related Programming Interfaces............................................................ 4-11
4.4.6
WebLogic Server-specific Timer-related Programming Interfaces ........................... 4-12
4.4.7
Timer Deployment Descriptors ...................................................................................... 4-14
4.4.8
Configuring Clustered EJB Timers................................................................................. 4-14
4.5
Declare Web Service References ............................................................................................ 4-15
4.6
Compile Java Source ............................................................................................................... 4-15
4.7
Generate Deployment Descriptors ........................................................................................ 4-16
4.8
Edit Deployment Descriptors................................................................................................. 4-16
4.8.1
Security Elements ............................................................................................................. 4-16
4.8.2
Resource Mapping Elements........................................................................................... 4-17
4.8.3
Persistence Elements ........................................................................................................ 4-18
4.8.4
Clustering Elements ......................................................................................................... 4-19
4.8.5
Data Consistency Elements ............................................................................................. 4-20
4.8.6
Container-Managed Transactions Elements................................................................. 4-20
4.8.7
Performance Elements ..................................................................................................... 4-22
4.8.8
Network Communications Elements............................................................................. 4-24
4.9
Generate EJB Wrapper Classes, and Stub and Skeleton Files ........................................... 4-24
4.9.1
appc and Generated Class Name Collisions ................................................................ 4-25
4.10
Package ..................................................................................................................................... 4-25

v

4.10.1
Packaging Considerations for EJBs with Clients in Other Applications ..................
4.11
Deploy .......................................................................................................................................
4.12
Solving Problems During Development...............................................................................
4.12.1
Adding Line Numbers to Class Files .............................................................................
4.12.2
Monitoring Data ...............................................................................................................
4.12.3
Creating Debug Messages ...............................................................................................
4.13
WebLogic Server Tools for Developing EJBs.......................................................................
4.13.1
Oracle JDeveloper .............................................................................................................
4.13.2
Oracle Enterprise Pack for Eclipse .................................................................................
4.13.3
Administration Console ..................................................................................................
4.13.4
javac ....................................................................................................................................
4.13.5
EJBGen................................................................................................................................
4.13.6
DDInit .................................................................................................................................
4.13.7
WebLogic Server Ant Utilities ........................................................................................
4.13.8
weblogic.Deployer............................................................................................................
4.13.9
appc.....................................................................................................................................
4.13.10
DDConverter .....................................................................................................................
4.13.11
Comparison of EJB Tool Features...................................................................................

4-25
4-25
4-26
4-26
4-26
4-26
4-26
4-26
4-26
4-27
4-27
4-27
4-28
4-28
4-28
4-28
4-28
4-29

5 Session EJBs
5.1
5.2
5.3
5.3.1
5.3.2
5.3.3
5.3.3.1
5.3.3.2
5.3.4
5.3.5
5.4
5.4.1
5.4.2
5.5
5.5.1

Comparing Stateless and Stateful Session Beans ...................................................................
Pooling for Stateless Session EJBs.............................................................................................
Caching and Passivating Stateful Session EJBs ......................................................................
Stateful Session EJB Creation .............................................................................................
Stateful Session EJB Passivation ........................................................................................
Controlling Passivation ......................................................................................................
Eager Passivation (LRU)..............................................................................................
Lazy Passivation (NRU) ..............................................................................................
Specifying the Persistent Store Directory for Passivated Beans ...................................
Configuring Concurrent Access to Stateful Session Beans............................................
Design Decisions for Session Beans .........................................................................................
Choosing Between Stateless and Stateful Beans .............................................................
Choosing the Optimal Free Pool Setting for Stateless Session Beans ..........................
Implementing Session Beans.....................................................................................................
WebLogic-Specific Configurable Behaviors for Session Beans .....................................

5-1
5-2
5-3
5-4
5-4
5-4
5-5
5-5
5-5
5-6
5-6
5-6
5-6
5-7
5-7

6 Entity EJBs
6.1
6.1.1
6.1.2
6.1.3
6.1.4
6.1.5
6.1.6
6.1.7
6.2
6.2.1
vi

Managing Entity Bean Pooling and Caching .........................................................................
Understanding Entity Pooling ...........................................................................................
Understanding Entity Caching ..........................................................................................
Understanding Passivation of Entity Beans.....................................................................
Understanding ejbLoad() and ejbStore() Behavior .........................................................
Controlling the Behavior of ejbLoad() and ejbStore() ...................................................
Disabling Cache Flushing ..................................................................................................
Configuring Application-Level Caching .........................................................................
Using Primary Keys....................................................................................................................
Specifying Primary Keys and Primary Key Classes .......................................................

6-1
6-2
6-3
6-4
6-4
6-5
6-5
6-5
6-6
6-7

6.2.2
Guidelines for Primary Keys.............................................................................................. 6-7
6.2.3
Automatically Generating Primary Keys ......................................................................... 6-8
6.2.4
Specifying Automatic Key Generation for Oracle Databases ....................................... 6-8
6.2.5
Specifying Automatic Key Generation for Microsoft SQL Server................................ 6-9
6.2.6
Generating Primary Keys with a Named Sequence Table............................................. 6-9
6.2.7
Declaring Primary Key Field Type................................................................................. 6-10
6.2.8
Support for Oracle Database SEQUENCE ................................................................... 6-10
6.2.9
String-Valued CMP Field Trimming ............................................................................. 6-10
6.2.10
Benefits of String Trimming ............................................................................................ 6-11
6.2.11
Disabling String Trimming.............................................................................................. 6-11
6.3
Configuring Entity EJBs for Database Operations .............................................................. 6-11
6.3.1
Configuring Table Mapping ........................................................................................... 6-11
6.3.2
Automatic Table Creation (Development Only).......................................................... 6-12
6.3.3
Delaying Database Inserts ............................................................................................... 6-14
6.3.4
Why Delay Database Inserts? ......................................................................................... 6-14
6.3.5
Configuring Delayed Database Inserts.......................................................................... 6-15
6.3.6
Limiting Database Reads with cache-between-transactions ...................................... 6-15
6.3.7
Updating the Database Before Transaction Ends ........................................................ 6-16
6.3.8
Dynamic Queries .............................................................................................................. 6-16
6.3.9
Enabling Dynamic Queries ............................................................................................. 6-16
6.3.10
Executing Dynamic Queries............................................................................................ 6-17
6.3.11
Enabling BLOB and CLOB Column Support for Oracle or DB2 Databases............. 6-17
6.3.12
Specifying a BLOB Column Using the Deployment Descriptor................................ 6-17
6.3.13
Serialization for cmp-fields of Type byte[] Mapped to an Oracle Blob .................... 6-17
6.3.14
Specifying a CLOB Column Using the Deployment Descriptor ............................... 6-17
6.3.15
Optimized CLOB Column Insertion on Oracle 10g..................................................... 6-18
6.3.16
Specifying Field Groups .................................................................................................. 6-18
6.3.17
Ordering and Batching Operations................................................................................ 6-19
6.3.18
Operation Ordering.......................................................................................................... 6-19
6.3.19
Batch Operations Guidelines and Limitations ............................................................. 6-19
6.3.20
Using Query Caching (Read-Only Entity Beans)......................................................... 6-20
6.4
Using SQL in Entity Beans...................................................................................................... 6-20
6.5
Using Container-Managed Relationships (CMRs).............................................................. 6-20
6.5.1
CMR Requirements and Limitations ............................................................................. 6-21
6.5.2
CMR Cardinality............................................................................................................... 6-21
6.5.3
CMR Direction .................................................................................................................. 6-21
6.5.4
Removing CMRs ............................................................................................................... 6-22
6.5.5
Defining Container-Managed Relationships (CMRs) ................................................. 6-22
6.5.6
Specifying Relationships in ejb-jar.xml ......................................................................... 6-22
6.5.6.1
Specifying Relationship Cardinality ....................................................................... 6-23
6.5.6.2
Specifying Relationship Directionality................................................................... 6-23
6.5.7
Specifying Relationships in weblogic-cmp-jar.xml ..................................................... 6-24
6.5.7.1
One-to-One and One-to-Many Relationships ....................................................... 6-24
6.5.7.2
Many-to-Many Relationships .................................................................................. 6-25
6.5.7.3
Specifying CMRs for EJBs that Map to Multiple Tables ...................................... 6-26
6.5.8
About CMR Fields and CMR Field Accessor Methods .............................................. 6-26
6.5.9
Using Cascade Delete for Entities in CMRs.................................................................. 6-27

vii

6.5.10
Relationship Caching ....................................................................................................... 6-27
6.5.11
Enabling Relationship Caching ...................................................................................... 6-28
6.6
Choosing a Concurrency Strategy ......................................................................................... 6-29
6.6.1
Exclusive Concurrency .................................................................................................... 6-29
6.6.2
Database Concurrency ..................................................................................................... 6-30
6.6.3
Optimistic Concurrency................................................................................................... 6-30
6.6.4
Preventing Stale Optimistic Bean Data ......................................................................... 6-30
6.6.5
Explicit Invalidation of Optimistic Beans...................................................................... 6-30
6.6.6
Invalidation Options for Optimistic Concurrency in Clusters................................... 6-30
6.6.7
Check Data for Validity with Optimistic Concurrency............................................... 6-31
6.6.8
Optimistic Concurrency and Oracle Databases ........................................................... 6-32
6.6.9
Read Only Concurrency .................................................................................................. 6-33
6.6.10
Concurrency Strategy Trade-Offs .................................................................................. 6-33
6.6.11
Configuring Concurrency Strategy ................................................................................ 6-34
6.6.12
Deadlock Prevention for Exclusive Concurrency and Cascade Deletes................... 6-34
6.6.13
Using the Read-Mostly Pattern....................................................................................... 6-35
6.6.14
Configuring Entity Beans for Read-Mostly Pattern..................................................... 6-35
6.6.15
Invalidating Read-Only Entity EJBs Implicitly ............................................................ 6-36
6.6.16
Invalidating Entity EJBs Explicitly ................................................................................. 6-36
6.7
CMP Entity Bean Descriptors Element by Feature ............................................................. 6-37
6.7.1
Container-Managed Relationship Elements ................................................................. 6-37
6.7.2
Primary Key Elements ..................................................................................................... 6-37

7 Message-Driven EJBs
8 Deployment Guidelines for Enterprise JavaBeans
8.1
8.2
8.3
8.3.1
8.3.2
8.3.3
8.3.4
8.3.5
8.3.6
8.3.7
8.3.8
8.3.9

8-1
8-1
8-2
8-2
8-2
8-3
8-3
8-3
8-3
8-4
8-4
8-4

Before You Deploy an EJB .........................................................................................................
Understanding and Performing Deployment Tasks .............................................................
Deployment Guidelines for EJBs ..............................................................................................
Deploy EJBs as Part of an Enterprise Application ..........................................................
Deploy EJBs That Call Each Other in the Same Application.........................................
Deploying EJBs that Use Dependency Injection .............................................................
Deploy Homogeneously to a Cluster................................................................................
Deploying Pinned EJBs to a Cluster..................................................................................
Redeploying an EJB .............................................................................................................
Using FastSwap Deployment to Minimize Deployment ...............................................
Understanding Warning Messages ..................................................................................
Disabling EJB Deployment Warning Messages ..............................................................

A Deployment Descriptor Schema and Document Type Definitions Reference
A.1
A.1.1
A.1.2
A.1.3
A.2

viii

XML Schema Definitions and Namespace Declarations......................................................
weblogic-ejb-jar.xml Namespace Declaration and Schema Location .........................
weblogic-cmp-jar.xml Namespace Declaration and Schema Location.......................
ejb-jar.xml Namespace Declaration and Schema Location...........................................
Document Type Definitions and DOCTYPE Header Information .....................................

A-1
A-2
A-2
A-2
A-2

B weblogic-ejb-jar.xml Deployment Descriptor Reference
B.1
B.2
B.3
B.3.1
B.3.2
B.4
B.4.1
B.4.2
B.5
B.5.1
B.5.2
B.6
B.6.1
B.6.2
B.7
B.7.1
B.7.2
B.8
B.8.1
B.8.2
B.9
B.9.1
B.9.2
B.10
B.10.1
B.11
B.11.1
B.11.2
B.12
B.12.1
B.12.2
B.13
B.13.1
B.13.2
B.14
B.14.1
B.15
B.15.1
B.16
B.16.1
B.16.2
B.17
B.17.1
B.17.2
B.18
B.18.1

2.1 weblogic-ejb-jar.xml File Structure....................................................................................
2.1 weblogic-ejb-jar.xml Elements ...........................................................................................
allow-concurrent-calls ...............................................................................................................
Function................................................................................................................................
Example................................................................................................................................
allow-remove-during-transaction ...........................................................................................
Function................................................................................................................................
Example................................................................................................................................
cache-between-transactions......................................................................................................
Function................................................................................................................................
Example................................................................................................................................
cache-type ...................................................................................................................................
Function................................................................................................................................
Example................................................................................................................................
client-authentication ..................................................................................................................
Function................................................................................................................................
Example................................................................................................................................
client-cert-authentication ..........................................................................................................
Function................................................................................................................................
Example................................................................................................................................
clients-on-same-server...............................................................................................................
Function................................................................................................................................
Example................................................................................................................................
component-factory-class-name ................................................................................................
Function................................................................................................................................
concurrency-strategy .................................................................................................................
Function..............................................................................................................................
Example..............................................................................................................................
confidentiality...........................................................................................................................
Function..............................................................................................................................
Example..............................................................................................................................
connection-factory-jndi-name ................................................................................................
Function..............................................................................................................................
Example..............................................................................................................................
connection-factory-resource-link...........................................................................................
Function..............................................................................................................................
create-as-principal-name.........................................................................................................
Function..............................................................................................................................
delay-updates-until-end-of-tx ................................................................................................
Function..............................................................................................................................
Example..............................................................................................................................
description.................................................................................................................................
Function..............................................................................................................................
Example..............................................................................................................................
destination-jndi-name .............................................................................................................
Function..............................................................................................................................

B-1
B-2
B-6
B-6
B-6
B-6
B-6
B-7
B-7
B-7
B-7
B-7
B-7
B-8
B-8
B-8
B-8
B-8
B-8
B-8
B-8
B-9
B-9
B-9
B-9
B-9
B-10
B-10
B-10
B-11
B-11
B-11
B-11
B-11
B-11
B-11
B-12
B-12
B-12
B-12
B-13
B-13
B-13
B-13
B-13
B-14

ix

B.18.2
B.19
B.19.1
B.20
B.20.1
B.20.2
B.21
B.21.1
B.21.2
B.22
B.22.1
B.22.2
B.23
B.23.1
B.23.2
B.24
B.24.1
B.24.2
B.25
B.25.1
B.25.2
B.26
B.26.1
B.26.2
B.27
B.27.1
B.27.2
B.28
B.28.1
B.28.2
B.29
B.29.1
B.29.2
B.30
B.30.1
B.31
B.31.1
B.31.2
B.32
B.32.1
B.32.2
B.33
B.33.1
B.33.2
B.34
B.34.1
B.34.2

x

Example..............................................................................................................................
destination-resource-link ........................................................................................................
Function..............................................................................................................................
disable-warning........................................................................................................................
Function..............................................................................................................................
Example..............................................................................................................................
dispatch-policy .........................................................................................................................
Function..............................................................................................................................
Example..............................................................................................................................
distributed-destination-connection .......................................................................................
Function..............................................................................................................................
Example..............................................................................................................................
durable-subscription-deletion................................................................................................
Function..............................................................................................................................
Example..............................................................................................................................
ejb-name ....................................................................................................................................
Function..............................................................................................................................
Example..............................................................................................................................
ejb-reference-description.........................................................................................................
Function..............................................................................................................................
Example..............................................................................................................................
ejb-ref-name ..............................................................................................................................
Function..............................................................................................................................
Example..............................................................................................................................
enable-bean-class-redeploy ....................................................................................................
Function..............................................................................................................................
Example..............................................................................................................................
enable-call-by-reference ..........................................................................................................
Function..............................................................................................................................
Example..............................................................................................................................
enable-dynamic-queries ..........................................................................................................
Function..............................................................................................................................
Example..............................................................................................................................
entity-always-uses-transaction ..............................................................................................
Function..............................................................................................................................
entity-cache ...............................................................................................................................
Function..............................................................................................................................
Example..............................................................................................................................
entity-cache-name ....................................................................................................................
Function..............................................................................................................................
Example..............................................................................................................................
entity-cache-ref .........................................................................................................................
Function..............................................................................................................................
Example..............................................................................................................................
entity-clustering .......................................................................................................................
Function..............................................................................................................................
Example..............................................................................................................................

B-14
B-14
B-14
B-14
B-14
B-15
B-15
B-15
B-15
B-15
B-16
B-16
B-16
B-16
B-16
B-16
B-17
B-17
B-17
B-17
B-17
B-17
B-18
B-18
B-18
B-18
B-18
B-18
B-19
B-19
B-19
B-19
B-19
B-19
B-20
B-20
B-20
B-20
B-20
B-21
B-21
B-21
B-21
B-21
B-21
B-22
B-22

B.35
B.35.1
B.35.2
B.36
B.36.1
B.36.2
B.37
B.37.1
B.38
B.38.1
B.38.2
B.39
B.39.1
B.40
B.41
B.41.1
B.41.2
B.42
B.42.1
B.42.2
B.43
B.43.1
B.43.2
B.44
B.44.1
B.44.2
B.45
B.45.1
B.45.2
B.46
B.46.1
B.46.2
B.47
B.47.1
B.47.2
B.48
B.48.1
B.49
B.49.1
B.49.2
B.50
B.50.1
B.50.2
B.51
B.51.1
B.51.2
B.52

entity-descriptor.......................................................................................................................
Function..............................................................................................................................
Example..............................................................................................................................
estimated-bean-size .................................................................................................................
Function..............................................................................................................................
Example..............................................................................................................................
externally-defined ....................................................................................................................
Function..............................................................................................................................
finders-load-bean .....................................................................................................................
Function..............................................................................................................................
Example..............................................................................................................................
generate-unique-jms-client-id ................................................................................................
Function..............................................................................................................................
global-role ...................................................................................................................