Index

A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X  Z 

---

Symbols

<J2EE-Container>-jar.xml file

EJB 3.0, 8.1.4.3

---

A

access

data access, 84

direct, 35.16.1

modifiers, 5.7.2.2

optimizing data access, 11.10

remote sessions, 75.9.2.1

access method

direct, 35.6

generating, 5.5.3.2

mappings, 35.6.1

method, 35.6

specifying, 35.16.1

access modifiers, classes, 5.7.2.2

acquiring

client sessions, 78.4

sessions, at runtime, 75.2.4

unit of work, 101.1

activating descriptors, 5.3.3

Add Named Query dialog, 28.7.1.1, 28.7.1.6.1, 28.7.1.7.1

Add New Class dialog, 5.7.1.1

Add New Table button, 5.5.1.2

Add or Refresh Class button, 5.7.3.1

addConstraingDependencies(), 102.10.2

address

multicast group, 91.4

multicast port, 91.5

Add/Update Existing Tables from Database button, 5.5.1.3

advanced properties for descriptors, 22.6

After Load tab, 28.33.1

aggregate collection relational mappings

and EJB, 36.9.2

configuring, 44

understanding, 36.9

aggregate descriptors

about, 26.2.6

aggregate object mapping, 26.2.6.1

EIS projects, 26.2.6.2

EJB 3.0, 26.2.6.1.1

inheritance, 26.7.4

relational projects, 26.2.6.1

XML projects, 26.2.6.3

aggregate object relational mapping

aggregate descriptors, and, 26.2.6.1

aggregate object relational mappings

configuring, 47

understanding, 36.12

aggregation, isolated client sessions, 75.5.2

AllFieldsLockingPolicy, 26.8.4

allows none, 28.7.1.6.1, 97.7.1.1

allows null, 28.7.1.6.1, 97.7.1.1

amending descriptors, 2.9.2.1.1, 26.2.5, 28.33

see also after load

announcement delay, 91.9

Ant, integrating with Oracle TopLink Workbench, 5.8

any collection XML mappings

configuring, 72

understanding, 65.8

any object XML mappings

configuring, 71

understanding, 65.7

application development

deploying, 10

mapping, 2.9.2.1

querying, 2.4.3.4, 74.5

troubleshooting, 15

application layer, remote sessions, 75.9.1.1

application servers

EJB support, customizing, 7.7

integrating with Oracle TopLink, 7

logging, 75.2.6.1.3

optimization, 11.13

setter parameter type checking, 7.7, 7.7.1

single-object finder return type checking, 7.7, 7.7.3

software requirements, 7.2.1

target platforms, 2.2.2

unknown primary key class support, 7.7, 7.7.2

architectures

application, 1.4

BMP, 1.4, 2.14

cache, 90.1

choosing, 2.2

CMP, 1.4, 2.13

EIS, 2.2.1.4, 2.2.1.5, 56.2.7

EJB entity beans, 1.4, 1.4, 2.13, 2.14

EJB session bean facade, 1.4, 2.12, 2.12

locking, 2.3.5, 2.3.5.1, 2.3.5.2

optimistic locking, 2.3.5.1

Oracle TopLink, 1.1

pessimistic locking, 2.3.5.2

selecting, 2.3

session brokers, 75.7.1

sessions, 75.2.1

three-tier, 1.4, 2.10, 2.10

two-tier, 1.4, 2.11, 2.11

unit of work, 100.1

web services, 1.4, 2.15

arguments, binding in query, 29.4

array

dimensionality, 5.7.2.6.1, 5.7.2.10.1

object-relational mappings, 49.4

AsOfClause, 99.2

asynchronous change propagation, 91.2

AttributeChangeTrackingPolicy

about, 100.2.3.3

OC4J CMP integration, 100.2.3.3.1

OC4J EJB 1.x CMP integration, 100.2.3.3.1

OC4J EJB 2.x CMP integration, 100.2.3.3.1

OC4J EJB 3.0 CMP integration, 100.2.3.3.1

other application servers, 100.2.3.3.2

attributes

adding to descriptors, 5.7.2.5

array dimensionality, 5.7.2.6.1, 5.7.2.10.1

changes, tracking, 28.29.1.3

final, 5.7.2.5.1, 5.7.2.9.1

in TopLink Workbench, Navigator window, 5.3.3

lazy loading. see fetch groups

static, 5.7.2.5.1, 5.7.2.9.1

transforming, 35.15, 35.15, 35.16, 35.16, 36.13

transient, 5.7.2.5.1, 5.7.2.9.1

unmapping, 34.5.1

volatile, 5.7.2.5.1, 5.7.2.9.1

Attributes tab, 5.7.2.4.1, 5.7.2.5.1, 5.7.2.8.1

Attunity Connect platform, 84.1.3.1

auditing

authentication, 84.1.4.3

unit of work, 102.12

authentication

about, 84.1.4

auditing, 84.1.4.3

proxy authentication, 84.1.4.2

simple JDBC authentication, 84.1.4.1

three-tier architecture, 84.1.4.2

two-tier architecture, 84.1.4.1

Automap, 34.3.1

automapping descriptors

about, 34.3

see also mappings

automatic table generation

about, 33.2.3.2

configuring, 8.7.1.3

---

B

Base64 encoded strings, 35.12.2

batch options

mappings, 37.4.1

writing, 11.10.3

batch reading

in query objects, 98.2.1.9

read optimization, and, 11.11.7

batch writing

about, 11.10.3, 11.11.8, 86.6.2

dynamic, 11.10.3

dynamic, setMaxBatchWritingSize(), 11.10.3

MySQL4 platform, 86.6

non-parameterized, 11.10.3

parameterized, 11.10.3

setMaxBatchWritingSize(), 11.10.3

BEA WebLogic

deploying to, 10.4.2

deployment exceptions, 15.3

modifying persistence descriptor, 8.8.1

setting classpath, 7.4.1, 7.4.2

setting shared library, 7.4.1, 7.4.2

transport layer, 75.9.1.2

using a security manager, 7.4.5

beans

session beans, 2.12.3

stateful beans, 2.12.3

stateless beans, 2.12.3

bidirectional relationships

about, 36.2.1

generating, 5.5.3.2

in one-to-one mappings, 35.18

target keys, 36.5

with indirection, 35.18

bindAllParameters() method, 23.6

bindings

arguments, 29.4

input paramters, 98.4.1.1

JAXB, 20.5.1

see parameter binding

BMP

and EJB 1.1, 2.14

and EJB 2.0, 2.14

and TopLink, 2.14

deployment files, 8.6

descriptors, 26.2.3, 28.17

packaging for deployment, 9.5

boolean logic in expressions, 97.2.1

branch classes, 26.7, 26.7

buttons. see toolbars

Byte array Base64, 35.12.2

---

C

cache

about, 2.4.3.3, 2.8.8, 90

architecture, 90.1

configuring, 90.2.3, 99.11.1

coordination, 90.2.6, 91, 92, 93

descriptor level, 28.12

disabling during read query, 96.15.4

distributed, 90.2.6

expiration, 22.14, 28.15, 99.11.2

expression limitations, 96.15.2.2

identity maps, using, 75.8

in-memory queries, 96.15.2.1, 96.15.2.2

internal query object cache, 96.15.6, 96.15.7, 96.15.7.1, 99.11.1, 99.11.2

invalidation, 22.14, 28.15, 90.2.3.4, 90.2.5

isolated client sessions, 75.5.2

isolation, 90.2.3, 90.2.7

object cache, 96.15.7

object cascading refresh, 96.15.5.2

object refresh, 96.15.5.1

optimizing, 11.9

project level, 22.11

queries, 90.2.2, 96.15

query cache, 96.15.7

readObject method, and, 98.1.1.1

refreshing, 28.9, 90.2.4.1, 96.15.5.3

restrictions, 96.15.7.1

service channel, 91.3

sessions, 75.2.1.1, 75.10, 90.1.1

stale data, 90.2.3

storing query results, 96.15.6, 96.15.6, 99.11.1

type and size, 22.11, 28.12

unit of work cache, 90.1.2

cache coordination

about, 90.2.6

application server clustering, and, 7.2.5

avoiding stale data, 90.2.3.5

CMP projects, 8.7.1.2

EJB Entity Beans with BMP architecture, and, 2.14.3.3

explicit query refreshes, 90.2.4

JMS, 92

orion-ejb-jar.xml, 8.7.1.2

packet time-to-live, 91.12

permissions, 7.6.1.3

RMI, 93

cache invalidation, avoiding stale data, 90.2.3.4

cache synchronization. see cache coordination

cacheAllStatements(), 23.6

cacheQueryResults(), 28.7.1.10

cache-synchronization property, 8.7.1.2

Caching tab, 28.12.1, 28.13.1, 28.14.1, 28.16.1

call

call queries, 96.9

EIS, 98.6

EJBQLCall, 98.5

SQLCall, 98.4, 98.4.1

StoredFunctionCall, 98.4.3

StoredProcedureCall, 98.4.2

Call finders

creating, 99.9.2.1

executing, 99.9.2.2

using, 99.9.2

Call object, queries, 96.2.1

cascading

object refresh, 96.15.5.2

optimistic version locking, 26.8.2

write queries, compared to non-cascading, 96.7.3.7, 98.2.2.3

catalog, database, 5.5.1.2

catchExcpetions(), 77.11

change policy

about, 28.29

attribute change tracking, configuring, 28.29.1.3

deferred change detection, configuring, 28.29.1.1

empty transaction, 100.2.3

object change tracking, configuring, 28.29.1.2

unit of work, 100.2.3

change tracking

attribute, configuring, 28.29.1.3

deferred, configuring, 28.29.1.1

object, configuring, 28.29.1.2

changed items, displaying in TopLink Workbench Navigator window, 5.3.3

ChangedFieldsLockingPolicy, 26.8.4

changing package names, 5.7.5

checkDatabase(), 77.11

checking in/out projects, 4.2.1

checkInstantiationPolicy(), 77.11

Choose a Schema Context dialog box, 31.2.1.1, 32.2.1.1

Choose Query Key dialog box, 97.7.1.1

Choose Relationships to Generate dialog box, 5.5.3.2, 5.5.3.2

Choose Root Element dialog box, 31.3.1.1, 32.4.1.1

class extraction method

about, 26.7.1.2

inheritance, 26.7.1.2

class indicator

about, 26.7.1

class extraction method, 26.7.1.2

class indicator field, 26.7.1.1, 41.2

class loader

host application, 2.2.2

loading session, 78.3.2

class modifiers, 5.7.2.2

Class tab, 5.7.2.1.1, 5.7.2.2.1, 5.7.2.3.1

classes

access modifiers, 5.7.2.2

adding and refreshing, 5.7.3.1

branch, 26.7

creating, 5.7.1.1, 5.7.5.1

CursoredStream, optimizing, 99.10.5

Database Exception, 98.7

DatabaseMapping, 33.3

default null values, 35.19

DeleteObjectQuery, 98.2.2.1

ExpressionBuilder, 97.7.2

generating from database, 5.5.3.2

InsertObjectQuery, 98.2.2.1, 98.2.2.1, 100.3.1.1.2

interfaces, 5.7.2.3

leaf, 26.7

merging files, 4.2.2.2

methods, adding, 5.7.2.8

naming, 5.7.2.1.1

non-descriptor classes, 5.7.4

object model, 2.8.1

Performance Profiler, 11.3.1

persistent requirements, 2.4.2

preferences, 5.4.4

refreshing, 5.7.3.1

removing, 5.7.3.1

root, 26.7

troubleshooting, 14.8

tutorial, 16.2.1.1

unit of work, 100.3.1.1.2

UpdateObjectQuery, 98.2.2.1, 98.2.2.1, 98.2.2.3

ValueHolderInterface, 2.4.2, 33.2.4.1, 36.8

VariableOneToOneMapping, 36.6, 36.6

see also specific class name

classpath

adding, 22.3.1

BEA WebLogic, 7.4.1

configuring, 5.2, 7.4.1, 7.5.1.1

connector.jar, 5.2

custom Collection class, 5.2

DRIVER_CLASSPATH, Oracle TopLink Workbench, 5.2

IBM WebSphere, 7.5.1.1

J2C adapter, 5.2

JDBC driver, 5.2, 5.5.1.3

JDBC_CLASSPATH, 5.2

Oracle TopLink Workbench DRIVER_CLASSPATH, 5.2

relative, 22.3.1

setting for BEA WebLogic, 7.4.2

troubleshooting, 14.8

xdb.jar file, 5.2

class-table relationships, 16.2.2

client sessions

about, 75.1, 75.3, 75.7

acquiring, 78.4

configuration, 82.1

example, 75.3.2.2

shared resources, 75.3.2.1

client-controlled transactions, 102.14.1

client-server architecture. See two-tier

clones

copying methods, 28.28

merging changes, 102.5

post-commit, avoiding, 102.16.1

unit of work, 100.1.1, 100.2.4

Cloudscape platform, 84.1.3.1

clustering, integrating TopLink with, 7.2.5

CMP

and EJB 1.1, 2.13

and EJB 2.x, 2.13

and EJB 3.0, 2.13

and TopLink, 2.13

CMPPolicy, 26.2.3, 28.17

deploying, 8.5, 10.4

descriptors, inheritance, 26.2.3.3

external transactions, 100.1.2.3

isolated client sessions, 75.5.2

local transaction, 102.14.1, 102.14.2

non-deferred write, 102.14.3

OC4J persistence, 7.3.2

packaging for deployment, 9.4

setter parameter type checking, 7.7.1

single-object finder return type checking, 7.7.3

transaction attribute, 102.14.1

unit of work, 100.1.2.3, 102.14

unknown primary key class support, 7.7.2

code generation, optimizing, 11.5

collapsing items in Navigator window, 5.3.3

