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

A

access

data access, 81

direct, 32.16.1

modifiers, 4.7.2.2

optimizing data access, 11.10

remote sessions, 72.9.2.1

access method

direct, 32.6

generating, 4.5.3.2

mappings, 32.6.1

method, 32.6

specifying, 32.16.1

access modifiers, classes, 4.7.2.2

acquiring

client sessions, 75.4

sessions, at runtime, 72.2.4

unit of work, 98.1

activating descriptors, 4.3.3

Add Named Query dialog, 25.7.1.1, 25.7.1.6.1, 25.7.1.7.1

Add New Class dialog, 4.7.1.1, 4.7.5.1

Add New Table button, 4.5.1.2

Add or Refresh Class button, 4.7.3.1

addConstraingDependencies(), 99.10.2

address

multicast group, 88.4

multicast port, 88.5

Add/Update Existing Tables from Database button, 4.5.1.3

advanced properties for descriptors, 19.6

After Load tab, 25.34.1

aggregate collection relational mappings

and EJB, 33.9.2

configuring, 41

understanding, 33.9

aggregate descriptors

about, 23.2.6

aggregate object mapping, 23.2.6.1

EIS projects, 23.2.6.2

EJB 3.0, 23.2.6.1.1

inheritance, 23.7.4

relational projects, 23.2.6.1

XML projects, 23.2.6.3

aggregate object relational mappings

aggregate descriptors, and, 23.2.6.1

configuring, 43

understanding, 33.12

aggregation, isolated client sessions, 72.5.2

AllFieldsLockingPolicy, 23.8.4

allows none, 25.7.1.6.1, 95.7.1.1

allows null, 25.7.1.6.1, 95.7.1.1

amending descriptors, 2.9.2.1.1, 23.2.5, 25.34

B

Base64 encoded strings, 32.12.2

batch options

mappings, 34.4.1

writing, 11.10.3

batch reading

in query objects, 94.2.1.9

read optimization, and, 11.11.7

batch writing

about, 11.10.3, 11.11.8, 83.6.2

dynamic, 11.10.3

dynamic, setMaxBatchWritingSize(), 11.10.3

MySQL4 platform, 83.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, 72.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, 33.2.1

generating, 4.5.3.2

in one-to-one mappings, 32.18

target keys, 33.5

with indirection, 32.18

bindAllParameters() method, 20.6

bindings

arguments, 26.4

input paramters, 94.4.1.1

JAXB, 17.5.1

LOB mappings, 31.5.1

see parameter binding

BLOB

mapping to, 31.5

BMP

and EJB 1.1, 2.14

and EJB 2.0, 2.14

and TopLink, 2.14

deployment files, 8.6

descriptors, 23.2.3, 25.18

packaging for deployment, 9.5

boolean logic in expressions, 95.2.1

branch classes, 23.7, 23.7

buttons. see toolbars

bye array binding, LOB mappings, 31.5.1

Byte array Base64, 32.12.2

C

cache

about, 2.4.3.3, 2.8.8, 87

architecture, 87.1

configuring, 87.2.3, 96.11.1

coordination, 87.2.6, 88, 89, 90

descriptor level, 25.12

disabling during read query, 93.15.4

distributed, 87.2.6

expiration, 19.14, 25.16, 96.11.2

expression limitations, 93.15.2.2

identity maps, using, 72.8

in-memory queries, 93.15.2.1, 93.15.2.2

internal query object cache, 93.15.6, 93.15.7, 93.15.7.1, 96.11.1, 96.11.2

invalidation, 19.14, 25.16, 87.2.3.4, 87.2.5

isolated client sessions, 72.5.2

isolation, 87.2.3, 87.2.7

object cache, 93.15.7

object cascading refresh, 93.15.5.2

object refresh, 93.15.5.1

optimizing, 11.9

project level, 19.11

queries, 87.2.2, 93.15

query cache, 93.15.7

readObject method, and, 94.1.1.1

refreshing, 25.9, 87.2.4.1, 93.15.5.3

