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

<Java EE-Container>-jar.xml file
EJB 3.0, 9.1.4

A

access
data access, 96
direct, 121.16.1
modifiers, 5.7.2.2
optimizing data access, 12.11
remote sessions, 87.9.2.1
access method
direct, 121.6
generating, 5.5.3.2
mappings, 121.6.1
method, 121.6
specifying, 121.16.1
access modifiers, classes, 5.7.2.2
acquiring
client sessions, 90.4
sessions, at runtime, 87.2.4
unit of work, 114.1
activating descriptors, 5.3.3
Add Named Query dialog, 119.7.1.1, 119.7.1.6.1, 119.7.1.7.1
Add New Class dialog, 5.7.1.1, 5.7.5.1
Add New Table button, 5.5.1.2
Add or Refresh Class button, 5.7.3.1
addConstraingDependencies(), 115.10.2
address
multicast group, 103.4
multicast port, 103.5
Add/Update Existing Tables from Database button, 5.5.1.3
advanced properties for descriptors, 117.6
After Load tab, 119.35.1
aggregate collection relational mappings
and EJB, 27.9.2
configuring, 35
understanding, 27.9
aggregate descriptors
about, 16.2.5
aggregate object mapping, 21.2
EIS projects, 74.2.1
EJB 3.0, 16.2.5, 21.2.1
inheritance, 16.3.4
relational projects, 21.2
XML projects, 50.1.1.1
aggregate object relational mappings
aggregate descriptors, and, 21.2
configuring, 37
understanding, 27.12
aggregation, isolated client sessions, 87.5.2
AllFieldsLockingPolicy, 16.4.4
allows none, 110.7.1.1, 119.7.1.6.1
allows null, 110.7.1.1, 119.7.1.6.1
amending descriptors, 2.9.2.1.1, 16.2.7, 119.35
see also after load
announcement delay, 103.9
Ant, integrating with Oracle TopLink Workbench, 5.8
any attribute XML mappings
configuring, 70
any collection XML mappings
configuring, 60
understanding, 53.8
any object XML mappings
configuring, 59
understanding, 53.7
application development
deploying, 11
mapping, 2.9.2.1
querying, 2.4.3.4, 86.1.4
application layer, remote sessions, 87.9.1.1
Application Navigator
TopLink elements, 4.3.1
application servers
EJB support, customizing, 8.9
integrating with Oracle TopLink, 8
logging, 87.2.6.1.3
MaD support, 8.4.4
optimization, 12.15
setter parameter type checking, 8.9, 8.9.1
single-object finder return type checking, 8.9, 8.9.3
software requirements, 8.2.1
target platforms, 2.2.2
unknown primary key class support, 8.9, 8.9.2
architectures
application, 1.4
BMP, 1.4, 2.15
cache, 102.1
choosing, 2.2
CMP, 1.4, 2.14
EIS, 2.2.1.4, 2.2.1.5, 77.2.7
EJB entity beans, 1.4, 1.4, 2.14, 2.15
EJB session bean facade, 1.4, 2.13, 2.13
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, 87.7.1
sessions, 87.2.1
three-tier, 1.4, 2.11, 2.11
two-tier, 1.4, 2.12, 2.12
unit of work, 113.1
web services, 1.4, 2.17
arguments, binding in query, 23.4
array
dimensionality, 5.7.2.6.1, 5.7.2.10.1
object-relational data type mappings, 40.1.3
AsOfClause, 111.2
asynchronous change propagation, 103.2
AttributeChangeTrackingPolicy
about, 113.2.3.3
JPA entities, 113.2.3.3.1
OC4J CMP integration, 113.2.3.3.3
POJO classes, 113.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, 119.30.1.3
final, 5.7.2.5.1, 5.7.2.9.1
in TopLink Workbench, Navigator window, 5.3.3
static, 5.7.2.5.1, 5.7.2.9.1
transforming, 27.13, 121.15, 121.15, 121.16, 121.16
transient, 5.7.2.5.1, 5.7.2.9.1
unmapping, 120.6.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, 96.1.3.1
auditing
authentication, 96.1.4.3
unit of work, 115.12
authentication
about, 96.1.4
auditing, 96.1.4.3
proxy authentication, 96.1.4.2
simple JDBC authentication, 96.1.4.1
three-tier architecture, 96.1.4.2
two-tier architecture, 96.1.4.1
Automap, 120.3.1
automapping descriptors
about, 120.3
see also mappings
automatic table generation
about, 17.2.3.4
configuring, 9.9.1.3

B

Base64 encoded strings, 121.12.2
batch
writing
JDBC, 12.11.3, 98.6.1
batch options
mappings, 28.5.1
writing, 12.11.3
batch reading
in query objects, 109.2.1.9
read optimization, and, 12.12.9
batch writing
about, 12.11.3, 12.12.10, 98.6.2
dynamic, 12.11.3
dynamic, setMaxBatchWritingSize(), 12.11.3
JDBC, 12.11.3, 98.6.1
MySQL4 platform, 98.6
native, 12.11.3, 98.6.1
non-parameterized, 12.11.3
parameterized, 12.11.3
setMaxBatchWritingSize(), 12.11.3
TopLink, 12.11.3, 98.6.1
BEA WebLogic
setting classpath, 8.3.1
setting shared library, 8.3.1
using a security manager, 8.3.4
beans
session beans, 2.13.3
stateful beans, 2.13.3
stateless beans, 2.13.3
bidirectional relationships
about, 27.2.1
generating, 5.5.3.2
in Java, 121.18.2
in one-to-one mappings, 121.18.2
target keys, 27.5
with indirection, 121.18.2
binary data collection XML mappings
configuring, 65, 67
binary data XML mappings
configuring, 64
bindAllParameters() method, 20.7
bindings
arguments, 23.4
JAXB, 47.1.1
see parameter binding
BLOB
mapping to, 120.5
BMP
and EJB 1.1, 2.15
and EJB 2.0, 2.15
and TopLink, 2.15
deployment files, 9.7
descriptors, 16.2.3, 119.18
packaging for deployment, 10.7
boolean logic in expressions, 110.2.1
branch classes, 16.3, 16.3
buttons. see toolbars
Byte array Base64, 121.12.2

C

cache
about, 2.4.3.3, 2.8.8, 102
architecture, 102.1
configuring, 102.2.3, 111.13.1
coordination, 102.2.6, 103, 104, 105
descriptor level, 119.12
disabling during read query, 108.16.4
distributed, 102.2.6
expiration, 111.13.2, 117.13, 119.16
expression limitations, 108.16.2.2
identity maps, using, 87.8
in-memory queries, 108.16.2.1, 108.16.2.2
internal query object cache, 108.16.6, 108.16.7, 108.16.7.1, 111.13.1, 111.13.2
invalidation, 102.2.3.4, 102.2.5, 117.13, 119.16
isolated client sessions, 87.5.2
isolation, 102.2.3, 102.2.7
object cache, 108.16.7
object cascading refresh, 108.16.5.2
object refresh, 108.16.5.1
optimizing, 12.10
project level, 117.10
queries, 102.2.2, 108.16
query cache, 108.16.7
readObject method, and, 109.1.1.1
refreshing, 102.2.4.1, 108.16.5.3, 119.9
restrictions, 108.16.7.1
service channel, 103.3
sessions, 87.2.1.1, 87.10, 102.1.1
stale data, 102.2.3
storing query results, 108.16.6, 108.16.6, 111.13.1
type and size, 117.10, 119.12
unit of work cache, 102.1.2
cache coordination
about, 102.2.6
application server clustering, and, 8.2.5
avoiding stale data, 102.2.3.5
CMP projects, 9.9.1.2
EJB Entity Beans with BMP architecture, and, 2.15.3.3
explicit query refreshes, 102.2.4
JMS, 104
JMS, connection handling, 104.5
JMS, error receiving message, 104.5
JMS, ERROR_RECEIVED_JMS_MESSAGE_IS_NULL, 104.5
JMS, ERROR_RECEIVING_JMS_MESSAGE, 104.5
JMS, null JMS message, 104.5
orion-ejb-jar.xml, 9.9.1.2
packet time-to-live, 103.12
permissions, 8.8.1.3
RMI, 105
cache invalidation, avoiding stale data, 102.2.3.4
cache synchronization. see cache coordination
cacheAllStatements(), 20.7
cacheQueryResults(), 119.7.1.10
cache-synchronization property, 9.9.1.2
Caching tab, 119.12.1, 119.13.1, 119.15.1, 119.17.1
calendar, 28.3
call
call queries, 108.9
EIS, 109.8
EJBQLCall, 109.7
JPQLCall, 109.7
SQLCall, about, 109.4
SQLCall, JDBC arguments, 109.4.2
SQLCall, no arguments, 109.4.1
StoredProcedureCall, 109.6
StoredProcedureCall, about, 109.5
StoredProcedureCall, ErrorCodeListener, 109.5.5
StoredProcedureCall, JDBC arguments, 109.5.2, 109.5.3
StoredProcedureCall, no arguments, 109.5.1
StoredProcedureCall, PL/SQL arguments, 109.5.3
Call object, queries, 108.2.1
cascading
object refresh, 108.16.5.2
optimistic version locking, 16.4.2
write queries, compared to non-cascading, 108.7.3.7, 109.2.2.2
catalog, database, 5.5.1.2
catchExcpetions(), 89.11
CDATA in mappings, 121.20
change policy
about, 113.2.3
attribute change tracking, configuring, 119.30.1.3
configuring, 119.30
deferred change detection, configuring, 119.30.1.1
empty transaction, 113.2.3
object change tracking, configuring, 119.30.1.2
unit of work, 113.2.3
change tracking
attribute, configuring, 119.30.1.3
deferred, configuring, 119.30.1.1
method and direct field access limitations, 2.4.1.4, 117.4, 121.6
object, configuring, 119.30.1.2
changed items, displaying in TopLink Workbench Navigator window, 5.3.3
ChangedFieldsLockingPolicy, 16.4.4
changing package names, 5.7.5
checkDatabase(), 89.11
checking in/out projects, 7.2.1
checkInstantiationPolicy(), 89.11
choice collection XML mappings
configuring, 69
choice object XML mappings
configuring, 68
Choose a Schema Context dialog box, 52.2.1.1, 76.2.1.1
Choose Query Key dialog box, 110.7.1.1
Choose Relationships to Generate dialog box, 5.5.3.2
Choose Root Element dialog box, 52.4.1.1, 76.3.1.1
class extraction method
about, 16.3.1.2
inheritance, 16.3.1.2
class indicator
about, 16.3.1
class extraction method, 16.3.1.2
class indicator field, 16.3.1.1, 32.2
class loader
host application, 2.2.2
IBM WebSphere, 8.5.2
loading session, 90.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, 16.3
creating, 5.7.1.1, 5.7.5.1
CursoredStream, optimizing, 111.11.3
Database Exception, 109.9
DatabaseMapping, 17.3
default null values, 121.19
DeleteObjectQuery, 109.2.2.1
DirectCollectionMapping, 36.2.2
ExpressionBuilder, 110.7.2
generating from database, 5.5.3.2
InsertObjectQuery, 109.2.2.1, 109.2.2.1, 113.3.1.1.2
interfaces, 5.7.2.3
leaf, 16.3
merging files, 7.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, 12.3.1
persistent requirements, 2.4.2
preferences, 5.4.4
refreshing, 5.7.3.1
removing, 5.7.3.1
root, 16.3
troubleshooting, A.3.8
unit of work, 113.3.1.1.2
UpdateObjectQuery, 109.2.2.1, 109.2.2.1, 109.2.2.2
ValueHolderInterface, 2.4.2, 17.2.4.1, 27.8, Glossary
VariableOneToOneMapping, 27.6, 27.6
see also specific class name
classpath
adding, 117.3.1
BEA WebLogic, 8.3.1
configuring, 5.2, 8.3.1, 8.6.1, 8.7.1
connector.jar, 5.2
custom Collection class, 5.2
DRIVER_CLASSPATH, Oracle TopLink Workbench, 5.2
JCA adapter, 5.2
JDBC driver, 5.2, 5.5.1.3
JDBC_CLASSPATH, 5.2
Oracle TopLink Workbench DRIVER_CLASSPATH, 5.2
relative, 117.3.1
SunAS, 8.6.1, 8.7.1
troubleshooting, A.3.8
xdb.jar file, 5.2
client session
logging out, 90.8
releasing, 90.8
client sessions
about, 87.1, 87.3, 87.7
acquiring, 90.4
configuration, 94.1
example, 87.3.2.2
shared resources, 87.3.2.1
client-controlled transactions, 115.14.1
client-server architecture. See two-tier
CLOB
mapping to, 120.5
clones
copying methods, 119.29
merging changes, 115.5
post-commit, avoiding, 115.16.1
unit of work, 113.1.1, 113.2.4
Cloudscape platform, 96.1.3.1
clustering, integrating TopLink with, 8.2.5
CMP
and EJB 1.1, 2.14
and EJB 2.x, 2.14
and EJB 3.0, 2.14
and TopLink, 2.14
automatic table creation, 6.4.2
CMPPolicy, 16.2.3, 119.18
deploying, 9.6, 11.5
descriptors, inheritance, 16.2.3.3
external transactions, 113.1.2.3
isolated client sessions, 87.5.2
local transaction, 115.14.1, 115.14.2
non-deferred write, 115.14.3
OC4J persistence, 8.4.2
packaging for deployment, 10.6
schema generation, 6.4.2
schema manager, 6.4.2
setter parameter type checking, 8.9.1
single-object finder return type checking, 8.9.3
transaction attribute, 115.14.1
unit of work, 113.1.2.3, 115.14
unknown primary key class support, 8.9.2
code generation, optimizing, 12.5
collapsing items in Navigator window, 5.3.3
collection class
specifying, 109.2.1.6
specifying in query objects, 109.2.1.6
collection reference XML mappings
configuring, 63
collections
persistent requirements for mappings, 2.4.2
query results, 108.5.1
comments
descriptors, 119.5.1, 119.6, 119.6.1
mappings, 121.8
projects, 117.14
commit
and Java Transaction API, 113.2.6.1, 113.2.6.1.1
failure, resuming after, 115.6
resuming unit of work after, 115.6
Communication Exceptions, A.2.11
composite collection EIS mappings
configuring, 82
example, 77.6
understanding, 77.6
composite collection XML mappings
configuration, 58.1
configuring, 58
understanding, 53.6
composite descriptors
about, 16.2.5
composite object mapping, 50.1.1.1, 74.2.1
EIS projects, 74.2.1
XML projects, 50.1.1.1
composite direct collection EIS mappings
configuring, 80
understanding, 77.4
composite direct collection XML mappings
configuring, 56
understanding, 53.4
composite EIS descriptors, 75.2.1.2
composite object EIS mappings
composite descriptors, and, 74.2.1
configuring, 81
understanding, 77.5
composite object mappings
composite descriptors, and, 50.1.1.1
composite object XML mappings
configuration, 57.1
configuring, 57
understanding, 53.5
composite primary key, 27.8, 121.18.2
concrete class. see container policy
concurrency
about, 2.8.7
exceptions, A.2.2
server session, 87.3.2.5
Concurrency Exceptions, A.2.2, A.2.2
configurations
about, 88.2
creating, 88.2.1
development environment, 7.1
new, 88.2.1
Oracle JDeveloper, 7.1
session, 88.2.1, 88.3.1, 88.4.1, 88.5.1, 88.6.1
conforming
about, 115.4
alternatives, UnitOfWork method writeChanges, 115.4.4.1
alternatives, UnitOfWork properties, 115.4.4.2
descriptors, and, 115.4.3
queries, alternatives to, 115.4.4
ConnectBy, 111.9.2.2
connection policy
configuring, 89.12
exclusive connections, 89.12
lazy connection acquisition, 89.12
connection pool
about, 96.1.6, 96.1.6
connection count, 101.2
ConnectionPolicy, 87.5
external, 96.1.6.2
internal, 96.1.6.1, 96.1.6.3, 96.1.6.3, 96.1.6.4, 96.1.6.5
lazy connection allocation, 87.3.2.6, 90.4.5
named, 96.1.6.5, 96.1.6.5
parameter binding, 12.11.5
prepared statement caching, 12.11.5
read, 96.1.6.3
sequence, 15.2.6, 96.1.6.4, 96.1.6.4
server session, 87.3.2.6
sessions, and, 87.2.1.2
size, 101.2
write, 96.1.6.3
Connection Specifications tab, 73.3.1
Connection tab, 73.3.1
connections
about, 96.1.5
connection pool, 96.1.6
exclusive write connection, 89.12
lazy acquisition, 89.12
reading through the write connection, 115.15.1.4
connector.jar, 5.2, 71.1
container policy
about, 121.14
custom Collection class, 5.2
sorting, in memory, 121.14
container-controlled transactions, 115.14.1
context
JAXB context, 47.1.1.3.4
menus, 5.3.1.2
schema, 52.2, 76.2
Context.SECURITY_CREDENTIALS, 103.7.1
Context.SECURITY_PRINCIPAL, 103.7.1
Conversion Exception, A.2.3
Converter tab
object type mappings, 121.11, 121.11.1
converters
custom, 27.2.2.2
object type, 121.11, 121.11.1
coordinated announcement delay, 103.9
coordinated cache, 9.9.1.2
configuring, 103
naming service, 103.6
service channel, 103.3
copy policy
about, 119.29
method, 119.29
setting, 119.29.1
copying project objects, 7.2.3
Copying tab, 119.29.1
CORBA
Oracle TopLink transport layer support, 87.9.1.2
Transaction Service see OTS
Create New Project button, 116.1.2.1
Create New Project dialog box, 116.1.2.1
Create New Session dialog, 88.4.1, 88.5.1, 88.6.1
Create Project from JAXB dialog, 48.2.1
creating
configurations, 88.2.1
expressions, 110.7.1
sessions, 88.4.1, 88.5.1, 88.6.1, 100.2.1
Crimson XML parser, 8.2.2.2
cursored streams
example, 111.11.2.1
optimizing, 111.11.3
remote sessions, 87.9.2.5
usage example, 87.9.2.5
cursors
as query results, 108.5.3
traversing scrollable, 111.11.1.1
Custom Calls tab, 76.5.1
custom SQL
Custom SQL tab, 23.4.1
unit of work, 115.9
customization
about, 13, 13.1
data types, 13.2
EIS, 13.1
mapping extensions, 13.2
overview, 2.6
XML, 13.1