collection class

specifying, 98.2.1.6

specifying in query objects, 98.2.1.6

collections

persistent requirements for mappings, 2.4.2

query results, 96.5.1

comments

descriptors, 28.5.1, 28.6, 28.6.1

mappings, 35.8

projects, 22.15

commit

and Java Transaction API, 100.2.6.1, 100.2.6.1.1

failure, resuming after, 102.6

resuming unit of work after, 102.6

Communication Exceptions, 13.11

composite collection EIS mappings

configuring, 61

example, 56.6

understanding, 56.6

composite collection XML mappings

configuration, 70.1

configuring, 70

understanding, 65.6

composite descriptors

about, 26.2.6

composite object mapping, 26.2.6.2, 26.2.6.3

EIS projects, 26.2.6.2

XML projects, 26.2.6.3

composite direct collection EIS mappings

configuring, 59

understanding, 56.4

composite direct collection XML mappings

configuring, 68

understanding, 65.4

composite EIS descriptors, 27.4.1.2

composite object EIS mappings

composite descriptors, and, 26.2.6.2

configuring, 60

understanding, 56.5

composite object mappings

composite descriptors, and, 26.2.6.3

composite object XML mappings

configuration, 69.1

configuring, 69

understanding, 65.5

composite primary key, 36.8

concrete class. see container policy

concurrency

about, 2.8.7

exceptions, 13.2

server session, 75.3.2.5

Concurrency Exceptions, 13.2, 13.2

configurations

about, 76.2

creating, 76.2.1

development environment, 4.1

new, 76.2.1

Oracle JDeveloper, 4.1

session, 76.2.1, 76.3.1, 76.4.1, 76.5.1, 76.6.1

conforming

about, 102.4

alternatives, UnitOfWork method writeChanges, 102.4.4.1

alternatives, UnitOfWork properties, 102.4.4.2

descriptors, and, 102.4.3

in-memory queries, 102.4.1.2

queries, alternatives to, 102.4.4

ConnectBy, 99.8.2.2

connection policy

configuring, 77.12

exclusive connections, 77.12

lazy connection acquisition, 77.12

connection pool

about, 84.1.6, 84.1.6

connection count, 89.2

ConnectionPolicy, 75.5

external, 84.1.6.2

internal, 84.1.6.1, 84.1.6.3, 84.1.6.3, 84.1.6.4, 84.1.6.5

lazy connection allocation, 75.3.2.6, 78.4.6

named, 84.1.6.5, 84.1.6.5

parameter binding, 11.10.4

prepared statement caching, 11.10.4

read, 84.1.6.3

sequence, 20.2.6, 84.1.6.4, 84.1.6.4

server session, 75.3.2.6

sessions, and, 75.2.1.2

size, 89.2

write, 84.1.6.3

Connection Specifications tab, 24.3.1

Connection tab, 24.3.1

connections

about, 84.1.5

connection pool, 84.1.6

exclusive write connection, 77.12

lazy acquisition, 77.12

reading through the write connection, 102.15.1.4

connector.jar, 5.2, 20.4

container configuration file, 8.1.4

container policy

about, 35.14

custom Collection class, 5.2

sorting, in memory, 35.14

container-controlled transactions, 102.14.1

context

JAXB path, 20.5.1.3.2

menus, 5.3.1.2

schema, 31.2, 32.2

Context.SECURITY_CREDENTIALS, 91.7.1

Context.SECURITY_PRINCIPAL, 91.7.1

Conversion Exception, 13.3

Converter tab

object type mappings, 35.11, 35.11.1

converters

custom, 36.2.2.2

object type, 35.11, 35.11.1

coordinated announcement delay, 91.9

coordinated cache, 8.7.1.2

configuring, 91

naming service, 91.6

service channel, 91.3

copy policy

about, 28.28

method, 28.28

setting, 28.28.1

copying project objects, 4.2.3

Copying tab, 28.28.1

CORBA

Oracle TopLink transport layer support, 75.9.1.2

Transaction Service see OTS

Create New Project button, 21.1.1.1

Create New Project dialog box, 21.1.1.1

Create New Session dialog, 76.4.1, 76.5.1, 76.6.1

Create Project from JAXB dialog, 21.5.1

Create Project from OC4J dialog, 7.3.2.2

creating

configurations, 76.2.1

expressions, 97.7.1

sessions, 76.4.1, 76.5.1, 76.6.1, 88.1.1

Crimson XML parser, 7.2.2.2

cursored streams

example, 99.10.4.1

optimizing, 99.10.5

remote sessions, 75.9.2.5

usage example, 75.9.2.5

cursors

as query results, 96.5.3

traversing scrollable, 99.10.3.1

custom SQL

Custom SQL tab, 29.4.1

unit of work, 102.9

customization

about, 12, 12.1

data types, 12.2

EIS, 12.1

mapping extensions, 12.2

overview, 2.6

XML, 12.1

---

D

data access

about, 84

authentication, 84.1.4

connection pool, 84.1.6

connections, 84.1.5

optimizing, 11.10, 11.10.2

platforms, 84.1.3

data level queries

example, 97.6.2

in expressions, 97.6

data source platform

about, 84.1.3

Attunity Connect database, 84.1.3.1

Cloudscape database, 84.1.3.1

databases, 84.1.3.1

DB2 database, 84.1.3.1

EIS, 84.1.3.2

HSQL database, 84.1.3.1

Informix database, 84.1.3.1

J2C adapter, 84.1.3.2

JDBC drivers, 84.1.3.1

Microsoft Access database, 84.1.3.1

MySQL4 database, 84.1.3.1

Oracle database, 84.1.3.1

Oracle8 database, 84.1.3.1

Oracle9 database, 84.1.3.1

PointBase database, 84.1.3.1

SQLAnyWhere database, 84.1.3.1

SQLServer database, 84.1.3.1

SybasePlatform database, 84.1.3.1

data sources

configuring, 85

nontransactional, 84.1.1

transactional, 84.1.1

troubleshooting, 14.9

Database Exceptions, 13.4, 98.7

database fields, configuring, 37.2

database functions, in expressions, 97.2.2

database login

parameter binding, 86.6

prepared statement caching, 86.6

Database Preferences, 5.4.6

database queries

about, 96.7, 98.2

fetch groups, 96.7.1.5

join reading, 96.7.1.4

object level modify query, 96.7.3, 96.7.4

object level read query, 96.7.1, 96.7.2

partial object query, 96.7.1.3

read all query, 96.7.1.2

read object query, 96.7.1.1

report query, 96.7.5

database schema

tables, 5.5.1.2

tutorial, 16.2.2

database sessions

about, 75.1, 75.8

cache, 75.10.1

configuration, 83.1

creating, 76.6

database tables

about, 5.5

adding to database, 5.5.1.2

creating, 5.5.1.2

descriptors and classes, generating, 5.5.3.2

EJB entity generation, 5.5.3.3

fields, 5.5.2.1

generating, 5.5.3.1, 5.5.3.2, 5.5.3.4

importing, 5.5.1.3

Java source generation, 21.9.4

JDBC driver classpath, 5.5.1.3

properties, 5.5.2

references, 5.5.2.3, 5.5.2.4

removing, 5.5.1.4

renaming, 5.5.1.5

schema, 5.5.1.2

SQL generation, 5.5.3.1

TopLink Workbench, Navigator window, 5.3.3

DatabaseException class, 98.7

DatabaseLogin, 84.1.2.1

DatabaseMapping class, 33.3, 33.3

DatabaseQuery, 96.2.2

DatabaseRow, 36.13

databases

catalog, 5.5.1.2

common problems, 14.9.1

connect to, 5.5.1.1

creating reference tables on, 5.5.2.3

custom drivers, 5.4.6

disconnect from, 5.5.1.1

drivers, 5.4.6

exceptions, 98.7

fields, configuring, 37.2

for project, 21.1.1.1

Java type conversion, 6.1.1

linking, 75.7.4.1

log out of, 5.5.1.1

logging into, 5.5.1.1, 23.5.1.1

logins, 86

mapping. See mappings

platform, 21.1.1.1, 23.2, 24.2, 86.2, 87.2

preferences, 5.4.6

schema, 5.5.1.2

schema manager, 6

tables, 5.5

TopLink Workbench, Navigator window, 5.3.3

troubleshooting, 14.9.1

type conversion, schema manager, 6.1.1

using with Oracle TopLink Workbench, 5.5

DatabaseSession class

logging SQL and messages, 75.2.6.4

DB2

platform, 84.1.3.1

schema manager type conversion, 6.1.1

DBase platform, 84.1.3.1

default mapping

about, 33.2.3.2

automatic table generation, and, 33.2.3.2, 33.2.3.2

configuring, 8.7.1.3

default table generator, 6.4

Default Mapping Exception, 13.19

default table generator

default mapping, 6.4

table creator, creating, 6.2.2

defaults

login level null values, 85.6

mapping level null values, 35.5

null values, 35.5, 35.19, 85.6

optimization, 11.5

root, 32.4

see also preferences

DefaultSequence, 86.4.2.1

deferred change detection

configuring, 28.29.1.1

DeferredChangeDetectionPolicy, 100.2.3.1

Delete All Interaction tab, 63.3

deleteObject(), 29.4.1

DeleteObjectQuery, 98.2.2.1

deletes

controlling order, 102.10

delete operation, 98.1.2.5

queries, EIS mappings, 63.3

demarcation of unit of work transactions, 100.1.2

dependent objects

non-deferred write, 26.2.3.1

deploy tool

about, 10.7, 10.7

troubleshooting, 10.7.2.1

using with WebSphere Studio Application Developer, 10.7.2

deploying

about, 2.5, 2.5.1, 10

application server requirements, 7

BEA WebLogic, 10.4.2

CMP applications, 10.4, 10.6.1

database login, 23.5.1

entity beans overview, 2.5.2

generating XML for, 8.1.1.4

hot deployment, 10.6, 10.6.1, 10.6.2

IBM WebSphere, 10.4.3

Java applications, 10.1

JSP and Servlet applications, 10.2

modifying BEA WebLogic persistence descriptor, 8.8.1

non-CMP applications, 10.6.2

packaging, 9

Session Bean applications, 10.3

troubleshooting, 15

deployment descriptors, 26.2.3

Deployment Exceptions, 13.13

deployment exceptions

BEA WebLogic deployment, 15.3

Deployment Exceptions (14001-14033), 13.13

IBM WebSphere deployment, 15.7

deployment files

BMP applications, 8.6

CMP applications, 8.5

creating, 8.1

descriptors, 26.2.3

EJB 3.0, 8.1, 9

JARs, troubleshooting, 15.1

Java applications, 8.2

JSP and Servlet applications, 8.3

Session Bean applications, 8.4

XML, generating, 8.1.1.4

deployment XML, exporting, 21.9.1

DeploymentXMLGenerator, 8.1.1.5

Descriptor Event Listener, 28.24

Descriptor Event Manager

about, 26.2.7

Descriptor Event Listener, 28.24, 28.24

domain object methods, 28.23

event types, 28.23

handlers, 26.2.7, 28.23, 28.24

handlers, Descriptor Event Listener, 28.24

understanding, 26.2.7

descriptor events

about, 26.2.7

Descriptor Event Listener, 28.24

domain object methods, 28.23

handlers, 26.2.7, 28.23, 28.24, 28.24

types of, 28.23

understanding, 26.2.7

Descriptor Exceptions, 13.1, 13.5

Descriptor Info tab, 28.2.1, 28.3.2, 28.4.1, 29.2.1, 29.3.1, 31.2.1, 31.3.1, 31.3.1, 32.2.1, 32.3.1, 32.3.1, 32.4.1, 32.4.1, 32.5.1

DescriptorEventListener, 28.24

descriptors

about, 19.1.2, 19.1.2, 26

advanced properties, default, 22.6

aggregate, 26.2.6, 27.2.1.2

aggregate, EJB 3.0 and, 26.2.6.1.1

aggregate, relational projects and, 26.2.6.1

amending, 2.9.2.1.1, 26.2.5, 28.33

API, 26.9

architecture, 26.2.1

attributes, adding, 5.7.2.5

automapping, 34.3

automatically mapping, 34.3

BMP, 26.2.3, 28.17

cache refreshing, 28.9

change policy, 28.29

child inheritance, 28.19

class, 27.2.1.1

CMP, 26.2.3, 28.17

CMPPolicy, 26.2.3, 28.17

comments, 28.5.1, 28.6, 28.6.1

composite, 26.2.6, 26.2.6.2, 26.2.6.3, 27.4.1.2

composite EIS, 27.4.1.2

configuring, 28, 28.1

conforming, 102.4

creating, 27, 27.2.1.1, 27.2.1.2, 27.4.1.1, 27.4.1.2

custom EIS interactions for basic persistence, 31.5

custom SQL queries for basic persistence, 29.4

deactivating, 5.3.3

default mappings, 33.2.3.2

default root, 31.3.1

deployment information, 26.2.3

Descriptor Event Listener, 28.24, 28.24

domain object methods, 28.23

EIS, 26.5, 27.4.1.1, 27.4.1.2, 31

EIS projects, 26.2.6.2

EJB, 26.2.3, 28.17

EJB information, 26.2.3, 26.2.3, 28.17

errors, 5.3.3, 5.3.5, 14.3

event handlers, 26.2.7, 28.23, 28.24, 28.24

events, 26.2.7, 26.2.7, 28.23

existence checking, 11.7, 28.16

fetch groups, 28.32

files, merging, 4.2.2.2

generating from database, 5.5.3.2

hierarchy, inheritance, 26.9.1

history policy, 28.30

identity maps, 22.11, 28.12, 28.12, 28.13, 28.14

in Java, 26.9

inactive, 5.3.3

inheritance, 26.2.2, 26.7, 28.19, 28.20