restrictions, 93.15.7.1

service channel, 88.3

sessions, 72.2.1.1, 72.10, 87.1.1

stale data, 87.2.3

storing query results, 93.15.6, 93.15.6, 96.11.1

type and size, 19.11, 25.12

unit of work cache, 87.1.2

cache coordination

about, 87.2.6

application server clustering, and, 7.2.5

avoiding stale data, 87.2.3.5

CMP projects, 8.7.1.2

EJB Entity Beans with BMP architecture, and, 2.14.3.3

explicit query refreshes, 87.2.4

JMS, 89

orion-ejb-jar.xml, 8.7.1.2

packet time-to-live, 88.12

permissions, 7.6.1.3

RMI, 90

cache invalidation, avoiding stale data, 87.2.3.4

cache synchronization. see cache coordination

cacheAllStatements(), 20.6

cacheQueryResults(), 25.7.1.10

cache-synchronization property, 8.7.1.2

Caching tab, 25.12.1, 25.13.1, 25.15.1, 25.17.1

calendar, 34.2

call

call queries, 93.9

EIS, 94.6

EJBQLCall, 94.5

SQLCall, 94.4, 94.4.1

StoredFunctionCall, 94.4.3

StoredProcedureCall, 94.4.2

Call object, queries, 93.2.1

cascading

object refresh, 93.15.5.2

optimistic version locking, 23.8.2

write queries, compared to non-cascading, 93.7.3.6, 94.2.2.3

catalog, database, 4.5.1.2

catchExcpetions(), 74.11

change policy

about, 25.30

attribute change tracking, configuring, 25.30.1.3

deferred change detection, configuring, 25.30.1.1

empty transaction, 97.2.3

object change tracking, configuring, 25.30.1.2

unit of work, 97.2.3

change tracking

attribute, configuring, 25.30.1.3

deferred, configuring, 25.30.1.1

object, configuring, 25.30.1.2

changed items, displaying in TopLink Workbench Navigator window, 4.3.3

ChangedFieldsLockingPolicy, 23.8.4

changing package names, 4.7.5

checkDatabase(), 74.11

checking in/out projects, 6.2.1

checkInstantiationPolicy(), 74.11

Choose a Schema Context dialog box, 28.2.1.1, 29.2.1.1

Choose Query Key dialog box, 95.7.1.1

Choose Relationships to Generate dialog box, 4.5.3.2

Choose Root Element dialog box, 28.3.1.1, 29.4.1.1

class extraction method

about, 23.7.1.2

inheritance, 23.7.1.2

class indicator

about, 23.7.1

class extraction method, 23.7.1.2

class indicator field, 23.7.1.1, 38.2

class loader

host application, 2.2.2

loading session, 75.3.2

class modifiers, 4.7.2.2

Class tab, 4.7.2.1.1, 4.7.2.2.1, 4.7.2.3.1

classes

access modifiers, 4.7.2.2

adding and refreshing, 4.7.3.1

branch, 23.7

creating, 4.7.1.1, 4.7.5.1

CursoredStream, optimizing, 96.10.3

Database Exception, 94.7

DatabaseMapping, 30.3

default null values, 32.19

DeleteObjectQuery, 94.2.2.1

ExpressionBuilder, 95.7.2

generating from database, 4.5.3.2

InsertObjectQuery, 94.2.2.1, 94.2.2.1, 97.3.1.1.2

interfaces, 4.7.2.3

leaf, 23.7

merging files, 6.2.2.2

methods, adding, 4.7.2.8

naming, 4.7.2.1.1

non-descriptor classes, 4.7.4

object model, 2.8.1

Performance Profiler, 11.3.1

persistent requirements, 2.4.2

preferences, 4.4.4

refreshing, 4.7.3.1

removing, 4.7.3.1

root, 23.7

troubleshooting, 14.8

unit of work, 97.3.1.1.2

UpdateObjectQuery, 94.2.2.1, 94.2.2.1, 94.2.2.3

