Oracle8
i
Enterprise JavaBeans Developer's Guide and Reference
Release 3 (8.1.7)
Part Number A83725-01
Library
Solution Area
Contents
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
Y Z
Symbols
<assembly-descriptor> section, 2-23,
2-24,
A-3,
A-14
<attr-mapping> element, A-30
<cmp-field> element, 4-31,
4-35,
A-6,
A-29
<column-name> element, A-30
<container-transaction> element, 2-24,
A-20
<ejb-class> element, A-4
<ejb-client-jar> element, 2-26,
A-33
<ejb-jar> element, 2-23,
A-3
<ejb-link> element, A-10,
A-11
<ejb-mapping> element, A-10,
A-11,
A-24
<ejb-name> element, 2-23,
2-24,
A-4,
A-10
<ejb-ref> element, A-10,
A-11
<ejb-ref-name> element, 4-36,
A-10,
A-11,
A-12
<ejb-ref-type> element, A-11
<enterprise-beans> section, 2-23,
A-3,
A-4
<entity> element, A-4
<env-entry> element, A-9
<env-entry-name> element, A-9
<env-entry-type> element, A-9
<env-entry-value> element, A-9
<field-name> element, A-30
<home> element, A-4,
A-11
<jndi-name> element, 2-26,
A-10,
A-11,
A-13,
A-24
<mapping> element, A-10,
A-13
<mappings> element, A-23
<method> element, 2-25,
A-21,
A-27
defined, A-17
<method-intf> element
defined, A-18
<method-name> element, A-21,
A-27
<method-permission> element, 2-24,
A-15
<mode> element, 2-25,
A-27
<oracle-descriptor> element, A-24
<persistence-deployer> element, A-28
<persistence-name> element, A-28,
A-29
<persistence-provider> element, A-28
<persistence-type> element, A-6
<prim-key-class> element, 4-12,
4-31,
A-6
<primkey-field> element, 4-31,
A-6
<PSI-RI> element, A-30
<reentrant> element, A-14
<remote> element, A-4,
A-11
<res-auth> element, 4-37,
A-13
<resource-ref> element, 4-37
<resource-ref-mapping> element, A-13,
A-24
<res-ref-name> element, 4-37,
A-13,
A-24
<res-type> element, 4-37,
A-13
<role-link> element, A-15
<role-name> element, A-15,
A-25,
A-27
<run-as> element, 2-25,
4-24,
A-2,
A-26,
A-27
<schema> element, A-30
<security-role> element, 2-24,
A-15,
A-25,
A-27
<security-role-mapping> element, A-25
<security-role-ref> element, A-14,
A-15
<serialize-mapping> element, A-31
<session> element, 2-23,
A-4
<table> element, A-30
<transaction-manager> element, 7-30
defining 2pc engine, A-21
<transaction-type> element, A-14,
A-19
<trans-attribute> element, A-20
A
ACID properties, 7-2
acronyms, C-1
activation, 2-8,
4-22
ADDRESS parameter, 3-11,
3-16
afterBegin method, 7-40
afterCompletion method, 7-41
applet
invoking server objects from, 5-29
sandbox security restrictions, 5-29
APPLET_CLASS property, 5-29
aurora_client.jar file, 6-10
AuroraCertificateManager class, 6-23,
6-25
setCertificateChain method, 6-24
setEncryptedPrivateKey method, 6-24
AuroraCurrentManager class, 6-20
aurora.zip, 5-28
authenticate method, 5-20,
6-11
authentication
defined, 6-5
logout, 5-19,
6-11
server-side, 6-20
using SSL, 6-3
B
bean
accessing remotely, 2-2
creating, 2-3,
4-9
deployment, 2-20
entity, 4-3
environment, 2-10
interface, 2-2
naming conventions, 2-4
removing, 2-5
retrieving reference, 2-17
session, 2-10,
4-2
testing equality, 2-5
bean-managed persistence, 4-9,
4-19
beforeCompletion method
SessionSynchronization interface, 7-40
begin method, 7-16,
7-22
bindds command, 7-22,
7-38
bindut command, 7-17,
7-30
C
callback
client-side authentication, 6-25
server-side authentication, 6-22
using SSL, 6-21
callout
using SSL, 6-21
certificates, 6-20,
6-21,
6-24
manager, 6-23,
6-24
ClassLoader property, 5-30
client
access existing bean, 5-23
CLIENT_IDENTITY property, 2-25,
A-26
client-side authentication, 6-5
Collection, 4-11,
4-18
commit method, 7-16,
7-17,
7-22
configuring, 3-1 to
3-19
direct to dispatcher, 3-16
IIOP clients, 3-1 to
3-19
SSL over TCP/IP, 3-17
container-managed persistence, 4-28
defining data fields, 4-34
deploying, A-6,
A-28
managing primary key, 4-33
Context
JNDI object, 5-9
context
session, 2-10
transaction, 2-10
Context object
JNDI context, 2-16
JNDI object, 2-16
CosNaming service, 2-15,
5-2
create method, 2-12,
2-18,
4-10,
4-11
EJBHome interface, 2-2,
2-3,
2-6
CreateException, 2-6
D
data integrity, 6-3
Database Configuration Assistant, 3-8
DataSource object, A-13
binding in namespace, 7-22
create dynamically, 7-38
getConnection method, 7-8,
7-26
DebugAgent class, 2-29
restart method, 2-29
stop method, 2-29
debugging techniques, 2-28
deployejb tool, 2-19,
2-21,
2-26
deployment descriptor, 1-6,
2-3,
2-19,
4-10,
A-1
bean identity, 2-25
bean names, A-4,
A-23
bean type, A-4
EJB reference, A-9
entity bean, 4-24
environment variables, A-8
JDBC DataSource, A-12,
A-24
mapping logical names, A-23
Oracle-specific elements, A-22
persistence, A-5
reentrancy, A-14
run-as identity, A-26
security, 2-24,
A-14,
A-15,
A-25
transactions, 2-24,
A-14,
A-19
XML, 2-20
DESCRIPTION parameter, 3-10
dispatchers
configuration, 3-11
connecting directly, 3-11
overview, 3-11
DriverManager class
getConnection method, 7-7,
7-26
DTD file, 2-21,
2-22,
A-3,
A-22
E
EJB
application developer role, 1-3
basic concepts, 1-2,
1-7
container vendor role, 1-3
creating beans, 2-3,
4-9
deployment, 1-2,
2-19,
2-20
deployment descriptor, 1-2,
A-1
developer role, 1-2
difference between session and entity, 4-5
parameter passing, 2-13
programming restrictions, 2-28
remote interface, 2-4
security, 1-2
server vendor role, 1-3
URL for retrieving, 2-17
ejbActivate method, 2-8,
4-7,
4-22
EJBContext interface, 2-9
ejbCreate method, 2-3,
2-6,
4-6,
4-7,
4-10,
4-11,
4-17,
4-28
initializing primary key, 4-14
EJBException, 2-6
ejbFindByPrimaryKey method, 4-10,
4-14,
4-29
EJBHome interface, 2-3,
2-4,
2-6,
4-10
create method, 4-10,
4-11
findByPrimaryKey method, 4-10,
4-11
ejb-jar file, 2-3,
4-10
ejbLoad method, 4-7,
4-9,
4-19,
4-29
EJBMetaData interface, 2-6
EJBObject interface, 2-3,
2-4,
4-9,
4-12
ejbPassivate method, 2-8,
4-7,
4-22
ejbPostCreate method, 4-6,
4-10,
4-17,
4-28
ejbRemove method, 2-8,
4-6,
4-9,
4-21,
4-29
ejbStore method, 4-7,
4-9,
4-19,
4-29
endpoint, 3-13
IIOP registration, 3-15
endSession method, 5-19
Enterprise JavaBeans, see EJB
entity bean
activation and passivation, 4-22
bean-managed persistence, 4-19
class implementation, 4-15,
4-17
context information, 4-8,
4-22
creating, 4-7,
4-9,
4-10,
4-25
deploy, 4-24
destroying, 4-21
finder methods, 4-10,
4-11,
4-14,
4-29
home interface, 4-10,
4-26
overview, 1-9,
4-2,
4-3,
4-5
persistent data, 4-2,
4-9
primary key, 4-10
remote interface, 4-12,
4-16
removing, 4-9
retrieving reference, 4-26
EntityBean interface, 2-3,
2-8,
4-2,
4-6,
4-10,
4-28
ejbActivate method, 4-7,
4-22
ejbCreate method, 4-6,
4-7,
4-11,
4-28
ejbFindByPrimaryKey method, 4-10,
4-29
ejbLoad method, 4-7,
4-9,
4-19,
4-29
ejbPassivate method, 4-7,
4-22
ejbPostCreate method, 4-6
ejbRemove method, 4-6,
4-9,
4-21,
4-29
ejbStore method, 4-7,
4-9,
4-19,
4-29
implementation, 4-17
setEntityContext method, 4-7,
4-8,
4-22,
4-29
unsetEntityContext method, 4-7
Enumeration, 4-11
environment
defining EJB references, 4-36
locating DataSource, 4-37
retrieve, 2-10
exceptions
creating, 2-7
F
findByPrimaryKey method, 4-10
finder methods, 4-14,
4-29
ejbFindByPrimaryKey method, 4-18
entity bean, 4-11
findByPrimaryKey method, 4-11
where clause finder method, 4-29
G
General Inter-Orb Protocol, see GIOP
getEJBHome method, 2-5,
2-10,
2-13
getEnvironment method, 2-10
getHandle method, 2-5
getPrimaryKey method, 2-5
getRollbackOnly method, 2-10
getUserTransaction method, 2-10
GIOP
dispatcher configuration, 3-11
oracle.aurora.server.SGiopServer, 3-9
presentation, 3-2
H
hand off, 3-14
handle
retrieving, 2-5
home interface
creating, 2-3,
4-9
example, 2-7
getEJBHome method, 2-13
lookup, 2-12
overview, 1-6
requirements, 2-4
retrieving, 2-5
I
iAS
deploying EJBs, 2-20
IIOP, 1-4,
3-2,
5-15
clients
connecting to dispatchers, 3-11
session-based, 3-9
MTS_DISPATCHER, 3-3
profile, 5-13
SSL support, 3-17
IIOP clients
configuring, 3-1 to
3-19
InitialContext object, 2-16,
5-12
in-session activation, 5-24
Internet Inter-Orb Protocol, see IIOP
isIdentical method, 2-5
J
JAR file, 2-3,
2-20,
4-10
Java Naming and Directory Interface, see JNDI
javax-ssl-1_1.jar, 5-11,
6-4
javax-ssl-1_2.jar, 5-11,
6-4
JDeveloper
debugging, 2-28
JNDI, 2-12
Context object, 5-9
EJB lookup, 4-25
initial context, 5-2
InitialContext constructor, 5-12
lookup method, 5-7,
5-12
overview, 2-15
retrieving JDBC DataSource, 4-37
retrieving references, 2-15
storing EJB references, 4-36
URL syntax, 4-25
jssl-1_1.jar, 5-11,
6-4
jssl-1_2.jar, 5-11,
6-4
JTA
bean-managed, 7-14
client-side demarcation, 7-16
container-managed, 7-13
enlisting resources, 7-7,
7-25
limitations, 7-13
nested transactions, 7-13
overview, 7-2
specification web site, 7-1
timeout, 7-39
two-phase commit, 7-8,
7-29
L
LDAP, 2-15
listener, 3-11
dynamic registration of endpoints, 3-15
endpoint, 3-13
hand off, 3-14
overview, 3-11
redirection, 3-12,
3-13
login
non-JNDI login, 5-19,
6-11
Login class, 5-5,
6-11
LoginServer class, 6-11
authenticate method, 5-20,
6-11
logout method, 5-19,
6-11
LogoutServer class, 5-19,
6-11
lookup method, 2-17,
5-11,
5-12
M
Mandatory transaction attribute, 7-6,
A-20
metadata, 2-6
MTS_DISPATCHERS parameter
ADDRESS attribute, 3-16
overview, 3-3
PRESENTATION attribute, 3-9,
3-10,
3-17
PROTOCOL attribute, 3-9
N
namespace, 5-3
Net8 Assistant
configuring for IIOP clients, 3-6,
3-10
Never transaction attribute, 7-7,
A-20
NON_SSL_LOGIN value, 2-16,
5-2,
5-10
NotSupported transaction attribute, 7-6,
A-20
O
object activation, 5-28
in-session, 5-24,
5-29
oracle.aurora.server.SGiopServer, 3-9
OracleDriver class
defaultConnection method, 7-7,
7-26
OracleJTADataSource class, 7-39
ORB
initialization, 6-24
ORBClass property, 5-31
ORBdisableLocator property, 5-31
ORBSingletonClass property, 5-31
OSS.SOURCE.MY_WALLET parameter, 3-19
P
parameters
passing conventions, 2-13
pass by reference, 2-13
pass by value, 2-13
passivation, 2-8,
4-22
persistence
bean-managed, 4-9
container-managed, 4-28,
4-34
container-managed vs. bean-managed, 4-27
create database tables, 4-23
data initialization, 4-17
data management, 4-7
deployment descriptor, 4-34,
A-2,
A-6
managing, 4-10,
4-28
overview, 4-2
PSI-RI, 4-28
persistence provider, 4-34
Persistence Service Interface Reference Implementation, see PSI-RI
presentation
GIOP, 3-2,
3-9
oracle.aurora.server.SGiopServer, 3-9
PRESENTATION attribute, 3-9,
3-10,
3-11,
3-17
primary key, 4-10
complex, 4-32
creating, 4-14
entity bean, 4-31
finder method, 4-18
identify entity bean, 4-10
intializing, 4-33
management, 4-7
overview, 4-2,
4-12
restriction, A-6
PROTOCOL attribute, 3-9
PROTOCOL_STACK parameter, 3-11
PSI-RI, 4-28,
A-28
published object
permissions, 5-4
R
RAW session layer, 3-11
redirection, 3-12,
3-13,
3-16
regep tool, 3-15,
3-16
remote interface, 2-12,
4-16
creating, 2-3,
2-4,
4-9
example, 2-5
overview, 1-6,
2-2
requirements, 2-4
Remote Method Invocation
see
RMI
remote object
access, 1-2
definition, 4-3
RemoteException, 2-6
remove method, 2-12
EJBHome interface, 2-3,
2-5
Required transaction attribute, 7-6,
A-20
RequiresNew transaction attribute, 7-6,
A-20
restart method, 2-29
restrictions, 2-28
RMI, 2-4
rollback method, 7-16,
7-17,
7-22
S
Secure Socket Layer, see SSL
SECURITY_AUTHENTICATION property, 2-16,
5-10
SECURITY_CREDENTIALS property, 2-16,
5-10
SECURITY_PRINCIPAL property, 2-16,
5-10
SECURITY_ROLE property, 2-16,
5-10
Serializable interface, 2-14
server-side authentication, 6-5
service name, 5-6,
5-11
session
logout, 5-19,
6-11
routing, 5-14
synchronization, 7-40
terminating from server-side, 5-19
SESSION attribute, 3-11
session bean
class implementation, 2-8
context, 2-9
creating, 2-7,
2-18
deploying, 2-19,
2-20
example, 2-10,
4-15
home interface, 2-7
IIOP, 3-9
overview, 1-9,
4-2
removing, 2-8
SessionBean interface, 2-8
EJB, 2-3,
2-8
ejbActivate method, 2-8,
4-7
ejbPassivate method, 2-8,
4-7
ejbRemove method, 2-8,
4-6
setSessionContext method, 2-9,
4-7
SessionContext
interface, 2-9
SessionSynchronization interface, 7-40
afterBegin method, 7-40
afterCompletion method, 7-41
beforeCompletion method, 7-40
setCertificateChain method, 6-24
setEncryptedPrivateKey method, 6-24
setEntityContext method, 4-7,
4-8,
4-22,
4-29
setRollbackOnly method, 2-10
setSessionContext method, 2-9,
4-7,
4-8
setTransactionTimeout method, 7-40
SID, 2-17,
5-6
SPECIFIED_IDENTITY property, 2-25,
A-27
SSL, 6-20
configuring, 3-17
connection security, 1-3
defined, 6-3
JAR files, 5-11,
6-4
protocol version numbers, 6-4
SSL_CLIENT_ AUTHENTICATION parameter, 3-19
SSL_CLIENT_AUTH value, 2-16,
5-10
SSL_CREDENTIAL value, 2-16,
5-10
SSL_LOGIN value, 2-16,
5-10
SSL_VERSION parameter, 3-19
SSL_VERSION property, 2-17,
3-19
start method, 2-29
stop method, 2-29
Supports transaction attribute, 7-6,
A-20
system identifier, see SID
SYSTEM_IDENTITY property, 2-25,
A-27
T
trace files, 2-28
transaction
bean-managed, 7-4,
7-14
client-side demarcation, 7-16
commit, 2-10
container-managed, 7-4,
7-6,
7-13
context propagation, 2-10,
7-5
demarcation, 7-3
deployment descriptor, A-20
enlisting resources, 7-7,
7-25
global, 7-3
limitations, 7-13
overview, 1-2,
7-2
retrieve status, 2-10
rollback, 2-10
timeout, 7-39
two-phase commit, 7-8,
7-29
Transaction class, 7-3
TransactionManager class, 7-3
TTC, 5-13
two-phase commit, 7-29
two-task common, see TTC
U
unsetEntityContext method, 4-7,
4-29
URL
syntax for, 5-5
used as JNDI parameter, 2-17
URL_PKG_PREFIXES property, 2-16,
5-9
USE_SERVICE_NAME property, 5-11
UserTransaction object
begin method, 7-16,
7-22
commit method, 7-16,
7-17,
7-22
retrieving, 7-14
rollback method, 7-16,
7-17,
7-22
setTransactionTimeout method, 7-40
useServiceName flag, 5-6
deployejb option, 5-11
W
wallet, 6-20
X
XML, 2-21
deployment descriptor, 4-10
deployment descriptors, A-1
version number, 2-22,
A-3,
A-22
Copyright © 1996-2000, Oracle Corporation.
All Rights Reserved.
Library
Solution Area
Contents