instantiation, 11.7

interface, 27.2.1.3, 28.10, 28.11

mapping, 28.2.1, 29.2.1, 33.2.3.2, 34.2, 34.3

merging, 4.2.2.2

named queries, 28.7

nondescriptor classes, 5.7.4

object-relational, 26.4, 30

optimizing, 11.7, 11.7

parent inheritance, 28.20

projects, 19.1.2, 26.1

query key interfaces, 28.10

query timeout, 28.7.1.10, 28.8

read only, 28.3

registering with sessions, 75.2.10, 77.2, 77.2.2, 77.5.2

relational, 26.3, 27.2.1.1, 27.2.1.2, 27.2.1.3, 29

removing, 5.7.3.1

returning policy, 28.26

root EIS, 27.4.1.1, 27.4.1.1

root element, 32.4

schema context, 31.2, 32.2, 32.3

sequencing, 26.2.9, 29.3

TopLink Workbench, Navigator window, 5.3.3

types of, 26.1

validating, 27.6

XML, 26.6, 32

XML projects, 26.2.6.3

detachment indirection, 33.2.4.5.1

developing applications with Oracle TopLink, 2

development environments

about, 3.1

configuring, 4.1

database logins, 23.5.1

development process

about, 2.1

additional support, 2.1.2

stages of, 2.1.1

with Oracle TopLink, 2.1

development tools

about, 3

profiler, 11.3

schema manager, 6

dimensionality, array, 5.7.2.6.1, 5.7.2.10.1

direct access

about, 22.4, 35.6

specifying, 35.16.1

direct collection relational mappings

configuring, 45, 45.1

example, 36.10

understanding, 36.10

direct collections

session broker limitations, 75.7.3.1

direct EIS mappings

configuring, 58

understanding, 56.3

direct field

in direct collection mappings, 45.3

direct key fields, 46.3

direct map relational mappings

configuring, 46, 46.1

direct keys, 46.3

direct value, 46.2

understanding, 36.11

direct mappings

generating deprecated, 22.10

with EJB, 36.2.3

direct value fields, 46.2

direct XML mappings

configuring, 67

understanding, 65.3

directionality in mappings, 36.2.1

direct-to-field mappings

ObjectTypeMapping deprecated, 36.2.2.2

SerializedObjectMapping deprecated, 36.2.2.2

type conversions, 37.2

TypeConversionMapping deprecated, 36.2.2.2

direct-to-field relational mappings

configuring, 38

options, 38.1

timestamp support, 37.2

understanding, 36.3

direct-to-XMLType relational mappings

configuring, 39

understanding, 36.4

Discovery Exception, 13.20

DMS profiler

about, 11.4, 75.2.7.2

accessing with JMX, 11.4.2

and JMX

nouns, 11.4, 75.2.7.2

selecting, 77.6.1, 77.8.1, 77.10.1, 77.12.1

sensors, 11.4, 75.2.7.2

document information in XML schemas, 5.6.2, 5.6.4.1, 5.6.5.1

documentation

hosted, 5.4.2

See also Help

does exist write object, 11.11.8

dontOptimizeDataConversion(), 11.10.2

doPrivileged(), 7.2.3

DRIVER_CLASSPATH

Oracle TopLink Workbench environment, 5.2

drivers, custom database, 5.4.6

dynamic batch writing

about, 11.10.3

setMaxBatchWritingSize(), 11.10.3

dynamic fetch groups, querying with, 99.3.3

---

E

Editor window, about, 5.3, 5.3.4

EIS

about, 20.4

architecture, 2.2.1.4

call, 98.6

custom interactions for basic persistence, per descriptor, 31.5

indexed records, configuring, 31.4

interactions, 31.5, 96.2.8.4, 98.6

mapped records, configuring, 31.4

mappings, 20.4, 56.2

projects, 21.1.1.1

queries, 96.2.8.4

record format, configuring, 31.4

XML records, configuring, 31.4

EIS descriptors

composite, 27.4.1.2

configuring, 31

default root, 31.3.1

locking policy, 28.25

root descriptor, 27.4.1.1

schema context, 31.2

setDataTypeName, 31.3.2

understanding, 26.5

EIS mappings

about, 56, 56.2

architecture, 56.2.7

composite collection, 56.6, 61

composite direct collection, 56.4, 59

composite object, 56.5, 60

configuring, 57

direct, 56.3, 58

jaxb:class support, 56.2.4

list support, 56.2.3

one-to-many, 56.8, 63

one-to-many, key on source, 56.8.1

one-to-many, key on target, 56.8.2

one-to-one, 56.7, 62

one-to-one, key on source, 56.7.1

one-to-one, key on target, 56.7.2

transformation, 56.9, 64

types of, 56.1

union support, 56.2.3

xsd:list, 56.2.3

xsd:union, 56.2.3

EIS projects

configuring, 24

connector.jar, 20.4

indexed records, 20.4.2

mapped records, 20.4.2

sequencing, 20.2.6

understanding, 20.4

XML records, 20.4.1

EIS queries, 96.2.8.4

EIS record types, supported, 56.2.1

EISLogin, 84.1.2.1

EJB

descriptors, 21.8.1

isolated client sessions, 75.5.2

setter parameter type checking, 7.7

single-object finder return type checking, 7.7

unknown primary key class support, 7.7

EJB 1.1

and BMP, 2.14

and CMP, 2.13

EJB 1.x

indirection, 33.2.4.5.2

serialization, 33.2.4.5.2

EJB 2.x

and BMP, 2.14

and CMP, 2.13

default mapping, 33.2.3.2

indirection, 33.2.4.5.2

serialization, 33.2.4.5.2

EJB 3.0

<J2EE-Container>-jar.xml file, 8.1.4.3

and CMP, 2.13

attribute change tracking policy, OC4J CMP integration, 7.3.1, 100.2.3.3.1

Bean annotation, fetch=lazy, 33.2.4.4.1

default mapping, 33.2.3.2

deployment files, 8.1, 9

deployment files, OC4J CMP integration, 7.3.1

detachment, 33.2.4.5.1

Embedded annotation, 26.2.6.1.1

packaging for deployment, 9

packaging, OC4J CMP integration, 7.3.1

projects.xml file, 8.1.1.6, 8.1.3.1

serialization, 33.2.4.5.1

sessions.xml file, 8.1.2.4

toplink-ejb.xml file, 8.1.5.4

value holder indirection, 33.2.4.4.1

EJB descriptors, opening projects with, 21.8.1

EJB entities

BMP indirection, 33.2.4.4.3

CMP hot deployment, 10.6.1

deployment overview, 2.5.2

EJB 1.x indirection, 33.2.4.4.3

EJB 2.x indirection, 33.2.4.4.2

EJB 3.0 indirection, 33.2.4.4.1

generating, 5.5.3.3

hot deployment, 10.6, 10.6.1, 10.6.2

indirection, 33.2.4.4.3

inheritance, 26.2.3.3, 26.7.5

inserting after ejbCreate, 26.2.3.2

inserting after ejbPostCreate, 26.2.3.2

mapping, 22.5

non-CMP hot deployment, 10.6.2

non-deferred write, understanding, 26.2.3.1, 102.14.3

sequencing, 20.7.4

EJB entity beans

and EJB 1.1, 2.13, 2.14

and EJB 2.x, 2.13, 2.14

and EJB 3.0, 2.13

with BMP architecture, 1.4, 1.4, 2.14

with CMP architecture, 1.4, 1.4, 2.13

EJB Exception Factory Exceptions, 13.10

EJB finders

about, 96.14

Call finders, 96.14.3, 99.9.2

creating, 99.9.1

DatabaseQuery finders, about, 96.14.4

default finders, about, 96.14.2

default finders, creating, 99.9.1

EJB QL finders, about, 96.14.8

ejb-jar.xml options, 99.9.1.1

ejbSelect method, 96.14.11

ejbSelect, creating, 99.9.10

ejbSelect, using, 99.9.10

expression finders, about, 96.14.7

named query finders, about, 96.14.5

predefined, about, 96.14.1

primary key finders, about, 96.14.6

redirect finders, about, 96.14.10

redirect finders, using, 99.9.9

single-object finder return type checking, 7.7

SQL finders, about, 96.14.9

EJB Info tab, 28.17.1

EJB JAR XML Exception, 13.25

EJB QL

exceptions, 13.8

queries, 29.4, 96.2.8.2

query language, 96.2.8.2

EJB session bean facade architecture

about, 1.4, 1.4, 2.12

understanding, 2.12

EJB Session Beans, 75.9.1.2

ejbc

about, 10.4.2

troubleshooting, 10.4.2.1

ejbCreate, 26.2.3.2

ejb-jar.xml file

about, 8.1.3, 21.10

configuring, 8.1.4

corresponding to Oracle TopLink Workbench functions, 21.10

EJB finder options, 99.9.1.1

location, 22.5.1

managing, 4.2.4

preferences, 5.4.5

synchronization under EJB 2.0, 8.1.3

updating from, 21.10.2

writing, 21.10.1

ejbPostCreate, 26.2.3.2

@Embeddable, 26.2.6.1.1

@Embedded, 26.2.6.1.1

empty unit of work transactions, 100.2.3

encrypting login passwords, 21.9

enhanced validation exceptions, 8.1.2.1

Enterprise Information Systems. see EIS

entity beans

deployment, 2.5.2

descriptor information, 26.2.3

direct mappings, 36.2.3

indirection, BMP, 33.2.4.4.3

indirection, EJB 1.x, 33.2.4.4.3

indirection, EJB 2.x, 33.2.4.4.2

indirection, EJB 3.0, 33.2.4.4.1

sequencing with, 20.7.4

environment

configuring, 5.2

JAVA_HOME, 5.2

JDBC_CLASSPATH, 5.2

proxy, 5.4.1, 5.4.2, 21.10.2

error codes

1-176, 13.1

1-176, 13.1, 14.1, 14.2, 14.4, 14.5, 14.6, 14.7

200-399, 14.3

10001-10047, 13.10

12000-12004, 13.11

13000-13020, 13.12

14001-14027, 13.13

15001-15024, 13.14

17001-17006, 13.15

18001-18002, 13.17

19001-19003, 13.18

22001-22004, 13.20

22101-22105, 13.21

3001-3007, 13.3

4002-4018, 13.4

5001-5008, 13.5

6001-6098, 13.6

7001-7104, 13.7

72000-72023, 13.25

8001-8010, 13.8

9000-9009, 13.9

errors

about, 13

codes and descriptions, 13, 14.1

descriptors, 5.3.3, 5.3.5

migration, 7.3.2.5

Oracle TopLink Workbench, 14

Event Manager, 75.2.5

events

about, 26.2.7, 26.2.7

client session, 75.2.5.1

database access, 75.2.5.1

Descriptor Event Listener, 28.24

domain object methods, 28.23

handlers, 26.2.7, 28.23, 28.24

listeners, sessions, 75.2.5.2

session, 75.2.5

session manager, 75.2.5.1

sever session, 75.2.5.1

types of, 28.23

unit of work, 75.2.5.1

examples

composite collection EIS mapping, 56.6

context menu, 5.3.1.2

cursored streams, 99.10.4.1

direct collection mappings, 36.10

direct-to-field mappings, 36.3

exception handler, 77.7.2

indirection, 33.2.4

inheritance, 26.7

Oracle TopLink Workbench, 5.3

performance optimization, 11.11.7.2, 11.11.7.4

proxy indirection in code, 35.3.2.5

READALL finders, 99.9.2.1, 99.9.2.2, 99.9.2.2, 99.9.3, 99.9.6

report query, 98.2.1.3

scrollable cursors, 99.10.3.1

serialized mapping, 33.2.6.1

stored procedure call, 98.4.2.1, 98.4.2.2, 98.4.2.3

transformation mapping, 36.13

transformation XML mapping, 56.9, 65.9

Unit of Work, 100.2.2, 101.6

write, write all, 98.1.2.1

exception handler

about, 75.2.9

example, 77.7.2

selecting, 77.7.1

exceptions

chained, 75.2.6.5

communication exceptions, 13.11

conversion exceptions, 13.3

database exceptions, 13.4, 98.7

Default mapping exception, 13.19

deployment exceptions, 13.13

descriptor exceptions, 13.1, 13.1

discovery exceptions, 13.20

EJB exceptions factory, 13.10

EJB JAR XML exceptions, 13.25

EJB QL exceptions, 13.8

enhanced validation, 8.1.2.1

java.security.AccessControlException, 15.7, 15.7

JMS processing exceptions, 13.17

Migration utility exception, 13.24

optimistic locking, 13.5

query exceptions, 13.6

remote command manager exceptions, 13.21

SDK data store exceptions, 13.15

SDK descriptor exceptions, 13.18

selecting exception handler, 77.7.1

session loader exceptions, 13.9

synchronization exceptions, 13.14

Transaction exception, 13.22

validation exceptions, 13.7

XML conversion exception, 13.23

XML data store exceptions, 13.12

exclusive connections

about, 102.15.1.4.3

internal read connection pool, 89.6

isolated sessions, 75.5, 77.12

named queries, 28.7.1.10

existence checking, 102.1.4

descriptors, 28.16

projects, 22.7

expanding items in Navigator window, 5.3.3

expiration of objects in the cache, 22.14, 28.15

explicit query refreshes, cache coordination, 90.2.4

exporting

deployment XML, 21.9.1

Java model, 21.9.2

Java source, 21.9.3

preferences, 5.4

projects, 21.9

Expression Builder, 97.7.1, 97.7.2

Expression Builder dialog box, 97.7.1

Expression class, 97.1

ExpressionMath class, 97.1

expressions

about, 96.2.6, 97, 97.1

allows none, 28.7.1.6.1, 97.7.1.1

allows null, 28.7.1.6.1, 97.7.1.1

