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 

---

A

access method

direct, 4-70

generating, 3-15

mappings, 4-70

method, 4-70

project default, 2-10

specifying, 4-70

access, direct, 4-70

accessors

database, B-33

Java methods, B-10

ACME Employee Management System

database schema, B-40

see also tutorials

activating descriptors, 1-10

Add Named Query dialog box, 4-16

Add New Class dialog box, 2-14

Add New Table button, 3-4

addAscendingOrdering(), 6-38

addDescendingOrdering(), 6-38

addFieldTransformation(), 5-13

adding

classes, 2-15, B-11

query keys, 4-25

sessions, 8-6

see also creating

ADDRESS table, B-3, B-41

addTableName() method, 4-72

Add/Update Class button, 2-15

Add/Update Existing Tables from Database button, 3-6

advanced properties

descriptor, 4-26

sessions, 8-10

specifying default, 2-13

Advanced Properties Default dialog box, 2-13

Advanced Query Options dialog box, 4-19

advanced tutorial

about, B-38

see also tutorials

After Load tab, 4-27

aggregate collection mappings, about, 6-31

Aggregate Descriptor button, 6-18

Aggregate Descriptor icon, 6-18

Aggregate Mapping button, 6-19

Aggregate Mapping tab

Fields, 6-19, B-58

General, 6-19, B-57

aggregate object mappings

about, 6-15

creating, 6-19

target descriptor, 6-18

tutorial, B-57

alias, descriptor, 4-17

AllFieldsLockingPolicy, 4-56

amending descriptors, 4-27, 5-13, 6-23

see also after load

API, 4-1

arguments

binding in query, 4-14

array dimensionality, 4-10

array mappings

about, 7-1, 7-2

example, 7-3

implementing in Java, 7-3

attributes

array dimensionality, 4-10

nullValue, 4-71

transformation method, 5-10

Attributes tab, 4-9, 4-11

automapping descriptors

about, 4-4

tutorial, B-46

see also mappings

---

B

bidirectional relationships

about, 6-1

generating, 3-15

maintaining, 4-71

target keys, 6-21

bindAllParameters(), 4-18

binding arguments, 4-14

BLOB fields in databases, 5-1, 5-9

branch classes, 4-32, 4-44

Builder JDBC Server, B-5

buttons. see toolbars

---

C

cache

caching objects, 4-59

identity map, 4-58

refreshing, 4-7

cacheQueryResults(), 4-18, 4-20

cacheStatement(), 4-18

caching. see also clustering

catalog, database, 3-5

ChangedFieldsLockingPolicy, 4-57

changing package names, 2-11

checking in/out projects, 1-20

Choose Query Key dialog box, 4-22

Choose Relationships to Generate dialog box, 3-15

.class file, 1-22

class definitions, generating, B-11

class extraction method, 4-42

Class Import preferences

Editing Classes tab, 1-15

Importing Classes tab, 1-14

class indicator field, 4-42, 4-43, 6-24

Class Indicator Info tab, 6-28

class information, setting, 4-7

class path

about, 2-6

adding, 2-8, B-7

relative, 2-8

setting, B-7

Class tab, 4-8

classes

advanced tutorial, B-39

ArrayMapping, 7-10

branch, 4-44

creating, 2-14

DatabaseException, B-35

DatabaseMapping, 4-68

DirectCollectionMapping, 6-40

enabling, B-9

Expression, B-37

ExpressionBuilder, 6-40

generating, 4-5

generating from database, 3-14

introductory tutorial, B-2

leaf, 4-44

linking to tables, B-19

NestedTableMapping, 7-10

OneToOneMapping, 6-40

OptimisticLockException, 4-57

persistent, 4-72

persistent requirements, A-2

preferences, 1-14

refreshing, 2-15

removing, 2-16

root, 4-43

SchemaManager, B-33

setting information, 4-7

TableDefinition, B-34

TransformationMapping, 5-13

ValueHolderInterface, 6-7, 6-35, A-2, B-47