ValueHolderInterface, 2.4.2, 30.2.4.1, 33.8

VariableOneToOneMapping, 33.6, 33.6

D

data access

about, 81

authentication, 81.1.4

connection pool, 81.1.6

connections, 81.1.5

optimizing, 11.10, 11.10.2

platforms, 81.1.3

data level queries

example, 95.6.2

in expressions, 95.6

data source platform

about, 81.1.3

Attunity Connect database, 81.1.3.1

Cloudscape database, 81.1.3.1

databases, 81.1.3.1

DB2 database, 81.1.3.1

EIS, 81.1.3.2

HSQL database, 81.1.3.1

Informix database, 81.1.3.1

J2C adapter, 81.1.3.2

JDBC drivers, 81.1.3.1

Microsoft Access database, 81.1.3.1

MySQL4 database, 81.1.3.1

Oracle database, 81.1.3.1

Oracle8 database, 81.1.3.1

Oracle9 database, 81.1.3.1

PointBase database, 81.1.3.1

SQLAnyWhere database, 81.1.3.1

SQLServer database, 81.1.3.1

SybasePlatform database, 81.1.3.1

data sources

configuring, 82

nontransactional, 81.1.1

transactional, 81.1.1

troubleshooting, 14.9

Database Exceptions, 13.4, 94.7

database fields, configuring, 34.2

database functions, in expressions, 95.2.2

database login

parameter binding, 83.6

prepared statement caching, 83.6

Database Preferences, 4.4.6

database queries

about, 93.7, 94.2

fetch groups, 93.7.1.5

join reading, 93.7.1.4

object level modify query, 93.7.3, 93.7.4

object level read query, 93.7.1, 93.7.2

partial object query, 93.7.1.3

read all query, 93.7.1.2

read object query, 93.7.1.1

report query, 93.7.5

database schema

tables, 4.5.1.2

database sessions

about, 72.1, 72.8

cache, 72.10.1

configuration, 80.1

creating, 73.6

database tables

about, 4.5

adding to database, 4.5.1.2

creating, 4.5.1.2

descriptors and classes, generating, 4.5.3.2

EJB entity generation, 4.5.3.3

fields, 4.5.2.1

generating, 4.5.3.1, 4.5.3.2, 4.5.3.4

importing, 4.5.1.3

Java source generation, 18.9.4

JDBC driver classpath, 4.5.1.3

properties, 4.5.2

references, 4.5.2.3, 4.5.2.4

removing, 4.5.1.4

renaming, 4.5.1.5

schema, 4.5.1.2

SQL generation, 4.5.3.1

TopLink Workbench, Navigator window, 4.3.3

DatabaseException class, 94.7

DatabaseLogin, 81.1.2.1

DatabaseMapping class, 30.3, 30.3

DatabaseQuery, 93.2.2

DatabaseRow, 33.13

databases

catalog, 4.5.1.2

common problems, 14.9.1

connect to, 4.5.1.1

creating reference tables on, 4.5.2.3

custom drivers, 4.4.6

disconnect from, 4.5.1.1

drivers, 4.4.6

exceptions, 94.7

fields, configuring, 34.2

for project, 18.1.1.1

Java type conversion, 5.1.1

linking, 72.7.4.1

log out of, 4.5.1.1

logging into, 4.5.1.1, 20.5.1.1

logins, 83

mapping. See mappings

platform, 18.1.1.1, 20.2, 21.2, 83.2, 84.2

preferences, 4.4.6

schema, 4.5.1.2

schema manager, 5

tables, 4.5

TopLink Workbench, Navigator window, 4.3.3

troubleshooting, 14.9.1

type conversion, schema manager, 5.1.1

using with Oracle TopLink Workbench, 4.5

DatabaseSession class

logging SQL and messages, 72.2.6.4

DB2

platform, 81.1.3.1

schema manager type conversion, 5.1.1

DBase platform, 81.1.3.1

default mapping

about, 30.2.3.2

automatic table generation, and, 30.2.3.2, 30.2.3.2