building, 97.7.1

comparing with SQL, 97.1.1

components, 97.2, 97.2

creating, 97.7

data level queries, 97.6

database functions, 97.2.2

in relationships, 97.2.7

in-memory queries, limitations, 96.15.2.2

mathematical functions, 97.2.3

multiple, 97.5

one-to-one mappings, 97.2.6

outer joins, 98.2.1.10

parallel expressions, 97.5.2

parameterized, 97.3

platform functions, 97.8

query keys, 97.4

subqueries and subselects, 97.5.1

user-defined functions, 97.2.5, 97.8

using Boolean logic, 97.2.1

XML Type functions, 97.2.4

see also queries

external

applications, 102.15.1.1

connection pools, 84.1.6.2

controller, transaction, 100.1

JDBC pools, 2.14.3.1

transactions, 100.1, 100.1

external transaction controller

configuration, sessions, 77.9

session, 100.1.2

---

F

factory name, JMS connection, 92.3

failure, resuming unit of work after commit, 102.6

features of Oracle TopLink, 1.3

fetch groups

about, 26.2.4, 28.32

configuring, 28.32, 99.3.1

default, 28.32, 99.3.1

disabling, 99.3.1

dynamic, 99.3.3

object level read query, 96.7.1.5

read optimization, and, 28.32

size, 11.11.5

static, 99.3.2

@Bean fetch=lazy, 33.2.4.4.1

field references, 37.6

Field uses XML Schema "type" attribute option, 33.2.6.4

fields in database tables, 5.5.2.1

Fields tab, 47.3.1

field-to-object attribute transformation, 35.15, 35.16

files

JAXB-specific, 20.5.1.1

TopLink-specific, 20.5.1.2

see also specific file name

final attributes, 5.7.2.5.1, 5.7.2.9.1

findAll, using, 96.14.4

finders

caching options, 96.15.8.1

disabling cache, 96.15.8.2

managing large result sets, 99.10.6

refreshing results, 96.15.8.3

see also EJB finders

flashback queries

about, 96.9.1.4.3

historical client sessions, 81.1.1

forceUpdateToVersionField(), 102.11

foreign keys

about, 2.8.5, 37.6

configuring in EIS mappings, 62.2

EIS mappings, 63.2

multiple tables, 29.7.1

one-to-many mappings, 36.7

one-to-one mappings, 35.18, 36.5

parameterized expressions, 97.3

references, 14.4, 14.6

target, 36.5, 37.6

troubleshooting, 14.4, 14.6

full identity map, 90.2.1.1

---

G

garbage collection, managing, 101.7.1

General Preferences dialog, 5.4.1

Generate Classes and Descriptors dialog, 5.5.3.2

Generate EJB Entity Classes and Descriptors dialog, 5.5.3.3

generating

access method, 5.5.3.2

deployment JARs, troubleshooting, 15.1

deprecated direct mappings, 22.10

see also exporting

getCatalogs(), 5.5.1.3

getField(), 97.6.1

getImportedKeys(), 5.5.1.3

getParameter, 97.3.1

getPrimaryKeys(), 5.5.1.3

getTable(), 97.6.2

getTables(), 5.5.1.3

getTableTypes(), 5.5.1.3

getValue(), 33.2.4.1

getValue() method, 33.2.4.1

---

H

hard cache weak identity map

about, 90.2.1.3

when to use, 90.2.1.6

help

about, 5.3.6

displaying, 5.3.6

Help button., 5.3.6

Help Preferences, 5.4.4

hierarchical queries

about, 96.9.1.4.2

described, 99.8.2

hints, Oracle Hints in queries, 96.9.1.4.1

historical client sessions

about, 75.1, 75.6

cache, 75.10.3

limitations of, 75.6.1

historical queries, 99.2

about, 96.11

see also AsOfClause

history policy, configuring, 28.30

holders, value, 33.2.4.1

host URL, JMS topic, 92.4

hosted

documentation, 5.4.2

XSD files, 8.1.1.1, 8.1.2.1

hot deployment

about, 10.6

CMP applications, 10.6.1

non-CMP applications, 10.6.2

HSQL platform, 84.1.3.1

---

I

IBM Informix Database native sequencing, 20.7.2.6

IBM WebSphere

deploy tool, 10.7

deploying to, 10.4.3

deployment exceptions, 15.7

setting classpath, 7.5.1.1

identity

about, 2.8.3, 90.2.1

cache, and, 90.2.1

using cache to preserve, 90.2.1

see also identity map

identity map cache

disabling during a write query, 98.2.2.4

refresh in read query, 96.15.5.3

identity maps

about, 28.12, 28.13, 28.14, 75.8

cascading refresh during read query, 96.15.5.3

descriptors, 22.11, 28.12

example, 96.15.5.3

full, 90.2.1.1

guidelines for choosing type, 90.2.1.5

hard cache weak identity map, 90.2.1.3, 90.2.1.6

isolated client sessions, 75.5.2

no identity map, 90.2.1.4

refreshing during read query, 96.15.5.3

soft cache weak identity map, 90.2.1.3, 90.2.1.6

soft cache weak identity map and read optimization, 11.11.7

specifying, 28.12, 28.13, 28.14

weak, 90.2.1.2

weak identity map and read optimization, 11.11.7

Identity tab. see Caching tab

impedance mismatch, solving, 1.2

Implementors tab, 28.11

Import Tables from Database dialog, 5.5.1.3

importing

classes, 5.4.4

preferences, 5.4

inactive descriptors

about, 5.3.3

mapping to, 37.3.1, 57.2.1

independent relationships, 35.7

indexed records, 56.2.1.1

indirection

about, 2.8.10, 33.2.4, 33.2.4

bidirectional relationships, 35.18

choosing the correct type, 35.3

configuring, 35.3

EJB, 33.2.4.4

EJB 1.x CMP, 33.2.4.4.3

EJB 2.x CMP, 33.2.4.4.2

EJB 3.0 CMP, 33.2.4.4.1

example, 33.2.4

many-to-many mappings, 36.8

nontransparent, 2.4.2

one-to-many mappings, 35.18

proxy indirection, 33.2.4.3

remote sessions, 75.9.2.4

serialization, 33.2.4.5

transparent, 2.4.2, 33.2.4.2

value holder, 33.2.4.1

ValueHolderInterface, 2.4.2

see also proxy indirection, transparent indirection

Informix platform, 84.1.3.1

inheritance

about, 2.8.6, 26.2.2, 26.7

aggregate classes, 26.7.4

aggregate collection mappings, 36.9.1

branch classes, 26.7, 26.7

child descriptors, 28.19

class extraction, 26.7.1.2, 26.7.1.2

class indicator, 26.7.1, 26.7.1.2

descriptors, 26.2.2, 26.7, 28.19, 28.20

finding subclasses, 26.7.1

instantiating subclasses, 26.7.1

isolated client sessions, 75.5.2

leaf classes, 26.7, 26.7, 99.5

primary keys, 26.7.2

queries, 96.12

querying on hierarchy, 99.5

relational parent, 28.20

root class, 26.7, 26.7, 28.19.1, 28.20.1

root class subclasses, finding in inheritance, 26.7.1

supporting with multiple tables, 26.7.3.2

supporting with one table, 26.7.3.1

transformed to relational model, 11.6.3

using with EJB, 26.2.3.3, 26.7.5

inheritance hierarchies

descriptors, 26.9.1

querying on, 99.5

Inheritance tab, 28.19.1, 28.20.1

inherited subclasses, mapping, 28.22

in-memory query

about, 90.2.2

check cache using exact primary key, 96.15.2.1

check cache using primary key, 96.15.2.1

check database if not in cache, 96.15.2.1

conform results in unit of work, 96.15.2.1

conforming, 102.4.1.2

expression limitations, 96.15.2.2

supported, 96.15.2.1

using, 96.15.2.1

inner join, 97.2.7.1

insert operation, 98.1.2.1, 98.1.2.3

insertObject(), 29.4.1

instantiation policy

about, 28.27

setting, 28.27.1

Instantiation tab, 28.27.1

integrity checker, 27.6

about, 75.2.8

configuring, 77.11

interactions

about, 98.6

creating, 31.5

interface alias

about, 29.5

creating, 29.5.1

Interface Alias tab, 29.5.1

interfaces

classes, implementing, 5.7.2.3

customizing, 5.4.1

descriptors, 27.2.1.3, 28.10, 28.11

queries, 96.12

query keys, 28.10

querying on, 99.4

internal connection pool

about, 84.1.6.1

named, 84.1.6.5

read, 84.1.6.3

sequence, 84.1.6.4

write, 84.1.6.3

internal query object cache

about, 96.15.7

configuring, 99.11.1, 99.11.2

expiration, 99.11.2

restrictions, 96.15.7.1

internal transactions, 100.1

invalidation of objects in the cache, 22.14, 28.15, 90.2.5

IP address for multicast group, 91.4

isolated client sessions

about, 75.1, 75.5, 80

configuration, 80.1

life cycle, 75.5.1.3

limitations of, 75.5.2

session event handlers, 75.5.1

with Oracle Virtual Private Database (VPD), 75.5.1

isolated session

cache, 75.10.2

ConnectionPolicy, 75.5

exclusive connections, 75.5

supported databases, 75.5

isolation

cache, 90.2.3

transaction levels, 100.1

unit of work transactions, 100.1.3

Iterator interface, 99.10.3

---

J

J2C adapters

about, 84.1.3.2

configuring for Oracle TopLink Workbench, 5.2

EISLogin, 84.1.2.1

selecting, 84.1.3.2

with EIS, 21.1.1.1

J2EE, 8.1.4

parameter binding, 11.10.4

prepared statement caching, 11.10.4

web applications, 1.4

Java

database tables, 21.9.4

exporting to, 21.9.3

integration with any datasource, 1.2

iterators, 99.10.3

object model, 2.4

Java applications

deploying, 10.1

deployment files, 8.2

packaging for deployment, 9.1

Java Cryptography Extension, 21.9

Java Management Extensions. see JMX

Java Naming and Directory Interface. See JNDI

Java Object Builder, 75.2.1.4

Java streams

described, 99.10.4

optimizing, 99.10.5

support for, 99.10.4.1

Java Transaction API

and unit of work commit, 100.2.6.1, 100.2.6.1.1

and unit of work rollback, 100.2.6.2.1

see also JTA

Java Transaction Service see JTA

JAVA_HOME, 5.2

java.security.AccessControlException, 15.7, 15.7

java.util.Collection interface, 35.14

java.util.Map interface, 35.14

java.util.Set interface, 35.14

javax.ejbEntityBean interface, 5.5.3.3

JAXB

creating projects from, 21.5.1

files, 20.5.1.1

generating project from the command line, 21.5.2

jaxb:class, and EIS mappings, 56.2.4

jaxb:class, and XML mappings, 65.2.6

proxy configuration, 21.5.2

tljaxb.cmd, 21.5.2

tljaxb.sh, 21.5.2

typesafe enumeration converter, 35.13

understanding, 20.5.1

validation, 20.5.2

XML projects, 20.5.1

JAXB typesafe enumeration converter

configuring, 35.13

understanding, 33.2.10

JAXBContext, 20.5.1.3.2

JCE. see Java Cryptography Extension

JConnect, 11.10.1

JDBC

adaptor for EIS, 56.2.7

database gateway for EIS, 56.2.7

driver classpath, 5.5.1.3

JConnect, 11.10.1

Sybase JConnect, 11.10.1

JDBC drivers

about, 84.1.3.1

configuring for Oracle TopLink Workbench, 5.2

fetch size, 11.10.1, 11.11.5

general properties, 11.10.1

selecting, 84.1.3.1

JDBC pools

external with EJB Entity Beans with BMP architecture, 2.14.3.1

JDBC_CLASSPATH, 5.2

JDeveloper. See Oracle JDeveloper

JITDG75002|Understanding data access, data access concepts, 84.1

JMS

connection factory name, 92.3

coordinated cache, 92

Processing Exceptions, 13.16, 13.17

topic host URL, 92.4

topic name, 92.2

JMX

about

and DMS profiler

DMS profiler, 11.4.2

JNDI naming service, 91.7

joining

about, 96.7.1.4

expressions, and, 97.2.7

mappings, and, 40.2

one-to-many, about, 98.2.1.10.2

one-to-many, when not to use, 97.2.7.3

one-to-one mappings, 40.2, 98.2.1.10.2

optimizing reads, 11.11.7

queries, and, 98.2.1.10, 98.2.1.10.2

QueryManager expressions, 99.6

read queries, 11.11.7, 98.2.1.10

JSP and Servlet applications

deploying, 10.2

deployment files, 8.3

packaging for deployment, 9.2

JTA

about, 100.1.2.1

and unit of work, 100.1.2.1

isolated client sessions, 75.5.2

unit of work, 100.1

JTA/JTS

using with EJB Entity Beans with BMP architecture, 2.14.3.2

just-in-time reading. see indirection

---

K

Key Converter tab, 46.4.1

key pairs

database table reference, 5.5.2.4

troubleshooting, 14.4, 14.6

keys

about, 2.8.3

foreign, 2.8.5, 35.18, 36.5

foreign, target, 36.5

inheritance, 26.7.2

multiple tables, 29.7.1

primary, 26.7.2, 29.7.1, 35.2, 36.6, 36.8, 41.3.1

read-only settings, 35.2

reference key field, 36.10, 36.11

variable class relationships, 36.6, 41.3.1

---

L

large result sets, managing in finders, 99.10.6

lazy attribute loading and read optimization, 28.32

lazy connection

acquisition, 77.12

allocation, 75.3.2.6, 78.4.6

lazy loading. see indirection

lazy reading. see indirection

leaf classes, 26.7, 26.7, 99.5

life cycle of unit of work, 100.2.2

local