VariableOneToOneMapping, 6-24

XMLProjectReader class, 2-1

class-table relationships, B-10, B-43

Clustering property sheet, 8-14

CMP fields, 2-8

CMR relationships, 2-8

code generation

creating from descriptors, 4-5

options, 2-12

collapsing items in Navigator pane, 1-9, 8-3

collection mappings, persistent requirements, A-2

Collection Options tab, 4-73

composite primary key, 6-35

Configuration General property sheet, 8-5

Configuration Session Broker property sheet, 8-6

configurations

about, 8-3

creating, 8-4

new, 8-4

opening, 8-4

saving, 8-5

session, 8-4

conform results in unit of work, 4-6

Connection Pool button, 8-16

Connection Pool General property sheet, 8-16

connection pools

about, 8-15

creating, 8-15

constructor requirements, A-2

container policy

about, 6-4

overriding, 6-5

copy policy

about, 4-51

setting, 4-51

copying project objects, 1-24

Copying tab, 4-52

Create New Configuration button, 8-4

Create New Project button, 2-2

Create New Project dialog box, 2-2

creating

configurations, 8-4

database tables, B-15

database tables in OracleAS TopLink Mapping Workbench, B-15

expressions, 4-20

new projects, B-4, B-45

projects, 2-2

session brokers, 8-5

sessions, 8-7

---

D

data definition language (DDL) creation scripts, B-17

database

about, 3-2

accessors, B-33

catalog, 3-5

creating reference tables on, 3-11

driver requirements, 3-6

drivers, 1-18, 3-3

for project, 2-2

logging in, 3-3, B-13, B-33

platform, 2-2, 3-2

preferences, 1-17

properties, 3-2

requirements, 3-6

schema, 3-5

supported, 4-67

tables, 3-4

database drivers, custom, 1-18

Database Fields tab, B-16, B-21, B-23

database login, B-13, B-33

Database Login button, 3-3

Database login icon, 3-3

Database Preferences, 1-17

Database properties, B-14

Database property sheet, 3-2

database schema

about, 2-11

advanced tutorial, B-40

introductory tutorial, B-3

tables, 3-5

database sessions, B-32

database tables

about, 3-4

creating, 3-4, B-15

creating in Java, B-33

creating in OracleAS TopLink Mapping Workbench, B-15

generating, 3-17

generating descriptors and classes, 3-14

generating EJB entities, 3-16

generating Java source, 2-17

generating SQL, 3-13

importing, 3-5, B-17

properties, 3-8

removing, 3-7

renaming, 3-8

schema, 3-5

specifying fields, 3-8

specifying references, 3-10

DatabaseException class, B-35

DatabaseMapping class, 4-68

DatabaseRow, 5-10

dates, converting, 8-13

deactivating descriptors, 1-10

default values, when database field is null

Direct-to-Field mapping, 5-4

object type mappings, 5-8

defaults

advanced properties, setting, 2-13

sessions, 8-7

table generation, 2-11

Defaults tab, 2-10

deleteObject(), 4-14

deployment

database login, 3-3

descriptors, 4-1

XML, generating, 2-17

deployment XML, generating, 2-17

descriptor alias, 4-17

descriptor files

merging, 1-22

Descriptor Info tab, 4-6, B-20, B-26

descriptors

about, 4-1, 4-2, B-19, B-32

advanced properties, 4-26

advanced properties, setting default, 2-13

alias, 4-17

amending, 4-27

automapping, 4-4, B-46

cache refreshing, 4-7

class information, 4-7

deactivating, 1-10

EJB, 2-8

errors, 1-10

events, 4-28

generating from database, 3-14

generating Java code, 4-5

identity mapping, 4-29

inactive, 1-10

interface, 4-45

mapping, 4-3

mapping inherited attributes, 4-40

mapping to tables, 4-5

object-relational, 4-66

primary key, 4-36

registering events, 4-64

removing, 2-16

types, 4-3