D

data access
about, 96
authentication, 96.1.4
connection pool, 96.1.6
connections, 96.1.5
optimizing, 12.11, 12.11.2
platforms, 96.1.3
data level queries
example, 110.6.2
in expressions, 110.6
data source platform
about, 96.1.3
Attunity Connect database, 96.1.3.1
Cloudscape database, 96.1.3.1
databases, 96.1.3.1
DB2 database, 96.1.3.1
EIS, 96.1.3.2
HSQL database, 96.1.3.1
Informix database, 96.1.3.1
JCA adapter, 96.1.3.2
JDBC drivers, 96.1.3.1
Microsoft Access database, 96.1.3.1
MySQL4 database, 96.1.3.1
Oracle database, 96.1.3.1
Oracle8 database, 96.1.3.1
Oracle9 database, 96.1.3.1
PointBase database, 96.1.3.1
SQLAnyWhere database, 96.1.3.1
SQLServer database, 96.1.3.1
SybasePlatform database, 96.1.3.1
data sources
configuring, 97
nontransactional, 96.1.1
transactional, 96.1.1
Database Exceptions, 109.9, A.2.4
database fields, configuring, 28.3
database functions, in expressions, 110.2.2
database login
parameter binding, 98.6
prepared statement caching, 98.6
Database Preferences, 5.4.6
database queries
about, 108.7, 109.2
fetch groups, 108.7.1.6
join reading, 108.7.1.5
object level modify query, 108.7.3, 108.7.4
object level read query, 108.7.1, 108.7.2
partial object query, 108.7.1.3
read all query, 108.7.1.2
read object query, 108.7.1.1
report query, 108.7.5
database schema
tables, 5.5.1.2
database session
logging out, 90.8
database sessions
about, 87.1, 87.8
cache, 87.10.1
configuration, 95.1
creating, 88.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, 19.6.2
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, 109.9
DatabaseLogin, 96.1.2.1
DatabaseMapping class, 17.3, 17.3
DatabaseQuery, 108.2.2
DatabaseRow, 27.13
databases
catalog, 5.5.1.2
common problems, A.3.9
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, 109.9
fields, configuring, 28.3
for project, 116.1.2.1
Java type conversion, 6.1.1
linking, 87.7.4.1
log out of, 5.5.1.1
logging into, 5.5.1.1, 20.6
logins, 98
mapping. See mappings
platform, 20.2, 73.2, 98.2, 99.2, 116.1.2.1
preferences, 5.4.6
schema, 5.5.1.2
schema manager, 6
tables, 5.5
TopLink Workbench, Navigator window, 5.3.3
troubleshooting, A.3.9
type conversion, schema manager, 6.1.1
using with Oracle TopLink Workbench, 5.5
DatabaseSession class
logging SQL and messages, 87.2.6.4
DB2
platform, 96.1.3.1
schema manager type conversion, 6.1.1
DBase platform, 96.1.3.1
default mapping
about, 17.2.3.4
automatic table generation, and, 17.2.3.4, 17.2.3.4
configuring, 9.9.1.3
default table generator, 6.4
Default Mapping Exception, A.2.14
default table generator
default mapping, 6.4
table creator, creating, 6.2.2
defaults
login level null values, 97.6
mapping level null values, 121.5
null values, 97.6, 121.5, 121.19
optimization, 12.5
root, 52.4
see also preferences
DefaultSequence, 98.4.2.1
deferred change detection
configuring, 119.30.1.1
DeferredChangeDetectionPolicy, 113.2.3.1
Delete All Interaction tab, 84.3
deleteObject(), 23.4.1
DeleteObjectQuery, 109.2.2.1
deletes
controlling order, 115.10
delete operation, 109.1.2.5
queries, EIS mappings, 84.3
demarcation of unit of work transactions, 113.1.2
dependent objects
non-deferred write, 16.2.3.1
deploying
about, 2.5, 2.5.1, 11
application server requirements, 8
CMP applications, 11.5, 11.7.1
database login, 20.5.1
entity beans overview, 2.5.2
generating XML for, 9.1.1.6
hot deployment, 11.7, 11.7.1, 11.7.2
Java applications, 11.1
JSP and Servlet applications, 11.2
non-CMP applications, 11.7.2
packaging, 10
Session Bean applications, 11.3
deployment descriptors, 16.2.3
deployment files
BMP applications, 9.7
CMP applications, 9.6
creating, 9.1
descriptors, 16.2.3
EJB 3.0, 9.1, 10
Java applications, 9.2
JSP and Servlet applications, 9.3
Session Bean applications, 9.4
XML, generating, 9.1.1.6
deployment XML, exporting, 116.3.1
DeploymentXMLGenerator, 9.1.1.7
descriptor customizer, 16.2.6
Descriptor Event Listener, 119.25
Descriptor Event Manager
about, 16.2.8
Descriptor Event Listener, 119.25, 119.25
domain object methods, 119.24
event types, 119.24
handlers, 16.2.8, 119.24, 119.25
handlers, Descriptor Event Listener, 119.25
understanding, 16.2.8
descriptor events
about, 16.2.8
Descriptor Event Listener, 119.25
domain object methods, 119.24
handlers, 16.2.8, 119.24, 119.25, 119.25
types of, 119.24
understanding, 16.2.8
Descriptor Exceptions, A.2.1, A.2.5
Descriptor Info tab, 23.2.1, 23.3.1, 52.2.1, 52.3.1, 52.3.1, 52.4.1, 52.4.1, 52.5.1, 76.2.1, 76.3.1, 76.3.1, 119.2.1, 119.3.2, 119.4.1
DescriptorEventListener, 119.25
descriptors
about, 14.1.2, 14.1.2, 16
advanced properties, default, 117.6
aggregate, 16.2.5, 22.2.1.2
aggregate, EJB 3.0 and, 16.2.5, 21.2.1
aggregate, relational projects and, 21.2
amending, 2.9.2.1.1, 16.2.7, 119.35
API, 16.5
architecture, 16.2.1
attributes, adding, 5.7.2.5
automapping, 120.3
automatically mapping, 120.3
BMP, 16.2.3, 119.18
cache refreshing, 119.9
change policy, 119.30
child inheritance, 119.20
class, 22.2.1.1
CMP, 16.2.3, 119.18
CMPPolicy, 16.2.3, 119.18
comments, 119.5.1, 119.6, 119.6.1
composite, 16.2.5, 50.1.1.1, 74.2.1, 75.2.1.2
composite EIS, 75.2.1.2
configuring, 119, 119.1
conforming, 115.4
creating, 22, 22.2.1.1, 22.2.1.2, 25, 75, 75.2.1.1, 75.2.1.2, 118
custom EIS interactions for basic persistence, 76.5
custom SQL queries for basic persistence, 23.4
customization, 16.2.6
deactivating, 5.3.3
default mappings, 17.2.3.4
default root, 76.3.1
deployment information, 16.2.3
Descriptor Event Listener, 119.25, 119.25
domain object methods, 119.24
EIS, 74.1, 75.2.1.1, 75.2.1.2, 76
EIS projects, 74.2.1
EJB, 16.2.3, 119.18
EJB information, 16.2.3, 16.2.3, 119.18
errors, 5.3.3, 5.3.5, A.3.3
event handlers, 16.2.8, 119.24, 119.25, 119.25
events, 16.2.8, 16.2.8, 119.24
existence checking, 12.8, 119.17
fetch groups, 119.33
files, merging, 7.2.2.2
generating from database, 5.5.3.2
hierarchy, inheritance, 16.5.1
history policy, 119.31
identity maps, 117.10, 119.12, 119.12, 119.13, 119.15
in Java, 16.5
inactive, 5.3.3
inheritance, 16.2.2, 16.3, 21.3, 119.20, 119.21
instantiation, 12.8
interface, 22.2.1.3, 119.10, 119.11
mapping, 17.2.3.4, 23.2.1, 119.2.1, 120.2, 120.3
merging, 7.2.2.2
named queries, 119.7
nondescriptor classes, 5.7.4
object-relational data type, 24.1, 26
optimizing, 12.8, 12.8
parent inheritance, 119.21
projects, 14.1.2, 16.1
query key interfaces, 119.10
query timeout, 119.7.1.10, 119.8
read-only, 119.3
registering with sessions, 87.2.10, 89.2, 89.2.2, 89.5.2
relational, 21.1, 22.2.1.1, 22.2.1.2, 22.2.1.3, 23
removing, 5.7.3.1
returning policy, 119.27
root EIS, 75.2.1.1, 75.2.1.1
root element, 52.4
schema context, 52.2, 52.3, 76.2
sequencing, 16.2.10, 23.3
TopLink Workbench, Navigator window, 5.3.3
types of, 16.1
validating, 118.2
XML, 50.1, 51, 52
XML projects, 50.1.1.1
developing applications with Oracle TopLink, 2
development environments
about, 3.1
configuring, 7.1
database logins, 20.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, 12.3
schema manager, 6
dimensionality, array, 5.7.2.6.1, 5.7.2.10.1
direct access
about, 117.4, 121.6
specifying, 121.16.1
direct collection relational mappings
configuring, 36, 36.1
example, 27.10, 36.2.2
in Java code, 36.2.2
understanding, 27.10
direct collections
session broker limitations, 87.7.3.1
direct EIS mappings
configuring, 79
understanding, 77.3
direct field
in direct collection mappings, 36.3
direct field access
change tracking limitations, 2.4.1.4, 117.4, 121.6
direct key fields, 38.3
direct map relational mappings
configuring, 38, 38.1
direct keys, 38.3
direct value, 38.2
understanding, 27.11
direct mappings
generating deprecated, 20.11
with EJB, 27.2.3
direct value fields, 38.2
direct XML mappings
configuring, 55
understanding, 53.3
DirectCollectionMapping class, 36.2.2
directionality in mappings, 27.2.1
direct-to-field mappings
ObjectTypeMapping deprecated, 27.2.2.2
SerializedObjectMapping deprecated, 27.2.2.2
type conversions, 28.3
TypeConversionMapping deprecated, 27.2.2.2
direct-to-field relational mappings
configuring, 29
options, 29.1
timestamp support, 28.3
understanding, 27.3
direct-to-XMLType relational mappings
configuring, 30
understanding, 27.4
Discovery Exception, A.2.15
DMS profiler
about, 12.4, 87.2.7.2
accessing with JMX, 12.4.2
and JMX
nouns, 12.4, 87.2.7.2
selecting, 89.6.1, 89.8.1, 89.10.1, 89.12.1
sensors, 12.4, 87.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, 12.12.10
dontOptimizeDataConversion(), 12.11.2
doPrivileged(), 8.2.3
DRIVER_CLASSPATH
Oracle TopLink Workbench environment, 5.2
drivers, custom database, 5.4.6
dynamic batch writing
about, 12.11.3
setMaxBatchWritingSize(), 12.11.3
dynamic fetch groups, querying with, 111.3.3