configuring, 8.7.1.3

default table generator, 5.4

Default Mapping Exception, 13.13

default table generator

default mapping, 5.4

table creator, creating, 5.2.2

defaults

mapping level null values, 32.5

null values, 32.5, 32.19, 82.6

optimization, 11.5

root, 29.4

E

Editor window, about, 4.3, 4.3.4

EIS

about, 17.4

architecture, 2.2.1.4

call, 94.6

custom interactions for basic persistence, per descriptor, 28.5

indexed records, configuring, 28.4

interactions, 28.5, 93.2.8.4, 94.6

mapped records, configuring, 28.4

mappings, 17.4, 53.2

projects, 18.1.1.1

queries, 93.2.8.4

record format, configuring, 28.4

XML records, configuring, 28.4

EIS descriptors

composite, 24.4.1.2

configuring, 28

default root, 28.3.1

locking policy, 25.26

root descriptor, 24.4.1.1

schema context, 28.2

setDataTypeName, 28.3.2

understanding, 23.5

EIS mappings

about, 53, 53.2

architecture, 53.2.7

composite collection, 53.6, 58

composite direct collection, 53.4, 56

composite object, 53.5, 57

configuring, 54

direct, 53.3, 55

jaxb:class support, 53.2.4

list support, 53.2.3

one-to-many, 53.8, 60

one-to-many, key on source, 53.8.1

one-to-many, key on target, 53.8.2

one-to-one, 53.7, 59

one-to-one, key on source, 53.7.1

one-to-one, key on target, 53.7.2

transformation, 53.9, 61

types of, 53.1

union support, 53.2.3

xsd:list, 53.2.3

xsd:union, 53.2.3

EIS projects

configuring, 21

connector.jar, 17.4

indexed records, 17.4.2

mapped records, 17.4.2

sequencing, 17.2.6

understanding, 17.4

XML records, 17.4.1

EIS queries, 93.2.8.4

EIS record types, supported, 53.2.1

EISLogin, 81.1.2.1

EJB

descriptors, 18.8.1

isolated client sessions, 72.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, 30.2.4.5.1

serialization, 30.2.4.5.1

EJB 2.x

and BMP, 2.14

and CMP, 2.13

default mapping, 30.2.3.2

indirection, 30.2.4.5.1

serialization, 30.2.4.5.1

EJB 3.0

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

and CMP, 2.13

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

Bean annotation, fetch=lazy, 30.2.4.4.1

default mapping, 30.2.3.2

deployment files, 8.1, 9

deployment files, OC4J CMP integration, 7.3.1

detachment, 30.2.4.5.1

Embedded annotation, 23.2.6.1.1

packaging for deployment, 9

packaging, OC4J CMP integration, 7.3.1

projects.xml file, 8.1.1.5, 8.1.3

serialization, 30.2.4.5.1

sessions.xml file, 8.1.2.3

toplink-ejb.xml file, 8.1.5

value holder indirection, 30.2.4.4.1

EJB descriptors, opening projects with, 18.8.1

EJB entities

CMP hot deployment, 10.6.1

deployment overview, 2.5.2

EJB 2.x indirection, 30.2.4.4.1

EJB 3.0 indirection, 30.2.4.4.1

generating, 4.5.3.3

hot deployment, 10.6, 10.6.1, 10.6.2

inheritance, 23.2.3.3, 23.7.5

inserting after ejbCreate, 23.2.3.2

inserting after ejbPostCreate, 23.2.3.2

mapping, 19.5

non-CMP hot deployment, 10.6.2

non-deferred write, understanding, 23.2.3.1, 99.14.3

sequencing, 17.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 finders

about, 93.14

Call finders, 93.14.3

creating, 96.9.1

DatabaseQuery finders, about, 93.14.4

default finders, about, 93.14.2

default finders, creating, 96.9.1

EJB QL finders, about, 93.14.8

ejb-jar.xml options, 96.9.1.1

ejbSelect method, 93.14.11