using in an application, B-34

development database login, 3-3

dimensionality, array, 4-10

direct access

about, 4-70

specifying, 4-70

Direct Collection Mapping button, 6-30

Direct Collection Mapping tab

General, 6-30, B-59

Table Reference, 6-31

direct collection mappings, B-58

about, 6-29

creating, 6-30

example, 6-29

direct mappings

about, 4-67, 5-1, 5-2

nullValue, 4-71

direct nullValue attribute, 4-71

direct query key, 4-60

DirectCollectionMapping class, 6-40

direct-to-field mapping, B-24

Direct-to-Field Mapping button, 5-4

Direct-to-Field Mapping tab, 5-4, B-24, B-49

direct-to-field mappings

about, 5-1, 5-2

creating, 5-4

null values, 4-71, 5-3

type conversions, 5-3

drivers

custom database, 1-18

database, 3-3

---

E

Edit the Literal Type and Value dialog box, 4-23

Editor pane, about, 1-3, 1-10

EJB descriptor icon, 2-8

EJB descriptors

deployment descriptors, 4-1

icon, 2-8

opening projects with, 2-3

updating, 2-8

EJB entities

generating, 3-16

inheritance, 4-40

EJB finders, 4-17

EJB Info tab, 4-25

EJB Preferences, 1-16

EJB QL queries, 4-12

ejb-jar.xml

about, 2-18

corresponding to OracleAS TopLink Mapping Workbench functions, 2-18

displaying information, 4-25

file location, 2-7

managing, 1-24

preferences, 1-16

specifying, 4-3

updating from, 2-20

writing, 2-19

ejbSelect queries, 4-17

elements, renaming, 8-3

EMPLOYEE table, B-3, B-40

enabling Java classes, B-9

encrypting login passwords, 2-16

encryption, password, 8-11

Entity Beans, using sequence numbers with, 4-37

errors

descriptors, 1-10

messages, C-2

sessions, 8-3

Event Manager, 4-63

event method, 4-64

events

about, 4-28, 4-63

registering with a descriptor, 4-64

setting, 4-28

supported, 4-64

Events tab, 4-28

examples

array mapping, 7-3

custom mapping query, 6-40

direct collection mappings, 6-29

direct-to-field mappings, 5-3

event methods, 4-64

events, 4-64

indirection, 6-6

inheritance, 4-40

interface, 4-46

nested table mapping, 7-10

object array mapping, 7-4

object type mapping, 5-6

one-to-many mapping, 6-33

OracleAS TopLink Mapping Workbench, 1-2

pop-up menu, 1-5

query keys, 4-60, 4-62

reference mapping, 7-8

serialized mapping, 5-9

structure mapping, 7-6

transformation mapping, 5-10, 5-12

transformation mapping (write-only), 5-13

type conversion mappings, 5-5

see also tutorials

existence checking, specifying, 2-10

expanding items in Navigator pane, 1-9, 8-3

Export to Deployment XML button, 2-17

Export to Java Source button, 2-16

exporting

Java model source, 2-18

Java source, 2-16

projects, 2-16

Expression Builder, 4-20

Expression Builder dialog box, 4-20

Expression class, B-37

ExpressionBuilder class, 6-40

expressions

building, 4-20

see also queries

---

F

field locking policies, 4-55, 4-56

fields

access, project, 2-10

database tables, 3-8

finders

about, 4-66

reserved, 4-66

see also queries

findManyByQuery, 4-19

findOnebyQuery, 4-19

foreign keys

about, 6-3

multiple tables, 4-51

one-to-many mappings, 6-33

one-to-one mappings, 6-21, B-28

references, C-2

specifying, 6-4

target, 6-21

troubleshooting, C-2

full identity map, 4-58

---

G

General Preferences dialog box, 1-11

General tab, 2-6, B-7

Generate Classes and Descriptors dialog box, 3-14

Generate EJB Entity Classes and Descriptors dialog box, 3-16

generating