documentation, 5.4.2

transactions, 102.14.2

locked files, 4.2.5

locking policy

AllFieldsLockingPolicy, 26.8.4

ChangedFieldsLockingPolicy, 26.8.4

configuring, 28.25

field locking, 26.8.4

optimistic, 26.2.10, 26.8.2, 26.8.4

optimistic version locking, 26.8.1

OptimisticLockException, 26.8.1, 26.8.4

pessimistic locking policy, 26.2.10, 26.8.5

SelectedFieldsLockingPolicy, 26.8.4

stale data, and, 90.2.3.1

three-tier architectures, optimistic locking and, 26.8.6.1

three-tier architectures, pessimistic locking and, 26.8.6.2

TimestampLockingPolicy, 26.8.1

understanding, 26.2.10, 26.8

version locking, 26.8.2

VersionLockingPolicy, 26.8.1

Locking tab, 28.25.1

log into database, 5.5.1.1

Log Out of Database, 5.5.1.1

log out of database, 5.5.1.1

logging

application server, 75.2.6.1.3

chained exceptions, 75.2.6.5

java.util.logging, 75.2.6.1.2

log level, 75.2.6.3

Oracle Enterprise Manager 10g, 75.2.6.6

output, 75.2.6.2

permissions, 7.6.1.5

sessions, 75.2.6, 77.4, 77.4.1

TopLink native logging, 75.2.6.1.1

types, 75.2.6.1

Logging tab, 77.4.1

login

CMP deployment, 20.2.4.2

database, 23.4.1, 23.5.1.1, 86

deployment, 20.2.4.2

development, 20.2.4.3, 20.2.4.3

platforms, and, 20.2.5

projects, and, 20.2.4, 74.3, 84.1.2

role in project, 20.2.4, 84.1.2

session, 20.2.4.1, 77.3

session role, non-CMP, 20.2.4.1

logMessages method, 75.2.6

look and feel, specifying, 5.4.1

---

M

Manage Non-Descriptor Classes dialog, 5.7.4

management, source control, 4.2.1

manager, session events, 75.2.5

many-to-many mappings

relation table, 36.8

relation tables, 43.2

session broker limitations, 75.7.3.1

many-to-many relational mappings

configuring, 43

EJB, 36.8.1

understanding, 36.8

mapped records, 56.2.1.2

mapping extensions

custom data types, 12.2

JAXB typesafe enumeration converter, 33.2.10, 35.13

object type converter, 33.2.6.3, 35.11

serialized object converter, 33.2.6.1, 35.9

simple type translator, 33.2.6.4, 35.12

transformation mappings, 33.2.6.5

type conversion converter, 33.2.6.2, 35.10

mappings

about, 2.8, 2.8.4, 19, 19.1.3, 19.1.3, 33, 33, 34.1

access types, 35.6.1

aggregate collection mappings and EJB, 36.9.2

anyType mapping, 66.3

as part of the application development process, 2.9.2.1

automatic, 34.3

batch options, 37.4.1

class hierarchy, 33.3

comments, 35.8

configuring, 34.2, 35, 35.1

database field, 37.2.1

default mapping, 33.2.3.2

deprecated, generating, 22.10

direct access, 11.7, 35.6, 35.6

directionality, 36.2.1

EIS mappings, 20.4, 33.7, 56, 56.1, 57

EJB 2.0 entities, 22.5

errors, 14.4

example, 33.2.2

extensions, about, 33.2.6

hierarchy, 33.3

inactive descriptors, 37.3.1, 57.2.1

indirection, 11.7, 33.2.4, 35.3

isolated client sessions, 75.5.2

manually configuring, 34.2

many-to-many, 36.8.1

many-to-many, with EJB, 36.8.1

method access, 35.6, 35.16.1

null values, 35.5, 35.19

object-relational, 49, 50

one-to-many object, with EJB, 36.7.1

one-to-one with EJB, 36.5.1

optimizing, 11.7, 11.7

OX mappings, 33.6

projects, and, 19.1.3

read only, 35.2, 35.2.1

relation tables, 43.2, 43.2

relational, 36, 37

removing, 34.5.1

to tables, 28.2.1, 29.2.1

TopLink Workbench, Navigator window, 5.3.3

types of, 33, 33.1

XML mappings, 65, 65.1, 66

mathematical functions, in TopLink expressions, 97.2.3

menu bar, 5.3.1.1

menus

about, 5.3, 5.3.1

context menus, 5.3.1.2

menu bar, 5.3.1.1

merging

changes in clones, 102.5

Oracle TopLink Workbench project files, 4.2.2

project files, 4.2.2.1

messages, error, 13, 14.1

metadata

about, 2.4.3.1, 2.9

advantages, 2.9.1

creating, 2.9.2, 2.9.3

mapping and configuration, 19

project metadata, 2.9.2

session metadata, 2.9.3

Metalink, 2.1.2

method access

about, 22.4, 35.6

setting, 35.16.1

methods

adding, 5.7.2.8

getValue(), 33.2.4.1

setValue(), 33.2.4.1

wrapper policy, 28.31.1

see also specific method name

Microsoft Access

platform, 84.1.3.1

schema manager type conversion, 6.1.1

Microsoft SQL Database native sequencing, 20.7.2.6

migrating

error messages, 7.3.2.5

OC4J persistence to TopLink, 7.3.2

Oracle TopLink Workbench projects, 21.8.1

troubleshooting, 7.3.2.5

Migration Utility Exception, 13.24

model source, exporting, 21.9.2

modifiers, class, 5.7.2.2

multicast group address, coordinated cache, 91.4

multicast port, coordinated cache, 91.5

multiple sessions, 75.7.4.2, 75.7.4.2, 78.1.2

multiple tables

about, 29.7

specifying for descriptors, 29.7.1

multiplicity in relationships, resolving, 7.3.2.5

multi-processing, 11.11.8.1.4

Multitable Info tab, 28.18.1, 29.7.1

mutable mappings, 35.17

.mwp file, 5.1, 21.1.1

MySQL4

batch writing, 86.6

platform, 84.1.3.1

primary key restrictions, 20.7

schema manager type conversion, 6.1.1, 6.1.1

---

N

named connection pools, 84.1.6.5

named queries

about, 28.7, 77.13, 96.8

configuring, 28.7, 77.13

descriptor level, 28.7

exclusive connections, 28.7.1.10

options, advanced, 28.7.1.10

parameter binding, 28.7.1.9

prepared statement caching, 28.7.1.9

redirect query, 96.8

session level, 77.13

using, 98.3

when not to use, 96.8

when to use, 96.8

namespaces

about, 20.2.7, 20.8

configuring, 5.6.5

naming service

coordinated cache, 91.6

JNDI, 91.7

RMI, 91.8

native sequencing

IBM Informix Database, 20.7.2.6

Microsoft SQL Database, 20.7.2.6

Microsoft SQL Server, 6.2.3.4

non-Oracle database, 20.7.2.6

Oracle Database, 20.7.2.5, 20.7.3

Oracle Database SEQUENCE object, 20.7.2.5.2

Sybase Database, 6.2.3.4, 20.7.2.6

Navigator window

about, 5.3, 5.3.3

attribute and mapping, 5.3.3

database, 5.3.3, 5.3.3

database tables in, 5.5

descriptor, 5.3.3

example, 5.3.3

package, 5.3.3

project, 5.3.3

unsaved or changed item, 5.3.3

NCHAR, 33.2.6.2

NCLOB, 33.2.6.2

neediness warnings. See troubleshooting

nested table object-relational mappings

configuring, 55

understanding, 49.6

nested unit of work, 100.2.5, 102.8.2

new projects, 21.1.1.1

New Reference dialog box, 5.5.2.3

New Session button, 76.4.1, 76.5.1, 76.6.1

New Sessions Configuration, 76.2.1

New Table dialog box, 5.5.1.2

newInstance method, 102.1.1

no identity map, 90.2.1.4

non-cascading write queries

compared to cascading, 96.7.3.7, 98.2.2.3

creating using dontCascadeParts () method, 96.7.3.7, 98.2.2.3

non-deferred write

configuring, 102.4.4.1

dependent objects, 26.2.3.1

understanding, 26.2.3.1, 102.3, 102.14.3

nonintrusive persistence, 2.8.9

nonpersistent projects, 20.2.3

nonrelational projects, 20.2.2

nontransactional data sources, 84.1.1

nontransparent indirection, 2.4.2

nouns

DMS profiler, 11.4, 75.2.7.2

null values

default, 35.5, 35.19, 85.6

in expressions, 97.7.1

login level, 85.6

mapping level, 35.5

NVARCHAR2, 33.2.6.2

---

O

object array object-relational mappings

configuring, 54

understanding, 49.5

object cache, 96.15.7

object cache, sessions, 75.2.1.1

object change tracking

configuring, 28.29.1.2

object identity, 75.8

about, 2.8.3, 90.2.1

cache, and, 90.2.1

using cache to preserve, 90.2.1

see also identity map

object indirection

read optimization, as, 11.11.7

object level modify query

about, 96.7.3, 96.7.4

object level read query

about, 96.7.1, 96.7.2

fetch groups, 96.7.1.5

join reading, 96.7.1.4

partial object query, 96.7.1.3

read all query, 96.7.1.2

read object query, 96.7.1.1

object model

about, 2.8.1

generating with tljaxb.cmd, 21.5.2

optimization, 11.6

Oracle TopLink requirements, 2.4

tutorial, 16.2.1.1

object type converter

about, 12.2, 33.2.6.3

configuring, 35.11

object type mappings

configuring, 35.11, 35.11.1

ObjectLevelChangeTrackingPolicy, 100.2.3.2

object-relational descriptors

configuring, 30

locking policy, 28.25

understanding, 26.4

object-relational mappings

about, 49

array, understanding, 49.4

configuring, 50

nested table, 49.6, 55

object array, 49.5, 54

overview, 2.8

reference, 49.3, 52, 53

structure, 49.2, 51

object-relational projects

about, 20.3.2

sequencing, 20.2.6

objects

cascading refresh in cache, 96.15.5.2

creating and registering, 102.1.1

query, 98.2.1.4

refreshing in cache, 96.15.5.1

registering and unregistering, 102.1

ObjectTypeMapping

see ObjectTypeConverter

OC4J. See Oracle Containers for J2EE

one-to-many EIS mappings

configuring, 63

key on source, 56.8.1

key on target, 56.8.2

understanding, 56.8

one-to-many relational mappings

configuring, 42

understanding, 36.7

one-to-one EIS mappings

configuring, 62

key on source, 56.7.1

key on target, 56.7.2

understanding, 56.7

one-to-one relational mappings

configuring, 40

expressions, 97.2.6

joining, 40.2

understanding, 36.5

with EJB, 36.5.1

online help, 5.4.2

Open Project button, 21.8.1

opening projects, 21.8.1

operators

boolean logic, 97.2.1

optimistic locking

about, 26.2.10

application architecture, 2.3.5.1

cascading locking policy, 26.8.2, 28.25.2.2

database exception, 98.7

exceptions, 13.5

field locking policy, about, 26.8.4

rollbacks, 26.8.3

version locking policy, 26.8.1, 26.8.2, 28.25.2.2

with forceUpdateToVersionField() method, 102.11

optimistic locking policy

field locking, about, 26.8.4

version locking, 26.8.1, 26.8.2, 28.25.2.2

OptimisticLockException, 26.8.1, 26.8.4

optimization

about, 11, 11.1

application bottlenecks, 11.2

application server, 11.13

batch reading, 11.11.3

batch writing, 11.10.3

CMP partial object queries, 11.11.4

code generation, 11.5

data access, 11.10, 11.10.2

data format, 11.10.2

database, 11.13

descriptors, 11.7, 11.7

DMS profiler, 11.4, 75.2.7.2

existence checking, 11.7

fetch groups, 11.11.4

fetch size, JDBC, 11.11.5

general, 11.5

inheritance, 26.7.3.2

instantiation, 11.7

JDBC driver, 11.10.1, 11.11.5

join reading, 11.11.3

mappings, 11.7, 11.7

named queries, 11.11.2

object model, 11.6

overview, 2.6

parameter binding, 11.10.4

partial object queries, 11.11.4

prepared statement caching, 11.10.4

profiler, 11.4, 75.2.7.2

optimization, 11.3

queries, 11.11

reading, 11.11.7

ReadQuery method setMaxRows, 11.11.5

schema, 11.6

setMaxRows, 11.11.5

understanding, 11.1

unit of work, 11.12

writing, 11.11.8

Oracle

development support, 2.1.2

remote session support, 75.9.1.2

Oracle Containers for J2EE

creating projects from, 7.3.2.2

migrating to TopLink, 7.3.2

Oracle Database

date and timestamp mappings, 37.2

native sequencing, 20.7.3

Oracle Database, 20.7.2.5.2

platform, 84.1.3.1

schema manager type conversion, 6.1.1

Oracle extensions

hierarchical queries, 99.8.2

Oracle Hints, 99.8.1

Oracle Hints, using with TopLink queries, 99.8.1

Oracle JDeveloper

configuring with Oracle TopLink, 4.1

TopLink sessions, 4.1.2

Oracle TopLink

about, 1, 1, 5.1

application architectures, 1.4

architectures, 1.1

deploy tool for IBM WebSphere, 10.7

development, 2, 2.1, 3

features, 1.3

integrating with application server, 7, 7.2.1

mapping types, 33.1

optimization, 11.1

packaging your application, 9

public source, 12.3

runtime components, 3.2

understanding, 1

Oracle TopLink Sessions Editor. see sessions

Oracle TopLink Workbench

about, 5, 5.1

Ant integration, 5.8

classpath, 5.2

creating projects, 21.1

development process, 5.1

DRIVER_CLASSPATH, 5.2

environment, 5.2

