Oracle9iAS Containers for J2EE Enterprise JavaBeans Developer's Guide -- Index

<abstract-schema-name> element, 5-4, 5-7

<assembly-descriptor> element, B-20, B-21

<caller> element, B-21

<cascade-delete/> element, 4-9

<cmp-field-mapping> element, 4-24, 4-25, 4-27, 4-31, B-9, B-21

<cmr-field> element, 3-19, 4-6, 4-12, 4-27, 4-31

<cmr-field-name> element, 4-4, 4-6

<cmr-field-type> element, 4-6

<collection-mapping> element, 4-26, 4-27, 4-30, B-21

<context-attribute> element, B-22

<default-method-access> element, 8-36, B-20, B-22

<delay-updates-until-commit> attribute, B-23

<description> element, B-22

<ejb> element, 2-13

<ejb-link> element, 8-18, 8-19

<ejb-location> element, 6-11

<ejb-mapping> element, 8-19

<ejb-module> element, 8-8

<ejb-name> element, 8-19, B-22

<ejb-ql>, 5-4

<ejb-ql> element, 5-8

<ejb-ref> element, 8-2, 8-6, 8-19

<ejb-ref-mapping> element, 8-19, B-5, B-9, B-14, B-22

<ejb-ref-name> element, 8-2, 8-19, 8-20

<ejb-ref-type> element, 8-19

<ejb-relation> element, 4-6

<ejb-relation-name> element, 4-6

<ejb-relationship-role> element, 4-6

<ejb-relationship-role-name> element, 4-6

<enterprise-beans> element, B-3, B-23

<entity-deployment> element, 4-20, 4-24, 8-10, 8-12, B-7, B-8, B-23

<entity-ref> element, B-25

<env-entry> element, 8-15

<env-entry-mapping> element, B-5, B-9, B-14, B-25

<env-entry-name> element, 8-15

<env-entry-type> element, 8-15

<env-entry-value> element, 8-15

<fields> element, B-26

<finder-method> element, 5-3, B-9, B-26

<group> element, B-26

<home> element, 8-19

<ior-security-config> element, B-4, B-8, B-26

<java> element, 2-13

<jem-deployment> element, B-16, B-27

<jem-server-extension> element, B-16, B-27

<jndi-name> element, 8-19, 8-23, 8-25

<list-mapping> element, B-27

<lookup-context> element, B-27

<map-key-mapping> element, B-27

<map-mapping> element, B-28

<mapping> element, 8-19, 8-23, 8-25

<max-tx-retries> element, 8-11

<message-driven> element, 7-10

<message-driven-deployment> element, B-13, B-14, B-28

<method> element, B-18, B-19, B-28

defined, 8-31

<method-intf> element, B-29

<method-name> element, 5-4, B-29

<method-param> element, 5-8, B-29

<method-params> element, B-29

<method-permission> element, 8-28, 8-29, 8-31

<module> element, 2-13

<multiplicity> element, 4-6

<orion-ejb-jar> element, B-3, B-29

<persistence-type> element, 6-11

<prim-key-class> element, 3-9, 6-4, A-8

<primkey-mapping> element, 4-28, B-8, B-29

<properties> element, B-29

<query> element, 5-2, 5-3, 5-4, 5-8

<query> element., 5-6

<relationship-role-source> element, 4-6

<relationships> element, 4-5, 4-26

<remote> element, 8-19

<res-auth> element, 8-23, 8-26

<resource-env-ref> element, 7-15

<resource-env-ref-mapping> element, B-5, B-9, B-14, B-30

<resource-ref> element, 6-11, 7-15

<resource-ref-mapping> element, 8-23, 8-25, B-5, B-9, B-14, B-30

<res-ref-name> element, 8-23, 8-25

<res-type> element, 8-23, 8-26

<result-type-mapping> element, 5-4

<role-link> element, 8-28, 8-29, 8-30

<role-name> element, 8-28, 8-29

<run-as> element, 8-33

<security-identity> element, 8-33

<security-role> element, 8-28, 8-29

<security-role-mapping> element, 8-34, 8-35, B-20, B-30

<security-role-ref> element, 8-28, 8-29

<session-deployment> element, B-4, B-31

<set-mapping> element, B-32

<unchecked/> element, 8-33

<use-caller-identity/> element, 8-34

<user> element, B-32

<value-mapping> element, B-32

<value-mapping> element, 4-28

<web> element, 2-13

AC4J, 10-1 to 10-62

Active Components for Java, see AC4J

application.xml file, 2-13, 7-4

example, 2-14

overview, 2-13

archiving

directions, 2-12

EAR file, 2-14

EJBs, 2-12

associateUsingThirdTable option, 4-30