access method, 3-15

class definitions, B-11

options, 2-12

tutorial code, B-65

see also exporting

getCatalogs(), 3-6

getImportedKeys(), 3-6

getPrimaryKeys(), 3-6

getTables(), 3-6

getTableTypes(), 3-6

getValue(), 6-7

getValue() method, 6-7

getWrapperPolicy(), 4-55

---

H

hard cache weak identity map, 4-58

hashtable, collection mappings, 6-5

Help Preferences, 1-19

holders, value, 6-7

---

I

identity maps

about, 4-58

database sessions, B-32

project default, 2-10

recommendations, 4-59

size, 4-58

specifying, 4-29

Identity tab, 4-29

Implementors tab, 4-47, 6-26

Import Tables from Database dialog box, 3-6

importing

classes, 1-14

database tables, B-17

inactive descriptors, 1-10

independent relationships, 6-2

indirection

about, 6-5, 6-6, B-47

example, 6-6

implementing in OracleAS TopLink Mapping Workbench, B-49

Java class requirements, 6-9

many-to-many mappings, 6-35

non-transparent, A-2

specifying, 6-8

transformation mapping, 5-12

transparent, A-2, C-2

value holder, C-2

ValueHolderInterface, A-2

see also proxy indirection, transparent indirection

Informix, sequence numbers, 4-37

inheritance

about, 4-39

aggregate collection mappings, 6-32

branch and leaf classes, 4-32

branch classes, 4-44

finding subclasses, 4-42

in one descriptor, 4-40

leaf classes, 4-44

primary keys, 4-44

root class, 4-30

root classes, 4-43

specifying, 4-30

supporting with multiple tables, 4-42

supporting with one table, 4-40

tutorial examples, B-61

using with EJBs, 4-40

Inheritance tab, 4-30, B-63

insertObject(), 4-13

instantiation policy

about, 4-52

setting, 4-53

Instantiation tab, 4-53

Interface Alias tab, 4-34

interfaces

about, 4-45

adding, 4-9

customizing, 1-11

descriptors, 4-45

implementing, 4-47, 4-48

query keys, 4-60

removing, 4-9

variable class relationships, 4-45

introductory tutorial

about, B-2

database schema, B-3, B-40

see also tutorials

---

J

Java

database tables, 2-17

descriptors, 4-5

exporting to, 2-16

generating source code, B-65

object model, A-1

persistent classes, B-19

Java class instances, B-35

Java classes, persistent, B-19

Java Core Reflection API, 4-70

Java Cryptography Extension, 2-16

Java source code, generating, B-65

java.util.Collection interface, 6-4

java.util.Map interface, 6-4

java.util.Vector class, 6-5

javax.ejbEntityBean interface, 3-16

JCE. see Java Cryptography Extension

JDBC drivers

database requirements, 3-6

methods, 3-6

supported, 4-67

tutorial, B-14

JDBC Server, B-5

---

K

key pairs

database table reference, 3-12

troubleshooting, C-2

keys

foreign, 6-21, B-28

foreign, target, 6-21

primary, 6-35, B-21

primary, in inheritance, 4-44

primary, in variable class relationships, 6-24, 6-25

primary, multiple tables, 4-50

primary, read-only settings, 4-71

query, 4-60, 4-62

reference key field, 6-29

---

L

LARGEPROJECT table, B-42

leaf classes, 4-32, 4-44

linking classes and tables, B-19

locked files, 1-24

locking policies

about, 4-55

advanced options, 4-57

optimistic, 4-55

troubleshooting, C-2

Locking tab, 4-34

logging into a database, B-13, B-33

logging XML, 1-12, 2-2

Login General properties sheet, 8-10

Login Options tab, 8-12

Login Sequencing properties sheet, 8-11

logins, database, 3-3

look and feel, specifying, 1-11

---

M

maintainCache(), 4-19

management, source control, 1-20

Many-to-Many Mapping button, 6-36

Many-to-Many Mapping tab