error messages, 14, 14.2

JDBC_CLASSPATH, 5.2

parts of, 5.3

preferences, 5.4

project, 5.1, 21.1.1

proxy, 5.4.1, 5.4.2, 21.10.2

sample, 5.3

table creator, creating, 6.2.1

upgrading projects, 21.8.1

Oracle Virtual Private Database (VPD)

isolated client sessions, 75.5.1

proxy authentication, 75.5.1.1, 84.1.4.2, 86.8

oracle.sql.TimeStamp, 37.2

order

query keys, 37.5

relational mappings, 37.5

OrderSibling, 99.8.2.3

orion-ejb-jar.xml file

about, 8.7

entity-deployment attribute pm-name, 8.7.1

modifying for Oracle TopLink, 8.7

persistence-manager attribute class-name, 8.7.1

persistence-manager attribute descriptor, 8.7.1

persistence-manager attribute name, 8.7.1

persistence-manager subentry forpm-properties

cache-synchronizations, 8.7.1.1

customization-class, 8.7.1.1

db-platform-class, 8.7.1.1

default-mapping, 8.7.1.1

project-class, 8.7.1.1

remote-relationships, 8.7.1.1

session-name, 8.7.1.1

OTN (Oracle Technology Network), 1.3, 2.1.2

OTS (Object Transaction Service)

about, 100.1.2.2

unit of work, 100.1.2.2

outer joins

in expressions, 98.2.1.10

inheritance, 28.18

output parameter event in stored procedures, 98.4.2.4

OX mappings

about, 33.6, 33.7

extensions, simple type translator, 33.2.6.4.1, 33.2.6.4.2

read conversions, 33.2.6.4.1

write conversions, 33.2.6.4.2

---

P

package names

generating, 5.5.3.2

renaming, 5.7.5

TopLink Workbench, Navigator window, 5.3.3

see also classes

packaging for deployment

about, 9

BMP applications, 9.5

CMP applications, 9.4

EJB 3.0, 9

Java applications, 9.1

JSP and Servlet applications, 9.2

Session Bean applications, 9.3

packet time-to-live cache coordination, 91.12

parallel

expressions, 97.5.2

unit of work, 100.2.5

parameter binding

about, 11.10.4

byte arrays, 11.10.4

configuring, 23.6, 28.7.1.9, 86.6, 98.2.7

database login level, 86.6

descriptor level, 28.7.1.9

external connection pools, 11.10.4

internal connection pools, 11.10.4

J2EE, 11.10.4

named queries, 28.7.1.9

optimizing, 11.10.4

project level, 23.6

queries, 98.2.7

streams, 11.10.4

strings, 11.10.4

trouble shooting, 11.10.4

parameterized batch writing

about, 11.10.3

setMaxBatchWritingSize(), 11.10.3

parameterized expressions

about, 97.3

example, 97.3.1

parameterized SQL

enabling on queries, 98.2.7

Oracle TopLink optimization features, 11.11.8

See also parameter binding

parser conflicts, XML, 7.2.2

partial object reading optimization, 11.11.7

passwords, encryption, 21.9

performance optimization

about, 11.1

application bottleneck, 11.2

examples, 11.11.7.1

JConnect method isClosed, 11.10.1

using Performance Profiler, 11.3

Performance Profiler

about, 11.3

class, 11.3.1

persistence

about, 2.8.9

BEA WebLogic deployment, 8.8.1

by reachability, 101.5

components of, 2.4.3

descriptor, 8.8

implementation options, 2.4.1

manager, 7.2.4

OC4J, 7.3.2

projects, 20.2.3

types, 22.5

using a persistence layer, 2.4.4

persistence manager

default, 7.2.4

migration, 7.2.4

restrictions, 7.2.4

persistent classes

requirements, 2.4, 2.4, 2.4.2, 2.4.2

types, 22.5.1

pessimistic locking

about, 26.2.10, 26.8.5

application architecture, 2.3.5.2

policy, 26.8.5

phantom reads, preventing, 102.15.5

platforms

Attunity Connect database, 84.1.3.1

Cloudscape database, 84.1.3.1

data source, 84.1.3

database, 21.1.1.1, 23.2, 24.2, 84.1.3.1, 86.2, 87.2

DB2 database, 84.1.3.1

EIS, 84.1.3.2

functions in expressions, 97.8

HSQL database, 84.1.3.1

Informix database, 84.1.3.1

J2C adapter, 84.1.3.2

JDBC drivers, 84.1.3.1

Microsoft Access database, 84.1.3.1

MySQL4 database, 84.1.3.1

Oracle database, 84.1.3.1

Oracle8 database, 84.1.3.1

Oracle9 database, 84.1.3.1

parser, XML, 7.2.2

PointBase database, 84.1.3.1

projects, and, 20.2.5

server, 77.9.1

session configuration, 77.9.1

SQLAnyWhere database, 84.1.3.1

SQLServer database, 84.1.3.1

SybasePlatform database, 84.1.3.1

XML parser, 7.2.2

see also target platforms

PointBase platform, 84.1.3.1

pop-up menus. see context menus

ports

multicast group, 91.5

permissions, 7.6.1.3, 7.6.1.4

post-commit clones, avoiding, 102.16.1

Potential EJB Descriptors dialog box, 21.8.1

pre-allocating sequence numbers, 20.7.3, 23.3.1, 86.4.1, 87.2.1

preferences

class import, 5.4.4

database, 5.4.6

EJB, 5.4.5

general, 5.4.1

help, 5.4.2

importing and exporting, 5.4

Oracle TopLink Workbench, 5.4

sessions, 5.4.7, 5.4.8

Preferences - Class dialog, 5.4.4

Preferences - EJB dialog, 5.4.5

Preferences - General dialog, 5.4.1

Preferences - Help dialog, 5.4.2

Preferences - Mappings dialog, 5.4.3

Preferences dialog, 5.4

prepared statement caching

about, 11.10.4

configuring, 23.6, 28.7.1.9, 86.6, 98.2.7, 98.2.7

database login level, 86.6

descriptor level, 28.7.1.9

external connection pools, 11.10.4

internal connection pools, 11.10.4

J2EE, 11.10.4

named queries, 28.7.1.9

optimizing, 11.10.4

project level, 23.6

queries, 98.2.7

query level, 98.2.7

preserving XML documents, 32.5

primary key

about, 2.8.3

composite, 36.8

inheritance, 26.7.2

multiple tables, 29.7.1

primkey in ejb-jar.xml file, 21.10

read-only settings, 35.2

restrictions, 20.7

setting, 5.5.2.2, 28.2.1, 29.2.1

unit of work, 100.2.7

unknown, 28.17.1

variable class relationships, 36.6, 41.3.1

private relationships, 35.7

Problems window

about, 5.3, 5.3.5

sample, 5.3.5

see also error messages

profiler

about, 77.6

development tool, 11.3

DMS, 11.4, 75.2.7.2

Oracle TopLink, 11.3, 11.3.1, 75.2.7.1

selecting, 77.6.1, 77.8.1, 77.10.1, 77.12.1

Project - Multiple Projects tab, 77.5.1

Project Status Report dialog box, 21.8.3

projects

about, 19.1.1, 20, 20.2, 21.1.1

architecture, 20.2.1

cache type and size, 22.11, 28.12

comments, 22.15

configuring, 22

copying objects, 4.2.3

creating, 7.3.2.2, 21, 21.1, 21.1.1.1, 21.1.2, 21.5.1

deployment login, and, 20.2.4.2

deployment overview, 2.5.2

descriptors, 19.1.2

development login, and, 20.2.4.3

direct access to mapped fields, 22.4

EIS, 20.4, 20.4, 20.4.1, 20.4.2, 20.4.2, 24

errors, 14.2

existence checking, 22.7

exporting, 21.9, 21.9.2

for sessions, 77.5

indexed records, 20.4.2

Java, 21.1.2

JAXB, 21.5.1

locked, 4.2.5

login, 20.2.4, 74.3, 84.1.2, 84.1.2

login, and, 20.2.4

mapped field access, default, 22.4

mapped records, 20.4.2

mapping projects, creating, 21.1.1.1

mappings, 19.1.3, 21.1.1.1

merging, 4.2.2, 4.2.2.1

metadata, 2.9.2

method access to mapped fields, 22.4

model, exporting, 21.9.2

.mwp file, 5.1

nondescriptor classes, 5.7.4

non-persistent, 20.2.3

nonrelational, 20.2.2

object-relational, types supported, 20.3.2

OC4J, creating from, 7.3.2.2

open, 21.8.1

Oracle TopLink Workbench, 21.1.1

packages, renaming, 5.7.5

persistence type, 20.2.3, 22.5.1

platforms, and, 20.2.5

prior TopLink versions, 21.8.1

recently opened, 21.8.1

relational, 20.2.2, 20.3, 20.3.1, 20.3.2, 23

renaming, 21.8.2.1

reopening, 21.8.1

saving, 21.8.2

sequencing, 20.2.6, 20.2.6, 20.2.6, 20.2.6, 20.2.6, 23.3, 86.4

session login, and, 20.2.4.1

sharing, 4.2.3

status report, 21.8.3, 21.8.3

team development, 4.2

TopLink Workbench, Navigator window, 5.3.3

types of, 20.1, 21.1.1, 26.1

updating from ejb-jar.xml, 21.10.2

upgrading from 2.x or 3.x, 21.8.1

writing ejb-jar.xml file, 21.10.1

XML, 20.5, 25

XML records, 20.4.1

projects.xml file

about, 8.1.1

EJB 3.0, 8.1.1.6, 8.1.3.1

schema, 8.1.1.1

XSD file, 8.1.1.1

propagation mode, cache, 91.2

proxies. see wrapper policy

proxy authentication

about, 84.1.4.2

applications, 84.1.4.2

Oracle Virtual Private Database, 75.5.1.1, 84.1.4.2, 86.8

session events, 75.2.5

use cases, 84.1.4.2

proxy indirection

about, 33.2.4.3

example, 35.3.2.5

restrictions, 33.2.4.3.1

proxy settings, preferences, 5.4.1

public source code, 12.3

---

Q

qualified names, database tables, 5.5.1.3, 5.5.1.3

queries

about, 96

application development process, 2.4.3.4, 74.5

building, 96.3

cache, 96.15

Call queries, 96.2.1, 96.9

cascading, 96.7.3.7, 98.2.2.3

concepts, 96.2

conforming, 102.4

database queries, 96.7, 98.2

DatabaseQuery, 96.2.2

descriptor query manager, 96.2.5

EIS interactions, 96.2.8.4

EJB finders, 96.14

EJB QL query language, 96.2.8.2

ejb-jar.xml file, 28.7, 29.4, 31.5

executing, 96.4

expressions, 96.2.6

fetch groups, 96.7.1.5

flashback queries, 81.1.1, 96.9.1.4.3

hierarchical queries, Oracle extensions, 96.9.1.4.2

hints, Oracle extensions, 96.9.1.4.1

historical, 96.11, 99.2

interface and inheritance queries, 96.12

joining, 96.7.1.4, 96.7.1.4

languages, about, 96.2.8

named queries, 96.8

object level modify query, 96.7.3, 96.7.4

object level read query, 96.7.1, 96.7.2

on inheritance hierarchies, 99.5

on interfaces, 99.4

optimizing, 11.11

Oracle database features, 99.8

Oracle extensions, 96.9.1.4, 96.9.1.4.1, 96.9.1.4.2, 96.9.1.4.3, 96.9.1.4.4

parameter binding, 98.2.7

partial object query, 96.7.1.3

performance, 11.11

prepared statement caching, 98.2.7

query keys, 96.2.7

read all query, 96.7.1.2

read object query, 96.7.1.1

redirect queries, 96.10

remote sessions, 75.9.2.2

report, 11.11.7.1.2, 96.5.2

report query, 96.7.5

results, 96.5

returning policy, 96.9.1

session queries, 96.6, 98.1

SQL query language, 96.2.8.1

stored functions, Oracle extensions, 96.9.1.4.4

subqueries, 97.5

summary queries, 96.2.4

timeout, 28.7.1.10, 28.8, 98.2.1.8

types, 96.1

UpdateAll, 96.7.3.5

XML query language, 96.2.8.3

Queries tab, 28.8.1, 28.9.1

query by example, 98.2.1.4

query cache, 96.15.7

Query Exception, 13.6, 13.6

query keys

about, 28.10, 28.11, 96.2.7

adding, 28.10.1, 28.11.1

and expressions, 97.4

creating, 28.10.1, 28.11.1

direct mappings, 28.10

generating, 28.10

in expressions, 97.4

interface descriptors, 28.10, 28.11

Java implementation, 28.10.2

modifying, 28.10

order, 37.5

relationship mappings, 28.10

specifying, 28.10.1, 28.11.1

unmapped attributes, 28.10, 28.10, 28.10

Query Keys tab, 28.10.1

query object query. See DatabaseQuery

query objects

batch reading, 98.2.1.9

cache expiration, 99.11.2

caching results, 96.15.6, 99.11.1

examples, 98.2.1.1, 98.2.1.1

ordering for ReadAll queries, 98.2.1.5

report query, 11.11.7.1.2

specifying collection class, 98.2.1.6

query results

about, 96.5

caching, 96.15.6

collections, 96.5.1

cursors, 96.5.3

reports, 96.5.2

streams, 96.5.3

query timeout example, 98.2.1.8

QueryManager

about, 26.2.8

joining expressions, 99.6

QuerySequence, 86.4.2.3

---

R

read access

providing in sessions, 75.3.2.2

read all operation, 98.1.1.2, 98.1.1.2

read conversions

simple type translator, 33.2.6.4.1

read only

descriptors, 28.3

files, 4.2.5

mappings, 35.2, 35.2.1

read operation, 98.1.1.1

read optimization

