Index
A
access control 230
accessing EJBs from a servlet 8
AccountAccessBean 240
AccountBean 249
ACID 165
adding a home method to generated home interfaces 68
adding entity relation XML to the deployment descriptor 70?71, 73
adding log messages 249
AddressBean 98
afterBegin 179?180, 183
afterCompletion 180, 184
Ant 274, 278
automating tests 294
building stubs 283
building the ejb.jar 280
compiling EJB source 278
properties 56
properties with XDoclet 57
setting up for build 278
with Cactus 294
See also build.xml
Apache
Ant 274
Cactus 275
appenders
html 261
JDBC 257
JMS 258
rolling file 260
XML 259
Applet 27
<arg> 286
assert 287, 289
assertEquals 289
assertFalse 289
assertNotNull 289
assertNotSame 289
assertNull 289
assertSame 289
assertTrue 289
assigning a role to an EJB 238
assigning and determining EJB client security roles 232
AsynchBean 156
asynchronous business logic 202
asynchronous email 223
asynchronous processes 151
without message-driven bean 156
asynchronous timer 145
AsyncProcessBean 151
atomic 165
attempting error recovery to avoid a rollback 172
authentication 230
AuthenticationException 242
authorization 230
automate development 34
<automatic-key-generation> 91
automating test cases 274
execution 294
automation, building EJB stubs 283
avoiding a rollback 172
in a BMT bean 173
in a CMT bean 173
avoiding hard-coded XDoclet tag values 56
B
batch processes 159
BatchProcessBean 160
bean adapter 139
bean-managed transactions 166, 169
beforeCompletion 179?180, 183
BETWEEN 221
binary data messages 210
BMP
switching to CMP 81
BMT 170
BookJMSQueue 208
build.properties 278, 283
build.xml 35?38, 40, 44, 49, 62, 64, 66?68
for building ejb.jar 281
for generating deployment descriptor 46
for generating interfaces 40
for XDoclet 36
generating EJB interfaces 41
generating stubs 284
generating utility objects 59
generating XML 45
using Ant properties 57?58
building 278
EJB stubs 283
ejb.jar file 280
building Enterprise JavaBean stub classes 283
business logic insulation 209
BusinessDataAccessObject 189
BusinessLogicBean 209
BytesMessage 211, 213
C
Cactus
automating tests 294
building test cases 286
introduction 275
jar files 276
servlets 276
testing entity beans 292
unit test for a stateful bean 290
unit test for session bean 286
with a UI 298
cactus.jar 276
cactus.properties 297
CallableStatement 111
<cascade-delete/> 106
cascading deletes 104
CDATA 220?221
centralize logging 263
change the level of your loggers 254
change the way you write messages 255
change your conversion patterns 255
class files
packaging 280
client 210
applet 27
assigning security role 232
categories 4
credentials 234
EJBs finding identity 231
JMS 15
JSP 12
other EJBs 4
remote EJB 6
servlets 8
sorting log messages 269
starting asynchronous processes 151
starting transactions 190
streaming 210
using large result sets 126
Client.java 206
using reflection 25
ClientLoader 20
ClientSaver 18
cluster, centralize logging 263
CMP 81, 84
EJB-QL 111
generating primary keys 88
<cmp-field/> 84
CMR XML
generating 70
<cmr-field/> 104
CMT 165?169, 173, 181, 194
code finder methods
generating 66
code generation 33
CMR XML 70
deployment descriptor 45
EJB interfaces 37
finder methods 66
JMS XML 71
primary key class 53
utility objects 58
value objects 47
code value objects 47
Collection 96
combining entity updates into a single transaction 177
commitMultipleEntities 178
common interfaces 137
COMP_NAME 44, 60?61
comparing two EJB references for equality 23
compile_ejb target 282
compiling Enterprise JavaBeans 278
compound primary keys 92
consistent 165
ConsoleAppender 250, 252, 270?271
constant values 134
CONTACT_URL 135
env var 135
container-managed persistence 81
container-managed transactions 165, 186
multiples in a method 181
propagating to another method 186?187
rollback 173?174
throwing exceptions 184
timeout 177
<container-transaction> 167
Context.SECURITY_
AUTHENTICATION 234
Context.SECURITY_
CREDENTIALS 234
Context.SECURITY_
PRINCIPAL 234
continuous integration 34
conversion characters 253
formatting 253
conversion specifiers 252
ConversionPattern 252
performance 255
createServiceInstance 158
creating a batch process mechanism 159
creating a centralized log file in a clustered environment 263
creating a message-driven
Enterprise JavaBean 202
creating a one-to-many relationship for entity beans 101
creating a stateful session bean unit test 290
creating a stateless session bean unit test 286
creating an entity bean unit test 292
creating an interface to your entity data 120
creating asynchronous behavior
for an EJB client 151
without message-driven beans 156
creating EJB 2.0 container-
managed persistence 81
creating log file views for the web browser 261
D
DAO 188
data source 78
for different users 85
database
logging 257
view 115
database sequence 88
for BMP 88
for CMP 90
DataBean 39
DataSource 79
EJB deployment descriptor 79
decreasing hardcoded values 134
decreasing the number of calls to an entity bean 124
deployment descriptor 65
cascading deletes 106
CMP 83
CMR 1 to 1 99
CMR 1 to many 102
datasource 79
for a CMP bean 83
for BMT 169
for CMP primary key generation 90
for message-driven bean 203
one-to-one relationship 99
setting transaction control 166
showing a data source 79
showing environment variable 135
vendor specific 62
weblogic for message-driven bean 204
<deploymentdescriptor/> 45, 47, 66, 68
<description> 135
<destination-jndi-name> 215
<destination-type> 204
developing noncreatable, read-only entity beans 107
disabling methods for certain users 235
distributed transactions 193
Durable 72
durable subscriptions 165, 199
E
EJB 18
2.0 specification 5, 202
2.1 149
2.1 specification 145
See also Enterprise JavaBeans
EJB clients, using Timer service 146
EJB Container. getting client credentials 234
EJB credentials 234
EJB equality 23
EJB handle 19?21
EJB interfaces
generating 37
inheritance 137
EJB lifecycle 265
EJB lifecycle methods 139
EJB references 23
@ejb.bean 38?39, 44, 46, 53?54, 57, 59, 64?65, 67?68
properties 41
@ejb.finder 41, 66?67
@ejb.home-method 41, 69
ejb.jar 280
using Ant 280
@ejb.permission 65
@ejb.persistence 48?49, 54
@ejb.pk 41, 48?49, 53?54, 56
@ejb.pk-field 41, 48?49,
53?54, 56
@ejb.security-identity 64
@ejb.select 41, 67?68
ejb.session 252
@ejb.util 59, 61
@ejb.value-object 48
ejbActivate, inheriting 139
EJBApplet 28
EJBApplet.java 28
ejbBookDataSource 80
ejbc 285?286
EJBContext 169?172, 174,
177, 231
identity methods 231?232
<ejbdoclet/> 35?38, 40, 62, 64
generating a primary key class 53
generating a value object 52
generating EJB interfaces 40
generating interfaces 42
generating XML 45
sample usage 37
using Ant properties 57
utility objects 59
vendor XML 62
ejbFindByPortfolioName 96
ejbHomeGetCountOfSymbols
123
<ejb-jar/> 83
ejb-jar.xml 47
generating 45
ejbLoad 180, 184
EJBLocalHome 23
EJBMetaData 25?27
EJBObject 19
ejbPassivate, inheriting 139
EJB-QL 68, 111
<ejb-ql> 114
<ejb-relation/> 99?100
<ejb-relation-name> 99
ejbTimeout 146?147, 157, 160
ejbToString 136?137
EJBWebService 149
EJBWebServiceBean 150
@ejb.security-role-ref 64
email 144
asynchronous 223
synchronous 144
EmailBean 224
encapsulate business logic 210
encapsulating error-handling code in a message-driven EJB 221
Enterprise JavaBeans
as a web service 149
building stubs 283
cascading deletes 104
CMP 81
compiling 278
creating a message-driven bean 202
disabling methods 235
email 223
error handling in an MDB 221
examining with reflection 25
faster lookup 31
finding client identity 231
finding client role 232
generating code 34
generating interfaces 37
handling rollbacks in an MDB 225
invoking another EJB (local) 4
invoking another EJB (remote) 6
logging in a cluster 263
logging with many clients 269
looking up with JNDI 43
one-to-many relationships 101
one-to-one relationships 97
packaging 280
Enterprise JavaBeans (continued)
retreiving a persisted reference 20
saving a home object reference 21
saving a reference 18
security 230
security role identity 238
sending JMS messages 147
stateful unit test 290
superclass 139
testing for equality 23
toString method 136
tracking the lifecycle 265
2.1 timer service 145
using a data source 78
using environment variables 134
with applets 27
with JMS 202
with JSP 12
with no create method 107
with servlets 8
entity bean
cascading deletes 104
compound primary key 92
decreasing calls 124
EJB-QL 111
finder methods 95
from a database view 115
generating interfaces 39
generating primary keys 88
primary key classes 95
security 239
select methods 122
session facade 120
superclass 140
unit test 292
value objects 124
with JMS 117
entity deletes 104
entity relationships
generating 70
generating XML 45
EntityBeanTemplate 140
<entitypk/> 53
<env-entry> 135
<env-entry-name> 135
<env-entry-type> 135
<env-entry-value> 135
environment entry, data types 135
environment variables 134
equality 23
equals 23
EquityBean 7, 24, 81, 137
sample toString 137
with a database view 115
EquityHome 6
equityPriceView 115
EquityVO 125
error handling
message-driven beans 221
rollbacks in a message-driven bean 225
ErrorHandler 223
executing test cases 274
using a UI 298
executing unit tests
from a web browser 298
from UI classes 299
F
facilitating bean lookup with a utility object 58
FIFO 205
<fileset/> 37, 282
filtering messages for a message-driven EJB 219
findByPortfolioName 96
findByPrimaryKey 96
finder methods 95
EJB-QL 111
findHighPriced 112
findHighPricedLowPE 112
finding a remote EJB 6
finding the identity and role of the caller inside an EJB method 231
forcing rollbacks before method completion 172, 175, 177, 180, 185, 189
formatting log messages 251
FROM 114
G
generating a primary key class 53
generating and maintaining method permissions 64
generating finder methods for entity home interfaces 66
generating primary key values 88
generating stub classes 274
generating the ejbSelect method XML 67
generating vendor XML 62
generating vendor-specific deployment descriptors 62
getCallerPrincipal 205, 231
getCodeBase 30
getConnection 85
getCountOfSymbols 122, 124
getEJBMetaData 25
getEJBObject 21
getEquityHome 6
getHandle 19
getHomeHandle 22?23
getPasswordHome 5
getPrincipal 271
getRollbackOnly 172
getRow 131
getStoredProcPrice 110
getUserTransaction 169?170, 173, 177, 181?182, 187
Google xv
H
Handle 18
Handle class 18
handleMessageDrivenError 222
handling rollbacks in a message-driven bean 225
handling transaction management without the container 169
HelperBean 121
holding a transaction across multiple Java Server Pages 191
HoldingKey 92
home interfaces
caching 61
generating 37
JNDI name variable 44
home methods, generating 68
home object reference, persisting 21
HomeHandle 23
how to format log4j messages 251
HTML 29
as a log format 261
converter 29
layout 261
htmlFileAppender 261
HTMLLayout 261
I
IIOP 8, 11
IllegalStateException 169, 171
implementing toString functionality for an EJB 136
imposing time limits on transactions 176
improving logging performance 254
improving your client-side EJB lookup code 31
inheritance
EJB superclass 139
interfaces 137
<initial-beans-in-free-pool> 208
InitialContext 170, 190?191
configuring JMS appender 259
finding a remote EJB 6
finding environment entries 135
initializing 6
with a servlet 12
with a utility object 32
with JSP 13
<init-param> 269
insulating an EJB from service class implementations 157
insulating message-driven beans from business logic changes 209
insulation 157, 209
invoking a local EJB from another EJB 4
invoking a remote EJB from another EJB 6
invoking a stored procedure from an EJB 109
invoking an EJB from a JavaServer Page 12
invoking an EJB from an applet 27
invoking EJB business logic from a JMS system 15
invoking EJBs in the same container 4
isCallerInRole 231, 233, 237
isDebugEnabled 255
isIdentical 24?25
Isolated 165
isPasswordValid 120
ItemBean 48, 53, 67?68
ItemBeanPK 54
ItemBeanPK.java 54
ItemBeanValue 49
ItemBeanValue.java 49
J
J2EE 1.4 156
jar_ejb target 282
<java> 286
Java Message Service. See JMS
Java plug-in 29
java.util.Collection 95, 103?104, 106
JavaServer Page. See JSP
javax.mail 144
javax.rmi.PortableRemoteObject 8, 10?11, 26, 31
<jboss/> 62
JDBC 78
appender 257
data source 78, 85
invoking a stored procedure 109
log4j 257
opening a connection 81
using a database view 115
with large result sets 126
JMS 15, 147
appender 258
decouple communication 198
FIFO 205
for centralizing logging 263
for clustered logging 263
generating XML 71
invoking an EJB 15
logging 258
message destination 202
message selectors 73
security 242
sending messages to many consumers 200
sending to a JMS topic 198
sending to a queue 200
speeding up message delivery 216
streaming data 210
topic 198
triggering multiple MDBs 213
using message selectors 219
with entity beans 119
JMSAppender 259
JMSPublisher 117
JMX
to refresh log4j 269
JNDI 8, 42, 44, 170, 190, 241
avoiding repeated lookups 18, 21
finder methods 95
finding env variables 135
home interface JNDI variable 43
name added to the home interface 42
static member variable 44
with JMS 200?201
with log4j JMS appender 258
JNDI_NAME 45
join 116
<jonas/> 63
<jrun/> 63
JSP xix, 12, 191
calling an EJB 12
calling local EJB 13
calling remote EJB 14
JUnit 275
junit.framework 287
L
LDAP 241
lifecycle methods 139
LIKE 221
loadReference 20, 22
local interfaces 5
generating 37
LocationInfo 260
log level 254
log4j 248
conversion characters 253
formatting messages 251
in a cluster 263
initialization 251
introduction 248?249
isDebugEnabled 255
log4j (continued)
jdbc 257
JDBC appender 257
Location Info 252
making reports 257
performance 254
refreshing configuration 267
rolling file appender 260
sample configuration 250
sorting messages by client 269
to HTML 261
to JMS 258
XML file log 259
logconfig.properties 250
LogConsolidatorBean 263
Logger.getLogger 249
LoggerInitializationServlet 268
logging 247
format characters 253
formatting messages 251
making reports 257
performance 254
to a database 257
to an XML file 259
to HTML 261
to JMS 258
to XML 259
tracking EJB lifecycle 265
LoginBean 8
LoginHome 13
LoginServlet 9?10
lookup 135
env vars 135
M
managing EJB state after a rollback 183
managing EJB state at transaction boundaries 179
Mandatory 168
Map 126
MapMessage 199
Mapped Diagnostic Context 271
<max-beans-in-free-pool> 208
MDC 271
message filters 219
message queue 200
message selectors 73, 219
MessageBean 16?17, 154, 207, 209, 214, 217, 219, 222
MessageBean2 214
MessageBeanTemplate 142
MessageDriveBean 204
<message-driven> 202?203
message-driven beans
business logic 209
creating 202
deployment descriptor 203
email 223
error handling 221
for centralizing logging 263
handling rollbacks 225
pool of 208
security 204, 242
superclass 142
using message selectors 219
MessageDrivenBean 203
MessageDrivenContext 203
<message-driven-descriptor> 215
<message-driven-destination> 204
MessageListener 15, 203
<message-selector> 220
method permissions 64, 235
generating XML 45
method that compares EJB references 24
<method-intf> 237
<method-permission> 236?237
Microsoft Excel 267
modeling one-to-one entity data relationships 97
MyService 158
N
NDC 270
Nested Diagnostic Context 270
nested transactions 182
Never 168
next 127
NonDurable 72
NotAdminException 233
NotSupported 168
O
one-to-many 101
one-to-one 97
onMessage 203, 242?243
handling rollbacks 226
security 242
org.apache.cactus.server.runner.ServletTestRunner 276
org.apache.cactus.server.ServletTestRedirector 277
<orion/> 63
OwnerBean 70, 98, 101
P
packaging beans into an ejb.jar file 274
PaginationBean 127
paging through large result sets 126
passing client credentials to the EJB container 234
PasswordBean 108, 121
PasswordHome 5
PatternLayout 250, 252
performance 255
patterns
bean adapter 139
session facade 120
performance
JMS message delivery 216
logging 254
repeated lookups 31
permissions 235
persisting a home object reference 21
persisting a reference to an EJB instance 18
persisting entity data into a database view 115
point-to-point 200
pool
of MDB 208
PortableRemoteObject 7, 10, 18, 20, 28, 32
PortfolioBean 101?102, 104
PortfolioHolding 95
PortfolioHoldingBean 93, 96
PortfolioHoldingHome 95
<pramati/> 63
prepareCall 111
preventing access to entity data 239
previous 127
PricingBean 110
primary key class 92
generating 53
requirements 94
primary keys
compound 92
custom classes 94
from a database sequence 88
processing messages 205
in a FIFO manner from a message queue 205
propagating transactions 165, 186, 190
to a nonEJB class 188
to another EJB business method 186
Propertyconfigurator 251
providing common methods for all your EJBs 137
publish 148, 199
publish/subscribe 198
publishMessage 119
Q
<query> 113?114
<query-method> 114
queue 201, 205
for FIFO messaging 205
QueueConnection 201
QueueConnectionFactory 201
QueueSender 201
QueueSession 201
R
read-only entity beans 107
reducing the clutter of unimplemented bean methods 139
reference, EJB 18
reflection 25
registerOutParameter 111
<relationship/> 100
<relationship-role-source> 100
<relationships> 99
relationships
cascading deletes 104
one-to-many 101
one-to-one 97
remote interfaces
generated sample 42
generating 37
reports 257
Required 168
RequiredLocalException 168
RequiresNew 167?168
<resin-ejb-xml/> 63
<resource-ref>
for a data source 80
<resource-ref/> 80
result sets 126
retrieving an environment variable 134
retrieving and using a persisted EJB reference 20
retrieving information about entity data sets 122
retrieving multiple entity beans in a single step 95
RMI 5
<role-link> 233
<role-name> 66, 232, 236
rollback 171, 173?174, 182,
189?190
rollback recovery 174
rollbacks 170
message-driven bean 225
rolling back the current transaction 170
RollingFileAppender 260?261
rootLogger 250
<run-as> 239
runCactusTest 296
<runservertests> 295, 297
RuntimeException 176, 185
S
sample JSP looking up a
remote EJB 14
sample JSP using a local EJB 13
sample log output 251
SampleBean 178
SampleDataSourceBean 79
deployment descriptor 79
SampleMDB 203
saveHomeReference 22
saveReference 18
saving an EJB reference 18
SecureMDB 244
securing a message-driven bean 242
security 230
credentials 234
disabling methods 235
entity beans 239
LDAP 241
local interfaces 240
MDB 242
message-driven beans 204
passing credentials to the EJB container 234
roles 238
security roles 232
for an EJB 238
generating XML 45
SecurityException 171
<security-identity> 238?239
<security-role> 232?233
<security-role-ref> 233
SELECT 114
select methods 67, 122
generating 67
selector 221
send 201
sendEmail 144?145, 224
SendEmailBean.java 144
sending a JMS message from an EJB 147
sending a point-to-point JMS message 200
sending a publish/subscribe JMS message 198
sending an email from an EJB 144
sending an email message asynchronously 223
sending notifications upon entity data changes 117
SequenceBean 89
CMP 90
serializable 18
EJB handles 18
service classes 157, 209
serviceMethod 151
servlets
as EJB clients 8
calling local EJB 8
calling remote EJB 10
initialization parameters 11
refreshing log4j 263
ServletTestCase 287, 290, 292
session beans
facade 5
generating interfaces 38
session beans (continued)
invoking a stored procedure 109
paging through data 126
sending email 144
session facade 120
superclass 141
unit test 286
session facade 120, 241
SessionBeanTemplate 141
SessionSynchronization 177, 179?180, 183?184
setRollbackOnly 171?172,
174, 188
setTransactionTimeout 177
simple lookup method 5
SimpleDateFormat 256
SimpleLayout 256
sorting log messages by client 269
source files
compiling 278
specifying security roles in the bean source 63
speeding up message delivery to a message-driven bean 216
start.weblogic.61 296
starting a transaction in the client layer 190
startProcess 156
startTarget 296
startTimer 146
StatusBean 153
stdout appender 250
stop.weblogic.61 297
stopTarget 296
store procedure 109
Streaming 210
streaming data to a message-driven EJB 210
stub classes 283
super interface 139
Supports 168
Swing 29
SystemException 171?172, 177
T
test_sequence 88
testCreateEntity 294
TestEntity 292
TestEntityBean 141
testIncrement 290
testing 274
automating tests 294
entity bean 292
from a browser 298
from Swing 299
statefull session 290
stateless session 286
with a UI 298
testNegativeResponse 287
testPositiveResponse 287
TestStateful 290
TestStateless 287
testTarget 296
throwing exceptions without causing a rollback 184
TimedObject 146?147
timeouts 176
Timer 145
timer service
to create asynchronous process 156
TimerHandle 147
TimerService 146
TimerSession 146
TimerSessionBean 146
topic 199
logging to JMS 258
TopicBindingName 259
TopicConnection 199
TopicConnectionFactory 199
TopicPublisher 199
TopicSession 199
toString 136
tracking the lifecycle of an EJB 265
transaction attribute
Mandatory 167
Never 167
NotSupported 167
Required 167
Supports 167
transaction behavior 166
transaction boundaries 179
TransactionRequiredException 168
transactions 164
avoiding rollbacks 172
distributed 193
forcing rollbacks 175
introduction to 165
JSP 191
managing state 179
nested 182
progating to nonEJB 188
propagating to an EJB 186
restoring state after rollback 183
rollback the current transaction 170
throwing exceptions 184
timeouts 176
updating multiple entity beans 177
using more than one per method 181
<transaction-type/> 170, 181
<trans-attribute> 167
triggering two or more message-driven beans with a single JMS message 213
trivial implementations 139
tuning the container transaction control for your EJB 166
2 phase commit 193
TYPE_SCROLL_INSENSITIVE 131
U
<unchecked> 65, 237
unit tests
an entity bean 274
automation 294
entity 292
executing 298
stateful session 290
stateful session beans 274
stateless session 286
stateless session beans 274
Updating multiple databases in one transaction 193
<use-caller-identity/> 239
UserBean 31, 38, 44, 46, 57, 59, 64?65
sample ejb-jar.xml 46
utility object 59
UserSpecificDB
deployment descriptor 86
UserSpecificDBBean 85
UserTransaction 169?171,
173?174, 177, 181, 187,
189?190, 192
UserUtil 31
UserUtil.java 31
using a compound primary key for your entity beans 92
using a data source 78
using a database sequence to generate primary key values for entity beans 88
using a different configuration at runtime 267
using an EJB as a web service 149
using Ant for compilation 274
using different data sources for different users 85
using EJB-QL to create custom finder methods 111
using EJBs to handle simple authentication with an LDAP source 241
using entity relationships to create a cascading delete 104
using environment variables 134
using more than one transaction in a method 181
using reflection with an EJB 25
using the EJB 2.1 timer service 145
UtilInterface 138
<utilityobject> 59
V
value objects 124
generating 47
<valueobject> 49
W
web browser
viewing log files 261
with a UI 298
web service config.xml 150
web services 149
web.xml
for cactus 276
Weblogic
ejbc 286
finding remote EJBs 7
stubs 283
Weblogic deployment descriptor 17
for message-driven bean 204
generating primary keys 91
MDB pool 208
<websphere/> 63
WHERE 114
wildcard 237
wscompile 150
X
XAConnection 194
XADataSource 194
XDoclet 34?35, 37, 44, 66
<remoteinterface/> 40
adding home methods 69
continuous integration 34
customizing home interfaces 44
deployment descriptor 46?47
generating a primary key class 53
generating EJB interfaces 38
generating interfaces 41
generating utility objects 58
generating vendor XML 62
generating XML 67
generating XML file 62
installing 35
introduction to 34
jar dependencies 36, 168
JNDI names 42
method permissions 64
security roles 63
using Ant properties 56, 58
value objects 52
vendor XML subtasks 62
website 37
XDoclet tags
@ejb
create-method 38
@ejb.bean 38
@ejb.create-method 39, 41, 48, 53, 65?66
@ejb.interface-method 38?41, 49, 54, 65?66, 70
@ejb.util 59
@ejb-relation 70
@ejb-value-object 48
generating EJB interfaces 41
XML 84, 259
as log file 259
descriptor for Servlet EJB client 11
layout 259
message selectors 221