General, 6-36, B-60

Source Reference, 6-38

many-to-many mappings

about, 6-35

creating, 6-36

relation table, 6-35

tutorial, B-59

mapping

class hierarchy, 4-68

descriptors, 4-3

relationship, 4-68, 6-2

to tables, 4-5

tutorial, B-19

Mapping Workbench. see OracleAS TopLink Mapping Workbench

mapping, relationship

about, 4-68, 6-2

aggregate object, 6-15

direct collection, 6-29

many-to-many, 6-35

one-to-many, 6-32

one-to-one, 6-20

mappings

about, 4-67, B-19

access types, 4-70

aggregate object, 6-15, B-57

amending the descriptor, 5-13

array, 7-2

bidirectional relationships, maintaining, 4-71

BLOB fields, 5-9

collection options, 4-73

direct, 4-67, 5-1, 5-2

direct access, 4-70

direct collection, 6-29, B-58

direct mappings, 5-2

direct-to-field, 5-1, 5-2, B-24

ejb-jar.xml file, 4-73

hierarchy, 4-68

many-to-many, 6-35, B-59

method access, 4-70

null values, 4-71

object relational, 7-2

object type, 5-1, 5-6, B-55

one-to-many, 6-32, B-30, B-53

one-to-one, 6-20, B-27, B-50

properties, 4-69

read-only setting, 4-70

serialized object, 5-1, 5-9

to database BLOB fields, 5-1

transformation, 5-1, 5-10, 5-13, B-63

type conversion, 5-1, 5-5

maps, identity, B-32

menu bar, 1-4

menus

about, 1-2, 1-4

menu bar, 1-4

pop-up menus, 1-5

merging files, 1-20

method access

about, 4-70

setting, 4-70

methods

getValue(), 6-7

JDBC drivers, 3-6

setting container policy, 6-5

setValue(), 6-7

wrapper policy, 4-55

Methods tab, 4-12

model source, exporting, 2-18

multimedia objects, mapping, 5-1

multiple tables

about, 4-48

specifying for descriptors, 4-49

tutorial, B-54

Multi-table Info tab, 4-49

mw_xml.log file, 2-2

mw_xml.txt file, 1-12

.mwp file, 2-1, 2-2, 4-2, B-5

---

N

named queries, 4-15

see also finders

Named Queries Format tab, 4-17

Named Queries General tab, 4-17

Named Queries Options tab, 4-18

Named Queries tab, 4-15

native sequencing, 4-37

NAVCHAR2 database type, 5-3, 5-5

Navigator pane

about, 1-3

example, 1-9, 8-2

refreshing, 2-5

NCHAR database type, 5-3, 5-5

NCLOB database type, 5-3, 5-5

neediness warnings, 1-10, 8-3

see also troubleshooting

nested table mappings

about, 7-1, 7-9

example, 7-10

Java, 7-10

properties, 7-11

NestedTableMapping class, 7-10

new project, creating, B-4

New Reference dialog box, 3-11

New Sessions File dialog box, 8-4

New Table dialog box, 3-5

non-native sequencing, B-25

non-transparent indirection, A-2

null value

in expressions, 4-21

nullValue attribute, 4-71

---

O

object array mappings

about, 7-4

example, 7-4

implementing in Java, 7-4

object identity, 4-58, 4-59

object model

advanced tutorial, B-39

OracleAS TopLink requirements, A-1

Object Type Mapping button, 5-7

Object Type Mapping tab, 5-7, B-56

object type mappings

about, 5-1, 5-6

creating, 5-7

null values, 4-71

tutorial, B-55

object, cache, 4-56

object-relational descriptors

about, 4-66, 4-67

mapping, 4-67

one-to-many mapping, B-30

One-to-Many Mapping button, 6-33

One-to-Many Mapping tab

General, 6-33, B-31, B-53

Table Reference, B-31, B-54

one-to-many mappings

about, 6-32, B-53

creating, 6-33, B-30