about, 11.11.7

batch reading, 11.11.7

fetch groups, 28.32

joining, 11.11.7

lazy attribute loading, 28.32

object indirection, 11.11.7

partial object reading, 11.11.7

report query, 11.11.7

soft cache weak identity map, 11.11.7

unit of work, 11.11.7

weak identity map, 11.11.7

read queries

cascading refresh of identity maps, 96.15.5.3

identity map cache refresh, 96.15.5.3

refreshing identity maps, 96.15.5.3

ReadAll finders

executing, 99.9.3

ReadAll queries

ordering in query objects, 98.2.1.5

readAllObjects()

about, 29.4.1

example, 98.1.1.2

reading

ejb-jar.xml, 21.10.2

just-in-time reading, 33.2.4.2

whole XML documents, 39.2

reading through the write connection, 102.15.1.4

read-locking, 26.2.10

readObject()

example, 98.1.1.1

recently opened projects, 21.8.1

redirect queries

about, 96.10, 99.1

creating, 99.1.1

finders, 99.9.9

using, 99.9.9

reference key field, 36.10, 36.11

reference object-relational mappings

configuring, 52, 53

understanding, 49.3

ReferenceMapping class, 49.3

references

database tables, 5.5.2.3, 5.5.2.4

foreign keys, 14.4, 14.6

Refresh from Database button, 5.5.1.6

refresh policy

cache, 90.2.4.1

EJB finders, 90.2.4.2

refreshing

cache, 28.9

classes, 5.7.3.1, 5.7.3.1

refreshObject(), 98.1.1.3

remote sessions, 75.9.2.3

sessions, 78.3.5

registering objects, 102.1

registerNewObject method, 102.1.2

reimporting schemas, 5.6.3

relation tables

about, 36.8

many-to-many mappings, 43.2

mappings, 43.2

relational descriptors

associated table, 29.2

configuring, 29

locking policy, 28.25

understanding, 26.3

relational mappings

about, 36

aggregate collection, 36.9, 44

aggregate object, 36.12, 47

configuring, 37

converters, 36.2.2

direct collection, 36.10, 45

direct map, 36.11, 46

direct-to-field, 36.3, 38

direct-to-XMLType, 36.4, 39

many-to-many, 36.8, 43

one-to-many, 36.7, 42

one-to-one, 36.5, 40

options, 37.1

order, 37.5

transformation, 36.2.2, 36.13, 48

variable one-to-one, 36.6, 41

relational projects

about, 20.2.2

configuring, 23

object-relational databases, 20.3.2

relational databases, 20.3.1

understanding, 20.3

relationships

about, 2.8.5

bidirectional, 5.5.3.2, 35.18, 36.5

expressions, 97.2.7

in ejb-jar.xml file, 21.10

unexpected multiplicity, 7.3.2.5

relative locations

about, 22.2

classpath, 22.3.1

Remote Command Manager Exception, 13.21

remote connection using RMI, example, 76.7.1

remote sessions

about, 75.1, 75.9

application layer, 75.9.1.1

creating, 76.7

limitations of, 75.9.2

securing access, 75.9.2.1

server layer, 75.9.1.3

transport layer, 75.9.1.2

unit of work, 75.9.2.6

Remove Class button, 5.7.3.1

Remove Table button, 5.5.1.4

removing sessions from brokers, 82.2

Rename dialog, 5.5.1.5

renaming

packages, 5.7.5, 5.7.5

projects, 21.8.1, 21.8.2.1

reopening projects, 21.8.1

report query

about, 96.7.5

query objects, 11.11.7.1.2

read optimization, and, 11.11.7

using, 11.11.7.1.2, 96.5.2

reports

project status, 21.8.3

query results, 96.5.2

see also status reports

resuming unit of work

after commit, 102.6

after commit failure, 102.6

returning policy

configuring, 28.26

SQLCall, 96.9.1

Returning tab, 28.26.1

RMI

coordinated cache, 93

naming service, 91.8

remote session support, 75.9.1.2

rollback

and Java Transaction API, 100.2.6.2.1

overview, 100.2.6.2

with optimistic locking, 26.8.3

root class

about, 26.7

inheritance, 26.7

root EIS descriptor, 27.4.1.1

root element, descriptor, 32.4

runtime

acquiring sessions, 75.2.4

components, 3.2

services, configuring sessions, 77.9

troubleshooting, 15.7.1

---

S

Save All button, 21.8.2

Save button, 21.8.2

saving projects, 22.2

schema context

descriptors without, 32.3

EIS descriptors, 31.2

XML descriptors, 32.2

Schema Document Info tab, 5.6.4.1, 5.6.5.1

schema manager

about, 6

automatic table creation, 6.4

creating a table creator, 6.2

DB2, 6.1.1

default table generator, 6.2.2

Java table creator, 6.2.3

MS Access, 6.1.1

MySQL, 6.1.1

Oracle, 6.1.1

Oracle TopLink Workbench table creator, 6.2.1

sequencing, 6.1.2, 6.2.3.4

Sybase, 6.1.1

table creator, 6.1, 6.2.1, 6.2.3, 6.3, 6.4

table definition, 6.1

type conversion, 6.1.1, 6.1.1, 6.1.1

usage, 6.1

Schema Structure tab, 5.6.2

schemas

about, 2.8.2

context for EIS descriptors, 31.2

context for XML descriptor, 32.2

data storage, 2.8.2

database, 5.5.1.2

default root for EIS descriptors, 31.3.1

details, 5.6.2

document information, 5.6.4.1, 5.6.5.1

errors, 14.6

importing, 5.6.3

optimizing, 11.6

properties, 5.6.3

reimporting, 5.6.3

schema manager, 6

structure, 5.6.2

XML schemas, 5.6.1

SCM. see source control management

scripts

SQL, generating, 5.5.3.1

see also SQL

scrollable cursor

traversing, 99.10.3.1, 99.10.3.1

using for ReadAllQuery, 99.10.3

SDK

Data Store Exception, 13.15

Descriptor Exception, 13.18

security

cache coordination, permissions, 7.6.1.3

data source access, permissions, 7.6.1.4

disabling doPrivileged(), 7.6.3

doPrivileged(), 7.2.3

EJB, permissions, 7.6.1.6

enabling doPrivileged(), 7.6.3

J2EE application, permissions, 7.6.1.6, 7.6.1.6

java.util.logging, permissions, 7.6.1.5

loading project.xml, permissions, 7.6.1.2

loading sessions.xml, permissions, 7.6.1.2

logging, permissions, 7.6.1.5

password encryption, 21.9

permissions by feature, 7.6.1

permissions when doPrivileged() disabled, 7.6.2

port permissions, 7.6.1.3, 7.6.1.4

SecurityManager integration, 7.2.3

system properties, permissions, 7.6.1.1

understanding permissions, 7.6

with BEA WebLogic, 7.4.5

Select Classes dialog box, 5.7.3.1, 5.7.3.1

SelectedFieldsLockingPolicy, 26.8.4

sensors, DMS profiler, 11.4, 75.2.7.2

SEQ_COUNT column in sequence table, 20.7.3

sequence connection pools, 84.1.6.4

sequence numbers, write optimization features, 11.11.8

SEQUENCE objects in Oracle native sequencing, 20.7.2.5.2

sequencing

about, 20.7, 20.7

BEA WebLogic, 20.7.4

BEA WebLogic single column sequence table, 20.7.2.2, 23.3, 86.4

configuring, 20.7.1, 20.7.1

connection pools, 84.1.6.4

default, 86.4.2.1, 86.4.2.1, 86.4.2.1

DefaultSequence class, 86.4.2.1

descriptors, 26.2.9, 29.3

entity beans, 20.7.4

IBM WebSphere, 20.7.4

isolated client sessions, 75.5.2

Java configuration, 20.7.1

Microsoft SQL Server, 6.2.3.4

native, 20.7.2.5, 20.7.2.6, 20.7.3

non-Oracle database native, 20.7.2.6

Oracle Database native, 20.7.2.5, 20.7.3

Oracle TopLink Workbench configuration, 20.7.1

overriding default, 86.4.2.1

platform default, 86.4.2.1

preallocation, 11.11.8.1.3, 20.7.3

QuerySequence class, 86.4.2.3

schema manager, 6.2.3.4

SEQ_COUNT, 20.7.3

sequence type, configuring, 23.3, 86.4

sessions, and, 75.2.12

stored procedures, 20.7.2.3, 86.4.2.3, 86.4.2.3

Sybase Database, 6.2.3.4

table, 20.7.2.1

table, default column and table names, 20.7.2.1.1

unary table, 20.7.2.2

with stored procedures, 86.4.2.3

serialization

descriptor exceptions, 102.5

EJB 1.x, 33.2.4.5.2

EJB 2.x, 33.2.4.5.2

EJB 3.0, 33.2.4.5.1

indirection, 33.2.4.5

merging into session cache with unit of work, 102.5

serialized object converter

about, 12.2, 33.2.6.1

configuring, 35.9

serialized object mappings, 35.9.1

server layer, 75.9.1.3

server platform

external transaction controller, 77.9

runtime services, 77.9

session configuration, 77.9

session event listener, 77.9.2

Server Platform tab, 77.9.1

server sessions

about, 75.1, 75.3, 75.3.2.1

cache, 75.10.1

connection options, 75.3.2.6

service channel, coordinated cache, 91.3

session accessor

about, 2.13.3.5.1

managing dependent objects with, 2.13.3.5.1

session beans

about, 2.12.3

deploying, 8.4, 9.3, 10.3

model, 2.11, 2.12.3, 2.12.3

remote session support for, 75.9.1.2

session brokers

about, 75.1, 75.7

adding sessions to, 82.2

alternatives, 75.7.4

architecture, 75.7.1

configuration, 82.1

limitations of, 75.7.3

renaming, 82.2

two-phase commits, 75.7.2

two-stage commits, 75.7.2.2

session configuration file

about, 76.1

loading alternative, 78.3.3

preferences, 5.4.7, 5.4.8

see also sessions.xml file

session customizer, 75.2.3

Session Event Manager, 75.2.5

session events

example, 75.2.5, 75.2.5

isolated sessions, and, 75.2.5

manager, 75.2.5

proxy authentication, and, 75.2.5

Session Loader Exceptions, 13.9

Session Manager

about, 78.1, 78.1.1

acquiring, 78.2, 78.3

defaults, 78.3.1

destroying sessions, 78.9

J2EE defaults, 78.3.1

sessions, acquiring, 75.2.4

storing sessions, 78.8

sessions

about, 2.4.3.2, 74.2, 75, 75, 75.2, 76

acquiring at runtime, 75.2.4, 78, 78.1

adding to session brokers, 82.2, 82.2

additional mapping projects, 77.5

API, 75.11

application server logging, 75.2.6.1.3

architecture, 75.2.1

cache, 75.10, 90.1.1

client, 75.3

configuring, 77, 77.1, 77.9.2

connection policy, 77.12

creating, 2.9.3, 76.1, 76.4.1, 76.5.1, 76.6.1, 88.1.1

customization, 75.2.3

database sessions, 75.8, 76.6

destroying in Session Manager, 78.9

errors, 14.7

event listeners, 75.2.5.2, 77.9.2

events, 75.2.5.1

external transaction controller, 77.9, 100.1.2

historical client sessions, 75.6

in sessions.xml file, 75.2.2

isolated client sessions, 75.5, 80

loading with alternative class loader, 78.3.2

logging, 75.2.6, 75.2.6.1.3, 75.2.6.4, 77.4, 77.4.1

logging into, 78.5

logging out of, 78.7

logins, 77.3

management of, 78.1

metadata, about, 2.9.3

multiple sessions, 75.7.4.2, 75.7.4.2, 78.1.2

named queries, 77.13

object cache, 75.2.1.1

optimizing, 11.8

preferences, 5.4.7, 5.4.8

queries, 96.4, 96.6, 98.1, 98.1

refreshing, 78.3.5

registering descriptors, 75.2.10, 77.2, 77.2.2, 77.5.2

remote sessions, 75.9, 76.7

sequencing, about, 75.2.12

server, 75.3

server platform, 77.9, 77.9.1

SQL and messages, 75.2.6.4

storing in Session Manager, 78.8

three-tier architecture, 75.3.1

transformation mappings, 36.13

types, 75.1

unit of work, 75.1, 75.4

sessions.xml file

about, 8.1.2

acquiring, 75.2.4

CMP applications, 8.1.2.3, 75.2.3

configuring with JDeveloper, 4.1.2

creating, 76.1, 76.2

default location, 75.2.4

EJB 3.0, 8.1.2.4

loading alternative configuration file, 78.3.3

non-CMP applications, 8.1.2.2

schema, 8.1.2.1

sessions, 75.2.2

XSD file, 8.1.2.1

setAdditionalJoinExpression(), 99.6.1

setenv.cmd file, 5.2

setenv.sh file, 5.2

setMaxBatchWritingSize(), 11.10.3

setMultipleTableJoinExpression(), 99.6.1

setShouldPerformDeletesFirst(), 102.10.1

Settings tab, 28.8.1, 28.9.1

setValue() method, 33.2.4.1

shared library

setting for BEA WebLogic, 7.4.2

shared library for BEA WebLogic, 7.4.1

simple type translators

about, 12.2, 33.2.6.4

configuring, 35.12

in Java, 35.12.2

read conversions, 33.2.6.4.1

write conversions, 33.2.6.4.2

soft cache weak identity map

about, 90.2.1.3

when to use, 90.2.1.6

sorting, in memory, 35.14

source code, public, 12.3

source control management

projects, 4.2

with Oracle TopLink Workbench, 4.2.1

see also team development

source table, reference, 5.5.2.3

source.jar, 12.3

splash screen, 5.4.1

SQL

call, 98.4

comparing with expressions, 97.1.1