E

editor, 4.3
editor window
TopLink, 4.3.2
Editor window, about, 5.3, 5.3.4
EIS
about, 71.1
architecture, 2.2.1.4
call, 109.8
custom interactions for basic persistence, per descriptor, 76.5
indexed records, configuring, 76.4
interactions, 76.5, 108.2.8.5, 109.8
mapped records, configuring, 76.4
mappings, 71.1, 77.2
projects, 116.1.2.1
queries, 108.2.8.5
record format, configuring, 76.4
XML records, configuring, 76.4
EIS descriptors
composite, 75.2.1.2
configuring, 76
default root, 76.3.1
locking policy, 119.26
root descriptor, 75.2.1.1
schema context, 76.2
setDataTypeName, 76.3.2
understanding, 74.1
EIS mappings
about, 77, 77.2
architecture, 77.2.7
composite collection, 77.6, 82
composite direct collection, 77.4, 80
composite object, 77.5, 81
configuring, 78
direct, 77.3, 79
jaxb:class support, 77.2.4
list support, 77.2.3
one-to-many, 77.8, 84
one-to-many, key on source, 77.8.1
one-to-many, key on target, 77.8.2
one-to-one, 77.7, 83
one-to-one, key on source, 77.7.1
one-to-one, key on target, 77.7.2
transformation, 77.9, 85
types of, 77.1
union support, 77.2.3
xsd:list, 77.2.3
xsd:union, 77.2.3
EIS projects
configuring, 73
connector.jar, 71.1
indexed records, 72.3
mapped records, 72.3
sequencing, 15.2.6
understanding, 71.1
XML records, 72.2
EIS queries, 108.2.8.5
EIS record types, supported, 77.2.1
EISLogin, 96.1.2.1
EJB
descriptors, 116.2.1
isolated client sessions, 87.5.2
setter parameter type checking, 8.9
single-object finder return type checking, 8.9
unknown primary key class support, 8.9
EJB 1.1
and BMP, 2.15
and CMP, 2.14
EJB 2.x
and BMP, 2.15
and CMP, 2.14
default mapping, 17.2.3.4
EJB 3.0
<Java EE-Container>-jar.xml file, 9.1.4
and CMP, 2.14
default mapping, 17.2.3.4
deployment files, 9.1, 10
Embedded annotation, 16.2.5, 21.2.1
packaging for deployment, 10
projects.xml file, 9.1.1.7, 9.1.3
sessions.xml file, 9.1.2.4
EJB descriptors, opening projects with, 116.2.1
EJB entities
CMP hot deployment, 11.7.1
deployment overview, 2.5.2
EJB 2.x indirection, 17.2.4.6
generating, 5.5.3.3
hot deployment, 11.7, 11.7.1, 11.7.2
inheritance, 16.2.3.3, 16.3.5
inserting after ejbCreate, 16.2.3.2
inserting after ejbPostCreate, 16.2.3.2
mapping, 117.5
non-CMP hot deployment, 11.7.2
non-deferred write, understanding, 16.2.3.1, 115.14.3
sequencing, 18.2.4
EJB entity beans
and EJB 1.1, 2.14, 2.15
and EJB 2.x, 2.14, 2.15
and EJB 3.0, 2.14
with BMP architecture, 1.4, 1.4, 2.15
with CMP architecture, 1.4, 1.4, 2.14
EJB Exception Factory Exceptions, A.2.10
EJB finders
about, 108.15
Call finders, 108.15.3
creating, 111.10.1
DatabaseQuery finders, about, 108.15.4
default finders, about, 108.15.2
default finders, creating, 111.10.1
EJB QL finders, about, 108.15.8
ejb-jar.xml options, 111.10.1.1
ejbSelect method, 108.15.11
ejbSelect, creating, 111.10.8
ejbSelect, using, 111.10.8
expression finders, about, 108.15.7
named query finders, about, 108.15.5
predefined, about, 108.15.1
primary key finders, about, 108.15.6
redirect finders, about, 108.15.10
redirect finders, using, 111.10.7
single-object finder return type checking, 8.9
SQL finders, about, 108.15.9
EJB Info tab, 119.18.1
EJB JAR XML Exception, A.2.23
EJB Preferences, 5.4.5
EJB QL
exceptions, A.2.8
queries, 23.4, 108.2.8.2
query language, 108.2.8.2
EJB session bean facade architecture
about, 1.4, 1.4, 2.13
understanding, 2.13
EJB Session Beans, 87.9.1.2
ejbCreate, 16.2.3.2
ejb-jar.xml file
about, 9.1.3, 19.7
corresponding to Oracle TopLink Workbench functions, 19.7
EJB finder options, 111.10.1.1
location, 117.5.1
managing, 7.2.4
preferences, 5.4.5
synchronization under EJB 2.0, 9.1.3
updating from, 19.7.2
writing, 19.7.1
ejbPostCreate, 16.2.3.2
@Embeddable, 16.2.5, 21.2.1
@Embedded, 16.2.5, 21.2.1
empty unit of work transactions, 113.2.3
encrypting login passwords, 116.3
encryption
password encryption, customizing, 97.3
Securable interface, 97.3.1
enhanced validation exceptions, 9.1.2.1
Enterprise Information Systems. see EIS
entity beans
deployment, 2.5.2
descriptor information, 16.2.3
direct mappings, 27.2.3
indirection, EJB 2.x, 17.2.4.6
sequencing with, 18.2.4
Entity Manager Setup Exception, A.2.19, A.2.22
EntityManagerSetupException, A.2.19, A.2.21, A.2.22
environment
configuring, 5.2
JAVA_HOME, 5.2
JDBC_CLASSPATH, 5.2
proxy, 5.4.1, 5.4.2, 19.7.2
error codes
1-176, A.2.1
1-176, A.2.1, A.3.1, A.3.2, A.3.4, A.3.5, A.3.6, A.3.7
200-399, A.3.3
12000-12004, A.2.11
18001-18002, A.2.13
22001-22004, A.2.15
22101-22105, A.2.16
3001-3007, A.2.3
4002-4018, A.2.4
5001-5008, A.2.5
6001-6098, A.2.6
7001-7104, A.2.7
72000-72023, A.2.19, A.2.21, A.2.22, A.2.23
8001-8010, A.2.8
9000-9009, A.2.9
ErrorCodeListener
StoredProcedureCall, and, 109.5.5
errors
about, A.2
codes and descriptions, A.2, A.3.1
descriptors, 5.3.3, 5.3.5
MaD support, A.1
migration, 8.4.2.5
Oracle TopLink Workbench, A.3
Event Manager, 87.2.5
events
about, 16.2.8, 16.2.8
client session, 87.2.5.1
database access, 87.2.5.1
Descriptor Event Listener, 119.25
domain object methods, 119.24
handlers, 16.2.8, 119.24, 119.25
listeners, sessions, 87.2.5.2
session, 87.2.5
session manager, 87.2.5.1
sever session, 87.2.5.1
types of, 119.24
unit of work, 87.2.5.1
examples
composite collection EIS mapping, 77.6
context menu, 5.3.1.2
cursored streams, 111.11.2.1
direct collection mappings, 27.10
direct-to-field mappings, 27.3
exception handler, 89.7.2
indirection, 17.2.4
inheritance, 16.3
Oracle TopLink Workbench, 5.3
performance optimization, 12.12.9.2, 12.12.9.4
proxy indirection in code, 121.3.2.5
READALL finders, 111.10.2
report query, 109.2.1.3
scrollable cursors, 111.11.1.1
serialized mapping, 17.2.6.1
transformation mapping, 27.13
transformation XML mapping, 53.9, 77.9
Unit of Work, 113.2.2, 114.6
write, write all, 109.1.2.1
exception handler
about, 87.2.9
example, 89.7.2
selecting, 89.7.1
exceptions
chained, 87.2.6.5
communication exceptions, A.2.11
conversion exceptions, A.2.3
database exceptions, 109.9, A.2.4
Default mapping exception, A.2.14
descriptor exceptions, A.2.1, A.2.1
discovery exceptions, A.2.15
EJB JAR XML exceptions, A.2.19, A.2.21, A.2.22, A.2.23
EJB QL exceptions, A.2.8
enhanced validation, 9.1.2.1
JMS processing exceptions, A.2.13
Migration utility exception, A.2.20
optimistic locking, A.2.5
query exceptions, A.2.6
remote command manager exceptions, A.2.16
selecting exception handler, 89.7.1
session loader exceptions, A.2.9
Transaction exception, A.2.17
validation exceptions, A.2.7
XML conversion exception, A.2.18
exclusive connections
about, 115.15.1.4.3
internal read connection pool, 101.6
isolated sessions, 87.5, 89.12
named queries, 119.7.1.10
existence checking, 115.1.3
descriptors, 119.17
projects, 117.7
expanding items in Navigator window, 5.3.3
expiration of objects in the cache, 117.13, 119.16
explicit query refreshes, cache coordination, 102.2.4
exporting
deployment XML, 116.3.1
Java model, 116.3.2
Java source, 19.6.1
preferences, 5.4
projects, 116.3
relational projects, 19.6
Expression Builder, 110.7.1, 110.7.2
Expression Builder dialog box, 110.7.1
Expression class, 110.1
ExpressionMath class, 110.1
expressions
about, 108.2.6, 110, 110.1
allows none, 110.7.1.1, 119.7.1.6.1
allows null, 110.7.1.1, 119.7.1.6.1
building, 110.7.1
comparing with SQL, 110.1.1
components, 110.2, 110.2
creating, 110.7
data level queries, 110.6
database functions, 110.2.2
in relationships, 110.2.7
in-memory queries, limitations, 108.16.2.2
mathematical functions, 110.2.3
multiple, 110.5
one-to-one mappings, 110.2.6
parallel expressions, 110.5.2
parameterized, 110.3
platform functions, 110.8
query keys, 110.4
subqueries and subselects, 110.5.1
user-defined functions, 110.2.5, 110.8
using Boolean logic, 110.2.1
XML Type functions, 110.2.4
see also queries
external
applications, 115.15.1.1
connection pools, 96.1.6.2
controller, transaction, 113.1
JDBC pools, 2.15.3.1
transactions, 113.1, 113.1
external transaction controller
configuration, sessions, 89.9
session, 113.1.2

F

factory name, JMS connection, 104.3
failure, resuming unit of work after commit, 115.6
features of Oracle TopLink, 1.3
fetch groups
about, 16.2.4, 119.33
configuring, 111.3.1, 119.33
default, 111.3.1, 119.33
disabling, 111.3.1
dynamic, 111.3.3
object level read query, 108.7.1.6
read optimization, and, 119.33
size, 12.12.6
static, 111.3.2
field access
about, 2.4.1.4
field references, 28.7
Field uses XML Schema "type" attribute option, 17.2.6.4
fields in database tables, 5.5.2.1
Fields tab, 37.2.1, 37.3.1
field-to-object attribute transformation, 121.15, 121.16
files
JAXB-specific, 47.1.1.2
see also specific file name
final attributes, 5.7.2.5.1, 5.7.2.9.1
finalizers
sessions, 90.8
findAll, using, 108.15.4
finders
caching options, 108.16.8.1
disabling cache, 108.16.8.2
managing large result sets, 111.11.4
refreshing results, 108.16.8.3
see also EJB finders
flashback queries
about, 108.14.3
historical client sessions, 93.1.1
forceUpdateToVersionField(), 115.11
foreign keys
about, 2.8.5, 28.7
configuring in EIS mappings, 83.2
direct collection mappings, 36.2.2
EIS mappings, 84.2
multiple tables, 23.7.1
one-to-many mappings, 27.7
one-to-one mappings, 27.5, 121.18.2
parameterized expressions, 110.3
references, A.3.4, A.3.6
target, 27.5, 28.7
troubleshooting, A.3.4, A.3.6
fragment XML mappings
configuring, 66
full identity map, 102.2.1.1

G

garbage collection, managing, 114.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
deprecated direct mappings, 20.11
see also exporting
getCatalogs(), 5.5.1.3
getField(), 110.6.1
getImportedKeys(), 5.5.1.3
getParameter, 110.3.1
getPrimaryKeys(), 5.5.1.3
getTable(), 110.6.2
getTables(), 5.5.1.3
getTableTypes(), 5.5.1.3
getValue(), 17.2.4.1, Glossary
getValue() method, 17.2.4.1, Glossary

H