specifying advanced features, 4-72

one-to-one mapping, B-27

One-to-One Mapping button, 6-22

One-to-One Mapping tab

General, 6-22, B-28, B-51

Table Reference, 6-23, B-29, B-51

one-to-one mappings

about, 6-20

creating, 6-22, B-27, B-50

foreign key references, B-28

specifying advanced features, 6-23

variable, 6-24

one-way transformation mapping, 5-14

online help, 1-18

Open Configuration button, 8-4

Open Project button, 2-3

opening configurations, 8-4

opening projects, 2-3

optimistic locking

about, 4-55

advanced policies, 4-57

OptimisticLockException class, 4-57

optimization

inheritance, 4-42

queries, 6-14

Oracle

native sequencing, 4-39

pre-allocation, 4-38

sequence objects, 4-37

OracleAS TopLink

about, 1-1

see also OracleAS TopLink Mapping Workbench

OracleAS TopLink Mapping Workbench

about, 1-1

development process, 1-1

error messages, C-2

parts of, 1-2, 8-2

sample, 1-2

starting, 1-2

upgrading projects, 2-3

window, B-4

OracleAS TopLink Sessions Editor

about, 8-1

defaults, 8-7

starting, 8-2

outer-join, 4-31

---

P

package names

generating, 3-15

renaming, 2-11

packages, renaming, 2-11

password

encryption, 2-16

password, database login, 3-3

persistent class requirements, A-1, A-2

persistent classes

about, 4-2

Java, B-19

multiple tables, 4-72

project, 3-16

registering events, 4-64

requirements, A-1

types, 2-7

pessimistic locking, 4-55

PHONENUMBER table, B-4, B-41

platform, database, 2-2, 3-2

polymorphic relationships, 6-24

pop-up menus, 1-5

Potential EJB Descriptors dialog box, 2-3

pre-allocating sequence numbers, 2-9, 4-38

preferences

class import, 1-14

database, 1-17

EJB, 1-16

general, 1-11

help, 1-18

warnings, 1-13

workbench, 1-10

Preferences button, 1-11, 1-14, 1-16, 1-18

primary key

composite, 6-35

default, 2-11

inheritance, 4-44

multiple tables, 4-50

read-only settings, 4-71

search, 2-11

setting, 3-10, 4-5, 4-36

tutorial, B-21

variable class relationships, 6-24, 6-25

primary key search, 2-11

primkey, ejb-jar.xml file, 2-19

private relationships, 6-2

privately owned classes, B-28

PROJ_EMP table, B-42

project files, merging, 1-21

project objects, copying, 1-24

Project Options tab, 2-11

project status, 2-5

Project Status Report dialog box, 2-5

PROJECT table, B-42

projects

about, 2-2

class path, 2-6

creating, 2-2, B-4, B-45

defaults, 2-10

exporting, 2-16

general properties, 2-6

locked, 1-24

logging XML, 1-12, 2-2

merging, 1-21

merging files, 1-20

model, exporting, 2-18

.mwp file, 4-2

new, 2-2

open, 2-3

packages, renaming, 2-11

persistence type, 2-7

properties, 2-6

recently opened, 2-3

refreshing, 2-5

renaming, 2-4, 8-5

reopening, 2-3

saving, 2-4

status report, 2-5

team development, 1-19

troubleshooting, 1-12, 2-2

updating from ejb-jar.xml, 2-20

upgrading from 2.x or 3.x, 2-3

writing ejb-jar.xml, 2-19

properties

project, general, 2-6

setting default advanced, 2-13

proxies. see wrapper policy

proxy indirection

about, 6-12

implementing in Java, 6-14

public accessor methods, requirements, 4-2

---

Q

qualified names, database tables, 3-7

queries

ejb-jar.xml file, 4-12

optimizing, 6-14

Query Key Association tab, 6-28

query keys

about, 4-24, 4-60

adding, 4-25

automatically defining, 4-60, 4-72

creating, 4-25