custom queries for basic persistence, per descriptor, 29.4

EJBQLCall, 98.5

generating from database tables, 5.5.3.1, 5.5.3.1

parameter binding, 11.10.4

parameterized, 11.11.8, 98.2.7

prepared statement caching, 11.10.4

queries, 96.2.8.1, 96.2.8.1

scripts with binding arguments, 29.4

SQLCall, 98.4.1

StoredFunctionCall, 98.4.3

StoredProcedureCall, 98.4.2

unit of work, 102.9

SQL Creation Script dialog box, 5.5.3.1

SQL DISTINCT, 11.11.7.2

SQL Exception, 13.4

SQLAnyWhere platform, 84.1.3.1

SQLCall

about, 96.9.1.1

binding input parameters, 98.4.1.1

cursors, 99.10.1

input parameters, 98.4.1.1

input-output parameters, specifying, 98.4.1.3

output parameters, 98.4.1.2, 99.10.1

parameter type, 98.4.1.4

Returning Policy, 96.9.1

ReturningPolicy, 98.4.1.4

using, 98.4.1

SQLServer platform, 84.1.3.1

stages of development with Oracle TopLink, 2.1.1

stale data

cache, 90.2.3, 90.2.3.4, 90.2.3.5

coordination, cache, 90.2.3.5

invalidating the cache, 90.2.3.4

locking policy, and, 90.2.3.1

per-class cache configuration, 90.2.3.2

per-query cache refresh, 90.2.3.3

StartWith, 99.8.2.1

stateful

beans, 2.12.3

comparing with stateless, 2.12.3

stateless

comparing with stateful, 2.12.3

static attributes, 5.7.2.5.1, 5.7.2.9.1

static fetch groups, querying with, 99.3.2

status report, generating, 21.8.3

stored functions

about, 96.9.1.4.4

using, 98.4.3

stored procedures

output parameter event, 98.4.2.4

queries, 98.4.2

sequencing, and, 20.7.2.3, 86.4.2.3

streams

as query results, 96.5.3

cursored, 75.9.2.5, 99.10.5

structure object-relational mappings

configuring, 51

understanding, 49.2

StructureMapping class, 49.2

subqueries

multiple expressions, 97.5

subselects in expressions, 97.5.1

subselects, in expressions, 97.5.1

summary queries, 96.2.4

superclass, 5.7.2.1.1

Sybase

database schema manager type conversion, 6.1.1

native sequencing, 20.7.2.6

platform, 84.1.3.1

Synchronization Exceptions, 13.14

synchronous change propagation, 91.2

system properties

oracle.j2ee.security.usedoprivileged, 7.6.3

oracle.j2ee.toplink.security.usedoprivileged, 7.6.3

toplink.cts.collection.checkParameters, 7.7.1

toplink.xml.platform, 7.2.2.1

---

T

table creator

about, 6.1

creating, 6.2

using, 6.3

Table Creator dialog, 6.2.1

table generation. see automatic table generation

table sequence

about, 20.7.2.1

default column and table names, 20.7.2.1.1

table-class relationships, 16.2.2

tables

adding database, 5.5.1.2

associating with relational descriptors, 29.2

database, 5.5

defining schema, 6.1

errors, 14.5

generating, automatic, 33.2.3.2

import filter, 5.5.1.3

mapping to descriptors, 28.2.1, 29.2.1

merging files, 4.2.2.2

multiple, 29.7

primary key, 5.5.2.2

references, 37.6

relation tables for mappings, 43.2

TableDefinition class, 6.1

see also database tables

target foreign keys

about, 36.5, 37.6

configuring, 37.6

target platforms

about, 2.2.2

choosing, 2.2

target tables

in direct collection mappings, 45.2

reference, 5.5.2.3

team development, 4.2

technical support, 2.1.2

three-tier architecture

about, 1.4, 2.10

authentication, 84.1.4.2

migrating to scalable architecture, 75.8

overview, 2.10

sessions, 75.3.1

timestamp support

about, 37.2

direct to field mappings, 37.2

Oracle Database, 37.2

TIMESTAMP timezone, 37.2

TimestampLockingPolicy, 26.8.1

timezone, with TIMESTAMP, 37.2

tljaxb.cmd file, 21.5.2

toolbars, 5.3, 5.3.2, 5.3.2

topic name, 92.2

TopLink expressions. see expressions

TopLink profiler

about, 11.3

selecting, 77.6.1, 77.8.1, 77.10.1, 77.12.1

TopLink Workbench. see Oracle TopLink Workbench

toplink-ejb-jar.xml file, 8.1.5, 19.1.1

toplink-ejb.xml file, 8.1.5.4

Transaction Exception, 13.22

transactional data sources, 84.1.1

transactions

client-controlled, 102.14.1

CMP, 100.1.2.3, 102.14.1, 102.14.1

container-controlled, 102.14.1

demarcation, 100.1.2

external transaction controller, 77.9, 100.1.2

external, integrating, 100.1.2, 102.13

isolated client sessions, 75.5.2

isolation, 100.1, 100.1.3

JTA, 100.1.2.1

JTS, 100.1.2.1

local, 102.14.1

local, CMP, 102.14.2

OTS, 100.1.2.2

overview, 2.4.3.5, 74.6, 100.1

see also unit of work

transformation EIS mappings

configuring, 64

understanding, 56.9

transformation mappings

about, 33.2.6.5

attribute transformation, 35.15, 35.16

mutable, 35.17

transformation relational mappings

configuring, 48

understanding, 36.13

transformation XML mappings

configuring, 73

understanding, 65.9

transient attributes, 5.7.2.5.1, 5.7.2.9.1

transparent indirection

about, 33.2.4.2

persistent class requirements, 2.4.2

transport layer, 75.9.1.2

troubleshooting

BEA WebLogic deployment, 15.3

data sources, 14.9

deploy tool, 10.7.2.1

deployment, 15

ejbc, 10.4.2.1

IBM WebSphere deployment, 15.7

migration from OC4J persistence, 7.3.2.5

Oracle TopLink Workbench, 14

unit of work, 102.16, 102.16.5.1

tutorial

about, 16.1

database schema, 16.2.2

planning, 16.1

two-phase commits, 75.7.2

two-stage commits, 75.7.2.2

two-tier architecture

about, 1.4, 1.4, 2.11

authentication, 84.1.4.1

understanding, 2.11

type conversion

automatic, 37.2

NCHAR, 33.2.6.2

NCLOB, 33.2.6.2

NVARCHAR2, 33.2.6.2

oracle.sql.TimeStamp, 37.2

schema manager, 6.1.1

String to TIMESTAMP, 33.2.6.2

TIMESTAMP to String, 33.2.6.2

type conversion converter

about, 12.2, 33.2.6.2

configuring, 35.10

provided by direct-to-field mappings, 37.2

TypeConversionMapping

see TypeConversionConverter

types of mappings, 33.1

typesafe enumeration, in EIS mappings, 56.2.5

---

U

unary table sequence

about, 20.7.2.2

BEA WebLogic single column sequence table, 20.7.2.2, 23.3, 86.4

undeployment, 10.6, 10.6.1, 10.6.2

unexpected relationship multiplicity, 7.3.2.5

unidirectional relationships, 36.2.1

unit of work

about, 100.1, 100.1.1, 100.2, 100.2.1

acquiring, 101.1

API, 100.3

architecture, 100.1

auditing, 102.12, 102.12

benefits of, 100.2.1

cache, 90.1.2

change policy, 100.2.3

clones, 100.2.4

CMP integration, 100.1.2.3

commit and Java Transaction API, 100.2.6.1, 100.2.6.1.1

commit, writing changes before, 102.3, 102.4.4.1, 102.13.4.1, 102.13.4.2

conform results of in-memory query, 96.15.2.1

creating objects, 101.2

deleting objects, 101.7

example, 100.2.2

external transaction controller, 77.9, 100.1.2

external transactions, 100.1.2, 100.1.2, 102.13

integrating with CMP, 102.14

isolation, 100.1.3

JTA integration, 100.1.2.1

JTS integration, 100.1.2.1

life cycle, 100.2.2

modifying objects, 101.3

mutable mappings, 35.17

nested, 100.2.5, 102.8.1, 102.8.2

newInstance method, 102.1.1

optimization, 11.12, 100.2.8

OTS integration, 100.1.2.2

parallel, 100.2.5, 102.8.1

pre-commit validation, 102.16.5.1

primary keys, 100.2.7

proxy indirection, 33.2.4.3.1

queries, 100.3.1.1.2

read optimization, 11.11.7

read-only classes, 102.2, 102.2.1, 102.2.2

registerNewObject method, 102.1.2

remote sessions, 75.9.2.6

resuming, 102.6

reverting, 102.7

rollback, 100.2.6.2, 100.2.6.2.1

sessions, 75.1, 75.4

transaction demarcation, 100.1.2

transactions, 100.1.3

unit of work, 100.1.2

troubleshooting, 102.16

validating objects, 102.16.5

with custom SQL, 102.9

write optimization, 11.11.8

writing changes before commit, about, 102.3

writing changes before commit, and external transaction exceptions, 102.13.4.2

writing changes before commit, and external transaction timeouts, 102.13.4.1

writing changes before commit, as alternative to conforming, 102.4.4.1

unmapping, 34.5.1

unregistering objects, 102.1

unsaved items, displaying in TopLink Workbench Navigator window, 5.3.3

update

operation, 98.1.2.1, 98.1.2.4

projects from prior versions, 21.8.1

UpdateAll query, 96.7.3.5

updateObject(), 29.4.1

Use XML Schema "type" attribute, configuring, 35.12

useBatchWriting(), 86.6.2

user-defined functions, in expressions, 97.8

---

V

validating

descriptors, 27.6

JAXB, 20.5.2

projects, 21.8.3

unit of work, 102.16.5

Validation Exceptions, 13.7, 13.7

Value Converter tab, 46.5.1

value holders

about, 33.2.4.1

ValueHolder class, 33.2.4.1

ValueHolderInterface class, 2.4.2, 33.2.4.1, 36.8

variable one-to-one relational mappings

class indicator, 41.2

configuring, 41

primary key, unique, 41.3

understanding, 36.6

VariableOneToOneMapping class, 36.6

Varray in Oracle database. see array mappings

version control, 4.2.5

Version Control Assistance dialog box, 4.2.5

VersionLockingPolicy, 26.8.1

volatile attributes, 5.7.2.5.1, 5.7.2.9.1

VPD. see Oracle Virtual Private Database

---

W

warning icon, 5.3.3, 5.3.5

weak identity map, 90.2.1.2

web browser, specifying, 5.4.2

web services architecture, 1.4, 2.15

WebLogic. see BEA WebLogic

weblogic-ejb-jar.xml file

described, 8.1.4

modifying for Oracle TopLink, 8.8

unsupported tags, 8.8.2

WebSphere. see IBM WebSphere

welcome screen, 5.4.2

wildcard, 66.3

wrapper policy

about, 28.31

implementing in Java, 28.31.1

write

conversions, simple type translator, 33.2.6.4.2

write all operation, 98.1.2.2

write query

disabling identity map cache, 98.2.2.4

non-cascading, 98.2.2.3

objects, 98.2.2.1

overview, 98.2.2.1

write-locking, 26.2.10

writing

batch, 11.11.8, 86.6.2

ejb-jar.xml file, 21.10.1

optimization, 11.11.8

sessions write access, 75.3.2.3

---

X

xdb.jar file, 5.2

XML

descriptor, schema context, 32.2

generating deployment, 8.1.1.4

mappings, concepts, 65.2

preserving data, 32.5

projects, 21.1.1.1

query language, 96.2.8.3

reading whole documents, 39.2

records, 56.2.1.3

schemas, 5.6.1

XML Conversion Exception, 13.23

XML Data Store Exceptions, 13.12

XML descriptors

configuring, 32

schema context, 32.2

understanding, 26.6

XML mappings

about, 65

any collection, 65.8, 72

any object, 65.7, 71

any type support, 65.2.5

composite collection, 65.6, 70

composite direct collection, 65.4, 68

composite object, 65.5, 69

concepts, 65.2

configuring, 66

default conversion pairs, customizing, 65.3.5

direct, 65.3, 67

extensions, 65.2.8

jaxb:class support, 65.2.6

list support, 65.2.4

reference descriptor, configuring, 66.2

transformation, 65.9, 73

types of, 65.1

union support, 65.2.4

xsd:list, 65.2.4

xsd:union, 65.2.4

XML parser platform

about, 7.2.2

configuring, 7.2.2.1, 7.2.2.1

creating, 7.2.2.2

Crimson, 7.2.2.2

default, 7.2.2.1

limitations, 7.2.2.2

parser conflicts, 7.2.2

toplink.xml.platform system property, 7.2.2.1

used by, application server, 7.2.2

used by, Oracle TopLink, 7.2.2

XML projects

configuring, 25

JAXB support, 20.5.1

sequencing, 20.2.6

understanding, 20.5

XML queries, 96.2.8.3

XML schema

jaxb:class, and EIS mappings, 56.2.4

jaxb:class, and XML mappings, 65.2.6

jaxb:class, understanding, 33.2.9

type, 35.12

xs:any, understanding, 65.2.5

xs:anyType, understanding, 65.2.5

xsd:list, understanding, 33.2.8

xsd:union, understanding, 33.2.8

see also schemas

XML Type functions, 97.2.4

XPath

by name, 33.2.7.3

by position, 33.2.7.1

mapping Java attributes, 35.4

support in OX mappings, 33.2.7

support in XML mappings, 56.2.2, 65.2.3

XSD file

projects.xml file, 8.1.1.1

sessions.xml file, 8.1.2.1

---

Z

zero-argument constructors

editing, 5.4.4, 5.4.4

TopLink. see Oracle TopLink