hard cache weak identity map
about, 102.2.1.4
when to use, 102.2.1.7
help
about, 5.3.6
displaying, 5.3.6
Help button., 5.3.6
Help Preferences, 5.4.2, 5.4.4
hierarchical queries
about, 108.14.2
described, 111.9.2
hints, Oracle Hints in queries, 108.14.1
historical client sessions
about, 87.1, 87.6
cache, 87.10.3
limitations of, 87.6.1
historical queries, 111.2
about, 108.11
see also AsOfClause
history policy, configuring, 119.31
holders, value, 17.2.4.1, Glossary
host URL, JMS topic, 104.4
hosted
documentation, 5.4.2
XSD files, 9.1.1.1
hot deployment
about, 11.7
CMP applications, 11.7.1
non-CMP applications, 11.7.2
HSQL platform, 96.1.3.1

I

IBM Informix Database native sequencing, 18.2.2.6
IBM WebSphere
setting class loader order, 8.5.2
identity
about, 2.8.3, 102.2.1
cache, and, 102.2.1
using cache to preserve, 102.2.1
see also identity map
identity map cache
disabling during a write query, 109.2.2.3
refresh in read query, 108.16.5.3
identity maps
about, 87.8, 119.12, 119.13, 119.15
cascading refresh during read query, 108.16.5.3
descriptors, 117.10, 119.12
example, 108.16.5.3
full, 102.2.1.1
guidelines for choosing type, 102.2.1.6
hard cache weak identity map, 102.2.1.4, 102.2.1.7
isolated client sessions, 87.5.2
no identity map, 102.2.1.5
refreshing during read query, 108.16.5.3
soft, 102.2.1.3
soft cache weak identity map, 102.2.1.4, 102.2.1.7
soft cache weak identity map and read optimization, 12.12.9
specifying, 119.12, 119.13, 119.15
weak, 102.2.1.2
weak identity map and read optimization, 12.12.9
Identity tab. see Caching tab
impedance mismatch, solving, 1.2
Implementors tab, 119.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, 28.4.1, 78.3.1
independent relationships, 121.7
indexed records, 77.2.1.1
indirection
about, 2.8.10, 17.2.4, 17.2.4
bidirectional relationships, 121.18.2
choosing the correct type, 121.3
configuring, 121.3
EJB, 17.2.4.6
EJB 2.x CMP, 17.2.4.6
example, 17.2.4
many-to-many mappings, 27.8
nontransparent, 2.4.2
one-to-many mappings, 121.18.2
proxy indirection, 17.2.4.3
remote sessions, 87.9.2.4
serialization, 17.2.4.7
serialization and JPA, 17.2.4.7
transparent, 2.4.2, 17.2.4.2, Glossary
value holder, 17.2.4.1, Glossary
ValueHolderInterface, 2.4.2
see also proxy indirection, transparent indirection
Informix platform, 96.1.3.1
inheritance
about, 2.8.6, 16.2.2, 16.3, 21.3
aggregate classes, 16.3.4
aggregate collection mappings, 27.9.1
branch classes, 16.3, 16.3
child descriptors, 119.20
class extraction, 16.3.1.2, 16.3.1.2
class indicator, 16.3.1, 16.3.1.2
descriptors, 16.2.2, 16.3, 21.3, 119.20, 119.21
finding subclasses, 16.3.1
instantiating subclasses, 16.3.1
isolated client sessions, 87.5.2
leaf classes, 16.3, 16.3, 111.6
outer-join subclasses, 12.11.4
primary keys, 16.3.2, 21.3.1, 74.3.1
queries, 108.12
querying on hierarchy, 111.6
relational parent, 119.21
root class, 16.3, 16.3, 119.20.1, 119.21.1
root class subclasses, finding in inheritance, 16.3.1
supporting with multiple tables, 21.3.2.2
supporting with one table, 21.3.2.1
transformed to relational model, 12.7.3
using with EJB, 16.2.3.3, 16.3.5
inheritance hierarchies
descriptors, 16.5.1
querying on, 111.6
Inheritance tab, 119.20.1, 119.21.1
inherited subclasses, mapping, 119.23
in-memory query
about, 102.2.2
check cache using exact primary key, 108.16.2.1
check cache using primary key, 108.16.2.1
check database if not in cache, 108.16.2.1
conform results in unit of work, 108.16.2.1
expression limitations, 108.16.2.2
supported, 108.16.2.1
using, 108.16.2.1
inner join, 110.2.7.1
insert operation, 109.1.2.1, 109.1.2.3
insertObject(), 23.4.1
instantiation policy
about, 119.28
setting, 119.28.1
Instantiation tab, 119.28.1
integrity checker, 118.2
about, 87.2.8
configuring, 89.11
interactions
about, 109.8
creating, 76.5
interface alias
about, 23.5
creating, 23.5
Interface Alias tab, 23.5.1
interfaces
classes, implementing, 5.7.2.3
customizing, 5.4.1
descriptors, 22.2.1.3, 119.10, 119.11
queries, 108.12
query keys, 119.10
querying on, 111.5
internal connection pool
about, 96.1.6.1
named, 96.1.6.5
read, 96.1.6.3
sequence, 96.1.6.4
write, 96.1.6.3
internal query object cache
about, 108.16.7
configuring, 111.13.1, 111.13.2
expiration, 111.13.2
restrictions, 108.16.7.1
internal transactions, 113.1
invalidation of objects in the cache, 102.2.5, 117.13, 119.16
IP address for multicast group, 103.4
isolated client sessions
about, 87.1, 87.5, 92
configuration, 92.1
life cycle, 87.5.1.3
limitations of, 87.5.2
session event handlers, 87.5.1
with Oracle Virtual Private Database (VPD), 87.5.1
isolated session
cache, 87.10.2
ConnectionPolicy, 87.5
exclusive connections, 87.5
supported databases, 87.5
isolation
cache, 102.2.3
transaction levels, 113.1
unit of work transactions, 113.1.3
Iterator interface, 111.11.1

J

Java
database tables, 19.6.2
exporting to, 19.6.1
integration with any datasource, 1.2
iterators, 111.11.1
object model, 2.4
Java applications
deploying, 11.1
deployment files, 9.2
packaging for deployment, 10.1
Java Cryptography Extension, 116.3
Java EE
parameter binding, 12.11.5
prepared statement caching, 12.11.5
web applications, 1.4
Java Management Extensions. see JMX
Java Naming and Directory Interface. See JNDI
Java Object Builder, 87.2.1.4
Java streams
described, 111.11.2
optimizing, 111.11.3
support for, 111.11.2.1
Java Transaction API
and unit of work commit, 113.2.6.1, 113.2.6.1.1
and unit of work rollback, 113.2.6.2.1
see also JTA
Java Transaction Service see JTA
JAVA_HOME, 5.2
javaagent, 2.10.1
JAVA-EE-CONTAINER-ejb-jar.xml file, 9.1.4
java.util.Collection interface, 121.14
java.util.Map interface, 121.14
java.util.Set interface, 121.14
javax.ejbEntityBean interface, 5.5.3.3
JAXB
creating projects from, 48.2.1
files, 47.1.1.2
generating project from the command line, 48.2.2
jaxb:class, and EIS mappings, 77.2.4
jaxb:class, and XML mappings, 53.2.6
proxy configuration, 48.2.2
tljaxb.cmd, 48.2.2
tljaxb.sh, 48.2.2
typesafe enumeration converter, 121.13
understanding, 47.1.1
validation, 47.1.2
XML projects, 47.1.1
JAXB typesafe enumeration converter
configuring, 121.13
understanding, 17.2.10
JAXBContext, 47.1.1.3.4
JCA adapters
about, 96.1.3.2
configuring for Oracle TopLink Workbench, 5.2
EISLogin, 96.1.2.1
selecting, 96.1.3.2
with EIS, 116.1.2.1
JCE. see Java Cryptography Extension
JConnect, 12.11.1
JDBC
adaptor for EIS, 77.2.7
database gateway for EIS, 77.2.7
driver classpath, 5.5.1.3
JConnect, 12.11.1
Sybase JConnect, 12.11.1
JDBC drivers
about, 96.1.3.1
configuring for Oracle TopLink Workbench, 5.2
fetch size, 12.11.1, 12.12.6
general properties, 12.11.1
mapping LOBs, 120.5
selecting, 96.1.3.1
JDBC pools
external with EJB Entity Beans with BMP architecture, 2.15.3.1
JDBC_CLASSPATH, 5.2
JMS
connection factory name, 104.3
coordinated cache, 104
coordinated cache, connection handling, 104.5
coordinated cache, error receiving message, 104.5
coordinated cache, ERROR_RECEIVED_JMS_MESSAGE_IS_NULL, 104.5
coordinated cache, ERROR_RECEIVING_JMS_MESSAGE, 104.5
coordinated cache, null JMS message, 104.5
Processing Exceptions, A.2.12, A.2.13
topic host URL, 104.4
topic name, 104.2
JMX
about
and DMS profiler
DMS profiler, 12.4.2
JNDI naming service, 103.7
joining
about, 108.7.1.5
addJoinedAttribute, 109.2.1.10.1
expressions, and, 110.2.7
inner joins, 110.2.7.1
mappings, and, 28.8
ObjectLevelReadQuery, 109.2.1.10
ObjectLevelReadQuery, and, 109.2.1.10.1
one-to-many, 109.2.1.10.1
one-to-many, filtering duplicates, 109.2.1.10.1
one-to-many, when not to use, 108.7.1.5.1
one-to-one, 109.2.1.10.1
optimizing reads, 12.12.9
outer-join inherited subclasses, 12.11.4
QueryManager expressions, 111.7
read queries, 12.12.9, 109.2.1.10
reading and object-level read queries, 108.7.1.5
reference mappings, 28.8
setAdditionalJoinExpression(), 111.7.1
setMultipleTableJoinExpression(), 111.7.1
use inner join, 108.7.1.5, 109.2.1.10.1
use outer join, 108.7.1.5, 109.2.1.10.1
JPA
indirection and serialziation, 17.2.4.7
schema generation, 6.4.1
schema manager, 6.4.1
serialization and indirection, 17.2.4.7
JPQL, 109.2.7
JSP and Servlet applications
deploying, 11.2
deployment files, 9.3
packaging for deployment, 10.2
JTA
about, 113.1.2.1
and unit of work, 113.1.2.1
isolated client sessions, 87.5.2
unit of work, 113.1
JTA/JTS
using with EJB Entity Beans with BMP architecture, 2.15.3.2
just-in-time reading. See indirection

K

Key Converter tab, 38.4.1
key pairs
database table reference, 5.5.2.4
troubleshooting, A.3.4, A.3.6
keys
about, 2.8.3
composite primary, 121.18.2
foreign, 2.8.5, 27.5, 121.18.2
foreign, target, 27.5
inheritance, 16.3.2, 21.3.1, 74.3.1
multiple tables, 23.7
primary, 16.3.2, 21.3.1, 23.7, 27.6, 27.8, 32.3.3, 74.3.1, 121.2, 121.18.2
read-only settings, 121.2
reference key field, 27.10, 27.11
variable class relationships, 27.6, 32.3.3

L

language, specifying, 5.2.1
large result sets, managing in finders, 111.11.4
lazy attribute loading and read optimization, 119.33
lazy connection
acquisition, 89.12
allocation, 87.3.2.6, 90.4.5
lazy loading
See fetch groups
See indirection
lazy reading. See indirection
leaf classes, 16.3, 16.3, 111.6
life cycle of unit of work, 113.2.2
LOB
mapping to, 120.5
local
documentation, 5.4.2
transactions, 115.14.2
locked files, 7.2.5
locking policy
AllFieldsLockingPolicy, 16.4.4
ChangedFieldsLockingPolicy, 16.4.4
configuring, 119.26
field locking, 16.4.4
optimistic, 16.2.11, 16.4.2, 16.4.4
optimistic version locking, 16.4.1
optimistic version locking, stored function restrictions, 16.4.1
optimistic version locking, stored procedure restrictions, 16.4.1, 109.5.4
OptimisticLockException, 16.4.1, 16.4.4
pessimistic locking policy, 16.2.11, 16.4.5
SelectedFieldsLockingPolicy, 16.4.4
stale data, and, 102.2.3.1
three-tier architectures, optimistic locking and, 16.4.6.1
three-tier architectures, pessimistic locking and, 16.4.6.2
TimestampLockingPolicy, 16.4.1
understanding, 16.2.11, 16.4
version locking, 16.4.2
VersionLockingPolicy, 16.4.1
Locking tab, 119.26.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, 87.2.6.1.3
chained exceptions, 87.2.6.5
configuring, non-Oracle Java EE container, 89.4.4
configuring, TopLink Workbench, 89.4.1
configuring, using java.util.logging, 89.4.5
configuring, using Oracle Enterprise Manager, 89.4.3
configuring, using Session API in Java, 89.4.2
java.util.logging, 87.2.6.1.2
log level, 87.2.6.3
logging.properties file, 87.2.6.7
MaD, configuration with Oracle Enterprise Manager, A.1.1
MaD, in-container defaults, A.1.1
MaD, out of container defaults, A.1.1
non-Oracle, in-container defaults, 87.2.6.6
out of container defaults, 87.2.6.7
output, 87.2.6.2
permissions, 8.8.1.5
sessions, 87.2.6, 89.4, 89.4.1
TopLink native logging, 87.2.6.1.1
types, 87.2.6.1
Logging tab, 89.4.1
logging.properties file, 87.2.6.7
login
CMP deployment, 15.2.4.2
database, 20.4.1, 20.6, 98
deployment, 15.2.4.2
development, 15.2.4.3, 15.2.4.3
platforms, and, 15.2.5
projects, and, 15.2.4, 86.1.2, 96.1.2
role in project, 15.2.4, 96.1.2
session, 15.2.4.1, 89.3
session role, non-CMP, 15.2.4.1
logMessages method, 87.2.6
look and feel, specifying, 5.4.1