interface descriptors, 4-60

relationship mappings, 4-62

specifying, 4-24

variable one-to-one mapping, 6-28

Query keys tab, 4-24

---

R

Read Only Files dialog box, 1-24

readAllObjects(), 4-14

reading ejb-jar.xml, 2-20

read-only files, 1-24

read-only mappings, 4-70

recently opened projects, 2-3

records, B-21

reference key field, 6-29

reference mappings

about, 7-1

example, 7-8

Java, 7-8

properties, 7-9

ReferenceMapping class, 7-8

references

about, 6-3

database tables, 3-10

foreign keys, C-2

refreshIdentityMapResults(), 4-18

refreshing

cache, 4-7

classes, 2-15

project tree, 2-5

relation table, 6-35

relational mappings, about, 7-1

relationship mappings

about, 4-68, 6-1, 6-2

aggregate object, 6-15

many-to-many, 6-35

one-to-one, 6-20

optimizing queries, 6-14

relationship partner, bidirectional, 4-71

relationship query keys, 4-62

relationship element, 4-73

relationships

bidirectional, 6-21

bidirectional, generating, 3-15

in ejb-jar.xml file, 2-19

polymorphic, 6-24

query keys, 4-62

variable class, 6-24

relative class path, 2-8

remote session requirements, A-2

Remove Class button, 2-16

Remove Table button, 3-7

Rename button, 8-3

renamer, project, 2-3

renaming

packages, 2-11

projects, 2-4, 8-5

renaming elements, 8-3

reopening projects, 2-3

reports, 2-5

requirements

constructors, A-2

remote session, A-2

reserved finders, 4-66

RESPONS table, B-42

root class

about, 4-43

inheritance mapping, 4-42

---

S

SALARY table, B-41

samples. see examples

Save All button, 8-5

Save All Projects button, 2-4

Save As button, 8-5

Save button, 8-5

Save Selected Project button, 2-4

schema manager, 4-39

schema, database, 2-11, 3-5

scripts

see also SQL

SQL, generating, 3-13

security, 8-11

password encryption, 2-16

Select, 5-4

Select Classes dialog box, 2-15

SelectedFieldsLockingPolicy, 4-57

sequence information, setting, 4-5

sequence numbers

about, 4-36, B-21

Entity Beans, 4-37

native in database, 4-37

pre-allocation, 4-38

projects, 2-9

sequence table

about, 4-38

tutorial, B-22

sequencing

classes, B-25

non-native, B-25

setting, B-25

Sequencing tab, 2-9, B-23

Serialized Mapping button, 5-9

Serialized Object Mapping tab, 5-9

serialized object mappings

about, 5-1, 5-9

creating, 5-9

server, Builder JDBC, B-5

Session, 5-10

session brokers

about, 8-5

adding sessions, 8-6

Session button, 8-7

Session Classes property sheet, 8-9

Session General property sheet, 8-8

sessions

adding to session broker, 8-6

advanced properties, 8-10

brokers, 8-5

creating, 8-7

default values, 8-7

errors, 8-3

remote, requirements, A-2

Sessions Editor. see OracleAS TopLink Sessions Editor

sessions, remote, A-2

sessions.xml file, 8-1

setTableName() method, 4-72

setting

sequence table, B-22

sequencing, B-25

setValue() method, 6-7

setWrapperPolicy(), 4-19, 4-55

single implementor interfaces, 4-47

soft cache weak identity map, 4-58

source control management

with OracleAS TopLink Mapping Workbench, 1-20

see also team development

source table, reference, 3-11

SQL (DDL) creation scripts, B-17

SQL Creation Script dialog box, 3-13

SQL scripts

binding arguments, 4-14

generating, 3-13

generating from database tables, 3-13

SQL Server, sequence numbers, 4-37

SQL, using custom code, 4-71

stale data, avoiding, 4-55

starting the OracleAS TopLink Mapping Workbench, 1-2

starting the OracleAS TopLink Sessions Editor, 8-2