ejbSelect, creating, 96.9.8

ejbSelect, using, 96.9.8

expression finders, about, 93.14.7

named query finders, about, 93.14.5

predefined, about, 93.14.1

primary key finders, about, 93.14.6

redirect finders, about, 93.14.10

redirect finders, using, 96.9.7

single-object finder return type checking, 7.7

SQL finders, about, 93.14.9

EJB Info tab, 25.18.1

EJB JAR XML Exception, 13.19

EJB Preferences, 4.4.5

EJB QL

exceptions, 13.8

queries, 26.4, 93.2.8.2

query language, 93.2.8.2

EJB session bean facade architecture

about, 1.4, 1.4, 2.12

understanding, 2.12

EJB Session Beans, 72.9.1.2

ejbc

about, 10.4.2

troubleshooting, 10.4.2.1

ejbCreate, 23.2.3.2

ejb-jar.xml file

about, 8.1.3, 18.10

configuring, 8.1.4

corresponding to Oracle TopLink Workbench functions, 18.10

EJB finder options, 96.9.1.1

location, 19.5.1

managing, 6.2.4

preferences, 4.4.5

synchronization under EJB 2.0, 8.1.3

updating from, 18.10.2

writing, 18.10.1

ejbPostCreate, 23.2.3.2

@Embeddable, 23.2.6.1.1

@Embedded, 23.2.6.1.1

empty unit of work transactions, 97.2.3

encrypting login passwords, 18.9

enhanced validation exceptions, 8.1.2.1

Enterprise Information Systems. see EIS

entity beans

deployment, 2.5.2

descriptor information, 23.2.3

direct mappings, 33.2.3

indirection, EJB 2.x, 30.2.4.4.1

indirection, EJB 3.0, 30.2.4.4.1

sequencing with, 17.7.4

Entity Manager Setup Exception, 13.20, 13.21

EntityManagerSetupException, 13.20, 13.21, 13.22

environment

configuring, 4.2

JAVA_HOME, 4.2

JDBC_CLASSPATH, 4.2

proxy, 4.4.1, 4.4.2, 18.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

12000-12004, 13.10

18001-18002, 13.12

22001-22004, 13.14

22101-22105, 13.15

3001-3007, 13.3

4002-4018, 13.4

5001-5008, 13.5

6001-6098, 13.6

7001-7104, 13.7

72000-72023, 13.19, 13.20, 13.21, 13.22

8001-8010, 13.8

9000-9009, 13.9

errors

about, 13

codes and descriptions, 13, 14.1

descriptors, 4.3.3, 4.3.5

migration, 7.3.2.5

Oracle TopLink Workbench, 14

Event Manager, 72.2.5

events

about, 23.2.7, 23.2.7

client session, 72.2.5.1

database access, 72.2.5.1

Descriptor Event Listener, 25.25

domain object methods, 25.24

handlers, 23.2.7, 25.24, 25.25

listeners, sessions, 72.2.5.2

session, 72.2.5

session manager, 72.2.5.1

sever session, 72.2.5.1

types of, 25.24

unit of work, 72.2.5.1

examples

composite collection EIS mapping, 53.6

context menu, 4.3.1.2

cursored streams, 96.10.2.1

direct collection mappings, 33.10

direct-to-field mappings, 33.3

exception handler, 74.7.2

indirection, 30.2.4

inheritance, 23.7

Oracle TopLink Workbench, 4.3

performance optimization, 11.11.7.2, 11.11.7.4

proxy indirection in code, 32.3.2.5

READALL finders, 96.9.2

report query, 94.2.1.3

scrollable cursors, 96.10.1.1

serialized mapping, 30.2.6.1

stored procedure call, 94.4.2.1, 94.4.2.2, 94.4.2.3

transformation mapping, 33.13

transformation XML mapping, 53.9, 62.9

Unit of Work, 97.2.2, 98.6

write, write all, 94.1.2.1

exception handler

about, 72.2.9

example, 74.7.2