bean

accessing remotely, 1-8

activation, 1-12

creating, 2-4, 3-3, A-2

environment, 1-14

implementation, 2-8

interface, 1-7

overview, 1-1

passivation, 1-12

removal, 2-15

steps for invocation, 1-8

bean-managed persistent, see BMP

BMP

create database tables, 6-12

creation process, 6-2

defined, 6-1

deployment descriptor, 6-11

ejbCreate implementation, 6-3

home and remote interfaces, 6-3

implementation details, 6-3

persistence, 1-20

cache-timeout attribute, B-15

called-by attribute, B-21

caller-identity attribute, B-21

call-timeout attribute, B-5, B-9, B-23, B-31

ClassCastException, 8-8, 8-44

clustering, 9-1 to 9-9

concurrency mode effect, 8-13

deploying application to all nodes, 9-8

clustering-schema attribute, B-23

CMP

data types, 3-17

overview, 1-21

persistence update configuration, 8-14

CMR

cardinality, 4-6

cascade delete option, 4-9

default mapping, 4-11

define get/set methods, 4-4

deployment descriptor, 4-5

direction, 4-6

explicit relationship mapping, 4-19

many-to-many, 4-3, 4-7, 4-14

many-to-one, 4-3, 4-6

mapping relationships, 4-10

one-to-many, 4-3, 4-6, 4-14, 4-26, 4-30

one-to-one, 4-2, 4-6, 4-13, 4-22

relationship definition, 4-3

types of relationships, 4-2

Collections, 3-19

command-line options

performance settings, 8-38

concurrency modes, 8-10

clustering, 8-13

connection-factory-location attribute, B-28

context

session, 1-14

transaction, 1-14

copy-by-value attribute, B-6, B-10, B-23, B-31

create method, 2-15, 3-3, 3-4, 3-5, 6-2, A-2, A-3

EJBHome interface, 1-9, 2-4

CreateException, 2-5, 2-6

data types, 3-17

data-bus attribute, B-22

data-source attribute, B-10, B-23

DataSource object, 8-21

data-source-location attribute, B-27

data-sources.xml file, 6-11, 6-12

DBMS_AQADM package, 7-5

deadlock

recovery, 8-44

dedicated.connection setting, 8-38

dedicated.rmicontext setting, 8-38

DefineColumnType setting, 8-38

delay-updates-until-commit attribute, B-13

deployment descriptor, 1-9, 2-11, 3-3, 6-3, A-2

BMP, 6-11

EJB QL, 5-4

EJB reference, 8-16

entity bean, A-10, B-7

environment variables, 8-15

JDBC DataSource, 8-20

MDB, 7-3

message-driven bean, B-13

security, 8-28, 8-29, 8-35

session bean, B-5

destination-location attribute, B-28

disable-wrapper-cache attribute, 8-14, B-23

disble-wrapper-cache attribute, B-12

DNS round-robin, 8-7, 8-43

do-select-before insert attribute, B-23

do-select-before-insert attribute, B-10

DTD file, 2-11

dynamic cluster discovery, 9-3

EAR file, 2-1

creation, 2-14

EJB

archive, 2-12

client

setting JMS port, 8-6

setting RMI port, 8-6

clustering, 9-1 to 9-9

creating, 2-2, 2-4, 2-8, 3-3, A-2

deployment descriptor, 2-11

development suggestions, 2-2

difference between session and entity, 1-25

home interface, 2-4

JAR file, 3-4, 6-3, 7-4, A-2

local interface, 2-7

overview, 1-1

parameter passing, 1-10

referencing other EJBs, 8-8, 8-44

remote interface, 2-6

replication, 9-7

security, 8-27

setting pool size, 8-13

standalone client, 8-6

EJB QL

?1, 5-8

deployment descriptor, 5-4

DISTINCT keyword, 5-8

documentation, 5-1

finder method

example, 5-5

overview, 5-2

input parameter syntax, 5-8

overview, 5-2

query methods, 5-2

select method

example, 5-7

overview, 5-3

statement example, 5-5, 5-6

EJB Query Language, see EJB QL

ejbActivate method, 1-12, 1-19, 6-3, 6-9, 6-10

EJBContext interface, 1-13

ejbCreate method, 1-18, 1-19, 1-21, 2-4, 3-3, 6-2, 6-3, A-2

initializing primary key, 6-3

MDB, 7-3

SessionBean interface, 1-12

EJBException, 2-5, 2-6, 2-7

ejbFindByPrimaryKey method, 1-21, 6-3, 6-7, A-2

EJBHome interface, 2-4, 2-5, 3-3, 3-4, 6-2, A-2

create method, 3-3, 3-4, 3-5, 6-2, A-2, A-3