starting the workbench, B-4

Status bar, about, 1-3

status report, generating, 2-5

structure mappings

about, 7-1

example, 7-6

Java, 7-6

properties, 7-7

StructureMapping class, 7-6

subclasses, finding in inheritance, 4-42

Sybase, sequence numbers, 4-37

---

T

table files

creating in code, B-33

creating in OracleAS TopLink Mapping Workbench, B-15

importing, B-17

merging, 1-22

table generation properties, 2-11

table-class relationships, B-10, B-43

table-class, linking, B-19

tables

ADDRESS, B-3, B-41

creating in code, B-33

database, 3-4

EMPLOYEE, B-3, B-40

EMPLOYEE2, B-41

import filter, 3-6

LARGEPROJECT, B-42

mapping to descriptors, 4-5

multiple, 4-48

name, 3-5

PHONENUMBER, B-4, B-41

primary key, 3-10

PROJ_EMP, B-42

PROJECT, B-42

RESPONS, B-42

see also database tables

tables, database

creating, B-15

creating in OracleAS TopLink Mapping Workbench, B-15

importing, B-17

linking to classes, B-19

primary keys, B-21

target descriptor in aggregate object mappings, 6-18

target foreign key, 6-21

target table, reference, 3-11

team development, 1-19

TimestampLockingPolicy, 4-56

toolbars

about, 1-2, 1-5, 1-8

TopLink. see OracleAS TopLink

transactions, B-34

Transformation Mapping button, 5-11

Transformation Mapping tab, 5-11, B-64

transformation mappings

about, 5-1, 5-10

creating, 5-11

example, 5-12, 5-13

one-way, 5-14

tutorial, B-63

TransformationMapping class, 5-13

transparent indirection

about, 6-10

persistent class requirements, A-2

specifying, 6-11

troubleshooting, C-2

troubleshooting projects, 1-12, 2-2

tutorials

advanced, B-38

introductory, B-2

Type Conversion Mapping button, 5-5

Type Conversion Mapping tab, 5-6

type conversion mappings

about, 5-1, 5-5

creating, 5-5

provided by direct-to-field mappings, 5-3

---

U

uni-directional relationships, 6-1

unit of work, 6-23

conform query results, 4-6

updating methods in, 4-65

units of work

about, B-34

reading an object, B-37

using, B-36

updateObject(), 4-14

updating descriptors from ejb-jar.xml, 2-8

upgrading OracleAS TopLink Mapping Workbench projects from prior versions, 2-3

URL for database login, 3-3

Use Indirection checkbox, 5-12, 6-11

useCollectionClass(Class), 6-5

useMapClass(Class, String), 6-5

useProxyIndirection(), 6-14

using source control management, 1-20

---

V

value holder indirection, C-2

value holders, 6-7, B-47

ValueHolderInterface class, 6-7, 6-35, A-2

variable class relationships, interfaces, 4-45

Variable One-to-One Mapping button, 6-27

Variable One-to-one Mapping tab

Class Indicator Info, 6-28

General, 6-27

Query Key Associations, 6-28

variable one-to-one mappings

about, 6-24

creating, 6-26

interfaces, 4-47

VariableOneToOneMapping class, 6-24

Varray (Oracle). see array mappings

verification, one-to-one mappings, 6-23

version control, 1-24

version fields, 4-55, 4-56

version locking policies, 4-56

VersionLockingPolicy, 4-56

---

W

warning icon, 1-10, 8-3

warnings and confirmations, preferences, 1-13

Warnings Preferences dialog box, 1-13

weak identity map, 4-58

web browser, specifying, 1-18

workbench preferences, 1-10

wrapper policy

about, 4-54

implementing in Java, 4-55

write-locking, 4-55

writing ejb-jar.xml, 2-19

---

X

XML

generating deployment, 2-17

logging, 1-12, 2-2

XMLProjectReader class, 2-1

---

Z

zero-argument constructors

editing, 1-16