M

MaD
about, A.1
DMS, about, A.1.2
DMS, TopLink instrumentation, 12.4
integrating with, 8.4.4
JMX, about, A.1.3
logging, about, A.1.1
logging, configuration with Oracle Enterprise Manager, A.1.1
logging, in-container defaults, A.1.1
logging, out of container defaults, A.1.1
Manage Non-Descriptor Classes dialog, 5.7.4
Manageability and Diagnosability. see MaD
management, source control, 7.2.1
manager, session events, 87.2.5
many-to-many mappings
relation table, 27.8
relation tables, 34.2
session broker limitations, 87.7.3.1
many-to-many relational mappings
configuring, 34
EJB, 27.8.1
understanding, 27.8
mapped records, 77.2.1.2
mapping extensions
custom data types, 13.2
JAXB typesafe enumeration converter, 17.2.10, 121.13
object type converter, 17.2.6.3, 121.11
serialized object converter, 17.2.6.1, 121.9
simple type translator, 17.2.6.4, 121.12
transformation mappings, 17.2.6.5
type conversion converter, 17.2.6.2, 121.10
mappings
about, 2.8, 2.8.4, 14, 14.1.3, 14.1.3, 17, 17, 120.1
access types, 121.6.1
aggregate collection mappings and EJB, 27.9.2
anyType mapping, 54.4
as part of the application development process, 2.9.2.1
automatic, 120.3
batch options, 28.5.1
bidirectional relationships in Java, 121.18.2
CDATA, 121.20
class hierarchy, 17.3
comments, 121.8
configuring, 120.2, 121, 121.1
database field, 28.3.1
default mapping, 17.2.3.4
deprecated, generating, 20.11
direct access, 12.8, 121.6
directionality, 27.2.1
EIS mappings, 17.7, 71.1, 77, 77.1, 78
EJB 2.0 entities, 117.5
errors, A.3.4
example, 17.2.2
extensions, about, 17.2.6
hierarchy, 17.3
inactive descriptors, 28.4.1, 78.3.1
indirection, 12.8, 17.2.4, 121.3
isolated client sessions, 87.5.2
manually configuring, 120.2
many-to-many, 27.8.1
many-to-many, with EJB, 27.8.1
method access, 121.6, 121.16.1
null values, 121.5, 121.19
object-relational data type, 40, 41
one-to-many object, with EJB, 27.7.1
one-to-one with EJB, 27.5.1
optimizing, 12.8, 12.8
OX mappings, 17.6
projects, and, 14.1.3
read-only, 121.2, 121.2.1
relation tables, 34.2, 34.2
relational, 27, 28
removing, 120.6.1
to tables, 23.2.1, 119.2.1
TopLink Workbench, Navigator window, 5.3.3
types of, 17, 17.1
use inner join, 108.7.1.5, 109.2.1.10.1
use outer join, 108.7.1.5, 109.2.1.10.1
XML mappings, 53, 53.1, 54
mathematical functions, in TopLink expressions, 110.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, 115.5
Oracle TopLink Workbench project files, 7.2.2
project files, 7.2.2.1
messages, error, A.2, A.3.1
metadata
about, 2.4.3.1, 2.9
advantages, 2.9.1
creating, 2.9.2, 2.9.3
mapping and configuration, 14
project metadata, 2.9.2
session metadata, 2.9.3
Metalink, 2.1.2
method access
about, 2.4.1.4, 117.4, 121.6
change tracking limitations, 2.4.1.4, 117.4, 121.6
setting, 121.16.1
methods
adding, 5.7.2.8
getValue(), 17.2.4.1, Glossary
setValue(), 17.2.4.1, Glossary
wrapper policy, 119.32.1
see also specific method name
Microsoft Access
platform, 96.1.3.1
schema manager type conversion, 6.1.1
Microsoft SQL Database native sequencing, 18.2.2.6
migrating
error messages, 8.4.2.5
OC4J persistence to TopLink, 8.4.2
Oracle TopLink Workbench projects, 116.2.1
troubleshooting, 8.4.2.5
Migration Utility Exception, A.2.20
model source, exporting, 116.3.2
modifiers, class, 5.7.2.2
multicast group address, coordinated cache, 103.4
multicast port, coordinated cache, 103.5
multiple sessions, 87.7.4.2, 87.7.4.2, 90.1.2
multiple tables
about, 23.7
specifying for descriptors, 23.7
multiplicity in relationships, resolving, 8.4.2.5
multi-processing, 12.12.10.1.4
Multitable Info tab, 23.7.1, 119.19.1
mutability
about, 2.8.11
change policy, 113.2.3.4, 119.30
change tracking performance, 2.8.11
defaults, 2.8.11
EIS transformation mapping, and change policy, 113.2.3.4
transformation mapping, and change policy, 113.2.3.4
transformation mappings, 121.17
transformation mappings, and copy policy, 2.8.11, 113.2.3.4, 121.17
weaving, 2.8.11
mutable mappings, 121.17
.mwp file, 5.1, 116.1.2
MySQL4
batch writing, 98.6
platform, 96.1.3.1
primary key restrictions, 18.2
schema manager type conversion, 6.1.1, 6.1.1

N

named connection pools, 96.1.6.5
named queries
about, 89.13, 108.8, 119.7
configuring, 89.13, 119.7
descriptor level, 119.7
exclusive connections, 119.7.1.10
options, advanced, 119.7.1.10
parameter binding, 119.7.1.9
prepared statement caching, 119.7.1.9
redirect query, 108.8
session level, 89.13
using, 109.3
when not to use, 108.8
when to use, 108.8
namespaces
about, 15.2.7, 15.4
configuring, 5.6.5
naming service
coordinated cache, 103.6
JNDI, 103.7
RMI, 103.8
native batch writing, 12.11.3, 98.6.1
native sequencing
IBM Informix Database, 18.2.2.6
Microsoft SQL Database, 18.2.2.6
Microsoft SQL Server, 6.2.3.4
non-Oracle database, 18.2.2.6
Oracle Database, 18.2.2.5, 18.2.3
Oracle Database SEQUENCE object, 18.2.2.5.2
Sybase Database, 6.2.3.4, 18.2.2.6
native SQL, 98.6.1
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, 17.2.6.2
NCLOB, 17.2.6.2
neediness warnings. See troubleshooting
nested table object-relational data type mappings
configuring, 46
understanding, 40.1.5
nested unit of work, 113.2.5, 115.8.2
new projects, 116.1.2.1
New Reference dialog box, 5.5.2.3
New Session button, 88.4.1, 88.5.1, 88.6.1
New Sessions Configuration, 88.2.1
New Table dialog box, 5.5.1.2
newInstance method, 115.1.1
no identity map, 102.2.1.5
non-cascading write queries
compared to cascading, 108.7.3.7, 109.2.2.2
creating using dontCascadeParts () method, 108.7.3.7, 109.2.2.2
non-deferred write
configuring, 115.4.4.1
dependent objects, 16.2.3.1
understanding, 16.2.3.1, 115.3, 115.14.3
nonintrusive persistence, 2.8.9
nonpersistent projects, 15.2.3
nonrelational projects, 15.2.2
nontransactional data sources, 96.1.1
nontransparent indirection, 2.4.2
nouns
DMS profiler, 12.4, 87.2.7.2
null values
default, 97.6, 121.5, 121.19
in expressions, 110.7.1
login level, 97.6
mapping level, 121.5
NVARCHAR2, 17.2.6.2

O