findByPrimaryKey method, 3-3, 3-5, 6-2, A-2, A-3

ejb-jar.xml file, 2-11, 6-11

ejbLoad method, 1-18, 1-20, 1-21, 1-22, 6-3, 6-9

EJBLocalHome interface, 2-4, 2-6, 3-3, 3-4, 6-2

EJBLocalObject interface, 2-4, 2-7, 3-3, 3-5, 6-2

ejb-name attribute, B-27

EJBObject interface, 2-4, 2-6, 3-3, 3-5, 6-2, A-2, A-4

ejbPassivate method, 1-12, 1-19, 6-3, 6-9

ejbPostCreate method, 1-18, 1-21, 3-3, 6-2, A-2

ejb-reference-home attribute, B-21

ejbRemove method, 1-12, 1-18, 1-20, 1-21, 6-10

MDB, 7-3

ejbStore method, 1-18, 1-20, 1-21, 6-2, 6-8

Enterprise Archive file, see EAR file

Enterprise Java Beans, see EJB

entity bean

class implementation, 3-6, A-4

clustering, 9-4

context information, 1-19

creating, 1-19, 3-3, 3-4, A-2, A-3

deploy, A-10

deployment descriptor, B-7

finder methods, 3-4, 6-3, A-3

home interface, 3-4, A-3

overview, 1-11, 1-16

persistent data, 1-17, 1-20

primary key, 1-17

relationships, see CMR

remote interface, 3-5, A-4

removing, 1-20

EntityBean interface, 1-10, 1-17, 1-21, 2-4, 3-3, 6-2, A-2

ejbActivate method, 1-19, 6-3

ejbCreate method, 1-18, 1-19, 1-21

ejbFindByPrimaryKey method, 1-21, A-2

ejbLoad method, 1-18, 1-20, 1-21, 1-22, 6-3

ejbPassivate method, 1-19, 6-3

ejbPostCreate method, 1-18

ejbRemove method, 1-18, 1-20, 1-21

ejbStore method, 1-18, 1-20, 1-21, 6-2

setEntityContext method, 1-18, 1-19, 1-22

unsetEntityContext method, 1-19

environment references

URL, 8-25

environment, retrieval, 1-14

exclusive-write-access attribute, 8-12, B-10, B-23

findByPrimaryKey method, 3-3, 6-2, A-2

finder method

backwards compatibility, 5-3

EJB QL example, 5-5

overview, 5-2

finder methods, 6-3

BMP, 6-7

entity bean, 3-4, A-3

findByPrimaryKey method, 3-5, A-3

force-update attribute, B-13

getEJBHome method, 1-14

getEnvironment method, 1-14

getRollbackOnly method, 1-14

getUserTransaction method, 1-14

global-thread-pool element, 8-39

home interface

creating, 2-4, 3-3, 6-2, A-2

lookup, 2-15

overview, 1-8, 1-9

immutable attribute, B-32

impliesAll attribute, 8-36, B-31

InitialContext, 8-38

instance-cache-timeout attribute, B-10, B-23

isCallerInRole method, 8-29

isolation attribute, 8-10, B-11, B-24

isolation modes, 8-10

JAR

archiving command, 2-12

jar command, 2-12

JAR file, 3-4, 6-3, 7-4, A-2

EJB, 2-12

Java mail

Session object, 8-22

jem-name attribute, B-27

JMS

handled by MDB, 1-23

port, 8-6

JNDI

lookup, 2-15

listener-threads attribute, 7-12, B-15, B-28

Lists, 3-19

load balancing, 9-9

DNS round-robin, 8-7

LoadBalanceOnLookup property, 9-9

local home interface

example, 2-6

local interface

creating, 2-7

example, 2-8

local-wrapper attribute, B-7, B-13, B-24, B-31

location attribute, B-6, B-10, B-24, B-27, B-30, B-31

locking-mode attribute, 8-12, B-11, B-24

mail

Session object, 8-22

mapping

relationships, 4-19

max-instances attribute, 8-14, B-6, B-11, B-15, B-24, B-31

max-tx-retries attribute, B-6, B-12, B-24, B-31

MDB

configuration, 7-10

creation, 7-3

deployment descriptor, 7-3

overview, 1-11, 1-23, 7-1

performance, 7-12, B-28

transaction timeout, 7-13, B-28

message-driven bean

deployment descriptor, B-13

Message-Driven Beans, see MDB

MessageDrivenBean interface, 1-24, 7-3

setMessageDrivenContext method, 7-3

MessageListener interface, 1-24, 7-3

onMessage method, 7-3

min-instances attribute, 8-14, B-6, B-11, B-15, B-24, B-31