selecting, 74.7.1

exceptions

chained, 72.2.6.5

communication exceptions, 13.10

conversion exceptions, 13.3

database exceptions, 13.4, 94.7

Default mapping exception, 13.13

descriptor exceptions, 13.1, 13.1

discovery exceptions, 13.14

EJB JAR XML exceptions, 13.19, 13.20, 13.21, 13.22

EJB QL exceptions, 13.8

enhanced validation, 8.1.2.1

java.security.AccessControlException, 15.7, 15.7

JMS processing exceptions, 13.12

Migration utility exception, 13.18

optimistic locking, 13.5

query exceptions, 13.6

remote command manager exceptions, 13.15

selecting exception handler, 74.7.1

session loader exceptions, 13.9

Transaction exception, 13.16

validation exceptions, 13.7

XML conversion exception, 13.17

exclusive connections

about, 99.15.1.4.3

internal read connection pool, 86.6

isolated sessions, 72.5, 74.12

named queries, 25.7.1.10

existence checking, 99.1.4

descriptors, 25.17

projects, 19.7

expanding items in Navigator window, 4.3.3

expiration of objects in the cache, 19.14, 25.16

explicit query refreshes, cache coordination, 87.2.4

exporting

deployment XML, 18.9.1

Java model, 18.9.2

Java source, 18.9.3

preferences, 4.4

projects, 18.9

Expression Builder, 95.7.1, 95.7.2

Expression Builder dialog box, 95.7.1

Expression class, 95.1

ExpressionMath class, 95.1

expressions

about, 93.2.6, 95, 95.1

allows none, 25.7.1.6.1, 95.7.1.1

allows null, 25.7.1.6.1, 95.7.1.1

building, 95.7.1

comparing with SQL, 95.1.1

components, 95.2, 95.2

creating, 95.7

data level queries, 95.6

database functions, 95.2.2

in relationships, 95.2.7

in-memory queries, limitations, 93.15.2.2

mathematical functions, 95.2.3

multiple, 95.5

one-to-one mappings, 95.2.6

outer joins, 94.2.1.10

parallel expressions, 95.5.2

parameterized, 95.3

platform functions, 95.8

query keys, 95.4

subqueries and subselects, 95.5.1

user-defined functions, 95.2.5, 95.8

using Boolean logic, 95.2.1

XML Type functions, 95.2.4

F

factory name, JMS connection, 89.3

failure, resuming unit of work after commit, 99.6

features of Oracle TopLink, 1.3

fetch groups

about, 23.2.4, 25.33

configuring, 25.33, 96.3.1

default, 25.33, 96.3.1

disabling, 96.3.1

dynamic, 96.3.3

object level read query, 93.7.1.5

read optimization, and, 25.33

size, 11.11.5

static, 96.3.2

@Bean fetch=lazy, 30.2.4.4.1

field references, 34.6

Field uses XML Schema "type" attribute option, 30.2.6.4

fields in database tables, 4.5.2.1

Fields tab, 43.3.1

field-to-object attribute transformation, 32.15, 32.16

files

JAXB-specific, 17.5.1.1

TopLink-specific, 17.5.1.2

G

garbage collection, managing, 98.7.1

General Preferences dialog, 4.4.1

Generate Classes and Descriptors dialog, 4.5.3.2

Generate EJB Entity Classes and Descriptors dialog, 4.5.3.3

generating

access method, 4.5.3.2

deployment JARs, troubleshooting, 15.1

deprecated direct mappings, 19.10

H

hard cache weak identity map

about, 87.2.1.3

when to use, 87.2.1.6

help

about, 4.3.6

displaying, 4.3.6

Help button., 4.3.6

Help Preferences, 4.4.2, 4.4.4

hierarchical queries

about, 93.9.1.4.2

described, 96.8.2

hints, Oracle Hints in queries, 93.9.1.4.1

historical client sessions

about, 72.1, 72.6

cache, 72.10.3

limitations of, 72.6.1

historical queries, 96.2

about, 93.11