object array object-relational data type mappings
configuring, 45
understanding, 40.1.4
object cache, 108.16.7
object cache, sessions, 87.2.1.1
object change tracking
configuring, 119.30.1.2
object identity, 87.8
about, 2.8.3, 102.2.1
cache, and, 102.2.1
using cache to preserve, 102.2.1
see also identity map
object indirection
read optimization, as, 12.12.9
object level modify query
about, 108.7.3, 108.7.4
object level read query
about, 108.7.1, 108.7.2
addJoinedAttribute, one-to-many mappings, 109.2.1.10.1
addJoinedAttribute, one-to-one mappings, 109.2.1.10.1
fetch groups, 108.7.1.6
join reading, 108.7.1.5
joining one-to-many mappings, 109.2.1.10.1
joining one-to-many mappings, filtering duplicates, 109.2.1.10.1
joining one-to-one mappings, 109.2.1.10.1
partial object query, 108.7.1.3
read all query, 108.7.1.2
read object query, 108.7.1.1
setShouldFilterDuplicates, one-to-many mappings, 109.2.1.10.1
object model
about, 2.8.1
generating with tljaxb.cmd, 48.2.2
optimization, 12.7
Oracle TopLink requirements, 2.4
object reference XML mappings
configuring, 62
object type converter
about, 13.2, 17.2.6.3
configuring, 121.11
object type mappings
configuring, 121.11, 121.11.1
ObjectLevelChangeTrackingPolicy, 113.2.3.2
object-relational data type descriptors
configuring, 26
locking policy, 119.26
understanding, 24.1
object-relational data type mappings
about, 40
array, understanding, 40.1.3
configuring, 41
nested table, 40.1.5, 46
object array, 40.1.4, 45
overview, 2.8
reference, 40.1.2, 43, 44
structure, 40.1.1, 42
object-relational data type projects
about, 18.1.2
sequencing, 15.2.6
objects
cascading refresh in cache, 108.16.5.2
creating and registering, 115.1.1
query, 109.2.1.4
refreshing in cache, 108.16.5.1
registering and unregistering, 115.1
ObjectTypeMapping
see ObjectTypeConverter
one-to-many EIS mappings
configuring, 84
key on source, 77.8.1
key on target, 77.8.2
understanding, 77.8
one-to-many relational mappings
configuring, 33
understanding, 27.7
one-to-one EIS mappings
configuring, 83
key on source, 77.7.1
key on target, 77.7.2
understanding, 77.7
one-to-one relational mappings
configuring, 31
expressions, 110.2.6
understanding, 27.5
with EJB, 27.5.1
online help, 5.4.2
Open Project button, 116.2.1
opening projects, 116.2.1
operators
boolean logic, 110.2.1
optimistic locking
about, 16.2.11
application architecture, 2.3.5.1
cascading locking policy, 16.4.2, 119.26.2.2
database exception, 109.9
exceptions, A.2.5
field locking policy, about, 16.4.4
rollbacks, 16.4.3
version locking policy, 16.4.1, 16.4.2, 119.26.2.2
version locking policy, stored function restrictions, 16.4.1
version locking policy, stored procedure restrictions, 16.4.1, 109.5.4
with forceUpdateToVersionField() method, 115.11
optimistic locking policy
field locking, about, 16.4.4
version locking, 16.4.1, 16.4.2, 119.26.2.2
version locking, stored function restrictions, 16.4.1
version locking, stored procedure restrictions, 16.4.1, 109.5.4
OptimisticLockException, 16.4.1, 16.4.4
optimization
about, 12, 12.1
application bottlenecks, 12.2
application server, 12.15
batch reading, 12.12.3
batch writing, 12.11.3
CMP partial object queries, 12.12.4
code generation, 12.5
cursored streams, 12.12.7
data access, 12.11, 12.11.2
data format, 12.11.2
database, 12.15
descriptors, 12.8, 12.8
DMS profiler, 12.4, 87.2.7.2
existence checking, 12.8
fetch groups, 12.12.4
fetch size, JDBC, 12.12.6
general, 12.5
inheritance, 21.3.2.2
instantiation, 12.8
JDBC driver, 12.11.1, 12.12.6
join reading, 12.12.3
mappings, 12.8, 12.8
named queries, 12.12.2
object model, 12.7
outer-join inherited subclasses, 12.11.4
overview, 2.6
pagination, 12.12.8
parameter binding, 12.11.5
parameterized SQL, 12.12.1
partial object queries, 12.12.4
prepared statement, 12.12.1
prepared statement caching, 12.11.5
profiler, 12.4, 87.2.7.2
optimization, 12.3
queries, 12.12
reading, 12.12.9
read-only queries, 12.12.5
read-only query, 12.12.5
ReadQuery method setMaxRows, 12.12.6
result set pagination, 12.12.8
schema, 12.7
scrollable cursors, 12.12.7
setMaxRows, 12.12.6
understanding, 12.1
unit of work, 12.13
weaving, 12.14
writing, 12.12.10
Oracle
development support, 2.1.2
remote session support, 87.9.1.2
Oracle Containers for J2EE
migrating to TopLink, 8.4.2
Oracle Database
date and timestamp mappings, 28.3
native sequencing, 18.2.3
Oracle Database, 18.2.2.5.2
platform, 96.1.3.1
schema manager type conversion, 6.1.1
Oracle extensions
hierarchical queries, 111.9.2
Oracle Hints, 111.9.1
Oracle Hints, using with TopLink queries, 111.9.1
Oracle JDeveloper
configuring with Oracle TopLink, 7.1
Oracle TopLink
about, 1, 1, 5.1
application architectures, 1.4
architectures, 1.1
development, 2, 2.1, 3
features, 1.3
integrating with application server, 8, 8.2.1
mapping types, 17.1
optimization, 12.1
packaging your application, 10
public source, 13.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, 19.1, 48.1, 72.1, 116.1
development process, 5.1
DRIVER_CLASSPATH, 5.2
environment, 5.2
error messages, A.3, A.3.2
JDBC_CLASSPATH, 5.2
parts of, 5.3
preferences, 5.4
project, 5.1, 116.1.2
proxy, 5.4.1, 5.4.2, 19.7.2
sample, 5.3
table creator, creating, 6.2.1
upgrading projects, 116.2.1
Oracle Virtual Private Database (VPD)
isolated client sessions, 87.5.1
proxy authentication, 87.5.1.1, 96.1.4.2, 98.8
oracle.sql.TimeStamp, 28.3
order
query keys, 28.6
relational mappings, 28.6
OrderSibling, 111.9.2.3
orion-ejb-jar.xml file, 9.1.4.2
about, 9.9
entity-deployment attribute pm-name, 9.9.1
modifying for Oracle TopLink, 9.9
persistence-manager attribute class-name, 9.9.1
persistence-manager attribute descriptor, 9.9.1
persistence-manager attribute name, 9.9.1
persistence-manager subentry forpm-properties
cache-synchronizations, 9.9.1.1
customization-class, 9.9.1.1
db-platform-class, 9.9.1.1
default-mapping, 9.9.1.1
project-class, 9.9.1.1
remote-relationships, 9.9.1.1
session-name, 9.9.1.1
OTN (Oracle Technology Network), 1.3, 2.1.2
OTS (Object Transaction Service)
about, 113.1.2.2
unit of work, 113.1.2.2
outer joins
inheritance, 119.19
OX mappings
about, 17.6, 17.7
extensions, simple type translator, 17.2.6.4.1, 17.2.6.4.2
read conversions, 17.2.6.4.1
write conversions, 17.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
JPA application for weaving, 10.4
POJO application for weaving, 2.10.4, 10.5
packaging for deployment
about, 10
BMP applications, 10.7
CMP applications, 10.6
EJB 3.0, 10
Java applications, 10.1
JSP and Servlet applications, 10.2
Session Bean applications, 10.3.1
packet time-to-live cache coordination, 103.12
pagination, 111.13
parallel
expressions, 110.5.2
unit of work, 113.2.5
parameter binding
about, 12.11.5
byte arrays, 12.11.5
configuring, 20.7, 98.6, 109.2.9, 119.7.1.9
database login level, 98.6
descriptor level, 119.7.1.9
external connection pools, 12.11.5
internal connection pools, 12.11.5
Java EE, 12.11.5
named queries, 119.7.1.9
optimizing, 12.11.5
project level, 20.7
queries, 109.2.9
streams, 12.11.5
strings, 12.11.5
trouble shooting, 12.11.5
parameterized batch writing
about, 12.11.3
setMaxBatchWritingSize(), 12.11.3
parameterized expressions
about, 110.3
example, 110.3.1
parameterized SQL
enabling on queries, 109.2.9
Oracle TopLink optimization features, 12.12.10
See also parameter binding
parser conflicts, XML, 8.2.2
partial object reading optimization, 12.12.9
password encryption
customizing, 97.3
passwords, encryption, 116.3
performance optimization
about, 12.1
application bottleneck, 12.2
examples, 12.12.9.1
JConnect method isClosed, 12.11.1
using Performance Profiler, 12.3
Performance Profiler
about, 12.3
class, 12.3.1
persistence
about, 2.8.9
by reachability, 114.5
components of, 2.4.3
descriptor, 9.8
implementation options, about, 2.4.1
implementation options, JPA annotations, 2.4.1.1
implementation options, JPA metadata, 2.4.1.1
implementation options, JPA XML, 2.4.1.1
implementation options, method and direct field access, 2.4.1.4
implementation options, TopLink metadata Java API, 2.4.1.3
implementation options, TopLink metadata XML, 2.4.1.2
implementation options, weaving, 2.4.1.5
manager, 8.2.4
OC4J, 8.4.2
projects, 15.2.3
types, 117.5
using a persistence layer, 2.4.4
persistence manager
default, 8.2.4
migration, 8.2.4
restrictions, 8.2.4
persistent classes
project, 5.5.3.3
requirements, 2.4, 2.4, 2.4.2, 2.4.2
types, 117.5.1
pessimistic locking
about, 16.2.11, 16.4.5
application architecture, 2.3.5.2
policy, 16.4.5
phantom reads, preventing, 115.15.5
platforms
Attunity Connect database, 96.1.3.1
Cloudscape database, 96.1.3.1
data source, 96.1.3
database, 20.2, 73.2, 96.1.3.1, 98.2, 99.2, 116.1.2.1
DB2 database, 96.1.3.1
EIS, 96.1.3.2
functions in expressions, 110.8
HSQL database, 96.1.3.1
Informix database, 96.1.3.1
JCA adapter, 96.1.3.2
JDBC drivers, 96.1.3.1
Microsoft Access database, 96.1.3.1
MySQL4 database, 96.1.3.1
Oracle database, 96.1.3.1
Oracle8 database, 96.1.3.1
Oracle9 database, 96.1.3.1
parser, XML, 8.2.2
PointBase database, 96.1.3.1
projects, and, 15.2.5
server, 89.9.1
session configuration, 89.9.1
SQLAnyWhere database, 96.1.3.1
SQLServer database, 96.1.3.1
SybasePlatform database, 96.1.3.1
XML parser, 8.2.2
see also target platforms
PointBase platform, 96.1.3.1
pop-up menus. see context menus
ports
multicast group, 103.5
permissions, 8.8.1.3, 8.8.1.4
post-commit clones, avoiding, 115.16.1
Potential EJB Descriptors dialog box, 116.2.1
pre-allocating sequence numbers, 18.2.3, 20.3.1, 98.4.1, 99.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, 12.11.5
configuring, 20.7, 98.6, 109.2.9, 109.2.9, 119.7.1.9
database login level, 98.6
descriptor level, 119.7.1.9
external connection pools, 12.11.5
internal connection pools, 12.11.5
Java EE, 12.11.5
named queries, 119.7.1.9
optimizing, 12.11.5
project level, 20.7
queries, 109.2.9
query level, 109.2.9
preserving XML documents, 52.5
primary key
about, 2.8.3
cache, 108.16.3
composite, 27.8, 121.18.2
inheritance, 16.3.2, 21.3.1, 74.3.1
multiple tables, 23.7
primkey in ejb-jar.xml file, 19.7
queries with compound, 108.16.3
read-only settings, 121.2
restrictions, 18.2
setting, 5.5.2.2, 23.2.1, 119.2.1
unit of work, 113.2.7
unknown, 119.18.1
variable class relationships, 27.6, 32.3.3
private relationships, 121.7
Problems window
about, 5.3, 5.3.5
sample, 5.3.5
see also error messages
profiler
about, 89.6
development tool, 12.3
DMS, 12.4, 87.2.7.2
Oracle TopLink, 12.3, 12.3.1, 87.2.7.1
selecting, 89.6.1, 89.8.1, 89.10.1, 89.12.1
Project - Multiple Projects tab, 89.5.1
Project Status Report dialog box, 116.2.3
projects
about, 14.1.1, 15, 15.2, 116.1.2
architecture, 15.2.1
cache type and size, 117.10, 119.12
comments, 117.14
configuring, 117
copying objects, 7.2.3
creating, 19.1, 48.1, 48.2.1, 72.1, 116, 116.1, 116.1.2.1, 116.1.3
deployment login, and, 15.2.4.2
deployment overview, 2.5.2
descriptors, 14.1.2
development login, and, 15.2.4.3
direct access to mapped fields, 117.4
EIS, 71.1, 71.1, 72.2, 72.3, 72.3, 73
errors, A.3.2
existence checking, 117.7
exporting, 116.3, 116.3.2
for sessions, 89.5
indexed records, 72.3
Java, 116.1.3
JAXB, 48.2.1
locked, 7.2.5
login, 15.2.4, 86.1.2, 96.1.2, 96.1.2
login, and, 15.2.4
mapped field access, default, 117.4
mapped records, 72.3
mapping projects, creating, 116.1.2.1
mappings, 14.1.3, 116.1.2.1
merging, 7.2.2, 7.2.2.1
metadata, 2.9.2
method access to mapped fields, 117.4
model, exporting, 116.3.2
.mwp file, 5.1
nondescriptor classes, 5.7.4
non-persistent, 15.2.3
nonrelational, 15.2.2
object-relational data type, types supported, 18.1.2
open, 116.2.1
Oracle TopLink Workbench, 116.1.2
packages, renaming, 5.7.5
persistence type, 15.2.3, 117.5.1
platforms, and, 15.2.5
prior TopLink versions, 116.2.1
recently opened, 116.2.1
relational, 15.2.2, 18, 18.1, 18.1.1, 18.1.2, 20
renaming, 116.2.2.1
reopening, 116.2.1
saving, 116.2.2
sequencing, 15.2.6, 15.2.6, 15.2.6, 15.2.6, 15.2.6, 20.3, 98.4
session login, and, 15.2.4.1
sharing, 7.2.3
status report, 116.2.3, 116.2.3
team development, 7.2
TopLink Workbench, Navigator window, 5.3.3
types of, 15.1, 16.1, 116.1.2
updating from ejb-jar.xml, 19.7.2
upgrading from 2.x or 3.x, 116.2.1
writing ejb-jar.xml file, 19.7.1
XML, 47.1, 49
XML records, 72.2
projects.xml file
about, 9.1.1
EJB 3.0, 9.1.1.7, 9.1.3
propagation mode, cache, 103.2
proxies. see wrapper policy
proxy authentication
about, 96.1.4.2
applications, 96.1.4.2
Oracle Virtual Private Database, 87.5.1.1, 96.1.4.2, 98.8
session events, 87.2.5
use cases, 96.1.4.2
proxy indirection
about, 17.2.4.3, Glossary
example, 121.3.2.5
restrictions, 17.2.4.3.1
proxy settings, preferences, 5.4.1
public source code, 13.3

Q

qualified names, database tables, 5.5.1.3, 5.5.1.3
queries
about, 108
application development process, 2.4.3.4, 86.1.4
building, 108.3
cache, 108.16
Call queries, 108.2.1, 108.9
cascading, 108.7.3.7, 109.2.2.2
concepts, 108.2
conforming, 115.4
database queries, 108.7, 109.2
DatabaseQuery, 108.2.2
descriptor query manager, 108.2.5
EIS interactions, 108.2.8.5
EJB finders, 108.15
EJB QL query language, 108.2.8.2
ejb-jar.xml file, 23.4, 76.5, 119.7
executing, 108.4
expressions, 108.2.6
fetch groups, 108.7.1.6
flashback queries, 93.1.1, 108.14.3
hierarchical queries, Oracle extensions, 108.14.2
hints, Oracle extensions, 108.14.1
historical, 108.11, 111.2
interface and inheritance queries, 108.12
joining, 108.7.1.5, 108.7.1.5
languages, about, 108.2.8
named queries, 108.8
object level modify query, 108.7.3, 108.7.4
object level read query, 108.7.1, 108.7.2
on inheritance hierarchies, 111.6
on interfaces, 111.5
optimizing, 12.12
Oracle database features, 111.9
Oracle extensions, 108.14, 108.14.1, 108.14.2, 108.14.3, 108.14.4
pagination, 111.13
parameter binding, 109.2.9
partial object query, 108.7.1.3
performance, 12.12
prepared statement caching, 109.2.9
query keys, 108.2.7
read all query, 108.7.1.2
read object query, 108.7.1.1
read-only, about, 108.7.1.4
read-only, configuring, 111.4
read-only, optimization, 12.12.9
redirect queries, 108.10
remote sessions, 87.9.2.2
report, 12.12.9.1.2, 108.5.2
report query, 108.7.5
result set pagination, 111.13
results, 108.5
returning policy, 108.9.1
session queries, 108.6, 109.1
SQL query language, 108.2.8.1
stored functions, Oracle extensions, 108.14.4
subqueries, 110.5
summary queries, 108.2.4
timeout, 109.2.1.8, 119.7.1.10, 119.8
types, 108.1
UpdateAll, 108.7.3.5
XML query language, 108.2.8.4
Queries tab, 119.8.1, 119.9.1
query by example, 109.2.1.4
query cache, 108.16.7
Query Exception, A.2.6, A.2.6
query keys
about, 108.2.7, 119.10, 119.11
adding, 119.10.1, 119.11.1
and expressions, 110.4
creating, 119.10.1, 119.11.1
direct mappings, 119.10
generating, 119.10
in expressions, 110.4
interface descriptors, 119.10, 119.11
Java implementation, 119.10.2
modifying, 119.10
order, 28.6
relationship mappings, 119.10
specifying, 119.10.1, 119.11.1
unmapped attributes, 119.10, 119.10, 119.10
Query Keys tab, 119.10.1
query object query. See DatabaseQuery
query objects
batch reading, 109.2.1.9
cache expiration, 111.13.2
caching results, 108.16.6, 111.13.1
examples, 109.2.1.1, 109.2.1.1
ordering for ReadAll queries, 109.2.1.5
report query, 12.12.9.1.2
specifying collection class, 109.2.1.6
query results
about, 108.5
caching, 108.16.6
collections, 108.5.1
cursors, 108.5.3
reports, 108.5.2
streams, 108.5.3
query timeout example, 109.2.1.8
QueryManager
about, 16.2.9
joining expressions, 111.7
QuerySequence, 98.4.2.3

R