name attribute, B-6, B-12, B-15, B-24, B-28, B-31, B-32

narrowing, 2-15

onMessage method, 1-24, 7-3

optimisitic concurrency mode, 8-11

optimistic concurrency mode, B-11, B-24

ORA-8177 exception, 8-13

oracle.dms.gate setting, 8-38

packaging

referenced EJB classes, 8-8, 8-44

parameters

object types, 1-10

passing conventions, 1-10

parent application, 8-9

partial attribute, B-26

pass by reference, 1-10

pass by value, 1-10

performance setting

command-line options, 8-38

dedicated.connection, 8-38

dedicated.rmicontext, 8-38

DefineColumnType, 8-38

DNS load balancing option, 8-7, 8-43

oracle.dms.gate, 8-38

statement caching, 8-42

task manager granularity, 8-42

thread pools, 8-39

performance settings, 8-38 to 8-43

permissions, 8-27

persistence

bean-managed, 1-20

container-managed, 1-21

container-managed vs. bean-managed, 1-22

create database tables, 6-12

data management, 1-19

field modification, 8-14

managing, 3-4, A-2

managing in BMP, 6-3

overview, 1-17

persistence-filename attribute, B-6, B-32

persistence-name attribute, 4-25, 4-31, B-21

persistence-type attribute, B-21

pessimistic concurrency mode, B-11, B-24

pessimistic conncurrency mode, 8-11

pool

setting size, 8-13

pool-cache-timeout attribute, B-5, B-12, B-25, B-31

PortableRemoteObject

narrow method, 2-15

primary key, 3-3, 6-2, A-2

complex class, 6-6

complex definition, 6-4

creating, 6-3

entity bean, 1-21, 3-9, A-8

management, 1-19

overview, 1-17, 3-9, A-8

simple definition, 6-4

PropertyPermission, 8-27

query attribute, B-26

read-only concurrency mode, 8-12, B-11, B-24

remote home interface

example, 2-5

remote interface

business methods, 2-15

creating, 2-4, 2-6, 3-3, 6-2, A-2

example, 2-7

overview, 1-8, 1-9

RemoteException, 2-5, 2-7

remove method, 2-15

EJBHome interface, 1-9

RMI

port, 8-6

RMILBInitialContextFactory, 8-7, 8-43

runAs security identity, 8-33

RuntimePermission, 8-27

scheduling-threads attribute, B-27

security, 8-27

permissions, 8-27

SecurityException, B-16

security-identity element, B-30

select method

EJB QL example, 5-7

overview, 5-3

Serializable interface, 1-11

session bean

class implementation, 1-10

context, 1-12

deployment descriptor, B-4, B-5

local home interface, 2-6

methods, 1-12

overview, 1-11

remote home interface, 2-5

removing, 1-12

stateful, 1-8, 1-15

stateless, 1-8, 1-14

Session object, 8-22

SessionBean interface, 1-10

EJB, 1-11, 2-4

ejbActivate method, 1-12

ejbCreate method, 1-12

ejbPassivate method, 1-12

ejbRemove method, 1-12

setSessionContext method, 1-12

SessionContext

interface, 1-13

setEntityContext method, 1-18, 1-19, 1-22

setMessageDrivenContext method, 1-24, 7-3

setRollbackOnly method, 1-14

setSessionContext method, 1-12, 1-20

setStmtCacheSize method, 8-42

SocketPermission, 8-27

stateful session bean

clustering, 9-4

overview, 1-15

stateless session bean

clustering, 9-4

overview, 1-14

statement caching

DataSource

statement caching, 8-42

static cluster discovery, 9-2

stmt-cache-size attribute, 8-42

subscription-name attribute, B-15, B-28

table attribute, B-12, B-25, B-27, B-28

task manager granularity, 8-42

taskmanager-granularity attribute, 8-42

thread

pooling, 8-39

TimedOutException, B-5, B-9

timeout attribute, B-7, B-32

transaction

commit, 1-14

context propagation, 1-14

retrieve status, 1-14

rollback, 1-14

TRANSACTION_READ_COMMITTED, 8-10

TRANSACTION_SERIALIZABLE, 8-10

transaction-timeout attribute, 7-13, B-15, B-28

type attribute, B-28, B-33

unsetEntityContext method, 1-19, 1-22

update-changed-fields-only attribute, 8-14, B-12, B-25

validity-timeout attribute, B-13, B-25

wrapper attribute, B-7, B-13, B-25, B-32

XML

BMP, 6-11

deployment descriptor, 3-3, 6-3, A-2

Index

Symbols

A

B

C

D

E

F

G

H

I

J

L

M

N

O

P

Q

R

S

T

U

V

W

X