read access
providing in sessions, 87.3.2.2
read all operation, 109.1.1.2, 109.1.1.2
read conversions
simple type translator, 17.2.6.4.1
read operation, 109.1.1.1
read optimization
about, 12.12.9
batch reading, 12.12.9
fetch groups, 119.33
joining, 12.12.9
lazy attribute loading, 119.33
object indirection, 12.12.9
partial object reading, 12.12.9
read-only query, 12.12.9
report query, 12.12.9
soft cache weak identity map, 12.12.9
unit of work, 12.12.9
weak identity map, 12.12.9
read queries
cascading refresh of identity maps, 108.16.5.3
identity map cache refresh, 108.16.5.3
refreshing identity maps, 108.16.5.3
ReadAll finders
executing, 111.10.2
ReadAll queries
ordering in query objects, 109.2.1.5
readAllObjects()
about, 23.4.1
example, 109.1.1.2
reading
ejb-jar.xml, 19.7.2
just-in-time reading, 17.2.4.2, Glossary
whole XML documents, 30.2
reading through the write connection, 115.15.1.4
read-locking, 16.2.11
readObject()
example, 109.1.1.1
read-only
descriptors, 119.3
files, 7.2.5
mappings, 121.2, 121.2.1
queries, configuring, 111.4
queries, optimization, 12.12.9
read-only queries
about, 108.7.1.4
read-only query
read optimization, and, 12.12.9
recently opened projects, 116.2.1
redirect queries
about, 108.10, 111.1
creating, 111.1.1
finders, 111.10.7
using, 111.10.7
reference key field, 27.10, 27.11
reference object-relational data type mappings
configuring, 43, 44
understanding, 40.1.2
reference relational mappings
joining, 28.8
ReferenceMapping class, 40.1.2
references
database tables, 5.5.2.3, 5.5.2.4
foreign keys, A.3.4, A.3.6
Refresh from Database button, 5.5.1.6
refresh policy
cache, 102.2.4.1
EJB finders, 102.2.4.2
refreshing
cache, 119.9
classes, 5.7.3.1, 5.7.3.1
refreshObject(), 109.1.1.3
remote sessions, 87.9.2.3
sessions, 90.3.5
registering objects, 115.1
registerNewObject method, 114.4.4, 115.1.6
registerObject method, 114.4.2, 114.4.3, 114.4.4, 115.1.6
reimporting schemas, 5.6.3
relation tables
about, 27.8
many-to-many mappings, 34.2
mappings, 34.2
relational descriptors
associated table, 23.2
configuring, 23
locking policy, 119.26
understanding, 21.1
relational mappings
about, 27
aggregate collection, 27.9, 35
aggregate object, 27.12, 37
configuring, 28
converters, 27.2.2
direct collection, 27.10, 36
direct map, 27.11, 38
direct-to-field, 27.3, 29
direct-to-XMLType, 27.4, 30
many-to-many, 27.8, 34
one-to-many, 27.7, 33
one-to-one, 27.5, 31
options, 28.1
order, 28.6
transformation, 27.2.2, 27.13, 39
variable one-to-one, 27.6, 32
relational projects
about, 15.2.2
configuring, 20
exporting, 19.6
introduction, 18
object-relational data type databases, 18.1.2
relational databases, 18.1.1
understanding, 18.1
relationships
about, 2.8.5
bidirectional, 5.5.3.2, 27.5, 121.18.2
expressions, 110.2.7
in ejb-jar.xml file, 19.7
unexpected multiplicity, 8.4.2.5
relative locations
about, 117.2
classpath, 117.3.1
Remote Command Manager Exception, A.2.16
remote connection using RMI, example, 88.7.1
remote sessions
about, 87.1, 87.9
application layer, 87.9.1.1
creating, 88.7
limitations of, 87.9.2
securing access, 87.9.2.1
server layer, 87.9.1.3
transport layer, 87.9.1.2
unit of work, 87.9.2.6
Remove Class button, 5.7.3.1
Remove Table button, 5.5.1.4, 5.5.1.5
removing sessions from brokers, 94.2
Rename dialog, 5.5.1.5
renaming
packages, 5.7.5, 5.7.5
projects, 116.2.1, 116.2.2.1
reopening projects, 116.2.1
report query
about, 108.7.5
query objects, 12.12.9.1.2
read optimization, and, 12.12.9
using, 12.12.9.1.2, 108.5.2
reports
project status, 116.2.3
query results, 108.5.2
see also status reports
result set pagination, 111.13
resuming unit of work
after commit, 115.6
after commit failure, 115.6
returning policy
configuring, 119.27
SQLCall, 108.9.1
Returning tab, 119.27.1
RMI
coordinated cache, 105
naming service, 103.8
remote session support, 87.9.1.2
rollback
and Java Transaction API, 113.2.6.2.1
overview, 113.2.6.2
with optimistic locking, 16.4.3
root class
about, 16.3
inheritance, 16.3
root EIS descriptor, 75.2.1.1
root element, descriptor, 52.4
runtime
acquiring sessions, 87.2.4
components, 3.2
services, configuring sessions, 89.9

S

Save All button, 116.2.2
Save button, 116.2.2
saving projects, 117.2
schema context
descriptors without, 52.3
EIS descriptors, 76.2
XML descriptors, 52.2
Schema Document Info tab, 5.6.4.1, 5.6.5.1
schema manager
about, 6
automatic table creation, 6.4
automatic table creation, CMP, 6.4.2
automatic table creation, JPA, 6.4.1
CMP, 6.4.2
creating a table creator, 6.2
DB2, 6.1.1
default table generator, 6.2.2
Java table creator, 6.2.3
JPA, 6.4.1
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, 76.2
context for XML descriptor, 52.2
data storage, 2.8.2
database, 5.5.1.2
default root for EIS descriptors, 76.3.1
details, 5.6.2
document information, 5.6.4.1, 5.6.5.1
errors, A.3.6
importing, 5.6.3
optimizing, 12.7
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, 111.11.1.1, 111.11.1.1
using for ReadAllQuery, 111.11.1
Securable interface, 97.3.1
security
cache coordination, permissions, 8.8.1.3
data source access, permissions, 8.8.1.4
disabling doPrivileged(), 8.8.3
doPrivileged(), 8.2.3
EJB, permissions, 8.8.1.6
enabling doPrivileged(), 8.8.3
Java EE application, permissions, 8.8.1.6, 8.8.1.6
java.util.logging, permissions, 8.8.1.5
loading project.xml, permissions, 8.8.1.2
loading sessions.xml, permissions, 8.8.1.2
logging, permissions, 8.8.1.5
password encryption, 116.3
permissions by feature, 8.8.1
permissions when doPrivileged() disabled, 8.8.2
port permissions, 8.8.1.3, 8.8.1.4
SecurityManager integration, 8.2.3
system properties, permissions, 8.8.1.1
understanding permissions, 8.8
with BEA WebLogic, 8.3.4
Select Classes dialog box, 5.7.3.1, 5.7.3.1
SelectedFieldsLockingPolicy, 16.4.4
sensors, DMS profiler, 12.4, 87.2.7.2
SEQ_COUNT column in sequence table, 18.2.3
sequence connection pools, 96.1.6.4
sequence numbers, write optimization features, 12.12.10
SEQUENCE objects in Oracle native sequencing, 18.2.2.5.2
sequencing
and relational projects, 18.2
configuring, 18.2.1, 18.2.1
connection pools, 96.1.6.4
default, 98.4.2.1, 98.4.2.1, 98.4.2.1
DefaultSequence class, 98.4.2.1
descriptors, 16.2.10, 23.3
entity beans, 18.2.4
isolated client sessions, 87.5.2
Java configuration, 18.2.1
Microsoft SQL Server, 6.2.3.4
native, 18.2.2.5, 18.2.2.6, 18.2.3
non-Oracle database native, 18.2.2.6
Oracle Database native, 18.2.2.5, 18.2.3
Oracle TopLink Workbench configuration, 18.2.1
overriding default, 98.4.2.1
platform default, 98.4.2.1
preallocation, 12.12.10.1.3, 18.2.3
QuerySequence class, 98.4.2.3
schema manager, 6.2.3.4
SEQ_COUNT, 18.2.3
sequence type, configuring, 20.3, 98.4
sessions, and, 87.2.12
stored procedures, 18.2.2.3, 98.4.2.3, 98.4.2.3
Sybase Database, 6.2.3.4
table, 18.2.2.1
table, default column and table names, 18.2.2.1.1
unary table, 18.2.2.2
with stored procedures, 98.4.2.3
serialization
descriptor exceptions, 115.5
indirection, 17.2.4.7
indirection and JPA, 17.2.4.7
merging into session cache with unit of work, 115.5
serialized object converter
about, 13.2, 17.2.6.1
configuring, 121.9
serialized object mappings, 121.9.1
server layer, 87.9.1.3
server platform
BEA WebLogic, integrating, 8.3
external transaction controller, 89.9
IBM WebSphere, integrating, 8.5
JBoss, integrating, 8.7
OC4J, integrating, 8.4
runtime services, 89.9
session configuration, 89.9
session event listener, 89.8.2, 89.9.2, 119.34.1
SunAS, integrating, 8.6
Server Platform tab, 89.9.1
server session
logging out, 90.8
server sessions
about, 87.1, 87.3, 87.3.2.1
cache, 87.10.1
connection options, 87.3.2.6
service channel, coordinated cache, 103.3
session beans
about, 2.13.3
deploying, 9.4, 10.3.1, 11.3
model, 2.12, 2.13.3, 2.13.3
remote session support for, 87.9.1.2
session broker session
logging out, 90.8
session brokers
about, 87.1, 87.7
adding sessions to, 94.2
alternatives, 87.7.4
architecture, 87.7.1
configuration, 94.1
limitations of, 87.7.3
renaming, 94.2
two-phase commits, 87.7.2
two-stage commits, 87.7.2.2
session configuration file
about, 88.1
loading alternative, 90.3.3
preferences, 5.4.7, 5.4.8
see also sessions.xml file
session customizer, 87.2.3
Session Event Manager, 87.2.5
session events
example, 87.2.5, 87.2.5
isolated sessions, and, 87.2.5
manager, 87.2.5
proxy authentication, and, 87.2.5
Session Loader Exceptions, A.2.9
Session Manager
about, 90.1, 90.1.1
acquiring, 90.2, 90.3
defaults, 90.3.1
destroying sessions, 90.10
Java EE defaults, 90.3.1
sessions, acquiring, 87.2.4
storing sessions, 90.9
sessions
about, 2.4.3.2, 86.1.1, 87, 87, 87.2, 88
acquiring at runtime, 87.2.4, 90, 90.1
adding to session brokers, 94.2, 94.2
additional mapping projects, 89.5
API, 87.11
application server logging, 87.2.6.1.3
architecture, 87.2.1
cache, 87.10, 102.1.1
client, 87.3
configuring, 89, 89.1, 89.8.2, 89.9.2, 119.34.1
connection policy, 89.12
creating, 2.9.3, 88.1, 88.4.1, 88.5.1, 88.6.1, 100.2.1
customization, 87.2.3
database sessions, 87.8, 88.6
destroying in Session Manager, 90.10
errors, A.3.7
event listeners, 87.2.5.2, 89.8.2, 89.9.2, 119.34.1
events, 87.2.5.1
external transaction controller, 89.9, 113.1.2
finalizers, 90.8
historical client sessions, 87.6
in sessions.xml file, 87.2.2
isolated client sessions, 87.5, 92
loading with alternative class loader, 90.3.2
logging, 87.2.6, 87.2.6.1.3, 87.2.6.4, 89.4, 89.4.1
logging into, 90.6
logging out of a client session, 90.8
logging out of a database session, 90.8
logging out of a server session, 90.8
logging out of a session broker session, 90.8
logins, 89.3
management of, 90.1
metadata, about, 2.9.3
multiple sessions, 87.7.4.2, 87.7.4.2, 90.1.2
named queries, 89.13
object cache, 87.2.1.1
optimizing, 12.9
preferences, 5.4.7, 5.4.8
queries, 108.4, 108.6, 109.1, 109.1
refreshing, 90.3.5
registering descriptors, 87.2.10, 89.2, 89.2.2, 89.5.2
releasing a client session, 90.8
remote sessions, 87.9, 88.7
sequencing, about, 87.2.12
server, 87.3
server platform, 89.9, 89.9.1
SQL and messages, 87.2.6.4
storing in Session Manager, 90.9
three-tier architecture, 87.3.1
transformation mappings, 27.13
types, 87.1
unit of work, 87.1, 87.4
sessions.xml file
about, 9.1.2
acquiring, 87.2.4
CMP applications, 9.1.2.4, 87.2.3
creating, 88.1, 88.2
default location, 87.2.4
EJB 3.0, 9.1.2.4
loading alternative configuration file, 90.3.3
non-CMP applications, 9.1.2.2
schema, 9.1.2.1
sessions, 87.2.2
XSD file, 9.1.2.1
setAdditionalJoinExpression(), 111.7.1
setenv.cmd file, 5.2
setenv.sh file, 5.2
setFirstResult, 111.13
setMaxBatchWritingSize(), 12.11.3
setMaxRows, 111.13
setMultipleTableJoinExpression(), 111.7.1
setShouldPerformDeletesFirst(), 115.10.1
Settings tab, 119.8.1, 119.9.1
setValue() method, 17.2.4.1, Glossary
shared library for BEA WebLogic, 8.3.1
simple type translators
about, 13.2, 17.2.6.4
configuring, 121.12
in Java, 121.12.2
read conversions, 17.2.6.4.1
write conversions, 17.2.6.4.2
soft cache weak identity map
about, 102.2.1.4
when to use, 102.2.1.7
soft identity map, 102.2.1.3
sorting, in memory, 121.14
source code, public, 13.3
source control management
projects, 7.2
with Oracle TopLink Workbench, 7.2.1
see also team development
source table, reference, 5.5.2.3
splash screen, 5.4.1
SQL
comparing with expressions, 110.1.1
custom queries for basic persistence, per descriptor, 23.4
EJBQLCall, 109.7
generating from database tables, 5.5.3.1, 5.5.3.1
JPQLCall, 109.7
parameter binding, 12.11.5
parameterized, 12.12.10, 109.2.9
prepared statement caching, 12.11.5
queries, 108.2.8.1, 108.2.8.1
scripts with binding arguments, 23.4
SQLCall, about, 109.4
SQLCall, JDBC arguments, 109.4.2
SQLCall, no arguments, 109.4.1
unit of work, 115.9
SQL Creation Script dialog box, 5.5.3.1
SQL DISTINCT, 12.12.9.2
SQL Exception, A.2.4
SQLAnyWhere platform, 96.1.3.1
SQLCall
about, 108.9.1.1
Returning Policy, 108.9.1
SQLServer platform, 96.1.3.1
stages of development with Oracle TopLink, 2.1.1
stale data
cache, 102.2.3, 102.2.3.4, 102.2.3.5
coordination, cache, 102.2.3.5
invalidating the cache, 102.2.3.4
locking policy, and, 102.2.3.1
per-class cache configuration, 102.2.3.2
per-query cache refresh, 102.2.3.3
StartWith, 111.9.2.1
stateful
beans, 2.13.3
comparing with stateless, 2.13.3
stateless
comparing with stateful, 2.13.3
static attributes, 5.7.2.5.1, 5.7.2.9.1
static fetch groups, querying with, 111.3.2
status report, generating, 116.2.3
stored functions
about, 108.14.4
stored procedure
StoredProcedureCall, 109.6
StoredProcedureCall, about, 109.5
StoredProcedureCall, ErrorCodeListener, 109.5.5
StoredProcedureCall, JDBC arguments, 109.5.2, 109.5.3
StoredProcedureCall, no arguments, 109.5.1
StoredProcedureCall, PL/SQL arguments, 109.5.3
stored procedures
sequencing, and, 18.2.2.3, 98.4.2.3
streams
as query results, 108.5.3
cursored, 87.9.2.5, 111.11.3
structure object-relational data type mappings
configuring, 42
understanding, 40.1.1
Structure window
TopLink, 4.3.3
StructureMapping class, 40.1.1
subqueries
multiple expressions, 110.5
subselects in expressions, 110.5.1
subselects, in expressions, 110.5.1
summary queries, 108.2.4
SunAS
setting classpath, 8.6.1, 8.7.1
superclass, 5.7.2.1.1
Sybase
database schema manager type conversion, 6.1.1
native sequencing, 18.2.2.6
platform, 96.1.3.1
synchronous change propagation, 103.2
system properties
oracle.j2ee.security.usedoprivileged, 8.8.3
oracle.j2ee.toplink.security.usedoprivileged, 8.8.3
toplink.cts.collection.checkParameters, 8.9.1
toplink.xml.platform, 8.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, 18.2.2.1
default column and table names, 18.2.2.1.1
tables
adding database, 5.5.1.2
associating with relational descriptors, 23.2
database, 5.5
defining schema, 6.1
errors, A.3.5
generating, automatic, 17.2.3.4
import filter, 5.5.1.3
mapping to descriptors, 23.2.1, 119.2.1
merging files, 7.2.2.2
multiple, 23.7
primary key, 5.5.2.2
references, 28.7
relation tables for mappings, 34.2
TableDefinition class, 6.1
see also database tables
target foreign keys
about, 27.5, 28.7
configuring, 28.7
target platforms
about, 2.2.2
choosing, 2.2
target tables
in direct collection mappings, 36.2
reference, 5.5.2.3
team development, 7.2
technical support, 2.1.2
three-tier architecture
about, 1.4, 2.11
authentication, 96.1.4.2
migrating to scalable architecture, 87.8
overview, 2.11
sessions, 87.3.1
timestamp support
about, 28.3
direct to field mappings, 28.3
Oracle Database, 28.3
TIMESTAMP timezone, 28.3
TimestampLockingPolicy, 16.4.1
timezone, with TIMESTAMP, 28.3
tljaxb.cmd file, 48.2.2
toolbars, 5.3, 5.3.2, 5.3.2
topic name, 104.2
TopLink, 4.3
Application Navigator, 4.3.1
Structure window, 4.3.3
TopLink Editor, 4.3.2
TopLink editor, 4.3.2
TopLink Editor, parts of, 4.3
TopLink expressions. see expressions
TopLink profiler
about, 12.3
selecting, 89.6.1, 89.8.1, 89.10.1, 89.12.1
TopLink Workbench. see Oracle TopLink Workbench
toplink-ejb-jar.xml file, 9.1.5, 9.1.5, 14.1.1
toplink-src.zip, 13.3
Transaction Exception, A.2.17
transactional data sources, 96.1.1
transactions
client-controlled, 115.14.1
CMP, 113.1.2.3, 115.14.1, 115.14.1
container-controlled, 115.14.1
demarcation, 113.1.2
external transaction controller, 89.9, 113.1.2
external, integrating, 113.1.2, 115.13
isolated client sessions, 87.5.2
isolation, 113.1, 113.1.3
JTA, 113.1.2.1
JTS, 113.1.2.1
local, 115.14.1
local, CMP, 115.14.2
OTS, 113.1.2.2
overview, 2.4.3.5, 86.1.5, 113.1
see also unit of work
transformation EIS mappings
configuring, 85
understanding, 77.9
transformation mappings
about, 17.2.6.5
and copy policy, 2.8.11, 113.2.3.4, 121.17
attribute transformation, 121.15, 121.16
mutability, 121.17
transformation relational mappings
configuring, 39
understanding, 27.13
transformation XML mappings
configuring, 61
understanding, 53.9
transient attributes, 5.7.2.5.1, 5.7.2.9.1
transparent indirection
about, 17.2.4.2, Glossary
persistent class requirements, 2.4.2
transport layer, 87.9.1.2
troubleshooting
MaD support, A.1
migration from OC4J persistence, 8.4.2.5
Oracle TopLink Workbench, A.3
unit of work, 115.16, 115.16.5.1
two-phase commits, 87.7.2
two-stage commits, 87.7.2.2
two-tier architecture
about, 1.4, 1.4, 2.12
authentication, 96.1.4.1
understanding, 2.12
type conversion
automatic, 28.3
NCHAR, 17.2.6.2
NCLOB, 17.2.6.2
NVARCHAR2, 17.2.6.2
oracle.sql.TimeStamp, 28.3
schema manager, 6.1.1
String to TIMESTAMP, 17.2.6.2
TIMESTAMP to String, 17.2.6.2
type conversion converter
about, 13.2, 17.2.6.2
configuring, 121.10
provided by direct-to-field mappings, 28.3
TypeConversionMapping
see TypeConversionConverter
types of mappings, 17.1
typesafe enumeration, in EIS mappings, 77.2.5

U

unary table sequence
about, 18.2.2.2
undeployment, 11.7, 11.7.1, 11.7.2
unexpected relationship multiplicity, 8.4.2.5
unidirectional relationships, 27.2.1
unit of work
about, 113.1, 113.1.1, 113.2, 113.2.1
acquiring, 114.1
API, 113.3
architecture, 113.1
auditing, 115.12, 115.12
benefits of, 113.2.1
cache, 102.1.2
change policy, 113.2.3
clones, 113.2.4
CMP integration, 113.1.2.3
commit and Java Transaction API, 113.2.6.1, 113.2.6.1.1
commit, writing changes before, 115.3, 115.4.4.1, 115.13.4.1, 115.13.4.2
conform results of in-memory query, 108.16.2.1
creating objects, 114.2
deleting objects, 114.7
example, 113.2.2
external transaction controller, 89.9, 113.1.2
external transactions, 113.1.2, 113.1.2, 115.13
integrating with CMP, 115.14
isolation, 113.1.3
JTA integration, 113.1.2.1
JTS integration, 113.1.2.1
life cycle, 113.2.2
modifying objects, 114.3
mutable mappings, 121.17
nested, 113.2.5, 115.8.1, 115.8.2
newInstance method, 115.1.1
optimization, 12.13, 113.2.8
OTS integration, 113.1.2.2
parallel, 113.2.5, 115.8.1
pre-commit validation, 115.16.5.1
primary keys, 113.2.7
proxy indirection, 17.2.4.3.1
queries, 113.3.1.1.2
read optimization, 12.12.9
read-only classes, 115.2, 115.2.1, 115.2.2
registerNewObject method, 114.4.4, 115.1.6
registerObject method, 114.4.2, 114.4.3, 114.4.4, 115.1.6
remote sessions, 87.9.2.6
resuming, 115.6
reverting, 115.7
rollback, 113.2.6.2, 113.2.6.2.1
sessions, 87.1, 87.4
transaction demarcation, 113.1.2
transactions, 113.1.3
unit of work, 113.1.2
troubleshooting, 115.16
validating objects, 115.16.5
with custom SQL, 115.9
write optimization, 12.12.10
writing changes before commit, about, 115.3
writing changes before commit, and external transaction exceptions, 115.13.4.2
writing changes before commit, and external transaction timeouts, 115.13.4.1
writing changes before commit, as alternative to conforming, 115.4.4.1
unmapping, 120.6.1
unregistering objects, 115.1
unsaved items, displaying in TopLink Workbench Navigator window, 5.3.3
update
operation, 109.1.2.1, 109.1.2.4
projects from prior versions, 116.2.1
UpdateAll query, 108.7.3.5
updateObject(), 23.4.1
Use XML Schema "type" attribute, configuring, 121.12
useBatchWriting(), 98.6.2
user-defined functions, in expressions, 110.8

V

validating
descriptors, 118.2
JAXB, 47.1.2
projects, 116.2.3
unit of work, 115.16.5
Validation Exceptions, A.2.7, A.2.7
Value Converter tab, 38.5.1
value holders
about, 17.2.4.1, Glossary
ValueHolder class, 17.2.4.1, Glossary
ValueHolderInterface class, 2.4.2, 17.2.4.1, 27.8, Glossary
variable one-to-one relational mappings
class indicator, 32.2
configuring, 32
primary key, unique, 32.3
understanding, 27.6
VariableOneToOneMapping class, 27.6
Varray in Oracle database. see array mappings
version control, 7.2.5
Version Control Assistance dialog box, 7.2.5
VersionLockingPolicy, 16.4.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, 102.2.1.2
weaving
about, 2.4.1.5, 2.10
application servers, about, 2.10.6
change policy and lazy loading, configuring, 17.2.4.1, 17.2.4.2, 17.2.4.4, 119.30, 121.3
change tracking, 2.10.5, 113.2.3.3.1, 113.2.3.3.2
change tracking and lazy loading, about, 113.2.3.3.2
change tracking and lazy loading, configuring, 17.2.4.1, 17.2.4.2, 17.2.4.4, 119.30, 121.3
disabling, 2.10.3
dynamic, javaagent, 2.10.1
fetch groups, configuring, 119.33
indirection, 2.10.5
indirection, configuring, 17.2.4.1, 17.2.4.2, 17.2.4.4, 119.30, 121.3
Java EE, about, 2.10.6
JPA enties, change tracking, 113.2.3.3.1
lazy loading, 2.10.5
lazy loading, configuring, 17.2.4.1, 17.2.4.2, 17.2.4.4, 119.30, 121.3
mutability, 2.8.11
OC4J, about, 2.10.6
optimization, 12.14
packaging JPA application, 10.4
packaging POJO application, 2.10.4, 10.5
POJO classes, about, 2.10.5
POJO classes, change tracking, 2.10.5, 113.2.3.3.2
POJO classes, indirection, 2.10.5
POJO classes, lazy loading, 2.10.5
static, about, 2.10.2
web browser, specifying, 5.4.2
web services architecture, 1.4, 2.17
weblogic-ejb-jar.xml file, 9.1.4.1
modifying for Oracle TopLink, 9.8
unsupported tags, 9.8.1
welcome screen, 5.4.2
wildcard, 54.4
wrapper policy
about, 119.32
implementing in Java, 119.32.1
write
conversions, simple type translator, 17.2.6.4.2
write all operation, 109.1.2.2
write query
disabling identity map cache, 109.2.2.3
non-cascading, 109.2.2.2
objects, 109.2.2.1
overview, 109.2.2.1
write-locking, 16.2.11
writing
batch, 12.12.10, 98.6.2
ejb-jar.xml file, 19.7.1
optimization, 12.12.10
sessions write access, 87.3.2.3

X

xdb.jar file, 5.2
XML
descriptor, schema context, 52.2
generating deployment, 9.1.1.6
mappings, concepts, 53.2
preserving data, 52.5
projects, 116.1.2.1
query language, 108.2.8.4
reading whole documents, 30.2
records, 77.2.1.3
schemas, 5.6.1
XML Conversion Exception, A.2.18
XML descriptors
configuring, 52
creating, 51
schema context, 52.2
understanding, 50.1
XML mappings
about, 53
any attribute, 70
any collection, 53.8, 60
any object, 53.7, 59
any type support, 53.2.5
binary data, 64
binary data collection, 65, 67
CDATA, 121.20
choice collection, 69
choice object, 68
collection reference, 63
composite collection, 53.6, 58
composite direct collection, 53.4, 56
composite object, 53.5, 57
concepts, 53.2
configuring, 54
default conversion pairs, customizing, 53.3.5
direct, 53.3, 55
extensions, 53.2.8
fragment, 66
jaxb:class support, 53.2.6
list support, 53.2.4
object reference, 62
reference descriptor, configuring, 54.3
transformation, 53.9, 61
types of, 53.1
union support, 53.2.4
xsd:list, 53.2.4
xsd:union, 53.2.4
XML parser platform
about, 8.2.2
configuring, 8.2.2.1, 8.2.2.1
creating, 8.2.2.2
Crimson, 8.2.2.2
default, 8.2.2.1
limitations, 8.2.2.2
parser conflicts, 8.2.2
toplink.xml.platform system property, 8.2.2.1
used by, application server, 8.2.2
used by, Oracle TopLink, 8.2.2
XML Platform Exception, A.2.21
XML projects
configuring, 49
introduction, 47.1
JAXB support, 47.1.1
sequencing, 15.2.6
XML queries, 108.2.8.4
XML schema
jaxb:class, and EIS mappings, 77.2.4
jaxb:class, and XML mappings, 53.2.6
jaxb:class, understanding, 17.2.9
type, 121.12
xs:any, understanding, 53.2.5
xs:anyType, understanding, 53.2.5
xsd:list, understanding, 17.2.8
xsd:union, understanding, 17.2.8
see also schemas
XML Type functions, 110.2.4
XMLMarshalException, A.2.19
XMLPlatformException, A.2.21
XPath
by name, 17.2.7.3
by position, 17.2.7.1
mapping Java attributes, 121.4
support in OX mappings, 17.2.7
support in XML mappings, 53.2.3, 77.2.2
XSD file
sessions.xml file, 9.1.2.1

Z

zero-argument constructors
editing, 5.4.4, 5.4.4
SerializedObjectMapping. see SerializedObjectConverter