Beruflich Dokumente
Kultur Dokumente
Use A Cabeça! EJB PDF
Hochgeladen von
Iradis IradisOriginaltitel
Copyright
Verfügbare Formate
Dieses Dokument teilen
Dokument teilen oder einbetten
Stufen Sie dieses Dokument als nützlich ein?
Sind diese Inhalte unangemessen?
Dieses Dokument meldenCopyright:
Verfügbare Formate
Use A Cabeça! EJB PDF
Hochgeladen von
Iradis IradisCopyright:
Verfügbare Formate
Head First EJB™
by Kathy Sierra and Bert Bates
Copyright © 2003 O’Reilly Media, Inc. All rights reserved.
Printed in the United States of America.
Published by O’Reilly Media, Inc., 1005 Gravenstein Highway North, Sebastopol, CA 95472.
O’Reilly books may be purchased for educational, business, or sales promotional use. Online editions are
also available for most titles (safari.oreilly.com). For more information, contact our corporate/institutional sales
department: (800) 998-9938 or corporate@oreilly.com.
Editor: Mike Loukides
Cover Designer: Edie Freedman
Interior Decorators: Kathy Sierra and Bert Bates
Anthropomorphizer: Bert Bates
Bean Wrangler: Kathy Sierra
Printing History:
October 2003: First Edition.
The O’Reilly logo is a registered trademark of O’Reilly Media, Inc. Java and all Java-based trademarks and logos
are trademarks or registered trademarks of Sun Microsystems, Inc., in the United States and other countries.
O’Reilly Media, Inc. is independent of Sun Microsystems.
Many of the designations used by manufacturers and sellers to distinguish their products are claimed as
trademarks.
Where those designations appear in this book, and O’Reilly was aware of a trademark claim, the designations
have been printed in caps or initial caps.
While every precaution has been taken in the preparation of this book, the publisher and the authors assume no
responsibility for errors or omissions, or for damages resulting from the use of the information contained herein.
In other words, if you use anything in Head First EJB™ to, say, run a nuclear power plant or air traffic control
system, you’re on your own.
And although some people have been able to pass the exam simply by placing this book under their pillow each
night for three consecutive weeks, we generally don’t recommend it. Most people find it helpful to actually read
the book or at least look at the pictures.
ISBN-10: 0-596-00571-7
ISBN-13: 978-0-596-00571-9
[M] [8/07]
Table of Contents (summary)
Intro xix
1 Welcome to EJB: an introduction 1
2 EJB Architecture: architectural overview 61
3 Exposing Yourself: the client view 111
4 Being a Session Bean: session bean lifecycle 173
5 Entities are Persistent: entity bean intro 259
6 Being an Entity Bean: bean/entity synchronization 295
7 When Beans Relate: entity bean relationships 373
8 Getting the Message: message-driven beans 437
9 The Atomic Age: EJB transactions 469
10 When Beans Go Bad: exceptions in EJB 525
11 Protect Your Secrets: security in EJB 569
12 The Joy of Deployment: a bean’s environment 599
A Appendix A: Final Mock Exam 637
Table of Contents (the real thing)
i Intro
Your brain on EJB. Here you are trying to learn something, while here your brain
is doing you a favor by making sure the learning doesn’t stick. Your brain’s thinking, “Better
leave room for more important things, like which wild animals to avoid and whether naked
snowboarding is a bad idea.” So how do you trick your brain into thinking that your life
depends on knowing EJB?
Who is this book for? xviii
We know what your brain is thinking xix
Metacognition xxi
Bend your brain into submission xxiii
What you need for this book xxiv
Passing the certification exam xxvi
Technical reviewers xxviii
Acknowledgements xxix
ix
1 Welcome to EJB
Enterprise JavaBeans are easy. Well, at least when you compare EJB
to what you’d have to do to write your own scalable, transactional, secure, persistent,
concurrent enterprise component server. In this chapter, we’ll develop, deploy, and run an
EJB application, and then dive into the details. Before we’re done, we’ll look at the use,
benefits, and characteristics of EJB, and we’ll look (briefly) at how EJB containers work.
Exam objectives 2
Server What is EJB all about? 3
No more vendor lock-in! 5
biz interface
services
biz logic How does it all work? 7
EJB t En separate
an
obj e c terp se be
ri from data Behind the scenes... 8
EJB Container DB
Beans come in three flavors 11
The Advice Guy bean 15
Five things you do to build a bean 16
EJB Roles and Responsibilities 26
Tutorial 28
Coffee Cram 59
2 EJB Architecture
EJB is about infrastructure. Your components are the building blocks. With
EJB, you can build big applications. The kind of applications that could run everything
from the Victoria’s Secret back-end to document-handling systems at CERN. But an
architecture with this much flexibility, power, and scalability isn’t simple. It all begins with a
distributed programming model...
Exam objectives 62
<<interface>> <<interface>>
Making a Remote method call 64
(J2SE API) Remote (J2EE API) EnterpriseBean
no methods no methods What about arguments and return values? 67
The client calls business methods through the Remote interface 79
<<interface>> <<interface>>
(J2EE API)
EJBObject
// several methods
(J2EE API) SessionBean EJB uses RMI 81
// several methods
The Remote object is not the bean, it’s the bean’s bodyguard 82
YOU write this
<<interface>>
BookCart YOU write this
BookCartBean Architectural overview: Session beans 98
interface class
addBook() addBook()
(the remote
component
removeBook()
showBooksInCart()
(the bean class)
removeBook()
showBooksInCart()
Architectural overview: Entity beans 99
interface) doCheckout() doCheckout()
// other methods
Architectural overview: Creating a Stateful Session bean 100
Architectural overview: Creating a Stateless Session bean 101
Architectural overview: Message-driven beans 106
Organize your beans 108
x
3 Exposing Yourself
You can’t keep your bean private. Clients need to see what you’ve got.
(Except for message-driven beans, which don’t have a client view). The Advice Bean
exposes the getAdvice() method in its Component interface—the place where you declare
business methods. But that’s not all the client sees. Remember, the Advice interface
extends EJBObject, an interface with methods of its own. Methods the client can see.
Methods the client can call. And it works the same way with the Home interface.
Stateless Exam objectives 112
beans
What the client really wants 113
These beans are What’s JNDI? 116
all identical PortableRemoteObject.narrow() (exotic casting) 121
Writing the Remote home interface for a session bean 125
bean
Thankfully, we’ve got handles (online shopping takes time) 139
bean
Which methods make sense for the local client interfaces? 148
bean
Why so many remove methods? 151
For stateless session beans from
Comparing Remote vs. Local interfaces 154
the same home, isIdentical() always
returns true, even for different beans. Arguments to Remote vs. local methods 163
Coffee Cram 168
4 Being a Session Bean
Session beans are created and removed. If you’re lucky, you’re a
stateless bean. Because the life of a stateful bean is tied to the whims of a heartless
client. Stateful beans are created at the client’s insistence, and live and die only to serve
that one client. But ahhhh, the life of a stateless bean is fabulous! Pools, those little
umbrella drinks, and no boredom since you get to meet so many different clients.
Exam objectives 174
For me? This is
such a special moment!
Container callbacks, for the special moments in a bean’s life 181
Once in a lifetime...
Bean Creation 188
Bean things you can do within business methods 199
Passivation: a stateful bean’s chance at scalability 200
Bean Removal 208
Writing a Session Bean: your job as Bean Provider 230
SessionContext: you need it more than it needs you 240
Coffee Cram 244
xi
5 Entities are Persistent
Entity beans persist. Entity beans exist. Entity beans are. They are object
representations of something in an underlying persistent store. (Think: database,
because most entity beans represent something from a relational database.) If you have
If you’ve got any last a Customer entity bean, then one bean might represent the entity Tyler Durden, ID #343,
words, you better do
it in your ejbRemove()... while another is the entity Donny Darko, ID #42. Three beans, representing three real
entities. An entity bean is simply a realization of something that already exists.
Exam objectives 260
What’s an entity bean? 261
Entity beans from the client’s point of view 265
No, Please, No!
I’ll give you whatever A very simple Customer entity bean 268
you want, just don’t
call remove()! Entity bean Remote component interface 270
Entity bean Remote home interface 273
What does the client really want from an entity bean home? 274
Home business methods to the rescue 278
Session bean create() vs. entity bean create() 281
Session bean remove() vs. entity bean remove() 282
Entity/bean/instance death 285
Coffee Cram 288
6 Being an Entity Bean
Entity beans are actors. As long as they’re alive, they’re either in the pool or
they’re being somebody. Somebody from the underlying persistent store (an entity from
the database). When a bean is playing a part, the bean and the underlying entity have to
If I’m a bean I say
to a method, “Don’t stay in sync. Imagine the horror if the bean is pretending to be, say, Audrey Leone, and
call me, call my bodyguard,
and here’s his contact someone lowers Audrey’s credit limit in the database... but forgets to tell the bean.
information...”
Exam objectives 296
The real power of entity beans is synchronization 298
Instead of:
bean
Container-managed vs. bean-managed persistence 303
doStuff(this); The EntityBean interface adds new container callbacks 310
EJB
object
Writing a CMP entity bean 313
Use:
doStuff(myContext.getEJBObject()); Object identity: the primary key 332
Finder methods 339
Home business methods 345
Coffee Cram 362
xii
7 When Beans Relate
Entity beans need relationships. An Order needs a Customer. A LineItem
needs an Order. An Order needs LineItems. Entity beans can have container-managed
relationships (CMR) and the Container takes care of virtually everything. Make a new
LineItem that’s related to an Order? If you ask the Customer to show you his Orders,
you’ll see the new LineItem. Best of all, you can use EJB-QL to write portable queries.
Exam objectives 374
Relationships 378
Multiplicity: Multiplicity:
many one Multiplicity 380
Movie Director CMP and CMR fields 383
Director getDirector() Collection getMovies()
Cascade delete can propagate 393
0..* 1
EJB-QL for the MovieBean 402
one Director. SELECT and FROM are the mandatory! 409
Each Movie has y Movies.
man
A Director has
The WHERE clause 411
Collections don’t bark()! 414
The BETWEEN, IN, IS EMPTY, and LIKE expression 416
Relationship assignments 421
Coffee cram 425
8
Getting the Message
It’s fun to receive messages. Not as much fun as, say, getting that eBay
package with the genuine Smurf™ lamp, but fun and efficient nonetheless. Imagine if
you sent your order to eBay, and you couldn’t leave your house until the package was
<<interface>>
EJBContext delivered. That’s what it’s like with Session and Entity beans. But with message-driven
beans, the client can send a message and walk away.
getCallerPrincipal()
getEJBHome() Exam objectives 438
isCallerInRole(String s)
getRollbackOnly() Writing a message-driven bean: your job as Bean Provider 447
getEJBLocalHome() My life is sad. I
getUserTransaction() have no home, I have Complete DD for a message-driven bean 449
setRollbackOnly()
no clients... I can use
my context ONLY for Topics and Queues 450
transactions... Oh well,
at least I get a
MessageDrivenContext 455
pool. Message acknowledgement 458
<<interface>>
MessageDrivenContext Coffee Cram 463
// this interface adds no
// new methods
xiii
9 The Atomic Age
Transactions protect you. With transactions, you can try something knowing
that if anything goes wrong along the way, you can just pretend the whole thing didn’t
happen. Everything goes back to the way it was before. Transactions in EJB are a thing
of beauty—you can deploy a bean with customized transaction behavior without touching
the bean’s source code! But you can write transaction code, if you need to.
Exam objectives 470
The ACID test 472
How it works in EJB 474
������������� Transaction propagation 475
CMT beans ru How do I make (or get) a transaction? 476
n
transactions setRollbackOnly() lives in TWO interfaces 487
unknown,
while BMT be
ans BMT can be a really BAD idea. BMT hurts bean reuse 490
use only their
own. Container-managed transactions 491
OK, not our be
st work, we kn
ow. So why How attributes work 492
don’t you tr y
it. Memor y de
help, but they vices can Methods you MUST mark with an attribute (for a CMT bean) 498
work much be
you create th tter when
em yourself.
“Unspecified Transaction Context” 499
DD example for CMT 503
SessionSynchronization “special moments” 512
Coffee cram 516
Oh sh**! A system
10
exception. Nothing I can
When Beans Go Bad
Expect the unexpected. Despite your best efforts, things can go wrong.
Terribly, tragically, wrong. You need to protect yourself. You can’t let your entire program
collapse, just because one bean in the family throws an exception. The application must
do about it. There goes my
stateful bean. I’ll have to
start over... go on. You can’t prevent tragedy, but you can prepare for it. You need to know what is
and is not recoverable, and who is responsible when a problem occurs.
Exam objectives 526
Gotta love application
exceptions... I can
recover from this if I put
In EJB, exceptions come in two flavors 532
in a different value for the
argument to the create() With an Application Exception, the Container will... 533
method...
With a System Exception, the Container will... 534
RemoteException vs. EJBException 539
Bean Provider’s responsibilities 541
The five standard EJB application exceptions 548
Common system exceptions 551
Coffee cram 563
xiv
11 Protect Your Secrets
Keep your secrets. Security is about authentication and authorization. First,
you have to prove your identity, and then we’ll tell you what you’re allowed to do. Security
is easy in EJB, because you’re only dealing with authorization. You decide who gets to
call which methods on your beans. Except one problem... if you’re a Bean Provider or App
Assembler, you probably don’t know who the users are going to be!
Exam objectives 570
In the EJB In a vendor- In a company-
Deployment specific way specific way How to do security in EJB 573
Descriptor
The Application Assembler’s job: access control 574
real people
Defining the method permissions 578
<security-role-ref> <security-role> users and groups
The Deployer’s job: mapping actual humans to abstract roles 583
Class-level vs. instance-level security 586
Using programmatic security to custom-tailor a method 587
Use <run-as> security identity to pretend someone else is calling... 591
Security context propagation with <run-as> 592
Coffee cram 593
12 The Joy of Deployment
You worked hard on that bean. You coded, you compiled, you tested. About
a hundred zillion times. The last thing you want to touch is already-tested source code,
just because something simple changed in the deployment configuration. And what if you
don’t even have the source code? EJB supports bean reuse through the customizable
JAR
Deployment Descriptor and a bean’s special environment.
1
Exam objectives 600
ejb-jar A bean’s special place- java:comp/env 602
Creating and using a subcontext 609
com META-INF
Bean Provider and Application Assembler responsibility 617
<?xml ver-
sion=”1.0”
encoding
Deployer responsibility 618
=”UTF-8”?>
Remembering who does what 619
<!DOCTYPE
headfirst
ejb-jar
PUBInc./
ejb-jar.xml
Which APIs does EJB 2.0 guarantee? 621
011 0 1
011 0 1
What MUST be in an ejb-jar? 624
1100 1
1100 1 0 100 0
0 100 0 0 1 1 1
011 0 1
0 1 1 1 0111 0 11
1100 1
0111 0 11
00011 01
0 100 0
0 1 1 1
00011 01
Programming restrictions 625
Advice.class
0111 0 11
00011 01 AdviceBean.class
Coffee cram 627
AdviceHome.class
xv
A
Appendix A
The final Coffee Cram Mock Exam. This is it. 70 questions. The tone, topics,
and difficulty level are virtually identical to the real exam. We know.
Final Mock Exam 637
i Index 685
xvi
Intro to EJB
5
4
4 :HOFRPHWR(-%
<RX·UHJRQQDORYH
(-%$QGER\ZRQ·W-LPDQG
%HWW\EHHQYLRXVZKHQ\RXU
HQWHUSULVHEDFNHQGLVELJJHU
WKDQWKHLUV\RXPLJKWHYHQ
JHWWKDWSURPRWLRQ
(QWHUSULVH-DYD%HDQVDUHHDV\:HOODWOHDVWZKHQ\RXFRPSDUH(-%WRZKDW
\RX¶GKDYHWRGRWRZULWH\RXURZQVFDODEOHWUDQVDFWLRQDOVHFXUHFRQFXUUHQWHQWHUSULVH
VHUYHU,QWKLVFKDSWHUZH¶OOGHYHORSGHSOR\DQGUXQDQ(-%DSSOLFDWLRQEHIRUHGLYLQJ
LQWRWKHGHWDLOV%HIRUHZH¶UHGRQHZH¶OOORRNDWWKHXVHEHQH¿WVDQGFKDUDFWHULVWLFVRI
(-%DQGZH¶OOORRN EULHÀ\ DWKRZ(-%FRQWDLQHUVZRUN:H¶OOWDNHDKLJKOHYHOORRNDWWKH
DUFKLWHFWXUHRI(-%DQGOHDUQDERXWWKHWKUHHEHDQW\SHV7KHPRUH\RXXQGHUVWDQGIURP
WKLVFKDSWHUWKHOHVV\RX¶OOKDYHWRPHPRUL]HODWHUVRGRQ¶WVNLSLW ,I\RX¶UHDQ(-%H[SHUW
\RXFDQSUREDEO\JHWDZD\ZLWKMXVWDTXLFNVNLP
WKLVLVDQHZFKDSWHU
H[DPREMHFWLYHV
(QWHUSULVH-DYDEHDQV2YHUYLHZ
2IILFLDO :KDWLWUHDOO\PHDQV
,GHQWLI\WKHXVHEHQH¿WVDQG <RXQHHGWRNQRZKRZ(-%ZRUNVRYHUDOO
FKDUDFWHULVWLFVRI(QWHUSULVH ZKDWLW¶VJRRGIRUZKDWLWSURYLGHVDQG
-DYDEHDQVWHFKQRORJ\IRUYHUVLRQ ZKDWLWGRHVQ¶WSURYLGH
RIWKH(-%VSHFL¿FDWLRQ
<RXQHHGWRXQGHUVWDQGWKHRYHUDOO
DUFKLWHFWXUHRI(-%DQGKRZWKDW
DUFKLWHFWXUHVXSSRUWVWKHIHDWXUHVRI(-%
)RUH[DPSOH\RXQHHGWRNQRZWKDW
(-%VXSSRUWVWUDQVDFWLRQVVHFXULW\DQG
FRQFXUUHQF\EXWLWGRHVQRWJXDUDQWHH
ORDGEDODQFLQJIDLORYHURUFOXVWHULQJ<RX
QHHGWRNQRZWKDW(-%VXSSRUWVWKUHH
EHDQW\SHV VHVVLRQHQWLW\DQGPHVVDJH
GULYHQDQGWKDWVHVVLRQEHDQVFDQEH
VWDWHOHVVRUVWDWHIXO
&KDSWHU
LQWURWR(-%
?PI\Q[-2*ITTIJW]\' ts built
componens-R-Us
by Bean
&RPSRQHQWEDVHGGHYHORSPHQW &XVWRPHU
7ITH ENTERPRISE JAVABEANS YOU CAN DEVELOP BUILDING FRPSRQHQW
BLOCKS%*" COMPONENTSTHAT YOU OR SOMEONE ELSE CAN
ASSEMBLE AND REASSEMBLE INTO DIFFERENT APPLICATIONS
Fred w
&OR EXAMPLE YOU MIGHT CREATE A #USTOMER BEAN BEAN IS this onerote 2UGHU
ANOTHER WORD FOR COMPONENT THAT REPRESENTS A CUSTOMER
IN A DATABASE 9OU CAN USE THAT #USTOMER BEAN IN AN FRPSRQHQW
ACCOUNTING PROGRAM AN E
COMMERCE SHOPPING CART
SYSTEM A TECH SUPPORT APPLICATION OR VIRTUALLY ANY OTHER &DUW
APPLICATION THAT MIGHT NEED TO REPRESENT A CUSTOMER FRPSRQHQW
)N FACT WITH SOME BEANS THE BEAN DEVELOPER AND THE
APPLICATION ASSEMBLER MIGHT NOT WORK FOR THE SAME
COMPANY OR HAVE ANY KNOWLEDGE OF ONE ANOTHER $SSOLFDWLRQ$ RQOLQHVKRSSLQJ
)F YOURE A BEAN DEVELOPER YOU MIGHT BUILD AN /RDER )UHGDVVHPEOHVDQRQOLQHVKRSSLQJ
BEAN OR A 0AYROLL BEAN OR A 3HOPPING#ART BEAN THAT DSSOLFDWLRQXVLQJWZRFRPSRQHQWVKH
ERXJKWIURP%HDQV58VSOXVDWKLUG
DEVELOPERS IN SOME UNRELATED COMPANY CAN BUY AND USE
FRPSRQHQW)UHGGHYHORSHGDWKLV
TO CONSTRUCT THEIR OWN CUSTOM APPLICATIONS FRPSDQ\
/NE BEAUTY OF COMPONENT
BASED DEVELOPMENT IS THAT
YOU TAKE CODE REUSE TO A WHOLE NEW LEVEL )NSTEAD OF
uilt
components b-Us
REUSING *AVA CLASSES YOU GET TO REUSE A BIGGER CHUNK OF
FUNCTIONALITY /FTEN YOU CAN MODIFY THE WAY A BEAN
WORKS WITHOUT EVER TOUCHING ITS *AVA CODE 9OULL LEARN IN by Beans-R 6XSSRUW
FRPSRQHQW
THIS CHAPTER THAT WHEN YOU DEPLOY A BEAN INTO A SERVER
YOU CAN CONlGURE AND CUSTOMIZE THE BEAN DECLARATIVELY
&XVWRPHU
THROUGH AN 8-,
BASED DEPLOYMENT DESCRIPTORTO CHANGE FRPSRQHQW
THE WAY THE BEAN BEHAVES AT RUNTIME Bill made
these two
With component-based development,
2UGHU
you take code reuse to a whole new ,QYHQWRU\ FRPSRQHQW
FRPSRQHQW
level. With OO development, you reuse
classes, but with components, you
$SSOLFDWLRQ% WHFKQLFDOVXSSRUW
reuse a bigger chunk of functionality, %LOODVVHPEOHVDWHFKQLFDOVXSSRUWDSS
XVLQJWZRFRPSRQHQWVKHERXJKWIURP
and you can customize them without %HDQV58VSOXVWZRFRPSRQHQWVKH
GHYHORSHGKLPVHOI
touching code!
\RXDUHKHUH
EHQH¿WVRI(-%
?PI\LWM[-2*ZMITTaOQ^MUM'
(-%OHWV\RXIRFXVRQWKHEXVLQHVVORJLF
IRU\RXUEXVLQHVVDQGOHDYHWKHXQGHUO\LQJ
(-%VHUYHUVJLYH\RXDEXQFK
VHUYLFHV WUDQVDFWLRQVQHWZRUNLQJ
RIVHUYLFHVVRWKDW\RXGRQ·W
VHFXULW\HWF WRWKH(-%VHUYHUYHQGRU KDYHWRZULWHWKHP\RXUVHOI
)MAGINE YOU WORK FOR 'UITAR ,AND A COMPANY THAT SELLS
5 7UDQVDFWLRQPDQDJHPHQW
MUSICIANS GEAR ONLINE 9OU HAVE BETTER THINGS TO DO THAN
WORK HOURS A WEEK SO WHERE WOULD YOU WANT TO SPEND YOUR
TIME 7OULDNT YOU RATHER CONCENTRATE ON HOW 'UITAR ,AND
5 6HFXULW\
DOES BUSINESS ONLINE AS OPPOSED TO WRITING YOUR OWN SECURE
NETWORKED TRANSACTION MANAGEMENT SERVER 7HY NOT WORK
ON WHAT YOU KNOW BEST BUSINESS LOGIC FOR YOUR PARTICULAR
5 &RQFXUUHQF\
BUSINESS AND LEAVE THE HEAVY LIFTING IE
THE BIG INFRASTRUCTURE SERVICES YOU GET
FROM THE SERVER TO SOMEONE ELSE
5 1HWZRUNLQJ
4HE %*" MODEL IS TO LET EVERYONE DO
WHAT THEY DO BESTTHE SERVER VENDORS
CONCENTRATE ON THE INFRASTRUCTURE THAT MOST 5 5HVRXUFHPDQDJHPHQW
ENTERPRISE APPLICATIONS NEED WHILE THE
BUSINESS DEVELOPERS CONCENTRATE ON THEIR OWN
BUSINESS LOGIC 5 3HUVLVWHQFH
(-%OHW·V\RXFXVWRPL]HDQG
FRQÀJXUHUHXVDEOHFRPSRQHQWVDW 5 0HVVDJLQJ
GHSOR\WLPHZLWKRXWWRXFKLQJWKH
VRXUFHFRGH
5 'HSOR\WLPHFXVWRPL]DWLRQ
9OU CAN CHANGE THE WAY A BEAN USES THE
UNDERLYING SERVICES SIMPLY BY TWEAKING AN 8-L DOCUMENT
AT DEPLOY
TIME &OR EXAMPLE YOU CAN COMPLETELY DElNE THE
SECURITY ACCESS CONTROL FOR A BEANS METHODS WITHIN 8-,
y alre a d y wrotef,
DECLARATIVELY RATHER THAN WITHIN THE BEANS SOURCE CODE
Somebodsted all this stuf
PROGRAMMATICALLY !ND YOU CAN CUSTOMIZE THE WAY A BEANS
and te donÕt have to.
METHODS RUN IN TRANSACTIONS ALL WITHIN THE DEPLOYMENT so you
DESCRIPTOR WITHOUT HAVING TO HARD
CODE IN TRANSACTION
BOUNDARIES AND BEHAVIORS 4HAT JUST ROCKS
&KDSWHU
LQWURWR(-%
you
vendor
6WUWZM^MVLWZTWKSQV
(QWHUSULVHEHDQVDUHSRUWDEOH³
QRWMXVWWRGLIIHUHQW-90·VEXW ,QVWHDGRIOHDUQLQJ
WRGLIIHUHQW(-%VHUYHUV DQHZ$3,IRUHDFKDSSVHUYHU
ZLWK(-%,RQO\OHDUQ21(DQGP\
FRPSRQHQWVZLOOZRUNRQDQ\(-%VHUYHU
/NE OF THE REASONS WE ALL LOVE *AVA IS ITS 7KRVHYHQGRUVDUHJRQQDKDYHWRVXFNXS
PORTABILITY ACROSS MULTIPLE PLATFORMS 4HE WHOLE WR0(IRUDFKDQJH
WRITE
ONCE
RUN
ANYWHERE 7/2! THING
%*" TAKES PORTABILITY TO A NEW LEVEL INSTEAD OF
WRITE
ONCE
RUN
ANYWHERE ITS WRITE
ONCE
DEPLOY
ANYWHERE 7/$! *UST AS 7/2! FREES YOU
FROM BEING FORCED TO WORK ON A SINGLE /3
7/$! FREES YOU FROM BEING AT THE MERCY OF
YOUR APPLICATION SERVER VENDOR !ND THEN OF
COURSE THERES 9/$! BUT WE DIGRESS
)N THE OLD DAYS EACH APPLICATION SERVER VENDOR
HAD ITS OWN PROPRIETARY !0) 9OU LEARN IT WORK
WITH IT AND lNALLY GET YOUR ENTERPRISE APPS UP
AND RUNNING !ND THEN GUESS WHAT 9OU NEED A
NEW FEATURE !ND THEN GUESS WHAT 9OUR VENDOR
SAYS h7ERE CONSIDERING THAT FOR 1 OF NEXT
YEARv .OW WHAT ,IKE A DRUG DEALER THEYVE
HOOKED YOU AND NOW ITS JUST TOO PAINFUL TO
CONSIDER GIVING THEM UP 'IVE THEM UP FOR
WHAT !NOTHER VENDOR AND ANOTHER PROPRIETARY
!0) AND MORE LOCK
IN
/NE OF THE CRUCIAL BENElTS OF %*" IS 7/$!
!ND NOW THE VENDORS HAVE TO COMPETE NOT JUST
TO SELL YOU IN THE lRST PLACE BUT TO KEEP YOU
"ECAUSE AS EVERYBODY KNOWS YOU CAN JUST PACK
UP YOUR BEANS AND GO ELSEWHERE
\RXDUHKHUH
(-%TXHVWLRQV
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: 7HATS THE DIFFERENCE Q: #AN ) USE %*" COMPONENTS Q: 7HATS THE DIFFERENCE
BETWEEN %*" AND *%% WITHOUT AN %*"
COMPLIANT APP BETWEEN REGULAR JAVABEANS AND
SERVER ENTERPRISE JAVABEANS
A: "OTH *%% AND %*" ARE
A: A:
SPECIFICATIONS FOR A SERVER "UT %*" .OPE %*" COMPONENTS CANT #ONGRATULATIONS 9OURE THE
IS ACTUALLY A SUBSET OF *%% )N OTHER LIVE OUTSIDE OF AN %*" CONTAINER 4HEY MILLIONTH PERSON TO HAVE ASKED THAT
WORDS A *%% SERVER MUST INCLUDE DONT HAVE A MAIN METHOD AND EVEN QUESTION
AN %*" CONTAINER 7EVE USED THE IF YOU ADD ONE TO YOUR BEAN CLASS 4HE TERM hJAVABEANv MEANS A
WORD SERVER ON THESE FIRST PAGES BUT THE BEAN WOULDNT BE VERY USEFUL REUSABLE COMPONENT 2EGULAR OLD
TECHNICALLY THE THING THAT ENTERPRISE ON ITS OWN -OST OF THE METHODS IN NON
ENTERPRISE BEANS AND BEANS IS
JAVABEANS RUN IN IS CALLED AN %*" AN ENTERPRISE BEAN ARE CALLED BY THE JUST A SHORTER FORM OF JAVABEANS ARE
CONTAINER 3O EVERY *%% SERVER MUST CONTAINER ITSELF AND HAVE NO MEANING
REUSABLE COMPONENTS THAT FOLLOW A
INCLUDE AN %*" CONTAINER ALONG OUTSIDE THE SERVER 2EMEMBER THE NAMING CONVENTION THAT CAN BE USED
WITH A 7EB CONTAINER THAT CAN RUN WHOLE POINT OF AN %*" SERVER IS TO BY DEVELOPMENT TOOLS
SERVLETS AND *30S GIVE YOU ALL THE BIG SERVICES SECURITY
TRANSACTIONS ETC AND WITHOUT THE "Y FAR THE MOST COMMON TYPE OF
4HIS EXAM IS ABOUT THE %*" PORTION
SERVER YOUD LOSE EVERYTHING BUT JAVABEAN IS ANY '5) COMPONENT LIKE
OF *%% WHEREAS THE 3#7#$ EXAM
YOUR BASIC BUSINESS LOGIC !ND IF THAT A 3WING BUTTON OR TEXT FIELD .EARLY
3UN #ERTIFIED 7EB #OMPONENT
BUSINESS LOGIC RELIES ON THE CONTAINER ALL *AVA )$%S ARE JAVABEAN
COMPLIANT
$EVELOPER IS ABOUT THE 7EB PORTION
FOR EXAMPLE CALLING METHODS SO THAT IF YOURE WORKING IN A VISUAL
OF *%%
ON INTERFACES PROVIDED BY THE LAYOUT TOOL YOU CAN CLICK ON A BUTTON
,ATER IN THIS CHAPTER WELL GET MORE CONTAINER THEN EVEN THE BUSINESS AND UP POPS A PROPERTY SHEET WHERE
INTO THE DETAILS OF HOW *%% AND %*" LOGIC WOULD FAIL YOU CAN SET THE COLOR SIZE FONT ETC
FIT TOGETHER 4HE TOOL KNOWS WHICH PROPERTIES THE
&OR THE REST OF THIS BOOK WE USE
THE TERMS %*" SERVER CONTAINER
Q: #AN ) DESIGN AND WRITE MY
BEAN HAS BECAUSE THE BEAN FOLLOWS
CONVENTIONS FOR GETTERS AND SETTERS
AND SERVER INTERCHANGEABLY )F THE CODE IN SUCH A WAY THAT MOST OF "UT REGULAR JAVABEANS ARENT JUST
DIFFERENCE BETWEEN THE TERMS THE BUSINESS LOGIC IS IN A PLAIN OLD FOR '5) COMPONENTSOTHER *AVA
MATTERS WELL MAKE IT CLEAR *AVA CLASS AND JUST HAVE THE BEAN TECHNOLOGIES INCLUDING *INI AND
CALL METHODS ON THAT CLASS 4HAT 3ERVLETS CAN USE JAVABEAN FEATURES
WAY ) COULD STILL REUSE THE BUSINESS
LOGIC %NTERPRISE JAVABEANS ARE ALSO
REUSABLE COMPONENTS BUT THATS
WHERE THE SIMILARITY ENDS 4HE @BEAN
A: 9ES YOU CAN DO THAT AND IN PART OF A REGULAR JAVABEAN IS USED
MOSTLY AT DEVELOPMENT
TIME AS A
FACT A LOT OF DESIGNERS WRITE SEPARATE
NON
BEAN REUSABLE CLASSES AND THEN WAY TO EASE OR SPEED UP HOOKING
HAVE THE BEANS INVOKE METHODS ONE BEANS EVENTS TO ANOTHER BEANS
ON THOSE CLASSES )F YOUR BEAN CALLS METHODS OR SETTING PROPERTY VALUES
A METHOD ON A NON
BEAN *AVA WHICH OFTEN MEAN THE SAME THING
CLASS THAT METHOD IS STILL UNDER THE AS INSTANCE VARIABLE VALUES ! REGULAR
CONTROL OF THE CONTAINER SO AS FAR BEAN RUNS IN A *6- JUST LIKE ANY
AS THE CONTAINER IS CONCERNED THAT OTHER NORMAL *AVA CLASS "UT THE
NON
BEAN METHOD IS JUST PART OF THE hBEANv PART OF AN ENTERPRISE BEAN
BEANS FUNCTIONALITY KICKS IN AT RUNTIME AND AN ENTERPRISE
BEAN MUST BE RUN UNDER THE CONTROL
OF AN %*" CONTAINER
&OR THE REST OF THE BOOK WHEN WE
SAY BEAN WE MEAN ENTERPRISE BEAN
&KDSWHU
LQWURWR(-%
0W_LWM[Q\ITT_WZS'
<RXUEHDQVUXQXQGHUWKHFRQWURO DQGSURWHFWLRQ
RIWKH(-%VHUYHU
7KHVHUYHUVWHSVLQWRWKHPLGGOHRIHYHU\
PHWKRGFDOOIURPDFOLHQWWRDEHDQDQGLQVHUWV
WKH´VHUYLFHVµOLNHVHFXULW\WUDQVDFWLRQVDQG
SHUVLVWHQFH
9OUR BEANS LIVE AND RUN IN THE SERVER AND THE SERVER DOES VIRTUALLY
EVERYTHING TO MANAGE TRANSACTIONS SECURITY PERSISTENCE AND EVEN THE LIFE
AND DEATH OF YOUR OBJECTS !ND IT DOES ALL THIS BY STEPPING IN EACH TIME
A CLIENT MAKES A REQUEST IE CALLS A BUSINESS METHOD ON THE BEAN 4HE
SERVER JUMPS IN AND STARTS ASKING QUESTIONS LIKE
h$OES THIS CLIENT HAVE SECURITY CLEARANCE TO CALL THIS METHOD v OR
h$OES THIS BEAN NEED TO RUN AS PART OF A LARGER TRANSACTION v OR
h$OES THIS BEAN NEED TO REFRESH ITSELF WITH DATA FROM THE DATABASE BEFORE RUNNING
THAT METHOD FOR THE CLIENT v
s...
The EJB object HereÕs where it all happd en
the serve r st ep s in an
intercepts the calls to
This client could be let, a the bean. A client can layers in the services. y for
ANYTHINGÑa servapp, NEVER talk directly Most of what you pa
stand-alone Java bean, a to the bean. happens here. Business logic
another enterprise lives here!
mobile device... 6HUYHU
&OLHQW
EL]LQWHUIDFH
VHUYLFHV
biz logic
separate
W
DQ
(Q
& OL
HQWREMHFW
(-%
REMHF WHUS VHEH
UL
from data
(-%&RQWDLQHU '%
$ULGLFXORXVO\KLJKOHYHOYLHZRI(-%DUFKLWHFWXUH
\RXDUHKHUH
ZKDWUHDOO\KDSSHQV
*MPQVL\PM[KMVM[
1RWVRIDVWEXGG\
1RERG\EXW12%2'<WDONVWR
WKHEHDQH[FHSWWKHFRQWDLQHU,I\RX
ZDQWWKHEHDQ\RXJRWWDJRWKURXJKPH
6KRZPHVRPH,'DQG,·OOFKHFNZLWK
WKHFRQWDLQHUDQGLILW·V2.,·OO
SDVVRQ\RXUUHTXHVW
8K\HDKSXW
WKH%URNHUEHDQRQ
WKHSKRQH³,QHHGWR
PDNHDWUDGH12: +PPPPOHW·V
VHHKHGRHVVHHP
WREHRQWKHDSSURYHGOLVW
IRUFDOOLQJPDNH7UDGH RQD
%URNHUEHDQ
(-%2EMHFW
&OLHQW
&RQWDLQHU
&KDSWHU
LQWURWR(-%
:KDWGR\RXPHDQ
WKHUH·VQREHDQ"-XVW
JHWRQHIURPWKHIUHDNLQ·SRRO1R
,QHHGD%URNHUEHDQ
LWGRHVQ·WPDWWHUZKLFKRQH<HV,
GRZQKHUHQRZ6OLP6OHD]\
.12:WKHEHDQVDUHVSRLOHGOLWWOH
QHHGVWRPDNHDWUDGH2KDQG
SULPDGRQQDVEXWWKH\$5(WKHVWDUV
PDNHVXUHWKHEHDQJHWVKLVRZQ
RIWKHVKRZULJKWQRZ
QHZWUDQVDFWLRQ
&RQWDLQHU &RQWDLQHU
2.WKHEHDQLVUHDG\
VRJRDKHDGDQGSDVV
WKHFOLHQW·VPHWKRGUHTXHVWWR
:K\DUHZHXVLQJWKH5,"
WKHEHDQ$QGE\WKHZD\\RXFDQ
$UHQ·W\RXMXVWPDNLQJPHOHDUQ
WHOOOLWWOHPLVV´EHDQTXHHQµVKH
VRPHWKLQJWKDW,FDQQHYHUXVH
EHWWHUVKDSHXS,LQVWDQWLDWHG
LQWKHUHDOZRUOG":K\FDQ·WZH
KHUDQG,FDQVHQGKHUWRWKH
+H\ , ZHQWODVW 7KH\62GRQ·WSD\ XVHD5($/DSSVHUYHU"
JDUEDJHFROOHFWRU
WLPHVRRQHRI\RXFDQ XVHQRXJKIRUWKLV
JRQRZ%HVLGHV,·PVWLOO :H·UHWKHRQHVZKRGRWKH5($/
UHFRYHULQJIURPWKDWELJ EXVLQHVVORJLF%XWDWOHDVWZH
WUDQVDFWLRQUROOEDFN QHYHUKDYHWRWDONWRWKHFOLHQWV
<HDKKDYLQ·DQ(-%2EMHFW
ERG\JXDUGLVSUHWW\
FRRO
&RQWDLQHU
WKH%HDQ3RRO
\RXDUHKHUH
(-%DUFKLWHFWXUH
6KDUSHQ \RXU SHQFLO
/DEHOWKHWKUHHSDUWVLQWKHGLDJUDP
VHUYHU
&OLHQW %
EL]LQWHUIDFH
& OL
HQWREMHFW $ &
'%
'HVFULEH EULHÀ\ ZKDWHDFKRIWKHWKUHHWKLQJVDUH
UHVSRQVLEOHIRURUKRZWKH\EHKDYH
&
&KDSWHU
LQWURWR(-%
EHDQV
*MIV[KWUMQV\PZMMNTI^WZ[
(QWLW\
5SE AN ENTITY BEAN TO REPRESENT A THING IN A 7UL[LD/LQ 3DUW
PERSISTENT STORE 4HAT ALMOST ALWAYS MEANS ,' /DYD/DPS
SOMETHING IN A DATABASE WHERE AN INSTANCE
'% OF AN ENTITY BEAN REPRESENTS A ROW IN A TABLE %R2OHDQ
ALTHOUGH IF THE DATABASE IS NORMALIZED THE ,'
BEAN MIGHT BE DRAWING FROM ROWS IN MULTIPLE
&XVWRPHU ,QYHQWRU\
TABLES ! TYPICAL ENTITY EXAMPLE IS #USTOMER %HDQ %HDQ
WHERE ONE ENTITY MIGHT REPRESENT "O /LEAN
)$ AND ANOTHER ENTITY MIGHT REPRESENT &XVWRPHU
4RIXIA ,IN )$ %HDQ
0HVVDJHGULYHQ
5SE A MESSAGE
DRIVEN BEAN ONLY WHEN YOU
NEED A *-3 CONSUMER )N OTHER WORDS A BEAN ,·PZDLWLQJIRU
THAT CAN LISTEN FOR MESSAGES FROM A *-3 MESSAGING DQQRXQFHPHQWVDERXW ,·PZDLWLQJIRUD
SERVICE #LIENTS NEVER CALL MESSAGE
DRIVEN QHZFXVWRPHUV ELJFDOFXODWLRQMRE
BEANS DIRECTLY IN ORDER TO GET A MESSAGE
WREHSRVWHG
DRIVEN BEAN TO DO SOMETHING A CLIENT MUST
SEND A MESSAGE TO A MESSAGING SERVICE
4HAT MEANS A MESSAGE
DRIVEN BEAN HAS NO
%*"/BJECT BECAUSE THE SERVER GETS THE CLIENT 1HZ&XVWRPHU/LVWHQHU
REQUESTS DIRECTLY FROM A MESSAGING SERVICE %HDQ %LJ&DOF-RE/LVWHQHU
RATHER THAN AS A CALL FROM THE CLIENT TO THE %HDQ
BEAN ! TYPICAL MESSAGE
DRIVEN BEAN MIGHT
BE A .EW#USTOMER.OTIlCATION SUBSCRIBER
6HVVLRQ
5SE A SESSION BEAN FOR EVERYTHING ELSE ,YHULI\
!LMOST ANY KIND OF BACK
END SERVICE CAN FUHGLWFDUGV ,GRJHQHWLF
AND OFTEN SHOULD BEGIN WITH A SESSION BEAN PDWFKLQJ
7HERE AN ENTITY BEAN REPRESENTS A THING A
SESSION BEAN TYPICALLY REPRESENTS A PROCESS 4O
,·PDQRQOLQH
PUT IT ANOTHER WAY WHEN YOU THINK OF ENTITY VKRSSLQJVHVVLRQ
BEANS THINK NOUN AND WHEN YOU THINK OF &DUG9HUL¿HU
%HDQ *HQH%HDQ
SESSION BEANS THINK VERB ! SHOPPING SESSION
IS A TYPICAL EXAMPLE OF A SESSION BEAN WHILE
A CREDIT CARD PROCESSING SYSTEM MIGHT BE
ANOTHER SESSION BEAN &DUW%HDQ
\RXDUHKHUH
VWDWHIXODQGVWDWHOHVVVHVVLRQEHDQV
;M[[QWVJMIV[KIVJM[\I\MTM[[
WZ[\I\MN]T
7ELL GO OVER ALL THIS IN DETAIL IN THE 3ESSION "EAN
CHAPTER &OR NOW YOU NEED TO KNOW THAT SESSION
WKHUH DUH QR
BEANS CAN BE MARKED AT DEPLOYMENT TIME AS
EITHER STATELESS OR STATEFUL
'XPE 4XHVWLRQV
! STATEFUL BEAN CAN REMEMBER CONVERSATIONAL STATE Q: )VE HEARD THAT ONLY
BETWEEN METHOD CALLS WHILE A STATELESS BEAN WONT STATELESS SESSION BEANS ARE
REMEMBER ANYTHING ABOUT THE CLIENT BETWEEN SCALABLE AND THAT NOBODY SHOULD
METHOD INVOCATIONS EVER USE STATEFUL SESSION BEANS
)S THAT TRUE
4HE PHRASE hCONVERSATIONAL STATEv REALLY MEANS
hCLIENT
SPECIl C STATEv AND A TYPICAL EXAMPLE IS
A SHOPPING CART )T WOULDNT BE FUN IF YOU THE A: .O NOT COMPLETELY )T IS
SHOPPER GOT A CART PUT SOMETHING IN BUT THEN TRUE THAT STATELESS SESSION BEANS
WHEN YOU GO TO PUT THE SECOND THING IN THE ARE GENERALLY MORE SCALABLE THAN
l RST THING VANISHES FROM THE CART .OT TOO USER
STATEFUL SESSION BEANS BECAUSE
FRIENDLY 3O A GOOD SHOPPING CART WILL KEEP THE OF THE WAY STATELESS BEANS ARE
MANAGED BY THE CONTAINER 9OULL
CLIENT SHOPPER STATE IE THE ITEMS IN THE CART
SEE THE REASONS FOR THIS IN THE
FOR AS LONG AS THE SHOPPING SESSION IS ALIVE 7ELL 3ESSION "EAN CHAPTER
EXPLAIN WHAT WE MEAN BY ALIVE IN THE 3ESSION "EAN
"UT THAT DOESNT MEAN YOU
CHAPTER
SHOULD NEVER USE STATEFUL BEANS
3TATELESS BEANS SIMPLY FORGET ABOUT THE CLIENT 9OU SHOULD CONSIDER STATEFUL BEANS
ONCE THE METHOD CALL COMPLETES 3O STATELESS WHEN YOU NEED CONVERSATIONAL
BEANS ARE FOR SERVICES THAT DONT REQUIRE A STATE AND WHEN THE ALTERNATIVES
CONTINUED CONVERSATION BETWEEN THE CLIENT AND FOR SAVING THAT STATE LIKE USING
THE CLIENT TO STORE STATE OR USING
THE SERVICE 4HAT DOESNT MEAN THE CLIENT WONT
A SERVLET TO STORE STATE OR USING A
KEEP CALLING METHODS ON THE STATELESS BEAN BUT DATABASE TO STORE STATE BETWEEN
IT DOES MEAN THAT THE CLIENT CANT DEPEND ON THE EACH METHOD CALL FROM THE CLIENT
BEAN REMEMBERING ANYTHING ABOUT THE PREVIOUS ARE MORE OF A PERFORMANCE HIT
METHOD CALLS THAN THE LESS
SCALABLE NATURE OF
STATEFUL SESSION BEANS
6WDWHOHVVEHDQV&$1
KDYHVWDWH -XVWQRW
:DWFKLW FOLHQWVSHFLÀFVWDWH
OHVV´PHDQV
6RPHSHRSOHWKLQN³VWDWH
WDWH OHVVE HDQ FDQKDYH
³QRVWDWH´$V
\R WKHUREMHFW
LQVWDQFHYDULDEOHVOLNHDQ
HP WRPD LQWD LQYDOXHV
LWMXVWFDQ¶WXVHWK
SD UWLFXOD UFOLHQ W
VSHFL¿FWRD
&KDSWHU
LQWURWR(-%
Q , 6 V R P H WKLQJ
HD
$QHQWLW\E V R P HWKLQJ
HDQ ' 2 ( 6
$VHVVLRQE
6KDUSHQ \RXU SHQFLO
.QRZ\RXUEHDQW\SHV
/RRNDWWKHSUREOHPGHVFULSWLRQRQWKHOHIWDQGSXW
DFKHFNPDUNIRUWKHEHDQW\SHWKDWZRXOGEHVW¿W
WKHSUREOHP7KHUHLVQ¶WRQHSHUIHFWULJKWDQVZHU
IRUWKHVH\RXPLJKWGHFLGHWKDWRQHEHDQW\SHZLOO
ZRUNLI\RXDSSURDFKLWRQHZD\EXWDQRWKHUEHDQ
ZLOOZRUNLI\RXVROYHWKHSUREOHPLQDGLIIHUHQWZD\
(QWLW\ 0HVVDJHGULYHQ 6HVVLRQEHDQ
FLUFOHVWDWHOHVVVWDWHIXORUERWK
%RRNLQJDWLFNHWIRUDURFNFRQFHUW VWDWHIXOVWDWHOHVV
$EDQNDFFRXQW VWDWHIXOVWDWHOHVV
6HDUFKLQJDSURGXFWGDWDEDVH VWDWHIXOVWDWHOHVV
'DWLQJVHUYLFHPDWFKXSV VWDWHIXOVWDWHOHVV
5HFHLYLQJVXEPLWWHGH[SHQVHUHSRUWVDQG VWDWHIXOVWDWHOHVV
VHQGLQJWKHPRXWIRUDSSURYDO
2QOLQHH[SHUWGLDJQRVLV²\RXGHVFULEHD VWDWHIXOVWDWHOHVV
V\PSWRPDQGWKHV\VWHPKHOSV\RXGHWHU
PLQHWKHFDXVH
7KHERRNVLQDOLEUDU\ VWDWHIXOVWDWHOHVV
\RXDUHKHUH
7LNLEHDQ/RXQJH
RYHUYLHZ
EHDQEXOOHWSRLQWV
VHVVLRQEHDQDQGEDUWHQGHU
:MDD=LHGAFLK
(-%LVDFRPSRQHQWEDVHG
GHYHORSPHQWPRGHO
&RPSRQHQWVDUHUHXVDEOHFKXQNV
RIIXQFWLRQDOLW\\RXFDQPRGLI\IRU
6HVVLRQEHDQ ,·PVRWLUHGRIGRLQJDOOWKHZRUNDQGJHWWLQJQRQH GLIIHUHQWDSSOLFDWLRQVZLWKRXWWRXFKLQJ
RIWKHJORU\ WKHMDYDVRXUFHFRGH
%DUWHQGHU :KDWGR\RXPHDQ´QRQHRIWKHJORU\·µ"$UHQ·W\RXWKH 2QHEHQHILWRI(-%LV:2'$³:ULWH
RQO\EHDQWKDW·VEHHQUHTXLUHGE\WKHVSHFVLQFHWKHYHU\EHJLQQLQJ" 2QFH'HSOR\$Q\ZKHUH<RXFDQ
6LQFH(-%" GHSOR\\RXU(-%FRPSRQHQWV
WRDQ\DSSVHUYHUWKDW·V(-%
6HVVLRQEHDQ )DWORWRIJRRG7+$7GRHVPH$OODQ\RQHZDQWV FRPSOLDQW
WRWDONDERXWQRZLVHQWLW\EHDQV(QWLW\EHDQVHQWLW\EHDQVHQWLW\
EHDQV1RWWKDW,GRQ·WOLNHWKHP³VRPHRIP\EHVWIULHQGVDUH :2'$PHDQV\RXKDYHWROHDUQ
HQWLW\EHDQVEXW,ZLVKSHRSOHZRXOGWDONDERXWZKDW,GR RQO\RQHVWDQGDUG$3,UDWKHUWKDQ
SURSULHWDU\YHQGRUVSHFLILF$3,V
%DUWHQGHU 1RZWKDW\RXPHQWLRQLWHQWLW\EHDQVDUHPRVWO\
ZKDWIRONVWDONDERXWKHUHDWWKHEDUZKDWZLWKWKHELJ&03 7KH(-%DUFKLWHFWXUHXVHVDQ
LPSURYHPHQWVLQ(-% (-%2EMHFWWRLQWHUFHSWFOLHQWFDOOVWRD
EHDQ7KLVJLYHVWKHVHUYHUFRQWDLQHU
6HVVLRQEHDQ $QGWKDW·VDQRWKHUWKLQJZKDWLVWKH%LJ'HDOZLWK DFKDQFHWRVWHSLQDQGDGGVHUYLFHV
&03",W·VMXVWJRLQJWRDGDWDEDVH6HULRXVO\WHOOPH:+$7LVVR
VSHFLDODERXWWKDW"´2RRKKKORRN,WXSGDWHGDUHFRUGµ3OHDVH
(-%VHUYLFHVLQFOXGHWUDQVDFWLRQV
VHFXULW\UHVRXUFHPDQDJHPHQW
%DUWHQGHU <HDKEXWWKHSURJUDPPHUVDURXQGKHUHVHHPWROLNH QHWZRUNLQJDQGSHUVLVWHQFH
QRWKDYLQJWRGRDOOWKHGDWDEDVHFRGHQRZ$QGWKHUH·VVRPHWKLQJ %HDQVFRPHLQWKUHHIODYRUV (QWLW\
DERXWSHUVLVWHQWUHODWLRQVKLSV,MXVWFDQ·WTXLWHUHPHPEHU
6HVVLRQDQG0HVVDJHGULYHQ
6HVVLRQEHDQ &05&RQWDLQHUPDQDJHGUHODWLRQVKLSV2.HYHQ (QWLW\EHDQVUHSUHVHQWDXQLTXHO\
,KDYHWRDGPLWWKDW&05PDNHVWKLQJVDORWHDVLHUIRUGHYHORSHUV LGHQWLILDEOHWKLQJLQDSHUVLVWHQW
%XWWKDW·VQRWZKDWEXJVPH³,.12:HYHU\ERG\OLNHVHQWLW\EHDQV VWRUH XVXDOO\WKDWPHDQVDURZLQD
EXWZKDWDERXW0(":KDWDERXWHYHU\WKLQJ,GR"(QWLW\EHDQV
GDWDEDVHWDEOH
UHSUHVHQWWKLQJVLQWKHV\VWHPEXWZLWKRXWPHWKRVHWKLQJVGRQ·W
GRPXFK0D\EHDQHQWLW\KDVVRPHJHWWHUVDQGVHWWHUVDQGVRPH 0HVVDJHGULYHQEHDQVDUH-06
TXHULHVVXUHEXWQRWDORWRIEXVLQHVVORJLF7RXVHHQWLW\EHDQVLQDQ PHVVDJLQJVHUYLFHFRQVXPHUV
DSS\RXSUHWW\PXFK+$9(WRXVHVHVVLRQEHDQVWRGRWKHEXVLQHVV
SURFHVVLQJ/LNHDQHQWLW\EHDQPLJKWUHSUHVHQWWKHGULQNV\RXVHOO 6HVVLRQEHDQVDUHHYHU\WKLQJHOVH
KHUHDQGWKHLQGLYLGXDOFXVWRPHUVEXWZKDWJRRGDUHGULQNVDQG
6HVVLRQEHDQVFDQEHVWDWHIXORU
FXVWRPHUVZLWKRXWDEDUWHQGHU"<RXQHHGVRPHRQHWRDFWXDOO\SXW
VWDWHOHVV
WKHHQWLWLHV WKHGULQNVDQGWKHFXVWRPHUV WRJHWKHULQDPHDQLQJIXO
ZD\$QGWKDW·VZKDWVHVVLRQEHDQVGR:HGRWKHGHDOV:HZRUN 6WDWHIXOEHDQVFDQUHPHPEHU
ZLWKWKHFOLHQWWRJHWVRPHWKLQJGRQHZKLOHHQWLWLHVMXVWVLWWKHUH ´FRQYHUVDWLRQDOVWDWHµZLWKDFOLHQW
ZDLWLQJIRUVHVVLRQEHDQVWRXVHWKHP+H\FDQ,JHWDQRWKHURQHRI ZKLOHVWDWHOHVVEHDQVFDQQRW
WKRVH"$QGGRQ·WHYHQJHWPHVWDUWHGRQPHVVDJHGULYHQEHDQV
>7REHFRQWLQXHG@
&KDSWHU
LQWURWR(-%
7HOO\RXUERVV
7UHDW\RXUVHOIWR
WKHUHSRUWZLOO
DFROGRQH<RX
KDYHWRZDLW7KHUH·V
GHVHUYHLW
SRZGHUDW$VSHQ
-`IUXTM"
7KDWVKDGHRI
<PM)L^QKM/]aJMIV JUHHQLVQ·WUHDOO\
"EFORE WE GET INTO THE GUTS OF %*" LETS ZRUNLQ·IRU\RX
LOOK AT HOW TO DEVELOP DEPLOY AND TEST
A BEAN FROM START TO lNISH )F YOURE
NOT ALREADY FAMILIAR WITH %*" YOU WONT
UNDERSTAND EVERYTHING HERE $ONT WORRY
ABOUT IT NOW WELL lGURE IT ALL OUT IN LATER
CHAPTERS 4HIS IS JUST TO GIVE YOU A FEELING
FOR WHAT ITS LIKE TO GET A BEAN UP AND
RUNNING
/UR lRST BEAN IS FOR THE !DVICE 'UY 7KH$GYLFH*X\
SERVICEA REMOTE SERVICE THAT GIVES BACK
AN ADVICE 3TRING EACH TIME THE CLIENT 2XU¿UVWEHDQLVIRUWKH$GYLFH*X\
MAKES A REQUEST 7ELL SPEND THE NEXT VHUYLFH(DFKWLPHWKHFOLHQWPDNHV
SEVERAL PAGES LOOKING AT THE PROCESS AND DUHTXHVWWKH$GYLFH*X\VHUYLFH
THEN WELL ACTUALLY MAKE THIS BEAN AS A DQHQWHUSULVHMDYDEHDQ JLYHVEDFN
TUTORIAL DSLHFHRIVWXQQLQJO\KHOSIXO DQG
SUHWHUQDWXUDOO\DSSURSULDWH DGYLFH
,Q+HDG)LUVW-DYDZHGHSOR\HGWKH$GYLFH
*X\VHUYLFHXVLQJVWUDLJKW7&3VRFNHWV1RZ
IRURQO\ILYHWLPHVWKHDPRXQWRIFRGHDQG
HIIRUWZHJHWWRKDYHWKHVDPHVHUYLFHLQ(-%
2IFRXUVHLIRQHIHOWOLNHLWRQHFRXOGDUJXH
WKDWWKH$GYLFH*X\GRHVQ·WUHDOO\QHHGDOO
WKRVH(-%VHUYLFHVEXWZHGLVDJUHH:H·UH
DOUHDG\SODQQLQJWKH,32IRUWKLVEDE\
\RXDUHKHUH
¿YHVWHSVWREXLOGLQJDEHDQ
.Q^M\PQVO[aW]LW\WJ]QTLIJMIV"
7KHVHDUHWKH
VWHSV\RX·OOJRWKURXJK
&RGHWKHEHDQFODVVZLWKDOORIWKH IRUDOPRVWHYHU\EHDQ\RX·OO
MDYD[HME
LPSRUWMDYD
UPL5HPRWH([ EXVLQHVVPHWKRGV PDNH&RGLQJLVVLPSOH WKH
FHSWLRQ
WULFN\SDUWLVGHSOR\LQJ
$GYLFH%HDQMDYD
&RGHWZRLQWHUIDFHVIRUWKHEHDQ
MDYD[HME
LPSRUWMDYD
UPL5HPRWH([
FHSWLRQ
KRPHDQGFRPSRQHQW
$GYLFH+RPHMDYD
$GYLFHMDYD
&UHDWHDQ;0/GHSOR\PHQWGHVFULSWRU
'2&7<3(
HMEMDU
WKDWWHOOVWKHVHUYHUZKDW\RXUEHDQLVDQG
38%,QF
HMEMDU[PO
KRZLWVKRXOGEHPDQDJHG<RXPXVWQDPHLW
HMEMDU[PO
3XWWKHEHDQWKHLQWHUIDFHVDQGWKH
-$5
GHSOR\PHQWGHVFULSWRULQWRDQHMEMDU¿OH
7KHUHPLJKWEHPRUHWKDQRQHEHDQLQWKH
HMEMDU
HMEMDUEXWWKHUHZLOODOZD\VEHMXVWRQH
GHSOR\PHQWGHVFULSWRU
'HSOR\WKHEHDQLQWRWKHVHUYHUXVLQJWKH
WRROVSURYLGHGE\WKHVHUYHUYHQGRU
<RXGRQ¶WQHHGWREHDQ;0/H[SHUW
,QIDFW\RXGRQ¶WKDYHWRNQRZDQ\WKLQJDWDOODERXWKRZ;0/ZRUNV<RXGRQHHG
WRNQRZDERXWPDQ\RIWKHGHSOR\PHQWGHVFULSWRUWDJVEXW\RXGRQ¶WQHHGWRNQRZ
DERXW;0/LQRUGHUWROHDUQWKHWDJV,I\RXWKLQNRIWKHWDJVDVVLPSO\ODEHOVLQDGRFXPHQW
ZLWKYHU\VSHFL¿FUHTXLUHPHQWVIRUZKDW\RX¶UHDOORZHGWRW\SHZLWKLQWKRVHODEHOVWKHQDOO\RX
QHHGWRNQRZIRUWKHH[DPLVWKHQDPHDQGUHTXLUHPHQWVIRUVRPHRIWKHPRVWLPSRUWDQWODEHOV
WDJV :H¶OOORRNDWWKRVHFUXFLDOWDJVLQVHYHUDOFKDSWHUV
&KDSWHU
LQWURWR(-%
EHDQFODVV
LQWHUIDFHV
;0/'' MDYD[HME
LPSRUWMDYD
HMEMDU UPL5HPRWH([
FHSWLRQ
GHSOR\ $GYLFH%HDQMDYD
:ULWHWKHEHDQFODVVZLWK a ve o n ly o ne businessBean
we h for the Advice
WKHDFWXDOEXVLQHVVPHWKRGV method
WKHFOLHQWFDOOV
SXEOLF6WULQJJHW$GYLFH ^
4HIS IS WHERE IT ALL HAPPENS 4HE DGYLFHJHQHUDWLQJFRGH
IMPLEMENTATION OF YOUR BUSINESS `
METHODS DEl NED IN THE COMPONENT
INTERFACE )N OTHER WORDS YOU WRITE YOUR
BUSINESS LOGIC IN THE BEAN CLASS
4HERE ARE THREE BEAN TYPES TO CHOOSE
<RXPXVWNQ
WRZULWHDOO
RZKRZ
WKHFRGH
KRXW
FROM 3ESSION %NTITY AND -ESSAGE
DRIVEN :DWFKLW E\KDQGZ (
LW
-% UHDG\
AND WELL COVER EACH ONE IN DETAIL IN LATER XVLQJDQ
WWRRO
CHAPTERS OF THE BOOK "EFORE MAKING GHYHORSPHQ
A BEAN THOUGH YOU MUST DECIDE WHAT WRZULWH
GWRNQRZKRZ
TYPE YOU NEED BECAUSE YOUR BEAN CLASS <RX¶UHH[SHFWH GWK H EH DQFODVV
FHVDQ
MUST IMPLEMENT ONE OF THREE INTERFACES WKHWZRLQWHUID QVMXVWWKH
JHGULYHQEHD
DEPENDING ON THE TYPE YOU CHOOSE RUIRUPHVVD \ RX VKRXOG
DWPHDQV
EHDQFODVV 7K DU HGH YH ORSPHQW
-%D Z
7EVE CHOSEN A 3ESSION BEAN HERE 127XVHDQ( EH DQRU
VRPHRIWKH
BECAUSE ITS PERFECT FOR THE !DVICE 'UY WRROWKDWEXLOGV QW LO\R X¶UH
IRU\RXX
APPLICATION !DVICE 'UY GIVES BACK LQWHUIDFHFRGH FWO\ Z KD WF RGHWKH
ZH [D
AN ADVICE 3TRING WHEN YOU INVOKE THE FHUWDLQ\RXNQR
IRU\RX
SURPRISINGLY
NAMED GET!DVICE METHOD WRROLVFUHDWLQJ GWR
SLOH R IUXOHV\RXQHH
3O OUR BEAN CLASS ON THE NEXT PAGE 7KHUH¶VD QG LQ WK H QH[WIHZ
[DP D
NQRZIRUWKHH JR U\ GHWDLOV
IMPLEMENTS THE 3ESSION"EAN INTERFACE UV Z H¶OOJHWLQWRWKH
FK DS WH HPRUL]LQJ
!ND 3ESSION"EAN ISNT JUST A MARKER ZRUU\DERXWP
)RUQRZGRQ¶W LVH[HUFLVH
INTERFACE
IT HAS METHODS YOUR BEAN WKHFRGHLQWK
DQ\WKLQJIURP QH HG WROHDUQLW
\RX:,//
CLASS MUST IMPLEMENT -XVWNQRZWKDW
GRQH
4HE METHODS YOU IMPLEMENT FROM DOOEHIRUHZH¶UH
HYHU²
THE 3ESSION"EAN INTERFACE ARE KNOWN JRRGQHZVKRZ
7KHUHLVVRPH H;0/
AS CONTAINER
CALLBACKS BECAUSE THE WRROWREXLOGWK
\RX&$1XVHD H[ DP
FULSWRU7KH
CONTAINER USES THEM TO NOTIFY YOU OF GHSOR\PHQWGHV HP RU L]HDOOWKH
W\RXWRP
IMPORTANT MILESTONES IN THE BEANS LIFE GRHVQ¶WH[SHF LOOQHHGWR
OWKRXJK\RXZ
;0/WDJV $ YHUWKHP
RZ D IH Z H OH PHQWV ZH¶OOFR
NQ
ODWHU
$PDUNHULQWHUIDFH DOVRFDOOHGDWDJLQWHUIDFH KDV
QRPHWKRGVWRLPSOHPHQWDQGH[LVWVVRWKDW\RXFDQ
DQQRXQFHWRWKHZRUOGWKDW´<HV,FDQGRWKLVµ
\RXDUHKHUH
WKHEHDQFODVV
MDYD[HME
LPSRUWMDYD
UPL5HPRWH([
FHSWLRQ
%HDQFODVV $GYLFH%HDQMDYD
4HE !DVICE"EAN IMPLEMENTS THE 3ESSION"EAN INTERFACE SO IT MUST IMPLEMENT
THE METHODS DECLARED IN JAVAXEJB3ESSION"EAN 7ELL GRILL YOU ON EVERYTHING
A LITTLE LATER FOR NOW JUST REMEMBER THAT THE BEAN CLASS IS WHERE YOUR ACTUAL
BUSINESS LOGIC GOES )N OTHER WORDS THE REASON YOUR BEAN EXISTS IN THE l RST
PLACE &OR THE !DVICE 'UY THAT MEANS THE GET!DVICE METHOD
an type
e of the threeDberiven)
SDFNDJHKHDG¿UVW
age pl em en t on
LPSRUWMDYD[HME
you need this pack im
You MUST sion, Entity, or Message
interfaces (Ses
SXEOLFFODVV$GYLFH%HDQLPSOHPHQWV6HVVLRQ%HDQ^
SULYDWH6WULQJ>@DGYLFH6WULQJV ^³2QHZRUG LQDSSURSULDWH´³<RXPLJKW
ZDQWWRUHWKLQNWKDWKDLUFXW´³<RXUERVVZLOOUHVSHFW\RXLI\RXWHOOKLP
ZKDW\RX5($//<WKLQNRIKLP´³9LVXDOL]H\RXUVHOIZLWKEHWWHUFORWKHV´
³2IFRXUVH\RXGRQ¶WKDYHWRJRWRZRUNWRGD\´³'R\RXUHDOO\WKLQN\RX
VKRXOGEHOHDYLQJWKHKRXVHOLNHWKDW"´³5HDGDERRNRQFHD\HDUZKHWKHU
\RXQHHGWRRUQRW´` The business method
(g etAdvice()) randomly pic
e of these Strings to re ks
SXEOLFYRLGHME$FWLYDWH ^
6\VWHPRXWSULQWOQ ³HMEDFWLYDWH´ on
turn.
`
he
SXEOLFYRLGHME3DVVLYDWH ^
m e t h o d s are from thave
6\VWHPRXWSULQWOQ ³HMESDVVLYDWH´ u
These foueran interface, so yohis simple
`
SessionB hem in here. For t anything
SXEOLFYRLGHME5HPRYH ^ to put t donÕt need to do got print
6\VWHPRXWSULQWOQ ³HMEUHPRYH´ bean, we ethods, but weÕve when (or
` in the m ts so you can see donÕt
statemen e called. For now, e for !
SXEOLFYRLGVHW6HVVLRQ&RQWH[W 6HVVLRQ&RQWH[WFW[ ^ if) theyÕrout what these ar
6\VWHPRXWSULQWOQ ³VHVVLRQFRQWH[W´ worry ab
`
Finally! The actual
SXEOLF6WULQJJHW$GYLFH ^ business method from th
6\VWHPRXWSULQWOQ ³LQJHWDGYLFH´ component interface. ItÕse
LQWUDQGRP LQW 0DWKUDQGRP DGYLFH6WULQJVOHQJWK the whole point of th
UHWXUQDGYLFH6WULQJV>UDQGRP@ bean... the thing the clie en
`
wants to call. t
SXEOLFYRLGHME&UHDWH ^ You must have an ejb ea
6\VWHPRXWSULQWOQ ³LQHMEFUHDWH´ ItÕs an EJB rule youÕlCr
l lea
te() method.
` later. But it does not co rn about
` the SessionBean interfa me from
ce.
&KDSWHU
LQWURWR(-%
EHDQ
LQWHUIDFHV LPSRUW
MDYD[HME
;0/'' LPSRUWMDYD
FHSWLRQ MDYD[HME
HMEMDU LPSRUWMDYD
UPL5HPRWH([
$GYLFHMDYD FHSWLRQ
GHSOR\
$GYLFH+RPHMDYD
:ULWHWZRLQWHUIDFHVIRUWKHEHDQ
4HESE ARE THE INTERFACES THE CLIENT SEES 7E HAVE AN ENTIRE CHAPTER
DEVOTED TO THESE INTERFACES SO YOU DONT HAVE TO UNDERSTAND IT ALL NOW
&20321(17LQWHUIDFH FRPSRQHQW
LPSRUW
LQWHUIDFH
4HIS IS WHERE ALL THE BUSINESS METHODS ARE DECLARED )N OTHER WORDS MDYD[HME
LPSRUWMDYD
UPL5HPRWH([ EXVLQHVV
ITS WHERE YOU PUT THE METHODS THE CLIENT WANTS TO CALL FHSWLRQ
PHWKRGV
$GYLFHMDYD
SDFNDJHKHDG¿UVW
o
you need theseentwts.
LPSRUWMDYD[HME
import statem terface,
the EJBObjectteinr
LPSRUWMDYDUPL5HPRWH([FHSWLRQ
exte nd eith er
It must which weÕll see la
or E JBLocalObject,
SXEOLFLQWHUIDFH$GYLFHH[WHQGV(-%2EMHFW^ You must declare Remote-
Exception on all methods in
SXEOLF6WULQJJHW$GYLFH WKURZV5HPRWH([FHSWLRQ
this interface!
This is the
`
whole reasonacttheual business method. (the
correspond to bean exists). It MUST
a method in the
bean class.
+20(LQWHUIDFH KRPH
LPSRUW
LQWHUIDFH
4HE CLIENT USES THE HOME INTERFACE TO ASK FOR A REFERENCE TO THE MDYD[HME
LPSRUWMDYD
DIDFWRU\
COMPONENT INTERFACE 4HE HOME IS THE CLIENTS STARTING POINT FOR GETTING FHSWLRQ
IRUEHDQ
$GYLFH+RPHMDYD
HOLD OF A REFERENCE TO A BEAN OR AT LEAST WHAT THE CLIENT THINKS IS THE UHIHUHQFHV
BEAN BUT WELL GET TO THAT LATER &OR NOW THINK OF THE HOME AS A KIND
OF FACTORY THAT MAKES AND DISTRIBUTES BEAN REFERENCES TO CLIENTS
statements
SDFNDJHKHDG¿UVW
same import
LPSRUWMDYD[HME
as above. nd
ome
either the EJBeÕHll see later
m e m ust exte w
LPSRUWMDYDUPL5HPRWH([FHSWLRQ The ho LocalHome, which exceptions,
interface, or EJB need TWO ption
This time weeption and RemoteExce
SXEOLFLQWHUIDFH$GYLFH+RPHH[WHQGV(-%+RPH^ CreateExc
SXEOLF$GYLFHFUHDWH WKURZV&UHDWH([FHSWLRQ5HPRWH([FHSWLRQ
the create() method
`
component interface must return your
type!!
\RXDUHKHUH
WKHEHDQLQWHUIDFHUHODWLRQVKLS
:DLWMXVWDPLQXWH
KHUHKRZFRPHZH·UH
PDNLQJWKHEHDQFODVV
EHIRUHWKHLQWHUIDFHV"
7KDWGRHVQ·WVRXQGULJKW
$QGWKDW·VQRWHYHQWKHZRUVW
WKLQJ$GYLFH%HDQGRHVQ·W
LPSOHPHQWWKH$GYLFHLQWHUIDFH"/HWPH
JHWWKLVVWUDLJKW\RX0867KDYHWKHVDPH
PHWKRGVLQWKHEHDQWKDW\RXKDYHLQWKH
FRPSRQHQWLQWHUIDFH\HW\RXGRQ·WPDNHWKH
EHDQLPSOHPHQWWKHLQWHUIDFH"
(MMM TWO GOOD QUESTIONS )N A NON BEAN *AVA WORLD THE WAY WERE
DOING THINGS HERE WOULDNT MAKE MUCH SENSE "UT BEAN WORLD HAS
DIFFERENT RULES AND PRACTICES 7E COULD WRITE THE INTERFACES lRST AND
SOME DEVELOPERS DO 3OMETIMES THE CHOICE OF WHICH TO DEVELOP lRST
DEPENDS ON THE DEVELOPMENT TOOLS YOURE USING TO BUILD YOUR BEANS
3OME TOOLS FOR EXAMPLE EXPECT YOU TO lRST BUILD YOUR BEAN CODING
THE ACTUAL BUSINESS LOGIC AND THEN THE TOOL WILL BUILD THE INTERFACES
TO MATCH !ND SOME TOOLS DO JUST THE OPPOSITE LOOKING AT THE
INTERFACES AND BUILDING A hYOUR CODE GOES HEREv BEAN CLASS WITH ALL
OF THE METHODS FROM THE INTERFACE &OR LEARNING %*" WE LIKE TO START
WITH THE BEAN FOCUSING ON THE BUSINESS LOGIC BEFORE lGURING OUT THE
INTERFACES ,ATER IN THE BOOK WELL DO IT THE OTHER WAY AROUND
!S FOR THE BEAN NOT IMPLEMENTING THE COMPONENT INTERFACE YOU COULD
DO IT THAT WAY BUT THIS TIME WE STRONGLY URGE YOU NOT TO /N THE NEXT
PAGE WELL LOOK AT THIS IN MORE DETAIL
&KDSWHU
LQWURWR(-%
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: 3O WHY DOESNT THE BEAN Q: "UT THERES AN EASY SOLUTION TO
Q: "UT IF YOU DONT HAVE THE
CLASS !DVICE"EAN IMPLEMENT 4(!4 PROBLEM YOU COULD HAVE THE BEAN IMPLEMENT THE INTERFACE IN
THE COMPONENT INTERFACE !DVICE BEAN EXTEND A CLASS THAT HAS ALL THE OTHER WORDS IF !DVICE"EAN DOESNT
IF IT HAS TO IMPLEMENT THE SAME IMPLEMENTATIONS THAT YOU NEED TO IMPLEMENT !DVICE DOESNT THIS MEAN
METHODS *AVA CLASSES ARE ALLOWED SATISFY THE COMPILER BUT DONT REALLY THAT THE COMPILER WONT CATCH YOU IF
TO IMPLEMENT MORE THAN ONE NEED TO IMPLEMENT IN YOUR CODE ,IKE THE BEAN BLOWS IT AND DOESNT MATCH
INTERFACE SO WHATS THE PROBLEM WITH THE ADAPTER EVENT LISTENER CLASSES IN THE METHODS OF THE INTERFACE
SAYING !74 7HY NOT DO SOMETHING LIKE THAT
FODVV$GYLFH%HDQLPSOHPHQWV
$GYLFH6HVVLRQ%HDQ
HERE AND MAKE A SUPERCLASS FOR YOUR
BEAN THAT IMPLEMENTS THE METHODS
A: 9ES THATS EXACTLY WHAT IT
MEANS !ND YES THAT MAKES MOST
*AVA DEVELOPERS A LITTLE QUEASY JUST
A: ,EGALLY THE BEAN CLASS CAN A: 9ES YOU COULD DO THAT AND IT
THINKING ABOUT IT !FTER ALL THATS ONE
OF THE BENEFITS OF INTERFACES IN *AVA
IMPLEMENT THE COMPONENT INTERFACE WOULD BE LEGAL "UT IT STILL MEANS YOUR
THAT THE COMPILER GUARANTEES THAT
BUT THE SPEC DOESNT RECOMMEND IT BEAN IS CAPABLE OF HAVING METHODS
YOU HAVE ALL OF THE INTERFACE METHODS
2EMEMBER ALTHOUGH TO THE CLIENT IT INVOKED THAT THE BEAN SHOULD
PROPERLY IMPLEMENTED
LOOKS AS THOUGH THE !DVICE"EAN IS THE NEVER KNOW ABOUT 4HE METHODS OF
OBJECT THE CLIENTS INVOKING METHODS %*"/BJECT ARE METHODS FOR THE CLIENT "UT DONT PANIC )N OUR DEVELOPMENT
ON THE OBJECT THAT IMPLEMENTSIN TO CALL ON THE BEAN BUT ./4 FOR THE IN THIS BOOK WE DO HAVE TO BE CAREFUL
THE TRUE *AVA SENSETHE COMPONENT BEAN TO ACTUALLY IMPLEMENT 3O ITS NOT SINCE THE COMPILER ISNT MAKING SURE
INTERFACE THE CLIENT REALLY INVOKES THE BEST // PRACTICE THAT WEVE IMPLEMENTED THE BUSINESS
METHODS ON SOMETHING CALLED AN METHODS FROM THE COMPONENT
!ND THERES STILL ANOTHER REASON WHY
%*"/BJECT THATS IMPLEMENTED BY THE INTERFACE )N THE REAL WORLD HOWEVER
ITS NOT GOOD PRACTICE TO HAVE THE
SERVER AT DEPLOY
TIME 4HE CLIENT NEVER YOULL ALMOST CERTAINLY BE USING AN
BEAN IMPLEMENT THE COMPONENT
INTERACTS DIRECTLY WITH THE BEAN .EVER %*"
READY DEVELOPMENT ENVIRONMENT
INTERFACEIF THE INTERFACE IS REMOTE
EVER EVER ,ATER IN THE BOOK YOULL SEE THAT WILL MAKE SURE YOU PROVIDE THE
AND %*"/BJECT IS SINCE IT EXTENDS THE
THAT IF THE BEAN DOES IMPLEMENT THE METHODS EITHER BY PUTTING A hYOUR
JAVARMI2EMOTE INTERFACE THAT WOULD
COMPONENT INTERFACE YOU COULD SNEAK CODE GOES HEREv VERSION OF THE METHOD
MAKE THE BEAN CLASS A 2EMOTE CLASS
THINGS PAST THE COMPILER THAT WOULD IN YOUR BEAN CLASS OR BY DOING THE
AND THAT MUST NEVER BE 4HE BEAN IS
EXPLODE AT RUNTIME 3O WE STRONGLY REVERSEFINDING THE BUSINESS METHOD
PROTECTED BY THE SERVER AND MUST
URGE YOU NOT TO HAVE YOUR BEAN IN THE BEAN CLASS AND PUTTING IT INTO
NEVER BE ACCESSED IN ANY OTHER WAY
IMPLEMENT THE COMPONENT INTERFACE THE COMPONENT INTERFACE !T THE VERY
BY ANYTHING BUT THE SERVER )TS THE
LEAST MOST SERVERS WILL CHECK BEFORE
"UT THERES ANOTHER ISSUE AS WELLTHE SERVER THAT MAKES THE %*"/BJECT BY
OR AT THE TIME YOU DEPLOY THE BEAN
COMPONENT INTERFACE EXTENDS ANOTHER IMPLEMENTING THE !DVICE INTERFACE
THAT YOUR COMPONENT INTERFACE AND
INTERFACE )N OUR EXAMPLE !DVICE WHICH )3 REMOTE AND WHICH INTERCEPTS
BEAN CLASS HAVE MATCHING METHODS
EXTENDS %*"/BJECT AND %*"/BJECT ALL BUSINESS METHOD CALLS TO THE BEAN
IS NOT A MARKER INTERFACE )T HAS )F THIS STILL BOTHERS YOU THOUGH WE DO
METHODS 4HIS MEANS THAT ANY CLASS HAVE A TECHNIQUE FOR GETTING AROUND IT
IMPLEMENTING !DVICE MUST ALSO THAT WELL LOOK AT A LITTLE LATER #HANCES
IMPLEMENT THE METHODS OF %*"/BJECT ARE YOU WONT NEED TO USE IT
3O YOUR BEAN WOULD END UP
IMPLEMENTING A BUNCH OF METHODS IT
SHOULD NEVER HAVE LIKE GET(ANDLE
GET%*"(OME
\RXDUHKHUH
EHDQ%UDLQ3RZHU
YiX`e
7KHQDPLQJ
FRQYHQWLRQ gfn\i
IRUEHDQVLV
127SDUWRI <RXVDZKRZWKHEHDQGRHVQ¶WLPSOHPHQWWKHFRPSRQHQW
WKH(-%VSHF LQWHUIDFHHYHQWKRXJKWKHEHDQPXVWKDYHWKHVDPHPHWKRGV
%UDLQVWRUPDZD\ WKHUHPD\EHPRUHWKDQRQH LQZKLFK\RX
$GYLFH$GYLFH+RPH FRXOGKDQGOHWKHVHUHTXLUHPHQWVIRUWKH$GYLFH*X\EHDQ
$GYLFH%HDQ
HVH
<RX¶UHQRWUHTXLUHGWRXVHWK 7KHFRPSRQHQWLQWHUIDFH $GYLFH PXVWH[WHQG(-%2EMHFW
HV IRUHQW HUS ULVHEH DQV
QDP
RRG
,W¶VDUHDOO\UHDOO\UHDOO\J 7KHEHDQPXVWLPSOHPHQWWKH6HVVLRQ%HDQLQWHUIDFH7KH
HYH U % HV XUH WKD W EHDQPXVWQRWLPSOHPHQWWKHFRPSRQHQWLQWHUIDFH $GYLFH
LGHDKRZ
¶UHQRW IRR OHG E\WKH QD PH
\RX
OHJDO
RIDFODVVRULQWHUIDFH²LW¶V :HZDQWWKHFRPSLOHUWRYHULI\WKDWWKHEHDQ $GYLFH%HDQ
RP SRQ HQW LQWHUID FH KDVWKHVDPHPHWKRGVDVWKRVHLQWKHFRPSRQHQWLQWHUIDFH
WRKDYHDF
QDPHG$GYLFH+RPHDQGD
HG
FRPSRQHQWLQWHUIDFHQDP +LQW ³WKHVDPHPHWKRGVDVWKRVHLQWKHFRPSRQHQWLQWHU
%HD QI RUH [DP SOH 2 Q IDFH´GRHVQRWPHDQWKHVDPHWKLQJDV³WKHVDPHPHWKRGV
$GYLFH
WKHH[DPDOZD\VJRE\WKH DVWKRVHGHFODUHGLQWKHFRPSRQHQWLQWHUIDFH´
WLRQ
FODVVRULQWHUIDFHGHFODUD
KDQ WKH QD PH RIWKH FODVV +LQW WKLVUHTXLUHVRQO\-DYDNQRZOHGJHQRW(-%NQRZOHGJH
UDWKHUW
7RGD\PDQ\(-%SURJUDPPHUVXVH(-%VDYY\GHYHORSPHQW
WRROV,QRWKHUZRUGVDEHDQFDSDEOH,'(WKDWNQRZVKRZ
WKHWKUHHSLHFHV²KRPHLQWHUIDFHFRPSRQHQWLQWHUIDFH
DQGEHDQFODVV²DUHUHODWHGWRRQHDQRWKHU0DQ\RI
WKHVHWRROVDOVRNQRZKRZWRWDONGLUHFWO\WRRQHRU
PRUHDSSVHUYHUVVRWKDW\RXFDQXVHWKHWRROWRERWK
GHYHORSDQGGHSOR\\RXUEHDQUDWKHUWKDQVZLWFKLQJIURP
%HDQDZDUH DGHYHORSPHQWHQYLURQPHQWWRWKHVHUYHU¶VRZQ DQGRIWHQ
GHYHORSPHQW OHVVIULHQGO\ GHSOR\PHQWWRROV2QHRIWKHDGYDQWDJHVRIDQ
WRROV (-%GHYHORSPHQWWRROLVWKDW\RXPLJKWQRWKDYHWRZRUU\DERXW
PDWFKLQJXSWKHEXVLQHVVPHWKRGVLQWKHFRPSRQHQWLQWHUIDFH
ZLWKWKHDFWXDOEHDQFODVVRUYLFHYHUVD$JRRG(-%DZDUH,'(
ZLOOPDNHVXUH\RX¶YHJRWHYHU\WKLQJV\QFHGXS
&KDSWHU
LQWURWR(-%
EHDQ
D Þle
required! ThemDlÓ
LQWHUIDFHV
;0/'' '2&7<3( This name is ed Òejb-jar.x
must be nam
HMEMDU
HMEMDU 38%,QF
GHSOR\ HMEMDU[PO
tually
&UHDWHDQ;0/GHSOR\PHQWGHVFULSWRU (In this book, we wonÕt ac let the
ll
WKDWWHOOVWKHVHUYHUZKDW\RXUEHDQLVDQGKRZwrite this ourselves;uiwldeÕit for us.)
sb
LWVKRXOGEHPDQDJHG deployment tool
4HE DEPLOYMENT DESCRIPTOR $$ DESCRIBES THE STRUCTURE
OF YOUR BEAN INCLUDING HOW THE THREE l LES COMPONENT
INTERFACE HOME INTERFACE AND BEAN CLASS ARE RELATED TO ONE
ANOTHER 4HE SERVER WONT LOOK AT YOUR NAMING CONVENTION You donÕt have to write
AND l GURE OUT WHICH IS THE HOME WHICH IS THE BEAN ETC 9OU
HAVE TO TELL THE SERVER THROUGH THE $$ WHICH CLASS IS WHICH the XML by hand if you
AND HOW THEYRE CONNECTED "UT THE $$ DOES A LOT MORE THAN
THAT !ND FOR SOME BEANS THE $$ CAN BE SEVERAL PAGES LONG use a tool that can help
&OR THIS SIMPLE BEAN THE $$ IS SHORT 2EMEMBER YOU DONT
NEED TO MEMORIZE THE SYNTAX OF THE 8-, IN THE $$ ,ATER
you build a deployment
IN THE BOOK IN SEVERAL DIFFERENT CHAPTERS WELL GO OVER THE
ASPECTS OF THE $$ THAT YOU DO NEED TO KNOW
descriptor.
"[POYHUVLRQ ´´HQFRGLQJ ´87)´"!
You can use the J2EE
'2&7<3(HMEMDU38%/,&µ6XQ0LFURV\VWHPV RI bean wizard to do it
,QF'7'(QWHUSULVH-DYD%HDQV(1¶µKWWS
MDYDVXQFRPGWGHMEMDUBBGWG¶! for you, and the XML
HMEMDU!
GLVSOD\QDPH!(ME GLVSOD\QDPH!
it spits out will work in
HQWHUSULVHEHDQV! any EJB 2.0 container!
VHVVLRQ!
GLVSOD\QDPH!$GYLFH%HDQ GLVSOD\QDPH!
HMEQDPH!$GYLFH%HDQ HMEQDPH!
KRPH!KHDG¿UVW$GYLFH+RPH KRPH!
UHPRWH!KHDG¿UVW$GYLFH UHPRWH!
HMEFODVV!KHDG¿UVW$GYLFH%HDQ HMEFODVV!
VHVVLRQW\SH!6WDWHOHVV VHVVLRQW\SH!
WUDQVDFWLRQW\SH!%HDQ WUDQVDFWLRQW\SH!
VHFXULW\LGHQWLW\!
GHVFULSWLRQ! GHVFULSWLRQ! For now, just know th
XVHFDOOHULGHQWLW\! XVHFDOOHULGHQWLW\! bean in an application at
mu
every
VHFXULW\LGHQWLW\! st
element in the DD that have an
VHVVLRQ! the beanÕs structure and describes
type.
HQWHUSULVHEHDQV!
HMEMDU!
\RXDUHKHUH
WKHHMEMDU
EHDQ
LQWHUIDFHV
-$5
;0/''
HMEMDU
HMEMDU
Õt use the JAs;R
GHSOR\
is b oo k, w e w on
3XWWKHEHDQWKHLQWHUIDFHVDQGWKH
(in th
to m ak e t h e ejb-bar ours)elve
tool loytools do it
GHSOR\PHQWGHVFULSWRULQWRDQHMEMDU¿OH weÕll let the dep
!S A BEAN DEVELOPER OFl CIALLY CALLED A "EAN 0ROVIDER YOULL ALWAYS PUT YOUR BEANS IN
A *!2 4HE SPEC SAYS AN EJB
JAR IS A *!2 l LE THAT HOLDS THE THINGS THE BEAN DEPENDS ON
CLASSES AND INTERFACES ALONG WITH THE DEPLOYMENT DESCRIPTOR
9OU DONT HAVE TO DO THIS BY HAND SINCE WELL USE THE 2) 2ATHER THAN WRITING THE 8-, $$
AND USING THE MDU TOOL TO PACKAGE IT WELL USE THE 2) GHSOR\WRRO WIZARD TO MAKE IT
EASIER AND LESS ERROR
PRONE )N OTHER WORDS WERE GOING TO COMBINE STEPS AND INTO
ONE &OR NOW YOU NEED TO KNOW THAT A BEAN ISNT A BEAN UNTIL YOU MAKE A *!2 l LE WITH
THE COMPILED CLASS AND INTERFACES AND THE $$
The ejb-jar Þle must inc
the bean .class Þles (the lude all three of
t descriptor plus the bean implementattwo interfaces
The deploymaenmed Òejb-jar.xmlÓ
P\HMEMDU
the deployment descripto ion class) and
MUST be n be in a directory ejb-jar Þle whatever yo r. Name the
and MUST TA-INFÓ required name for the ejbu like; thereÕs no
named ÒME -jar.
0(7$,1)
any ot he r JAR Þle, the directory
KHDGILUVW
As wi th
the package must be
structure matchinegthe JAR. In other words,
immediately inside have been deÞned in the
since these thre e, the Þles must be inside
ÒheadÞrstÓ packagdirectory.
'2&7<3(
HMEMDU
the ÒheadÞrstÓ
38%,QF
HMEMDU[PO
$GYLFHFODVV
$GYLFH+RPHFODVV
$G L % O
7KHH[DPH[SHFWV\RXWRNQRZZKDWLVVXSSRVHGWREHLQWKHHMEMDU¿OHDQGDOVR
ZKDWLVQRWVXSSRVHGWREHLQWKHUH7KHFODVVHVDQGLQWHUIDFHVJHQHUDWHGE\WKH
:DWFKLW FRQWDLQHU \RX¶OOOHDUQZKDWWKRVHDUHDOLWWOHODWHU PXVWQRWEHLQWKHHMEMDU¿OH7KLQN
RIWKHHMEMDUDVWKHWKLQJ\RXFUHDWHDVDEHDQGHYHORSHU,W¶V\RXUGHOLYHUDEOH7KH
FRQWDLQHUVHUYHUKDVLWVRZQGHOLYHUDEOHVDQGWKRVHGHOLYHUDEOHVGRQ¶WJRLQWRWKHHME
MDU,PDJLQHWKDW\RXZRUNIRU%HDQV58VDQG\RXGRQ¶WHYHQKDYHDQ(-%FDSDEOH
VHUYHU7KDW¶VWKHZKROHLGHDRIWKHHMEMDU LW¶VZKHUHWKHEHDQGHYHORSHUSXWVKLV
EXLOGLQJEORFNFRPSRQHQWV LHEHDQV WKDWVRPHRWKHUGHYHORSHUFDQXVHWRDVVHPEOH
DQDSSOLFDWLRQ<RXPLJKWXVHDVHUYHUWRROWRKHOSFUHDWHWKH;0/''EXWWKH''LVVWLOO
\RXUGHOLYHUDEOHUHJDUGOHVVRIZKR RUZKDW FUHDWHVLW
&KDSWHU
LQWURWR(-%
EHDQ
LQWHUIDFHV
;0/''
HMEMDU
GHSOR\
'HSOR\WKHEHDQLQWRWKHVHUYHUXVLQJWKH
WRROVSURYLGHGE\WKHVHUYHUYHQGRU
3OONER OR LATER YOUR BEANS HAVE TO DO SOMETHING 4HEY HAVE TO BE ASSEMBLED
INTO AN APPLICATION AND DEPLOYED INTO A SERVER WAITING FOR CLIENTS TO CALL
4HIS IS A HUGE STEP )N FACT WE CHEATED A LITTLE BECAUSE ITS ACTUALLY TWO STEPS
!PPLICATION !SSEMBLY AND $EPLOYMENT
5!PPLICATION !SSEMBLY
4HIS MEANS TAKING THE BEAN FROM THE REUSABLE COMPONENT STAGE TO BEING PART OF
AN APPLICATION &OR SIMPLE BEANS THAT MIGHT MEAN SIMPLY WRITING A CLIENT THAT
CAN ACCESS THE BEAN IE CALL THE BEANS BUSINESS METHODS )N OTHER WORDS A
SINGLE BEAN MIGHT BE THE ENTIRE APPLICATION ON THE SERVER SIDE "UT THIS COULD
ALSO BE THE STEP WHERE YOU INTEGRATE MULTIPLE BEANS AND OTHER *AVA CLASSES
INTO A CUSTOM APPLICATION AND THAT USUALLY MEANS TAKING DIFFERENT BEANS EACH
IN ITS OWN EJB
JAR WITH ITS OWN $$ AND PUTTING THEM INTO A NEW SINGLE EJB
JAR
WITH A SINGLE $$ THAT MIGHT DESCRIBE HOW TWO OR MORE BEANS ARE RELATED TO ONE
ANOTHER
$URING ASSEMBLY YOU MIGHT ALSO ADD NEW INFORMATION TO THE $$ FOR THINGS THE
BEAN DEVELOPER DIDNT KNOW ABOUT &OR EXAMPLE THE BEAN DEVELOPER MIGHT
WRITE CODE THAT USES A SPECIAL BEAN
SPECIlC hPROPERTYv CALLED AN ENVIRONMENT
ENTRY WHICH WELL GET INTO IN A LATER CHAPTER FOR THE TAX AMOUNT USED BY THIS
APPLICATION "UT THE BEAN DEVELOPER HAS NO IDEA WHAT VALUE TO GIVE THE TAX
AMOUNT PROPERTY SO HE LEAVES THE VALUE BLANK IN THE $$ 4HEN THE APPLICATION
ASSEMBLER COMES ALONG SEES BY READING THE $$ THAT THE BEAN USES A PROPERTY
lGURES OUT WHAT THE VALUE SHOULD BE AND ADDS IT TO THE $$
&OR THE !DVICE BEAN PUTTING THE BEAN IN THE EJB
JAR BUILDING THE $$ AND
DEPLOYING WILL HAPPEN AS ONE BIG STEP
5$EPLOYMENT
4HIS IS WHERE THE RUBBER MEETS THE ROAD THE BEAN MEETS THE SERVER THE
DEVELOPER MEETS THE SYS ADMIN 4HE TWO CRUCIAL PARTS OF DEPLOYMENT ARE NAMING
THE BEAN SO THE CLIENT WILL KNOW HOW TO lND IT AND GETTING THE BEAN INTO THE
CONTAINERS CONTROL
4HE SPEC DOESNT SAY ANYTHING ABOUT THE WAY IN WHICH YOU DEPLOY YOUR BEANS IT
ALL DEPENDS ON THE %*" SERVERCONTAINER THAT YOURE USING
\RXDUHKHUH
(-%UROHV
-2*:WTM[IVL:M[XWV[QJQTQ\QM[
,ZRUNIRU%HDQV
58VDQG,GHYHORS
UHXVDEOHFRPSRQHQWV
WKDWZHVHOOWRRWKHU
GHYHORSHUV
(-%5ROH %HDQ3URYLGHU
Bill 'HOLYHUDEOH HMEMDU¿OHV WKDW
LQFOXGHRQHRUPRUHEHDQVDQGDQ;0/
GHSOR\PHQWGHVFULSWRU
3ULPDU\UHVSRQVLELOLW\ 'HVLJQDQG ,·PDGHYHORSHUIRUD
ELJRQOLQHERRNVWRUH
SURJUDPHQWHUSULVHMDYDEHDQV,QRWKHU :HEX\DORWRIEHDQVIURP
ZRUGVZULWHWKHEHDQFRGH %HDQV58VEXW,DOVRPDNHP\
RZQEHDQV,PL[WKHPWRJHWKHU
&KDUDFWHULVWLFV .QRZVWKHEXVLQHVV LQWRQHZDSSOLFDWLRQVFXVWRPL]HG
ORJLFWKDWVKRXOGEHLQDSDUWLFXODUW\SHRI IRUWKHEXVLQHVVUXOHVRIKRZ
FRPSRQHQWIRUDSDUWLFXODUGRPDLQ ZHVHOOERRNV
Annie
(-%5ROH
$SSOLFDWLRQ$VVHPEOHU
7KHH[DP
FRYHUVVXEWOH
:DWFKLW GLIIHUHQFHV 'HOLYHUDEOH HMEMDU¿OHV WKDWLQFOXGH
EHWZHHQUROHV RQHRUPRUHEHDQVDQGDQ;0/
DQ\
3D\YHU\FORVHDWWHQWLRQWR GHSOR\PHQWGHVFULSWRUZLWK%HDQ
QWLRQR I(- %U ROH VLQ WKL V 3URYLGHULQIRDVZHOODVDSSOLFDWLRQ
PH
FRYHU
ERRNHVSHFLDOO\ZKHQZH DVVHPEO\LQIR 0D\DOVRFUHDWHFOLHQWV
LOVR IWKHG HSO R\P HQW
PRUHGHWD
LQJ WHV WHG RUGH¿QHLQWHUDFWLRQEHWZHHQRWKHU
GHVFULSWRU&RXQWRQEH
DWDQG FR XQW
RQZKRGRHVZK FRPSRQHQWV VXFKDV-63V
VXEWOH
RQWKRVHTXHVWLRQVEHLQJ
%H DQ 3ULPDU\UHVSRQVLELOLW\ &RPELQH
7KH$SS$VVHPEOHUDQG
LQVHY HUD ODU HDV
3URYLGHURYHUODS RQHRUPRUHHQWHUSULVHEHDQVLQWRD
VWK H' HSO R\H UDQ GWK H
DVGRH ODUJHUDSSOLFDWLRQ0D\VRPHWLPHVZHDUWKH%HDQ
P
$SS$VVHPEOHU)RUWKHH[D 3URYLGHUKDWPL[LQJQHZDQGH[LVWLQJEHDQV
QRZ ZK LFK URO HK DV
\RXQHHGWRN
U\U HVS RQV LELOLW\I RUD WRJHWKHUWREXLOGDQDSS'H¿QHVWKHVHFXULW\DQG
WKHSU LPD
OO\K DYL QJ WR
SDUWLFXODUWDVN XVXD WUDQVDFWLRQEHKDYLRUIRUWKHDSSOLFDWLRQ
VFULSWRU
GRZLWKWKHGHSOR\PHQWGH
UPD WLRQ 7K HV WXII RQ WKL VSDJH &KDUDFWHULVWLFV 'H¿QLWHO\DGRPDLQH[SHUW
LQIR
DV WDUW
DQGWKHQH[WDUHMXVW 0LJKWQRWGRDVPXFKFRGLQJDVWKH%HDQ3URYLGHU
&KDSWHU
LQWURWR(-%
(-%5ROH 'HSOR\HU
'HOLYHUDEOH (QWHUSULVHEHDQVWKDWKDYHEHHQ
:RZ,WDFWXDOO\GHSOR\HG FXVWRPL]HGIRUDVSHFL¿FRSHUDWLRQDOHQYLURQPHQWDQG
8QEHOLHYDEOH,ZRUNIRU GHSOR\HGLQWRWKHVHUYHU
WKHVDPHRQOLQHERRNVWRUHDVWKHDSS
DVVHPEOHUDQG,WDNHKHUHMEMDUVWXG\ 3ULPDU\UHVSRQVLELOLW\ 7DNHWKH$SSOLFDWLRQ
WKHGHSOR\PHQWGHVFULSWRUDQGJHWWKHWKLQJ $VVHPEOHU¶VGHOLYHUDEOHVWXG\WKHGHSOR\PHQWGHVFULSWRU
DFWXDOO\UXQQLQJLQWRWKHVHUYHUDQGZDLWLQJ DQGUHVROYHDQ\H[WHUQDOGHSHQGHQFLHV)RUH[DPSOH
IRUFOLHQWV,NQRZD/27DERXWWKHZD\RXU
V\VWHPVDUHFRQÀJXUHGDQGUXQQLQJKHUH LIWKHEHDQUHOLHVRQDSDUWLFXODUUHVRXUFHWKHGHSOR\HU
PXVWPDSWKHORJLFDOQDPHIURPWKH%HDQ3URYLGHUWRWKH
DFWXDOQDPHRIWKHUHVRXUFHRQWKHVHUYHU5HPHPEHU
Dick
ZKHQ%LOOZURWHWKHEHDQFRGHKHGLGQ¶WNQRZLWZRXOG
HQGXSRQ'LFN¶VVHUYHU%LOOKDGWRPDNHXSDµIDNH¶QDPH
IRUWKHGDWDEDVHDQG'LFNKDVWRELQGWKHIDNHQDPHWR
VRPHWKLQJUHDO
&KDUDFWHULVWLFV $QH[SHUWLQDVSHFL¿FRSHUDWLRQDO
GRPDLQ.QRZVWKHVHFXULW\XVHUVDQGUROHVIRUWKLV
V\VWHPNQRZVZKDW¶VFRQ¿JXUHGLQWRWKHVHUYHUDQG
XQGHUVWDQGVKRZWRLQWHUSUHWWKHGHSOR\PHQWGHVFULSWRU
LQIRIURPWKH%HDQ3URYLGHUDQG$SS$VVHPEOHU
:HGRWKH
ELJVHUYLFHVVR\RXJHW
WRIRFXVRQ\RXUEXVLQHVVORJLF
:HZRUNIRUWKH :HFRPSHWHZLWK,%0%($
6XSHU6HUYHUFRPSDQ\ DQG2UDFOHDQGVRPHGD\ZH·OO
:H·UHH[SHUWVLQORZOHYHO NLFN/DUU\(OOLVRQ·VEXWW
VHUYLFHVOLNHWUDQVDFWLRQ
PDQDJHPHQWSRROLQJDQG
VHFXULW\ Sue
(-%5ROH &RQWDLQHUDQG6HUYHU3URYLGHU
'HOLYHUDEOH (-%FRPSOLDQWVHUYHUGHSOR\PHQW
WRROVUXQWLPHHQYLURQPHQWIRUHQWHUSULVHEHDQV
3ULPDU\UHVSRQVLELOLW\ ,PSOHPHQWLQJWKHVSHF
&KDUDFWHULVWLFV ([SHUWVLQGLVWULEXWHGREMHFWVDQG
WUDQVDFWLRQVDQGRWKHUORZOHYHOV\VWHPVHUYLFHV Carl
\RXDUHKHUH
$GYLFH%HDQWXWRULDO
<]\WZQIT"
/HW·VPDNHGHSOR\DQGWHVWWKH$GYLFH%HDQ
7ELL WRITE THE CODE COMPILE IT START THE SERVER START THE
DEPLOYTOOL USE THE DEPLOYTOOL TO MAKE THE $$ AND THE Remember, the exam is for
EJB
JAR DEPLOY THE BEAN CREATE A CLIENT AND TEST THE BEAN 1.3, NOT 1.4! Whatever you J2EE
USING THE CLIENT 4HE ONLY THING WE WONT DO IS INSTALL AND NOT study for the exam usi do, do
CONlGURE THE SERVER 7E ASSUME YOU ALREADY DID THAT 1.4 spec. See the intro for mong the
)F YOU DONT YET HAVE THE *%% 2) UP AND RUNNING GO details about why the exam re
TO HTTPJAVASUNCOMJEE AND DOWNLOAD VERSION and not 1.4Ñthe short versiouses 1.3
OF *%% IT INCLUDES SET
UP INSTRUCTIONS THEN GO BACK AND we donÕt want to certify fol n is:
DOWNLOAD THE *%% !0) DOCUMENTATION something that almost nobod ks on
CertiÞcation is NOT about ÒIy is using.
the latest and greatest releas know
:K\DUHZHXVLQJ about ÒI know the technology eÓ. ItÕs
WKH5, ":K\FDQ·WZHXVH people are using now. IÕve been that
D5($/DSSVHUYHU" for at least six months.Ó using it
RWKLQJ
:KLFKVHUYHUZRXOGZHXVH":HXVHWKH 7KHUH¶VQ P
[D
5,IRUOHDUQLQJDQGSUDFWLFLQJEHFDXVH RQWKHH ((5,
ZHGRQ¶WNQRZZKLFKVHUYHU\RX¶OOQHHG XWWKH-
DER U
WRXVHDQGWKH5,LVWKHVLPSOHVWRIDOO RQVHUYH
\R WK H UDSSOLFDWL XWDQ\
WKHIUHHO\DYDLODEOHVHUYHUV:HZDQW 2UDQ NQRZDE
R
¶WKDYHWR LQJ6XQ¶V IRU
LWWREHDVHDV\DVSRVVLEOHIRU\RXWR <RXGRQ G
ROV LQFOX W<RX
IRFXVRQ(-%WHFKQRORJ\DQGLJQRUHWKH YHQGRUWR WRUGHSOR\PHQ
S P H Q DELOLWLHV
WRROVSHFL¿FWDVNV GHYHOR Q R ZZ KDWFDS
GRQHHG
WRN HUZLOO
S OLDQWVHUY
% F R P NQRZ
2SHQVRXUFHSURGXFWVOLNH-%RVVDUH HYHU\(- RXGRQ¶WQHHGWR
\ U
KDYH E X W HDWX VR
UH
VWLOOUHDOSURGXFWLRQVHUYHUVVRWKH\WHQG H Q G R UVSHFL¿FI
DQ\Y LOV
WRKDYHDORWPRUHFRQ¿JXUDWLRQDQG WLRQGHWD
FRQ¿JXUD
DGPLQLVWUDWLRQWDVNVWRFRSHZLWK8VLQJ
WKH5,OHWV\RXVSHQGPRUHWLPHGRLQJ
WKHWKLQJV\RX¶OOKDYHWRGRUHJDUGOHVV
RIWKHVHUYHUZLWKWKHOHDVWDPRXQWRI
WLPHVSHQWOHDUQLQJDVHUYHUVSHFL¿F
DSSURDFKWRWKRVHWKLQJV
&KDSWHU
LQWURWR(-%
7ZOIVQbMaW]ZXZWRMK\LQZMK\WZa
!LL THE BEANS IN THIS BOOK ARE ORGANIZED INTO PACKAGES WHICH MEANS YOU
MUST BE A LITTLE MORE CAREFUL ABOUT COMPILING AND RUNNING %VERY INSTRUCTION
IN THIS CHAPTER ASSUMES YOUVE ORGANIZED YOUR PROJECT EXACTLY THE WAY ITS
SHOWN HERE )F YOU DEVIATE FROM THIS STRUCTURE YOURE ON YOUR OWN FOR
MAPPING OUR COMMAND
LINE AND DEPLOYMENT FORMULAS TO YOUR OWN STRUCTURE
7KHUH·VRQO\21(SURMHFWV
SURMHFWV GLUHFWRU\IRUWKHZKROH
ERRN
(DFKSURMHFWLQWKHERRNKDVLWV
SURMHFWRUJDQL]DWLRQ
RZQGLUHFWRU\7KLVGLUHFWRU\LV
VKRSSLQJ DGYLFH IRUWKHDGYLFHSURMHFW
(DFKSURMHFWKDVD
VUFGLUHFWRU\ IRUMDYD
VRXUFH¿OHV DQGD
FODVVHV VUF FODVVHV VUF FODVVHVGLUHFWRU\ IRU
FODVVE\WHFRGH¿OHV
7KLVLVZKHUHWKHSDFNDJH
SDFNDJH
GLUHFWRU\VWUXFWXUHEHJLQV
KHDGILUVW KHDGILUVW KHDGILUVW KHDGILUVW 0RVWSURMHFWFODVVHVDUH
LQWKH³KHDG¿UVW´SDFNDJH
ZKLFKPHDQVWKHFODVVHV
PXVWEHLQDGLUHFWRU\
QDPHGKHDG¿UVW
MDYD[HME
MDYD[HME
LPSRUWMDYD LPSRUWMDYD
UPL5HPRWH([ UPL5HPRWH([
FHSWLRQ FHSWLRQ
MDYDILOHV MDYDILOHV
FODVVILOHV FODVVILOHV
7ZOIVQbQVOaW]Z\MZUQVITKWUUIVLTQVM
)LOH(GLW:LQGRZ+HOS$FFHVVRUL]H
FGaSURMHFWVDGYLFHVUF FRPSLOHIURPWKHVUFGLUHFWRU\
FGaSURMHFWVDGYLFH UXQFOLHQWVIURPWKHVSHFL¿F
SURMHFWGLUHFWRU\
\RXDUHKHUH
FRPSLOLQJWKHLQWHUIDFHVDQGEHDQFODVV
+ WUXQTM\PM\ _WQV\MZNIKM[
IVL\PMJMIVKTI[[ 5LJKWQRZWKLVLVKRZ
\RXUSURMHFWVGLUHFWRU\
3O FAR WEVE WRITTEN THE TWO INTERFACES AND THE VWUXFWXUHVKRXOGORRN
BEAN CLASS BUT WE STILL HAVE TO COMPILE THEM
!FTER THAT WELL MAKE THE EJB
JAR WHICH HOLDS
CLASS l LES NOT SOURCE l LES SURMHFWV
)LOH(GLW:LQGRZ+HOS:K\$P,+HUH
FGaSURMHFWVDGYLFHVUF
DGYLFH
MDYDFGFODVVHVKHDG¿UVW
MDYD
7ERE USING THE G COMPILER m AG SO THE COMMAND FODVVHV VUF
LINE ABOVE SAYS h#OMPILE ALL THE JAVA l LES IN THE
@HEADl RST DIRECTORY AND THEN PUT THE COMPILED
CLASS l LES INTO THE @CLASSES DIRECTORY WHICH YOULL
l ND BY GOING UP ONE LEVEL FROM THE CURRENT SRC
DIRECTORY /H YEAH ALMOST FORGOT BE SURE TO PUT KHDGILUVW KHDGILUVW
THE CLASSES IN THEIR CORRECT 0!#+!'% DIRECTORY
,OOK FOR THE PACKAGE STRUCTURE INSIDE THE @CLASSES
DIRECTORY WHICH MEANS YOU SHOULD SEE A DIRECTORY When we
NAMED @HEADl RST AND 4(!4S WHERE THE CLASS the .class compile, weÕll make
MDYD[HME LPSRUW
LPSRUWMDYD MDYD[HME
in the clas Þles land here,
UPL5HPRWH([ LPSRUWMDYD
l LES NEED TO GOAND IF YOU DO ./4 l ND THE FHSWLRQ UPL5HPRWH([
FHSWLRQ
directory. ses/headÞrst
@HEADl RST DIRECTORY THERE THEN MAKE ONE FOR ME $GYLFH%HDQMDYD $GYLFHMDYD
4HANKSv
MDYD[HME
LPSRUWMDYD
UPL5HPRWH([
FHSWLRQ
$GYLFH+RPHMDYD
va Þles
All three .jathe src/
must be in directory.
headÞrst
&KDSWHU
LQWURWR(-%
;\IZ\\PM[MZ ^MZ
/PEN UP A NEW TERMINAL FOR THE SERVER 9OULL LEAVE IT RUNNING AND WE
WANT TO SEE THE OUTPUT AS IT RUNS SO DONT USE THIS TERMINAL FOR ANYTHING
ELSE -AKE THE ADVICE DIRECTORY YOUR WORKING DIRECTORY
)LOH(GLW:LQGRZ+HOS%ODK%ODK%ODK
FGSURMHFWVDGYLFH
MHHYHUERVH
AW]¼TT[MM[WUM\PQVOTQSM\PQ[
4HE
VERBOSE mAG WHICH ISNT REQUIRED BUT WE LIKE
IT PRINTS OUT A BUNCH OF STUFF IN THE TERMINAL
)LOH(GLW:LQGRZ+HOS:KDW7KH"
MHHYHUERVH
-((VHUYHUOLVWHQSRUW
1DPLQJVHUYLFHVWDUWHG
%LQGLQJ'DWD6RXUFHQDPH MGEF'%XUO MGEF FORXGVFDSH UPL &ORXGVFDSH'% FUHDWH WUXH
%LQGLQJ'DWD6RXUFHQDPH MGEF,QYHQWRU\'%XUO MGEF FORXGVFDSH UPL
&ORXGVFDSH'% FUHDWH WUXH
%LQGLQJ'DWD6RXUFHQDPH MGEF'%XUO MGEF FORXGVFDSH UPL &ORXGVFDSH'% FUHDWH WUXH
%LQGLQJ'DWD6RXUFHQDPH MGEF(VWRUH'%XUO MGEF FORXGVFDSH UPL
&ORXGVFDSH'% FUHDWH WUXH
%LQGLQJ'DWD6RXUFHQDPH MGEF&ORXGVFDSHXUO MGEF FORXGVFDSH UPL
&ORXGVFDSH'% FUHDWH WUXH
%LQGLQJ'DWD6RXUFHQDPH MGEF;$&ORXGVFDSHXUO MGEF;$&ORXGVFDSHBB[D
%LQGLQJ'DWD6RXUFHQDPH MGEF;$&ORXGVFDSHBB[DGDWD6RXUFH &20FORXGVFDSHFRUH5HPRWH;
D'DWD6RXUFH#F
6WDUWLQJ-06VHUYLFH,QLWLDOL]DWLRQFRPSOHWHZDLWLQJIRUFOLHQWUHTXHVWV%LQGLQJ
-06'HVWLQDWLRQ MPV7RSLFMDYD[MPV7RSLF!%LQGLQJ -06'HVWLQDWLRQ MPV4XHXH
MDYD[MPV4XHXH!%LQGLQJ -06&Q[)DFWRU\ 4XHXH&RQQHFWLRQ)DFWRU\4XHXH1RSURS
HUWLHV!%LQGLQJ -06&Q[)DFWRU\ MPV7RSLF&RQQHFWLRQ)DFWRU\7RSLF1RSURSHUWLHV
!%LQGLQJ -06&Q[)DFWRU\ MPV4XHXH&RQQHFWLRQ)DFWRU\4XHXH1RSURSHUWLHV!%LQGLQJ
-06&Q[)DFWRU\ 7RSLF&RQQHFWLRQ)DFWRU\7RSLF1RSURSHUWLHV!
6WDUWLQJZHEVHUYLFHDWSRUW
6WDUWLQJVHFXUHZHEVHUYLFHDWSRUW
-((6'.
6WDUWLQJZHEVHUYLFHDWSRUW
-((6'.
-((VHUYHUVWDUWXSFRPSOHWH
\RXDUHKHUH
VWDUWLQJGHSOR\WRRO
;\IZ\LMXTWa\WWT
/PEN UP A NEW TERMINAL FOR THE DEPLOYTOOL 4HIS TOOL IS
PART OF THE *%% 2) AND IT HAS EVERYTHING YOU NEED TO
CREATE THE EJB
JAR THE $$ AND TO DO THE lNAL DEPLOYMENT
INTO THE 2) SERVER
)LOH(GLW:LQGRZ+HOS&KLOO
GHSOR\WRRO
6WDUWLQJ'HSOR\PHQWWRROYHUVLRQ
7\SHµGHSOR\WRROKHOS¶IRUFRPPDQGOLQH
RSWLRQV
aW]¼TT[MM[WUM\PQVOTQSM\PQ[
! LOVELY SPLASH SCREEN POPS UP AND SITS WHILE THE
APPLICATION LOADS )F YOU CLICK THE SPLASH SCREEN IT
DISAPPEARS SO DONT PANIC IF IT THEN LOOKS LIKE NOTHINGS
HAPPENING 0ATIENCE
&KDSWHU
LQWURWR(-%
5ISMIVM_)XXTQKI\QWV WKHUH DUH QR
'XPE 4XHVWLRQV
4HE 2) IS A *%% SERVER REMEMBER NOT JUST AN %*" CONTAINER
3O WE HAVE TO DO A SMALL BIT OF *%%ISH STUFF BEFORE WE CAN
Q: $OES THIS MEAN THAT )
MAKE THE EJB JAR AND DEPLOY THE APP 4HIS STEP IS WHERE -534 HAVE A *%% SERVER IF )
WANT TO USE SERVLETS AND %*"S
WE CREATE A NEW *%% APPLICATION AND FOR NOW YOU CAN
TOGETHER
THINK OF THE *%% APPLICATION AS SOMETHING THAT WRAPS THE
BEANS AND ADDS A LITTLE MORE INFORMATION FOR THE SERVER
4HE MAIN DIFFERENCE BETWEEN A *%% APPLICATION AND AN
%*" APPLICATION IS THAT A *%% APPLICATION CAN INCLUDE WEB
A: .O 7ITH A *%% SERVER
THE WEB COMPONENTS AND %*"
COMPONENTS SERVLETS AND *30S AS WELL AS %*" COMPONENTS COMPONENTS ARE MORE TIGHTLY
ALL INTEGRATED AS PART OF A SINGLE APP INTEGRATED WHICH MEANS YOU
CAN HAVE ALL OF THE COMPONENTS
&KRRVH)LOH 1HZ$SSOLFDWLRQ RESPECT ONE ANOTHERS TRANSAC
TIONS AND SECURITY "UT YOURE
ALWAYS FREE TO USE A SERVLET AS
A CLIENT TO AN ENTERPRISE BEAN
EVEN IF THAT BEAN ISNT RUNNING
IN THE SAME APPLICATION SERVER
OR EVEN THE SAME PHYSICAL
MACHINE !NOTHER ADVANTAGE
OF A *%% SERVER IS THE EASE WITH
WHICH YOU CAN DEPLOY BOTH
COMPONENT TYPES AS PART OF ONE
ENTERPRISE APPLICATION
(AVING SAID ALL THIS CHANCES ARE
EXTREMELY HIGH THAT IF YOURE DO
ING %*" APPLICATIONS YOU ARE
RUNNING THEM IN A *%% SERVER
2EMEMBER THERE ARE VERY FEW
STANDALONE %*" CONTAINERS
TODAY 6IRTUALLY ALL SIGNIFICANT
VENDORS RUN THEIR %*" CONTAINERS
WITHIN A *%% SERVER
$-((VHUYHUYHQGRUPXVWSDVVD
PDVVLYHSLOHRIFRPSDWLELOLW\WHVWV
EHIRUHWKHVHUYHUFDQEHFDOOHG
´-((FRPSOLDQWµ$-((VHUYHU
IRUH[DPSOHPXVWLQFOXGHDQ(-%
FRQWDLQHUDQGWKDWFRQWDLQHUPXVW
LPSOHPHQWWKH(-%VSHFLILFDWLRQ
\RXDUHKHUH
GHSOR\WRRO PDNLQJDQHZDSSOLFDWLRQ
6IUMIVL[I^M\PMVM_IXXTQKI\QWV
4HIS PARTS A LITTLE AWKWARD 9OU CAN USE THE "ROWSE BUTTON TO NAVIGATE
THROUGH YOUR OWN DIRECTORY TREE BUT THE EASIEST WAY TO NAME AND
SAVE THE APPLICATION IS TO TYPE THE COMPLETE PATH TO THE lLE YOURE
ABOUT TO CREATE 4HE THING WERE MAKING IS NOT THE BEAN ITSELFYOU
CAN THINK OF IT MORE LIKE A DOCUMENT THAT HOLDS ALL THE INFORMATION
ABOUT THE APPLICATION !S A CONVENTION WE SAVE THE APPLICATION IN
THE PROJECTS;WHATEVER= DIRECTORYTHE DIRECTORY CORRESPONDING TO
THAT PARTICULAR PROJECT &OR THE !DVICE BEAN THAT MEANS THE PROJECTS
ADVICE DIRECTORY )F YOU STARTED THE SERVER FROM THE PROJECTSADVICE
DIRECTORY IN OTHER WORDS IF ADVICE IS YOUR CURRENT WORKING DIRECTORY
THEN YOULL GET THE RIGHT NAME AND LOCATION BY DEFAULT
1DPHWKHDSSOLFDWLRQ$GYLFH$SS
,IQHHGHGLQFOXGHWKHIXOOSDWKWRSURMHFWVDGYLFH$GYLFH$SS
&OLFN2.
DonÕt w
Applicatioorry about the
the tool wn Display Name Þe
in with th ill automatically Þ ld;
Applicatio e Þle name from t ll it
n File Nam
e Þeld. he
&KDSWHU
LQWURWR(-%
?PI\aW]¼TT[MMIN\MZaW]KZMI\MIVLVIUM
\PMIXXTQKI\QWV
.OW YOURE BACK AT THE MAIN SCREEN OF THE DEPLOYTOOL 9OU MIGHT
HAVE TO CLICK ON THE &ILES OR !PPLICATIONS ICONS TO EXPAND THEM BUT
YOULL SEE THAT THE TOOL HAS CREATED AN !PPLICATIONS DIRECTORY WITH
SOMETHING CALLED !DVICE!PP INSIDE #LICK ON THE !DVICE!PP ICON
AND YOULL SEE INFORMATION ABOUT THE APPLICATION INCLUDING THE
NAME LOCATION AND CURRENT CONTENTS !T THIS POINT THERES NOTHING
BUT A -%4!
).& DIRECTORY THAT HOLDS MORE INFO ABOUT THE APP
WHICH WE WONT EVER NEED TO LOOK AT
&OLFNRQWKH$GYLFH$SSLFRQ
\RXDUHKHUH
GHSOR\WRRO PDNLQJDQHZHQWHUSULVHEHDQ
6W_TM\¼[UISM\PMVM_MV\MZXZQ[M
JMIV\PMMRJRIZIVL\PM,,
4HIS IS WHAT WERE REALLY AFTERTHE ACTUAL BEAN 4HE PREVIOUS
STEPS MAKING THE *%% APPLICATION WERE TO SATISFY THE *%% 2)
BECAUSE WE HAVE TO DEPLOY THE BEAN WITHIN A *%% APP
&KRRVH)LOH1HZ(QWHUSULVH%HDQ
&KDSWHU
LQWURWR(-%
6W__M¼ZMQV\PMZMITTaKWWT
6M_-V\MZXZQ[M*MIV?QbIZL
4HIS PART OF THE DEPLOYTOOL IS WHERE ALMOST EVERYTHING HAPPENS
4HE KEY THINGS WELL DO ARE
5 #REATE THE EJB
JAR
5 0UT THE BEAN CLASS AND THE TWO INTERFACES INTO THE EJB
JAR
5 #REATE THE DEPLOYMENT DESCRIPTOR THAT DESCRIBES THE BEAN
&OLFN1H[W!
\RXDUHKHUH
GHSOR\WRRO FUHDWHDQHZHMEMDU
+ZMI\M\PMVM_MRJRIZ
&OR NOW JUST ACCEPT THE DEFAULTS 4HE RADIO BUTTON ON THE TOP LEFT OF
THE SCREEN SHOWS THAT YOURE MAKING A NEW *!2 WITHIN THE !DVICE!PP
APPLICATION .OTICE THAT THE !DVICE!PP IS PART OF A DROP
DOWN LISTIF
THERE WERE OTHER EJB
JARS ALREADY IN THE APPLICATION WE COULD HAVE
CHOSEN TO PUT THE NEW BEAN IN A PRE
EXISTING *!2
4HE TOOL PICKS AN ESPECIALLY HELPFUL DISPLAY NAME h%JBv AND YOULL SEE
THIS BACK ON THE MAIN DEPLOYTOOL SCREEN WHEN WERE DONE 4HAT NAME
ISNT USED ANYWHERE IN YOUR REAL APPLICATION SO ITS NO BIG DEAL BUT IF
YOU HAVE MORE THAN ONE *!2 IN AN APPLICATION YOU MIGHT WANT TO GIVE IT
A MORE DESCRIPTIVE NAME #ART *!2 !CCOUNT *!2 ETC
&OLFN(GLW
&KDSWHU
LQWURWR(-%
)LL\PM\PZMMKTI[[NQTM[QVKT]LQVO\PMQZ
XIKSIOMLQZMK\WZa\W\PM2):
4HIS IS THE MOST IMPORTANT PART OF THE WHOLE PROCESS )N OTHER WORDS DONT
SCREW IT UP 4HE KEY IS TO GET THE CORRECT CLASSES INTO THE *!2 IN THEIR PACKAGE
DIRECTORY STRUCTURE AND ONLY THEIR PACKAGE DIRECTORY STRUCTURE )N OTHER WORDS
IF YOU PUT THE THREE CLASS lLES INTO THE *!2 WITHOUT THE HEADlRST DIRECTORY
YOUR BEAN WONT DEPLOY /R IF YOU INCLUDE THE CLASSES DIRECTORY AS WELL AS THE
HEADlRST DIRECTORY YOUR BEANS WONT DEPLOY 2EMEMBER THE EJB
JAR IS STILL A
*!2 lLE SO THE USUAL *!2 RULES ABOUT PACKAGE STRUCTURES APPLY HERE
1DYLJDWHWRWKH$GYLFHGLUHFWRU\
([SDQGWKHFODVVHVGLUHFWRU\WRVHHWKHKHDGÀUVWGLUHFWRU\
6HOHFWWKHKHDGÀUVWGLUHFWRU\
&OLFN$GG
Use the navigation
controls here to get to
your Advice directory
where you can see your,
classes and src direc rie
Then select the headto
Þr
s.
directory. You donÕt st
to expand it... we didhave
it so that you could see
whatÕs in there.
\RXDUHKHUH
GHSOR\WRRO FRQ¿UP-$5FRQWHQWV
+WVNQZU\PI\aW]ILLML764A\PM
XIKSIOMLQZMK\WZaIVL\PMKTI[[NQTM[
9OU GOTTA GET THIS PART RIGHT ,OOK AT THE BOTTOM WINDOW THAT SAYS h#ONTENTS OF
%JBv AND VERIFY THAT THE ONLY THING IN THE *!2 BESIDES THE -%4!
).& DIRECTORY
IS THE HEADlRST DIRECTORY INCLUDING THE CONTENTS OF THE DIRECTORY 4HE CLASSIC
MISTAKE WE SEE ALL THE TIME NOT THAT YOUD EVER DO THAT IS TO ADD ONLY THE CLASS lLES
BUT NOT THE PACKAGE DIRECTORY "E SURE THAT YOU HAVE THE HEADlRST DIRECTORY AND
NOT THE CLASSES DIRECTORY WITH THE THREE CLASS lLES !NOTHER COMMON MISTAKE IS TO
ADD THE SOURCE lLES INSTEAD OF THE CLASS lLES 3O DONT FEEL BAD IF IT HAPPENS TO YOU
9HULI\WKDW\RXKDYHWKHULJKWFODVVHV DQGSDFNDJHGLUHFWRU\
,I\RXGRQ¶WVHOHFWWKHPIURPWKHERWWRPZLQGRZFOLFN5HPRYHDQGVWDUWRYHU
&OLFN2.ZKHQ\RX¶UHGRQHWKHQFOLFN1(;7
&KDSWHU
LQWURWR(-%
5ISMQ\I;\I\MTM[[;M[[QWVJMIV
.OW WERE AT THE PLACE WHERE WE GIVE THE TOOL THE BEANS @STRUCTURAL INFORMATION 7HAT KIND OF
BEAN IT IS WHICH CLASS lLE IS THE HOME INTERFACE AND SO ON 2EMEMBER THE TOOL USES THIS TO CREATE
THE DEPLOYMENT DESCRIPTOR !ND THE %*" CONTAINER USES THE DEPLOYMENT DESCRIPTOR TO lGURE OUT
HOW TO DEPLOY AND MANAGE THE BEAN
4HE !DVICE BEAN IS SIMPLECLIENT CALLS A METHOD ON THE REMOTE OBJECT THE REMOTE OBJECT RETURNS
A VALUE THEN THE REMOTE OBJECT FORGETS THE WHOLE THING EVER HAPPENED %ND OF STORY 4HAT SCENARIO
IS JUST PERFECT FOR A STATELESS SESSION BEAN SOLUTION )F THE !DVICE BEAN NEEDED TO REMEMBER THE ADVICE
IT GAVE TO THE CLIENT AND USE IT IN SOME WAY IN FUTURE INVOCATIONS FROM THAT SAME CLIENT THEN WED
MAKE IT STATEFUL "UT WE DONT SO WE WONT
!ND AS YOULL LEARN LATER IT WOULDNT MAKE SENSE TO HAVE THE !DVICE BEAN BE AN ENTITY OR MESSAGE
DRIVEN BEAN "UT ITS TOO LATE TO MAKE IT ANYTHING BUT A SESSION BEAN ANYWAYYOUR BEAN CLASS
IMPLEMENTS THE 3ESSION"EAN INTERFACE 3O YOURE ALREADY COMMITTED TO A BEAN TYPE "UT WHETHER
THE SESSION BEAN IS STATELESS OR STATEFUL CAN BE A LITTLE MORE SUBTLE &OR NOW JUST MAKE IT STATELESS
6HOHFWWKH6HVVLRQUDGLREXWWRQ
6HOHFWWKH6WDWHOHVVUDGLREXWWRQ
DonÕt click the Next
button!! We have way
more to do on this screen
.
\RXDUHKHUH
GHSOR\WRRO UHODWLQJWKHEHDQ¶VFODVV¿OHV
<MTTQ\_PQKPWN\PM\PZMMKTI[[NQTM[QV\PM2):
Q[\PMIK\]IT*-)6KTI[[
9OU HAVE THREE CLASS lLES IN THE *!2 THE HOME INTERFACE !DVICE(OME THE
COMPONENT INTERFACE !DVICE AND THE BEAN !DVICE"EAN "UT THE %*"
CONTAINER NEEDS TO KNOW WHICH IS WHICH 2EMEMBER THE NAMING CONVENTION
DOESNT MEAN ANYTHING TO ANYONE BUT YOU 4HE CONTAINER WONT LOOK AT THE
THREE CLASSES IN THE *!2 AND RECOGNIZE THAT !DVICE(OME MUST BE THE HOME
INTERFACE AND SO ON
.O THE NAMING CONVENTION IS FOR YOU AND ANYONE ELSE
USING YOUR BEAN COMPONENTS
3O NOW YOU HAVE TO TELL THE TOOL WHICH OF THE lLES IS THE BEAN CLASS WELL DO
THE TWO INTERFACES ON THE NEXT PAGE 4HE TOOL THEN WILL PUT THIS INFO INTO
THE DEPLOYMENT DESCRIPTOR
&OLFNWKH(QWHUSULVH%HDQ&ODVVGURSGRZQPHQX
6HOHFWKHDGÀUVW$GYLFH%HDQ
7KHUHDUHVRPHYHQGRUWRROV
WKDWFDQXVH\RXUQDPLQJ
FRQYHQWLRQDPRQJRWKHU
WKLQJVWRILJXUHRXWZKLFKLV
WKHKRPHZKLFKLVWKHEHDQ
HWF%XWWKH5,GRHVQ·WGRWKLV
DQGGHYHORSPHQWWRROVXSSRUW
LVQRWSDUWRIWKH(-%VSHF
7KHRQO\WRROVUHTXLUHGE\
WKHVSHFDUHIRUWKH'HSOR\HU
QRWWKH%HDQ3URYLGHURU$SS
$VVHPEOHU
&KDSWHU
LQWURWR(-%
<MTTQ\_PQKPQ[\PM0WUMQV\MZNIKMIVL_PQKP
Q[\PM+WUXWVMV\QV\MZNIKM
.OW YOU HAVE TO DO THE SAME THING YOU DID FOR THE BEAN CLASS BUT WITH THE TWO
INTERFACES 9OULL NOTICE THAT THERE ARE TWO DIFFERENT PLACES WHERE YOU CAN SELECT
INTERFACES,OCAL AND 2EMOTE 4HIS BEAN IS REMOTE WHICH MEANS ITS A *AVA 2-)
REMOTE SERVICE BUT WELL GET INTO THAT IN THE NEXT CHAPTER SO WERE USING ONLY THE
BOTTOM SECTION FOR 2EMOTE INTERFACES *UST LEAVE THE ,OCAL INTERFACES SECTION ALONE
4HE STRANGE PART IS THAT THIS SCREEN USES THE TERM 2EMOTE )NTERFACE RATHER THAN
2EMOTE #OMPONENT )NTERFACE 4HATS JUST A BAD INTERFACE DESIGN IN THE DEPLOYTOOL
)TS ACTUALLY AN ARTIFACT OF THE PREVIOUS VERSION OF %*" WHEN THERE WERE ONLY REMOTE
INTERFACES ,OCAL INTERFACES ARE NEW TO %*" BUT WE HAVE TO LIVE WITH IT
&OLFNWKH5HPRWH+RPH,QWHUIDFHGURSGRZQPHQX
6HOHFWKHDGÀUVW$GYLFH+RPH
&OLFNWKH5HPRWH,QWHUIDFHGURSGRZQPHQX
6HOHFWKHDGÀUVW$GYLFH
\RXDUHKHUH
GHSOR\WRRO YHULI\VWUXFWXUDOLQIRUPDWLRQ
>MZQNaM^MZa\PQVOWV\PQ[[KZMMV
#HOOSING THE BEAN CLASS THE HOME INTERFACE AND THE COMPONENT INTERFACE IS A
PERMANENT DECISION /NCE YOURE DONE WITH THE REST OF THE BEAN WIZARD AND THE
DEPLOYMENT DESCRIPTOR IS CREATED YOURE STUCK WITH IT )F YOU ACCIDENTALLY MIX UP
THE HOME AND COMPONENT INTERFACES YOUR BEAN WONT WORK )N THE 2) IT WONT EVEN
DEPLOY SOME SERVERS LET YOU DEPLOY STRUCTURALLY BAD BEANS WHICH MEANS THEY BLOW UP
AT RUNTIME BUT THE 2) WONT EVEN LET YOU IN THE SERVER DOOR
%HVXUH\RXKDYHWKHIROORZLQJVHWWLQJV
(QWHUSULVH%HDQ&ODVV KHDGÀUVW$GYLFH%HDQ
5HPRWH+RPH,QWHUIDFH KHDGÀUVW$GYLFH+RPH
5HPRWH,QWHUIDFH KHDGÀUVW$GYLFH
&OLFN1(;7
Be sure your screen looks
just like this before yo
hit the Next > button !u
&KDSWHU
LQWURWR(-%
AW]¼ZMLWVMKTQKS.QVQ[P
"ECAUSE THIS BEAN IS SO SIMPLE AND WE DONT CARE ABOUT TRANSACTIONS SECURITY
ENVIRONMENT ENTRIES AND DATABASE ACCESS WEVE DONE EVERYTHING WE NEED TO
MAKE THE DEPLOYMENT DESCRIPTOR AND PUT IT IN A *!2 WITH THE CLASS lLES
3O YOU CAN IGNORE THE 4RANSACTIONS -ANAGEMENT SCREEN ALTHOUGH YOULL
BECOME INTIMATE WITH IT LATER IN THE BOOK
&OLFN)LQLVK
\RXDUHKHUH
GHSOR\WRRO PDLQVFUHHQDIWHUPDNLQJDEHDQ
5MIV_PQTMJIKSWV\PMUIQVLMXTWa\WWT[KZMMV
4HINGS HAVE CHANGED 4HE !DVICE!PP ICON EXPANDS TO SHOW YOUR EJB
JAR
NAMED h%JBv AND THE EJB
JAR EXPANDS TO SHOW THE CUTE BEAN ICON NAMED
h!DVICE"EANv )F YOU SELECT THE !DVICE"EAN YOULL SEE A BUNCH OF TABBED PANELS
THATLL SHOW YOU THE CHOICES YOU MADE IN THE BEAN WIZARD 3OME OF THE THINGS YOU
CHOSE CAN BE CHANGED BUT SOME CANT )N THE 'ENERAL PANEL FOR EXAMPLE YOU
CANT CHANGE THE CLASS lLE DESIGNATIONS FOR THE HOME COMPONENT AND BEAN )N
FACT YOU CAN SEE THAT THE DROP
DOWN LISTS FOR THESE ARE GRAYED
OUT HERE "UT GEE
YOU CAN STILL CHANGE IT FROM 3TATELESS TO 3TATEFUL
$GPLUH\RXUZRUN
&KDSWHU
LQWURWR(-%
:]VaW]ZJMIV\PZW]OP\PMLMXTWa\WWT^MZQNQMZ
9OU ALREADY KNOW YOUR BEAN CLASSES COMPILE BUT JUST BECAUSE IT COMPILES
DOESNT MEAN IT FOLLOWS BEAN LAW 4HE VERIlER TAKES YOUR JAR AND RUNS IT
THROUGH A BUNCH OF TESTS TO SEE IF IT MEETS THE MINIMUM REQUIREMENTS FOR
DEPLOYMENT !S YOU LEARN MORE ABOUT THE %*" SPEC YOULL SEE THAT THE
VERIlER IS TESTING YOUR BEANS CODE AND THE DEPLOYMENT DESCRIPTOR TO SEE
IF IT COMPLIES WITH THE SPEC &OR EXAMPLE A STATELESS SESSION BEANS HOME
INTERFACE MUST HAVE A NO
ARG CREATE METHOD DECLARED AND NOTHING ELSE
!ND THE BEAN CLASS MUST HAVE METHODS THAT MATCH THOSE DECLARED IN THE
COMPONENT INTERFACE !ND IF THE COMPONENT INTERFACE IS REMOTE IT MUST
DECLARE THAT EACH METHOD THROWS 2EMOTE%XCEPTION $ONT WORRY ABOUT
REMEMBERING THESE EXAMPLES ITS JUST TO GIVE YOU AN IDEA OF THE KINDS OF
THINGS THE VERIlER DOES
&OLFNRQWKH(MELFRQ WKHOLWWOHMDU WRKLJKOLJKWLW
&KRRVH7RROV 9HULÀHU
&URVV\RXU¿QJHUV
\RXDUHKHUH
GHSOR\WRRO UXQQLQJWKHYHUL¿HU
+TW[MaW]ZMaM[IVLKTQKS73
4HE VERIlER SCREEN SHOWS YOU THE NAME OF THE *!2 AS EJB
JAR
ICJAR IN A TMP
DIRECTORY BUT THATS JUST HOW THE 2) SAVES YOUR EJB
JAR UNTIL YOURE READY TO
DEPLOY 4HE TMP lLE AND THE *!2 WILL GO AWAY WHEN YOU DEPLOY OR DELETE
THE BEAN FROM YOUR APPLICATION
!T LEAST ITS SUPPOSED TO 3OMETIMES YOU MIGHT HAVE TO lND THAT DIRECTORY AND
DELETE IT YOURSELF 2EPEAT AFTER ME 4HE DEPLOYTOOL IS FREE 4HE DEPLOYTOOL IS
NOT A PRODUCTION TOOL ) DID NOT PAY ANY MONEY FOR THIS TOOL ) WILL LEARN TO
APPRECIATE ITS STRENGTHS AND LOOK PAST THE WAYS IT IS A PAIN IN THE A
&KRRVHWKH)DLOXUHV2QO\UDGLREXWWRQ
&OLFN2.
&KDSWHU
LQWURWR(-%
?PM_ 6WNIQTML\M[\[
)F EVERYTHING VERIlES YOU SEE A NICE LITTLE MESSAGE IN THE $ETAILS BOX AT THE BOTTOM OF THE
VERIlER WINDOW )F THERE ARE FAILURES YOULL SEE THEM IN THE 2ESULTS BOX 9OU CAN CLICK ON A
@FAILURE MESSAGE TO GET MORE DETAILS ABOUT WHAT WENT WRONG $ONT PANIC IF YOU SEE A MILLION
FAILURES USUALLY YOU CAN lX ONE THING AND THEY ALL GO AWAY 5NLIKE COMPILER ERROR MESSAGES
WHICH ARE SOMETIMES ABOUT AS HELPFUL AS 6#2 INSTRUCTIONS THE VERIlER FAILURE MESSAGES ARE
PRETTY EXPLICIT 9OU CAN USUALLY lGURE OUT EXACTLY WHERE YOU WENT WRONG
3OMETIMES YOU CAN lX THE PROBLEM BACK IN THE MAIN DEPLOYTOOL WINDOW BY CLICKING ON ONE OF
THE TABBED PANELS AND CHANGING SOMETHING &OR EXAMPLE IF YOU FORGOT TO SPECIFY A TRANSACTION
ATTRIBUTE FOR AN ENTITY BEAN METHOD YOU CAN GO TO THE 4RANSACTIONS TABBED PANEL IN THE
DEPLOYTOOL WINDOW AND SET THE ATTRIBUTE WITHOUT STARTING OVER IN THE BEAN WIZARD
"UT IF YOU HAVE PROBLEMS WITH YOUR ACTUAL CLASS lLES YOULL HAVE TO MODIFY THEM RECOMPILE
THEM AND THEN UPDATE YOUR EJB
JAR
/R IF THE PROBLEM IS THAT YOU MADE A SETTING IN THE BEAN
WIZARD THAT CANT BE CHANGED LIKE SELECTING THE BEAN CLASS WHEN THE TOOL ASKS FOR THE HOME
INTERFACE YOULL HAVE TO DELETE THE EJB
JAR AND START OVER WITH THE BEAN WIZARD
%HKDSS\DERXWWKHZRQGHUIXOPHVVDJHDWWKHERWWRP
&OLFN&ORVH
Click Close to put
away the window.
If you click OK,
youÕll just run the
veriÞer again.
4O UPDATE YOUR
EJB
JAR lLE CHOOSE
THE @4OOLS THEN
@5PDATE &ILES
MENU OPTIONS
\RXDUHKHUH
GHSOR\WRRO GRLQJWKHGHSOR\
<QUM\W,MXTWa
/NCE YOUVE VERIlED YOURE READY TO DEPLOY 4HERES NOT MUCH THAT CAN GO
WRONG UNLESS SOMETHING BAD HAPPENS IN THE SERVER !T THIS POINT ALMOST
ANYTHING THAT GOES WRONG CAN BE lXED BY SHUTTING DOWN THE SERVER AND
DEPLOYTOOL AND STARTING THEM BACK UP AGAIN $RASTIC YES BUT IT USUALLY WORKS
3OMETIMES YOU DO HAVE TO TAKE EVEN HARSHER ACTION BY RETURNING THE SERVER
BACK TO ITS FRESHLY INSTALLED STATE BUT FORTUNATELY THERES A COMMAND THAT
CAN DO THAT 7HEN ALL ELSE FAILS BRING UP A NEW TERMINAL AND TYPE CLEANUP
4HIS SCRIPT SHUTS DOWN THE *%% SERVER BUT IT ALSO CLEANS OUT ALL THE LOGS
DIRECTORIES AND lLES THAT HAVE BEEN MADE ON THAT MACHINE !FTER THAT YOU
CAN TRY STARTING THE SERVER THEN THE DEPLOYTOOL AND DEPLOYING AGAIN !ND IF
YOU EVER OPEN THE DEPLOYTOOL AND YOU DONT SEE YOUR APPLICATION DONT PANIC
*UST GO TO THE &ILE MENU AND CHOOSE /PEN JUST LIKE YOU WOULD TO OPEN A
DOCUMENT IN ANY OTHER APPLICATION 4HINK OF THE *%% APP LIKE A DOCUMENT AS
FAR AS THE DEPLOYTOOL IS CONCERNED
&KRRVH7RROV 'HSOR\
&KDSWHU
LQWURWR(-%
5ISMQ\:M\]ZVI+TQMV\2IZ
/NCE IT STARTS THE SERVER IS GOING TO DO A TON OF THINGS TO GET YOUR BEAN READY /NE OF
THEM IS TO GENERATE THE CLASS lLES THAT IMPLEMENT YOUR TWO INTERFACES THE HOME AND THE
COMPONENT INTERFACES !ND SINCE THEYRE REMOTE INTERFACES THE SERVER WILL ALSO CREATE
THE REMOTE STUB CLASSES FOR THOSE INTERFACES ,OTS MORE ON THESE LATER 7ELL THE CLIENT
NEEDS THE TWO INTERFACES AND THE TWO STUBS 9OU COULD HAVE GIVEN THE CLIENT THE INTERFACES
SINCE YOU CREATED THOSE "UT ONLY THE SERVER CAN MAKE THE STUB CLASSES AND THE CLIENT WILL
NEVER WORK WITHOUT THEM 3O YOUR CLIENT APPLICATION MIGHT BE SITTING THERE ALL NICE AND
COMPILED AND JUST WAITING FOR YOU TO GIVE IT THE STUB CLASSES SO THAT IT CAN ACTUALLY RUN
&ORTUNATELY YOU CAN ASK THE 2) DEPLOYTOOL TO GIVE YOU A CLIENT JAR THAT HAS EVERYTHING THE
CLIENT NEEDS AND A LOT MORE IT TURNS OUT BUT SINCE THIS ISNT A REAL PRODUCTION ENVIRONMENT
WERE JUST GOING TO LET THAT GO
6IRTUALLY ALL %*" APPLICATION SERVERS MUST CREATE THE STUB CLASSES SO YOULL HAVE TO lND OUT
WHERE YOUR SERVER PUTS THEM SO YOU CAN GIVE THEM TO THE CLIENT
6HOHFWWKH5HWXUQ&OLHQW-DUFKHFNER[ SXWLWLQWKHSURMHFWVDGYLFHGLUHFWRU\
&OLFN1H[W!
\RXDUHKHUH
GHSOR\WRRO JLYLQJWKHEHDQD-1',QDPH
/Q^MQ\IVIUM[WKTQMV\[KIVTWWSQ\]X
7ERE NOW DANGEROUSLY CLOSE TO DEPLOYMENT AND THE LAST STEP IS TO GIVE THE BEAN A
*.$) NAME 4HATS THE NAME CLIENTS USE TO GET A REFERENCE TO THE BEAN 7ELL TO WHAT
THE CLIENT THINKS IS THE BEAN BUT WELL SAVE THE GORY DETAILS FOR THE NEXT CHAPTER
4HE BEANS *.$) NAME IS SIMPLY THE LOGICAL NAME YOU CHOOSE OR IN THE REAL WORLD
WHOEVER DEPLOYS THE BEAN )T DOESNT HAVE TO MATCH ANYTHING FROM THE BEAN ITSELF 7E
COULD FOR EXAMPLE NAME THIS BEAN (OMER WHICH WOULD IN FACT MAKE IT EVEN MORE
FUN AND CHALLENGING FOR THE CLIENTS THAN IT ALREADY WOULD BE WITH A MEANINGFUL NAME
7\SHLQWKH-1',QDPH$GYLVRU
&OLFN)LQLVK
7DNHDGHHSEUHDWKDQGKROGLWXQWLOWKHGHSOR\SURFHVVFRPSOHWHV
$GYLVRU
&KDSWHU
LQWURWR(-%
?I\KP\PMXZWOZM[[JIZ[OW]X\PMVKMTMJZI\M
7AIT FOR IT WAIT FOR IT WAIT FOR IT
7HEN THE BEANS DEPLOYED SUCCESSFULLY YOULL SEE THE LINE h$EPLOYMENT OF !DVICE!PP
IS COMPLETEv IN THE WINDOW !T THAT POINT CLIENTS CAN ACCESS THE BEAN
9OU DID IT
&OLFN2.
ItÕs a miracle !
It worked !
\RXDUHKHUH
GHSOR\WRRO PDLQVFUHHQDIWHUGHSOR\LQJ
6W_aW]¼TT[MM\PM)L^QKM)XXQV[QLM\PM[MZ ^MZ
5NDER THE 3ERVERS ICON YOULL SEE THE LOCALHOST ICON REPRESENTING THE *%% SERVER
YOU STARTED BEFORE YOU LAUNCHED THE DEPLOYTOOL !ND UNDER THE LOCALHOST ICON YOU
CAN NOW SEE THAT YOUR !DVICE!PP IS DEPLOYED 9OULL ALSO SEE THE 5NDEPLOY BUTTON
THAT YOU CAN USE TO WELL UNDEPLOY
([SDQGWKH6HUYHUV!ORFDOKRVWLFRQVWRVHHWKH$GYLFH$SS
&KDSWHU
LQWURWR(-%
6W_ITT_MVMMLQ[IKTQMV\
7E HAVE A FRESHLY DEPLOYED BEAN IN A *%% SERVER BUT WE CANT
TEST IT UNTIL WE HAVE A CLIENT 4HE CLIENT HAS TO DO lVE THINGS
*HWDUHIHUHQFHWRD-1',,QLWLDO&RQWH[W :H·UHXVLQJDVWDQGDORQH-DYD
ZH¶OOOHDUQDERXWWKDWLQWKH&OLHQW9LHZFKDSWHU SURJUDPDVWKHFOLHQW
8VHWKH,QLWLDO&RQWH[WWRGRDORRNXSRQWKH ,QWKHUHDOZRUOG\RXUFOLHQWV
KRPHLQWHUIDFHRIWKHEHDQ WKDWZHQDPHG ZLOOOLNHO\EHVHUYOHWVRURWKHU
³$GYLVRU´ZKHQZHGHSOR\HG EHDQV
1DUURZDQGFDVWWKHWKLQJZHJHWEDFN
IURPWKHORRNXS 7KDWWKLQJLVVRPHWKLQJ
7KHÀYHWKLQJVWKHFOLHQWPXVW
WKDWLPSOHPHQWVWKH$GYLFH+RPHLQWHUIDFH GRDUHWKHVDPHUHJDUGOHVVRI
:H¶OOOHDUQDERXWQDUURZLQJLQWKH&OLHQW9LHZ WKHW\SHRIFOLHQW
FKDSWHU
6RXVLQJDVWDQGDORQH-DYD
&DOOFUHDWHRQWKHKRPHLQWHUIDFHWRJHW SURJUDPWHDFKHV\RXWRGRWKH
EDFNDUHIHUHQFHWRWKHFRPSRQHQWLQWHUIDFH VDPHWKLQJV\RX·OOQHHGWRGR
ZLWKDVHUYOHWFOLHQW
&DOOJHW$GYLFH WKHEXVLQHVVPHWKRG
WKHUHDVRQZH¶UHKHUHUHPHPEHU" RQWKH ,I\RXUFOLHQWLVDQRWKHU
FRPSRQHQWLQWHUIDFHDQGSULQWWKHUHVXOW HQWHUSULVHEHDQWKHFRGHZLOO
EHVOLJKWO\GLIIHUHQWEXW\RX
VWLOOKDYHWRGRWKHÀYHVWHSV
7KHUH¶VQRWKLQJRQWKHH[DPDERXWVHUYOHWVRU-63V
7KHH[DPH[SHFWV\RXWRNQRZKRZWKHFOLHQWJHWVDQGXVHVD
EHDQ WKHVWHSVDERYH EXWWKHW\SHRIFOLHQWGRHVQ¶WPDWWHU7KHFOLHQW
FRGHIRUJHWWLQJDUHIHUHQFHWRDEHDQDQGXOWLPDWHO\FDOOLQJPHWKRGVRQWKH
EHDQLVYLUWXDOO\WKHVDPHZKHWKHUWKHFOLHQWLVDVHUYOHWRUVWDQGDORQH-DYD
DSS$QGDOOWKHH[DPFDUHVDERXWLVWKHSDUWRIWKHFRGHZKHUHWKHFOLHQWLV
WU\LQJWRJHWDQGXVHDEHDQ
7KHRQO\NQRZOHGJHRIVHUYOHWVDQG-63V\RXQHHGIRUWKHH[DPLVWRNQRZ
WKDWWKH(-%VSHFGRHV127JXDUDQWHHVXSSRUWIRUWKHP6HUYOHWVDQG-63V
DUHJXDUDQWHHGE\WKH-((VSHFEXWQRWE\WKH(-%VSHF
\RXDUHKHUH
RUJDQL]LQJWKHFRPSOHWHSURMHFW
7ZOIVQbQVOaW]ZXZWRMK\LQZMK\WZaNWZ\PMKTQMV\
7KLVLVZKDW\RXUSURMHFWVDGYLFH
so we
ster client,in a
GLUHFWRU\VKRXOGORRNOLNHDIWHUZH
ZULWHDQGFRPSLOHWKHFOLHQWFRGH ju st a t e
This is the client class ep it
wonÕt putWeÕre just gonna ke nd class)
package. put it all (source a
easy and vice directory.
This is the client JA SURMHFWV in the ad
the server gave us R
MDYD[HME
LPSRUWMDYD
UPL5HPRWH([
FHSWLRQ
when we deployed. $GYLFH&OLHQWMDYD
$GYLFH$SS&OLHQWMDU DGYLFH
$GYLFH&OLHQWFODVV
FODVVHV VUF
KHDGILUVW KHDGILUVW
MDYD[HME
LPSRUW
LPSRUWMDYD MDYD[HME
UPL5HPRWH([ LPSRUWMDYD
FHSWLRQ
$GYLFH%HDQFODVV FHSWLRQ
$GYLFHFODVV $GYLFH%HDQMDYD $GYLFHMDYD
MDYD[HME
LPSRUWMDYD
UPL5HPRWH([
FHSWLRQ
$GYLFH+RPHFODVV $GYLFH+RPHMDYD
&KDSWHU
LQWURWR(-%
7KH&OLHQW&RGH $GYLFH&OLHQWMDYD
LPSRUWMDYD[QDPLQJ
LPSRUWMDYDUPL
LPSRUWMDYD[UPL
A bunch of imports
LPSRUWKHDG¿UVW
LPSRUWMDYD[HME
SXEOLFFODVV$GYLFH&OLHQW^
SXEOLFVWDWLFYRLGPDLQ 6WULQJ>@DUJV ^
QHZ$GYLFH&OLHQW JR
` InitialContext is our entry po,int
into the JND nami
I ng service
kup.
SXEOLFYRLGJR ^
where we do the loo I
WU\^
Lookup the Aditvicdu e bean using thet.JND
&RQWH[WLF QHZ,QLWLDO&RQWH[W
ring de plo ym en
2EMHFWR LFORRNXS ³$GYLVRU´ name we gave
$GYLFH+RPHKRPH $GYLFH+RPH 3RUWDEOH5HPRWH2EMHFWQDUURZ R$GYLFH+RPHFODVV
$GYLFHDGYLVRU KRPHFUHDWH
6\VWHPRXWSULQWOQ DGYLVRUJHW$GYLFH Just go with it for now.
`FDWFK ([FHSWLRQH[ ^ make perfect sense a lit ItÕll all
H[SULQW6WDFN7UDFH
tle later.
` Finally we get to the ac
` tual business
`
The method declare d in the componenmethod!
(Advice) and implement t erface
ed in the bean claint
ss.
&RPSLOHWKHFOLHQW
)LOH(GLW:LQGRZ+HOS$OO7KLV)RU-XVW7KDW
FGaSURMHFWVDGYLFH The client class
The client JAR Þle
MDYDFFODVVSDWK^&/$663$7+` $GYLFH$SS&OLHQWMDU$GYLFH&OLHQWMDYD
4HE CLIENT NEEDS ACCESS TO THE TWO INTERFACES !DVICE !DVICE(OME AND THE TWO STUB
CLASSES THAT IMPLEMENT THOSE INTERFACES 4HEYRE BOTH IN THE CLIENT *!2 THE SERVER MADE
BUT WE CANT COMPILE THE CLIENT WITHOUT THEM 4HE CLEANEST WAY IS TO ADD THEM TO THE
CLASSPATH AT COMPILE TIME USING THE FODVVSDWK COMPILER mAG
\RXDUHKHUH
UXQQLQJWKHFOLHQW
5XQWKHFOLHQW
)LOH(GLW:LQGRZ+HOS$OO7KLV)RU-XVW7KDW
FGaSURMHFWVDGYLFH
MDYDFS^&/$663$7+` $GYLFH$SS&OLHQWMDU$GYLFH&OLHQW
!T RUNTIME THE CLIENT STILL NEEDS ACCESS TO THE TWO INTERFACES !DVICE
!DVICE(OME AND THE TWO STUB CLASSES THAT IMPLEMENT THOSE INTERFACES
4HEYRE BOTH IN THE CLIENT *!2 THE SERVER MADE WE HAVE TO ADD THEM TO THE
CLASSPATH 4HE BEST WAY IS TO USE THE FS COMPILER mAG
.OTE &OR NOW THE CLIENT MUST BE ON THE SAME PHYSICAL MACHINE AS THE SERVER
,ATER WELL SEE HOW TO CHANGE THIS AND RUN THE CLIENT AGAINST A *%% SERVER ON
A DIFFERENT MACHINE
,WKLQN,FDQDQVZHUWKDW³\HDKWKLV
<RX·UHNLGGLQJPH LVPDMRURYHUNLOOIRUD+HOOR:RUOGLVK
ULJKW"$OOWKLVZRUNMXVWWR DSSOLNHWKH$GYLFH%HDQ%XWLQWKHFRQWH[WRI
FDOORQHOLWWOHPHWKRGWKDWUHWXUQV DUHDOHQWHUSULVHDSSZLWKD]LOOLRQFXVWRPHUVDGD\
D6WULQJ",KDYHWRGRDOOWKLV KLWWLQJ\RXUVHUYHU DQGDQLQVDQHO\VKRUWGHDGOLQH
MXVWWRGR+HOOR:RUOGLQ(-%" WKLVH[WUDZRUNDQGUXQWLPHRYHUKHDGLVSUHWW\WULYLDO
(VSHFLDOO\ZKHQ\RXFRQVLGHUHYHU\WKLQJ\RX*(76R,
WKLQN\RXQHHGWRORRNDWWKLVIURPDPRUHUHDO
ZRUOGSHUVSHFWLYH
2.\HVLI\RX·UHJRQQDEHDOOSLFN\DERXWLW
,·P QRWUHDOEXWWKDWVKRXOGQ·W
DIIHFWP\FUHGLELOLW\
&KDSWHU
LQWURWR(-%
0RFN([DP
7HICH ARE FEATURES EVERY %*" CONTAINER MUST IMPLEMENT OR SUPPORT
1 #HOOSE ALL THAT APPLY
R! ! '5) BEAN DEPLOYMENT UTILITY
R" 3YNCHRONOUS INVOCATION FOR ALL BEAN TYPES
R# 4RANSACTION SUPPORT FOR ALL BEAN TYPES
R$ 2EMOTE CLIENT VIEWS FOR ALL BEAN TYPES
R% *.$) NAMESPACE
7HICH ARE GUARANTEED CAPABILITIES OF %*" #HOOSE ALL THAT APPLY
2
R! ,OCAL HOME INTERFACES FOR MESSAGE
DRIVEN BEANS
R" $IRTY DETECTION MECHANISMS TO REDUCE MEMORY FOOTPRINTS
R# 2UN
AS SECURITY IDENTITY FUNCTIONALITY
R$ 4HE *$"# EXTENSION
R% 3ESSION BEAN FAILOVER
7HICH ARE FEATURES IN %*" #HOOSE ALL THAT APPLY
3
R! 0ORTABLE lNDER QUERY SYNTAX
R" #ONTAINER MANAGED PERSISTENCE
R# ,OCAL INTERFACES FOR SESSION BEANS
R$ 8-, BASED DEPLOYMENT DESCRIPTORS
R% 3YNCHRONOUS MESSAGE
DRIVEN BEANS
\RXDUHKHUH
PRFNH[DPDQVZHUV
0RFN([DP$QVZHUV
1 7HICH ARE FEATURES EVERY %*" CONTAINER MUST IMPLEMENT OR SUPPORT (spec: 30)
#HOOSE ALL THAT APPLY
to be GUI
R! ! '5) BEAN DEPLOYMENT UTILITY - it doesnÕt have
R" 3YNCHRONOUS INVOCATION FOR ALL BEAN TYPES - MDBs cannot be synchronous
R# 4RANSACTION SUPPORT FOR ALL BEAN TYPES
R$ 2EMOTE CLIENT VIEWS FOR ALL BEAN TYPES - MDBs d
o not have clie
R% *.$) NAMESPACE nt views
7HICH ARE GUARANTEED CAPABILITIES OF %*" #HOOSE ALL THAT APPLY
2 ve clients
R! ,OCAL HOME INTERFACES FOR MESSAGE
DRIVEN BEANS - MDBs donÕt ha
R" $IRTY DETECTION MECHANISMS TO REDUCE MEMORY FOOTPRINTS - nice, but not guaranteed
R# 2UN
AS SECURITY IDENTITY FUNCTIONALITY
R$ 4HE *$"# EXTENSION
R% 3ESSION BEAN FAILOVER - maybe available, but not gua
ranteed
3 7HICH ARE FEATURES IN %*" #HOOSE ALL THAT APPLY
(spec: 25-26)
R! 0ORTABLE lNDER QUERY SYNTAX
R" #ONTAINER MANAGED PERSISTENCE
R# ,OCAL INTERFACES FOR SESSION BEANS
R$ 8-, BASED DEPLOYMENT DESCRIPTORS
R% 3YNCHRONOUS MESSAGE
DRIVEN BEANS - MDBs are always asynchron
ous
&KDSWHU
architectural overview
5
4
4 (-%$UFKLWHFWXUH
,WDOOORRNVVR
LPSUHVVLYHIURPWKLV
YLHZ7RREDGZHFDQ·W
VWD\DWWKLVOHYHO
(-%LVDERXWLQIUDVWUXFWXUH<RXUFRPSRQHQWVDUHWKHEXLOGLQJEORFNV:LWK
(-%\RXFDQEXLOGELJDSSOLFDWLRQV7KHNLQGRIDSSOLFDWLRQVWKDWFRXOGUXQHYHU\WKLQJ
IURPWKH9LFWRULD¶V6HFUHWEDFNHQGWRGRFXPHQWKDQGOLQJV\VWHPVDW&(51%XWDQ
DUFKLWHFWXUHZLWKWKLVPXFKÀH[LELOLW\SRZHUDQGVFDODELOLW\LVQ¶WVLPSOH,WDOOEHJLQVZLWK
DGLVWULEXWHGSURJUDPPLQJPRGHOZKHUHFOLHQWVVHUYHUVDQGHYHQGLIIHUHQWSLHFHVRIWKH
VDPHDSSOLFDWLRQDUHUXQQLQJZKRNQRZVZKHUHRQWKHQHWZRUN%XWKRZGRHVWKHFOLHQW
¿QGDEHDQ"+RZGRHVWKHFOLHQWFDOOPHWKRGVLW":K\DUHWKHUHGLIIHUHQWEHDQW\SHV":LOO
%HQPDUU\-/R"
WKLVLVDQHZFKDSWHU
QRREMHFWLYHV
%DFNJURXQG
:H¶UHLQWKLVFKDSWHUIRUEDFNJURXQGQRWEHFDXVHRIDQH[DP
REMHFWLYH$OWKRXJK\RXFRXOGVD\WKDWHYHU\REMHFWLYHLQWKH
H[DPGHSHQGVRQ\RXUXQGHUVWDQGLQJZKDW¶VLQWKLVFKDSWHU
%XWGRQ¶WZRUU\ZH¶OOKDYHSOHQW\RIREMHFWLYHVEHJLQQLQJ
ZLWK&KDSWHU%\&KDSWHU\RXZLOOORRNEDFNORQJLQJO\RQ
WKLVFKDSWHUDQGUHPHPEHUZKDWLWZDVOLNHQRWWRKDYHDQ\
REMHFWLYHV<RX¶OOPLVVWKLVFKDSWHUZKHQLW¶VJRQHVRVDYRUWKH
PRPHQWV\RXKDYHZLWKLW
&KDSWHU
DUFKLWHFWXUDORYHUYLHZ
AW]ZMUMUJMZ\PQ[XQK\]ZM
"UT IT WAS TOO HIGH
LEVEL TO GET US ANYWHERE 4HINK ABOUT HOW MUCH IS
MISSING FROM THIS PICTURE ,IKE HOW DOES THE CLIENT GET A REFERENCE TO
SOMETHING RUNNING ON A DIFFERENT MACHINE (OW DOES THE CLIENT ACTUALLY
COMMUNICATE WITH THE BEAN (OW IS IT THAT THE SERVER CAN STEP INTO THE
MIDDLE OF A CLIENT
TO
BEAN METHOD CALL
"ENEATH %*" THERES *AVAS DISTRIBUTED TECHNOLOGY FOR 2EMOTE -ETHOD
)NVOCATION 2-) !LTHOUGH %*" HIDES SOME OF THE COMPLEXITIES OF 2-)
FROM THE BEAN DEVELOPER ITS STILL THERE AND UNLESS YOU TRULY UNDERSTAND IT
SOME PIECES WILL NEVER MAKE SENSE
3O WE START OUR DESCENT FROM A HIGH
LEVEL VIEW TO THE BLOOD AND GUTS OF %*"
WITH A LESSON ON 2-) )F YOURE ONE OF THE FORTUNATE WHOVE ALREADY WORKED
A LOT WITH 2-) YOU CAN SKIP THIS AND GO STRAIGHT TO THE PART WHERE WE TALK
ABOUT THE WAYS IN WHICH %*" USES 2-) "UT YOU SHOULD STILL AT LEAST SKIM IT
EVEN IF YOURE AN EXPERIENCED %*" DEVELOPER IF FOR NO OTHER REASON THAN TO
GET COMFORTABLE WITH THE TERMINOLOGY AND PICTURES WELL USE THROUGHOUT THE
REST OF THE BOOK
/+ BACK TO WHERE WE STARTEDWHATS MISSING FROM THIS PICTURE 3TART BY
LOOKING AT THE PLACES WHERE A MIRACLE OCCURS
eÕs
too soon to tell if ththerere
a miracle he re , bu t
miracle occurs here probably is...
miracle occurs here VHUYHU
&OLHQW
EL]LQWHUIDFH
VHUYLFHV
W
DQ
(-% (Q
& OL REMHF WHUS VHEH
HQWREMHFW UL
'%
$ULGLFXORXVO\KLJKOHYHOYLHZRI(-%DUFKLWHFWXUH
\RXDUHKHUH
UHPRWHPHWKRGV
5ISQVOIZMUW\MUM\PWLKITT
7HEN YOU WRITE A CLIENT TO ACCESS A BEAN THE CLIENT IS EITHER LOCAL
OR REMOTE ! LOCAL CLIENT MEANS THE CLIENT IS RUNNING IN THE SAME
*6- AS THE BEAN )N OTHER WORDS BOTH THE BEAN AND THE CLIENT
LIVE IN THE SAME HEAP 7ELL TALK ABOUT THAT MUCH MORE IN THE :LWK50,\RXUFOLHQWREMHFW
#LIENT 6IEW CHAPTER BUT FOR NOW REMEMBER THAT LOCAL MEANS JHWVWRDFWOLNHLW·VPDNLQJD
SAME HEAP *6- #HANCES ARE YOULL USE LOCAL CLIENTS ONLY WITH
ENTITY BEANS AND ONLY UNDER VERY SPECIAL CIRCUMSTANCES UHPRWHPHWKRGFDOO%XWZKDW
9OULL USE A REMOTE CLIENT WHEN YOU WANT A BEAN TO BE USED BY THE
OUTSIDE WORLD -OST ENTERPRISE APPLICATIONS HAVE A REMOTE CLIENT
LW·VUHDOO\GRLQJLVFDOOLQJD
EVEN IF SOME OF THE BEANS USED IN THE APPLICATION TALK TO ONE PHWKRGRQD´SUR[\µREMHFW
ANOTHER AS LOCAL CLIENTS 7ELL EXPLORE EVERY GORY DETAIL ABOUT
THIS BEFORE THE BOOK IS OVER UXQQLQJLQWKHVDPHKHDS
3O HOW DOES AN OBJECT IN ONE HEAP*6- DIRECTLY CALL A METHOD ZLWKWKHFOLHQW7KHSUR[\LV
ON A REFERENCE TO AN OBJECT RUNNING IN ANOTHER HEAP*6-
4ECHNICALLY ITS NOT POSSIBLE *AVA REFERENCES HOLD BITS THAT DONT FDOOHGD´VWXEµDQGLWKDQGOHV
MEAN ANYTHING OUTSIDE THE CURRENTLY RUNNING *6- )F YOURE AN
OBJECT AND YOU HAVE A REFERENCE TO ANOTHER OBJECT THAT OBJECT MUST DOOWKHORZOHYHOQHWZRUNLQJ
BE IN THE SAME HEAP WITH YOU
VRFNHWVDQGVWUHDPV
*AVA 2-) 2EMOTE -ETHOD )NVOCATION SOLVES THIS PROBLEM BY
GIVING THE CLIENT A PROXY CALLED A STUB OBJECT THAT ACTS AS THE
GO
BETWEEN FOR THE CLIENT AND 2EMOTE OBJECT 4HE CLIENT CALLS
A METHOD ON THE STUB AND THE STUB TAKES CARE OF THE LOW
LEVEL
COMMUNICATION SOCKETS AND STREAMS WITH THE 2EMOTE OBJECT
,
et en d s to be th e Remote object
Helper ÒstubÓ prproxy... something that knows .
but itÕs just a icate with the Remote object
how to commun
&OLHQWKHDS JHW$GYLFH
$ G Y LF H 6HUYHUKHDS
JHW
UHP E· 5H
W
RWH¶VWX PRWH REMHF
FOL
HQWREMH FW
The clientÕs goal is to ca
object (the thing that doll a method on the Remote The Remote Object is the object with the
Remote object is in a dif es the real work). But since the method that actually does the real work
method on a local ÒstubÓ ferent heap, the client calls a for whatever that method is supposed to do
over the network) object (which in turn sen (checkCredit(), calculatePi(), etc.).
ds info
&KDSWHU
DUFKLWHFWXUDORYHUYLHZ
<PMZM¼[I¹PMTXMZºWV\PM[MZ ^MZI[_MTT
4HE 2EMOTE OBJECT HAS THE METHOD THE CLIENT WANTS TO CALL "UT WHEN THE STUB
MAKES A NETWORK CONNECTION TO THE SERVER SOMETHING ON THE SERVER HAS TO TAKE THE
INFORMATION IN THE INCOMING STREAM AND TURN IT INTO A METHOD CALL ON THE 2EMOTE
OBJECT 9OU COULD PUT THE NETWORKING CODE INTO YOUR 2EMOTE OBJECT BUT THAT
DEFEATS THE WHOLE POINT OF 2-)TO MAKE IT AS EASY FOR YOUR CLIENT TO CALL A METHOD
ON AN OBJECT ACROSS THE NETWORK AS IT IS TO CALL A METHOD ON AN OBJECT IN THE SAME
HEAP 4HE GOAL OF 2-) IS TO PROMOTE NETWORK TRANSPARENCY )N OTHER WORDS THE FACT
THAT THE OBJECTS ARE IN DIFFERENT MACHINES SHOULD BE NEARLY TRANSPARENT TO THE
DEVELOPER 7HICH MEANS TO YOU LESS CODESIMPLER CODE
3O WITH THAT AS THE GOAL 2-) TAKES CARE OF THE SERVER
SIDE OF THE METHOD CALL AS
WELL 4HE THING ON THE SERVER
SIDE THAT ACCEPTS THE SOCKET CONNECTION IS CALLED A
SKELETON )TS THE COUNTERPART TO THE CLIENT STUB )N THE EARLY VERSIONS OF 2-) FOR
EVERY STUB THERE WAS A MATCHING SKELETON OBJECT 4ODAY THOUGH THATS NOT ALWAYS
TRUE 4HE FUNCTIONALITY OF THE SKELETON HAS TO HAPPEN SOMEHOW ON THE SERVER
SIDE
BUT AN ACTUAL SKELETON OBJECT IS OPTIONAL 7E WONT GO INTO ANY OF THE DETAILS BECAUSE
IT DOESNT MAKE ANY DIFFERENCE TO US WITH %*" (OW THE CONTAINER CHOOSES TO
IMPLEMENT ITS SKELETON BEHAVIOR IS UP TO THE VENDOR
!LL WE CARE ABOUT IS THAT SOMETHING IS ON THE SERVER THAT THE STUB KNOWS HOW TO
TALK TO AND THAT SOMETHING KNOWS HOW TO INTERPRET THE MESSAGE FROM THE STUB AND
INVOKE A METHOD ON THE 2EMOTE OBJECT
tion
pt s th e in co m in g Socket connyiecng,
The skeleton ac, ceÞgures out what the stub is ansad calls
from the stub hod to call on which object)
(i.e. which met the Remote object.
the method on
&OLHQWKHDS 6HUYHUKHDS
JHW$GYLFH
JHW$GYLFH
$ G YL F H
JHW
5H
W
UHP E· ¶VNHOHWRQ· PRWH REMHF
RWH¶VWX
FOL
HQWREMHFW
a method call to To the Remote object, itÕs just a method call
To the client, itÕs juste same heap. from another object in the same heap.
another object in th
\RXDUHKHUH
(-%DUFKLWHFWXUH
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: (OW CAN YOU HAVE hNETWORK TRANSPARENCYv Q: !M ) RESPONSIBLE FOR BUILDING THE STUB
7HAT HAPPENS IF THE NETWORK OR THE SERVER IS AND THE SKELETON (OW DOES THE STUB KNOW WHAT
DOWN WHEN THE CLIENT CALLS THE REMOTE METHOD )T METHODS MY 2EMOTE OBJECT HAS &OR THAT MATTER
SEEMS LIKE THERES A ,/4 MORE THAT CAN GO WRONG HOW DOES THE CLIENT KNOW WHAT METHODS MY
THAN IF THE CLIENT OBJECT IS JUST MAKING A PLAIN OLD 2EMOTE OBJECT HAS
METHOD CALL TO ANOTHER OBJECT IN THE HEAP
A: A: .O YOU DONT NEED TO MAKE THE STUBS AND
9ES YES 9OU OBVIOUSLY UNDERSTAND THAT SKELETONS 7ITH PLAIN OLD 2-) YOU USE THE 2-)
hNETWORK TRANSPARENCYv IS NOT ONLY A MYTH ITS A BAD COMPILER RMIC TO GENERATE THEM "UT FOR THE OTHER
IDEA /F COURSE THE REMOTE METHOD CALL CAN FAIL IN TWO QUESTIONS WELL LET YOU THINK ABOUT IT FOR A
WAYS A LOCAL METHOD CALL WOULD NOT AND THE CLIENT MINUTE BEFORE WE LOOK AT THE DETAILS
NEEDS TO BE PREPARED FOR THAT
4HATS WHY IN *AVA 2-) ALL REMOTE METHODS MUST
DECLARE A JAVARMI2EMOTE%XCEPTION WHICH IS A
CHECKED EXCEPTION 4HAT MEANS THE CLIENT HAS TO
HANDLE OR DECLARE THE EXCEPTION )N OTHER WORDS YiX`e
THE CLIENT CANT REALLY PRETEND THE METHOD CALL ISNT
REMOTE
gfn\i
"UT WAIT THERES MORETHE CLIENT HAS TO DO
SOMETHING SPECIAL TO EVEN GET THE REFERENCE TO THE
,Q-DYDZKDW¶VWKHEHVWZD\WRWHOOWKHFOLHQW
2EMOTE OBJECT IN THE FIRST PLACE !ND WHAT EXACTLY IS
THAT REFERENCE )TS REALLY A REFERENCE TO THE 2EMOTE ZKDWPHWKRGVVKHFDQFDOO",QRWKHUZRUGV
OBJECTS PROXYTHE STUB KRZGR\RXH[SRVH\RXUSXEOLFPHWKRGVWR
RWKHUV"
3O NO 2-) DOES NOT GIVE YOU TRUE NETWORK
TRANSPARENCY 4HE DESIGNERS OF 2-) WANT THE CLIENT
TO ACKNOWLEDGE THAT THINGS CAN GO HORRIBLY WRONG
WITH A REMOTE METHOD INVOCATION
7KLQNDERXWWKHUHODWLRQVKLSEHWZHHQWKH
3TILL WHEN YOU LOOK AT EVERYTHING THAT NEEDS TO
VWXEDQGWKHDFWXDO5HPRWHREMHFW:KDW
HAPPEN TO MAKE A REMOTE METHOD CALL NETWORKING
3OCKET CONNECTION STREAMS PACKAGING UP PXVWWKH\ERWKKDYHLQFRPPRQ"
ARGUMENTS ETC THE CLIENT HAS TO DO ONLY A COUPLE
OF THINGS USE A SPECIAL LOOKUP PROCESS TO GET THE
REFERENCE TO THE REMOTE OBJECT AND WRAP REMOTE
METHOD CALLS IN A TRYCATCH 4HATS PRETTY TRIVIAL
:H·OOVHHWKHDQVZHUVHYHUDOSDJHVIURPQRZ
WHEN YOU CONSIDER WHAT IT WOULD TAKE IF THE CLIENT
HAD TO MANAGE THE WHOLE PROCESS
!ND THERES EVEN A WAY TO MAKE IT EASIER FOR THE
CLIENT USING AN %*" DESIGN PATTERN WELL SEE IN THE
LAST CHAPTER
&KDSWHU
DUFKLWHFWXUDORYHUYLHZ
?PI\IJW]\IZO]UMV\[IVLZM\]ZV^IT]M['
7KHVWXEDQGVNHOHWRQ
2EMOTE METHOD CALLS ARE JUST LIKE LOCAL METHOD CALLS EXCEPT FOR THE DUHLQLWIRUWKHZKROH
2EMOTE%XCEPTIONS !ND WHAT GOOD WOULD A METHOD CALL BE IF YOU URXQGWULS7KH\·UHERWK
COULDNT PASS ARGUMENTS OR GET A RETURN VALUE 9OU MIGHT AS WELL BE UHVSRQVLEOHIRUSDFNLQJ
DOING 20#
THE WAY YOUR PARENTS DID DQGXQSDFNLQJWKHYDOXHV
4HIS BRINGS US TO ONE OF THE KEY JOBS FOR THE STUB AND THE SKELETON OR VKLSSHGRYHUWKHZLUH
WHATEVER IS DOING THE SKELETONISH THINGS PACKING AND UNPACKING %XWLWZRQ·WZRUNLIWKH
VALUES SHIPPED OVER THE WIRE DUJXPHQWVDQGUHWXUQ
2EMEMBER THE CLIENT IS REALLY CALLING A METHOD ON THE STUB AND THE YDOXHVDUHQ·WVKLSSDEOH
STUB IS LOCAL TO THE CLIENT IE IN THE SAME HEAP 3O FROM THE CLIENTS
PERSPECTIVE THERES NOTHING SPECIAL ABOUT SENDING ARGUMENTS WITH 6KLSSDEOHYDOXHVPXVWEH
THE METHOD )TS THE STUB THAT DOES ALL THE DIRTY WORK 4HE STUB HAS TO RQHRIWKHVH
PACKAGE UP THE ARGUMENTS THROUGH A PROCESS KNOWN AS MARSHALLING
AND SEND THEM IN THE OUTPUT STREAM THROUGH THE 3OCKET CONNECTION 5 3ULPLWLYHV
WITH THE SERVER
4HE SKELETON
THING ON THE SERVER HAS TO PROCESS THE STREAM FROM THE 5 6HULDOL]DEOHREMHFWV
STUB UNPACK THE ARGUMENTS lGURE OUT WHAT TO DO WITH EVERYTHING FOR
INSTANCE WHICH METHOD TO CALL ON WHICH OBJECT AND THEN INVOKE THE 5 $QDUUD\RUFROOHFWLRQ
METHOD A LOCAL CALL ON THE 2EMOTE OBJECT WITH THE ARGUMENTS RISULPLWLYHVRU
6HULDOL]DEOHREMHFWV
4HEN IT ALL HAPPENS IN REVERSE 4HE SKELETON PACKAGES UP THE RETURN
VALUES AND SHIPS THEM TO THE STUB WHO UNPACKS THEM AND GIVES THEM
TO THE CLIENT AS PLAIN OLD GARDEN
VARIETY RETURN VALUES "UT IN ORDER TO
5 $5HPRWHREMHFW
SEND ARGUMENTS AND RETURN VALUES THEY MUST BE PRIMITIVES 3ERIALIZABLE
OBJECTS AN ARRAY OR COLLECTION OF PRIMITIVES OR 3ERIALIZABLE OBJECTS OR A
2EMOTE OBJECT
JHW1DPH
1DPH JHW1DPH
&OLHQW JHW
6HUYHU
´-RQµ
´-RQµ VNHOHWRQ
´-RQµ VWXE 5HPRWHREMHFW
FOLHQW
e argument and The skeleton (or whatever is doing the skeleton
The stub packages upththod call information, behavior on the server) unpacks the method
sends it with the meturn value for the client. arguments for the Remote object method call, then
then unpacks the re packs and ships the return value.
53&VWDQGVIRU5HPRWH3URFHGXUH&DOO%RULQJ
\RXDUHKHUH
SDVVLQJREMHFWVUHPRWHO\
:DLW DPLQXWH-DYD
SDVVHVREMHFWVE\SDVVLQJ
DFRS\RIWKHREMHFWUHIHUHQFH
QRWWKHREMHFWLWVHOI6RKRZFDQ
7+$7HYHUZRUNZLWKDUHPRWH
PHWKRGFDOO"7KDWUHIHUHQFH
ZRXOGQ·WPHDQDQ\WKLQJRQ
WKHRWKHUKHDS
,QRUGLQDU\ORFDOPHWKRGFDOOV-DYD
SDVVHVDQREMHFWUHIHUHQFHE\YDOXH
,QRWKHUZRUGVE\FRS\LQJWKHELWVLQ
WKHUHIHUHQFHYDULDEOH
7KHREMHFWLWVHOILVQHYHUSDVVHG
WeÕll think of
remote controla local Java reference as a 'RJ
Something we cato an object on the heap. REMHFW
call methods) on n use to push buttons (i.e.
the object. ^a\g
'RJ
ng here??
What are we really passi
YRLGJR ^
'RJ¿GR QHZ'RJ
WKLVWUDLQ3HW ¿GR
`
A copy of the reference (the remote control),
not the Dog object
'RJ
YRLGWUDLQ3HW 'RJDUJ ^` REMHFW
Yj_
:HNQRZ\RXNQRZDOOWKLV
REYLRXVO\EXWMXVWVR¶ZH·UHDOO ter and the
Now the ÒargÓ parame
^a\g
tical copies. Both
RQWKHVDPHSDJH· ZKLFKLV 'RJ
DQRGGWKLQJWRVD\VLQFHZH en
ÒÞdoÓ variable are idDog object. 'RJ
FOHDUO\$5(DOORQWKHVDPH
SDJH EXW\RXJHWWKHLGHD
reference the same
&KDSWHU
DUFKLWHFWXUDORYHUYLHZ
?PI\ZMITTaOM\[XI[[ML _PMVaW]
XI[[IVWJRMK\\WIZMUW\MUM\PWL'
'RJ
REMHFW
^a\g
'RJ ,I\RXUUHPRWHPHWKRG
&OLHQW KDVDQDUJXPHQW
,PDJLQHWKLV&/,(17FRGH WKDW·VDQREMHFWW\SH
WU\^
WKHDUJXPHQWLV
NOW what are we SDVVHGDVDIXOOFRS\
'RJ¿GR QHZ'RJ
really passing here?? RIWKHREMHFWLWVHOI
UHPRWH6WXEWUDLQ3HW ¿GR )RUUHPRWHFDOOV
`FDWFK 5HPRWH([FHSWLRQH[ ^ -DYDSDVVHVREMHFWV
H[SULQW6WDFN7UDFH E\REMHFWFRS\QRW
!
`
'RJ
REMHFW
NOT the reference value UHIHUHQFHFRS\
ItÕs a serialized copyctof. $VHULDOL]HGFRS\RI
the actual Dog obje
$QGWKLV5(027(PHWKRG WKHREMHFWLVVKLSSHG
WRWKH5HPRWHREMHFW
YRLGWUDLQ3HW 'RJDUJ ^`
py 6HULDOL]DEOH
The server Dog is a co
of the client Dog.
'RJ 'RJ
REMHFW REMHFW 'RJ
^a\g Yj_
'RJ 'RJ
'RJLPSOHPHQWV
&OLHQW 6HUYHU 6HULDOL]DEOH
\RXDUHKHUH
UHPRWHPHWKRGDUJXPHQWV
*HWWLQJWKHREMHFWDUJXPHQWIURP
WKHFOLHQWWRWKHVHUYHU
&OLHQWLQYRNHVWUDLQ3HW P\'RJ RQWKH
VWXESDVVLQJDFRS\RIWKHUHIHUHQFHWR
WKH'RJREMHFW
Client passes a co
of a reference to py
the Dog object on
'RJ the heap. ThereÕs
only one Dog object.
3H 5HPRWH
WUDLQ W P\'RJ VNHO
REMHFW
FOLHQW
VWXE
7KHVWXEPDNHVDVHULDOL]HGFRS\RI
WKHREMHFWDQGVHQGVWKDWFRS\RYHU
WKHZLUHWRWKHVNHOHWRQ
a serialized
The stub sendDs og.
copy of the
'RJ
'RJ
VNHO 5HPRWH
REMHFW
FOLHQW
VWXE
&KDSWHU
DUFKLWHFWXUDORYHUYLHZ
8QSDFNLQJ GHVHULDOL]LQJ WKH
REMHFWRQWKHVHUYHU
7KHVNHOHWRQGHVHULDOL]HVWKHSDVVHG
DUJXPHQWFUHDWLQJDQHZ'RJREMHFWLQWKH
5HPRWHREMHFW·VKHDS
'RJ
VNHO 5HPRWH
REMHFW
FOLHQW
VWXE 'RJ
The new D
one on the ocgli is just like the
ent side.
7KHVNHOHWRQLQYRNHVWKHPHWKRGRQ
WKH5HPRWHREMHFWSDVVLQJDSODLQROG
-DYDUHIHUHQFHWRWKHQHZ'RJREMHFW
'RJ
VNHO 5HPRWH
WUD
LQ3HW QHZ'RJ REMHFW
FOLHQW
VWXE 'RJ
mote object gets
By the time the Reion the Dog is
the method invocat on, the heap.
just another object
\RXDUHKHUH
UHPRWHPHWKRGDUJXPHQWV
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: )M SITTING HERE WITH A (ASH-AP FULL OF Q: )F SOMETHING YOURE PASSING TO A REMOTE
3ERIALIZABLE #USTOMER OBJECTS WITH 3TRING KEYS METHOD ISNT 3ERIALIZABLE IS THIS A COMPILE
TIME OR
$O ) HAVE TO WORRY ABOUT WHETHER THE (ASH-AP RUNTIME FAILURE
ITSELF IS 3ERIALIZABLE
A: A: 2UNTIME 5SUALLY ANYWAY 2EMEMBER THAT THE
/+ THIS IS KIND OF A TRICKY ONE !LL OF THE DECLARED ARGUMENT OR RETURN TYPE IS NOT NECESSARILY
#OLLECTION IMPLEMENTATIONS IN THE *3% !0) ARE THE SAME AS THE ACTUAL RUNTIME TYPE
3ERIALIZABLE 3O YOU DONT HAVE TO WORRY ABOUT A 4HE ONLY CASE WHERE IT CAN FAIL AT COMPILE TIME IS IF
(ASHMAPAS LONG AS WHAT YOU PUT IN THE (ASHMAP THE REMOTE METHOD ACTUALLY USES 3ERIALIZABLE AS THE
IS 3ERIALIZABLE YOURE FINE DECLARED TYPE OF THE ARGUMENT OR RETURN VALUE
"UT THERE IS ONE PLACE WHERE THINGS CAN FAIL SXEOLFYRLGWDNH,W 6HULDOL]DEOHV
#HANCES ARE YOULL NEVER SEE THIS BUT ITS STILL WORTH
MENTIONING 9OU PROBABLY ALREADY KNOW THAT THE )N THAT CIRCUMSTANCE THE COMPILER CAN USE NORMAL
-AP CLASSES LIKE (ASH-AP AND (ASHTABLE HAVE A *AVA TYPE
CHECKING TO SEE IF THE DECLARED TYPE OF THE
VALUES METHOD THAT RETURNS A COLLECTION OF JUST THING BEING PASSED IMPLEMENTS 3ERIALIZABLE
THE VALUES WITHOUT THE KEYS )N OTHER WORDS IF YOU -OST OF THE TIME THE DECLARED ARGUMENT OR RETURN
CALLED IT ON YOUR (ASH-AP YOUD GET A #OLLECTION OF TYPE IS SOMETHING OTHER THAN 3ERIALIZABLE LIKE $OG
#USTOMER OBJECTS !RRAY,IST 3TRING ETC SO *AVA WONT KNOW WHETHER THE
"UT WHAT TYPE OF COLLECTION !ND THERES THE RUNTIME OBJECT IS 3ERIALIZABLE UNTIL IT ACTUALLY TRIES TO
PROBLEM 9OU DONT KNOW !LL YOU KNOW IS THAT DO THE SERIALIZATION AND THEN IT THROWS AN EXCEPTION
ITS SOMETHING THAT IMPLEMENTS THE #OLLECTION !ND WITH COLLECTIONS AND ARRAYS IF ANY OF THE OBJECTS
INTERFACE "UT THAT ISNT ENOUGH TO TELL YOU WHETHER INSIDE ARENT 3ERIALIZABLE THE WHOLE SERIALIZATION FAILS
THE #OLLECTION RETURNED BY VALUES IS 3ERIALIZABLE
)N OTHER WORDS YOU MIGHT GET BACK A #OLLECTION
THATEVEN WHEN FILLED WITH 3ERIALIZABLE OBJECTSIS
NOT ITSELF 3ERIALIZABLE Q: $OES MY CLASS HAVE TO EXPLICITLY IMPLEMENT
3ERIALIZABLE OR CAN ) INHERIT 3ERIALIZABLENESS FROM MY
4HE BOTTOM LINE DONT RELY ON THE #OLLECTION
SUPERCLASS
RETURNED FROM A MAPS VALUES METHOD TO BE
3ERIALIZABLE 0UT YOUR VALUES INTO SOMETHING YOU CAN
TRUST TO BE 3ERIALIZABLE LIKE !RRAY,IST BEFORE TRYING
TO SHIP THEM AS PART OF A REMOTE METHOD CALL
A: 2EMEMBER *AVAS )3
! RULE IF YOUR PARENT
SUPERCLASS IS SOMETHING THEN SO ARE YOU )F $OG
EXTENDS !NIMAL AND !NIMAL IMPLEMENTS 3ERIALIZABLE
THEN $OG IS 3ERIALIZABLE WHETHER THE $OG CLASS
EXPLICITLY DECLARES IT OR NOT
(OWEVER IT IS CONSIDERED GOOD PRACTICE TO EXPLICITLY
DECLARE YOUR CLASS AS 3ERIALIZABLE EVEN IF YOUR SUPERCLASS
DOES JUST SO THAT OTHERS LOOKING AT YOUR CLASS !0) DONT
HAVE TO HUNT THROUGH YOUR CLASS INHERITANCE TREE TO SEE
IF SOMEBODY UP THERE IS 3ERIALIZABLE
&KDSWHU
DUFKLWHFWXUDORYHUYLHZ
5HPHPEHUDUJXPHQWVDQG
UHWXUQYDOXHVIRUDUHPRWH
PHWKRGPXVWEHRQHRIWKHVH
5 3ULPLWLYHV ,GRQ·WJHWZK\LW·VOHJDO
WRSDVVD5HPRWHREMHFWLQD
UHPRWHPHWKRG,VQ·WWKHZKROH
5 6HULDOL]DEOHREMHFWV SRLQWRID5HPRWHREMHFWWRVWD\
UHPRWH":K\ZRXOG\RXVHQGD
5 $QDUUD\RUFROOHFWLRQRISULPLWLYHV 5HPRWHREMHFWWRWKHFOLHQW""
RU6HULDOL]DEOHREMHFWV 7KDWPDNHVQRVHQVH
5 $5HPRWHREMHFW
ItÕll make sense in a minute.
But before you turn the
page, think about the
implications of passing a
Remote object through a
remote method call...
\RXDUHKHUH
UHPRWHPHWKRGDUJXPHQWV
8I[[QVOI:MUW\MWJRMK\\PZW]OPI
ZMUW\MUM\PWLKITT
:KHQ\RXSDVVD5HPRWH
)T DOES NOT MAKE SENSE TO SEND A 2EMOTE OBJECT IN A
REMOTE METHOD CALL !FTER ALL THE WHOLE POINT OF A REMHFWWRRUIURPDUHPRWH
2EMOTE OBJECT IS TO STAY REMOTE 4O BE ACCESSED BY
CLIENTS WHO LIVE SOMEWHERE ELSE )N ANOTHER HEAP
PHWKRG-DYDDFWXDOO\VHQGV
"UT WHAT IF YOU WANT TO PASS A REMOTE CLIENT A WKH5HPRWHREMHFW·VVWXE
REFERENCE TO ANOTHER 2EMOTE OBJECT 7HAT IF
RATHER THAN HANDING YOUR CLIENT A FULL
BLOWN COPY ,QRWKHUZRUGVDWUXQWLPH
OF A #USTOMER YOU SEND HIM A STUB TO A 2EMOTE
#USTOMER WKH5HPRWHREMHFWVWD\VULJKW
4HINK ABOUT IT "EFORE YOU READ THE NEXT PAGE ZKHUHLWLVDQGLWVVWXELV
VHQWRYHUWKHZLUHLQVWHDG
YiX`e
gfn\i A remote re
remote obje ference is a stub to a
:KDWDUHWKHLPSOLFDWLRQVRISDVVLQJDVWXEWRD a remote re ct. If the client has
5HPRWH&XVWRPHUREMHFWDVRSSRVHGWRSDVVLQJD reference toference, he has a local
QRQUHPRWH&XVWRPHUREMHFW"
talk to the a stub, and the stub
Remote obje can
ct.
:KDWDUHWKHEHQH¿WVRISDVVLQJDVWXELQVWHDGRI
WKHUHDO&XVWRPHUREMHFW" FOLHQW VHUYHU
)RR 5HPRWH
VWXE )RR
:KDWDUHWKHGUDZEDFNV" REMHFW
^gg^
stub to a
)RR Remote object
nce
local refere
1RWH ZKHWKHUWRSDVVVHULDOL]HGREMHFWVRUVWXEV
WRUHPRWHREMHFWVLVDFUXFLDOGHVLJQGHFLVLRQ:H¶OO
to a stub
H[SORUHWKLVZKHQZHORRNDWSHUIRUPDQFHDQG
SDWWHUQV
&KDSWHU
DUFKLWHFWXUDORYHUYLHZ
:KHQWKHUHWXUQYDOXHLVD
5HPRWHREMHFW
7KHFOLHQWLQYRNHVJHW&XVWRPHU RQ5HPRWH
REMHFW$ XVLQJVWXE$
JHW&XVWRPHU
JHW&XVWRPHU
JHW&XVWRPHU 5HPRWH
VNHO
FOLHQW REMHFW$
VWXE$
5HPRWH
REMHFW%
&XVWRPHU
5HPRWHREMHFW$UHWXUQVDUHIHUHQFHWRD
&XVWRPHUREMHFW 5HPRWHREMHFW% 7KHVNHOHWRQ turns
VXEVWLWXWHV DQGVHULDOL]HV WKH5HPRWHREMHFW·V
he R em ot e ob je ct (A) simply mreer
T to the Custo
a local referencee object B), but itÕs
VWXEDQGVHQGVLWEDFNWRWKHFOLHQW
7KH&XVWRPHUVWXE % LVGHVHULDOL]HGRQWKH object (Remot ub that gets sent back.
FOLHQWDQGWKHFOLHQWJHWVDORFDOUHIHUHQFHWRWKH actually the st
QHZVWXEREMHFW
VNHO 5HPRWH
REMHFW$
FOLHQW VWXE$
5HPRWH
ORFDOUHIHUHQFH 5HPRWH REMHFW%
VWXE%
WRVWXE% VWXE%
Serialized stub &XVWRPHU
B (the Customerto Remote object
a local object).
Now the client gets backme r stub
reference to the Cu sto
object (B).
\RXDUHKHUH
50,TXHVWLRQV
WKHUH DUH QR
'XPE 4XHVWLRQV
:MDD=LHGAFLK
Q: 7HAT HAPPENS IF THE CLIENT OBJECT AND THE
2EMOTE OBJECT ARE RUNNING IN DIFFERENT *6-S BUT (-%XVHV-DYD50, 5HPRWH0HWKRG,QYRFDWLRQ VR
ON THE SAME PHYSICAL MACHINE )N OTHER WORDS WKDW\RXUEHDQVFDQEHDFFHVVHGE\UHPRWHFOLHQWV
THEYRE BOTH RUNNING IN *AVA PROGRAMS ON THE SAME
SERVER $UHPRWHFOLHQWLQWKLVFRQWH[WLVDQREMHFWUXQQLQJLQ
DGLIIHUHQW-90ZKLFKDOVRPHDQVDGLIIHUHQWKHDS
A: $OESNT MAKE ANY DIFFERENCE !LL THAT MATTERS $5HPRWHREMHFWVWD\VLQLWVRZQKHDSZKLOHFOLHQWV
LQYRNHPHWKRGVRQWKH5HPRWHREMHFW·VSUR[\FDOOHG
IS WHETHER THE TWO OBJECTS LIVE IN DIFFERENT HEAPS
AND *6-S DO NOT SHARE HEAPS WITH ONE ANOTHER THANK DVWXE
YOU VERY MUCH NO MATTER HOW INTIMATE THEY ARE
COHABITING THE SAME SERVER 7KHVWXEREMHFWKDQGOHVDOOWKHORZOHYHOQHWZRUNLQJ
GHWDLOVLQFRPPXQLFDWLQJZLWKWKH5HPRWHREMHFW
)N FACT YOU CAN AND WITH %*" OFTEN MUST USE 2-)
EVEN WHEN THE OBJECTS ARE IN THE SAME HEAP :KHQWKHFOLHQWZDQWVWRFDOODPHWKRGRQD5HPRWH
REMHFWWKHFOLHQWFDOOVWKHVDPHPHWKRGRQWKHVWXE
Q: 7HY IN THE WORLD WOULD YOU EVER WANT TO DO
7KHVWXEOLYHVLQWKHVDPHKHDSDVWKHFOLHQW
USE 2-) IF YOU DONT NEED TO )SNT THERE ENOUGH 7RWKHFOLHQWDUHPRWHPHWKRGFDOOLVLGHQWLFDOWRD
OVERHEAD WITH REMOTE CALLS AS IT IS ORFDOPHWKRGFDOOH[FHSWDUHPRWHPHWKRGFDQWKURZ
D5HPRWH([FHSWLRQ DFKHFNHGH[FHSWLRQ
A: 7ELL GO INTO THIS IN MORE DETAIL LATER BUT 7KHVWXESDFNDJHVXSWKHPHWKRGDUJXPHQWVDQG
THE MAIN REASON IS BECAUSE IF YOU DONT USE 2-) FOR VHQGVLQIRUPDWLRQDERXWWKHFDOOWRDVNHOHWRQRQ
METHOD CALLS YOURE LOCKING DOWN YOUR DESIGN IN WKHVHUYHU7KHVNHOHWRQREMHFWLWVHOILVRSWLRQDOEXW
SUCH A WAY THAT YOU CANT DISTRIBUTE YOUR OBJECTS IN WKHVNHOHWRQ·VZRUNPXVWEHGRQHE\VRPHWKLQJRQ
DIFFERENT PLACES IN YOUR NETWORK OR EVEN ON THE SAME
WKHVHUYHU:HGRQ·WKDYHWRFDUHZKR³RUZKDW³LV
SERVER )N OTHER WORDS WITHOUT 2-) YOU MUST HAVE
BOTH OBJECTS IN THE SAME HEAP
DFWXDOO\GRLQJWKHVNHOHWRQ·VZRUN
&OR A DISTRIBUTED PROGRAMMING MODEL THATS A PRETTY $UJXPHQWVDQGUHWXUQYDOXHVPXVWEHRQHRIWKH
PERMANENT DECISION WITH NO CHANCE TO CHANGE YOUR IROORZLQJ DSULPLWLYHD6HULDOL]DEOHREMHFWDQDUUD\
MIND LATER WITHOUT REWRITING CODE /N THE OTHER RUFROOHFWLRQRISULPLWLYHVRU6HULDOL]DEOHREMHFWVRUD
HAND IF YOU DO USE 2-) YOU CAN DECIDE LATER TO SPLIT 5HPRWHREMHFW,IWKHYDOXHLVQ·WRQHRIWKHVH\RX·OO
YOUR PROGRAM UP INTO DIFFERENT NODES ON YOUR SYSTEM JHWDUXQWLPHH[FHSWLRQ
WITH LITTLE OR USUALLY NO CODE CHANGES
3O THE TRADEOFF IS FLEXIBILITY FOR PERFORMANCE BUT FOR ,IDQREMHFWLVSDVVHGDVDQDUJXPHQWRUUHWXUQ
MOST DISTRIBUTED ENTERPRISE APPS THE OVERHEAD OF A YDOXHWKHREMHFWLVVHQWDVDVHULDOL]HGFRS\WKHQ
REMOTE CALL IS NOT YOUR BIGGEST PROBLEM )TS USUALLY GHVHULDOL]HGRQWKH5HPRWHREMHFW·VORFDOKHDS
YOUR BANDWIDTH ANDOR CONCURRENCY THAT HURTS THE
MOST /VERALL YOU PROBABLY HAVE BIGGER PERFORMANCE ,ID5HPRWHREMHFWLVSDVVHGDVDQDUJXPHQWRUUHWXUQ
FISH TO FRY IN AREAS OTHER THAN WHETHER YOUR CALLS ARE YDOXHWKHREMHFW·VVWXELVVHQWLQVWHDG
REMOTE OR LOCAL "UT THE STORY ISNT ALWAYS THAT SIMPLE
SO WELL EXPLORE THIS AGAIN LATER IN THE BOOK
&KDSWHU
DUFKLWHFWXUDORYHUYLHZ
2KP\,DOPRVWIRUJRWWKH
PRVWLPSRUWDQWWKLQJDERXWUHPRWH
PHWKRGFDOOV:KHQ\RXSDVVDVHULDOL]HG
REMHFWDVDQDUJXPHQWRUUHWXUQYDOXH\RX
EHWWHUPDNHVXUHWKHFODVVÀOHIRUWKHW\SH
\RX·UHSDVVLQJLVDYDLODEOHRQWKHRWKHU
VLGH,IWKHFODVVLVQ·WWKHUHWKHREMHFW
ZLOOQHYHUGHVHULDOL]HDQG
\RX·UHVFUHZHG
7KDWLQFOXGHVWKHVWXE
FODVVHV,IWKHFOLHQW
GRHVQ·WKDYHWKHFODVVIRU
WKHVWXEREMHFWLW·V
KRSHOHVV
\RXDUHKHUH
5HPRWHLQWHUIDFH
?PI\U][\\PM:MUW\MWJRMK\
IVL\PM[\]JPI^MQVKWUUWV'
(OW DOES THE CLIENT KNOW WHICH METHODS TO CALL ,WDOOEHJLQVZLWKD5HPRWH
(OW DOES THE STUB KNOW WHICH METHODS THE
2EMOTE OBJECT HAS
LQWHUIDFH%RWKWKH5HPRWH
2EMEMBER IF THE STUB IS PRETENDING TO BE THE REMHFWDQGWKHVWXELPSOHPHQW
2EMOTE OBJECT THE STUB MUST HAVE THE SAME
METHODS AS THE 2EMOTE OBJECT
WKHVDPHLQWHUIDFHWKHRQH
/F COURSE YOU KNOW THE ANSWER TO THIS ZLWKWKHPHWKRGVWKHFOLHQW
!N INTERFACE ZDQWVWRFDOO
4HE WAY ALL METHODS IN A DISTRIBUTED ENVIRONMENT
SHOULD BE EXPOSED TO A CLIENT $5HPRWHLQWHUIDFHPXVW
7E CALL THIS THE BUSINESS INTERFACE BECAUSE IT HAS
THE BUSINESS METHODS THE CLIENT WANTS TO CALL H[WHQGMDYDUPL5HPRWHDQG
4ECHNICALLY THE BUSINESS INTERFACE FOR A 2EMOTE
OBJECT MUST BE SURPRISINGLY A 2EMOTE INTERFACE
HYHU\PHWKRGPXVWGHFODUHD
5HPRWH([FHSWLRQ
4O BE 2EMOTE AN INTERFACE MUST FOLLOW THREE
RULES
5 LWPXVWH[WHQGMDYDUPL5HPRWH
5 HDFKPHWKRGPXVWGHFODUHD
MDYDUPL5HPRWH([FHSWLRQ
5 DUJXPHQWVDQGUHWXUQW\SHVPXVWEH
VKLSSDEOH 6HULDOL]DEOHSULPLWLYHHWF
mote
RemoteException and.rmRei package emote
LPSRUWMDYDUPL
interface are in java te rface M U ST extend java.rmi.R
A Remote in .
SXEOLFLQWHUIDFH'LFH5ROOHUH[WHQGV5HPRWH^ (which doesnÕt
have any methods)
All of your methods must declare
SXEOLFLQWUROO'LFH WKURZV5HPRWH([FHSWLRQ
`
a RemoteException.
&KDSWHU
DUFKLWHFWXUDORYHUYLHZ
<PMKTQMV\KITT[J][QVM[[UM\PWL[
WV\PM[\]J\PZW]OP\PM:MUW\M
J][QVM[[QV\MZNIKM LQWHUIDFH!!
5HPRWH
2EMEMBER AS FAR AS THE CLIENTS CONCERNED HES CALLING
METHODS ON 4HE 2EAL 4HING 4HE ACTUAL 2EMOTE OBJECT 4HE
THING THAT HAS THE METHODS HE WANTS TO CALL
4HE ONLY THING REMINDING THE CLIENT THAT HE ISNT
CALLING METHODS DIRECTLY ON THE 2EMOTE OBJECT IS THE LQWHUIDFH!!
2EMOTE%XCEPTIONS HE HAS TO DEAL WITH 'LFH5ROOHU the Remote rface
UROO'LFH
(business) inte
'LFH5ROOHU6WXE 'LFH5ROOHU,PSO
the stub class te
UROO'LFH UROO'LFH the Remcolass
obje c t
ice R o ll e r Im p l (the Remote
Both the D the actual dice rolling ub
object with y) and the DiceRoller stterface.
functionalit he Remote DiceRoller in
&OLHQWKHDS implement t
6HUYHUKHDS
'LFH5ROOHU
'LFH5ROOHU
O
'L 'L
PS
XE
FH5 FH5
ROOHUVW ROOHU,
FOLHQW
From this
mote business to show a skpoeint forward, weÕre not
The client uses the Re s on the stub. about is that leton object. All we ca going
interface to call methmoodte object both is handling th SOMETHING on the re
The stub and the Rete interface. e skeleton fu se
nctionality. rver
implement the Remo
\RXDUHKHUH
(-%DUFKLWHFWXUH
6KDUSHQ \RXU SHQFLO
This sharpen gets you on the one most common
mistake EJB developers make. So donÕt skip it!
%DVHGRQWKLVVFHQDULRGUDZWKHFODVVHVEHORZLQWRWKH
DSSURSULDWHVORWIRUZKHWKHUWKH\PXVWEHRQWKHFOLHQWVHUYHURU
ERWK \RXFDQUHXVHDFODVV 7KHSLFWXUHLVVLPSOL¿HGVR\RX
DUHQ¶WVHHLQJDOORIWKHSOD\HUVLQYROYHG
'RJ
'RJ
5HPRWH
3H
WUDLQ W P\'RJ 'RJ7UDLQHU
FOLHQW
VWXE
'RJ7UDLQHU,PSO
'RJ7UDLQHU6WXE
'RJ7UDLQHU FOLHQWFODVV
LQWHUIDFH 'RJ
&KDSWHU
DUFKLWHFWXUDORYHUYLHZ
0W_-2*][M[:51
)N %*" A CLIENTS ENTRY POINT INTO THE 3O 2-) LIES AT THE HEART OF MOST CLIENT
TO
ENTERPRISE APPLICATION IS NEARLY ALWAYS BEAN COMMUNICATION "UT AS YOU SAW A HINT
THROUGH A REFERENCE STUB TO A 2EMOTE OF IN THE lRST CHAPTER THE %*" ARCHITECTURE
OBJECT 9ES IT IS POSSIBLE AND SOMETIMES IS A LITTLE MORE COMPLEX THAN A SIMPLE
NECESSARY TO USE A LOCAL CLIENT IE A CLIENT
TO
STUB
TO
2EMOTE
OBJECT SCENARIO
CLIENT IN THE SAME HEAP AS THE BEAN AND )N %*" THE BEANTHE THING ON WHICH THE
WHICH DOESNT USE 2-) TO INVOKE BUSINESS CLIENT WANTS TO CALL BUSINESS METHODSIS
METHODS BUT THIS IS FOR ONLY A FEW VERY NOT 2EMOTE
SPECIAL CASES
3ODLQ50, Business logic
lives here!
VHUYHU
&OLHQW
EL]LQWHUIDFH
EL]LQWHUIDFH
5HPRWH
VWXE REMHFW
FOLHQW
KHDS '%
50,LQ(-% Business logic
lives here!
VHUYHU
&OLHQW
EL]LQWHUIDFH
VHUYLFHV
EL]LQWHUIDFH
5HPRWH
VWXE REMHFW
DQ
FOLHQW (-% W (Q
WHUS VHEH
2EM H F UL
KHDS '%
\RXDUHKHUH
(-%REMHFW
<PM:MUW\MWJRMK\Q[VW\\PMJMIVQ\¼[
\PMJMIV¼[JWLaO]IZL ¸ \PM-2*7JRMK\
%RWKWKH5HPRWHREMHFW
)N %*" REMEMBER THE 2EMOTE OBJECT %*"/BJECT IS THE
BEANS BODYGUARD 4HE BEAN SITS BACK PROTECTED FROM ALL
DQGWKHVWXELPSOHPHQWWKH
CLIENT INVOCATIONS WHILE THE %*"/BJECT IMPLEMENTS THE VDPHLQWHUIDFH³WKHEXVLQHVV
2EMOTE INTERFACE AND TAKES THE REMOTE CALLS /NCE THE CALL
GETS TO THE %*"/BJECT THE SERVER JUMPS IN WITH ALL THE SERVICES LQWHUIDFH FDOOHGD&RPSRQHQW
LIKE SECURITY IS THIS CLIENT AUTHORIZED TO CALL THIS METHOD
TRANSACTIONS IS THIS CALL PART OF AN EXISTING TRANSACTION OR LQWHUIDFH ³EXWZLWKRXWWKH
SHOULD WE START ANOTHER TRANSACTION AND PERSISTENCE DOES
THE BEAN NEED TO LOAD INFO FROM THE DATABASE BEFORE RUNNING
UHDOEXVLQHVVORJLFEHKDYLRU
THE CLIENTS METHOD
4HE %*"/BJECT IMPLEMENTS THE 2EMOTE BUSINESS INTERFACE SO 7KHEHDQFODVVGRHV127
THE REMOTE CALLS FROM THE CLIENT COME TO THE %*"/BJECT "UT LPSOHPHQWWKHEXVLQHVV
ITS STILL THE BEAN THAT HAS THE REAL BUSINESS LOGIC EVEN THOUGH
THE BEAN DOESNT IMPLEMENT THE 2EMOTE INTERFACE IN THE LQWHUIDFH LQWKHIRUPDO
TECHNICAL *AVA WAY
-DYDZD\ EXWWKHEHDQ
KDVWKHUHDOEXVLQHVVORJLF
1RERG\WDONVWRWKH IXQFWLRQDOLW\
EHDQZLWKRXWJRLQJ
WKURXJKPHÀUVW
te The bean doesnÕ
t h t h e st ub and the Remino terface, the Remote (bustinactually implement
Bo ent the same it DOES have the ess) interface! (But
object impleomnÕt have the REAL real business logic.)
but they d c implementations.
business logi (-%VHUYHU
&OLHQW
EL]LQWHUIDFH
VHUYLFHV
EL]LQWHUIDFH
5HPRWH
VWXE REMHFW
DQ
FOLHQW (-% W (Q
WHUS VHEH
2EM H F UL
KHDS '%
&KDSWHU
DUFKLWHFWXUDORYHUYLHZ
<PM+WUXWVMV\QV\MZNIKM
)N %*" THE BUSINESS INTERFACE IS CALLED THE COMPONENT
INTERFACE 4HIS IS WHERE YOU EXPOSE YOUR BUSINESS
METHODS TO THE CLIENT 4HE MAIN DIFFERENCE BETWEEN
es
AN 2-) INTERFACE AND A REMOTE COMPONENT INTERFACE LQWHUIDFH!! All Remote interfac
IS THAT WITH %*" YOU EXTEND JAVAXEJB%*"/BJECT 5HPRWH must ex te nd
INSTEAD OF JAVARMI2EMOTE java.rmi.Remote.
.H\SRLQWV
LQWHUIDFH!! In RMI,
$Q\LQWHUIDFHZLWKMDYDUPL5HPRWHLQLWVLQKHULWDQFH (-%2EMHFW java.rmi.Ryeomu extend
WUHHLVD5HPRWHLQWHUIDFH EJB, your inote directly. In
VHYHUDOPHWKRGV javax.ejb terface extend
in turn ex.EtJeBObject, which s
nds Remote.
7KH(-%2EMHFWLQWHUIDFHH[WHQGV5HPRWHVR
(-%2EMHFWLVD5HPRWHLQWHUIDFH
LQWHUIDFH!!
%RRN&DUW Your componentejb.E interface
<RXUUHPRWHFRPSRQHQWLQWHUIDFHPXVWH[WHQGWKH extends ja va x. JBObject.
(-%2EMHFWLQWHUIDFH
DGG%RRN yo u
This is where ods. This pu t your
UHPRYH%RRN
s me th is
busines t us es !
<RXFDQKDYHDORFDOFRPSRQHQWLQWHUIDFHDQGWKH
VKRZ%RRNV,Q&DUW
what the cli en
GR&KHFNRXW
UXOHVDUHGLIIHUHQWEXWZH¶OOORRNDWWKDWLQWKHFKDSWHU
RQ&OLHQW9LHZ
<RXH[SRVH\RXUEXVLQHVVPHWKRGVWRWKHFOLHQW
:KRHYHULPSOHPHQWVWKH%RRN&DUW
WKURXJKWKHFRPSRQHQWLQWHUIDFH
LQWHUIDFHPXVWLPSOHPHQWDOOWKHPHWKRGV
IURPERWK%RRN&DUWDQG(-%2EMHFW7KH
(-%2EMHFWLQWHUIDFHDGGVWKHPHWKRGV
7KH(-%2EMHFWLQWHUIDFHDGGVDGGLWLRQDOPHWKRGVIRU WKDWDOO(-%FOLHQWVPLJKWQHHG
WKHFOLHQWWRXVH :H¶OOVHHWKRVHODWHU
\RXDUHKHUH
WKHEHDQFODVV
+RZWKHEHDQFODVVÀWVLQ
LQWHUIDFH!! LQWHUIDFH!!
-6($3, 5HPRWH -(($3, (QWHUSULVH%HDQ
QRPHWKRGV QRPHWKRGV
LQWHUIDFH!! LQWHUIDFH!!
-(($3, -(($3,
(-%2EMHFW 6HVVLRQ%HDQ
VHYHUDOPHWKRGV VHYHUDOPHWKRGV
LQWHUIDFH!! %RRN&DUW%HDQ
<28ZULWHWKLV <28ZULWHWKLV
%RRN&DUW
LQWHUIDFH FODVV
DGG%RRN DGG%RRN
WKHUHPRWH UHPRYH%RRN UHPRYH%RRN
WKHEHDQFODVV
FRPSRQHQW VKRZ%RRNV,Q&DUW VKRZ%RRNV,Q&DUW
LQWHUIDFH GR&KHFNRXW GR&KHFNRXW
RWKHUPHWKRGV
<RX5($//<
KDYHWRNQRZ
ookCCartBean
ookCart interfdoacese! not implement the
WKHLQWHUIDFHV
ut it sure looks lik
7KHH[DPH[SHFWV\RXWRN
QRZ e it does...)
HD FK PH WKR GOL YHV
H[DFWO\ZKHUH
QH HGWRN QRZ ZK LFK PH WKRGV
<RX
DUHLQ(-%2EMHFWDQGZK
LFKDUH
The bean developer must make sure that h the
LQ6HVVLRQ %HD QIRUH [DP SOH
the bean class has methods that matcexac tly
$QG \RXK DYH WRNQR ZWKH H[DFW
methods in the comp onen t inte rface,
VLJQDWXUHIRUWKRVH PH WKR GV
as if the bean class DID imple ment the
VH LQWH UIDF HV LQ
:H¶OOJHWL
[WF
QWR
RXS
WKH
OHR IFK DSW HUV DQG component interface.
WKH QH
ZKHQZHGRSD\DWWHQWLRQ
&KDSWHU
DUFKLWHFWXUDORYHUYLHZ
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: ) JUST WANT TO BE SURE )M CLEAR ABOUT THIS Q: 7HY DOESNT THE BEAN IMPLEMENT THE
INTERFACES CAN %84%.$ OTHER INTERFACES 2EMOTEBUSINESS INTERFACE )SNT THE WHOLE
POINT OF AN INTERFACE IMPLEMENTATION TO USE THE
A: 9ES INTERFACES HAVE THEIR OWN INHERITANCE TREE
COMPILER TO KEEP YOU HONEST AND TO SUPPORT *AVA
TYPE
CHECKING
)N FACT WITH INTERFACES YOU CAN DO SOMETHING YOU
CANT EVER DO WITH A CLASSAN INTERFACE CAN EXTEND
MORE THAN ONE INTERFACE A: 9OU ASKED THIS QUESTION BEFORE "UT HEY
LQWHUIDFH&DUWH[WHQGV(-%2EMHFW&DUW%XVLQHVV WE ALL FORGET THINGS SO WELL REMIND YOU AGAIN 4HE
BEAN DOESNT IMPLEMENT THE 2EMOTE INTERFACE
Q: "UT WHAT DOES THAT REALLY MEAN WHEN AN
BECAUSE THE BEAN IS NEVER SUPPOSED TO BE A
2EMOTE OBJECT IN THE *AVA 2-) SENSE )N OTHER
INTERFACE EXTENDS ANOTHER INTERFACE %XTENDING WORDS YOU NEVER EVER WANT ANYONE TO HAVE A STUB
MEANS INHERITANCE BUT WHAT IS THE INTERFACE TO THE ACTUAL BEAN )F YOU WERE TO SOMEHOW SNEAK
INHERITING A REMOTE REFERENCE IE A STUB OUT TO THE WORLD
YOUD BE DEFEATING THE WHOLE PURPOSE OF %*" )F YOU
A: 7HEN ONE INTERFACE EXTENDS ANOTHER IT
LET A CLIENT TALK DIRECTLY TO THE BEAN THEN THE SERVER
WOULDNT BE ABLE TO APPLY ITS SERVICES AND IF YOU
INHERITS EVERYTHING FROM THAT INTERFACE 7HOEVER DONT NEED THE SERVICES YOU SEE WHERE WERE GOING
IMPLEMENTS AN INTERFACE MUST IMPLEMENT NOT JUST THE HERE
METHODS FROM THAT INTERFACE BUT ALSO THE METHODS
4ECHNICALLY IT IS LEGAL TO HAVE THE BEAN IMPLEMENT
FROM EVERY INTERFACE THAT INTERFACE EXTENDS ALL THE
THE 2EMOTE INTERFACE BUT ITS A REALLY BAD IDEA SINCE
WAY UP THE INTERFACE INHERITANCE TREE
YOU COULD MAKE MISTAKES THAT WOULDNT BE CAUGHT
3O IN THIS EXAMPLE WHOEVER IMPLEMENTS "OOK#ART AT COMPILE TIME BUT WHICH WOULD BLOW UP LATER
MUST ALSO IMPLEMENT THE METHODS OF %*"/BJECT "UT YOU DONT NEED TO DO IT SINCE VIRTUALLY ALL BEAN
DEVELOPMENT TOOLS INCLUDING NEARLY EVERY BEAN
AWARE )$% UNDERSTAND THE RELATIONSHIP BETWEEN
THE BEAN THE %*"/BJECT AND THE 2EMOTE INTERFACE
AND THEY GUARANTEE THAT THE COMPONENT INTERFACE
:KHQ\RXLPSOHPHQW AND THE BEAN CLASS HAVE MATCHING METHODS
DQLQWHUIDFH\RXPXVW
LPSOHPHQWDOOWKH Q: "UT WHAT IF ) JUST lND THIS TOO DISTURBING
4HIS WHOLE IDEA VIOLATES MY *AVA SENSIBILITIES THE
PHWKRGVWKDWLQWHUIDFH VERY PRINCIPLES UPON WHICH ) CODE 3URELY THERE
LQKHULWVIURPLWVVXSHU MUST BE SOMETHING ) CAN DO
LQWHUIDFHV
6RZKRHYHULPSOHPHQWV A: 9OU COULD TRUST US ON THE WHOLE hYOURE
ALMOST CERTAINLY USING TOOLS SO IT REALLY WONT
%RRN&DUWPXVWLPSOHPHQW MATTER 2EALLYv THING BUT NO SO IF YOU INSIST YES
WKHPHWKRGVIURPERWK THERE IS SOMETHING YOU CAN DO THATLL PROBABLY HELP
%RRN&DUWDQG(-%2EMHFW YOU FEEL BETTER )TS ON THE NEXT PAGE BUT YOU CAN
PROBABLY FIGURE IT OUT YOURSELF ANYWAY
.ONETHELESS WERE STICKING BY OUR STORY THAT MOST
DEVELOPERS WONT NEED TO DO THIS
\RXDUHKHUH
LQWHUIDFHLPSOHPHQWDWLRQ
$GHVLJQIRUWKRVHZKRIHHO
VTXHDPLVKWKDWWKHEHDQ
GRHVQ·WLPSOHPHQWWKH
EXVLQHVVPHWKRGLQWHUIDFH
Create an inte
the business metrfhoace that has
not extend EJBObjds, but does
not a remote interfect (so itÕs
LQWHUIDFH!! ace). LQWHUIDFH!!
5HPRWH (QWHUSULVH%HDQ
QRPHWKRGV QRPHWKRGV
LQWHUIDFH!!
%RRN&DUW%XVLQHVV
DGG%RRN
LQWHUIDFH!! UHPRYH%RRN LQWHUIDFH!!
(-%2EMHFW VKRZ%RRNV,Q&DUW 6HVVLRQ%HDQ
VHYHUDOPHWKRGV GR&KHFNRXW VHYHUDOPHWKRGV
LQWHUIDFH!! %RRN&DUW%HDQ
%RRN&DUW
QRPHWKRGV DGG%RRN
UHPRYH%RRN
VKRZ%RRNV,Q&DUW
GR&KHFNRXW
RWKHUPHWKRGV
ace
t h e c o m po nent intebrfject
Now, both the EJBO ss Make the bean class pleme
extends e AND the busine both the SessionBeanimint er
nt
interfac interface. AND the business me od ce fa
method interface. Now, the cothmp
make sure you have the rigiler will
methods in the bean class. ht
&KDSWHU
DUFKLWHFWXUDORYHUYLHZ
6R,ZULWHP\EHDQDQG
,SXWLQPDWFKLQJPHWKRGV
IURPWKHFRPSRQHQWLQWHUIDFH
ZLWKRXWRIÀFLDOO\LPSOHPHQWLQJ
WKHFRPSRQHQWLQWHUIDFH%XWLI,
GRQ·WLPSOHPHQWWKHFRPSRQHQW
LQWHUIDFHZKRGRHV"
?PW_ZQ\M[\PMKTI[[\PI\ZMITTa,7-;
QUXTMUMV\\PMKWUXWVMV\QV\MZNIKM'
1VW\PMZ_WZL[_PWUISM[\PM
-2*7JRMK\KTI[['
4HE CONTAINER 9OU DECLARE THE METHODS BUT THE CONTAINER
IMPLEMENTS YOUR COMPONENT INTERFACE 2EMEMBER YOUR
COMPONENT INTERFACE IS THE ONE THAT EXTENDS %*"/BJECT SO THE
CONTAINER HAS TO IMPLEMENT NOT JUST YOUR BUSINESS METHODS BUT
ALSO THE METHODS OF %*"/BJECT WHICH WE HAVENT YET LOOKED AT
Q: "UT HOW DOES THE CONTAINER KNOW WHAT TO PUT IN THOSE
METHODS )M THE ONE WHO DECLARED THOSE METHODS
A: 2EMEMBER THE CONTAINER ISNT IMPLEMENTING THE REAL BUSINESS
LOGIC 4HE TRUE FUNCTIONALITY FOR THOSE BUSINESS METHODS LIVES IN YOUR
BEAN CLASSTHE CLASS THAT YOU IMPLEMENT 4HE CLASS IMPLEMENTING THE
COMPONENT INTERFACE IS GOING TO BE THE %*"/BJECT 4HE BODYGUARD 4HE
2EMOTE OBJECT !ND REMEMBER THAT THE %*"/BJECT IS ONLY PRETENDING
TO BE THE BEAN )T CAN RESPOND TO THE REMOTE METHOD CALLS COMING FROM
THE CLIENT VIA THE STUB BUT THE %*"/BJECTS ONLY JOB IS TO CAPTURE THE
INCOMING CLIENT CALLS TO THE BEAN !FTER THAT ITS UP TO THE CONTAINER
SERVER TO TAKE OVER
7E DONT REALLY KNOW HOW THE %*"/BJECT IS IMPLEMENTEDITS
COMPLETELY UP TO THE VENDOR "UT WE DONT REALLY CARE !LL YOU NEED TO
KNOW IS THAT AN %*" CONTAINER IS REQUIRED BY THE SPEC TO GENERATE THE
CODE FOR THE %*"/BJECT AND ITS CORRESPONDING STUB
\RXDUHKHUH
ZKRFUHDWHVZKLFKFODVV
?PWKZMI\M[_PI\'
&OR A BEAN WITH A REMOTE CLIENT VIEW IN OTHER WORDS A BEAN THAT CAN BE ACCESSED
BY REMOTE CLIENTS YOU KNOW THAT YOU HAVE TO WRITE THE #OMPONENT INTERFACE AND
THE "EAN CLASS "UT SOMEBODY HAS TO WRITE THE CLASS THAT IMPLEMENTS YOUR #OMPONENT
INTERFACE TO MAKE THE 2EMOTE %*"/BJECT AND SOMEBODY HAS TO MAKE THE STUB THAT
GOES WITH THAT %*"/BJECT 4HAT SOMEBODY IS THE #ONTAINER !ND THOUGH WE HAVENT YET
TALKED ABOUT THE (OME WEVE LISTED THE RELEVANT PIECES HERE FOR COMPLETENESS
<RX WKH&RQWDLQHU
7KH&RPSRQHQWLQWHUIDFH 7KH(-%2EMHFWFODVV
H[WHQGVMDYD[HME(-%2EMHFW LPSOHPHQWV\RXU&RPSRQHQWLQWHUIDFH
7KH%HDQFODVV 7KH(-%2EMHFWVWXEFODVV
LPSOHPHQWVMDYD[HME6HVVLRQ%HDQ LPSOHPHQWV\RXU&RPSRQHQWLQWHUIDFH
RUMDYD[HME(QWLW\%HDQ DQGNQRZVKRZWRWDONWRWKH(-%2EMHFW
7KH+RPHLQWHUIDFH 7KH+RPHFODVV
H[WHQGVMDYD[HME(-%+RPH ZH¶OO LPSOHPHQWV\RXU+RPHLQWHUIDFH
WDONDERXWWKLVRQWKHQH[WSDJH
We havenÕt lked
so we donÕt ta
7KH+RPHVWXEFODVV
about
show it on thisthpie Home yet, LPSOHPHQWV\RXU+RPHLQWHUIDFH
cture. DQGNQRZVKRZWRWDONWRWKH+RPH
VHUYHU
FRPSRQHQWLQWHUIDFH
&OLHQW
VHUYLFHV
5HPRWH
REMHFW
VWXE
W
(-%
DQ
&RQWDLQHU 2EMHF (Q
WHUS VHEH
UL
&RQWDLQHU <RX
<RX
'%
&KDSWHU
DUFKLWHFWXUDORYHUYLHZ
(-%2EMHFW +H\%HDQLHGRQ·W\RXHYHUJHWWLUHGRI (-%2EMHFW ,JXHVVWKDWPDNHVVHQVH<RXSXWWKH
DOZD\VKDYLQJPHLQWKHPLGGOHRIHYHU\WKLQJ"'RQ·W VHFXULW\FKHFNVLQWKH;0/GHSOR\PHQWGHVFULSWRUDQG
\RXHYHUMXVWZDQWWRKDYHDGLUHFWFRQYHUVDWLRQZLWK WKHQZKHQ,JHWWKHFDOOWKHVHUYHUFDQFKHFNWRVHH
VRPHRQH" LIWKHFOLHQWKDVWKHULJKWDXWKRUL]DWLRQ%XWZKDWLI
%HDQ 1R,·PWRRLPSRUWDQW,·PWRRYDOXDEOH$QG VHFXULW\LVQ·WHYHQDQLVVXHIRU\RX":KDWLIZKRHYHU
,·PVXUHDVKHOOQRWJRQQDVWDUWVFUHHQLQJP\RZQFDOOV GHSOR\V\RXGRHVQ·WFDUHZKRFDOOVWKHPHWKRGV"
7KDW·VZKDW\RXSHRSOHDUHIRU %HDQ 1RWWRREULJKWDUH\RX"%XWDWOHDVW\RXFDQOLIW
(-%2EMHFW <RXSHRSOH" KHDY\REMHFWV7+,1.DERXWDOOWKHRWKHUWKLQJVWKDW
PDWWHUOLNHWUDQVDFWLRQVDQGSHUVLVWHQFH
%HDQ <HDK\RXSHRSOHZKRZRUNIRUWKHFRQWDLQHU
<RXWKH+RPHWKHVWXEVDOORI\RX0\MRELVWRKDQGOH (-%2EMHFW 2K,IRUJRWDERXWWUDQVDFWLRQV2.WKDW
WKHFRPSOH[EXVLQHVVORJLF7KHFULWLFDOIXQFWLRQVWKDW PDNHVVHQVHWRR7KHVHUYHUKDVWRÀJXUHRXWLIWKHUH·V
PHDQWKHGLIIHUHQFHEHWZHHQVXFFHVVDQGIDLOXUHLQDQ DWUDQVDFWLRQFRQWH[WEHIRUHLWFDOOV\RXUPHWKRGVR
HQWHUSULVHHQYLURQPHQW WKDW\RXUPHWKRGFDQUXQLQDWUDQVDFWLRQ(LWKHU\RXU
RZQRUWKHFDOOHU·V
(-%2EMHFW *HH]VRXQGVOLNHDPDUNHWLQJVSHHFK
2.VR\RXKDYHVRPHLPSRUWDQWPHWKRGVEXW,VWLOO %HDQ 'XK
GRQ·WVHHZK\\RXQHHGWRKDYHPHLQHYHU\FDOO (-%2EMHFW %XWZKHUHGRHVSHUVLVWHQFHFRPHLQ"
%HDQ /RRNP\ZRUNLVWRRLPSRUWDQWWREH %HDQ :HOOWKLQNDERXWHQWLW\EHDQVIRUDPLQXWH,I
LQWHUUXSWHGE\FOLHQWVZKRKDYHQREXVLQHVVFDOOLQJPH ,·PDQHQWLW\EHDQWKDWPHDQV,·PUHSUHVHQWLQJVRPH
LQWKHÀUVWSODFH'R\RXKRQHVWO\WKLQNWKDW,DPJRLQJ HQWLW\LQWKHXQGHUO\LQJSHUVLVWHQWVWRUHDQG³
WRFKHFNVHFXULW\FOHDUDQFHVIRUHYHU\FDOOHU"/LNH,
(-%2EMHFW ³ZDLW³E\SHUVLVWHQWVWRUHGRQ·W\RXMXVW
GRQ·WKDYHEHWWHUWKLQJVWRGR"
PHDQ'$7$%$6(":K\GRQ·W\RXMXVWVD\GDWDEDVH"
(-%2EMHFW 2.VRLW·VUHDOO\MXVWDVHFXULW\WKLQJEXW %HDQ 8KQHZVÁDVKWKHZRUGSKUDVH´SHUVLVWHQW
,GRQ·WVHHZK\\RXFDQ·WMXVWKDYHWKHFRGHWRFKHFN VWRUHµLVQRWDV\QRQ\PIRU´GDWDEDVHµ$GDWDEDVHLV
WKHVHFXULW\DFFHVVRIWKHFDOOHU7KDWZRXOGVDYHDORW MXVWRQHH[DPSOHRIDSHUVLVWHQWVWRUH%XWLILWPDNHV
RIRYHUKHDG QDPHO\0(
\RXIHHOEHWWHUWRWKLQNDERXWLWWKDWZD\JRDKHDGIRU
%HDQ )LUVWRIDOOVHFXULW\LVMXVW21(RIWKHUHDVRQV QRZ%XWDV,ZDVVD\LQJLI,UHSUHVHQWDQHQWLW\VD\
\RXKDYHWRWDNHP\FDOOV,·OOJHWWRWKRVHRWKHU DFXVWRPHUQDPHG7RP'XIIWKHQZKDWKDSSHQVLIWKH
UHDVRQVLQDPLQXWH%XWDVIRUSXWWLQJLQFRGHWRGRP\ FOLHQWFDOOVP\JHW$GGUHVV PHWKRG"7KHVHUYHUFDQ·W
RZQFKHFNVDFWXDOO\,&$1GRWKDWLIWKHSURJUDPPHU MXVWKDQGPHWKHFDOO
ZDQWVPHWR%XWLW·VXVXDOO\QRWWKHZD\WRKDQGOH (-%2EMHFW %HFDXVH
VHFXULW\
%HDQ %HFDXVH,KDYHWRORDGLQ7RP'XII·V
(-%2EMHFW :KDW·VZURQJZLWK\RXKDQGOLQJWKH LQIRUPDWLRQIURPWKHGDWDEDVHÀUVW
VHFXULW\FKHFNVLQ\RXURZQFRGH"
(-%2EMHFW %HFDXVH
%HDQ <RXUHDOO\GRQ·WNQRZGR\RX">UROOVH\HV@)LUVW
LIWKHVHFXULW\FKHFNVDUHFRGHGLQWRPHWKHQ,·PQRW %HDQ %HFDXVH,·GUHWXUQDQDGGUHVVWKDWPLJKWQRW
DVUHXVDEOH7KHZKROHSRLQWRI(-%LVWRFRQÀJXUHDQG HYHQEHYDOLG8QOHVV,·PVWLOOLQDSUHYLRXVWUDQVDFWLRQ
FXVWRPL]HEHDQVDWUXQWLPHZLWKRXWUHZULWLQJWKHFRGH ZLWKWKLVFOLHQWWKHQWKHVHUYHUKDVWRWHOOPHWR
,I,·YHJRWVHFXULW\SURJUDPPLQJLQP\-DYDFRGHWKHQ ORDGP\VHOIZLWK7RP'XII·VGDWDEDVHLQIR%()25(
LWFDQ·WEHFKDQJHGZLWKRXWWRXFKLQJWKHVRXUFH$QG WKHVHUYHUWHOOVPHWRUXQWKHJHW$GGUHVV PHWKRG
ZKRZDQWVWKDW" 2WKHUZLVHZKRNQRZVZKDW,·GUHWXUQ"2.ZHOOWKDW·V
ODVWFDOOVRZH·OOKDYHWRFRQWLQXHWKLVVRPHRWKHUWLPH
\RXDUHKHUH
(-%DUFKLWHFWXUH
there are no
Dumb Questions
Q: (OW AND WHEN DOES THE
LETS YOU VIEW POSSIBLY EVEN HACK
THE GENERATED SOURCE CODE BUT DONT
&OR THE MOST PART YOULL BARELY NOTICE
THE DIFFERENCE BETWEEN PLAIN OLD 2-)
CONTAINER CREATE THE %*"/BJECT AND COUNT ON IT !ND IF WE WERE YOU WE AND 2-)
))/0 "UT THERE ARE A COUPLE
THE (OME AND THE STUBS JUST WOULDNT GO THERE EVEN IF WE
COULD OF PLACES WHERE ITS DIFFERENT AND ONE
OF THESE DIFFERENCES IS DEFINITELY ON
A: 7HEN YOU DEPLOY A BEAN
THE CONTAINER LOOKS AT THE $$ AND
Q: 3O THESE CLASSES ARE UP TO THE
THE EXAMTHE NEED TO NARROW A STUB
7ELL COVER NARROWING IN DETAIL IN THE
TAKES IT FROM THERE 2EMEMBER THE VENDORS IMPLEMENTATION NEXT CHAPTER ON #LIENT 6IEW &OR NOW
$$ GIVES THE FULLY QUALIFIED NAME OF JUST KNOW THAT ITS SOMETHING A CLIENT
YOUR 2EMOTE #OMPONENT %*"/BJECT
INTERFACE AND YOUR 2EMOTE (OME A: 9ES 4HE VENDOR HAS ALL SORTS
OF CHOICES FOR IMPLEMENTING THESE
MUST DO WITH AN %*" STUB THAT THEY
DONT HAVE TO DO WITH A PLAIN *AVA
STUB BECAUSE THE %*" SPEC TELLS YOU TO
INTERFACE 3O ONCE THE CONTAINER GETS
THOSE INTERFACES IT GENERATES CODE CLASSES AND MIGHT USE THE STUBS AND ASSUME THAT THE STUB IS USING ))/0 AND
FOR THE TWO CLASSES IMPLEMENTING OR (OME AND %*"/BJECTS TO GET SOME THUS MIGHT BE A DIFFERENT KIND OF STUB
THOSE INTERFACES !ND BECAUSE THEYRE PERFORMANCE ADVANTAGES "UT AGAIN
2EMOTE THE CONTAINER ALSO CREATES
THE CLIENT STUBS THAT KNOW HOW TO
THATS NOT UP FOR YOU TO MESS WITH OR
EVEN KNOW ABOUT Q: 7HEN ARE WE GOING TO TALK
COMMUNICATE BACK TO THE 2EMOTE ABOUT THE (OME
4HE ONLY REQUIREMENT IN THE SPEC
OBJECTS THAT YOURE GUARANTEED AND REQUIRED
TO ADHERE TO IS THAT 2EMOTE OBJECTS
MUST FOLLOW THE RULES FOR 2-)
))/0 A: .EXT PAGE
Q: !RE THESE ALWAYS PLAIN OLD 2-) WHICH MEANS *AVAS 2EMOTE -ETHOD
)NVOCATION USING THE ))/0 #/2"! Q:
STUBS ) SEE THAT WHEN WE DEPLOYED 7HY DID YOU TAKE SO LONG
STANDARD WIRE PROTOCOL
USING THE 2) IT PRINTED OUT A MESSAGE )SNT THE (OME IMPORTANT
THAT IT WAS RUNNING RMIC
Q: 9OU BROUGHT IT UP HOW IS 2-)
A:
A: 4HE CONTAINER CAN DO WHAT
EVER IT WANTS TO CREATE THE STUBS THE
))/0 DIFFERENT FROM REGULAR 2-) !S CRUCIAL AS THE (OME IS
ITS USUALLY JUST THE WAY YOU GET
A REFERENCE TO SOMETHING THAT
REQUIREMENT IS THAT THE STUBS BE 2-)
))/0 COMPLIANT )N FACT A SERVER CAN
A: 0LAIN OLD 2-) USES *2-0 AS ITS
WIRE PROTOCOL "UT ))/0 LETS 2EMOTE
IMPLEMENTS THE #OMPONENT INTERFACE
)N OTHER WORDS YOU USE THE (OME TO
USE SOMETHING CALLED DYNAMIC PROXIES OBJECTS INTEROPERATE THROUGH #/2"! GET AN %*"/BJECT STUB FOR 2EMOTE
TO IMPLEMENT THE STUB FUNCTIONAL
WE WONT BE SAYING MUCH AT ALL ABOUT CLIENTS WHICH IS ALL WEVE TALKED ABOUT
ITY BUT WE DONT CARE 7HEN WE SAY #/2"! IN THIS BOOK ITS DEFINITELY OUT SO FAR
hSTUBv WE MEAN SOMETHING WITH STUB OF SCOPE FOR THE EXAM AND THE BOOK &OR %NTITY BEANS THE (OME CAN HAVE
BEHAVIOR 7HETHER ITS AN 2-) STUB OR EXCEPT IN A FEW TINY CASES WELL SEE A MORE IMPORTANT ROLE AND WELL SEE
SOMETHING ELSE IS AN IMPLEMENTATION SCATTERED THROUGHOUT THE CHAPTERS THAT BUT EVEN WITH %NTITY BEANS THE
DETAIL FOR THE SERVER 7ELL LOOK AT THAT
4HAT GIVES YOUR OBJECTS A CHANCE TO BE (OMES PRIMARY USE IS STILL TO GET
IN MORE DETAIL IN THE NEXT CHAPTER 4HE
ACCESSED FOR EXAMPLE BY EVEN NON
%*"/BJECT STUBS !FTER THAT MOST OF
BOTTOM LINE IS THAT YOU REALLY DONT
*AVA CLIENTS /NE THING ))/0 SPECIFIES IS THE COMMUNICATION BETWEEN THE
KNOW WHAT THE STUB CLASS CODE LOOKS
THE WAY INFORMATION FOR TRANSACTIONS CLIENT AND THE BEAN COMES THROUGH
LIKE &OR THAT MATTER YOU REALLY DONT
AND SECURITY CAN BE PROPAGATED THE %*"/BJECT AND NOT THE (OME
KNOW HOW THE %*"/BJECT AND THE
ALONG WITH THE METHOD CALL AND YOUR -OST OF THE TIME IN FACT CLIENTS USE
(OME ARE IMPLEMENTED 9OURE NOT
CONTAINER MIGHT BE TAKING ADVANTAGE THE (OME JUST TO GET THE %*"/BJECT
SUPPOSED TO KNOW
OF THAT REFERENCE AND THEN THE (OME
9OU MIGHT HAVE AN %*" CONTAINER THAT REFERENCE IS TOSSED OUT NOT NEEDED
&KDSWHU
DUFKLWHFWXUDORYHUYLHZ
<PMJMIV0WUM
%VERY 3ESSION AND %NTITY BEAN HAS A (OME
-ESSAGE
DRIVEN BEANS DONT HAVE HOMES BECAUSE
MESSAGE
DRIVEN BEANS DONT HAVE A CLIENT VIEW IN OTHER
WORDS CLIENTS CANT GET A REFERENCE TO A -ESSAGE
DRIVEN
BEAN
4HE (OME HAS ONE MAIN JOB TO HAND OUT REFERENCES TO
A BEANS #OMPONENT INTERFACE &OR A 3ESSION BEAN THATS
JUST ABOUT ALL YOULL DO WITH THE BEANS (OME &OR %NTITY
BEANS THOUGH THE (OME PLAYS A MUCH BIGGER ROLE
%ACH DEPLOYED BEAN HAS ITS OWN (OME AND THAT (OME
IS RESPONSIBLE FOR ALL BEAN INSTANCES OF THAT TYPE &OR
EXAMPLE IF YOU DEPLOY A 3HOPPING#ART 3ESSION BEAN
THE CONTAINER WILL CREATE ONE 3HOPPING#ART BEAN
(OME 4HAT 3HOPPING#ART (OME TAKES CARE OF ALL THE
INSTANCES OF 3HOPPING#ART BEANS )N OTHER WORDS IF (DFKGHSOR\HG6HVVLRQDQG
CLIENTS EACH WANT THEIR OWN 3HOPPING#ART BEAN
REFERENCE WHICH REMEMBER MEANS A REFERENCE TO THE (QWLW\EHDQKDVD+RPH)RU
3HOPPING#ART BEANS #OMPONENT INTERFACE THE ONE H[DPSOHWKH$GYLFH%HDQKDV
AND ONLY 3HOPPING#ART (OME WILL HAND OUT ALL
REFERENCES DQ$GYLFH%HDQ+RPH1R
)F YOU DEPLOY THREE BEANS AS PART OF AN APPLICATION SAY
A 3HOPPING#ART #USTOMER AND 0RODUCT THERE WILL BE
PDWWHUKRZPDQ\FOLHQWVJHW
THREE (OMES IN THE SERVER REPRESENTING EACH OF THOSE DQ$GYLFH%HDQWKHUH·VRQO\
DEPLOYED BEANS )T MAKES NO DIFFERENCE HOW MANY
%*"/BJECTS AND STUBS THE (OME OBJECTS HAND OUT THERE RQH$GYLFH%HDQ+RPH
WILL STILL BE ONLY THREE (OMES
3O DOES THAT MEAN THAT FOR EACH (OME THERE IS ONLY A 7KH+RPH·VMRELVWRKDQG
SINGLE INSTANCE OF THE CLASS THAT IMPLEMENTS THE (OME
INTERFACE FOR THAT BEAN TYPE .OT NECESSARILY BUT THATS RXWUHIHUHQFHVWRWKDWEHDQ·V
EXACTLY HOW WERE SUPPOSED TO THINK ABOUT IT 7ELL &RPSRQHQWLQWHUIDFH
ACTUALLY REFER TO THE (OME AS THE (OME OBJECT AND WELL
ASSUME THAT THERES ALWAYS JUST ONE PER DEPLOYED BEAN
TYPE 4HE SPEC GUARANTEES THAT YOU CAN THINK ABOUT IT
THAT WAY REGARDLESS OF WHAT YOUR VENDOR ACTUALLY DOES 7HFKQLFDOO\WKHUH¶VDOLWWOHPRUHWRWKHVWRU\
WITH ITS IMPLEMENTATION FOR THE (OME EHFDXVHDEHDQPLJKWKDYHERWKDORFDO+RPH
DQGD5HPRWH+RPHEXWWKDW¶VUHDOO\XQOLNHO\
(YHQWKHQWKHUHZRXOGEHRQO\RQHRIHDFK
+RPHW\SH 5HPRWHRUORFDO QRPDWWHUKRZ
PDQ\EHDQVRIWKDWW\SHDUHDOLYH
\RXDUHKHUH
WKHKRPH
*HWWLQJDQGXVLQJD+RPHIRUWKH$GYLFH%HDQ
7KLVVFHQDULRDVVXPHV$GYLFH%HDQLVDVWDWHIXO6HVVLRQEHDQ
7KH$GYLFH%HDQLVGHSOR\HGDQGWKHVHUYHU
LQVWDQWLDWHVWKH$GYLFH%HDQ+RPHREMHFW
DQGUHJLVWHUVLWZLWK-1',
VHUYLFHV
FOLHQW
+RPHLQWHUIDFH
+RPH
REMHFW
-1',1DPLQJ
6HUYLFH
³$GYLVRU´ VWXE
7KHFOLHQWGRHVD-1',ORRNXSRQWKH+RPH
XVLQJWKHUHJLVWHUHGQDPH´$GYLVRUµ
VHUYLFHV
FOLHQW
+RPHLQWHUIDFH
+RPH
REMHFW
-1',1DPLQJ
6HUYLFH
ORRNX
S ´$G ³$GYLVRU´ VWXE
YLVRU
µ
&KDSWHU
DUFKLWHFWXUDORYHUYLHZ
-1',VHQGVEDFNDVWXEWRWKH5HPRWH+RPHREMHFW
VHUYLFHV
FOLHQW
+RPHLQWHUIDFH
+RPH
REMHFW
-1',1DPLQJ
6HUYLFH
VWXE
³$GYLVRU´ VWXE
7KHFOLHQWDVNVWKH+RPHIRUDUHIHUHQFHWRWKH
&RPSRQHQWLQWHUIDFHE\FDOOLQJFUHDWH
,QRWKHUZRUGVWKHFOLHQWZDQWVWR´FUHDWHµDEHDQDQG
JHWWKHVWXEEDFNWRWKHEHDQ·V(-%2EMHFW
VHUYLFHV
FOLHQW
+RPHLQWHUIDFH
+RPHLQWHUIDFH
+RPH
FUH REMHFW
DWH
VWXE
\RXDUHKHUH
WKHKRPH
7KH+RPHREMHFWPDNHVWKH(-%2EMHFW
DQGVHQGVEDFNWKHVWXE
1RZWKH´VHUYLFHVµNLFNLQDQGWKHEHDQLVFUHDWHG
VHUYLFHV
FUH
DWH
EHDQ
FOLHQW
+RPHLQWHUIDFH
+RPHLQWHUIDFH
+RPH
REMHFW
VWXE
7KH(-%2EMHFWLVPDGH WKHERG\JXDUGIRUWKLVQHZO\
FUHDWHGEHDQ DQGLWVVWXELVUHWXUQHGWRWKHFOLHQW
&RPSRQHQWLQWHUIDFH
VHUYLFHV
(-%
REMHFW
EHDQ
FOLHQW
+RPHLQWHUIDFH
+RPHLQWHUIDFH
+RPH
REMHFW
VWXE VWXE
&KDSWHU
DUFKLWHFWXUDORYHUYLHZ
1RZWKHFOLHQWFDQ ÀQDOO\ GRZKDWKH5($//<ZDQWV
WRGR³FDOODEXVLQHVVPHWKRGRQWKHEHDQ :KLFKRI
FRXUVHKDVWRJRWKURXJKWKH&RPSRQHQWLQWHUIDFH
&RPSRQHQWLQWHUIDFH
&RPSRQHQWLQWHUIDFH
VHUYLFHV
(-%
VWXE REMHFW
EHDQ
FOLHQW
+RPHLQWHUIDFH
+RPHLQWHUIDFH
+RPH
REMHFW
VWXE
7KHFOLHQWFDQJHWULGRIKLV+RPHVWXELIKHGRHVQ·W
ZDQWDFFHVVWRPRUHEHDQVRIWKLVW\SH $GYLFH%HDQ
EXWKHFDQVWLOONHHSFDOOLQJPHWKRGVRQWKH
&RPSRQHQWLQWHUIDFH
&RPSRQHQWLQWHUIDFH
&RPSRQHQWLQWHUIDFH
VHUYLFHV
(-%
VWXE REMHFW
EHDQ
FOLHQW
+RPHLQWHUIDFH
+RPHLQWHUIDFH
+RPH
REMHFW
VWXE
\RXDUHKHUH
(-%DUFKLWHFWXUH
6KDUSHQ \RXU SHQFLO ,QWKHVFHQDULREHORZDVVXPHWKHFOLHQWKDVSUHYLRXVO\GRQHD-1',ORRNXSDQG
JRWWHQEDFNDVWXEWRWKH5HPRWH+RPHREMHFW
(YHU\WKLQJLQWKHSLFWXUHLVZKDWKDSSHQV$)7(5WKHFOLHQWKDVWKH+RPHVWXEDQG
QRZZDQWVWRJHWDUHIHUHQFHWRDQ(-%2EMHFWDQGXOWLPDWHO\FDOODEXVLQHVVPHWKRG
RQWKHEHDQ
(-%/LIHF\FOH
&OLHQWKDVRQO\D 1XPEHUWKHDUURZV XVLQJWKHER[HVRYHUWKHDUURZV LQWKHRUGHULQZKLFKWKH\
+RPHVWXEEXWZDQWV RFFXU7KHVHDUURZVDUHQ¶WQHFHVVDULO\GLUHFWPHWKRGFDOOV DOWKRXJKWKH\PLJKWEH
WRLQYRNHDEXVLQHVV EXWUDWKHUDUURZVSRLQWLQJWRWKHQH[W7+,1*WKDWKDSSHQV7HOODVWRU\IRUZKDWKDS
PHWKRGRQDEHDQ SHQVDWHDFKDUURZ7KHUHPLJKWEHPRUHWKDQRQHULJKWDQVZHUGHSHQGLQJRQKRZ
\RXWHOOWKHVWRU\6RPHDUURZVDUHPLVVLQJ \RXFDQDGGWKHPLI\RXZDQWRUMXVW
DVVXPHVRPHWKLQJVDUHKDSSHQLQJWKDW\RXGRQ¶WKDYHDUURZVIRU
5HOD[DQGWDNH\RXUWLPH
,I\RXJHWVWXFNÀLSEDFNWKURXJKWKHSUHYLRXVSDJHVDQGVWXG\WKHGLDJUDPV
VHUYLFHV
VWXE (-%
REMHFW
EHDQ
FOLHQW
+RPH
VWXE REMHFW
2
The stub tells the Home that the client wants
to ÒcreateÓ a bean.
&KDSWHU
DUFKLWHFWXUDORYHUYLHZ
:MDD=LHGAFLK
%HDQVWKDWDUHH[SRVHGWRUHPRWHFOLHQWVKDYHWZR5HPRWH
LQWHUIDFHVRQHIRUWKH(-%+RPHDQGRQHIRUWKH(-%2EMHFW
5HPRWHLQWHUIDFHPXVWH[WHQG GLUHFWO\RULQGLUHFWO\
YDUPL5HPRWHDQGDOOPHWKRGVPXVWGHFODUHD
YDUPL5HPRWH([FHSWLRQ
(-%WKHLQWHUIDFHWKDWH[WHQGV(-%2EMHFWLVFDOOHGWKH
HPRWH&RPSRQHQWLQWHUIDFH,WLVZKHUHWKHEXVLQHVVPHWKRGV
HGHFODUHG
ARE BLUE
S A RE R E D VIOLETS RI TTEN BY 9
/5 KHFOLHQWQHYHUFDOOVPHWKRGVRQWKHEHDQLWVHOIEHFDXVHWKH
2OSE RF A C E S ARE W
OTE IN TE HDQLV127D5HPRWHREMHFW
4HE 2EM
CT
BIG PROJE KHFRQWDLQHULPSOHPHQWVWKH5HPRWH&RPSRQHQWLQWHUIDFHE\
R E D A N D QUITE A T
2OSES ARE /BJEC XLOGLQJDFODVVWKDWLPSOHPHQWVLW7KLVFODVVLVXVHGWRPDNHWKH
E THE %*"
S E RV E R WILL MAK -%2EMHFWIRUWKHEHDQ 7KHEHDQ·VERG\JXDUG
4HE
T
WILL FLOA
E D T HE PETALS TE
KHFRQWDLQHUDOVRFUHDWHVWKHVWXEWRWKH(-%2EMHFW
2OSES A RE R ER 2E O
M
LA S S I TS ELF IS NEV RXFUHDWHWKH5HPRWH&RPSRQHQWLQWHUIDFHE\ZULWLQJDQ
C
4HE BEAN
U TRY IT
WHUIDFHWKDWH[WHQGVMDYD[HME(-%2EMHFW DQLQWHUIDFHWKDW
R N
l E ST WORK 9O T MORE [WHQGVMDYDUPL5HPRWH
NOT O U STICK A LO
9EAH /+ THESE THINGS WILL ELF
ER URS
2EMEMB UP WITH THEM YO <RXDOVRFUHDWHWKHEHDQFODVVZKHUHWKHDFWXDOEXVLQHVV
ME
IF YOU CO PHWKRGVDUHLPSOHPHQWHG GHVSLWHWKHIDFWWKDWWKHEHDQFODVV
WHFKQLFDOO\GRHVQ·WLPSOHPHQWWKH5HPRWH&RPSRQHQWLQWHUIDFH
7KH+RPHLVWKHIDFWRU\IRUWKHEHDQ,WVPDLQMRELVWRKDQGWKH
FOLHQWDUHIHUHQFHWRWKHEHDQ%XWUHPHPEHUWKHFOLHQWFDQQHYHU
WUXO\JHWDUHIHUHQFHWRWKHEHDQ³WKHEHVWWKHFOLHQWFDQGRLVWR
JHWDUHIHUHQFHWRWKHEHDQ·V(-%2EMHFW
<RXFUHDWHWKH+RPHLQWHUIDFHE\ZULWLQJDQLQWHUIDFHWKDW
H[WHQGVMDYD[HME(-%+RPH DQLQWHUIDFHWKDWH[WHQGV
MDYDUPL5HPRWH
7KHFRQWDLQHULVUHVSRQVLEOHIRULPSOHPHQWLQJWKH+RPHLQWHUIDFH
E\EXLOGLQJDFODVVWKDWLPSOHPHQWVLWDQGWKHFRQWDLQHUDOVR
JHQHUDWHVWKHVWXEIRUWKH+RPH
7KHUHLVRQO\RQH+RPHSHUGHSOR\HGEHDQ)RUH[DPSOHD
6KRSSLQJ&DUWEHDQZRXOGKDYHDVLQJOH6KRSSLQJ&DUW+RPH
UHJDUGOHVVRIKRZPDQ\6KRSSLQJ&DUWEHDQVKDYHEHHQFUHDWHG
\RXDUHKHUH
VHVVLRQEHDQRYHUYLHZ
)ZKPQ\MK\]ZITW^MZ ^QM_";M[[QWVJMIV[
&OLHQWVVKDUHWKH+RPHEXWQHYHUWKHEHDQ
(DFKFOLHQWJHWVKLVRZQ(-%2EMHFWUHIHUHQFHDQGKLVRZQEHDQ7KHFOLHQWQHYHU
VKDUHVDEHDQZLWKDQRWKHUFOLHQWDOWKRXJKWKHPHDQLQJRI³VKDUHV´GHSHQGV
RQZKHWKHUWKHEHDQLVVWDWHIXORUVWDWHOHVV :H¶OOVHHWKDWLQWKHQH[WFKDSWHU
+RZHYHUWKHUH¶VRQO\RQH+RPHREMHFWIRUWKLVSDUWLFXODUEHDQW\SH VD\
$GYLFH%HDQ VRERWKFOLHQWVKDYHDVWXEWRWKHRQHDQGRQO\$GYLFH+RPH%RWK
FOLHQWVDVNWKHVDPH$GYLFH+RPHIRUDUHIHUHQFHWRDQ$GYLFHEHDQ 2IFRXUVH
WKHFOLHQWQHYHUJHWVWKHUHIHUHQFHWRWKHEHDQLQVWDQFHEXWLQVWHDGJHWVDUHIHUHQFH
WRWKHEHDQ¶V(-%2EMHFW$QGVLQFH(-%2EMHFWLV5HPRWHWKHFOLHQWVJHWVDVWXE
6HUYHU
&OLHQW2QH
VHUYLFHV
(-%
VWXE REMHFW
FOLHQW
EHDQ
VWXE
7KHUH·VRQO\RQH+RPH
REMHFWEXWHDFKFOLHQW
JHWVKLVRZQGHGLFDWHG
+RPH EHDQDQG(-%2EMHFW
REMHFW
EHDQ
VHUYLFHV
&OLHQW7ZR
(-%
REMHFW
FOLHQW VWXE
A session bean client is guaranteed to
be the only client executing a method
on that bean. While the client is in
VWXE the middle of a business method, that
bean belongs to that client.
&KDSWHU
DUFKLWHFWXUDORYHUYLHZ
)ZKPQ\MK\]ZITW^MZ ^QM_"-V\Q\aJMIV[
&OLHQWVVKDUHWKH+RPHDQGPD\VKDUHWKHEHDQ
(DFKFOLHQWKDVKLVRZQUHIHUHQFHWRWKHRQHDQGRQO\+RPHIRUWKLVEHDQ VD\
&XVWRPHU%HDQ %XWLIWZRFOLHQWVDUHWU\LQJWRDFFHVVWKHVDPH&XVWRPHU )UHG6PLWK
WKHQERWKFOLHQWVKDYHDUHIHUHQFHWRWKHVDPH(-%2EMHFW7KH(-%2EMHFWIRU
,QRWKHUZRUGVWKH(-%2EMHFWLVWKHERG\JXDUGIRUDSDUWLFXODU&XVWRPHU OLNH)UHG6PLWK
,IDOOWKHFOLHQWVDUHWU\LQJWRDFFHVV)UHG6PLWKWKH\ZLOOHDFKKDYHWKHLURZQVWXE
RIFRXUVHEXWDOOVWXEVZLOOFRPPXQLFDWHZLWKWKHVDPH5HPRWH(-%2EMHFW$QGWKHUHZLOO
EHRQO\RQHEHDQUHSUHVHQWLQJ)UHG6PLWK,IDFOLHQWZDQWVWRDFFHVVWZRGLIIHUHQW
FXVWRPHUVWKRXJKWKHFOLHQWZLOOKDYHWZRVWXEVDQGWKRVHVWXEVZLOOEHIRUWZRGLIIHUHQW
(-%2EMHFWVRQHIRUHDFKFXVWRPHU$QGWKDWDOVRPHDQVWZRGLIIHUHQWEHDQV
&OLHQW2QH 6HUYHU
)UHG6PLWK
VWXE )UHG6PLWK·V
FOLHQW
ERG\JXDUG
EHDQ
VWXE &XVWRPHU
(-% WDEOH
REMHFW
'%
VHUYLFHV
+RPH
REMHFW
&OLHQW7ZR
EHDQ
6N\OHU6DQ
(-%
VWXE REMHFW
FOLHQW 6N\OHU6DQ·V
ERG\JXDUG
VWXE
VWXE
\RXDUHKHUH
VHVVLRQEHDQRYHUYLHZ
)ZKPQ\MK\]ZITW^MZ ^QM_"
+ZMI\QVOI;\I\MN]T;M[[QWVJMIV
$IWHUJHWWLQJD+RPHVWXEWKHFOLHQWFDOOV³FUHDWH´RQWKH+RPH
7KH+RPHFUHDWHVWKHEHDQDQGWKH(-%2EMHFWIRUWKHEHDQDQG
KDQGVEDFNWKH(-%2EMHFWVWXE
VHUYLFHV
(-%
VWXE REMHFW
EHDQ
FOLHQW
+RPH
REMHFW
VWXE
The client calls create() on the Home stub (create() is a method in the
Home interface).
The stub sends the create() call to the Remote Home object.
The Home object steps in and adds its services.
The EJBObject is created/instantiated for the bean.
The bean itself is instantiated.
The EJBObject stub is returned to the client, so the client can call
business methods on the Component interface.
&KDSWHU
DUFKLWHFWXUDORYHUYLHZ
)ZKPQ\MK\]ZITW^MZ ^QM_"
+ZMI\QVOI;\I\MTM[[;M[[QWVJMIV
$IWHUJHWWLQJD+RPHVWXEWKHFOLHQWFDOOV³FUHDWH´RQWKH+RPH7KH
+RPHJLYHVWKHFOLHQWDVWXEWRDQH[LVWLQJ(-%2EMHFWEXWGRHVQRW
DVVRFLDWHDEHDQZLWKWKLV(-%2EMHFW,QVWHDGWKHEHDQVWD\VLQDSRRO
XQWLOWKHFOLHQWXVHVWKH(-%2EMHFWVWXEWRFDOODEXVLQHVVPHWKRG
VHUYLFHV
(-%
VWXE REMHFW
EHDQ
FOLHQW
+RPH
REMHFW
EHDQSRRO
VWXE
The client calls create() on the Home stub (create() is a method in the
Home interface).
The stub sends the create() call to the Remote Home object.
The Home container steps in and adds its services.
An EJBObject is created for this client.
The bean stays in the bean pool ! It comes out only to service an actual
business method, if the client invokes one on the EJBObject stub.
The EJBObject stub is returned to the client, so the client can call
business methods on the Component interface.
\RXDUHKHUH
VHVVLRQEHDQRYHUYLHZ
2.VRWKHEHDQFRPHVRXW
RIWKHSRRORQO\ZKHQWKHFOLHQW
FDOOVDEXVLQHVVPHWKRGEXWWKHQ
KRZGLGWKHEHDQJHWLQWKHSRROLQ
WKHÀUVWSODFH",ILWZDVQ·WFUHDWHG
ZKHQWKHFOLHQWFDOOHGFUHDWH
WKHQZKDWGLGFDXVHWKHEHDQWR
EHFUHDWHG"
?PWKZMI\M[\PM[\I\MTM[[[M[[QWV
JMIVIVL_PMV'
&IRST WE HAVE TO DElNE WHAT CREATE MEANS &OR A SESSION BEAN IT
MEANS THE BEAN INSTANCE IS PHYSICALLY INSTANTIATED AND INITIALIZED
AS A BEAN &OR AN ENTITY BEAN ITS COMPLETELY DIFFERENT SO THIS
CONVERSATION APPLIES JUST TO SESSION BEANS ,ATER WELL GET INTO
WHAT IT MEANS TO CREATE AN ENTITY BEAN
&OR STATEFUL SESSION BEANS THE CREATE IS TRIGGERED BY THE CLIENT
4HE CLIENT CALLS CREATE ON A (OME STUB AND EVERYTHING HAPPENS
AT THAT POINTAN %*"/BJECT IS INSTANTIATED FOR THIS NEW ABOUT
TO
BE
CREATED
BEAN AND THEN THE BEAN ITSELF IS CREATED AND LINKED TO
THE %*"/BJECT THE BEANS BODYGUARD
"UT FOR STATELESS SESSION BEANS THE CLIENT CREATE AND THE ACTUAL
CREATION OF THE BEAN ARE DECOUPLED )N OTHER WORDS JUST BECAUSE
THE CLIENT CALLS CREATE ON A (OME STUB DOESNT MEAN A BEAN WILL
BE CREATED AT THAT POINT
3TATELESS SESSION BEANS ARENT CREATED UNTIL THE CONTAINER DECIDES
IT NEEDS ONE AND THATS REALLY UP TO THE CONTAINER )T MIGHT
FOR EXAMPLE MAKE A BUNCH OF BEAN INSTANCES IE CREATE SOME
BEANS AND PLOP THEM IN A POOL BEFORE EVEN A SINGLE CLIENT
HAS ASKED FOR ONE BY CALLING CREATE ON A (OME STUB /R THE
CONTAINER MIGHT MAKE JUST
IN
TIME BEANS AND WAIT UNTIL THE
CLIENT INVOKES A BUSINESS METHOD BEFORE GOING TO THE TROUBLE OF
PHYSICALLY CREATING THE BEAN
&KDSWHU
DUFKLWHFWXUDORYHUYLHZ
;\I\MTM[[[M[[QWVJMIV[IZMUWZM[KITIJTM
&OLHQWVGRQ·WVKDUH(-%2EMHFWVEXWWKHVDPH
EHDQFDQVHUYLFHPXOWLSOH(-%2EMHFWV-XVWQRWDW
WKHVDPHWLPH$VLQJOHEHDQFDQKDQGOHPXOWLSOH
FOLHQWVDVORQJDVRQO\RQHFOLHQWDWDWLPHLVLQWKH
PLGGOHRIDEXVLQHVVPHWKRGLQYRFDWLRQ
&OLHQW2QH 6HUYHU
VWXE
FOLHQW
VWXE
(-%
REMHFW
+RPH
REMHFW EHDQ
&OLHQW7ZR
(-% EHDQSRRO
REMHFW
VWXE
FOLHQW
The bean comes out of the pool
VWXE
ONLY when a client invokes
a business method on the
EJBObject stub. So, a single
bean can jump out to handle
one clientÕs call, then jump back
in the pool, then jump out to
handle a different clientÕs call,
and then jump back in the pool...
\RXDUHKHUH
VHVVLRQEHDQRYHUYLHZ
YiX`e 6KDUSHQ \RXU SHQFLO
gfn\i
:K\GRHVWKH³SRRO´DUFKLWHFWXUHZRUNWRPDNH
7) $VWDWHIXOVHVVLRQEHDQFDQEHVKDUHG
EHWZHHQPXOWLSOHFOLHQWV
VWDWHOHVVVHVVLRQEHDQVPRUHVFDODEOHEXW
QRWVWDWHIXOVHVVLRQEHDQV":K\FDQ¶WVWDWHIXO
VHVVLRQEHDQVXVHWKHEHDQSRRO" 7) $QHQWLW\EHDQFDQEHVKDUHGEHWZHHQ
PXOWLSOHFOLHQWVDVORQJDVWKHHQWLW\
EHLQJVKDUHGLVWKHVDPH
7) 6WDWHOHVVVHVVLRQEHDQVDUHFUHDWHG
there are no ZKHQWKHFOLHQWLQYRNHVFUHDWHRQWKH
Dumb Questions +RPH
Q: (ERES SOMETHING THAT IS 2%!,,9
7) 6WDWHIXOVHVVLRQEHDQVDUHFUHDWHG
ZKHQWKHFOLHQWLQYRNHVFUHDWHRQWKH
STARTING TO ANNOY ME WHY DO YOU HAVE A +RPH
#OMPONENT INTERFACE AND A (OME INTERFACE
WHEN THE 2EMOTE OBJECTS ARE CALLED THE
7) 7KHUHPXVWEHRQHVWDWHOHVVVHVVLRQ
(OME AND THE %*"/BJECT 7HY ISNT IT JUST EHDQSHUFOLHQWIRUDVORQJDVWKHFOLHQW
THE %*"/BJECT INTERFACE AND THE (OME/BJECT KROGVDUHIHUHQFHWRDQ(-%2EMHFW
INTERFACE /R THE (OME AND THE %*"
INTERFACES 7HY THE INCONSISTENCY
7) 7KHUHPXVWEHRQHVWDWHOHVVVHVVLRQ
EHDQSHUFOLHQWIRUDVORQJDVWKHFOLHQW
A: !CTUALLY THAT REALLY PISSES US OFF TOO "UT
YOULL GET USED TO IT "E THANKFUL IT WAS EVEN
LVLQWKHPLGGOHRIDEXVLQHVVPHWKRG
LQYRFDWLRQRQWKHEHDQ
WORSE IF YOU LEARNED %*" PRIOR TO VERSION
WHEN IT WAS CALLED THE (OME AND THE 2EMOTE 7) (DFKHQWLW\EHDQPXVWKDYHLWV
.OW THAT WAS A REAL PROBLEM BECAUSE FIRST (-%2EMHFW
OF ALL BOTH THE (OME AND THE 2EMOTE WERE
2EMOTE IN THE JAVARMI SENSE 3ECOND AS OF
%*" YOU CAN HAVE A (OME AND A 2EMOTE
THAT ARENT ACTUALLY 2EMOTE 3O THEY HAD
TO CHANGE THE NAME TO #OMPONENT INTERFACE
INSTEAD OF CALLING IT 4(% 2EMOTE INTERFACE
SINCE IT MIGHT IN FACT NOT BE 2EMOTE )F YOU
JUST REMEMBER THAT THE #OMPONENT INTERFACE
IS WHERE THE BUSINESS METHODS ARE AND THE
(OME IS WHERE THE UM (OME METHODS ARE
YOU SHOULD BE FINE *UST REMEMBER #OMPONENT
BUSINESS %*"/BJECT OR %*",OCAL/BJECT BUT
WE WONT GO THERE UNTIL THE NEXT CHAPTER $QVZHUV )7)7)77
&KDSWHU
DUFKLWHFWXUDORYHUYLHZ
there are no
Dumb Questions
Q: (OW DOES THIS WORK )S THERE
MADE IT THIS FAR WE ASSUME THAT YOU
ALREADY KNOW THE ANSWER AND WERE Q: (OW LONG DOES A STATEFUL BEAN
ONE BEAN POOL FOR ALL BEANS OR ONE JUST CONFIRMING IT KEEP CLIENT
SPECIlC STATE
BEAN POOL FOR A PARTICULAR TYPE OF ! STATEFUL BEAN REMEMBER HOLDS CLIENT
BEAN CONVERSATIONAL STATE 4HAT MEANS THE
BEAN HAS TO SAVE CLIENT
SPECIFIC STATE A: /NLY FOR THE LIFE OF THE SESSION
A: )N REALITY WE DONT KNOW WHAT
THE CONTAINER IMPLEMENTATION IS BUT
IN OTHER WORDS IT HAS TO REMEMBER
THINGS ABOUT THIS CLIENT ACROSS
! SESSION CONTINUES UNTIL THE CLIENT
TELLS THE BEAN HES DONE BY CALLING
REMOVE ON THE BEANS #OMPONENT
MULTIPLE METHOD INVOCATIONS FROM THE
CONCEPTUALLY THERES ONE POOL FOR CLIENT INTERFACE OR THE SERVER CRASHES OR THE
EVERY BEAN TYPE 3O IF YOU DEPLOY BEAN TIMES OUT WELL COVER THAT IN THE
AN !DVICE"EAN AND A 7EATHER"EAN 4HINK OF A SHOPPING CART AGAINA 3ESSION LIFECYCLE CHAPTER
AND BOTH ARE STATELESS SESSION BEANS STATEFUL BEAN NEEDS TO REMEMBER
THEYLL EACH GET THEIR OWN POOL WHATS IN THE CLIENTS CART EACH TIME THE
CLIENT CALLS ADD)TEM4O#ART ! STATELESS
BEAN ON THE OTHER HAND DOESNT HAVE Q: 3O STATEFUL SESSION BEANS
Q: $OES EACH STATELESS SESSION
TO REMEMBER ANYTHING ON THE CLIENTS
BEHALF SO TO A CLIENT ONE STATELESS ARENT SCALABLE
BEAN HAVE ITS OWN %*"/BJECT BEAN OF A PARTICULAR TYPE IS AS GOOD
AS ANY OTHER BEAN OF THAT TYPE
A: .O THEY ARE *UST NOT AS SCALABLE
A: 3ORT OF ! STATELESS SESSION
BEAN DOESNT NEED A BODYGUARD
)F THE !DVICE"EAN SIMPLY RETURNS
A PIECE OF ADVICE NOT CONNECTED
AS STATELESS BEANS
IN ANY WAY TO ANYTHING IT TOLD THE
UNTIL HES ACTUALLY INVOLVED IN A CLIENT BEFORE OR ANYTHING THE CLIENT
METHOD INVOCATION 3O THE CLIENT
GETS A REFERENCE TO AN %*"/BJECT
TOLD IT THEN THERES NO NEED FOR THE
!DVICE"EAN TO BE STATEFUL )N THAT CASE
Q: (OW CAN A STATEFUL BEAN BE
BUT THE BEAN ISNT ASSOCIATED WITH SCALABLE IF YOU ALWAYS NEED ONE BEAN
EACH TIME A CLIENT CALLS GET!DVICE
THAT %*"/BJECT UNTIL THE CLIENT CALLS FOR EVERY CLIENT
ON THE #OMPONENT INTERFACE IE THE
A BUSINESS METHOD !T THAT POINT %*"/BJECT ANY !DVICE"EAN IS JUST AS
THE BEAN SLIDES OUT OF THE POOL TO
SERVICE THE METHOD 3O THE %*"/BJECT
THE CLIENT HAS IS FOR A KIND OF BEAN
CAPABLE OF RUNNING THE METHOD AS ANY
OTHER A: 9OU DO NEED A SEPARATE BEAN
ALLOCATED FOR EACH CLIENT BUT NOT EVERY
!DVICE"EAN 7EATHER"EAN ETC BUT /N THE OTHER HAND IF THE !DVICE"EAN BEAN HAS TO BE ACTIVELY CONSUMING
NOT A SPECIFIC INSTANCE OF A BEAN WERE MODIFIED TO RETURN SAY RANDOM RESOURCES )F THE STATEFUL SESSION BEAN
BUT NON
REPEATING ADVICE THEN THE CLIENT IS TAKING A LONG TIME BETWEEN
!DVICE"EAN WOULD HAVE TO BE STATEFUL METHOD CALLS THE STATEFUL BEAN CAN
SO THAT IT COULD KEEP TRACK OF PREVIOUS BE TEMPORARILY TAKEN DOWN AND PUT
Q: 7HY DONT STATEFUL SESSION
ADVICE AND NEVER REPEAT IT IN A STATE CALLED PASSIVATION 4HIS STATE
PRESERVES THE CLIENT
SPECIFIC STATE OF
BEANS HAVE A POOL
COURSE BUT REDUCES THE NUMBER OF
BEANS CURRENTLY ALIVE IN THE SERVER 4HE
A: (AVE YOU ALREADY THOUGHT
ABOUT THIS IN THE "RAIN 0OWER ON THE
BEAN COMES OUT OF PASSIVATION AND
BACK INTO ACTIVE DUTY ACTIVATION WHEN
PREVIOUS PAGE "ECAUSE IF YOU HAVENT THE CLIENT CALLS A BUSINESS METHOD
DONT READ ANY FURTHER UNTIL YOUVE
COME UP WITH YOUR OWN IDEAS )F YOU
\RXDUHKHUH
PHVVDJHGULYHQEHDQRYHUYLHZ
)ZKPQ\MK\]ZITW^MZ ^QM_"
5M[[IOMLZQ^MVJMIV[
0HVVDJHGULYHQEHDQVGRQ¶WKDYHDFOLHQWYLHZ7KDWPHDQVWKH\GRQ¶W
KDYHLQWHUIDFHV 5HPRWHRUORFDO WKDWH[SRVHPHWKRGVWRWKHFOLHQW,Q
RWKHUZRUGVPHVVDJHGULYHQEHDQVGRQ¶WKDYHD+RPHRU(-%2EMHFW
7KH\GRQ¶WKDYHD+RPHLQWHUIDFHRUD&RPSRQHQWLQWHUIDFH
O
-DYD0HVVDJLQJ6HUYLFH -06
M VHUYLFHV
FOLHQW
E
EHDQ
D
EHDQ EHDQSRRO
The client sends a message to a JMS messaging service.
The messaging service delivers the message to the container.
The container gets a message-driven bean out of the pool.
The container delivers the message to the bean (by calling the beanÕs
onMessage() MessageListener interface method).
&KDSWHU
DUFKLWHFWXUDORYHUYLHZ
?PI\OWM[_PMZM'
3ODFHWKHREMHFWVDQGFODVVHVLQWKHDSSURSULDWHVSRWRQHLWKHU
([HUFLVH WKHFOLHQWWKHVHUYHURULQERWKSODFHV \HV\RXFDQUHXVHDQ
REMHFW 1RWH QRWDOOWKHSLHFHVDUHKHUHVRZKHQ\RX¶UHGRQH
LI\RXFDQWKLQNRIRWKHUWKLQJVWKDWVKRXOGJRLQWRWKHSLFWXUH
FODVVHVRUREMHFWV GUDZWKHPLQ
FOLHQW VHUYHU
(-%
REMHFW
(-%2EMHFWLQWHUIDFH
EHDQ
FOLHQWFODVV
VWXE
'%
EHDQFODVV VWXE
KRPHFODVV
KRPHVWXEFODVV
+RPH
REMHFW
\RXDUHKHUH
EHDQWDEOH
7ZOIVQbMaW]ZJMIV[
)LQLVKWKHWDEOHE\SXWWLQJLQDFKHFNPDUN HYHQEHWWHULI\RX
([HUFLVH DGGQRWHV LQWKHER[HVFRUUHVSRQGLQJWRWKHODEHOVWKDWDSSO\
WRWKDWEHDQW\SH:H¶YHGRQHRQHRIWKHER[HVIRU\RX,I\RX
JHWVWXFNJREDFNWKURXJKWKHSUHYLRXVWZRFKDSWHUV<RXPLJKW
KDYHWRPDNH\RXUEHVWJXHVVRQDIHZWKLQJV7KDW¶V2.²
\RX¶OOKDYHLWDOOZRUNHGRXWZD\EHIRUHWKHHQGRIWKHERRN:H
EHOLHYHLQ\RX<RXFDQGRLW>FXHWKHPHVRQJIURP³5RFN\´@
6WDWHIXO6HVVLRQ 6WDWHIXO6HVVLRQ (QWLW\%HDQV 0HVVDJHGULYHQ
%HDQV %HDQV %HDQV
8VHVDSRRO Yes. Since they
donÕt keep any
client-speciÞc data,
you donÕt need one
per each client.
0XOWLSOHFOLHQWVFDQKDYHDUHIHUHQFH
WRWKHVDPHEHDQ
*XDUDQWHHGWRVXUYLYHDFRQWDLQHU
FUDVK
+DVDFOLHQWYLHZ
$OORZVDV\QFKURQRXVFRPPXQLFDWLRQ
5HSUHVHQWVDSURFHVV
5HSUHVHQWVD´WKLQJµLQDQXQGHUO\
LQJSHUVLVWHQWVWRUH OLNHDGDWDEDVH
&KDSWHU
H[HUFLVHVROXWLRQ DUFKLWHFWXUDORYHUYLHZ
([HUFLVH
6ROXWLRQV
?PI\OWM[_PMZM'
EHDQ
EHDQFODVV
VWXE (-%
(-%2EMHFWLQWHUIDFH
REMHFW
(-%2EMHFWLQWHUIDFH
+RPH
KRPHVWXEFODVV
REMHFW
FOLHQWFODVV VWXE
KRPHFODVV KRPHVWXEFODVV
FOLHQW VHUYHU '%
127( \RXZRQ¶W¿QGD¿QLVKHGVROXWLRQIRUWKH2UJDQL]H
<RXU%HDQVWDEOH:HZDQW<28WR¿OOWKLVRXW,W¶V\HW
DQRWKHUVSHFLDO/HDUQLQJ2SSRUWXQLW\IRUZKLFK\RX¶OO
DOZD\VUHPHPEHUXVZLWKIRQGQHVV
\RXDUHKHUH
(-%DUFKLWHFWXUH
2KPDQ7KLVFKDSWHUZDV
TXLWHDQRUGHDO&DQZHSOHDVH
MXVWVNLSWKHH[DPTXHVWLRQVIRUWKLV
FKDSWHU",SURPLVH,·OOGRWKHPLQDOO
WKHRWKHUFKDSWHUV
<RX¶UHLQOXFN7KLVFKDSWHULV
DOOEDFNJURXQGNQRZOHGJHVR
WKHUHDUHQ¶WDQ\REMHFWLYHVRU
H[DPTXHVWLRQV
$SSUHFLDWHWKHPRPHQW²
&KDSWHULVMXVWDSDJHWXUQ
DZD\
&KDSWHU
the client view
5 4
4 ([SRVLQJ<RXUVHOI
<RXFDQ·WNHHS\RXUEHDQSULYDWH&OLHQWVQHHGWRVHHZKDW\RX¶YHJRW
([FHSWIRUPHVVDJHGULYHQEHDQVZKLFKGRQ¶WKDYHDFOLHQWYLHZ 7KH$GYLFH%HDQ
H[SRVHGWKHJHW$GYLFH PHWKRGLQLWV&RPSRQHQWLQWHUIDFH²WKHSODFHZKHUH\RXGHFODUH
EXVLQHVVPHWKRGV%XWWKDW¶VQRWDOOWKHFOLHQWVHHV5HPHPEHUWKH$GYLFHLQWHUIDFH
H[WHQGHG(-%2EMHFWDQLQWHUIDFHZLWKPHWKRGVRILWVRZQ0HWKRGVWKHFOLHQWFDQVHH
0HWKRGVWKHFOLHQWFDQFDOO$QGLWZRUNVWKHVDPHZD\ZLWKWKH+RPHLQWHUIDFH,QWKLV
FKDSWHUZH¶OOOHDUQZKDW\RXUHDOO\H[SRVHWRWKHFOLHQWDQGKRZWKHFOLHQWZRUNVLQFOXGLQJ
ERWK5HPRWHDQGORFDOLQWHUIDFHV
WKLVLVDQHZFKDSWHU
H[DPREMHFWLYHV
7KH&OLHQW9LHZ
2IILFLDO :KDWLWUHDOO\PHDQV
,GHQWLI\FRUUHFWDQGLQFRUUHFW <RXKDYHWRNQRZHYHU\WKLQJDERXWWKHKRPHLQWHUIDFH
VWDWHPHQWVRUH[DPSOHVDERXWWKH 7KLVSDUWLFXODUREMHFWLYHGRHVQ¶WLQFOXGHWKHVSHFLDO
FOLHQWYLHZRIDVHVVLRQEHDQ¶VORFDO FKDUDFWHULVWLFVRIDQHQWLW\EHDQKRPHEXWPRVWRIWKH
DQGUHPRWHKRPHLQWHUIDFHVLQFOXGLQJ GHWDLOVDERXWWKHFOLHQW¶VYLHZRIDEHDQ¶VKRPHDUHVWLOO
WKHFRGHXVHGE\WKHFOLHQWWRORFDWHD FRYHUHGLQWKLVREMHFWLYH DQGWKLVFKDSWHU
VHVVLRQEHDQ¶VKRPHLQWHUIDFH )RUH[DPSOH\RXKDYHWRNQRZH[DFWO\ZKLFKPHWKRGV
DUHLQMDYD[HME(-%+RPH WKH5HPRWHKRPHLQWHUIDFH
DQGZKLFKPHWKRGVDUHLQMDYD[HME(-%/RFDO+RPH
WKHORFDOKRPHLQWHUIDFH $QGLW¶VQRWHQRXJKWRNQRZ
ZKDWWKHPHWKRGVDUH²\RXDOVRKDYHWRNQRZWKH
FLUFXPVWDQFHVXQGHUZKLFKWKH\FDQEHFDOOHG<RXKDYH
WRNQRZIRULQVWDQFHWKDWD5HPRWHVHVVLRQEHDQFOLHQW
FDQUHPRYHDEHDQXVLQJWKHEHDQ¶VKRPHEXWDORFDO
FOLHQWFDQQRW$QG\RXKDYHWRNQRZWKDWDORFDOKRPH
KDVIHZHUPHWKRGVWKDQD5HPRWHKRPHDQGZKDWWKDW
PHDQVIRUWKHFOLHQW
)LQDOO\IRU2EMHFWLYH\RXKDYHWRNQRZWKHLQVDQG
RXWVRIKRZDFOLHQWGRHVD-1',ORRNXSRQDEHDQ¶V
KRPHLQWHUIDFH7KDWLQFOXGHVWKHV\QWD[RIWKHFOLHQW¶V
ORRNXSFRGHWKHUXOHVIRUSHUIRUPLQJWKHORRNXSDQG
KRZWRXVHWKHKRPHLQWHUIDFHWRJHWDUHIHUHQFHWR
DEHDQ¶VFRPSRQHQWLQWHUIDFH<RXKDYHWRNQRZIRU
H[DPSOHWKHUXOHVIRUQDUURZLQJDKRPHVWXEDQGJLYHQ
DFRGHVQLSSHW\RXPXVWEHDEOHWRUHFRJQL]HZKHWKHU
WKHFOLHQWLVORFDORU5HPRWH
,GHQWLI\FRUUHFWDQGLQFRUUHFW 7KLVREMHFWLYHLVMXVWOLNHH[FHSWLW¶VDERXWWKH
VWDWHPHQWVRUH[DPSOHVDERXWWKH FRPSRQHQWLQWHUIDFH%XWDJDLQ\RXPXVWNQRZDOOWKH
FOLHQWYLHZRIDVHVVLRQEHDQ¶VORFDO PHWKRGVRIERWKMDYD[HME(-%2EMHFWDQG
DQGUHPRWHFRPSRQHQWLQWHUIDFHV MDYD[HME(-%/RFDO2EMHFWDQGKRZWKH\¶UHXVHGE\WKH
FOLHQWDQG\RXPXVWEHDEOHWRUHFRJQL]HWKHGLIIHUHQFH
EHWZHHQD5HPRWHDQGORFDOFOLHQWMXVWE\ORRNLQJDW
FRGH
&KDSWHU
WKHFOLHQWYLHZ
?PI\\PMKTQMV\ZMITTa_IV\[
4HE CLIENT HAS A GOAL ! VISION ! QUEST 3HE WANTS TO CALL A BUSINESS METHOD ON THE
BEAN 3OMETHING EXPOSED IN THE COMPONENT INTERFACE .EVER FORGET THAT ULTIMATE
GOAL IT IS EASY TO GET BOGGED DOWN IN ALL THE DETAILS "UT IF YOU KEEP FOCUSED ON THE
CLIENTS DRIVING NEED YOULL HAVE A MUCH EASIER TIME REMEMBERING THINGS LIKE SAY
THE RETURN TYPE OF A SESSION BEANS HOME CREATE METHOD
%XW,FDQ·W %XWKRZGR,JHWD
JHWDUHIHUHQFH UHIHUHQFHWRWKH(-%REMHFW"
WRWKHEHDQ,KDYHWR ,KDYHWRJRWKURXJKWKHEHDQ·V
:KDW,UHDOO\ JRWKURXJKWKHEHDQ·V KRPH<HDKWKDW·VULJKW,QHHG
ZDQWLVWRFDOOD FRPSRQHQWLQWHUIDFH WRVWDUWE\JHWWLQJWKHVWXEWR
EXVLQHVVPHWKRGRQ WKH(-%REMHFW WKHEHDQ·V+RPHREMHFW
DEHDQ
\RXDUHKHUH
WKH+RPHLQWHUIDFH
1\ITT[\IZ\[_Q\P\PMPWUMQV\MZNIKM
4HE CLIENT WANTS THE BEAN 7ELL TOO BAD 4HE
CLIENT WILL NEVER GET THE BEAN BECAUSE NOBODY
TALKS TO THE BEAN EXCEPT THE CONTAINER
4HE BEST THE CLIENT CAN HOPE FOR IS A
REFERENCE TO THE BEANS BODYGUARDTHE
COMPONENT INTERFACE !ND THE CLIENT
GETS A REFERENCE TO THE BEANS COMPONENT :KDWWKHFOLHQW5($//<
INTERFACE BY CALLING A METHOD ON THE
BEANS HOME INTERFACE ZDQWVLVDUHIHUHQFHWRWKH
WKHUH DUH QR EHDQ%XWWKHEHVWWKHFOLHQW
'XPE 4XHVWLRQV
FDQGRLVJHWDUHIHUHQFH
Q: (OW COME YOU SAID h!ND THE CLIENT GETS A REFERENCE TO
WRWKHEHDQ·VFRPSRQHQW
THE BEANS COMPONENT INTERFACEv 9OU CANT HAVE A REFERENCE TO
AN INTERFACE IN *AVAYOU CAN REFERENCE AN OBJECT BUT YOU CANT
REFERENCE AN INTERFACE 4HE REFERENCE VARIABLE CAN BE DECLARED
LQWHUIDFHWKH(-%REMHFW
AS AN INTERFACE TYPE BUT THATS NOT THE SAME THING
%XWLIVKHZDQWVDQ(-%
A: 7ELL ACTUALLY IT IS THE SAME THING )N THIS BOOK AND IN THE REMHFWUHIHUHQFHWKHFOLHQW
SPEC AND IN THE EXAM EVERYWHERE YOU SEE THE PHRASE hREFERENCE
TO AN INTERFACEv DO A MENTAL SEARCH AND REPLACE TO MAKE IT KDVWRJHWDUHIHUHQFHWRWKH
hREFERENCE TO AN OBJECT THAT IMPLEMENTS THE INTERFACEv
EHDQ·VKRPHLQWHUIDFH
)T CAN FEEL A LITTLE STRANGE IF YOU HAVENT READ DOCUMENTS THAT USE
THIS CONVENTION BUT YOU BETTER GET USED TO IT "UT DONT WORRY BY
#HAPTER YOULL WONDER HOW ANYONE EVER SAID IT DIFFERENTLY 6RWKDW·VZKHUHLWEHJLQV
WKHFOLHQWGRHVDORRNXSRQ
Q: 9OU SAID THE CLIENTS ULTIMATE GOAL IS TO CALL METHODS ON
WKHEHDQ·VKRPH
THE BEAN /+ THE COMPONENT INTERFACE BUT YOU KNOW WHAT )
MEAN "UT WITH ENTITY BEANS YOU CAN HAVE BUSINESS METHODS
IN THE HOME RIGHT 3O WITH ENTITY BEANS ISNT IT TRUE THAT
SOMETIMES THE CLIENTS GOAL IS *534 TO USE THE HOME
A: 9ES YOURE RIGHT 4HEYRE CALLED hHOME BUSINESS METHODSv
AS OPPOSED TO PLAIN OLD hHOME METHODSv OR PLAIN OLD hBUSINESS
METHODSv "UT THEYRE A SPECIAL CASE WELL LOOK AT LATER IN THE
BOOK 4HERE ARE OTHER REASONS TOO FOR WHY YOU MIGHT NEED ONLY
:HXVHWKHZRUG³(-%REMHFW´WRPHDQWKH
THE HOME OF AN ENTITY BEAN &OR EXAMPLE IF YOU WANT TO CREATE A EHDQ¶VFRPSRQHQWLQWHUIDFH WKHERG\JXDUG
BUNCH OF NEW CUSTOMERS IN A DATABASE BUT YOU DONT WANT TO DO LHWKHWKLQJUHFHLYLQJPHWKRGFDOOVPHDQW
ANY OTHER OPERATIONS ON REFERENCES TO THOSE ENTITY CUSTOMERS IRUWKHEHDQUHJDUGOHVVRIZKHWKHUWKHFOLHQW
LVORFDORUUHPRWH
&KDSWHU
WKHFOLHQWYLHZ
0W_IKTQMV\][M[I[M[[QWVJMIV"
KZMI\M][MIVLZMUW^M Note: over the next sev
pages, weÕre lookin eral
REMOTE interfaceg satfoonly the
LQWHUIDFH!! Later weÕll see r a bean.
5HPRWH ÒlocalÓ versions). the special-case
&UHDWH
&OLHQWDVNVWKHKRPHLQWHUIDFHIRUDUHIHUHQFHWR LQWHUIDFH!!
WKHEHDQ¶VFRPSRQHQWLQWHUIDFH (-%+RPH
PHWKRGV
:KLFKPHDQVWKHFOLHQWFDOOVDFUHDWH PHWKRG
RQWKHKRPHVWXE
LQWHUIDFH!!
per must
The bean deve()lome
put a create thod
$GYLFH+RPH me
in the bean Õs ho
FUHDWH
LQWHUIDFH!!
8VH 5HPRWH
&OLHQWFDOOVEXVLQHVVPHWKRGVGHFODUHGLQWKH
FRPSRQHQWLQWHUIDFH
:KLFKPHDQVWKHFOLHQWFDOOVPHWKRGVRQWKH(-%
REMHFWVWXE LQWHUIDFH!!
(-%2EMHFW The javax.ejb.s EJ BObject
ve()
UHPRYH interface ha clientmocan
a re
PRUHPHWKRGV meth od th e
call.
5HPRYH
&OLHQWWHOOVWKHEHDQWKDWKH¶VGRQHXVLQJLW
LQWHUIDFH!! In the c
:KLFKPHDQVWKHFOLHQWFDOOVUHPRYH RQWKH $GYLFH the deveolompeponent interface,
EHDQ¶V(-%REMHFWVWXE JHW$GYLFH business met r puts in the
compone hods, but since
the EJBnOtbjeinterface EXTENthDeS
client se t ct interface, the
BOTH inetserf he methods
from
aces.
\RXDUHKHUH
XVLQJ-1',WRJHWWKHKRPH
*]\NQZ[\_MPI^M\WOM\IPWUMQV\MZNIKMZMNMZMVKM
1VW\PMZ_WZL[_MPI^M\WOM\\PM[\]J\W\PMPWUM
WJRMK\\PM\PQVO_M][M\WKITTKZMI\M[W\PI\_MKIVOM\
_PI\_MZMITTa_IV\¸\PM-2*WJRMK\[\]J
7HEN YOU THE CLIENT WANT A REFERENCE TO A HOME INTERFACE YOU GO THROUGH
*.$) 4HE PROCESS IS PRETTY STRAIGHTFORWARD YOU GIVE *.$) A LOGICAL NAME
THE NAME THE DEPLOYER TOLD THE SERVER TO USE AND YOU GET BACK SOMETHING
THAT IMPLEMENTS THE HOME INTERFACE
ject assigned
The InitialContfeexretncobe to the JNDI
&RQWH[WLF QHZ,QLWLDO&RQWH[W to ÒicÓ is a re
lookup service.
2EMHFWR LFORRNXS ³$GYLVRU´ Give it a name
used to regist (whatever the
bean loyer
and get back an that bean with thedep
er
server)
DIHZPRUHVWHSV object.
JNDI organizesorythtrings into a
?PI\¼[26,1' eeÓ.
Òvirtual direct
e tree is eitheed r
*.$) STANDS FOR *AVA .AMING AND IRR Each level of thdi re ctor y (c all a
al
another virtu an object.
$IRECTORY )NTERFACE AND ITS AN !0) FOR
ACCESSING NAMING AND DIRECTORY SERVICES ÒcontextÓ) or...
!LTHOUGH *.$) IS QUITE POWERFUL THERE
ARE ONLY A FEW PIECES OF IT YOU NEED TO
KNOW FOR %*"HOW CLIENTS lND IT HOW EDU a JNDI Ôc
ED] ontextÕ
CLIENTS USE IT HOW BEANS USE IT AND HOW TO
PUT THINGS INTO IT
object
4HE *.$) !0) CAN WORK WITH MANY REM just a plain old
DIFFERENT SERVICES AS LONG AS THAT REM
SERVICE HAS A *.$) DRIVER CALLED A REM
3ERVICE 0ROVIDER )TS A LOT LIKE *$"# a JNDI context can
WHERE YOU THE DEVELOPER USE THE *$"# EDW hold objects as well as
!0) TO SEND 31, STATEMENTS TO A VARIETY WD] other contexts.
OF DIFFERENT DATABASES 4HE *.$) DRIVER
TRANSLATES THE METHOD CALLS YOU MAKE
ON THE *.$) !0) INTO SOMETHING THE REM
UNDERLYING NAMINGDIRECTORY SERVICE REM ]RR
UNDERSTANDS
&KDSWHU
WKHFOLHQWYLHZ
$-1',´YLUWXDO
*HWWLQJWKHKRPHLQWHUIDFHVWXE GLUHFWRU\WUHHµ
IRR LetÕs say thatthe
*HWDQ,QLWLDO&RQWH[W ÒbarÓ is where is
InitialContext
&RQWH[WLF QHZ,QLWLDO&RQWH[W for your beans.
7KH,QLWLDO&RQWH[W DVXEW\SHRI&RQWH[W LV\RXUHQWU\
SRLQWLQWRWKH-1',WUHH,W¶VVLPSO\WKH¿UVWFRQWH[WIURP EDU
ZKLFK\RXVWDUWQDYLJDWLQJ.LQGRIOLNH\RXUFXUUHQW ED]
ZRUNLQJGLUHFWRU\ WKHRQH\RXFGWR
7KH,QLWLDO&RQWH[WFRQVWUXFWRU¿JXUHVRXWZKHUH\RX REM
VKRXOGVWDUW :H¶OOWDONDERXWWKDWLQDPLQXWH %RWK REM REM
&RQWH[WDQG,QLWLDO&RQWH[WDUHSDUWRIWKHMDYD[QDPLQJ $GYLVRU
SDFNDJHSDUWRI-((EXWDOVRDGGHGWR-6(ZLWK &XVWRPHU 7D[5DWH
YHUVLRQ EDW
Whichever contex t you start wi,thifis WD]
ext. For example
your InitialContex s ÒtazÓ, then
the InitialCo yotu wa
nt
co uld lookup from
the only thing the ÒItemDBÓ object REM
here would be REM ]RR 6KRSSHU
,WHP'%
/RRNXSWKHEHDQ·VKRPHXVLQJWKH
,QLWLDO&RQWH[W
2EMHFWR LFORRNXS ³$GYLVRU´
7KHORRNXSPHWKRGWDNHVD6WULQJWKDWPXVWPDWFKWKHQDPH
DVVLJQHGWRWKLVEHDQ¶V-1',GHSOR\PHQW,IWKHGHSOR\HU
DVVLJQHGDQDGGLWLRQDOFRQWH[WWRWKHEHDQE\QDPLQJLW
DWGHSOR\WLPH ³EDW$GYLVRU´WKHQWKHORRNXSFRGHZRXOG
FKDQJHWR
LFORRNXS ³EDW$GYLVRU´
$VVLJQWKHUHVXOWRIWKHORRNXSWRWKH
+RPHLQWHUIDFHUHIHUHQFH
$GYLFH+RPHKRPH $GYLFH+RPH R Warning: This coh de isnÕt quite
it LOOKS like it
right... althougl Þn out whatÕs
7KHUHWXUQW\SHRIWKHFRQWH[WORRNXSPHWKRGLV2EMHFW should be. WeÕl fewd pages.
VR\RXKDYHWRFDVWLWEDFNWRWKHEHDQ¶VKRPHLQWHUIDFH wrong in just a
W\SHEHIRUH\RXFDQFDOO$GYLFH+RPHPHWKRGV
\RXDUHKHUH
WKH+RPHLQWHUIDFH
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: (OW DO ) KNOW WHAT THE Q: ) JUST THOUGHT OF AN EVEN
DEVELOPER NAMED THE BEAN ")''%2 PROBLEM HOW THE HECK DO )
KNOW WHERE TO lND THE SERVER !ND
A: !CTUALLY ITS NOT UP TO THE BEAN
HOW DO ) SPECIFY IT ) DIDNT SEE ANY
CODE FOR AN )0 ADDRESS OR 4#0 PORT
DEVELOPER THE %*" ROLE KNOWN AS "EAN NUMBER
0ROVIDERTHE ONE WHO ACTUALLY WROTE
THE BEAN CODE TO GIVE THE BEAN
ITS *.$) NAME 2EMEMBER THE "EAN A: 'OOD CATCH 9EAH THATS ALL
0ROVIDER MIGHT HAVE WRITTEN THAT BEAN A BIT OF A MYSTERY ISNT IT 7E HAVE
AS A REUSABLE COMPONENT FOR "EANS @2 )RUWKHH[DP\RXGRQ¶WQHHG
THREE ANSWERS FOR NOW
5S AND THUS MIGHT HAVE NO IDEA WHERE WRNQRZPXFKDERXW-1',
7ERE CHEATING A LITTLE BECAUSE
AND HOW THE BEAN WILL BE USED
THE CODE WERE USING WORKS ONLY )RUWKHFOLHQWUHODWHGREMHFWLYHV
)TS THE DEPLOYERTHE PERSON WHO BECAUSE WERE USING THE 2EFERENCE WKHRQHVIURPWKLVFKDSWHU
ACTUALLY GETS THE BEAN RUNNING IN THE )MPLEMENTATION AND EVEN THEN ONLY DOO\RXQHHGWRNQRZLVWKH
SERVER AS PART OF SOME APPLICATION BECAUSE WERE RUNNING THE SERVER ON IXQGDPHQWDOSURFHVVIRUGRLQJD
WHO REGISTERS THE BEAN UNDER A THE SAME PHYSICAL MACHINE AS THE -1',ORRNXSWKDW\RXQHHGWR
LOGICAL NAME "UT THE BOTTOM LINE IS CLIENT 3O WERE TAKING ADVANTAGE VWDUWZLWKDQ,QLWLDO&RQWH[WDQG
THAT THERES NO STANDARD OR AUTOMATIC OF DEFAULT SETTINGS THAT ARE IN PLACE WKHQFDOOORRNXS ZKLFKUHWXUQV
MECHANISM FOR LEARNING THE NAMES AUTOMATICALLY BECAUSE WERE RUNNING VRPHWKLQJRIW\SH2EMHFW
OF REGISTERED BEANS !S A CLIENT THE 2EFERENCE )MPLEMENTATION
SOMEBODY SOMEHOW HAS TO TELL YOU <RXGR127QHHGWRNQRZKRZ
7E LIED A LITTLE IN POINT NUMBER
THAT SAY THE BEAN WAS REGISTERED AS WKHFOLHQWRUVHUYHU¿QGVDQG
ABOVE BECAUSE THIS CODE COULD BE
h!DVISORv JHWVDUHIHUHQFHWRWKHFRUUHFW
CORRECT IF IT WERE INSIDE A BEAN 7ELL
.OTICE THAT h!DVISORv WHILE DESCRIBING GET TO THAT IN THE "EAN %NVIRONMENT ,QLWLDO&RQWH[WRQO\WKDWDQ
THE SERVICE IS NOT A 3TRING THAT CHAPTER ,QLWLDO&RQWH[WLVQHHGHG
CORRESPONDS DIRECTLY TO THE NAMES OF
)N REALITY A CLIENT DOES NEED TO ,QWKH%HDQ(QYLURQPHQW
ANY OF THE OTHER PIECES OF THE BEAN
KNOW HOW TO FIND THE *.$) SERVICE FKDSWHUZH¶OODGGDWLQ\ELWPRUH
2EMEMBER THE COMPONENT INTERFACE
WHERE A BEANS HOME IS REGISTERED -1',LQIRIRUKRZWKHEHDQLWVHOI
WAS !DVICE THE HOME INTERFACE WAS
4HERE ARE SEVERAL WAYS YOU CAN DO XVHV-1',WRORRNXSWKLQJVWKDW
!DVICE(OME AND THE BEAN ITSELF IS
THISYOU COULD PASS INFORMATION KDYHEHHQVSHFL¿FDOO\SODFHG
!DVICE"EAN 4HE NAME h!DVISORv WAS
TO THE )NITIAL#ONTEXT CONSTRUCTOR WKHUHIRUWKHEHDQ
JUST SOMETHING THE DEPLOYER THOUGHT
A 0ROPERTIES OBJECT THAT CONTAINS
HAD A NICE RING TO IT
EVERYTHING THE )NITIAL#ONTEXT NEEDS %XWWKDW¶VDERXWLWIRU\RXU-1',
/F COURSE IN YOUR COMPANY YOU MIGHT TO FIND THE SERVER AND THE STARTING NQRZOHGJH<RXGRQ¶WKDYHWR
AND PROBABLY WILL HAVE STRICT NAMING CONTEXT /R THERE ARE SEVERAL NQRZDQ\GHWDLOVDERXWWKHUHVW
GUIDELINES TO FOLLOW FOR HOW BEANS ARE PLACES WHERE *.$) PROPERTIES CAN RIWKH-1',$3,RWKHUWKDQWKH
REGISTERED WITH *.$) AT DEPLOYMENT BE PLACED ON THE CLIENTS MACHINE &RQWH[WORRNXS PHWKRG
TIME )N EITHER CASE THE CLIENT -534 BE
5NLESS ITS YOUR OWN COMPANY IN GIVEN SOMETHINGEITHER INFO FOR
WHICH CASE YOU CAN DO WHATEVER YOU THE )NITIAL#ONTEXT CONSTRUCTOR OR A
DARN WELL PLEASE INCLUDING NAMING PROPERTIES FILE )TS DIFFERENT FOR EACH
EACH BEAN AFTER YOUR FAVORITE ROCK STAR VENDORS SERVER TOO SO YOU HAVE TO
OR -ATRIX CHARACTER CHECK YOUR DOCUMENTATION IN ORDER
TO KNOW WHAT THE CLIENT NEEDS
&KDSWHU
WKHFOLHQWYLHZ
4M\¼[\ISMIVW\PMZTWWSI\\PMKWUXTM\MKTQMV\KWLM
LPSRUWMDYD[QDPLQJ
LPSRUWMDYDUPL
weÕll look
LPSRUWMDYD[UPL
A bunch of impoivirtdus, ally at the
LPSRUWKHDG¿UVW
at each one ind page
LPSRUWMDYD[HME
bottom of the
SXEOLFFODVV$GYLFH&OLHQW^
SXEOLFVWDWLFYRLGPDLQ 6WULQJ>@DUJV ^
o the
is our entry pointdoint
QHZ$GYLFH&OLHQW JR
` InitialContext , wh ere we th e lookup
JN DI naming service rÓ
SXEOLFYRLGJR ^
WU\^
on the name ÒAdviso
&RQWH[WLF QHZ,QLWLDO&RQWH[W What is THIS??? Why
2EMHFWR LFORRNXS ³$GYLVRU´ just a plain old ca not
st?
$GYLFH+RPHKRPH $GYLFH+RPH 3RUWDEOH5HPRWH2EMHFWQDUURZ R$GYLFH+RPHFODVV
Call create on the home
$GYLFHDGYLVRU KRPHFUHDWH to get us wh
REALLY want Ñ the at
component interfawe
ce.
6\VWHPRXWSULQWOQ DGYLVRUJHW$GYLFH
`FDWFK 5HPRWH([FHSWLRQUH[ ^ The point of everything! To call a business
UH[SULQW6WDFN7UDFH method on the bean (via the EJBObject stub)
`FDWFK &UHDWH([FHSWLRQFH[ ^
FH[SULQW6WDFN7UDFH
`FDWFK ([FHSWLRQH[ ^
Not a good way to handle (or ns
H[SULQW6WDFN7UDFH ha nd le) exceptio
` rather, NOTe want to show some
` here... but wked exceptions...
` of the chec
6KDUSHQ \RXU SHQFLO
0ACKAGE .AME #LASS .AME
-ATCH THE CLASS NAME WITH MDYD[QDPLQJ ,QLWLDO&RQWH[W
THE PACKAGE ITS FROM 9OU CAN
USE THE SAME PACKAGE NAME MDYDUPL $GYLFH+RPH
MORE THAN ONCE
MDYD[UPL 3RUWDEOH5HPRWH2EMHFW
)F YOURE NOT SURE MAKE YOUR
BEST GUESS
KHDG¿UVW 5HPRWH([FHSWLRQ
MDYD[HME $GYLFH
&UHDWH([FHSWLRQ
\RXDUHKHUH
FDVWLQJDQGQDUURZLQJ
2][\_PMVaW]\PW]OP\I[QUXTMKI[\_W]TLJMMVW]OP
4HE RETURN VALUE OF THE #ONTEXTLOOKUP METHOD IS TYPE /BJECT 3O WERE
THINKING A SIMPLE CAST SHOULD BE ENOUGH TO FORCE THE OBJECT REFERENCED BY O
BACK TO THE !DVICE(OME IMPLEMENTATION THAT WE KNOW IT REALLY IS
&RQWH[WLF QHZ,QLWLDO&RQWH[W
This LOOKS right , but isnÕt.
2EMHFWR LFORRNXS ³$GYLVRU´ interface,
$GYLFH+RPHKRPH $GYLFH+RPH R With a Remoteenhooume
gh .
casting is no t
*]\67AW]PI^M\WVIZZW_\PMWJRMK\I[_MTT
.ARROWING FORCES THE OBJECT RETURNED FROM THE *.$) LOOKUP TO BE ABSOLUTELY
POSITIVELY SOMETHING THAT IMPLEMENTS THE HOME INTERFACE )N OTHER WORDS
SOMETHING YOU CAN CAST TO !DVICE(OME
&RQWH[WLF QHZ,QLWLDO&RQWH[W
2EMHFWR LFORRNXS ³$GYLVRU´
$GYLFH+RPHKRPH $GYLFH+RPH 3RUWDEOH5HPRWH2EMHFWQDUURZ R$GYLFH+RPHFODVV
731¼TTJQ\M?PaKIV¼\aW]R][\LWIXTIQVWTLKI[\ '
!CCORDING TO THE SPEC YOUTHE CLIENTMUST ASSUME THAT THE SERVER IS USING 2-)
))/0 RATHER THAN REGULAR OLD 2-) .ORMAL 2-) USES *2-0 AS THE WIRE PROTOCOL
WHICH ASSUMES THAT WERE ALWAYS TALKING *AVA ALL THE WAY DOWN )F THIS WERE PLAIN
2-) YOUD ALWAYS KNOW THAT WHAT YOU GET OUT OF THE LOOKUP IS POLYMORPHICALLY
SOMETHING THAT )3
! HOME INTERFACE )N OTHER WORDS AN OBJECT WHOSE CLASS TYPE
IMPLEMENTS THE HOME INTERFACE FOR THAT BEAN !ND FOR THAT SCENARIO A NORMAL *AVA
LANGUAGE CAST WOULD LET YOU ASSIGN THE OBJECT BACK TO THE HOME INTERFACE TYPE
SO THAT YOU CAN CALL THE HOME METHODS /THERWISE REMEMBER YOUD BE STUCK
CALLING ONLY METHODS OF TYPE /BJECT EQUALS HASH#ODE TO3TRING ETC
WHEN WHAT YOU REALLY WANT TO CALL IS CREATE
"UT WHEN THE WIRE PROTOCOL IS ))/0 THE RULES CHANGE A LITTLE 4HE NARROW
OPERATION GIVES YOU SOMETHING THAT IS CASTABLE
&KDSWHU
WKHFOLHQWYLHZ
8WZ\IJTM:MUW\M7JRMK\VIZZW_
4HE JAVAXRMI0ORTABLE2EMOTE/BJECTS NARROW METHOD
RUNS CODE WRITTEN BY THE SERVER VENDOR "UT ALL WE CARE ABOUT
IS THAT IT TAKES THE OBJECT WE GOT FROM *.$) AND GIVES US BACK
SOMETHING THAT REALLY DOES IMPLEMENT THE HOME INTERFACE 7KHKRPHVWXEUHWXUQHGIURP
)N OTHER WORDS IT GIVES US BACK SOMETHING WE CAN THEN CAST
TO THE HOME INTERFACE TYPE AND CALL CREATE
D-1',ORRNXSPLJKWQRW
LPSOHPHQWWKHKRPHLQWHUIDFH
<RXPLJKWJHWEDFNDQ,,23
3RUWDEOH5HPRWH2EMHFWQDUURZ R$GYLFH+RPHFODVV
VWXEWKDWLVQ·WFDVWDEOHWRWKH
the object you the interfac KRPHLQWHUIDFHRI\RXUEHDQ
got from JNDI want it to bee. ty pe you
It must
be a Remote inte
rface! $QGWKDWPHDQV\RXFRXOGQ·W
FDOOFUHDWH
7RJHWDVWXEWKDW·VFDVWDEOH
HWDLOVRI,,23
Q ¶WQ HH G WR NQRZWKHG WRWKHKRPHLQWHUIDFH\RX
<RXGR
23
NQRZKRZ,, KDYHWRILUVWQDUURZ WKH
GRQ¶WQHHGWR -DYD
)RU(-%\RX LQWHQGWRG HY HO RS Q RQ
QO HV V\R X H 1 RW
ZRUNVX ¶WJRWKHU
&2 5 % $ F OLHQW V%XWZHZRQ H[ DP H LWK HU REMHFW\RXJHWIURPWKH-1',
H ER RN D QG QRWLQWKH
KHUHLQWK IVFRSH ORRNXSRQWKHEHDQKRPH
UHZD\RXWR
7KHGHWDLOVD
HF
ZWKDWWKHVS
QHHGWRNQR DWWKH %XWRQO\ZKHQWKHKRPH
%XW\RX'2 D VV XP HWK
Q3URYLGHUVWR DW\RXUEHDQ
UHTXLUHV%HD WK
XV LQJ,,23DQG LQWHUIDFHLV5HPRWH
FRQWDLQHULV LD QW
FRPSO
PXVWEH,,23 FRPSOLDQW"
VLWWD NHWREH,,23 HG
:KD WG RH VZKHQQHHG
H5HPRWHVWXE
1DUURZLQJWK IRWK HU WLQ\ ,,2 3
HDFRXSOHR
$QGWKHUHDU WLQWK LVFKDSWHU
RN D
LVVXHVZH¶OOOR \ RX '2KDYHWRE
H
QHLVWKDW GRQ¶W
7KHERWWRPOL VH GE XW \ RX
23LVEHLQJX H¶OO
DZDUHWKDW,, KP RU HWKDQWKDW:
WR N QR Z P XF Z D ER XW
QH HG WRN QR
LQJ\RXQHHG
FRYHUHYHU\WK RQ H
HFKDSWHU¶VG
,,23EHIRUHWK
\RXDUHKHUH
3RUWDEOH5HPRWH2EMHFWQDUURZ
:LWKD5HPRWH
KRPHVWXEIURP
-1',DQRUGLQDU\FDVW
LVQ·WJRRGHQRXJK<RXQHHG
VRPHWKLQJPRUHH[RWLF
\RXQHHGWRQDUURZLW
7KLQNRIQDUURZLQJDV
´([RWLF&DVWLQJµ
.ARROWING IS NOT THE SAME AS CASTING BUT YOU
CAN THINK OF IT AS A FORM OF hEXOTIC CASTINGv
#ASTING IS ABOUT POLYMORPHISM 7ITH A CAST
THE OBJECT DOESNT CHANGE BUT THE WAY YOU
REFER TO THAT OBJECT DOES 7ITH NARROWING YOU
MIGHT ACTUALLY GET A DIFFERENT OBJECT
&DVW
$QLPDODQL QHZ'RJ
'RJ¿GR 'RJ DQL
'RJ
Casting lets yo u see
REMHFW
ONE ob je ct in multiple
e
ways. The reines nc
fe re
w hat
type de te rm
u ca n call,
Yfa
methods yo ct itself
^a\g
but the obje itÕs a Dog.
$QLPDO
always knows
'RJ
1DUURZ
QDUURZ R$GYLFH+RPHFODVV
The narrow method
,,23 might return a
KRPH
VWXE
VWXE
completely different
object (or it might
not). But regardless,
g youÕll get a stub that
`ge] really DOES implem
2EMHFW the interface, so youent
$GYLFH+RPH can then cast it.
&KDSWHU
WKHFOLHQWYLHZ
1RZWKDWZH ÀQDOO\ KDYHWKHKRPHVWXE
OHW·VXVHLWWRJHWZKDWZH5($//<ZDQW
&DOOFUHDWH RQWKHKRPHLQWHUIDFHWR
JHWWKH(-%REMHFWVWXE :DLWDPLQXWHKRZ
FRPHZHGLGQ·WKDYHWR
FDVWDQGQDUURZWKH(-%
$GYLFHDGYLVRU KRPHFUHDWH
REMHFWVWXEEXWZHKDGWR
7KHFUHDWHPHWKRGUHWXUQVDUHIHUHQFHWRWKH IRUWKHKRPHVWXE"
FRPSRQHQWLQWHUIDFH$GYLFH,QRWKHUZRUGVLWUHWXUQV
DVWXEWRWKH(-%REMHFW ZKLFKLPSOHPHQWV$GYLFHWKH
5HPRWHFRPSRQHQWLQWHUIDFHIRUWKLVEHDQ <RXGRQ¶W
QHHGWRFDVWDQGQDUURZWKH(-%REMHFWVWXE
&DOODEXVLQHVVPHWKRGRQWKH
FRPSRQHQWLQWHUIDFH (-%REMHFWVWXE
6\VWHPRXWSULQWOQ DGYLVRUJHW$GYLFH
1RWKLQJVSHFLDOKHUH,W¶VMXVWDSODLQROGPHWKRGFDOORQWKH
UHIHUHQFHWRWKH$GYLFHLQWHUIDFH
:HOOQRWTXLWH5HPHPEHUHYHU\5HPRWHPHWKRGFDOO
GHFODUHVD5HPRWH([FHSWLRQ$QGWKDW¶VDFKHFNHG
H[FHSWLRQVR\RX0867KDQGOHRUGHFODUHLW
WU\^
6\VWHPRXWSULQWOQ DGYLVRUJHW$GYLFH
`FDWFK 5HPRWH([FHSWLRQUH[ ^
UH[SULQW6WDFN7UDFH
`
9
1
\RXDUHKHUH
GRQ¶WQDUURZWKH(-%2EMHFW
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: /+ ) KNOW ) KNOW ) DONT NEED TO LEARN THE
DETAILS OF ))/0 BUT ) STILL WANT TO UNDERSTAND 7(9 THEY
USE IT
A:
/+ A LITTLE MORE ))/0 THE WIRE PROTOCOL FOR
#/2"! CAN REPRESENT MORE INFORMATION THAN PLAIN 2-)
&OR EXAMPLE ))/0 CAN PROPAGATE BOTH TRANSACTION AND
SECURITY INFORMATION IMPORTANT THINGS THAT YOU CANT 7KHGHFODUHGUHWXUQW\SHRI
SEND WITH A NON
))/0 REMOTE METHOD CALL
3O ))/0 LETS A CONTAINER AT LEAST HAVE THE POTENTIAL FOR FUHDWH LVWKHFRPSRQHQW
INTEROPERATING WITH OTHER SERVERS INCLUDING POSSIBLY
ONE THAT ISNT *AVA
BASED LQWHUIDFHQRW2EMHFW
2EMEMBER #/2"! IS A STANDARD THAT AMONG OTHER
THINGS CAN GIVE TWO OBJECTS WRITTEN IN TWO DIFFERENT
LANGUAGES A CHANCE TO INVOKE EACH OTHERS METHODS
4HIS DOES NOT MEAN THAT YOUR SERVER IS NECESSARILY USING
6RWKH(-%REMHFWFRPHVEDFN
))/0 4HE SPEC SAYS THAT 9/5THE DEVELOPERHAVE TO
ASSUME THE SERVER IS USING ))/0 WHICH MEANS YOU HAVE IURPFUHDWH DOUHDG\NQRZLQJ
TO BE SURE YOUR BEANS ARE ))/0
COMPLIANT WELL TALK
ABOUT ))/0 COMPLIANCE A LITTLE LATER IN THIS CHAPTER ZKDWLWLV DQLPSOHPHQWDWLRQ
Q: )F MY SERVER DOESNT USE ))/0 DO ) STILL HAVE TO
RI\RXUFRPSRQHQWLQWHUIDFH
DO THE WHOLE NARROWING THING
A:
9ES AND NO 9OUR CODE MIGHT WORK JUST FINE WITH
SXEOLF$GYLFHFUHDWH
NOTHING MORE THAN A CAST "UTAND THIS IS A REALLY HUGE
BUTYOUR CLIENT CODE WONT BE VENDOR
INDEPENDENT )N
e home
The return type ofmeththod is
OTHER WORDS YOU WONT HAVE A PORTABLE APP IF YOU DONT
USE NARROW BECAUSE REDEPLOYING THE BEAN ON A SERVER ()
interface create
THAT DOES USE ))/0 WILL BREAK THE CLIENTS t interface
ALWAYS the componen
doesnÕt need
Q: )S THERE ANY DOWNSIDE TO USING NARROW %SPE
So the EJB object..stub
a cast or a narrow
CIALLY IF THE SERVER IS NOT USING ))/0
A:
.O DOWNSIDE WELL WHATEVER OVERHEAD THERE
IS WOULDNT BE WORTH THE PORTABILITY TRADEOFF )F YOUR
SERVER ISNT USING ))/0 NARROW IS MOST LIKELY A NO
OP IE
DO
NOTHING METHOD 4HE SPEC SAYS TO ALWAYS NARROW
AND IT WONT HURT YOU IF IT ISNT NEEDED
&KDSWHU
WKHFOLHQWYLHZ
?ZQ\QVO\PM:MUW\MPWUMQV\MZNIKMNWZI[M[[QWVJMIV
.OW THAT YOUVE SEEN THE LOOKUP AND CREATE PROCESS FROM THE CLIENTS POINT OF VIEW
WELL SEE WHAT YOU HAVE TO DO TO WRITE A HOME INTERFACE FOR YOUR BEAN &OR SESSION
BEANS THE PROCESS IS VERY EASY )N FACT FOR STATELESS SESSION BEANS ITS LUDICROUSLY
EASYYOU JUST DECLARE A SINGLE NO
ARG CREATE METHOD
SDFNDJHKHDG¿UVW
LPSRUWMDYD[HME
LPSRUWMDYDUPL5HPRWH([FHSWLRQ
SXEOLFLQWHUIDFH$GYLFH+RPHH[WHQGV(-%+RPH^
SXEOLF$GYLFHFUHDWH WKURZV&UHDWH([FHSWLRQ5HPRWH([FHSWLRQ
5XOHVIRUWKHKRPHLQWHUIDFH
,PSRUWMDYD[HME DQGMDYDUPL5HPRWH([FHSWLRQ
([WHQG(-%+RPH
'HFODUHDFUHDWH PHWKRGWKDWUHWXUQVWKHFRPSRQHQWLQWHUIDFHDQG
GHFODUHVD&UHDWH([FHSWLRQDQG5HPRWH([FHSWLRQ
4 )RUVWDWHOHVVVHVVLRQEHDQVWKHUHFDQEHRQO\RQHFUHDWH DQGLWPXVW127
KDYHDUJXPHQWV
4 6WDWHIXOVHVVLRQEHDQVFDQKDYHPXOWLSOHRYHUORDGHGFUHDWH PHWKRGVDQG
GR127QHHGWRKDYHDQRDUJFUHDWH
4 $OOFUHDWH PHWKRGVPXVWGHFODUHD&UHDWH([FHSWLRQDQG5HPRWH([FHSWLRQ
EXWWKH\FDQDOVRGHFODUHRWKHUDSSOLFDWLRQ FKHFNHG H[FHSWLRQV
4 7KHQDPHRIFUHDWHPHWKRGVLQVWDWHIXOEHDQVPXVWEHJLQZLWK³FUHDWH´
FUHDWH$FFRXQW FUHDWH%LJ'RJ FUHDWH)DVKLRQ$GYLVRU HWF
4 )RUVWDWHIXOVHVVLRQEHDQVDUJXPHQWVPXVWEH50,,,23FRPSDWLEOH \RX
NQRZ6HULDOL]DEOHSULPWLYH5HPRWHRUDUUD\VRUFROOHFWLRQVRIDQ\RIWKRVH
\RXDUHKHUH
WKH+RPHLQWHUIDFH
:MUW\MPWUMQV\MZNIKMM`IUXTM[NWZ[M[[QWVJMIV[
4HE EXAMPLES ON THIS PAGE ARE ALL LEGAL EXAMPLES OF 2EMOTE HOME INTERFACES
9OULL SEE SOME THAT COULD BE BOTH STATELESS AND STATEFUL AND SOME THAT COULD BE
ONLY STATEFUL BECAUSE THEY HAVE A CREATE METHOD WITH ARGUMENTS 7EVE DROPPED
THE PACKAGE AND IMPORT STATEMENTS TO PUT MORE ON THE PAGE
SXEOLFLQWHUIDFH&DUW+RPHH[WHQGV(-%+RPH^
SXEOLF&DUWFUHDWH 6WULQJVWRUH,' WKURZV&UHDWH([FHSWLRQ5HPRWH([FHSWLRQ
SXEOLF&DUWFUHDWH WKURZV&UHDWH([FHSWLRQ5HPRWH([FHSWLRQ
`
SXEOLFLQWHUIDFH0DWFKHU+RPHH[WHQGV(-%+RPH^
SXEOLF0DWFKHUFUHDWH 6WULQJFXVWRPHU,' WKURZV&UHDWH([FHSWLRQ5HPRWH([FHSWLRQ
SXEOLF0DWFKHUFUHDWH1HZ&XVWRPHU 6WULQJQDPH6WULQJORJLQ
WKURZV&UHDWH([FHSWLRQ5HPRWH([FHSWLRQ
`
SXEOLFLQWHUIDFH7LFNHWV+RPHH[WHQGV(-%+RPH^
SXEOLF7LFNHWVFUHDWH WKURZV&UHDWH([FHSWLRQ5HPRWH([FHSWLRQ
`
SXEOLFLQWHUIDFH&OXE+RPHH[WHQGV(-%+RPH^
SXEOLF&OXEFUHDWH([LVWLQJ 6WULQJFOXE,' WKURZV&UHDWH([FHSWLRQ5HPRWH([FHSWLRQ
SXEOLF&OXEFUHDWH1HZ&OXE 6WULQJFOXE1DPH WKURZV&UHDWH([FHSWLRQ5HPRWH([FHSWLRQ
`
7KHUH¶VRQO\RQHLQWHUIDFHKHUHWKDWFRXOGEHDVWDWHOHVVVHVVLRQEHDQ¶V
KRPH²QXPEHU1RWLFHWRRWKDWQXPEHUKDVWZRFUHDWHPHWKRGVWKDW
ERWKKDYHWKHVDPHDUJXPHQW²D6WULQJ²EXWWKHPHWKRGVDUHQDPHG
GLIIHUHQWO\WRUHÀHFWZKDWWKDWSDUWLFXODUFUHDWHPHWKRGLVIRU
&KDSWHU
WKHFOLHQWYLHZ
,ZRQGHUZKDWHOVH
,FDQGRZLWKWKHKRPH
LQWHUIDFH,NQRZWKHUH·V
PRUHWKDQMXVWWKHFUHDWH
PHWKRGZKDWPHWKRGVDUH
LQ(-%+RPH"
LQWHUIDFH!!
5HPRWH
LQWHUIDFH!!
(-%+RPH
The client sees
ZKDWPHWKRGV EJBHome! All ofeverything in
DUHLQKHUH"
are exposed to these methods
the AdviceHome the client through
FOLHQWFDQFDOO interface.
WKHVHPHWKRGV
Remember, any class that
LQWHUIDFH!!
implements AdviceHome must from
implement ALL the methods e
$GYLFH+RPH
FUHDWH both AdviceHome AND EJBHom
(Remote doesnÕt have any methods).
\RXDUHKHUH
WKH(-%+RPHLQWHUIDFH
:KDW<28ZULWH :KDWWKH&/,(17VHHV
LQWHUIDFH!! LQWHUIDFH!!
$GYLFH+RPH $GYLFH+RPH
FUHDWH FUHDWH
JHW(-%0HWD'DWD
JHW+RPH+DQGOH
UHPRYH +DQGOHK
UHPRYH 2EMHFWNH\
5HPHPEHUWKHFRQWDLQHU
$GYLFH+RPH,PSO $GYLFH+RPH,PSOBVWXE
LPSOHPHQWV\RXUKRPH
LQWHUIDFHDQGPDWFKLQJVWXE FUHDWH FUHDWH
7KHFRQWDLQHUPXVW JHW(-%0HWD'DWD JHW(-%0HWD'DWD
JHW+RPH+DQGOH JHW+RPH+DQGOH
LPSOHPHQW(9(5<7+,1*IURP UHPRYH +DQGOHK UHPRYH +DQGOHK
$GYLFH+RPHDQG(-%+RPH UHPRYH 2EMHFWNH\ UHPRYH 2EMHFWNH\
the class of the actual the class
home objecof the
Remote home object t stub
1RWH WKHVHDUHQ¶WQHFHVVDULO\WKHUHDOQDPHV²
WKHVHUYHUJHQHUDWHVWKHVHFODVVHVDQGLWFDQ
QDPHWKHPZKDWHYHULWZDQWVWR
&KDSWHU
WKHFOLHQWYLHZ
,I\RX·UHDFOLHQWDQG\RXZDQWWR &DOOWKLVPHWKRG
JHWUHÁHFWLRQOLNHLQIRUPDWLRQDERXWWKHEHDQ LQWHUIDFH!!
8QOHVV\RX¶UHDWRROYHQGRU\RX¶OOSUREDEO\QHYHUQHHGWRFDOOWKLV (-%+RPH
PHWKRG,WUHWXUQVWKH(-%0HWD'DWDLQWHUIDFH²VRPHWKLQJ\RXFDQ (-%0HWD'DWDJHW(-%0HWD'DWD
XVHWRJHWPRUHVSHFL¿FFODVVLQIRUPDWLRQDERXWWKHEHDQ,I\RX¶YH +RPH+DQGOHJHW+RPH+DQGOH
JRW\RXUVHOIDQ(-%0HWD'DWDUHIHUHQFH E\FDOOLQJJHW(-%0HWD'DWD YRLGUHPRYH +DQGOHK
\RXFDQFDOOJHW+RPH,QWHUIDFH&ODVV JHW3ULPDU\.H\&ODVV
YRLGUHPRYH 2EMHFWNH\
LV6HVVLRQ DQGPRUH
VHULDOL]HWKHKRPHVRWKDW\RXFDQXVHWKHKRPH LQWHUIDFH!!
DJDLQODWHUZLWKRXWKDYLQJWRJRWKURXJK-1', (-%+RPH
,PDJLQH\RX¶UHDFOLHQWDQG\RX¶YHEHHQZRUNLQJZLWKDKRPH² (-%0HWD'DWDJHW(-%0HWD'DWD
PDNLQJDEXQFKRIEHDQVFDOOLQJKRPHPHWKRGVRQHQWLW\EHDQV +RPH+DQGOHJHW+RPH+DQGOH
ZKDWHYHU$QGQRZ\RXKDYHWRUHERRW\RXUPDFKLQH2UPRYHWR YRLGUHPRYH +DQGOHK
DQRWKHUPDFKLQH%XW\RXZDQWWRFRQWLQXHZRUNLQJZLWKWKLVKRPH YRLGUHPRYH 2EMHFWNH\
:KDWGR\RXGR"
<RXFRXOGJREDFNWKURXJK-1',DQGGRWKHZKROHORRNXSWKLQJDJDLQ
%XWLI\RXDVNWKHKRPHIRUDKDQGOH\RX¶OOJHWEDFND6HULDOL]DEOH
WKLQJ\RXFDQVDYHDQGXVHODWHUWRJHWWKHKRPHVWXEEDFNZLWKRXW
JRLQJWKURXJK-1', PRUHRQKDQGOHVDOLWWOHODWHU
WHOOWKHKRPH\RX·UHGRQHZLWKDVHVVLRQEHDQ LQWHUIDFH!!
(-%+RPH
:KHQ\RX¶UHGRQHZLWKDVHVVLRQEHDQ\RXFDQWHOOWKHKRPHE\FDOOLQJ
(-%0HWD'DWDJHW(-%0HWD'DWD
UHPRYH DQGSDVVLQJWKH(-%REMHFW¶VKDQGOH<HVWKDW¶VULJKWWKH(-%
REMHFW-XVWDVWKHKRPHREMHFWFDQJLYH\RXDKDQGOH VRWKDW\RXFDQ +RPH+DQGOHJHW+RPH+DQGOH
JHWWKHKRPHVWXEEDFNODWHUZLWKRXWJRLQJWKURXJK-1', WKH(-%REMHFW YRLGUHPRYH +DQGOHK
FDQJLYH\RXDKDQGOHWRLWVHOI :H¶OOVHHPRUHRIWKDWODWHULQWKLVFKDSWHU YRLGUHPRYH 2EMHFWNH\
<RXFDQXVHWKLVYHUVLRQRIUHPRYH IRUHQWLW\EHDQVDVZHOOEXWZLWK
HQWLW\EHDQVLW¶VXVXDOO\HDVLHUWRFDOOWKHRWKHUUHPRYH
WHOOWKHKRPHWRUHPRYHDQHQWLW\EHDQ LQWHUIDFH!!
1RWLFHZHGLGQ¶WVD\³7HOOWKHKRPH\RX¶UHGRQHZLWKDQHQWLW\EHDQ´7KDW¶V (-%+RPH
EHFDXVHFDOOLQJUHPRYHRQDQHQWLW\EHDQLVGUDVWLFDOO\GLIIHUHQWIURPFDOO (-%0HWD'DWDJHW(-%0HWD'DWD
LQJUHPRYHRQDVHVVLRQEHDQ:H¶OOJHWLQWRWKHGHWDLOVLQWKHHQWLW\EHDQ +RPH+DQGOHJHW+RPH+DQGOH
FKDSWHUVEXWWKHVKRUWYHUVLRQLV ZKHQ\RXUHPRYHDQHQWLW\EHDQ\RX¶UH
YRLGUHPRYH +DQGOHK
QRWMXVWWHOOLQJWKHFRQWDLQHUWKDW\RX¶UHGRQHZLWKWKHEHDQ\RX¶UHWHOOLQJLW
YRLGUHPRYH 2EMHFWNH\
WKDWHYHU\RQHLVGRQHZLWKWKHEHDQ)RUHYHU%HFDXVHFDOOLQJUHPRYH RQ
DQHQWLW\EHDQPHDQV³'HOHWHWKLVHQWLW\IURPWKHSHUVLVWHQWVWRUH´ :KLFK
XVXDOO\PHDQV³'HOHWHWKLVURZIURPWKHGDWDEDVH´
7KLVYHUVLRQRIUHPRYHWDNHVDSULPDU\NH\ZKLFKVHVVLRQEHDQVGRQ¶WKDYH
VRXQOLNHWKHRWKHUUHPRYH WKLVYHUVLRQFDQEHXVHGIRUHQWLW\EHDQVRQO\
\RXDUHKHUH
WKH(-%+RPHLQWHUIDFH
,NQRZLVQ·WWKDWRGG"
%XWORRNWKHUH·VRQO\RQH
+H\GLG,MXVW KRPHLQWHUIDFH(-%+RPH
VHHVRPHWKLQJDERXW UHJDUGOHVVRIWKHEHDQW\SH7KHUH·V
DSULPDU\NH\",QWKHKRPH QRVHSDUDWH(-%6HVVLRQ+RPH
LQWHUIDFHIRUDVHVVLRQ RU(-%(QWLW\+RPHLW·VMXVW
EHDQ"7KDWFDQ·WEH (-%+RPHIRUHYHU\WKLQJ
ULJKW
Q: $OES THIS MEAN THE CLIENT HAS TO KNOW THAT SHES USING A SESSION BEAN AND
NOT AN ENTITY BEAN )SNT THAT SOMETHING THE CLIENT SHOULDNT HAVE TO KNOW
A: 9ES THE CLIENT DOES HAVE TO KNOW THAT WHEN SHES GOT THE HOME INTERFACE FOR
A SESSION BEAN HE CANT CALL THE REMOVE/BJECT PRIMARY+EY METHOD )F SHE DOES
SHELL GET AN EXCEPTION JAVAXEJB2EMOVE%XCEPTION )T DOES FEEL LIKE MORE OF AN
IMPLEMENTATION DETAIL THAN THE CLIENT SHOULD HAVE TO KNOW IE THAT ITS A SESSION VS
ENTITY BEAN BUT IN REALITY YOU CANT EXPECT TO WRITE AN %*" CLIENT WITHOUT KNOWING
WHETHER YOURE COMMUNICATING WITH A SESSION OR ENTITY BEAN &OR ONE THING THE WAY
THE CLIENT INTERACTS WITH AN ENTITY BEAN HOME IS COMPLETELY DIFFERENT FROM THE WAY A
CLIENT USES A SESSION BEAN HOME 9OULL SEE DRAMATIC DIFFERENCES WHEN WE GET TO THE
ENTITY BEAN CHAPTERS
&KDSWHU
WKHFOLHQWYLHZ
:MDD=LHGAFLK
7KHPHWKRGVRIWKHEHDQDUHH[SRVHGWRWKHFOLHQW
WKURXJKWKHFRPSRQHQWLQWHUIDFH
7KHFOLHQWFDQ·WGLUHFWO\JHWDUHIHUHQFHWRWKH
EHDQ WKHFOLHQWPXVWJRWKURXJKWKHEHDQ·V(-%
REMHFWZKLFKLPSOHPHQWVWKHFRPSRQHQWLQWHU
IDFH
7KHFOLHQWJHWVDUHIHUHQFHWRWKHEHDQ·V(-%
REMHFWIURPWKHEHDQ·VKRPH
7RJHWWKHEHDQ·VKRPHWKHFOLHQWGRHVDORRNXS
E CLIENT
H O M E S TUB ON TH RQ-1',XVLQJWKHORJLFDOQDPHXQGHUZKLFKWKH
S A
4HERE WA E DEFIANT EHDQZDVGHSOR\HG
A D E T H E 6- QUIT
4HAT M D E D 7RGRD-1',ORRNXSWKHFOLHQWPXVWILUVWJHWDQ
WAS NEE
! NARROW H EEDED ,QLWLDO&RQWH[WZKLFKLVWKHHQWU\SRLQWLQWRWKH
E C A ST TO BE ANT
&O R TH ! COMPLI VHUYHU·V-1',´YLUWXDOGLUHFWRU\WUHHµ
U S E I T W AS #/2"
" E CA
)RUD5HPRWHKRPHLQWHUIDFHWKHVWXEUHWXUQHG
IURP-1',PXVWEHERWKFDVWDQGQDUURZHG
1DUURZLQJLVWKH´H[RWLFFDVWLQJµQHHGHGIRUVWXE
REMHFWVWKDWFRPHIURPDPHWKRGWKDWGRHVQRW
UHWXUQWKHVWXE·VFOLHQWLQWHUIDFH6LQFHWKH-1',
ORRNXSUHWXUQVW\SH2EMHFWWKHREMHFWUHWXUQHG
IURPWKHORRNXSPXVWEHQDUURZHGWRWKHEHDQ·V
KRPHLQWHUIDFHDQGWKHQFDVWWRWKHEHDQ·VKRPH
LQWHUIDFH
1DUURZLQJLVUHTXLUHGIRU,,23VWXEV ,,23LV
WKHZLUHSURWRFROIRU&25%$ EHFDXVHZKDW·V
UHWXUQHGIURPWKHORRNXSPLJKWQRWEHFDSDEOHRI
2OSES ARE RED BLUE IS THE SKY LPSOHPHQWLQJPXOWLSOHLQWHUIDFHVDQGWKXVZRXOG
YOU CANT GET A BEAN FROM *.$ NQRZRQO\DERXWWKHPHWKRGVLQW\SH2EMHFW
)
1DUURZLQJUHWXUQVDQREMHFWWKDWLPSOHPHQWVWKH
)TS ONLY THE HOME A CLIENT WI KRPHLQWHUIDFH
LL SPY
WHEN HE DOES A LOOKUP ON *.$ 7KHKRPHLQWHUIDFHH[WHQGV(-%+RPHZKLFKKDV
)
IRXUDGGLWLRQDOPHWKRGVWKHFOLHQWFDQVHH
JHW(-%0HWD'DWDJHW+RPH+DQGOH
UHPRYH +DQGOHK UHPRYH 2EMHFWSULPDU\.H\
7KHUHPRYH 2EMHFWSULPDU\.H\ PXVWQRWEH
FDOOHGRQDVHVVLRQEHDQ
\RXDUHKHUH
WKH+RPHLQWHUIDFH
6KDUSHQ \RXU SHQFLO
%DVHGRQWKHUXOHVIRUVHVVLRQEHDQKRPHLQWHUIDFHVZKLFK
VWDWHPHQWVDUHWUXHDERXWWKLVLQWHUIDFH
LPSRUWMDYD[HME(-%+RPH
LPSRUWMDYDUPL5HPRWH([FHSWLRQ
SXEOLFLQWHUIDFH&DUW+RPHH[WHQGV(-%+RPH^
SXEOLF&DUWFUHDWH WKURZV&UHDWH([FHSWLRQ5HPRWH([FHSWLRQ
R&DUW+RPHPXVWQRWEHWKHKRPHRIDVWDWHIXOVHVVLRQEHDQ
R7KHLQWHUIDFHLVPLVVLQJDQLPSRUWVWDWHPHQW
R7KHFUHDWHPHWKRGLVPLVVLQJDQH[FHSWLRQ
R&DUWPXVWEHWKHFODVVW\SHRIWKHEHDQ
R&DUWPXVWEHWKHLQWHUIDFHWKDWH[WHQGV(-%2EMHFW
R7KHREMHFWUHWXUQHGIURPFUHDWH PXVWEHQDUURZHG
R7KHREMHFWUHWXUQHGIURPFUHDWH GRHVQRWQHHGDFDVW
<RX0867EH
DEOHWRORRNDW
FRGHDQGLQIHU
DORWDERXWLW
RRNDW
7KHH[DPH[SHFWV\RXWRO
UEH DQFRG HDQG
FOLHQWLQWHUIDFHR
UHQFHV DE RXWWKLQJV \RX
PDNHLQIH
QRZ DOO RI
GRQ¶WVHH<RX0867N
HDQG FRP SRQ HQW
WKHUXOHVIRUKRP
HV$QGWK HUH¶VP RUH
LQWHUIDF
&KDSWHU
WKHFOLHQWYLHZ
*]\MVW]OPIJW]\\PMPWUMTM\¼[\ITSIJW]\
\PM-2*WJRMK\<PMKWUXWVMV\QV\MZNIKM
<PM\PQVOaW]:-)44A_IV\
2EMEMBER ALL THAT )NITIAL#ONTEXT
*.$)
LOOKUP
CAST
NARROW
CREATE BUSINESS
WAS JUST TO GET WHAT YOU REALLY WANTED ALL ALONGSOMETHING WITH THE BUSINESS
METHODS 3OMETHING YOU CAN USE TO GET THE BEAN TO DO WHATEVER IT IS THAT BEAN
WAS CREATED FOR .UMBER CRUNCHING ONLINE SHOPPING ADVICE
SDFNDJHKHDG¿UVW
LPSRUWMDYD[HME
LPSRUWMDYDUPL5HPRWH([FHSWLRQ
SXEOLFLQWHUIDFH$GYLFHH[WHQGV(-%2EMHFW^
SXEOLF6WULQJJHW$GYLFH WKURZV5HPRWH([FHSWLRQ
5XOHVIRUWKHFRPSRQHQWLQWHUIDFH
,PSRUWMDYD[HME DQGMDYDUPL5HPRWH([FHSWLRQ
([WHQG(-%2EMHFW
'HFODUHRQHRUPRUHEXVLQHVVPHWKRGVWKDWWKURZD5HPRWH([FHSWLRQ
4 $UJXPHQWVDQGUHWXUQW\SHVPXVWEH50,,,23FRPSDWLEOH 6HULDOL]DEOHSULPL
WLYH5HPRWHRUDUUD\VRUFROOHFWLRQVRIDQ\RIWKRVH
4 <RXFDQKDYHRYHUORDGHGPHWKRGV
4 (DFKPHWKRGPXVWGHFODUHD5HPRWH([FHSWLRQ
4 <RXFDQGHFODUH\RXURZQDSSOLFDWLRQH[FHSWLRQVEXWWKH\PXVW127EHUXQ
WLPHH[FHSWLRQV LQRWKHUZRUGVWKH\PXVWEHFRPSLOHUFKHFNHGH[FHSWLRQV²
VXEFODVVHVRI([FHSWLRQEXWQRWVXEFODVVHVRI5XQWLPH([FHSWLRQ
\RXDUHKHUH
WKH&RPSRQHQWLQWHUIDFH
,ZRQGHUZKDWHOVH,
FDQGRZLWKWKHFRPSRQHQW
LQWHUIDFH,NQRZWKHUH·V
PRUHWKDQMXVWWKHEXVLQHVV
PHWKRGVZKDWPHWKRGVDUH
LQ(-%2EMHFW"
LQWHUIDFH!!
5HPRWH
LQWHUIDFH!!
(-%2EMHFW
Just as with
ZKDWPHWKRGV interface, thethcle EJBHome
DUHLQKHUH"
in EJBObject ient sees everything
methods are ex! po
All of these
FOLHQWFDQFDOO
through the bean sed to the client
interface (Advice Õs component
WKHVHPHWKRGV
).
Any class that implements the
LQWHUIDFH!!
Advice must implement ALL D
methods from both Advice AN
$GYLFH
JHW$GYLFH EJBObject.
&KDSWHU
WKHFOLHQWYLHZ
1UIOQVM_PI\MT[MaW]UQOP\_IV\\WLW
_Q\PaW]Z-2*WJRMK\ZMNMZMVKM
9OURE A CLIENT 9OU HAVE A REFERENCE TO THE !DVICE"EANS COMPONENT
INTERFACE 9OU KNOW YOU CAN CALL GET!DVICE "UT NOW THAT YOUVE GONE
TO ALL THE TROUBLE OF GETTING THE STUB ARE THERE OTHER THINGS YOU MIGHT
WANT TO DO
,FDQWKLQNRIVRPHWKLQJV
OLNHZKDWLI,KDYHWKHEHDQEXW,
ORVWWKHUHIHUHQFHWRWKHKRPHDQGQRZ
,ZDQWWRPDNHPRUHEHDQVRIWKDWW\SH"
6XUHO\WKHEHDQNQRZVLWVRZQKRPHULJKW"
,FDQ·WEHOLHYHWKH\ZRXOGKDYHEHHQ
VWXSLGHQRXJKWRPDNH\RXJREDFN
WKURXJK-1',
\RXDUHKHUH
WKH(-%2EMHFWLQWHUIDFH
:KDW<28ZULWH :KDWWKH&/,(17VHHV
LQWHUIDFH!! LQWHUIDFH!!
$GYLFH $GYLFH
JHW$GYLFH JHW$GYLFH
JHW3ULPDU\.H\
JHW(-%+RPH
JHW+DQGOH
UHPRYH
(-%2EMHFW WKH
EHDQ·VERG\JXDUG LV,GHQWLFDO
IRUEXVLQHVV
PHWKRGV
5HPHPEHUWKHFRQWDLQHU
$GYLFH,PSO $GYLFH,PSOBVWXE
LPSOHPHQWV\RXUFRPSRQHQW
LQWHUIDFHDQGPDWFKLQJVWXE JHW$GYLFH JHW$GYLFH
JHW3ULPDU\.H\ JHW3ULPDU\.H\
7KHFRQWDLQHUPXVWLPSOHPHQW JHW(-%+RPH JHW(-%+RPH
JHW+DQGOH JHW+DQGOH
(9(5<7+,1*IURP$GYLFHDQG
UHPRYH UHPRYH
(-%2EMHFW LV,GHQWLFDO LV,GHQWLFDO
the class of the actual the class
EJB objecof the
<RXEHWWHU Remote EJB object t stub
NQRZWKHVH
RWKHUPHWKRGV
LQVLGHDQGRXW
QRZDOO
7KHH[DPH[SHFWV\RXWRN
GV LQ( -%2 EMHFW
¿YHRIWKHPHWKR
WRNQRZ WKD WWKH\¶UH
<RXKDYH
DQG
DYDLODEOHWR5HPRWHFOLHQWV
H[DFWO\KRZWKH\ ¶UH XVH G
&KDSWHU
WKHFOLHQWYLHZ
,I\RX·UHDFOLHQWDQG\RXZDQWWR FDOOWKLVPHWKRG
JHWWKHSULPDU\NH\RIDQHQWLW\EHDQ LQWHUIDFH!!
:HZRQ¶WJRLQWRWKLVQRZVLQFHZHKDYHPLOOLRQSDJHVRQHQWLW\EHDQV (-%2EMHFW
FRPLQJXS-XVWNQRZWKDWWKLVGRHVQRWDSSO\WRVHVVLRQEHDQVZKLFKGRQ¶W 2EMHFWJHW3ULPDU\.H\
KDYHDXQLTXHLGHQWLW\H[SRVHGWRWKHFOLHQW%XWLIWKHFOLHQWVRPHKRZJHWV (-%+RPHJHW(-%+RPH
DUHIHUHQFHWRDQHQWLW\EHDQ PD\EHE\VHDUFKLQJRQDFXVWRPHU¶VQDPH +DQGOHJHW+DQGOH
DQGZDQWVWKHDFWXDOSULPDU\NH\WKLVLVWKHPHWKRGWRFDOO7U\LWRQD YRLGUHPRYH
VHVVLRQEHDQDQG\RX¶OOJHWDELJIDW5HPRWH([FHSWLRQ RU(-%([FHSWLRQLI ERROHDQLV,GHQWLFDO 2EMHFWR
WKHFOLHQWLVORFDO
JHWWKHEHDQ·VKRPH LQWHUIDFH!!
,PDJLQH\RX¶YHJRWDEHDQEXW\RXGRQ¶WKDYHWKHEHDQ¶VKRPH$QGQRZ (-%2EMHFW
\RXZDQWWRPDNHPRUHEHDQVRIWKDWW\SH:KDWGR\RXGR"<RXFRXOGGRD 2EMHFWJHW3ULPDU\.H\
-1',ORRNXSDQGJHWWKHKRPHLQWKHXVXDOZD\%XWZKDWLI\RXGRQ¶WKDYH (-%+RPHJHW(-%+RPH
HQRXJKLQIRUPDWLRQWRGRWKH-1',ORRNXS"<RXFDQDVNWKHEHDQWRJLYH +DQGOHJHW+DQGOH
\RXDUHIHUHQFHWRLWVKRPH(YHQLI\RXDUHFDSDEOHRIGRLQJD-1',ORRNXS YRLGUHPRYH
RQWKHKRPHFDOOLQJJHW(-%+RPH RQWKHEHDQLVPRUHHI¿FLHQW ERROHDQLV,GHQWLFDO 2EMHFWR
VDYHDUHIHUHQFHWRWKH(-%2EMHFW LQWHUIDFH!!
<RX¶UHVKRSSLQJRQOLQHFDUHIXOO\SXWWLQJLWHPVLQ\RXUFDUWDIWHUKRXUVRI (-%2EMHFW
SDLQVWDNLQJUHVHDUFKDQGGHFLVLRQPDNLQJRQZKHWKHU\RXUJLUOIULHQGZLOO 2EMHFWJHW3ULPDU\.H\
SUHIHU\RXLQFRUQÀRZHUEOXHRUWKH0DUWKD6WHZDUWVHDIRDPJUHHQ%XW (-%+RPHJHW(-%+RPH
EHIRUH\RXFDQ¿QLVK\RXKDYHWRVZLWFKWRDQRWKHUPDFKLQH1RSUREOHP +DQGOHJHW+DQGOH
<RXFDQDVNWKHEHDQIRUDKDQGOHWRWKH(-%REMHFW<RXFDQXVHWKH YRLGUHPRYH
KDQGOHWRJHWEDFNWR\RXURULJLQDO(-%REMHFWDQGNHHSVKRSSLQJ ERROHDQLV,GHQWLFDO 2EMHFWR
WHOOWKHEHDQ\RX·UHGRQHZLWKLW LQWHUIDFH!!
:KHQ\RX¶UH¿QLVKHGZLWKWKHEHDQLW¶VJRRGPDQQHUVWRWHOOLW\RX¶UHGRQH (-%2EMHFW
VRWKHFRQWDLQHUFDQIUHHXSDQ\UHVRXUFHVLWPLJKWEHNHHSLQJRQ\RXU 2EMHFWJHW3ULPDU\.H\
EHKDOI'$1*(5:H¶UHWDONLQJRQO\DERXWVHVVLRQEHDQVKHUH$OWKRXJK (-%+RPHJHW(-%+RPH
\RXFDQFDOOUHPRYH RQDQHQWLW\EHDQUHPHPEHULWKDVDYHU\GLIIHUHQW +DQGOHJHW+DQGOH
PHDQLQJ ZH¶OOVHHWKDWLQWKHHQWLW\EHDQFKDSWHUV YRLGUHPRYH
ERROHDQLV,GHQWLFDO 2EMHFWR
FRPSDUHWZR(-%REMHFWUHIHUHQFHVWRVHHLIWKH\ LQWHUIDFH!!
UHIHUHQFHWKHVDPHEHDQ (-%2EMHFW
<RX¶YHJRWWZRUHIHUHQFHVWRVHVVLRQEHDQ(-%REMHFWV1RZ\RXZDQWWR 2EMHFWJHW3ULPDU\.H\
NQRZLIWKH\¶UHUHDOO\UHIHUHQFHVWRWKHVDPHEHDQ7KHLV,GHQWLFDO PHWKRG (-%+RPHJHW(-%+RPH
WDNHVDQ(-%REMHFWUHIHUHQFHDQGFRPSDUHVLWWRWKH(-%REMHFWRQZKLFK +DQGOHJHW+DQGOH
\RXLQYRNHGLV,GHQWLFDO DQGUHWXUQVWUXHRUIDOVH YRLGUHPRYH
ERROHDQLV,GHQWLFDO 2EMHFWR
\RXDUHKHUH
WKHJHW+DQGOH PHWKRG
9OURE SHOPPING )TS TOUGH
BECAUSE YOU CANT DECIDE WHETHER
7VTQVM[PWXXQVO[PW]TLVW\JMZ][PML
YOURE A SPRING OR A SUMMER
9OU DONT WANT TO BE RUSHED BUT
YOUVE ALREADY GOT A BUNCH OF
STUFF IN YOUR CART WHEN YOU REALIZE
YOURE l VE MINUTES LATE FOR WORK
9OUD LOVE TO CONTINUE WITH YOUR
SHOPPING ONCE YOU GET TO WORK
7HAT DO YOU DO )F IT WERE
!MAZON YOUR SHOPPING CART
WOULD STILL BE THERE WHEN YOU
LOG
IN FROM THE 7EB "UT THIS IS A
PROPRIETARY 3WING
BASED SHOPPING +PPPP\QH[WGRRU
CLIENT APP YOURE USING (OW CAN QHLJKERUVD\VFRZER\ERRWV
YOU GET YOUR %*" OBJECT STUB FROM DUHVH[\%XWWKHVDQGDOVZLOOPDNH
YOUR HOME MACHINE TO YOUR WORK PHORRNPRUHVHQVLWLYH7KHQDJDLQ
MACHINE JLUOVOLNHWKDWUXJJHGORRNVRPD\EH
,VKRXOGJRZLWKWKHKLNLQJERRWV
9OU COULD TRY SERIALIZING THE STUB 6KRSSLQJLVVRWLPHFRQVXPLQJ
9EAH THAT MIGHT WORK 4HEN
AGAIN IT MIGHT NOT 4HE STUB HAS
A LIVE NETWORK CONNECTION AND
THERES CERTAINLY NO GUARANTEE YOU
CAN GET THAT SAME CONNECTION
TO THE SAME %*" OBJECT AGAIN
!ND SINCE THAT %*" OBJECT IS
THE COMPONENT INTERFACE FOR
YOUR OWN PERSONAL TEMPORARY
SHOPPING CART BEAN YOU NEED
A WAY TO GET BACK TO YOUR EXACT
SAME %*" OBJECT AGAIN FROM WORK
LQWHUIDFH!!
(-%2EMHFW
2EMHFWJHW3ULPDU\.H\
(-%+RPHJHW(-%+RPH
+DQGOHJHW+DQGOH
YRLGUHPRYH
ERROHDQLV,GHQWLFDO 2EMHFWR
&KDSWHU
WKHFOLHQWYLHZ
<PIVSN]TTa_M¼^MOW\PIVLTM[ handle
handle
handle
LQWHUIDFH!!
handle +DQGOH
JHW(-%2EMHFW
no handle
! HANDLE CAN RESCUE YOUR SHOPPING EXPERIENCE !SK $KDQGOHLVD6HULDOL]DEOH
THE BEAN VIA THE %*"/BJECT INTERFACE FOR A HANDLE
REMHFWWKDWNQRZVKRZWRJHW
+DQGOHP\+DQGOH P\&DUWJHW+DQGOH
EDFNWRWKHRULJLQDO5HPRWH
SERIALIZE IT EMAIL IT TO YOURSELF THEN DESERIALIZE ON YOUR
WORK MACHINE AND YOURE BACK IN BUSINESS (-%REMHFW,W·VQRWDVWXE
4HE HANDLE IS A 3ERIALIZABLE THING THAT KNOWS HOW TO EXWLWFDQ*(7WKHVWXE
GET BACK TO THE STUB )T HAS A SINGLE METHOD
SXEOLF(-%2EMHFWJHW(-%2EMHFW ,WKDVMXVWRQHPHWKRG
3O WHEN YOU CALL IT YOU HAVE TO CAST AND NARROW THE JHW(-%2EMHFW WKDWUHWXUQV
STUB THAT COMES BACK 2EMEMBER YOU ALWAYS HAVE TO
CAST AND NARROW A STUB UNLESS THE METHOD THAT RETURNS W\SH2EMHFW
IT HAS THE ACTUAL 2EMOTE INTERFACE AS ITS DECLARED RETURN
TYPE 3INCE THE HANDLES METHOD HAS NO FRICKIN CLUE 6R\RXKDYHWRQDUURZDQG
WHAT YOUR COMPONENT INTERFACE IS SAY 3HOPPING#ART
YOURE FACED WITH THE SAME SCENARIO YOU HAD WITH THE FDVWWKHVWXE\RXJHWEDFN
HOME STUB YOU GOT FROM THE *.$) LOOKUP METHOD
#AST AND NARROW #AST AND NARROW #AST AND NARROW
)N YOUR CLIENT CODE YOULL HAVE SOMETHING LIKE
\RXUFRGHWRJHWWKHVHULDOL]HGKDQGOH\RXVDYHGHDUOLHU
+DQGOHK WKLVUHVWRUH7KH+DQGOH
QRZXVHLWWRJHWWKH(-%2EMHFWVWXE
2EMHFWR KJHW(-%2EMHFW
6KRSSLQJFDUW 6KRSSLQJ 3RUWDEOH5HPRWH2EMHFWQDUURZ R6KRSSLQJFODVV
\RXDUHKHUH
(-%+DQGOHV
:DLWDPLQXWHLVQ·WDKDQGOHDELJ
VHFXULW\SUREOHP"<RXDOUHDG\VDLG,FRXOG
VHULDOL]HDKDQGOHDQGSXWLWRQDQRWKHUPDFKLQHVR
ZKDW·VWRVWRSPHIURPJLYLQJWKHKDQGOHWRVRPHRQH
HOVH"6RPHRQHZKRGLGQ·WKDYHDFFHVVWRWKHVWXELQWKH
ÀUVWSODFH"$QGDQRWKHUWKLQJEXJVPHDERXWKDQGOHV
,KRSH\RX·UHQRWWHOOLQJPHWKHVHUYHUKDVWRNHHS
VKRSSLQJFDUWVDURXQGIRUHYHUMXVWLQFDVHD
FOLHQWFRPHVEDFNXVLQJDKDQGOH
*RRGE\HVFDODELOLW\
'RQ·WZRUU\<RXFDQ·WXVHDKDQGOHDVD
ZD\WRYLRODWH\RXUEHDQ·VVHFXULW\
9OUR SECURITY IS ON A METHOD BY METHOD BASIS SO
EVEN IF YOU GIVE A HANDLE TO SOMEONE ELSE IF THAT
CLIENT DOESNT HAVE AUTHORIZATION TO CALL METHODS
ON THE BEAN THE STUB THEY GET BACK FROM THE
HANDLE WILL BE USELESS
-XVWEHFDXVH\RXVWLOOKDYHDKDQGOHGRHVQ·W
PHDQWKHVHUYHUVWLOOKDV\RXUEHDQ
)F YOURE SHOPPING AND YOU GET A HANDLE AND
THEN THE SERVER DETECTS THAT YOU HAVENT BEEN
DOING ANYTHING WITH YOUR CART FOR A WHILE THE
SERVER CAN TEMPORARILY SAVE YOUR BEAN KNOWN AS
PASSIVATION TO CONSERVE RESOURCES BUT KEEP YOUR
CART AROUND JUST IN CASE YOU COME BACK "UT IF YOU
STILL DONT COME BACK WITHIN SOME TIME PERIOD
THE SERVER WILL DESTROY YOUR CART WITH NO HOPE OF
RESURRECTING IT 4HAT BEAN IS HISTORY
)N THAT CASE YOUR CART WONT BE THERE WHEN YOU
CALL GET%*"/BJECT ON THE HANDLE AND YOULL GET
A 2EMOTE%XCEPTION
&KDSWHU
WKHFOLHQWYLHZ
Q[1LMV\QKIT'
PW_\WNQVLW]\QN\ _W[\]J[
ZMNMZ\W\PM[IUMJMIV
LQWHUIDFH!!
(-%2EMHFW
2EMHFWJHW3ULPDU\.H\
These twins ar (-%+RPHJHW(-%+RPH
theyÕre stateLEe identical if +DQGOHJHW+DQGOH
can each do the SS, since they YRLGUHPRYH
clients wonÕt knowsame thing and ERROHDQLV,GHQWLFDO 2EMHFWR
But if theyÕr the difference.
they are alwayes stateFUL, then
twins cannot be distinct. Stateful )F YOUVE GOT TWO STUBS AND YOU WANT TO KNOW IF THEY REFER
they can hold identical, because TO THE SAME BEAN YOU CALL IS)DENTICAL ON ONE REFERENCE
to their own uniniqformation speciÞc PASSING IN THE REFERENCE YOU WANT TO COMPARE IT AGAINST
ue client. *UST LIKE THE WAY YOU USE THE EQUALS METHOD
4HE TRICK IS STATELESS SESSION BEANS STATEFUL SESSION BEANS
AND ENTITY BEANS EACH HAVE DIFFERENT RULES FOR WHAT CAUSES
IS)DENTICAL TO RETURN TRUE
6WDWHOHVVVHVVLRQEHDQV
4RUE IF BOTH REFERENCES CAME FROM THE SAME HOME EVEN IF
THE STUBS ARE REFERRING TO TWO DIFFERENT 2EMOTE %*" OBJECTS
4O THE SERVER ONE STATELESS BEAN IS AS GOOD AS ANY OTHER
BEAN FROM THE SAME HOME BECAUSE THE CLIENT WOULD NEVER
BE ABLE TO TELL THE DIFFERENCE SINCE THE BEAN CANT HOLD ANY
CLIENT
SPECIl C STATE
6WDWHIXOVHVVLRQEHDQV
&ALSE NO MATTER WHAT FOR ANY TWO UNIQUE STUBS
EVEN IF FROM THE SAME HOME !FTER ALL MY
SHOPPING CART ISNT THE SAME AS YOURS
(QWLW\EHDQV
4RUE IF THE STUBS REFER TO TWO ENTITIES WITH THE SAME PRIMARY KEY
\RXDUHKHUH
WKHLV,GHQWLFDO PHWKRG
6WDWHOHVV
EHDQV
These beans ar
all identical e 7KHLV,GHQWLFDO PHWKRGLV
OLNHFDOOLQJD5HPRWHHTXDOV
PHWKRGH[FHSW\RX·UHQRW
EHDQ
EHDQ
DVNLQJLIWZRREMHFWVRQ\RXU
EHDQ
KHDSDUHPHDQLQJIXOO\HTXLYDOHQW
LV,GHQWLFDO DOZD\VUHWXUQVWUXH \RX·UHDVNLQJLIWZR5HPRWH
HYHQIRUGLIIHUHQWEHDQV
REMHFWVDUHPHDQLQJIXOO\
HTXLYDOHQWRQWKHVHUYHU
6WDWHIXO (QWLW\
EHDQV EHDQV
These beans are
NEVER identical.
Your cart is
different from
mine.
EHDQ These two are EHDQ
identical
EHDQ EHDQ
EHDQ
EHDQ
LV,GHQWLFDO DOZD\VUHWXUQVIDOVH LV,GHQWLFDO UHWXUQVWUXHIRUEHDQV
IRUGLIIHUHQWEHDQVHYHQLIWKH WKDWUHIHUHQFHWKHVDPHHQWLW\ LQ
EHDQVDUHIURPWKHVDPHKRPH RWKHUZRUGVWKHVDPHSULPDU\NH\
:HXVHWKHWHUP´EHDQµKHUHDOLWWOHORRVHO\EHFDXVH
FRQFHSWXDOO\WKHVHUYHUXVHVRQO\RQHEHDQWR
UHSUHVHQWDSDUWLFXODUHQWLW\6RWKHUHZRXOGEHRQO\
RQHEHDQZLWKDSULPDU\NH\RIEXWFOLHQWVPD\
KDYHPXOWLSOH(-%REMHFWUHIHUHQFHVWRLW
&KDSWHU
WKHFOLHQWYLHZ
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: 7HY CANT YOU JUST USE THE EQUALS METHOD Q: (OW COME THERES A METHOD IN THE %*"/BJECT
INSTEAD OF IS)DENTICAL )SNT THAT WHAT EQUALS IS FOR INTERFACE FOR GETTING THE BEANS HOME )F YOU DONT
(!6% THE HOME THEN HOW DID YOU GET THE BEAN IN THE
A: 2EMEMBER WERE TALKING ABOUT 2EMOTE OBJECTS
lRST PLACE
4HE EQUALS METHOD COMPARES TWO OBJECTS ON THE
SAME (%!0 WHERE IS)DENTICAL COMPARES TWO 2EMOTE A: 4HERE ARE OTHER WAYS TO GET A REFERENCE TO AN %*"
OBJECTS ON THE 3%26%2 OBJECT )TS TRUE THAT YOU CANT USE *.$) TO LOOK UP THE
%*" OBJECT ONLY THE HOME IS REGISTERED
Q: ) STILL DONT SEE WHY THEY COULDNT HAVE JUST
"54 THERES NOTHING TO STOP YOU FROM PASSING AN %*"
OBJECT REFERENCE AS AN ARGUMENT OR RETURN VALUE 9OU
IMPLEMENTED THE EQUALS METHOD ON THE STUB TO DO
MIGHT HAVE A BUSINESS METHOD IN ONE BEAN WHOSE SOLE
THE SAME THING
JOB IS TO HAND YOU BACK A REFERENCE TO AN %*" OBJECT FOR A
DIFFERENT BEAN
A: 4HE EQUALS METHOD IS NOT A REMOTE METHOD .OW SUPPOSE YOU HAVE THIS %*" OBJECT REFERENCE TO A
BEAN WHOSE HOME YOU NEVER HAD AND NOW YOU WANT TO
FOR ONE THING 9OU CAN ALWAYS CALL EQUALS ON A STUB
BECAUSE YOU CAN CALL IT ON ANY OBJECT ON YOUR HEAP MAKE MORE OF THOSE BEANS FOR YOURSELF 9OU CAN DO THAT
"UT ITS NOT PART OF THE REMOTE INTERFACE SO IT CANT BE BY ASKING FOR THE BEANS HOME USING GET%*"(OME
A REMOTE METHOD FOR EXAMPLE IT DOESNT DECLARE A !ND EVEN IF YOU DO HAVE ENOUGH INFORMATION TO DO A
2EMOTE%XCEPTION ETC LOOKUP IN *.$) FOR THAT BEANS HOME *.$) LOOKUPS ARE
!ND REMEMBER THE EQUALS METHOD IS USED TO SEE IF EXPENSIVE 9OULL SAVE SOME OVERHEAD IF YOU JUST GET THE
TWO OBJECTS ON THE HEAP ARE MEANINGFULLY EQUIVALENT HOME REFERENCE FROM THE BEAN DIRECTLY
4HE VENDOR CAN IMPLEMENT THE EQUALS METHOD ON
THE STUB ANY WAY IT LIKES BUT THAT STILL DOESNT TELL YOU
ANYTHING ABOUT WHATS GOING ON BACK AT THE SERVER
Q: 7HY CANT YOU SERIALIZE THE STUB 7HY DO WE
END *UST BECAUSE TWO STUBS DONT PASS THE EQUALS TEST NEED HANDLES
DOESNT MEAN THE SERVER DOESNT CONSIDER THE TWO %*"
OBJECTS TO BE IDENTICAL OR REFERENCING IDENTICAL BEANS
9OUR SERVER MAY BE USING 2-) STUBS FOR EXAMPLE THAT
A: 7E DIDNT SAY THE STUB WASNT 3ERIALIZABLE "UT
EVEN IF YOU CAN SERIALIZE IT THAT DOESNT MEAN ITS GOT
HAVE NO LOGIC FOR HOW THEIR COMPARISONS RELATE TO ENOUGH INFORMATION TO GET YOU BACK TO THE SAME OR
MEANINGFUL COMPARISONS OF TWO %*" OBJECTS ON THE MEANINGFULLY IDENTICAL %*" OBJECT 7HEN THE STUB COMES
SERVER 2-) STUBS KNOW ABOUT 2EMOTE OBJECTS BUT THEY OVER FROM THE SERVER ITS ALREADY KNOWLEDGEABLE ABOUT
DONT KNOW WHAT THOSE 2EMOTE OBJECTS REPRESENT HOW TO CONTACT A PARTICULAR 2EMOTE OBJECT 7HEN THAT
STUB IS RECREATED THAT EXACT 2EMOTE OBJECT MIGHT NOT
EVEN EXIST ANY LONGER
Q: 4HEN HOW WOULD THE HANDLE BE ANY BETTER
A: 4HE HANDLE HAS THE @SMARTS TO COMMUNICATE
WITH THE SERVER AND GET BACK SOMETHING THAT IS JUST THE
SAME AS THE %*" OBJECT YOU HAD BEFORE )N OTHER WORDS
IT MIGHT NOT BE THE SAME %*" OBJECT BUT THE CLIENT WILL
NEVER BE ABLE TO TELL THE DIFFERENCE
\RXDUHKHUH
WKH5HPRWHLQWHUIDFHV
:MDD=LHGAFLK
<RXH[SRVH\RXUEHDQ·VEXVLQHVVPHWKRGVLQWKH
FRPSRQHQWLQWHUIDFH
5HPRWHFRPSRQHQWLQWHUIDFHVPXVWH[WHQG
MDYD[HME(-%2EMHFW
7KHFOLHQWJHWVDUHIHUHQFHWRWKHEHDQ·V(-%2EMHFW
E\FDOOLQJDPHWKRGRQWKHEHDQ·VKRPHLQWHUIDFH
TATELESS H
OME 5HIHUHQFHVWRERWKVWDWHOHVVDQGVWDWHIXOVHVVLRQ
)N YOUR S MORE EHDQVDUHUHWULHYHGIURPWKHKRPH·VFUHDWH
E AND NO
WRITE ON SEE PHWKRGV
LIENT WILL
BUT THE C R
IONAL FOU )URPWKH(-%2EMHFWLQWHUIDFHWKHFOLHQWVHHVILYH
AN ADDIT
S= DGGLWLRQDOPHWKRGV JHW(-%+RPH JHW+DQGOH
;METHOD
UHPRYH LV,GHQWLFDO DQGJHW3ULPDU\.H\
ARE ALIVE
D W HEN THEY
2OSES ARE
R E TS FIVE 2QO\HQWLW\EHDQFOLHQWVDUHDOORZHGWRFDOO
JE C T T H E CLIENT GE
/B JHW3ULPDU\.H\ RQWKHEHDQ·VFRPSRQHQW
&ROM %*"
O D S= LQWHUIDFH6HVVLRQEHDQFOLHQWVZLOOJHWD
;METH
5HPRWH([FHSWLRQ
7KHJHW(-%+RPH PHWKRGUHWXUQVDUHIHUHQFHWR
WKHEHDQ·VKRPHLQWHUIDFHVRWKDWWKHFOLHQWGRHVQ·W
,Q(-%WKHUH
·V
KDYHWRJRWKURXJKD-1',ORRNXSLIWKH\ZDQWWR
:DWFKLW FDQDQGWKHU PDNHPRUHEHDQVRIWKDWW\SH
H·V
FDQ
2QWKHH[DPV
RPHIRONVDUHF
7KHJHW+DQGOH PHWKRGUHWXUQVD6HULDOL]DEOH
WKHZRUG³FDQ´ RQIXVHGE\ REMHFWWKDWFDQEHXVHGODWHUWRUHHVWDEOLVKFRQWDFW
DVLQ³&DQDVHV
FOLHQWFDOOJHW3U VLRQEHDQ ZLWKWKHVHUYHUDQGJHWEDFNWKHVWXEWRWKH
LPDU\.H\ RQWK
REMHFWVWXE"´ H(-%
FRPSRQHQWLQWHUIDFHWKDWWKHFOLHQWXVHGWRJHWWKH
'HSHQGVRQKRZ
KDQGOH
\RXGH¿QH³FDQ
IRUWKHH[DPWKH ´$QG 7KHKDQGOHKDVRQHPHWKRGJHW(-%2EMHFW WKDW
DQVZHUZRXOGE
,QRWKHUZRUGVM H12
XVWEHFDXVHVRP UHWXUQVWKH5HPRWHVWXEDVW\SH(-%2EMHFW7KDW
LVOHJDOO\H[SRV HWKLQJ
PHDQVWKHFDOOH
HGWRWKHFDOOHU
ZKLFK PHDQVWKHVWXEPXVWEHFDVWDQGQDUURZHGMXVWDV
UFDQ&203,/( \RXPXVWGRZLWKWKHKRPHVWXEWKDW\RXJHWIURPD
PHWKRGFDOOLIWK ZLWKWKH
HVSHFVD\V\R -1',ORRNXS
WKHQ\RXFDQ¶W6 XFDQ¶W
RMXVWEHFDXVH\
FRPSLOH GRHVQ RXFDQ
LQJWRWKHVSHF
¶WPHDQ\RXFD
Q DFFRUG 7KHLV,GHQWLFDO PHWKRGLVNLQGRIOLNHGRLQJDQ
5HPHPEHUWKHU HTXDOV PHWKRGRQWKHVHUYHU,WUHWXUQVWUXHIRU
SLOHUODZDQGWK H¶VFRP
HQWKHUH¶V(-% WZRGLIIHUHQWVWDWHOHVVEHDQVIURPWKHVDPHKRPH
2QWKHH[DPZ VSHFODZ
H¶UHORRNLQJIRU(
WKHTXHVWLRQ'2 -%ODZ,I IDOVHIRUWZRGLIIHUHQWVWDWHIXOEHDQVIURPWKHVDPH
(6LQYROYHFRP
\RX¶OONQRZIURP SLODWLRQ KRPHDQGWUXHIRUUHIHUHQFHVWRHQWLWLHVZLWKWKH
WKHZRUGLQJ
VDPHSULPDU\NH\
&KDSWHU
WKHFOLHQWYLHZ
)JMIV¼[KTQMV\QV\MZNIKM[KIVJMTWKIT
7EVE LOOKED AT ONLY THE 2EMOTE CLIENT INTERFACES FOR A BEAN SO FAR BUT AS
OF %*" SESSION AND ENTITY BEANS CAN EXPOSE A LOCAL CLIENT VIEW )N OTHER
WORDS CLIENT INTERFACES THAT DO NOT EXTEND JAVARMI2EMOTE
7HAT DOES THIS MEAN 4HAT THE HOME OBJECT AND %*" OBJECT ARE NOT 2EMOTE
OBJECTS 4HEYRE RUNNING IN THE SAME *6- AS THE CLIENT AND THE BEAN )N THE
ENTITY BEAN #-2 CHAPTER WELL LOOK AT WHY LOCAL INTERFACES WERE ADDED TO
THE SPEC &OR NOW THINK OF THEM AS A VERY SPECIAL CASE
5HPRWHFOLHQWYLHZ /RFDOFOLHQWYLHZ
LQWHUIDFH!! LQWHUIDFH!! LQWHUIDFH!! LQWHUIDFH!!
5HPRWH 5HPRWH (-%/RFDO+RPH (-%/RFDO2EMHFW
PHWKRGV PHWKRGV
LQWHUIDFH!! LQWHUIDFH!! LQWHUIDFH!! LQWHUIDFH!!
(-%+RPH (-%2EMHFW $GYLFH+RPH/RFDO $GYLFH/RFDO
PHWKRGV PHWKRGV FUHDWH JHW$GYLFH
LQWHUIDFH!! LQWHUIDFH!! The local interfaces do NOT
$GYLFH+RPH $GYLFH extend java.rmi.Remote
FUHDWH JHW$GYLFH (and our naming conventio n is
not required... but you nee d
to distin gui sh it
SOMETHING ace s)
from you r Re mo te int erf
YiX`e
gfn\i
7KH5HPRWHLQWHUIDFHV(-%+RPHDQG(-%2EMHFWKDYHPRUHPHWKRGV
WKDQWKHORFDOLQWHUIDFHV(-%/RFDO+RPHDQG(-%/RFDO2EMHFW)OLS
EDFNWKURXJKWKLVFKDSWHUDQGORRNDWWKHPHWKRGVIRU(-%+RPH
DQG(-%2EMHFWDQGWU\WRZRUNRXWZKLFKPHWKRGVLQWKRVH5HPRWH
LQWHUIDFHVPLJKWEHLQDSSURSULDWHRUQRWQHHGHGLQWKHORFDOLQWHUIDFHV
7KLQNDERXWWKHLPSOLFDWLRQVRIKDYLQJWKHLQWHUIDFHVORFDOWRWKHFOLHQW
\RXDUHKHUH
5HPRWHYVORFDOFOLHQWYLHZ
5(027(FOLHQWYLHZ
&RPSRQHQWLQWHUIDFH
&RPSRQHQWLQWHUIDFH
VHUYLFHV
(-%
VWXE REMHFW
EHDQ
HV
FOLHQW
+RPHLQWHUIDFH
VHUYLF
+RPHLQWHUIDFH
+RPH
REMHFW
FOLHQWKHDS VWXE
VHUYHUKHDS
/2&$/FOLHQWYLHZ
&RPSRQHQWLQWHUIDFH
The client still canÕt get to No stubs!!
VHUYLFHV
the bean directly, because (-%
the server still needs a place REMHFW
to intercept the call to the EHDQ
bean (so the server can add FOLHQW
services). But this time, the
HV
client has a local reference
+RPHLQWHUIDFH
VHUYLF
to the home and component +RPH
interface objects. REMHFW
VHUYHUKHDS
&KDSWHU
WKHFOLHQWYLHZ
6KDUSHQ \RXU SHQFLO
*LYHQWKDWWKHFOLHQWKDVDSODLQROGHYHU\GD\-DYD
UHIHUHQFHWRWKHKRPHDQGFRPSRQHQWLQWHUIDFHV
LHWKHKRPHREMHFWDQGWKH(-%REMHFW ZKLFK
RIWKH5HPRWHLQWHUIDFHPHWKRGVGR\RXWKLQNDUH
DSSURSULDWHIRUWKHORFDOFOLHQWYLHZ"
,QRWKHUZRUGVZKLFKPHWKRGVRI(-%+RPHDUHQRWLQ
(-%/RFDO+RPHDQGZKLFKPHWKRGVRI(-%2EMHFWDUHQRWLQ
(-%/RFDO2EMHFW":K\"
2IWKHIRXUPHWKRGVLQ
(-%+RPH(-%/RFDO+RPH
KDVRQO\RQH:KLFKRQH"
LQWHUIDFH!! LQWHUIDFH!!
(-%+RPH (-%/RFDO+RPH
(-%0HWD'DWDJHW(-%0HWD'DWD
+RPH+DQGOHJHW+RPH+DQGOH 1 BBBBBBBBBBBBBBBBBBBBBBBBB
YRLGUHPRYH +DQGOHK
YRLGUHPRYH 2EMHFWNH\
2IWKH¿YHPHWKRGVLQ(-%2EMHFW
(-%/RFDO2EMHFWKDVRQO\IRXU DQG
RQHRIWKHIRXULVVOLJKWO\GLIIHUHQW
:KLFKIRXU"
LQWHUIDFH!! LQWHUIDFH!!
(-%2EMHFW (-%/RFDO2EMHFW
2EMHFWJHW3ULPDU\.H\
BBBBBBBBBBBBBBBBBBBBBBBBB
(-%+RPHJHW(-%+RPH 1
2 BBBBBBBBBBBBBBBBBBBBBBBBB
+DQGOHJHW+DQGOH
3 BBBBBBBBBBBBBBBBBBBBBBBBB
YRLGUHPRYH
4 BBBBBBBBBBBBBBBBBBBBBBBBB
ERROHDQLV,GHQWLFDO (-%2EMHFWR
\RXDUHKHUH
ORFDOLQWHUIDFHV
?PQKPUM\PWL[UISM[MV[MNWZ\PMTWKITKTQMV\QV\MZNIKM['
9OU ALREADY KNOW THAT THE LOCAL CLIENT INTERFACES ARE MISSING SOME OF THE METHODS
FROM THEIR 2EMOTE COUNTERPARTS ,ETS lGURE OUT WHICH ONES ARE MISSING AND WHY
,W_MVMMLPIVLTM[_Q\PTWKITQV\MZNIKM['
2EMEMBER WHY HANDLES EXIST IN %*"TO GIVE YOU A 3ERIALIZABLE OBJECT THAT YOU
CAN USE TO RE
ESTABLISH A STUB TO THE %*" OBJECT YOUD BEEN WORKING WITH 4HE
HANDLE IS JUST AN ABSTRACTION OF A REMOTE CONNECTION 3O DOES THIS MAKE SENSE
ON A LOCAL CLIENT
,W_MVMML-2*5M\I,I\I_Q\PTWKITQV\MZNIKM['
2EMEMBER WHAT %*"-ETA$ATA IS USED FORTO GET REmECTION
LIKE INFO ABOUT A
BEAN )F YOU CALL GET%*"-ETA$ATA ON A BEANS 2EMOTE HOME YOU GET BACK
AN OBJECT THAT IMPLEMENTS %*"-ETA$ATA 4HAT INTERFACE %*"-ETA$ATA HAS
METHODS THAT LET YOU INTERROGATE THE BEAN AND LEARN MORE ABOUT THE CLASSES THAT
MAKE UP THE COMPONENT 7OULD A LOCAL CLIENT EVER NEED %*"-ETA$ATA
,W_MVMMLQ[1LMV\QKIT_Q\PTWKITQV\MZNIKM['
2EMEMBER WHY IS)DENTICAL EXISTSTO LET YOU COMPARE TWO HOME OR
COMPONENT INTERFACE REFERENCES TO SEE IF THEY REFER TO hMEANINGFULLY EQUIVALENTv
BEANS ON THE SERVER 7OULD YOU NEED TO USE IS)DENTICAL ON A LOCAL CLIENT "IG
(INT THE SERVER IS FREE TO IMPLEMENT EQUALS ANY WAY IT CHOOSES
,W_MVMMLXZQUIZaSMaQVNWZUI\QWV_Q\PTWKITQV\MZNIKM['
2EMEMBER WHY PRIMARY KEYS EXISTTO UNIQUELY IDENTIFY ENTITY BEANS 7OULD
YOU EVER NEED TO IDENTIFY AN ENTITY BEAN ON A LOCAL CLIENT
,W_MVMMLZMUW^MUM\PWL[_Q\PTWKITQV\MZNIKM['
2EMEMBER WHAT REMOVE IS USED FORTO TELL THE CONTAINER THAT YOURE DONE
WITH A BEAN FOR 3ESSION BEANS OR TO TELL THE CONTAINER TO PERMANENTLY DELETE THE
ENTITY FOR ENTITY BEANS 7OULD A LOCAL CLIENT NEED TO CALL REMOVE ON A BEAN
&KDSWHU
WKHFOLHQWYLHZ
?PMVaW]\PQVSPIVLTM\PQVS:MUW\M
4WKITKTQMV\[LWV¼\VMMLPIVLTM[
,OCAL CLIENTS HAVE NO USE FOR A HANDLE BECAUSE HANDLES ARE
STRICTLY FOR GETTING A SAVABLE 3ERIALIZABLE OBJECT THAT KNOWS HOW
TO REESTABLISH COMMUNICATION WITH THE 2EMOTE OBJECT
/2&$/FOLHQWYLHZ
A local client
Java referencehatos a plain old no stubs,
or component inte the home no handles
VHUYLFHV
thereÕs no need rface, so (-%
for handles. REMHFW
EHDQ
FOLHQW
HV
VHUYLF
+RPH
REMHFW
?PWVMML[-2*5M\I,I\I_PMV
aW]¼^MOW\ZMNTMK\QWV'
4WKITKTQMV\[LWV¼\VMML-2*5M\I,I\I
7ITH THE *AVA REmECTION !0) YOU CAN INTERROGATE AN OBJECT TO GET ALL
SORTS OF INFORMATION ABOUT ITS CLASS 7ITH 2EMOTE OBJECTS YOU DONT HAVE
THAT OPTION BECAUSE YOU CANT GET A REFERENCE TO THE CLASS OF THE 2EMOTE
OBJECT 4HE ONLY THING YOU CAN INTERROGATE ON A 2EMOTE CLIENT ARE THE
STUB OBJECTS BUT THEY CANT TELL YOU ANYTHING ABOUT THE REAL %*" OBJECT OR
(OME OBJECT
3O WHILE A 2EMOTE HOME CLIENT HAS TO USE %*"-ETA$ATA THE INTERFACE
RETURNED FROM THE %*"(OME GET%*"-ETA$ATA METHOD TO GET INFO A
LOCAL CLIENT WILL SIMPLY USE THE *AVA REmECTION METHODS GET#LASS ETC
\RXDUHKHUH
ORFDOLQWHUIDFHV
,WaW]VMMLQ[1LMV\QKIT_PMV\PMZM¼[MY]IT[ '
4WKITKTQMV\[[\QTTVMMLQ[1LMV\QKIT
2EMEMBER FOR A 2EMOTE CLIENT THE ONLY LOCAL COMPARISON YOU DO IS ON TWO STUB OBJECTS
USING EQUALS 4HIS DOESNT WORK WHEN YOU WANT TO COMPARE SOMETHING BACK ON THE
SERVER IN THIS CASE THE TWO %*" OBJECT REFERENCES 4HATS WHAT IS)DENTICAL IS FOR "UT LOCAL
CLIENTS HAVE THE REAL THING 4HEY HAVE THE REAL REFERENCE TO THE %*" OBJECT SO THEY CAN USE
EQUALS TO SEE IF TWO %*" OBJECT LOCAL REFERENCES ARE MEANINGFULLY EQUIVALENT "UT
THATS STILL NOT WHAT YOU WANT 4HERE IS NO GUARANTEE IN THE SPEC FOR THE RESULTS YOULL GET
WITH EQUALS 3O WHILE IT SEEMS LIKE YOU COULD JUST USE EQUALS RATHER THAN IS)DENTICAL
WITH A LOCAL CLIENT THE SPEC DOES NOT GUARANTEE THAT THE RESULTS WILL BE THE SAME "OTTOM
LINE IF YOU WANT TO KNOW IF TWO %*" OBJECT REFERENCES ARE REFERENCING THE SAME SESSION
OBJECT YOU HAVE TO USE IS)DENTICAL EVEN WHEN THE %*" OBJECT IS LOCAL
5(027(FOLHQWYLHZ
LV,GHQWLFDO LV,GHQWLFDO
VHUYLFHV
(-%
FOLHQW VWXE REMHFW EHDQ
A Remote clie
method call, isnt
Id
has to make a R
emote
en
meaningful compa tical(), to get
EJB object. Cal rison info about an
wonÕt tell you anling equals() on a stub
ything useful.
/2&$/FOLHQWYLHZ
ical() on
() and isIdent
Calling equals object reference are e HTXDOV
a local EJBteed to give you the sam
VHUYLFHV
FOLHQW
not guaran still need isIdentical()
(-%
LV,GHQWLFDO REMHFW
result. You e if two EJB object EHDQ
to determinare to the same Session
references
object.
&KDSWHU
WKHFOLHQWYLHZ
?Pa[WUIVaZMUW^MUM\PWL['
.WZ:MUW\MKTQMV\[\ _WQV\PMPWUMXT][WVMQV\PM
KWUXWVMV\QV\MZNIKM
2EMEMBER 2EMOTE CLIENTS HAVE THREE REMOVE METHODS AVAILABLE TWO IN THE
HOME AND ONE IN THE COMPONENT INTERFACE 4HE REMOVE THAT COMES FROM
%*"/BJECT IS SIMPLE IF YOU CALL IT YOURE SAYING YOU WANT TO REMOVE THAT VERY BEAN )N
OTHER WORDS THE BEAN WHOSE %*"/BJECT YOU USED TO CALL REMOVE !ND FOR SESSION
BEANS REMEMBER CALLING REMOVE SIMPLY TELLS THE CONTAINER THAT YOURE DONE WITH
THE BEAN )TS GOOD MANNERS AND IT IMPROVES SCALABILITY SINCE THE SERVER CAN STOP
KEEPING CLIENT
SPECIl C RESOURCES ON YOUR BEHALF RATHER THAN WAITING SAY FOR YOUR
SHOPPING SESSION TO TIME OUT FROM INACTIVITY
"UT THINGS ARENT SO SIMPLE WHEN YOU CALL REMOVE ON A HOME &OR ONE THING YOU
ACTUALLY CANT REMOVE A HOME 4HE SERVER KEEPS THE BEAN HOME ALIVE WHETHER YOURE
AROUND OR NOT SO THERES NO SIGNIl CANT CLIENT
SPECIl C RESOURCES 4HERES NO NEED TO
TELL THE SERVER YOURE DONE WITH THE HOME BECAUSE THE SERVER WOULD SIMPLY SAY h3O
WHAT v
4HEN WHAT DOES IT MEAN TO CALL REMOVE ON A HOME
)T MEANS YOURE TELLING THE HOME TO REMOVE ONE OF THE BEANS THAT CAME FROM THAT
HOME !ND THAT MEANS YOU HAVE TO IDENTIFY WHICH BEAN YOURE TALKING ABOUT
5(027(FOLHQWYLHZ
LQWHUIDFH!! LQWHUIDFH!!
(-%+RPH (-%2EMHFW
(-%0HWD'DWDJHW(-%0HWD'DWD 2EMHFWJHW3ULPDU\.H\
+RPH+DQGOHJHW+RPH+DQGOH (-%+RPHJHW(-%+RPH
YRLGUHPRYH +DQGOHK +DQGOHJHW+DQGOH
YRLGUHPRYH 2EMHFWNH\ YRLGUHPRYH
ERROHDQLV,GHQWLFDO 2EMHFWR
ainer
es tell the contthat
These two remov iÞc bean from This version tells
to remove a spechave to say WHICH to remove the be the container
home, but you er the handle (session an
EJBObject you on whose
invoked remove().
bean using eith s), or primary key
or entity beanonly).
(entity beans
\RXDUHKHUH
UHPRYHPHWKRGV
:K\WKHUH·VQRWDQRDUJUHPRYH
PHWKRGLQWKHKRPH
+H\KRPLH,·G
OLNHWRUHPRYHRQHRIWKH
EHDQV\RXMXVWJDYHPH
7KDQNV
5RJHUWKDW
0U&OLHQW,·OOWHOOWKH
FRQWDLQHUULJKWQRZ
:KLFKEHDQ"""<RX·YHJLYHQRXW
OLNHDPLOOLRQEHDQVVRIDUDQG,KDYH
QRLGHDZKLFKRQH\RXZDQWWRQXNH
&RPHRQZRUNZLWKPHKHUH+RPLH,
QHHGVRPHWKLQJWKDWXQLTXHO\LGHQWLÀHV
WKHEHDQ2WKHUZLVH,·OOMXVWSLFNRQHDW
UDQGRPDQGNLOOLW$QGZHUHDOO\GRQ·W
ZDQWWKDWQRZGRZH"
&RQWDLQHUSOHDVH
UHPRYHDEHDQRQ
EHKDOIRIWKLVFOLHQW
&KDSWHU
WKHFOLHQWYLHZ
0W_KIVaW]][MIZMUW^M\PI\\ISM[I
PIVLTM_PMVaW]LWV¼\PI^MIPIVLTM'
4WKITKTQMV\[LWV¼\PI^MPIVLTM[[WTWKITPWUM[ <RXGRQ·WFDOOUHPRYHRQD
LWV¼\PI^MIZMUW^M\PI\\ISM[IPIVLTM KRPHWRUHPRYHWKHKRPH
)F LOCAL HOME INTERFACES DONT HAVE HANDLES THEN
THERES NO WAY YOU COULD HAVE A REMOVE METHOD THAT <RXFDOOUHPRYHRQDKRPH
TAKES A HANDLE "ECAUSE IN ORDER TO PASS A HANDLE TO
THE HOME THAT UNIQUELY IDENTIlES THE BEAN YOURE WRWHOOWKHKRPHWRUHPRYH
TRYING TO REMOVE YOUD HAVE TO lRST GET THE BEANS
HANDLE !ND SINCE LOCALLY
EXPOSED BEANS DONT HAVE DEHDQ
HANDLES YOU SEE THE PROBLEM
WKHUH DUH QR $EHDQIURPWKDWKRPHW\SH
'XPE 4XHVWLRQV
Q: 7HAT IF YOU HAVE A LOCAL HOME BUT YOU HAVE A 7KDWPHDQV\RXPXVW
2EMOTE %*" OBJECT REFERENCE #ANT YOU PASS THE 2EMOTE
BEANS HANDLE TO THE LOCAL HOME XQLTXHO\LGHQWLI\WKHEHDQ
A: \RXZDQWUHPRYHGZKHQ
./ "ECAUSE YOU CANT MIX LOCAL AND 2EMOTE
INTERFACES TOGETHER /NLY A LOCAL BEAN COMES FROM A LOCAL
HOME AND VICE VERSA 3O IT WILL .%6%2 BE POSSIBLE TO HAVE
\RXFDOODKRPHUHPRYH
A 2EMOTE BEANS HANDLE TO GIVE TO THAT SAME 2EMOTE
BEANS HOME UNLESS THAT HOME IS ALSO 2EMOTE
PHWKRG)RUHQWLW\EHDQV
7E DIDNT SAY THAT VERY WELL DID WE /+ HOW ABOUT
THISA 2EMOTE HOME WILL HAND OUT ONLY 2EMOTE REFERENCES
XVHWKHSULPDU\NH\RUD
TO THE COMPONENT %*"/BJECT INTERFACE FOR THAT BEAN TYPE
AND A LOCAL HOME WILL ONLY RETURN LOCAL REFERENCES TO THE
KDQGOHDQGIRUVHVVLRQ
COMPONENT %*",OCAL/BJECT INTERFACE
EHDQVXVHDKDQGOH
Q: 4ELL ME AGAIN WHY YOU CANT REMOVE THE HOME
%XWKDQGOHVRQO\ZRUNIRU
A: 4HERES NEVER A REASON TO REMOVE THE HOME IN 5HPRWHKRPHFOLHQWV
OTHER WORDS TO TELL THE CONTAINER YOURE DONE WITH IT
BECAUSE THE CONTAINER MUST KEEP THE HOME AROUND WITH
OR WITHOUT YOUR INTEREST 3O IF YOU WERE ABLE TO SAY REMOVE
TO THE HOME THE CONTAINER WOULD SAY h'EEDONT FLATTER
YOURSELF BUDDY 7HAT ) DO HERE ON THE SERVER IS NOT !"/54
YOU ) COULD CARE LESS WHEN YOURE DONE WITH YOUR HOME
REFERENCEv
\RXDUHKHUH
FRPSDULQJORFDOYV5HPRWH
+WUXIZQVO:MUW\M^[4WKITQV\MZNIKM[
4HE %*"/BJECT AND %*"(OME INTERFACES HAVE MORE METHODS THAN THE
%*",OCAL/BJECT AND %*",OCAL(OME INTERFACES BECAUSE THERE ARE METHODS
THAT DONT MAKE SENSE IN A LOCAL CONTEXT
5(027(FOLHQWYLHZ /2&$/FOLHQWYLHZ
LQWHUIDFH!! LQWHUIDFH!!
(-%+RPH (-%/RFDO+RPH
Local clients can
(-%0HWD'DWDJHW(-%0HWD'DWD (-%0HWD'DWDJHW(-%0HWD'DWD
they donÕt need use reßection
+RPH+DQGOHJHW+RPH+DQGOH
EJBMetaData., so
+RPH+DQGOHJHW+RPH+DQGOH No need for a ha
clientÑthereÕs no ndle with a local
YRLGUHPRYH +DQGOHK YRLGUHPRYH +DQGOHK stub!
YRLGUHPRYH 2EMHFWNH\ YRLGUHPRYH 2EMHFWNH\ locally-accessed
handles, so you cabeans donÕt have
remove one. nÕt use a handle
to
LQWHUIDFH!! LQWHUIDFH!!
(-%2EMHFW (-%/RFDO2EMHFW
2EMHFWJHW3ULPDU\.H\ 2EMHFWJHW3ULPDU\.H\
(-%+RPHJHW(-%+RPH (-%/RFDO+RPHJHW(-%/RFDO+RPH changes from Remote to local
l clients
+DQGOHJHW+DQGOH +DQGOHJHW+DQGOH No handles in loca
YRLGUHPRYH YRLGUHPRYH
ERROHDQLV,GHQWLFDO (-%2EMHFWR ERROHDQLV,GHQWLFDO 2EMHFWR
&KDSWHU
WKHFOLHQWYLHZ
6KDUSHQ \RXU SHQFLO
%DVHGRQZKDW\RXQRZNQRZDERXWWKHGLIIHUHQFHEHWZHHQORFDO
DQG5HPRWHFOLHQWLQWHUIDFHVGHFLGHLIWKHIROORZLQJVWDWHPHQWV
DUHWUXHRUIDOVH<RX¶OOKDYHWRPDNHVRPHLQIHUHQFHVDQGVPDUW
JXHVVHVIRUVRPHRIWKHP
6HOHFWDOOWKDWDUHWUXH
R7KHRQO\ZD\WRUHPRYHDORFDOVHVVLRQEHDQLVWKURXJKWKHFRPSRQHQWLQWHUIDFH
R(QWLW\EHDQVFDQEHUHPRYHGWKURXJKDORFDOKRPHLQWHUIDFH
R,I\RXVHHDQLV,GHQWLFDO FDOOWKLVPXVWEHDORFDOEHDQ
R,I\RXVHHDJHW+DQGOH FDOOWKLVPXVWEHD5HPRWHEHDQ
R,IWKHFOLHQWLVFDWFKLQJD5HPRWH([FHSWLRQRQDKRPHPHWKRGWKHEHDQ¶VKRPH
LQWHUIDFHPXVWH[WHQG(-%/RFDO+RPH
R,IWKHFOLHQWLVQRWKDQGOLQJD5HPRWH([FHSWLRQRQDEXVLQHVVPHWKRGWKHEHDQ¶V
FRPSRQHQWLQWHUIDFHPXVWH[WHQG(-%2EMHFW
R,I\RXVHHDFDOOWRJHW(-%0HWD'DWD WKHEHDQ¶VFRPSRQHQWLQWHUIDFHPXVWH[WHQG
(-%/RFDO2EMHFW
R,I\RXGRD-1',ORRNXSRQDORFDOKRPH\RXPXVWQDUURZWKHREMHFWUHWXUQHGIURP-1',
R7KHUHDUHWKUHHPHWKRGVLQWKH(-%/RFDO2EMHFWLQWHUIDFH
R7KHUHDUHWZRPHWKRGVLQWKH(-%/RFDO+RPHLQWHUIDFH
\RXDUHKHUH
ORFDOLQWHUIDFHV
?ZQ\QVO\PMTWKITKTQMV\QV\MZNIKM[
.OW THAT WEVE COVERED WHAT THE CLIENT SEES IN A LOCAL INTERFACE LETS LOOK AT
YOUR RESPONSIBILITY AS A "EAN 0ROVIDER )N OTHER WORDS WHAT YOU HAVE TO DO TO
WRITE THE LOCAL INTERFACES FOR YOUR BEAN
&RPSRQHQWLQWHUIDFH
ocalObject
SDFNDJHKHDG¿UVW extend EJBLJBObject
LPSRUWMDYD[HME
instead of E
SXEOLFLQWHUIDFH$GYLFH/RFDOH[WHQGV(-%/RFDO2EMHFW^
SXEOLF6WULQJJHW$GYLFH
No RemoteExce
`
this return type doesnÕt need to be RMI- ption!!
IIOP compliant (although it certainly can
be, of course, like String)
+RPHLQWHUIDFH
ocalHome
SDFNDJHKHDG¿UVW extend EJBLJBHome
LPSRUWMDYD[HME
instead of E
SXEOLFLQWHUIDFH$GYLFH+RPH/RFDOH[WHQGV(-%/RFDO+RPH^
SXEOLF$GYLFH/RFDOFUHDWH WKURZV&UHDWH([FHSWLRQ
`
This MUST be the loc
al component interface ! still needs a CreateException
but no RemoteException
5XOHVIRUORFDOLQWHUIDFHV
,PSRUWMDYD[HME
RUXVHIXOO\TXDOL¿HGQDPHV
([WHQG(-%/RFDO2EMHFW IRUWKHFRPSRQHQWLQWHUIDFH RU
(-%/RFDO+RPH IRUWKHKRPHLQWHUIDFH
'HFODUHRQHRUPRUHEXVLQHVVPHWKRGVLQWKHFRPSRQHQWLQWHUIDFH
$OOFUHDWHPHWKRGVLQWKHORFDOKRPHPXVWUHWXUQWKHORFDOFRPSRQHQWLQWHUIDFH
DQGGHFODUHD&UHDWH([FHSWLRQ
$Q\PHWKRG\RXGHFODUHLQWKHKRPHRUFRPSRQHQWLQWHUIDFHFDQGHFODUH\RXU
RZQDSSOLFDWLRQH[FHSWLRQVZKLFKPXVWEHFRPSLOHUFKHFNHGH[FHSWLRQV LH
QRWVXEFODVVHVRI5XQWLPH([FHSWLRQ
<RXPXVW127GHFODUHD5HPRWH([FHSWLRQIRUDQ\PHWKRGV
&KDSWHU
WKHFOLHQWYLHZ
AW]KIVPI^MJW\PI:MUW\M
IVLTWKITKTQMV\^QM_NWZIJMIV
J]\aW]XZWJIJTa_WV¼\ <RXFDQ·WPL[ORFDODQG
7E MENTIONED EARLIER THAT LOCAL INTERFACES ARE 5HPRWHLQWHUIDFHVWRJHWKHU
A VERY SPECIAL CASE FOR A CLIENT VIEW 4HEY WERE
INTRODUCED WITH VERSION OF THE %*" SPEC WHICH IRUWKHVDPHEHDQHYHQ
THIS BOOK IS BASED ON AND THE ORIGINAL INTENT WAS
TO SUPPORT CONTAINER
MANAGED RELATIONSHIPS IN WKRXJKDJLYHQEHDQFDQ
ENTITY BEANS "UT ENOUGH CUSTOMERS AND VENDORS
ASKED FOR THE ABILITY TO HAVE NON
2EMOTE INTERFACES H[SRVHERWKD5HPRWHDQG
FOR BEANS SO THE *%% TEAM DECIDED TO MAKE IT
AVAILABLE FOR SESSION BEANS AS WELL AS ENTITY BEANS ORFDOFOLHQWYLHZ
"UT REGARDLESS OF WHICH YOU CHOOSE ITS VERY
UNLIKELY YOULL HAVE A DESIGN THAT REQUIRES BOTH
A LOCAL AND 2EMOTE CLIENT VIEW )F YOUR BEAN IS IN
%XWD5HPRWHKRPHZLOOJLYH
A CONTAINER
MANAGED RELATIONSHIP WITH ANOTHER
ENTITY BEAN YOULL LEARN ALL ABOUT THIS IN THE ENTITY
RXWRQO\5HPRWHFRPSRQHQW
CHAPTERS YOU HAVE NO CHOICE 4HE BEAN MUST
EXPOSE ITSELF LOCALLY !ND IN THAT CASE ITS ALMOST
LQWHUIDFHUHIHUHQFHV VWXEV
IMPOSSIBLE TO THINK OF A REASON TO ALSO HAVE THAT
SAME BEAN EXPOSED TO 2EMOTE CLIENTS FOR OTHER
DQGDORFDOKRPHZLOOJLYH
PURPOSES RXWRQO\ORFDOFRPSRQHQW
*UST KNOW THAT IT IS LEGAL TO HAVE BOTH
"UT YOU CAN NEVER EVER EVER MIX AND MATCH
LQWHUIDFHUHIHUHQFHV
! 2EMOTE HOME INTERFACE CAN GIVE OUT ONLY 2EMOTE UHJXODU-DYDUHIHUHQFHV
COMPONENT INTERFACE REFERENCES IN OTHER WORDS A
STUB TO THE 2EMOTE %*"/BJECT ! LOCAL HOME CAN
GIVE OUT ONLY LOCAL COMPONENT INTERFACE REFERENCES
IN OTHER WORDS A REGULAR *AVA HEAP REFERENCE TO
THE %*",OCAL/BJECT
\RXDUHKHUH
ORFDOFOLHQWV
6KDUSHQ \RXU SHQFLO
&KDQJHWKH$GYLFH&OLHQWIURPD5HPRWHFOLHQWWRDORFDOFOLHQW
XVLQJWKHORFDOLQWHUIDFHVIRU$GYLFH/RFDODQG$GYLFH+RPH/RFDO
'R127WXUQWKHQH[WSDJH
LPSRUWMDYD[QDPLQJ
LPSRUWMDYDUPL
LPSRUWMDYD[UPL
LPSRUWKHDG¿UVW
LPSRUWMDYD[HME
SXEOLFFODVV$GYLFH&OLHQW^
SXEOLFVWDWLFYRLGPDLQ 6WULQJ>@DUJV ^
QHZ$GYLFH&OLHQW JR
`
SXEOLFYRLGJR ^
WU\^
&RQWH[WLF QHZ,QLWLDO&RQWH[W
2EMHFWR LFORRNXS ³$GYLVRU´
$GYLFH+RPHKRPH $GYLFH+RPH 3RUWDEOH5HPRWH2EMHFWQDUURZ R$GYLFH+RPHFODVV
$GYLFHDGYLVRU KRPHFUHDWH
6\VWHPRXWSULQWOQ DGYLVRUJHW$GYLFH
`FDWFK ([FHSWLRQH[ ^
H[SULQW6WDFN7UDFH
`
`
`
:KDWKDVWRFKDQJH":ULWHWKHFKDQJHGOLQH RUOLQHV EHORZ
&KDSWHU
WKHFOLHQWYLHZ
-`KMX\QWV[QVKTQMV\QV\MZNIKM["_PI\\PMKTQMV\UQOP\OM\
! 2EMOTE INTERFACE MUST HAVE 2EMOTE%XCEPTION DECLARED ON EVERY METHOD 4HAT MEANS THE
CLIENT USING A 2EMOTE INTERFACE MUST DEAL WITH 2EMOTE%XCEPTION FOR EVERY 2EMOTE METHOD CALL
"UT LOCAL INTERFACES DONT HAVE THAT RESTRICTION 4HE ONLY METHODS IN A LOCAL CLIENT INTERFACE THAT
MUST DECLARE EXCEPTIONS ARE THE CREATE AND REMOVE METHODS FOR SESSION BEANS ENTITY BEANS
ALSO HAVE A lNDER METHOD THAT DECLARES A &INDER%XCEPTION
7E HAVE A WHOLE CHAPTER DEVOTED TO EXCEPTIONS IN %*" SO WE WONT GO INTO THE DETAILS NOW BUT
THE ESSENCE IS THIS IF A BEAN OR THE #ONTAINER GENERATES A RUNTIME EXCEPTION 2EMOTE CLIENTS SEE
THE EXCEPTION AS A CHECKED 2EMOTE%XCEPTION BUT LOCAL CLIENTS SEE IT AS AN UNCHECKED %*"%XCEPTION
)N ADDITION TO WHATEVER OTHER CHECKED EXCEPTIONS CALLED APPLICATION EXCEPTIONS IN %*" THE
INTERFACE METHODS DECLARE ALL 2EMOTE INTERFACE METHODS CAN THROW A 2EMOTE%XCEPTION AND
LOCAL CLIENT INTERFACE METHODS CAN ALWAYS THROW AN %*"%XCEPTION 3O 2EMOTE CLIENTS MUST WRAP ALL
CALLS TO A HOME OR COMPONENT INTERFACE METHOD IN A TRYCATCH WHILE LOCAL CLIENTS USE A TRYCATCH
ONLY IF THE INTERFACE METHOD DECLARES AN APPLICATION EXCEPTION WHICH INCLUDES #REATE%XCEPTION
2EMOVE%XCEPTION &INDER%XCEPTION AND ANY OTHER EXCEPTIONS THE "EAN 0ROVIDER DECLARES IN THE
METHODS OF THE BEANS CLIENT INTERFACES
LNDICATES A COMPILER CHECKED EXCEPTION IE NON 2UNTIME%XCEPTION
5(027(FOLHQWYLHZ /2&$/FOLHQWYLHZ
$//PHWKRGV MDYD[HME5HPRWH([FHSWLRQ MDYD[HME(-%([FHSWLRQ
&5($7(PHWKRGV MDYD[HME5HPRWH([FHSWLRQ MDYD[HME(-%([FHSWLRQ
MDYD[HME&UHDWH([FHSWLRQ MDYD[HME&UHDWH([FHSWLRQ
5(029(PHWKRGV MDYD[HME5HPRWH([FHSWLRQ MDYD[HME(-%([FHSWLRQ
MDYD[HME5HPRYH([FHSWLRQ MDYD[HME5HPRYH([FHSWLRQ
\RXDUHKHUH
ORFDOFOLHQWV
4WKITKTQMV\KWLM
#OMPARE THIS TO THE CODE MODIlCATIONS YOU MADE ON THE PREVIOUS SHARPEN
4O HELP SHOW THAT THE CALLS TO THE HOME AND COMPONENT INTERFACE ARE NO
LONGER 2EMOTE WEVE MADE THE EXCEPTION HANDLING MORE lNE
GRAINED .OTICE
THAT WERE NOT CATCHING A 2EMOTE%XCEPTION
LPSRUWMDYD[QDPLQJ
LPSRUWKHDG¿UVW
we got rid of javax.rmi and
LPSRUWMDYD[HME
java.rmi imports
SXEOLFFODVV$GYLFH/RFDO&OLHQW^
SXEOLFVWDWLFYRLGPDLQ 6WULQJ>@DUJV ^
QHZ$GYLFH/RFDO&OLHQW JR
`
SXEOLFYRLGJR ^
okup the
2EMHFWR QXOO
ug h J N D I, and do the loa real
to go thro ference to
WU\^ You still have ly this time you get a cere of EJBLocalHome),
usual way, onon the heap (an instan Home object..
&RQWH[WLF QHZ,QLWLDO&RQWH[W Java object a stub to a Remote EJB
R LFORRNXS ³$GYLVRU/RFDO´ instead of
`FDWFK 1DPLQJ([FHSWLRQQH[ ^
QH[SULQW6WDFN7UDFH
`
HereÕs a big ch
old cast (we stan ge! No narrowing!
Just a pl
return type of lo have to cast because the ain
ill
$GYLFH+RPH/RFDOKRPH $GYLFH+RPH/RFDO R
have to narrow it okup is Object, but we donÕt
$GYLFH/RFDODGYLVRU QXOO
since it isnÕt a st
WU\^ ub.)
DGYLVRU KRPHFUHDWH
od still declares a ception
The create() methbu not a RemoteEx
CreateException, t
`FDWFK &UHDWH([FHSWLRQFH[ ^
FH[SULQW6WDFN7UDFH
`
6\VWHPRXWSULQWOQ DGYLVRUJHW$GYLFH The busines
method calls. method call is no longer
` and since get Just a normal local met a Remote
` excpetions, t Advice() doesnÕt decla hod call,
have to be w he business method callre any
rapped in a t
ry/catch. doesnÕt
&KDSWHU
WKHFOLHQWYLHZ
YiX`e
gfn\i
?PI\PI[\WKPIVOMQV[QLM\PMJMIVKTI[['
7EVE SEEN HOW THE INTERFACES CHANGE AND HOW THE CLIENT CODE HAS TO
CHANGE WHEN YOU GO FROM A 2EMOTE TO LOCAL CLIENT VIEW "UT WHAT ABOUT THE
BEAN CLASS ITSELF 7HAT DO YOU THINK $OES THE BEAN CODE NEED TO CHANGE
IF YOURE GOING TO DEPLOY IT WITH A LOCAL CLIENT VIEW INSTEAD OF A 2EMOTE CLIENT
VIEW 7HAT IF YOU PLAN TO DEPLOY IT WITH BOTH A LOCAL AND 2EMOTE CLIENT VIEW
&OR NOW LETS ASSUME THAT THE ONLY METHOD THAT MATTERS IS THE BEANS
BUSINESS METHOD (ERES HOW IT LOOKS IN THE ORIGINAL BEAN CLASS
SXEOLF6WULQJJHW$GYLFH ^
6\VWHPRXWSULQWOQ ³LQJHWDGYLFH´
LQWUDQGRP LQW 0DWKUDQGRP
DGYLFH6WULQJVOHQJWK
UHWXUQDGYLFH6WULQJV>UDQGRP@
`
$O YOU SEE ANYTHING IN THAT METHOD THAT LOOKS SPECIlC TO A 2EMOTE CLIENT
VIEW 7OULD YOU NEED TO DO ANYTHING DIFFERENT WITH A LOCAL CLIENT
.O DONT THINK SO
!NYTHING THAT WORKS AS A RETURN TYPE OR ARGUMENT FOR A 2EMOTE METHOD IS
GUARANTEED TO WORK FOR A LOCAL METHOD AS WELL SO WERE /+ THERE +IND
OF A NO
BRAINER WHEN THE RETURN TYPE IS 3TRING THOUGH /+ THERE IS ONE
EXCEPTIONREMEMBER ACCORDING TO "EAN LAW YOU MUST NOT RETURN A BEANS
2EMOTE INTERFACE FROM A LOCAL INTERFACE METHOD
3O IT LOOKS LIKE AT LEAST WITH THIS BEAN WE SHOULD NEVER HAVE TO KNOW OR
CARE 7E SHOULD BE ABLE TO DEPLOY THE BEAN AS WRITTEN AND THE BEAN SHOULD
BE KEPT UNAWARE OF WHETHER ITS CLIENTS ARE 2EMOTE OR LOCAL
3OUNDS GOOD DOESNT IT 3IMPLE CLEAN OBJECT
ORIENTED
"UT THINK ABOUT IT SOME MORE )MAGINE A BEAN WITH MORE COMPLEX LOGIC
-ORE BUSINESS METHODS !RGUMENTS TO THOSE METHODS !RGUMENTS THE
METHOD MIGHT EVEN NEED TO ACT ON
(MMMMM CAN YOU THINK OF ANYTHING THAT THE BEAN MIGHT WANT TO TREAT
DIFFERENTLY IF IT KNEW THE CLIENT WERE LOCAL INSTEAD OF 2EMOTE
\RXDUHKHUH
SDVVLQJREMHFWVORFDOO\
:DLWDPLQXWH-DYD
SDVVHVREMHFWVORFDOO\E\SDVVLQJ
DFRS\RIWKHREMHFWUHIHUHQFHQRW
WKHREMHFWLWVHOI%XWZHNQRZWKDW
5HPRWHPHWKRGDUJXPHQWVDQGUHWXUQ
YDOXHVDUHSDVVHGDVD6HULDOL]HG
FRS\RIWKHDFWXDOREMHFW
,QRUGLQDU\ORFDOPHWKRGFDOOV-DYDSDVVHV
DQREMHFWUHIHUHQFHE\YDOXHDVDFRS\RIWKH
UHIHUHQFHYDULDEOH
7KHREMHFWLWVHOILVQHYHUSDVVHG
%XWZLWK5HPRWHFDOOVWKHREMHFWLWVHOILVFRSLHG
:LWK5HPRWHFDOOVWKHFDOOHGPHWKRGLVDOZD\V
ZRUNLQJRQDFRS\RIWKHFDOOHU¶VREMHFW
:LWKORFDOFDOOVWKHFDOOHGPHWKRGLVDOZD\VZRUNLQJ
ZLWKWKHFDOOHU¶VRULJLQDOREMHFW²QRWDFRS\
&KDSWHU
WKHFOLHQWYLHZ
)ZO]UMV\[\W:MUW\M^[TWKITUM\PWL[
/2&$/PHWKRGFDOO
'RJ
'RJ¿GR QHZ'RJ REMHFW
WKLVWUDLQ3HW ¿GR
^a\g
%()25( GRJ
a copy of the reference 'RJ UHIHUHQFH
(the remote control) not
the Dog object
YRLGWUDLQ3HW 'RJDUJ ^` 'RJ
REMHFW
r and the ÔÞdoÕ Yj_
Now the ÔargÕ paramel te pies. Both
variable are identicaDco
^a\g
'RJ
object. %()25( GRJ
reference the same og 'RJ UHIHUHQFHV
5(027(PHWKRGFDOO
'RJ¿GR QHZ'RJ
UHPRWH6WXEWUDLQ3HW ¿GR
'RJ
!
NOT the reference value REMHFW
'RJ
ItÕs a serialized copyctof
the actual Dog obje
REMHFW
^a\g
%()25( GRJ
'RJ UHIHUHQFH
py
YRLGWUDLQ3HW 'RJDUJ ^` The server Dog is a co
of the clien t D og
'RJ 'RJ
REMHFW REMHFW
^a\g Yj_
'RJ $)7(5 GRJV
&OLHQW 'RJ
UHIHUHQFHV 6HUYHU
\RXDUHKHUH
5HPRWHYVORFDO
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: 3O )M STILL NOT CLEAR IF THE
THE BEAN NEVER HAS TO WORRY THAT A
LOCAL CLIENT MIGHT BE MODIFYING THE
!ND A LOCAL CLIENT WONT HAVE CODE
TO HANDLE THE 2EMOTE%XCEPTIONS OR
BEAN -534 ALWAYS KNOW IF THE CLIENT BEANS OBJECT NARROW THE STUBS
IS 2EMOTE OR LOCAL 4HE BOTTOM LINE IS THAT DEPLOYING A
Q: 4HEN ITS JUST ABOUT
BEAN WITH A 2EMOTE VS LOCAL CLIENT
A: )TS NOT THAT THE BEAN MUST ARGUMENTS AND RETURN VALUES )S
THERE ANY OTHER REASON YOU COULDNT
VIEW IS A "IG $EAL )TS A COMMITMENT
4HE CLIENT HAS TO KNOW IN ADVANCE
BUT RATHER THAT THE BEAN MIGHT HAVE
DEPLOY A BEAN AND MAKE THE
TO KNOW )F IT MATTERS THAT THE BEAN
IS WORKING ON A THE CALLERS OBJECT
VIA A COPY OF THE CALLERS REFERENCE
DECISION FOR 2EMOTE VS LOCAL VIEW AT
DEPLOY TIME
Q: #AN YOU GET AROUND THIS BY
DECLARING YOUR 2EMOTE%XCEPTIONS
AS OPPOSED TO A COPY OF THE CALLERS ON YOUR LOCAL INTERFACE !ND COULD
OBJECT YOUR BEAN CODE MIGHT HAVE
TO CHANGE !ND THAT GOES FOR RETURN A: 4HERE IS ANOTHER REASON 4HE
YOU MAKE AN INTERFACE THAT IS BOTH
2EMOTE AND LOCAL BY HAVING
VALUES TOO )F IT MATTERS THAT THE CALLING CLIENT CODE %VEN IF THE BEAN DOESNT YOUR COMPONENT INTERFACE LIKE
METHOD GETS BACK A COPY OF A REFER
NEED TO KNOW HOW ITS CLIENT IS !DVICE EXTEND BOTH 2EMOTE AND
ENCE VS A COPY OF AN OBJECT THE BEAN ACCESSING IT THE CLIENT MUST KNOW ! %*",OCAL/BJECT 7HATS THE HARM
CODE MIGHT HAVE TO CHANGE CLIENT WRITTEN TO ACCESS A BEAN LOCALLY IF THE CLIENT SIMPLY ALWAYS HANDLES
WOULDNT WORK IF THE BEANS 2EMOTE 2EMOTE%XCEPTIONS AND ALWAYS DOES
CLIENT INTERFACES AND VICE
VERSA
THE NARROW 4HAT WAY THE CLIENT
Q: "UT ) THOUGHT THAT CHOOSING TO Q: 7HY NOT
SHOULDNT HAVE TO KNOW
DEPLOY A BEAN WITH LOCAL VS 2EMOTE
CLIENT VIEWS WAS JUST A MATTER OF A: 3TILL WONT WORK &OR ONE THING
SWITCHING A SWITCH AT DEPLOY TIME A: 4HE CLIENT MUST KNOW IN ACCORDING TO BEAN LAW YOURE NOT
ALLOWED TO DECLARE 2EMOTE%XCEPTIONS
ADVANCE WHETHER ITS ACCESSING A
A: ./ ./ ./ ,ETS IMAGINE THAT
BEANS 2EMOTE OR LOCAL CLIENT VIEW
BECAUSE THE INTERFACES THEMSELVES
ON LOCAL METHODS 3O THERES NO
GUARANTEE THAT YOUR SERVER WOULD
YOU DID WRITE TWO SETS OF INTERFACES ARE DIFFERENT 0OLYMORPHICALLY YOU EVEN LET YOU DEPLOY A BEAN WITH
ONE FOR A LOCAL CLIENT VIEW AND ONE CANT USE THE 2EMOTE AND LOCAL A LOCAL INTERFACE THAT DECLARES
FOR A 2EMOTE CLIENT VIEW )T IS TRUE VIEWS INTERCHANGEABLY BECAUSE THE 2EMOTE%XCEPTIONS !ND THERE IS NO
THAT AT DEPLOYMENT YOU COULD DECIDE INTERFACES THEMSELVES ARE DIFFERENT GUARANTEE THAT THE NARROW METHOD
WHICH OF THE TWO VIEWS YOU WANTED TO WOULD NOT CAUSE PROBLEMS !ND THEN
EXPOSE OR BOTH "UT THAT WORKS ONLY 4HERES NO WAY THE CLIENT CAN BE THERE ARE HANDLES AND ALL THAT OTHER
IF THE BEAN CODE DOESNT CARE WHERE KEPT BLISSFULLY IGNORANT
BECAUSE STUFF 9OU NEED TO JUST LET THIS GO
THE CLIENT IS ! BEAN METHOD WITH NO THE BEHAVIOR OF THE BEAN IS DIFFERENT
ARGUMENTS OR RETURN VALUES MIGHT BE 2EMEMBER A 2EMOTE CLIENT MUST
SAFE REGARDLESS OF HOW THE CLIENT IS HANDLE 2EMOTE%XCEPTIONS AND
ACCESSING IT NARROW THE 2EMOTE STUB COMING BACK
FROM THE LOOKUP !ND A 2EMOTE CLIENT
/NE SOLUTION MIGHT BE TO WRITE THE IS EXPOSED TO METHODS IN THE BEANS
BEAN CODE ASSUMING THE BEAN IS CLIENT INTERFACESMETHODS THAT
ALWAYS GETTING A COPY AND THEN IF THE DONT EXIST IN THE LOCAL INTERFACES 3O A
CLIENT IS LOCAL HAVE THE CLIENT MAKE 2EMOTE CLIENT MIGHT FOR EXAMPLE TRY
A COPY CLONE OF THE OBJECT BEFORE TO CALL A GET(ANDLE METHOD ON THE
PASSING IT /R FOR RETURN VALUES YOU LOCAL COMPONENT INTERFACE A METHOD
MIGHT ALWAYS HAVE THE BEAN MAKE A CALL THAT WOULD NEVER WORK
COPY BEFORE HANDING IT BACK 4HAT WAY
&KDSWHU
WKHFOLHQWYLHZ
%(WKH&RQWDLQHU
(DFKRIWKHFRGHVQLSSHWVRQWKLVSDJHUHSUHVHQWVFRGHIURPHLWKHU
DQLQWHUIDFHRUDFOLHQW<RXUMRELVWRSOD\&RQWDLQHUDQGGHFLGH
([HUFLVH ZKHWKHUHDFKLVOHJDODFFRUGLQJWRERWK-DYDODZDQG%HDQ
ODZ,QRWKHUZRUGVHYHQLIWKHFRGHFRPSLOHVLWPLJKWVWLOOEH
:521*WRWKH&RQWDLQHUEHFDXVHLWGRHVQ·WFRPSO\ZLWKWKH
UXOHVRIWKH(-%VSHF$VVXPHWKDWHYHU\WKLQJ\RXGR127VHHLV
OHJDODQGFRUUHFW)LJXUHRXWLIWKHSUREOHPLVDFRPSLOHUHUURURUD
SUREOHPWRWKH&RQWDLQHUDQGILJXUHRXWKRZWRIL[LW
$,QDORFDOFOLHQW %,QD5HPRWHFOLHQW
SXEOLFYRLGJR ^ SXEOLFYRLGJR ^
2EMHFWR QXOO WU\^
WU\^ ORRNXSWKH$GYLFHEHDQDVVLJQLW
WRDGYLVRU
&RQWH[WLF QHZ,QLWLDO&RQWH[W `FDWFK ([FHSWLRQH[ ^
R LFORRNXS ³$GYLVRU/RFDO´ H[SULQW6WDFN7UDFH
`
`FDWFK 1DPLQJ([FHSWLRQQH[ ^ 6\VWHPRXWSULQWOQ DGYLVRUJHW$GYLFH
QH[SULQW6WDFN7UDFH `
`
$GYLFH+RPH/RFDOKRPH $GYLFH+RPH/RFDO R
$GYLFH/RFDODGYLVRU QXOO
PRUHVWXII
`
&,QDEHDQ·VKRPHLQWHUIDFH
SDFNDJHKHDG¿UVW
LPSRUWMDYD[HME
SXEOLFLQWHUIDFH$GYLFH+RPHH[WHQGV(-%+RPH^
SXEOLF$GYLFHFUHDWH WKURZV&UHDWH([FHSWLRQ
`
',QDEHDQ·VFRPSRQHQWLQWHUIDFH
SDFNDJHKHDG¿UVW
LPSRUWMDYD[HME
SXEOLFLQWHUIDFH$GYLFH/RFDOH[WHQGV(-%/RFDO2EMHFW^
SXEOLF6WULQJJHW$GYLFH
`
\RXDUHKHUH
ORFDOLQWHUIDFHV
:MDD=LHGAFLK
<RXFDQH[SRVH\RXUEHDQWRORFDOFOLHQWVXVLQJDORFDOFOLHQWYLHZ
/RFDOFRPSRQHQWLQWHUIDFHVPXVWH[WHQGMDYD[HME(-%/RFDO2EMHFW
/RFDOKRPHLQWHUIDFHVPXVWH[WHQGMDYD[HME(-%/RFDO+RPH
0HWKRGVLQORFDOFOLHQWLQWHUIDFHVGR127GHFODUH
<RXKDYHWR
UHFRJQL]HD
5HPRWH([FHSWLRQ :DWFKLW ORFDOYV5HPRWH
FOLHQWYLHZ
6RPHRIWKHLQWHUIDFHPHWKRGVH[SRVHGWR5HPRWHFOLHQWVDUHQRW
H[SRVHGWRORFDOFOLHQWV QFRGH
%HSUHSDUHGWRORRNDWEHD
RGH RU LQW HUID FH FRG HDQG
/RFDOFOLHQWVFDQQRWJHWKDQGOHVVLQFHKDQGOHVDUHXVHGWRUH FOLHQWF
ORR NLQ JD WD
NQRZZKHWKHU\RX¶UH
HVWDEOLVKDFRQQHFWLRQWRWKH5HPRWHREMHFW FDO FOLH QWY LHZ
5HPRWHRUOR
(-%0HWD'DWDLVQRWXVHGZLWKORFDOFOLHQWVVLQFHDORFDOFOLHQWFDQ $QGLWPLJKWEHVXEWOH
HWKH
XVHUHIOHFWLRQWRLQWHUURJDWHWKH(-%REMHFWDQG+RPHREMHFW )RUH[DPSOH\RXPLJKWVH
DE XVL QHV VP HWK RGFDOO
FOLHQWPDNH
PH WKR G
/RFDOKRPHLQWHUIDFHVKDYHRQO\RQHUHPRYH PHWKRG³WKHRQH DQGWKHDUJXPHQWWRWKH
EOH RE MHF W6 LQF H
WKDWWDNHVDSULPDU\NH\7KHUHPRYH WKDWWDNHVD+DQGOHGRHVQ·W LVDQRQ6HULDOL]D
DVV XP HWK DWW KH PH WKR G
H[LVWLQWKHORFDOKRPHLQWHUIDFHVLQFH+DQGOHVDUHQ·WXVHGZLWKD \RXDUHWR
.1 2:
ORFDOFOLHQWYLHZ LVOHJDODQGFRUUHFW\RX
WHUIDFH²
WKDWWKLVPXVWEHDORFDOLQ
SDV VD QR Q6 HULD OL]DEOH
%HFDXVHWKHRQO\UHPRYH LQWKHORFDOKRPHLQWHUIDFHUHTXLUHVD \RXFDQ¶W
RU UHWX UQ
SULPDU\NH\DUJXPHQWORFDOVHVVLRQEHDQFOLHQWVFDQQRWUHPRYH REMHFWDVDQDUJXPHQW
PD 5H PR WHP HWK RG
DEHDQXVLQJWKHEHDQ·VKRPH WKH\FDQFDOOUHPRYH RQO\RQWKH YDOXHWRRUIUR
KHU JR WFK DV WRW HOO\RX
6RPHR IRW
EHDQ·VFRPSRQHQWLQWHUIDFH ZKHWKHUWKHEHDQLVORF DOR U5 H
(-%/RFDO+RPHKDVRQO\RQHPHWKRG UHPRYH WKDWWDNHVD PRWHLQFOXGH
KH+RPH
SULPDU\NH\EHFDXVHWKHJHW+RPH+DQGOH JHW(-%0HWD'DWD &OLHQWGRHVQ¶WQDUURZW
OHD Q\
&OLHQWGRHVQ¶WKDQG
DQGUHPRYH +DQGOH PHWKRGVWKDWDUHLQ(-%+RPHGRQ·WDSSO\WRD SWLR QV RQ DE XVLQHVV
FKHFNHGH[FH
ORFDOFOLHQWYLHZ PH WKRGF DOO
QGOH RQ
7KHRQO\PHWKRGLQ(-%2EMHFWWKDWLVQRWDOVRLQ(-%/RFDO2EMHFWLV &OLHQWFDOOVUHPRYH +D
DEHDQ¶VK RP H
JHW+DQGOH
$UJXPHQWVDQGUHWXUQYDOXHVDUHSDVVHGE\YDOXHZKHQXVLQJD
ORFDOFOLHQWYLHZ,QRWKHUZRUGVWKH\·UHSDVVHGLQWKHQRUPDO-DYD
ZD\ REMHFWVSDVVHGE\DFRS\RIWKHUHIHUHQFHSULPLWLYHVSDVVHG
E\DFRS\RIWKHYDOXH
/RFDOFOLHQWVGRQRWQHHGWRQDUURZWKH+RPHUHIHUHQFHEHFDXVH
LW·VDQRUPDO-DYDUHIHUHQFHQRWDVWXEWRD5HPRWHREMHFW
/RFDOFOLHQWVGRQRWQHHGWRFDWFK5HPRWH([FHSWLRQVVLQFHORFDO
LQWHUIDFHPHWKRGVGRQ·WGHFODUH5HPRWH([FHSWLRQV
&KDSWHU
WKHFOLHQWYLHZ
([HUFLVH %(WKH&RQWDLQHU
6ROXWLRQV
$,QDORFDOFOLHQW %,QD5HPRWHFOLHQW
SXEOLFYRLGJR ^ SXEOLFYRLGJR ^
2EMHFWR QXOO WU\^
WU\^ ORRNXSWKH$GYLFHEHDQDVVLJQ
LWWRDGYLVRU
&RQWH[WLF QHZ,QLWLDO&RQWH[W `FDWFK ([FHSWLRQH[ ^
R LFORRNXS ³$GYLVRU/RFDO´ H[SULQW6WDFN7UDFH
`
`FDWFK 1DPLQJ([FHSWLRQQH[ ^ 6\VWHPRXWSULQWOQ DGYLVRUJHW$GYLFH
QH[SULQW6WDFN7UDFH `
`
$GYLFH+RPH/RFDOKRPH $GYLFH+RPH/RFDO R
emote
dvice() is a r
$GYLFH/RFDODGYLVRU QXOO
PRUHVWXII r r o r ! g e t A
` Compiler e t it isnÕt handling the e last line
A is Þne. Because itÕs local, it method, bu eption. If we moved th ork.
does not need to narrow the Ho
me RemoteExce try block, it would w
reference. Only a cast is needed
. INSIDE th
Container error! EJBHome is a Remote
interface, and the rule is that you must declare
&,QDEHDQ·VKRPHLQWHUIDFH RemoteException on each method in the interface.
The compiler doesnÕt care, but the Container will.
SDFNDJHKHDG¿UVW At some point in the deploy process, this will fail.
LPSRUWMDYD[HME
SXEOLFLQWHUIDFH$GYLFH+RPHH[WHQGV(-%+RPH^
SXEOLF$GYLFHFUHDWH WKURZV&UHDWH([FHSWLRQ needs RemoteException
` (look at the imports; no java.rmi.*)
',QDEHDQ·VFRPSRQHQWLQWHUIDFH
a local
D works Þne.. ItÕsace, and it SDFNDJHKHDG¿UVW
component interfdeclare any LPSRUWMDYD[HME
doesnÕt need to e business SXEOLFLQWHUIDFH$GYLFH/RFDOH[WHQGV(-%/RFDO2EMHFW^
exceptions on th
methods. SXEOLF6WULQJJHW$GYLFH OK, needs no exceptions declared
`
\RXDUHKHUH
FRIIHHFUDPPRFNH[DP
0RFN([DP
7HICH CAPABILITIES ARE PROVIDED BY BOTH REMOTE AND LOCAL HOME INTERFACES FOR
1 SESSION BEANS #HOOSE ALL THAT APPLY
R! #REATING A SESSION OBJECT
R" 2EMOVING A SESSION OBJECT
R# 'ETTING A SESSION OBJECTS %*"-ETA$ATA
R$ 'ETTING A SESSION OBJECTS HANDLE
7HEN LOCATING A SESSION BEANS REMOTE HOME INTERFACE WHICH ARE STEPS THAT
2 MUST OCCUR TO CREATE A VALID HOME INTERFACE REFERENCE #HOOSE ALL THAT
APPLY
R! 4HE SESSION CONTEXT MUST BE NARROWED AND THE NARROWED RESULT CAST
R" 4HE RESULT OF THE *.$) LOOKUP MUST BE NARROWED AND THE NARROWED
RESULT CAST
R# 4HE INITIAL CONTEXT MUST BE NARROWED AND THE NARROWED RESULT CAST
R$ 4HE RESULT OF THE *.$) LOOKUP MUST BE CAST TO AN INITIAL CONTEXT AND
THENNARROWED
'IVEN A REMOTE CLIENT @2 THAT HAS VALID REFERENCES TO SESSION BEANS @! AND @"
3 AND GIVEN THAT ! IS A LOCAL CLIENT TO " WHICH STATEMENTS ARE TRUE #HOOSE ALL
THAT APPLY
R! 2 CANNOT PASS HIS REFERENCE FOR ! TO "
R" ! CANNOT PASS HIS REFERENCE FOR " TO 2
R# ! CANNOT INVOKE METHODS ON "
R$ " CANNOT INVOKE METHODS ON 2
&KDSWHU
WKHFOLHQWYLHZ
7HEN COMPARING TWO SESSION OBJECTS WHAT IS TRUE #HOOSE ALL THAT APPLY
4
R! 5SING THE IS)DENTICAL METHOD STATELESS SESSION BEANS FROM THE SAME
HOME WILL ALWAYS RETURN TRUE
R" 5SING THE IS)DENTICAL METHOD STATEFUL SESSION BEANS FROM THE SAME
HOME WILL ALWAYS RETURN TRUE
R# 4HE IS)DENTICAL METHOD CAN BE USED FOR ONLY REMOTE OBJECT
REFERENCES
R$ 5SING THE EQUALS METHOD STATELESS SESSION BEANS FROM THE SAME HOME
ARE GUARANTEED TO RETURN TRUE
R% 5SING THE EQUALS METHOD STATEFUL SESSION BEANS FROM THE SAME HOME
ARE GUARANTEED TO RETURN TRUE
7HICH STATEMENTS ABOUT SESSION BEANS ARE TRUE #HOOSE ALL THAT APPLY
5
R! 4HE BEAN PROVIDER MUST WRITE THE METHOD PUBLIC VOID REMOVE IN
BOTH STATELESS AND STATEFUL SESSION CLASSES
R" ,OCAL CLIENTS CAN REMOVE SESSION BEANS BY CALLING A METHOD ON THE
BEANS HOME
R# 4HE REMOVE METHOD IN THE COMPONENT INTERFACE CAN BE USED ONLY BY
REMOTE CLIENTS
R$ 4O ASK THE %*"(OME TO REMOVE A SESSION BEAN THE CLIENT MUST PROVIDE
THE BEANS HANDLE
\RXDUHKHUH
FRIIHHFUDPPRFNH[DP
0RFN([DP$QVZHUV
7HICH CAPABILITIES ARE PROVIDED BY BOTH REMOTE AND LOCAL HOME INTERFACES FOR
1 SESSION BEANS #HOOSE ALL THAT APPLY nÕt be removed here is
session beanlos cacal home interface becausye ket y
R! #REATING A SESSION OBJECT through a ove() that takes a primar
R" 2EMOVING A SESSION OBJECT - only
a rem
R# 'ETTING A SESSION OBJECTS %*"-ETA$ATA - not in a local home
R$ 'ETTING A SESSION OBJECTS HANDLE - not in a local home
7HEN LOCATING A SESSION BEANS REMOTE HOME INTERFACE WHICH ARE STEPS THAT
2 MUST OCCUR TO CREATE A VALID HOME INTERFACE REFERENCE #HOOSE ALL THAT
(spec: 57)
APPLY
R! 4HE SESSION CONTEXT MUST BE NARROWED AND THE NARROWED RESULT CAST
R" 4HE RESULT OF THE *.$) LOOKUP MUST BE NARROWED AND THE NARROWED
RESULT CAST
R# 4HE INITIAL CONTEXT MUST BE NARROWED AND THE NARROWED RESULT CAST
R$ 4HE RESULT OF THE *.$) LOOKUP MUST BE CAST TO AN INITIAL CONTEXT AND
THENNARROWED
'IVEN A REMOTE CLIENT @2 THAT HAS VALID REFERENCES TO SESSION BEANS @! AND @"
3 AND GIVEN THAT ! IS A LOCAL CLIENT TO " WHICH STATEMENTS ARE TRUE #HOOSE ALL
THAT APPLY
l
R! 2 CANNOT PASS HIS REFERENCE FOR ! TO " ca nÕ t gi ve a re mote clienta alolocacal
You B through
R" ! CANNOT PASS HIS REFERENCE FOR " TO 2 reference, A sees
reference
R# ! CANNOT INVOKE METHODS ON "
R$ " CANNOT INVOKE METHODS ON 2
&KDSWHU
WKHFOLHQWYLHZ
4 7HEN COMPARING TWO SESSION OBJECTS WHAT IS TRUE #HOOSE ALL THAT APPLY (spec: 65-66)
R! 5SING THE IS)DENTICAL METHOD STATELESS SESSION BEANS FROM THE SAME
HOME WILL ALWAYS RETURN TRUE
R" 5SING THE IS)DENTICAL METHOD STATEFUL SESSION BEANS FROM THE SAME
HOME WILL ALWAYS RETURN TRUE
R# 4HE IS)DENTICAL METHOD CAN BE USED FOR ONLY REMOTE OBJECT
REFERENCES
of equals()
R$ 5SING THE EQUALS METHOD STATELESS SESSION BEANS FROM THE SAME HOME The behavior
iÞed
ARE GUARANTEED TO RETURN TRUE is not spec
R% 5SING THE EQUALS METHOD STATEFUL SESSION BEANS FROM THE SAME HOME
ARE GUARANTEED TO RETURN TRUE
7HICH STATEMENTS ABOUT SESSION BEANS ARE TRUE #HOOSE ALL THAT APPLY
5 ove(), not remov
e( )
R! 4HE BEAN PROVIDER MUST WRITE THE METHOD PUBLIC VOID REMOVE IN - itÕs ejbRem
BOTH STATELESS AND STATEFUL SESSION CLASSES
- local homes have only a
R" ,OCAL CLIENTS CAN REMOVE SESSION BEANS BY CALLING A METHOD ON THE
remove() that takes a
BEANS HOME primary key
R# 4HE REMOVE METHOD IN THE COMPONENT INTERFACE CAN BE USED ONLY BY - no,
REMOTE CLIENTS
only for local
R$ 4O ASK THE %*"(OME TO REMOVE A SESSION BEAN THE CLIENT MUST PROVIDE
THE BEANS HANDLE
- but not true for EJBLocalHo
me
\RXDUHKHUH
session bean lifecycle
5
4
4 %HLQJD6HVVLRQ%HDQ
,KDWHLWZKHQ,JHW
FRQWDLQHUFDOOEDFNV,MXVWNQRZ
LW·VJRQQDEHDQHME5HPRYH EXW,
ZDVRQO\MXVWFUHDWHG,ZLVK,ZDV
VWDWHOHVV7KH\ZRQ·WHYHQOHW
PHJRLQWKHSRRO
6HVVLRQEHDQVDUHFUHDWHGDQGUHPRYHG,I\RX¶UHOXFN\\RX¶UHD
VWDWHOHVVEHDQ%HFDXVHWKHOLIHRIDVWDWHIXOEHDQLVWLHGWRWKHZKLPVRIDKHDUWOHVV
FOLHQW6WDWHIXOEHDQVDUHFUHDWHGDWWKHFOLHQW¶VLQVLVWHQFHDQGH[LVWRQO\WRVHUYHWKDW
RQHFOLHQW$VDVWDWHIXOEHDQWKHEHVW\RXFDQKRSHIRULVWKDWWKHFOLHQWFUDVKHVRU
IRUJHWVWRFDOOUHPRYH LWPLJKWWDNHWKH&RQWDLQHUDZKLOHWR¿JXUHRXW\RX¶YHEHFRPH
XVHOHVV%XWDKKKKWKHOLIHRIDVWDWHOHVVEHDQLVIDEXORXV3RROVWKRVHOLWWOHXPEUHOOD
GULQNVDQGQRERUHGRPVLQFH\RXJHWWRPHHWVRPDQ\GLIIHUHQWFOLHQWV2IFRXUVHHYHQ
DVWDWHOHVVEHDQGLHVZLWKDQXQFKHFNHGH[FHSWLRQ
WKLVLVDQHZFKDSWHU
H[DPREMHFWLYHV
6HVVLRQ%HDQV
2IILFLDO :KDWLWUHDOO\PHDQV
,GHQWLI\FRUUHFWDQGLQFRUUHFWVWDWHPHQWVRU 7KLVREMHFWLYHFDQKLW\RXRQDQ\WKLQJUHODWHGWR
H[DPSOHVDERXWVHVVLRQEHDQVLQFOXGLQJ VHVVLRQEHDQVVR\RXSUHWW\PXFKKDYHWRNQRZLW
FRQYHUVDWLRQDOVWDWHWKH6HVVLRQ%HDQ DOOLQFOXGLQJWKHGHWDLOVRIERWKVWDWHOHVVDQGVWDWHIXO
LQWHUIDFHDQGFUHDWHPHWKRGV EHDQOLIHF\FOHVWKHFRQWDLQHUFDOOEDFNPHWKRGV
RI6HVVLRQ%HDQZKDW\RXPXVWZULWHLQDEHDQ
FODVVDQGZKDWDEHDQFDQJHWIURPLWV(-%&RQWH[W
$Q\WKLQJFRYHUHGE\WKHRWKHUVHVVLRQEHDQREMHFWLYHV
LVIDLUJDPH
,GHQWLI\WKHXVHRIDQGWKHEHKDYLRURIWKH )LUVW\RXKDYHWRNQRZWKDWSDVVLYDWLRQLVIRURQO\
HME3DVVLYDWHPHWKRGLQDVHVVLRQEHDQ VWDWHIXOVHVVLRQEHDQV6WDWHOHVVEHDQVJREDFNWR
LQFOXGLQJWKHUHVSRQVLELOLWLHVRIERWKWKH WKHEHDQSRROZLWKRXWJRLQJWKURXJKSDVVLYDWLRQ6R
FRQWDLQHUDQGWKHEHDQSURYLGHU HME3DVVLYDWH ZLOOQHYHUEHFDOOHGRQDVWDWHOHVV
EHDQ<RXKDYHWRNQRZWKDW\RXUUHVSRQVLELOLW\LQ
HME3DVVLYDWH LVWRPDNHVXUHWKDWZKHQWKHPHWKRG
HQGV\RXUEHDQLVUHDG\IRUSDVVLYDWLRQDQGWKDW
SDVVLYDWLRQPD\RUPD\QRWLQYROYHVHULDOL]DWLRQ<RX
PXVWNQRZWKHVWDWHWKDW\RXULQVWDQFHYDULDEOHVPXVW
EHLQDWWKHWLPHHME3DVVLYDWH HQGV$QGHYHQWKRXJK
WKLVREMHFWLYHGRHVQ¶WPHQWLRQHME$FWLYDWH \RXKDYH
WRXQGHUVWDQGKRZHME$FWLYDWH ZRUNVDVZHOO
,GHQWLI\WKHLQWHUIDFHDQGPHWKRGIRU <RXPXVWEHDEOHWRORRNDWDGHVFULSWLRQRIDGHVLUHG
HDFKRIWKHIROORZLQJ UHWULHYHWKHVHVVLRQ EHKDYLRUOLNH¿JXUHRXWWKHVHFXULW\SULQFLSDORIWKH
EHDQ¶VUHPRWHKRPHLQWHUIDFHUHWULHYHWKH FOLHQWDQGNQRZZKLFKPHWKRG\RXFDQFDOODQGRQ
VHVVLRQEHDQ¶VORFDOFRPSRQHQWLQWHUIDFH ZKLFKLQWHUIDFHWRJHWWKDWEHKDYLRU LQWKLVFDVH
GHWHUPLQHLIWKHVHVVLRQEHDQ¶VFDOOHUKDV JHW&DOOHU3ULQFLSDO FDOOHGRQWKH6HVVLRQ&RQWH[W
DSDUWLFXODUUROHDOORZWKHLQVWDQFHWRPDUN LQWHUIDFH
WKHFXUUHQWWUDQVDFWLRQDVDUROOEDFNUHWULHYH 7RDQVZHUWKHVHTXHVWLRQV\RXKDYHWRNQRZHYHU\
WKH8VHU7UDQVDFWLRQLQWHUIDFHSUHSDUHWKH PHWKRGLQWKHWKUHHNH\LQWHUIDFHV 6HVVLRQ%HDQ WKH
LQVWDQFHIRUUHXVHIROORZLQJSDVVLYDWLRQ LQWHUIDFH\RXUEHDQLPSOHPHQWV 6HVVLRQ&RQWH[W
UHOHDVHUHVRXUFHVSULRUWRUHPRYDO WKHLQWHUIDFH\RXUEHDQKDVDUHIHUHQFHWR DQG
LGHQWLI\WKHLQYRNHURIWKHEHDQLQVWDQFH¶V 6HVVLRQ6\QFKURQL]DWLRQ DQRSWLRQDOLQWHUIDFHWKDWD
FRPSRQHQWLQWHUIDFHEHQRWL¿HGWKDWDQHZ VWDWHIXOEHDQFDQLPSOHPHQW
WUDQVDFWLRQKDVEHJXQEHQRWL¿HGWKDWWKH ,QWKLVFKDSWHUZH¶OOFRYHUHYHU\WKLQJDERXWVHVVLRQ
FXUUHQWWUDQVDFWLRQKDVFRPSOHWHG EHDQLQWHUIDFHVH[FHSW6HVVLRQ6\QFKURQL]DWLRQ
ZKLFKLVFRYHUHGLQWKHWUDQVDFWLRQVFKDSWHU
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
2EMHFWLYH
6HVVLRQ%HDQV
2IILFLDO :KDWLWUHDOO\PHDQV
0DWFKFRUUHFWGHVFULSWLRQVDERXWSXUSRVH <RXKDYHWRNQRZWKHGLIIHUHQFHVEHWZHHQVWDWHOHVV
DQGIXQFWLRQZLWKZKLFKVHVVLRQEHDQ DQGVWDWHIXOEHDQVLQFOXGLQJZKHQ\RX¶GFKRRVHRQH
W\SHWKH\DSSO\WR VWDWHOHVVVWDWHIXORU RYHUWKHRWKHU<RXPXVWNQRZWKHEHDQUXOHVLQFOXGLQJ
ERWK WKHUHFDQEHRQO\RQHFUHDWHPHWKRGLQDVWDWHOHVVEHDQ
DQGLWPXVWKDYHQRDUJXPHQWV RQO\VWDWHIXOEHDQVFDQ
LPSOHPHQW6HVVLRQ6\QFKURQL]DWLRQERWKVWDWHOHVVDQG
VWDWHIXOEHDQVZLOOQRWVXUYLYHDFRQWDLQHUFUDVKVWDWH
OHVVEHDQVZLOOQHYHUEHSDVVLYDWHGVWDWHOHVVEHDQ
FUHDWLRQDQGUHPRYDOLVQRWWLHGWRWKHFOLHQW
*LYHQDOLVWRIUHVSRQVLELOLWLHVUHODWHGWR <RXKDYHWRNQRZZKDWLVDQGLVQ¶WJXDUDQWHHGLQWKH
VHVVLRQEHDQVLQGHQWLI\WKRVHZKLFKDUH VSHF)RUH[DPSOHWKHFRQWDLQHUZRQ¶WDOORZFRQFXUUHQW
WKHUHVSRQVLELOLW\RIWKHVHVVLRQEHDQ DFFHVVWRDVLQJOHVHVVLRQEHDQ LIFOLHQW$LVXVLQJWKH
SURYLGHUDQGWKRVHZKLFKDUHWKH EHDQFOLHQW%ZLOOJHWDQH[FHSWLRQLILWFDOOVDPHWKRG
UHVSRQVLELOLW\RIWKH(-%FRQWDLQHU RQWKDWEHDQ $QGWKHFRQWDLQHULVQ¶WUHTXLUHGWRDOORZ
SURYLGHU DEHDQLQRQH($5¿OHWREHDORFDOFOLHQWWRDEHDQLQ
DGLIIHUHQW($5$QG\RXKDYHWRNQRZH[DFWO\ZKLFK
FODVVHVDQGPHWKRGVDUHLPSOHPHQWHGE\\RX WKHEHDQ
WKHHME5HPRYH DQGHME&UHDWH PHWKRGVHWF DQG
ZKLFKDUHLPSOHPHQWHGE\WKHFRQWDLQHU WKHKDQGOHV
WKHKRPHDQGFRPSRQHQWREMHFWVWKHVWXEV IRU5HPRWH
FOLHQWLQWHUIDFHV WKHJHW(-%2EMHFW PHWKRGHWF 0RVW
RIZKDW¶VLQWKLVREMHFWLYHRYHUODSVZLWKDQG
*LYHQDOLVWRIUHTXLUHPHQWVLGHQWLI\ 7KLVLVDERXWNQRZLQJEHDQODZ²WKHUXOHV\RXKDYHWR
WKRVHZKLFKDUHWKHUHTXLUHPHQWVIRUD IROORZDFFRUGLQJWRWKHVSHFHYHQLQWKHFDVHVZKHUH
VHVVLRQEHDQFODVVUHPRWHFRPSRQHQW FRPSLOHUZRQ¶WFDUHLI\RXGRQ¶W)RUH[DPSOH\RXPXVW
LQWHUIDFHUHPRWHKRPHLQWHUIDFHFUHDWH KDYHDPDWFKLQJHME&UHDWH PHWKRGIRUHDFKFUHDWH
PHWKRGVEXVLQHVVPHWKRGVORFDO PHWKRGLQWKHKRPHEXWWKHFRPSLOHUZRQ¶WVWRS\RXLI
FRPSRQHQWLQWHUIDFHUHPRWHFRPSRQHQW \RXOHDYHLWRXW$QG\RXPXVWNQRZWKDWORFDOLQWHUIDFH
LQWHUIDFH PHWKRGVPXVWQRWGHFODUHD5HPRWH([FHSWLRQEXW
5HPRWHLQWHUIDFHPHWKRGVPXVW$QG\RXPXVWNQRZ
WKDWREMHFWW\SHDUJXPHQWVWRD5HPRWHLQWHUIDFH
PHWKRGDUHVHQWDVVHULDOL]HGFRSLHVRIWKHREMHFWZKLOH
DUJXPHQWVWRORFDOLQWHUIDFHVDUHVHQWDVFRSLHVRIWKH
UHIHUHQFH
\RXDUHKHUH
VHVVLRQEHDQV
-`XTWZQVO\PM[M[[QWVJMIVTQNMKaKTM
)MAGINE YOURE A SESSION BEAN 7HAT MATTERS TO YOU 7HAT ARE THE KEY MOMENTS
IN YOUR LIFE 7HAT DO YOU NEED TO KNOW ABOUT THE CLIENT 7HAT DO YOU NEED TO
KNOW ABOUT THE #ONTAINER 7HAT DO YOU NEED TO GET FROM THE #ONTAINER
.OW IMAGINE YOURE THE CLIENT 7HATS YOUR MOTIVATION 7HAT DO YOU NEED TO
KNOW ABOUT HOW THE #ONTAINER WORKS !ND WHAT IF YOURE THE #ONTAINER 7HAT
DO YOU HAVE TO DO TO MANAGE A BEANS LIFE AND WHEN DO YOU HAVE TO DO IT
)F YOURE THE "EAN 0ROVIDER WHAT DO YOU HAVE TO KNOW ABOUT THE BEANS LIFECYCLE
IN ORDER TO WRITE CODE THAT WORKS 7HAT IF YOU WANT THAT CODE TO BE EFlCIENT
)N THIS CHAPTER WE LOOK AT THE ENTIRE WORLD OF A SESSION BEAN AND WE DO IT FROM
DIFFERENT POINTS OF VIEW 7E TAKE AN // APPROACH TO THIS CHAPTER ITERATING
THROUGH DEEPER LEVELS OF DETAIL 3O DONT PANIC IF THE lRST SEVERAL PAGES FEEL
A LITTLE TOO HIGH
LEVEL OR LEAVE YOU WITH QUESTIONS 9OULL BE DOWN IN THE DIRT
BEFORE THE CHAPTERS DONE
"EFORE WE START LETS INTRODUCE THE PLAYERS
+WV\IQVMZ
+TQMV\ *MIV8ZW^QLMZ
*MIV *RDO EHWKHEHDQ
*RDO XQGHUVWDQGWKH JRG0DQDJHWKHOLIH
WUXHPHDQLQJRILWVOLIH DQGGHDWKRIEHDQV
:KHUHLWFDPHIURP LQWHUFHSWLQJDOORIWKH
ZKDWLWVSXUSRVHLV EHDQ·VPHWKRGFDOOV
KRZZLOOLWDOOHQG *RDO ZULWHGHSOR\DEOH
*RDO FDOOEXVLQHVV ZHOOEHKDYHGEHDQV
PHWKRGVRQDEHDQ .QRZWKHEHDQ$3,ZHOO
HQRXJKWRSXWWKHULJKW
FRGHLQWKHULJKWSODFH
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
,FUHDWHXVHDQGUHPRYH
EHDQVE\FDOOLQJPHWKRGVRQWKH
KRPHDQGFRPSRQHQWLQWHUIDFHVWXEV
6RPHGD\,ZLOONLOOWKH%HDQ3URYLGHU ,·PDQREMHFWDQG,UXQ
ZLWKP\EDUHKDQGVIRUQHYHUJLYLQJ EXVLQHVVPHWKRGVEXW,·PDOVR
PHWKHULJKWVWXEV DEHDQ$VDEHDQ,SD\DWWHQWLRQWRNH\
PLOHVWRQHVLQP\OLIHOLNHFRQVWUXFWLRQ ERULQJ EHDQ
FUHDWLRQ YHU\LPSRUWDQW SDVVLYDWLRQ JRLQJWR
VOHHS DFWLYDWLRQ ZDNLQJXS DQGUHPRYDO GHDWK
QRWJRRGLI\RX·UHPH 7KHFRQWDLQHUWHOOVPH
+TQMV\ HYHU\WLPHRQHRIWKHVHVSHFLDOPRPHQWVRFFXUV
0RVWKDSSHQMXVWRQFH FRQVWUXFWLRQFUHDWLRQ
UHPRYDO EXWDFWLYDWLRQSDVVLYDWLRQDQG
EXVLQHVVPHWKRGVFDQKDSSHQRYHU
DQGRYHUDJDLQ
*MIV
,ZULWHWKHEHDQFRGH%HVLGHVWKH
EXVLQHVVPHWKRGV,KDYHWRLPSOHPHQW
WKHFRQWDLQHUFDOOEDFNV WKHRQHVWKH ,FRQVWUXFWWKHEHDQ,
FRQWDLQHUFDOOVZKHQVRPHWKLQJKDSSHQVLQWKH JLYHWKHEHDQLWVEHDQQHVV
EHDQ·VOLIH ,DOVRKDYHWRZULWHWKHHME&UHDWH VSHFLDOEHDQFDSDELOLWLHV DQG,FDOOFUHDWH
PHWKRGVWRPDWFKWKHKRPHFUHDWH PHWKRGV RQWKHEHDQSDVVLQJLQFOLHQWDUJXPHQWVLI
$QG,·PXQGHUSDLGDQGWKH\VWLOOKDYHQ·W LW·VDVWDWHIXOEHDQ,GHFLGHLIDQGZKHQWKH
JLYHQPHRQHRIWKRVH$HURQFKDLUV EHDQVKRXOGVOHHSDQGZDNHXSDQG,·PWKH
RQO\RQHWKDWFDQNLOO UHPRYH DEHDQ,
GHFLGHKRZDQGLIDEXVLQHVVPHWKRGLV
FDOOHGRQDEHDQIDFWRULQJLQWKLQJV
OLNHVHFXULW\DQGWUDQVDFWLRQV
7RDEHDQ,·PDJRG
*MIV8ZW^QLMZ
+WV\IQVMZ
\RXDUHKHUH
VHVVLRQEHDQV
AW]ZMUMUJMZPW_Q\ITT_WZS[ZQOP\ '
/M\\QVOIVL][QVOI[\I\MN]T[M[[QWVJMIV
4HIS PICTURE SHOWS WHAT HAPPENS AFTER THE CLIENT DOES A LOOKUP
IN *.$) AND GETS THE HOME STUB )N OTHER WORDS IT SHOWS THE
CLIENT GETTING AND THEN USING A BEAN 4HIS PICTURE IS STILL TOO
HIGH
LEVEL THOUGH SO WELL GO A LOT DEEPER LATER IN THIS CHAPTER
&OR EXAMPLE WELL COVER WHAT REALLY HAPPENS BETWEEN STEP TWO
HOME OBJECT GETS THE CLIENTS CREATE CALL AND STEP FOUR HOME
MAKES THE BEAN 4HE EXAM EXPECTS YOU TO KNOW JUST EXACTLY
WHATS INVOLVED IN hMAKES THE BEANv
&OLHQWFDOOVFUHDWH RQWKHKRPHVWXE
+RPHREMHFWJHWVWKHFUHDWH FDOO
creating a bean
+RPHFRQWDLQHUPDNHVWKH(-%2EMHFW FRPSRQHQWLQWHUIDFH IRUWKHEHDQ
+RPHFRQWDLQHUPDNHVWKHEHDQ
+RPHUHWXUQVWKH(-%2EMHFW FRPSRQHQWLQWHUIDFH VWXEWRWKHFOLHQW
&OLHQWFDOOVDEXVLQHVVPHWKRGRQWKHFRPSRQHQWLQWHUIDFHVWXE JHW$GYLFH
using a bean
(-%2EMHFWJHWVWKHJHW$GYLFH FDOO
&RQWDLQHUVWHSVLQDQGJHW$GYLFH LVFDOOHGRQWKHEHDQ
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
6WDWHIXO6HVVLRQ%HDQ
&5($7,21
(-%
VWXE REMHFW
EHDQ
PDNH
UHW
VHU
NH
FOLHQW XUQ PD
YLF
VWX
E
HV
+RPH
REMHFW
FU
HD
WH VWXE
H
FUHDW
86(
EXVLQHVVPHWKRGFDOO
JHW$GYLFH
JHW$GYLFH
VHUYLFHV
YLFH (-%
G VWXE REMHFW
W$
JH
EHDQ
FOLHQW
+RPH
REMHFW
\RXDUHKHUH
VHVVLRQEHDQV
<PMZM¼[WJ^QW][TaUWZM\W\PMJMIV¼[TQNMKaKTM
\PIVR][\KZMI\QWVIVLJ][QVM[[UM\PWL[
7HAT ABOUT WHEN A CLIENT WANTS TO REMOVE A BEAN 7HAT ABOUT ACTIVATION
AND PASSIVATION OF STATEFUL SESSION BEANS !ND WHAT REALLY DOES HAPPEN
WHEN A BEAN IS CREATED 7HAT MAKES BEAN CREATION DIFFERENT FROM PLAIN
OLD OBJECT CONSTRUCTION
)N THIS CHAPTER WELL LOOK AT ALL THE STAGES OF A SESSION BEANS LIFE FOR
BOTH STATEFUL AND STATELESS SESSION BEANS
7KHEHDQOLIHF\FOH VSHFLDOPRPHQWVLQDEHDQ·VOLIH
6WDWHIXOVHVVLRQEHDQV
%HDQFUHDWLRQ ZKHQWKHFOLHQWZDQWVDEHDQ
%HDQXVH ZKHQWKHFOLHQWFDOOVDEXVLQHVVPHWKRG
%HDQSDVVLYDWLRQ WKHEHDQLVSXWWRVOHHSWRFRQVHUYH
UHVRXUFHV
%HDQDFWLYDWLRQ WKHEHDQZDNHVXSWRVHUYLFHDEXVLQHVV
PHWKRGIURPWKHFOLHQW
%HDQUHPRYDO ZKHQWKHFOLHQWLVILQLVKHGZLWKWKHEHDQRU
WKHEHDQWLPHVRXW
6WDWHOHVVVHVVLRQEHDQV
%HDQFUHDWLRQ ZKHQWKHFRQWDLQHUZDQWVWRPDNHDEHDQ
%HDQXVH ZKHQWKHFOLHQWFDOOVDEXVLQHVVPHWKRG
%HDQUHPRYDO ZKHQWKHFRQWDLQHUGHFLGHVWKHUHDUHWRR
PDQ\EHDQVLQWKHSRRO
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
+WV\IQVMZ+ITTJIKS[
NWZ\PM[XMKQITUWUMV\[QVIJMIV¼[TQNM
+H\LWKDSSHQVRQO\
RQFHLQDOLIHWLPHVR
\RXEHWWHUPDNHWKH
PRVWRILW
)RUPH"7KLV
LVVXFKDVSHFLDO
PRPHQW
$VD%HDQ3URYLGHU<28PXVWLPSOHPHQW
FRQWDLQHUFDOOEDFNVLQ\RXUEHDQFODVV
7HEN A BEAN HAS A SPECIAL MOMENT IT DOESNT KNOW UNTIL THE
#ONTAINER CALLS ONE OF THE BEANS CONTAINER CALLBACK METHODS
4HESE ARE SPECIAL METHODS THE #ONTAINER KNOWS ABOUT
THAT YOU THE "EAN 0ROVIDER MUST IMPLEMENT IN YOUR
BEAN CLASS 9OU CAN THINK OF THE CONTAINER CALLBACKS AS
BEING KIND OF LIKE EVENT HANDLERS
#ONTAINER CALLBACKS COME FROM TWO PLACES YOUR BEANS
HOME INTERFACE AND THE 3ESSION"EAN INTERFACE YOUR
SESSION BEAN CLASS MUST IMPLEMENT
&OR A SESSION BEAN THE HOME
RELATED CONTAINER CALLBACKS
ARE MATCHING CREATION METHODS EJB#REATE FOR EACH
CREATE METHOD DECLARED IN THE BEANS HOME INTERFACE
4HE 3ESSION"EAN INTERFACE DECLARES FOUR CONTAINER
CALLBACK METHODS FOR GIVING THE BEAN ITS BEAN CONTEXT
ACTIVATING IT PASSIVATING IT AND REMOVING IT 7ELL LOOK AT
THE ACTUAL METHODS ON THE NEXT PAGE
\RXDUHKHUH
FRQWDLQHUFDOOEDFNV
+WV\IQVMZ+ITTJIKS[KWUMNZWU<?7XTIKM["
<RXUKRPHLQWHUIDFH 6HVVLRQ%HDQLQWHUIDFH
MDYD[HME6HVVLRQ%HDQ
LQWHUIDFH!! LQWHUIDFH!!
$GYLFH+RPH $GYLFH%HDQ 6HVVLRQ%HDQ
FUHDWH 6WULQJFOLHQW1DPH VHW6HVVLRQ&RQWH[W 6HVVLRQ&RQWH[WVF
VHW6HVVLRQ&RQWH[W 6HVVLRQ&RQWH[WVF
HME$FWLYDWH HME$FWLYDWH
HME3DVVLYDWH
HME3DVVLYDWH
for eve HME5HPRYH
the homry create() in
HME5HPRYH
a match e, there must
in the b ing ejbCreate( be HME&UHDWH 6WULQJFOLHQW1DPH you must always implement
ean ) these FOUR container callba
JHW$GYLFH methods in your session bean ck
class
e
s s m e t h o d from toht a
Busine nt interface, n
compone r callback
containe
&OR ANY SESSION BEAN YOU WILL ALWAYS ALWAYS ALWAYS HAVE AT LEAST l VE CONTAINER
CALLBACKSFOUR FROM THE 3ESSION"EAN INTERFACE IMPLEMENTATIONS AND AT LEAST
ONE EJB#REATE TO MATCH THE CREATE METHOD DECLARED IN THE HOME INTERFACE
&OR STATELESS SESSION BEANS THERE WILL BE EXACTLY l VE CONTAINER CALLBACKS
SINCE STATELESS SESSION BEANS CAN HAVE ONLY ONE CREATE METHOD !ND SINCE
THE STATELESS BEANS CREATE IS ALWAYS A NO
ARG YOU KNOW THAT THE BEANS
EJB#REATE WILL ALWAYS BE A NO
ARG
&OR STATEFUL BEANS REMEMBER THERE MUST BE AT LEAST ONE CREATE BUT THERE CAN
BE MORE INCLUDING BOTH OVERLOADED CREATE METHODS AND CREATE SOMETHING
METHODS &OR EXAMPLE A STATEFUL BEAN HOME MIGHT HAVE THREE CREATE METHODS
CREATE CREATE3TRING S CREATE"IG#USTOMER3TRING S 4HAT WOULD MEAN
THE BEAN WOULD HAVE THREE CONTAINER CALLBACKS FROM THE HOME EJB#REATE
EJB#REATE3TRING S EJB#REATE"IG#USTOMER3TRING S
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
1UXTMUMV\QVO\PMKWV\IQVMZKITTJIKS[
4HIS !DVICE"EAN CODE IS COMPLETELY LEGAL )T COMPILES AND RUNS 2IGHT NOW WE DONT
NEED ANYTHING IN THE CALLBACK METHODS BECAUSE THE BEANS BUSINESS LOGIC DOESNT
DEPEND ON ANYTHING ELSE THAT HAPPENS AT OTHER TIMES IN THE BEANS LIFE 9OULL NOTICE
THAT WE ARE SAVING THE 3ESSION#ONTEXT PARAMETER WE GET FROM THE SET3ESSION#ONTEXT
CONTAINER CALLBACK BUT WE ARENT USING IT IN THIS CODE ,ATER IN THIS CHAPTER YOULL
LEARN WHY YOU MIGHT WANT TO ASSIGN THE CONTEXT TO AN INSTANCE VARIABLE AND THE
CIRCUMSTANCES UNDER WHICH YOU WOULD PUT CODE IN EACH OF THESE CALLBACK METHODS
ent SessionBean
You MUST implem
SDFNDJHKHDG¿UVW
LPSRUWMDYD[HME
SXEOLFFODVV$GYLFH%HDQLPSOHPHQWV6HVVLRQ%HDQ^
SULYDWH6HVVLRQ&RQWH[WFRQWH[W instance variable to hold the context we
SULYDWH6WULQJQDPH get from a container callback method.
SXEOLFYRLGHME$FWLYDWH ^
` ethods of SessionBean
the four m implement
SXEOLFYRLGHME3DVVLYDWH ^ that you must
`
SXEOLFYRLGHME5HPRYH ^
`
SXEOLFYRLGVHW6HVVLRQ&RQWH[W 6HVVLRQ&RQWH[WFW[ ^
FRQWH[W FW[
`
This must match the
SXEOLFYRLGHME&UHDWH 6WULQJFOLHQW1DPH ^ from the home interfacrceeate method
QDPH FOLHQW1DPH
` business meth od from the component
interface... not a contain
SXEOLF6WULQJJHW$GYLFH ^ er callback
UHWXUQ³$GYLFHIRU³QDPH³ WKHUHLVQRVSRRQ´
`
`
\RXDUHKHUH
FRQWDLQHUFDOOEDFNV
:KHQDUHFRQWDLQHUFDOOEDFNVLQYRNHG"
)RUVWDWHIXOVHVVLRQEHDQVZKHQWKHEHDQWUDQVLWLRQV
IURPRQHVWDWHWRDQRWKHU
EHDQWKURZVV\VWHPH[FHSWLRQ
GRHVQRWH[LVW XQFKHFNHGXQFDXJKW
FRQVWUXFWRU
VHW6HVVLRQ&RQWH[W
HME5HPRYH ===
HME&UHDWH
RUWLPHRXW ===
WLPHRXW
HME3DVVLYDWH
PHWKRGUHDG\ SDVVLYDWHG
PHWKRGFDOOV HME$FWLYDWH
GRHVQRWH[LVW %HIRUHDEHDQLVDEHDQ RUHYHQDQREMHFW LWGRHVQRWH[LVW7KHVSHFPDNHVDELJSRLQWRI
WKLVMXVWLQFDVHWKHUH·VDQ\FRQIXVLRQDERXWVRPHWKLQJH[LVWLQJEHIRUHLWH[LVWV6RWKHVWDWH
RIQRQH[LVWHQFHLVLQGHHGDVWDWHWKDWDEHDQFDQEHLQHYHQWKRXJKLWGRHVQRW\HWH[LVW
:KHQDVHVVLRQEHDQPRYHVRXWRIWKLVVWDWHWKHEHDQ·VFRQVWUXFWRUUXQVWKHQVHW6HVVLRQ
&RQWH[W DQGILQDOO\WKHHME&UHDWH PHWKRG7KLVLVDOVRWKHVWDWHDEHDQUHWXUQVWRDIWHU
DQ\RQHRIWKHVHWKLQJVRFFXUV EHDQWLPHVRXWEHDQWKURZVDV\VWHPH[FHSWLRQRUDFOLHQW
FDOOVUHPRYH 7KHEHDQZLOOJHWDQHME5HPRYH FDOOLIWKHFOLHQWFDOOVUHPRYH RUWLPHVRXW
ZKLOHLQWKHPHWKRGUHDG\ DFWLYH VWDWH
PHWKRGUHDG\ $EHDQLQWKHPHWKRGUHDG\VWDWHLVHLWKHUH[HFXWLQJDFOLHQW·VPHWKRGRUZDLWLQJIRUWKHFOLHQW
WRPDNHDQRWKHUEXVLQHVVPHWKRGFDOO$VWDWHIXOEHDQPLJKWRUPLJKWQRWEHLQDQDFWLYH
WUDQVDFWLRQZKLOHLQWKLVVWDWH GHSHQGVRQWKHGHSOR\PHQWWUDQVDFWLRQVHWWLQJVDQGWKHFDOOHU·V
WUDQVDFWLRQVWDWXV EXWLIWKHEHDQLVLQDWUDQVDFWLRQWKHEHDQFDQQRWEHSDVVLYDWHG
SDVVLYDWHG $SDVVLYDWHGEHDQLVWHPSRUDULO\VDYHGLQVRPHNLQGRIVHFRQGDU\VWRUDJHWRFRQVHUYH
UHVRXUFHVEHWZHHQFOLHQWFDOOV3DVVLYDWLRQPLJKWEHVHULDOL]DWLRQDOWKRXJKWKH&RQWDLQHU
FDQXVHDQ\WKLQJLWZDQWVDVORQJDVLWEHKDYHVOLNHVHULDOL]DWLRQ ZLWKRQHVPDOOH[FHSWLRQ
ZH·OOVHHODWHULQWKLVFKDSWHU $OWKRXJKDSDVVLYDWHGEHDQLVQRORQJHUDQDFWLYHREMHFWRQ
WKHKHDSWKH&RQWDLQHUZLOOUHDFWLYDWHWKHEHDQ FDOOLQJHME$FWLYDWH ZKHQWKHFOLHQWFDOOVD
EXVLQHVVPHWKRG,IDSDVVLYDWHGEHDQWLPHVRXWWKHEHDQZLOOVLPSO\GLHZLWKRXWILUVWEHLQJ
UHDFWLYDWHG
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
:HKDYHWRORRNDWWKHWUDQVLWLRQV
.OW THAT YOUVE SEEN THE OVERALL STATE DIAGRAM WE HAVE TO
DRILL DOWN AND l ND OUT WHAT REALLY HAPPENS AND WHY WHEN
A STATEFUL SESSION BEAN TRANSITIONS FROM ONE STATE TO ANOTHER
EHDQWKURZVV\VWHPH[FHSWLRQ
0RYLQJIURPGRHVQRWH[LVW XQFKHFNHGXQFDXJKW
GRHVQRWH[LVW
WRPHWKRGUHDG\
FRQVWUXFWRU
VHW6HVVLRQ&RQWH[W
HME5HPRYH
FRQVWUXFWRU HME&UHDWH
RUWLPHRXW
WLPHRXW
VHW6HVVLRQ&RQWH[W
HME3DVVLYDWH
HME&UHDWH
PHWKRGUHDG\ SDVVLYDWHG
HME$FWLYDWH
0RYLQJIURPPHWKRGUHDG\ EHDQWKURZVV\VWHPH[FHSWLRQ
GRHVQRWH[LVW XQFKHFNHGXQFDXJKW
WRSDVVLYDWHGDQGYLFHYHUVD
FRQVWUXFWRU
VHW6HVVLRQ&RQWH[W
HME&UHDWH HME5HPRYH
HME3DVVLYDWH RUWLPHRXW
WLPHRXW
HME$FWLYDWH
HME3DVVLYDWH
PHWKRGUHDG\ SDVVLYDWHG
HME$FWLYDWH
0RYLQJIURPSDVVLYDWHGRU EHDQWKURZVV\VWHPH[FHSWLRQ
GRHVQRWH[LVW XQFKHFNHGXQFDXJKW
PHWKRGUHDG\WRGRHVQRWH[LVW
FRQVWUXFWRU
VHW6HVVLRQ&RQWH[W
WLPHRXWV\VWHPH[FHSWLRQ HME&UHDWH
HME5HPRYH
RUWLPHRXW
WLPHRXW
RU
HME3DVVLYDWH
HME5HPRYH
PHWKRGUHDG\ SDVVLYDWHG
HME$FWLYDWH
\RXDUHKHUH
VHVVLRQEHDQV
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: )F ITS SO COMMON TO LEAVE THE METHODS EMPTY WHY DONT
6KDUSHQ \RXU SHQFLO
THEY HAVE ADAPTER CLASSES LIKE THEY HAVE FOR EVENT HANDLERSTHAT
IMPLEMENT ALL THE METHODS FROM THE INTERFACE )S THERE ANY REASON
WHY YOUR BEAN CLASS CANT EXTEND A CLASS THAT IMPLEMENTS THE
3ESSION"EAN INTERFACE
)RUWKHH[DP\RXKDYHWRNQRZH[DFWO\
ZKLFKPHWKRGVDUHLQWKH6HVVLRQ%HDQ
A: 4HE !0) DOESNT HAVE ADAPTER CLASSES FOR 3ESSION"EAN
LQWHUIDFHVRQRZLVDJRRGWLPHWRVWDUW
PHPRUL]LQJWKHP6HHLI\RXFDQUHPHPEHU
IMPLEMENTATIONS IE A CLASS THAT IMPLEMENTS ALL OF THE METHODS "UT
THERES NO REASON YOU CANT MAKE ONE YOURSELF +EEP IN MIND THOUGH WKHQDPHRIWKHPHWKRGWKDWPDWFKHVWKH
THAT WITH REAL
WORLD BEANS YOU PROBABLY WILL HAVE CODE IN ONE OR MORE EHKDYLRUGHVFULEHG:H·YHLQFOXGHGVRPH
OF THE METHODS !ND YOU MIGHT EVEN BE WORKING WITH A BEAN
AWARE )$% SUHWW\ELJKLQWVKHUHEHFDXVHLW·V\RXUILUVW
THAT PUTS THE METHODS IN FOR YOU ANYWAY WLPHEXWWKHPRFNH[DPTXHVWLRQVZLOOEH
3TILL IT MIGHT BE HANDY TO MAKE YOURSELF A GENERIC BEAN THAT YOU PXFKOHVVREYLRXV
TYPICALLY EXTEND FROM THAT HAS ALL OF THE METHODS FROM 3ESSION"EAN
7ITH STATELESS BEANS ESPECIALLY YOU HAVE TO IMPLEMENT EJB!CTIVATE AND
EJB0ASSIVATE EVEN THOUGH THEYLL NEVER BE CALLED 3TATELESS BEANS ARE 7KLVPHWKRGLVFDOOHGZKHQWKHFOLHQWWHOOV
NEVER PASSIVATED YOULL SEE MORE ON THAT LATER IN THE CHAPTER WKH&RQWDLQHUWKDWKH·VGRQHXVLQJDVWDWHIXO
VHVVLRQEHDQ7KHEHDQLV127KDSS\
Q: ) JUST REMEMBERED THAT ) READ SOMEWHERE THAT ENTERPRISE BEANS BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
DONT SUPPORT INHERITANCE 7HATS THAT ABOUT
A: !H A COMMON MISCONCEPTION 7ELL SORT OF %*" SUPPORTS REGULAR 7KLVPHWKRGLVFDOOHGZKHQWKHEHDQ
LVSXWWRVOHHSWRWHPSRUDULO\FRQVHUYH
*AVA CLASS INHERITANCE BUT HAS NO CONCEPT OF BEAN INHERITANCE !ND NOW
YOURE ASKING h7HAT THE HECK IS THE DIFFERENCE v 9OU ALREADY KNOW WHAT UHVRXUFHV
CLASS INHERITANCE IS ITS THE THING YOU DO IN *AVA WHEN ONE CLASS EXTENDS
BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
ANOTHER !ND YOU CAN DO THAT WITH A BEAN JUST LIKE ANY OTHER CLASS
"UT BEAN INHERITANCE IF IT WERE SUPPORTED WOULD MEAN THAT A BEAN
CLASS COULD EXTEND ANOTHER BEAN CLASS AND INHERIT NOT JUST THE CLASS
7KLVPHWKRGLVFDOOHGZKHQWKHSUHYLRXVO\
INHERITABLE MEMBERS BUT ALSO ITS BEANNESS 7HAT KIND OF BEANNESS
MIGHT BE INHERITABLE *UST IN CASE THEY DO DECIDE TO SUPPORT THIS IN VOHHSLQJEHDQLVFDOOHGEDFNWRDFWLYHGXW\
THE FUTURE WHICH IS A POSSIBILITY 2EGULAR OLD NON ENTERPRISE BEANS DO WRVHUYLFHDEXVLQHVVPHWKRG
SUPPORT BEAN INHERITANCE BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
/NE IDEA MIGHT BE TO HAVE YOUR BEAN SUBCLASS INHERIT SOME OF THE
DEPLOYMENT DESCRIPTOR SETTINGS OF ITS SUPERCLASS AND THEN OVERRIDE THE
ONES IT WANTS TO CHANGE WITH A MUCH SMALLER INCOMPLETE DEPLOYMENT 7KLVPHWKRGLVFDOOHGQHDUWKHEHJLQQLQJ
DESCRIPTOR 4HAT MIGHT BE COOL WERE NOT SURE "UT RIGHT NOW ITS JUST OUR
RIWKHEHDQ·VOLIHZKHQWKH&RQWDLQHUKDQGV
LITTLE FANTASY
WKHEHDQDUHIHUHQFHWRWKHEHDQ·VVSHFLDO
)N THE MEANTIME GO AHEAD AND LET YOUR BEAN EXTEND ANOTHER CLASS IF IT OLQNWRWKH&RQWDLQHU
MAKES SENSE FOR YOUR // DESIGN
BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
6KDUSHQ \RXU SHQFLO
)LOOLQWKHPLVVLQJPHWKRGV'RQ·WZRUU\LI\RXGRQ·WJHWWKH
QDPHH[DFWO\ULJKW MXVWWU\WRZRUNRXWZKDWKDSSHQVDWHDFK
RIWKHWUDQVLWLRQVLQWKHVWDWHIXOVHVVLRQEHDQVWDWHGLDJUDP
EHDQWKURZVV\VWHPH[FHSWLRQ
GRHVQRWH[LVW XQFKHFNHGXQFDXJKW
RUWLPHRXW ===
===
WLPHRXW
PHWKRGUHDG\ SDVVLYDWHG
PHWKRGFDOOV
<RXKDYHWR
NQRZWKLV
OLIHF\FOH
WKDQN
,I\RXWDNHWKHH[DP\RX¶OO
HDW KE HFD XVH
XVIRUEHDWLQJLWWRG
XVWNQ RZ LWE DFN ZD UGV
\RXUHDOO\P
DQGIRUZDUG
RSHUWKLV
%XWHYHQDVDEHDQGHYHO
PH QWD OWRZU LWLQ J\RXU
LVVRIXQGD
DQW WR
EHDQFRGHWKDW\RX'2Z
HG 7K LVLV Q¶W
KDYHWKLVPHPRUL]
IWKRVH $3 ,P HP RUL] DWLRQ
OLNHRQHR
LQN ³,V Q¶W
TXHVWLRQVZKHUH\RXWK
"´
WKDWZKDWWKHGRFVDUHIRU
\R XK DYH DQ ,' (WK DWSXWV
(YHQLI
LQW R\ RXU
WKHFRQWDLQHUFDOOEDFNV
RX VWLOOKD YH WR
FRGHIRU\RX\
GZKDW
NQRZZKDWWKH\PHDQDQ
RWG RLQ
\RXVKRXOGRUVKRXOGQ
HDFKRQH
\RXDUHKHUH
EHDQFUHDWLRQ
GRHVQRWH[LVW
*MIV+ZMI\QWV"
_PMVIVWJRMK\JMKWUM[IJMIV
FRQVWUXFWRU
VHW6HVVLRQ&RQWH[W
HME&UHDWH 7KHSURXGHVWPRPHQWRIP\OLIH
LVZKHQWKH*UDQG0DVWHU&RQWDLQHU
PDNHVPHDEHDQE\JLYLQJPHDFRQWH[WDQG
PHWKRGUHDG\ FDOOLQJP\FUHDWH %HIRUHWKDW,·PMXVWDQ
RUGLQDU\REMHFW%XWDVDEHDQ,KDYHVSHFLDO
e xt () a n d ejbCreate()life, SULYLOHJHV EHVLGHVWKHVHFUHWKDQGVKDNH
n t Õs OLNHWKHDELOLW\WRJHWVHFXULW\
setSessionCoonce in a session beayn to do RUWUDQVDFWLRQLQIR
happe n o n ly on Õt t r
w it ! And d is too
so donÕt blosoon... the constructor
things too o any bean things.
early to d
! BEAN MOVES FROM DOES NOT EXIST TO METHOD READY STILL
FEELS CREEPY DOESNT IT HAVE TO EXIST BEFORE IT CAN MOVE
BEGINNING WITH A CONSTRUCTOR "UT THE CONSTRUCTOR MAKES
AN OBJECT NOT A BEAN 4O BE A BEAN THE OBJECT NEEDS TO BE
GRANTED BEANNESS
7HEN AN OBJECT BECOMES A BEAN IT GETS ALL THE UNIQUE
PRIVILEGES THAT COME WITH BEANNESS LIKE THE ABILITY TO GET
SECURITY INFO ABOUT THE CLIENT OR LOOK UP SPECIAL DEPLOY
TIME PROPERTIES IN THE BEANS SPECIAL SPACE IN *.$) OR GET A
*$"# #ONNECTION FROM A POOL MANAGED BY THE CONTAINER
7HY DO YOU CARE ABOUT CREATION DETAILS
"ECAUSE SOMEWHERE BETWEEN THE CONSTRUCTOR AND THE
CREATE METHOD THE BEAN IS IN A 3CHROEDINGERS BEAN
STATE
9OU MIGHT HAVE BEAN INITIALIZATION CODE LIKE GETTING A
*$"# #ONNECTION OR LOOKING UP A REFERENCE TO ANOTHER
BEAN THAT WILL FAIL IF YOU RUN IT TOO EARLY IN THE BEANS LIFE
7RITING GOOD BEAN CODE MEANS YOU MUST KNOW THE POINT
AT WHICH AN OBJECT BECOMES A CARD
CARRYING BEAN AND WHAT
THAT MEANS TO YOU AS THE DEVELOPER
*WeÕre not explaining the whole Schroedinger reference here, except to
say that it involves cats (animal-lovers be warned) and subatomic physics.
For more info, look for Head First Quantum Physics in the future. WeÕre
serious. Serious for us, anyway.
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
:KDWGRHV´EHDQQHVVµEX\\RX"
:KDWKDSSHQVZKHQD WRWKLV"
EHDQJRHVIURPWKLV
object card-carrying bean
$6HVVLRQ&RQWH[WUHIHUHQFH
! BEANS CONTEXT SOMETIMES CALLED %*"#ONTEXT
REFERRING TO THE SUPERINTERFACE OF 3ESSION#ONTEXT
'RQ·WFRQIXVH
DEHDQFRQWH[W
IS THE BEANS ONLY LIFELINE TO THE #ONTAINER AND IT
LETS THE BEAN DO THINGS LIKE GET SECURITY INFORMATION
ZLWKD-1',
ABOUT THE CALLING CLIENT FORCE A TRANSACTION TO
FRQWH[W ROLLBACK GET A REFERENCE TO THE BEANS OWN HOME OR
%*" OBJECT AND MORE
DVDOOVR
-XVWZKHQ\RXWKRXJKWLWZ
\RXUKRUURUWKDWWKH
FOHDU\RX¿QGWR
FRQ WH[W´LVRYHUORDGH G
ZRUG³
$VSHFLDO-1',&RQWH[W
LRQ&RQWH[W
$EHDQ¶VFRQWH[WOLNH6HVV
JH'ULYHQ
RU(QWLW\&RQWH[WRU0HVVD %VERY BEAN GETS ITS VERY OWN *.$) CONTEXT WHERE
VSHFLDOUHIHU
&RQWH[W LVWKHEHDQ¶V IT CAN l ND THINGS INCLUDING RESOURCE MANAGER
[WHQGV(-%& RQW H[W IRU
HQFH ZKLFKH CONNECTION FACTORIES OBJECTS THAT GIVE YOU
LQH U
JHWWLQJLQIRIURPWKH&RQWD CONNECTIONS TO RESOURCES LIKE A DATABASE OTHER
ZLWKD-1', BEANS AND DEPLOY
TIME CONSTANT VALUES THAT YOU CAN
7KLVKDV127+,1*WRGR USE TO CUSTOMIZE YOUR BEANS VARIABLES 9OULL LEARN A
PHPEHULV
FRQWH[W$-1',FRQWH[WUH
QD -1 ',YLUWXDO LOT MORE ABOUT THAT IN #HAPTER WHERE WE LOOK AT
DSDUWLFXODU³QRGH´R
UHH $Q ,QLWLDO&R QWH [WLVWKH THE ENTERPRISE BEAN ENVIRONMENT THATS WHAT THE SPEC
GLUHFWRU\W
V\ RXUHQWU\
-1',FRQWH[WWKDWVHUYHVD CALLS THE BEANS SPECIAL *.$) CONTEXT
HV WUXF WXUH ,QRWKHU
SRLQWLQWRWKHWUH
HS ODF HIURP ZK LFK \R XVWDUW
ZRUGVWK
QDYLJDWLQJWKURXJKWKHWU HH
UG³FRQWH[W´ $FFHVVWREHDQVDQGUHVRXUFHV
:KHQHYHU\RXVHHWKHZR
FR QWH[WRIWKH
ORRNFORVHO\DWWKHXP *UST BECAUSE YOU GOT A CONNECTION TO A DATABASE
UHRXWWRZ KLFKFRQWH[W
TXHVWLRQWR¿JX DOESNT MEAN YOU CAN ALWAYS USE IT 0ART OF BEING A
Q¶V(-%
WKHTXHVWLRQUHIHUV²WKHEHD BEAN IS THE ABILITY TO ACCESS A RESOURCE LIKE A DATABASE
WH[ W6KHH VK
&RQWH[WRU-1',FRQ OR CALL METHODS ON ANOTHER ENTERPRISE BEAN
\RXDUHKHUH
VSHFLDOEHDQWKLQJV
6SHFLDO%HDQ7KLQJV
$6HVVLRQ&RQWH[WUHIHUHQFH
7KLQJV\RXFDQGRZLWK\RXUFRQWH[W
JHWDUHIHUHQFHWR\RXUKRPH
JHWDUHIHUHQFHWR\RXU(-%REMHFW
(-%&RQWH[W
JHWVHFXULW\LQIRUPDWLRQDERXWWKHFOLHQW
IRUFHDWUDQVDFWLRQWRUROOEDFN &07
ILQGRXWLIWKHWUDQVDFWLRQKDVDOUHDG\EHHQVHWWRUROOEDFN &07
JHWDWUDQVDFWLRQUHIHUHQFHDQGFDOOPHWKRGVRQLW %07
$VSHFLDO-1',&RQWH[W
7KLQJV\RXFDQORRNXSZLWK\RXUVSHFLDO
-1',FRQWH[W
)RR
DUHIHUHQFHWRDQRWKHUEHDQ
DUHIHUHQFHWRDUHVRXUFHPDQDJHUFRQQHFWLRQIDFWRU\ OLNH
'DWD6RXUFH WKDW\RXFDQXVHWRJHWIRUH[DPSOHDGDWDEDVH
0\3ULYDWH3ODFH
FRQQHFWLRQ
%DU
GHSOR\WLPHFRQVWDQWYDOXHV NLQGRIOLNHSURSHUWLHV IRUWKHEHDQ
YDOXHVVHWE\WKHGHSOR\HUWKDWWKHEHDQFDQORRNXSDQGXVH
a beanÕs special DVYDULDEOHVDWUXQWLPH
JNDI reference DUHIHUHQFHWRDQ´DGPLQLVWHUHGREMHFWµUHVRXUFH ZKLFKXVXDOO\
PHDQVD-06GHVWLQDWLRQ
$FFHVVWR
DQRWKHUEHDQ
DUHVRXUFHPDQDJHU OLNHDGDWDEDVH
'%
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
<RXFDQ·WDOZD\VXVHDOORI
\RXUEHDQQHVV
*UST BECAUSE YOUVE BECOME A FULL
m EDGED BEAN DOESNT
NECESSARILY MEAN YOU CAN DO ALL OF THE "EAN 4HINGS ON
THE OPPOSITE PAGE LOOKUP A RESOURCE FORCE A TRANSACTION
ROLLBACK ETC
4HE THINGS YOU CAN DO CAN VARY DEPENDING ON WHAT KIND
OF BEAN YOU ARE 3ESSION %NTITY -ESSAGE$RIVEN YOUR
TRANSACTION STATUS AND WHAT KIND OF METHOD YOURE IN
&OR EXAMPLE IF YOURE A STATEFUL SESSION BEAN YOUR
<RXPXVWNQRZ
:+(1\RXFDQ
CREATION IS A DIRECT RESULT OF THE CLIENT CALLING CREATE ON
YOUR HOME )F YOURE A STATEFUL BEAN AND YOURE IN YOUR
GRVSHFLÀF%HDQ
7KLQJVDQGZKHQ EJB#REATE METHOD THERE CAN BE ONLY ONE REASON A CLIENT
\RXFDQ·W HAS ASKED FOR YOU TO BE CREATED !ND THAT MEANS YOU CAN l ND
OUT WHO THE CLIENT IS BY ASKING YOUR %*"#ONTEXT LIKE
VFHQDULR
%HSUHSDUHGIRUFRGHRUD 3ESSION#ONTEXT FOR CLIENT SECURITY INFORMATION
DP HWK RG DQG DVNV
WKDWVKRZV\RX "UT IF YOURE A STATELESS BEAN YOUR CREATION ISNT TIED TO ANY
HU\ RXFDQ GR DS DUWLFXO DU%HDQ
ZKHWK
RG JLYHQ WKH PARTICULAR CLIENTS REQUEST YOULL LEARN ALL ABOUT THIS IN A
7KLQJIURPWKDWPHWK
FLUFXPVWDQFH V FEW MORE PAGES )N FACT IF THE #ONTAINER WANTS TO IT CAN
VKRZQ
)RUH[DPSOH\RXPLJKWEH CREATE A BUNCH OF STATELESS BEANS FOR THE POOL BEFORE THERE
H[W P HWKRGRID
WKHVHW6HVVLRQ&RQW ARE ANY CLIENTS !ND THAT MEANS A STATELESS BEAN CANNOT GET
HG LI\ RX¶ UHD OORZHGWR
EHDQDQGDVN SECURITY INFORMATION ABOUT THE CLIENT DURING EJB#REATE
DWD EDVH
DFFHVVDUHVRXUFH OLNHDG "ECAUSE THERES NO CLIENT 4HERES ONLY THE #ONTAINER
X¶UH QR W< RX
IURPWKDWPHWKRG <R INVOKING A CONTAINER CALLBACK THATS NOT PART OF A CLIENT
HDQ LQJ IXOWUDQ VDF WLRQ
DUHQ¶WLQD³P CALL AND WE DONT CONSIDER THE #ONTAINER TO BE A CLIENT
FRQWH[W´DWWKDWSRLQW 4HE #ONTAINER IS THE BOSS NOT THE CLIENT
!ND THERE ARE SOME "EAN 4HINGS THAT CAN BE DONE ONLY
WHILE THE BEAN IS IN WHAT THE #ONTAINER CONSIDERS hA
MEANINGFUL TRANSACTION CONTEXTv 9OU CANT FOR EXAMPLE
ACCESS A DATABASE FROM A METHOD THAT MIGHT NOT HAVE A
TRANSACTION
3OME "EAN 4HINGS ARE MUTUALLY EXCLUSIVE )F YOURE USING
CONTAINER
MANAGED TRANSACTIONS #-4 #HAPTER
YOU MUST NOT ASK YOUR %*"#ONTEXT TO GIVE YOU YOUR OWN
TRANSACTION OBJECT /N THE OTHER HAND IF YOURE USING BEAN
MANAGED TRANSACTIONS "-4 YOU CAN ASK FOR A TRANSACTION
OBJECT BUT THEN YOU MUST NOT ASK YOUR CONTEXT TO ROLLBACK
YOUR TRANSACTION 9OULL HAVE TO ROLLBACK THE TRANSACTION
YOURSELF USING THE TRANSACTION OBJECT YOU GOT FROM YOUR
CONTEXT
\RXDUHKHUH
EHDQFUHDWLRQ
%HDQFUHDWLRQRYHUYLHZ
VWDWHIXOVHVVLRQEHDQ
&OLHQWFDOOVFUHDWHRQWKHKRPH
FOLHQW
+RPH
VWXE REMHFW
FUHDWH
FUHDWH
&RQWDLQHUPDNHVWKH(-%REMHFWDQG
6HVVLRQ&RQWH[W
(-%
REMHFW
6HVVLRQ
&RQWH[W
&RQWDLQHUFRQVWUXFWVWKH
EHDQLQVWDQFH
EHDQ
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
&RQWDLQHUOLQNVWKHEHDQWRLWV
FRQWH[WDQG(-%REMHFW FDOOLQJ
VHW6HVVLRQ&RQWH[W DQGHME&UHDWH
EHDQ
H [W
DW WH
UH RQ
E& Q&
HM VVLR
H
W6
VH
4HE LINKING HAPPENS WHEN THE CONTAINER CALLS SET3ESSION#ONTEXT AND
EJB#REATE ON THE BEAN /NCE EJB#REATE RETURNS THE BEAN IS READY FOR
@ACTIVE DUTY IN OTHER WORDS READY FOR BUSINESS METHOD CALLS FROM THE CLIENT
&RQWDLQHUVHQGVWKHFOLHQWDVWXE
WRWKH(-%REMHFW
VWXE
\RXDUHKHUH
EHDQFUHDWLRQ
2EMHFW,QWHUDFWLRQ'LDJUDP 2,' IRUEHDQFUHDWLRQ
VWDWHIXOVHVVLRQEHDQ
FOLHQW
+RPH (-% 6HVVLRQ
REMHFW REMHFW &RQWH[W
EHDQ
FUHDWH
QHZ
QHZ
QHZ EHDQ·VFRQVWUXFWRUUXQV
VHW6HVVLRQ&RQWH[W
HME&UHDWH
E TO
OU DO NT HAV SS
9 A
-, TO P
KNOW 5
M
THE EXA U TO
UIRE YO
M D O E SNT REQ ITTLE 5-, IS
4HE EX
A GH A L
5 - , ALTHOU E OF OUR BEST
K N OW 3 O M O T H ING
H E % * " SPEC 5 - , )T S N
IN T N OW VER
DONT K Y (OWE
FRIENDS AMED OF 2EALL EMAINING
SH N R
TO BE A ONE OF THE TE T K NOW 5-,
O U A RE T D O N O
IF Y O IN FA C LIC
LE W H T O R ISK PUB HT
PEOP W A N T IG
U DONT RIDICULE YOU M 5-,
AND YO N D IR S T
TION A EAD &
HUMILIA ONSIDER OUR (
T T O C
WAN S BOOK
A T T E R N
0
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
:ULWLQJWKHWKUHHFUHDWLRQUHODWHGWKLQJV
VWDWHIXOVHVVLRQEHDQ
FRQVWUXFWRU
'RQ·WSXWDQ\WKLQJLQWKHFRQVWUXFWRU7KHUH·VQRWKLQJ\RXZRXOGGRLQ
WKHFRQVWUXFWRUWKDW\RXFDQ·WGRLQHME&UHDWH VRXQOHVV\RXU,'(SXWV
RQHLQIRU\RX\RX·UHEHWWHURIIOHDYLQJWKHFRQVWUXFWRURXWRI\RXUFRGH
SXEOLFFODVV$GYLFH%HDQLPSOHPHQWV6HVVLRQ%HDQ^
ok
t h e c o n st r uctor should loa
SXEOLF$GYLFH%HDQ ^ This is whaty. Better yet, donÕt put give you
QRFRGHKHUH like!! Empt in and let the compiler
`
constructor constructor.
the default
`
VHW6HVVLRQ&RQWH[W 6HVVLRQ&RQWH[WVF
6DYH\RXUFRQWH[W<RXJHWRQO\RQHFKDQFHWRJUDEWKLVUHIHUHQFHWR
\RXU6HVVLRQ&RQWH[WVR\RXEHWWHUDVVLJQLWWRDQLQVWDQFHYDULDEOH
SULYDWH6HVVLRQ&RQWH[WFRQWH[W
SXEOLFYRLGVHW6HVVLRQ&RQWH[W 6HVVLRQ&RQWH[WFW[ ^
FRQWH[W FW[
` save the SessionContext by assigning it to an instance
variable. You will NEVER get another chan
a reference to your context, so you betterce to have
do it here!
Anything else you would put in this method prob
belongs in ejbCreate(). ably
HME&UHDWH
3XWDOO\RXULQLWLDOL]DWLRQFRGHKHUH,ILW·VDVWDWHIXOEHDQDQGWKHFUHDWH
PHWKRGKDVDUJXPHQWVWKH&RQWDLQHUZLOOSDVVWKRVHDUJXPHQWVLQWR\RXU
PDWFKLQJHME&UHDWH PHWKRG<RXKDYHIXOOEHDQVWDWXVQRZVR\RXFDQ
GRDQ\WKLQJ\RXQHHGWRIURPWKLVPHWKRGLQFOXGLQJWKLQJV\RXFDQ·WGRLQ
VHW6HVVLRQ&RQWH[W OLNHJHWDUHIHUHQFHWR\RXURZQ(-%REMHFW
SULYDWH6WULQJQDPH YouÕre a full member of the
bean society now, so this is
SXEOLFYRLGHME&UHDWH 6WULQJFOLHQW1DPH ^
QDPH FOLHQW1DPH
where youÕll usually put ALL
RWKHUFRGH your initialization code.
`
\RXDUHKHUH
EHDQFUHDWLRQ
*MIV\PQVO[aW]KIVLWL]ZQVOKZMI\QWV"
VWDWHIXOVHVVLRQEHDQ
WLPHOLQH
FRQVWUXFWRU VHW6HVVLRQ&RQWH[W HME&UHDWH
QRWKLQJ 8VH\RXU6HVVLRQ&RQWH[WWR 8VH\RXU6HVVLRQ&RQWH[WWR
JHWDUHIHUHQFHWR\RXUKRPH JHWDUHIHUHQFHWR\RXUKRPH
ItÕs too early to DO
anything ! YouÕre an object, JHWDUHIHUHQFHWR\RXU(-%REMHFW JHWDUHIHUHQFHWR\RXU(-%REMHFW
but not yet a bean. JHWVHFXULW\LQIRUPDWLRQDERXWWKHFOLHQW JHWVHFXULW\LQIRUPDWLRQDERXWWKHFOLHQW
IRUFHDWUDQVDFWLRQWRUROOEDFN &07 IRUFHDWUDQVDFWLRQWRUROOEDFN &07
EHDQV EHDQV
ILQGRXWLIWKHWUDQVDFWLRQKDVDOUHDG\ ILQGRXWLIWKHWUDQVDFWLRQKDVDOUHDG\
EHHQVHWWRUROOEDFN &07EHDQV EHHQVHWWRUROOEDFN &07EHDQV
JHWDWUDQVDFWLRQUHIHUHQFHDQGFDOO JHWDWUDQVDFWLRQUHIHUHQFHDQGFDOO
PHWKRGVRQLW %07EHDQV PHWKRGVRQLW %07EHDQV
$FFHVV $FFHVV
\RXUVSHFLDO-1',HQYLURQPHQW \RXUVSHFLDO-1',HQYLURQPHQW
DQRWKHUEHDQ·VPHWKRGV DQRWKHUEHDQ·VPHWKRGV
DUHVRXUFHPDQDJHU OLNHDGDWDEDVH DUHVRXUFHPDQDJHU OLNHDGDWDEDVH
1RWH WKHZRUG³DFFHVV´PHDQV³GRWKLQJVZLWK´VRZKHQWKHVSHFXVHV
WKHSKUDVH³UHVRXUFHPDQDJHUDFFHVV´LWPHDQVXVLQJWKHUHVRXUFHWR
GRZKDWHYHUWKDWUHVRXUFHLVIRU6RLQVHW6HVVLRQ&RQWH[W IRUH[DPSOH
\RXFDQXVH-1',WRORRNXSDUHVRXUFHPDQDJHUFRQQHFWLRQIDFWRU\OLNH
MDYD[VTO'DWD6RXUFHDQG\RXFDQDVNWKH'DWD6RXUFHIRUDFRQQHFWLRQ
P\'DWD6RXUFHJHW&RQQHFWLRQ EXW\RXFDQ¶WPDNHD-'%&FDOORQWKH
FRQQHFWLRQUHIHUHQFH<RXFDQXVH\RXUFRQQHFWLRQLQHME&UHDWH
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
8PJRRGWR
NQRZDOOWKDWEXW
WKLVPDWWHUVWRPH+2:"
:KDWGRHVWKLVPHDQ
WR0(DQGKRZGRHVLW
DIIHFWP\FRGH"
6KHGRHVQ·WJHWLWIRURQHWKLQJ,GRQ·WSXW
$1<7+,1*LQP\FRQVWUXFWRU2QHWLPH,WULHGWR
GRD-1',ORRNXSLQDFRQVWUXFWRUWRJHWDGDWDEDVH
UHVRXUFHIDFWRU\,WFRPSLOHGDQGGLGQ·WWKURZDQ
H[FHSWLRQGXULQJWKHORRNXSEXWDWUXQWLPHZKHQ,WULHG
WRJHWDFRQQHFWLRQLWEOHZXS7KHEHDQKDGQ·WJRWWHQLWV
VSHFLDOEHDQ-1',FDSDELOLWLHV\HWVRWKHUHVRXUFHIDFWRU\
ZDVQ·WUHDOO\WKHUH7KHUHLV127+,1*\RXZRXOGGRLQ
DFRQVWUXFWRUWKDW\RXFDQ·WGRLQHME&UHDWH LQVWHDG
0\EHVWDGYLFHLVWRWKLQNRIHME&UHDWH DVWKH
FRQVWUXFWRUIRUVHVVLRQEHDQV HQWLW\EHDQVDUH
DQRWKHUVWRU\
DQDVSLULQJ%HDQ3URYLGHU
WKHPRUHH[SHULHQFHG
%HDQ3URYLGHU
\RXDUHKHUH
EHDQXVH
GRHVQRWH[LVW
*MIV=[M"
_PI\PIXXMV[).<-:KZMI\QWV
7KHRQO\UHDVRQ,FDOOHG
PHWKRGUHDG\
FUHDWH RQWKHKRPHLVVR,FRXOG
JHWDUHIHUHQFHWRDEHDQ·VFRPSRQHQW
he
ady state, tness
LQWHUIDFHDQGGRZKDW,5($//<ZDQW
m e t h o d re
In the her running a busi FDOODEXVLQHVVPHWKRG)DUDV,·P
bean is eit waiting for the
FRQFHUQHGWKDW·VWKH21/<UHDVRQ
method or all one...
WKHEHDQ·VDOLYH7RVHUYLFH
0(VR,FDQVKRS
client to c
$WODVW,·PIXOÀOOLQJ
P\GHVWLQ\0\SXUSRVH
0\UDLVRQG·rWUH
)N THE METHOD READY STATE THE BEAN CAN RUN BUSINESS
METHODS !ND GIVEN THAT BUSINESS METHODS ARE THE BEANS
HIGHEST PURPOSE THE BEAN CAN BRING ALL OF ITS BEANNESS TO
BEAR )N OTHER WORDS THE BEAN CAN DO MORE BEAN THINGS
FROM WITHIN A BUSINESS METHOD THAN AT ANY OTHER POINT IN
ITS BRIEF BUT MEANINGFUL LIFE
:HFKDOOHQJH\RXWR¿QGDQRWKHUFRPSXWHUERRNWKDWXVHV
UDLVRQG¶rWUHDVDSSURSULDWHO\DVZHGR$QGZLWKWKDWOLWWOH
XSVLGHGRZQYWKLQJRYHUWKHrDQGHYHU\WKLQJ
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
*MIV\PQVO[aW]KIVLW_Q\PQVJ][QVM[[UM\PWL["
8VH\RXU6HVVLRQ&RQWH[WWR
JHWDUHIHUHQFHWR\RXUKRPH
JHWDUHIHUHQFHWR\RXU(-%REMHFW
JHWVHFXULW\LQIRUPDWLRQDERXWWKHFOLHQW
IRUFHDWUDQVDFWLRQWRUROOEDFN &07
EHDQV
ILQGRXWLIWKHWUDQVDFWLRQKDVDOUHDG\
EHHQVHWWRUROOEDFN &07EHDQV
JHWDWUDQVDFWLRQUHIHUHQFHDQGFDOO
PHWKRGVRQLW %07EHDQV
$FFHVV
\RXUVSHFLDO-1',HQYLURQPHQW
DQRWKHUEHDQ·VPHWKRGV
DUHVRXUFHPDQDJHU OLNHDGDWDEDVH
\RXDUHKHUH
EHDQSDVVLYDWLRQ
HME3DVVLYDWH
PHWKRGUHDG\ SDVVLYDWHG
HME$FWLYDWH
8I[[Q^I\QWV"I[\I\MN]TJMIV¼[KPIVKM
I\[KITIJQTQ\a
$UH\RXVXUHWKLV
FDQ·WZDLWXQWLOODWHU",
ZDVULJKWLQWKHPLGGOHRI
VKRSSLQJRKZHOO,JXHVV
P\VKRSSLQJFDUWEHDQZLOO
VWLOOEHWKHUHZKHQ 7KDWFOLHQWGRHVQ·WVHHPWREH
ZH·UHGRQH GRLQJDQ\WKLQJ,W·VWRRHDUO\WRNLOO
WKHEHDQFRPSOHWHO\ VKHVWLOOPLJKWFRPH
EDFN%XW,GRQ·WZDQWWKHEHDQZDVWLQJ
5$0 ,·OOVHULDOL]HWKHEHDQIRUQRZDQG
LIWKHFOLHQWFRPHVEDFN,·OOMXVW
GHVHULDOL]HLW
/RRNV
OLNH,·PEHLQJ
SDVVLYDWHGVR,EHWWHU
===
PDNHVXUH,QXOORXWP\ ===
QRQ6HULDOL]DEOHLQVWDQFH
YDULDEOHV
b e a n s a r e tied directly
StateFUL , remember, so until ut
to a client iner decides to timeoas 7HEN THE #ONTAINER DECIDES A STATEFUL BEAN IS WASTING
the Conta(because the client w n RESOURCES ITLL CALL THE BEANS EJB0ASSIVATE METHOD AND
the bean ay too long), the bea THEN SAVE THE BEAN INTO TEMPORARY STORAGE
inactive w sed for anything (or
canÕt be u e. 7HY DO YOU CARE ABOUT PASSIVATION DETAILS
anyone) els nÕt have thlis "ECAUSE THE #ONTAINER USES A SPECIAL SET OF RULES NEARLY
S b e a n s d o
StateLES hey go back to a poo a IDENTICAL TO 3ERIALIZATION TO PASSIVATE YOUR BEAN AND ITS
problem, tach method call, since YOUR JOB TO MAKE SURE YOUR INSTANCE VARIABLES ARE IN A STATE
between e tied to a client. THAT WORKS FOR PASSIVATION !ND ITS JUST A TINY BIT MORE SUBTLE
bean isnÕt THAN SIMPLY MAKING NON
3ERIALIZABLE VALUES TRANSIENT
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
/LIHF\FOHRYHUYLHZ EHDQSDVVLYDWLRQDFWLYDWLRQ
&OLHQWGRHVQ·WFDOODQ\PHWKRGV
IRUDZKLOHVRFRQWDLQHUFDOOV
HME3DVVLYDWH RQWKHEHDQ
EHDQ
(-%
REMHFW WH
FOLHQW DVVLYD
VWXE 3
HME
&RQWDLQHUFDOOVHME3DVVLYDWH RQ
WKHEHDQWKHQVDYHVWKHEHDQWR
===
WHPSRUDU\VWRUDJH HLWKHUWKURXJK ===
VHULDOL]DWLRQRUVRPHWKLQJOLNHLW
EHDQ
(-%
REMHFW EHDQLVDVOHHS
FOLHQW SDVVLYDWHGDQG
VWXE WHPSRUDULO\VDYHG
&OLHQWFDOOVDEXVLQHVVPHWKRGVR
FRQWDLQHUDFWLYDWHVWKHEHDQ WKURXJK
VRPHWKLQJOLNHGHVHULDOL]DWLRQ FDOOV
HME$FWLYDWH WKHQLQYRNHVWKHEXVLQHVV
PHWKRG JHW$GYLFH RQWKHEHDQ H
W$GYLF
JH
JHW$GYLFH (-%
EHDQ
JHW$GYLFH WH
FOLHQW
REMHFW
$FWLYD
VWXE HME
\RXDUHKHUH
EHDQSDVVLYDWLRQ
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: (OW DOES THE #ONTAINER Q: 7HAT IF THE CLIENT CRASHES
KNOW WHEN TO PASSIVATE A BEAN #AN THE SERVER TELL )S THERE ANY
KIND OF DISTRIBUTED GARBAGE COL
A: 4HE #ONTAINER LOOKS FOR INAC
LECTION OR LEASING LIKE THERE IS WITH
2-) /R IS THE SERVER REALLY JUST
TIVITY )F THE CLIENT HASNT BEEN DOING BASING EVERYTHING ON INACTIVITY
ANYTHING FOR SOME PERIOD OF TIME
THE #ONTAINER CAN CHOOSE TO PASSIV
ATE THE BEAN )F IT NEEDS TO A: !CCORDING TO THE SPEC THERE
IS NO GUARANTEE OF DISTRIBUTED GAR
Q: 'EE CAN YOU BE ANY MORE BAGE COLLECTION WHICH MEANS YOU
SHOULD ASSUME THAT IT ISNT HAPPEN
NON
COMMITTAL (OW LONG IS
hSOME PERIOD OF TIMEv AND WHAT ING 0ART OF THE REASON IS BECAUSE AN
%*" CLIENT COULD AT LEAST IN THEORY
DETERMINES WHETHER THE #ONTAINER
BE A #/2"! CLIENT RATHER THAN A *AVA
@NEEDS TO PASSIVATE THE BEAN
2-) CLIENT 3O THE WHOLE CONCEPT OF
2-)S DISTRIBUTED GARBAGE COLLECTION
A: 4HERE IS NOTHING IN THE SPEC
WOULDNT APPLY
!ND JUST A QUICK OFF
PATH HERE
THAT SAYS YOURE ALLOWED TO TUNE
THE PARAMETERS FOR THE #ONTAINERS DISTRIBUTED GARBAGE COLLECTION DGC 7KHUH¶VQRWKLQJRQWKH
PASSIVATION DECISIONS "UT MANY OR DISTRIBUTED LEASING ARE WAYS IN H[DPDERXWYHQGRU
CONTAINERS DO GIVE YOU A WAY TO WHICH A SERVER CAN FIGURE OUT IF VSHFL¿FSDVVLYDWLRQ
SET A VARIETY OF VALUES 4HE DECISION A CLIENT HAS WITH DGC NULLED OUT VHWWLQJVRUEHKDYLRU
MIGHT BE BASED ON AVAILABILITY OF RE
THEIR REFERENCE TO THE STUB OR WITH
SOURCES LIKE hPASSIVATE STATEFUL SES
LEASING IF THE CLIENT HAS SIMPLY GONE 7KHRQO\WKLQJRQWKHH[DPDERXW
SION BEANS ONLY WHEN AVAILABLE 2!- AWAY EITHER BY SHUTTING DOWN THE SDVVLYDWLRQLVZKDW\RX¶UHUHVSRQVLEOH
HITS THIS LEVELv OR hPASSIVATE BEANS APP CRASHING OR DISCONNECTING FROM IRUDVD%HDQ3URYLGHU²JHWWLQJ
ONLY WHEN THE NUMBER OF ACTIVE THE NETWORK \RXULQVWDQFHYDULDEOHYDOXHVLQD
STATEFUL SESSION BEANS REACHESv SDVVLYDWDEOHVWDWH ZH¶OOWDONDERXW
4HE BOTTOM LINE IS THAT YOU HAVE TO WKDWQH[W 1RWKLQJDERXWSDVVLYDWLRQ
!ND YOU MIGHT BE ABLE TO SET THE ASSUME THAT THE %*" SERVER DOESNT JRHVLQWRWKHGHSOR\PHQWGHVFULSWRU
INACTIVITY VALUE FOR THE AMOUNT OF SUPPORT THIS SO YOURE STUCK WITH VR\RXGRQ¶WQHHGWRNQRZKRZ
ELAPSED TIME AT WHICH THE #ONTAINER INACTIVITY AND PERHAPS SOME KIND OF SDVVLYDWLRQSDUDPHWHUVDUHVHWIRU
SHOULD PASSIVATE ,25 ,EAST 2ECENTLY 5SED ALGO
DQ\SDUWLFXODUVHUYHU
RITHMS FOR SELECTING WHO SHOULD
BE PASSIVATED IF RESOURCES BECOME
SCARCE AND THE #ONTAINER NEEDS TO
BRING DOWN SOME BEANS
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
AW]ZRWJNWZXI[[Q^I\QWV"
UISMaW]Z[\I\MXI[[Q^I\IJTM
:KHQ,ZULWHP\EHDQFODVV,
KDYHWRPDNHVXUHWKDWE\WKH
WLPHHME3DVVLYDWH FRPSOHWHVP\
LQVWDQFHYDULDEOHYDOXHVDUH$//UHDG\
IRUSDVVLYDWLRQ7KDWPHDQVWKHYDOXHV
KDYHWREH6HULDOL]DEOH RUSULPLWLYH QXOO
RUUHIHUHQFHVWRRQHRIWKHVSHFLDO
WKLQJVWKH&RQWDLQHUKDVWRWDNH :KHQHME3DVVLYDWH FRPSOHWHVHYHU\QRQWUDQVLHQWLQVWDQFH
FDUHRIQRPDWWHUZKDW YDULDEOH0867EHDUHIHUHQFHWRRQHRIWKHIROORZLQJ
D6HULDOL]DEOHREMHFW
DQXOOYDOXH
DEHDQ·VUHPRWHFRPSRQHQWRUKRPHLQWHUIDFHHYHQLIWKHVWXE
FODVVLVQRW6HULDOL]DEOH LQRWKHUZRUGV\RXGRQ·WKDYHWRZRUU\
DERXWLW
DEHDQ·VORFDOFRPSRQHQWRUKRPHLQWHUIDFHHYHQLILW·VQRW
6HULDOL]DEOH DJDLQ\RXGRQ·WKDYHWRZRUU\
D6HVVLRQ&RQWH[WREMHFWHYHQLILW·VQRW6HULDOL]DEOH
WKHEHDQ·VVSHFLDO-1',FRQWH[WRUDQ\RILWVVXEFRQWH[WV
WKH8VHU7UDQVDFWLRQLQWHUIDFH VRPHWKLQJ\RXFDQJHWIURP\RXU
6HVVLRQ&RQWH[W³ZH·OOVHHWKDWLQWKHWUDQVDFWLRQVFKDSWHU
DUHVRXUFHPDQDJHUFRQQHFWLRQIDFWRU\ OLNHDQLQVWDQFHRI
MDYD[VTO'DWD6RXUFH
<RXKDYHWR
NQRZWKHVH
IRUWKHH[DP
WKDW
<RXPLJKWVHHDTXHVWLRQ
VKRZV\RXDFODVVD QG DQ
DVNV
HME3DVVLYDWH PHWKRGDQG
WZRXOGZ RUN RUQRW
\RXLIL
KDYH
,IWKHPHWKRGLVHPSW\\RX
LQV WDQFH YDU LDEOHVWR
WRORRNDWWKH
LIWKH\¶UHDOO2. DVWKH \DUH
VHH
\RXDUHKHUH
DFWLYDWLRQSDVVLYDWLRQ
,PSOHPHQWLQJHME$FWLYDWH DQGHME3DVVLYDWH
HME3DVVLYDWH
0DNHVXUH\RXULQVWDQFHYDULDEOHVDUHUHDG\IRUSDVVLYDWLRQ0RVW
RIWKHWLPH\RXSUREDEO\ZRQ·WKDYHDQ\FRGHLQHME3DVVLYDWH VLPSO\
EHFDXVHDOORI\RXULQVWDQFHYDULDEOHVPHHWWKHFULWHULDGHILQHGRQWKH
SUHYLRXVSDJH HJUHIHUHQFHWRD6HVVLRQ&RQWH[WRUDEHDQ·VFRPSRQHQW
LQWHUIDFHRUD6HULDOL]DEOHREMHFWHWF
SXEOLFYRLGHME3DVVLYDWH ^
FRQQHFWLRQ QXOO ection is not
` a JDBC con, nso if you have one, you
Serializable to null in ejbPassivate()
must set it
HME$FWLYDWH
5HDFTXLUH\RXUQRQ6HULDOL]DEOHUHVRXUFHVRUGRZKDWHYHULWWDNHV
WRUHVWRUH\RXUVWDWHIRUXVH,I\RX·UHUXQQLQJLQHME$FWLYDWH WKHUH
FDQEHRQO\RQHUHDVRQ WKHFOLHQWFDOOHGDEXVLQHVVPHWKRG6RLQ\RXU
HME$FWLYDWH PHWKRG\RXPXVWPDNHVXUH\RXJHWUHDG\IRUWKHEXVLQHVV
PHWKRGFDOOWKDW·VDERXWWRKDSSHQ&KDQFHVDUHWKLVPHWKRGZLOOEH
HPSW\IRUWKHVDPHUHDVRQDVHME3DVVLYDWH %XWLI\RXGLGQXOORXWQRQ
6HULDOL]DEOHUHIHUHQFHVWKHQHME$FWLYDWH LVWKHSODFHWRJHWWKHPEDFN
SXEOLFYRLGHME$FWLYDWH ^
WU\^
FRQQHFWLRQ P\'DWD6UFJHW&RQQHFWLRQ
`FDWFK ([FHSWLRQH[ ^`
`
now we have to get the JDBC connecti back
that the DataSource did not have to beonrest again. Notice
ored
itÕs one of the things on the ContainerÕs Òapp , because
(Because itÕs a resource manager connection roved listÓ.
Container is required to passivate it.) factory, and the
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
WKHUH DUH QR 6KDUSHQ \RXU SHQFLO
'XPE 4XHVWLRQV
Q: #ANT YOU JUST MARK YOUR NON 3ERIALIZABLE VARIABLES
TRANSIENT )SNT THAT WHAT TRANSIENT IS FOR <RX·UHUHVSRQVLEOHIRUPDNLQJVXUHWKDWZKHQ
HME3DVVLYDWH FRPSOHWHV\RXULQVWDQFH
A: 9OU COULD YES BECAUSE THE #ONTAINER IS REQUIRED TO
YDULDEOHVDUHLQRQHRIWKHVWDWHVZHOLVWHGD
FRXSOHRISDJHVDJR'RQ·WORRNQRZ6HHLI
FOLLOW THE RULES FOR 3ERIALIZATION WHEN IT PASSIVATES A BEAN
\RXFDQZRUNRXWZKLFKRIWKHVHZLOOEHVDIHO\
EVEN IF THE #ONTAINER CHOOSES TO USE SOMETHING OTHER THAN
SERIALIZATION TO GET THE JOB DONE
SDVVLYDWHG
"UT THERES A LITTLE TEENY COMMENT IN THE SPEC WHICH
SAYS THAT THERES AN EXCEPTION TO THE RULE THAT PASSIVATION UHIHUHQFHWRDMDYDQHW6RFNHWREMHFW
BEHAVE JUST LIKE SERIALIZATION 4HE EXCEPTION IS THAT WHILE
SERIALIZATION IS REQUIRED TO BRING BACK TRANSIENT FIELDS WITH UHIHUHQFHWRDMDYD[VTO'DWD6RXUFH
DEFAULT VALUES PASSIVATION DOESNT GUARANTEE THAT
7HAT DOES THIS MEAN 4HINK ABOUT IT )T MEANS YOU CANT UHIHUHQFHWRDEHDQ·V5HPRWHFRPSRQHQW
RELY ON TRANSIENT TO GIVE YOU BACK YOUR DEFAULTS SO AFTER LQWHUIDFH
ACTIVATION YOU COULD END UP WITH WELL ANYTHING IN A
VARIABLE THATS MARKED TRANSIENT UHIHUHQFHWRDEHDQ·V-1',FRQWH[W
3O YOU ARE FREE TO USE TRANSIENT AND IT CAN MAKE PASSIVATION
MORE EFFICIENT BUT THE IMPLICATION ISRESET YOUR TRANSIENT UHIHUHQFHWRDMDYDVTO&RQQHFWLRQ
VARIABLES YOURSELF IN EJB!CTIVATE
UHIHUHQFHWRDMDYD[HME6HVVLRQ&RQWH[W
Q: 7HAT IF ) HAVE A NON
3ERIALIZABLE VALUE THAT ) REALLY
REMHFW
NEED TO MAINTAIN DURING PASSIVATION )F ) CANT SAVE IT HOW DWUDQVLHQWYDULDEOHZLWKDQXOOYDOXH
WILL ) KNOW WHAT TO SET IT BACK TO IN EJB!CTIVATE
DQRQWUDQVLHQW6HULDOL]DEOHYDULDEOHZLWK
A: 4HIS IS A CLASSIC SERIALIZATION ISSUE NOT SPECIFIC TO
DQXOOYDOXH
PASSIVATION 4HE USUAL TRICK IS TO INTERROGATE THE NON
3ERIALIZABLE OBJECT TO GET ALL THE IMPORTANT STATE OUT OF DWUDQVLHQWYDULDEOHZLWKDQRQQXOOYDOXH
IT AND STICK THAT STATE INTO INSTANCE VARIABLES THAT ARE
3ERIALIZABLE 4HEN DURING EJB!CTIVATE USE THE VALUES YOU DQRQWUDQVLHQWQRQ6HULDOL]DEOHYDULDEOH
WERE ABLE TO SAVE TO RECONSTRUCT THE NON
3ERIALIZABLE OBJECT ZLWKDQXOOYDOXH
SO THAT ITS IDENTICAL TO THE ONE YOU HAD BEFORE PASSIVATION
&OR EXAMPLE IMAGINE YOU HAVE A $OG BEAN WITH A #OLLAR DQRQWUDQVLHQWQRQ6HULDOL]DEOHYDULDEOH
VARIABLE AND THE #OLLAR ISNT 3ERIALIZABLE )N EJB0ASSIVATE ZLWKDQRQQXOOYDOXH
CALL GETTERS ON THE #OLLAR TO RETRIEVE THE VALUES THAT MATTER
LIKE GET#OLOR GET3IZE ETC 3AVE THOSE VALUES IN INSTANCE
VARIABLES IN THE BEAN THEN IN EJB!CTIVATE INSTANTIATE A NEW
#OLLAR AND USE THE #OLLAR ATTRIBUTES YOU SAVED AS ARGUMENTS
:HZHUHJRLQJIRUDSHUVRQDOEHVW 3% LQWKH
TO SETTERS ON THE NEW #OLLAR OBJECT QXPEHURIWLPHVLQZKLFKZHFRXOGXVHWKH
ZRUG¶QRQ·LQDVLQJOHVWDWHPHQW
\RXDUHKHUH
SDVVLYDWLRQDQGWUDQVDFWLRQV
,ZRXOGPDUU\WKLVPDQLIRQO\
KHZDVQRWVXFKDQLGLRWDERXW
VWDWHIXOVHVVLRQEHDQVFDODELOLW\
+HOHWVKLVVWDWHIXOEHDQVVWD\LQRSHQ
WUDQVDFWLRQV(YHQ%REP\ORVHUH[
ER\IULHQGNQRZVWKDWVHVVLRQEHDQV
LQDWUDQVDFWLRQFDQQHYHUEH
SDVVLYDWHG
:$51,1*
$VWDWHIXOVHVVLRQ
EHDQZLOO1(9(5EH
SDVVLYDWHGZKLOH
WKHEHDQLVVWLOOLQD
WUDQVDFWLRQ
,KDYHEHHQ
VLWWLQJKHUHOLNH
IRUHYHUZDLWLQJIRUWKLV
VWXSLGWUDQVDFWLRQWR
ÀQLVK
7KHVSHFOHWV\RXEHJLQDWUDQVDFWLRQLQRQHPHWKRGRIDVWDWHIXO
VHVVLRQEHDQEXWHQGWKHPHWKRGZLWKRXWHQGLQJWKHWUDQVDFWLRQ
7KLVLVDOPRVWDOZD\VDUHDOO\VWXSLGWKLQJWRGR)RUVWDUWHUV\RX
FRXOGQHYHUJXDUDQWHHWKDWMXVWEHFDXVHDFOLHQWFDOOVWKHPHWKRG
WKDWEHJLQVWKHWUDQVDFWLRQWKHFOLHQWZLOODWVRPHSRLQWFDOOWKH
PHWKRGWKDWHQGVWKHWUDQVDFWLRQ LQHLWKHUDFRPPLWRUUROOEDFN
%XWWKHPDLQUHDVRQLVWKDWWKHORQJHU\RXUWUDQVDFWLRQVWKHEHWWHU
\RXUFKDQFHVRIEULQJLQJ\RXUVHUYHUWRLWVNQHHV DQGWKDWKROGV
UHJDUGOHVVRIWKHEHDQW\SH )RUVWDWHIXOVHVVLRQEHDQVOHDYLQJD
WUDQVDFWLRQRSHQPHDQVWKHEHDQZLOOQRWEHSDVVLYDWHGQRPDWWHU
KRZORQJLW·VEHHQVLQFHWKHFOLHQWGLGDQ\WKLQJZLWKLW:H·OOORRNDW
WKLVPRUHLQWKHWUDQVDFWLRQVFKDSWHUEXWIRUQRZXQGHUVWDQGWKDW
VWDWHIXOEHDQVLQDWUDQVDFWLRQZRQ·WEHSDVVLYDWHG
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
*MIV\PQVO[aW]KIVLWQVMRJ)K\Q^I\MIVLMRJ8I[[Q^I\M
HME3DVVLYDWH HME$FWLYDWH
8VH\RXU6HVVLRQ&RQWH[WWR 8VH\RXU6HVVLRQ&RQWH[WWR
JHWDUHIHUHQFHWR\RXUKRPH JHWDUHIHUHQFHWR\RXUKRPH
JHWDUHIHUHQFHWR\RXU(-%REMHFW JHWDUHIHUHQFHWR\RXU(-%REMHFW
JHWVHFXULW\LQIRUPDWLRQDERXWWKHFOLHQW JHWVHFXULW\LQIRUPDWLRQDERXWWKHFOLHQW
IRUFHDWUDQVDFWLRQWRUROOEDFN &07 IRUFHDWUDQVDFWLRQWRUROOEDFN &07
EHDQV EHDQV
ILQGRXWLIWKHWUDQVDFWLRQKDVDOUHDG\ ILQGRXWLIWKHWUDQVDFWLRQKDVDOUHDG\
EHHQVHWWRUROOEDFN &07EHDQV EHHQVHWWRUROOEDFN &07EHDQV
JHWDWUDQVDFWLRQUHIHUHQFHDQGFDOO JHWDWUDQVDFWLRQUHIHUHQFHDQGFDOO
PHWKRGVRQLW %07EHDQV PHWKRGVRQLW %07EHDQV
$FFHVV $FFHVV
\RXUVSHFLDO-1',HQYLURQPHQW \RXUVSHFLDO-1',HQYLURQPHQW
DQRWKHUEHDQ·VPHWKRGV DQRWKHUEHDQ·VPHWKRGV
DUHVRXUFHPDQDJHU OLNHDGDWDEDVH DUHVRXUFHPDQDJHU OLNHDGDWDEDVH
\RXDUHKHUH
EHDQUHPRYDO
*MIV:MUW^IT"
_PMVJMIV[LQM
EHDQWKURZVV\VWHPH[FHSWLRQ
GRHVQRWH[LVW XQFKHFNHGXQFDXJKW
$VDVWDWHIXOEHDQ
,·PDSHUVRQDOVODYHWR
WKHFOLHQWDQGZKHQVKH·VGRQH
ZLWKPH,·PWRVVHGRXWOLNH
HME5HPRYH
VRPDQ\$2/GLVNV6RPHWLPHV
RUWLPHRXW
WKH\GRQ·WHYHQOHWPHVD\ WLPHRXW
JRRGE\H
PHWKRGUHDG\ SDVVLYDWHG
$VHVVLRQEHDQVWRSVH[LVWLQJIRU
RQHRIWKUHHUHDVRQV
WKHFOLHQWFDOOVUHPRYH
WKHEHDQWLPHVRXW
WKHEHDQWKURZVDV\VWHPH[FHSWLRQ
%XWWKHUH·VDQRWKHUTXHVWLRQWRDVN ZKHQWKHEHDQWLPHV
RXWZDVLWDFWLYHRUSDVVLYH",IWKHEHDQLVDFWLYHWKH
&RQWDLQHUGHDOVZLWKLWLQWKHVDPHZD\LWGHDOVZLWKFOLHQW
UHPRYH FDOOV³WKHEHDQJHWVDQHME5HPRYH FDOODQGLV
WKHQNLOOHG%XWLIWKHEHDQZDVSDVVLYDWHGZKHQLWWLPHVRXW
WKH&RQWDLQHUVHQGVLWVWUDLJKWWRWKHGRHVQRWH[LVWVWDWH
ZLWKRXWFDOOLQJHME5HPRYH
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
/LIHF\FOHRYHUYLHZ UHPRYLQJDVWDWHIXOEHDQ
&OLHQWFDOOVUHPRYH RQDQDFWLYH LHQRQSDVVLYDWHG EHDQ
&OLHQWFDOOVUHPRYHRQWKH
FRPSRQHQWLQWHUIDFH RUFDOOV
WKHUHPRYH PHWKRGLQWKHKRPH
LQWHUIDFHWKDWWDNHVD+DQGOH
EHDQ
UHPRYH (-%
UHPRYH REMHFW
FOLHQW
VWXE
&RQWDLQHUFDOOVHME5HPRYH
RQWKHEHDQ
EHDQ
(-%
REMHFW YH
FOLHQW
VWXE E5HPR
HM
&RQWDLQHU´NLOOVµWKHEHDQDQG(-%
REMHFW DVVXPHWKH\·UHQRZHOLJLEOH
IRUJDUEDJHFROOHFWLRQ 7KHFOLHQW
ZLOOJHWDQH[FHSWLRQLIVKHWULHVWR
XVHWKHVWXEDJDLQ
FOLHQW
PLJKWVWLOOEHKHU
HEXW
ZLOOQRORQJHUZRU
N
\RXDUHKHUH
EHDQUHPRYDO
/LIHF\FOHRYHUYLHZ UHPRYLQJDVWDWHIXOEHDQ
%HDQWLPHVRXWZKLOHDFWLYH
&OLHQWGRHVQ·WPDNHDQ\FDOOVWRWKH
EHDQ·VFRPSRQHQWLQWHUIDFHIRUD
ORQJWLPH ZKDWHYHUWKH&RQWDLQHU
FRQVLGHUVD´ORQJµWLPH
EHDQ
(-%
REMHFW
FOLHQW
VWXE
1RDFWLYLW\
&RQWDLQHUGHFLGHVWRNLOOWKH
EHDQDQGFDOOVHME5HPRYH
RQWKHEHDQ
EHDQ
(-%
FOLHQW
REMHFW
HPRYH
VWXE 5
HME
&RQWDLQHU´NLOOVµWKHEHDQDQG(-%
REMHFW DVVXPHWKH\·UHQRZHOLJLEOH
IRUJDUEDJHFROOHFWLRQ 7KHFOLHQW
ZLOOJHWDQH[FHSWLRQLIVKHWULHVWR
XVHWKHVWXEDJDLQ
FOLHQW
PLJKWVWLOOEHKHU
HEXW
ZLOOQRORQJHUZRU
N
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
/LIHF\FOHRYHUYLHZ UHPRYLQJDVWDWHIXOEHDQ
%HDQWLPHVRXWZKLOHSDVVLYDWHG
7KHFOLHQWGRHVQ·WFDOODQ\PHWKRGV
RQWKHEHDQ·VFRPSRQHQWLQWHUIDFH
IRUDORQJWLPH$)7(5WKHEHDQKDV ===
===
DOUHDG\EHHQSDVVLYDWHG
EHDQ
(-%
REMHFW
FOLHQW
VWXE
1RDFWLYLW\
&RQWDLQHUGHFLGHVWRNLOOWKHEHDQ
EXWGRHV127FDOOHME5HPRYH
===
===
EHDQ
(-%
RJF
REMHFW
FOLHQW GW
VWXE
VHQ
HYHU
WK HEHDQQ
<,.( 6 YH FDOO
WVDQ HME5HPR
JH
&RQWDLQHU´NLOOVµWKHEHDQDQG(-%
REMHFW DVVXPHWKH\·UHQRZHOLJLEOH
IRUJDUEDJHFROOHFWLRQ 7KHFOLHQW
ZLOOJHWDQH[FHSWLRQLIVKHWULHVWR
XVHWKHVWXEDJDLQ
FOLHQW
PLJKWVWLOOEHKHU
HEXW
ZLOOQRORQJHUZRU
N
\RXDUHKHUH
EHDQUHPRYDO
/LIHF\FOHRYHUYLHZ UHPRYLQJDVWDWHIXOEHDQ
%HDQWKURZVDV\VWHPH[FHSWLRQ
7KHEHDQWKURZVDV\VWHP
XQFKHFNHG H[FHSWLRQZKLOH ([FHSWLRQ
H[HFXWLQJDPHWKRG
(-% EHDQ
REMHFW
FOLHQW
VWXE
&RQWDLQHUGHFLGHVWRNLOOWKHEHDQ
EXWGRHV127FDOOHME5HPRYH
(-% EHDQ
RJF
REMHFW
FOLHQW GW
VWXE
VHQ
&RQWDLQHU´NLOOVµWKHEHDQDQG(-%
REMHFW DVVXPHWKH\·UHQRZHOLJLEOH
IRUJDUEDJHFROOHFWLRQ 7KHFOLHQW
ZLOOJHWDQH[FHSWLRQLIVKHWULHVWR
XVHWKHVWXEDJDLQ
FOLHQW
PLJKWVWLOOEHKHU
HEXW
ZLOOQRORQJHUZRU
N
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
+WUXTIQV\[IJW]\JMIVZMUW^IT
:K\ZRXOG\RX
JHWULGRIP\EHDQ
ZLWKRXWZDLWLQJIRUPH
WRFDOOUHPRYH "7KDW
LVVRUXGH +RZDP,VXSSRVHGWR
NQRZ\RX·UHFRPLQJEDFN",I,
GRQ·WXVHWLPHRXWVEHIRUHORQJ,·OOEH
)8//RIUXVW\ROGDEDQGRQHGVKRSSLQJ
FDUWV6RRQHURUODWHU,KDYHWR
DVVXPHWKDW\RX·UHQHYHUFRPLQJ
EDFN6RUU\EXW,UHDOO\
KDYHQRFKRLFH
,GRQ·WVHHZK\ \RX )LUVWRIDOO\RXKRQHVWO\H[SHFWPHWREULQJ
FDQ·WFDOOHME5HPRYH DEHDQ287RISDVVLYDWLRQMXVWWRNLOOLW"7DON
DERXWDZDVWHRIRYHUKHDG6KHHVK\RXVKRXOG
RQDEHDQZKHQ\RX·UHJRLQJWR
NQRZEHWWHULI\RXFDUHDERXWSHUIRUPDQFH$QG
NLOOLWUHJDUGOHVVRIWKHUHDVRQ
LW·VQRWWKDWELJRIDGHDOMXVWSXW\RXUFOHDQXSFRGHLQ
:KDWJRRGLVHME5HPRYH IRU
ERWKHME5HPRYH $1'HME3DVVLYDWH DQG\RX·UHVDIH
SXWWLQJLQFOHDQXSFRGHLILW $QGZLWKH[FHSWLRQVWKLQNDERXWLWGR\RXUHDOO\ZDQW
PLJKWQRWEHFDOOHG" WRUXQ\RXUFOHDQXSFRGHRQDEHDQZKRVHVWDWHFRXOG
EHVHULRXVO\FRUUXSWDWWKLVSRLQW",IDEHDQWKURZV
DV\VWHPH[FHSWLRQ,·PMXVWJRQQDORJLWDQG
SXWLWRXWRILWVPLVHU\
\RXDUHKHUH
LPSOHPHQWLQJHME5HPRYH
,PSOHPHQWLQJHME5HPRYH
HME5HPRYH
5HOHDVHDQ\UHVRXUFHVRUGRZKDWHYHUFOHDQXS\RXQHHGWRGREH
IRUHWKHEHDQGLHVIRUHYHU0XFKRIWKHWLPH\RXUHME5HPRYH PHWKRG
ZLOOEHHPSW\EHFDXVHLI\RXUEHDQGRHVXVHUHVRXUFHVLWPRVWOLNHO\ZLOO
DFTXLUHDQGUHOHDVHWKHUHVRXUFHVLQHDFKEXVLQHVVPHWKRG%XWLI\RXU
GHVLJQGRHVFDOOIRUNHHSLQJUHVRXUFHVRSHQWKURXJKRXWWKHEHDQ·VOLIH
WKHQ\RXQHHGWRIUHHWKHPXSKHUH
SXEOLFYRLGHME5HPRYH ^
ces
WU\^
to g r a ce ful ly close resour
P\5HVRXUFHFORVH if you wantill open, do it here !
`FDWFK ([FHSWLRQH[ ^` that are st
`
DQDOWHUQDWLYH
&DOODFOHDQ8S PHWKRGIURPERWKHME3DVVLYDWH DQGHME5HPRYH
*LYHQWKDW\RXUEHDQFRXOGEHUHPRYHGZLWKRXWDQHME5HPRYH FDOOLILW
WLPHVRXWZKLOHSDVVLYDWHG\RXVKRXOGKDYHERWK\RXUHME3DVVLYDWH DQG
HME5HPRYH PHWKRGVSHUIRUPWKHVDPHFOHDQXS6LQFHVFDUFHV\VWHP
UHVRXUFHVDUHVHOGRP6HULDOL]DEOHDQ\ZD\\RX·UHSUREDEO\DOUHDG\WDNLQJ
FDUHRIWKHPLQHME3DVVLYDWH
SXEOLFYRLGHME5HPRYH ^
WKLVFOHDQ8S
` now both ejbRemov )
do the same thing, e(so
and ejbPassivate() will
SXEOLFYRLGHME3DVVLYDWH ^ ev
while passivated, you do en if you time out
WKLVFOHDQ8S nÕt have to worry.
`
SULYDWHYRLGFOHDQ8S ^
WU\^
P\5HVRXUFHFORVH
`FDWFK ([FHSWLRQH[ ^`
`
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
0LVVHGHME5HPRYH FDOOV
:DLWDPLQXWHWKHUH·V
VWLOOVRPHWKLQJZURQJKHUH
:KDWKDSSHQVLIWKHEHDQWKURZV :HOOXP\HV<HV\RXFRXOGVWLOO
DQH[FHSWLRQ"7KHQ,VWLOOZRQ·W EHLQWURXEOHLQWKDWFDVH%XWWKLVLVUHDOO\<285
UHVSRQVLELOLW\WRGHDOZLWK/HW·VVD\\RXWHPSRUDULO\
JHWP\FOHDQXSFRGHWRUXQ
VDYHVRPHRQH·VVKRSSLQJLQIRWRDGDWDEDVHVRWKDWLI
:RQ·W,VWLOOJHWLQWRWURXEOH"
WKHVHUYHUFUDVKHVZKLOHWKHSHUVRQ·VVKRSSLQJ\RXKDYHD
PHDQVRIVWLOOUHFRYHULQJWKHLUFDUW XQWLOWKHEHDQWLPHVRXW ,Q
HME5HPRYH \RX·GGHOHWHWKHURZLQWKHGDWDEDVHIRUWKLVFOLHQW
%XWVLQFH\RXPLJKWQRWJHWWKDWHME5HPRYH FDOOVRRQHURU
ODWHU\RX·UHJRQQDQHHGVRPHZD\WRJRWKURXJKDQGGRSHULRGLF
FOHDQXSVRQWKDWGDWD7KHUH·VQRWKLQJLQWKHVSHFWKDWFDQ
KHOS\RXKHUH,W·VXSWR<28WRGHDOZLWKWKHSRWHQWLDO
FRQVHTXHQFHVRIPLVVHGHME5HPRYH FDOOV
<RXPXVWEHDEOHWR
UHFRJQL]HVFHQDULRVL
Q
:DWFKLW ZKLFKHME5HPRYH ZLOO
EHPLVVHG
QRZWKDWWKHUHDUH
7KHH[DPH[SHFWV\RXWRN
ZKLFKDEHDQZLOO
WKUHHFLUFXPVWDQFHVXQGHU
DOO
127JHWDQHME5HPRYH F
6HUYHUFUDVKHV
VLYDWHG
%HDQWLPHVRXWZKLOHSDV
VWH PH[FH SWLRQ
%HDQWKURZVDV\
XUFOHDQXSFRGH
,IDQ\RIWKHVHKDSSHQ\R
OORZ WKH VXJJHVWLRQVRQ
ZLOOQRWUXQ,I\RXIR
FOHDQXSFRGHLQ
WKHSUHYLRXVSDJHDQGSXW
ME5 HPRYH WKHQ
ERWKHME3DVVLYDWH DQGH
.IR USUREO HP WLPHRXW
\RX¶UHSUREDEO\2
OOVWLOOKDYHWRGHDO
ZKLOHSDVVLYDWHG EXW\RX¶
DQ V\VWHPH[FHSWLRQ
ZLWKDVHUYHUFUDVKRUEH
REYLRXVTXHVWLRQ
$QGGRQ¶WH[SHFWDVLPSOH
QH ME5HPRYH LI
OLNH³:LOODEHDQPLVVD
WLRQLVWKUR ZQ "´<RXPLJKW
DV\VWHPH[FHS
VFHQDULRIRU
KDYHWRFRQVLGHUDGHVLJQ
XWLIWK HUHFRXOGEHD
H[DPSOHDQG¿JXUHR
RQ\RX UNQ RZ OHGJHRIPLVVHG
SUREOHPEDVHG
HME5HPRYH PHWKRGFDOOV
\RXDUHKHUH
HME5HPRYH EHDQWKLQJV
*MIV\PQVO[aW]KIVLWQVMRJ:MUW^M
8VH\RXU6HVVLRQ&RQWH[WWR
JHWDUHIHUHQFHWR\RXUKRPH 7KHEHDQWKLQJV\RXFDQ
JHWDUHIHUHQFHWR\RXU(-%REMHFW GRLQHME5HPRYH DUH
JHWVHFXULW\LQIRUPDWLRQDERXWWKHFOLHQW H[DFWO\WKHVDPHDVWKH
IRUFHDWUDQVDFWLRQWRUROOEDFN &07 EHDQWKLQJV\RXFDQGRLQ
EHDQV
HME&UHDWH
ILQGRXWLIWKHWUDQVDFWLRQKDVDOUHDG\
EHHQVHWWRUROOEDFN &07EHDQV HME3DVVLYDWH
JHWDWUDQVDFWLRQUHIHUHQFHDQGFDOO
PHWKRGVRQLW %07EHDQV
HME$FWLYDWH
$FFHVV
\RXUVSHFLDO-1',HQYLURQPHQW
DQRWKHUEHDQ·VPHWKRGV
DUHVRXUFHPDQDJHU OLNHDGDWDEDVH
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
1UXTMUMV\QVO\PM)L^QKM*MIVI[I[\I\M.=4JMIV
3O FAR THE !DVICE"EAN WEVE WRITTEN HASNT <PQVO[aW]KIVILLQN\PMJMIVQ[[\I\M.=4
NEEDED TO BE STATEFUL )T DOESNT KEEP OR USE
ANY CLIENT SPECIlC STATE SO IT DOESNT NEED A
CREATE METHOD WITH ARGUMENTS "UT WHAT IF <RXFDQKDYHPRUHWKDQRQHFUHDWHPHWKRG
WE DID WANT TO MAKE IT A STATEFUL BEAN 7HAT IF
THE BUSINESS LOGIC NEEDED TO SAY KEEP A RECORD
OF THE CONVERSATION ITS HAVING SO THAT IT NEVER 7KHFUHDWHPHWKRGFDQKDYHDUJXPHQWV
GIVES OUT THE SAME ADVICE MORE THAN ONCE IN A
SESSION %VEN IF THE CHOICE OF AN ADVICE STRING IS
PURELY RANDOM IF YOU WANT TO ENSURE THE ADVICE 7KHEHDQFDQEHSDVVLYDWHGVR\RX
ISNT REPEATED DURING A SESSION YOULL HAVE TO FDQZULWHFRGHLQHME3DVVLYDWH DQG
KEEP TRACK OF IT IN AN INSTANCE VARIABLE HME$FWLYDWH
!ND YOU MIGHT HAVE OTHER CHANGES TOO LIKE
MAKING THE CREATE METHODS TAKE ARGUMENTS THAT
WKHUH DUH QR
CONTAIN THE TYPE OF ADVICE THE CLIENT IS LOOKING
FOR OR SOME OTHER KIND OF PREFERENCE )N THAT
'XPE 4XHVWLRQV
CASE EACH TIME THE CLIENT MADE A METHOD CALL
YOUD WANT TO CHECK THE STATUS OF THAT CLIENT Q: 7HAT HAPPENS IF YOU PUT CODE IN EJB0ASSIVATE OR
SUPPLIED CREATION INITIALIZATION PREFERENCE EJB!CTIVATE AND THE BEAN IS STATE,%33 7ILL IT COMPILE
AND TAILOR YOUR ADVICE BASED ON THE VALUE SET 7ILL IT DEPLOY
DURING THE BEANS EJB#REATE ,ATER IN THE
BOOK WELL LOOK AT A MORE ELABORATE VERSION OF
THIS !DVICE"EAN BUT FOR NOW WELL MAKE JUST A
A: 9OU CAN CERTAINLY PUT CODE IN EJB!CTIVATE OR
EJB0ASSIVATE REGARDLESS OF WHETHER THE BEAN IS STATELESS
SUBTLE CHANGE TO MAKE THE BEAN STATEFUL OR STATEFUL EVEN THOUGH IT WILL NEVER BE CALLED IF THE BEAN
IS STATELESS
4HINK ABOUT IT ,OOK AT THE 3ESSION"EAN INTERFACE .OTICE
THAT THERE ISNT A SEPARATE 3TATEFUL3ESSION"EAN INTERFACE
YiX`e AND 3TATELESS3ESSION"EAN INTERFACE 4HERES JUST 3ESSION
"EAN AND BOTH STATELESS AND STATEFUL BEANS IMPLEMENT IT
gfn\i 3O THERES NOTHING IN YOUR CLASS THAT SPECIFICALLY SAYS YOUR
BEAN IS STATELESS )TS ONLY AT DEPLOY TIME WHEN YOU TELL
<RXNQRZWKDWWKHEHDQFODVVLVJRLQJWR THE DEPLOYMENT DESCRIPTOR THAT THE BEAN IS STATELESS OR
FKDQJHEXWZKDWDERXWWKHFOLHQWDQGWKH STATEFUL THAT IT ACTUALLY MATTERS
WZRLQWHUIDFHV"'RRQHRUPRUHRIWKRVH )N FACT YOU COULD WRITE A BEAN THAT HAS ONLY A NO ARG CRE
KDYHWRFKDQJH"5HDOO\WKLQNWKURXJKWKH ATE AND KEEPS NO CLIENT STATE AND YOU CAN DEPLOY IT WITH
LPSOLFDWLRQVEHIRUH\RXWXUQWKHSDJH EITHER SETTINGSTATELESS OR STATEFULAND IT WILL WORK AS
LONG AS YOUVE TAKEN CARE OF PASSIVATION AND ACTIVATION
\RXDUHKHUH
VWDWHIXOVHVVLRQEHDQFRGH
)L^QKM;\I\MN]T*MIVKWLM
SDFNDJHKHDG¿UVW
LPSRUWMDYD[HME
SXEOLFFODVV$GYLFH6WDWHIXO%HDQLPSOHPHQWV6HVVLRQ%HDQ^
SULYDWH6HVVLRQ&RQWH[WFRQWH[W ent SessionBean
We still implem
SULYDWH6WULQJXVHU1DPH
This time, we can keep client-speciÞc
state (in this case, the argument the
client sends to the create method)
SXEOLFYRLGHME$FWLYDWH ^ of the four SessionBean ta
`
thing weÕre doing is savingcon
th e
iner callbacks, the only
con
this version of the class weÕre text, even though in
the context because we want not using it. WeÕre saving
SXEOLFYRLGHME3DVVLYDWH ^
`
your context, because in most YOU to get used to saving
SXEOLFYRLGHME5HPRYH ^ gonna want to use it later. (L real-world beans youÕre
` examples of using the context)ater in the book, youÕll see
SXEOLFYRLGVHW6HVVLRQ&RQWH[W 6HVVLRQ&RQWH[WFW[ ^
FRQWH[W FW[
`
se
L Y a st at eF UL bean, becau
This can be OnÕNs must NOT have anything
SXEOLFYRLGHME&UHDWH 6WULQJQDPH ^
XVHU1DPH QDPH stateless bea -arg create() method.
` except the no
SXEOLF6WULQJJHW$GYLFH ^
UHWXUQXVHU1DPH³P\DGYLFHLV ³$GYLVRUJHW$GYLFH
`
static helper
In the busi assume this is claass, Advisor,
speciÞc stantess method, weÕre usi
`
method on a Õt see here. WeÕll
parameter. e, that we saved fr ng the client- that you done that one.
stateless be This must be a stat om the create let you writ
ans arenÕt t ef
ied to a sinul bean, because
gle client.
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
)L^QKM;\I\MN]T*MIV+41-6<KWLM
4HE STATEFUL VERSION OF THE CLIENT ADDS TWO THINGS NOT IN THE STATELESS VERSION
7ERE PASSING AN ARGUMENT TO THE CREATE METHOD
! STATEFUL BEAN CAN AND OFTEN DOES HAVE ARGUMENTS TO CREATE METHODS SO THAT
THE CLIENT CAN PASS IN CLIENT
SPECIl C STATE FOR THE BEAN TO SAVE AND USE IN LATER
hCONVERSATIONSv WITH THE CLIENT IE LATER METHOD CALLS FROM THAT CLIENT
7ERE CALLING REMOVE ON THE COMPONENT INTERFACE
)TS POLITE FOR THE CLIENT TO TELL THE #ONTAINER THAT SHES DONE WITH A STATEFUL SESSION
BEAN !ND NOW YOU KNOW WHY 7ITHOUT THE REMOVE CALL THE #ONTAINER WILL HOLD ON
TO THE BEAN WASTEFULLY UNTIL THE BEAN TIMES OUT 3O IN THIS CASE hPOLITEv REALLY MEANS
hIMPROVES SCALABILITYv
LPSRUWMDYD[QDPLQJ
LPSRUWMDYD[UPL
LPSRUWKHDG¿UVW
<RXPXVWEHDEOHWR
UHFRJQL]HZKHWKHU
LPSRUWMDYD[HME
WKHFOLHQWLVIRUD
VWDWHIXOEHDQ
SXEOLFFODVV$GYLFH6WDWHIXO&OLHQW^ WFOLHQWFRGH
<RXPXVWEHDEOHWRORRND
KHW KHU WKHFOLHQW¶V
OLNHWKLVDQGNQRZZ
SXEOLFVWDWLFYRLGPDLQ 6WULQJ>@DUJV ^ WHIX O,IWKH FOLH QWF DOOVD
EHDQLVVWD
QHZ$GYLFH6WDWHIXO&OLHQW JR ZD \WRNQRZ
QRDUJFUHDWH WKHUH¶VQR
` WHOH VV EX WDW OHD VW\RX
ZKHWKHULW,6VWD
*+ 7E H, IWK HF UHD WHK DV
NQRZLW0,
SXEOLFYRLGJR ^ DQ FUH DWH
DUJVRUDQDPHRWKHUWK
WU\^ XQW \R XN QRZ WKH
OLNHFUHDWH$FFR
&RQWH[WLF QHZ,QLWLDO&RQWH[W XVWEH VWD WHIX O
EHDQP
2EMHFWR LFORRNXS ³6WDWHIXO$GYLVRU´
$GYLFH6WDWHIXO+RPHKRPH $GYLFH6WDWHIXO+RPH 3RUWDEOH5HPRWH2EMHFWQDUURZ R
$GYLFH6WDWHIXO+RPHFODVV
$GYLFH6WDWHIXODGYLVRU KRPHFUHDWH ³FORYHU´ because bean,
T h is m ust be a statefwulith arguments!
eate
weÕre calling cr
6\VWHPRXWSULQWOQ DGYLVRUJHW$GYLFH
DGYLVRUUHPRYH weÕre calling remove(), to tell the tain
`FDWFK ([FHSWLRQH[ ^ done with the bean (so the ContainCon er weÕre
er can kill it).
H[SULQW6WDFN7UDFH
`
` this is a poor way to handle exceptions! You would probably write
` a real-world client to catch the different kinds of exceptions
that matter... NamingException, CreateException, etc.
\RXDUHKHUH
VHVVLRQEHDQV
6KDUSHQ \RXU SHQFLO
'RWKHLQWHUIDFHVKDYHWRFKDQJHZKHQLWJRHVIURP
VWDWHOHVVWRVWDWHIXO"
/RRNDWWKHWZRLQWHUIDFHVEHORZIRUWKHVWDWHOHVVYHUVLRQ
RIWKH$GYLFHEHDQ,IQHHGHGPDNHDQ\DGMXVWPHQWVWR
WKHFRGHLQHLWKHURUERWKRIWKHLQWHUIDFHVIRUZKDW LIDQ\
WKLQJ QHHGVWRFKDQJHWRPDNHWKLVZRUNZLWKWKHUHYLVHG
VWDWHIXOYHUVLRQRIWKHEHDQ
SDFNDJHKHDG¿UVW
LPSRUWMDYD[HME
LPSRUWMDYDUPL5HPRWH([FHSWLRQ
SXEOLFLQWHUIDFH$GYLFH+RPHH[WHQGV(-%+RPH^
SXEOLF$GYLFHFUHDWH WKURZV&UHDWH([FHSWLRQ5HPRWH([FHSWLRQ
`
SDFNDJHKHDG¿UVW
LPSRUWMDYD[HME
LPSRUWMDYDUPL5HPRWH([FHSWLRQ
SXEOLFLQWHUIDFH$GYLFHH[WHQGV(-%2EMHFW^
SXEOLF6WULQJJHW$GYLFH WKURZV5HPRWH([FHSWLRQ
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
:MDD=LHGAFLK
&RQWDLQHUFDOOEDFNVLQGLFDWHNH\PLOHVWRQHVLQDEHDQ·V
,MXTWaQVOI[\I\MN]TJMIV OLIH
4HE ONLY DIFFERENCE BETWEEN DEPLOYING THE STATEFUL
$VD%HDQ3URYLGHU\RX·UHUHVSRQVLEOHIRULPSOHPHQW
LQJWKHFRQWDLQHUFDOOEDFNVLQ\RXUEHDQFODVV
!DVICE BEAN AND THE STATELESS VERSION BESIDES THE
lLE NAMES AND *.$) NAME IS IN THE DEPLOYMENT &RQWDLQHUFDOOEDFNVFRPHIURPWZRSODFHV WKH
DESCRIPTOR SETTING THAT DElNES WHETHER THE BEAN 6HVVLRQ%HDQLQWHUIDFHDQGWKHKRPHLQWHUIDFH7KH
IS STATELESS OR STATEFUL 5SING THE 2) DEPLOYTOOL FRPSLOHUIRUFHV\RXWRLPSOHPHQWWKH6HVVLRQ%HDQ
REMEMBER YOU SET THIS USING THE DEPLOYTOOLS .EW LQWHUIDFHEXWWKHFDOOEDFNVUHODWHGWRWKHKRPHDUH\RXU
%NTERPRISE "EAN 7IZARDTHE THING THAT WALKS YOU UHVSRQVLELOLW\DQGWKHFRPSLOHUZRQ·WNQRZVLQFH\RXU
THROUGH THE SETTINGS THAT IT THEN USES TO OUTPUT THE EHDQFODVVGRHVQ·WLPSOHPHQW\RXUKRPHLQWHUIDFH
8-, DEPLOYMENT DESCRIPTOR
$VWDWHIXOVHVVLRQEHDQFDQEHLQRQHRIWKUHHVWDWHV
GRHVQRWH[LVW \HVWKDW·VDVWDWH PHWKRGUHDG\DQG
SDVVLYDWHG
:KHQDEHDQWUDQVLWLRQVIURPGRHVQRWH[LVWWRPHWKRG
UHDG\LWVFRQVWUXFWRULVFDOOHGIROORZHGE\VHW6HVVLRQ
&RQWH[W DQGILQDOO\WKHEHDQ·VHME&UHDWH
$EHDQLQVWDQFHKDVVSHFLILF%HDQ7KLQJVWKDWLWFDQ
GREXWQRQHDUHDYDLODEOHGXULQJWKHEHDQ·VFRQVWUXF
WRUEHFDXVHDWWKDWSRLQWLWLVDQREMHFWEXWQRW\HWDIXOO
EHDQ,WGRHVQ·W\HWKDYHLWVEHDQQHVV
6RPHRIWKH%HDQ7KLQJVDEHDQFDQGRLQFOXGH JHWD
UHIHUHQFHWRLWVKRPHRU(-%REMHFWOHDUQRUDIIHFWWKH
VWDWXVRIWKHWUDQVDFWLRQJHWVHFXULW\LQIRUPDWLRQDERXW
WKHFOLHQWDQGDFFHVVDUHVRXUFHVXFKDVDGDWDEDVH
:KHQDVWDWHIXOEHDQLVSDVVLYDWHGLW·VSXWLQWRVHFRQG
DU\VWRUDJHSRVVLEO\WKURXJKVHULDOL]DWLRQ<RXPXVW
EHVXUHE\WKHHQGRI\RXUHME3DVVLYDWH PHWKRGWKDW
YouÕll have to change this to State
ful !! \RXULQVWDQFHYDULDEOHVDUHUHDG\IRUSDVVLYDWLRQ
7KH&RQWDLQHUFDOOVHME5HPRYH RQDEHDQZKHQWKH
FOLHQWFDOOVUHPRYH IRUDVWDWHIXOEHDQRUZKHQWKH
&RQWDLQHUZDQWVWRUHGXFHWKHVL]HRIWKHSRROIRU
VWDWHOHVVEHDQV,IDSDVVLYDWHGEHDQWLPHVRXWWKH
&RQWDLQHUZLOONLOOWKHEHDQZLWKRXWLQYRNLQJHME5H
PRYH
$EHDQFDQDOVRPLVVDQHME5HPRYH FDOOLIWKHUH·VD
FRQWDLQHUFUDVKRUWKHEHDQWKURZVDUXQWLPHH[FHSWLRQ
\RXDUHKHUH
VWDWHIXOYVVWDWHOHVV
+WUXIZML\W[\I\MN]TJMIV[[\I\MTM[[JMIV[
PI^MI[QUXTMTQNM
3TATELESS BEANS HAVE A MUCH SIMPLER EXISTENCE 4HEYRE BORN CREATED
THEYRE THROWN INTO A POOL WITH OTHERS OF THEIR KIND THEY RUN BUSINESS
METHODS FOR ANY CLIENT WHO ASKS AND THEY MIGHT EVENTUALLY DIE 4HEY ARENT
PASSIVATED THEY DONT KEEP CLIENT
SPECIlC STATE AND THEIR CREATION AND
DESTRUCTION REMOVAL ARENT TIED TO THE WHIMS OF THE CLIENT #OMPARE THE
DIFFERENCE BETWEEN THE LIFECYCLE OF A STATEFUL VS STATELESS BEAN
7KHEHDQOLIHF\FOH VSHFLDOPRPHQWVLQDEHDQ·VOLIH
6WDWHIXOVHVVLRQEHDQV
%HDQFUHDWLRQ ZKHQWKHFOLHQWZDQWVDEHDQ
%HDQXVH ZKHQWKHFOLHQWFDOOVDEXVLQHVVPHWKRG
%HDQSDVVLYDWLRQ WKHEHDQLVSXWWRVOHHSWRFRQVHUYH
UHVRXUFHV
%HDQDFWLYDWLRQ WKHEHDQZDNHVXSWRVHUYLFHDEXVLQHVV
PHWKRGIURPWKHFOLHQW
%HDQUHPRYDO ZKHQWKHFOLHQWLVILQLVKHGZLWKWKHEHDQRU
WKHEHDQWLPHVRXW
6WDWHOHVVVHVVLRQEHDQV
%HDQFUHDWLRQ ZKHQWKHFRQWDLQHUZDQWVWRPDNHDEHDQ
%HDQXVH ZKHQWKHFOLHQWFDOOVDEXVLQHVVPHWKRG
%HDQUHPRYDO ZKHQWKHFRQWDLQHUGHFLGHVWKHUHDUH
WRRPDQ\EHDQVLQWKHSRRORUWKHEHDQWKURZVDV\VWHP
H[FHSWLRQ
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
&RPSDULQJWKHOLIHF\FOHVRIVWDWHIXO
DQGVWDWHOHVVVHVVLRQEHDQV
6WDWHIXO
EHDQWKURZVV\VWHPH[FHSWLRQ
GRHVQRWH[LVW XQFKHFNHGXQFDXJKW
FRQVWUXFWRU
VHW6HVVLRQ&RQWH[W
HME5HPRYH ===
HME&UHDWH
RUWLPHRXW ===
WLPHRXW
HME3DVVLYDWH
PHWKRGUHDG\ SDVVLYDWHG
PHWKRGFDOOV HME$FWLYDWH
6WDWHOHVV
EHDQWKURZVV\VWHPH[FHSWLRQ
GRHVQRWH[LVW XQFKHFNHGXQFDXJKW
FRQVWUXFWRU
VHW6HVVLRQ&RQWH[W
HME5HPRYH
HME&UHDWH
PHWKRGUHDG\
PHWKRGFDOOV
\RXDUHKHUH
VWDWHOHVVEHDQV
&OLHQWFDOOVFUHDWHRQDVWDWHOHVVVHVVLRQEHDQKRPH
&OLHQWFDOOVFUHDWHRQWKHKRPH
FOLHQW
+RPH
VWXE REMHFW
FUHDWH
FUHDWH
&RQWDLQHUPDNHVWKH(-%REMHFW
(-%
REMHFW
&RQWDLQHUVHQGVWKHFOLHQWDVWXE
WRWKH(-%REMHFW
See whatÕs
missing?
No bean !! N
o context !
VWXE
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
6HVVLRQEHDQFUHDWLRQLVQRW
UHODWHGWRWKHFOLHQW
&RQWDLQHUFRQVWUXFWVWKH
6HVVLRQ&RQWH[WREMHFWDQG
WKHEHDQLQVWDQFHWKHQFDOOV
VHW6HVVLRQ&RQWH[W RQWKHEHDQ
EHDQ
&RQWH[W
[W
WH
RQ
Q&
VLR
HV
W6
VH
&RQWDLQHUSXWVWKHEHDQ ZKLFKLV
QRZOLQNHGWRLWVRZQFRQWH[W LQ
WKHSRROIRUWKDWEHDQW\SH
&RQWH[W
EHDQ
%HDQ3RRO
\RXDUHKHUH
EXVLQHVVPHWKRGV
%XVLQHVVPHWKRGFDOO
&OLHQWLQYRNHVDEXVLQHVVPHWKRG
RQKHUSUHYLRXVO\DFTXLUHG(-%
REMHFWVWXE JR
(-%
REMHFW
JR
VWXE
FOLHQW
%HDQ3RRO
&RQWDLQHUSXOOVDEHDQRXWRIWKH
SRRODQGOLQNVLWZLWKWKHFOLHQW·V
(-%REMHFW
(-%
REMHFW
&RQWH[W
EHDQ
%HDQ3RRO
&RQWDLQHULQYRNHVEXVLQHVVPHWKRG
RQWKHEHDQ WKHEHDQUHWXUQV
IURPWKHPHWKRG WKHQ&RQWDLQHU
VHQGVEHDQEDFNWRWKHSRRO
JR
EHDQ
%HDQ3RRO
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
2EMHFW,QWHUDFWLRQ'LDJUDP 2,' IRUEHDQFUHDWLRQ
VWDWHOHVVVHVVLRQEHDQ
:KHQWKHFOLHQWFDOOVFUHDWH
FOLHQW
+RPH (-% 6HVVLRQ
REMHFW REMHFW &RQWH[W
EHDQ
FUHDWH
QHZ
DQGDWDFRPSOHWHO\GLIIHUHQWXQUHODWHGWLPH
QHZ
QHZ EHDQFRQVWUXFWRUUXQV
VHW6HVVLRQ&RQWH[W
HME&UHDWH
7KHFOLHQWFDQFDOO
FUHDWHDOOGD\ORQJEXW
,ZLOO127WLHDEHDQWRWKH
FOLHQW·V(-%REMHFWXQWLOWKH
FOLHQWJHWVVHULRXVDQGFDOOVD
EXVLQHVVPHWKRG
\RXDUHKHUH
VHVVLRQEHDQWKLQJV
*MIV\PQVO[aW]KIVLWNZWU[\I\MTM[[JMIVUM\PWL[
FRQVWUXFWRU VHW6HVVLRQ&RQWH[W EXVLQHVVPHWKRG
8VH\RXU6HVVLRQ&RQWH[WWR 8VH\RXU6HVVLRQ&RQWH[WWR
QRWKLQJ
JHWDUHIHUHQFHWR\RXUKRPH JHWDUHIHUHQFHWR\RXUKRPH
JHWDUHIHUHQFHWR\RXU(-%REMHFW JHWDUHIHUHQFHWR\RXU(-%REMHFW
JHWVHFXULW\LQIRUPDWLRQDERXWWKHFOLHQW JHWVHFXULW\LQIRUPDWLRQDERXWWKHFOLHQW
IRUFHDWUDQVDFWLRQWRUROOEDFN &07 IRUFHDWUDQVDFWLRQWRUROOEDFN &07
EHDQV EHDQV
ILQGRXWLIWKHWUDQVDFWLRQKDVDOUHDG\ ILQGRXWLIWKHWUDQVDFWLRQKDVDOUHDG\
EHHQVHWWRUROOEDFN &07EHDQV EHHQVHWWRUROOEDFN &07EHDQV
JHWDWUDQVDFWLRQUHIHUHQFHDQGFDOO JHWDWUDQVDFWLRQUHIHUHQFHDQGFDOO
PHWKRGVRQLW %07EHDQV PHWKRGVRQLW %07EHDQV
$FFHVV $FFHVV
\RXUVSHFLDO-1',HQYLURQPHQW \RXUVSHFLDO-1',HQYLURQPHQW
DQRWKHUEHDQ·VPHWKRGV DQRWKHUEHDQ·VPHWKRGV
DUHVRXUFHPDQDJHU OLNHDGDWDEDVH DUHVRXUFHPDQDJHU OLNHDGDWDEDVH
HME&UHDWH HME5HPRYH
8VH\RXU6HVVLRQ&RQWH[WWR
JHWDUHIHUHQFHWR\RXUKRPH
JHWDUHIHUHQFHWR\RXU(-%REMHFW
JHWVHFXULW\LQIRUPDWLRQDERXWWKHFOLHQW
IRUFHDWUDQVDFWLRQWRUROOEDFN &07
EHDQV Unlike stateFUL beans, a sta teLESS
bean canÕt get caller security info in
ILQGRXWLIWKHWUDQVDFWLRQKDVDOUHDG\ no client
EHHQVHWWRUROOEDFN &07EHDQV ejbCreate(), because thereessIS bea nÕs
JHWDWUDQVDFWLRQUHIHUHQFHDQGFDOO associated with the statel Container
creation. Remember, itÕs thebean, and
that decides to create the
PHWKRGVRQLW %07EHDQV
its not tied to any client.
$FFHVV
\RXUVSHFLDO-1',HQYLURQPHQW
DQRWKHUEHDQ·VPHWKRGV
DUHVRXUFHPDQDJHU OLNHDGDWDEDVH
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
+RZFRPH
HME3DVVLYDWH DQG
HME$FWLYDWH DUHQ·WFDOOHG
ZKHQWKHEHDQJRHVLQDQG 7KHUH·VQRQHHG%HDQVVWD\
RXWRIWKHSRRO" DZDNHZKHQWKH\·UHLQWKHEHDQ
SRRO)RUSHUIRUPDQFH,NHHS
WKHEHDQVDVZKROHOLYLQJREMHFWVRQWKH
KHDSQRWVHULDOL]HGREMHFWVWKDW,·G
MXVWKDYHWRUHDFWLYDWHHDFKWLPHD
FOLHQWFDOOVDPHWKRGDQG,QHHG
DEHDQWRVHUYLFHLW
:HOOWKHQKRZGR
\RXJHWVFDODELOLW\LI
DOOWKHEHDQVLQWKHSRRO
DUHWDNLQJXSVSDFHRQ
WKHKHDS"
5HPHPEHUZLWKVWDWHOHVV
EHDQV,GRQ·WQHHGRQHSHU
FOLHQW,QHHGRQO\RQHSHUFOLHQWLQWKH
PLGGOHRIDEXVLQHVVPHWKRGFDOO,QRWKHUZRUGV
,QHHGMXVWHQRXJKVWDWHOHVVEHDQVWRVHUYLFHWKH
PHWKRGVDFWXDOO\H[HFXWLQJDQGQRWRQHSHUHYHU\
FOLHQWZKRKDSSHQVWRKDYHDUHIHUHQFHWRDQ(-%
REMHFW&OLHQWVVSHQGIDUPRUHWLPHEHWZHHQ
PHWKRGFDOOVWKDQDFWXDOO\LQPHWKRGFDOOV
\RXDUHKHUH
ZULWLQJVHVVLRQEHDQV
?ZQ\QVOI;M[[QWV*MIV"
aW]ZRWJI[*MIV8ZW^QLMZ
,KDYHDV\VWHPZKHQ,
VLWGRZQWRZULWHD6HVVLRQ
EHDQ,DOZD\VKDYHWRSXW
LQWKUHHNLQGVRIWKLQJV KRPH
VWXIIEXVLQHVVPHWKRGVDQGWKH <RXSXW7+5((NLQGVRIPHWKRGV
6HVVLRQ%HDQPHWKRGV LQWKHEHDQFODVV
LQWHUIDFH!! +20(WKLQJV HME&UHDWH PHWKRGV
$GYLFH+RPH
FUHDWH :ULWHDQHME&UHDWH PHWKRGLQWKHEHDQWRPDWFKHDFK
FUHDWH PHWKRGLQWKHKRPHLQWHUIDFH
LQWHUIDFH!!
$GYLFH &20321(17WKLQJV EXVLQHVVPHWKRGV
JHW$GYLFH :ULWHDEXVLQHVVPHWKRGLQWKHEHDQWRPDWFKHDFK
PHWKRGLQ\RXUEHDQ¶VFRPSRQHQWLQWHUIDFH
LQWHUIDFH!!
6HVVLRQ%HDQ 6(66,21%($1WKLQJV FRQWDLQHUFDOOEDFNV
VHW6HVVLRQ&RQWH[W IURPWKH6HVVLRQ%HDQLQWHUIDFH
HME3DVVLYDWH ,PSOHPHQWHDFKRIWKHIRXUPHWKRGVIURPWKH
HME$FWLYDWH 6HVVLRQ%HDQLQWHUIDFHZKLFK\RXUEHDQPXVWLPSOHPHQW
HME5HPRYH LQWKHRI¿FLDO-DYDZD\ LHXVLQJWKHLPSOHPHQWV
6HVVLRQ%HDQGHFODUDWLRQHLWKHULQ\RXUEHDQFODVVRURQH
RILWVVXSHUFODVVHV
6KDUSHQ \RXU SHQFLO
&RPSLOHUFKHFNHG"
0HWKRGVWRPDWFKWKH+RPHLQWHUIDFH
2IWKHWKUHHW\SHVRIPHWKRGV\RX
SXWLQ\RXUEHDQFKHFNRIIWKHRQHV 0HWKRGVWRPDWFKWKH&RPSRQHQWLQWHUIDFH
WKHFRPSLOHUFDUHVDERXW 0HWKRGVIURPWKH6HVVLRQ%HDQLQWHUIDFH
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
*LYHQWKHIROORZLQJLQWHUIDFHVZULWHWKHEHDQFODVVFRGH \RXFDQOHDYH
6KDUSHQ \RXU SHQFLO WKHPHWKRGHPSW\ DWWKHERWWRPRIWKHSDJH3D\VSHFLDODWWHQWLRQWR
WKH+RPHFUHDWHPHWKRGZKDWGRHVLWWDNHWRµPDWFK¶WKLVLQWKHEHDQ"
:LOOLWKDYHWKHVDPHUHWXUQW\SH"+LQWVDUHDWWKHERWWRPRIWKHSDJH
LPSRUWMDYD[HME
LPSRUWMDYDUPL5HPRWH([FHSWLRQ
SXEOLFLQWHUIDFH.HQQHO+RPHH[WHQGV(-%+RPH^
SXEOLF.HQQHOFUHDWH 6WULQJFXVW,' WKURZV&UHDWH([FHSWLRQ5HPRWH([FHSWLRQ
`
LPSRUWMDYD[HME
LPSRUWMDYDUPL5HPRWH([FHSWLRQ
SXEOLFLQWHUIDFH.HQQHOH[WHQGV(-%2EMHFW^
SXEOLF.HQQHO/HDVHSODFH3HW 3HWS WKURZV5HPRWH([FHSWLRQ
SXEOLFYRLGUHQHZ/HDVH ./HDVHOHDVH WKURZV5HPRWH([FHSWLRQ([SLUHG([FHSWLRQ
SXEOLF3HWJHW3HW ./HDVHOHDVH WKURZV5HPRWH([FHSWLRQ'HDG3HW([FHSWLRQ
`
:ULWHWKHEHDQFODVVKHUH
WLRQFODVVWKDWDUHGHFODUHGRQWKHPHWKRGVLQWKHLQWHUIDFH"
UXOHWKDWVD\VWKHLPSOHPHQWHURIDQLQWHUIDFHPXVWGHFODUHWKHVDPHH[FHSWLRQVLQWKHLPSOHPHQWD
IDFH7KH&RQWDLQHUGRHVQ¶WQHHGDQ\WKLQJEDFNIURPWKHEHDQGXULQJFUHDWLRQ'RHV-DYDKDYHD
+LQWV 7KHKRPHPHWKRGLQWKHEHDQKDVDVOLJKWO\GLIIHUHQWQDPHWKDQWKHRQHLQWKHKRPHLQWHU
\RXDUHKHUH
KRPHLQWHUIDFH
5XOHVIRUWKH+20(PHWKRGV KRPHLQWHUIDFH
/RFDOKRPHLQWHUIDFHVPXVWUHWXUQWKHORFDOFRPSRQHQWLQWHUIDFHDQG
5HPRWHKRPHLQWHUIDFHVPXVWUHWXUQWKH5HPRWHFRPSRQHQWLQWHUIDFH
SXEOLFLQWHUIDFH$GYLFH/RFDO+RPHH[WHQGV(-%/RFDO+RPH^
SXEOLF$GYLFH/RFDOFUHDWH WKURZV&UHDWH([FHSWLRQ
The return type of a
` home create method
SXEOLFLQWHUIDFH$GYLFH+RPHH[WHQGV(-%+RPH^
SXEOLF$GYLFHFUHDWH WKURZV&UHDWH([FHSWLRQ
must ALWAYS
5HPRWH([FHSWLRQ
`
be the component
(YHU\FUHDWHPHWKRGLQWKHKRPHLQWHUIDFHPXVWGHFODUHD
interface type.
&UHDWH([FHSWLRQUHJDUGOHVVRIZKHWKHUWKHLQWHUIDFHLVORFDORU5HPRWH
<RXFDQDOVRGHFODUH\RXURZQDSSOLFDWLRQ FKHFNHG H[FHSWLRQV
LQWHUIDFH!!
SXEOLF$GYLFHFUHDWH WKURZV&UHDWH([FHSWLRQ .HQQHO+RPH
1R$GYLFH([FHSWLRQ
.HQQHOFUHDWH 6WULQJLG
/RFDOKRPHLQWHUIDFHVPXVWH[WHQG(-%/RFDO+RPHDQGPXVW127
GHFODUH5HPRWH([FHSWLRQV
SXEOLFLQWHUIDFH$GYLFH/RFDO+RPHH[WHQGV(-%/RFDO+RPH^
SXEOLF$GYLFH/RFDOFUHDWH WKURZV&UHDWH([FHSWLRQ
`
This must be the component
5HPRWHKRPHLQWHUIDFHVPXVWH[WHQG(-%+RPHDQGPXVWGHFODUH interface type. Remote
5HPRWH([FHSWLRQVRQHYHU\PHWKRG homes must return Re-
SXEOLFLQWHUIDFH$GYLFH+RPHH[WHQGV(-%+RPH^
mote component interface
SXEOLF$GYLFHFUHDWH WKURZV&UHDWH([FHSWLRQ references, local homes must
5HPRWH([FHSWLRQ return local component
` interface references.
6WDWHOHVVEHDQVFDQKDYHRQO\RQHFUHDWH PHWKRGDQGLWPXVW127
KDYHDUJXPHQWV
SXEOLF$GYLFHFUHDWH WKURZV&UHDWH([FHSWLRQ
6WDWHIXOEHDQVPXVWKDYHRQHRUPRUHFUHDWH PHWKRGVDQGDUH127
UHTXLUHGWRKDYHDQRDUJFUHDWH 7KHFUHDWH PHWKRGVPXVWVWDUW
ZLWKWKHVWULQJ³FUHDWH´DQGFDQEHRYHUORDGHG
)RRFUHDWH%LJ)RR
)RRFUHDWH
$UJXPHQWVDQGUHWXUQW\SHVIRU5HPRWHKRPHLQWHUIDFHPHWKRGVPXVW
EHOHJDO50,,,23W\SHV 6HULDOL]DEOHSULPLWLYH5HPRWHRUFROOHF
WLRQVRUDUUD\VRIDQ\RIWKRVH
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
5XOHVIRUWKH+20(PHWKRGV EHDQFODVV
(YHU\FUHDWHPHWKRGLQWKHKRPHPXVWKDYHDPDWFKLQJHME&UHDWH
PHWKRGLQWKHEHDQFODVV7KHHME&UHDWHPHWKRGVLQWKHEHDQPXVW
KDYHDYRLGUHWXUQW\SH Every create in the
SXEOLFYRLGHME&UHDWH ^`
home must have a
7KHHME&UHDWHPHWKRGVPXVWEHSXEOLFDQGPXVW127EHPDUNHG matching ejbCreate
¿QDORUVWDWLF
in the bean class
<RXGR127KDYHWRGHFODUHWKHH[FHSWLRQVGHFODUHGLQWKHKRPHLQWHU
IDFHXQOHVV\RXPLJKWDFWXDOO\WKURZWKRVHH[FHSWLRQVIURP\RXURZQ
(void return type).
PHWKRGVDOWKRXJKLWLVRIWHQJRRGSUDFWLFHWRGHFODUH&UHDWH([FHSWLRQ
<RX0867QRWGHFODUH5HPRWH([FHSWLRQLQ\RXUEHDQFODVV(9(5
SXEOLFYRLGHME&UHDWH ^`QRGHFODUHGH[FHSWLRQV .HQQHO%HDQ
EHFDXVHZHGRQ¶WDFWXDOO\WKURZDQ\
YRLGHME&UHDWH 6WULQJLG
<RXPXVW127GHFODUHDQ\DSSOLFDWLRQH[FHSWLRQV LHFKHFNHG
H[FHSWLRQV WKDWZHUHQRWGHFODUHGLQWKHKRPHLQWHUIDFHIRUWKDW
PDWFKLQJFUHDWHPHWKRG
The bean home methods
SXEOLFYRLGHME&UHDWH WKURZV)LUH([FHSWLRQ^` must match the home
QRWOHJDOXQOHVV)LUH([FHSWLRQLVGHFODUHGRQWKH interface methods, except
KRPHLQWHUIDFHFUHDWHPHWKRG you preÞx the bean class
methods with ÔejbÕ, and
6WDWHOHVVEHDQVPXVWKDYHRQO\RQHHME&UHDWH DQGLWPXVWKDYHQR capitalize the ÔÔcÕ in create
DUJXPHQWV to ÔejbCreateÕ
SXEOLFYRLGHME&UHDWH ^`PXVWORRNOLNHWKLV
6WDWHIXOEHDQVPXVWKDYHRQHRUPRUHHME&UHDWHPHWKRGV PDWFK
LQJWKHPHWKRGVRIWKHKRPHLQWHUIDFH DQGPXVWVWDUWZLWKWKHVWULQJ
³HME&UHDWH´
+20(
SXEOLF)RRFUHDWH%LJ)RR WKURZV&UHDWH([FHSWLRQ
%($1
SXEOLFYRLGHME&UHDWH%LJ)RR ^`
\RXDUHKHUH
FRPSRQHQWLQWHUIDFH
5XOHVIRUWKH%86,1(66PHWKRGV FRPSRQHQWLQWHUIDFH
%XVLQHVVPHWKRGQDPHVPXVWQRWEHJLQZLWKWKHVWULQJ³HME´
$UJXPHQWVDQGUHWXUQW\SHVIRU5HPRWHFRPSRQHQWLQWHUIDFHPHWKRGV
PXVWEHOHJDO50,,,23W\SHV7KDWPHDQV6HULDOL]DEOHSULPLWLYH Remote component
5HPRWHRUDQDUUD\RUFROOHFWLRQRIDQ\RIWKRVH DVORQJDVWKHFROOHFWLRQ
LPSOHPHQWDWLRQFODVVLVLWVHOI6HULDOL]DEOH interface methods
SXEOLF6WULQJJHW$GYLFH WKURZV5HPRWH([FHSWLRQ
6WULQJLV6HULDOL]DEOHVRWKLVPHWKRGFRXOGEH
must have RMI-IIOP
LQD5HPRWHFRPSRQHQWLQWHUIDFH types as arguments
SXEOLF6RFNHWJHW7KH6RFNHW
and return types.
6RFNHWLV1276HULDOL]DEOHVRWKLVPHWKRGPXVW
127EHLQD5HPRWHLQWHUIDFH ORFDOZRXOGEH2.
6WULQJGR6RPHWKLQJ LQWL
/RFDOFRPSRQHQWLQWHUIDFHVPXVWH[WHQG(-%/RFDO2EMHFWDQGPXVW127
GHFODUH5HPRWH([FHSWLRQV This method would be legal
SXEOLFLQWHUIDFH$GYLFH/RFDOH[WHQGV(-%/RFDO2EMHFW^ in either a Remote or local
SXEOLF6WULQJJHW$GYLFH interface, because the argu-
` ment and return type are
legal RMI-IIOP types.
5HPRWHFRPSRQHQWLQWHUIDFHVPXVWH[WHQG(-%2EMHFWDQGPXVW
GHFODUH5HPRWH([FHSWLRQVRQHYHU\PHWKRG
SXEOLFLQWHUIDFH$GYLFHH[WHQGV(-%2EMHFW^
SXEOLF6WULQJJHW$GYLFH WKURZV5HPRWH([FHSWLRQ
`
<RXPXVWQRWH[SRVHWKHORFDOKRPHRUFRPSRQHQWLQWHUIDFHRIDEHDQ
WKURXJKD5HPRWHFRPSRQHQWLQWHUIDFHPHWKRG,QRWKHUZRUGV\RX
FDQ¶WKDYHDORFDOLQWHUIDFHDVWKHUHWXUQW\SHRUDUJXPHQWW\SHLQD
5HPRWHFRPSRQHQWLQWHUIDFHPHWKRG
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
5XOHVIRUWKH%86,1(66PHWKRGV EHDQFODVV
%XVLQHVVPHWKRGVPXVWEHGHFODUHGDVSXEOLFDQGPXVW127EH
GHFODUHGDV¿QDORUVWDWLF
SXEOLFYRLGGR%LJ7KLQJV ^`
Business methods must
0HWKRGQDPHVPXVWQRWEHJLQZLWKWKHVWULQJ³HME´ not throw application
<RXPXVW127SDVV³WKLV´DVDQDUJXPHQWRUUHWXUQYDOXH5HPHPEHU
(checked) exceptions
\RXGRQ¶WZDQWWRJLYHRXWDUHIHUHQFHWRWKHEHDQ(YHU\ERG\PXVWJR
WKURXJKWKH(-%REMHFW ODWHUZH¶OOVHHKRZWRGRWKDW
that arenÕt declared
SXEOLFYRLGGR6WXII WKLV QRWOHJDO
in the component
IURPZLWKLQDEHDQPHWKRG
interface.
$UJXPHQWVDQGUHWXUQW\SHVIRU5HPRWHFRPSRQHQWLQWHUIDFHPHWKRGV
PXVWEHOHJDO50,,,23W\SHV7KDWPHDQV6HULDOL]DEOHSULPLWLYH
5HPRWHRUDQDUUD\RUFROOHFWLRQRIDQ\RIWKRVH DVORQJDVWKHFROOHFWLRQ
LPSOHPHQWDWLRQFODVVLVLWVHOI6HULDOL]DEOH
SXEOLF6WULQJJHW$GYLFH ^`
6WULQJLV6HULDOL]DEOHVRWKLVPHWKRGFRXOGEH
LQD5HPRWHFRPSRQHQWLQWHUIDFH
6HVVLRQ%HDQ
H[WHQGV
(QWHU SULVH%HDQ
%87
SXEOLF6RFNHWJHW7KH6RFNHW ^` 7KHUH¶VQRWKLQJLQWKHUH
6RFNHWLV1276HULDOL]DEOHVRWKLVPHWKRGPXVW HUS ULVH%HD QLV6H ULDOL]D EOH
(QW
EH DQ LV
127EHLQD5HPRWHLQWHUIDFH ORFDOZRXOGEH2. 6RWKDWPHDQV\RXU
ZLWKRXW
DXWRPDWLFDOO\6HULDOL]DEOH
<RXGR127KDYHWRGHFODUHWKHH[FHSWLRQVGHFODUHGLQWKHFRPSRQHQW \RXUKDYLQJVDLGVR
HUH\RX
LQWHUIDFHXQOHVV\RXPLJKWDFWXDOO\WKURZWKRVHH[FHSWLRQVIURP\RXU ,I\RXKDYHDVFHQDULRZK
RJQ L]H LID EH DQ LV
RZQPHWKRGV<RX0867QRWGHFODUH5HPRWH([FHSWLRQLQ\RXUEHDQ QHHGWRUHF
LDOL]DEOH,7,6 HY HQ WKR XJK
FODVV(9(5 6HU
VVVD\
\RXGRQ¶WVHHWKHEHDQFOD
SXEOLF6WULQJJHW$GYLFH ^`QRGHFODUHGH[FHSWLRQV ³LPSOHPH QWV6H ULDO L]D EOH ´
EHFDXVHZHGRQ¶WDFWXDOO\WKURZDQ\
<RXPXVW127GHFODUHDQ\DSSOLFDWLRQH[FHSWLRQV LHFKHFNHG
H[FHSWLRQV WKDWZHUHQRWGHFODUHGLQWKHFRPSRQHQWLQWHUIDFHIRUWKDW
PDWFKLQJEXVLQHVVPHWKRG
SXEOLFYRLGJHW$GYLFH WKURZV$GYLFH([FHSWLRQ^`
QRWOHJDOXQOHVV$GYLFH([FHSWLRQLVGHFODUHGRQWKH
FRPSRQHQWLQWHUIDFHYHUVLRQRIWKHPHWKRG
\RXDUHKHUH
UXOHVIRUWKHEHDQFODVV
2WKHUUXOHVIRU\RXUEHDQFODVV
7KHFODVVPXVWLPSOHPHQWMDYD[HME6HVVLRQ%HDQHLWKHUGLUHFWO\
RULQGLUHFWO\
SXEOLFFODVV$GYLFH%HDQLPSOHPHQWV6HVVLRQ%HDQ
7KHFODVVPXVWEHSXEOLFDQGFDQQRWEH¿QDORUDEVWUDFW
7KHFODVVPXVWKDYHDSXEOLFQRDUJFRQVWUXFWRU 7KDW¶VZKDWWKH
&RQWDLQHUKDVWRXVH :HUHFRPPHQGMXVWOHWWLQJWKHFRPSLOHULQVHUW
WKHGHIDXOWFRQVWUXFWRUVLQFH\RXGR127ZDQWWRSXWFRGHLQWKH
FRQVWUXFWRU
SXEOLF$GYLFH ^`YDOLGEHDQFRQVWUXFWRU
<RXPXVW127KDYHD¿QDOL]H PHWKRGLQ\RXUFODVV
7KHFODVVLVQRWUHTXLUHGWR EXWLVDOORZHGWR LPSOHPHQWWKHEHDQ¶V
FRPSRQHQWLQWHUIDFH :HWDONHGHDUOLHUUHPHPEHUDERXWZK\\RX
SUREDEO\GRQ¶WZDQWWR³RI¿FLDOO\´LPSOHPHQW\RXUFRPSRQHQWLQWHUIDFH
<RXUFODVV0867LPSOHPHQWWKHPDWFKLQJKRPHDQGFRPSRQHQWLQWHUIDFH
<RXUEHDQFODVV
FDQKDYHRWKHU
PHWKRGV LHDQHME&UHDWHIRUHYHU\FUHDWHLQWKHKRPHDQGDPDWFKLQJ PHWKRGV
HWKH
EXVLQHVVPHWKRGIRUHYHU\PHWKRGLQWKHFRPSRQHQWLQWHUIDFH <RXUEHDQFODVVKDVWRKDY
PH WKR GV VWX IIIURP
WKUHHW\SHVRI
PH HME& UHD WHV WR PD WFK
,IWKHEHDQLVVWDWHIXOLWFDQRSWLRQDOO\LPSOHPHQWWKH WKHKR
WKR GV IURP
6HVVLRQ6\QFKURQL]DWLRQLQWHUIDFH 7KLVLQWHUIDFHJLYHVWKHEHDQ FUHDWHV EXVLQHVVPH
QWLQWH UIDF HD QG WKH
WKUHHPRUHFDOOEDFNVUHODWHGWRWUDQVDFWLRQVZKLFKZH¶OOORRNDWLQWKH WKHFRPSRQH
LRQ %HD QP HWK RGV %X W
WUDQVDFWLRQVFKDSWHU IRXU6 HVV
KD YLQ J\ RXU
QRWKLQJVWRSV\RXIURP
RVH G³K HOS HU¶´ PH WKR GV
RZQQRQH[S
7Q HHG
<RXUEHDQFODVVFDQKDYHDVXSHUFODVV,QRWKHUZRUGV\RXFDQXVH DQGWKRVHPHWKRGVGR12
QRUPDO-DYDLQKHULWDQFHZLWK\RXUEHDQFODVV <RXMXVWGRQ¶WJHWDQ\ WREHSXEOLF
VSHFLDOEHDQVSHFL¿FLQKHULWDQFHUHPHPEHU
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
7KHGLIIHUHQFHEHWZHHQFUHDWHDQGHME&UHDWH
the client needs to get
KRPH
back the component
interface
LQWHUIDFH
SXEOLF.HQQHOFUHDWH WKURZV&UHDWH([FHSWLRQ5HPRWH([FHSWLRQ3HW([FHSWLRQ
donÕt forget the ce declares an
name differences! just because the interanfa YOU must. If
EHDQ exception doesnÕt medonÕt declare it.
FODVV you donÕt throw it,
SXEOLFYRLGHME&UHDWH WKURZV3HW([FHSWLRQ^`
but the container doesnÕt need
anything from the bean
7KH&RQWDLQHU
PLJKWQRWQHHG
DQ\WKLQJIURPWKHEHDQEXW
,·PQRWVXUH, WKHKRPHGDPQZHOOEHWWHU
XQGHUVWDQGZK\WKH JLYH0(WKHFRPSRQHQW
UHWXUQW\SHVDUHGLIIHUHQW LQWHUIDFH7KDW·VWKHRQO\
UHDVRQ,·PKHUH
EHWZHHQWKHEHDQDQG
WKHLQWHUIDFH
:KHQ,FDOOWKH
EHDQ·VHME&UHDWHPHWKRG,
GRQ·W1(('DQ\WKLQJIURPWKH
EHDQWKDQN\RXYHU\PXFKVRXVH
YRLGIRUWKHUHWXUQW\SH 7KLVZLOODOO
FKDQJHZLWKHQWLWLHVWKRXJKVR
EHSUHSDUHG
\RXDUHKHUH
VHVVLRQEHDQZDWFKLWV
<RXFDQKDYH
DUHWXUQLQDQ
HME&UHDWH
DWH
<RX.12:WKDWDQHME&UH
WKRGP XVW KD YH DYRLG UHWXUQ
PH
DVLF
W\SHEXWGRQ¶WIRUJHW\RXUE
MX VWE HFD XVH \R XVHHD
-DYDUXOHV
3D\DWWHQWLRQWR
WKH
UHWXUQVWDWHPHQW UHWXUQ
QRWPHDQ\RX¶UH UHWX UQLQ
G
JD
RHV
YD OXH
´HMEµDVLQHME5H OHG E\ FR QVL GHU LQJ
PRYH 'RQ¶WEH IRR
YVMXVWUHPRYH WXDO
DQG DQ\WKLQJRWKHUWKDQWKHDF
HME&UHDWHYVF W\S HR IWKH
UHDWH GHFODUHGUHWXUQ
7UXHRUIDOVH WKH&
RQWDLQHUFDOOVDEH
DQ¶V HME&UHDWH PHWKRG
UHPRYH PHWKRGL
IWKHVWDWHIXOEHDQW
RXWZKLOHDFWLYH LPHV
)$/6(7KHEHDQ
GRHVQ¶W+$9(D
UHPRYH PHWKRG
RQO\DQHME5HPRY
PHWKRG H
:DWFKIRUWKLQJVOLNH
³7KH%HDQ3URYLG
UHVSRQVLEOHIRUSX HULV
WWLQJWKHFUHDWH P
LQWKHEHDQ´1RWWU HWKRG
XHEHFDXVHWKHUH,
QRFUHDWH PHWKRG 6
LQWKHEHDQRQO\
HME&UHDWH DQ
2QO\21(FOLHQWFDQD
DVHVVLR QE HD QD WD WLP
FFHVV
H
%HVXUHWREXUQLW DUG OHV VR IZ KH WKH UWKHEHDQ
LQWR\RXUKHDGWKD UHJ
W O
DQ\WKLQJVWDUWLQJZ
LWKWKHOHWWHUVµHME¶LV LVVWDWHOHVVRUVWDWHIX
WKHEHDQ2IFRXUVH LQ QRQH
LWZRXOGEHHDV\LI 5EHDFFHVVHGE\PRUHWKD
ZHUHWKH21/<UX
OHOLNHLIHYHU\WKLQJ
WKDW 6HVVLRQEHDQVPXVW1(9( DF OLHQ WDQ GD QRW KHU
LQ XVH E\
WKHEHDQVWDUWVZL LQ FOLHQW,IDEHDQLVFXUUHQWO\ WJHWV
WK³HME´DQGQRWKLQJ WKHEHDQWKDWVHFRQGFOLHQ
LQWHUIDFHVVWDUWVZL
WKµ³HME´EXWRIFR
LQWKH FOLHQWLQYRNHVDPHWKRGRQ QWL QWK HV SHF WKD W
HLVDFRPPH
WKDW¶VQRWWUXH XUVH DQH[FHSWLRQ%87WKHU HQW VWD WH/ (6 6E HDQVDV
WRL PS OHP
%XVLQHVVPHWKRGVD VD\VWKH&RQWDLQHULVIUHH KHQUXQV
UHLGHQWLFDOO\QDPHG HDQZKLFKWKH&RQWDLQHUW
ERWKWKHFRPSRQHQ
WLQWHUIDFHDQGWKHE
LQ DVLQJOHLQVWDQFHRIWKHE
WLPH
FODVVDQGWKH\GR HDQ WKHFOLHQWVWKURXJKRQHDWD U
HLWKHUWKHLQWHUIDFH
Q¶WHYHUVWDUWZLWK³H
ME´LQ Q¶WVXS SRVHG WRN QRZ RUFDUHKRZWKH&RQWDLQH
RUWKHEHDQFODVV <RXDUH RXW LVWKD W\R X
KDYHWRFDUHDE
GRHVLW WKHRQO\WKLQJ\RX W\R XUE HDQ IUR P
WRSURWHF
<RXDOVRQHHGWRNH GR127KDYHWRZULWHFRGH RX
LQYRNHV:+$7)R
HSWUDFNRI:+2
FXU UHQ WDFFHV V :K LFK \RXNQRZDQ\ZD\VLQFH\
UH[DPSOHZKR FRQ GF RGH LQ\RXU
86(WKUHDGUHODWH
LQYRNHVWKHFUHDWH
PHWKRG"7KHFO NQRZWKDW\RXFDQ¶WHYHQ HWF
DLWQRWLI\
RUWKH&RQWDLQHU" F LHQW
OLHQW :KRLQYRNH EHDQOLNHV\QFKURQL]HGZ
HME&UHDWH WKH& V
RQWDLQHU :KRLQYR
VHW6HVVLRQ&RQWH[ NHV
W " &RQWDLQHU :
LQYRNHVUHPRYH " KR
FOLHQW
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
6KDUSHQ \RXU SHQFLO :KRGRHV:KDW"
)URPWKHOLVWRIZRUGVEHORZDUUDQJHWKHPLQWKHDSSURSULDWHOLVWVDFFRUGLQJWR
ZKHWKHULW¶VDUHVSRQVLELOLW\RIWKH%HDQ3URYLGHUWKH&RQWDLQHURUWKH&OLHQW
KZMI\QVO\PM0WUMWJRMK\KTI[[ QUXTMUMV\QVO\PM;M[[QWV+WV\M`\KTI[[
QV^WSQVO[M\;M[[QWV+WV\M`\
QV^WSQVOMRJ+ZMI\M QV^WSQVOMRJ:MUW^M
QUXTMUMV\QVO\PM-2*7JRMK\KTI[[ KZMI\QVO\PMPWUMQV\MZNIKM
QV^WSQVOKZMI\M
QUXTMUMV\QVO\PM0IVLTMKTI[[
QUXTMUMV\QVO;M[[QWV*MIV
QV^WSQVOIJ][QVM[[UM\PWL
WV\PMKWUXWVMV\QV\MZNIKM QUXTMUMV\QVO\PMKZMI\MUM\PWL
QUXTMUMV\QVO\PMMRJ+ZMI\MUM\PWL QUXTMUMV\QVO\PMMRJ)K\Q^I\MUM\PWL
QV^WSQVOMJR8I[[Q^I\M
%HDQ3URYLGHU &OLHQW &RQWDLQHU
\RXDUHKHUH
VHVVLRQFRQWH[W
;M[[QWV+WV\M`\
AW]VMMLQ\UWZM\PIVQ\VMML[aW]
!T THE BEGINNING OF A BEANS LIFE AND ONLY ONCE IN THE BEANS LIFE THE
#ONTAINER CALLS THE BEANS SET3ESSION#ONTEXT CONTAINER CALLBACK METHOD
4HAT CONTEXT A SUBCLASS OF %*"#ONTEXT IS THE BEANS LIFELINE TO THE #ONTAINER
AND ITS THE ONLY THING THE BEAN CAN CALL METHODS ON TO GET REFERENCES TO HIS
OWN HOME AND %*" OBJECT TO GET SECURITY INFORMATION ABOUT THE CLIENT OR TO
DO TRANSACTION
RELATED THINGS 7E WONT LOOK AT THE SECURITY AND TRANSACTION
INFO NOW THEYRE BOTH COVERED IN SEPARATE CHAPTERS
<RXDUH62IULFNLQ·OXFN\WRKDYHPH,·P 8POHW·VJHWWKLVVWUDLJKW³
DVFORVHDV\RX·OOHYHUJHWWRWKH&RQWDLQHU \RX·UHKHUHWRVHUYH0(6R\RXEHWWHU
EDE\VR\RXEHWWHUWDNHJRRGFDUHRIPH$QG JHWXVHGWRKHDULQJ´2K&RQWH[W%R\JHW
\RXRQO\JHWRQHVKRWDWLWLI\RXGRQ·WVDYHPHZKHQ PHDWUDQVDFWLRQµ´2K&RQWH[W%R\JHWPH
WKH&RQWDLQHUFDOOVVHW6HVVLRQ&RQWH[W \RX·UH WKHFOLHQW·VVHFXULW\LQIRµ$QG,DOPRVW
VFUHZHG$QGGRQ·WGRDQ\WKLQJVWXSLGOLNHQXOORXW IRUJRW,WDNHRQHVXJDUDQGQRFUHDP
P\UHIHUHQFH6RRQHURUODWHU\RX·UHJRQQD
LQP\FRIIHH
QHHGPHIRUVRPHWKLQJ
%HDQ
6HVVLRQ&RQWH[W
0HPRUL]HWKH
6HVVLRQ&RQWH[W
LQWHUIDFH
WDOLVWRI
<RXPXVWEHDEOHWRORRND
GNQRZ ZK LFK EH ORQJWRWKH
PHWKRGVDQ
$Q GUH PHPEHU
6HVVLRQ&RQWH[WLQWHUIDFH
LRQ VUH ODWH GWR OLIH F\FOH
DORWRIWKHTXHVW
NQRZ LQJWKH PH WKR GV IURPZKLFK
DUHDERXW
GVRQ\RXU
\RXFDQFDOOFHUWDLQPHWKR
SOH \R XK DYHWRNQRZ
FRQWH[W)RUH[DP
ODWHGLQIRIURP
WKDW\RXFDQ¶WJHWFOLHQWUH
UHD WH PHWKRG
\RXUFRQWH[WLQWKHHME&
EHD Q% HFD XVH WKHUH¶VQR
RIDVWDWHOHVV
WHOHVVEHDQ¶V
FOLHQWDVVRFLDWHGZLWKDVWD
&$ 1J HWFOLHQWLQIR
HME&UHDWH %XW\RX
H[W IUR PD VWD WHIXOEHDQ¶V
IURP\RXUFRQW
WLQLWLDWHGLW
HME&UHDWH EHFDXVHDFOLHQ
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
7KLQJV\RXFDQGRZLWK\RXU6HVVLRQ&RQWH[W
PHWKRGVFDWHJRULHV
LQWHUIDFH!!
(-%&RQWH[W
JHWDUHIHUHQFHWR\RXUKRPH
JHW(-%+RPH JHW&DOOHU3ULQFLSDO
KRPHUHI JHW(-%/RFDO+RPH LV&DOOHU,Q5ROH 6WULQJV
JHW(-%+RPH
JHW(-%/RFDO+RPH
JHWDUHIHUHQFHWR\RXU(-%REMHFW JHW5ROOEDFN2QO\
JHW(-%2EMHFW JHW8VHU7UDQVDFWLRQ
(-%REMHFWUHI VHW5ROOEDFN2QO\
JHW(-%/RFDO2EMHFW
LQWHUIDFH!!
JHWVHFXULW\LQIRUPDWLRQDERXWWKHFOLHQW 6HVVLRQ&RQWH[W
JHW(-%/RFDO2EMHFW
FOLHQWVHFXULW\ JHW&DOOHU3ULQFLSDO
LV&DOOHU,Q5ROH 6WULQJV JHW(-%2EMHFW
IRUFHDWUDQVDFWLRQWRUROOEDFN &07RQO\
VHW5ROOEDFN2QO\ ERROHDQE
WUDQVDFWLRQV <RXGRQ¶WQHHG
WRNQRZWKHWKUHH
ILQGRXWLIWKHWUDQVDFWLRQKDVDOUHDG\EHHQ GHSUHFDWHGPHWKRGV
VHWWRUROOEDFN &07RQO\ %HVLGHVWKHRQHVVKRZQRQWKLVSDJH
JHW5ROOEDFN2QO\ WKH(-%&RQWH[WLQWHUIDFHKDVWKUHH
RWKHUPHWKRGVDOORIZKLFKKDYH
EHHQGHSUHFDWHG<RX¶UHQRWWHVWHG
JHWDWUDQVDFWLRQUHIHUHQFHDQGVWDUW\RXU RQGHSUHFDWHGPHWKRGVVRLI\RXVHH
RZQWUDQVDFWLRQ %07RQO\ WKHPLQWKH$3,GRQ¶WSDQLF7KHRQO\
JHW8VHU7UDQVDFWLRQ UHDVRQ\RXQHHGWRNQRZDERXWWKHP
LVLQFDVH\RX¶UHZRUNLQJZLWKROGHU
(-%FRGH7KHPHWKRGVDUH
LV&DOOHU,Q5ROH ,GHQWLW\LG
JHW&DOOHU,GHQWLW\
JHW(QYLURQPHQW
\RXDUHKHUH
7LNLEHDQ/RXQJH
6WDWHOHVVEHDQ ,GRQ·WVHHKRZ\RXFDQVWDQG 6WDWHIXOEHDQ :KLFKLVDOVRZK\\RX·UHQRWXVHGIRU
LWEHLQJDVWDWHIXOEHDQ<RXUZKROHOLIHLVWLHGWR DQ\WKLQJELJRUVHULRXV
VHUYLFLQJRQHFOLHQW
6WDWHOHVVEHDQ 1RZZDLWMXVWDPLQXWHKHUH³WKDWLV
6WDWHIXOEHDQ ,·PQRWVXUH,OLNHWKHZD\\RXSKUDVH 62QRWWUXH,QIDFWLI\RXZDQWWRWDONSHUIRUPDQFH
WKDW´VHUYLFLQJRQHFOLHQWµ0DNHVLWVRXQGOLNH,·PD EXGG\,·PZD\PRUHVFDODEOHWKDQ\RX$QGEHIRUH
SHUVRQDOVODYHRUVRPHWKLQJ \RXVWDUWDUJXLQJGRQ·WHYHQJLYHPHWKDWQRQVHQVH
DERXWSDVVLYDWLRQ,·YHKHDUGDOOWKHDUJXPHQWV%XW
6WDWHOHVVEHDQ $QGWKDWZRXOGEHZURQJEHFDXVH SDVVLYDWLRQZLOO1(9(5PDNH\RXDVVFDODEOHDVPH
6WDWHIXOEHDQ ,W·VDSHUVRQDOLQWLPDWHUHODWLRQVKLS$ 6WDWHIXOEHDQ 2.PD\EH,·PQRWTXLWH$6VFDODEOH
UHODWLRQVKLSWKDW\RXFRXOGQ·WSRVVLEO\FRPSUHKHQG EXWWKHUHDUHPRUHLPSRUWDQWWKLQJVLQOLIHWRFRQVLGHU
6WDWHOHVVEHDQ :KDWLV7+$7VXSSRVHGWRPHDQ" 6WDWHOHVVEHDQ )RUH[DPSOH"
6WDWHIXOEHDQ %HFDXVH\RXUUHODWLRQVKLSVDUHVR 6WDWHIXOEHDQ :HOO,·PHDV\WRXVH(DV\DQGTXLFN
WUDQVLHQW<RXGRQ·WUHDOO\FDUH:+2\RXVHUYLFH$Q\ WREXLOG0D\EHWKDW·VPRUHLPSRUWDQWWRWKHGHYHORSHU
FOLHQWLQDVWRUPDVWKH\VD\ $QGLQVRPHFDVHV,·PVWLOOJRQQDSHUIRUPEHWWHUZKHQ
\RXUHDOO\GRQHHGFOLHQWFRQYHUVDWLRQDOVWDWH7KH
6WDWHOHVVEHDQ 7KHUH·VQRWKLQJZURQJZLWKWKDW,·P RSWLRQVFDQUHDOO\VXFNVRPHWLPHVKDYLQJWRVWRUH
DSHRSOHSHUVRQ,OLNHEHLQJLQWKHSRROZLWKWKHRWKHU WKHVWDWHLQDGDWDEDVHZLWKHDFKFDOO DQGWKHQJRDQG
EHDQVWKHQFRQVWDQWO\PHHWLQJQHZFOLHQWV,W·VQHYHU ORRNLWDOOXSDJDLQZLWKWKHYHU\1(;7FDOO ",NQRZ
ERULQJDQG,EDUHO\HYHUVHHWKHVDPHFOLHQWWZLFH VRPHWLPHV\RXKDYHWRGRWKDWEXWVWLOO2UVXUH\RX
DQG³ FRXOGMXVWNHHSVHQGLQJWKHFRQYHUVDWLRQDOVWDWHEDFNWR
WKHFOLHQWVRWKDWWKH\FDQWXUQDURXQGDQGVHQGLWEDFN
6WDWHIXOEHDQ 0\SRLQWH[DFWO\<RX·UHQRWHYHQ WR<28ZLWKHDFKFDOODQG³
3+<6,&$//<DEOHWRVXVWDLQDPHDQLQJIXORQJRLQJ
UHODWLRQVKLS 6WDWHOHVVEHDQ :KDW·VZURQJZLWKWKDW"
6WDWHOHVVEHDQ ([FXVHPH" 6WDWHIXOEHDQ +HUH·VDQHZZRUGIRU\RXU
YRFDEXODU\´EDQGZLGWKµ3URQRXQFHLWZLWKPH
6WDWHIXOEHDQ ,W·VWKDWVKRUWWHUPPHPRU\ORVV ´EDDDQGZLLLLGWKµ'R\RXUHDOO\ZDQWDOOWKDWJRLQJEDFN
WKLQJ<RXFDQ·WKROGDQ\FOLHQWLQIRUPDWLRQEHWZHHQ DQGIRUWK"
PHWKRGFDOOVZKLFKLVZK\LWGRHVQ·WPDWWHU:+,&+
FOLHQWFDOOV<RX·GQHYHUEHDEOHWRUHPHPEHUHYHQLI\RX 6WDWHOHVVEHDQ 2N\HDKJRWLW%XWWHOOPHKRZ
JRWWKHVDPHFOLHQWFDOOLQJWHQRI\RXUPHWKRGVLQDURZ LVWKLVZRUVHIRUSHUIRUPDQFHWKDQWKHKLWIURP
SDVVLYDWLRQDFWLYDWLRQ"$QGZKLOHZH·UHDWLW³ZDLWGLG
6WDWHOHVVEHDQ <HDKEXWWKDW·VQRWDSUREOHP \RXKHDUWKDW",WKLQN,KHDU\RXUFOLHQWFDOOLQJ$QG
5HPHPEHU,·PXVHGIRUVHUYLFHVWKDWGRQ·W1(('PH LWVRXQGOLNHQRZDLW\HV,·PDIUDLGLWVRXQGVOLNH
WRUHPHPEHUDQ\WKLQJIURPFOLHQWVEHWZHHQPHWKRG KH·VFDOOLQJUHPRYH ,W·VEHHQQLFHWDONLQJWR\RX,·OO
FDOOV EHWKLQNLQJDERXW\RXZKLOH,·PRXWDWWKHSRRO)ORDWLQJ
RQDLUPDWWUHVV*HWWLQJDWDQ'ULQNLQJPDUJDULWDVZLWK
VKDYHGLFH:RZ,/29(EHLQJPH
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
3XWDFKHFNQH[WWRWKHPHWKRGVWKDW\RXFDQFDOORQ\RXU6HVVLRQ&RQWH[WLILW·VDOORZHGIURPWKH
PHWKRGVLQWKHOHIWFROXPQ)RUH[DPSOHLQHME&UHDWH \RXFDQJHWDUHIHUHQFHWR\RXUKRPHIRUERWK
WhatÕs allowed? VWDWHOHVVDQGVWDWHIXOVHVVLRQEHDQVVR\RXFDQSXWDFKHFNLQWKHWRSER[LQERWKFROXPQV$OORIWKH
DQVZHUVDUHLQWKLVFKDSWHUEXWWU\WRPDNH\RXUEHVWJXHVVEHIRUHJRLQJEDFNIRUWKHDQVZHUV<RX
PLJKWZDQWWRPDNHDQRWKHURQHRIWKHVH\RXUVHOIWRLQFOXGH-1',UHVRXUFHDQGEHDQDFFHVV
%HDQPHWKRGV 6WDWHIXO 6WDWHOHVV
8VH\RXU6HVVLRQ&RQWH[WWR 8VH\RXU6HVVLRQ&RQWH[WWR
JHWDUHIHUHQFHWR\RXUKRPH JHWDUHIHUHQFHWR\RXUKRPH
HME&UHDWH
JHWDUHIHUHQFHWR\RXU(-%REMHFW JHWDUHIHUHQFHWR\RXU(-%REMHFW
HME5HPRYH
JHWVHFXULW\LQIRUPDWLRQDERXWWKHFOLHQW JHWVHFXULW\LQIRUPDWLRQDERXWWKHFOLHQW
IRUFHDWUDQVDFWLRQWRUROOEDFN &07 IRUFHDWUDQVDFWLRQWRUROOEDFN &07
EHDQV EHDQV
ILQGRXWLIWKHWUDQVDFWLRQKDVDOUHDG\ ILQGRXWLIWKHWUDQVDFWLRQKDVDOUHDG\
EHHQVHWWRUROOEDFN &07EHDQV EHHQVHWWRUROOEDFN &07EHDQV
JHWDWUDQVDFWLRQUHIHUHQFHDQGFDOO JHWDWUDQVDFWLRQUHIHUHQFHDQGFDOO
PHWKRGVRQLW %07EHDQV PHWKRGVRQLW %07EHDQV
8VH\RXU6HVVLRQ&RQWH[WWR
HME3DVVLYDWH JHWDUHIHUHQFHWR\RXUKRPH
HME$FWLYDWH JHWDUHIHUHQFHWR\RXU(-%REMHFW 'RHVQRWDSSO\
VWDWHOHVVEHDQVDUH
JHWVHFXULW\LQIRUPDWLRQDERXWWKHFOLHQW QHYHUSDVVLYDWHG
IRUFHDWUDQVDFWLRQWRUROOEDFN &07
EHDQV
ILQGRXWLIWKHWUDQVDFWLRQKDVDOUHDG\
EHHQVHWWRUROOEDFN &07EHDQV
JHWDWUDQVDFWLRQUHIHUHQFHDQGFDOO
PHWKRGVRQLW %07EHDQV
8VH\RXU6HVVLRQ&RQWH[WWR 8VH\RXU6HVVLRQ&RQWH[WWR
JHWDUHIHUHQFHWR\RXUKRPH JHWDUHIHUHQFHWR\RXUKRPH
EXVLQHVV
PHWKRGV
JHWDUHIHUHQFHWR\RXU(-%REMHFW JHWDUHIHUHQFHWR\RXU(-%REMHFW
JHWVHFXULW\LQIRUPDWLRQDERXWWKHFOLHQW JHWVHFXULW\LQIRUPDWLRQDERXWWKHFOLHQW
IRUFHDWUDQVDFWLRQWRUROOEDFN &07 IRUFHDWUDQVDFWLRQWRUROOEDFN &07
EHDQV EHDQV
ILQGRXWLIWKHWUDQVDFWLRQKDVDOUHDG\ ILQGRXWLIWKHWUDQVDFWLRQKDVDOUHDG\
EHHQVHWWRUROOEDFN &07EHDQV EHHQVHWWRUROOEDFN &07EHDQV
JHWDWUDQVDFWLRQUHIHUHQFHDQGFDOO JHWDWUDQVDFWLRQUHIHUHQFHDQGFDOO
PHWKRGVRQLW %07EHDQV PHWKRGVRQLW %07EHDQV
\RXDUHKHUH
FRIIHHFUDPPRFNH[DP
0RFN([DP
7HICH STATEMENTS ABOUT SESSION BEANS ARE TRUE #HOOSE ALL THAT APPLY
1
R! ! STATEFUL SESSION BEAN IS TYPICALLY USED TO REPRESENT A ROW IN A DATABASE
R" 4HE CLIENT MUST CALL THE EJB!CTIVATE METHOD BEFORE CALLING ANY BUSINESS
METHODS
R# ! STATEFUL SESSION BEANS lELDS CAN CONTAIN CLIENT CONVERSATIONAL STATE
R$ 4HEY ARE TYPICALLY USED AS ASYNCHRONOUS MESSAGE CONSUMERS
7HICH LISTS CORRECTLY SEQUENCE SOME OF THE STEPS IN A SESSION BEANS LIFECYCLE
2 #HOOSE ALL THAT APPLY
R! HME&UHDWH QHZ,QVWDQFH VHW6HVVLRQ&RQWH[W
R" QHZ,QVWDQFH VHW6HVVLRQ&RQWH[W HME&UHDWH
R# HME&UHDWH VHW6HVVLRQ&RQWH[W QHZ,QVWDQFH
R$ QHZ,QVWDQFH HME&UHDWH VHW6HVVLRQ&RQWH[W
R% VHW6HVVLRQ&RQWH[W QHZ,QVWDQFH HME&UHDWH
7HICH TYPES OF SESSION BEAN INSTANCE lELDS CAN BE SUCCESSFULLY PASSIVATED AND
3 REACTIVATED #HOOSE ALL THAT APPLY
R! ! REFERENCE TO THE REMOTE HOME INTERFACE
R" ! REFERENCE TO THE 5SER4RANSACTION INTERFACE
R# ! REFERENCE TO A DATABASE CURSOR
R$ ! REFERENCE TO THE 3ESSION#ONTEXT OBJECT
R% ! REFERENCE TO A SOCKET
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
7HICH ARE VALID REMOTE COMPONENT INTERFACES FOR A SESSION BEAN #HOOSE ALL
4 THAT APPLY
R! SXEOLFLQWHUIDFH0\%HDQH[WHQGVMDYD[HME(-%2EMHFW^
YRLGP\0HWKRG
`
R" SXEOLFLQWHUIDFH0\%HDQH[WHQGVMDYD[HME(-%2EMHFW
WKURZV5HPRWH([FHSWLRQ^
YRLGP\0HWKRG
`
R# SXEOLFLQWHUIDFH0\%HDQH[WHQGV
MDYD[HME(-%+RPH2EMHFW^
YRLGP\0HWKRG WKURZV5HPRWH([FHSWLRQ
`
R$SXEOLFLQWHUIDFH0\%HDQH[WHQGVMDYD[HME(-%2EMHFW^
YRLGP\0HWKRG WKURZV5HPRWH([FHSWLRQ
`
)F A CLIENT MAKES A CALL TO A SESSION OBJECT THAT HAS BEEN REMOVED BY THE
5 CONTAINER WHICH EXCEPTIONS CAN BE THROWN #HOOSE ALL THAT APPLY
R! MDYDUPL5HPRWH([FHSWLRQ
R" MDYD[HME5HPRYH([FHSWLRQ
R# MDYDUPL1R6XFK2EMHFW([FHSWLRQ
R$ MDYD[HME1R6XFK(QWLW\([FHSWLRQ
R% MDYD[HME2EMHFW1RW)RXQG([FHSWLRQ
'IVEN
6 0\%HDQFUHDWH 6WULQJQDPH WKURZV&UHDWH([FHSWLRQ
5HPRWH([FHSWLRQ
7HICH SESSION BEAN INTERFACE CAN CONTAIN THIS METHOD
R! /NLY STATEFUL SESSION BEANS
R" /NLY STATELESS SESSION BEANS
R# "OTH STATEFUL AND STATELESS SESSION BEANS
R$ .EITHER STATEFUL NOR STATELESS SESSION BEANS
\RXDUHKHUH
FRIIHHFUDPPRFNH[DP
7HAT IS TRUE ABOUT A SESSION BEANS LIFECYCLE #HOOSE ALL THAT APPLY
7
R! )F A BUSINESS METHOD THROWS A SYSTEM EXCEPTION THE BEAN WILL BE
PASSIVATED
R" ! PASSIVATED BEAN MUST BE ACTIVATED BEFORE IT CAN BE REMOVED
R# ! STATELESS SESSION BEANS REMOVAL MUST BE INITIATED BY THE CLIENT NOT THE
CONTAINER
R$ 3TATELESS SESSION BEANS CANNOT IMPLEMENT THE 3ESSION3YNCHRONIZATION
INTERFACE
7HICH ARE REQUIRED OF THE BEAN PROVIDER TO ENSURE THAT A SESSION BEAN IS
8 SUCCESSFULLY PASSIVATED #HOOSE ALL THAT APPLY
R! 4HE PROVIDER MUST CALLHME3DVVLYDWH
R" 4HE PROVIDER MUST ALWAYS ADD BUSINESS LOGIC TO THEHME3DVVLYDWH
METHOD IF THE BEAN IS STATEFUL
R# 4HE PROVIDER MUST CLOSE ANY DATABASE CONNECTIONS BEFORE
HME3DVVLYDWH COMPLETES
R$ 4HE PROVIDER MUST ASSUME THAT ANY STATE STORED IN INSTANCE lELDS MARKED
TRANSIENT WILL BE LOST
R% 4HE PROVIDER MUST ASSUME THAT ANY REFERENCE TO THE 3ESSION#ONTEXT
OBJECT WILL BE NOT SURVIVE PASSIVATION IF THE 3ESSION#ONTEXT OBJECT IS NOT
SERIALIZABLE
'IVEN A STATELESS SESSION BEAN WITH CONTAINER
MANAGED TRANSACTION
9 DEMARCATION FROM WHICH METHODS CAN YOU ACCESS ANOTHER BEAN #HOOSE
ALL THAT APPLY
R! HME&UHDWH
R" HME5HPRYH
R# A BUSINESS METHOD
R$ VHW6HVVLRQ&RQWH[W
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
.OTE 4HE REAL EXAM HAS SEVERAL TYPES OF @DRAG AND DROP QUESTIONS THAT
10 WERE GOING TO DO A LAME JOB OF SIMULATING WITH THIS QUESTION
-ATCH THE METHODS ON THE LEFT WITH THE INTERFACES IN WHICH THOSE METHODS
CAN BE FOUND ON THE RIGHT ! MATCH IS CORRECT IF THE METHOD IS EITHER DECLARED
IN OR INHERITED BY THE INTERFACE .OTE 4HERE MAY BE SOME MANY
TO
ONE AND
ONE
TO
MANY RELATIONSHIPS IN YOUR ANSWER
! AFTER#OMPLETION 3ESSION3YNCHRONIZATION
" GET5SER4RANSACTION 3ESSION#ONTEXT
# AFTER"EGIN 3ESSION"EAN
$ IS#ALLER)N2OLE 5SER4RANSACTION
% GET2OLL"ACK/NLY
& SET3ESSION#ONTEXT
' SET2OLLBACK/NLY
11 7HAT IS TRUE ABOUT A SESSION BEANS LIFECYCLE #HOOSE ALL THAT APPLY
R! 4HE CONTAINER WILL ALWAYS CREATE A NEW SESSION BEAN INSTANCE WHEN
THE CLIENT INVOKES THE FUHDWH METHOD ON THE HOME INTERFACE OF A
STATELESS BEAN
R" 4HE CONTAINER WILL ALWAYS CALL HME5HPRYH WHEN THE CLIENT INVOKES
THE UHPRYH METHOD ON A STATELESS BEANS HOME INTERFACE
R# ! SESSION BEAN CANNOT BE PASSIVATED WHILE IT IS IN A TRANSACTION
R$ 4HE VHW6HVVLRQ&RQWH[W METHOD IS NOT INVOKED DURING A STATELESS
BEANS LIFECYCLE
7HICH OF THE FOLLOWING METHODS ARE CONTAINER CALLBACK METHODS #HOOSE ALL
12 THAT APPLY
R! HME3DVVLYDWH
R" VHW5ROOEDFN2QO\
R# VHW6HVVLRQ&RQWH[W
R$ JHW5ROOEDFN2QO\
R% JHW8VHU7UDQVDFWLRQ
\RXDUHKHUH
FRIIHHFUDPPRFNH[DP
)N WHAT CASES WILL THE CONTAINER FAIL TO CALL EJB2EMOVE ON A SESSION BEAN
13 #HOOSE ALL THAT APPLY
R! )F THE CONTAINER CRASHES
R" )F AN APPLICATION EXCEPTION IS THROWN FROM A BUSINESS METHOD
R# )F A TIMEOUT OCCURS WHILE THE BEAN IS IN THE METHOD READY STATE
R$ )F AN APPLICATION EXCEPTION IS THROWN FROM WITHIN A TRANSACTION
7HICH METHODS ALLOW BOTH STATEFUL AND STATELESS SESSION BEANS WITH BEAN
14 MANAGED TRANSACTION DEMARCATION TO ACCESS 5SER4RANSACTION METHODS
#HOOSE ALL THAT APPLY
R! HME&UHDWH
R" HME5HPRYH
R# A BUSINESS METHOD
R$ VHW6HVVLRQ&RQWH[W
&OR WHICH TYPE OF BEAN CAN THE CONTAINER PASSIVATE AN INSTANCE THAT IS IN A
15 TRANSACTION
R! ONLY STATEFUL SESSION BEANS
R" ONLY STATELESS SESSION BEANS
R# BOTH STATEFUL AND STATELESS SESSION BEANS
R$ NEITHER STATEFUL NOR STATELESS SESSION BEANS
&OR SESSION BEANS WHICH ARE THE RESPONSIBILITY OF THE #ONTAINER #HOOSE ALL
16 THAT APPLY
R! )NVOKING THE LOCAL INTERFACE FUHDWH METHOD
R" )NVOKING THE JHW6HVVLRQ&RQWH[W METHOD
R# )NVOKING THE HME&UHDWH METHOD
R$ %NSURING THAT THE HME5HPRYH METHOD IS ALWAYS INVOKED
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
&OR THIS DRAG AND DROP TYPE QUESTION YOU CAN USE EACH ELEMENT ONLY ONCE
17 7HICH INTERFACE SHOULD BE MATCHED WITH WHICH FACT SO THAT ALL FOUR MATCHES
ARE CORRECT
REMOTE COMPONENT A (AS A JHW+RPH+DQGOH METHOD
REMOTE HOME B EXTENDS µMDYD[HME(-%2EMHFW¶
LOCAL COMPONENTC METHODS MUST ./4 THROW
µMDYDUPL5HPRWH([FHSWLRQ¶
LOCAL HOME D CAN BE USED TO RETRIEVE AN %*",OCAL/BJECT
7HICH CAN BE CALLED BY THE CONTAINER DURING THE LIFECYCLE OF A SESSION BEAN
18 #HOOSE ALL THAT APPLY
R! FUHDWH
R" BEAN CONSTRUCTOR
R# VHW5ROOEDFN2QO\
R$ JHW8VHU7UDQVDFWLRQ
R% HME5HPRYH
7HICH STATEMENTS ABOUT A SESSION BEAN CLASS ARE TRUE #HOOSE ALL THAT APPLY
19
R! 4HEY CAN BE MARKED @lNAL
R" 4HEY DO NOT NEED A NO
ARGUMENT CONSTRUCTOR
R# 4HEIR COMPONENT INTERFACE METHODS CAN BE @PRIVATE
R$ 4HEIR BUSINESS METHOD NAMES MUST START WITH hEJBv
R% 4HEIR @EJB#REATE METHODS MUST NOT BE DECLARED AS @lNAL
&OR WHICH TYPE OF BEAN CAN THE 3ESSION3YNCHRONIZATION INTERFACE BE
20 IMPLEMENTED
R! ONLY STATEFUL SESSION BEANS
R" ONLY STATELESS SESSION BEANS
R# BOTH STATEFUL AND STATELESS SESSION BEANS
R$ NEITHER STATEFUL NOR STATELESS SESSION BEANS
\RXDUHKHUH
FRIIHHFUDPPRFNH[DP
7HICH STATEMENTS ARE TRUE FOR STATELESS SESSION BEAN INSTANCES #HOOSE ALL
21 THAT APPLY
R! !NY INSTANCE CAN BE USED FOR ANY CLIENT
R" #ONVERSATIONAL STATE MUST BE RETAINED ACROSS METHODS
R# #ONVERSATIONAL STATE MUST BE RETAINED ACROSS TRANSACTIONS
R$ 4HEY CAN BE PASSIVATED
R% 4HEY DO NOT SUPPORT TRANSACTIONS
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
0RFN([DP$QVZHUV
(spec: 71)
7HICH STATEMENTS ABOUT SESSION BEANS ARE TRUE #HOOSE ALL THAT APPLY
1 what entity
R! ! STATEFUL SESSION BEAN IS TYPICALLY USED TO REPRESENT A ROW IN A DATABASE -thatsÕsdo
bean
R" 4HE CLIENT MUST CALL THE EJB!CTIVATE METHOD BEFORE CALLING ANY BUSINESS - only the container calls
METHODS ejbActivate()
R# ! STATEFUL SESSION BEANS lELDS CAN CONTAIN CLIENT CONVERSATIONAL STATE
R$ 4HEY ARE TYPICALLY USED AS ASYNCHRONOUS MESSAGE CONSUMERS
7HICH LISTS CORRECTLY SEQUENCE SOME OF THE STEPS IN A SESSION BEANS LIFECYCLE (spec: 77)
2 #HOOSE ALL THAT APPLY
R! HME&UHDWH QHZ,QVWDQFH VHW6HVVLRQ&RQWH[W
R" QHZ,QVWDQFH VHW6HVVLRQ&RQWH[W HME&UHDWH
R# HME&UHDWH VHW6HVVLRQ&RQWH[W QHZ,QVWDQFH
R$ QHZ,QVWDQFH HME&UHDWH VHW6HVVLRQ&RQWH[W
R% VHW6HVVLRQ&RQWH[W QHZ,QVWDQFH HME&UHDWH
3 7HICH TYPES OF SESSION BEAN INSTANCE lELDS CAN BE SUCCESSFULLY PASSIVATED AND (spec: 71)
REACTIVATED #HOOSE ALL THAT APPLY
R! ! REFERENCE TO THE REMOTE HOME INTERFACE
R" ! REFERENCE TO THE 5SER4RANSACTION INTERFACE ization
be r, pa ss ivat io n could be serial
R# ! REFERENCE TO A DATABASE CURSOR - remem
R$ ! REFERENCE TO THE 3ESSION#ONTEXT OBJECT
R% ! REFERENCE TO A SOCKET - remember, passivation cou
ld be serialization
\RXDUHKHUH
PRFNH[DPDQVZHUV
(spec: 97)
7HICH ARE VALID REMOTE COMPONENT INTERFACES FOR A SESSION BEAN #HOOSE ALL
4 THAT APPLY
R! SXEOLFLQWHUIDFH0\%HDQH[WHQGVMDYD[HME(-%2EMHFW^
YRLGP\0HWKRG - needs RemoteException
`
R" SXEOLFLQWHUIDFH0\%HDQH[WHQGVMDYD[HME(-%2EMHFW
WKURZV5HPRWH([FHSWLRQ^
- illegal Java !
YRLGP\0HWKRG
`
R# SXEOLFLQWHUIDFH0\%HDQH[WHQGV - nope, gotta be EJBObj
ect
MDYD[HME(-%+RPH2EMHFW^
YRLGP\0HWKRG WKURZV5HPRWH([FHSWLRQ
`
R$SXEOLFLQWHUIDFH0\%HDQH[WHQGVMDYD[HME(-%2EMHFW^
YRLGP\0HWKRG WKURZV5HPRWH([FHSWLRQ
`
)F A CLIENT MAKES A CALL TO A SESSION OBJECT THAT HAS BEEN REMOVED BY THE (spec: 79)
5 CONTAINER WHICH EXCEPTIONS CAN BE THROWN #HOOSE ALL THAT APPLY
R! MDYDUPL5HPRWH([FHSWLRQ )
R" MDYD[HME5HPRYH([FHSWLRQ - this happen
s only on remove(
R# MDYDUPL1R6XFK2EMHFW([FHSWLRQ
R$ MDYD[HME1R6XFK(QWLW\([FHSWLRQ - clients donÕt
see this
R% MDYD[HME2EMHFW1RW)RXQG([FHSWLRQ - this is for entity Þn
ders
'IVEN (spec: 98)
6 0\%HDQFUHDWH 6WULQJQDPH WKURZV&UHDWH([FHSWLRQ
5HPRWH([FHSWLRQ
7HICH SESSION BEAN INTERFACE CAN CONTAIN THIS METHOD
must have
R! /NLY STATEFUL SESSION BEANS
Stateless bearangusment create
R" /NLY STATELESS SESSION BEANS only a no-
R# "OTH STATEFUL AND STATELESS SESSION BEANS
R$ .EITHER STATEFUL NOR STATELESS SESSION BEANS
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
(spec: 79, 88)
7HAT IS TRUE ABOUT A SESSION BEANS LIFECYCLE #HOOSE ALL THAT APPLY
7 killed
R! )F A BUSINESS METHOD THROWS A SYSTEM EXCEPTION THE BEAN WILL BE - no, the bean is
PASSIVATED
R" ! PASSIVATED BEAN MUST BE ACTIVATED BEFORE IT CAN BE REMOVED - nope
R# ! STATELESS SESSION BEANS REMOVAL MUST BE INITIATED BY THE CLIENT NOT THE
CONTAINER
R$ 3TATELESS SESSION BEANS CANNOT IMPLEMENT THE 3ESSION3YNCHRONIZATION
INTERFACE
(spec: 71-72)
7HICH ARE REQUIRED OF THE BEAN PROVIDER TO ENSURE THAT A SESSION BEAN IS
8 SUCCESSFULLY PASSIVATED #HOOSE ALL THAT APPLY
R! 4HE PROVIDER MUST CALLHME3DVVLYDWH
R" 4HE PROVIDER MUST ALWAYS ADD BUSINESS LOGIC TO THEHME3DVVLYDWH
METHOD IF THE BEAN IS STATEFUL
R# 4HE PROVIDER MUST NOT CLOSE ANY DATABASE CONNECTIONS BEFORE
HME3DVVLYDWH COMPLETES
R$ 4HE PROVIDER MUST ASSUME THAT ANY STATE STORED IN INSTANCE lELDS MARKED
TRANSIENT WILL BE LOST
R% 4HE PROVIDER MUST ASSUME THAT ANY REFERENCE TO THE 3ESSION#ONTEXT
OBJECT WILL BE NOT SURVIVE PASSIVATION IF THE 3ESSION#ONTEXT OBJECT IS NOT
SERIALIZABLE , no matter what!
Container MUST passivate your context
'IVEN A STATELESS SESSION BEAN WITH CONTAINER
MANAGED TRANSACTION (spec: 90)
9 DEMARCATION FROM WHICH METHODS CAN YOU ACCESS ANOTHER BEAN #HOOSE
ALL THAT APPLY
R! HME&UHDWH
R" HME5HPRYH
R# A BUSINESS METHOD - also true for stateless BMT beans
R$ VHW6HVVLRQ&RQWH[W
\RXDUHKHUH
PRFNH[DPDQVZHUV
.OTE 4HE REAL EXAM HAS SEVERAL TYPES OF @DRAG AND DROP QUESTIONS THAT (API docs)
10 WERE GOING TO DO A LAME JOB OF SIMULATING WITH THIS QUESTION
-ATCH THE METHODS ON THE LEFT WITH THE INTERFACES IN WHICH THOSE METHODS
CAN BE FOUND ON THE RIGHT ! MATCH IS CORRECT IF THE METHOD IS EITHER DECLARED
IN OR INHERITED BY THE INTERFACE .OTE 4HERE MAY BE SOME MANY TO ONE AND
ONE TO MANY RELATIONSHIPS IN YOUR ANSWER
! AFTER#OMPLETION 1 3ESSION3YNCHRONIZATION
" GET5SER4RANSACTION 2 3ESSION#ONTEXT
# AFTER"EGIN 1 3ESSION"EAN
$ IS#ALLER)N2OLE 2 5SER4RANSACTION
% GET2OLL"ACK/NLY 2
& SET3ESSION#ONTEXT 3
' SET2OLLBACK/NLY 2,4
7HAT IS TRUE ABOUT A SESSION BEANS LIFECYCLE #HOOSE ALL THAT APPLY (spec: 70)
11
R! 4HE CONTAINER WILL ALWAYS CREATE A NEW SESSION BEAN INSTANCE WHEN
THE CLIENT INVOKES THE FUHDWH METHOD ON THE HOME INTERFACE OF A
STATELESS BEAN - Container makes stateless beans whenever it wants
R" 4HE CONTAINER WILL ALWAYS CALL HME5HPRYH WHEN THE CLIENT INVOKES - Container remove
s
THE UHPRYH METHOD ON A STATELESS BEANS HOME INTERFACE stateless bean ONLYa
R# ! SESSION BEAN CANNOT BE PASSIVATED WHILE IT IS IN A TRANSACTION when it wants to shrink
the pool
R$ 4HE VHW6HVVLRQ&RQWH[W METHOD IS NOT INVOKED DURING A STATELESS
BEANS LIFECYCLE
12 7HICH OF THE FOLLOWING METHODS ARE CONTAINER CALLBACK METHODS #HOOSE ALL (spec: 73)
THAT APPLY
R! HME3DVVLYDWH
R" VHW5ROOEDFN2QO\
R# VHW6HVVLRQ&RQWH[W
R$ JHW5ROOEDFN2QO\
R% JHW8VHU7UDQVDFWLRQ
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
)N WHAT CASES WILL THE CONTAINER FAIL TO CALL EJB2EMOVE ON A SESSION BEAN (spec: 82)
13 #HOOSE ALL THAT APPLY
R! )F THE CONTAINER CRASHES
R" )F AN APPLICATION EXCEPTION IS THROWN FROM A BUSINESS METHOD
R# )F A TIMEOUT OCCURS WHILE THE BEAN IS IN THE METHOD READY STATE
R$ )F AN APPLICATION EXCEPTION IS THROWN FROM WITHIN A TRANSACTION
7HICH METHODS ALLOW BOTH STATEFUL AND STATELESS SESSION BEANS WITH BEAN (spec: 80, 90)
14 MANAGED TRANSACTION DEMARCATION TO ACCESS 5SER4RANSACTION METHODS
#HOOSE ALL THAT APPLY
R! HME&UHDWH r stateful only
- fo
R" HME5HPRYH
R# A BUSINESS METHOD
R$ VHW6HVVLRQ&RQWH[W
15 &OR WHICH TYPE OF BEAN CAN THE CONTAINER PASSIVATE AN INSTANCE THAT IS IN A (spec: 70)
TRANSACTION
R! ONLY STATEFUL SESSION BEANS
R" ONLY STATELESS SESSION BEANS
R# BOTH STATEFUL AND STATELESS SESSION BEANS
R$ NEITHER STATEFUL NOR STATELESS SESSION BEANS
&OR SESSION BEANS WHICH ARE THE RESPONSIBILITY OF THE #ONTAINER #HOOSE ALL
16 THAT APPLY
it
R! )NVOKING THE LOCAL INTERFACE FUHDWH METHOD- client calls
R" )NVOKING THE JHW6HVVLRQ&RQWH[W METHOD - Container calls setSessionContext
R# )NVOKING THE HME&UHDWH METHOD
R$ %NSURING THAT THE HME5HPRYH METHOD IS ALWAYS INVOKED - might b
passivatede bmeisa sed if
bean throws a n times out, or
exception runtime
\RXDUHKHUH
PRFNH[DPDQVZHUV
&OR THIS DRAG AND DROP TYPE QUESTION YOU CAN USE EACH ELEMENT ONLY ONCE
17 7HICH INTERFACE SHOULD BE MATCHED WITH WHICH FACT SO THAT ALL FOUR MATCHES
ARE CORRECT
b
REMOTE COMPONENT A (AS A JHW+RPH+DQGOH METHOD
a
REMOTE HOME B EXTENDS µMDYD[HME(-%2EMHFW¶
c
LOCAL COMPONENTC METHODS MUST ./4 THROW
µMDYDUPL5HPRWH([FHSWLRQ¶
LOCAL HOME D CAN BE USED TO RETRIEVE AN %*",OCAL/BJECT
d
7HICH CAN BE CALLED BY THE CONTAINER DURING THE LIFECYCLE OF A SESSION BEAN (spec: 90, 97)
18 #HOOSE ALL THAT APPLY
R! FUHDWH - client calls
R" BEAN CONSTRUCTOR
R# VHW5ROOEDFN2QO\
- bean calls these
R$ JHW8VHU7UDQVDFWLRQ
R% HME5HPRYH
19 7HICH STATEMENTS ABOUT A SESSION BEAN CLASS ARE TRUE #HOOSE ALL THAT APPLY (spec: 95)
R! 4HEY CAN BE MARKED @lNAL
R" 4HEY DO NOT NEED A NO ARGUMENT CONSTRUCTOR
R# 4HEIR COMPONENT INTERFACE METHODS CAN BE @PRIVATE
R$ 4HEIR BUSINESS METHOD NAMES MUST START WITH hEJBv
R% 4HEIR @EJB#REATE METHODS MUST NOT BE DECLARED AS @lNAL
20 &OR WHICH TYPE OF BEAN CAN THE 3ESSION3YNCHRONIZATION INTERFACE BE (spec: 75)
IMPLEMENTED
R! ONLY STATEFUL SESSION BEANS
R" ONLY STATELESS SESSION BEANS
R# BOTH STATEFUL AND STATELESS SESSION BEANS
R$ NEITHER STATEFUL NOR STATELESS SESSION BEANS
&KDSWHU
VHVVLRQEHDQOLIHF\FOH
7HICH STATEMENTS ARE TRUE FOR STATELESS SESSION BEAN INSTANCES #HOOSE ALL
21 THAT APPLY
(spec: 88)
R! !NY INSTANCE CAN BE USED FOR ANY CLIENT
R" #ONVERSATIONAL STATE MUST BE RETAINED ACROSS METHODS
R# #ONVERSATIONAL STATE MUST BE RETAINED ACROSS TRANSACTIONS
R$ 4HEY CAN BE PASSIVATED
R% 4HEY DO NOT SUPPORT TRANSACTIONS
\RXDUHKHUH
entity bean intro
5 4
4 (QWLWLHVDUH3HUVLVWHQW
DQGWKHQ,VDLG´<RXZDQWDSLHFH
RIPH"*RDKHDGWDNH\RXUEHVWVKRWEXGG\µ
+HGLGQ·WNQRZKHZDVPHVVLQJZLWKDQHQWLW\EHDQ6R
KHWKUHZDQH[FHSWLRQWKHQKHFUDVKHGWKHVHUYHU
EXW,·PVWLOOKHUH,ZRQ·WJRGRZQWKDWHDV\QR
VLUHH$VORQJDV,·PLQWKHGDWDEDVH,·OOMXVW
NHHSFRPLQJEDFNVRGR\RXUZRUVW
(QWLW\EHDQVSHUVLVW(QWLW\EHDQVH[LVW(QWLW\EHDQVDUH7KH\DUHREMHFW
UHSUHVHQWDWLRQVRIVRPHWKLQJLQDQXQGHUO\LQJSHUVLVWHQWVWRUH 7KLQN GDWDEDVH
EHFDXVHPRVWHQWLW\EHDQVUHSUHVHQWVRPHWKLQJIURPDUHODWLRQDOGDWDEDVH ,I\RX
KDYHD&XVWRPHUHQWLW\EHDQWKHQRQHEHDQPLJKWUHSUHVHQWWKHHQWLW\7\OHU'XUGHQ
,'ZKLOHDQRWKHULVWKHHQWLW\'RQQ\'DUNR,'7ZREHDQVUHSUHVHQWLQJWZR
UHDOHQWLWLHV$QHQWLW\EHDQLVVLPSO\DUHDOL]DWLRQRIVRPHWKLQJWKDWDOUHDG\H[LVWVLQD
SHUVLVWHQWVWRUH6RPHWKLQJWKDWDOUHDG\LV$QGWKHVHVXFNHUVDUHKDUGWRNLOO$VORQJDV
WKHGDWDLVLQWKHGDWDEDVHLWFDQNHHSFRPLQJEDFNLQWKHIRUPRIDQHQWLW\EHDQ
WKLVLVDQHZFKDSWHU
H[DPREMHFWLYHV
(QWLW\%HDQV
2IILFLDO :KDWLWUHDOO\PHDQV
,GHQWLI\FRUUHFWDQGLQFRUUHFWVWDWHPHQWVRU <RXKDYHWRNQRZWKHUXOHVIRUDQHQWLW\EHDQKRPH
H[DPSOHVDERXWWKHFOLHQWYLHZRIDQHQWLW\ LQWHUIDFHDQGHVSHFLDOO\KRZWKH\¶UHGLIIHUHQWIURPD
EHDQ¶VORFDODQG5HPRWHKRPHLQWHUIDFH VHVVLRQEHDQ<RXPXVWNQRZWKDW\RX¶UHQRWUHTXLUHG
LQFOXGLQJWKHFRGHXVHGWRORFDWHDQHQWLW\ WRKDYHDFUHDWH PHWKRGEXWWKDW\RXPXVWKDYH
EHDQ¶VKRPHLQWHUIDFHDQGWKHKRPH DWOHDVWRQH¿QGHUPHWKRG¿QG%\3ULPDU\.H\ <RX
LQWHUIDFHPHWKRGVSURYLGHGWRWKHFOLHQW KDYHWRNQRZWKDWWKHUHWXUQW\SHRIVLQJOHHQWLW\
¿QGHUVDQGFUHDWHPHWKRGVPXVWDOZD\VEHWKH
FRPSRQHQWLQWHUIDFHW\SHEXWWKDWPXOWLHQWLW\¿QGHUV
PXVWUHWXUQD&ROOHFWLRQ<RXPXVWNQRZWKDWVLQJOH
HQWLW\¿QGHUVWKURZDQ2EMHFW1RW)RXQG([FHSWLRQLI
WKHUH¶VQRPDWFKLQWKHGDWDEDVHEXWWKDWPXOWLHQWLW\
¿QGHUVDOZD\VUHWXUQD&ROOHFWLRQHYHQLILWVHPSW\
<RXDOVRKDYHWRNQRZWKDWKRPHEXVLQHVVPHWKRGV
DUHQ¶WUHTXLUHGWRUHWXUQWKHFRPSRQHQWLQWHUIDFH²
WKH\FDQUHWXUQDQ\WKLQJWKDWFDQEHOHJDOO\SDVVHG
<RXPXVWDOVRNQRZWKDWLIDQHQWLW\LVGHOHWHGIURPWKH
GDWDEDVHLWFDQQRORQJHUEHUHSUHVHQWHGDVDQHQWLW\
EHDQEXWWKDWLIDQHQWLW\EHDQLQVWDQFHGLHV WKURXJK
DQH[FHSWLRQRUHYHQDVHUYHUFUDVK WKHHQWLW\LWVHOI
SHUVLVWV$VORQJDVWKHHQWLW\LVLQWKHGDWDEDVHLWFDQ
EHUHSUHVHQWHGE\DQHQWLW\EHDQ
,GHQWLI\FRUUHFWDQGLQFRUUHFWVWDWHPHQWV 7KHUXOHVIRUKRZ\RXGH¿QHWKLQJVLQDQHQWLW\
RUH[DPSOHVDERXWWKHFOLHQWYLHZRIDQ FRPSRQHQWLQWHUIDFHDUHLGHQWLFDOWRWKHUXOHVIRUD
HQWLW\EHDQ¶VORFDOFRPSRQHQWLQWHUIDFH VHVVLRQEHDQFRPSRQHQWLQWHUIDFH%XWLQREMHFWLYH
(-%/RFDO2EMHFW DQG5HPRWHFRPSRQHQW ZH¶OOORRNDWKRZWKHPHWKRGVEHKDYHGLIIHUHQWO\
LQWHUIDFH (-%2EMHFW
,GHQWLI\WKHXVHV\QWD[DQGEHKDYLRURIWKH 7KHEHKDYLRURIUHPRYH LVSURIRXQGO\GLIIHUHQWIRU
IROORZLQJHQWLW\EHDQKRPHPHWKRGW\SHV DQHQWLW\EHDQDQG\RXPXVWXQGHUVWDQGWKDWFDOOLQJ
IRU&03 ¿QGHUPHWKRGVFUHDWHPHWKRGV UHPRYH UHDOO\PHDQV³GHOHWHWKLVHQWLW\IURPWKH
UHPRYHPHWKRGVDQGKRPHEXVLQHVV XQGHUO\LQJSHUVLVWHQWVWRUH´<RXPXVWNQRZWKDW
PHWKRGV FDOOLQJFUHDWH RQDQHQWLW\EHDQPHDQV³LQVHUWD
QHZURZLQWKHGDWDEDVH´ 2.WHFKQLFDOO\LWPHDQV
³FUHDWHDQHZHQWLW\LQWKHXQGHUO\LQJSHUVLVWHQWVWRUH´
<RXPXVWNQRZWKDWLIDQHQWLW\LVGHOHWHGIURPWKH
XQGHUO\LQJSHUVLVWHQWVWRUHWKHHQWLW\EHDQµGLHV¶HYHQ
WKRXJKWKHEHDQLQVWDQFHJRHVEDFNWRWKHSRRO
&KDSWHU
HQWLW\EHDQLQWUR
?PI\¼[IVMV\Q\aJMIV'
/DVW 'DUNR
)LUVW 'RQQ\
&86720(57$%/( ,'
/DVW )LUVW ,'
&XV Q
'DUNR 'RQQ\ WRPHU%HD
-RQHV ,QGLH
/DVW -RQHV
/LQ 7DP
)LUVW ,QGLH
,'
&XV Q
e. WRPHU%HD
s re pr es en t da ta in a persistent stor
Entity bean means that entity (a bean ob- /DVW /LQ
That almost always ti on al da ta base ro ws lthough it )LUVW 7DP
to re la ce
jects map
lo t m or e co m pl ex than just one instan
can be a ,'
maps to one row...)
&XV Q
WRPHU%HD
!N ENTITY BEAN IS AN OBJECT
ORIENTED WAY OF LOOKING AT IN A PERSISTENT STORE 4HE SPEC
SAYS hPERSISTENT STOREv AND DOESNT SPECIFY WHAT THAT PERSISTENT STORE MUST BE )T COULD
BE ANYTHING THAT SATISlES THE REQUIREMENTS OF @PERSISTENCE INCLUDING A RELATIONAL
DATABASE AN OBJECT DATABASE OR EVEN SOMETHING AS LAME AND INEFlCIENT AS STORING
SERIALIZED OBJECTS TO lLES "UT IN MOST REAL
WORLD SCENARIOS WERE TALKING A RELATIONAL
DATABASE !ND THAT MEANS AN INDIVIDUAL ROW IN A TABLE MAPS TO A UNIQUE ENTITY BEAN
4HE OBJECT
TO
RELATIONAL /2 MAPPING COULD BE A LOT MORE COMPLEX THAN A SIMPLE ONE
ROW EQUALS ONE BEAN SCENARIO BUT WELL GET INTO THAT IN THE NEXT CHAPTER
%NTITY BEANS ARE DATA OBJECTS 4HEY ARETHINGS .OUNS !S OPPOSED TO SESSION BEANS
WHICH ARE PROCESSES 6ERBS %NTITY BEANS MIGHT REPRESENT THINGS LIKE PEOPLE PRODUCTS
ORDERS BOOKINGS INVENTORY ANIMALSTHINGS %NTITY BEANS WOULD NOT REPRESENT
THINGS LIKE CREDIT CARD VERIlCATION ADVISOR SERVICE ORDER SUBMISSION MEMBERSHIP
REGISTRATION PROCESSES
/F COURSE IN VIRTUALLY ALL WELL
DESIGNED %*" APPLICATIONS ENTITY BEANS WILL BE COMBINED
WITH SESSION BEANS WHERE THE CLIENT INTERACTS WITH THE PROCESS SESSION BEAN AND THE
SESSION BEAN USES ENTITY BEANS WHEN IT NEEDS DATA AS PART OF THE PROCESS
\RXDUHKHUH
HQWLW\EHDQV
-V\Q\QM[^[-V\Q\a*MIV[
!N ENTITY IS THE REAL THING THAT THE ENTITY BEAN REPRESENTS
)T DOESNT WORK IN REVERSE 4HE ENTITY DOES NOT REPRESENT
THE ENTITY BEAN 4HAT MIGHT SEEM LIKE A SUBTLE POINT BUT
ITS NOT 4HE DIFFERENCE IS IN KNOWING WHICH ONE IS REAL
AND WHICH ONE IS SIMPLY A VIEW OF THE REAL THING
)N OTHER WORDS IF YOU DELETE THE REAL ENTITY THE THING
IN THE DATABASE THE ENTITY BEAN DISINTEGRATES 0OOF "UT +L,·OOEHSOD\LQJ\RX
IF THE ENTITY BEAN DIES AS AN INSTANCE ON THE HEAP IT IRUWKLVWUDQVDFWLRQVR,·G
DOESNT KILL THE REAL ENTITY IN THE DATABASE "Y THE WAY OLNHWRNQRZDOLWWOHPRUH
DERXW\RX
WERE NOW GOING TO SAY @DATABASE INSTEAD OF @UNDERLYING
PERSISTENT STORE BUT YOU AND ) BOTH KNOW THAT THESE TWO
ARE NOT NECESSARILY SYNONYMOUS AND THAT THE @UNDERLYING 'DUNR 'RQQ\
PERSISTENT STORE NEED NOT BEBUT USUALLY ISA DATABASE
4HERE WEVE SAID IT entity
3O YOU WONT HAVE THE RIGHT PERSPECTIVE IF YOU THINK OF entity b
THE ENTITY BEAN AS SOME DATA OBJECT THAT HAPPENS TO BE ean
BACKED UP TO PERSISTENT STORAGE )N NEARLY ALL APPLICATIONS
THE VAST MAJORITY OF ENTITIES USED IN THE APP ARE NOT
REALIZED AS ENTITY BEANS AT ANY GIVEN TIME )NSTEAD MOST
ENTITY BEANS BECOME A REPRESENTATION OF AN UNDERLYING
ENTITY ONLY WHEN THAT PARTICULAR ENTITY IS NEEDED IN THE
APPLICATION LOGIC
&OR EXAMPLE IMAGINE YOUR DATABASE HAS
CUSTOMERS "UT AT ANY GIVEN TIME CLIENTS THROUGH
BUSINESS PROCESSES IN SESSION BEANS ARE USING ONLY
OF THOSE CUSTOMERS )N THAT CASE YOU PROBABLY HAVE ONLY
ENTITY BEANS ACTIVELY REPRESENTING CUSTOMER ENTITIES
4HE REST OF THE CUSTOMER ENTITIES ARE JUST SITTING
THERE IN THE DATABASE WAITING FOR A CLIENT PROCESS TO
NEED THEM
4HINK OF ENTITY BEANS AS ACTORS )N THE SCENARIO WE JUST
DESCRIBED YOU HAVE ACTORS EACH PLAYING A DIFFERENT
ROLE OF SOMEONE IN THE DATABASE "UT THE OTHER
ENTITIES IN THE DATABASETHE OTHER CUSTOMERSDO NOT
HAVE ANYONE PLAYING THEM
"UT AS SOON AS A CLIENT COMES ALONG AND TRIES TO GET ONE
OF THOSE OTHER SAY TO CHANGE THAT CUSTOMERS
ADDRESS OR CHECK ITS CREDIT LIMIT AN ACTOR ENTITY BEAN
WILL BE CHOSEN TO PLAY THE ROLE OF THAT SELECTED CUSTOMER
&KDSWHU
HQWLW\EHDQLQWUR
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: *UST SO )VE GOT THIS STRAIGHT
(QWLW\EHDQVDUHDQ22ZD\RI
YOUR ENTIRE DATABASE DOESNT GET
LOADED IN AS ENTITY BEANS RIGHT )
MEAN THAT WOULD BE INSANE ORRNLQJDWGDWDLQDSHUVLVWHQWVWRUH
A: 9OURE RIGHT AT LEAST ABOUT THE $QHQWLW\LVDUHDOXQLTXHO\
FIRST PART .O YOUR ENTIRE DATABASE
IS ./4 LOADED IN AS ENTITY BEANS LGHQWLILDEOHWKLQJWKDWH[LVWV
4HINK OF ENTITY BEANS AS JUST IN TIME
REPRESENTATIONS OF ONLY THE ENTITIES IN VRPHZKHUHRXWVLGHRI(-%DQG
THE DATABASE THAT ARE ACTIVELY NEEDED
BY CLIENT BUSINESS PROCESSES WKHHQWLW\EHDQ·VMRELVVLPSO\WR
"UT DOES THAT MEAN IT WOULD BE INSANE
TO LOAD THEM ALL IN .OT NECESSARILY %(&20(DQ22YLHZRIWKDWUHDO
7HILE IT WOULD CERTAINLY UP YOUR
RESOURCE REQUIREMENTS ESPECIALLY IF SHUVLVWHQWHQWLW\
THE DATA IN THE UNDERLYING DATABASE
CONTINUES TO GROW JUST THINK OF HOW
&!34 IT WOULD BE 7KHHQWLW\EHDQFDQQRWH[LVW
!LTHOUGH THERE IS NOTHING IN THE
SPEC THAT REQUIRES THIS A VENDOR CAN ZLWKRXWWKHUHDOHQWLW\EXWWKHUHDO
CHOOSE TO LET YOU CONFIGURE THE APP
IN SUCH A WAY THAT IT DOES PRE LOAD HQWLW\FDQH[LVWZLWKRXWWKHEHDQ
ALL THE ENTITIES IN THE DATABASE INTO
BEANS 4HAT GIVES YOU ESSENTIALLY A
LIGHTENING FAST IN MEMORY DATABASE $QHQWLW\EHDQLV127WKHUHDO
THAT STILL SYNCHRONIZES ITSELF WITH THE
REAL UNDERLYING STORE YOULL SEE HOW IN HQWLW\LW·VMXVWDUHSUHVHQWDWLRQRU
A MOMENT
!ND TO TAKE IT A STEP FURTHER IF YOUR ´UHDOL]DWLRQµRIWKHHQWLW\
SERVER GIVES YOU A WAY TO TELL IT THAT
YOUR ENTITY BEANS ARE YOUR ONLY ACCESS
TO THE DATABASE THEN THE SERVER CAN
EVEN ELIMINATE THE SYNCHRONIZATION
AND JUST KEEP THE DATABASE IN MEMORY
SAVING ONLY WHAT IT NEEDS AS A BACKUP
IN CASE OF A CRASH
\RXDUHKHUH
HQWLW\EHDQV
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: 7HY DO YOU EVEN .%%$ ENTITY BEANS 7HY
NOT JUST GO STRAIGHT TO THE DATABASE FROM A SESSION
BEAN
A: 9OU CAN GO FROM A SESSION BEAN DIRECTLY TO THE
DATABASE (ECK YOU CAN ALWAYS GO FROM THE CLIENT TO
THE DATABASE BUT THEN WERE BACK TO THE OLD NON
SCALABLE CLIENT
SERVER TWO
TIER ARCHITECTURE AND WE
ALL KNOW WHY THAT IS USUALLY A BAD IDEA DOESNT SCALE
BUSINESS LOGIC IS IN THE CLIENT HARD TO MAINTAIN ETC
QRZ
)F YOU USE ENTITY BEANS INSTEAD OF DIRECT CALLS TO
RQ¶WQHHGWRN
<RXG H[DP
THE DATABASE YOU GET TO TAKE ADVANTAGE OF ALL THE
%&IRUWKH
#ONTAINERS SERVICES INCLUDING THE ABILITY TO WRAP 64/RU-'
SEVERAL DATABASE TRIPS IN ONE TRANSACTION "UT AS YOULL WRNQRZ
UW < R X'2QHHG /
SEE ONE OF THE BIGGEST BENEFITS OF USING ENTITY BEANS
:HOOIRUWK
HPRVW S D LPLODUWR64
IS THAT THE #ONTAINER AUTOMATICALLY SYNCHRONIZES KLVLQ V R PHZD\VV ERX W
(-%4/Z
KLF KLQJD
NQRZDQ\W U
BETWEEN THE DATABASE AND THE ENTITY BEAN
X W\RX GRQ¶WQHHGWR [D PGRHVQ¶WFRYH
E K LOH WK HH
$QGZ EHDQ
"UT THE SINGLE MOST COMPELLING REASON FOR ENTITY 64/LWVHOI QRZWKDWD
BEANS IS THAT THEY TAKE YOU FROM THE RELATIONAL WORLD & \R X' 2QHHGWRN UFHIURPZKLFK
-'% WD6RX
YD[VTO'D LRQ<RX¶OO
TO THE OBJECT WORLD )N OTHER WORDS YOU GET TO STAY ORRNXSDMD MD YD VTO&RQQHFW H
WKHEHDQF
DQJH WD RNXSVLQWK
WITH OBJECTS ALL THE WAY DOWN IN YOUR APP RATHER
D ER X W' D WD6RXUFHOR
THAN MAPPING BACK AND FORTH IN YOUR CODE !ND IF OHDUQPRUH QPHQW
(-%HQYLUR
YOURE USING #-0 WHICH YOU ALMOST CERTAINLY WILL BE FKDSWHURQ
FOR REASONS THAT WILL BECOME OBVIOUS A LITTLE LATER
YOU WONT HAVE A SHRED OF 31, IN YOUR BEAN CODE )N
FACT WITH #-0 ENTITY BEANS YOU GET TO PRETEND THAT
YOUR ENTIRE DATABASE EXISTS SOLELY AS OBJECTS ON THE
HEAP
3URE MAYBE YOURE COMFORTABLE WITH *$"# BUT WHAT
ABOUT THE REST OF THE TEAM !ND LETS FACE ITTHINK
ING IN // MAKES A LOT MORE SENSE THAN HAVING TO
SHIFT BETWEEN // AND ENTITY CODE
&KDSWHU
HQWLW\EHDQLQWUR
-V\Q\aJMIV[NZWU\PMKTQMV\¼[XWQV\WN^QM_
:LWKWKHFXVWRPHUEHDQ ,ZDQWWR
LQSXWQHZFXVWRPHUVUHPRYHFXVWRPHUV
DQGXSGDWHFXVWRPHULQIRUPDWLRQ,DOVR
ZDQWWRGRTXHULHVWRVHOHFWFXVWRPHUV
EDVHGRQVRPHFULWHULD$QG,·PVRUU\EXW
,MXVW5()86(WRWKLQNLQ64/<RXNQRZ
ZKDWWKH\VD\RQFH\RX·YHWULHGDQ
REMHFW\RX·OOQHYHUJREDFN
7KHFOLHQWZDQWVWRGRGDWDEDVH
VWXIIEXWLQD-DYD22ZD\
0DNHDQHZHQWLW\ DQ64/,16(57
'HOHWHDQHQWLW\ DQ64/'(/(7(
8SGDWHHQWLW\VWDWH DQ64/83'$7(
6HDUFKTXHU\RQHQWLWLHV DQ64/6(/(&7
4HE CLIENT INTERFACE FOR AN ENTITY BEAN IS A
LITTLE DIFFERENT FROM THAT OF A SESSION BEAN &OR
EXAMPLE WHEN A SESSION BEAN CLIENT WANTS TO
GET A BEAN SO THAT IT CAN CALL THE BEANS BUSINESS
METHODS THE CLIENT CALLS CREATE AND THE
#ONTAINER ALLOCATES A NEW %*" OBJECT
"UT WHAT IF A CLIENT WANTS TO USE AN EXISTING ENTITY
BEAN &OR EXAMPLE WHAT IF THE CLIENT DOESNT
WANT JUST SOME RANDOM ENTITY BUT WANTS THE %*"
OBJECT OF A SPECIlC ENTITY SAY "ART 3IMPSON
)N THAT CASE A CREATE WONT WORK 4HE CLIENT
DOESNT WANT A NEW ENTITY BUT WANTS A REFERENCE TO
AN EXISTING ENTITY 3O AS YOULL SEE IN A MINUTE THE
CLIENT INTERFACE FOR AN ENTITY BEAN ADDS AND MUST
HAVE ONE OR MORE lNDER METHODS
4HE NEXT TWO PAGES ARE HIGH
LEVEL PICTURES OF
HOW ENTITY BEANS ARE CREATED INSERT AND FOUND
SELECT 4HE SCENARIOS IN THESE PICTURES WILL BE
lLLED IN WITH A LOT MORE DETAIL AS WE GO THROUGH
THIS CHAPTER BUT FOR NOW YOU CAN RELAX
\RXDUHKHUH
HQWLW\EHDQV
(QWLW\EHDQRYHUYLHZ
6FHQDULR FOLHQWZDQWVDUHIHUHQFHWRDQH[LVWLQJHQWLW\
FRQWH[W
EHDQ
FOLHQW
EHDQ
OWR FRQWH[W
ÀQ +RPH KHSRR
G% REMHFW DEH DQLQW H[LVWV
DVN
ULP
\3
WKDW
DU YHULI\
%HDQ3RRO
\.
´µ
VWXE
H\
´ ULPDU\.H\
\3
µ
ÀQG% '%
$IWHUGRLQJD-1',ORRNXSRQWKHHQWLW\EHDQKRPHDQGJHWWLQJDKRPHLQWHUIDFHUHIHUHQFH
WKHFOLHQWFDOOVILQG%\3ULPDU\.H\ ´µ RQWKHKRPHVWXE
7KHILQG%\3ULPDU\.H\ ´µ PHWKRGLQYRFDWLRQLVSDVVHGWRWKHKRPHREMHFW
7KH&RQWDLQHUDVNVDEHDQLQWKHSRROWRYHULI\WKDWH[LVWVLQWKHGDWDEDVH
(-%
REMHFW
VWXE
UHWX EHDQ
UQ(-
%RE
MHFW FRQWH[W
VWXE +RPH LVWVµ
REMHFW VH[
´<H
%HDQ3RRO
'%
7KHEHDQFKHFNVIRUDQHQWLW\LQWKHGDWDEDVHZLWKSULPDU\NH\
7KHEHDQWHOOVWKHKRPHWKDWLVLQWKHGDWDEDVH
7KH&RQWDLQHUPDNHVRUILQGVDQ(-%REMHFWIRU WKHUHPLJKWDOUHDG\EHRQH
7KH&RQWDLQHUUHWXUQVWKHVWXEIRU
&KDSWHU
HQWLW\EHDQLQWUR
(QWLW\EHDQRYHUYLHZ
6FHQDULR FOLHQWZDQWVWRFUHDWHDQHZHQWLW\
FRQWH[W
EHDQ
EHDQ
FOLHQW FRQWH[W
+RPH
SRR
O
FU QIURP
HD REMHFW EHD
WH JHW
´% %HDQ3RRO
LOO\
%REµ
VWXE
% %LOO\
RE WH ´
µ FUHD
'%
$IWHUGRLQJD-1',ORRNXSRQWKHHQWLW\EHDQKRPHDQGJHWWLQJDKRPHLQWHUIDFHUHIHUHQFH
WKHFOLHQWFDOOVFUHDWH ´%LOO\%REµ RQWKHKRPHVWXE
7KHFUHDWH ´%LOO\%REµ PHWKRGLQYRFDWLRQLVSDVVHGWRWKHKRPHREMHFW
7KH&RQWDLQHUSXOOVDEHDQIURPWKHSRROIRUWKLVEHDQW\SH FRXOGEHDQ\UDQGRPEHDQLQWKH
SRRO 1RWLFHWKDWWKHEHDQDOUHDG\KDVLWVRZQFRQWH[WWKDWVWLFNVZLWKWKHEHDQ
(-%
REMHFW
VWXE EHDQ
FRQWH[W
+RPH
REMHFW ,QV
HU
ZL WDQ %HDQ3RRO
WK H
DQ ZURZ
HZ
SU LQWK
LPD
U\ HGDW '%
NH\ DED
VH
7KH&RQWDLQHU RUWKHEHDQ LQVHUWVDQHZURZLQWKHGDWDEDVHDQGWKHEHDQ
JHQHUDWHVDQHZSULPDU\NH\
7KHEHDQLVOLQNHGWRDQ(-%REMHFWDQGERWKWKHFRQWH[WDQG(-%REMHFWJHWWKHQHZSULPDU\NH\
7KH&RQWDLQHUUHWXUQVDVWXEIRUWKHQHZO\FUHDWHGHQWLW\ %LOO\%RE ,IWKHFOLHQW·VRQO\
JRDOZDVWRLQVHUWWKHQHZURZWKHFOLHQWPLJKWQRWHYHQFDUHDERXWWKHUHWXUQHGVWXE
\RXDUHKHUH
&XVWRPHUHQWLW\EHDQ
)^MZa[QUXTM+][\WUMZMV\Q\aJMIV
n
e n t t h e EntityBeeassionBean)
SDFNDJHDQGLPSRUWVKHUH
implem instead of S
SXEOLFFODVV&XVWRPHU%HDQLPSOHPHQWV(QWLW\%HDQ^ interface (
es the Þelds that ca map to
SULYDWH6WULQJODVW1DPH
Th e en tit y beanÕs state includba ta ble , in th is se--
SULYDWH6WULQJ¿UVW1DPH
lum ns in th e Cu sto me r da ta se
co ID (primary key)
Þrst name, last name, and
SULYDWH6WULQJSULPDU\.H\
youÕre
SULYDWH(QWLW\&RQWH[WFRQWH[W Your context is ins even MORE imposiortn anbetanwhen
a ses
an entity bean tead of
SXEOLF6WULQJHME&UHDWH 6WULQJODVW6WULQJ¿UVW ^
entÕs
ructor? We take thene tclith
ODVW1DPH ODVW
th is loo k a lot lik e a co nst res e
¿UVW1DPH ¿UVW DoesnÕt to ins ta nce variables that rep
args an d ass ign th em e data ba se ta ble ).
SULPDU\.H\ WKLVJHW3.
entityÕs persistent sta te (i.e. columns in th-- donÕt worry about
'%,16(57
ret ur ns th e pr im ar y ke y
UHWXUQSULPDU\.H\ The ejbCr eat e()
` it right now.
SXEOLF6WULQJJHW/DVW1DPH ^
UHWXUQODVW1DPH
Plain old Java getters
persistent Þelds. The maand
` setters for the
SXEOLFYRLGVHW/DVW1DPH 6WULQJQDPH ^ gic ,
minute, is that the result of astheyouÕll see in a
ODVW1DPH QDPH
` ultimately lead to a database updse setters will
SXEOLF6WULQJJHW)LUVW1DPH ^
ate !
UHWXUQODVW1DPH
`
SXEOLFYRLGVHW)LUVW1DPH 6WULQJQDPH ^
¿UVW1DPH QDPH
`
Three container callbacks from EntityBVER ean, that were
VERY
also in SessionBean. Except... they have thisYchapter.
SXEOLFYRLGHME$FWLYDWH ^`
SXEOLFYRLGHME3DVVLYDWH ^`
SXEOLFYRLGHME5HPRYH ^'(/(7(` different meanings, as youÕll see later in
SXEOLFYRLGVHW(QWLW\&RQWH[W (QWLW\&RQWH[WFW[ ^
ntext, except for an
FRQWH[W FW[ this is just like setSessionhCoentity beans, the context is
` EntityContext. But wit than it is for session beans.
usu ally WAY more important
SXEOLFYRLGXQVHW(QWLW\&RQWH[W ^`
SXEOLFYRLGHME/RDG ^6(/(&7` these are three NEW container cal
lbacks from the EntityB
SXEOLFYRLGHME6WRUH ^83'$7(` interface (not found in Session Bean). TheyÕre IMPORTANT!ean
SULYDWH6WULQJJHW3. ^
UHWXUQ³´ LQW 0DWKUDQGRP WorldÕs worst primary key algorithm.Normally weÕd
use client-
` supplied info or perhaps the databaseÕs auto- generated key.
(ignore these last two
SXEOLF6WULQJHME)LQG3ULPDU\.H\ 6WULQJSN ^6(/(&7UHWXUQSN` methods for now)
SXEOLF&ROOHFWLRQHME)LQG%\&LW\ 6WULQJFLW\ ^6(/(&7UHWXUQFROOHFWLRQRINH\V`
`
&KDSWHU
HQWLW\EHDQLQWUR
)VMV\Q\aJMIV¼[KTQMV\^QM_
/UR #USTOMER BEAN ISNT l NISHED SO DONT GET TOO ATTACHED TO IT !ND IN FACT THE CODE
IS AN EXAMPLE OF BEAN
MANAGED PERSISTENCE "-0 WHICH WE REALLY WONT BE USING IN THIS
BOOK 7ELL TALK A LITTLE ABOUT "-0 AND A LOT ABOUT ITS MUCH MORE POPULAR COUNTERPART
CONTAINER
MANAGED PERSISTENCE #-0 IN THIS CHAPTER AND THE NEXT &OR NOW THOUGH WELL
FOCUS ON THE CLIENT VIEW OF AN ENTITY BEAN AND THIS SIMPLE BEAN IS JUST TO GET YOU STARTED
LOOKING AT ENTITY BEAN CODE
'IVEN THAT A #USTOMER BEAN REPRESENTS A #USTOMER ENTITY IE A REAL CUSTOMER IN THE
UNDERLYING DATABASE WHAT BEHAVIORS SHOULD THE ENTITY BEAN HAVE )N OTHER WORDS WHAT
KINDS OF THINGS MIGHT THE CLIENT WANT TO DO WITH EITHER A SINGLE #USTOMER OR MULTIPLE
#USTOMERS
4HINGS YOUD DO WITH A DATABASE RECORD 4HE THINGS WE MENTIONED EARLIER INCLUDING
MAKE A NEW #USTOMER DELETE A #USTOMER UPDATE A #USTOMERS l ELDS COLUMNS AND
QUERYSEARCH ON THE #USTOMER DATABASE
7KLQNDERXWWKHIROORZLQJRSHUDWLRQVDQGILJXUHRXWZKLFKRI
YiX`e WKHWZRFOLHQWLQWHUIDFHV FRPSRQHQWRUKRPH LVEHWWHUVXLWHG
IRUHDFKRSHUDWLRQ.HHSLQPLQGWKDWWKHUXOHVIRUHQWLW\EHDQ
gfn\i LQWHUIDFHVPLJKWEHGLIIHUHQWIURPVHVVLRQEHDQLQWHUIDFHV,I
\RXWKLQNERWKLQWHUIDFHVDUHDSSURSULDWHFKHFNWKHPERWK
:H·YHGRQHWKHILUVWRQHIRU\RX
MDYD[HME
LPSRUWMDYD
UPL5HPRWH([
MDYD[HME
LPSRUWMDYD
UPL5HPRWH([
0DNHDQHZFXVWRPHU
FHSWLRQ FHSWLRQ
KRPH FRPSRQHQW
MDYD[HME
LPSRUWMDYD
UPL5HPRWH([
MDYD[HME
LPSRUWMDYD
UPL5HPRWH([
&KDQJHDQH[LVWLQJFXVWRPHU¶VSKRQHQXPEHU
FHSWLRQ FHSWLRQ
KRPH FRPSRQHQW
LPSRUWMDYD
UPL5HPRWH([
LPSRUWMDYD
UPL5HPRWH([
)LQGDOOWKHFXVWRPHUVLQ3OHDVDQWYLOOH
FHSWLRQ FHSWLRQ
KRPH FRPSRQHQW
MDYD[HME
LPSRUWMDYD
UPL5HPRWH([
MDYD[HME
LPSRUWMDYD
UPL5HPRWH([
'HOHWHDOOFXVWRPHUVSUHYLRXVO\GHFODUHGµLQDFWLYH¶
FHSWLRQ FHSWLRQ
KRPH FRPSRQHQW
LPSRUWMDYD
UPL5HPRWH([
LPSRUWMDYD
UPL5HPRWH([
'HOHWHDVSHFL¿FFXVWRPHU
FHSWLRQ FHSWLRQ
KRPH FRPSRQHQW
MDYD[HME
LPSRUWMDYD
UPL5HPRWH([
MDYD[HME
LPSRUWMDYD
UPL5HPRWH([
*HWWKHVWUHHWDGGUHVVRIDVSHFL¿FFXVWRPHU
FHSWLRQ FHSWLRQ
KRPH FRPSRQHQW
\RXDUHKHUH
HQWLW\5HPRWHFRPSRQHQWLQWHUIDFH
-V\Q\aJMIV:MUW\MKWUXWVMV\QV\MZNIKM
!N ENTITY BEANS COMPONENT INTERFACE IS JUST LIKE A SESSION BEANSIT HAS BUSINESS
METHODS AND IT EXTENDS JAVAXEJB%*"/BJECT 4HAT MEANS A CLIENT CAN SEE THE METHODS
YOUVE DECLARED IN YOUR COMPONENT INTERFACE AS WELL AS THE METHODS FROM %*"/BJECT
GET(ANDLE REMOVE ETC
"UT WHAT KINDS OF BUSINESS METHODS GO IN THE COMPONENT INTERFACE
4HE METHODS RELATED TO A SINGLE ENTITY
7HEN THE CLIENT HAS A REFERENCE TO AN ENTITY BEAN WHICH MEANS A REFERENCE TO THE
BEANS %*" OBJECT OF COURSE THE CLIENT HAS A REFERENCE TO A SINGLE SPECIl C ENTITY
&RED &LINTSTONE -ARGE 3IMPSON 2OY 2ODGERS
3O WHAT MIGHT A CLIENT WANT TO DO WITH A REFERENCE TO SAY -ARGE 3IMPSON $ELETE
HER CHANGE HER LAST NAME GET HER HANDLE OR GET HER HOME SO THAT THE CLIENT CAN GET
REFERENCES TO OTHER CUSTOMERS +EEP IN MIND THAT OUR SIMPLE #USTOMER BEAN ISNT VERY
USEFUL YET WITH METHODS TO GET OR SET ONLY THE #USTOMER NAME ,ATER WELL BUILD IT OUT
:KDW<28ZULWH :KDWWKH&/,(17VHHV
LQWHUIDFH!! LQWHUIDFH!!
&XVWRPHU &XVWRPHU
JHW/DVW1DPH JHW/DVW1DPH
VHW/DVW1DPH 6WULQJV VHW/DVW1DPH 6WULQJV
JHW)LUVW1DPH JHW)LUVW1DPH
VHW)LUVW1DPH 6WULQJV VHW)LUVW1DPH 6WULQJV
JHW3ULPDU\.H\
JHW(-%+RPH
JHW+DQGOH
LQWHUIDFH!!
5HPRWH UHPRYH
LV,GHQWLFDO
n
Remember the actual
h e sa m e m et h ods that sessroiom
hierarchy for Remote LQWHUIDFH!!
These are t see, because they come f
component interfaces- (-%2EMHFW
bean clients .EJBObject interface!
the component interface the javax.ejb the
extends EJBObject, and b er , t h e cl ie nt can access r Customer
Remem you
EJBObject extends you declare in
Remote methods thatLUS the Þve methods from
interface, P BObject.
LQWHUIDFH!!
&XVWRPHU
javax.ejb.EJ
&KDSWHU
HQWLW\EHDQLQWUR
-V\Q\aJMIV:MUW\MKWUXWVMV\QV\MZNIKM
SDFNDJHKHDG¿UVW
LPSRUWMDYD[HME
LPSRUWMDYDUPL5HPRWH([FHSWLRQ
SXEOLFLQWHUIDFH&XVWRPHUH[WHQGV(-%2EMHFW^
SXEOLF6WULQJJHW/DVW1DPH WKURZV5HPRWH([FHSWLRQ
SXEOLFYRLGVHW/DVW1DPH 6WULQJODVW1DPH WKURZV5HPRWH([FHSWLRQ
SXEOLF6WULQJJHW)LUVW1DPH WKURZV5HPRWH([FHSWLRQ
SXEOLFYRLGVHW)LUVW1DPH 6WULQJ¿UVW1DPH WKURZV5HPRWH([FHSWLRQ
\RXDUHKHUH
HQWLW\5HPRWHFRPSRQHQWLQWHUIDFH
5XOHVIRUWKH5HPRWHFRPSRQHQWLQWHUIDFH
,PSRUWMDYD[HME DQGMDYDUPL5HPRWH([FHSWLRQ
([WHQGMDYD[HME(-%2EMHFW
'HFODUHRQHRUPRUHEXVLQHVVPHWKRGVWKDWWKURZD5HPRWH([FHSWLRQ
4 $UJXPHQWVDQGUHWXUQW\SHVPXVWEH50,,,23FRPSDWLEOH 6HULDOL]DEOH
SULPLWLYH5HPRWHRUDUUD\VRUFROOHFWLRQVRIDQ\RIWKRVH
4 <RXFDQKDYHRYHUORDGHGPHWKRGV
4 (DFKPHWKRGPXVWGHFODUHD5HPRWH([FHSWLRQ
4 <RXFDQGHFODUH\RXURZQDSSOLFDWLRQH[FHSWLRQVEXWWKH\PXVW
127EHUXQWLPHH[FHSWLRQV LQRWKHUZRUGVWKH\PXVWEHFRPSLOHU
FKHFNHGH[FHSWLRQV²VXEFODVVHVRI([FHSWLRQEXWQRWVXEFODVVHVRI
5XQWLPH([FHSWLRQ
4 0HWKRGVFDQKDYHDUELWUDU\QDPHVDVORQJDVWKH\GRQ¶WEHJLQZLWK³HME´
&KDSWHU
HQWLW\EHDQLQWUR
-V\Q\aJMIV:MUW\MPWUMQV\MZNIKM
0W_Q\¼[LQNNMZMV\NZWUI[M[[QWVJMIVPWUMQV\MZNIKM"
<RX¶UHPRUHOLNHO\WR¿QGDQH[LVWLQJHQWLW\WKDQFUHDWHDQHZRQH
!S A CLIENT YOULL PROBABLY SPEND A LOT MORE TIME USING REFERENCES TO EXISTING
CUSTOMERS THAN YOULL SPEND CREATING NEW CUSTOMERS 7HETHER YOURE UPDATING
A SPECIl C CUSTOMER OR DOING A BATCH OPERATION ON MANY CUSTOMERS YOULL NEED
HOME INTERFACE CODE THAT LETS YOU SELECT CUSTOMERS MORE THAN YOULL NEED CREATION
METHODS )N FACT THE CREATE METHOD IS OPTIONAL FOR ENTITY BEANS "ECAUSE YOU
MIGHT HAVE A POLICY THAT SAYS NEW ENTRIES IN THE DATABASE MUST BE DONE DIRECTLY
THROUGH A DATABASE ADMIN TOOL FOR EXAMPLE "UT YOURE REQUIRED TO PUT AT LEAST
ONE l NDER METHOD FOR AN ENTITY BEAN HOMEYOU CAN HAVE AS MANY l NDERS AS YOU
LIKE BUT YOU MUST HAVE l ND"Y0RIMARY+EY3TRING PRIMARY+EY IN EVERY ENTITY HOME
7HICH MEANS IT MIGHT BE THE ONLY METHOD DECLARED IN THE HOME INTERFACE
<RXPLJKWZDQWWRGRTXHULHVWKDWLQYROYHPRUHWKDQRQHHQWLW\
3INCE SESSION BEANS REPRESENT PROCESS IT DOESNT MAKE SENSE TO SAY GET MULTIPLE
INSTANCES OF THE SAME PROCESS "UT WITH ENTITY BEANS YOU MIGHT WANT TO DO THE
SAME THINGS YOUD DO ON A DATABASE TABLE LIKE l ND ALL THE CUSTOMERS WHO LIVE IN
(ELSINKI AND ENJOY SURl NG
:KDW<28ZULWH :KDWWKH&/,(17VHHV
LQWHUIDFH!! LQWHUIDFH!!
&XVWRPHU+RPH &XVWRPHU+RPH
FUHDWH 6WULQJODVW6WULQJILUVW FUHDWH 6WULQJODVW6WULQJILUVW
ILQG%\3ULPDU\.H\ 6WULQJNH\ ILQG%\3ULPDU\.H\ 6WULQJNH\
ILQG%\&LW\ 6WULQJFLW\ ILQG%\&LW\ 6WULQJFLW\
JHW(-%0HWD'DWD
JHW+RPH+DQGOH
the
client can see
UHPRYH +DQGOHK
An entity beaetnhods a session bean UHPRYH 2EMHFWNH\
same four m e, because both session
client can se ean home interfaces
and entity b javax.ejb.EJBHome.
must extend get to use BOTH
Entity beans ) methods, while
home remove( can use only the one
session beans Handle.
that takes a
\RXDUHKHUH
HQWLW\KRPHLQWHUIDFH
?PI\LWM[\PMKTQMV\ZMITTa_IV\
NZWUIVMV\Q\aJMIVPWUM '
LQWHUIDFH!!
give
ByPrimaryKeyhe
&XVWRPHU+RPH
eat e a nd Þnd
cr ference to t &XVWRPHUFUHDWH 6WULQJODVW6WULQJILUVW
back a single treerface. &XVWRPHUILQG%\3ULPDU\.H\ 6WULQJNH\
component in
-row Þnder
But a multipllleection of references &ROOHFWLRQILQG%\&LW\ 6WULQJFLW\
returns a co
7ITH SESSION BEANS THAT WAS EASYA REFERENCE TO THE
COMPONENT INTERFACE !ND THATS EXACTLY WHAT THE CREATE
METHODS HAVE TO GIVE BACK 7KHFUHDWHDQGILQGHU
7ITH ENTITY BEANS ITS THE SAME FOR CREATE METHODSTHEY
MUST GIVE BACK A REFERENCE TO THE COMPONENT INTERFACE IN THIS
PHWKRGVLQDQHQWLW\EHDQ
CASE THE COMPONENT INTERFACE FOR THE ENTITY JUST CREATED KRPHDOZD\VJLYHEDFN
"UT WHAT IF YOU WANT TO l ND AN EXISTING ENTITY BEAN WKHEHDQ·VFRPSRQHQW
INSTEAD OF MAKING A NEW ONE 4HATS WHAT THE MANDATORY
l ND"Y0RIMARY+EY METHOD IS FOR AND IT TOO MUST GIVE BACK LQWHUIDFH
A REFERENCE TO THE COMPONENT INTERFACE FOR THE BEAN MATCHING
THAT KEY )RUFUHDWH DQG
"UT WHAT IF THERE ISNT A MATCHING ENTITY )F THERES NO ENTITY ILQG%\3ULPDU\.H\ WKH
WITH THAT KEY IN THE DATABASE THE CLIENT GETS A JAVAXEJB/BJECT
.OT&OUND%XCEPTION 3O THE RETURN TYPE OF l ND"Y0RIMARY+EY FOLHQWJHWVDUHIHUHQFHWR
IS ALWAYS THE SAME AS IT IS FOR CREATE THE COMPONENT INTERFACE
FOR THAT BEAN TYPE !ND OF COURSE THE RULES FOR SESSION BEAN RQH(-%REMHFW
CLIENT INTERFACES APPLIES HERE AS WELLA 2EMOTE HOME INTERFACE
MUST GIVE BACK THE 2EMOTE COMPONENT INTERFACE AND THE LOCAL )RUPXOWLSOHHQWLW\
HOME INTERFACE MUST GIVE BACK THE LOCAL COMPONENT INTERFACE
ILQGHUVWKHFOLHQWPLJKW
4HIS STILL LEAVES US WITH A METHOD THAT CANNOT RETURN THE
COMPONENT INTERFACE A MULTIPLE
ENTITY l NDER LIKE OUR JHWDZKROH3,/(RI
l ND"Y#ITY METHOD 7ELL THE CLIENTS GOAL DOESNT CHANGE
WITH MULTIPLE
ENTITY l NDERS THE CLIENT STILL WANTS A REFERENCE
UHIHUHQFHVWR(-%REMHFWV³
TO THE COMPONENT INTERFACE ONLY THIS TIME IT MIGHT BE A WHOLE RQHIRUHDFKEHDQWKDW
COLLECTION OF THEM /NE FOR EVERY CUSTOMER ENTITY IN THE CITY
NAMED IN THE METHODS ARGUMENT PDWFKHVWKHTXHU\
.OTE A CLIENT WILL NOT GET AN EXCEPTION IF A MULTI
ENTITY l NDER
CANT l ND ANY MATCHES )NSTEAD THE CLIENT WILL STILL GET A
#OLLECTION BUT IT WILL SIMPLY BE EMPTY ! #OLLECTION WITH NO
ELEMENTS /NLY SINGLE
ENTITY l NDERS THROW EXCEPTIONS WHEN
NOTHING MATCHES THE l ND CRITERIA
&KDSWHU
HQWLW\EHDQLQWUR
-V\Q\aJMIV:MUW\MPWUMQV\MZNIKM
SDFNDJHKHDG¿UVW
LPSRUWMDYD[HME
LPSRUWMDYDUPL5HPRWH([FHSWLRQ
LPSRUWMDYDXWLO&ROOHFWLRQ
SXEOLFLQWHUIDFH&XVWRPHU+RPHH[WHQGV(-%+RPH^
SXEOLF&XVWRPHUFUHDWH 6WULQJODVW6WULQJ¿UVW WKURZV&UHDWH([FHSWLRQ5HPRWH([FHSWLRQ
SXEOLF&XVWRPHU¿QG%\3ULPDU\.H\ 6WULQJNH\ WKURZV)LQGHU([FHSWLRQ5HPRWH([FHSWLRQ
SXEOLF&ROOHFWLRQ¿QG%\&LW\ 6WULQJFLW\ WKURZV)LQGHU([FHSWLRQ5HPRWH([FHSWLRQ
`
\RXDUHKHUH
HQWLW\¿QGHUV
?PMVNQVLMZ[PI^MILIZS[QLM
,MXVWWKRXJKWRIDSUHWW\VFDU\
VFHQDULRLI,ZDQWP\FOLHQWWRGLVSOD\D
OLVWRIDOOP\FXVWRPHUVLW·VMXVWRQHFDOO
WRÀQG$OO EXW7+(1ZKDW"$UH\RXWHOOLQJPH
,ZRXOGJHWEDFND]LOOLRQUHPRWHVWXEV"$QG
WKHQ,·GKDYHWRPDNHUHPRWHPHWKRGFDOOVRQ
HDFKRQH"7KDWZRXOGWDNH)25(9(5QRWWR
PHQWLRQDOOWKHEDQGZLGWK7KDWGRHVQ·W
VRXQGJRRGDWDOO
:LWKD5HPRWHLQWHUIDFH
ILQGHUDQGFUHDWHPHWKRGV
JLYHEDFN5HPRWHVWXEV
7KDWPHDQV\RXKDYHWR
PDNHUHPRWHPHWKRGFDOOV
RQHDFKRQHWRJHWWKHGDWD
\RXZDQW
&KDSWHU
HQWLW\EHDQLQWUR
:RXOGQ·WLWEHGUHDP\LIWKHUH
ZHUHDZD\WRKDYHPHWKRGVLQWKH
KRPHWKDWFRXOGJLYHEDFNVRPHWKLQJRWKHU
WKDQ(-%REMHFWUHIHUHQFHV",IDOO,ZDQWLV
WKHGDWDDERXWWKHFXVWRPHUVOLNHMXVWDEXQFK
RI6WULQJVWRGLVSOD\ZRXOGQ·WLWEHJUHDWLI
,FRXOGKDYHDPHWKRGLQWKHKRPHWKDW
FRXOGJLYHEDFNMXVWWKHGDWD"%XWLW·V
SUREDEO\DIDQWDV\
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: 7AIT ) THOUGHT IT WAS BAD DESIGN
TO MAKE ALL THOSE METHOD CALLS FROM
THE CLIENT !.97!9 7OULDNT THE CLIENT
USUALLY GO THROUGH A SESSION BEAN !ND
THE SESSION BEAN WOULD THEN TALK TO THE
ENTITY BEAN
A: +IND OF 9OURE THINKING OF THE 3ES
SION &ACADE *%% DESIGN PATTERN "UT EVEN
IF YOU DO PUT A SESSION BEAN IN FRONT OF AN
ENTITY BEAN THE SESSION BEAN IS STILL A CLIENT
)T MIGHT BE A LOT MORE EFFICIENT BECAUSE
THE SESSION BEAN MIGHT NOT HAVE AS FAR TO
GO ON THE NETWORK AND MIGHT EVEN BE ON
THE SAME SERVER AS THE ENTITY "UT IF YOURE
KEEPING LOCATION
INDEPENDENCE THEN
YOUR SESSION BEAN IS STILL USING THE ENTITY
BEANS 2EMOTE INTERFACES SO THERES STILL A
LOT OF OVERHEAD
Q: #OULDNT YOU JUST HAVE A BUSINESS
METHOD IN THE COMPONENT INTERFACE THAT
RETURNS DATA ,IKE RETURN A COLLECTION OF
3TRINGS
A: 9OURE GETTING WARMER 9ES THATS
THE WAY YOU MIGHT HAVE DONE IT IN %*"
"UT THATS KLUDGEY BECAUSE YOU HAVE TO
FIRST GET A REFERENCE TO SOME CUSTOMER JUST
SO YOU CAN ASK THAT CUSTOMER TO GIVE YOU
BACK THE DATA FOR ALL CUSTOMERS
\RXDUHKHUH
HQWLW\KRPHEXVLQHVVPHWKRGV
0WUMJ][QVM[[UM\PWL[\W\PMZM[K]M
4HATS RIGHT BUSINESS METHODS ARENT JUST FOR THE
COMPONENT INTERFACE WHEN YOURE TALKING ABOUT ENTITY
BEANS !S OF %*" AN ENTITY BEAN HOME CAN HAVE
METHODS THATDRUM ROLLDONT HAVE TO RETURN COMPONENT
INTERFACES (OME BUSINESS METHODS CAN RETURN ANYTHING +RPHEXVLQHVVPHWKRGV
WITH THE ONE RESTRICTION OF COURSE THAT 2EMOTE HOME
METHODS RETURN VALUES THAT ARE 2-)
))/0 COMPLIANT FDQUHWXUQVRPHWKLQJ
(OME BUSINESS METHODS ARE GREAT FOR BATCH OPERATIONS
OR FOR QUERY METHODS WHERE THE CLIENT DOESNT NEEDOR
RWKHUWKDQ(-%REMHFW
WANT%*" OBJECT REFERENCES BUT SIMPLY WANTS THE UHIHUHQFHV7KH\·UH
ENTITYS DATA IN OTHER WORDS THE DATA FOR ONE OR MORE
OF THE ENTITYS PERSISTENT lELDS &OR EXAMPLE WE MIGHT SHUIHFWIRUTXHULHVZKHUH
PUT A HOME BUSINESS METHOD IN THE #USTOMER BEAN
LIKE GET!LL#USTOMER)NFO THAT RETURNS A COLLECTION OF WKHFOLHQWMXVWZDQWVWKH
3TRINGS WITH WHATEVER PIECES OF DATA YOUVE DECIDED MAKE
UP THE CUSTOMERS INFO "ETTER YET YOU CAN SEND BACK A
HQWLW\GDWDQRWUHIHUHQFHV
COLLECTION OF #USTOMER)NFO OBJECTS WHERE #USTOMER)NFO WRWKHHQWLWLHVWKHPVHOYHV
IS A CLASS THAT SIMPLY HOLDS THE DATA AND GETTERS FOR THE
#USTOMERS PERSISTENT STATE 4HAT WAY THE CLIENT CAN MAKE 7KH\·UHDOVRJUHDWIRU
LOCAL CALLS TO GET THE DATA IT NEEDS OUT OF THE #USTOMER)NFO
OBJECTS WITHOUT HAVING THOSE CALLS BE REMOTE CALLS ON THE EDWFKRSHUDWLRQVRU
COMPONENT INTERFACE
! #USTOMER)NFO CLASS IS AN EXAMPLE OF A 6ALUE /BJECT CLASS
DQ\WKLQJHOVH\RXPLJKW
WHICH IS IN A NUTSHELL JUST A CLASS WITH GETTERS AND POSSIBLY ZDQWWRGRZLWKPRUH
SETTERS DEPENDING ON THE DESIGN REPRESENTING THE ENTITYS
PERSISTENT lELDS !ND IT TOO HAS A DARK SIDETHE DATA WKDQRQHVSHFLILFHQWLW\
STARTS TO BECOME STALE THE MOMENT AFTER THE 6ALUE /BJECT IS
CREATED ZKHQ\RXGRQ·WZDQWWR
7E COULD TELL YOU NOW BUT THEN WED BE ROBBING YOU OF UHWXUQUHIHUHQFHVWRWKH
SUCH A VALUABLE OPPORTUNITY TO APPLY A LITTLE NEURAL EFFORT
3O FOR NOW WHY DONT YOU THINK OF WHY SENDING BACK FRPSRQHQWLQWHUIDFH
#USTOMER)NFO OBJECTS THAT THE CLIENT COULD THEN INTERROGATE
IE CALL METHODS ON AT ITS LEISURE COULD HAVE A DOWNSIDE
7ELL USE 6ALUE /BJECTS A LOT BUT YOU HAVE TO BE AWARE OF
THE TRADEOFFS WHEN CHOOSING BETWEEN USING A HOME lNDER
METHOD THAT RETURNS %*" OBJECT REFERENCES ESPECIALLY WHEN
THE REFERENCES ARE 2EMOTE VS A HOME BUSINESS METHOD THAT
RETURNS 6ALUE /BJECTS
&KDSWHU
HQWLW\EHDQLQWUR
5XOHVIRUWKH5HPRWHKRPHLQWHUIDFH
,PSRUWMDYD[HME DQGMDYDUPL5HPRWH([FHSWLRQ
([WHQGMDYD[HME(-%+RPH
'HFODUH RSWLRQDOO\ RQHRUPRUHFUHDWH PHWKRGVZKLFK0867
UHWXUQWKH5HPRWHFRPSRQHQWLQWHUIDFHDQGGHFODUHERWKD
5HPRWH([FHSWLRQDQGD&UHDWH([FHSWLRQ(DFKFUHDWH PHWKRGPXVW
EHJLQZLWKWKHSUH¿[³FUHDWH´
'HFODUHWKH¿QG%\3ULPDU\.H\ PHWKRGZKLFK0867
UHWXUQWKH5HPRWHFRPSRQHQWLQWHUIDFHDQGGHFODUHERWKD
5HPRWH([FHSWLRQDQGD)LQGHU([FHSWLRQ
'HFODUH RSWLRQDOO\ RQHRUPRUHRWKHU¿QGHUPHWKRGVZKLFK
0867UHWXUQHLWKHUWKH5HPRWHFRPSRQHQWLQWHUIDFH IRU
VLQJOHHQWLW\¿QGHUV RUMDYDXWLO&ROOHFWLRQ IRUPXOWLSOHHQWLW\
¿QGHUV $OO¿QGHUVPXVWGHFODUHERWKD5HPRWH([FHSWLRQDQGD
)LQGHU([FHSWLRQ
'HFODUHRQHRUPRUHKRPHEXVLQHVVPHWKRGV
4 $UJXPHQWVDQGUHWXUQW\SHVPXVWEH50,,,23FRPSDWLEOH 6HULDOL]DEOH
SULPLWLYH5HPRWHRUDUUD\VRUFROOHFWLRQVRIDQ\RIWKRVH
4 <RXFDQKDYHRYHUORDGHGPHWKRGV
4 (DFKPHWKRGPXVWGHFODUHD5HPRWH([FHSWLRQ
4 <RXFDQGHFODUH\RXURZQDSSOLFDWLRQH[FHSWLRQVEXWWKH\PXVW
127EHUXQWLPHH[FHSWLRQV LQRWKHUZRUGVWKH\PXVWEHFRPSLOHU
FKHFNHGH[FHSWLRQV²VXEFODVVHVRI([FHSWLRQEXWQRWVXEFODVVHVRI
5XQWLPH([FHSWLRQ
4 0HWKRGVFDQKDYHDUELWUDU\QDPHVDVORQJDVWKH\GRQ¶WEHJLQZLWK
³FUHDWH´³¿QG´RU³UHPRYH´
\RXDUHKHUH
HQWLW\EHDQV
6KDUSHQ \RXU SHQFLO
)RUWKHIRXUGDWDEDVHRSHUDWLRQV 64/FRPPDQGV DFOLHQWPLJKW
ZDQWWRGRZLWKDQHQWLW\EHDQOLVWWKHPHWKRGVLQWKHEHDQ¶V
LQWHUIDFH V WKDWDUHUHODWHGWRWKRVHGDWDEDVHRSHUDWLRQV1R\RX
GRQ¶WKDYHWRNQRZ64/EXW\RXGH¿QLWHO\KDYHWRXQGHUVWDQGWKH
LPSOLFDWLRQVRIWKHIRXUGDWDEDVHRSHUDWLRQVDQG\RXPXVWNQRZ
KRZWKH\FRUUHVSRQGWRPHWKRGVLQWKHEHDQFODVV
)URPWKHOLVWRIWKHPHWKRGVLQWKHLQWHUIDFHV¿OOLQWKHPHWKRGRU
PHWKRGVWKDWFRUUHVSRQGZLWKWKHGDWDEDVHRSHUDWLRQ
,16(57
'(/(7(
83'$7(
6(/(&7
LQWHUIDFH!!
LQWHUIDFH!!
&XVWRPHU+RPH
&XVWRPHU
FUHDWH 6WULQJODVW6WULQJILUVW JHW/DVW1DPH
ILQG%\3ULPDU\.H\ 6WULQJNH\ VHW/DVW1DPH 6WULQJV
ILQG%\&LW\ 6WULQJFLW\
JHW)LUVW1DPH
JHW(-%0HWD'DWD VHW)LUVW1DPH 6WULQJV
JHW+RPH+DQGOH
UHPRYH +DQGOHK JHW3ULPDU\.H\
UHPRYH 2EMHFWNH\ JHW(-%+RPH
JHW+DQGOH
UHPRYH
LV,GHQWLFDO
&KDSWHU
HQWLW\EHDQLQWUR
;M[[QWVJMIVKZMI\M^[MV\Q\aJMIVKZMI\M
6WDWHIXOVHVVLRQEHDQFUHDWH
&OLHQWFDOOVLWWRJHWDQ(-%REMHFWUHIHUHQFHWRDQHZMXVWIRUPH
VWDWHIXOVHVVLRQEHDQ
,WFDQ DQGIUHTXHQWO\GRHV KDYHDUJXPHQWVWKDWWKHEHDQXVHVWRGR
FOLHQWVSHFLILFLQLWLDOL]DWLRQ EHIRUHUXQQLQJDQ\EXVLQHVVPHWKRGV
7KH&RQWDLQHUPDNHVDQHZVHVVLRQEHDQZKHQWKHFOLHQWFDOOVFUHDWH
6WDWHOHVVVHVVLRQEHDQFUHDWH
&OLHQWFDOOVLWWRJHWDQ(-%REMHFWUHIHUHQFHWRDEHDQ
,WKDVQRDUJXPHQWVDQGWKHEHDQGRHVQRWGRDQ\FOLHQWVSHFLILF
LQLWLDOL]DWLRQ VLQFHDWWKHWLPHWKHEHDQ·VHME&UHDWH LV
FDOOHGWKHEHDQKDVQRDVVRFLDWLRQZLWKDFOLHQW
7KH&RQWDLQHUGRHVQRWPDNHDQHZVHVVLRQEHDQZKHQ
WKHFOLHQWFDOOVFUHDWH DQGGRHVQRWSXOORQHRXWRIWKH
SRROXQWLOWKHFOLHQWLQYRNHVDEXVLQHVVPHWKRG
RED
(QWLW\EHDQFUHDWH 2OSES ARE ATE
D FOR A D
AND GOO E
W IS MAD
&OLHQWFDOOVLWWRLQVHUWDQHZURZLQWKHGDWDEDVH
A NEW RO ATE
H NEW CRE
$OWKRXJKWKHHQGUHVXOWIRUWKHFOLHQWLVVWLOODQ(-%REMHFW WITH EAC
UHIHUHQFH LQWKLVFDVHWRWKHQHZO\FUHDWHGHQWLW\ T
*" OBJEC
M E M B E R N E W R O W NEW % " O B JECT
2E C REATE N N EW %*
,WZLOOYLUWXDOO\DOZD\VKDYHDUJXPHQWV DOWKRXJKWKH\ ENTITY B E A N S NEW B E A
REATE OBJECT
DUHQ·WPDQGDWRU\EXWLW·VNLQGDKDUGWRLPDJLQHDFUH BEANS C NEW %*"
STATEFUL N S C RE A TE
DWH ZLWKRXWWKHPOLNH´+H\GDWDEDVHFUHDWHDQHZ BEA
STATELESS
FXVWRPHUQR,GRQ·WKDYHDQ\QDPHRU,'RUDQ\WKLQJ
MXVWPDNHVRPHVWXIIXSµ
7KH&RQWDLQHUGRHVQRWPDNHDQHZHQWLW\EHDQEXWLWGRHVSXOORQH
RXWRIWKHSRROWRUXQWKHHME&UHDWH PHWKRG5HPHPEHUWKHHME&UH
DWH PHWKRGKDVWRWDNHWKHFUHDWH DUJXPHQWVDQGVRPHKRZFUHDWH
DQHZHQWLW\LQWKHXQGHUO\LQJSHUVLVWHQWVWRUH RUDWOHDVWVXSSRUWWKH
&RQWDLQHULQFUHDWLQJDQHZHQWLW\
\RXDUHKHUH
VHVVLRQYVHQWLW\
;M[[QWVJMIVZMUW^M^[MV\Q\aJMIVZMUW^M
6WDWHIXOVHVVLRQEHDQUHPRYH
&OLHQWFDOOVLWWRWHOOWKH&RQWDLQHUWKDWKH·VGRQHZLWKWKHEHDQ
&RQWDLQHUFDOOVWKHEHDQ·VHME5HPRYH XQOHVVWKHEHDQLVDOUHDG\SDVVLYDWHG DQG
NLOOVWKHEHDQ WKLQN IRRGIRUWKHJDUEDJHFROOHFWRU
&OLHQWZLOOJHWDQH[FHSWLRQLIKHWULHVWRXVHWKH(-%REMHFWUHIHUHQFHDIWHUUHPRYLQJ
WKHEHDQ
6WDWHOHVVVHVVLRQEHDQUHPRYH
&OLHQWFDOOVLWWRWHOOWKH&RQWDLQHUWKDWKH·VGRQHZLWKWKHEHDQ
&RQWDLQHUJHWVWKHFDOODQGVD\V´/LNH,FDUH"'R\RXKRQHVWO\WKLQN\RX·UHWKDW
LPSRUWDQW"7KLVEHDQLVDOUHDG\EDFNLQWKHSRROEDE\µ7KH&RQWDLQHUGRHVQRWFDOO
DEHDQ·VHME5HPRYH 7KLQNDERXWLW³ZKLFKEHDQ·VHME5HPRYH ZRXOGLWFDOO"
&OLHQWZLOOJHWDQH[FHSWLRQLIKHWULHVWRXVHWKH(-%REMHFWUHIHUHQFHDIWHUUHPRYLQJ
WKHEHDQ
(QWLW\EHDQUHPRYH
&OLHQWFDOOVLWWRWHOOWKH&RQWDLQHUWRGHOHWHWKHHQWLW\ZLWKWKLVSULPDU\NH\
&RQWDLQHUFDOOVWKHEHDQ·VHME5HPRYH PHWKRGDQG³LIWKHEHDQVXSSRUWVFOLHQW
WULJJHUHGUHPRYDO³WKHHQWLW\LVGHOHWHGIURPWKHXQGHUO\LQJSHUVLVWHQWVWRUH,QRWKHU
ZRUGVWKHURZLQWKHGDWDEDVHLVKLVWRU\*RQH3RRI
&OLHQWZLOOJHWDQH[FHSWLRQLIKHWULHVWRXVHWKH(-%REMHFWUHIHUHQFHDIWHUUHPRYLQJ
WKHEHDQ
,QIDFW12FOLHQWZLOOEHDEOHWRXVHDQ(-%REMHFWUHIHUHQFHWRWKDWHQWLW\
&KDSWHU
HQWLW\EHDQLQWUR
,KDWHWRGRWKLVUHDOO\EXW,
KDYHQRFKRLFH0867EH
UHPRYHGIURPWKHGDWDEDVH
UHPRYH RQDVHVVLRQEHDQ
6RLI\RX·YHJRWDQ\ODVWZRUGV\RX
EHWWHUGRLWLQ\RXUHME5HPRYH PHDQVWKHFOLHQWLVGRQHZLWK
WKHEHDQ
UHPRYH RQDQHQWLW\EHDQ
PHDQV(9(5<21(LVGRQHZLWK
WKHEHDQ
1R3OHDVH1R
,·OOJLYH\RXZKDWHYHU
\RXZDQWMXVWGRQ·W
FDOOUHPRYH
\RXDUHKHUH
HQWLW\UHPRYDO
&XW
/RRNVOLNHVRPHERG\
GLGQ·WUHDGWKHVFULSW<RX
NQRZWKDW·VQRWKRZLWZRUNVLW·V
QRWWKHEHDQLQVWDQFHWKDW·VNLOOHG
EXWWKHHQWLW\LQGDWDEDVH<RX
MXVWJREDFNWRWKHEHDQSRRO
ZKHQWKHFOLHQWFDOOV
UHPRYH %XW,QHYHUJHWWRGRDGHDWK
VFHQH,NQRZLW·VRQO\WKHGDWDEDVH
HQWLW\WKDWJHWVGHOHWHGEXW,MXVW
ZDQWHGVRPHWKLQJDELWPRUHGUDPDWLF
IRUDFKDQJH,NQRZ,·OOGLHLI,WKURZDQ
XQFKHFNHGH[FHSWLRQEXWWKDWFRXOGWDNH
IRUHYHUDQG,ZDVKRSLQJWRJHWD
SDUWLQ´/RUGRIWKH%HDQVµDQG
&KDSWHU
HQWLW\EHDQLQWUR
-V\Q\aJMIVQV[\IVKMLMI\P
3O WE ALL KNOW THAT AN ENTITY BEAN IS A REPRESENTATION OF
SOME REAL ENTITY IN AN UNDERLYING PERSISTENT STORE USUALLY AS
A ROW IN A DATABASE BLAH BLAH BLAH "UT THERES STILL SOME
CONFUSION ABOUT WHAT DISTINGUISHES AN ENTITY FROM AN ENTITY $FOLHQWFDQNLOODQHQWLW\
BEAN FROM AN ENTITY BEAN INSTANCE
E\FDOOLQJUHPRYH RQD
%NTITY
4HE REAL THING IN THE UNDERLYING PERSISTENT STORE 4HE ROW IN
EHDQRUGHOHWLQJWKHGDWD
THE DATABASE ALTHOUGH IT CAN BE MORE COMPLEX !N ENTITY IURPWKHGDWDEDVHGLUHFWO\
DIES WHEN ITS ROW IS DELETED FROM THE UNDERLYING STORE EITHER
THROUGH A DIRECT DATABASE DELETE LIKE SOMEONE USING A
DATABASE ADMIN TOOL OR BECAUSE SOMEONE CALLS REMOVE ON
%XWRQO\WKH&RQWDLQHURUD
THE BEANS HOME OR COMPONENT INTERFACE VHUYHUFUDVKFDQNLOODEHDQ
%NTITY BEAN LQVWDQFH
4HE COMPONENT THAT REPRESENTS THE UNDERLYING REAL ENTITY
"UT THIS ONES TRICKY IS IT THE CLASS )S IT THE INTERFACE )S IT ,IZHVD\´HQWLW\EHDQ
THE INSTANCE OF THE BEAN CLASS $URING DEVELOPMENT AND
DEPLOYMENT THE ENTITY BEAN IS THE WHOLE COMPONENT THE ZDVNLOOHGµWKHXQGHUO\LQJ
TWO INTERFACES $$ AND BEAN CLASS "UT AT RUNTIME IT CAN
GET A LITTLE FUZZY 3 OMETIMES WE USE hENTITY BEANv TO DESCRIBE HQWLW\LVJRQHDQGWKH(-%
THE POSSIBILITY OF REPRESENTING A PARTICULAR ENTITY AS A BEAN
)N OTHER WORDS IF THERES AN ENTITY FOR "O 2ODGERS IN THE
REMHFWIRULVJRQHEXW
DATABASE THEN WE CAN SAY THAT THERE IS A "O 2ODGERS ENTITY WKHEHDQLQVWDQFHWKDWKDG
BEAN EVEN IF THERES NO BEAN INSTANCE CURRENTLY REPRESENTING
THAT ENTITY )F AN ENTITY EXISTS FOR A PARTICULAR BEAN TYPE LIKE EHHQSOD\LQJVXUYLYHV
#USTOMER &RED &OO THE ENTITY BEAN FOR THAT ENTITY IS SAID TO
EXIST !N ENTITY BEAN IS SAID TO DIE WHEN ITS UNDERLYING ENTITY
IS DELETED AS IN h4HERES NO &RED &OO ENTITY BEANv "UT THAT :HOOLW·VEHHQJUHDW
DOESNT MEAN THE INSTANCE ON THE HEAP DIES SOD\LQJ\RXUHDOO\EXWQRZ
LW·VWLPHIRU\RXWRJRWRDEHWWHU
%NTITY BEAN INSTANCE SODFH,·OOWKLQNDERXW\RXZKLOH,·P
ÁRDWLQJRQRQHRIWKRVHOLWWOH
4HE INSTANCE OF THE BEAN CLASS ON THE HEAP "EAN DEATH IS LQÁDWDEOHPDWWUHVV
INTIMATELY TIED TO THE DATABASE BUT BEAN INSTANCE DEATH AS WKLQJV
IN hYOURE HEADIN FOR GARBAGE COLLECTION PALv IS TIED TO THE
WHIMS OF THE #ONTAINER OR A SERVER CRASH
'DUNR 'RQQ\
9ES IT REALLY IS THAT CONFUSING 9OU HAVE TO KNOW THE CONTEXT TO
KNOW HOW THE WORD @BEAN IS BEING USED )F IT MEANS THE BEAN
REPRESENTING
THE
ENTITY THEN THAT BEAN WILL DIE WHEN THE ENTITY
bean in entity DIES when a
DIES AND THE %*" OBJECT FOR THAT ENTITY GOES AWAY "UTAND
LIVES stance client calls remove()
HERES WHERE IT GETS WEIRDTHE ENTITY BEAN INSTANCE DOESNT
if the e even
DIE IT JUST GOES BACK TO THE POOL 4HINK OF THE PHRASE hENTITY
it plays ntity
BEANv AS MORE CONCEPTUAL THAN PHYSICAL )N MOST CASES WE
removed is
WONT HAVE TO DISTINGUISH BETWEEN THE BEAN AND ITS INSTANCE .
OR THE DISTINCTION WILL BE SO OBVIOUS THAT ITS NOT AN ISSUE
\RXDUHKHUH
HQWLW\UHPRYDO
&OLHQWFDOOVUHPRYH
FRQWH[W
UHPRYH
(-%
REMHFW
EHDQ
RYH VWXE
UHP
FOLHQW EHDQ
H FRQWH[W
PRY
5H
HME
%HDQ3RRO
'%
&OLHQWFDOOVUHPRYH RQWKH(-%REMHFWVWXEIRUHQWLW\
7KHUHPRYH PHWKRGLQYRFDWLRQLVSDVVHGWRWKH(-%REMHFW
7KH&RQWDLQHUFDOOVHME5HPRYH RQWKHEHDQ
FRQWH[W
(-%
REMHFW
EHDQ
EHDQ
FRQWH[W
%HDQ3RRO
GHO
SULP HWHUR
DU\ Z '%
NH\ IRU
7KH&RQWDLQHURUEHDQGHOHWHVWKHHQWLW\LQWKHGDWDEDVH
7KHEHDQORVHVLWVLGHQWLW\ LQRWKHUZRUGVLWLVQRORQJHUUHSUHVHQWLQJHQWLW\ DQGPRYHV
EDFNWRWKHSRRO0HDQZKLOHWKH(-%REMHFWIRULVGHOHWHGVRWKHFOLHQW·VVWXEZLOOWKURZDQ
H[FHSWLRQLIWKHFOLHQWXVHVLWWRLQYRNHDPHWKRG
&KDSWHU
HQWLW\EHDQLQWUR
-V\Q\aJMIVKTQMV\^QM_
:MDD=LHGAFLK
$QHQWLW\LVDUHDOWKLQJWKDWH[LVWVRXWVLGHRI(-%LQD ,QDQHQWLW\KRPHDFUHDWH PHWKRGLVQRWUHTXLUHG
SHUVLVWHQWVWRUHDQGDQHQWLW\EHDQLVDQ22UHSUH VLQFHFUHDWH PHWKRGLQHQWLW\EHDQVDUHIRULQVHUWLQJ
VHQWDWLRQRUUHDOL]DWLRQRIDQHQWLW\ QHZHQWLWLHVLQWRWKHGDWDEDVHDQG\RX·UHQRWUHTXLUHG
&OLHQWVXVHHQWLW\EHDQVWRGRGDWDEDVHRSHUDWLRQVLQ WRDOORZ\RXUFOLHQWVWRGRWKDW
DQ22ZD\2SHUDWLRQVLQFOXGHFUHDWLQJQHZHQWL (QWLW\EHDQKRPHLQWHUIDFHVFDQKDYHVLQJOHURZRU
WLHV GDWDEDVHLQVHUWV GHOHWLQJHQWLWLHV GDWDEDVH PXOWLURZILQGHUPHWKRGV%RWKFUHDWHDQGILQGHUPHWK
GHOHWHV XSGDWLQJHQWLW\VWDWH GDWDEDVHXSGDWHV DQG RGVUHWXUQWKHFRPSRQHQWLQWHUIDFHRIDEHDQDOWKRXJK
VHDUFKLQJIRURQHQWLWLHV GDWDEDVHVHOHFWV PXOWLHQWLW\ILQGHUVUHWXUQD&ROOHFWLRQRIFRPSRQHQW
$QHQWLW\EHDQ5HPRWHFRPSRQHQWLQWHUIDFHH[WHQGV LQWHUIDFHUHIHUHQFHV
(-%2EMHFW7KHUH·VQRWDVHSDUDWHLQWHUIDFHIRUVHV (YHU\HQWLW\EHDQKRPHLVUHTXLUHGWRKDYHDWOHDVW
VLRQEHDQVDQGHQWLW\EHDQV7KDWPHDQVWKDWWKH RQHPHWKRG³WKHILQG%\3ULPDU\.H\ PHWKRGWKDW
FOLHQWZLOOVHHDOORIWKHPHWKRGVLQ\RXUFRPSRQHQW VHDUFKHVIRUDSDUWLFXODUHQWLW\DQGUHWXUQVLWVFRP
SRQHQWLQWHUIDFH LHDUHIHUHQFHWRWKDWHQWLW\·V(-%
LQWHUIDFHSOXVWKHILYHDGGLWLRQDOPHWKRGVIURP(-
REMHFW RUWKURZVDQH[FHSWLRQ
%2EMHFW
0XOWLSOHHQWLW\ILQGHUVGRQRWWKURZDQH[FHSWLRQLIQR
(QWLW\EHDQFRPSRQHQWLQWHUIDFHVXVXDOO\FRQWDLQ PDWFKLQJHQWLWLHVDUHIRXQG7KH\VLPSO\UHWXUQDQ
JHWWHUVDQGVHWWHUVIRUILHOGYDOXHVWKDWFRUUHVSRQGWR HPSW\FROOHFWLRQ
FROXPQVLQDGDWDEDVHWDEOHVXFKDVJHW/DVW1DPH
(QWLW\KRPHLQWHUIDFHFDQDOVRKDYHKRPHEXVLQHVV
JHW+RPH3KRQH VHW)LUVW1DPH HWF PHWKRGVIRURSHUDWLRQVWKDWDSSO\WRPRUHWKDQRQH
(QWLW\EHDQFRPSRQHQWLQWHUIDFHPHWKRGVDUHXVXDOO\ HQWLW\DVRSSRVHGWRRQHVSHFLILFHQWLW\%DWFKXSGDWHV
PHDQWWREHUXQE\DVSHFLILFXQLTXHO\LGHQWLILDEOH ZRXOGEHDJRRGXVHIRUDKRPHEXVLQHVVPHWKRG
HQWLW\)RUH[DPSOHFDOOLQJJHW/DVW1DPH RQWKH 7KHUHDOEHQHILWRIKRPHEXVLQHVVPHWKRGVLV
HQWLW\ZLWKSULPDU\NH\UHWXUQVWKHODVWQDPHRI WKDW³XQOLNHFUHDWHDQGILQGHUPHWKRGV³KRPHEXVL
WKHHQWLW\LQWKHGDWDEDVHZLWKWKHSULPDU\NH\ QHVVPHWKRGVFDQUHWXUQVRPHWKLQJRWKHUWKDQDQ(-%
'DQ'RRI REMHFWUHIHUHQFH,IWKHFOLHQWZDQWVRQO\GDWDVD\D
7KHUXOHVIRUKRZ\RXZULWHDQHQWLW\EHDQ5HPRWH &ROOHFWLRQRI6WULQJVUHSUHVHQWLQJWKHQDPHDQGSKRQH
FRPSRQHQWLQWHUIDFHDUHWKHVDPHDVWKHUXOHVIRU QXPEHURIHDFKFXVWRPHUDKRPHEXVLQHVVPHWKRG
VHVVLRQEHDQVLQFOXGLQJ H[WHQG(-%2EMHFWGHFODUH FDQGRWKDWZKLOHDILQGHUFDQQRW
5HPRWH([FHSWLRQVRQDOOPHWKRGVXVHRQO\50,,,23 $QHQWLW\EHDQFUHDWH LVYHU\GLIIHUHQWIURPDVHVVLRQ
W\SHVIRUDUJXPHQWVDQGUHWXUQYDOXHVGRQ·WEHJLQ EHDQFUHDWH EHFDXVHDQHQWLW\EHDQFUHDWH LQVHUWV
PHWKRGQDPHVZLWKWKHSUHIL[´HMEµHWF DQHZHQWLW\LQWRWKHXQGHUO\LQJSHUVLVWHQWVWRUH LH
$QHQWLW\EHDQKRPHLQWHUIDFHLVVXEVWDQWLDOO\GLIIHUHQW QHZURZLQWKHGDWDEDVH
IURPWKDWRIDVHVVLRQEHDQEHFDXVHHQWLW\EHDQVDUH $QHQWLW\EHDQUHPRYH LVGUDPDWLFDOO\GLIIHUHQWIURPD
W\SLFDOO\IRXQGUDWKHUWKDQFUHDWHG,QRWKHUZRUGVWKH VHVVLRQEHDQUHPRYH :KHQDFOLHQWFDOOVUHPRYH
FOLHQWLVPRUHOLNHO\WRWU\WRDFFHVVDQH[LVWLQJHQWLW\ RQDQHQWLW\EHDQLW·VWRGHOHWHWKHHQWLW\IURPWKHGDWD
DVRSSRVHGWRPDNLQJDQHZHQWLW\ ZKLFKPHDQVD EDVH7KDWPHDQVHYHU\ERG\LVGRQHZLWKWKHEHDQ
QHZURZLQWKHGDWDEDVH
\RXDUHKHUH
FRIIHHFUDPPRFNH[DP
0RFN([DP
7HAT IS TRUE CONCERNING LOCATING AN ENTITY BEANS HOME INTERFACE
1
R! 4HE QDUURZ METHOD SHOULD BE USED FOR A LOCAL HOME INTERFACE
R" 4HE QDUURZ METHOD SHOULD BE USED FOR A REMOTE HOME INTERFACE
R# 4HE QDUURZ METHOD SHOULD BE USED FOR BOTH LOCAL AND REMOTE
HOME INTERFACES
R$ 4HE QDUURZ METHOD SHOULD BE USED FOR NEITHER LOCAL NOR REMOTE
HOME INTERFACES
7HICH CAPABILITIES ARE FOUND IN AN ENTITY BEANS REMOTE COMPONENT INTERFACE
2 #HOOSE ALL THAT APPLY
R! CREATING NEW ENTITY OBJECTS
R" lNDING EXISTING ENTITY OBJECTS
R# REMOVING EXISTING ENTITY OBJECTS
R$ EXECUTING A HOME BUSINESS METHOD
R% RETRIEVING THE %*"-ETA$ATA INTERFACE
7HICH ARE WAYS IN WHICH A CLIENT CAN GET A REFERENCE TO AN EXISTING ENTITY
3 OBJECTS LOCAL COMPONENT INTERFACE #HOOSE ALL THAT APPLY
R! #ALL HME&UHDWH
R" #ALL JHW6HVVLRQ&RQWH[W
R# /BTAIN THE REFERENCE FROM THE HANDLE
R$ 2ECEIVE THE REFERENCE AS A PARAMETER IN A METHOD CALL
R% 5SE A lNDER METHOD DElNED IN THE LOCAL HOME INTERFACE
&KDSWHU
HQWLW\EHDQLQWUR
(OW MANY CREATE METHODS CAN BE DElNED IN AN ENTITY BEANS LOCAL HOME
4 INTERFACE
R!
R" /NLY
R# TO
R$ TO MANY
R% TO MANY
7HICH ARE WAYS IN WHICH A CLIENT CAN GET A REFERENCE TO AN EXISTING ENTITY
5 OBJECTS REMOTE COMPONENT INTERFACE #HOOSE ALL THAT APPLY
R! #ALL HME&UHDWH
R" /BTAIN THE REFERENCE FROM THE HANDLE
R# #ALL A METHOD ON THE ENTITY OBJECTS PRIMARY KEY
R$ 2ECEIVE THE REFERENCE AS A PARAMETER IN A METHOD CALL
R% 5SE A lNDER METHOD DElNED IN THE REMOTE HOME INTERFACE
7HICH APPROACHES CAN BE USED ON A PRIMARY KEY CLASS TO DETERMINE IF TWO
6 KEYS REFER TO THE SAME ENTITY #HOOSE ALL THAT APPLY
R! 5SING THE OPERATOR
R" 5SING THE HTXDOV METHOD
R# 5SING THE LV,GHQWLFDO METHOD
R$ NONE OF THE ABOVE
7HICH APPROACHES CAN DETERMINE WHETHER TWO ENTITY %*" OBJECT REFERENCES
7 REFER TO THE SAME ENTITY OBJECT #HOOSE ALL THAT APPLY
R! 5SING THE OPERATOR
R" 5SING THE HTXDOV METHOD
R# 5SING THE LV,GHQWLFDO METHOD
R$ NONE OF THE ABOVE
\RXDUHKHUH
FRIIHHFUDPPRFNH[DP
7HATS TRUE ABOUT THE CLIENTS VIEW OF AN ENTITY BEANS REMOTE COMPONENT
8 INTERFACE #HOOSE ALL THAT APPLY
R! -ULTIPLE CLIENTS CAN ACCESS THE SAME ENTITY OBJECT CONCURRENTLY
R" .EW ENTITY BEANS CAN BE CREATED USING A METHOD IN THIS INTERFACE
R# %NTITY BEANS MAY NOT SURVIVE A CRASH OF THE CONTAINER
R$ "USINESS METHODS CANNOT RETURN A REFERENCE TO THE ENTITY OBJECT
(OW MANY lNDER METHODS CAN BE DECLARED WITHIN AN ENTITY BEANS LOCAL HOME
9 INTERFACE
R!
R" /NLY
R# TO
R$ TO MANY
R% TO MANY
7HICH IS A LEGAL DECLARATION FOR A LOCAL HOME INTERFACES CREATE METHOD
10 #HOOSE ALL THAT APPLY
R! SXEOLF&XVWFUHDWH LQW[
R" SXEOLFYRLGFUHDWH LQW[ WKURZV&UHDWH([FHSWLRQ
R# SXEOLF&XVWFUHDWH LQW[ WKURZV&UHDWH([FHSWLRQ
R$ SXEOLF&XVWFUHDWH LQW[ WKURZV&UHDWH([FHSWLRQ
5HPRWH([FHSWLRQ
7HICH IS A LEGAL NAME FOR AN ENTITY BEAN HOME BUSINESS METHOD #HOOSE ALL
11` THAT APPLY
R! CREATE
R" CREATE#UST
R# REMOVE!LL
R$ lND#UST
R% SELECT#UST
&KDSWHU
HQWLW\EHDQLQWUR
0RFN([DP$QVZHUV
7HAT IS TRUE CONCERNING LOCATING AN ENTITY BEANS HOME INTERFACE (spec: 110)
1
R! 4HE QDUURZ METHOD SHOULD BE USED FOR A LOCAL HOME INTERFACE
R" 4HE QDUURZ METHOD SHOULD BE USED FOR A REMOTE HOME INTERFACE
R# 4HE QDUURZ METHOD SHOULD BE USED FOR BOTH LOCAL AND REMOTE
HOME INTERFACES
R$ 4HE QDUURZ METHOD SHOULD BE USED FOR NEITHER LOCAL NOR REMOTE
HOME INTERFACES
7HICH CAPABILITIES ARE FOUND IN AN ENTITY BEANS REMOTE COMPONENT INTERFACE
2 #HOOSE ALL THAT APPLY
R! CREATING NEW ENTITY OBJECTS
- home methods
R" lNDING EXISTING ENTITY OBJECTS
R# REMOVING EXISTING ENTITY OBJECTS
R$ EXECUTING A HOME BUSINESS METHOD
- home methods
R% RETRIEVING THE %*"-ETA$ATA INTERFACE
7HICH ARE WAYS IN WHICH A CLIENT CAN GET A REFERENCE TO AN EXISTING ENTITY (spec: 119)
3 OBJECTS LOCAL COMPONENT INTERFACE #HOOSE ALL THAT APPLY
R! #ALL HME&UHDWH - we said existing : )
R" #ALL JHW6HVVLRQ&RQWH[W ces
r Remote interfa
R# /BTAIN THE REFERENCE FROM THE HANDLE - handles are fo
R$ 2ECEIVE THE REFERENCE AS A PARAMETER IN A METHOD CALL
R% 5SE A lNDER METHOD DElNED IN THE LOCAL HOME INTERFACE
\RXDUHKHUH
PRFNH[DPDQVZHUV
4 (OW MANY CREATE METHODS CAN BE DElNED IN AN ENTITY BEANS LOCAL HOME (spec: 115)
INTERFACE
R!
to allow
R" /NLY - You donÕtcrhaeavete new entities
clients to
R# TO
R$ TO MANY
R% TO MANY
7HICH ARE WAYS IN WHICH A CLIENT CAN GET A REFERENCE TO AN EXISTING ENTITY (spec: 119)
5 OBJECTS REMOTE COMPONENT INTERFACE #HOOSE ALL THAT APPLY
R! #ALL HME&UHDWH - we said EXISTING
R" /BTAIN THE REFERENCE FROM THE HANDLE
R# #ALL A METHOD ON THE ENTITY OBJECTS PRIMARY KEY
R$ 2ECEIVE THE REFERENCE AS A PARAMETER IN A METHOD CALL
R% 5SE A lNDER METHOD DElNED IN THE REMOTE HOME INTERFACE
6 7HICH APPROACHES CAN BE USED ON A PRIMARY KEY CLASS TO DETERMINE IF TWO (spec: 120-121)
KEYS REFER TO THE SAME ENTITY #HOOSE ALL THAT APPLY
R! 5SING THE OPERATOR
heyÕre
equals() testm,etentity.
o ke ys pa ss t he
- if tw
R" 5SING THE HTXDOV METHOD the same key ! Which m
eans the sa
R# 5SING THE LV,GHQWLFDO METHOD - isIdentical() is
for paring
R$ NONE OF THE ABOVE component interfacecom references
7HICH APPROACHES CAN DETERMINE WHETHER TWO ENTITY %*" OBJECT REFERENCES (spec: 120-121)
7 REFER TO THE SAME ENTITY OBJECT #HOOSE ALL THAT APPLY
R! 5SING THE OPERATOR is for compa ring
- equals() pr ar y ke ys
R" 5SING THE HTXDOV METHOD entityÕs im
R# 5SING THE LV,GHQWLFDO METHOD
R$ NONE OF THE ABOVE
&KDSWHU
HQWLW\EHDQLQWUR
7HATS TRUE ABOUT THE CLIENTS VIEW OF AN ENTITY BEANS REMOTE COMPONENT (spec: 108)
8 INTERFACE #HOOSE ALL THAT APPLY
R! -ULTIPLE CLIENTS CAN ACCESS THE SAME ENTITY OBJECT CONCURRENTLY
R" .EW ENTITY BEANS CAN BE CREATED USING A METHOD IN THIS INTERFACE
R# %NTITY BEANS MAY NOT SURVIVE A CRASH OF THE CONTAINER
R$ "USINESS METHODS CANNOT RETURN A REFERENCE TO THE ENTITY OBJECT
(OW MANY lNDER METHODS CAN BE DECLARED WITHIN AN ENTITY BEANS LOCAL HOME (spec: 116)
9 INTERFACE
R!
R" /NLY
R# TO
R$ TO MANY ired
R% TO MANY - ÞndByPrim
aryKey() is requ
7HICH IS A LEGAL DECLARATION FOR A LOCAL HOME INTERFACES CREATE METHOD (spec: 115)
10 #HOOSE ALL THAT APPLY
xception
R! SXEOLF&XVWFUHDWH LQW[ - needs CreateE canÕt return void,
R" SXEOLFYRLGFUHDWH LQW[ WKURZV&UHDWH([FHSWLRQ - must return component
interface
R# SXEOLF&XVWFUHDWH LQW[ WKURZV&UHDWH([FHSWLRQ
R$ SXEOLF&XVWFUHDWH LQW[ WKURZV&UHDWH([FHSWLRQ
5HPRWH([FHSWLRQ
- local interface canÕt throw RemoteException
7HICH IS A LEGAL NAME FOR AN ENTITY BEAN HOME BUSINESS METHOD #HOOSE ALL (spec: 114)
11 THAT APPLY
R! CREATE ÒÞndÓ &
R" CREATE#UST ÒcreateÓ
ÒremoveÓ ed preÞxes
R# REMOVE!LL are reserv
R$ lND#UST
R% SELECT#UST
\RXDUHKHUH
bean/entity synchronization
4 5
4 %HLQJDQ(QWLW\%HDQ
$V DQHQWLW\EHDQ,OHDGWKH
JODPRURXVOLIHRIDQDFWUHVV,VSHQGPRVW
RIP\WLPHLQWKHSRROEXWHYHQZKHQ,GR
ZRUN,·PQHYHUERUHG,DOZD\VJHWWRSOD\
GLIIHUHQWUROHV\HVWHUGD\,ZDV-HDQQH
5RVHWRGD\,·P0DULO\Q0DORQHDQG
WRQLJKW,·OOEHSOD\LQJWKHSDUWRI
'RXJ$GDPV
(QWLW\EHDQVDUHDFWRUV$VORQJDVWKH\¶UHDOLYHWKH\¶UHHLWKHULQWKHSRRORU
WKH\¶UHEHLQJVRPHERG\6RPHERG\IURPWKHXQGHUO\LQJSHUVLVWHQWVWRUH,QRWKHUZRUGV
DQHQWLW\IURPWKHGDWDEDVH:KHQDEHDQLVSOD\LQJDSDUWWKHEHDQDQGWKHXQGHUO\LQJ
HQWLW\KDYHWRVWD\LQV\QF,PDJLQHWKHKRUURULIWKHEHDQLVSUHWHQGLQJWREHVD\$XGUH\
/HRQHDQGVRPHRQHORZHUV$XGUH\¶VFUHGLWOLPLWLQWKHGDWDEDVHEXWIRUJHWVWRWHOO
WKHEHDQ7KHEHDQDFWLQJDV$XGUH\LVKDSSLO\DXWKRUL]LQJSXUFKDVHVIRUPRUHWKDQ
$XGUH\¶VFXUUHQWOLPLW2UZKDWLIDFOLHQWXVHVWKHEHDQWRPRGLI\$XGUH\¶VDGGUHVVEXW
WKHEHDQKDQJVRQWRWKHQHZLQIRZLWKRXWWHOOLQJWKHGDWDEDVH\LNHV
WKLVLVDQHZFKDSWHU
H[DPREMHFWLYHV
(QWLW\%HDQ/LIHF\FOH
2IILFLDO :KDWLWUHDOO\PHDQV
,GHQWLI\FRUUHFWDQGLQFRUUHFWVWDWHPHQWV 7KLVREMHFWLYHFDQKLW\RXRQDOPRVWDQ\WKLQJUHODWHG
RUH[DPSOHVDERXWWKH%HDQ3URYLGHU¶V WRHQWLW\EHDQVVR\RXSUHWW\PXFKKDYHWRNQRZLW
YLHZDQGSURJUDPPLQJFRQWUDFWIRU&03 DOOLQFOXGLQJWKHGHWDLOVRID&03HQWLW\EHDQOLIHF\FOH
LQFOXGLQJWKHUHTXLUHPHQWVIRUD&03 WKHFRQWDLQHUFDOOEDFNPHWKRGVRIMDYD[HME(QWLW\%HDQ
HQWLW\EHDQ ZKDW\RXPXVWZULWHLQDEHDQFODVVDQGZKDWDEHDQ
FDQJHWIURPLWV(-%&RQWH[W
,GHQWLI\WKHLQWHUIDFH V DQGPHWKRGV <RXKDYHWRNQRZWKDWSDVVLYDWLRQLQHQWLW\EHDQV
D&03HQWLW\EHDQPXVWDQGPXVWQRW LVGLIIHUHQWIURPVHVVLRQEHDQSDVVLYDWLRQEHFDXVH
LPSOHPHQW HQWLW\EHDQVJREDFNWRDSRRODIWHUHME3DVVLYDWH
EXWVWD\DVKHDOOLYLQJREMHFWV<RXPXVWNQRZWKDW
,GHQWLI\FRUUHFWDQGLQFRUUHFWVWDWHPHQWV HQWLW\EHDQFUHDWLRQLVDOVRFRPSOHWHO\GLIIHUHQWIRU
RUH[DPSOHVDERXWWKHOLIHF\FOHRID&03 HQWLW\EHDQVDQGWKDWDFUHDWH FDOORQDQHQWLW\
HQWLW\EHDQ EHDQPHDQV³LQVHUWDQHZHQWLW\LQWRWKHXQGHUO\LQJ
SHUVLVWHQWVWRUH´<RXKDYHWRNQRZWKDWUHPRYH RQ
DQHQWLW\EHDQLVPRUHGUDVWLFIRUHQWLW\EHDQVWKDQ
VHVVLRQEHDQV²DQHQWLW\EHDQUHPRYHGHOHWHVWKH
)URPDOLVWLGHQWLI\WKHSXUSRVHEHKDYLRU HQWLW\IURPWKHGDWDEDVH
DQGUHVSRQVLELOLWLHVRIWKH%HDQ3URYLGHU
IRUD&03HQWLW\EHDQLQFOXGLQJEXWQRW
<RXPXVWEHDEOHWRORRNDWDQHQWLW\EHDQPHWKRGDQG
OLPLWHGWR VHW(QWLW\&RQWH[W
NQRZWKHFLUFXPVWDQFHVXQGHUZKLFKWKDWPHWKRGLV
XQVHW(QWLW\&RQWH[W HME&UHDWH HME
FDOOHGDQGZKDW\RXVKRXOGGRLQWKDWPHWKRG)RUH[
3RVW&UHDWH HME$FWLYDWH HME3DVVLYDWH
DPSOH\RXQHHGWRNQRZWKDWLQDEHDQ¶VHME&UHDWH
HME5HPRYH HME/RDG HME6WRUH HME
PHWKRGWKHEHDQFDQQRWJHWDUHIHUHQFHWRLWV(-%
)LQG HME+RPH DQGHME6HOHFW
REMHFWEXWWKDWLWFDQJHWWKDWUHIHUHQFHLQHME3RVW&UH
DWH
<RXQHHGWRNQRZZKLFKPHWKRGV\RX¶UHUHTXLUHGWR
)URPDOLVWLGHQWLI\WKHSXUSRVHEHKDYLRU
DQGUHVSRQVLELOLWLHVRIWKH&RQWDLQHUIRUD ZULWHLQWR\RXUEHDQDQGZKLFKDUHOHIWWRWKH&RQ
&03HQWLW\EHDQLQFOXGLQJEXWQRWOLPLWHG WDLQHU)RUH[DPSOH\RXQHHGWRNQRZWKDWWKH%HDQ
WR VHW(QWLW\&RQWH[W XQVHW(QWLW\&RQWH[W 3URYLGHUPXVWZULWHDEVWUDFWJHWWHUVDQGVHWWHUVIRU
HME&UHDWH HME3RVW&UHDWH HME$FWLYDWH SHUVLVWHQW¿HOGVEXWPXVWGH¿QH¿QGHUPHWKRGVRQO\
HME3DVVLYDWH HME5HPRYH HME/RDG LQWKHKRPHLQWHUIDFHQRWWKHEHDQFODVV
HME6WRUH HME)LQG HME+RPH DQGHME
6HOHFW
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
(QWLW\%HDQ/LIHF\FOH
2IILFLDO :KDWLWUHDOO\PHDQV
)URPDOLVWRIEHKDYLRUVPDWFKWKHPZLWK <RXKDYHWRNQRZWKHPHWKRGVRI(QWLW\&RQWH[WDVZHOO
WKHDSSURSULDWH(QWLW\&RQWH[WPHWKRG DVWKHFLUFXPVWDQFHVXQGHUZKLFK\RXFDQFDOOWKRVH
UHVSRQVLEOHIRUWKDWEHKDYLRU PHWKRGV)RUH[DPSOH\RXVKRXOGNQRZWKDWLI\RX¶UH
UXQQLQJLQWKHVHW(QWLW\&RQWH[W PHWKRG\RXFDQXVH
\RXUVSHFLDO-1',QDPHVSDFHWRORRNXSDUHIHUHQFHWR
,GHQWLI\FRUUHFWDQGLQFRUUHFWVWDWHPHQWV D'DWD6RXUFHEXWWKDW\RX¶UHQRWDOORZHGWRDFFHVVWKH
DERXWDQHQWLW\EHDQ¶VSULPDU\NH\DQG XQGHUO\LQJGDWDEDVHIURPWKDWPHWKRG WKHUH¶VQRPHDQ
REMHFWLGHQWLW\ LQJIXOWUDQVDFWLRQVRWKH&RQWDLQHUZRQ¶WOHW\RXGRLW
<RXVKRXOGNQRZWKDW\RXFDQ¶WFDOOJHW8VHU7UDQVDFWLRQ
RQ\RXUFRQWH[WEHFDXVHHQWLW\EHDQVPXVWXVHFRQ
WDLQHUPDQDJHGWUDQVDFWLRQVDQGJHW8VHU7UDQVDFWLRQLV
IRUEHDQPDQDJHGWUDQVDFWLRQVRQO\
<RXKDYHWRNQRZWKDWDQHQWLW\EHDQPXVWKDYHD
XQLTXHLGHQWLW\ QRWZREHDQVFDQKDYHWKHVDPH
SULPDU\NH\ DQGWKDWD&03EHDQ¶VSULPDU\NH\PXVW
EHHLWKHURQHRIWKHEHDQ¶VSHUVLVWHQW¿HOGVRUDFXVWRP
SULPDU\NH\FODVVZKRVH¿HOGVDUHDOOIURPFRQWDLQHU
PDQDJHG¿HOGVGH¿QHGLQWKHEHDQ<RXPXVWNQRZWKDW
WKHSULPDU\NH\FODVVW\SHPXVWEH6HULDOL]DEOHDQGWKDW
LWPXVWKDYHDYDOLGRYHUULGHRIHTXDOV DQGKDVKFRGH
\RXDUHKHUH
HQWLW\EHDQV\QFKURQL]DWLRQ
<PMZMITXW_MZWNMV\Q\aJMIV[Q[
[aVKPZWVQbI\QWV 7KH&RQWDLQHUDOZD\VNQRZVZKHQWKH
EHDQDQGWKHGDWDEDVH WKHXQGHUO\LQJ
HQWLW\ PXVWEHV\QFKURQL]HGVRWKDW
4HE BEAN AND THE UNDERLYING ROW IN THE DATABASE MUST QHLWKHURQHKDVµVWDOH¶GDWD
STAY IN SYNC 2EMEMBER THE BEAN IS NOT THE ENTITYTHE
BEAN IS A REPRESENTATION OF THE REAL ENTITY 4HE BEAN IS
AN // WAY OF WORKING WITH THE DATA BUT THE ENTITY IN 2. ,KDYH
THE DATABASE IS THE ONLY TRUE ENTITY )F THE ENTITY IN THE WKHEHDQIRU&KULV
DATABASE DIES IE IS DELETED THE BEAN FOR THAT SPECIlC 0DUWLQDQGQRZ,ZDQWWR
ENTITY DIES TOO ALTHOUGH THE BEAN INSTANCE STILL LIVES AS FKDQJHKLVDGGUHVVWR
YOU SAW IN THE LAST CHAPTER &ORFN6WUHHW6R,·OO
FDOOVHW$GGUHVV RQ
4HE #ONTAINERS JOB IS MAKE SURE THAT THE ENTITY AND THE BEAN WKHEHDQ
STAY IN SYNC SO THAT NOBODYS LOOKING AT A STALE BEAN OR A
STALE ROW IN THE DATABASE +EEP IN MIND THAT THE ENTITY
BEAN MAY NOT BE THE ONLY WAY TO GET INTO THE DATABASE &RRO,·YH
)N FACT IN MOST CASES THE "EAN 0ROVIDER YOU WILL HAVE XSGDWHGP\EHDQ
VWDWHZLWKWKHQHZ
NO WAY TO KNOW FOR CERTAIN DURING DEVELOPMENT IF YOUR DGGUHVV
BEAN IS THE ONLY WAY ANYONE WILL EVER BE ABLE TO GET TO THE
ENTITY DATA
&OR EXAMPLE YOUR #USTOMER DATABASE MIGHT BE USED
BY A BUNCH OF APPS IN YOUR COMPANY INCLUDING SOME
THAT WORK DIRECTLY WITH THE DATABASE AND SOME THAT GO
THROUGH THE #USTOMER BEAN IN AN %*" APPLICATION
)F A CLIENT HAS A REFERENCE TO A BEAN THE CLIENT MIGHT EHDQFXUUHQWO\
CHANGE THE BEANS STATE BY SAY CALLING A SETTER METHOD SOD\LQJ
)F THAT SETTER METHOD CORRESPONDS TO ONE OF THE BEANS
PERSISTENT lELDS IN OTHER WORDS A COLUMN IN THE
TABLE LIKE ADDRESS THE BEAN AND THE DATABASE WILL BE +(//2([FXVHPH
TEMPORARILY OUT OF SYNC 4HE DATABASE WONT HAVE THE ,·PJODG\RX·UHDOOKDYLQJD
CURRENT ADDRESS UNTIL THE BEAN UPDATES THE DATABASE QLFHFKDWDERXWLWEXWGRQ·W\RX
WKLQNWKHGDWDEDVHPLJKWOLNH
.OW THINK WHAT A DISASTER IT WOULD BE IF THE BEAN CACHES WRNQRZDERXWWKDWDGGUHVV
THE NEW DATA FOR THE ENTITY WITHOUT TELLING THE DATABASE FKDQJH""
)F SOMEONE COMES ALONG WITH ANOTHER APPLICATION AND
ASKS FOR THAT #USTOMERS ADDRESS FROM THE DATABASE 4HAT
7OULD "E "AD
""
!ND THE OPPOSITE SCENARIO IS BAD AS WELL IF SOMEONE
UPDATES THE DATABASE THE BEAN NEEDS TO KNOW /THERWISE
THE BEAN IS OUT THERE IN THE %*" APP REPRESENTING THE
ENTITY IN THE DATABASE BUT THE BEAN ISNT A TRUE REmECTION
OF THE ENTITYS STATE )N OTHER WORDS THE BEAN IS STALE '%
7HICH MEANS PERHAPS USELESS
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
2KQR
7KHHQWLW\EHDQDQGWKHHQWLW\LW
UHSUHVHQWVKDYHGLIIHUHQWGDWD
)LUVW &KULV
/DVW 0DUWLQ
.H\
Someone changed the
$GGUHVV &ORFNVW
but not the databa bean state,
3KRQH se !
)LUVW /DVW .H\ $GGUHVV 3KRQH
&KULV 0DUWLQ )RRVW
)UDQ +HDO\ %DUUG
%HOD )OHFN 3LFNODQH
7KH&RQWDLQHU·VPRVWLPSRUWDQWHQWLW\EHDQMRELVWRPDNH
VXUHWKDWWKLVVFHQDULR³ZKHUHWKHEHDQDQGWKHGDWDEDVH
DUHRXWRIV\QF³GRHVQ·WFDXVHDQ\GDPDJH
7KH&RQWDLQHUKDVWRPDNHVXUHWKDW
:KLOHVRPHERG\LVZRUNLQJZLWKWKHEHDQ DQGSRWHQWLDOO\FKDQJLQJ
LWVVWDWH QRERG\FDQZRUNZLWKWKHUHDOHQWLW\LQWKHGDWDEDVH
2QFHDQHQWLW\EHDQ·VVWDWHKDVEHHQXSGDWHGWKHGDWDEDVHKDVWR
EHXSGDWHGEHIRUHDQ\RQHHOVHFDQDFFHVVWKDWUHFRUGLQWKHGDWD
EDVH
%HIRUHWKHEHDQFDQUXQDQ\EXVLQHVVPHWKRGVRQDSDUWLFXODUHQWLW\·V
EHKDOIWKHEHDQKDVWREHUHIUHVKHGZLWKWKHHQWLW\·VVWDWH,QRWKHU
ZRUGVEHIRUHWKHHQWLW\EHDQIRU-RH%ORJJVFDQUXQDJHW&UHG
LW/LPLW PHWKRGWKH&RQWDLQHUKDVWRORDGWKHHQWLW\EHDQXSZLWKWKH
PRVWFXUUHQWGDWDIRU-RH%ORJJV2WKHUZLVHWKHEHDQPLJKWUHWXUQ
WKHZURQJFUHGLWOLPLW³WKHOLPLWWKDWZDVLQSODFHWKHODVWWLPHWKH
EHDQZDVORDGHGXSZLWK-RH·VGDWDIURPWKHGDWDEDVH
\RXDUHKHUH
HQWLW\EHDQV\QFKURQL]DWLRQ
8KRK1RZ\RX·YHJRWPHHYHQ025(
ZRUULHG'RHVQ·WWKLVPHDQWKHQWKDWWKH
EHDQFDQJHWVWDOHLQEHWZHHQ(9(5<EXVLQHVV
PHWKRGFDOO"$UH\RXWHOOLQJPH\RXKDYHWRPDNHD
WULSWRWKHGDWDEDVHWRUHIUHVKWKHEHDQ·VGDWDZLWK
WKHDFWXDOGDWDEDVHGDWDMXVWLQFDVHLWFKDQJHG
HYHU\WLPHWKHFOLHQWFDOOVDPHWKRGRQWKHEHDQ"
,I7+$7·VWUXH\RXPLJKWDVZHOOMXVWJR
VWUDLJKWWRWKHGDWDEDVH
1R7KDW·VQRWZKDW,·P
VD\LQJEXW,FDQVHHKRZLWPLJKW
ORRNOLNHWKDW7KHPLVVLQJSLHFHKHUH
LVWKHWUDQVDFWLRQ$VORQJDVWKHEHDQ·V
PHWKRGVDUHEHLQJFDOOHGDVSDUWRID
VLQJOHWUDQVDFWLRQWKHEHDQGRHVQ·W
KDYHWRV\QFKURQL]HLWVVWDWHZLWK
GDWDLQWKHGDWDEDVH
6HHZKHQWKHFOLHQWFDOOVDEXVLQHVV
PHWKRGDQGWKDWPHWKRGVWDUWVD
WUDQVDFWLRQ,WHOOWKHGDWDEDVHWRORFNWKH
HQWLW\ )RUQRZ\RXFDQWKLQNRILWDVORFNLQJ
WKHURZDOWKRXJKLWPLJKWDFWXDOO\EHVRPHWKLQJD
OLWWOHGLIIHUHQW :LWKWKHUHDOHQWLW\ORFNHGWKH
EHDQFDQ·WEHFRPHVWDOHEHFDXVHQRERG\FDQJHW
LQWRWKHHQWLW\WKURXJKWKHGDWDEDVH,ZRQ·WWHOO
WKHGDWDEDVHWRUHOHDVHWKHORFNXQWLOWKH
WUDQVDFWLRQLVRYHUVRWKHEHDQLVVDIH
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
+RZWKHHQWLW\EHDQDQGWKHXQGHUO\LQJ
HQWLW\VWD\V\QFKURQL]HG
&OLHQWFDOOVD
EXVLQHVVPHWKRG &RQWDLQHULQWHUFHSWVWKH
FDOODQGVWDUWVDWUDQVDFWLRQ
%()25(JHWWLQJWKHEHDQ
&RQWDLQHUWHOOVWKHGDWDEDVHWRORFNWKH
URZ WRDQ\RQHHOVHEXWWKH&RQWDLQHU
/DVW )LUVW 3.H\ &RQWDLQHUORDGVWKHEHDQ
3RO\ 0RUSKLVP ZLWKWKHHQWLW\VWDWHIURPWKH
'% GDWDEDVH1RZQRERG\FDQ
'HZH\ &KHDWHP H[FHSWWKHEHDQFDQFKDQJH
WKHHQWLW\GDWD
'%
%HDQUXQVPXOWLSOHEXVLQHVV
PHWKRGVLQWKHVDPHWUDQVDFWLRQ
NQRZLQJWKDWWKHXQGHUO\LQJ
HQWLW\GDWDLQWKHGDWDEDVHFDQ¶W
, EHFKDQJHG EHFDXVHWKHURZIRU
WKLVHQWLW\LVORFNHG &RQWDLQHUHQGVWKHWUDQVDFWLRQ
EXW¿UVWLWXSGDWHVWKH
GDWDEDVHZLWKZKDWHYHUQHZ
VWDWHWKHEHDQPLJKWKDYH
EHHQFDFKLQJRQEHKDOIRIWKDW
HQWLW\ OLNHLIVRPHRQHFDOOHG
VHW$GGUHVV RQWKHEHDQ
&RQWDLQHUWHOOVWKHGDWDEDVHWRUHOHDVH
WKHORFNRQWKHHQWLW\URZ
'%
/DVW )LUVW 3.H\
3RO\ 0RUSKLVP
'%
'HZH\ &KHDWHP
\RXDUHKHUH
HQWLW\EHDQV\QFKURQL]DWLRQ
<PMWVTaY]M[\QWVQ[?07LWM[\PM_WZS
_PMVQ\¼[\QUM\W[aVKPZWVQbM
4HE #ONTAINER ALWAYS KNOWS WHEN THE BEAN AND THE DATABASE
ENTITY MUST BE SYNCHRONIZED )T KNOWS BASED ON TRANSACTIONS
)F A CLIENT CALLS A METHOD ON A BEAN AND THAT METHOD STARTS A &RQWDLQHU0DQDJHG
NEW TRANSACTION FOR THE BEAN THE #ONTAINER KNOWS THAT THE
UNDERLYING ENTITY IN THE DATABASE MAY HAVE CHANGED SINCE THE 3HUVLVWHQFH &03 PHDQVWKH
LAST TIME THIS BEAN WAS LOADED UP WITH THIS ENTITYS DATA 3O THE
#ONTAINER FORCES THE BEAN TO REFRESH ITS STATE BY LOADING IN THE &RQWDLQHUWDNHVFDUHRIDOO
ENTITYS DATA
WKHGDWDEDVHDFFHVVFRGHIRU
!ND OF COURSE THE REVERSE IS TRUE )F THE BEAN COMPLETES A
METHOD AND THIS METHOD WAS THE END OF THE TRANSACTION THE V\QFKURQL]DWLRQLQFOXGLQJ
#ONTAINER WILL TELL THE DATABASE TO RELEASE THE LOCK ON THIS
ENTITY IN THE DATABASE "UT DURING THE TIME WHEN THE ROW DGGLQJDQGGHOHWLQJHQWLWLHV
WAS LOCKED THE BEAN MIGHT HAVE BEEN HAPPILY CACHING DATA UHFRUGVURZVLQWKH
THAT REPRESENTS THE NEWLY
CHANGED STATE OF THE ENTITY LIKE A
NEW ADDRESS OR PHONE NUMBER )N OTHER WORDS THE CLIENT GDWDEDVH
MIGHT HAVE BEEN CALLING SETTER METHODS ON THE BEAN WITH THE
INTENTION OF CAUSING AN UPDATE IN THE REAL DATABASE 4HE CLIENT
WANTS TO UPDATE A RECORD 3O THE #ONTAINER KNOWS IT MUST
FORCE THE BEAN TO UPDATE THE DATA IN THE DATABASE WITH THE %HDQ0DQDJHG3HUVLVWHQFH
BEANS STATE BEFORE THE #ONTAINER TELLS THE DATABASE TO RELEASE %03 PHDQV<28ZULWHWKH
THE LOCK ON THAT ENTITY
/+ SO THE WHEN IS NOT THE ISSUE !ND THATS IMPORTANT BECAUSE GDWDEDVHDFFHVVFRGH WKH
OTHERWISE YOU THE "EAN 0ROVIDER WOULD HAVE TO WORK OUT THE
BUSINESS LOGIC TO KNOW EXACTLY WHEN THERE WAS A DANGER THAT
-'%&VWDWHPHQWV IRUZKHQ
THE BEAN AND ENTITY ARE OUT OF SYNC !ND YOU CAN JUST IMAGINE WKH&RQWDLQHUWHOOV\RXLWV
HOW QUICKLY YOU COULD CORRUPT THE STATE OF YOUR DATABASE
4HE REAL ISSUE IS WHO DOES THE DATABASE ACCESS !ND THERE ARE
WLPHWRJRWRWKHGDWDEDVH
ONLY TWO CHOICES ITS EITHER YOU OR THE #ONTAINER
)F YOU WRITE THE DATABASE ACCESS CODE YOU WRITE *$"#
STATEMENTS IN THE CALLBACK METHODS THE #ONTAINER CALLS WHEN ,Q(-%\RXVKRXOG
ITS TIME TO KICK YOU AND SAY h(EY
TIME TO GO TO THE DATABASEv XVH&03,WVDYHV\RXD
/N THE OTHER HAND IF THE #ONTAINER WRITES THE DATABASE CODE
YOU SAVE YOURSELF A LOT OF CODING TIME AND EFFORT AND YOULL ORWRIZRUNDQGYLUWXDOO\
ALMOST ALWAYS GET BETTER PERFORMANCE
DOZD\VJLYHV\RXEHWWHU
SHUIRUPDQFH
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
+WV\IQVMZUIVIOML^[JMIVUIVIOMLXMZ[Q[\MVKM
&RQWDLQHUPDQDJHGSHUVLVWHQFH &03
:LPS\LQ(-% JUHDWO\HQKDQFHGLQ(-%
&03
7KH%HDQ3URYLGHUGHVLJQVWKHHQWLW\EHDQFODVVFKRRVLQJZKLFKRI
WKHEHDQ·VILHOGVDUHSDUWRIWKHEHDQ·VSHUVLVWHQWVWDWH3HUVLVWHQW
ILHOGVPDSWRFROXPQVLQRQHRUPRUHGDWDEDVHWDEOHV
7KH&RQWDLQHUNHHSVWUDFNRIFKDQJHVWRWKHEHDQ·VVWDWHDQG
XSGDWHVWKHUHDOHQWLW\DVQHHGHG)RUH[DPSOHLIDFOLHQWFDOOV '%
VHW/DVW1DPH RQWKHEHDQWKH&RQWDLQHUNQRZVWKDWWKHUHDOHQWLW\
LQWKHGDWDEDVHKDVWREHXSGDWHGVRWKDWLIDQ\RQHHOVHDFFHVVHV
WKHGDWDEDVHIRUWKDWHQWLW\ LQFOXGLQJQRQ(-%FOLHQWVXVLQJVRPH 7KH&RQWDLQHUJRHVWRWKHGDWDEDVH
RWKHUPHDQVWRJHWWRWKHGDWDEDVH WKH\·OOVHHWKHFXUUHQWVWDWH ZKHQLWQHHGVWRLQVHUWDQHZHQWLW\
RIWKHHQWLW\7KH&RQWDLQHUPDNHVWKHGHFLVLRQVRQKRZWRNHHS GHOHWHDQGHQWLW\XSGDWHWKHGDWDEDVH
WKHEHDQDQGWKHUHDOHQWLW\V\QFKURQL]HGEDVHGRQWKHVWDWHRI ZLWKQHZHQWLW\VWDWH LHRQHRUPRUH
WUDQVDFWLRQV 0RUHRQWKDWODWHU FROXPQVLQWKHHQWLW\URZKDYHFKDQJHG
WKURXJKWKHEHDQ
7KH%HDQ3URYLGHUZULWHV(-%4/WRWHOOWKH&RQWDLQHUKRZWRGR
VHOHFWV(-%4/LVOLNHDVXEVHWRI64/EXWZLWKVRPH22IHDWXUHV
(-%4/KHOSVEULGJHWKH22ZRUOGRI\RXUEHDQWRWKHUHODWLRQDOZRUOG
RI\RXUUHDOHQWLW\
8VLQJLQIRUPDWLRQLQWKHGHSOR\PHQWGHVFULSWRUWKH&RQWDLQHUZULWHV
WKHDFWXDOLPSOHPHQWDWLRQRIWKH&03EHDQLQFOXGLQJLPSOHPHQWLQJ %03
WKHILQGHUDQGVHOHFWPHWKRGVDQGDOORIWKHGDWDEDVHDFFHVVFRGH
,QRWKHUZRUGVLI\RX·UHD%HDQ3URYLGHUZULWLQJD&03EHDQ\RXGR
QRWORRNXSDUHVRXUFHFRQQHFWLRQIDFWRU\IRUWKH'DWD6RXUFHJHW
DQ64/&RQQHFWLRQRUZULWHDQ\-'%&FRGH1RWRQO\LVWKHGDWD
DFFHVVFRGHWDNHQFDUHRIE\WKH&RQWDLQHUEXW\RXFDQWUXVWWKDWWKH
&RQWDLQHUNQRZVH[DFWO\ZKHQWRJRWRWKHGDWDEDVH
'%
%HDQPDQDJHGSHUVLVWHQFH %03
%HDQ3URYLGHUZULWHVWKHGDWDEDVHDFFHVVFRGHLQFOXGLQJORRNLQJXS
D'DWD6RXUFHJHWWLQJD&RQQHFWLRQDQGVHQGLQJ-'%&VWDWHPHQWV 7KH&RQWDLQHULQYRNHVDFRQWDLQHUFDOO
WRWKHGDWDEDVH,W·VVWLOOEHWWHUWKDQLI\RXGLGQ·WXVHHQWLW\EHDQVDW EDFNRQWKHEHDQZKHQWKHEHDQQHHGV
DOOEHFDXVHWKH&RQWDLQHUZLOODWOHDVWWHOOD%03EHDQZKHQWRJR WRGRVRPHWKLQJZLWKWKHGDWDEDVHDQG
WRWKHGDWDEDVHVRZLWK%03\RXGRQ·WKDYHWRSXWLQORJLFWRNHHS WKHEHDQFRGHGRHVWKHDFWXDO-'%&
WKHEHDQDQGWKHGDWDEDVHLQV\QF:KHQWKH&RQWDLQHUWHOOV\RXWR ZRUN
XSGDWHWKHGDWDEDVH\RXMXVWGRLW
\RXDUHKHUH
HQWLW\EHDQV\QFKURQL]DWLRQ
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: $OESNT THE #ONTAINER STILL HAVE Q: )T SEEMS LIKE PERFORMANCE WOULD
TO GIVE YOU THE DATABASE #ONNECTION BE BETTERNOT WORSEWITH "-0
)SNT THAT THE WHOLE POINT OF LOOKING UP $OESNT "-0 GIVE YOU MORE CONTROL
A $ATA3OURCE USING RESOURCE FACTORY
REFERENCES )F THATS TRUE THEN HOW CAN
YOU DO BEAN
MANAGED PERSISTENCE A: 9OU HAVE MORE FLEXIBILITY WITH
/R IS "-0 A WAY TO BYPASS ALL THAT IN "-0 BUT NOT NECESSARILY MORE CONTROL
WHICH CASE YOUD BE BYPASSING THE !ND ACCORDING TO NEARLY ALL BENCHMARKS
#ONTAINER SERVICES FOR CONNECTION POOL
AGAINST THE MAJOR *%% SERVERS NOT
ING AND BETTER PERFORMANCE 4HAT MIGHT SOUND
COUNTERINTUITIVE BUT REMEMBER THAT THE
A: 2ELAX 2EALLY 7ITH "-0 YOU
#ONTAINER CAN DO THINGS THAT YOU CANT
DO FROM WITHIN BEAN CODE 4HINGS LIKE
GANGING MULTIPLE CALLS TO THE DATABASE
STILL GET YOUR DATABASE CONNECTION
FROM THE #ONTAINER BY LOOKING UP AS USING NATIVE CODE TO GET IN AN OUT OF
YOU SAID A RESOURCE FACTORY REFERENCE THE DATABASE FASTER THAN YOU COULD LAZY
JAVAXSQL$ATA3OURCE 'EE YOU MUST LOADING DIRTY DETECTION NEITHER OF WHICH
HAVE BEEN READING AHEAD TO THE CHAPTER ARE GUARANTEED BY THE SPEC OF COURSE
ON THE %*" ENVIRONMENT "ECAUSE YOURE AND DOZENS OF OTHER TRICKS
RIGHT YOU NEED TO GET A CONNECTION 7E KNOW IT GOES AGAINST THE
FROM A CONNECTION POOL MANAGED BY THE CONVENTIONAL WISDOM THAT SAYS IF YOU
#ONTAINER "UT ONCE YOU GET THE CONNEC
WANT IT DONE RIGHT DO IT YOURSELF BUT
TION FOR A "-0 BEAN YOURE ON YOUR OWN KEEP IN MIND THAT THE SERVER VENDORS ARE
FOR SENDING IT STATEMENTS TO DO ).3%24 COMPETING FOR YOUR BUSINESS 4HEY KNOW
$%,%4% 50$!4% 3%,%#4 OPERATIONS PERFORMANCE MATTERS TO YOU 4HE
!ND WHILE WERE HERE REMEMBER THAT DA
SPEC ADDEDAND CHANGEDA LOT OF THE
TABASE ACCESS IS NOT JUST FOR ENTITY BEANS #-0 SPECIFICATION FOR THE SOLE PURPOSE
!.9 BEAN CAN GO TO THE DATABASE AS PART OF GIVING THE VENDORS MORE ROOM FOR
OF ITS BUSINESS LOGIC 3ESSION BEANS AND OPTIMIZING #-0
MESSAGE
DRIVEN BEANS MIGHT FIND PLENTY
OF REASONS TO LOOK SOMETHING UP OR STORE
SOMETHING IN A DATABASE 4HE DIFFERENCE
BETWEEN ENTITY BEANS AND THE OTHER TWO
BEAN TYPES IS THAT ENTITY BEANS EXIST ONLY
BECAUSE THERES SOMETHING IN A DATA
BASE 3OMETHING THE BEAN REPRESENTS
3O ENTITY BEANS ARE BY DEFINITION TIED TO
SOMETHING IN A PERSISTENT STORE
-ESSAGE
DRIVEN AND SESSION BEANS DO
NOT REPRESENT SOMETHING IN A DATABASE
ALTHOUGH THEY MAY NEED TO USE SOME
THING IN A DATABASE AS PART OF THEIR BUSI
NESS LOGIC
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
)JZQMNPQ[\WZaWV\PM
M^WT]\QWVWN+58
"EGINNING WITH VERSION OF THE %*" SPEC YOU COULD USE BOTH CONTAINER
MANAGED PERSISTENCE #-0 AND BEAN
MANAGED PERSISTENCE"-0 !T
THE HIGHEST LEVEL THE DIFFERENCE BETWEEN #-0 AND "-0 IS ABOUT WHO
WRITES THE DATABASE ACCESS CODE
7ITH %*" YOU CAN STILL USE BOTH BUT THERES NOW VERY LITTLE REASON
TO EVER USE "-0 4HE ORIGINAL %*" SPECIlCATION FOR #-0 ENTITY
BEANS WAS UM WEAK #LUNKY )NEFlCIENT ,IMITED .OT 4HAT 'OOD !ND 7KHH[DP
ALTHOUGH MANY VENDORS WERE ABLE TO OVERCOME MANY OF THE PROBLEMS GRHVQ·WFRYHU
WITH #-0 THE SOLUTIONS WERE OUTSIDE THE SPECIlCATION SO YOUR CHOICE WKHKLVWRU\JRVVLSRUVFDQGDOV
AS BEAN DEVELOPER WAS TO USE STANDARD #-0 BUT KEEP YOUR PORTABILITY RIWKH(-%VSHFLILFDWLRQ
OR STEP OUTSIDE THE SPEC REDUCING YOUR PORTABILITY BUT GET BETTER $OWKRXJKLWZRXOGKDYHPDGH
PERFORMANCE AND FEATURES WKHERRNPXFKVSLFLHULILWGLG
$KZHOOZH¶OOMXVWKDYHWRPDNH
7HEN THE %*" SPEC WAS CREATED THE TEAM SPENT A GREAT DEAL OF TIME GRZLWKWKHWHFKQLFDOFRQWHQW
AND EFFORT TALKING TO BOTH END
USER CUSTOMERS BEAN DEVELOPERS AND
6WLOOZHWKLQNWKHZD\D
CONTAINER VENDORS ALL OF WHOM WERE VERY HAPPY TO DESCRIBE THE PROBLEMS
VSHF DQ\VSHF HYROYHVLV
WITH #-0 )N GRAPHIC DETAIL COMPLETE WITH SUGGESTIONS FOR 3UN ON h)LL
LQWHUHVWLQJ6XQZRUNVKDUG
TELL YOU WHAT YOU CAN $/ WITH YOUR #-0 BEAN SPECv WRZDONWKH¿QHOLQHEHWZHHQ
4HE %*" SPEC TEAM LISTENED !ND DESIGNED !ND LISTENED !ND DESIGNED KDYLQJDPHDQLQJIXOVSHF
!ND IN THE END THEY CAME UP WITH SOMETHING AWFUL ! SOLUTION THAT WAS ZLWKVWURQJJXDUDQWHHVIRU
WKHSURJUDPPHUDQGRQH
AN EQUAL
OPPORTUNITY PISSER
OFFER 6ENDORS HATED IT $EVELOPERS HATED IT
WKDW¶VYDJXHHQRXJKRQ
0EOPLE LIKE US WHO HAD TO EXPLAIN THE NEW TECHNOLOGY TO CUSTOMERS REALLY LPSOHPHQWDWLRQGHWDLOVWR
HATED IT 3O WITH THE DEADLINE UPON THEM THE TEAM SCRAPPED MUCH OF OHWWKHYHQGRUVFRPSHWH
WHAT THEYD DONE WITH #-0 AND CAME UP WITH A MUCH CLEANER SOLUTION RQWKHSHUIRUPDQFHRIWKHLU
7ITH THE NEW %*" SPEC #-0 IS LIGHTYEARS AHEAD OF WHERE IT WAS IN %*" LPSOHPHQWDWLRQV
OR IN THE lRST TERRIBLE VERSION OF THE PRE
RELEASE %*" SPEC !ND 5HJDUGOHVVWKHUH¶VQRWKLQJRQ
NOW MOST DEVELOPERS USING ENTITY BEANS WILL USE #-0 )N FACT THE EXAM WKHH[DPDERXWWKHGLIIHUHQW
DOESNT COVER "-0 AT ALL SINCE ITS THERE MORE FOR LEGACY SUPPORT OR VERY YHUVLRQVRIWKHVSHF$VORQJDV
SPECIAL CASES MORE THAN ANYTHING ELSE \RXNQRZZKDW¶VLQWKHVSHF
\RX¶UHVDIH+RZHYHULQWKH
"ECAUSE OF THE HEAVY SHIFT TO #-0 FOR REASONS WELL EXPLORE WE UHDOZRUOG\RX¶UHOLNHO\WRFRPH
WONT COVER "-0 IN THIS BOOK 3O FROM THIS POINT FORWARD WERE GOING DFURVV(-%DSSOLFDWLRQV
TO ASSUME THAT WERE TALKING ABOUT #-0 4HE DIFFERENCES BETWEEN VREHSUHSDUHGWROHDUQWKH
THE LIFECYCLE AND THE DEVELOPERS RESPONSIBILITY FOR #-0 VS "-0 ARE GLIIHUHQFHV(VSHFLDOO\LI\RX¶UH
DRAMATIC SO DONT FORGET THAT EVERYTHING WE TALK ABOUT NOW WILL BE FROM WKHOXFN\RQHLQFKDUJHRI
PLJUDWLQJWKHDSSWRD
THE PERSPECTIVE OF A #-0 BEAN EVEN IF WE DONT EXPLICITLY SAY THAT WERE
FRPSOLDQWVHUYHU
REFERRING TO #-0
\RXDUHKHUH
HQWLW\EHDQV
+RZDEHDQDFWRUEHFRPHVDEHDQHQWLW\
6FHQDULR FOLHQWZDQWVWRJHWWKHDGGUHVVRID
VSHFL¿F&03&XVWRPHUHQWLW\SULPDU\NH\
:KHUHWKH
#LV
QXPEHU"7KHFOLHQWLVFDOOLQJ
DQG,GRQ·WVHHDQ\ERG\
SOD\LQJQXPEHU
JHW$GGUHVV FRQWH[W
(-%
VV REMHFW
GGUH VWXE EHDQ
$
JHW
FOLHQW
EHDQ
FRQWH[W
%HDQ3RRO
'%
&OLHQWFDOOVJHW$GGUHVV RQWKHVWXEIRUHQWLW\EHDQ7KHFOLHQWJRWWKHVWXEIURPD
SUHYLRXVFDOORQWKHKRPHVWXE \RX·OOVHHH[DFWO\KRZWKHFOLHQWJRWWKHVWXELQWKHILUVW
SODFHLQDPLQXWH
7KHFDOOLVSDVVHGWRWKH(-%REMHFW
7KH(-%REMHFWJHWVWKHFDOODQGSDQLFVEHFDXVHWKHUH,6QRHQWLW\EHDQIRU
7KH(-%REMHFWLVWKHDJHQWERG\JXDUGIRUEXWKHLVQ·WDWWDFKHGWRDVSHFLILF
EHDQWKDW·VSOD\LQJ
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
+RZDEHDQDFWRUEHFRPHVDEHDQHQWLW\
7KH&03EHDQFRPHVRXWRIWKHSRRODQGSUHSDUHVWRSOD\
,·OOMXVWZDLW
ZKLOHKHOHDUQVKRZ
WREH
,NQRZ,·PJRLQJ
WREHSOD\LQJ
EXWXPZKDW·VP\
FRQWH[W
PRWLYDWLRQ"
(-%
REMHFW
EHDQ
HME$FWLYDWH
%HDQ3RRO
G
/RD '%
HME
FW
VH H
O
7KH&RQWDLQHU¶DFWLYDWHV·DEHDQE\SXOOLQJLWRXWRIWKHSRRODQGFDOOLQJHME$FWLYDWH
7KH&RQWDLQHUGRHVDVHOHFWRQSULPDU\NH\LQWKHGDWDEDVHWRJHWWKHUHDO
HQWLW\GDWDWRSXWLQWRWKHEHDQ WKHGDWDWKDWZLOOEHFRPHWKHEHDQ·VVWDWH
7KH&RQWDLQHUORDGVWKHEHDQZLWKWKHHQWLW\GDWDIURPWKHGDWDEDVHDQGWKHQFDOOV
HME/RDG WRWHOOWKHEHDQ´+H\EHDQ\RX·YHMXVWEHHQORDGHGµ
\RXDUHKHUH
HQWLW\SDVVLYDWLRQDFWLYDWLRQ
2.WLPHRXW
'RHVWKDWSLFWXUHVD\WKDWHME3DVVLYDWH
LVWKHEHDQ·VFRQWDLQHUFDOOEDFNIRUJRLQJEDFNWR
WKHSRRO",VQ·WWKDWWKHRSSRVLWHRIKRZVHVVLRQ
EHDQVZRUN":LWKVHVVLRQEHDQVHME$FWLYDWH
KDVQRWKLQJWRGRZLWKWKHSRROVRZKDW·VWKH
GHDO"$UHWKH\MXVWWU\LQJWRPDNHLWDV
FRQIXVLQJDVSRVVLEOH"""
3DVVLYDWLRQDQG$FWLYDWLRQKDYHD
727$//<GLIIHUHQWPHDQLQJIRUHQWLW\
EHDQV
6WDWHOHVVVHVVLRQEHDQVJREDFNWRWKHSRRO
ZLWKRXWSDVVLYDWLRQ LQRWKHUZRUGVZLWKRXWJHWWLQJ
DQHME3DVVLYDWH FDOO
6WDWHIXOVHVVLRQEHDQVDUHSDVVLYDWHGZKHQ
WKH&RQWDLQHUSXWVWKHPWRVOHHS SRVVLEO\
VHULDOL]DWLRQ WRFRQVHUYHUHVRXUFHVEHWZHHQFOLHQW
PHWKRGLQYRFDWLRQV
(QWLW\EHDQVDUHQ¶WSDVVLYDWHGLQWKHZD\WKDW
VWDWHIXOVHVVLRQEHDQVDUHEXWHQWLW\EHDQV'2
JHWDQHME3DVVLYDWH FDOOZKHQWKH\¶UHDERXWWRJR
EDFNWRWKHSRRO DQGDQHME$FWLYDWH ZKHQWKH\
FRPHRXWRIWKHSRRO
7KHPRVWLPSRUWDQWSRLQWLVWKDWXQOLNHVHVVLRQ
EHDQVSDVVLYDWHGHQWLW\EHDQVDUHVWLOOOLYH
REMHFWVRQWKHKHDS
7KHUH¶VQRVXFKWKLQJDVDEHDQVOHHSLQJLQD
SRRO6WDWHOHVVEHDQVHQWLW\EHDQVDQGPHVVDJH
GULYHQEHDQVDOOXVHSRROV$QGWKRVHSRROVDUHIRU
OLYLQJ5$0XVLQJRQWKHKHDSREMHFWV
2QO\VWDWHIXOEHDQVDUHSXWWRVOHHS FDOOHG
FRQIXVLQJO\SDVVLYDWLRQ EXWWKLVKDVQRWKLQJWR
GRZLWKDSRRO
6R\HVWKH\¶YHRYHUORDGHGWKHZRUG³SDVVLYDWLRQ´
MXVWWRPDNHWKLQJVUHDOO\FRQIXVLQJIRU\RXDQGWR
KHOSGULYHWKHQHHGIRUPRUH(-%ERRNV )RUZKLFK
ZHWKDQNWKHPHYHU\VLQJOHGD\
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
HME3DVVLYDWH WKHGLIIHUHQFH
EHWZHHQVHVVLRQDQGHQWLW\EHDQV
(QWLW\EHDQ 6WDWHIXOVHVVLRQEHDQ 6WDWHOHVVVHVVLRQEHDQ
alive on
the hea
p
===
===
doesnÕt apply... st
beans are never paatsseless
ap... ivated
he he
al i ve on tized
(QWLW\%HDQ
NOT bly serial
3RRO
possi
4&DOOHGZKHQWKHEHDQKDV 4&DOOHGZKHQWKH&RQWDLQHU 4'RHVQ·WDSSO\6WDWHOHVVEHDQV
ILQLVKHGDEXVLQHVVPHWKRG RWKHU GHFLGHVWRFRQVHUYHUHVRXUFHV KDYHDSRROEXWDFWLYDWLRQDQG
WKDQUHPRYH DQGLVDERXW EHWZHHQEXVLQHVVPHWKRG SDVVLYDWLRQGRQ·WSOD\DQ\SDUW
WRJREDFNWRWKHSRRO,QWKH LQYRFDWLRQVIURPWKHFOLHQW LQLW5HPHPEHUVWDWHOHVV
SDVVLYDWHGVWDWHWKHEHDQKDVQR VHVVLRQEHDQVZLOO1(9(5JHWDQ
LGHQWLW\³LW·VQRWUHSUHVHQWLQJDQ\ 48VHLWWRUHOHDVHUHVRXUFHVDQG HME$FWLYDWH RUHME3DVVLYDWH FDOO
HQWLW\IURPWKHGDWDEDVH WRSUHSDUHWKHEHDQ·VVWDWHIRU
ZKDWPLJKWEHVHULDOL]DWLRQ QXOO
48VHLWWRUHOHDVHUHVRXUFHVWKDW RXWQRQ6HULDOL]DEOHUHIHUHQFHV
\RXGRQ·WZDQWWRZDVWHZKLOH HWF
WKHEHDQLVVLWWLQJLQWKHSRRO
QRWUXQQLQJDEXVLQHVVPHWKRG 47KHEHDQLV´SXWWRVOHHSµDQGLV
7\SLFDOO\WKHPHWKRGLVHPSW\ QRORQJHUWDNLQJXSVSDFHRQWKH
KHDS
47KHEHDQLV127SDVVLYDWHG
LQWKHVHVVLRQEHDQVHQVH,Q 47KH&RQWDLQHUFDOOVWKHEHDQ·V
RWKHUZRUGVWKHEHDQLVQRW HME$FWLYDWH PHWKRGZKHQD
VHULDOL]HGRUVDYHGVRWKHUHLV FOLHQWFDOOVDEXVLQHVVPHWKRG
12UHTXLUHPHQWWKDW\RXQXOORXW RQWKH(-%REMHFW7KHEHDQ
UHIHUHQFHVWRQRQ6HULDOL]DEOH UXQVHME$FWLYDWH EHIRUHLW
REMHFWV UXQVWKHEXVLQHVVPHWKRGWKDW
WULJJHUHGWKHDFWLYDWLRQ
47KH&RQWDLQHUFDOOVWKHEHDQ·V
HME$FWLYDWH PHWKRGZKHQD
EHDQLVQHHGHGWRVHUYLFHD
EXVLQHVVPHWKRGIURPDFOLHQW
7KHEHDQUXQVHME$FWLYDWH
EHIRUHLWUXQVWKHEXVLQHVV
PHWKRGWKDWWULJJHUHGWKH
DFWLYDWLRQ 7KLVPHWKRGLVXVXDOO\
HPSW\DVZHOO
\RXDUHKHUH
HQWLW\EHDQFDOOEDFNV
<PM-V\Q\a*MIVQV\MZNIKMILL[\PZMMVM_K WV\IQVMZ
KITTJIKS[QVKT]LQVO\ _WR][\NWZ[aVKPZWVQbI\QWV
LQWHUIDFH!! LQWHUIDFH!!
6HVVLRQ%HDQ (QWLW\%HDQ
VHW6HVVLRQ&RQWH[W 6HVVLRQ&RQWH[WVF VHW (QWLW\&RQWH[W (QWLW\&RQWH[WHF
HME3DVVLYDWH HME3DVVLYDWH
EntityCont
HME$FWLYDWH HME$FWLYDWH of SessionCoext instead
HME5HPRYH
ntext
HME5HPRYH
XQVHW(QWLW\&RQWH[W
New ! HME/RDG
HME6WRUH
4HE %NTITY"EAN INTERFACE ADDS THREE NEW METHODS AND THE CONTEXT SETTER
CHANGES TO GIVE THE BEAN AN %NTITY#ONTEXT INSTEAD OF A 3ESSION#ONTEXT
"UT AND THIS IS AN EXTREMELY LARGE hBUTv EVEN THE METHODS WHICH ARE THE
SAME IN BOTH INTERFACES DONT BEHAVE THE SAME
/F THE FOUR METHODS IN 3ESSION"EAN ONLY THE CONTEXT SETTER BEHAVES THE
SAME AS ITS COUNTERPART IN %NTITY"EAN 4HE OTHER THREE EJB0ASSIVATE
EJB!CTIVATE AND EJB2EMOVE HAVE DRASTICALLY DIFFERENT MEANINGS
9OULL SEE
&OR NOW JUST BE READY TO LET GO OF YOUR ATTACHMENTS TO THE MEANING OF
ACTIVATION PASSIVATION AND REMOVAL 7HAT THOSE MEAN TO AN ENTITY BEAN IS
NOTHING LIKE WHAT THEY MEAN TO A SESSION BEAN
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
-^MV\PMUM\PWL[\PI\IZM\PM[IUM
LWV¼\JMPI^M\PM[IUM
6HVVLRQ%HDQLQWHUIDFH (QWLW\%HDQLQWHUIDFH
VHW6HVVLRQ&RQWH[W 6HVVLRQ&RQWH[WVF VHW(QWLW\&RQWH[W (QWLW\&RQWH[WHF
&RQWDLQHUJLYHVWKHEHDQDUHIHUHQFHWRLWVFRQWH[W &RQWDLQHUJLYHVWKHEHDQDUHIHUHQFHWRLWVFRQWH[W
HME3DVVLYDWH HME3DVVLYDWH
&DOOHGRQDVWDWHIXOVHVVLRQEHDQZKHQWKHEHDQ &DOOHGZKHQWKHEHDQLVDERXWWRUHWXUQWRWKH
LVDERXWWREHVHULDOL]HG RUVRPHWKLQJOLNHLW SRROIROORZLQJDWUDQVDFWLRQ
HME$FWLYDWH HME$FWLYDWH
&DOOHGRQDVWDWHIXOVHVVLRQEHDQZKHQWKHEHDQ &DOOHGZKHQWKHEHDQLVWDNHQRXWRIWKHSRROWR
LVUHDFWLYDWHGIROORZLQJSDVVLYDWLRQ PLJKWEH VHUYLFHDFOLHQW·VEXVLQHVVPHWKRGFDOO
GHVHULDOL]DWLRQ
HME5HPRYH
HME5HPRYH &DOOHGZKHQWKHFOLHQWFDOOVUHPRYH DQGZDQWV
&DOOHGRQDVWDWHIXOEHDQZKHQWKHFOLHQWFDOOV WRGHOHWHWKLVHQWLW\IURPWKHGDWDEDVH
UHPRYH &DOOHGRQDVWDWHOHVVEHDQZKHQWKH
&RQWDLQHUZDQWVWRUHGXFHWKHVL]HRIWKHSRRO
nBean and
XQVHW(QWLW\&RQWH[W
o t h S e s s io
t h o d s t h at are in bter method behaves &DOOHGZKHQWKH&RQWDLQHUZDQWVWRUHGXFHWKH
ur me t set ivate, VL]HRIWKHSRRO
Of the feoan, only the contexbean, activate, passsession bean
EntityB way ! In an entity different from a HME/RDG
the same ve are completely
and remo &DOOHGZKHQWKHEHDQKDVEHHQUHIUHVKHGZLWK
GDWDIURPWKHXQGHUO\LQJSHUVLVWHQWVWRUH
E6WRUH
(QWLW\&RQWH[WDGGV
JHW3ULPDU\.H\
&DOOHGZKHQWKH&RQWDLQHULVDERXWWRXSGDWHWKH
GDWDEDVHWRUHIOHFWWKHVWDWHRIWKHEHDQ
RQWH[W
(QWLW\&RQWH[WH[WHQG(-%&
%RWK6HVVLRQ&RQWH[WDQG VVLR Q& RQW H[W
HPHWKRGWKDW6H
(QWLW\&RQWH[WKDVRQO\RQ LVWULFN\EHF DXV HWK HUH¶V
.H\ 7KLV
GRHVQ¶WKDYH²JHW3ULPDU\ RFD O2E MHFW
KH(-%2EMHFWDQG(-%/
DJHW3ULPDU\.H\ LQERWKW QDQGHQW LW\EHD Q
%27+VHVVLR
LQWHUIDFHVWKDW¶VH[SRVHGWR Q
XJK DVHVV LRQ EH DQFOLHQWZLOOJHWDQH[FHSWLR
FOLHQWV DOWKR U\. H\ LV
H[WYHUVLRQRIJHW3ULPD
IRUFDOOLQJLW %XWWKHFRQW
QV
H[SRVHGRQO\WRHQWLW\EHD
\RXDUHKHUH
HQWLW\EHDQFDOOEDFNV
*]\_IQ\\PMZM¼[UWZM -V\Q\aJMIV[PI^MVM_
PWUMKWV\IQVMZKITTJIKS[\WW
<RXUKRPHLQWHUIDFH (QWLW\%HDQLQWHUIDFH
MDYD[HME(QWLW\%HDQ
LQWHUIDFH!!
&XVWRPHU%HDQ
&XVWRPHU+RPH
FUHDWH 6WULQJODVW6WULQJILUVW6WULQJDGGU HME&UHDWH 6WULQJODVW6WULQJILUVW6WULQJDGGU
ILQG%\3ULPDU\.H\ 6WULQJNH\ HME3RVW&UHDWH 6WULQJODVW6WULQJILUVW6WULQJDGGU
ILQG%\&LW\ 6WULQJFLW\ HME)LQG%\3ULPDU\.H\ 6WULQJNH\
LQWHUIDFH!!
XSGDWH$OO 6WULQJFPG HME)LQG%\&LW\ 6WULQJFLW\ (QWLW\%HDQ
HME+RPH8SGDWH$OO 6WULQJFPG
VHW(QWLW\&RQWH[W (QWLW\&RQWH[WHF
ery create() in
You must match evt one but TWO HME$FWLYDWH
the home with noate(), like with VHW(QWLW\&RQWH[W (QWLW\&RQWH[WHF HME3DVVLYDWH
methods: ejbCre d a new thingÑ HME$FWLYDWH HME5HPRYH
session beans, an HME3DVVLYDWH XQVHW(QWLW\&RQWH[W
ejbPostCreate(). HME5HPRYH HME/RDG
ery home
You must match evwith an XQVHW(QWLW\&RQWH[W HME6WRUH
d
business metho ame>. HME/RDG
ejbHome<methodN HME6WRUH
ARE part you must always implement th
The Þnder methos,dsbut we wonÕt EXVLQHVVPHWKRGVIURPWKH
SEVEN container callback me ese
of the bean clasthem in our bean FRPSRQHQWLQWHUIDFH
in your bean class. EntityBeanthods
actually deÞne get there in a adds three new methods at
(long story, weÕll SessionBean interface didth
few minutes). nÕt have.
&OR ANY ENTITY BEAN USING CONTAINER MANAGED PERSISTENCE #-0 YOU WILL ALWAYS
HAVE AT LEAST SEVEN CONTAINER CALLBACKSALL FROM THE %NTITY"EAN INTERFACE
IMPLEMENTATION 9OU DONT HAVE TO HAVE A CREATE METHOD IN YOUR HOME
BUT IF YOU DO HAVE CREATE METHODS YOU MUST MATCH EACH CREATE WITH NOT
ONE BUT TWO METHODS EJB#REATE AND EJB0OST#REATE )F YOU HAVE HOME
BUSINESS METHODS YOU MUST WRITE A MATCHING EJB(OME METHOD.AME
METHOD IN THE BEAN CLASS
)F YOU USE BEAN MANAGED PERSISTENCE "-0 WHERE YOU WRITE YOUR OWN
DATABASE ACCESS CODE YOU ALSO MUST MATCH EACH l NDER METHOD WITH AN
EJB&IND WHATEVER METHOD 2EMEMBER THE ONLY METHOD REQUIRED IN A
HOME INTERFACE IS l ND"Y0RIMARY+EY "UT IN A #-0 BEAN YOU WONT PUT
ANY l NDERS IN YOUR BEAN CLASS EVEN THOUGH THEYRE IN YOUR HOME INTERFACE
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
?ZQ\QVOI+58MV\Q\aJMIV"
UISMQ\IJ[\ZIK\
<(6,ORYH&037KH&RQWDLQHU 2KVXUH\RXJHWWRJRKDYHIXQZKLOH
,
LPSOHPHQWVP\ÀQGHUVP\JHWWHUV GRDOOWKHUHDOZRUN+RZFRPHZLWKHDFKUHY
P\VHWWHUVP\VHOHFWPHWKRGVDQGLWZULWHV RIWKH(-%VSHF
,
HQGXSGRLQJPRUHZRUN
DOOWKHGDWDEDVHDFFHVVFRGHIRUWKHFUHDWH DQG\RXHQGXSGRLQJOHVV"7KDWEORZV:LOO\RX
UHPRYHORDGDQGVWRUHPHWKRGVMXVWWKLQN DWOHDVWWDNHVRPHSLFWXUHVRIWKHÁDVKPREQH[W
KRZPDQ\ÁDVKPREV,FDQDWWHQGQRZ ZHHNDW%DUQHVDQG1REOH"$WH[DFWO\ 30HYHU\RQH
WKDW,GRQ·WKDYHWRZULWHDOOWKLVEHDQ VKRZVXS$W HYHU\RQHUXQVLQDQGVWDUWVEUHDWKLQJ
FRGH KDUGDQGFURXFKLQJEHKLQGERRNVKHOYHVOLNHWKH\·UH
EHLQJFKDVHGE\EDGJX\V$W WKH\DOOUXQWRWKH
FRPSXWHUVHFWLRQJUDEWKHQHDUHVW+HDG)LUVWERRN
DQGVKRXW´,JRWLWµWKHQWKH\GLVSHUVH%\
HYHU\RQHLVJRQH
-AKE YOUR #-0 ENTITY BEAN CLASS ABSTRACT
9OU STILL HAVE TO IMPLEMENT THE CONTAINER CALLBACKS FROM JAVAXEJB%NTITY"EAN
AND IF YOU STILL HAVE TO WRITE ALL YOUR BUSINESS METHODS INCLUDING THOSE FROM
THE HOME AND IF YOU HAVE ANY CREATE METHODS YOU HAVE TO MATCH THOSE IN THE
BEAN CLASS AS WELL "UT THAT STILL LEAVES A PILE OF WORK FOR THE #ONTAINER TO DO
INCLUDING THE ACCESSOR METHODS FOR YOUR PERSISTENT lELDS &OR EXAMPLE IF YOUR
#USTOMER TABLE HAS A COLUMN FOR ADDRESS AND YOU MAP THAT TO A lELD IN YOUR
BEAN CLASS SO THAT CLIENTS CAN FOR INSTANCE CALL GET!DDRESS YOU DONT WRITE
THE GETTERS AND SETTERS FOR THAT lELD )N FACT YOU DONT EVEN DECLARE THE lELD 7ITH
#-0 YOU CREATE A VIRTUAL lELD BY DElNING GETTERS AND SETTERS )N OTHER WORDS
THE PERSISTENT lELD FOR ADDRESS EXISTS IN YOUR BEAN SIMPLY BECAUSE THERES AN ABSTRACT
GETTER AND SETTER FOR IT 7ELL THATS NOT ENTIRELY TRUE 4HERE ALSO HAS TO BE AN ENTRY
IN THE DEPLOYMENT DESCRIPTOR BUT WELL LOOK AT THAT IN THE NEXT CHAPTER
\RXDUHKHUH
HQWLW\EHDQFODVV
AW]X]\\PZMMSQVL[WN\PQVO[QVaW]ZJMIVKTI[["
7KLQJVIURPWKHKRPHLQWHUIDFH
)RUHDFKFUHDWH PHWKRGLQWKHKRPH\RXPXVWKDYH LQWHUIDFH!!
DPDWFKLQJHME&UHDWH DQGHME3RVW&UHDWH PHWKRG &XVWRPHU+RPH
LQWKHEHDQFODVV
FUHDWH 6WULQJODVW6WULQJILUVW6WULQJDGGUHVV
)RUHDFKEXVLQHVVPHWKRGLQWKHKRPH\RXPXVW ILQG%\3ULPDU\.H\ 6WULQJNH\
KDYHDPDWFKLQJHME+RPH PHWKRG!LQWKHEHDQ ILQG%\&LW\ 6WULQJFLW\
FODVV XSGDWH$OO 6WULQJFPG
)RU&03EHDQV\RXZLOO127ZULWHPDWFKLQJILQGHU
PHWKRGV7KH&RQWDLQHUZLOOZULWHWKHPIRU\RXEDVHG
RQLQIR\RXSXWLQWKHGHSOR\PHQWGHVFULSWRU :H·OOJR
RYHUDOOWKDWLQWKHQH[WFKDSWHU
7KLQJVIURPWKHFRPSRQHQWLQWHUIDFH
LQWHUIDFH!!
)RUHDFKPHWKRGLQWKHFRPSRQHQWLQWHUIDFH\RX &XVWRPHU
PXVWKDYHDPDWFKLQJFRQFUHWHLPSOHPHQWDWLRQLQWKH JHW)LUVW1DPH
EHDQFODVV
VHW)LUVW1DPH 6WULQJQDPH
JHW/DVW1DPH
VHW/DVW1DPH 6WULQJQDPH
JHW$GGUHVV
VHW$GGUHVV 6WULQJDGGU
7KLQJVIURPWKH(QWLW\%HDQLQWHUIDFH LQWHUIDFH!!
(QWLW\%HDQ
<RXPXVWLPSOHPHQWWKH(QWLW\%HDQLQWHUIDFHHLWKHU
GLUHFWO\RULQGLUHFWO\6RXQOHVV\RXKDYHDVXSHUFODVV VHW(QWLW\&RQWH[W (QWLW\&RQWH[WHF
WKDWLPSOHPHQWHGWKHPHWKRGV\RX·UHUHVSRQVLEOHIRU HME$FWLYDWH
ZULWLQJFRQFUHWHLPSOHPHQWDWLRQVLQ\RXUEHDQFODVV HME3DVVLYDWH
HME5HPRYH
XQVHW(QWLW\&RQWH[W
HME/RDG
HME6WRUH
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
84=;WS\PI\¼[NW]Z\PQVO[
9LUWXDOSHUVLVWHQW¿HOGV
)RUHDFKSHUVLVWHQWILHOGSURYLGHDQDEVWUDFWJHWWHUDQGVHWWHU
:KDWLVD¶YLUWXDO
SHUVLVWHQWÀHOG·",I\RX
PHDQDQLQVWDQFHYDULDEOH
WKHQZK\DUH\RXFDOOLQJ
LW¶YLUWXDO·"
¶9LUWXDOSHUVLVWHQWÀHOGV·DUHIRUWKH
YDOXHVWKDWPDSWRFROXPQVLQWKH
GDWDEDVH7KH\UHSUHVHQWWKHHQWLW\·V
SHUVLVWHQWVWDWH,Q\RXUEHDQFODVV
FRGHWKH\H[LVWRQO\DVDEVWUDFW
JHWWHUVDQGVHWWHUV
This bean has FOUR
persistent Þelds, fo )LUVW -RKQ
Last, PK (primary ker First, /DVW 0D\HU
and Address y), 3.
$GGUHVV 'HUODQG6W
)LUVW /DVW 3. $GGUHVV
-RKQ 0D\HU 'HUODQG6W
)UDQ +HDO\ %DU6W
%HOD )OHFN 3LFN/DQH
\RXDUHKHUH
YLUWXDO¿HOGV
>QZ\]ITNQMTL[IZM67<QV[\IVKM^IZQIJTM[
SXEOLFDEVWUDFWFODVV&XVWRPHU%HDQ&03LPSOHPHQWV(QWLW\%HDQ^
note: the only inst
SULYDWH(QWLW\&RQWH[WFRQWH[W ance variable is for
the EntityContext!
SXEOLF6WULQJHME&UHDWH 6WULQJODVW6WULQJ¿UVW6WULQJDGGU ^
WKLVVHW/DVW ODVW
WKLVVHW)LUVW ¿UVW
WKLVVHW3. PDNH3.
WKLVVHW$GGUHVV DGGU
UHWXUQQXOO
` .
ual persistent Þelds
These are the virt than abstract
ore
TheyÕre nothing m that map to the
SXEOLFDEVWUDFW6WULQJJHW/DVW
SXEOLFDEVWUDFWYRLGVHW/DVW 6WULQJODVW er s
getters and sett
SXEOLFDEVWUDFW6WULQJJHW)LUVW base, representing
SXEOLFDEVWUDFWYRLGVHW)LUVW 6WULQJ¿UVW columns in the data t state. The
en
SXEOLFDEVWUDFW6WULQJJHW&XVW$GGUHVV the entityÕs persist with the entity !
ved
SXEOLFDEVWUDFWYRLGVHW&XVW$GGUHVV 6WULQJDGGU things that get sa
SXEOLFDEVWUDFW6WULQJJHW3.
SXEOLFDEVWUDFWYRLGVHW3. 6WULQJSN
SXEOLF6WULQJJHW/DVW1DPH ^
UHWXUQWKLVJHW/DVW
These are methods fr
` om
SXEOLFYRLGVHW/DVW1DPH 6WULQJQDPH ^ interface, that are ex the component
posed to the client.
WKLVVHW/DVW QDPH
We know what youÕre
` thinking... why do you
a SECOND set of ge ha
SXEOLF6WULQJJHW)LUVW1DPH ^ tters and setters, wh ve
UHWXUQWKLVJHW)LUVW you can just expose th en
e abstract ones in your
` component interface?
SXEOLFYRLGVHW)LUVW1DPH 6WULQJQDPH ^
WKLVVHW)LUVW QDPH Well, you COULD expo
se
` good idea. Think abou them, but itÕs not a
SXEOLF6WULQJJHW$GGUHVV ^
t it....
UHWXUQWKLVJHW&XVW$GGUHVV hereÕs a hint: imagine
that
` versions had more code the non-abstract
than what you see here
SXEOLFYRLGVHW$GGUHVV 6WULQJDGGU ^
bigger hint: imagine th .
WKLVVHW&XVW$GGUHVV DGGU at
` methods had VALIDAT the non-abstract
ION code...
PRUHPHWKRGVIURP(QWLW\%HDQ ridiculously big hint: th
ink about encapsulation
DQGWKHKRPHLQWHUIDFH .
`
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
6KDUSHQ \RXU SHQFLO
8VLQJWKHLQWHUIDFHVEHORZZULWHDOHJDOEHDQFODVV<RXGRQ·WKDYH
WRZULWHWKHDFWXDOEXVLQHVVORJLFEXWDWOHDVWOLVWDOOWKHPHWKRGV
WKDW\RXKDYHWRZULWHLQWKHFODVVZLWKWKHLUFRUUHFWGHFODUDWLRQV
LQWHUIDFH!! LQWHUIDFH!! LQWHUIDFH!!
3URGXFW+RPH 3URGXFW (QWLW\%HDQ
FUHDWH 6WULQJGHVFULSWLRQ6WULQJFDWGRXEOHSULFH6WULQJ,' JHW&DWHJRU\ VHW(QWLW\&RQWH[W (QWLW\&RQWH[WHF
ILQG%\3ULPDU\.H\ 6WULQJNH\ JHW,' HME$FWLYDWH
ILQG%\&DWHJRU\ 6WULQJFDWHJRU\ JHW'HVFULSWLRQ HME3DVVLYDWH
JHW/RZ6WRFN,WHPV VHW'HVFULSWLRQ HME5HPRYH
JHW3ULFH XQVHW(QWLW\&RQWH[W
VHW3ULFH HME/RDG
:ULWHWKHFODVVKHUHLQWKHVSDFHEHORZ GRQ·W HME6WRUH
ZRUU\DERXWLPSRUWVWDWHPHQWV
\RXDUHKHUH
&XVWRPHU%HDQ&03FRGH
+WUXTM\MKWLMNWZ\PM+][\WUMZ*MIV+58KTI[[
QRWH LW·VQRWDQQRWDWHGEHFDXVHWKDW·V<285MRELQWKH6KDUSHQH[HUFLVHRQWKHQH[WSDJH
SDFNDJHKHDG¿UVW
LPSRUWMDYD[HME
SXEOLFDEVWUDFWFODVV&XVWRPHU%HDQ&03LPSOHPHQWV(QWLW\%HDQ^
SULYDWH(QWLW\&RQWH[WFRQWH[W
SXEOLF6WULQJHME&UHDWH 6WULQJODVW6WULQJ¿UVW6WULQJDGGU ^
WKLVVHW/DVW ODVW
WKLVVHW)LUVW ¿UVW
WKLVVHW3. PDNH3.
WKLVVHW$GGUHVV DGGU
UHWXUQQXOO
`
SXEOLF6WULQJJHW/DVW1DPH ^
UHWXUQWKLVJHW/DVW
`
SXEOLFYRLGVHW/DVW1DPH 6WULQJQDPH ^
WKLVVHW/DVW QDPH
`
SXEOLF6WULQJJHW)LUVW1DPH ^
UHWXUQWKLVJHW)LUVW
`
SXEOLFYRLGVHW)LUVW1DPH 6WULQJQDPH ^
WKLVVHW)LUVW QDPH
`
SXEOLF6WULQJJHW$GGUHVV ^
UHWXUQWKLVJHW&XVW$GGUHVV
`
SXEOLFYRLGVHW$GGUHVV 6WULQJDGGU ^
WKLVVHW&XVW$GGUHVV DGGU
`
SXEOLFYRLGVHW(QWLW\&RQWH[W (QWLW\&RQWH[WFW[ ^
FRQWH[W FW[
`
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
SXEOLFDEVWUDFW6WULQJJHW/DVW
SXEOLFDEVWUDFWYRLGVHW/DVW 6WULQJODVW
SXEOLFDEVWUDFW6WULQJJHW)LUVW
SXEOLFDEVWUDFWYRLGVHW)LUVW 6WULQJ¿UVW
SXEOLFDEVWUDFW6WULQJJHW&XVW$GGUHVV
SXEOLFDEVWUDFWYRLGVHW&XVW$GGUHVV 6WULQJDGGU
SXEOLFDEVWUDFW6WULQJJHW3.
SXEOLFDEVWUDFWYRLGVHW3. 6WULQJSN
SXEOLFYRLGXQVHW(QWLW\&RQWH[W ^`
imary
ldÕs stupidesthpr
SXEOLFYRLGHME/RDG ^`
SXEOLFYRLGHME6WRUH ^` h is is t h e w or at always
SXEOLFYRLGHME$FWLYDWH ^` remember: t r. (Well, we suppose one t etty lame,
SXEOLFYRLGHME3DVVLYDWH ^` key generatoe same number would be prprimary keys
SXEOLFYRLGHME5HPRYH ^` returned th ldnÕt work anyway, since JVM will
but that wouique or... guess what... the But as we
SULYDWH6WULQJPDNH3. ^ MUST be unce DuplicateKeyException. ther use a
LQWUDQG LQW 0DWKUDQGRP
give you a ni in the Real World, youÕd ei, or a REAL
UHWXUQ³´UDQG
were saying, d arg as the primary key sort, or
`
client-suppliegeneration engine of some abase auto-
primary key ainer to give you the dat s that.)
`
ask the Cont y (if your vendor support
generated ke
6KDUSHQ \RXU SHQFLO
0DUNHDFKPHWKRGLQWKH&XVWRPHU%HDQ&03FODVVZLWKRQHRIWKHIROORZLQJIRXU
V\PEROV
H C EB VF
EDVHGRQWKHUHDVRQIRUWKDWPHWKRG·VH[LVWHQFHLQWKHFODVV)RUH[DPSOHWKH
HME&UHDWH PHWKRGLVUHTXLUHGEHFDXVHWKHUH·VDPDWFKLQJFUHDWH LQWKHKRPH
VRPDUNDQHQH[WWRWKHHME&UHDWH PHWKRG
3XWDFKHFNPDUNQH[WWRWKRVHPHWKRGVWKDWWKHFRPSLOHUFDUHVDERXW,QRWKHU
ZRUGVLI\RXOHIWDPHWKRGRXWDQGWKHFRPSLOHUZRXOGFRPSODLQZLWKDQHUURUWKHQ
PDUNWKDWPHWKRGZLWKD
$QQRWDWHWKHFRGH\RXUVHOIZLWKDQ\RWKHUGHWDLOV\RXFDQWKLQNRI)RUWKLVH[HUFLVH
EXWQRWWKHSUHYLRXVWZR GRDVPXFKDV\RXFDQRQ\RXURZQWKHQWXUQEDFNWR
HDUOLHUSDJHVLQWKLVFKDSWHUDQGVHHLI\RXFDQDGGRUFKDQJHDQ\WKLQJ
\RXDUHKHUH
HQWLW\EHDQOLIHF\FOH
(QWLW\EHDQLQVWDQFHOLIHF\FOH
LQVWDQFHWKURZVV\VWHPH[FHSWLRQ
GRHVQRWH[LVW
XQFKHFNHGXQFDXJKW
FRQVWUXFWRU
XQVHW(QWLW\&RQWH[W
VHW(QWLW\&RQWH[W
SRROHG HME)LQG PHWKRG!
HME+RPH PHWKRG!
KRPHEXVLQHVVPHWKRGV HME6HOHFW PHWKRG! FRYHUHG
LQWKHQH[WFKDSWHU
HME$FWLYDWH
HME3DVVLYDWH
HME&UHDWH PHWKRG! HME5HPRYH
HME3RVW&UHDWH PHWKRG!
HME6WRUH PHWKRGUHDG\ HME/RDG
EXVLQHVVPHWKRG HME6HOHFW PHWKRG!
FRPSRQHQWLQWHUIDFH FDOOHGIURPDEXVLQHVVPHWKRG
/HW·VVHHKHUHE\P\
FDOFXODWLRQVLWVKRXOGWDNHPH
DSSUR[LPDWHO\\HDUVWRPHPRUL]H
WKLVOLIHF\FOHGLDJUDPVRWKDWZRXOG
PHDQ,FDQVFKHGXOHWKHH[DPIRU
VRPHWLPHLQWKH\HDU
when you see th e whole
It lo oks ba d on ly d of
elax...by the en
thing at once. asRsuming youÕve regained
this chapter, youÕll have it 90% down, and
consciousness, chapter 7, youÕll have it all.
by the end of
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
(QWLW\EHDQLQVWDQFHWUDQVLWLRQV
orize this all LQVWDQFHWKURZVV\VWHPH[FHSWLRQ
DonÕt try to eÕmllemspend most of GRHVQRWH[LVW XQFKHFNHGXQFDXJKW
right now ! W is chapter looking
the rest of th FRQVWUXFWRU
at this stuff. VHW(QWLW\&RQWH[W
XQVHW(QWLW\&RQWH[W
0RYLQJIURPGRHVQRWH[LVW SRROHG HME)LQG PHWKRG!
HME+RPH PHWKRG! HME6HOHFW PHWKRG!
WRSRROHG KRPHEXVLQHVVPHWKRGV
HME$FWLYDWH
HME3DVVLYDWH
FRQVWUXFWRU
HME&UHDWH PHWKRG! HME5HPRYH
VHW(QWLW\&RQWH[W HME3RVW&UHDWH PHWKRG!
QRWH QRFUHDWH
HME6WRUH PHWKRGUHDG\ HME/RDG
EXVLQHVVPHWKRG HME6HOHFW PHWKRG!
FRPSRQHQWLQWHUIDFH FDOOHGIURPDEXVLQHVVPHWKRG
0RYLQJIURPSRROHGWR
LQVWDQFHWKURZVV\VWHPH[FHSWLRQ
PHWKRGUHDG\
GRHVQRWH[LVW XQFKHFNHGXQFDXJKW
HME&UHDWH HME3RVW&UHDWH
FRQVWUXFWRU
XQVHW(QWLW\&RQWH[W
25 VHW(QWLW\&RQWH[W
HME$FWLYDWH
SRROHG HME)LQG PHWKRG!
7KH&RQWDLQHUGRHV127FDOO HME+RPH PHWKRG! HME6HOHFW PHWKRG!
HME$FWLYDWH LILWFDOOVHME&UHDWH KRPHEXVLQHVVPHWKRGV
HME$FWLYDWH
HME3DVVLYDWH
HME&UHDWH PHWKRG! HME5HPRYH
0RYLQJIURPPHWKRGUHDG\ HME3RVW&UHDWH PHWKRG!
WRSRROHG
HME3DVVLYDWH PHWKRGUHDG\
HME6WRUH HME/RDG
25
HME5HPRYH
EXVLQHVVPHWKRG HME6HOHFW PHWKRG!
1HYHUERWK$EHDQGRLQJDQ FRPSRQHQWLQWHUIDFH FDOOHGIURPDEXVLQHVVPHWKRG
HME5HPRYH ZLOO127EHSDVVLYDWHG
EHIRUHJRLQJEDFNWRWKHSRRO
\RXDUHKHUH
HQWLW\VWDWHWUDQVLWLRQV
(QWLW\EHDQLQVWDQFHWUDQVLWLRQV
LQVWDQFHWKURZVV\VWHPH[FHSWLRQ
GRHVQRWH[LVW XQFKHFNHGXQFDXJKW
FRQVWUXFWRU
XQVHW(QWLW\&RQWH[W
VHW(QWLW\&RQWH[W
0RYLQJWRGRHVQRWH[LVW
SRROHG HME)LQG PHWKRG!
HME+RPH PHWKRG! HME6HOHFW PHWKRG!
XQVHW(QWLW\&RQWH[W KRPHEXVLQHVVPHWKRGV
HME$FWLYDWH
HME3DVVLYDWH
25
HME&UHDWH PHWKRG! HME5HPRYH
LQVWDQFHWKURZVDV\VWHPH[FHSWLRQ HME3RVW&UHDWH PHWKRG!
HME6WRUH PHWKRGUHDG\ HME/RDG
EXVLQHVVPHWKRG HME6HOHFW PHWKRG!
FRPSRQHQWLQWHUIDFH FDOOHGIURPDEXVLQHVVPHWKRG
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: (OW COME THERE IS A LABEL FOR PLACES IS BECAUSE IT DEPENDS ON WHICH INTERFACE THE
EJB3ELECT METHOD WHATEVER 4(!4 IS IN BOTH THE CLIENT USES TO CALL THE METHOD THAT IN TURN CALLS A SELECT
POOLED STATE AND THE METHOD
READY STATE (OW CAN METHOD 3O IF A CLIENT CALLS A HOME BUSINESS METHOD
YOU RUN THOSE METHODS IN BOTH AND THE HOME METHOD CALLS AN EJB3ELECT METHOD
THE BEAN STAYS IN THE POOL TO RUN THE METHOD "UT
A: 7ELL GET TO EJB3ELECT METHODS A BIT LATER BUT
IF THE SELECT METHOD IS CALLED FROM A METHOD IN THE
BEANS COMPONENT INTERFACE THAT MEANS THE METHOD
FOR NOW THINK OF THEM AS PRIVATE METHODS IN THE BEAN IS RUNNING ON A SPECIFIC ENTITY SAY &RANK &OOF SO
IN OTHER WORDS CALLED NOT BY THE CLIENT BUT ONLY THE BEAN IS IN THE METHOD
READY STATE
BY THE BEANS OWN METHODS THAT DO SELECTS ON THE
DATABASE 4HEYRE USED ONLY FOR #-0 BEANS AND CAN
BE A HUGE CONVENIENCE SINCE THEYRE IMPLEMENTED FOR
YOU BY THE #ONTAINER 4HE REASON THEYRE IN BOTH
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: )T LOOKS LIKE THERE ARE 47/ WAYS TO MOVE
TO THE METHOD
READY STATE EITHER THE CLIENT
CALLS A CREATE METHOD OR THE #ONTAINER CALLS 6KDUSHQ \RXU SHQFLO
EJB!CTIVATE 3O DOES THIS MEAN THAT YOU CANT
COUNT ON EJB!CTIVATE BEING CALLED EACH TIME YOU
LEAVE THE POOL
)RUWKHH[DP\RXKDYHWRNQRZH[DFWO\
ZKLFKFRQWDLQHUFDOOEDFNPHWKRGVDUHLQWKH
A: 4HATS RIGHT ! BEAN CAN MOVE TO THE METHOD
(QWLW\%HDQLQWHUIDFHVR\RXQHHGWRPHPRUL]H
WKHVH7KHWULFN\SDUWLVWKDWVRPHRIWKHP
READY STATE BY /.,9 THOSE TWO PATHS CREATION OR
ACTIVATION BUT NEVER BOTH AT THE SAME TIME 3O IF YOU KDYHWKHVDPHQDPHVEXWFRPSOHWHO\GLIIHUHQW
HAVE A DESIGN THAT ACQUIRES RESOURCES IN EJB!CTIVATE EHKDYLRUWKDQWKHLUVHVVLRQEHDQFRXQWHUSDUWVLQ
SO THAT THEYLL ALWAYS BE AVAILABLE WHILE THE BEAN IS WKH6HVVLRQ%HDQLQWHUIDFH'2127/22.21
SERVICING A BUSINESS METHOD YOU BETTER GRAB THEM 7+(23326,7(3$*(
IN EJB#REATE OR EJB0OST#REATE YOULL SEE THE
DIFFERENCE IN A FEW MINUTES 7KHFOLHQWFDOOVWKLVPHWKRGWRWHOOWKH
)N THE REAL WORLD ITS MUCH LESS COMMON IN %*" &RQWDLQHUWKDWKH WKHFOLHQW LVGRQHXVLQJWKH
TO USE EJB!CTIVATE FOR MUCH OF ANYTHING 7ELL TALK EHDQ·V(-%REMHFWUHIHUHQFH
MORE ABOUT THIS BOTH IN THIS CHAPTER AND THE LAST
BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
CHAPTER PATTERNS AND PERFORMANCE BUT THE SHORT
VERSION IS THIS ITS USUALLY MORE EFFICIENT TO ACQUIRE
AND RELEASE SCARCE RESOURCES JUST WITHIN THE BUSINESS
METHODS THAT NEED THEM 4HAT WAY YOURE NOT 7KLVPHWKRGLVFDOOHGZKHQWKHEHDQJRHV
HANGING ON TO THEM PREVENTING OTHER BEANS FROM EDFNWRWKHSRRODIWHUDQHQWLW\LVGHOHWHGIURP
HAVING ACCESS WHILE YOUR BEAN IS ACTIVE IE NOT IN WKHGDWDEDVH
THE POOL BUT NOT ACTIVELY RUNNING A METHOD 9ES THAT
MEANS YOU HAVE SOME ADDITIONAL OVERHEAD IN EACH BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
BUSINESS METHOD AS OPPOSED TO GRABBING THE THING
ONCE IN EJB!CTIVATE BUT IN MANY CASES THE OVERHEAD
OF GRABBING THE RESOURCE IS MINOR COMPARED TO THE 7KLVPHWKRGLVFDOOHGLPPHGLDWHO\DIWHUWKH
SCALABILITY COST OF HOLDING RESOURCES WERE THINKING EHDQ·VFRQVWUXFWRUUXQV
DATABASE CONNECTIONS FROM THE POOL OPEN LONGER
THAN YOU NEED TO ACCESS THOSE RESOURCES BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
"OTTOM LINE 9OULL PROBABLY FIND YOURSELF LEAVING
EJB!CTIVATE EMPTY IN SO YOU WONT HAVE TO WORRY
ABOUT MISSING IT WHEN YOU COME OUT OF THE POOL VIA 7KLVPHWKRGLVFDOOHGRQWKHEHDQZKHQWKH
AN EJB#REATE CALL EHDQLVLQWKHSRRODQGWKHFOLHQWLQYRNHVD
EXVLQHVVPHWKRGRQWKHFRPSRQHQWLQWHUIDFH
:H·UHORRNLQJIRUWKHILUVWPHWKRGFDOOHGLQWKDW
VFHQDULR
BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
\RXDUHKHUH
HQWLW\OLIHF\FOHDFWLYLW\
6KDUSHQ \RXU SHQFLO
)LOOLQWKHPLVVLQJPHWKRGV'RQ·WZRUU\LI\RXGRQ·WJHWWKH
QDPHH[DFWO\ULJKW MXVWWU\WRZRUNRXWZKDWKDSSHQVDW
WKHWUDQVLWLRQVLQWKHHQWLW\EHDQVWDWHGLDJUDP
LQVWDQFHWKURZVV\VWHPH[FHSWLRQ
GRHVQRWH[LVW XQFKHFNHGXQFDXJKW
FRQVWUXFWRU
SRROHG
HME+RPH PHWKRG! HME6HOHFW PHWKRG! FRYHUHGLQWKHQH[WFKDSWHU
KRPHEXVLQHVVPHWKRGV
HME$FWLYDWH
HME3DVVLYDWH
HME&UHDWH PHWKRG!
HME6WRUH PHWKRGUHDG\
HME6HOHFW PHWKRG!
FRPSRQHQWLQWHUIDFH FDOOHGIURPDEXVLQHVVPHWKRG
<RXKDYHWRNQRZHYH
U\GHWDLORIWKLVOLIHF\
FOH
VDLG
IH7KHWULFNLHVWSDUWVDVZH
DP H[ SHF WV\ RX WRN QRZ HYHU\GHWDLORIDEHDQ¶VOL VEXWH QWLUHO\ GLIIHUHQW
7KHH[ WKHVDPHQDPH
OLHUDUHZ KHUHWK HP HWK RGVLQDQHQWLW\EHDQKDYH LWK
HDU SHFLDOFDUHZ
HVVLRQEHDQ7DNHH[WUDV
PHDQLQJVIURPWKRVHLQDV HZ HQWLW\LQWKH GDWDEDVH
YVPDNHDQ
FUHDWH PDNHDQHZEHDQ WLW\LQWKHGDWDEDVH
RX¶UHGRQHYVGHOHWHDQHQ
UHPRYH WHOOWKH&RQWDLQHU\ N ZKROH WRWKHSRRO
L]H WKH VWDWHIX OEHDQYVVHQGWKHEH EDFDQ
HWKRG
SDVVLYDWH VHULDO HSRROWRUXQDEXVLQHVVP
GHV HULD OL]H WKH VWDWHIX OEHDQYVEULQJLWRXWRIWK RURXW RIWKH SRRO
DFWLYD WH LRQEHDQJRH VLQ
DOOHGZKHQDVWDWHOHVVVHVV
UHPHPEHU12PHWKRGLVF
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
;WPW_,1,\PMKTQMV\OM\IZMNMZMVKM\W\PM
-2*WJRMK\NWZ '
7HEN A CLIENT WANTS TO CALL A BUSINESS METHOD ON A SPECIl C ENTITY IN OTHER
WORDS AN ENTITY WITH A UNIQUE PRIMARY KEY LIKE ,EE ,OO THE CLIENT l RST
NEEDS A REFERENCE TO THAT ENTITYS %*" OBJECT
&OR AN ENTITY BEAN REMEMBER THERE ARE THREE WAYS THAT CAN HAPPEN
&OLHQWFDOOVD¿QGHURQWKHKRPH
FXVWRPHU+RPH¿QG%\3ULPDU\.H\ ³´
&OLHQWFDOOVFUHDWHRQWKHKRPH WRLQVHUWIRUWKH¿UVWWLPH
FXVWRPHU+RPHFUHDWH ³/RR´³/HH´³´³%DU&LUFOH´
&OLHQWFDOOVDKRPHEXVLQHVVPHWKRGWKDWUHWXUQVD
UHIHUHQFHWRWKHEHDQ¶VFRPSRQHQWLQWHUIDFH
FXVWRPHU+RPHJHW&XVWRPHU%\6WUHHW ³%DU&LUFOH´
7ELL TALK ABOUT EACH STAGE OF THE BEANS LIFECYCLE FOR l NDERS CREATES AND
HOME BUSINESS METHODS "UT l RSTEACH OF THESE ASSUMES THAT THE BEAN
INSTANCE ALREADY EXISTS IN THE POOL "UT HOW DOES THE BEAN GET THERE IN THE
l RST PLACE
Before the client can use a bean for
GRHVQRWH[LVW
ANYTHING -- creation, Þnders, business
methods, etc., the Container has to make
FRQVWUXFWRU a new bean instance for the pool. Bean
VHW(QWLW\&RQWH[W
CONSTRUCTION isnÕt tied to entity bean
CREATION.
SRROHG
Construction means a new bean instance.
But creation, for an entity bean, means a
new entity is inserted into the database.
\RXDUHKHUH
&03EHDQFRQVWUXFWLRQ
&03(QWLW\EHDQFRQVWUXFWLRQ
6FHQDULR &RQWDLQHUZDQWVWRPDNHDQHZEHDQLQVWDQFHIRUWKHSRRO
FRQWH[W
FRQWH[W
&RQWDLQHUPDNHVDQHZ(QWLW\&RQWH[W
QHZ EHDQ
&RQWDLQHUPDNHVDQHZLQVWDQFHRIWKH EHDQ
EHDQFODVV EHDQ·VFRQVWUXFWRUUXQV QHZ REMHFW
%HDQ3RRO
FRQWH[W
&RQWDLQHUFDOOVVHW(QWLW\&RQWH[W RQWKH
EHDQ7KLVLVWKH21/<WLPHLQDEHDQ W
LQVWDQFH·VOLIHWKDWLWZLOOJHWWKLVFDOO W\&RQWH[ EHDQ
VHW(QWL EHDQ
&RQWDLQHUSXWVWKHEHDQ ZKLFKQRZKDVD FRQWH[W
FRQWH[W LQWKHSRRO EHDQ
1RWLFH FUHDWH ZDVQHYHUFDOOHG$FUHDWH FRQWH[W
PHWKRGLVRQO\IRULQVHUWLQJDQHZHQWLW\LQWR
WKHGDWDEDVHDQGKDVQRWKLQJWRGRZLWKWKH %HDQ3RRO
EHDQLQVWDQFH·VFUHDWLRQ %HDQ3RRO
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
*MIV\PQVO[aW]KIVLWL]ZQVOMV\Q\aK WV[\Z]K\QWV"
WLPHOLQH
FRQVWUXFWRU VHW(QWLW\&RQWH[W
8VH\RXU(QWLW\&RQWH[WWR 8VH\RXU(QWLW\&RQWH[WWR
JHWDUHIHUHQFHWR\RXUKRPH JHWDUHIHUHQFHWR\RXUKRPH
JHWDUHIHUHQFHWR\RXU(-%REMHFW JHWDUHIHUHQFHWR\RXU(-%REMHFW
JHWVHFXULW\LQIRUPDWLRQDERXWWKHFOLHQW JHWVHFXULW\LQIRUPDWLRQDERXWWKHFOLHQW
IRUFHDWUDQVDFWLRQWRUROOEDFN &07
G IRUFHDWUDQVDFWLRQWRUROOEDFN &07
THIN
EHDQV o ANY EHDQV
You canÕt d
ILQGRXWLIWKHWUDQVDFWLRQKDVDOUHDG\ ILQGRXWLIWKHWUDQVDFWLRQKDVDOUHDG\
EHHQVHWWRUROOEDFN &07EHDQV EHHQVHWWRUROOEDFN &07EHDQV
JHWDWUDQVDFWLRQUHIHUHQFHDQGFDOO JHWDWUDQVDFWLRQUHIHUHQFHDQGFDOO
PHWKRGVRQLW %07EHDQV PHWKRGVRQLW %07EHDQV
$FFHVV $FFHVV
\RXUVSHFLDO-1',HQYLURQPHQW \RXUVSHFLDO-1',HQYLURQPHQW
DQRWKHUEHDQ·VPHWKRGV DQRWKHUEHDQ·VPHWKRGV
DUHVRXUFHPDQDJHU OLNHDGDWDEDVH DUHVRXUFHPDQDJHU OLNHDGDWDEDVH
:KDWWRSXWLQWKHFRQVWUXFWRU
:HNQRZLW·VSDLQIXOO\REYLRXVE\QRZ127+,1*
8QOHVV\RX·UHIRUFHGWRGRQ·WHYHQSXWDFRQVWUXFWRULQ\RXUFRGHDWDOODQGMXVWXVH
WKHFRPSLOHUJHQHUDWHGGHIDXOWFRQVWUXFWRU
:KDWHYHU\RXGREH685(\RXKDYHDSXEOLFQRDUJFRQVWUXFWRULQ\RXUFODVV
SXEOLF&XVWRPHU ^`
:KDWWRSXWLQWKHVHW(QWLW\&RQWH[W PHWKRG
$VVLJQWKHFRQWH[WWRDQLQVWDQFHYDULDEOH5HPHPEHU\RXJHWRQO\21(FKDQFH
WRVDYHLW<RXPLJKWQRWDOZD\VQHHGWRXVHDVHVVLRQFRQWH[WEXW\RX·OOSUREDEO\
QHHGDQHQWLW\FRQWH[W%HVLGHV\RXUFRQWH[WLVJRQQDVWD\DOLYHZKHWKHU\RXNHHS
DUHIHUHQFHWRLWRUQRWVRWKHRQO\PHPRU\\RXVDYHLI\RXGRQ·WNHHSLWLVIRUWKH
UHIHUHQFHYDULDEOHQRWWKHREMHFWLWVHOI
SXEOLFYRLGVHW(QWLW\&RQWH[W (QWLW\&RQWH[WFW[ ^
FRQWH[W FW[
`
\RXDUHKHUH
&03EHDQFUHDWLRQ
&03(QWLW\EHDQFUHDWLRQ
6FHQDULR FOLHQWZDQWVWRFUHDWHDQHZHQWLW\LQWKHGDWDEDVH UHPHPEHUWKH
&RQWDLQHUPDGHWKHEHDQLQVWDQFHDQGWKHFRQWH[WHDUOLHUDQGSXWWKHPLQWKHSRRO
FRQWH[W
EHDQ
%REµ
WH ´%LOO\
HME&UHD EHDQ
FOLHQW FRQWH[W
RRO
+RPH RPS
FU REMHFW HDQIU
HD
WH JHW
E
´% %HDQ3RRO
LOO\ VWXE Eµ
% OO\%R
RE
µ UHDWH ´%L
F
'%
&OLHQWFDOOVFUHDWH ´%LOO\%REµ RQWKHKRPHVWXE
7KHFUHDWH ´%LOO\%REµ PHWKRGLQYRFDWLRQLVSDVVHGWRWKHKRPHREMHFW
$EHDQLVSXOOHGRXWRIWKHSRROWRGRWKHFUHDWLRQ
&RQWDLQHUFDOOVHME&UHDWH ´%LOO\%REµ RQWKHEHDQLQVWDQFH
(-%
REMHFW
VWXE $ EHDQ
REµ FRQWH[W
%
+RPH LOO\
REMHFW ´%
WH
UH
D %
W&
3RV
E
HM
,QVHUWDQHZ
URZLQWKHG
ZLWKDQHZSU DWDEDVH
LPDU\NH\ %HDQ3RRO
'%
&RQWDLQHULQVHUWVDQHZHQWLW\ URZ LQWKHGDWDEDVHIRUSULPDU\NH\
&RQWDLQHUJLYHVWKH(-%REMHFWDQG(QWLW\&RQWH[WWKHSULPDU\NH\YDOXH
&RQWDLQHUFDOOVHME3RVW&UHDWH ´%LOO\%REµ RQWKHEHDQWRJLYHWKHEHDQDFKDQFHWRILQLVKLQLWLDOL]LQJLWVHOI
7KHKRPHUHWXUQVWKH(-%REMHFWVWXEWRWKHFOLHQW
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
&UHDWLQJDQHZHQWLW\
&03HQWLW\EHDQ
note: this is not
creation, but entibe
ty
an instance
The Container inst creation.
the bean object ea antiated
FOLHQW
rlier
+RPH (-%
REMHFW REMHFW '%
EHDQ
wÕ on the bean instance,
see.. thereÕs no Ône happened the epool...
wh en th
FUHDWH because it already the bean in
Container Þrst put
HME&UHDWH
GDWDEDVHLQVHUW
QHZ
HME3RVW&UHDWH
EXVLQHVVPHWKRG
EXVLQHVVPHWKRG
7HOA 4HIS IS QUITE DIFFERENT FROM SESSION "UT THE SECOND DIFFERENCE BETWEEN ENTITY AND
BEAN CREATION SESSION BEAN EJB#REATE METHODS IS THE ORDER IN
WHICH THE %*" OBJECT IS CREATED 7HEN AN ENTITY
4HE #ONTAINER CALLS EJB#REATE ON A SESSION BEAN BEAN RUNS EJB#REATE THERES NO %*" OBJECT
INSTANCE ONLY ONCE AT THE BEGINNING OF THE BEANS 9IKES 4HAT MEANS THE BEAN HAS NO WAY TO GET A
LIFE 4HATS ONE BIG DIFFERENCE BETWEEN SESSION AND REFERENCE TO ITS BODYGUARD )N OTHER WORDS AN
ENTITY BEANSENTITY BEANS CAN RUN EJB#REATE ENTITY BEAN CANNOT USE THE EJB#REATE METHOD TO
OVER AND OVER LIKE A BUSINESS METHOD )N FACT SAY GET A REFERENCE TO ITS OWN %*" OBJECT AND PASS
THATS THE BEST WAY TO THINK OF IT AS JUST ANOTHER THAT REFERENCE TO SOMEONE ELSE 2EMEMBER A BEAN
HOME BUSINESS METHOD AS THOUGH IT WERE NAMED CANT PASS A REFERENCE TO ITSELF EVER 7HEN A BEAN
EJB)NSERT WHICH IN OUR HUMBLE OPINION IT WANTS TO PASS A REFERENCE TO ITSELF IT MUST PASS A
SHOULD HAVE BEEN NAMED BUT ONCE AGAIN THEY REFERENCE TO ITS OWN %*" OBJECT "UT IT CANT DO THAT
FORGOT TO ASK US IN EJB#REATE BECAUSE ITS TOO EARLY
\RXDUHKHUH
&03EHDQFUHDWLRQ
&03(QWLW\EHDQFUHDWLRQ
+H\EHDQUXQ 2.LQP\HME&UHDWH
\RXUHME&UHDWH
PHWKRG,·OOXVHWKRVHDUJV
PHWKRGDQGKHUHDUH IURPWKHFOLHQWWRVHWP\RZQ
WKHFOLHQWDUJV SHUVLVWHQWVWDWH ODVWQDPHÀUVW
QDPHSULPDU\NH\HWF
*UHDW1RZ,FDQ
ORRNDW\RXUSHUVLVWHQWÀHOG
VWDWHDQGXVHWKHGDWDWR 1RZWKDW,KDYHD
SULPDU\NH\,FDQPDNH
FUHDWHWKHQHZFXVWRPHULQ
WKH(-%REMHFW DQGWHOO
WKHGDWDEDVH
WKH(QWLW\&RQWH[W
LQVHUW
'%
(-%
%HIRUH $IWHU REMHFW
/DVW )LUVW 3.H\ /DVW )LUVW 3.H\
)UDQNLH )RRI )UDQNLH )RRI
%U\DQ %RRI %U\DQ %RRI
%LOO\ %RE
7KDQNV1RZWKDW
,·PLQHME3RVW&UHDWH ,NQRZ
2.EHDQLI\RXQHHG WKDWP\(-%REMHFWLVUHDG\DQG
WRÀQLVKXS\RXUFUHDWLRQ ,FDQJHWDUHIHUHQFHWRLWIURPP\
,·PGRQHLQVHUWLQJWKHURZDQG FRQWH[W,QHHGWRSDVVDUHIHUHQFHWR
PDNLQJWKH(-%REMHFWVRUXQ\RXU P\VHOI ZKLFKPHDQVDUHIHUHQFHWR
HME3RVW&UHDWH DQGKHUH·VWKH P\ERG\JXDUG RXWWRDQRWKHUEHDQ
RULJLQDOFUHDWHDUJVMXVWLQ VR,5($//<QHHGHGDVHFRQG
FDVH\RXIRUJRW FKDQFHWRÀQLVKP\FUHDWLRQ
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
,PSOHPHQW\RXUHME&UHDWH PHWKRGV
:KDWWRSXWLQHME&UHDWH
3XW\RXUHQWLW\LQLWLDOL]DWLRQFRGHKHUH7KLVPHDQVVHWWLQJYDOXHVIRU\RXUSHUVLVWHQW
ILHOGVWKHILHOGVWKDWPDSWRFROXPQVLQWKHGDWDEDVHURZWKDW·VDERXWWREHLQVHUWHG
1RWLFHZHDUHQ·WVD\LQJ´SXW\RXUREMHFWLQLWLDOL]DWLRQFRGHKHUHµ:LWKVHVVLRQEHDQVZHWROG
\RXWRWUHDWWKHHME&UHDWH NLQGRIOLNHDFRQVWUXFWRUIRUWKHEHDQ%XWZLWKHQWLW\EHDQVLW·VGLIIHU
HQWEHFDXVHWKHLQVWDQFHZDVLQLWLDOL]HGDORQJWLPHDJR ZKHQLWVVHW(QWLW\&RQWH[W PHWKRGZDV
FDOOHG
6RHME&UHDWH LVDERXWLQLWLDOL]LQJWKHEHDQDVWKLVQHZHQWLW\WKHEHDQZLOOQRZUHSUHVHQW)RU
D&03EHDQWKLVPHDQVWKHFOLHQWKDVKDQGHG\RXDUJXPHQWVUHSUHVHQWLQJWKHGDWDWRLQVHUW
LQWRWKHGDWDEDVH7KH&RQWDLQHUZLOOORRNDWWKHVWDWHRI\RXUSHUVLVWHQWILHOGVRQFHHME&UHDWH
UHWXUQVDQGXVHWKRVHILHOGVWRPDNHWKHQHZURZLQWKHGDWDEDVH
,I\RXGRQRWKLQJHOVHLQHME&UHDWH \RXPXVWPDNHDSULPDU\NH\IRUWKLVHQWLW\7KDW·V\RXU
PRVWLPSRUWDQWMRE<RXPLJKWPDNHWKHNH\EDVHGRQDUJXPHQWVWRWKHFUHDWHPHWKRG<RX
PLJKWPDNHWKHNH\EDVHGRQDNH\JHQHUDWLQJDOJRULWKP<RXPLJKWKDYHDNH\VHUYHUWKDW\RX
JRWRIRUWKHQH[WNH\:KDWHYHULWLV\RXPXVWFRPHXSZLWKWKHNH\DQGDVVLJQLWWR\RXUSULPDU\
NH\ILHOG:KHQHME&UHDWH WKH&RQWDLQHUORRNVDWWKHVWDWHRI\RXUSHUVLVWHQWILHOGVDQGXVHV
WKDWGDWDWRPDNHWKHQHZURZ
:DUQLQJ5HPHPEHUWKH&RQWDLQHUFDOOV\RXUHME&UHDWH EHIRUHLWFDQPDNHWKH(-%REMHFWVR
\RXFDQ·WXVHHME&UHDWH WRJHWDUHIHUHQFHWR\RXUVHOI LHDUHIHUHQFHWR\RXUERG\JXDUG(-%
REMHFW <RX·OOKDYHWRZDLWXQWLOHME3RVW&UHDWH EHIRUH\RXFDQDVN\RXUFRQWH[WIRUDUHIHUHQFH
WR\RXURZQFRPSRQHQWLQWHUIDFH<RXDOVRFDQ·WXVHHME&UHDWH WRDFFHVV\RXURZQSHUVLVWHQW
UHODWLRQVKLSV \RXKDYHWRZDLWXQWLOHME3RVW&UHDWH EXWZH·OOFRYHUDOOWKDWLQWKHQH[WFKDSWHU
y key!
m ust be th e ty pe of your primar
us in g is a
This e prim ary key weÕre type (and
In th is ca se , th
ust be the return
String, so that ism in the DD)
weÕll declare th
SXEOLF6WULQJHME&UHDWH 6WULQJODVW6WULQJ¿UVW ^
DVVLJQDUJVWRSHUVLVWHQW¿HOGV
WKLVVHW/DVW1DPH ODVW Once ejbCreate() completes,
WKLVVHW)LUVW1DPH ¿UVW Container will use th e val
set to make the new row.ues you
VHWDSULPDU\NH\
WKLVVHW3ULPDU\.H\ WKLVPDNH.H\
UHWXUQQXOO
` ret urn null?? WhatÕs up with TH
AT?
\RXDUHKHUH
HQWLW\SULPDU\NH\
7JRMK\QLMV\Q\a"\PMXZQUIZaSMa
%VERY ENTITY -534 HAVE A UNIQUE IDENTITY 4HE #ONTAINER WILL NEVER LET YOU
GET AWAY WITH HAVING TWO OR MORE ENTITIES WITH THE SAME PRIMARY KEY !ND AS
OF %*" COMING UP WITH THAT PRIMARY KEY IS STILL YOUR JOB 4HE #ONTAINER
WONT DO IT AT LEAST NOT ACCORDING TO THE SPECIlCATION
,I,·PMXVW
VXSSRVHGWRUHWXUQQXOO ,·PQRWJRQQDGRLW<28
ZK\GR,KDYHWRFRPH KDYHWRFRPHXSZLWKWKH
XSZLWKWKHNH\" SULPDU\NH\,GRQ·WNQRZZKDW
\RXUEXVLQHVVORJLFLVDQG,·P $QGGRQ·WH[SHFWPHWR
QRWJRQQDEHDSULPDU\NH\ GRLWHLWKHULI\RX·UHXVLQJ
JHQHUDWRUIRU\RX &03<RXKDYHWRFRPHXSZLWK
WKHSULPDU\NH\%()25(WKH
&RQWDLQHUWULHVWRLQVHUWWKHQHZ
URZ
'%
7ITH #-0 YOURE STILL RESPONSIBLE FOR THE PRIMARY KEY 4HAT DOESNT MEAN YOU
WONT USE A PRIMARY KEY SERVICE OF SOME KIND -AYBE YOU HAVE A SERVICE THAT
AUTOMATICALLY ALLOCATES A BIG BLOCK OF PRIMARY KEYS FROM THE DATABASE AND
THEN HANDS THEM OUT AS NEEDED /R YOU MIGHT HAVE SOME TYPE OF UNIQUE
IDENTIlER ALGORITHM THAT MAKES UNIQUE KEYS FOR YOU /R MAYBE YOURE USING
THE CUSTOMERS SOCIAL SECURITY NUMBER OR ACCOUNT NUMBER OR THATS UP TO
YOU TO DECIDE
!ND THE WAY YOU TELL THE #ONTAINER WHAT VALUE THE ABOUT
TO
BE
CREATED ENTITY
SHOULD HAVE IS THROUGH THE VALUE OF ONE OR MORE OF YOUR PERSISTENT lELDS
)F YOU HAVE JUST ONE lELD AS YOUR PRIMARY KEY AND IT MAPS DIRECTLY TO A
COLUMN IN THE DATABASE YOURE SET "UT IF YOU NEED MORE THAN ONE VALUE TO
UNIQUELY IDENTIFY AN ENTITY LIKE MAYBE IT TAKES A COMBINATION OF NAME AND
DATE YOU CAN USE A COMPOUND KEY THAT USES TWO OR MORE OF YOUR CONTAINER
MANAGED PERSISTENT lELDS
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
5XOHVIRUHME&UHDWH
<RXPXVWLPSOHPHQWWKHHME&UHDWH PHWKRG!WRPDWFKHDFK
FUHDWH PHWKRG!LQWKHKRPHLQWHUIDFH
7KHPHWKRGQDPHPXVWEHJLQZLWKWKHSUHIL[´HME&UHDWHµ
%\WKHHQGRIHME&UHDWH
7KHPHWKRGPXVWEHGHFODUHGSXEOLFDQGPXVWQRWEHGHFODUHGVWDWLF
RUILQDO \RX0867KDYHDYDOLG
7KHGHFODUHGUHWXUQW\SHPXVWEHWKHHQWLW\EHDQ·VSULPDU\NH\W\SH SULPDU\NH\DVVLJQHGWRWKH
HYHQWKRXJK\RXZLOOUHWXUQQXOOIURPWKHPHWKRG &03ILHOGWKDW\RX·YHWKH
7KHPHWKRGDUJXPHQWVPXVWEHWKHVDPHDVWKHDUJXPHQWVRIWKH WROGWKH&RQWDLQHULV\RXU
PDWFKLQJFUHDWH PHWKRG!
SULPDU\NH\ILHOG
<RXPD\GHFODUHDWKURZVFODXVHZLWK&UHDWH([FHSWLRQRUDQ\
DUELWUDU\DSSOLFDWLRQ FKHFNHG H[FHSWLRQWKDW\RXOLNHDVORQJDVLW
ZDVDOVRGHFODUHGLQWKHKRPHLQWHUIDFHEXW\RXPXVW127GHFODUHD
,I\RXXVHDFRPSRXQGNH\
5HPRWH([FHSWLRQ WKHQ$//WKHILHOGVWKDW
PDNHXSWKDWNH\PXVWKDYH
5XOHVIRU3ULPDU\.H\V YDOLGYDOXHV
$SULPDU\NH\FODVVPXVWEH6HULDOL]DEOHDQGSXEOLF
,IDWWKHHQGRIHME&UHDWH
<RXFDQXVHDVLQJOHSHUVLVWHQWILHOGIURP\RXUEHDQFODVVDV\RXU
SULPDU\NH\E\LGHQWLI\LQJERWKWKHILHOGQDPHDQGWKHFODVVW\SHLQ \RXUSULPDU\NH\LVQXOO
WKH'' WKH&RQWDLQHUZRQ·WGRWKH
,I\RXQHHGWZRRUPRUHSHUVLVWHQWILHOGVWRXQLTXHO\LGHQWLI\\RXU FUHDWH
HQWLW\PDNHDFXVWRPFRPSRXQGSULPDU\NH\FODVV
$FRPSRXQGNH\FODVVPXVWEHPDGHXSRIILHOGVWKDWDUHGHILQHGDV
SHUVLVWHQWILHOGVLQWKHEHDQFODVV7KHILHOGVLQWKHEHDQFODVVPXVW
KDYHSXEOLFDFFHVVRUPHWKRGV
Q: (OW COME ) CANT HAVE THE DATABASE COME UP WITH THE PRIMARY
KEY 4HATS HOW WE USUALLY DO IT !RE YOU TELLING ME THE #ONTAINER CANT
DO THAT
A: 9ES THATS WHAT WERE TELLING YOU 4HE CONTRACT YOU HAVE WITH THE
#ONTAINER SAYS THAT BY THE TIME EJB#REATE IS DONE YOUVE DONE WHATEVER
YOU HAD TO DO TO MAKE A VALID PRIMARY KEY 9OU MIGHT HAVE A SERVER THAT
LETS YOU SAY h,ET THE DATABASE COME UP WITH THE KEY WHEN YOU DO THE
INSERTv BUT THERES NO GUARANTEE IN THE SPEC AND YOU CANT ASSUME THAT
ALL %*" VENDORS SUPPORT THIS -AYBE SOME DAY IN THE FUTURE THERE WILL BE
A DEPLOYMENT
INDEPENDENT WAY TO SAY h5SE AUTO
GENERATED KEYv IN THE DE
PLOYMENT DESCRIPTOR "UT TODAY IS NOT THAT DAY !ND %*" IS NOT THAT SPEC
\RXDUHKHUH
HQWLW\EHDQFUHDWLRQ
,PSOHPHQW\RXUHME3RVW&UHDWH PHWKRGV
:KDWWRSXWLQHME3RVW&UHDWH
)LQLVK\RXULQLWLDOL]DWLRQFRGHKHUH1RZ\RXFDQVHHZK\HQWLW\EHDQVQHHG
DQHME3RVW&UHDWH ³EHFDXVHHME&UHDWH LVWRRHDUO\IRUVRPHWKLQJV7KH
WZRPRVWLPSRUWDQWUHDVRQVIRUHME3RVW&UHDWH DUHWKDW\RXFDQXVHLWWRJHW
DUHIHUHQFHWR\RXURZQ(-%REMHFWDQG\RXPXVWXVHLWIRUDFFHVVLQJ\RXU
FRQWDLQHUPDQDJHGUHODWLRQVKLSV &05 :H·OOORRNDW&05LQWKHQH[WFKDSWHU
7KLQNRIHME3RVW&UHDWH DVWKHRWKHUKDOIRI\RXUHME&UHDWH ZLWKVRPH5HDOO\
,PSRUWDQW7KLQJVKDSSHQLQJLQWKHPLGGOH,W·V\RXUVHFRQG DQGODVW FKDQFHWR
ILQLVK\RXULQLWLDOL]DWLRQLI\RXQHHGWRGRWKLQJVDVSDUWRIFUHDWLQJWKHQHZHQWLW\
WKDWGHSHQGRQKDYLQJDFFHVVWR\RXU(-%REMHFW RUVRPHWKLQJHOVHWKDWFDQ
KDSSHQRQO\LQHME3RVW&UHDWH DQGQRWLQHME&UHDWH
:H·OOUHYLVLWHME3RVW&UHDWH LQWKHQH[WFKDSWHUZKHQZHORRNDW&05
5XOHVIRUHME3RVW&UHDWH
<RXPXVWLPSOHPHQWWKHHME3RVW&UHDWH PHWKRG!WRPDWFKHDFKFUHDWH PHWKRG!
LQWKHKRPHLQWHUIDFH
7KHPHWKRGQDPHPXVWEHJLQZLWKWKHSUHIL[´HME3RVW&UHDWHµ
7KHPHWKRGPXVWEHGHFODUHGSXEOLFDQGPXVWQRWEHGHFODUHGVWDWLFRUILQDO
7KHGHFODUHGUHWXUQW\SHPXVWEHYRLG
7KHPHWKRGDUJXPHQWVPXVWEHWKHVDPHDVWKHPDWFKLQJHME&UHDWH PHWKRG!
<RXPD\GHFODUHDWKURZVFODXVHZLWK&UHDWH([FHSWLRQRUDQ\DUELWUDU\DSSOLFD
WLRQ FKHFNHG H[FHSWLRQWKDW\RXOLNHDVORQJDVLWZDVDOVRGHFODUHGLQWKHKRPH
LQWHUIDFHEXW\RXPXVW127GHFODUHD5HPRWH([FHSWLRQ
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
$OOWKUHHKDYHWKHVDPHDUJV
EXWGLIIHUHQWUHWXUQW\SHV
+RPHLQWHUIDFH
FUHDWH PHWKRG!
SXEOLF&XVWRPHUFUHDWH 6WULQJODVW6WULQJ¿UVW WKURZV
&UHDWH([FHSWLRQ5HPRWH([FHSWLRQ
differences
%HDQFODVV notice the name
HME&UHDWH PHWKRG!
SXEOLF6WULQJHME&UHDWH 6WULQJODVW6WULQJ¿UVW ^`
another differe
%HDQFODVV nce
HME3RVW&UHDWH PHWKRG!
SXEOLFYRLGHME3RVW&UHDWH 6WULQJODVW6WULQJ¿UVW ^`
the same
clas s d oe sn Õt have to declarend you
the bean it throws them.
(A
bean.
exceptions, unlessa RemoteException from theion.
NEVER throw iner throws a RemoteExcept
Only the Conta
YiX`e
gfn\i
7KLQNDERXWWKHWKUHHPHWKRGVDERYHDQGKRZWKH\¶UHUHODWHGWRRQHDQRWKHU7KLQNDERXW
ZKDWWKH\¶UHHDFKUHVSRQVLEOHIRU1RZDQVZHUWKHVHWZRTXHVWLRQV
:K\DUHWKHUHWXUQW\SHVGHFODUHGOLNHWKLV",QRWKHUZRUGVH[SODLQZK\HDFKRIWKHWKUHH
GLIIHUHQWUHWXUQW\SHVLVZKDWLWLV
:K\GRERWKHME&UHDWH PHWKRG!DQGHME3RVW&UHDWH PHWKRG!KDYHWKHVDPHDUJXPHQWV"
\RXDUHKHUH
HQWLW\EHDQFUHDWLRQ
,·PKDYLQJDKDUG
WLPHFRPLQJXSZLWKD
UHDVRQZK\DEHDQZRXOG
QHHGDUHIHUHQFHWRLWV
RZQ(-%REMHFW
,PDJLQH\RXLQSXWDQHZ&XVWRPHU
LQWKHGDWDEDVH0D\EH\RXU
EXVLQHVVORJLFVD\V´:KHQ\RX
PDNHDQHZ&XVWRPHUWHOOWKHPDUNHWLQJ
GHSDUWPHQWE\SDVVLQJDUHIHUHQFHWRWKH
QHZ&XVWRPHUHQWLW\EHDQRXWWRWKH
&XVWRPHU5HJLVWUDWLRQEHDQ´
,VWLOOGRQ·WVHHZK\
,QHHGWKH(-%REMHFW
FDQ·W,MXVWSDVV´WKLVµDV
WKHDUJXPHQWWRWKHRWKHU 7KLQNDERXWLWFROOHJHER\
)LUVWRIILW·VDJDLQVW%HDQ/DZ7KH
EHDQ"
(-%VSHFIRUELGVSDVVLQJ¶WKLV·DV
DQDUJXPHQWIURPEHDQFRGH12%2'<
LVVXSSRVHGWRJHWDGLUHFWUHIHUHQFHWR
WKHEHDQH[FHSWWKHFRQWDLQHU*HH]LI
VRPHERG\','JHWDUHIHUHQFHWRWKH
EHDQWKH\FRXOGMXVWFDOOPHWKRGVRQ
LWDQGVNLSDOOP\VHUYLFHV
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
2K,JHWLWLI,ZDQW ,I\RXZDQWWKHEHDQ\RX
WRSDVVDUHIHUHQFHWRWKH JRWWDJRWKURXJKPH$QG\RX
EHDQ,SDVVDUHIHUHQFHWRWKH GR127ZDQWWRPHVVZLWKPH,·YH
EHDQ·VERG\JXDUGLQVWHDG/LNH ZDWFKHGWKH0DWUL[OLNHWLPHV
SDVVLQJWKH(-%REMHFW·V DQG,·YHEHHQWDNLQJ3LODWHVIRU
EXVLQHVVFDUGLQVWHDGRIWKH OLNH\HDUV
EHDQ·V5LJKW"
,W·VOLNHWKLVLI,·PDEHDQ,
VD\WRDPHWKRGRIVRPHRQH
HOVH´+HUH·VDFDUG\RXFDQXVH
WRUHDFKPH%XWGRQ·WFDOOPHFDOO
P\ERG\JXDUGDQGKHUH·VKLV
FRQWDFWLQIRUPDWLRQµ
EHDQ
,QVWHDGRI
GR6WXII WKLV
(-%
REMHFW
8VH
GR6WXII P\&RQWH[WJHW(-%2EMHFW
\RXDUHKHUH
HQWLW\EHDQFUHDWLRQ
*MIV\PQVO[aW]KIVLWL]ZQVOM V\Q\aKZMI\QWV"
WLPHOLQH
HME&UHDWH HME3RVW&UHDWH
8VH\RXU(QWLW\&RQWH[WWR 8VH\RXU(QWLW\&RQWH[WWR
JHWDUHIHUHQFHWR\RXUKRPH JHWDUHIHUHQFHWR\RXUKRPH
JHWDUHIHUHQFHWR\RXU(-%REMHFW JHWDUHIHUHQFHWR\RXU(-%REMHFW
JHW\RXUSULPDU\NH\ JHW\RXUSULPDU\NH\
JHWVHFXULW\LQIRUPDWLRQDERXWWKHFOLHQW JHWVHFXULW\LQIRUPDWLRQDERXWWKHFOLHQW
IRUFHDWUDQVDFWLRQWRUROOEDFN &07 IRUFHDWUDQVDFWLRQWRUROOEDFN &07
EHDQV EHDQV
ILQGRXWLIWKHWUDQVDFWLRQKDVDOUHDG\ ILQGRXWLIWKHWUDQVDFWLRQKDVDOUHDG\
EHHQVHWWRUROOEDFN &07EHDQV EHHQVHWWRUROOEDFN &07EHDQV
JHWDWUDQVDFWLRQUHIHUHQFHDQGFDOO JHWDWUDQVDFWLRQUHIHUHQFHDQGFDOO
PHWKRGVRQLW %07EHDQVRQO\VR PHWKRGVRQLW %07EHDQVRQO\VR
HQWLWLHVFDQ·WXVHWKLV HQWLWLHVFDQ·WXVHWKLV
$FFHVV $FFHVV
\RXUVSHFLDO-1',HQYLURQPHQW \RXUVSHFLDO-1',HQYLURQPHQW
DQRWKHUEHDQ·VPHWKRGV DQRWKHUEHDQ·VPHWKRGV
DUHVRXUFHPDQDJHU OLNHDGDWDEDVH DUHVRXUFHPDQDJHU OLNHDGDWDEDVH
itÕs too early
object or primto get a reference Create(),
ar to your e time yo uÕre in ejbPoristmary key
still waiting for key, because the contaiEJB
y By t h
knows your p
Once you retur you to Þnish your ejbCre ner is the containere (or found) the EJB
will look in yourn from ejbCreate(), the coate(). and has madthis key.
youÕve made as bean and see what state ntainer object for
did based on t a result of the initializatiochanges
he client-supplie n
can the containe
r Þ d args. Only Tyou
key is (by lookin gu re out what yo HEN
g in yo ur prim ur prim ar y
it needs that to
make an EJBaroby key Þeld!), and
ject.
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
&03(QWLW\ILQGHU
6FHQDULR FOLHQWZDQWVWRJHWDUHIHUHQFHWRDQH[LVWLQJHQWLW\EHDQ
FRQWH[W
EHDQ
FOLHQW
EHDQ
.H\ ´µ
+RPH \3ULPDU\ FRQWH[W
ÀQ REMHFW HME)LQG%
G%
ULP
\3
DU %HDQ3RRO
\. VWXE ´µ
H\
´ ULPDU\.H\
\3
µ
ÀQG% '%
&OLHQWFDOOVILQG%\3ULPDU\.H\ ´µ RQWKHKRPHUHIHUHQFH
7KHILQGHUPHWKRGLVSDVVHGWRWKHKRPHREMHFW
$EHDQLVVHOHFWHGIURPWKHSRROWRUXQWKHHME)LQG%\3ULPDU\.H\ ´µ PHWKRG
7KHEHDQGRHVDVHOHFWRQWKHGDWDEDVHWRYHULI\WKDWDQHQWLW\ZLWKSULPDU\NH\H[LVWV
FRQWH[W
(-%
REMHFW EHDQ
VWXE
EHDQ
UHWXU µ
QVWXE +RPH UHWXUQ´ FRQWH[W
REMHFW
%HDQ3RRO
'%
7KHEHDQUHWXUQVWKHSULPDU\NH\ WRWKHKRPHZKLFKPHDQVWKHHQWLW\H[LVWVLQWKHGDWDEDVH
7KH&RQWDLQHUPDNHV RUILQGV DQ(-%REMHFWIRU
7KH&RQWDLQHUUHWXUQVWKH(-%REMHFWVWXEIRU
1RWH LIWKHEHDQKDGQRWIRXQGDPDWFKLQJHQWLW\IRUSULPDU\NH\WKHFOLHQWZRXOGJHWDQ
2EMHFW1RW)RXQG([FHSWLRQ VXEFODVVRI)LQGHU([FHSWLRQ
\RXDUHKHUH
HQWLW\EHDQ¿QGHUV
)LQGLQJDQH[LVWLQJHQWLW\
&03HQWLW\EHDQ
FOLHQW
+RPH (-%
REMHFW REMHFW '%
EHDQ
The bean neverr lea ves the
ods!
ÀQG PHWKRG! DUJV pool for Þnde thme
HME)LQG PHWKRG! DUJV
GDWDEDVHVHDUFK
QHZ
EXVLQHVVPHWKRG
EXVLQHVVPHWKRG
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
&03(QWLW\EHDQILQGHUV
+H\EHDQ 8PDUHQ·W\RXIRUJHWWLQJWKDW,·PD
UXQWKLVHME)LQG
&03EHDQ",GRQ·WKDYHWKHVHPHWKRGV
PHWKRGDQGKHUHLV LQP\EHDQFODVV$OWKRXJKFRPHWRWKLQN
WKHFOLHQWDUJ´µ RILW,·PDFRQFUHWHLPSOHPHQWDWLRQWKDW
WKH&RQWDLQHU³,PHDQ<28³PDGHIURP
P\DEVWUDFWFODVVVRPD\EH,'2KDYHWKH
PHWKRGVDIWHUDOOEXW,MXVWGLGQ·W
UHDOL]HLWDQG
5HOD[$QG\RX·UHULJKW,·P
WKHRQHWKDWLPSOHPHQWHGWKH&03
ÀQGHUPHWKRGVVRZH·OOVKRZLWWKLVZD\
1RZWKDW,KDYH
HYHQWKRXJKLWLV\RXWKDWFRQFHSWXDOO\ YHULÀHGWKDWWKLVHQWLW\
GRHVWKHZRUN,JXHVVLQWKHHQG
H[LVWV,FDQPDNHWKH
LWGRHVQ·WPDWWHUDVORQJDVLW
(-%REMHFWLILWGRHVQ·W
KDSSHQV
DOUHDG\H[LVW
VHDUFKIRUSN
'%
/DVW )LUVW 3.H\ (-%
3RO\ 0RUSKLVP REMHFW
'HZH\ &KHDWHP
7KDQNV,UHDOO\
QHHGWRFKDQJH
3RO\·VODVWQDPHWR
2.FOLHQWKHUH·V (VWKHU
\RXU(-%REMHFW
UHIHUHQFHIRU ,JXHVV,MXVW
<RXFDQXVHLWWRFDOO JHWWRVWD\LQWKH
EXVLQHVVPHWKRGVRQ3RO\ SRRODQGIRUJHW
0RUSKLVP WKHZKROHWKLQJ
\RXDUHKHUH
HQWLW\EHDQ¿QGHUV
<28GRQ·WLPSOHPHQWWKH)LQGHUPHWKRGV
'RQ·WSXWDQ\WKLQJLQ
LQWHUIDFH!!
&XVWRPHU+RPH \RXUEHDQFODVVDERXWWKH
FUHDWH 6WULQJODVW6WULQJILUVW
<RXLPSOHPHQW ILQGHUV7KH&RQWDLQHU
FUHDWHDQGKRPHEXVLQHVVPHWKRGV XSGDWH$OO 6WULQJFPG
LPSOHPHQWV\RXUILQGHU
&RQWDLQHULPSOHPHQWV
ILQG%\3ULPDU\.H\ 6WULQJNH\
PHWKRGVXVLQJWKHKRPH
ILQG%\&LW\ 6WULQJFLW\
ILQGHUPHWKRGV
LQWHUIDFHDQG\RXU
GHSOR\PHQWGHVFULSWRUWR
ILJXUHRXWZKDWWRGR
<RXUEHDQFODVVPXVW
*UST DONT WRITE @EM &OR A #-0 BEAN DONT PUT
ANYTHING IN YOUR CLASS ABOUT THE l NDER METHODS QRWHYHQ0(17,21WKH
9OU WILL IMPLEMENT YOUR CREATE AND HOME
BUSINESS METHODS BUT AS FAR AS YOUR OWN BEAN
ILQGHUPHWKRGV
CLASSTHE ONE THAT YOU WRITEGOES THERE ARE NO
l NDER METHODS
&XVWRPHU%HDQ
9OU DO DECLARE THEM IN THE HOME INTERFACE
OF COURSE INCLUDING THE MANDATORY HME&UHDWH 6WULQJODVW6WULQJILUVW
l ND"Y0RIMARY+EY BUT YOU DONT WRITE ANY HME3RVW&UHDWH 6WULQJODVW6WULQJILUVW
OTHER *AVA CODE RELATED TO YOUR l NDERS HME+RPH8SGDWH$OO 6WULQJFPG
4HE #ONTAINER LOOKS IN YOUR HOME INTERFACE AND HME)LQG%\3ULPDU\.H\ 6WULQJNH\
YOUR DEPLOYMENT DESCRIPTOR TO l GURE OUT WHAT TO HME)LQG%\&LW\ 6WULQJFLW\
DO WITH THE l NDER METHODS AND THE #ONTAINER
WRITES ALL THE CODE FOR THEM 9OULL NEVER SEE IT
VHW(QWLW\&RQWH[W (QWLW\&RQWH[WHF
HME$FWLYDWH
HME3DVVLYDWH
HME5HPRYH
XQVHW(QWLW\&RQWH[W
HME/RDG
HME6WRUH
EXVLQHVVPHWKRGVIURPWKH
FRPSRQHQWLQWHUIDFH
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
+PPPP,QRWLFHGWKDWWKHEHDQ
GLGQ·WFRPHRXWRIWKHSRRO%XWZKDW·V
5($//<ZHLUGLVWKDWQRZWKHUH·VDQ(-%REMHFW
IRUEXWWKHUH·VQRHQWLW\EHDQSOD\LQJWKH
SDUWRI7KHEHDQQHYHUJRWORDGHGXSZLWK
WKHHQWLW\GDWDIURPWKHGDWDEDVHVRZKDW
KDSSHQVLIWKHFOLHQWFDOOVDEXVLQHVVPHWKRG
OLNHJHW$GGUHVV """
:K\VKRXOG,ZDVWHDEHDQ·V
WLPHE\ORDGLQJLWXSZLWKWKH
GDWDZKHQWKHFOLHQWPLJKWQRW
HYHUFDOODEXVLQHVVPHWKRGRQ
WKDW(-%REMHFWUHIHUHQFH"
<RXMXVWDOZD\VKDYHWR
,KHDUZKDW\RX·UHVD\LQJEXW NQRZWKHWUXWK2.\RX
FRPHRQDUHQ·WWKHFKDQFHV JRWPHRQWKLVRQH<HVLW,6OLNHO\
SUHWW\JRRGWKDWWKHFOLHQW,6 WKHFOLHQWZLOOFDOODEXVLQHVVPHWKRGRQWKH
JRQQDFDOODEXVLQHVVPHWKRG HQWLW\VRLWPLJKWVHHPPRUHHIÀFLHQWWRKDYH
RQWKHEHDQ"7KH\ZHQWWRWKH WKHEHDQUHDG\%XWHYHQLI,','ORDGWKH
WURXEOHRIÀQGLQJLW GDWDLQWRWKHEHDQGXULQJWKHÀQGHUPHWKRG
,·GVWLOOKDYHWRUHORDGLWDQ\ZD\:K\"
%HFDXVHE\WKHWLPHWKHFOLHQWJHWV
DURXQGWRFDOOLQJWKHEXVLQHVVPHWKRG
WKHEHDQ·VVWDWHPLJKWEHVWDOH
\RXDUHKHUH
HQWLW\EHDQ¿QGHUV
,·PQRWIROORZLQJ
ZKDWGR\RXPHDQE\
VWDOH"+RZFDQWKHEHDQEHFRPH
VWDOHLIQRERG\HOVHFDQJHW
WRWKHEHDQ·VGDWD"+RZ
FRXOGDQ\ERG\FKDQJHWKH
7KLQNDERXWLW7KHHQWLW\3RO\0RUSKLVP
HQWLW\"
OLYHVLQWKHGDWDEDVH DURZLQDWDEOH 6XUH
ZHFDQKDQGRXWUHIHUHQFHVWRWKH(-%REMHFW
IRUWKLVHQWLW\%87WKHHQWLW\%($1LVQ·WWKH
RQO\ZD\WRJHWWRWKHGDWDEDVH6RZKLOHWKHFOLHQWLV
ZDLWLQJWRFDOODPHWKRGIRUDOOZHNQRZVRPHRQHHOVH
FRXOGKDYHXSGDWHG3RO\·VUHFRUGLQWKHGDWDEDVH
,IWKDWZHUHWRKDSSHQWKHQZKHQWKHFOLHQWFDOOV
DPHWKRGRQWKH3RO\HQWLW\EHDQWKHEHDQ
UHWXUQVROGZURQJLQIRUPDWLRQ
2NQRZ,JHWLWLIWKHEHDQZHUH
WREHORDGHGXSZLWKGDWDGXULQJWKH
ÀQGHUPHWKRGWKHQE\WKHWLPHWKH
FOLHQWFDOOVDEXVLQHVVPHWKRGRQLWWKH <HV,·PJRQQDKDYHWRORDG
XQGHUO\LQJHQWLW\GDWDLQWKHGDWDEDVH WKHGDWDLQDJDLQDVVRRQDVWKH
PLJKWKDYHFKDQJHG FOLHQWFDOOVDEXVLQHVVPHWKRGMXVWWR
PDNHVXUHWKDWWKHEHDQLVUHIUHVKHG
ZLWKWKHPRVWFXUUHQWGDWDVRWKHUH·V
QRSRLQWLQORDGLQJLWLQGXULQJWKH
ÀQGHU,WZRXOGMXVWEHDZDVWH
RIUHVRXUFHV
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
&03+RPH%XVLQHVV0HWKRGV
6FHQDULR FOLHQWZDQWVWRFDOODEXVLQHVVPHWKRGLQWKHKRPH
FRQWH[W
EHDQ
FOLHQW
EHDQ
+RPH WH$OO
HME8SGD
FRQWH[W
REMHFW
XS
GD
WH VWXE
%HDQ3RRO
$O
O H$OO
XSGDW
'%
&OLHQWFDOOVXSGDWH$OO RQKRPHUHIHUHQFH
7KHXSGDWH$OO PHWKRGLVSDVVHGWRWKHKRPHREMHFW
$EHDQLVVHOHFWHGIURPWKHSRROWRUXQWKHHME8SGDWH$OO PHWKRG
FRQWH[W
EHDQ
FOLHQW
EHDQ
DWD
UHWXUQ +RPH UHWXUQG FRQWH[W
GDWD
REMHFW
%HDQ3RRO
'%
:LWKRXWOHDYLQJWKHSRROWKHEHDQUXQVWKHKRPHPHWKRGSUREDEO\FDOOLQJRQD&RQWDLQHU
LPSOHPHQWHGVHOHFW PHWKRG!WRDFFHVVWKHGDWDEDVH
7KHEHDQUHWXUQVIURPWKHPHWKRG SRVVLEO\UHWXUQLQJGDWD
7KH&RQWDLQHUSDVVHVWKHUHWXUQYDOXHEDFNWRWKHFOLHQW
\RXDUHKHUH
KRPHEXVLQHVVPHWKRGV
&OLHQWLQYRNHVD+RPH%XVLQHVV0HWKRG
&03HQWLW\EHDQ
FOLHQW
+RPH
REMHFW '%
EHDQ
The bean nevereslea ves the pool
bu sin s me thods
KRPHEXVLQHVVPHWKRG for home
KRPHEXVLQHVVPHWKRG
GDWDEDVHDFFHVVYLDD
&RQWDLQHULPSOHPHQWHG
No EJB obje
ct is involved VHOHFWPHWKRG
!
:KDWWRSXWLQDKRPHEXVLQHVVPHWKRG
$V\RXZULWH\RXUFRGHUHPHPEHUWKDWDQHQWLW\EHDQVWD\VLQWKHSRROZKHQLWUXQVD
KRPHEXVLQHVVPHWKRG3XWFRGHLQ\RXUKRPHEXVLQHVVPHWKRGVWKDWDSSO\WRWKHXQGHUO\LQJ
GDWDEDVH³IRUDJURXSRIHQWLWLHVUDWKHUWKDQRQHVSHFLILFHQWLW\³DQGWKDWGRQ·WUHWXUQWKHEHDQ·V
FRPSRQHQWLQWHUIDFH WKHZD\ILQGHUVDQGFUHDWHPHWKRGVPXVW
SXEOLF&ROOHFWLRQHME+RPH'LVSOD\$OO ^
GRDVHOHFWRQWKHGDWDEDVHXVLQJDFRQWDLQHULPSOHPHQWHG
VHOHFWPHWKRG QH[WFKDSWHU WKHQUHWXUQDQ$UUD\/LVWRI6WULQJV
`
5XOHVIRUKRPHEXVLQHVVPHWKRGV
<RXPXVWKDYHDQHME+RPH PHWKRG!PHWKRGIRUHYHU\KRPH PHWKRG!LQWKHKRPHLQWHUIDFH
7KHQDPHPXVWEHJLQZLWKWKHSUHIL[´HME+RPHµIROORZHGE\WKHQDPHRIWKHKRPH PHWKRG!EXW
ZLWKWKHILUVWOHWWHURIWKHPHWKRGFDSLWDOL]HG)RUH[DPSOHXSGDWH$OO LQWKHKRPHLQWHUIDFHZLOOEH
HME+RPH8SGDWH$OO LQWKHEHDQFODVV
7KHPHWKRGPXVWEHGHFODUHGSXEOLFDQG127VWDWLF
,IWKHKRPHLQWHUIDFHLV5HPRWHWKHDUJXPHQWVDQGUHWXUQYDOXHVPXVWEHOHJDOW\SHVIRU50,,,23
<RXPD\GHFODUHDWKURZVFODXVHZLWK\RXURZQDSSOLFDWLRQ FKHFNHG H[FHSWLRQVDVORQJDVWKH
H[FHSWLRQVZHUHDOVRGHFODUHGLQWKHKRPHLQWHUIDFH
(YHQLI\RXUOLIHGHSHQGVRQLW\RXPXVW127GHFODUHD5HPRWH([FHSWLRQ
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
*MIV\PQVO[aW]KIVLWQVPWUMJ][QVM[[UM\PWL[
8VH\RXU(QWLW\&RQWH[WWR
JHWDUHIHUHQFHWR\RXUKRPH e the
canÕt do becaus
JHWDUHIHUHQFHWR\RXU(-%REMHFW two things youING an entity! The
JHW\RXUSULPDU\NH\ bean isnÕt BE pool acting on behalf
bean is in the entities of this type,
JHWVHFXULW\LQIRUPDWLRQDERXWWKHFOLHQW of ALL the e particular entity. So
IRUFHDWUDQVDFWLRQWRUROOEDFN &07 but not any onno EJB object and of
EHDQV the bean has imary key.
ILQGRXWLIWKHWUDQVDFWLRQKDVDOUHDG\ course, no pr
EHHQVHWWRUROOEDFN &07EHDQV
JHWDWUDQVDFWLRQUHIHUHQFHDQGFDOO
PHWKRGVRQLW %07EHDQVRQO\VR
HQWLWLHVFDQ·WXVHWKLV
$FFHVV
\RXUVSHFLDO-1',HQYLURQPHQW
DQRWKHUEHDQ·VPHWKRGV
DUHVRXUFHPDQDJHU OLNHDGDWDEDVH
\RXDUHKHUH
HQWLW\EXVLQHVVPHWKRGV
6WDUWLQJDEXVLQHVVPHWKRG LQDWUDQVDFWLRQ
6FHQDULR FOLHQWZDQWVWRJHWWKHDGGUHVVRIDVSHFL¿F&03&XVWRPHUHQWLW\
JHW$GGUHVV FRQWH[W
(-%
REMHFW
HVV
W$GGU VWXE EHDQ
JH
+(/3
FOLHQW
EHDQ
FRQWH[W
HME$FWLYDWH
'%
&OLHQWFDOOVJHW$GGUHVV RQWKHVWXEIRUHQWLW\EHDQ
7KHFDOOLVSDVVHGWRWKH(-%REMHFW
7KH(-%REMHFWJHWVWKHFDOODQGSDQLFVEHFDXVHWKHUH,6QRHQWLW\EHDQIRU
7KH&RQWDLQHUVHHVWKDWWKLVPHWKRGQHHGVDWUDQVDFWLRQVRWKH&RQWDLQHUVWDUWVRQH
WKHQSXOOVDEHDQIURPWKHSRRODQGFDOOVHME$FWLYDWH RQWKHEHDQ
EHDQ
FRQWH[W
HME/RDG
6(/(&7
'%
7HOOGDWDEDVH
WRORFNURZ
7KH&RQWDLQHUWHOOVWKHGDWDEDVHWRORFNHQWLW\LQWKHGDWDEDVH7KH
&RQWDLQHUWKHQGRHVD6(/(&7RQWKHHQWLW\·VGDWD
7KH&RQWDLQHUSRSXODWHVWKHHQWLW\EHDQ·VSHUVLVWHQWILHOGVZLWKWKHUHDOHQWLW\GDWD
7KH&RQWDLQHUFDOOVHME/RDG RQWKHEHDQWRWHOOWKHEHDQ´<RX·YHMXVWEHHQORDGHGµ
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
&RPSOHWLQJDEXVLQHVVPHWKRG DQGDWUDQVDFWLRQ
6FHQDULR EHDQFRPSOHWHVDEXVLQHVVPHWKRGWKDWHQGVDWUDQVDFWLRQ
UHWXUQ FRQWH[W
(-%
REMHFW
XUQ
VWXE JHW$GGUHVV EHDQ
UHW
UHWXUQ
FOLHQW
EHDQ
FRQWH[W
'%
7KHJHW$GGUHVV PHWKRGLVSDVVHGWRWKHEHDQ ILQDOO\
7KHEHDQUHWXUQVIURPWKHPHWKRG
7KH(-%REMHFWVHQGVWKHUHWXUQEDFNWRWKHFOLHQW
EHDQ
FRQWH[W
HME6WRUH
83'$7(
'%
7UDQVDFWLRQ(QGV
7KH&RQWDLQHUFDOOVHME6WRUH WRWHOOWKHEHDQ´,·PDERXWWRWDNH\RXUSHUVLVWHQW XQORFNURZ
ILHOGVWDWHDQGXSGDWHWKHGDWDEDVHVREHVXUH\RXUVWDWHLVUHDG\µ
7KHUHDOHQWLW\LVXSGDWHGLQWKHGDWDEDVH
7KH&RQWDLQHUFRPPLWVWKHWUDQVDFWLRQDQGWHOOVWKHGDWDEDVHWRXQORFNWKHHQWLW\
\RXDUHKHUH
EHLQJDQHQWLW\EHDQ
%HLQJ-RKQ(QWLW\%HDQ
,WDOOVWDUWVZKHQWKH
FOLHQWFDOOVDEXVLQHVV 6RWKH
PHWKRGRQDQ(-%REMHFW &RQWDLQHUSKRQHV
IRU-RKQ0DOFRP7KH(-% EDFNWRWKHSRRO
REMHFWIUHDNVRXWEHFDXVH DQGVD\V´:HQHHG
WKHUH·VDFDOOEXWQRHQWLW\ DEHDQRXWKHUH
EHDQWRUXQWKHPHWKRG WRVHUYLFHDFOLHQW
PHWKRGµ
,PLJKWQRWEH %XWDIWHUWKDW,VWLOOQHHG
FRPSOHWHO\UHDG\ZKHQ,FRPH WRDVN´:KRDP,VXSSRVHG
RXWRIWKHSRROVRWKH&RQWDLQHU WREH"µDQGWKDW·VZKHQ,JHWWKH
FDOOVP\HME$FWLYDWH PHWKRG,W·V ´%HLQJ-RKQ0DOFRPµVFULSWZLWKDOORIP\
DFWXDOO\DSUHWW\XVHOHVVPHWKRGVR FKDUDFWHU·VLPSRUWDQWGDWD7KH&RQWDLQHU
,DOPRVWQHYHUGRDQ\WKLQJWKHUH%XW, FDOOVP\HME/RDG PHWKRGWRWHOOPHWKDW
VXSSRVH,PLJKWUHDFTXLUHD6RFNHWRU
,KDYHHYHU\WKLQJ,QHHGWRSOD\WKH
VRPHWKLQJ,GRQ·WZDQWWRKDQJRQWR UROHRI-RKQ0DOFRP$IWHUWKDW,·P
ZKLOH¶EHWZHHQSURMHFWV·%XWLW·VKDUG
LQFKDUDFWHUDQGUHDG\IRUDFWLRQ
IRUPHWRLPDJLQHDQ\WKLQJ,ZRXOGGR
LQHME$FWLYDWH WKDW,ZRXOGQ·W
UDWKHUGRLQVRPHRWKHU
PHWKRG
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
6KRZWLPH7KHFOLHQW·VEXVLQHVV
PHWKRGFDOOLVÀQDOO\SDVVHGWRPH
+H\ZLOOVRPHERG\WHOOP\SV\FKR $IWHUP\VWXQQLQJSHUIRUPDQFHDV
ERG\JXDUGWRUHOD[LW·VQRWHDV\ -RKQ0DOFRPWKH&RQWDLQHU ZKR
EHLQJEULOOLDQW\RXNQRZ WDNHVWKLVMREZD\WRRVHULRXVO\
FDOOVP\HME6WRUH PHWKRGWRVHHLI,·YH
FKDQJHGDQ\RI-RKQ·VLQWHUQDOVWDWHYDOXHV
:HOORI&2856(,KDYHWKLVFKDUDFWHU
WKURXJKPXFKWUDJHG\VXIIHULQJDQG
EXVLQHVVORJLFKDVJURZQDVDQHQWLW\
2I&2856(KH·VDGLIIHUHQWSHUVRQ
6R,VD\´'RQ·WJHW\RXU
NQLFNHUVLQDWZLVWKHUH·VWKH 7KHQLW·VRYHUDQG
GDWDµ WKH\DOODFWOLNHLW·VOLWHUDOO\ ,·PEDFNWRWKHSRRO
WKHHQGRIWKHZRUOGRYHUKHUHLIWKH %XWÀUVWWKH&RQWDLQHUFDOOV
GDWDEDVHGRHVQ·WNQRZHYHU\OLWWOH P\HME3DVVLYDWH PHWKRGWRWHOOPH
WKLQJWKDWKDSSHQVWRP\ WKDW,·PGRQHEHLQJ-RKQ0DOFRP
FKDUDFWHU DQGWKDWLW·VVDIHWRUHOHDVHDQ\
UHVRXUFHV,ZDVNHHSLQJRQKLV
EHKDOI,DOPRVWQHYHUXVHWKLV
PHWKRGEHFDXVHLW·VQRWDQ
HIÀFLHQWZD\WRPDQDJH
WKLQJV
\RXDUHKHUH
DFWLYDWLRQSDVVLYDWLRQ
$FWLYDWLRQSDVVLYDWLRQRID&03HQWLW\EHDQ
FOLHQW &RQWDLQHU
(-%
REMHFW '%
EHDQ
EXVLQHVVPHWKRG
HME$FWLYDWH
6(/(&7HQWLW\GDWD
SRSXODWHEHDQVWDWH
HME/RDG
EXVLQHVVPHWKRG
HME6WRUH
83'$7(HQWLW\GDWD
HME3DVVLYDWH
4HE #ONTAINER ALWAYS CALLS EJB,OAD AFTER EJB!CTIVATE
4HE #ONTAINER ALWAYS CALLS EJB3TORE BEFORE EJB0ASSIVATE
4HE #ONTAINER CAN CALL EJB3TORE AND EJB3TORE AT OTHER TIMES
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
6KDUSHQ \RXU SHQFLO
,I\RX¶UHWDNLQJWKHH[DPWUXVWXVKHUH\RX5($//<QHHGWRVWRSULJKWQRZ
DQGGRWKLVH[HUFLVHEHIRUHWXUQLQJWKHSDJH7KLQNDERXWHYHU\WKLQJ\RX¶YH
OHDUQHGLQWKLVFKDSWHUDERXWWKHOLIHF\FOHRIDQHQWLW\EHDQHVSHFLDOO\KRZ
DQGZKHQLWFRPHVRXWRIWKHSRROWREHFRPHDQHQWLW\
7DNH\RXUEHVWJXHVVDERXWZKLFKDVSHFWVRIEHDQQHVVDUHDYDLODEOHGXULQJ
HDFKRIWKHIRXUFRQWDLQHUFDOOEDFNVIRUHME$FWLYDWH HME3DVVLYDWH
8VH\RXU(QWLW\&RQWH[WWR
HME$FWLYDWH HME3DVVLYDWH HME/RDG HME6WRUH
T T T T JHWDUHIHUHQFHWR\RXUKRPH
T T T T JHWVHFXULW\LQIRUPDWLRQDERXWWKHFOLHQW
T T T T IRUFHWKHWUDQVDFWLRQWRUROOEDFN
T T T T ILQGRXWLIWKHWUDQVDFWLRQKDVDOUHDG\EHHQVHWWRUROOEDFN
T T T T JHWDUHIHUHQFHWR\RXU(-%REMHFW
T T T T JHW\RXUSULPDU\NH\
$FFHVV
HME$FWLYDWH HME3DVVLYDWH HME/RDG HME6WRUH
T T T T PHWKRGVRIDQRWKHUEHDQ
T T T T \RXUVSHFLDO-1',FRQWH[W
T T T T DUHVRXUFHPDQDJHU OLNHDGDWDEDVH
\RXDUHKHUH
DFWLYDWLRQSDVVLYDWLRQ
*MIV\PQVO[aW]KIVLWL]ZQVOIK\Q^I\QWVIVLTWILQVO
WLPHOLQH
HME$FWLYDWH HME/RDG
8VH\RXU(QWLW\&RQWH[WWR 8VH\RXU(QWLW\&RQWH[WWR
JHWDUHIHUHQFHWR\RXUKRPH JHWDUHIHUHQFHWR\RXUKRPH
JHWDUHIHUHQFHWR\RXU(-%REMHFW JHWDUHIHUHQFHWR\RXU(-%REMHFW
JHW\RXUSULPDU\NH\ JHW\RXUSULPDU\NH\
JHWVHFXULW\LQIRUPDWLRQDERXWWKHFOLHQW JHWVHFXULW\LQIRUPDWLRQDERXWWKHFOLHQW
IRUFHDWUDQVDFWLRQWRUROOEDFN &07 IRUFHDWUDQVDFWLRQWRUROOEDFN &07
EHDQV EHDQV
ILQGRXWLIWKHWUDQVDFWLRQKDVDOUHDG\ ILQGRXWLIWKHWUDQVDFWLRQKDVDOUHDG\
EHHQVHWWRUROOEDFN &07EHDQV EHHQVHWWRUROOEDFN &07EHDQV
JHWDWUDQVDFWLRQUHIHUHQFHDQGFDOO JHWDWUDQVDFWLRQUHIHUHQFHDQGFDOO
PHWKRGVRQLW %07EHDQVRQO\VR PHWKRGVRQLW %07EHDQVRQO\VR
HQWLWLHVFDQ·WXVHWKLV HQWLWLHVFDQ·WXVHWKLV
$FFHVV $FFHVV
\RXUVSHFLDO-1',HQYLURQPHQW \RXUVSHFLDO-1',HQYLURQPHQW
DQRWKHUEHDQ·VPHWKRGV DQRWKHUEHDQ·VPHWKRGV
DUHVRXUFHPDQDJHU OLNHDGDWDEDVH DUHVRXUFHPDQDJHU OLNHDGDWDEDVH
that
C on t ai ne r prefers (no, makebean Now we can d
T he if you access a
INSISTS) thatmanager, you must be in entity bean CAo Neverything that an
or a resource transaction contextÕ, so we can do in a bu do... the same things
a Ômeaningful is too early. But once you think of this as siness method. You can
ejbActivate() d(), youÕre IN a transaction business method. the beginning of the
get to ejbLoatold the Container NOT
(unless youÕve nsaction... which is for very
to use a tra ly).
special cases on
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
*MIV\PQVO[aW]KIVLWL]ZQVOXI[[Q^I\QWVIVL[\WZQVO
WLPHOLQH
HME3DVVLYDWH HME6WRUH
8VH\RXU(QWLW\&RQWH[WWR 8VH\RXU(QWLW\&RQWH[WWR
JHWDUHIHUHQFHWR\RXUKRPH JHWDUHIHUHQFHWR\RXUKRPH
JHWDUHIHUHQFHWR\RXU(-%REMHFW JHWDUHIHUHQFHWR\RXU(-%REMHFW
JHW\RXUSULPDU\NH\ JHW\RXUSULPDU\NH\
JHWVHFXULW\LQIRUPDWLRQDERXWWKHFOLHQW JHWVHFXULW\LQIRUPDWLRQDERXWWKHFOLHQW
IRUFHDWUDQVDFWLRQWRUROOEDFN &07 IRUFHDWUDQVDFWLRQWRUROOEDFN &07
EHDQV EHDQV
ILQGRXWLIWKHWUDQVDFWLRQKDVDOUHDG\ ILQGRXWLIWKHWUDQVDFWLRQKDVDOUHDG\
EHHQVHWWRUROOEDFN &07EHDQV EHHQVHWWRUROOEDFN &07EHDQV
JHWDWUDQVDFWLRQUHIHUHQFHDQGFDOO JHWDWUDQVDFWLRQUHIHUHQFHDQGFDOO
PHWKRGVRQLW %07EHDQVRQO\VR PHWKRGVRQLW %07EHDQVRQO\VR
HQWLWLHVFDQ·WXVHWKLV HQWLWLHVFDQ·WXVHWKLV
$FFHVV $FFHVV
\RXUVSHFLDO-1',HQYLURQPHQW \RXUVSHFLDO-1',HQYLURQPHQW
DQRWKHUEHDQ·VPHWKRGV DQRWKHUEHDQ·VPHWKRGV
DUHVRXUFHPDQDJHU OLNHDGDWDEDVH DUHVRXUFHPDQDJHU OLNHDGDWDEDVH
By the time the Container starts to
passivate you, youÕre no longer associated FYI -- this page is EXAC Y
with a client or a transaction same as the previous one onTL
act
the
ivat
and loading. (except for the not ion
ainer
w it h ej bA ct ivate(), the Conttion made). The rules for whatÕs allo es we
Just as it was you in a Ômeaningful transac a activation are the same for pas wed during
no longer has her words, you canÕt be in t a and the rules for loading are idesivation,
contextÕ (in ot this point), so you canÕt ge . The the rules for storing. ntical to
transaction ata bean or a resource managerhis
reference to itÕs too dangerous to do t Õ. (see
Container says ningful transaction context
without a Ômeaions chapter)
the transact
\RXDUHKHUH
FRPPLWRSWLRQV
&RPPLWRSWLRQV ZKDW5($//<KDSSHQV
WRDEHDQDIWHUDWUDQVDFWLRQFRPPLWV"
(the previous pictures are just ONE way it could
work, but there are two other ways)
&RPPLWRSWLRQ$ $
7KHEHDQVWD\VUHDG\DWWDFKHGWRWKH(-%REMHFWORDGHG %HDQVWD\VFRQQHFWHGDQGLQV\QF
ZLWKGDWDEXW127LQDWUDQVDFWLRQ7KH&RQWDLQHUNHHSVWKH :KHQWKHQH[WEXVLQHVVPHWKRGFDOO
HQWLW\ORFNHGVRWKDWQRERG\FDQFKDQJHWKHEHDQ·VVWDWH FRPHVLQWRWKHEHDQLWMXVWUXQV1R
:KHQDFOLHQWFDOOVDEXVLQHVVPHWKRGRQWKLVHQWLW\EHDQ·V HME$FWLYDWH QRHME/RDG
(-%
(-%REMHFWWKH&RQWDLQHUGRHV127GRDQHME$FWLYDWH RU REMHFW
HME/RDG DQGDVVXPHVWKHEHDQ·VGDWDLVVWLOOLQV\QFZLWK 'DUNR 'RQQ\
WKHXQGHUO\LQJSHUVLVWHQWVWRUH
ys locked
EHDQ entity sta
&RPPLWRSWLRQ% %
7KHEHDQVWD\VDWWDFKHGWRWKH(-%REMHFWORDGHGZLWK %HDQVWD\VFRQQHFWHGEXWQRWLQV\QF
GDWDEXWWKHEHDQ·VVWDWHLVPDUNHGDV¶LQYDOLG·,QRWKHU :KHQWKHQH[WEXVLQHVVPHWKRGFDOO
ZRUGVWKH&RQWDLQHUNQRZVWKDWWKHEHDQPLJKWEHFRPH FRPHVLQWRWKHEHDQHME/RDG LV
VWDOHEHWZHHQQRZDQGWKHQH[WWLPHDFOLHQWLQYRNHV FDOOHG %XWQRHME$FWLYDWH
(-%
DPHWKRGRQWKLVEHDQVRWKH&RQWDLQHUZLOOGRDQ REMHFW
HME/RDG ZKHQDQHZEXVLQHVVPHWKRGFRPHVLQIRUWKLV 'DUNR 'RQQ\
HQWLW\ %XWQRHME$FWLYDWH
bean
EHDQ
lock is released, butthe pool
doesnÕt go back to
&RPPLWRSWLRQ& &
7KHEHDQLVSDVVLYDWHGDQGSXWEDFNLQWRWKHSRRO7KH %HDQLVGLVFRQQHFWHGIURPWKH(-%
QH[WWLPHDFOLHQWFDOOVDEXVLQHVVPHWKRGRQWKLVHQWLW\ REMHFWDQGJRHVEDFNWRWKHSRRO:LWK
HYHU\WKLQJZH·YHVHHQLQWKLVFKDSWHUKDSSHQV³DEHDQ (-%
WKHQH[WEXVLQHVVPHWKRGFDOOWRWKLV
FRPHVRXWRIWKHSRROLVDFWLYDWHGWKHORDGHGDQG REMHFW EHDQWKH&RQWDLQHUSXOOVDEHDQRXWRI
ILQDOO\WKHEXVLQHVVPHWKRGLWSDVVHGWRWKHEHDQ WKHSRROWKHQFDOOVHME$FWLYDWH DQG
HME/RDG
'DUNR 'RQQ\
322/
goes
EHDQ lock is released, bean
back to the pool
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
there are no
Dumb Questions
Q: (OW DOES THESE COMMIT
CREATED THAT THEN STAYS STUCK TO
THE %*" OBJECT !RENT POOLS MORE
SUPPOSED TO ASSUME THAT THIS IS
INDEED HOW IT WORKS WHEN A CLIENT
OPTIONS AFFECT ME $O ) NEED TO EFlCIENT BECAUSE YOU NEED ONLY WANTS AN ENTITY BEAN EITHER THROUGH
KNOW WHICH ONE MY #ONTAINER IS ENOUGH BEANS TO SERVICE THE ACTUAL A CREATE OR FIND THE #ONTAINER MAKES
CHOOSING $O ) GET A CHOICE IN
PROGRESS METHODS AN %*" OBJECT FOR THAT ENTITY hHERES
THE %*" OBJECT FOR HERES THE
%*" OBJECT FOR v ETC !ND AS A
A: !CCORDING TO THE SPECIFICATION
YOUR VENDOR IS FREE TO USE ANY OF THE
A: .O CONTAINER WORTH
CONFIGURING WOULD LEAVE YOU STUCK
"EAN 0ROVIDER AS OPPOSED TO SAY A
CONTAINERSERVER PROVIDER YOU ARE TO
THREE OPTIONS 9OUR CONTAINER MIGHT LET WITH A CONSTANTLY ENDLESSLY GROWING PROGRAM AS IF THATS REALLY THE WAY IT
YOU CHOOSE OR TUNE THE OPTION BUT ACCUMULATION OF OBJECTS %VEN A WORKS
DONT ALWAYS COUNT ON IT "UT DO YOU CONTAINER THAT DOES USE OPTION ! "UT INTERNALLY THE #ONTAINER MIGHT
NEED TO KNOW WHICH IS BEING USED CAN USE SOMETHING LIKE A ,25 ,EAST BE DOING SOMETHING QUITE DIFFERENT
2ECENTLY 5SED ALGORITHM TO SAY TO FROM THE CONCEPTUAL ARCHITECTURAL
9OU CAN SEE WHERE THE TRADE
OFFS ARE
ITSELF h(MMM NOBODY HAS CALLED A VIEW )MAGINE THAT 9/5 WERE A
OF COURSEIF YOU KEEP THE ENTITY
METHOD ON ENTITY FOR A LONG TIME CONTAINER DEVELOPERHOW WOULD YOU
LOCKED IN THE DATABASE NO OTHER
SO )LL PASSIVATE THAT BEAN AND PUT HIM IMPLEMENT THINGS
APPLICATIONS CAN USE THAT ENTITYS
BACK IN THE POOL AND UNLOCK THE ROW v
DATA 4HATS FINE IF THE %*" IS THE ONLY /NE IDEA MIGHT BE TO PUT THE BURDEN
"UT WITH AT LEAST THE OPTION OF USING
APPLICATION THAT NEEDS THAT DATABASE ON THE CLIENTS BY KEEPING ALL THE
OPTION ! A CONTAINER CAN SAY TO ITSELF
!ND THAT OPTION COMMIT OPTION INFORMATION IN THE STUBS &OR EXAMPLE
h4HIS ENTITY IS REALLY POPULAR
! GIVES YOU THE BEST PERFORMANCE WHEN THE CLIENT GETS A STUB TO AN
)TS A BIG PAIN TO KEEP GOING TO THE
WHEN A BUSINESS METHOD CALL COMES %*" OBJECT YOU CAN MAKE SURE THAT
DATABASE AND DOING THE WHOLE LOAD
IN FOR THE ENTITY BECAUSE THERES THE STUB KNOWS THE UNIQUE )$ FOR
STOREACTIVATEPASSIVATE CYCLE EACH
NO EJB!CTIVATE THE BEAN NEVER THE ENTITY IE THE PRIMARY KEY "UT
TIME SO )LL JUST KEEP HIM LOADED AND
WENT BACK TO THE POOL AND MORE THE %*" OBJECTS MIGHT BE GENERIC
READY EVEN BETWEEN TRANSACTIONSv
SIGNIFICANTLYTHERES NO TRIP TO THE IN SUCH A WAY THAT WHEN THE CLIENT
DATABASE OR AN EJB,OAD
Q: /H MAN ) JUST THOUGHT OF
CALLS A METHOD ON A STUB THAT STUB IS
CONNECTED NOT TO AN %*" OBJECT JUST
FOR THAT ENTITY BUT RATHER A ONE
%*"
Q: "UT COULDNT OPTION ! REALLY
SOMETHING 2%!,,9 BAD WITH THIS
ARCHITECTUREEVEN IF YOU DO ./4
KEEP ACCUMULATING ENTITY BEANS
OBJECT
FITS
ALL THAT KNOWS HOW TO MAKE
SURE THE METHOD ENDS UP AT THE RIGHT
KILL ME IF ) WANT TO KEEP THE ENTITIES
WHAT ABOUT THE %*" OBJECTS $ONT ENTITY 4HAT WAY WHEN A CLIENT ISNT
UNLOCKED IN THE DATABASE WHEN
THEY JUST KEEP GROWING AND GROWING USING AN %*" OBJECT THAT %*" OBJECT
THEYRE NOT BEING USED BY THE BEAN
SO THAT EACH TIME A CLIENT DOES A lND ISNT SITTING AROUND WASTING SPACE
AND GETS BACK A STUB AN %*" OBJECT 4HATS JUST ONE IDEA
A: &OR THIS REASON MOST VENDORS IS CREATED FOR THAT ENTITY AND IT JUST
WONT USE OPTION ! AS A DEFAULT
THEY ALLOW IT ONLY IF THE DEPLOYER OR
STAYS AROUND UNTIL THE ENTITY ITSELF
IS REMOVED !T ANY GIVEN TIME ) WILL
Q: 4HAT MIGHT BE lNE FOR STUBS
BUT WHAT IF THE CLIENT IS LOCAL 4HEN
ADMIN CHOOSES IT ASSUMING ITS EVEN HAVE ALL THE %*" OBJECTS ON THE HEAP
THEY HAVE A REAL REFERENCE TO THE
SUPPORTED AT ALL THAT REPRESENT EVERY ENTITY ANYONE
%*" OBJECT SO THAT %*" OBJECT WOULD
HAS EVER ACCESSED UP TO THAT POINT
(!6% TO BE ENTITY
SPECIlC
Q: ) SEE ANOTHER POSSIBLY EVEN
7/23% PROBLEM WITH OPTION !
DOESNT THIS MEAN A CONTINUALLY
A: !H NOW WE COME TO THE
DIFFERENCE BETWEEN THE hCONCEPTUALv
A: 9ES THATS TRUE "UT WITH
LOCAL CLIENTS NORMAL *AVA GARBAGE
GROWING HEAP FULL OF OBJECTS ,IKE VIEW OF THE ARCHITECTURE AND THE
COLLECTION WORKS 7HEN THERE ARE NO
EACH TIME SOMEONE USES A PARTICULAR hACTUALv IMPLEMENTATION
CLIENTS WITH REFERENCES TO A PARTICULAR
ENTITY AN ENTITY BEAN INSTANCE IS
!CCORDING TO THE SPEC YOURE %*" OBJECT THE INSTANCE WILL DIE
\RXDUHKHUH
FRPPLWRSWLRQV
there are no
Dumb Questions
Q: 7HICH OF THE THREE COMMIT
STILL DANGEROUS BECAUSE ENTITIES ARE
PERSISTENT 3O THE VENDOR STILL MUST
YOURE DOING MORE LOADSSTORES THAN
YOU NEED TO SO THE KEY IS TO HAVE YOUR
OPTIONS DO YOU THINK IS MOST USED IMPLEMENT SOMETHING THAT SAVES THE TRANSACTIONS BE AS LONG AS YOU NEED
STATE OF THE ENTITIES TO THE DATABASE AND NO LONGER
IF THEY CHANGE 3O THERE WILL STILL BE
A: 7ELL WE CANT REALLY ANSWER STORING IF NOT LOADING
THAT BUT IF WE WERE IN A BETTING MOOD
OUR MONEY WOULD BE ON OPTION " !
4HERE ARE STILL OTHER POTENTIAL PROB
LEMS WITH OPTION ! THOUGH &OR
Q: /NE MORE THING DOESNT
@SMART OPTION " THAT KNOWS WHEN IT EXAMPLE YOU MIGHT HAVE A SERVER THIS MEAN THAT EJB0ASSIVATE AND
MAKES SENSE TO HANG ON TO A BEAN THAT SUPPORTS CLUSTERING AND THE EJB!CTIVATE MIGHT NOT EVER BE CALLED
AND WHEN IT DOESNT "UT AVOIDING THE SERVER WILL HAVE TO BE CERTAIN THAT ALL ON A BEAN IF THE CONTAINER USES
EJB!CTIVATE WHICH IS USUALLY USELESS INSTANCES OF THAT ENTITY BEAN IN SYNC OPTION ! OR " !ND DOESNT THIS MEAN
ANYWAY IS A 'OOD 4HING NOT JUST WITH THE DATABASE BUT WITH THAT ) SHOULDNT RELY ON EJB!CTIVATE
ONE ANOTHER "UT THATS ANOTHER ISSUE OR EJB0ASSIVATE IN MY DESIGN
Q: "UT ISNT THE HIT TO THE
9OULL LEARN MORE IN THE PATTERNS AND
PERFORMANCE CHAPTER
A: 9%3 4HATS %8!#4,9 WHAT IT
DATABASETHE LOADA MUCH BIGGER
HIT THAN JUST ONE MORE METHOD CALL MEANS )TS USUALLY A LOUSY STRATEGY "UT
ON THE STACK
Q: 3O IS THE REAL POINT OF ALL THIS
YOU CAN IMAGINE HOW IT MIGHT SOUND
LIKE A GOOD IDEA
THE FACT THAT AS LONG AS YOURE IN A
A: &IRST OF ALL ACTIVATION IS
PROBABLY A LITTLE MORE THAN JUST
TRANSACTION YOU WONT HAVE ALL THESE
LOADSTORE ACTIVATEPASSIVATE CALLS
ONE MORE METHOD CALL ON THE STACK
8PUHPHPEHUKRZ,
BECAUSE THERES OVERHEAD JUST IN
MAINTAINING THE ORGANIZATION OF THE
POOL ITSELF "UT YES YOURE RIGHT ABOUT
A: 9ES A BIG PART OF THE POINT
ANYWAY
WROG\RXLWZRXOGEHPRUH
HIÀFLHQWWRJHWUHVRXUFHV
LQHME$FWLYDWHDQGUHOHDVHWKHP
THE DATABASE HIT BEING A BIGGER DEAL LQHME3DVVLYDWH"&DQZHMXVW
"UT THERES ALL SORTS OF WAYS THE SUHWHQGWKDW,QHYHUVDLG
#ONTAINER CAN OPTIMIZE AND WHATS
THE ALTERNATIVE 4HE ONLY ALTERNATIVE
OPTION ! KEEPS THE DATABASE LOCKED
Q: 4HEN SHOULDNT YOUR GOAL BE
WKDW"
TO HAVE THE LONGEST TRANSACTIONS
WHICH IS TYPICALLY NOT WHAT YOU WANT
Q: "UT WHAT IF MY %*" APP )3 THE
A: 9OU ARENT BEING SERIOUS RIGHT
*UST FOR FUN WELL PRETEND YOU ARE AND
ONLY THING THAT USES THAT DATABASE
SAY ./ ./ ./ ./ 4HINK ABOUT YOUR
CONCURRENCY ! GOOD RULE OF THUMB
A: ) THINK WE MENTIONED THIS
EARLIERIF YOU KNOW ABSOLUTELY
WITH A ZILLION EXCEPTIONS OF COURSE SO
ALL RULE
OF
THUMB DISCLAIMERS APPLY IS
THAT TRANSACTIONS SHOULD BE NO LONGER
POSITIVELY NO QUESTION THAT YOUR %*" THAN ABSOLUTELY NECESSARY 4HE LONGER
APP IS THE ONLY THING TOUCHING THAT YOUR BEAN IS IN A TRANSACTION THE MORE
DATABASE THEN YES IF YOUR VENDOR LIKELY IT IS THAT OTHERS ARE WAITING IN
SUPPORTS IT YOULL HAVE BETTER LINE TO GET TO THAT ENTITY /F COURSE
PERFORMANCE WITH OPTION ! /F COURSE
CACHING THINGS IN MEMORY IS ITS ALSO POSSIBLE TO HAVE TRANSACTIONS
WHICH ARE TOO SHORT WHICH MEANS
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
([HUFLVH &03HQWLW\EHDQ&UHDWLRQ
)LOOLQWKHILYHPLVVLQJDUURZODEHOVIRUWKHREMHFWLQWHUDFWLRQ
GLDJUDP5HPHPEHUWKH\DUHQ·WQHFHVVDULO\PHWKRGFDOOV7KLV
LVH[DFWO\WKHVDPHGLDJUDPWKDW\RXVDZHDUOLHULQWKHFKDSWHU
([FHSW\RXUVZLOOORRNQLFHUEHFDXVH\RX·OOSUREDEO\PDNHLWDOO
IDQF\ZLWKH[RWLFV\PEROVDQGPD\EHFRORUFRGHGPDUNHUVDQG
FOLHQW
+RPH (-%
REMHFW REMHFW '%
EHDQ
FUHDWH
\RXDUHKHUH
HQWLW\EHDQH[HUFLVH
(QWLW\%HDQ%XVLQHVV0HWKRG
([HUFLVH ZLWKDFWLYDWLRQ SDVVLYDWLRQ
7KLVWLPH\RX·UHJRQQDGUDZWKHDUURZV\RXUVHOI$VVXPHWKDWWKHEHDQLVLQWKHSRRODWWKH
WLPHWKHFOLHQWFDOOVDEXVLQHVVPHWKRG ZKLFKDOVRPHDQVWKHEHDQLVQRWLQDWUDQVDFWLRQ
'UDZDUURZVDQGODEHOWKHPZLWKWKHDFWLRQVWKDWRFFXUWKURXJKWKHFRPSOHWLRQRIWKH
EXVLQHVVPHWKRG6KRZZKDWKDSSHQVZKHQWKHEHDQUHWXUQVWRWKHSRRO
:KHQZHGLGLWWKHUHZHUHHLJKWPRUHDUURZVEXW\RXPLJKWKDYHPRUHRUOHVVGHSHQGLQJ
RQKRZ\RXZDQWWRGRLW'R127IOLSEDFNWKURXJKWKHPRVWUHFHQWSDJHV<RXFDQGRWKLV
FOLHQW &RQWDLQHU
(-%
REMHFW '%
EHDQ
EXVLQHVVPHWKRG
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
)LOOLQWKH3URGXFW%HDQ80/LVKER[ZLWKWKHPHWKRGVWKDW<28PXVWZULWH
LQ\RXUEHDQFODVVJLYHQWKHFRPSRQHQWDQGKRPHLQWHUIDFHV'RQ·WIRUJHW
WKHFRQWDLQHUFDOOEDFNVIURP(QWLW\%HDQDOWKRXJKZH·YHVKRZQ\RXRQO\
([HUFLVH WKUHHRIWKHVHYHQ7KHUHVW\RX·OOKDYHWRUHPHPEHUDQGILOOLQ
LQWHUIDFH!!
3URGXFW 3URGXFW%HDQ
JHW3URGXFW'HVFULSWLRQ
JHW4XDQWLW\
JHW3ULFH
LQWHUIDFH!!
(QWLW\%HDQ
HME$FWLYDWH
HME5HPRYH
XQVHW(QWLW\&RQWH[W
LQWHUIDFH!!
3URGXFW+RPH
FUHDWH 6WULQJ,'6WULQJSULFH6WULQJGHVFULSWLRQ
ILQG%\3ULPDU\.H\ 6WULQJNH\
JHW/RZ,QYHQWRU\ LQWOLPLW
\RXDUHKHUH
FRIIHHFUDPPRFNH[DP
0RFN([DP
7HATS TRUE FOR A BEAN PROVIDER WHEN CREATING AN ENTITY BEAN USING CONTAINER
1 MANAGED PERSISTENCE #HOOSE ALL THAT APPLY
R! #ONTAINER
MANAGED PERSISTENT lELDS MUST BE DElNED IN THE ENTITY BEAN
CLASS
R" #ONTAINER
MANAGED RELATIONSHIP lELDS MUST BE DElNED IN THE ENTITY
BEAN CLASS
R# 7HEN IMPLEMENTING A ONE
TO
MANY RELATIONSHIP THE JAVAUTIL,IST
INTERFACE MUST NOT BE USED
R$ !CCESSOR METHODS FOR CONTAINER
MANAGED RELATIONSHIP lELDS MUST BE
EXPOSED IN THE BEANS REMOTE COMPONENT INTERFACE
7HICH OF THE FOLLOWING IS A LEGAL ACCESSOR METHOD FOR A PERSISTENT lELD IN AN
2 ENTITY BEAN WITH CONTAINER
MANAGED PERSISTENCE #HOOSE ALL THAT APPLY
R! SXEOLFJHW&XVWRPHU1XP
R" SXEOLFYRLGJHW&XVWRPHU1XP
R# DEVWUDFWYRLGJHW&XVWRPHU1XP
R$ SXEOLFDEVWUDFWLQWJHW&XVWRPHU1XP
7HICH OF THE FOLLOWING ARE LEGAL ACCESSOR METHODS IN AN ENTITY BEAN WITH
3 CONTAINER
MANAGED PERSISTENCE #HOOSE ALL THAT APPLY
R! SXEOLFDEVWUDFWLQW*HW&XVWRPHU1XP
R" SXEOLFDEVWUDFWLQWJHWFXVWRPHU1XP
R# SXEOLFDEVWUDFWLQWJHW&XVWRPHU1XP
R$ SXEOLFDEVWUDFWLQWJHW&XVWRPHU1XP ^`
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
7HICH ARE REQUIREMENTS FOR A #-0 ENTITY BEAN CLASS #HOOSE ALL THAT APPLY
4
R! 4HE CLASS MUST DElNE A ¿QDOL]H METHOD
R" 4HE SOURCE lLE MUST DElNE AT LEAST ONE CONSTRUCTOR
R# 4HE CLASS MUST BE DECLARED PUBLIC AND ABSTRACT
R$ 4HE CLASS MUST IMPLEMENT DIRECTLY OR INDIRECTLY THE
MDYD[HME(QWHUSULVH%HDQ INTERFACE
R% !LL GETTER AND SETTER METHODS FOR THE BEANS ABSTRACT PERSISTENCE
SCHEMA MUST BE ABSTRACT
7HICH ARE LEGAL DECLARATIONS FOR A #-0 BEANS EJB#REATE METHODS #HOOSE
5 ALL THAT APPLY
R! SXEOLFYRLGHME&UHDWH%LJ&XVWRPHU WKURZV
MDYD[HME&UHDWH([FHSWLRQ
R" SXEOLF6WULQJHME&UHDWH$FFRXQW WKURZV
MDYD[HME&UHDWH([FHSWLRQ
R# VWDWLF6WULQJHME&UHDWH WKURZV
MDYD[HME&UHDWH([FHSWLRQ
R$ SXEOLFLQWHME&UHDWH WKURZV
MDYD[HME&UHDWH([FHSWLRQ
R% SXEOLF¿QDO6WULQJHME&UHDWH WKURZV
MDYD[HME&UHDWH([FHSWLRQ
7HICH ARE LEGAL DECLARATIONS FOR A METHOD IN A #-0 BEAN #HOOSE ALL THAT
6 APPLY
R! SXEOLF$FFRXQWHME6HOHFW$FFW ORQJ[ WKURZV
MDYD[HME)LQGHU([FHSWLRQ
R" SXEOLFDEVWUDFW$FFWHME6HOHFW$FFW ORQJ[ WKURZV
MDYD[HME)LQGHU([FHSWLRQ
R# SXEOLF$FFRXQWHME3RVW&UHDWH $FFWNH\ WKURZV
MDYD[HME&UHDWH([FHSWLRQ
R$ SXEOLFYRLGHME3RVW&UHDWH $FFWNH\ WKURZV
MDYD[HME&UHDWH([FHSWLRQ
R% SXEOLFVWDWLFYRLGHME3RVW&UHDWH $FFWNH\ WKURZV
MDYD[HME&UHDWH([FHSWLRQ
\RXDUHKHUH
FRIIHHFUDPPRFNH[DP
7HICH METHODS FROM THE %NTITY#ONTEXT INTERFACE CAN BE INVOKED FROM
7 WITHIN THE SET%NTITY#ONTEXT METHOD #HOOSE ALL THAT APPLY
R! JHW(-%2EMHFW
R" JHW(-%/RFDO+RPH
R# JHW&DOOHU,GHQWLW\
R$ JHW&DOOHU3ULQFLSDO
R% VHW5ROOEDFN2QO\
7HICH CAN BE CALLED ON A #-0 BEAN TO TRANSITION IT FROM THE READY STATE TO THE
8 POOLED STATE #HOOSE ALL THAT APPLY
R! HME6WRUH
R" HME&UHDWH
R# HME6HOHFW
R$ HME5HPRYH
R% HME3DVVLYDWH
7HICH METHODS FROM THE %NTITY#ONTEXT INTERFACE CAN BE INVOKED FROM
9 WITHIN THE EJB#REATE METHOD #HOOSE ALL THAT APPLY
R! JHW(-%+RPH
R" JHW(-%2EMHFW
R# JHW&DOOHU3ULQFLSDO
R$ JHW8VHU7UDQVDFWLRQ
R% VHW5ROOEDFN2QO\
7HAT IS TRUE FOR A #-0 BEAN IN THE READY STATE
10
R! )TS HME/RDG CAN BE CALLED DIRECTLY AFTER EJB3TORE
R" )TS HME6WRUH CAN BE CALLED DIRECTLY AFTER A BUSINESS METHOD
R# /NE OF ITS BUSINESS METHODS CAN BE CALLED DIRECTLY AFTER EJB3TORE
R$ .ONE OF THE ABOVE
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
7HICH METHODS FROM THE %NTITY#ONTEXT INTERFACE MUST ./4 BE INVOKED
11 FROM WITHIN THE EJB,OAD METHOD #HOOSE ALL THAT APPLY
R! JHW(-%+RPH
R" JHW(-%2EMHFW
R# JHW&DOOHU3ULQFLSDO
R$ JHW8VHU7UDQVDFWLRQ
R% VHW5ROOEDFN2QO\
7HICH METHOD CALLED ON A #-0 BEAN IS !,7!93 ASSOCIATED WITH A STATE
12 CHANGE IN THE BEAN #HOOSE ALL THAT APPLY
R! HME/RDG
R" HME)LQG
R# HME5HPRYH
R$ HME$FWLYDWH
R% XQVHW(QWLW\&RQWH[W
7HATS TRUE ABOUT AN #-0 ENTITY BEANS PRIMARY KEY #HOOSE ALL THAT APPLY
13
R! 4HE BEANS PRIMARY KEY CLASS MUST PROVIDE A SUITABLE IMPLEMENTATION OF
THE HASH#ODE AND EQUALS METHODS
R" 7HEN SPECIFYING THE PRIMARY KEY IN THE DEPLOYMENT DESCRIPTOR ONLY
THE lELD NAME MUST BE DECLARED
R# !LL lELDS IN THE PRIMARY KEY CLASS MUST BE DECLARED PUBLIC
R$ !LL lELDS USED IN THE PRIMARY KEY MUST BE CONTAINER
MANAGED lELDS
(OW MANY EJB#REATE METHODS CAN A #-0 ENTITY BEAN HAVE
14
R!
R"
R# OR
R$ TO MANY
R% TO MANY
\RXDUHKHUH
FRIIHHFUDPPRFNH[DP
7HICH METHODS ARE ALWAYS INVOKED IN DIRECT RESPONSE TO A CLIENT OPERATION
15 #HOOSE ALL THAT APPLY
R! HME/RDG
R" HME&UHDWH
R# HME5HPRYH
R$HME$FWLYDWH
R% HME3DVVLYDWH
R& VHW(QWLW\&RQWH[W
7HICH ADDITIONAL METHODS MIGHT THE CONTAINER CALL WHEN INVOKING
16 EJB2EMOVE #HOOSE ALL THAT APPLY
R! HME)LQG
R" HME/RDG
R# HME6WRUH
R$ HME$FWLYDWH
R% HME3DVVLYDWH
!T WHAT POINTS MUST THE CONTAINER ESTABLISH A #-0 BEANS PRIMARY KEY
17 #HOOSE ALL THAT APPLY
R! BEFORE CALLINGQHZ,QVWDQFH
R"BEFORE CALLING VHW(QWLW\&RQWH[W
R# BEFORE CALLINGHME&UHDWH
R$ BEFORE CALLINGHME3RVW&UHDWH
7HICH METHODS RUN IN THE TRANSACTION CONTEXT OF THE METHOD THAT CAUSES
18 THEIR INVOCATION #HOOSE ALL THAT APPLY
R! HME/RDG
R" HME5HPRYH
R# HME6HOHFW
R$ HME$FWLYDWH
R% HME3DVVLYDWH
R& VHW(QWLW\&RQWH[W
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
0RFN([DP$QVZHUV
7HATS TRUE FOR A BEAN PROVIDER WHEN CREATING AN ENTITY BEAN USING CONTAINER
1 MANAGED PERSISTENCE #HOOSE ALL THAT APPLY
R! #ONTAINER
MANAGED PERSISTENT lELDS MUST BE DElNED IN THE ENTITY BEAN
CLASS
R" #ONTAINER
MANAGED RELATIONSHIP lELDS MUST BE DElNED IN THE ENTITY
BEAN CLASS
Collection
R# 7HEN IMPLEMENTING A ONE
TO
MANY RELATIONSHIP THE JAVAUTIL,IST - OnlySet can be used
INTERFACE MUST NOT BE USED
or
R$ !CCESSOR METHODS FOR CONTAINER
MANAGED RELATIONSHIP lELDS MUST BE
EXPOSED IN THE BEANS REMOTE COMPONENT INTERFACE
7HICH OF THE FOLLOWING IS A LEGAL ACCESSOR METHOD FOR A PERSISTENT lELD IN AN
2 ENTITY BEAN WITH CONTAINER
MANAGED PERSISTENCE #HOOSE ALL THAT APPLY
R! SXEOLFJHW&XVWRPHU1XP
It m ust be Òp ub lic abstracttÓ -
- value of wha
R" SXEOLFYRLGJHW&XVWRPHU1XP and return eltdheis... it IS after
ever the ÞTER.
R# DEVWUDFWYRLGJHW&XVWRPHU1XP all, a GET
R$ SXEOLFDEVWUDFWLQWJHW&XVWRPHU1XP
7HICH OF THE FOLLOWING ARE LEGAL ACCESSOR METHODS IN AN ENTITY BEAN WITH
3 CONTAINER
MANAGED PERSISTENCE #HOOSE ALL THAT APPLY
R! SXEOLFDEVWUDFWLQW*HW&XVWRPHU1XP
- you have to follow the
R" SXEOLFDEVWUDFWLQWJHWFXVWRPHU1XP Java naming convention
R# SXEOLFDEVWUDFWLQWJHW&XVWRPHU1XP
R$ SXEOLFDEVWUDFWLQWJHW&XVWRPHU1XP ^`
- not legal Ja
va
\RXDUHKHUH
PRFNH[DPDQVZHUV
7HICH ARE REQUIREMENTS FOR A #-0 ENTITY BEAN CLASS #HOOSE ALL THAT APPLY (spec: 190)
4
R! 4HE CLASS MUST DElNE A ¿QDOL]H METHOD
R" 4HE SOURCE lLE MUST DElNE AT LEAST ONE CONSTRUCTOR - No, you want the default constructor
R# 4HE CLASS MUST BE DECLARED PUBLIC AND ABSTRACT
R$ 4HE CLASS MUST IMPLEMENT DIRECTLY OR INDIRECTLY THE - EntityBean extends EnterpriseBean
MDYD[HME(QWHUSULVH%HDQ INTERFACE
R% !LL GETTER AND SETTER METHODS FOR THE BEANS ABSTRACT PERSISTENCE
SCHEMA MUST BE ABSTRACT
(spec: 192)
7HICH ARE LEGAL DECLARATIONS FOR A #-0 BEANS EJB#REATE METHODS #HOOSE
5 ALL THAT APPLY
R! SXEOLFYRLGHME&UHDWH%LJ&XVWRPHU WKURZV
MDYD[HME&UHDWH([FHSWLRQ
R" SXEOLF6WULQJHME&UHDWH$FFRXQW WKURZV - it canÕt be:
- static
MDYD[HME&UHDWH([FHSWLRQ - void
R# VWDWLF6WULQJHME&UHDWH WKURZV - Þnal
MDYD[HME&UHDWH([FHSWLRQ must return tprheimary
type of the
R$ SXEOLFLQWHME&UHDWH WKURZV key
MDYD[HME&UHDWH([FHSWLRQ
R% SXEOLF¿QDO6WULQJHME&UHDWH
MDYD[HME&UHDWH([FHSWLRQ
7HICH ARE LEGAL DECLARATIONS FOR A METHOD IN A #-0 BEAN #HOOSE ALL THAT
(spec: 192-193)
6 APPLY
R! SXEOLF$FFRXQWHME6HOHFW$FFW ORQJ[ WKURZV
MDYD[HME)LQGHU([FHSWLRQ - must be:
R" SXEOLFDEVWUDFW$FFWHME6HOHFW$FFW ORQJ[ WKURZV abstract
MDYD[HME)LQGHU([FHSWLRQ
void
- nÕt be
ca
R# SXEOLF$FFRXQWHME3RVW&UHDWH $FFWNH\ WKURZV static
MDYD[HME&UHDWH([FHSWLRQ
R$ SXEOLFYRLGHME3RVW&UHDWH $FFWNH\ WKURZV
MDYD[HME&UHDWH([FHSWLRQ
R% SXEOLFVWDWLFYRLGHME3RVW&UHDWH $FFWNH\ WKURZV
MDYD[HME&UHDWH([FHSWLRQ
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
7HICH METHODS FROM THE %NTITY#ONTEXT INTERFACE CAN BE INVOKED FROM
7 WITHIN THE SET%NTITY#ONTEXT METHOD #HOOSE ALL THAT APPLY (spec: 179)
R! JHW(-%2EMHFW
R" JHW(-%/RFDO+RPH last
R# JHW&DOOHU,GHQWLW\ - just too heearly for thecaseller tx.
t a
three. T reÕs no st means a
R$ JHW&DOOHU3ULQFLSDO setEntityContext jupo
be an is going in the ol
R% VHW5ROOEDFN2QO\
7HICH CAN BE CALLED ON A #-0 BEAN TO TRANSITION IT FROM THE READY STATE TO THE (spec: 168-169)
8 POOLED STATE #HOOSE ALL THAT APPLY
R! HME6WRUH - store can be called anytime and is not
called to transition the bean
R" HME&UHDWH
R# HME6HOHFW
R$ HME5HPRYH - with ejbRemove(), the bean wonÕt get an
R% HME3DVVLYDWH
ejbPassivate()
7HICH METHODS FROM THE %NTITY#ONTEXT INTERFACE CAN BE INVOKED FROM
(spec: 179)
9 WITHIN THE EJB#REATE METHOD #HOOSE ALL THAT APPLY
R! JHW(-%+RPH
R" JHW(-%2EMHFW
R# JHW&DOOHU3ULQFLSDO R
beans can NEVE
R$ JHW8VHU7UDQVDFWLRQ - Entittyhis, because entity
invoke MT
R% VHW5ROOEDFN2QO\ beans must use C
(spec: 169)
7HAT IS TRUE FOR A #-0 BEAN IN THE READY STATE
10
R! )TS HME/RDG CAN BE CALLED DIRECTLY AFTER EJB3TORE
- The poinet anis:d
R" )TS HME6WRUH CAN BE CALLED DIRECTLY AFTER A BUSINESS METHOD load, stor hods
R# /NE OF ITS BUSINESS METHODS CAN BE CALLED DIRECTLY AFTER EJB3TORE business metd by the
can be callein any
R$ .ONE OF THE ABOVE Container
order
\RXDUHKHUH
PRFNH[DPDQVZHUV
7HICH METHODS FROM THE %NTITY#ONTEXT INTERFACE MUST ./4 BE INVOKED (spec: 180)
11 FROM WITHIN THE EJB,OAD METHOD #HOOSE ALL THAT APPLY
R! JHW(-%+RPH
R" JHW(-%2EMHFW
R# JHW&DOOHU3ULQFLSDO
R$ JHW8VHU7UDQVDFWLRQ - for BMT only
R% VHW5ROOEDFN2QO\
7HICH METHOD CALLED ON A #-0 BEAN IS !,7!93 ASSOCIATED WITH A STATE (spec: 168-169)
12 CHANGE IN THE BEAN #HOOSE ALL THAT APPLY
R! HME/RDG - not always!
R" HME)LQG
R# HME5HPRYH - bean goes ba
ck to the pool
R$ HME$FWLYDWH - bean comes out of the pool
R% XQVHW(QWLW\&RQWH[W - bean goes from the pool to dea
th
)
7HATS TRUE ABOUT AN #-0 ENTITY BEANS PRIMARY KEY #HOOSE ALL THAT APPLY
(spec: 203, 275
13
R! 4HE BEANS PRIMARY KEY CLASS MUST PROVIDE A SUITABLE IMPLEMENTATION OF
THE HASH#ODE AND EQUALS METHODS
R" 7HEN SPECIFYING THE PRIMARY KEY IN THE DEPLOYMENT DESCRIPTOR ONLY
THE lELD NAME MUST BE DECLARED - no, you need the type
R# !LL lELDS IN THE PRIMARY KEY CLASS MUST BE DECLARED PUBLIC
R$ !LL lELDS USED IN THE PRIMARY KEY MUST BE CONTAINER MANAGED lELDS
(OW MANY EJB#REATE METHODS CAN A #-0 ENTITY BEAN HAVE (spec: 171)
14
R!
let
R" You donÕt hatvee betoans
R# OR clients crea
R$ TO MANY
R% TO MANY
&KDSWHU
HQWLW\EHDQV\QFKURQL]DWLRQ
7HICH METHODS ARE ALWAYS INVOKED IN DIRECT RESPONSE TO A CLIENT OPERATION (spec: 171-172)
15 #HOOSE ALL THAT APPLY
R! HME/RDG ate, and
Load, Passivon t
setEntityC d tbyex the
R" HME&UHDWH lle
can be ca when it
R# HME5HPRYH Container
wants to
R$HME$FWLYDWH
R% HME3DVVLYDWH
R& VHW(QWLW\&RQWH[W
7HICH ADDITIONAL METHODS MIGHT THE CONTAINER CALL WHEN INVOKING (spec: 176)
16 EJB2EMOVE #HOOSE ALL THAT APPLY
R! HME)LQG a bean has to be ready
R" HME/RDG and loaded before it
can do a remove - it
R# HME6WRUH may have cascading
R$ HME$FWLYDWH deletes to take care of
R% HME3DVVLYDWH
!T WHAT POINTS MUST THE CONTAINER ESTABLISH A #-0 BEANS PRIMARY KEY (spec: 175)
17 #HOOSE ALL THAT APPLY
R! BEFORE CALLINGQHZ,QVWDQFH
R"BEFORE CALLING VHW(QWLW\&RQWH[W
es the values yo u set in
r us
R# BEFORE CALLINGHME&UHDWH the C on t
e
ai ne
so t hat in ej bPos ate the
t C re
R$ BEFORE CALLINGHME3RVW&UHDWH ejbCreatready to use its key
bean is
18 7HICH METHODS RUN IN THE TRANSACTION CONTEXT OF THE METHOD THAT CAUSES (spec: 174-178)
THEIR INVOCATION #HOOSE ALL THAT APPLY
R! HME/RDG
R" HME5HPRYH
R# HME6HOHFW
R$ HME$FWLYDWH
R% HME3DVVLYDWH
R& VHW(QWLW\&RQWH[W
\RXDUHKHUH
entity relationships
5 4
4 :KHQ%HDQV5HODWH
+DYH\RXKHDUG
DERXW2QHWR0DQ\
UHODWLRQVKLSV",WKRXJKW 2KUHDOO\"7RREDG\RXGRQ·W
PD\EHZHFRXOGWU\ KDYHD&RQWDLQHUWRPDQDJH\RXU
WKDW UHIHUHQWLDOLQWHJULW\%HFDXVH
,ZRXOGMXVWORYHWRFDVFDGH
GHOHWH\RXULJKWQRZ
(QWLW\EHDQVQHHGUHODWLRQVKLSV$Q2UGHUQHHGVD&XVWRPHU$/LQH,WHP
QHHGVDQ2UGHU$Q2UGHUQHHGV/LQH,WHPV$0RYLHQHHGVD'LUHFWRU$'LUHFWRUQHHGV
0RYLHV$0RYLHQHHGV$FWRUV$Q$FWRUQHHGVWDOHQW(QWLW\EHDQVFDQKDYHFRQWDLQHU
PDQDJHGUHODWLRQVKLSV &05 DQGWKH&RQWDLQHUWDNHVFDUHRIYLUWXDOO\HYHU\WKLQJ0DNH
DQHZ0RYLHDQGJLYHLWD'LUHFWRU"7KDW'LUHFWRUDXWRPDWLFDOO\KDVRQHPRUH0RYLHLQKLV
0RYLHFROOHFWLRQ0DNHDQHZ/LQH,WHPWKDW¶VUHODWHGWRDQ2UGHU",I\RXDVNWKH&XVWRPHU
WRVKRZ\RXKLV2UGHUVKLV2UGHUVZLOOVKRZWKHQHZ/LQH,WHP%HVWRIDOO\RXFDQXVH
(-%4/WRZULWHSRUWDEOH WKLQN YHQGRUGDWDEVHLQGHSHQGHQW TXHULHV
WKLVLVDQHZFKDSWHU
H[DPREMHFWLYHV
(QWLW\5HODWLRQVKLSV &03DQG&05
2IILFLDO :KDWLWUHDOO\PHDQV
,GHQWLI\FRUUHFWDQGLQFRUUHFW <RXKDYHWRNQRZWKDWWKHFRQWDLQHUPDQDJHV
VWDWHPHQWVRUH[DPSOHVDERXW UHODWLRQVKLSVEHWZHHQWZRHQWLW\EHDQVWKURXJK
SHUVLVWHQWUHODWLRQVKLSVUHPRYH FRQWDLQHUPDQDJHGSHUVLVWHQW &05 ¿HOGVDQGWKDW
SURWRFROVDQGDERXWWKHDEVWUDFW &05¿HOGVPXVWEHGHVFULEHGLQWKHGHSOR\PHQW
VFKHPDW\SHRID&03HQWLW\EHDQ GHVFULSWRUXVLQJWKH UHODWLRQVKLSV!VHFWLRQ
<RXKDYHWRXQGHUVWDQGWKHLPSOLFDWLRQVRIPXOWLSOLFLW\
,GHQWLI\FRUUHFWDQGLQFRUUHFW LQDUHODWLRQVKLSDQGWKDWWKH&RQWDLQHUFDUHVZKHWKHU
VWDWHPHQWVRUH[DPSOHVDERXW WKHUHODWLRQVKLSLVRQHWRRQHRQHWRPDQ\RUPDQ\
UXOHVDQGVHPDQWLFVIRUUHODWLRQVKLS WRPDQ\<RXPXVWNQRZWKDWWKH&RQWDLQHUPDLQWDLQV
DVVLJQPHQWXSGDWLQJLQD&03EHDQ WKHUHIHUHQWLDOLQWHJULW\RIWKHGDWDEDVHE\XVLQJWKH
PXOWLSOLFLW\ZKHQGRLQJDVVLJQPHQWV)RUH[DPSOHLI
0DWFKWKHQDPHZLWKDGHVFULSWLRQRI WKHUHFDQEHRQO\RQH&XVWRPHUSHU2UGHULI\RXDVVLJQ
SXUSRVHRUIXQFWLRQDOLW\IRUHDFKRI DQ2UGHUWRD&XVWRPHUWKDW2UGHUFDQQRWH[LVWLQDQ\
WKHIROORZLQJ HMEQDPH! DEVWUDFW RWKHU&XVWRPHU¶V2UGHUFROOHFWLRQ$QGLI\RXUHDVVLJQ
VFKHPDQDPH! HMEUHODWLRQVKLSUROH! WKDW2UGHUWRDGLIIHUHQW&XVWRPHUWKH2UGHULVPRYHG
FPU¿HOG! FPU¿HOGW\SH!DQG IURPRQH&XVWRPHU¶VFROOHFWLRQWRWKHRWKHU%XWLI\RX
UHODWLRQVKLSUROHVRXUFH! DVVLJQD&XVWRPHUZLWKWKUHHH[LVWLQJ2UGHUVWRDQRWKHU
2UGHUWKHUHIHUHQFHWRWKH&XVWRPHULVFRSLHGQRW
,GHQWLI\FRUUHFWO\LPSOHPHQWHG PRYHGVRWKDWWKHUHIHUHQFHWRD&XVWRPHUWKDWWKH
GHSOR\PHQWGHVFULSWRUHOHPHQWVIRU RWKHUWKUHHH[LVWLQJ2UGHUVKDYHLVQRWDIIHFWHG
D&03EHDQ LQFOXGLQJFRQWDLQHU
<RXKDYHWRNQRZWKDW(-%4/TXHULHVDUHGH¿QHGLQ
PDQDJHGUHODWLRQVKLSV
WKHGHSOR\PHQWGHVFULSWRUDQGDUHIRU)LQGHUDQG6HOHFW
PHWKRGVRQO\<RXKDYHWRNQRZWKHEDVLFV\QWD[RI(-%
,GHQWLI\FRUUHFWDQGLQFRUUHFWV\QWD[ 4/DQGWKDW)520DQG6(/(&7DUHPDQGDWRU\EXW
IRUDQ(-%4/TXHU\LQFOXGLQJWKH
:+(5(LVRSWLRQDO
6(/(&7)520DQG:+(5(FODXVH
<RXKDYHWRNQRZWKDWLI\RXXVHSDWKQDYLJDWLRQWRVD\
,GHQWLI\FRUUHFWDQGLQFRUUHFW JHWWKHWLWOHRID0RYLH\RXFDQVD\PWLWOH DVVXPLQJ³P´
VWDWHPHQWVRUH[DPSOHVDERXWWKH LVGHFODUHGDVWKHDEVWUDFWVFKHPDW\SHRI0RYLHDQG
SXUSRVHDQGXVHRI(-%4/ ³WLWOH´LVD&03¿HOGRIWKH0RYLH%HDQ %XWWKDW\RXFDQ¶W
VD\GPRYLHVWLWOHZKHUH³G´LVD'LUHFWRUDQG³PRYLHV´LV
,GHQWLI\FRUUHFWDQGLQFRUUHFW D&05¿HOGWKDWLVD&ROOHFWLRQRIPRYLHV)RUWKDW\RX
FRQGLWLRQDOH[SUHVVLRQVEHWZHHQ PXVWXVHWKH,1RSHUDWRUZLWKLQD)520FODXVH<RX¶OO
H[SUHVVLRQVOLNHH[SUHVVLRQVDQG VHHLW¶VDOOLQKHUH$QGPXFKVLPSOHUWKDQLWVRXQGV
FRPSDULVRQH[SUHVVLRQV
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
*MIVQNaQVOaW]ZUW^QMLI\IJI[M
)MAGINE YOU HAVE A MOVIE APPLICATION IT ISNT MAKING THE ,ZDQWWRVHHDOOWKH
FOLKS AT IMDBCOM NERVOUS BUT IT WORKS FOR YOU PRYLHVZLWKGLUHFWRUVZKR
9OU CAN USE IT TO LOOK UP A MOVIE DUHQRPRUHWKDQGHJUHHV
DZD\IURP.HYLQ%DFRQDQGWKH
/NCE YOU HAVE A MOVIE YOU CAN USE IT TO LAUNCH THE MOVIE JHQUHLV´URPDQWLFKRUURUµ
TRAILER
9OU CAN DO ALL KINDS OF SEARCHES TO SAY lND ALL SCI
l MOVIES
OR lND ALL ACTION MOVIES BY A SPECIlC DIRECTOR
7E CAN MAKE BEANS FOR -OVIE 4RAILER AND $IRECTOR "UT
HOW DO THEY MAP TO THE DATABASE !ND HOW DO THEY RELATE $IWHU
TO ONE ANOTHER
a foreign key
Director tab into the
le
0RYLH7DEOH
0RYLH,' 7LWOH *HQUH 'LUHFWRU,' <HDU
&URXFKLQJ3L[HOV+LGGHQ0RXVH $FWLRQ
7KH)LIWK$UUD\(OHPHQW $FWLRQ
7KH5HWXUQRIWKH%HDQ4XHHQ )DQWDV\
/RUGRIWKH/RRSV 6FL¿
'LUHFWRU7DEOH 7UDLOHU7DEOH
'LUHFWRU,' 2VFDU:LQQHU 'HJUHHV 1DPH 7UDLOHU,' )LOH1DPH
758( -LP<LQJVW &URXFKLQJ3L[HOV+LGGHQ0RXVH7UDLOHU
)$/6( -HVVLFD6DQW 7KH)LIWK$UUD\(OHPHQW7UDLOHU
)$/6( 6N\OHU6DIIRUG 7KH5HWXUQRIWKH%HDQ4XHHQ7UDLOHU
)$/6( -RKQ'DZVRQ /RUGRIWKH/RRSV7UDLOHU
Director doesnÕt have a The trailerÕs prim
always matches th ary key
reference to his movies. e MovieID
\RXDUHKHUH
HQWLW\EHDQUHODWLRQVKLSV
*]\_MLWV¼\_IV\\W\PQVSQV<)*4-;
?M_IV\\W\PQVSQV+4);;-;
7E KNOW WE CAN MAP TABLES TO BEAN CLASSES NO PROBLEM
!LL THE COLUMNS BECOME PERSISTENT lELDS IN THE BEAN CLASS
REPRESENTED BY ABSTRACT GETTERS AND SETTERS AND WERE
But this doe
GOOD TO GO %XCEPT IF THIS WERE A CLASS AND NOT A TABLE WE
Look what thsne Õt look very client-friendly
WOULDNT HAVE DESIGNED IT THAT WAY 7ED PROBABLY MAKE
reference to al client would have to do... .
THE MOVIE CLASS A LOT MORE FRIENDLY AND USEFUL FOR EXAMPLE
a reference to l three tables! If the clie get a
SO THAT A CLIENT COULD WORK WITH JUST THE MOVIE BEAN RATHER
directorID fro a movie, they have to getnt has
THAN HAVING TO GET REFERENCES TO ALL THREE BEANS
get a referencem the movie, then use that the
to a Director. to
0RYLH,' 7LWOH *HQUH 'LUHFWRU,' <HDU
&URXFKLQJ3L[HOV+LGGHQ0RXVH $FWLRQ
7KH)LIWK$UUD\(OHPHQW $FWLRQ
0RYLH
7KH5HWXUQRIWKH%HDQ4XHHQ )DQWDV\
/RUGRIWKH/RRSV 6FL¿ JHW0RYLH,'
JHW7LWOH 'LUHFWRU
7UDLOHU,' )LOH1DPH
7UDLOHU JHW*HQUH
'LUHFWRU,' 2VFDU:LQQHU 'HJUHHV 1DPH &URXFKLQJ3L[HOV+LGGHQ0RXVH7UDLOHU
JHW'LUHFWRU,' JHW'LUHFWRU,'
758( -LP<LQJVW 7KH)LIWK$UUD\(OHPHQW7UDLOHU
JHW7UDLOHU,' JHW<HDU JHW2VFDU:LQQHU
)$/6( -HVVLFD6DQW 7KH5HWXUQRIWKH%HDQ4XHHQ7UDLOHU
JHW)LOH1DPH JHW'HJUHHV
)$/6( 6N\OHU6DIIRUG /RUGRIWKH/RRSV7UDLOHU
JHW1DPH
)$/6( -RKQ'DZVRQ
a straight mapping from
tables to classes
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
:RXOGQ·WLWEHGUHDP\LIWKHUH
ZHUHDZD\WRXVHFRQWDLQHUPDQDJHG
SHUVLVWHQFHEXWKDYHFODVVHVWKDWGLGQ·W
KDYHWRORRNH[DFWO\OLNHWKHWDEOHV"6RWKDW
DFOLHQWFRXOGJHWDPRYLHDQGDVNWKHPRYLH
IRUDUHDO'LUHFWRUUHIHUHQFHQRWMXVWWKH
GLUHFWRU·VIRUHLJQNH\\HDKWKDWZRXOG
EHJUHDWEXWLW·VSUREDEO\MXVWD
IDQWDV\
\RXDUHKHUH
HQWLW\EHDQUHODWLRQVKLSV
?MVMMLZMTI\QWV[PQX[JM\ _MMV\PM5W^QMJMIV
IVL\PM, QZMK\WZJMIV
7E WANT THE -OVIE BEAN TO HAVE A REFERENCE TO ITS MATCHING $IRECTOR BEAN AND
WE WANT TO DO ALL SORTS OF SEARCHES AGAINST THE -OVIE BEAN AND HAVE THE QUERIES
USE THE $IRECTOR BEANS DATA AS WELL
)N OTHER WORDS WE WANT TO MAKE IT EASY ON THE CLIENT AND ON THE DEVELOPER TO
THINK IN A MORE NATURAL WAY RATHER THAN IN THE DATABASE
EFl CIENT WAY THAT WAS
USED TO DESIGN THE SCHEMA OF THE DATABASE 7HO WANTS THAT 2EMEMBER THIS IS
THE // WORLD AND RELATIONAL DATABASES WHILE CRUCIAL TO YOUR BUSINESS ARE SO
7E WANT TO USE DATABASES WE JUST DONT WANT TO THINK LIKE DATABASES )F
YOURE ONE OF THE LUCKY ONES WHO GETS TO USE AN // DATABASE AND ASSUMING
THAT DATABASE STILL SOMEHOW MANAGES TO PERFORM WELL ENOUGH FOR YOUR NEEDS
THEN YOU CAN JUST SMILE SMUGLY DURING THIS l RST SECTION
LQVWHDGRIWKLV ZHZDQWWKLV
We want
0RYLH
we donÕt want
0RYLH reference at
to keep just Director en o a
JHW0RYLH,' JHW0RYLH,'
BEAN tity
JHW7LWOH the DirectorÕs JHW7LWOH
JHW*HQUH foreign key JHW*HQUH
JHW'LUHFWRU,' JHW'LUHFWRU 'LUHFWRU
JHW<HDU JHW<HDU
JHW'LUHFWRU,'
JHW2VFDU:LQQHU
JHW'HJUHHV
JHW1DPH
0RYLH+RPH JHW0RYLHV
FUHDWH
r have
WeÕll let the Direcovtoie beans.
ILQG%\3ULPDU\.H\
ILQG%\*HQUH
OLVW$OO0RYLHV a Collection of M
OLVW0RYLHV%\'LUHFWRU$QG*HQUH
ILQG0RYLHV%\.HYLQ'HJUHHV
7ERE NOT GOING TO USE THE 4RAILER TABLE AND BEAN AFTER THIS ALTHOUGH YOULL
SEE IT IN CODE TO KEEP THE EXAMPLE CLEANER !DDING THE 4RAILER BEAN WOULDNT
ADD ANY NEW COMPLEXITY TO THE APPLICATION THOUGH )F YOU CAN SET
UP ONE
BEAN
TO
BEAN RELATIONSHIP YOU CAN SET UP OTHERS
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
?Pa[PW]TL\PM,QZMK\WZJMIJMIV'
?PaKIV¼\Q\R][\JMLI\I'
7HY NOT HAVE THE -OVIE BEAN SIMPLY GO TO THE DATABASE
USING THE $IRECTORS FOREIGN KEY STORED AS A PERSISTENT
lELD IN THE -OVIE BEAN AND GET THE $IRECTORS DATA "UT
IF YOU MAKE THE DIRECTOR A BEAN AS WELL YOU GET TO THINK ,IERWKWKH'LUHFWRUDQG
/.,9 IN OBJECTS EXCEPT DURING DEPLOYMENT WHEN YOU
DO HAVE TO MAP FROM YOUR BEANS TO YOUR TABLES !ND YOU WKH0RYLHDUHHQWLW\EHDQV
GET ALL THE BENElTS OF CONTAINER
MANAGED PERSISTENCE AND
SYNCHRONIZATION )MAGINE IF SOMEONE CALLS A SETTER METHOD \RXQHYHUKDYHWRZRUU\
TO CHANGE THE DIRECTORS OSCAR WINNING STATUS )F YOURE DERXWV\QFKURQL]LQJDQ\
MANAGING THIS YOUD HAVE TO GET A *$"# CONNECTION AND
SYNCHRONIZE THE DATABASE YOURSELF !ND OF COURSE YOUD HAVE RIWKH0RYLH·VUHODWHG
TO KNOW WHEN IS THE RIGHT TIME ETC "UT IF ITS DIRECTOR IS ALSO A
BEAN YOU CALL A SET7INNER METHOD AND YOURE DONE GDWD LIVRPHERG\XVHV
/H AND THERES ANOTHER COOL THING 9OU MIGHT DECIDE FOR WKH0RYLHEHDQWRFKDQJH
EXAMPLE TO BANISH A SPECIlC DIRECTOR FROM YOUR DATABASE
BECAUSE YOU THINK HIS MOVIES SUCK IN AN UNRECOVERABLE WAY VRPHWKLQJDERXWWKH'LUHFWRU
.O PROBLEM DELETING THAT DIRECTOR OBVIOUSLY "UT THEN WHAT HYHU\WKLQJ·VWDNHQFDUHRIE\
HAPPENS TO THE MOVIES (OW CAN YOU HAVE MOVIES IN THE
DATABASE THAT DONT HAVE A DIRECTOR 7HAT IS THE DATABASE IS WKH&RQWDLQHU
ALREADY SET UP IN SUCH A WAY THAT YOU ARENT ALLOWED TO HAVE A
NULL VALUE FOR THE DIRECTOR COLUMN )N OTHER WORDS WHAT IF A <RXFDQHYHQVHWWKLQJVXS
MOVIE CANNOT EXIST IN THE DATABASE WITHOUT A DIRECTOR
9OU CAN HANDLE THIS BRAINLESSLY BY SETTING UP THE -OVIE
IRUDFDVFDGHGHOHWHVRLI
TO
$IRECTOR BEAN RELATIONSHIP IN SUCH A WAY THAT WHEN YOU \RXUHPRYHD'LUHFWRUDOO
DELETE A DIRECTOR FROM THE DATABASE ALL OF HIS MOVIES ARE
AUTOMATICALLY DELETED 9OU DO THIS WITH ONE SIMPLE TAG IN THE WKH'LUHFWRU·VPRYLHVZLOOEH
DEPLOYMENT DESCRIPTOR AND 0//& 3OMEBODY CALLS REMOVE
ON A DIRECTOR BEAN AND REMOVE WILL AUTOMATICALLY BE CALLED
UHPRYHGDXWRPDWLFDOO\
ON ALL OF THE MOVIE ENTITY BEANS THAT HAVE A REFERENCE TO THIS
DIRECTOR AS THE VALUE OF THEIR DIRECTOR PERSISTENT lELD
\RXDUHKHUH
UHODWLRQVKLSPXOWLSOLFLW\
:MTI\QWV[PQX[IVLU]T\QXTQKQ\a
$ 7VM\W7VM
(DFK0RYLH
PI[ 2QH7UDLOHU
2QH0RYLH
PI[ (DFK7UDLOHU
% 7VM\W5IVa
PI[ 0DQ\0RYLHV
2QH'LUHFWRU
2QH'LUHFWRU
PI[ (DFK0RYLH
5IVa\W5IVa
PI[UILM
$Q$FWRU 0DQ\0RYLHV
0DQ\$FWRUV
PI[ $0RYLH
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
5]T\QXTQKQ\aQV*MIV+TI[[M[
(ERES HOW IT WORKS WITH OUR BEAN CODE 4HIS MULTIPLICITY NOTATION
IS THE ONLY 5-,
LIKE THING YOU HAVE TO KNOW ON THE EXAM
7UDLOHU 0RYLH $FWRU
(DFK0RYLH (DFK7UDLOHU (DFK$FWRU (DFK0RYLH
JHW7UDLOHU,' KDVH[DFWO\ KDVH[DFWO\ JHW0RYLH,' KDV]HURRU KDVKDVRQHRU JHW$FWRU,'
RQH7UDLOHU RQH0RYLH PRUH0RYLHV PRUH$FWRUV
JHW)LOH1DPH JHW7LWOH JHW1DPH
JHW0RYLH JHW*HQUH JHW$JHQW
JHW'LUHFWRU JHW7DOHQW
JHW7UDLOHU JHW0RYLHV
(DFK'LUHFWRU
KDV]HURRU
PRUH0RYLHV
'LUHFWRU
JHW'LUHFWRU,'
JHW2VFDU:LQQHU
(DFK0RYLH JHW'HJUHHV
KDVH[DFWO\ JHW1DPH
RQH'LUHFWRU JHW0RYLHV
4O READ THIS YOU HAVE TO FOLLOW THE ARROW TO ITS DESTINATION )N
THE 0ERSON TO 0ETS RELATIONSHIP 0ERSON HAS A MULTIPLICITY OF /.%
BUT 0ETS HAS A MULTIPLICITY OF -!.9 WHICH COULD BE ZERO 4O
l ND OUT HOW MANY 0ETS A 0ERSON CAN HAVE YOU HAVE TO FOLLOW
THE ARROW OUT OF 0ERSON AND INTO 0ETS 4HE NUMBER CLOSEST TO THE
CLASS IS THE MULTIPLICITY OF THAT CLASS TO OTHERS )N OTHER WORDS HOW
MANY OF THAT TYPE DOES THE OTHER TYPE HAVE
this number says this numberany
how many PERSON says how m each
PETS does ave
3HUVRQ objects does each 3HWV
PET have PERSO N h
JHW3HWV JHW3HUVRQ
\RXDUHKHUH
UHODWLRQVKLSPXOWLSOLFLW\
5]T\QXTQKQ\aINNMK\[ZM\]ZV\aXM
! -OVIE HAS ONE $IRECTOR 7HEN YOU CALL GET$IRECTOR YOU
GET BACK ONE $IRECTOR 3O THE RETURN TYPE OF GET$IRECTOR IS
A $IRECTOR
"UT A $IRECTOR HAS MANY MOVIES SO WHEN YOU CALL
GET-OVIES YOU GET BACK A #OLLECTION OF -OVIES
0XOWLSOLFLW\ 0XOWLSOLFLW\
Movie has a multiplicity of
PDQ\ RQH ÒmanyÓ in its relationship with
Director. That does NOT
0RYLH 'LUHFWRU mean that Movie has ÒmanyÓ
Directors... it means that
'LUHFWRUJHW'LUHFWRU &ROOHFWLRQJHW0RYLHV Director has ÒmanyÓ Movies!
So Director has a getMovies()
that returns a Collection of
Movies.
And Director has a multiplicity
of ÒoneÓ, which means that
)N THE -OVIE
TO
$IRECTOR RELATIONSHIP THE MULTIPLICITY OF Movie will return just one
-OVIE IS MANY AND THE MULTIPLICITY OF $IRECTOR IS ONE Director.
! MULTIPLICITY OF ONE MEANS THE OBJECT YOURE RELATED TO
HOLDS JUST ONE OF YOU
$IRECTOR HAS A MULTIPLICITY OF ONE SO THE -OVIE OBJECT RELATED
TO $IRECTOR RETURNS JUST A SINGLE $IRECTOR BEAN /+ TECHNICALLY
THE COMPONENT INTERFACE OF $IRECTOR BUT YOU KNOW WHAT WE
MEAN BY NOW
! MULTIPLICITY OF MANY MEANS THE OBJECT YOURE RELATED TO
HOLDS A #OLLECTION OF YOU
-OVIE HAS A MULTIPLICITY OF MANY SO THE $IRECTOR OBJECT
RELATED TO -OVIE RETURNS A #OLLECTION OF -OVIE BEANS
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
,MNQVQVO^QZ\]ITNQMTL[NWZXMZ[Q[\MV\
LI\INQMTL[IVLZMTI\QWV[PQXNQMTL[
)N THE PREVIOUS CHAPTER WE LOOKED AT DElNING CONTAINER
MANAGED
lELDSYOU PUT IN A PAIR OF ABSTRACT GETTERS AND SETTERS 7E SAID A
CONTAINER
MANAGED lELD EXISTS SIMPLY BECAUSE YOU HAVE A GETTER AND SETTER FOR
IT )T WORKS THE SAME WAY WITH CONTAINER
MANAGED RELATIONSHIP #-2
lELDS 9OU DElNE A PAIR OF ABSTRACT GETTERS AND SETTERS BUT RATHER THAN
SETTING AND RETURNING A VALUE THAT MAPS TO A COLUMN IN A TABLE YOU SET
AND RETURN A REFERENCE TO ANOTHER ENTITY BEAN OR A #OLLECTION THAT WILL 7KHRQO\GLIIHUHQFH
HOLD REFERENCES TO THE ENTITY BEAN 4HE RESTRICTIONS FOR #-2 lELDS ARE
THAT THEY CAN REFER ONLY TO THE LOCAL COMPONENT INTERFACE OF THE ENTITY
EHWZHHQD&03ILHOGDQG
BEAN AND THAT IF THE METHOD RETURNS A #OLLECTION THE DECLARED TYPE D&05ILHOGLVWKH7<3(
CAN BE ONLY #OLLECTION OR 3ET NOT -AP ,IST ETC
4HE TERMINOLOGY IS A LITTLE CONFUSING BECAUSE BOTH #-0 AND #-2 $&05ILHOGLVDOZD\V
lELDS ARE CONTAINER
MANAGED PERSISTENT lELDS 4HEY MIGHT HAVE
CALLED IT #-0#$ CONTAINER
MANAGED PERSISTENT COLUMN DATA lELDS DQRWKHUHQWLW\EHDQ·V
AND #-02 CONTAINER
MANAGED PERSISTENT RELATIONSHIP lELDS /F
COURSE PERSISTENCE ISNT RESTRICTED TO JUST RELATIONAL DATABASE SO WERE ORFDOLQWHUIDFHW\SHRUD
USING THE TERM hCOLUMNv A LITTLE LOOSELY "UT IN %*" ALL CONTAINER
&ROOHFWLRQRIWKHP
MANAGED PERSISTENT lELDS WERE #-0 lELDS BECAUSE THERE WAS NO
CONCEPT OF PERSISTENT RELATIONSHIPS IN %*" #-0
,ILW·VD&ROOHFWLRQ
AW]VMMLIXIQZWNIJ[\ZIK\OM\\MZ[IVL[M\\MZ[NWZ LWPXVWEHHLWKHU
MIKP+58NQMTLKWT]UV^IT]M[IVLMIKP+5:NQMTL <
MDYDXWLO&ROOHFWLRQRU
ZMTI\QWV[PQX_Q\PIVW\PMZMV\Q\a
MDYDXWLO6HW
&03ÀHOG
SXEOLFDEVWUDFW6WULQJJHW7LWOH make sure the
SXEOLFDEVWUDFWYRLGVHW7LWOH 6WULQJJ and return typeargument
match
&05 UHODWLRQVKLS ÀHOG
SXEOLFDEVWUDFW'LUHFWRUJHW'LUHFWRU
SXEOLFDEVWUDFWYRLGVHW'LUHFWRU 'LUHFWRUG Director must be the local
component interface for the
Director bean.
pe of a CMR
The argument and return ty ther Entity
Òvirtual ÞeldÓ is always anollec n.
beanÕs local type, or a Co tio
\RXDUHKHUH
WKHDEVWUDFWSHUVLVWHQFHVFKHPD
,MNQVQVOaW]Z¹IJ[\ZIK\XMZ[Q[\MVKM
[KPMUIº^QZ\]ITNQMTL[IZMV¼\MVW]OP
4O DElNE PERSISTENT lELDS AND RELATIONSHIPS YOU NEED TO
CREATE AN ABSTRACT PERSISTENCE SCHEMA $ElNING THE VIRTUAL $QDEVWUDFWSHUVLVWHQWVFKHPD
lELDS ISNT ENOUGH 9OUR ABSTRACT PERSISTENCE SCHEMA IS A
COMBINATION OF YOUR VIRTUAL lELDS IN YOUR BEAN CLASS PLUS
LVDFRPELQDWLRQRIVRPHVWXII
SOME THINGS YOU WRITE IN THE DEPLOYMENT DESCRIPTOR \RXSXWLQWKHGHSOR\PHQW
4HE WAY YOU DESCRIBE #-0 lELDS IN THE $$ IS SIMPLE AND
STRAIGHTFORWARD 7ITH #-2 YOULL HAVE TO DO A LITTLE MORE
GHVFULSWRUSOXV\RXUDEVWUDFW
TO SET THINGS UP INCLUDING DESCRIBING THE MULTIPLICITY FOR JHWWHUVDQGVHWWHUV
EACH OF THE TWO PARTICIPANTS IN A RELATIONSHIP
"UT WELL GET TO #-2 lELDS IN JUST A MINUTE &OR NOW WELL 7RJHWKHUWKH\WHOOWKH
START WITH JUST #-0 lELDS
&RQWDLQHUKRZWRPDQDJH\RXU
EHDQ·VSHUVLVWHQFHLQFOXGLQJ
<PM+WV\IQVMZVMML[\PM[M<?7\PQVO[\W
SVW_aW]PI^MI+58NQMTL¹\Q\TMº ERWKSHUVLVWHQW),(/'6
FDOOHG&03ILHOGV DQG
SHUVLVWHQW5(/$7,216+,36
,QWKH''
FDOOHG&05ILHOGV
HQWLW\!
HMEQDPH!0RYLH%HDQ HMEQDPH!
ORFDOKRPH!KHDG¿UVW0RYLH+RPH ORFDOKRPH!
ORFDO!KHDG¿UVW0RYLH ORFDO!
HMEFODVV!KHDG¿UVW0RYLH%HDQ HMEFODVV!
DEVWUDFWVFKHPDQDPH!0RYLH6FKHPD DEVWUDFWVFKHPDQDPH!
FPS¿HOG!
¿HOGQDPH!WLWOH ¿HOGQDPH!
FPS¿HOG!
HQWLW\!
,QWKHEHDQFODVV
SXEOLFDEVWUDFW6WULQJJHW7LWOH
SXEOLFDEVWUDFWYRLGVHW7LWOH 6WULQJJ
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
8MZ[Q[\MV\+58NQMTL[QV\PM,,
HQWLW\!
GLVSOD\QDPH!0RYLH%HDQ GLVSOD\QDPH!
ner that IT
HMEQDPH!0RYLH%HDQ HMEQDPH! tell the Contaiur persistence
ORFDOKRPH!KHDG¿UVW0RYLH+RPH ORFDOKRPH! is managing yo ÒBeanÓ)
ORFDO!KHDG¿UVW0RYLH ORFDO! (as opposed to
HMEFODVV!KHDG¿UVW0RYLH%HDQ HMEFODVV!
SHUVLVWHQFHW\SH!&RQWDLQHU SHUVLVWHQFHW\SH!
SULPNH\FODVV!MDYDODQJ6WULQJ SULPNH\FODVV! fully-qualiÞed class
UHHQWUDQW!)DOVH UHHQWUDQW!
na me for the Þeld
FPSYHUVLRQ![ FPSYHUVLRQ!
th at represents the
primary key
DEVWUDFWVFKHPDQDPH!0RYLH6FKHPD DEVWUDFWVFKHPDQDPH!
FPS¿HOG!
hat
¿HOGQDPH!JHQUH ¿HOGQDPH!
y o u r s c hema so yt type it
FPS¿HOG! Name w which entit ust be
FPS¿HOG! you kno nts. This name m
represe the DD!!
unique in
¿HOGQDPH!PRYLH,' ¿HOGQDPH!
FPS¿HOG!
FPS¿HOG!
¿HOGQDPH!\HDU ¿HOGQDPH! ner
told the Contitaiwhich
FPS¿HOG!
Now that youÕve el l
manage, t One...
FPS¿HOG! WHICH Þeldsdto is the Special
¿HOGQDPH!WLWOH ¿HOGQDPH! of those Þel s y Þeld.
FPS¿HOG! the primary ke
SULPNH\¿HOG!PRYLH,' SULPNH\¿HOG!
HQWLW\!
WKHUH DUH QR
7KHQDPLQJ
'XPE 4XHVWLRQV
FRQYHQWLRQLV
5(48,5(' Q: (OW DOES THE #ONTAINER KNOW THE TYPE
EVWUDFW OF THE PERSISTENT l ELD ) SEE A DEl NITION FOR THE
<RXPXVWKDYHDSDLURID
KDW KD YHWKH PRIMARY KEY TYPE PRIM
KEY
CLASS BUT ) DONT
JHWWHUVDQGVHWWHUVW
UDI WHUWKH ³JH W´DQG SEE ANYTHING FOR THE OTHER #-0 l ELDS
¿UVWFKDUDFWH
DSLWDOL]HG EX WLQ WKH &0 3
³VHW´F
¿HOGGH¿QLWLRQLQWKH
ZLWKDORZ HUF DVH OHW
''
WHU
\R
OHD
XV
YLQ
WDUW
JR II
V
A: 4HE #ONTAINER FIGURES IT OUT BASED ON THE
UZ RUG RETURN TYPE AND ARGUMENT OF THE ABSTRACT GETTERS
WKH³JHW´DQG³VHW´,QRWKH
3¿HOG LQ WKH AND SETTERS IN THE BEAN CLASS !ND THEY HAD BETTER
\RXGH¿QHWKH&0
WDQFH MATCH )F YOU HAVE A GET,IMIT.UM THAT RETURNS
''DVLILWZHUHDUHDOLQV
LDEOHIROORZ LQJ WKH ROG SUH(-% AN INT YOU BETTER HAVE A SET,IMIT.UMINT I THAT
YDU
JF RQY HQW LRQ TAKES AN INT
-DYD%HDQVQDPLQ
\RXDUHKHUH
HQWLW\EHDQUHODWLRQVKLSV
=[QVOZMTI\QWV[PQX[QVaW]ZKWLM
)N YOUR BEAN CODE YOU USE YOUR VIRTUAL RELATIONSHIP lELDS JUST
AS YOU WOULD ANY OTHER GETTER AND SETTER 4HE ONLY DIFFERENCE
BETWEEN USING A REAL lELD IE AN INSTANCE VARIABLE DECLARED IN
YOUR CLASS AND A VIRTUAL lELD IS THAT YOU CAN ACCESS YOUR VIRTUAL <RXFDQXVH\RXUYLUWXDO
lELDS ONLY BY CALLING THE ABSTRACT GETTERS AND SETTERS WHICH THE
#ONTAINER IMPLEMENTS AT DEPLOY
TIME UHODWLRQVKLSILHOGVMXVW
4HE ONLY NEW RESTRICTION IS THAT A RELATIONSHIP lELD CAN BE
ONLY A LOCAL COMPONENT INTERFACE TYPE 9OU CANT HAVE A #-2
DV\RXZRXOGDQ\RWKHU
RELATIONSHIP lELD THAT USES A BEANS 2EMOTE INTERFACE YLUWXDOILHOGE\FDOOLQJ
9LUWXDOÀHOGLQWKHEHDQFODVV WKHDEVWUDFWJHWWHUVWKDW
<28GHILQHGEXWZKLFK
SXEOLFDEVWUDFW'LUHFWRUJHW'LUHFWRU
SXEOLFDEVWUDFWYRLGVHW'LUHFWRU 'LUHFWRUG WKH&RQWDLQHULPSOHPHQWV
type of a 7KHW\SHRIDUHODWLRQVKLS
The argument and return ays another
CMR Òvirtual ÞeldÓ is alwMUST be a ILHOG0867EHWKHORFDO
Entity bean type, and itÕt have a virtual
local interface!! You can te interface. FRPSRQHQWLQWHUIDFHRI
Þeld to the entityÕs Remo
WKHHQWLW\
([SRVHGEXVLQHVVPHWKRGLQWKHEHDQFODVV
$&05ILHOGZLOO
SXEOLF'LUHFWRUJHW0RYLH'LUHFWRU ^
$/:$<6EHDORFDO
UHWXUQJHW'LUHFWRU
` FRPSRQHQWLQWHUIDFHW\SH
tor to a
Now we can return the Direc act getter.
client, by calling the ab str
SXEOLF6WULQJJHW0RYLH'LUHFWRU1DPH ^
UHWXUQJHW'LUHFWRU JHW'LUHFWRU1DPH
`
We can also do the wo
client, if we donÕt wantrk on behalf of the
Director reference to thto expose the real
thatÕs how weÕre going to e client. In fact,
Director is a local interfado it, because the
is going to have Remote ce, but the Movie
clients.
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
,MNQVQVOZMTI\QWV[PQX[QVaW]ZIJ[\ZIK\
XMZ[Q[\MVKM[KPMUIQV\PM,,
#-0 lELD DElNITIONS ARE SO EASY 9OU DECLARE A CMP
lELD AND GIVE
IT A NAME THAT MATCHES ONE OF YOUR GETTERSETTER PAIRS FOLLOWING THE
NAMING RULE OF DROPPING THE hGETv AND hSETv AND BEGINNING THE #-0
lELD NAME WITH A LOWER
CASE LETTER
"UT #-2 IS MORE INVOLVED 9OU CANT BE IN A RELATIONSHIP WITH ONLY
YOURSELF SO A RELATIONSHIP ALWAYS INCLUDES TWO BEANS
ionship has
'HÀQHDQHMEUHODWLRQEHWZHHQWZREHDQV Every relawto beans.
exactly t
$ 'HÀQHDQHMEUHODWLRQVKLSUROHIRURQHEHDQ
Multiplicity of this bean (i.e . how many of
R par ticipant have)
PXOWLSOLFLW\IRUWKLVEHDQ this type will the OTHE
g about?
Which bean are we really talkin
VRXUFHIRUWKLVEHDQ
in the bean class
FPUÀHOGIRUWKLVEHDQ Must match the Òvirtual ÞeldÓ
FDVFDGHGHOHWHIRUWKLVEHDQ
Only if THIS bean wa s
when its partner is dent to be deleted
leted.
$ 'HÀQHDQHMEUHODWLRQVKLSUROHIRUWKHVHFRQGEHDQ
PXOWLSOLFLW\IRUWKLVEHDQ
for the
VRXUFHIRUWKLVEHDQ Same stuffrticipant in
second paionship
FPUÀHOGIRUWKLVEHDQ the relat
FDVFDGHGHOHWHIRUWKLVEHDQ
\RXDUHKHUH
UHODWLRQVKLSVLQWKHGHSOR\PHQWGHVFULSWRU
5HODWLRQVKLSGHÀQLWLRQIRUWKH 0RYLH 'LUHFWRU
'LUHFWRUWR0RYLHUHODWLRQVKLS 'LUHFWRUJHW'LUHFWRU &ROOHFWLRQJHW0RYLHV
'HÀQHDQHMEUHODWLRQEHWZHHQWZREHDQV
Each <ejb-relation> descr
They REALLY should ha ibes one pair of beans... one relationship.
HMEUHODWLRQ!
ve named this <ejb-relation
ship>
$ 'HÀQHDQHMEUHODWLRQVKLSUROHIRURQHEHDQ
HMEUHODWLRQVKLSUROH!
HMEUHODWLRQVKLSUROHQDPH!'LUHFWRU%HDQ HMEUHODWLRQVKLSUROHQDPH!
This is a made-up name! ItÕ
choose to call the ROLE. s simply what you
it ÒDirectorRoleÓ or anyt We could have called
PXOWLSOLFLW\IRUWKLVEHDQ participant weÕre talking hing that tells us which
about.
PXOWLSOLFLW\!2QH PXOWLSOLFLW\!
Remember, this does NOT say how man
participant the Director bean will hav y of the other
e...
many of THIS bean the OTHER partne it says how
Movie will have only ONE Director. r will have.
VRXUFHIRUWKLVEHDQ
UHODWLRQVKLSUROHVRXUFH!
HMEQDPH!'LUHFWRU%HDQ HMEQDPH!
We can use any role-name we want, but
UHODWLRQVKLSUROHVRXUFH! sooner or later the Container must know
EXACTLY which bean weÕre talking about.
Put the beanÕs <ejb-name> which is just a
label telling the Container where to Þnd
this beanÕs real deÞnition in the <enterprise-
beans> section of the DD. This MUST
match an <ejb-name> in the DD.
FPUÀHOGIRUWKLVEHDQ
FPU¿HOG!
FPU¿HOGQDPH!PRYLHV FPU¿HOGQDPH!
This must match a Òvirtual ÞeldÓ in the
bean class for getMovies() / setMovies
()
FPU¿HOGW\SH!MDYDXWLO&ROOHFWLRQ FPU¿HOGW\SH!
FPU¿HOG!
Use <cmr-Þeld-type> ONLY if
partner has a MANY relationshipthe to
other
this
FDVFDGHGHOHWHIRUWKLVEHDQ bean, which means you will hold more tha
one, so you need a Collection. You can n
QRWVSHFL¿HGIRUWKLVEHDQ
say java.util.Set (your only two choicesalso
HMEUHODWLRQVKLSUROH!
)
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
$ 'HÀQHDQHMEUHODWLRQVKLSUROHIRUWKHVHFRQGEHDQ
HMEUHODWLRQVKLSUROH!
HMEUHODWLRQVKLSUROHQDPH!0RYLH%HDQ HMEUHODWLRQVKLSUROHQDPH!
Remember, this is just a name for
your own (or the App Assembler or a
toolÕs) use. It means nothing in your
PXOWLSOLFLW\IRUWKLVEHDQ Java code.
PXOWLSOLFLW\!0DQ\ PXOWLSOLFLW\!
This means Director will have MANY of
type (Movie). Se we expect that Direct this
have a CMR Þeld with a Collection typ or will
than a single Movie e rather
VRXUFHIRUWKLVEHDQ
UHODWLRQVKLSUROHVRXUFH!
HMEQDPH!0RYLH%HDQ HMEQDPH! This MUST match the <ejb-name> for
UHODWLRQVKLSUROHVRXUFH! where you deÞned the Movie entity
bean in the <enterprise-beans> section
of the DD.
FPUÀHOGIRUWKLVEHDQ
FPU¿HOG!
nÕt have a
FPU¿HOGQDPH!GLUHFWRU FPU¿HOGQDPH!
Look... no type! Webedocause it isnÕt a
FPU¿HOG!
<cmr-Þeld-type> , the only reason
Collection. In facteld-type> tag is
thereÕs a <cmr-Þ type is a Col-
for when the Þeld ve to distinguish
lection, and you ha llection. <cmr-
FDVFDGHGHOHWHIRUWKLVEHDQ between Set or Co
Þeld-type>
FDVFDGHGHOHWH!
Put this in if you want THIS
bean to be deleted whenever its
HMEUHODWLRQVKLSUROH! partner is deleted.
HMEUHODWLRQ!
\RXDUHKHUH
HQWLW\EHDQUHODWLRQVKLSV
6KDUSHQ \RXU SHQFLO
(ERES THE RELATIONSHIP $$ FOR $IRECTOR TO 0RYLH 'LUHFWRU
-OVIE BUT WEVE LEFT A FEW THINGS OUT 3EE IF 'LUHFWRUJHW'LUHFWRU &ROOHFWLRQJHW0RYLHV
YOU CAN l LL THEM IN CORRECTLY WITHOUT LOOKING
ON THE PREVIOUS PAGES
, QZMK\WZ\W5W^QMZMTI\QWV[PQX
UHODWLRQVKLSV!
HMEUHODWLRQ!
HMEUHODWLRQVKLSUROH!
HMEUHODWLRQVKLSUROHQDPH! HMEUHODWLRQVKLSUROHQDPH!
PXOWLSOLFLW\! PXOWLSOLFLW\!
UHODWLRQVKLSUROHVRXUFH!
HMEQDPH!'LUHFWRU%HDQ HMEQDPH!
UHODWLRQVKLSUROHVRXUFH!
FPU¿HOG!
FPU¿HOGQDPH! FPU¿HOGQDPH!
FPU¿HOG!
HMEUHODWLRQVKLSUROH!
HMEUHODWLRQVKLSUROH!
HMEUHODWLRQVKLSUROHQDPH!0RYLH%HDQ HMEUHODWLRQVKLSUROHQDPH!
PXOWLSOLFLW\! PXOWLSOLFLW\!
FDVFDGHGHOHWH!
UHODWLRQVKLSUROHVRXUFH!
HMEQDPH! HMEQDPH!
UHODWLRQVKLSUROHVRXUFH!
HMEUHODWLRQVKLSUROH!
HMEUHODWLRQ!
UHODWLRQVKLSV!
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
'RHVWKLVPHDQWKDWZKHQ
DEHDQLVLQDUHODWLRQVKLSLW
0867KDYHDÀHOGIRUWKHRWKHU
EHDQ":KDWLI,ZDQW0RYLHWRKDYH
D7UDLOHUEXW,GRQ·WZDQWDQ\ERG\
WRXVH7UDLOHUWRJHWWRD0RYLH" 0RYLH 7UDLOHU
7UDLOHUJHW7UDLOHU QRUHIHUHQFHWR0RYLH
:MTI\QWV[PQX[KIVJMWVM_Ia
] VQLQZMK\QWVIT
9OU CAN HAVE A RELATIONSHIP BETWEEN TWO
BEANS BUT HAVE A #-2 l ELD IN ONLY ONE OF
THE TWO BEANS &OR EXAMPLE IF YOU SET UP A
RELATIONSHIP BETWEEN A -OVIE AND ITS 4RAILER
A ONE
TO
ONE RELATIONSHIP AND YOU DONT
WANT CLIENTS TO USE A 4RAILER TO GET TO A -OVIE
JUST LEAVE THE #-2 l ELD FOR -OVIE OUT OF THE
4RAILER BEAN 3IMPLE AS THAT
)N THAT CASE THE 4RAILER"EAN WONT KNOW
ANYTHING ABOUT THE -OVIE"EAN EVEN THOUGH
THEYRE BOTH PARTNERS IN A RELATIONSHIP
HMEUHODWLRQVKLSUROH!
HMEUHODWLRQVKLSUROHQDPH!7UDLOHU%HDQ HMEUHODWLRQVKLSUROHQDPH!
PXOWLSOLFLW\!2QH PXOWLSOLFLW\!
FDVFDGHGHOHWH!
UHODWLRQVKLSUROHVRXUFH!
HMEQDPH!7UDLOHU%HDQ HMEQDPH!
UHODWLRQVKLSUROHVRXUFH!
FPU¿HOG!
FPU¿HOGQDPH! FPU¿HOGQDPH! Leave the cmr-Þeld out of a
FPU¿HOG! relationship role if you donÕt want
HMEUHODWLRQVKLSUROH! this bean to hav e a reference to its
partner bean.
\RXDUHKHUH
GLUHFWLRQDOLW\LQUHODWLRQVKLSV
<PMLIZS[QLMWNI]VQLQZMK\QWVITWVM_IaZMTI\QWV[PQX
+H\ZH·UH
LQDUHODWLRQVKLS <HV
WRJHWKHU ZHDUH
1RZH·UHQRW
1RZH·UHQRW
7UDLOHU
0RYLH 7UDLOHU 0RYLH
'RQ·W\RXWKLQN,·G
$UH NQRZLI,ZHUHLQD
$UH UHODWLRQVKLS",GRQ·W
1RW HYHQOLNH\RX
7UDLOHU
0RYLH 7UDLOHU
0RYLH
<RX·UHLQWKH''ZLWK 7KDW·VQRWHYHQWKH
PHEDE\$QG,KDYHDYLUWXDO %(67SDUW\RX·UHVHW
ÀHOGIRU\RXHYHQWKRXJK\RX WRFDVFDGHGHOHWHVRWKDW
GRQ·WKDYHRQHIRUPH ZKHQ,GLH\RXGLH6R\RX
EHWWHUWDNHJRRGFDUH
2KJUHDW,·PLQD RIPH
UHODWLRQVKLSDJDLQVW
P\ZLOOZLWKQR
NQRZOHGJH
0RYLH
7UDLOHU 0RYLH 7UDLOHU
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
+I[KILMLMTM\MKIVXZWXIOI\M
'LUHFWRU 0RYLH 7UDLOHU
,QZMK\WZ\W5W^QM 5W^QM\W<ZIQTMZ
ZMTI\QWV[PQX ZMTI\QWV[PQX
'LUHFWRU FDQ·WFDVFDGHGHOHWH 0RYLH FRXOGFDVFDGHGHOHWHEXWGRHVQ·W
ZDQWWR
0RYLH FDVFDGHGHOHWH!
7UDLOHU FDVFDGHGHOHWH!
<RXFDQ·WVHWFDVFDGHGHOHWHIRUWKH'LUHFWRU
EHDQLQWKH'LUHFWRUWR0RYLHUHODWLRQVKLS %HFDXVHWKLVLVDRQHWRRQHUHODWLRQVKLSERWK
EHFDXVH0RYLHKDVDPXOWLSOLFLW\RI0DQ\7KLQN SDUWQHUVFRXOGVHWDFDVFDGHGHOHWH%XWZH
DERXWLWLIVRPHRQHGHOHWHVD0RYLHVKRXOG ZDQWLWWRJRLQRQO\RQHGLUHFWLRQZKHUH
WKDW'LUHFWRUEHGHOHWHG"2IFRXUVHQRW7KH GHOHWLQJWKH0RYLHGHOHWHVWKH7UDLOHUEXW
'LUHFWRUFRXOGVWLOOEHWKH'LUHFWRURIRWKHU QRWWKHUHYHUVH-XVWEHFDXVHWKH7UDLOHU
PRYLHVWKDWVWLOOH[LVW LVGHOHWHGGRHVQRWPHDQZHZDQWWKH0RYLH
GHOHWHGEXWWKDW·VGHWHUPLQHGE\RXUEXVLQHVV
%XWWKH'LUHFWRUKDVDPXOWLSOLFLW\RI2QH ORJLFDQGQRW(-%UXOHV
ZLWKWKH0RYLHVRWKH0RYLHEHDQFDQVD\´,
FDQKDYHRQO\RQH'LUHFWRUVRLIKHJRHV,JRµ
D'LUHFWRUUHPRYH
'LUHFWRU 7UDLOHU
0RYLH
D0RYLHUHPRYH
'LUHFWRU 0RYLH
7UDLOHU
D7UDLOHUUHPRYH
'LUHFWRU 0RYLH 7UDLOHU
\RXDUHKHUH
UHODWLRQVKLSVLQWKHGHSOR\PHQWGHVFULSWRU
<PMIJ[\ZIK\[KPMUIQ[QV\PM$MV\Q\a&MTMUMV\IVL\PM
$MRJZMTI\QWV&Q[QV\PM$ZMTI\QWV[PQX[&MTMUMV\
HMEMDU!
GLVSOD\QDPH!0RYLH-DU GLVSOD\QDPH!
HQWHUSULVHEHDQV!
HQWLW\!
GLVSOD\QDPH!0RYLH%HDQ GLVSOD\QDPH!
HMEQDPH!0RYLH%HDQ HMEQDPH!
ORFDOKRPH!KHDG¿UVW0RYLH+RPH ORFDOKRPH!
ORFDO!KHDG¿UVW0RYLH ORFDO!
HMEFODVV!KHDG¿UVW0RYLH%HDQ HMEFODVV!
SHUVLVWHQFHW\SH!&RQWDLQHU SHUVLVWHQFHW\SH!
SULPNH\FODVV!MDYDODQJ6WULQJ SULPNH\FODVV!
UHHQWUDQW!)DOVH UHHQWUDQW!
FPSYHUVLRQ![ FPSYHUVLRQ!
DEVWUDFWVFKHPDQDPH!0RYLH6FKHPD DEVWUDFWVFKHPDQDPH!
FPS¿HOG!
¿HOGQDPH!JHQUH ¿HOGQDPH! The abstract schema for persiste
FPS¿HOG! Þelds is deÞned HERE in the <ennt
FPS¿HOG! element under <enterprise-beans>,tity >
whe
¿HOGQDPH!PRYLH,' ¿HOGQDPH! all beans are described. re
FPS¿HOG!
FPS¿HOG!
missing!! There
¿HOGQDPH!\HDU ¿HOGQDPH! WHOA! Notice whatfoÕs r Director. You
FPS¿HOG! is NO <cmp-Þeld>eld> elements inside
FPS¿HOG! donÕt list <cmr-Þion. TheyÕre deÞned
¿HOGQDPH!WLWOH ¿HOGQDPH!
the <entity> sect tionships> section
ONLY in the <rela
FPS¿HOG!
SULPNH\¿HOG!PRYLH,' SULPNH\¿HOG!
VHFXULW\LGHQWLW\! (next page)
XVHFDOOHULGHQWLW\! XVHFDOOHULGHQWLW\!
VHFXULW\LGHQWLW\!
HQWLW\!
HQWLW\!
GLVSOD\QDPH!'LUHFWRU%HDQ GLVSOD\QDPH!
HMEQDPH!'LUHFWRU%HDQ HMEQDPH!
ORFDOKRPH!KHDG¿UVW'LUHFWRU+RPH ORFDOKRPH!
ORFDO!KHDG¿UVW'LUHFWRU ORFDO!
HMEFODVV!KHDG¿UVW'LUHFWRU%HDQ HMEFODVV!
SHUVLVWHQFHW\SH!&RQWDLQHU SHUVLVWHQFHW\SH!
SULPNH\FODVV!MDYDODQJ6WULQJ SULPNH\FODVV!
UHHQWUDQW!)DOVH UHHQWUDQW!
FPSYHUVLRQ![ FPSYHUVLRQ!
DEVWUDFWVFKHPDQDPH!'LUHFWRU6FKHPD DEVWUDFWVFKHPDQDPH!
FPS¿HOG!
¿HOGQDPH!QDPH ¿HOGQDPH!
FPS¿HOG!
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
FPS¿HOG!
¿HOGQDPH!ZLQQHU ¿HOGQDPH!
FPS¿HOG!
FPS¿HOG!
¿HOGQDPH!GLUHFWRU,' ¿HOGQDPH!
FPS¿HOG!
FPS¿HOG!
¿HOGQDPH!GHJUHHV ¿HOGQDPH!
FPS¿HOG!
SULPNH\¿HOG!GLUHFWRU,' SULPNH\¿HOG!
VHFXULW\LGHQWLW\!
XVHFDOOHULGHQWLW\! XVHFDOOHULGHQWLW\!
VHFXULW\LGHQWLW\!
HQWLW\! ise-beans> section
HQWHUSULVHEHDQV! AFTER the <enterhaprve been described), we
(and all the beans ships> section that uses
UHODWLRQVKLSV! have the <relationnts to refer BACK to the
HMEUHODWLRQ! <ejb-name> eleme > section
<enterprise-beans
HMEUHODWLRQVKLSUROH!
HMEUHODWLRQVKLSUROHQDPH!'LUHFWRU%HDQ HMEUHODWLRQVKLSUROHQDPH!
PXOWLSOLFLW\!2QH PXOWLSOLFLW\!
UHODWLRQVKLSUROHVRXUFH! This name MUST match someth
HMEQDPH!'LUHFWRU%HDQ HMEQDPH!
DD, described in an <entity> eleing in this
UHODWLRQVKLSUROHVRXUFH!
<enterprise-beans> section ment in the
FPU¿HOG!
FPU¿HOGQDPH!PRYLHV FPU¿HOGQDPH!
FPU¿HOGW\SH!MDYDXWLO&ROOHFWLRQ FPU¿HOGW\SH!
FPU¿HOG! <cmr-Þeld-type> is only when
HMEUHODWLRQVKLSUROH! necessari your partner (not
ly YOU) has a mu licity of Ma
be ONLY Collection or Setltip(NO ny. This can
T List, Map, etc.)
HMEUHODWLRQVKLSUROH!
HMEUHODWLRQVKLSUROHQDPH!0RYLH%HDQ HMEUHODWLRQVKLSUROHQDPH!
PXOWLSOLFLW\!0DQ\ PXOWLSOLFLW\!
FDVFDGHGHOHWH!
UHODWLRQVKLSUROHVRXUFH! MovieBean says, ÒYou can delete
HMEQDPH!0RYLH%HDQ HMEQDPH! when you delete my Director me
UHODWLRQVKLSUROHVRXUFH!
Ó
FPU¿HOG!
FPU¿HOGQDPH!GLUHFWRU FPU¿HOGQDPH!
FPU¿HOG!
HMEUHODWLRQVKLSUROH! ause the Director has a
No <cmr-Þeld-type> bec tionship, so we return
HMEUHODWLRQ! multiplicity of One in this rela n of Directors.
UHODWLRQVKLSV! only one Director, not a Collectio
\RXDUHKHUH
WKH0RYLH%HDQFRGH
5W^QM*MIVKWLM_Q\PI+5:NQMTL
SDFNDJHKHDG¿UVW
LPSRUWMDYD[HME
LPSRUWMDYD[QDPLQJ
LPSRUWMDYDXWLO
SXEOLFDEVWUDFWFODVV0RYLH%HDQLPSOHPHQWV(QWLW\%HDQ^
SULYDWH(QWLW\&RQWH[WFRQWH[W
SXEOLF6WULQJHME&UHDWH 6WULQJPRYLH,'6WULQJWLWOHLQW\HDU6WULQJJHQUH
6WULQJGLUHFWRU,' WKURZV&UHDWH([FHSWLRQ^
r
VHW0RYLH,' PRYLH,'
we se t ou r pe rs ist en t Þelds, by calling ourence
VHW7LWOH WLWOH Here e must NOT try toTha refe
VHW<HDU \HDU abstract setters. WRE L ATIONS HI PS . t has to
our ow n pe rs ist en t at happens
en inserted, and th
VHW*HQUH JHQUH
UHWXUQQXOO wa it un ti l W E ha ve be
e() completes.
`
only AFTER ejbCreat
SXEOLFYRLGHME3RVW&UHDWH 6WULQJPRYLH,'6WULQJWLWOHLQW\HDU6WULQJJHQUH
6WULQJGLUHFWRU,' WKURZV&UHDWH([FHSWLRQ^
WU\^
,QLWLDO&RQWH[WFW[ QHZ,QLWLDO&RQWH[W
'LUHFWRU+RPHGLU+RPH 'LUHFWRU+RPH FW[ORRNXS ³MDYD FRPSHQYHME'LUHFWRU+RPH´
'LUHFWRUGLU GLU+RPH¿QG%\3ULPDU\.H\ GLUHFWRU,'
VHW'LUHFWRU GLU
`FDWFK ([FHSWLRQH[
^KDQGOHH[FHSWLRQ`
Now itÕs safe to assign our persistent relationship
` Þeld for Director. We lookup the Director (using
the directorID parameter from create) and call our
abstract setter to assign this Director.
SXEOLF6WULQJHME+RPH/LVW0RYLHV%\'LUHFWRU$QG*HQUH 6WULQJGLU,'6WULQJJHQUH ^
6WULQJOLVW QXOO
WU\^
&ROOHFWLRQF HME6HOHFW*HW0RYLHV%\'LUHFWRU$QG*HQUH GLU,'JHQUH
,WHUDWRULW FLWHUDWRU
t to
ZKLOH LWKDV1H[W ^
e ss m e t h o d for the clien the
OLVW LWQH[W A home businf all the movies that Þtthat
` get a list ouse an ejbSelect method cts.
`FDWFK ([FHSWLRQH[ ^H[SULQW6WDFN7UDFH `
query. We ollection of String objehe
UHWXUQOLVW
returns a Cselect method, we let tcode!
` ng a base
By usi write all the data
Container
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
SXEOLF6WULQJHME+RPH/LVW$OO0RYLHV ^
6WULQJOLVW QXOO
WU\^
&ROOHFWLRQF HME6HOHFW*HW$OO0RYLHV nother home business method
A to Þnd
,WHUDWRULWD FLWHUDWRU
th at uses a select methodturns a
re
all movies. This selecaltMovie objects,
ZKLOH LWDKDV1H[W ^
0RYLHPRYLH 0RYLH LWDQH[W ac tu
OLVW ³³PRYLHJHW0RYLH7LWOH Collection of it and pull out
` so we walk through we can return a
the titles, so thatclient.
`FDWFK ([FHSWLRQH[ ^KDQGOHH[FHSWLRQ` big String to the
UHWXUQOLVW
`
SXEOLF6WULQJJHW0RYLH7LWOH ^
UHWXUQJHW7LWOH
Two exposed business methods from
`
the component interface...
SXEOLF6WULQJJHW0RYLH'LUHFWRU1DPH ^
UHWXUQJHW'LUHFWRU JHW'LUHFWRU1DPH
`
SXEOLFDEVWUDFW6WULQJJHW0RYLH,'
SXEOLFDEVWUDFWYRLGVHW0RYLH,' 6WULQJL
We have FIVE virtual Þelds:
SXEOLFDEVWUDFW6WULQJJHW7LWOH
SXEOLFDEVWUDFWYRLGVHW7LWOH 6WULQJW
four CMP Þelds and
SXEOLFDEVWUDFWLQWJHW<HDU
SXEOLFDEVWUDFWYRLGVHW<HDU LQW\ one CMR Þeld for Director.
SXEOLFDEVWUDFW6WULQJJHW*HQUH
SXEOLFDEVWUDFWYRLGVHW*HQUH 6WULQJJ
SXEOLFDEVWUDFW'LUHFWRUJHW'LUHFWRU
SXEOLFDEVWUDFWYRLGVHW'LUHFWRU 'LUHFWRUG
SXEOLFDEVWUDFW&ROOHFWLRQHME6HOHFW*HW$OO0RYLHV WKURZV)LQGHU([FHSWLRQ
SXEOLFDEVWUDFW&ROOHFWLRQHME6HOHFW*HW0RYLHV%\'LUHFWRU$QG*HQUH 6WULQJGLU6WULQJ
JHQUH WKURZV)LQGHU([FHSWLRQ
The two select methods are declared as
abstract methods. The Collection doesnÕt say
SXEOLFYRLGXQVHW(QWLW\&RQWH[W ^` WHAT the methods will return... but weÕll tell
SXEOLFYRLGHME/RDG ^`
SXEOLFYRLGHME6WRUH ^`
the Container that one will return a Collection
SXEOLFYRLGHME$FWLYDWH ^` of Movies and one a Collection of Strings.
SXEOLFYRLGHME3DVVLYDWH ^`
SXEOLFYRLGHME5HPRYH ^`
The rest are
SXEOLFYRLGVHW(QWLW\&RQWH[W (QWLW\&RQWH[WFW[ ^
regular old callback
FRQWH[W FW[ metho ds.
`
`
\RXDUHKHUH
WKH0RYLH+RPH5HPRWHLQWHUIDFH
<PM5W^QM*MIV¼[PWUMQV\MZNIKM
LPSRUWMDYD[HME
LPSRUWMDYDXWLO
LPSRUWMDYDUPL
SXEOLFLQWHUIDFH0RYLH+RPH5HPRWHH[WHQGV(-%+RPH^
SXEOLF0RYLH5HPRWHFUHDWH 6WULQJPRYLH,'6WULQJWLWOHLQW\HDU6WULQJJHQUH
6WULQJGLUHFWRU,' WKURZV&UHDWH([FHSWLRQ5HPRWH([FHSWLRQ
SXEOLF0RYLH5HPRWH¿QG%\3ULPDU\.H\ 6WULQJNH\ WKURZV)LQGHU([FHSWLRQ
5HPRWH([FHSWLRQ
SXEOLF&ROOHFWLRQ¿QG%\*HQUH 6WULQJJHQUH WKURZV)LQGHU([FHSWLRQ5HPRWH([FHSWLRQ
SXEOLF6WULQJOLVW$OO0RYLHV WKURZV)LQGHU([FHSWLRQ5HPRWH([FHSWLRQ
SXEOLF6WULQJOLVW0RYLHV%\'LUHFWRU$QG*HQUH 6WULQJGLUHFWRU,'6WULQJJHQUH
WKURZV)LQGHU([FHSWLRQ5HPRWH([FHSWLRQ
SXEOLF&ROOHFWLRQ¿QG0RYLHV%\.HYLQ'HJUHHV LQWGHJUHHV WKURZV)LQGHU([FHSWLRQ
5HPRWH([FHSWLRQ
`
Whoa! There are three
Þn
werenÕt in the bean cla der methods that
ss...
implements your Þnder remember, the Container ss m e t h o d s all start with
me ne
ANYTHING about Þnde thods--you donÕt put The home busi omeÓ when theyÕre in the
rs jb H
You put them ONLY in in your bean class code. the preÞx Òe e home, they donÕt have
h
the home. bean class. In t
(well, thatÕs not complet
ely true...somewhere yo that preÞx.
have to tell the Contai u
ner HOW to implement
Þnders, which brings us the
to the next page...)
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
+RZWKHKHFN
$QG ZKDW
GRHVWKH&RQWDLQHU DERXWWKH)LQGHU
NQRZKRZWRLPSOHPHQW PHWKRGV",FDQXQGHUVWDQG
WKHVHOHFWPHWKRGV" KRZLWFDQGRÀQG%\3ULPDU\.H\
EHFDXVHLWDOUHDG\NQRZVWKH
NH\EXWZKDWDERXWWKH
RWKHUV"
$QGZKLOH,·P
DWLW+2:'2(6,7.12:
:+$7<285),(/'60$372
,17+('$7$%$6("+RZGR\RX
OLQN\RXUDEVWUDFWVFKHPDWRUHDO
GDWDEDVHWDEOHVDQGFROXPQV"
\RXDUHKHUH
GDWDEDVHWRHQWLW\PDSSLQJ
5IXXQVONZWUIJ[\ZIK\[KPMUI\WIZMITLI\IJI[M
3OONER OR LATER YOU HAVE TO TELL THE #ONTAINER HOW AND WHERE TO MANAGE YOUR
PERSISTENT DATA 4HIS HAPPENS OUTSIDE THE DEPLOYMENT DESCRIPTOR IN A VENDOR
SPECIlC WAY 4HAT MEANS OF COURSE THAT YOURE NOT TESTED ON IT IN THE EXAM %VERY
VENDOR HAS THEIR OWN MECHANISM BUT YOULL USUALLY GET SOME SORT OF A '5) WHERE
IF YOURE LUCKY YOU CAN TELL THE #ONTAINER TO CONNECT TO A SPECIlC DATABASE AND
THEN YOULL DRAG AND DROP OR DRAW CONNECTIONS FROM #-0 lELDS TO COLUMNS IN
ONE OR MORE TABLES
"ECAUSE THIS MAPPING HAPPENS OUTSIDE OF %*" IN THE SERVER THERES NOT MUCH
WE CAN SAY ABOUT IT 4HE PART WERE MOST INTERESTED IN IS MAPPING FROM ABSTRACT
QUERIES TO 2%!, QUERIES AND THAT HAPPENS IN A VERY COOL WAY USING A VENDOR
INDEPENDENT QUERY LANGUAGE JUST FOR YOUR ENTITY BEAN QUERIES %*"
1, 7ELL LOOK
AT THAT ON THE NEXT PAGE
DEVWUDFWVFKHPDQDPH!0RYLH6FKHPD DEVWUDFWVFKHPDQDPH!
FPS¿HOG! Notice that weÕre not
ma
¿HOGQDPH!JHQUH ¿HOGQDPH! column (the one that ke pping the Director ID
ep
FPS¿HOG!
the Director table) be s the foreign key into
caus
FPS¿HOG! persistent CMP Þeld fo e we donÕt HAVE a
r
¿HOGQDPH!PRYLH,' ¿HOGQDPH! that, when we can have the Director ID. Why do
th
entity bean, instead? T e real Director, as an
FPS¿HOG!
ha
FPS¿HOG! comes in, but we donÕt tÕs where our CMR Þeld
¿HOGQDPH!\HDU ¿HOGQDPH! map that to a database
Relationships happen by .
FPS¿HOG! matching up two BEANS
the <relationships> part in
FPS¿HOG! of the DD.
¿HOGQDPH!WLWOH ¿HOGQDPH!
FPS¿HOG!
SULPNH\¿HOG!PRYLH,' SULPNH\¿HOG!
0RYLH,' 7LWOH *HQUH 'LUHFWRU,' <HDU
&URXFKLQJ3L[HOV+LGGHQ0RXVH $FWLRQ
7KH)LIWK$UUD\(OHPHQW $FWLRQ
7KH5HWXUQRIWKH%HDQ4XHHQ )DQWDV\
/RUGRIWKH/RRSV 6FL¿
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
?ZQ\QVOaW]ZXWZ\IJTMY]MZQM[NWZ[MTMK\IVLNQVLMZUM\PWL[
5HPHPEHU,·PD
SURJUDPPHUVRWKHOHVV, %*"
1, IS A PORTABLE QUERY LANGUAGE THAT LETS YOU
NQRZWKHKDSSLHU,DP:LWK WRITE 31,
LIKE STATEMENTS WRITE INTO THE DEPLOYMENT
(-%4/,GRQ·WKDYHWRNQRZ DESCRIPTOR 9OU PUT THEM IN THE 8-, AND WITHOUT
DQ\WKLQJDERXWWKHUHDOGDWDEDVH HAVING TO KNOW ANYTHING ABOUT THE REAL DATABASE
ZKHUHP\EHDQZLOOHQGXS
UXQQLQJ !S A "EAN 0ROVIDER YOU CAN HAPPILY WRITE ALL THE
QUERIES YOU WANT TRUSTING THAT THE $EPLOYER WILL IN THE
END MAP YOUR #-0 lELDS TO REAL TABLES AND DATA !LL
WE CARE ABOUT HERE IS WRITING OUR QUERIES TO MATCH THE
METHODS WEVE CHOSEN TO EXPOSE TO THE CLIENT IN THE
HOME AND COMPONENT INTERFACES
3ELECT METHODS ARE HERE SIMPLY TO MAKE YOUR LIFE
EASIER BY LETTING THE #ONTAINER BUILD THE REAL DATABASE
ACCESS CODE FROM YOUR QUERIES
3O THE PROCESS IS USUALLY SOMETHING LIKE
7RITE A HOME BUSINESS METHOD
)MPLEMENT THE HOME BUSINESS METHOD TO CALL
THE EJB3ELECT METHOD THAT DOES THE REAL DATA ACCESS
$ECLARE THE ABSTRACT SELECT METHOD IN YOUR BEAN
CLASS
7RITE THE %*"
1, FOR THE SELECT QUERY
\RXDUHKHUH
(-%4/TXHULHV
-2*94NWZ\PM5W^QM*MIV
,ETS LOOK AT THE %*"
1, FOR ALL THE QUERIES THE -OVIE"EAN NEEDS $ONT WORRY IF YOURE
NOT UNDERSTANDING ALL OF IT AFTER WE WALK THROUGH THE EXAMPLES WELL EXPLORE THE
DIFFERENT PIECES IN DETAIL AND WORK OUT THE SYNTAX )F YOU KNOW 31, MOST OF THIS WILL BE
FAMILIAR ALTHOUGH THERE ARE FEW DIFFERENCES YOULL SEE )F YOU DONT KNOW 31, THATS
/+ 7ELL GET YOU STARTED WRITING QUERIES AND YOU CAN USE THE SPEC TO LEARN MORE ABOUT
THE %*"
1, LANGUAGE 4HE EXAM EXPECTS YOU TO KNOW JUST THE BASICS OF %*"
1,
eturns a
The method r ovie objects
M
,QWKHEHDQFODVV
Collection of
SXEOLFDEVWUDFW&ROOHFWLRQHME6HOHFW*HW$OO0RYLHV WKURZV)LQGHU([FHSWLRQ
,QWKHWKHGHSOR\PHQWGHVFULSWRU
6(/(&72%-(&7 P )5200RYLH6FKHPDP
ÔmÕ
d e c la rin g a va riable... ÒLet vie
e o
This says ÒReturn what
ever This is just lik bstract schema from the M , ÒLet
representing.Ó In this ex ÔmÕ is a k e
am represent the an REALLY think of it li type.
to represent MovieSch ple, ÔmÕ is said c
bean. But you e Movie component interface means,
ema which really th Y
means the Movie entity
be ÔmÕ represent Movie beans. So it REALL
Þrst part says, ÒGive me an type. So this d s,
In other wor nt a Movie bean.
Movie beansÓ. se
ÒLet ÔmÕ repre
:KDWLWUHDOO\VD\V
³*LYHPHDOOWKH0RYLHEHDQV´
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
=[QVOIVWX\QWVIT?0-:-KTI][M
4HIS EXAMPLE CONSTRAINS THE OBJECTS RETURNED FROM THE SEARCH BY ADDING A 7(%2%
CLAUSE THAT SAYS WHAT EXTRA CRITERIA THE OBJECTS HAVE TO MEET BEFORE THEY QUALIFY FOR
hTHINGS THAT CAN BE RETURNED FROM THE QUERYv 4HE 7(%2% CLAUSE IS YOUR WAY OF
SAYING h$ONT JUST GIVE ME !.9 OLD -OVIE ) WANT /.,9 THE MOVIES THATv
eturns a
The method fr Movie objects
,QWKHEHDQFODVV Collection o
SXEOLFDEVWUDFW&ROOHFWLRQHME6HOHFW*HW$OO0RYLHV WKURZV)LQGHU([FHSWLRQ
the
en re Ó m ust b e CMP Þeld in can
Òg hich means yo u
Movie bean, w re() / setGenre()
Þnd a getGen the bean class
,QWKHWKHGHSOR\PHQWGHVFULSWRU method pair in
6(/(&72%-(&7 P )5200RYLH6FKHPDP:+(5(PJHQUH " this means the
Þrst parameter
to the method
This says we want the n t t h e
type of whatever ÔmÕ tubean Let ÔmÕ reprteysepe vie s r e t u rned to only
Movie b e a n e M o
out to be... rns restrict th C M P Þeld ÒgenreÓ
e r e t h e
those wh st p arameter of t rst
he
e s t h e Þ r he Þ
match he Ò1Ó means t he dot
c t m e t h o d T
sele st
a r a m e t e r . T h e Òm.genreÓ use ÒpathÓ
p a
rator to make
navigation ope an object-oriented
in
:KDWLWUHDOO\VD\V that navigates the left hand operand
Ñ
way. ItÕs simple he right hand is a
³*LYHPHDOOWKH0RYLHEHDQVWKDWDUHLQWKH
is a type, and t hat type. ItÕs almost
ft
member Þeld o g regular Java syntax to
JHQUHPDWFKLQJWKH¿UVWSDUDPHWHUWRWKH
HME6HOHFW*HW$OO0RYLHVPHWKRG´ n
exactly like usi enreÓ, where genre is an
e .g
say, ÒmyMovi (in this case, a virtual
le
instance variab
.)
persistent Þeld
\RXDUHKHUH
SDWKQDYLJDWLRQ
6I^QOI\QVO\WIVW\PMZZMTI\MLJMIV
4HIS EXAMPLE IS FOR A lNDER METHOD SO YOU WONT lND IT IN THE BEAN CLASS
REMEMBER YOU DECLARE ABSTRACT METHODS FOR ONLY THE SELECT METHODS NOT THE
lNDERS 4HE #ONTAINER USES YOUR HOME INTERFACE TO lGURE OUT WHAT THE lNDERS ARE
AND THEN ITS UP TO YOU TO WRITE THE %*"
1, FOR THE lNDERS
9OU CAN USE THE DOT OPERATOR TO NAVIGATE NOT JUST TO A #-0 lELD IN THE BEAN BUT TO
ANOTHER lELD WITHIN A BEAN REFERENCED IN A #-2 lELD )N OTHER WORDS )F -OVIE HAS A
REFERENCE TO A $IRECTOR AND THEYRE IN A RELATIONSHIP YOU CAN USE THE -OVIE TO GET
TO THE $IRECTOR TO ASK FOR A #-0 VALUE FROM THE $IRECTOR
,QWKHKRPHLQWHUIDFH
SXEOLF&ROOHFWLRQ¿QG0RYLHV%\.HYLQ'HJUHHV LQWGHJUHHV WKURZV)LQGHU([FHSWLRQ
5HPRWH([FHSWLRQ
ns Òthe
m.director mea ectorÕ in ÒdegreesÓ is
CMR Þeld ÔdirnÓ persistent Þa
the Movie bea the Directo eld in
,QWKHWKHGHSOR\PHQWGHVFULSWRU r bean.
6(/(&72%-(&7 P )5200RYLH6FKHPDP:+(5(PGLUHFWRUGHJUHHV "
This says that we want o you know?
objects returned wh ... and what dthat ÔmÕ restrict the Movies returned to only those
is whatever ÔmÕ turnsosoue type It turns out ovie bean where the MovieÕs Director has a CMP
be representing... t to means the M ÒdegreesÓ Þeld with a value that matches
the Þrst parameter of the Þnder.
:KDWLWUHDOO\VD\V
³*LYHPHDOOWKH0RYLHEHDQVWKDWKDYHD'LUHFWRU
ZKRVHGHJUHHVPDWFKZKDWWKHFOLHQWVHQWLQWR
WKH¿QGHUPHWKRG´
25
³,ZDQWWRJHW0RYLHVEDFNEXWRQO\WKRVH0RYLHV
GLUHFWHGE\VRPHRQHZKRLVDVSHFL¿FQXPEHU
RIGHJUHHVDZD\IURP.HYLQ%DFRQ´
6L[GHJUHHVIURP.HYLQ%DFRQLVDSRSXODUJDPH
ZKHUH\RXWU\WRWDNHD+ROO\ZRRGW\SHDQGVHH
KRZPDQ\FRQQHFWLRQVLWWDNHVWRJHWWKDWSHUVRQ
OLQNHGWR.HYLQ%DFRQµ
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
;MTMK\QVOI^IT]MZI\PMZ\PIV\PM_PWTMJMIV
4HIS EXAMPLE IS FOR A HOME BUSINESS METHOD THAT TAKES TWO PARAMETERS
AND RETURNS NOT -OVIES BUT 3TRINGS
,QWKHKRPH
LQWHUIDFH t ur ns a si ng le String, with all
This method re s that match the query.
the Movie title
SXEOLF6WULQJHME+RPH/LVW0RYLHV%\'LUHFWRU$QG*HQUH 6WULQJGLU,'6WULQJJHQUH
,QWKHWKHGHSOR\PHQWGHVFULSWRU
this is different! WeÕre returning just
Movie titles, not Movie objects
the ÒgenreÓ
m.genre means the Movie bean
6(/(&7PWLWOH)5200RYLH6FKHPDP CMP Þeld in
:+(5(PGLUHFWRUGLUHFWRU,' "$1'PJHQUH "
This restricts the matc
Movies with a Director hes to only those AND whose Movie genre value equals the
equal to the Þrst para who has an ID second parameter to the method
method meter to the
:KDWLWUHDOO\VD\V
³*LYHPHEDFN0RYLHWLWOHV 6WULQJV WKDWKDYH
WKHGLUHFWRUDQGJHQUH,VSHFL¿HGLQWKHPHWKRG
DUJXPHQWV´
\RXDUHKHUH
(-%4/6(/(&7
-2*94;-4-+<
.OW THAT YOUVE SEEN SOME QUERIES WELL LOOK AT SOME OF THE DETAILS AND RULES
4XHU\'RPDLQV
4HE DOMAIN OF A QUERY IS A SINGLE DEPLOYMENT DESCRIPTOR 3O THAT MEANS A SINGLE EJB
JAR l LE (OWEVER MANY BEANS YOU CAN SQUISH IN THE EJB
JAR THATS HOW MANY BEANS YOU
CAN SEARCH ACROSS
6(/(&7
4HE 3%,%#4 CLAUSE SAYS WHAT KIND OF THING THIS QUERY WILL RETURN
)T CAN BE ONLY ONE OF THESE TWO
DQDEVWUDFWVFKHPDW\SHIRUDQHQWLW\EHDQ
DEVWUDFWVFKHPDQDPH!0RYLH6FKHPD DEVWUDFWVFKHPDQDPH!
6(/(&72%-(&7 P )5200RYLH6FKHPDP fo r m al E J B terms (and in a
In abstract schem
the spec) the ECT variable
25 type as a SELNGE variable,
is called a RA ges over the
because it ran bean type.
D FPSÀHOG!VLQJOHYDOXHW\SHIRUDQHQWLW\EHDQ entire entity
FPS¿HOG!
¿HOGQDPH!WLWOH ¿HOGQDPH! When you use a <cmp-Þeld>
FPS¿HOG! instead of a range variable, we
6(/(&7PWLWOH)5200RYLH6FKHPDP
call this a single-valued path
expression.
NOTE: weÕre deviating from
<RXFDQ·WXVHGRWQRWD
UHWXUQD&0 5ÀHOG
WLRQWR standard spec naming conventions in
our abstract schema name, because
UH2. we want it to be OBVIOUS that
$VD6(/(&7W\SHWKHVHD
PWLWOHRUPJHQUH
weÕre using the schema name and not,
say, the bean name. In the spec, the
%XWWKLVLV1272. abstract schema name is the same
PGLUHFWRU as the component interface name.
WQRWD&05¿HOGZLWK
<RXFDQXVHD&03¿HOGEX
/(&7W\SH
WKHGRWQRWDWLRQDVWKH6(
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
-2*94;-4-+<¸_PMV\W][M7JRMK\
7HATS WITH THE /"*%#4 M THING
)TS A STRUCTURE THE *%% DESIGNERS PUT IN TO BE CONSISTENT WITH A
VERSION OF 31,
)TS ANNOYING
"UT YOU HAVE TO DO IT WHENEVER YOU RETURN A BEAN TYPE INSTEAD OF A
#-0 lELD TYPE !ND YOU MUST ./4 DO IT WHENEVER YOU RETURN A
#-0 lELD TYPE
,I\RXUHWXUQWKHEHDQ·VDEVWUDFW
VFKHPDW\SHXVH2%-(&7
DEVWUDFWVFKHPDQDPH!0RYLH6FKHPD DEVWUDFWVFKHPDQDPH!
6(/(&72%-(&7 P
,I\RXUHWXUQD FPSILHOG!
GRQ·WXVH2%-(&7
FPS¿HOG!
¿HOGQDPH!WLWOH ¿HOGQDPH!
FPS¿HOG!
6(/(&7PWLWOH
in g t h e d o t , to navigate a
If youÕre us Õt use the OBJECT ( )
path, you don
6KDUSHQ \RXU SHQFLO
&LUFOHWKH(-%4/VWDWHPHQWLILWKDVDOHJDO6(/(&7FODXVH
6(/(&72%-(&7 P )5200RYLH6FKHPDP
6(/(&7PWLWOH)5200RYLH6FKHPDP
6(/(&7P)5200RYLH6FKHPDP
6(/(&72%-(&7 PWLWOH )5200RYLH6FKHPDP
\RXDUHKHUH
(-%4/6(/(&7
?PI\LWM[Q\5-)6\WZM\]ZVIV
I J[\ZIK\[KPMUI\aXM'
7KHDEVWUDFWVFKHPDLVMXVWDVWXSLG
ODEHOLQ;0/VRREYLRXVO\7+$7LVQRW
ZKDW\RX·UHUHWXUQLQJ<RX·UHUHWXUQLQJWKH
EHDQW\SH%XWWKDWFDQ·WEHULJKWHLWKHU\RX·UH
REYLRXVO\UHWXUQLQJWKHFRPSRQHQWLQWHUIDFHW\SH
EXW7+$7FDQ·WEHULJKWEHFDXVHKRZZRXOGLW
NQRZLILW·VVXSSRVHGWRJLYH\RXWKHORFDO 7KH0RYLH6FKHPDDEVWUDFWVFKHPDQDPH
RU5HPRWHW\SH UHSUHVHQWVWKHEHDQW\SH
$VLIE\PDJLFWKH&RQWDLQHUNQRZVZKLFK
LQWHUIDFHYLHZWRUHWXUQORFDORU5HPRWH
GHSHQGLQJRQZKHWKHUWKHLQYRFDWLRQRIWKH
TXHU\FDPHIURPDKRPHRU5HPRWHLQWHUIDFH
0RYLH/RFDO 0RYLH5HPRWH
You never have JHW0RYLH,' JHW0RYLH,'
to worry aboutype JHW7LWOH JHW7LWOH
whether the t ote JHW*HQUH JHW*HQUH
is local or Rem JHW'LUHFWRU JHW'LUHFWRU
JHW7UDLOHU JHW7UDLOHU
:KHQ\RXVHHWKLV
0RYLH6FKHPDP
7KLQNWKLV
P WKHFRPSRQHQWLQWHUIDFH
DQGZH¶OOOHWWKH&RQWDLQHUVRUWRXWWKH
5HPRWHYVORFDOLVVXH
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
;-4-+<IVL.:75IZMUIVLI\WZa
9OU GOTTA HAVE 3%,%#4 AND &2/- NO MATTER WHAT BUT THE 7(%2%
CLAUSE IS OPTIONAL 7ITH 3%,%#4 YOU CAN ALSO USE THE KEYWORD $)34).#4
TO SAY THAT YOU DONT WANT ANY DUPLICATES RETURNED IN YOUR #OLLECTION
use it declare it
6(/(&7',67,1&72%-(&7 P )5200RYLH6FKHPDP
ns in the FROM, we declare
DISTINCT mea identiÞcation variable Òm the
Ó
Òno duplicates thatÕs used in the SELE Ó
CT.
4HE &2/- CLAUSE DECLARES THE IDENTIlCATION VARIABLE LIKE THE hMv IN OUR
EXAMPLE QUERY 4HIS ALSO DElNES THE DOMAIN OF THE QUERY BY SAYING TO THE
#ONTAINER h(ERES WHERE ) WANT YOU TO BE LOOKINGv 4HE ORDER IN WHICH THE
&2/- AND 3%,%#4 MIGHT FEEL A LITTLE STRANGE IF YOURE NOT USED TO 31, "UT
THINK OF IT LIKE SOMEONE SAYING h) WANT YOU TO GO GET MY THINGS AND THE THINGS
)M TALKING ABOUT ARE &2/- MY TOP DRAWERv
)F YOU NEED TO DECLARE MORE IDENTIlCATION VARIABLES TO USE LATER IN THE QUERY
YOU CAN SEPARATE THEM WITH A COMMA
6(/(&72%-(&7 P We declared two differe
)5200RYLH6FKHPDP'LUHFWRU6FKHPDG and deÞned the domain nt identiÞers,
of the query
to those two abstract sch
emas.
9OU CAN ALSO USE THE !3 KEYWORD )TS OPTIONAL BUT YOU MIGHT SEE IT ON THE EXAM
OR IN SOMEONE ELSES CODE OR YOUR COMPANY STYLE GUIDE MIGHT INSIST ON USING IT
7ERE TOO LAZY TO KEEP TYPING IT
6(/(&72%-(&7 P )5200RYLH6FKHPD$6P
\RXDUHKHUH
(-%4/LGHQWL¿HUV
1LMV\QNQMZ[
7HEN YOU MAKE AN IDENTIl ER YOU HAVE TO FOLLOW THE *AVA
PROGRAMMING LANGUAGE GUIDELINES FOR WHAT YOU CAN NAME THINGS
9OU CANT USE THE OTHER *AVA IDENTIl ERS
,GHQWLÀHUV
0XVWEHYDOLG-DYDLGHQWLILHUV
0XVW127EHVDPHDVDQ DEVWUDFWVFKHPDQDPH!
RU HMEQDPH!DQ\ZKHUHLQWKH''
0XVW127EHRQHRIWKH(-%4/UHVHUYHGZRUGV
?
:DWFKRXWIRU
TXHVWLRQVZLWK
QDPHFRQÁLFWV
(-%4/UHVHUYHGZRUGV DPH!PXVW
5HPHPEHUWKDWDQ HMEQ
FK EHDQLQ WKHHMEMDU
EHXQLTXHIRUHD
6(/(&7 25 HFRPSOHWH
ZKLFKPHDQVXQLTXHIRURQ
UWK H DEVWUDFW
''7KHVDPHLVWUXHIR
)520 %(7:((1 H! LWPXVWEH XQ LTXHLQ
VFKHPDQDP
WKH''
:+(5( /,.(
XFDQ¶WXVHDQ
<RXDOUHDG\NQRZWKDW\R
RXUTXHU\WKDW
',67,1&7 ,1 LGHQWL¿FDWLRQYDULDEOHLQ\
DP H!RU DEVWUDFW
PDWFKHVDQ HMEQ
2%-(&7 $6 DP H!LQWKH '' EXWNHHSLQ
VFKHPDQ
VHVHQVLWLYH
PLQGWKDW(-%4/LVQRWFD
18// 81.12:1
LV
6R\RXPXVW127GRWK
758( (037< 6(/(&72%-(&7 PRYLH
)5200RYLHPRYLH
)$/6( 0(0%(5
In EJB-QL, ÒMovieÓ is the
127 2) same as ÒmovieÓ, and you
canÕt have conßicting names.
$1' ,6
QRWXVHGLQWKHFXUUHQWYHUVLRQ LW¶VIXWXUHXVHLVXQNQRZQ
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
<PM?0-:-KTI][M
! 7(%2% CLAUSE IS OPTIONAL AND LETS YOU PUT EXTRA CONDITIONS ON WHATS
RETURNED 2EMEMBER THAT WITHOUT ONE WE GOT EVERYTHING OF THE TYPE USED
IN THE 3%,%#4
127XVLQJ:+(5(
6(/(&72%-(&7 P )5200RYLH6FKHPDP
([LVWLQJ(QWLWLHV (QWLWLHVUHWXUQHG
IURPWKHTXHU\
0RYLH 0RYLH 0RYLH 0RYLH
0RYLH 0RYLH
0RYLH
0RYLH 0RYLH
0RYLH
0RYLH 0RYLH 0RYLH 0RYLH
0RYLH 0RYLH 0RYLH 0RYLH
ng
Enclose a siSntgrile quotes
literal in
8VLQJ:+(5(
6(/(&72%-(&7 P )5200RYLH6FKHPDP:+(5(PJHQUH µ+RUURU¶
([LVWLQJ(QWLWLHV (QWLWLHVUHWXUQHG
IURPWKHTXHU\
movies
n g W H E RE , w e get only the their
Usi in
value ÒHorrorÓ
0RYLH 0RYLH
0RYLH 0RYLH
0RYLH that have the reÓ. (In other words,
CMP Þeld Ògenhose getGenre() method
0RYLH
0RYLH 0RYLH those movies wÒHorrorÓ.)
0RYLH 0RYLH
would return
0RYLH 0RYLH
\RXDUHKHUH
WKH:+(5(FODXVH
<PM?0-:-KTI][M
<RXFDQXVHOLWHUDOV
:+(5(PGLUHFWRUGHJUHHV!
:+(5(PJHQUH µ+RUURU¶
<RXFDQXVHLQSXWSDUDPHWHUV
:+(5(PGLUHFWRUGHJUHHV!"
$QGWKHSDUDPHWHUVGRQ·WKDYHWREHLQRUGHU
WKDW·VZK\WKH\KDYHQXPEHUV
:+(5(PJHQUH "$1'PGLUHFWRUGHJUHHV "
SXEOLF6WULQJHME+RPH/LVW0RYLHV%\'LUHFWRU$QG*HQUH 6WULQJGLU,'6WULQJJHQUH
<RXFDQGRFRPSDULVRQV
:+(5(PGLUHFWRUGHJUHHV
%XW\RXEHWWHUFRPSDUHDSSOHVWRDSSOHV
:+(5(PGLUHFWRU 6W
or
o u ca n Õt co m pare a Direct
Y eric type!
bean to a num
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
<PMXZWJTMU_Q\P][QVO+ WTTMK\QWV\aXM[
)MAGINE YOU WANT TO USE THE $IRECTOR3CHEMA TO RETURN ALL THE
$IRECTORS THAT HAVE MADE HORROR MOVIES 3OUNDS PRETTY SIMPLE
$IRECTOR HAS A #-2 l ELD FOR MOVIES AND EACH MOVIE HAS A #-0
l ELD FOR GENRE 3O WE COME UP WITH SOMETHING LIKE THIS
Þrst glance,
6(/(&72%-(&7 G Looks good on UT! This is
)520'LUHFWRU6FKHPDG but WATCH O
:+(5(GPRYLHVJHQUH µ+RUURU¶ NOT LEGAL.
7HY CANT YOU DO THIS 'RJ
,ETS BACK UP AND IMAGINE THIS IS *AVA CODE (OW DO YOU NORMALLY
USE THE DOT OPERATOR IN *AVA 9OU MIGHT DO SOMETHING LIKE
YRLGEDUN
2ZQHUR QHZ2ZQHU
e can go
RJHW'RJ EDUN This is Þne.he.. Owwner, get its 2ZQHU
through t call bark() on the
method of Ow
ner method of Dog Dog, and og. 'RJD'RJ
OwnerÕs d
'RJJHW'RJ
4HE /WNER HAS A GET$OG METHOD AND THE $OG HAS A BARK
.O PROBLEM
"UT WHAT IF WE CHANGED THE /WNER TO ALLOW ONE /WNER TO HAVE
MULTIPLE $OG OBJECTS 4HEN WHAT HAPPENS
2ZQHU
2ZQHUR QHZ2ZQHU
RJHW'RJV EDUN &ROOHFWLRQGRJV
&ROOHFWLRQJHW'RJV
method of really
Owner S !! N o w w ho are weA Dog?
YIKE this method on?
calling llection...
Or a Co
\RXDUHKHUH
XVLQJFROOHFWLRQVLQDSDWK
+WTTMK\QWV[LWV¼\JIZS
GXK
9OU CANT USE THE DOT NAVIGATION WHEN SOMETHING YOURE USING
IN THE PATH IS A #OLLECTION &OR EXAMPLE YOU CANT DO THIS
2ZQHUR QHZ2ZQHU 2ZQHU
RJHW'RJV EDUN
&ROOHFWLRQGRJV
&ROOHFWLRQJHW'RJV
you
re t ur n s a C ollection. Aecntdion!
This () on a Coll
canÕt call bark
)TS THE $OG OBJECTS ). THE COLLECTION THAT CAN BARK 3O IN
*AVA YOUD HAVE TO l RST ACCESS THE INDIVIDUAL $OG ELEMENTS IN THE
COLLECTION AND ONE AT A TIME ASK EACH $OG TO BARK 4HE $OG CODE
ABOVE IS ALMOST EXACTLY LIKE THIS 7(%2% CLAUSE WE HAD BEFORE
:+(5(GPRYLHVJHQUH µ+RUURU¶ 6 W
7KLQNDERXWLWZKDWZRXOG\RX
EHWU\LQJWRVD\KHUH"7KDWWKH
ZKROHFROOHFWLRQKDVDJHQUH"1R
DFROOHFWLRQGRHVQ·WKDYHDJHW*HQUH
!ND SINCE hMOVIESv AND hGENREv ARE VIRTUAL l ELDS
,W·VWKHPRYLHVLQWKHFROOHFWLRQWKDW
WITH ACCESSORS YOU CAN THINK OF IT JUST LIKE THIS
6W KDYHDJHW*HQUH 6RWKLVV\QWD[
GJHW0RYLHV JHW*HQUH µ+RUURU¶ GRHVQ·WPDNHVHQVH
'LUHFWRU
0RYLH
JHW'LUHFWRU,'
JHW0RYLH,'
JHW2VFDU:LQQHU
JHW7LWOH
JHW'HJUHHV
JHW*HQUH
JHW1DPH
JHW'LUHFWRU
JHW0RYLHV
JHW7UDLOHU
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
<PM16WXMZI\WZTM\[aW][Ia
¹.WZIVQVLQ^QL]ITMTMUMV\16\PM+WTTMK\QWVº
4HE ). OPERATOR FOR THE &2/- CLAUSE LETS YOU REFER TO A
#OLLECTION BUT NAME AN IDENTIl ER AS REPRESENTING /.%
MEMBER OF THE #OLLECTION
6(/(&7',67,1&72%-(&7 G
)520'LUHFWRU6FKHPDG,1 GPRYLHV P
:+(5(PJHQUH µ+RUURU¶ an individual
Let ÒmÓ represenllet ct n. So, ÒmÓ
Movie IN the Co ent iothe Collection
Now ÒmÓ represents an individual does NOT repres the Movie
Movie IN the movies Collection type, but ratherthe Collection is
(a CMR Þeld of Director) type (the type
holding.)
This query looks throug
and looks through each h all of the Directors,
Director, and looks for of the Movies of each
that matches ÔHorrorÕ. a Movie with a genre
set (no duplicates becausThe query returns a
e we said ÒDISTINCTÓ
7KH,1RSHUDWRULV
RYHUORDGHGLQ(-%4
/
of Directors
20FODXVHLVGLIIHU
7KH,1RSHUDWRULQWKH)5
FRP SDULVRQRSHUDWRUXVHGLQD
HQWIURPWKH,1
:+(5(FODXVH
XFDQVD\
,QWKH:+(5(FODXVH\R
DV\¶
GJHQUH,1 µ+RUURU¶µ)DQW
VK RUWFXWIRUVD\LQJ
DQGLWLVMXVWD
HQU H µ+ RUURU¶ 25 GJ HQUH µ)DQWDV\¶
GJ
KWKH,1RSHUDWRU
%XWLWKDVQRWKLQJWRGRZLW
HVLJQDWHLQGLYLGXDO
XVHGLQD)520FODXVHWRG
ROOH FWLRQ6RMXVWUHPHPEHU
PHPEHUV,1D&
RNDWWKHLQGLYLGXDO
)520FODXVH ,1VD\V³/R
GUDWKHUWKDQXVLQJ
REMHFWVLQWKH&ROOHFWLRQDQ
VHWKHW\SHRIWKH
WKH&ROOHFWLRQDVWKHW\SHX
LWHPV,1WKH&ROOHFWLRQ ´
³6HHLIWKH¿HOG
:+(5(FODXVH ,1VD\V
WKH OLWHUDOVLQWKLVVHW´
YDOXHPDWFKHVRQHRI
\RXDUHKHUH
(-%4/%(7:((1
<PM*-<?--6M`XZM[[QWV
,ETS SAY YOU WANT TO lND MOVIES IN THE DATABASE MADE IN THE
S AND S BUT YOU WANT TO EXCLUDE ANY MOVIES MADE IN
OR REALLY BAD MOVIE YEARS
9OU COULD SAY
6(/(&7',67,1&72%-(&7 P
)5200RYLH6FKHPDP
:+(5( P\HDU! $1'P\HDU 25
P\HDU! $1'P\HDU
/R YOU COULD DO IT THE COOLER WAY
6(/(&7',67,1&72%-(&7 P
)5200RYLH6FKHPDP
:+(5( P\HDU%(7:((1 $1' $1'
P\HDU127%(7:((1 $1'
,I,·P%(7:((1
DURFNDQGDKDUGSODFH
clusive
am pl e no ti ce th at BETWEEN is IN ERWKWKHURFNDQGWKHKDUG
In this ex 79 WILL be includ
ed), SODFHDUH,1&/8'(',
ars 19 60 an d 19 EHW\RXNQRZWKHIHHOLQJ
(i.e. the ye ive
d th at N O T B E TWEEN is EXclus
an
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
<PMW\PMZ¹16º
7EVE USED ). WITH A &2/- CLAUSE TO HELP NAVIGATE THROUGH
COLLECTIONS BUT ). HAS ANOTHER PERSONALITY YOU MIGHT SAY ).
HAS BEEN OVERLOADED FOR USE IN THE 7(%2% CLAUSE ,ETS SAY
THAT YOU WANT TO SELECT MOVIES FROM A SUBSET OF ALL THE MOVIE
GENRES IN YOUR DATABASE
6(/(&7',67,1&72%-(&7 P
)5200RYLH6FKHPDP
:+(5(PJHQUH,1 µKRUURU¶µP\VWHU\¶
e
wo ul d re tu rn on ly th ose movies whose genrlets
This query of IN
ÒmysteryÓ. This ßavored list.
is eit he r Òh or ro rÓ or at
g akin to an enumer
you created somethin
!ND THERES ALWAYS ./4 ). FOR THOSE TIMES WHEN
´ µLV127WKH
VDPHDV´ !µ
YOU NEED SOME ACTION
D
:KHQFRPSDULQJYDOXHVLQ
6(/(&7',67,1&72%-(&7 P !´P HDQ V³QRW
:+(5(FODXVH³
)5200RYLH6FKHPDP XVH 7+ $7 LQV WHD GRI
HTXDOV´<RX
:+(5(PJHQUH127,1 µURPDQFH¶µFRPHG\¶ XWFRP LQJ IURP- DYD WK DW³ ´
³ ´%
XVHHLW
FDQORRNVRULJKWZKHQ\R
RQ¶WEHWHP SWHG
This query would return only RQDTXHV WLRQ '
those movies whose genre is
NOT ÒromanceÓ or ÒcomedyÓ
6WULQJO
LWH
DUHLQ6 UDOV
,1*/(
TXRWHV
:KLOHZH
¶UHRQWKH
VLVWHQFLH WRSLFRI
VEHWZHH LQFRQ
DQG(-% Q-DYDV
4/GRQ \QWD[
D6WULQJL ¶WEHWULFN
QG HGE\
:521* RXEOHTXRWHV7K
LQ(-%4 LVLV
:+(5( /
PIRR,1
,WPXVWE ³E
H µEDU¶µE DU´³ED]´
D]¶
\RXDUHKHUH
,6(037<
<PM1;-58<AKWUXIZQ[WVM`XZM[[QWV
4HIS BABY WILL LET YOU KNOW WHETHER THE COLLECTION IN QUESTION
IS EMPTY
-XVWVKRZ
PHWKHORVHUVZKR
KDYHQ·WPDGHDQ\
6(/(&7',67,1&72%-(&7 G PRYLHV
)520'LUHFWRU6FKHPDG
:+(5(GPRYLHV,6(037<
who
y re t ur ns on ly those directors
This quer made any movies.
have not
<PM1;67<-58<AKWUXIZQ[WVM`XZM[[QWV
)3 ./4 %-049 LETS YOU SAY h$ONT GIVE ME ANYTHING WHERE THIS
lELD IS EMPTYv
6(/(&7',67,1&72%-(&7 G
)520'LUHFWRU6FKHPDG
:+(5(GPRYLHV,6127(037<
ns only those
This querywrehoturhave at least one movie
directors ovies collection.
in their m
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
<PM413-M`XZM[[QWV
,IKE EXPRESSIONS ARE USED TO COMPARE SINGLE VALUE PATH
EXPRESSIONS WITH A 3TRING LITERAL 4HE POWER OF ,)+% IS THAT THE
3TRING LITERAL CAN HAVE WILDCARD ELEMENTS GIVING YOU A SIMPLE
PATTERN MATCHER 4HE hv WILDCARD MATCHES AGAINST TO MANY
CHARACTERS THE h?v MATCHES AGAINST A SINGLE CHARACTER ONLY
6(/(&7',67,1&72%-(&7 G
)520'LUHFWRU6FKHPDG
:+(5(GSKRQH/,.(µ ¶
is a wildcard
The Ò%Ó symmanboyl characters
for 0 to
This query
who have phwonoueldnureturn only those directors
digits Ô719Õ. (Hey,mbers beginning with the
Strings, they have phone numbers can to be
those dashes...)
6(/(&7',67,1&72%-(&7 P
)5200RYLH6FKHPDP
:+(5(P¿OPFRGH/,.(µBPP¶
This query
The Ò_Ó sylembo l is a wildcard
Þlm codes arseearinchth
es for movies whose acter
e 7Xmm family. for a sing char
<PM67<413-M`XZM[[QWV
6(/(&7',67,1&72%-(&7 P
)5200RYLH6FKHPDP
:+(5(P¿OPFRGH127/,.(µPP¶
e
guess what this on
You can probrnabs lyall movies whose Þlm codes
does... retu in ÒmmÓ.
DONÕT end
\RXDUHKHUH
HQWLW\EHDQUHODWLRQVKLSV
:MDD=LHGAFLK
(QWLW\EHDQVFDQKDYHSHUVLVWHQWUHODWLRQVKLSVZLWKRWKHU WKLVEHDQZLOOWKHRWKHUSDUWQHUKDYH DQGDQRSWLRQDO
HQWLW\EHDQV FDVFDGHGHOHWH! ZKLFKVD\V´'HOHWHPHLIP\SDUWQHU
LVGHOHWHGµ
$FRQWDLQHUPDQDJHGUHODWLRQVKLS &05 ILHOGLVGHILQHG 5HODWLRQVKLSVFDQEHRQHZD\ XQLGLUHFWLRQDO RU
LQWKHEHDQFODVVMXVWDVD&03ILHOGLV³ZLWKDSDLURI
WZRZD\ ELGLUHFWLRQDO $XQLGLUHFWLRQDOUHODWLRQVKLSLV
DEVWUDFWJHWWHUVDQGVHWWHUVWKDWUHWXUQHLWKHUWKHORFDO
GHVFULEHGLQWKH''LQWKHVDPHZD\DVDELGLUHFWLRQDO
FRPSRQHQWLQWHUIDFHRIWKHEHDQRUD&ROOHFWLRQ
UHODWLRQVKLSH[FHSWWKDWRQO\RQHRIWKHWZRSDUWQHUV
,IWKHYLUWXDOILHOGLVD&ROOHFWLRQLWPXVWEHGHFODUHGDV KDVD&05ILHOG7KLVPHDQVEHDQ$KDVDUHIHUHQFHWR
HLWKHUMDYDXWLO&ROOHFWLRQRUMDYDXWLO6HW1RRWKHU&ROOHF EHDQ% WKH\·UHLQDUHODWLRQVKLS EXWEHDQ%GRHVQRW
WLRQW\SHLVDOORZHGDVWKHGHFODUHGUHWXUQW\SHRID&05 KDYHDUHIHUHQFHEDFNWR$'LUHFWLRQDOLW\GRHVQRWDIIHFW
ILHOG PXOWLSOLFLW\RUFDVFDGHGHOHWH LWMXVWPHDQVWKDWRQO\RQH
RIWKHWZRSDUWQHUVKDVDUHIHUHQFHWRWKHRWKHU7RWKH
5HODWLRQVKLSVKDYHPXOWLSOLFLWLHV³WKH\FDQEHRQHWR &RQWDLQHUWKH\·UHVWLOOLQDUHODWLRQVKLS
RQHRQHWRPDQ\RUPDQ\WRPDQ\ 0DQ\WRRQHZRUNV
LQWKHVDPHZD\WKDWRQHWRPDQ\ZRUNV LWMXVWGHSHQGV &DVFDGHGHOHWHVWHOOWKH&RQWDLQHUWRGHOHWHWKHEHDQ
RQZKRVHSRLQWRIYLHZ\RX·UHXVLQJ ZLWKWKH FDVFDGHGHOHWH!WDJZKHQWKHEHDQ·VSDUWQHU
LVGHOHWHG7KLVZRUNVRQO\LIWKHEHDQKDVDPXOWLSOLF
)RUH[DPSOHD0RYLHEHDQKDVDPDQ\WRRQHUHODWLRQ LW\RIRQH <RXZRXOGQ·WZDQWWRGHOHWHD'LUHFWRUMXVW
VKLSZLWKD'LUHFWRUEHDQ(DFK0RYLHKDVRQO\RQH EHFDXVHRQHRIWKLV0RYLHVZDVGHOHWHG EXW\RXPLJKW
'LUHFWRUEXWD'LUHFWRUFDQKDYHPDQ\0RYLHV ZDQWWRGHOHWHD0RYLHLILWVVROH'LUHFWRUZDVGHOHWHG
0XOWLSOLFLW\DIIHFWVWKHUHWXUQW\SHRIWKHYLUWXDOILHOG $EHDQFDQQRWDFFHVVLWV&05ILHOGVLQHME&UHDWH LW
0RYLHKDVRQO\RQH'LUHFWRUVRWKH&05ILHOGLQWKH PXVWZDLWXQWLOHME3RVW&UHDWH EHIRUHVD\DVVLJQLQJ
EHDQLVJHW'LUHFWRU WKDWUHWXUQVDUHIHUHQFHWRD WKH&05YLUWXDOILHOGDQDFWXDOYDOXH,QRWKHUZRUGV\RX
'LUHFWRU·VORFDOFRPSRQHQWLQWHUIDFH%XWD'LUHFWRUKDV FDQ·WXVH\RXUDEVWUDFWJHWWHUVDQGVHWWHUVIRU\RXU&05
PDQ\PRYLHVVRD'LUHFWRU·VYLUWXDOILHOGLVJHW0RYLHV ILHOGVXQWLODIWHUHME&UHDWH FRPSOHWHV
ZKLFKUHWXUQVD&ROOHFWLRQ
(-%4/LVDSRUWDEOHTXHU\ODQJXDJH\RXFDQXVHWR
$&03EHDQPXVWGHILQHDQ´DEVWUDFWSHUVLVWHQFHVFKH VSHFLI\\RXUTXHULHVIRUERWKILQGHUDQGVHOHFWPHWKRGV
PDLQWKH''WKDWOLVWVHDFKRIWKHEHDQ·V&03ILHOGV
DQGDOVRLGHQWLILHVZKLFKRIWKHILHOGVLVWKHSULPDU\NH\ ,QDQ(-%4/TXHU\WKH6(/(&7DQG)520FODXVHV
XQOHVVLW·VDFRPSRXQGSULPDU\NH\ 7KH''PXVW DUHUHTXLUHG WKH:+(5(FODXVHLVRSWLRQDO
DOZD\VGHILQHWKHW\SHRIWKHSULPDU\NH\HYHQLIWKH
$6(/(&7FDQUHWXUQHLWKHUDQ DEVWUDFWVFKHPDW\SH!
SULPDU\NH\LVQRWDILHOGRIWKHEHDQ 5HPHPEHULIWKH
ZKLFKUHDOO\PHDQVWKHEHDQ·VORFDOFRPSRQHQWLQWHU
SULPDU\NH\LVQRWDILHOGRIWKHEHDQLWPXVWEHDSUL
IDFHW\SH RUDVLQJOHYDOXHILHOG
PDU\NH\FODVVFRPSRVHGRI&03ILHOGVIURPWKHEHDQ
5HODWLRQVKLS &05 ILHOGVDUHQRWGHILQHGLQWKH HQWHU ,I\RXXVHWKHGRWQRWDWLRQIRUQDYLJDWLQJDSDWK IRUH[
SULVHEHDQ!SRUWLRQRIWKH'' ZKHUH\RXGHILQH\RXU DPSOHPJHQUH \RXFDQ·WXVHD&ROOHFWLRQW\SHDVSDUW
&03ILHOGV EXWDUHLQVWHDGGHILQHGLQWKH UHODWLRQ RIWKHSDWK7RXVHD&ROOHFWLRQW\SHDVSDUWRID)520
VKLSV!VHFWLRQRIWKH'' FODXVH\RXPXVWHQFORVHLWXVLQJWKH,1 GPRYLHV
(DFKUHODWLRQVKLSPXVWKDYHWZRSDUWQHUVZLWKHDFK RSHUDWRU
SDUWQHUGHVFULEHGLQDQ HMEUHODWLRQVKLSUROH!HOHPHQW
WKDWLQFOXGHVWKH&05ILHOGQDPHWKHVRXUFH HME
QDPH! IRUWKHSDUWQHUWKHPXOWLSOLFLW\ LHKRZPDQ\RI
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
: MTI\QWV[PQXI[[QOVUMV\[
,GLUHFWHGWKDW 1RWKDWPRYLH
! -OVIE CAN HAVE ONLY ONE $IRECTOR )F YOU SET A PRYLH7KDWPRYLH VKRXOGEH0,1(,I
LV0,1(,WEHORQJVLQ D0RYLHFDQKDYHRQO\
-OVIES $IRECTOR l ELD TO $IRECTOR THE -OVIE RQH'LUHFWRUWKHQ
0<&ROOHFWLRQ
WILL BE IN $IRECTOR S COLLECTION OF -OVIES BUT ,·PLW
IN NO OTHER $IRECTORS COLLECTION )F YOU LATER
REASSIGN THE -OVIES $IRECTOR l ELD SO THAT THE
-OVIE HAS A DIFFERENT $IRECTOR$IRECTOR THE
PREVIOUS $IRECTOR $IRECTOR WILL NO LONGER
HAVE THAT -OVIE IN ITS #OLLECTION
4HIS ALL HAPPENS AUTOMATICALLY 4O MAINTAIN THE
INTEGRITY OF THE DATABASE THE #ONTAINER MANAGES
BOTH SIDES OF THE RELATIONSHIP AT ALL TIMES 'LUHFWRU 'LUHFWRU
%HIRUH
0RYLH% 0RYLH'
0RYLH$
0RYLH& 7KHUHLVRQO\RQH0RYLH
LQ'LUHFWRU·V&ROOHFWLRQ
7KUHH0RYLHVLQ'LUHFWRU
'LUHFWRU ,W·VWKHRQO\0RYLHWKDW
·V0RYLH&ROOHFWLRQ,I\RX
ZLOOUHWXUQ'LUHFWRULI 'LUHFWRU
FDOOJHW'LUHFWRU RQDQ\RI
\RXFDOOJHW'LUHFWRU RQ
WKHVH0RYLHVWKH\ZLOOUHWXUQ
WKH0RYLH
'LUHFWRU
PRYLH$VHW'LUHFWRU PRYLH'JHW'LUHFWRU
ie AÕs
this says, ÒsetbeMwovhatever the
Director to r Movie D.Ó
$IWHU Director is fo
0RYLH% 0RYLH$
0RYLH'
0RYLH&
:KHQZHUHDVVLJQHGWKH
0RYLH$FDQKDYHRQO\RQH'LUHFWRUVRZKHQ 'LUHFWRURI0RYLH$WKDW0RYLH
'LUHFWRU ZHUHDVVLJQHGWKH'LUHFWRUIRU0RYLH$WR DXWRPDWLFDOO\PRYHGLQWR'LUHFWRU
EH'LUHFWRU0RYLH$ZDVDXWRPDWLFDOO\ ·V&ROOHFWLRQRI0RYLHV 'LUHFWRU
5(029('IURP'LUHFWRU·V&ROOHFWLRQRI
0RYLHV5HPHPEHUWKH&RQWDLQHUPDQDJHV
ERWKVLGHVRIWKHUHODWLRQVKLS
\RXDUHKHUH
DVVLJQPHQWVLQUHODWLRQVKLSV
1N\PMU]T\QXTQKQ\aWN\PMZMTI\QWV[PQXNQMTLQ[76-Q\¼[I57>-
1N\PMU]T\QXTQKQ\aQ[5)6AQ\¼[I+78A
HMEUHODWLRQVKLSUROHQDPH!0RYLH%HDQ HMEUHODWLRQVKLSUROHQDPH!
PXOWLSOLFLW\!0DQ\ PXOWLSOLFLW\!
HMEUHODWLRQVKLSUROHQDPH!'LUHFWRU%HDQ HMEUHODWLRQVKLSUROHQDPH!
PXOWLSOLFLW\!2QH PXOWLSOLFLW\!
7HEN WE ASSIGNED $IRECTOR TO -OVIE ! THE -OVIE MOVED FROM $IRECTOR S #OLLECTION TO
$IRECTOR S #OLLECTION 4HE $IRECTOR #-2 l ELD HAS A MULTIPLICITY OF /NE IN ITS RELATIONSHIP
WITH -OVIE SO A -OVIE CANT EXIST IN THE #OLLECTION OF TWO DIFFERENT $IRECTORS BECAUSE A
-OVIE CAN HAVE ONLY /NE $IRECTOR
"UT JUST BECAUSE WE MOVE THE -OVIE DOESNT MEAN THE $IRECTOR ALSO MOVES 4HE
MULTIPLICITY OF -OVIE IS -ANY SO WHEN YOU ASSIGN ANOTHER -OVIES $IRECTOR TO A DIFFERENT
-OVIE THAT $IRECTOR REFERENCE IS COPIED AND BOTH -OVIES WILL NOW HAVE A REFERENCE
7KH029,(UHIHUHQFHZDV029('IURPRQH'LUHFWRUWRDQRWKHU
PRYLH$VHW'LUHFWRU PRYLH'JHW'LUHFWRU
0RYLH$
0RYLH'
0RYLH&
'LUHFWRU
'LUHFWRU
%HFDXVHWKH'LUHFWRUWR0RYLHUHODWLRQVKLSLV2QHWR0DQ\D
0RYLHFDQ1(9(5H[LVWLQPRUHWKDQRQH'LUHFWRU·V&ROOHFWLRQ,I
\RXFKDQJHD0RYLH·V'LUHFWRUWKH0RYLHLVQRWFRSLHG,WLVPRYHG
WRWKHQHZ'LUHFWRU·V&ROOHFWLRQ
7KH',5(&725UHIHUHQFHZDV&23,('IURPRQH0RYLHWRDQRWKHU
0RYLH$
Movie DÕs
0RYLH'
0RYLH' reference wasoved.
'LUHFWRU
'LUHFWRU copied, not m
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
0XOWLSOLFLW\DQG$VVLJQPHQWV
([HUFLVH
*LYHQWKLVUHODWLRQVKLS
HMEUHODWLRQVKLSUROHQDPH!0RYLH%HDQ HMEUHODWLRQVKLSUROHQDPH!
PXOWLSOLFLW\!2QH PXOWLSOLFLW\!
HMEUHODWLRQVKLSUROHQDPH!7UDLOHU%HDQ HMEUHODWLRQVKLSUROHQDPH!
PXOWLSOLFLW\!2QH PXOWLSOLFLW\!
$QGWKLVFXUUHQWVFHQDULR
7UDLOHU%
7UDLOHU$
0RYLH 0RYLH
'UDZZKDWWKHSLFWXUHZLOOORRNOLNHDIWHU\RXUXQ
PRYLHVHW7UDLOHU PRYLHJHW7UDLOHU
Draw your
picture here...
$QVZHUWKHVHTXHVWLRQV
:KDWLVWKHUHVXOWRI PRYLHJHW7UDLOHU
:KDWLVWKHUHVXOWRI PRYLHJHW7UDLOHU
:KDWLVWKHUHVXOWRI WUDLOHU$JHW0RYLH
:KDWLVWKHUHVXOWRI WUDLOHU%JHW0RYLH
\RXDUHKHUH
H[HUFLVHVROXWLRQ
0XOWLSOLFLW\DQG$VVLJQPHQWV
6ROXWLRQ
*LYHQWKLVELGLUHFWLRQDOUHODWLRQVKLS
HMEUHODWLRQVKLSUROHQDPH!0RYLH%HDQ HMEUHODWLRQVKLSUROHQDPH!
PXOWLSOLFLW\!2QH PXOWLSOLFLW\!
HMEUHODWLRQVKLSUROHQDPH!7UDLOHU%HDQ HMEUHODWLRQVKLSUROHQDPH!
PXOWLSOLFLW\!2QH PXOWLSOLFLW\!
$QGWKLVFXUUHQWVFHQDULR
7UDLOHU%
7UDLOHU$
0RYLH 0RYLH
'UDZZKDWWKHSLFWXUHZLOOORRNOLNHDIWHU\RXUXQ
PRYLHVHW7UDLOHU PRYLHJHW7UDLOHU
null
7UDLOHU%
7UDLOHU$
null
0RYLH
0RYLH
$QVZHUWKHVHTXHVWLRQV
returns trailerB
PRYLHJHW7UDLOHU
returns null! Movie has a multiplicity of One, so a Trailer can have
only ONE Movie. A Trailer canÕt be with both Movie 1 and Movie 2
PRYLHJHW7UDLOHU
also returns null... Trailer has a multiplicity of One, so there can
be only one Trailer per Movie. Whe n Trai lerB went to Movie 1,
WUDLOHU$JHW0RYLH
TrailerA was kicked out, disco nnec ted from the relationship.
WUDLOHU%JHW0RYLH
returns Movie1, not that it has been assigned to Movie1, the Container
updates the Þeld returned from the TrailerÕs getMovie().
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
0RFN([DP
7HATS TRUE FOR AN ENTITY BEAN PROVIDER USING CONTAINER
MANAGED PERSISTENCE
1 TO CREATE PERSISTENT RELATIONSHIPS #HOOSE ALL THAT APPLY
R! ! LOCAL INTERFACE IS REQUIRED FOR SUCH A BEAN TO HAVE A BIDIRECTIONAL
RELATIONSHIP WITH ANOTHER ENTITY BEAN
R" 3UCH A BEAN CAN HAVE RELATIONSHIPS WITH ONLY SESSION BEANS
R# 2ELATIONSHIPS CAN BE ONLY ONE
TO
ONE OR ONE
TO
MANY
R$ ! GETTER METHOD RETURN TYPE CAN BE JAVAUTIL,IST
7HATS TRUE FOR AN ENTITY BEAN PROVIDER USING CONTAINER
MANAGED PERSISTENCE
2 TO CREATE PERSISTENT RELATIONSHIPS #HOOSE ALL THAT APPLY
R! ! REMOTE INTERFACE IS REQUIRED FOR SUCH A BEAN TO HAVE A BIDIRECTIONAL
RELATIONSHIP WITH ANOTHER ENTITY BEAN
R" 3UCH A BEAN CAN HAVE RELATIONSHIPS WITH ONLY MESSAGE
DRIVEN BEANS
R# ! GET METHOD RETURN TYPE CAN USE JAVAUTIL-AP
R$ 2ELATIONSHIPS CAN BE ONE
TO
ONE ONE
TO
MANY OR MANY
TO
MANY
7HEN A REMOTE CLIENT INVOKES A METHOD ON AN ENTITY BEAN USING CONTAINER
3 MANAGED PERSISTENCE AND THAT BEAN HAS ALREADY BEEN REMOVED WHAT
EXCEPTION WILL BE THROWN
R! MDYD[HME$FFHVV/RFDO([FHSWLRQ
R" MDYD[HME2EMHFW1RW)RXQG([FHSWLRQ
R# MDYDUPL1R6XFK2EMHFW([FHSWLRQ
R$ MDYDUPL6WXE1RW)RXQG([FHSWLRQ
R% MDYD[HME1R6XFK(QWLW\([FHSWLRQ
\RXDUHKHUH
FRIIHHFUDPPRFNH[DP
'IVEN THE CONTAINER
MANAGED UNIDIRECTIONAL RELATIONSHIP
4
&OO
"AR
!ND THE OBJECT RELATIONS
F
B
F
B
7HAT WILL BE TRUE AFTER THE FOLLOWING CODE RUNS #HOOSE ALL THAT APPLY
I
VHW%DU IJHW%DU
R! IJHW%DU QXOO
R" EJHW)RR QXOO
R# EJHW%DU QXOO
R% NONE OF THE ABOVE
)F AN ENTITY BEAN ! HAS BEEN REMOVED FROM A RELATIONSHIP WITH BEAN " IN
5 WHICH CASES WILL BEAN !S ACCESSOR METHOD FOR BEAN " RETURN A NON
NULL
VALUE #HOOSE ALL THAT APPLY
R! ONE
TO
ONE
R" MANY
TO
ONE
R# MANY
TO
MANY
R$ ALL OF THE ABOVE
R% NONE OF THE ABOVE
7HICH DEPLOYMENT DESCRIPTOR ELEMENTS VALUES MUST BE A TYPE OF COLLECTION
6 #HOOSE ALL THAT APPLY
R! HMEQDPH!
R" FPU¿HOG!
R# FPU¿HOGW\SH!
R$ HMEUHODWLRQ!
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
7HICH DEPLOYMENT DESCRIPTOR ELEMENTS MUST HAVE EXACTLY TWO DECLARATIONS
7 OF ANOTHER DEPLOYMENT DESCRIPTOR ELEMENT #HOOSE ALL THAT APPLY
R! HMEQDPH!
R" FPU¿HOG!
R# FPU¿HOGW\SH!
R$ HMEUHODWLRQ!
R% HMEUHODWLRQVKLSUROH!
7HICH SETS OF ELEMENTS ARE MANDATORY WITHIN AN EJB RELATIONSHIP ROLE
8 ELEMENT #HOOSE ALL THAT APPLY
R! FPU¿HOG! PXOWLSOLFLW\!
R" FPU¿HOG! UHODWLRQVKLSUROHVRXUFH!
R# PXOWLSOLFLW\! UHODWLRQVKLSUROHQDPH!
R$ PXOWLSOLFLW\! UHODWLRQVKLSUROHVRXUFH!
R% UHODWLRQVKLSUROHQDPH! UHODWLRQVKLSUROHVRXUFH!
7HICH ARE VALID VALUES FOR A CMR lELD TYPE ELEMENT #HOOSE ALL THAT APPLY
9
R! 3TRING
R" )NTEGER
R# MDYDXWLO6HW
R$ MDYDXWLO/LVW
R% MDYDXWLO&ROOHFWLRQ
7HICH SETS OF ELEMENTS ARE MANDATORY WITHIN AN EJB RELATION ELEMENT
10
R! HMEUHODWLRQQDPH! HMEUHODWLRQVKLSUROH!
R" HMEUHODWLRQVKLSUROH! HMEUHODWLRQVKLSUROH!
R# GHVFULSWLRQ! HMEUHODWLRQQDPH!
HMEUHODWLRQVKLSUROH!
R$ HMEUHODWLRQQDPH! HMEUHODWLRQVKLSUROH!
HMEUHODWLRQVKLSUROH!
\RXDUHKHUH
FRIIHHFUDPPRFNH[DP
'IVEN #-0 BEANS #USTOMER"EAN /RDER"EAN AND ,INE)TEMS"EAN WITH THE
11 FOLLOWING RELATIONSHIPS
USTOMER"EAN /RDER"EAN N
#
/RDER"EAN ,INE)TEMS"EAN N
AND THE FOLLOWING %*" 1, QUERY
%,%#4 $)34).#4 /"*%#4 C
3
&2/- #USTOMER C ). C/RDER O ). OLINE)TEMS LI
7(%2% OLSURGXFWBW\SH µUHIULJHUDWRU¶
7HICH OF THE FOLLOWING PROPERLY DESCRIBES THE RESULT OF THE QUERY #HOOSE ALL
THAT APPLY
R! 4HE QUERY IS INVALID
R" !LL ORDERS THAT INCLUDE A LINE ITEM THAT REFERS TO A REFRIGERATOR
R# !LL LINE ITEMS THAT REFER TO A REFRIGERATOR
R$ !LL CUSTOMERS THAT HAVE ORDERS THAT REFER TO A REFRIGERATOR
'IVEN #-0 BEANS #USTOMER"EAN /RDER"EAN AND ,INE)TEMS"EAN WITH THE
12 FOLLOWING RELATIONSHIPS
#USTOMER"EAN /RDER"EAN N
/RDER"EAN ,INE)TEMS"EAN N
7HICH WILL RETURN ALL ORDERS THAT HAVE LINE ITEMS #HOOSE ALL THAT APPLY
R! 3%,%#4 $)34).#4 O
&2/- /RDER O ). OLINE)TEMS LI
R" 3%,%#4 $)34).#4 /"*%#4O
&2/- /RDER O ). OLINE)TEMS LI
R# 3%,%#4 /"*%#4O
&2/- /RDER O
7(%2% OLINE)TEMS
R$ 3%,%#4 /"*%#4O
&2/- /RDER O
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
7HATS TRUE ABOUT %*" 1, PATH EXPRESSIONS #HOOSE ALL THAT APPLY
13
R! )N A PATH EXPRESSION THE IS CONSIDERED THE NAVIGATION OPERATOR
R" 0ATH EXPRESSIONS CAN TERMINATE WITH EITHER FPU¿HOG OR FPS¿HOG
R# ! PATH EXPRESSION THAT ENDS IN A FPU¿HOG CANNOT BE FURTHER
COMPOSED
R$ ! PATH EXPRESSION CAN END WITH A SINGLE VALUE OR A COLLECTION VALUE
7HATS TRUE ABOUT %*" 1, QUERIES #HOOSE ALL THAT APPLY
14
R! /F THE THREE CLAUSE TYPES 3%,%#4 &2/- AND 7(%2% ONLY THE
3%,%#4 CLAUSE IS REQUIRED
R" 4HE 3%,%#4 CLAUSE DESIGNATES QUERY DOMAIN
R# 4HE 7(%2% CLAUSE DETERMINES THE TYPES OF OBJECTS TO BE SELECTED
R$ !N %*" 1, QUERY MAY HAVE PARAMETERS
7HATS TRUE ABOUT %*" 1, 7(%2% CLAUSES #HOOSE ALL THAT APPLY
15
R! )DENTIlCATION VARIABLES USED IN A 7(%2% CLAUSE CAN BE DElNED ONLY IN
THE &2/- CLAUSE
R" )DENTIlCATION VARIABLES CAN REPRESENT A SINGLE VALUE OR A COLLECTION
R# 4HE NUMBER OF INPUT PARAMETERS MUST EQUAL THE NUMBER OF
PARAMETERS FOR THE lNDER OR SELECTOR METHOD
R$ )NPUT CLAUSES CAN ONLY BE USED IN 7(%2% CLAUSES
'IVEN THE %*" 1, EXPRESSION
16
S
GLVFRXQW %(7:((1$1'
7HICH EXPRESSION IS EQUIVALENT
R! SGLVFRXQW!$1'SGLVFRXQW
R" SGLVFRXQW! $1'SGLVFRXQW
R# SGLVFRXQW!DQGSGLVFRXQW
R$ SGLVFRXQW! DQGSGLVFRXQW
\RXDUHKHUH
FRIIHHFUDPPRFNH[DP
7HATS TRUE ABOUT %*" 1, ). EXPRESSIONS #HOOSE ALL THAT APPLY
17
R! 4HE VLQJOHBYDOXHGBSDWKBH[SUHVVLRQ MUST HAVE A 3TRING VALUE
R" 4HE ./4 LOGICAL OPERATOR CAN BE USED IN AN ). EXPRESSION
R# 4HE STRING LITERAL LIST CAN BE EMPTY
R$ 4HE FOLLOWING EXPRESSION IS LEGAL RFRXQWU\ ). h5+v h53v
18 'IVEN THE %*" 1, EXPRESSION
PRODUCTCODE ,)+% @&?S
7HICH VALUES WOULD RESULT IN A TRUE COMPARISON #HOOSE ALL THAT APPLY
R! &S
R" &S
R# &8S
R$ &S
R% &ITS
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
0RFN([DP$QVZHUV
7HATS TRUE FOR AN ENTITY BEAN PROVIDER USING CONTAINER
MANAGED PERSISTENCE
1 TO CREATE PERSISTENT RELATIONSHIPS #HOOSE ALL THAT APPLY
R! ! LOCAL INTERFACE IS REQUIRED FOR SUCH A BEAN TO HAVE A BIDIRECTIONAL
RELATIONSHIP WITH ANOTHER ENTITY BEAN
R" 3UCH A BEAN CAN HAVE RELATIONSHIPS WITH ONLY SESSION BEANS
R# 2ELATIONSHIPS CAN BE ONLY ONE
TO
ONE OR ONE
TO
MANY
R$ ! GETTER METHOD RETURN TYPE CAN BE JAVAUTIL,IST - must be Collect
ion or Set
7HATS TRUE FOR AN ENTITY BEAN PROVIDER USING CONTAINER
MANAGED PERSISTENCE
2 TO CREATE PERSISTENT RELATIONSHIPS #HOOSE ALL THAT APPLY
R! ! REMOTE INTERFACE IS REQUIRED FOR SUCH A BEAN TO HAVE A BIDIRECTIONAL - must be local
RELATIONSHIP WITH ANOTHER ENTITY BEAN
R" 3UCH A BEAN CAN HAVE RELATIONSHIPS WITH ONLY MESSAGE
DRIVEN BEANS
R# ! GET METHOD RETURN TYPE CAN USE JAVAUTIL-AP - only Collection or Set
R$ 2ELATIONSHIPS CAN BE ONE
TO
ONE ONE
TO
MANY OR MANY
TO
MANY
3 7HEN A REMOTE CLIENT INVOKES A METHOD ON AN ENTITY BEAN USING CONTAINER (spec: 132)
MANAGED PERSISTENCE AND THAT BEAN HAS ALREADY BEEN REMOVED WHAT
EXCEPTION WILL BE THROWN
R! MDYD[HME$FFHVV/RFDO([FHSWLRQ
R" MDYD[HME2EMHFW1RW)RXQG([FHSWLRQ
R# MDYDUPL1R6XFK2EMHFW([FHSWLRQ
R$ MDYDUPL6WXE1RW)RXQG([FHSWLRQ
R% MDYD[HME1R6XFK(QWLW\([FHSWLRQ
\RXDUHKHUH
PRFNH[DPDQVZHUV
'IVEN THE CONTAINER
MANAGED UNIDIRECTIONAL RELATIONSHIP
4
(spec: 138)
&OO
"AR
!ND THE OBJECT RELATIONS
F
B
F
B
7HAT WILL BE TRUE AFTER THE FOLLOWING CODE RUNS #HOOSE ALL THAT APPLY
I
VHW%DU IJHW%DU The setBar() method ÒbreaksÓ
both of the existing object
relationships and creates a single
R! IJHW%DU QXOO new one.
R" EJHW)RR QXOO
R# EJHW)RR QXOO
R$ NONE OF THE ABOVE
5 )F AN ENTITY BEAN ! HAS BEEN REMOVED FROM A RELATIONSHIP WITH BEAN " IN (spec: 132)
WHICH CASES WILL BEAN !S ACCESSOR METHOD FOR BEAN " RETURN A NON NULL
VALUE #HOOSE ALL THAT APPLY
R! ONE TO ONE
R" MANY TO ONE
R# MANY TO MANY
R$ ALL OF THE ABOVE
R% NONE OF THE ABOVE
)
(spec: 463-464
7HICH DEPLOYMENT DESCRIPTOR ELEMENTS VALUES MUST BE A TYPE OF COLLECTION
6 #HOOSE ALL THAT APPLY
R! HMEQDPH!
R" FPU¿HOG!
R# FPU¿HOGW\SH! - Collection or Set.
R$ HMEUHODWLRQ!
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
)
7 7HICH DEPLOYMENT DESCRIPTOR ELEMENTS MUST HAVE EXACTLY TWO DECLARATIONS (spec: 467-468
OF ANOTHER DEPLOYMENT DESCRIPTOR ELEMENT #HOOSE ALL THAT APPLY
R! HMEQDPH!
R" FPU¿HOG!
R# FPU¿HOGW\SH! ve two
its gotta ha sub elements
R$ HMEUHODWLRQ! <ejb-relationship-role>
R% HMEUHODWLRQVKLSUROH!
7HICH SETS OF ELEMENTS ARE MANDATORY WITHIN AN EJB RELATIONSHIP ROLE (spec: 468)
8 ELEMENT #HOOSE ALL THAT APPLY
R! FPU¿HOG! PXOWLSOLFLW\!
R" FPU¿HOG! UHODWLRQVKLSUROHVRXUFH!
R# PXOWLSOLFLW\! UHODWLRQVKLSUROHQDPH! tionship, and
whoÕs in the yrerelalated
R$ PXOWLSOLFLW\! UHODWLRQVKLSUROHVRXUFH! how are the
R% UHODWLRQVKLSUROHQDPH! UHODWLRQVKLSUROHVRXUFH!
7HICH ARE VALID VALUES FOR A CMR lELD TYPE ELEMENT #HOOSE ALL THAT APPLY (spec: 464)
9
R! 3TRING
terface
R" )NTEGER Either a loCcaoll leinction or
R# MDYDXWLO6HW type, or a local inter-
Set of the
R$ MDYDXWLO/LVW face type
R% MDYDXWLO&ROOHFWLRQ
)
7HICH SETS OF ELEMENTS ARE MANDATORY WITHIN AN EJB RELATION ELEMENT
(spec: 467-468
10
R! HMEUHODWLRQQDPH! HMEUHODWLRQVKLSUROH!
R" HMEUHODWLRQVKLSUROH! HMEUHODWLRQVKLSUROH! gotta have two
partners
R# GHVFULSWLRQ! HMEUHODWLRQQDPH!
HMEUHODWLRQVKLSUROH!
R$ HMEUHODWLRQQDPH! HMEUHODWLRQVKLSUROH!
HMEUHODWLRQVKLSUROH!
\RXDUHKHUH
PRFNH[DPDQVZHUV
'IVEN #-0 BEANS #USTOMER"EAN /RDER"EAN AND ,INE)TEMS"EAN WITH THE (spec: 233)
11 FOLLOWING RELATIONSHIPS
USTOMER"EAN /RDER"EAN N
#
/RDER"EAN ,INE)TEMS"EAN N
AND THE FOLLOWING %*" 1, QUERY
%,%#4 $)34).#4 /"*%#4 C
3
&2/- #USTOMER C ). C/RDER O ). OLINE)TEMS LI
7(%2% OLSURGXFWBW\SH µUHIULJHUDWRU¶
7HICH OF THE FOLLOWING PROPERLY DESCRIBES THE RESULT OF THE QUERY #HOOSE ALL
THAT APPLY ause
The SELECt Tthecl query
R! 4HE QUERY IS INVALID ha
speciÞes t n Customer
R" !LL ORDERS THAT INCLUDE A LINE ITEM THAT REFERS TO A REFRIGERATOR must retur
objects.
R# !LL LINE ITEMS THAT REFER TO A REFRIGERATOR
R$ !LL CUSTOMERS THAT HAVE ORDERS THAT REFER TO A REFRIGERATOR
12 'IVEN #-0 BEANS #USTOMER"EAN /RDER"EAN AND ,INE)TEMS"EAN WITH THE (spec: 236)
FOLLOWING RELATIONSHIPS
#USTOMER"EAN /RDER"EAN N
/RDER"EAN ,INE)TEMS"EAN N
7HICH WILL RETURN ALL ORDERS THAT HAVE LINE ITEMS #HOOSE ALL THAT APPLY
R! 3%,%#4 $)34).#4 O
&2/- /RDER O ). OLINE)TEMS LI
R" 3%,%#4 $)34).#4 /"*%#4O
&2/- /RDER O ). OLINE)TEMS LI
R# 3%,%#4 /"*%#4O
&2/- /RDER O
7(%2% OLINE)TEMS
R$ 3%,%#4 /"*%#4O
&2/- /RDER O
&KDSWHU
HQWLW\EHDQUHODWLRQVKLSV
7HATS TRUE ABOUT %*" 1, PATH EXPRESSIONS #HOOSE ALL THAT APPLY (spec: 225-226)
13
R! )N A PATH EXPRESSION THE IS CONSIDERED THE NAVIGATION OPERATOR
R" 0ATH EXPRESSIONS CAN TERMINATE WITH EITHER FPU¿HOG OR FPS¿HOG
R# ! PATH EXPRESSION THAT ENDS IN A FPU¿HOG CANNOT BE FURTHER
COMPOSED
R$ ! PATH EXPRESSION CAN END WITH A SINGLE VALUE OR A COLLECTION VALUE
7HATS TRUE ABOUT %*" 1, QUERIES #HOOSE ALL THAT APPLY (spec: 218-219)
14
R! /F THE THREE CLAUSE TYPES 3%,%#4 &2/- AND 7(%2% ONLY THE
3%,%#4 CLAUSE IS REQUIRED
R" 4HE 3%,%#4 CLAUSE DESIGNATES QUERY DOMAIN
R# 4HE 7(%2% CLAUSE DETERMINES THE TYPES OF OBJECTS TO BE SELECTED
R$ !N %*" 1, QUERY MAY HAVE PARAMETERS
)
7HATS TRUE ABOUT %*" 1, 7(%2% CLAUSES #HOOSE ALL THAT APPLY (spec: 227-228
15
R! )DENTIlCATION VARIABLES USED IN A 7(%2% CLAUSE CAN BE DElNED ONLY IN
THE &2/- CLAUSE
R" )DENTIlCATION VARIABLES CAN REPRESENT A SINGLE VALUE OR A COLLECTION
R# 4HE NUMBER OF INPUT PARAMETERS MUST EQUAL THE NUMBER OF
PARAMETERS FOR THE lNDER OR SELECTOR METHOD
R$ )NPUT CLAUSES CAN ONLY BE USED IN 7(%2% CLAUSES
'IVEN THE %*" 1, EXPRESSION (spec: 229)
16
S
GLVFRXQW %(7:((1$1'
7HICH EXPRESSION IS EQUIVALENT
R! SGLVFRXQW!$1'SGLVFRXQW
R" SGLVFRXQW! $1'SGLVFRXQW
R# SGLVFRXQW!DQGSGLVFRXQW
R$ SGLVFRXQW! DQGSGLVFRXQW
\RXDUHKHUH
PRFNH[DPDQVZHUV
)
17 7HATS TRUE ABOUT %*" 1, ). EXPRESSIONS #HOOSE ALL THAT APPLY (spec: 229-230
R! 4HE VLQJOHBYDOXHGBSDWKBH[SUHVVLRQ MUST HAVE A 3TRING VALUE
R" 4HE ./4 LOGICAL OPERATOR CAN BE USED IN AN ). EXPRESSION
R# 4HE STRING LITERAL LIST CAN BE EMPTY
t for
R$ 4HE FOLLOWING EXPRESSION IS LEGAL RFRXQWU\ ). h5+v h53v watche ouquotes!
doubl
(spec: 230)
18 'IVEN THE %*" 1, EXPRESSION
PRODUCTCODE ,)+% @&?S
7HICH VALUES WOULD RESULT IN A TRUE COMPARISON #HOOSE ALL THAT APPLY
R! &S
R" &S
The % charac ter is a
R# &8S r a sequence is
wildcard foter The _
R$ &S of charac fos.r a single
R% &ITS a wildcard
character
&KDSWHU
message-driven beans
5
4
4 *HWWLQJWKH0HVVDJH
:RZ0HVVDJHGULYHQ
EHDQVDUHIDQWDVWLF,FDQVHQGD
PHVVDJHDQGWKHQJREDFNWRZKDW,
ZDVGRLQJEHIRUHZLWKRXWZDLWLQJ
IRUDUHSO\7KDWPHDQV,KDYHPRUH
WLPHWRUHDGWKLVQLIW\´+HDG
)LUVW6OLGH5XOHµERRN
,W·VIXQWRUHFHLYHPHVVDJHV1RWDVPXFKIXQDVVD\JHWWLQJWKDW(%D\
SDFNDJHZLWKWKHJHQXLQH6PXUIODPSEXWIXQDQGHI¿FLHQWQRQHWKHOHVV,PDJLQH
LI\RXVHQW\RXURUGHUWR(%D\DQG\RXFRXOGQ¶WOHDYH\RXUKRXVHXQWLOWKHSDFNDJH
ZDVGHOLYHUHG7KDW¶VZKDWLW¶VOLNHZLWK6HVVLRQDQG(QWLW\EHDQVEHFDXVHWKHUH¶VDOO
FDOOVWRDEHDQ¶VFOLHQWLQWHUIDFH KRPHFRPSRQHQWORFDO5HPRWHGRHVQ¶WPDWWHU DUH
V\QFKURQRXV%XWZLWKPHVVDJHGULYHQEHDQVWKHFOLHQWPDNHVDPHVVDJHDQGVHQGVLW
WRDPHVVDJLQJVHUYLFH7KHQWKHFOLHQWZDONVDZD\/DWHUWKHPHVVDJLQJVHUYLFHVHQGV
WKH&RQWDLQHUWKHPHVVDJHDQGWKH&RQWDLQHUJLYHLWWRDPHVVDJHGULYHQEHDQ
WKLVLVDQHZFKDSWHU
H[DPREMHFWLYHV
0HVVDJH'ULYHQ%HDQV
2IILFLDO :KDWLWUHDOO\PHDQV
,GHQWLI\FRUUHFWDQGLQFRUUHFWVWDWHPHQWV <RXKDYHWRNQRZWKDWPHVVDJHGULYHQEHDQVGRQ¶W
RUH[DPSOHVDERXWWKHFOLHQWYLHZDQG KDYHFOLHQWV7KDWPHDQVQRKRPHLQWHUIDFHQR
OLIHF\FOHRIDPHVVDJHGULYHQEHDQ FRPSRQHQWLQWHUIDFHDQGQRLVVXHVRIORFDOYV
5HPRWH2IFRXUVHPHVVDJHGULYHQEHDQVGRKDYHD
FDOOHUEXWWKDW¶VWKH&RQWDLQHU$QGZHGRQ¶WFRQVLGHU
WKH&RQWDLQHUDFOLHQW7KH&RQWDLQHULVWKHERVVQRW
WKHFXVWRPHU
0HVVDJHGULYHQEHDQVKDYHDYHU\VLPSO\OLIHF\FOH²LI
\RXNQRZKRZVWDWHOHVVVHVVLRQEHDQVZRUN\RX
NQRZKRZPHVVDJHGULYHQEHDQVZRUN7KHRQO\
GLIIHUHQWLVWKDWLQVWHDGRIEULQJLQJDEHDQRXWRIWKH
SRROWRVHUYLFHDFOLHQWPHWKRGFDOOWKH&RQWDLQHU
EULQJVPHVVDJHGULYHQEHDQVRXWRIWKHSRROWR
VHUYLFHDQLQFRPLQJ-06PHVVDJH
,GHQWLI\WKHLQWHUIDFH V DQGPHWKRGVD <RXPXVWNQRZWKDWPHVVDJHGULYHQEHDQVLPSOHPHQW
PHVVDJHGULYHQEHDQPXVWLPSOHPHQW WZRLQWHUIDFHV²MDYD[HME0HVVDJH'ULYHQ%HDQWKH
LQWHUIDFHZLWKWKH&RQWDLQHUFDOOEDFNV QRWPDQ\ DQG
MDYD[MPV0HVVDJH/LVWHQHUWKHLQWHUIDFHZLWKDVLQJOH
RQ0HVVDJH 0HVVDJHP PHWKRG)RUDPHVVDJH
GULYHQEHDQRQ0HVVDJH LVWKHRQO\EXVLQHVV
PHWKRG
,GHQWLI\WKHXVHDQGEHKDYLRURIWKH <RXKDYHWRNQRZWKDWPHVVDJHGULYHQEHDQVFDQ¶W
0HVVDJH'ULYHQ&RQWH[WLQWHUIDFHPHWKRGV FDOOPRVWRIWKHPHWKRGVLQ0HVVDJH'ULYHQ&RQWH[W
HYHU7KLQNDERXWLW,IWKHUH¶VQRFOLHQWKRZFRXOG
\RXJHWFOLHQWVHFXULW\LQIR",IWKHUH¶VQRFOLHQWZKLFK
PHDQVQRFOLHQWYLHZKRZFRXOG\RXFDOOJHW(-%2E
MHFW RUJHW(-%+RPH "<RXGRQ¶WKDYHDKRPH<RX
GRQ¶WKDYHDQ(-%2EMHFW
)URPDOLVWLGHQWLI\WKHUHVSRQVLELOLW\RIWKH <RXDOVRKDYHWRUHFRJQL]HWKDWLIWKHUH¶VQRFOLHQW\RX
%HDQ3URYLGHUDQGWKHUHVSRQVLELOLW\RIWKH FDQ¶WGHFODUHDQ\FKHFNHGH[FHSWLRQV:KRZRXOG
&RQWDLQHUSURYLGHUIRUDPHVVDJHGULYHQ FDWFKWKHP"$OVRMXVWDVZLWKVWDWHOHVVVHVVLRQEHDQV
EHDQ LI\RXVWDUWDWUDQVDFWLRQLQDPHWKRG ZKLFKFDQRQO\
PHDQD%07EHDQLQRQ0HVVDJH \RXPXVW¿QLVKLW
EHIRUHWKHPHWKRGHQGV
&KDSWHU
PHVVDJHGULYHQEHDQV
1UIOQVM\PQ[[KMVIZQW
9OU HAVE TO ASK SOMEONE TO DO A VERY IMPORTANT JOB
9OU HAVE NO IDEA HOW LONG ITS GOING TO TAKE THEM
9OU HAVE TO WAIT RIGHT WHERE YOU ARE UNTIL THEY lNISH
9OU CANT DO ANYTHING ELSE WHILE YOURE WAITING
SOHDVHRKSOHDVHGRQ·W
WDNHDOOGD\RQWKLV,KDYH
62PDQ\RWKHUWKLQJV,·G
UDWKHUEHGRLQJWKDQZDLW
KHUHIRU\RXWRÀQLVK
+TQMV\
\RXDUHKHUH
PHVVDJHGULYHQEHDQV
*HH]KRZ
KDUGFDQLWEH":KDW
LVWKHVHUYHUGRLQJ "
&KDSWHU
PHVVDJHGULYHQEHDQV
+H\ZH·UHDWWKH
SRROGXGH,WKRXJKW, 7HOOKLPWRFKLOO:H·OO
WROG\RXQHYHUWRFDOOPH JHWWRLWDQGLW·VQRW
OLNHKH·VJRWDQ\WKLQJ
KHUH
EHWWHUWRGR
;MZ ^MZ
+TQMV\
JMNWZMUM[[IOMLZQ^MVJMIV[
<WWJIL\PM[MO]a[IZMV¼\
UM[[IOMLZQ^MVJMIV[
-ETHOD CALLS LOCAL OR REMOTE ARE SYNCHRONOUS
4HE CALLER IS STUCK WAITING UNTIL THE SERVER RETURNS
-ESSAGE
DRIVEN BEANS ADDED IN %*" GIVE
YOU ASYNCHRONOUS COMMUNICATION BETWEEN THE
CLIENT MESSAGE SENDER AND THE SERVER MESSAGE
RECEIVER
)N MESSAGING TERMS THE SENDER IS CALLED THE
MESSAGE 0RODUCER AND THE RECEIVER IS CALLED THE IN\MZUM[[IOMLZQ^MVJMIV[
MESSAGE #ONSUMER
7ITH MESSAGING THE 0RODUCER SENDS A MESSAGE AND
THEN GOES ABOUT HIS BUSINESS (E DOESNT HAVE TO
WAIT FOR THE #ONSUMER TO EVEN GET THE MESSAGE LET
ALONE PROCESS IT
7HEN THE #ONSUMER GETS A MESSAGE HE PROCESSES
IT )N THE MEANTIME THE CLIENT CAN STILL HAVE A LIFE
\RXDUHKHUH
PHVVDJHGULYHQEHDQV
0HVVDJHGULYHQEHDQRYHUYLHZ
&OLHQW 3URGXFHU VHQGDPHVVDJHWR
WKHPHVVDJLQJVHUYLFH
PHVVDJLQJVHUYLFH
JH
HVVD EHDQ
EHDQ
P
EHDQ
FOLHQW 0HVVDJHGULYHQ
%HDQ3RRO
3URGXFHU
0HVVDJHLVGHOLYHUHGWRWKH
&RQWDLQHU&OLHQWLVGRLQJRWKHU
FOLHQWWKLQJV
PHV
VDJ
PHVVDJLQJVHUYLFH H
WRVRP EHDQ
HRWK
VHUYHU HU EHDQ
EHDQ
FOLHQW 0HVVDJHGULYHQ
%HDQ3RRO
3URGXFHU
&RQWDLQHUDFNQRZOHGJHVWKH
PHVVDJHWRWKHVHUYLFHDQG H
DQUHPRY
SXOOVDEHDQRXWRIWKHSRROWR LW\RXF
2.JRW KHTXHX H
SURFHVVWKHPHVVDJH LWIURPW
PHVVDJLQJVHUYLFH
EHDQ
EHDQ
FOLHQW 0HVVDJHGULYHQ
EHDQ %HDQ3RRO
3URGXFHU
&KDSWHU
PHVVDJHGULYHQEHDQV
&RQWDLQHULQYRNHVWKHEHDQV
RQ0HVVDJH PHWKRGZLWKWKH
PHVVDJHDVWKHDUJXPHQW
PHVVDJLQJVHUYLFH RQ0
HVV
DJH EHDQ
PV
J
EHDQ
0HVVDJHGULYHQ
FOLHQW %HDQ3RRO
EHDQ
3URGXFHU
7KHEHDQ·VWUDQVDFWLRQFRPPLWV
DQGWKH&RQWDLQHUVHQGVWKHEHDQ
EDFNWRWKHSRRO
,IWKHEHDQ·VWUDQVDFWLRQLQ PHVVDJLQJVHUYLFH
RQ0HVVDJHKDGUROOHGEDFN
EHDQ
WKH&RQWDLQHUZRXOGKDYHWROGWKH
EHDQ
PHVVDJLQJVHUYLFHWRSXWWKH
PHVVDJHEDFNRQWKHTXHXH 0HVVDJHGULYHQ
%HDQ3RRO
EHDQ
%HDQ3RRO
,WV¼\\PMaTWWSITW\TQSM[\I\MTM[[[M[[QWVJMIV['
,IKE STATELESS SESSION BEANS MESSAGE
DRIVEN BEANS HAVE NO
UNIQUE IDENTITY TO CLIENTS ACTUALLY THEY DONT HAVE CLIENTS
SINCE THE #ONTAINER ISNT REALLY CONSIDERED A CLIENT TO THE
BEAN THEYRE POOLED AND THEY HAVE NO INDIVIDUAL STATE
THAT AFFECTS THEIR BUSINESS LOGIC 4HAT MEANS ONE MESSAGE
DRIVEN BEAN OF A PARTICULAR TYPE IS THE SAME AS ANY OTHER
BEAN FROM THE SAME HOME *UST LIKE STATELESS BEANS
\RXDUHKHUH
PHVVDJHGULYHQEHDQV
0XOWLSOHEHDQVRIWKHVDPH
W\SHFDQSURFHVVPHVVDJHV
FRQFXUUHQWO\
PVJ
HVVDJH
RQ0 EHDQ
PHVVDJLQJVHUYLFH RQ0
HVV :HOFRPH%HDQ EHDQ
DJH
PV
J
RQ
0H
VVD
JH
EHDQ
P
VJ
:HOFRPH%HDQ
:HOFRPH%HDQ 0'% %HDQ3RRO
EHDQ
:HOFRPH%HDQ
%XWWKHFRQWDLQHUZLOOPDNHVXUH
WKDWHDFKEHDQLVWKUHDGVDIH
&DQ·W\RXVHH,·P 1RSUREOHP,·OO
%86<",·YHDOUHDG\JRWD PDNHVXUHQRRWKHU
PHVVDJHJRLQJ'RQ·WJHWPH WKUHDGVERWKHU\RXXQWLO
VWDUWHGRQDQRWKHURQH \RX·UHGRQHZLWKWKLVRQH
:HOFRPH%HDQ &RQWDLQHU
&KDSWHU
PHVVDJHGULYHQEHDQV
7KHOLIHF\FOHRIPHVVDJHGULYHQEHDQV
ORRNVMXVWOLNHVWDWHOHVVVHVVLRQEHDQV
0HVVDJHGULYHQ
EHDQ
EHDQWKURZVV\VWHPH[FHSWLRQ
GRHVQRWH[LVW XQFKHFNHGXQFDXJKW
FRQVWUXFWRU
VHW0HVVDJH'ULYHQ&RQWH[W
HME5HPRYH
HME&UHDWH
n
passivatio
note: noivation
PHWKRGUHDG\ or act
RQ0HVVDJH
nly
this is the obetween message-driven beans
difference ssion have only ONE business
stateless send MDB methodÑ onMessage().
lifecycle a
lifecycle.
SXEOLFYRLGRQ0HVVDJH 0HVVDJHPVJ ^
RSHQWKHPHVVDJHDQGGRVRPHWKLQJZLWKLW
logic thing a mesth-er
`
The on ly bu si ne ss
ThatÕs it ! n do (o
needs to doÑor ca
sage-driven beancontainer callbacks for creating,
than the three tting its context)
removing, and se
\RXDUHKHUH
PHVVDJHGULYHQEHDQV
5M[[IOMLZQ^MVJMIVKTI[[
SDFNDJHKHDG¿UVW
rt: !
a new impo.jms package s to implement
TWO interface
LPSRUWMDYD[HME
LPSRUWMDYD[MPV
the javax
SXEOLFFODVV:HOFRPH%HDQLPSOHPHQWV0HVVDJH'ULYHQ%HDQ0HVVDJH/LVWHQHU^
javax.ejb.MessageDriv
er callbacks) javax.jm enBean (with the cont
s.M ain-
the onMessage() callb essageListener (with
ack method)
SULYDWH0HVVDJH'ULYHQ&RQWH[WFRQWH[W
extends EJBObjec
EntityContext t just like SessionContext and
SXEOLFYRLGHME&UHDWH ^`
you MUST have a single, no-arg ejbCreate()
SXEOLFYRLGHME5HPRYH ^`
works just like stateless session beans... called when
the Container wants to reduce the pool
SXEOLFYRLGVHW0HVVDJH'ULYHQ&RQWH[W 0HVVDJH'ULYHQ&RQWH[WFW[ ^
FRQWH[W FW[
` just do the same thing
do... save your context you always
FINALLY! A real business
SXEOLFYRLGRQ0HVVDJH 0HVVDJHPVJ ^ This is the only method method.
SURFHVVWKHPHVVDJH de Þn
MessageListener interface ed in the
WU\^ .
LI PVJLQVWDQFHRI7H[W0HVVDJH ^
e, but it might
7H[W0HVVDJHPHVVDJH 7H[W0HVVDJH PVJ TextMessage is-a Messdagof message like
have been another kin essage, ObjectMes-
6\VWHPRXWSULQWOQ PHVVDJHJHW7H[W BytesMessage, MapM e. So we test it
` sage or StreamMessag the cast.
`FDWFK -06([FHSWLRQH[ ^
H[SULQW6WDFN7UDFH
with instanceof before
` Yikes. A checked ex
`
fr om the getText() cemeption! ItÕs
` thod.
&KDSWHU
PHVVDJHGULYHQEHDQV
?ZQ\QVOIUM[[IOMLZQ^MVJMIV"
aW]ZRWJI[*MIV8ZW^QLMZ
7KLVWLPHWKHUH·VQRFOLHQW
YLHZVR,GRQ·WKDYHWR <RXSXW7+5((NLQGVRIPHWKRGV
PDWFKDQ\WKLQJIURPWKHKRPH
RUFRPSRQHQWLQWHUIDFHV
LQWKHEHDQFODVV
7KH\GRQ·WH[LVW-XVWOLNHPH
%HDQ/DZ HME&UHDWH PHWKRG
:ULWHDVLQJOHQRDUJXPHQWHME&UHDWH PHWKRGLQWKH
EHDQ,WGRHVQ¶WPDWFKDQ\WKLQJRUFRPHIURPDQ\LQWHU
IDFH,W¶VWKHUHEHFDXVHLW0867EH
LQWHUIDFH!!
0HVVDJH/LVWHQHULPSOHPHQWDWLRQ
0HVVDJH/LVWHQHU
RQ0HVVDJH
RQ0HVVDJH
7KLVLV\RXUEXVLQHVVPHWKRG<RXURQO\EXVLQHVV
PHWKRG
0HVVDJH'ULYHQ%HDQLPSOHPHQWDWLRQ
LQWHUIDFH!! FRQWDLQHUFDOOEDFNV
0HVVDJH'ULYHQ%HDQ
HME5HPRYH
VHW0HVVDJH'ULYHQ&RQWH[W ,PSOHPHQWERWKRIWKHPHWKRGVIURPWKH
0HVVDJH'ULYHQ%HDQLQWHUIDFHZKLFK\RXUEHDQPXVW
LPSOHPHQWLQWKHRI¿FLDO-DYDZD\ LHXVLQJWKH
µLPSOHPHQWV0HVVDJH'ULYHQ%HDQ¶GHFODUDWLRQHLWKHULQ
\RXUEHDQFODVVRURQHRILWVVXSHUFODVVHV
6KDUSHQ \RXU SHQFLO
&RPSLOHUFKHFNHG"
HME&UHDWH
2IWKHWKUHHW\SHVRIPHWKRGV\RX
SXWLQ\RXUEHDQFKHFNRIIWKHRQHV RQ0HVVDJH
WKHFRPSLOHUFDUHVDERXW HME5HPRYH DQGVHW0HVVDJH'ULYHQ&RQWH[W
\RXDUHKHUH
PHVVDJHGULYHQEHDQV
5XOHVIRUWKHPHVVDJHGULYHQEHDQFODVV
7KHFODVVPXVWLPSOHPHQWMDYD[HME0HVVDJH'ULYHQ%HDQDQG
MDYD[HME0HVVDJH/LVWHQHU
SXEOLFFODVV:HOFRPH%HDQLPSOHPHQWV0HVVDJH'ULYHQ%HDQ0HVVDJH/LVWHQHU^
7KHFODVVPXVWEHSXEOLFPXVWQRWEH¿QDODQGPXVWQRWEHDEVWUDFW
7KHFODVVPXVWKDYHDSXEOLFFRQVWUXFWRUWKDWWDNHVQRDUJXPHQWV -XVWOLNH
WKHRWKHUEHDQVVRWKH&RQWDLQHUFDQPDNHDQHZLQVWDQFH tructor.
th e co m pi le r pu t in the default conÕnst put any
t do
If you can, justhaleve one, be SURE itÕs no-arg, and
SXEOLF:HOFRPH%HDQ ^`
But if yo u do
r ejbCreate()
code in it. Wait fo
7KHFODVVPXVWKDYHDQRDUJHME&UHDWH PHWKRG,WPXVWEHSXEOLFQRW
¿QDOQRWVWDWLFZLWKDYRLGUHWXUQW\SH
SXEOLFYRLGHME&UHDWH ^`
code in here. By
Put initializationethod is called, you
the time this mur context.
already have yo
0HVVDJHGULYHQ
EHDQVFDQ·W
GHFODUHFKHFNHG
H[FHSWLRQV
7KHFODVVPXVWGH¿QHWKHRQ0HVVDJH PHWKRGIURPWKH <RX¶OOOHDUQPRUHDERXW
XWIRU
0HVVDJH/LVWHQHULQWHUIDFH,WPXVWEHSXEOLFQRW¿QDOQRWVWDWLF H[FHSWLRQVLQ&KDSWHUE
ZLWKDYRLGUHWXUQW\SHDQGLWWDNHVDVLQJOHDUJXPHQWRIW\SH WLW7K HUH ¶VQR
QRZMXVWWKLQNDERX
MDYD[MPV0HVVDJH RD UH\ RX H[SHFW LQJ
FOLHQW6RZK
UDS DWU\FDWF KD URX QGWKHVH
SXEOLFYRLGRQ0HVVDJH 0HVVDJHPVJ ^` WRZ
XJK
FDOOV"7KH&RQWDLQHUZLOOOD
RWK LV<RX 08 67
The REAL business method. You LI\RXWU\WRG
r logic goes here... FDWFK DQG KD QGO HD Q\ FKH FNHG
H[FHSWLRQVWKDW\RXJHW
<RXPXVWKDYHWKHHME5HPRYH DQGVHW0HVVDJH'ULYHQ&RQWH[W
PHWKRGVIURPWKH0HVVDJH'ULYHQ%HDQLQWHUIDFHH[DFWO\DVGHFODUHG
LQWKHLQWHUIDFH
SXEOLFYRLGHME5HPRYH ^`
SXEOLFYRLGVHW0HVVDJH'ULYHQ&RQWH[W 0HVVDJH'ULYHQ&RQWH[WFW[ ^
FRQWH[W FW[
`
1RPHWKRGVLQWKHFODVVDUHDOORZHGWRWKURZDSSOLFDWLRQH[FHSWLRQV $QGWKH\
VKRXOGQ¶WEHGHFODULQJUXQWLPHH[FHSWLRQVHLWKHUDOWKRXJKLW¶VWHFKQLFDOO\OHJDO
&KDSWHU
PHVVDJHGULYHQEHDQV
6W\QKM[WUM\PQVOUQ[[QVONZWU\PMKWLM'
?MVM^MZ[IQL_PI\SQVLWNUM[[IOM[_M¼ZMTQ[\MVQVONWZ
WZ_PMZM\PMaUQOP\JMKWUQVONZWU
9OU DONT PUT ANYTHING IN YOUR CODE THAT INDICATES THE *-3 DESTINATION
9OU CAN PROBABLY GUESS WHEN THAT HAPPENS DEPLOY
TIME
"UT AS A "EAN 0ROVIDER YOU TELL THE $EPLOYER WHETHER YOURE LOOKING FOR
MESSAGES FROM A TOPIC OR QUEUE !ND FOR THAT WELL USE A NEW TAG IN THE
DEPLOYMENT DESCRIPTOR JUST FOR MESSAGE
DRIVEN BEANS !T DEPLOY
TIME THE
$EPLOYER WILL BIND YOUR BEAN TO A SPECIlC 4OPIC OR 1UEUE CONlGURED AS A
RESOURCE IN THE %*" SERVER
PHVVDJHGULYHQGHVWLQDWLRQ!
GHVWLQDWLRQW\SH!MDYD[MPV7RSLF GHVWLQDWLRQW\SH!
PHVVDJHGULYHQGHVWLQDWLRQ!
You tell the Deployer if yo
messages from a Topic or uÕre expecting
a Queue
+WUXTM\M,,NWZIUM[[IOMLZQ^MVJMIV
HQWHUSULVHEHDQV!
PHVVDJHGULYHQ!
%HDQ3RRO Remote
HMEQDPH!:HOFRPH1HZ&XVWRPHU HMEQDPH!
w ! N o lo c al view, noin the
client vie donÕt put
KRPH!KHDG¿UVW&XVWRPHU+RPH KRPH! ThereÕs noview at all. So youent interface.
UHPRWH!KHDG¿UVW&XVWRPHU UHPRWH! view. No home and compon
tags for
HMEFODVV!KHDG¿UVW:HOFRPH%HDQ HMEFODVV!
WUDQVDFWLRQW\SH!&RQWDLQHU WUDQVDFWLRQW\SH!
PHVVDJHGULYHQGHVWLQDWLRQ!
GHVWLQDWLRQW\SH!MDYD[MPV7RSLF GHVWLQDWLRQW\SH!
PHVVDJHGULYHQGHVWLQDWLRQ!
PHVVDJHGULYHQ! (WeÕll look at an optional tag in
a few pages)
HQWHUSULVHEHDQV!
\RXDUHKHUH
WRSLFVDQGTXHXHV
<WXQK[IVL9]M]M[
-ESSAGING COMES IN TWO mAVORS TOPICS
AND QUEUES ALTHOUGH TOPICS COME IN TWO
SUBmAVORSDURABLE SUBSCRIPTIONS AND NON
DURABLE SUBSCRIPTIONS (QWHUSULVHV\VWHPVWHQGWR
1UEUES ARE LIKE &)&/ LISTS ALTHOUGH &IRST
XVHHLWKHUTXHXHVRUGXUDEOH
)N
&IRST
/UT ORDER ISNT GUARANTEED 4HE
PRODUCER SENDS A MESSAGE THATS INTENDED WRSLFVXEVFULSWLRQV$QRQ
FOR JUST A SINGLE CONSUMER /NCE SOMEBODY
PROCESSES THE MESSAGE THATS IT !N EXAMPLE
GXUDEOHWRSLFVXEVFULSWLRQ
MIGHT BE AN EMPLOYEE REIMBURSEMENT PLJKWEHDSSURSULDWH
SYSTEM WHERE THE EMPLOYEE SENDS HIS
REIMBURSEMENT REQUEST TO THE MESSAGING VRPHWLPHVEXWLI,·PD
SERVICE AND SOMEBODY IN ACCOUNTING WILL
PROCESS THE REQUEST )T DOESNT NEED TO GO TO PHVVDJHFRQVXPHULW·VUHDOO\
ANYBODY ELSE AT THAT POINT )F IT TURNS OUT THAT
THE NEXT STEP IS TO SEND IT FOR MANAGEMENT
OLNHVD\LQJ´,GRQ·WFDUH
PROCESSING THE ACCOUNTING DEPARTMENT PXFKDERXWZKHWKHU,JHW
MIGHT SEND A MESSAGE TO A DIFFERENT
DESTINATIONTHE -ANAGER!PPROVAL QUEUE WKHVHPHVVDJHVµ
4OPICS USE A PUBLISH AND SUBSCRIBE MODEL
WHERE A PRODUCER SENDS A MESSAGE AND
ANYONE WHOS LISTENING AS A CONSUMER WILL
GET A COPY OF THE MESSAGE 7ORKS JUST LIKE A
MAILING LIST )F ANY ONE SUBSCRIBER DOESNT GET
THE MESSAGE THE PRODUCER DOESNT CARE
! TOPIC SUBSCRIBER CAN REQUEST A DURABLE
SUBSCRIPTION IF HE WANTS TO MAKE SURE THAT
HE SEES ALL MESSAGES INCLUDING THE ONES
THAT ACCUMULATED WHILE HE WAS OFmINE FOR
EXAMPLE 4HAT WILL ALMOST ALWAYS BE YOUR
CHOICE BECAUSE YOULL WANT TO GET ALL THE
MESSAGES 4HINK ABOUT ITA NON
DURABLE
TOPIC SUBSCRIPTION WOULD BE LIKE YOU MUST BE
HOME AT THE TIME YOUR MAGAZINE IS DELIVERED
OS YOU SIMPLY WONT SEE IT
&KDSWHU
PHVVDJHGULYHQEHDQV
4XHXH RQHWRRQH SRLQWWRSRLQW
,·PDQHQWLW\EHDQ
FXUUHQWO\SOD\LQJWKHEULOOLDQWO\
GDVKLQJ7KRPDV3DXODQG,KDYHD
SULYDWHPDWWHUWKDW,ZDQWVRPHRQH
GLVFUHHWWRWDNHFDUHRIULJKWDZD\
EXW,GRQ·WZDQWWRZDLW,KDYHDQ Only one message co-d nsumer (in
ge riven bean)
DXGLWLRQFRPLQJXS this case, a messa
gets the message.
:H·OOÀQGD 2.WKDQNVIRU
EHDQWRKDQGOH WKHPHVVDJH1RQHHG
WKDWIRU\RX WRJLYHLWWRDQ\RQH
HOVH
-06
0HVVDJLQJ
6HUYLFH
7RSLF RQHWRPDQ\ SXEOLVKVXEVFULEH
This time, ALL beHi ans
vents
1RZ,KDYHDSDUW\ subscribed to th pE
e
ssa ge.
topic will get th e me
LQYLWDWLRQ-XVWVHQGLWRXWWR
HYHU\RQHOLVWHQLQJRQ7KRPDV
3DXO·V´+LS(YHQWVµOLVW
2.ZH·OOVHQGLW
WRHYHU\RQHZKR·V
LQWHUHVWHG
-06
0HVVDJLQJ
6HUYLFH
\RXDUHKHUH
PHVVDJHGULYHQEHDQV
there are no
Dumb Questions
Q: (OW DOES *-3 lT INTO ALL Q: 7HY DOESNT THE Q: )F ITS A TOPIC DOES THAT MEAN
THIS !ND IF ) HAVE A MESSAGE DRIVEN -ESSAGE$RIVEN"EAN JUST EXTEND ALL BEANS IN A PARTICULAR SUBSCRIBER
BEAN WHERE DO ) GET THE MESSAGING THE -ESSAGE,ISTENER INTERFACE POOL WILL GET THE MESSAGE
SERVICE 4HAT WAY YOU WOULDNT HAVE TO
A:
IMPLEMENT BOTH INTERFACES
A: .O 2EMEMBER ONE BEAN CAN
*-3 IS THE *AVA -ESSAGING
3ERVICE !0) THATS REQUIRED BY %*" A: 3EE YOUR PREVIOUS QUESTION
STAND IN FOR ALL THE OTHER BEANS 4HE
#ONTAINER WILL DELIVER THE MESSAGE TO
4HAT MEANS YOUR %*" CONTAINER MUST 4HE *%% TEAM DIDNT WANT TO LOCK JUST /.% BEAN IN THE POOL 5NLESS NO
HAVE SOME KIND OF MESSAGING SERVICE ALL MESSAGE
DRIVEN BEANS INTO BEING NEVER MIND
INCLUDED ALTHOUGH MANY VENDORS *-3 LISTENERS /NE DAY THERE MIGHT BE
CAN WORK WITH MULTIPLE MESSAGING MANY KINDS OF LISTENER INTERFACES FOR
SERVICES AS LONG AS THOSE SERVICES DIFFERENT MESSAGING TYPES
SUPPORT THE *-3 !0) Q: 5NLESS WHAT 4ELL ME
4HE *-3 !0) WORKS MUCH LIKE *$"#
YOU HAVE A DRIVER THAT KNOWS HOW
TO TAKE YOUR STANDARD *-3 !0) CALLS Q: !RE MESSAGES GUARANTEED TO A: /+ /+ "UT THIS ISNT ON THE
AND TRANSLATE THEM INTO SOMETHING COME IN ORDER 7ILL ) ALWAYS GET THE EXAM SO RELAX ,ETS SAY YOUR SERVER IS
THE UNDERLYING MESSAGING SYSTEM lRST ONE lRST RUNNING AS A CLUSTERED CONFIGURATION
UNDERSTANDS WHERE YOU COULD HAVE MULTIPLE
A: .O 9OU BETTER NOT DEPEND ON
INSTANCES OF YOUR SERVER RUNNING )N
THAT CASE THERE IS NO GUARANTEE ABOUT
IT OR "AD 4HINGS -IGHT (APPEN &OR HOW THE #ONTAINER WILL REPRESENT ITSELF
Q: #AN ) GET MESSAGES FROM NON
EXAMPLE YOU MIGHT GET THE h#ANCEL
THE /RDERv MESSAGE BEFORE YOU GET
TO THE MESSAGING SERVICE
*-3 MESSAGING SERVICES 4HE QUESTION BECOMES DOES THE
THE h0LACE THE /RDERv MESSAGE $ESIGN MESSAGING SERVICE SEE THE WHOLE
YOUR SYSTEM AND CODE YOUR BEAN ON
A: .OT RIGHT NOW IN %*" BUT THE ASSUMPTION THAT MESSAGE ORDER IS
NOT STRICTLY GUARANTEED
CLUSTER AS /.% VERSION OF YOUR
APPLICATION NO MATTER HOW MANY
THEY THE INFAMOUS *%% TEAM HOPE *6-S ITS RUNNING ON OR DOES THE
TO ADD THAT CAPABILITY SOME DAY MESSAGING SERVICE SEE EACH CLUSTER
WITH ITS OWN DUPLICATED POOL FOR EACH
BEAN TYPE AS A SEPARATE LISTENER
&KDSWHU
PHVVDJHGULYHQEHDQV
7VTa76-JMIVXMZXWWTOM\[
IKWXaWNI\WXQKUM[[IOM
)F YOU HAVE SAY THE 7ELCOME"EAN SUBSCRIBED TO
THE .EW#USTOMER TOPIC WHEN A NEW MESSAGE IS
PUBLISHED TO THAT TOPIC THE #ONTAINER WILL CHOOSE
ONLY ONE BEAN FROM THE 7ELCOME"EAN POOL TO GET
THE MESSAGE 2EMEMBER THE #ONTAINER KEEPS A
SEPARATE POOL OF BEANS FOR EACH HOME AND EVERY
DEPLOYED BEAN TYPE GETS ITS OWN HOME 4HE
#ONTAINER DOESNT PUT ALL MESSAGE
DRIVEN BEANS
INTO ONE POOL EVEN IF THEYRE SUBSCRIBED TO THE
SAME TOPICS bscriber
Only one bean per sussa ge. NOT
"UT IF THERE ARE MULTIPLE BEAN TYPES SUBSCRIBED
pool will get th e me
!
TO THAT TOPIC ONE BEAN FROM EACH OF THOSE POOLS
every bean in the pool
WILL ALSO GET THE MESSAGE )N THIS PICTURE BOTH
THE 7ELCOME"EAN AND THE .EW3ALES"EAN ARE
1HZ&XVWRPHU
SUBSCRIBERS TO THE .EW#USTOMER TOPIC SO THE 7RSLFVXEVFULEHU
#ONTAINER SELECTS ONE BEAN FROM EACH POOL TO GET
THE MESSAGE
EHDQ
EHDQ
EHDQ :HOFRPH%HDQ
PVJ
3RRO
-06
0HVVDJLQJ
PVJ 6HUYLFH
1HZ&XVWRPHU PVJ
7RSLFPHVVDJH
1HZ&XVWRPHU
7RSLFVXEVFULEHU
EHDQ
EHDQ
EHDQ
1HZ6DOHV%HDQ
3RRO
\RXDUHKHUH
-06TXHXH
?Q\PIY]M]MWVTaWVMJMIV
OM\[\PMUM[[IOM8MZQWL
)F YOU HAVE A QUEUE FOR MESSAGES REQUESTING THAT
A NEW CUSTOMER BE PROCESSED ONLY ONE BEAN
FROM THE POOL ASSOCIATED WITH THAT QUEUE WILL GET
THE MESSAGE 4HATS IT
/H AND DONT EVEN THINK ABOUT ASKING WHAT
HAPPENS IF YOU HAVE MORE THAN ONE BEAN TYPE
POOL ASSOCIATED WITH THAT QUEUE
"UT IF YOU PERSIST WELL TELL YOU THAT *-3 DOESNT
DElNE WHAT HAPPENS WHEN THERE IS MORE THAN
ONE CONSUMER FOR A PARTICULAR QUEUE 4HAT
ol will
Only one bean in the Tpoevery
MEANS THERES NO WAY TO KNOW HOW THE MESSAGES
MIGHT BE DISTRIBUTED AMONG THE DIFFERENT QUEUE
CONSUMERS -AYBE THE MESSAGING SERVICE WILL JUST get the message. NO
PICK ONE AT RANDOM "UT MAYBE IT WONT -AYBE bean in the pool !
ITLL JUST PICK THE lRST ONE IN A PROPERTIES lLE AND
SEND EVERYTHING THERE 3O JUST DONT DO IT 3URFHVV&XVWRPHU
TXHXHOLVWHQHU
EHDQ
EHDQ
EHDQ &XVW3URFHVV%HDQ
PVJ
3RRO
-06
0HVVDJLQJ
PVJ 6HUYLFH
3URFHVV&XVWRPHU
TXHXHPHVVDJH
&KDSWHU
PHVVDJHGULYHQEHDQV
5M[[IOM,ZQ^MV+WV\M`\ 6KDUSHQ \RXU SHQFLO
4HE SERVER MAKES MESSAGE DRIVEN BEANS VIRTUALLY
7KLQNDERXWZKLFKPHWKRGVDPHVVDJHGULYHQEHDQ
THE SAME WAY IN WHICH IT MAKES STATELESS SESSION
FRXOGFDOORQLWVFRQWH[W
BEANS )URPWKHOLVWRIPHWKRGVLQ(-%&RQWH[WFURVV
#ALL THE BEANS CONSTRUCTOR MUST BE NO ARG RXWWKRVHPHWKRGVWKDWGRQRWPDNHVHQVHIRUD
PHVVDJHGULYHQEHDQ DQGE\³GRQRWPDNHVHQVH´
#ALL THE BEANS CONTEXT SETTER ZHPHDQ³ZLOOFDXVHDKRUULEOHUXQWLPHH[FHSWLRQ
#ALL THE BEANS EJB#REATE METHOD ZLWKGHYDVWDWLQJDQGSRWHQWLDOO\FDUHHUHQGLQJ
FRQVHTXHQFHV´
)N FACT THE l RST TWO STEPS ARE THE SAME FOR ALL 2KDQGEHSUHSDUHGWRGHIHQG\RXUDQVZHUV
BEAN TYPES 4HE CONTEXT SETTER ALWAYS COMES ,PDJLQHXVVLWWLQJULJKWEHKLQG\RXVFDULO\
IMMEDIATELY AFTER THE BEANS CONSTRUCTOR AND AT GHPDQGLQJMXVWL¿FDWLRQIRU\RXUFKRLFHV
SOME POINT BEFORE EJB#REATE !ND OF COURSE
AN ENTITY BEAN MIGHT NEVER GET AN EJB#REATE
CALL IF THERE ARENT ANY CLIENTS TRYING TO INSERT NEW LQWHUIDFH!!
ENTITIES INTO THE DATABASE (-%&RQWH[W
3O WHAT CAN A MESSAGE
DRIVEN BEAN DO WITH ITS
JHW&DOOHU3ULQFLSDO
CONTEXT 7E THINK ITS TIME FOR YOU TO l GURE THAT
OUT 7E CAN GUARANTEE THERE WILL BE QUESTIONS JHW(-%+RPH
ON THE EXAM RELATED TO WHAT A MESSAGE
DRIVEN LV&DOOHU,Q5ROH 6WULQJV
BEAN CAN AND CANNOT DO WITH ITS CONTEXT )N FACT JHW5ROOEDFN2QO\
YOULL l ND THESE QUESTIONS SCATTERED THROUGHOUT JHW(-%/RFDO+RPH
THE OBJECTIVES NOT JUST IN THE MESSAGE
DRIVEN JHW8VHU7UDQVDFWLRQ
BEAN OBJECTIVES n 1UESTIONS FROM THE
VHW5ROOEDFN2QO\
TRANSACTIONS EXCEPTIONS AND SECURITY OBJECTIVES
MIGHT INVOLVE A MESSAGE
DRIVEN BEAN AND ITS
CONTEXT
4HIS IS JUST OUR WAY OF SAYING DO THE DAMN EXERCISE
9OU DONT WANT TO HAVE TO MEMORIZE THIS STUFF BUT LQWHUIDFH!!
IF YOU JUST SPEND A FEW MOMENTS THINKING ABOUT 0HVVDJH'ULYHQ&RQWH[W
IT YOULL l GURE IT OUT WKLVLQWHUIDFHDGGVQR
4HE ANSWERS ARE ON THE NEXT PAGE THOUGH SO QHZPHWKRGV
DONT TURN UNTIL YOURE DONE
\RXDUHKHUH
0HVVDJH'ULYHQ&RQWH[W
5M[[IOM,ZQ^MV+WV\M`\
LQWHUIDFH!!
,W·VVLPSOH0HVVDJHGULYHQ
al() and
(-%&RQWH[W
getCallerPrincip) give you EHDQVGRQ·WKDYHFOLHQWV7KDW
isCallerInRole(about the
JHW&DOOHU3ULQFLSDO security info u donÕt PHDQVWKH\GRQ·WKDYHDFOLHQW
JHW(-%+RPH client. But yo . 9,(:VRWKHUH·VQRKRPH
LV&DOOHU,Q5ROH 6WULQJ V HAVE a client
JHW5ROOEDFN2QO\
LQWHUIDFH
JHW(-%/RFDO+RPH
HW(
JHW8VHU7UDQVDFWLRQ
$QGVLQFHWKHUH·VQRFOLHQW
0\OLIHLVVDG,KDYH
VHW5ROOEDFN2QO\ QRKRPH,KDYHQRFDOOHUV
WKHUH·VQRFOLHQWVHFXULW\
H[FHSWWKHVWXSLG&RQWDLQHU
DQGWKDW·VOLNHVD\LQJWKHRQO\
LQIRUPDWLRQ
IULHQGV\RXKDYHDUH\RXU
SDUHQWV 2KZHOODWOHDVW 6R\RXFDQ·WFDOOWKHWZR
,JHWDSRRO
LQWHUIDFH!!
0HVVDJH'ULYHQ&RQWH[W
PHWKRGVIRUJHWWLQJWKHKRPH
WKLVLQWHUIDFHDGGVQR VLQFH\RX+$9(QRKRPH RU
QHZPHWKRGV WKHWZRPHWKRGVIRUJHWWLQJ
LQIRDERXWWKHFDOOHU·VVHFXULW\
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: 9OU KEEP SAYING THAT MESSAGE
DRIVEN
BEANS DONT HAVE CLIENTS "UT 3/-%"/$9 HAS
TO CALL THE BEANS METHODS RIGHT 4HEY DONT
CALL THEMSELVES
A: 4ECHNICALLY YES THE BEANS METHODS ARE
CALLED "UT WE DONT CONSIDER THE #ONTAINER TO
BE A CLIENT )TS THE BOSS NOT THE CUSTOMER 3O IN
THE *AVA SENSE THE #ONTAINER IS THE BEANS CALLER
BUT NOT A CLIENT !ND AS FOR GETTING SECURITY INFO
IF THE BEAN DOESNT TRUST ITS OWN #ONTAINER YOU
HAVE WAAAAY BIGGER PROBLEMS 7ERE TALKING ONE
SERIOUSLY PARANOID BEAN
&KDSWHU
PHVVDJHGULYHQEHDQV
?PI\QN[WUM\PQVOOWM[_ZWVO'
(YHU\WKLQJZDVJRLQJVRZHOO
:H·OOÀQGD 2.WKDQNVIRU
EHDQWRKDQGOH WKHPHVVDJH1RQHHG
WKDWIRU\RX WRJLYHLWWRDQ\RQH
HOVH
-06
0HVVDJLQJ
6HUYLFH
:KHQVXGGHQO\
+RXVWRQZHKDYH
DSUREOHP/RRNVOLNHZH
EHWWHUSXWWKDWPHVVDJHEDFN
RQWKHTXHXHVRVRPHERG\HOVH
FDQGHDOZLWKLW3RRUEHDQ
PXVWKDYHKLWDUXQWLPH
H[FHSWLRQ
-06
0HVVDJLQJ
6HUYLFH
\RXDUHKHUH
PHVVDJHDFNQRZOHGJHPHQW
5M[[IOMIKSVW_TMLOMUMV\
9OU DONT WANT MESSAGES GETTING LOST )F YOU HAVE A CRUCIAL MESSAGE
ON THE QUEUE AND THE ONE BEAN WHO GETS IT CANT COMMITOR
WORSE THROWS AN EXCEPTION AND DIESWHAT HAPPENS TO YOUR CRITICAL
MESSAGE
4HATS THE POINT OF ACKNOWLEDGEMENT 4HE #ONTAINER TELLS THE
MESSAGING SERVICE NOT THE ORIGINAL PRODUCER THAT THE MESSAGE WAS
DELIVERED AND EVERYTHING IS lNE
"UT IF LATER WHILE THE CONSUMER THE MESSAGE
DRIVEN BEAN IS
PROCESSING THE MESSAGE A "AD 4HING HAPPENS THE #ONTAINER CAN
TELL THE MESSAGING SERVICE TO PUT THE MESSAGE BACK IN THE QUEUE
(OW DOES THE #ONTAINER REALLY KNOW THAT SOMETHING WENT WRONG
4WO WAYS AND ITS YOUR CHOICE AS A "EAN 0ROVIDER
7KHWUDQVDFWLRQVWDWXV
-ESSAGE ACKNOWLEDGEMENT IS TIED TO WHETHER THE TRANSACTION
COMMITS OR ROLLS BACK )F THE TRANSACTION ROLLS BACK THE MESSAGE
GOES BACK ON THE QUEUE 9OU GET THIS BEHAVIOR FOR BEANS THAT USE
CONTAINER
MANAGED TRANSACTION DEMARCATION WELL COVER TRANSACTIONS
IN THE NEXT CHAPTER
25
7KHPHWKRGFRPSOHWLRQ
-ESSAGE ACKNOWLEDGEMENT IS TIED TO WHETHER THE METHOD
COMPLETES SUCCESSFULLY )F THE METHOD THROWS A RUNTIME
EXCEPTION THE MESSAGE GOES BACK ON THE QUEUE 9OU GET
THIS BEHAVIOR FOR BEANS THAT USE BEAN
MANAGED TRANSACTION
DEMARCATION
&KDSWHU
PHVVDJHGULYHQEHDQV
<PI\¼[ITT_MTTIVLOWWLJ]\TM\¼[OWJIKSIVL
[MMPW_W]ZMIZTQMZ[KMVIZQWMVLML
2.WKDQNVIRU 1RSUREOHP
+HUH·VD
WKHPHVVDJH1RQHHG ZH·OOMXVWSXOODQRWKHU
PHVVDJHIURP
WRJLYHLWWRDQ\RQH EHDQRXWRIWKH
WKHTXHXH
HOVH SRRO
-06
0HVVDJLQJ -06
6HUYLFH 0HVVDJLQJ
6HUYLFH
%HDQ$DOLYH %HDQ$GHDG
2KGHÀQLWHO\ :KDWLV
+HUH·VDPHVVDJH 7KHUH·VQRWKLQJ, LWZLWKWKHVHJX\V"
IURPWKHTXHXH,·PVXUH FDQ·WKDQGOH 2KZHOOOHW·VJRSXOO
\RX·OOGREHWWHUWKDQ DQRWKHURQHRXWRI
WKDW/$67JX\ WKHSRRO
-06
-06 0HVVDJLQJ
0HVVDJLQJ 6HUYLFH
6HUYLFH
%HDQ%DOLYH
%HDQ%GHDG
+HUH·VDPHVVDJH 7KRVHRWKHU 8PGR\RXWKLQN
IURPWKHTXHXH/HW·V EHDQVZHUHZHDN PD\EHWKHUH·VVRPHWKLQJ
KRSH<28FDQGRWKLV ZURQJZLWKWKH
RQH PHVVDJH"
-06
-06 0HVVDJLQJ
0HVVDJLQJ 6HUYLFH
6HUYLFH
%HDQ&DOLYH %HDQ&GHDG
\RXDUHKHUH
PHVVDJHDFNQRZOHGJHPHQW
<PQVSIJW]\Q\
)F YOU WANT YOUR MESSAGE ACKNOWLEDGEMENT TIED TO THE STATUS OF THE TRANSACTION USE
CONTAINER
MANAGED TRANSACTIONS #-4 -OST OF THE TIME THIS WILL BE YOUR CHOICE
"UT IF YOU WANT TO DECOUPLE MESSAGE
ACKNOWLEDGEMENT FROM THE STATUS OF YOUR
TRANSACTION YOUR ONLY CHOICE IS TO USE BEAN
MANAGED TRANSACTION DEMARCATION
"-4 7ITH "-4 THE #ONTAINER LOOKS ONLY AT WHETHER YOUR METHOD COMPLETES
-ETHOD COMPLETES &INE THE MESSAGE ACKNOWLEDGEMENT STANDS 2UNTIME
EXCEPTION -ESSAGE GOES BACK IN THE QUEUE
"UT WHAT IF YOU HAVE A SCENARIO WHERE THE BEAN CAN NEVER COMMIT BECAUSE OF
SOMETHING INHERENTLY BAD ABOUT THE MESSAGE 7ITH #-4 THAT MESSAGE WILL KEEP
COMING AND COMING AND COMING AND BUT NOT FOREVER -OST MESSAGING SERVICES LET
YOU CONlGURE HOW MANY TIMES A PARTICULAR MESSAGE IS RESENT BEFORE THE SERVICE SAYS
h4HIS MESSAGE LOOKS LIKE POISON LETS SEND IT TO A 3PECIAL 0LACE LIKE A "AD -ESSAGE
QUEUE WHERE IT CANT HARM ANYONEv 9OU REALLY NEED TO WATCH OUT FOR THIS BECAUSE
THERES NOTHING IN THE SPEC TO HELP 9OURE RELIANT ON YOUR SERVER VENDOR
4HERE IS ANOTHER POSSIBILITY THOUGH 7ITH "-4 YOU COULD WRITE YOUR METHOD IN
SUCH A WAY THAT YOU ROLLBACK THE METHOD BUT STILL lNISH THE METHOD 4HAT WAY THE
#ONTAINER JUST GOES WHISTLING ON ITS MERRY WAY THINKING EVERYTHING WAS lNE )T HAS NO
IDEA THAT THINGS WENT BADLY )N THIS SCENARIO YOUD CATCH WHATEVER EXCEPTION COMES
UP ROLLBACK THE TRANSACTION YOURSELF AGAIN YOULL LEARN HOW TO DO THAT VERY SOON
AND THEN END THE METHOD LOOKING SUCCESSFUL AT LEAST TO THE #ONTAINER
6HWWLQJWKHDFNQRZOHGJHPHQWPRGH
)F YOU $/ USE "-4 YOU HAVE TWO CHOICES FOR HOW THE #ONTAINER SENDS AN
ACKNOWLEDGEMENT TO THE MESSAGING SERVICE 4HE CHOICES ARE
DFNQRZOHGJHPRGH!$XWRDFNQRZOHGJH DFNQRZOHGJHPRGH!
/2
DFNQRZOHGJHPRGH!'XSVRNDFNQRZOHGJH DFNQRZOHGJHPRGH!
4HIS DOESNT CHANGE THE #ONTAINERS BEHAVIOR OF WHETHER IT DECIDES TO DO THE
ACKNOWLEDGEMENTFOR A "-4 BEAN ITS ALWAYS BASED ON WHETHER THE METHOD
COMPLETES 4HE ACKNOWLEDGE MODE IS SIMPLY A WAY TO TWEAK HOW THE #ONTAINER
SENDS THE ACKNOWLEDGEMENT
7ITH $UPS
OK
ACKNOWLEDGE YOURE TELLING THE #ONTAINER THAT YOU DONT MIND IF ITS
KIND OF SLOW WITH THE ACKNOWLEDGEMENT TO THE MESSAGE SERVICE THAT YOU DONT MIND
IF YOU GET DUPLICATE MESSAGES hDUPS
OKv 4HIS LETS THE #ONTAINER TAKE WHATEVER
TIME IT WANTS TO DO THE ACKNOWLEDGEMENT AND IT MIGHT MAKE THE SERVER MORE
EFlCIENT BUT AT THE RISK OF DUPLICATE MESSAGES BECAUSE THE POOR MESSAGING SERVICE
DIDNT GET AN ACKNOWLEDGEMENT QUICKLY ENOUGH
&KDSWHU
PHVVDJHGULYHQEHDQV
([HUFLVH
)LOOLQWKHEODQNVZLWKWKHFRGHWKDWPXVWEHLQVHUWHGIRU
WKHEHDQWREHDOHJDOPHVVDJHGULYHQEHDQFODVV
SDFNDJHKHDG¿UVW
LPSRUWMDYD[HME
LPSRUWMDYD[MPV
SXEOLFFODVV)RR/LVWHQHU%HDQBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB^
SULYDWH0HVVDJH'ULYHQ&RQWH[WFRQWH[W
SXEOLFYRLGBBBBBBBBBBBBBBBBBBBBBBBBBBBB
SXEOLFYRLGBBBBBBBBBBBBBBBBBBBBBBBBBBBB
SXEOLFYRLGVHW0HVVDJH'ULYHQ&RQWH[W 0HVVDJH'ULYHQ&RQWH[WFW[ ^
FRQWH[W FW[
`
SXEOLFYRLGBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
/LVWWZRWKLQJVDVWDWHIXOVHVVLRQEHDQFDQFDOORQLWV
6HVVLRQ&RQWH[WWKDWDPHVVDJHGULYHQEHDQFDQQHYHU
FDOORQLWV0HVVDJH'ULYHQ&RQWH[W
BBBBBBBBBBBBBBBBBBBBBBBBBBBB
BBBBBBBBBBBBBBBBBBBBBBBBBBBB
\RXDUHKHUH
PHVVDJHGULYHQEHDQV
6ROXWLRQ
)LOOLQWKHEODQNVZLWKWKHFRGHWKDWPXVWEHLQVHUWHGIRU
WKHEHDQWREHDOHJDOPHVVDJHGULYHQEHDQFODVV
SDFNDJHKHDG¿UVW
LPSRUWMDYD[HME
LPSRUWMDYD[MPV
implements MessageDrivenBean, MessageListener
SXEOLFFODVV)RR/LVWHQHU%HDQBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB^
SULYDWH0HVVDJH'ULYHQ&RQWH[WFRQWH[W
ejbCreate() { }
SXEOLFYRLGBBBBBBBBBBBBBBBBBBBBBBBBBBBB
ejbRemove() { }
SXEOLFYRLGBBBBBBBBBBBBBBBBBBBBBBBBBBBB
SXEOLFYRLGVHW0HVVDJH'ULYHQ&RQWH[W 0HVVDJH'ULYHQ&RQWH[WFW[ ^
FRQWH[W FW[
`
onMessage(Message msg) { }
SXEOLFYRLGBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
/LVWWZRWKLQJVDVWDWHIXOVHVVLRQEHDQFDQFDOORQLWV
6HVVLRQ&RQWH[WWKDWDPHVVDJHGULYHQEHDQFDQQHYHU
FDOORQLWV0HVVDJH'ULYHQ&RQWH[W
call isCallerInRole() (thereÕs no client!)
BBBBBBBBBBBBBBBBBBBBBBBBBBBB
call getEJBHome() (thereÕs no client view, so thereÕs no home or component interface)
BBBBBBBBBBBBBBBBBBBBBBBBBBBB
&KDSWHU
PHVVDJHGULYHQEHDQV
0RFN([DP
7HATS TRUE ABOUT MESSAGE
DRIVEN BEANS #HOOSE ALL THAT APPLY
1
R! ! MESSAGE
DRIVEN BEAN HAS A HOME INTERFACE BUT NO COMPONENT
INTERFACE
R" ! CLIENT NEVER KNOWS A MESSAGE
DRIVEN BEANS IDENTITY
R# ! CLIENT SEES A MESSAGE
DRIVEN BEAN AS A *AVA-AIL MESSAGE CONSUMER
R$ 4HE LIFETIME OF A MESSAGE
DRIVEN BEAN IS CONTROLLED BY THE CONTAINER
7HICH INTERFACES MUST BE IMPLEMENTED IN A MESSAGE
DRIVEN BEAN CLASS OR IN
2 ONE OF ITS SUPERCLASSES #HOOSE ALL THAT APPLY
R! MDYD[MPV0HVVDJH
R" MDYD[MPV0HVVDJH/LVWHQHU
R# MDYD[MPV0HVVDJH&RQVXPHU
R$ MDYD[HME0HVVDJH'ULYHQ%HDQ
R% MDYD[HME0HVVDJH'ULYHQ&RQWH[W
7HICH LIST PROPERLY SEQUENCES THE METHODS CALLED IN THE LIFECYCLE OF A MESSAGE
3 DRIVEN BEAN #HOOSE ALL THAT APPLY
R! HME&UHDWH QHZ,QVWDQFH VHW0HVVDJH'ULYHQ&RQWH[W
RQ0HVVDJH
R" RQ0HVVDJH QHZ,QVWDQFH HME&UHDWH
VHW0HVVDJH'ULYHQ&RQWH[W
R# QHZ,QVWDQFH VHW0HVVDJH'ULYHQ&RQWH[W HME&UHDWH
RQ0HVVDJH
R$ QHZ,QVWDQFH HME&UHDWH VHW0HVVDJH'ULYHQ&RQWH[W
RQ0HVVDJH
R% HME&UHDWH VHW0HVVDJH'ULYHQ&RQWH[W QHZ,QVWDQFH
RQ0HVVDJH
\RXDUHKHUH
FRIIHHFUDPPRFNH[DP
7HICH ARE VALID SIGNATURES FOR METHODS IN A MESSAGE DRIVEN BEAN #HOOSE
4 ALL THAT APPLY
R! SXEOLFYRLGRQ0HVVDJH
R" SXEOLFYRLGHME&UHDWH
R# SXEOLFVWDWLFYRLGRQ0HVVDJH
R$ SXEOLFYRLGHME&UHDWH MDYD[MPV0HVVDJHP
R% SXEOLFYRLGRQ0HVVDJH MDYD[MPV0HVVDJHP
R& SXEOLFYRLGRQ0HVVDJH MDYD[MPV0HVVDJHP WKURZV
MDYDUPL5HPRWH([FHSWLRQ
7HEN IS A MESSAGE
DRIVEN BEAN ABLE TO ACCESS JAVACOMPENV VIA *.$)
5
R! HME&UHDWH
R" HME5HPRYH
R# VHW0HVVDJH'ULYHQ&RQWH[W
R$ .ONE OF THE ABOVE
7HICH MESSAGE
DRIVEN BEAN METHODS TAKE AN ARGUMENT #HOOSE ALL THAT
6 APPLY
R! HME&UHDWH
R"HME5HPRYH
R# RQ0HVVDJH
R$ VHW0HVVDJH'ULYHQ&RQWH[W
7HEN IS A MESSAGE
DRIVEN BEAN ABLE TO ACCESS OTHER ENTERPRISE BEANS
7
R! HME&UHDWH
R" HME5HPRYH
R# RQ0HVVDJH
R$ VHW0HVVDJH'ULYHQ&RQWH[W
R% .ONE OF THE ABOVE
&KDSWHU
PHVVDJHGULYHQEHDQV
7HATS TRUE ABOUT #ONTAINER SUPPORT FOR MESSAGE
DRIVEN BEANS #HOOSE ALL
8 THAT APPLY
R! 4HE #ONTAINER MUST SUPPORT THE DEPLOYMENT OF A MESSAGE
DRIVEN BEAN
AS THE CONSUMER OF A *AVA-AIL QUEUE
R" 4HE #ONTAINER IS ./4 REQUIRED TO SUPPORT TRANSACTION SCOPING FOR
MESSAGE
DRIVEN BEANS
R# 4HE #ONTAINER GUARANTEES lRST
IN lRST DELIVERED MESSAGE PROCESSING
R$ 4HE #ONTAINER MUST ENSURE THAT THE BEAN INSTANCES ARE NON
REENTRANT
7HEN IS A MESSAGE
DRIVEN BEAN WITH "-4 DEMARCATION ABLE TO ACCESS RESOURCE
9 MANAGERS
R! HME&UHDWH
R" HME5HPRYH
R# RQ0HVVDJH
R$ VHW0HVVDJH'ULYHQ&RQWH[W
R% .ONE OF THE ABOVE
7HATS TRUE ABOUT MESSAGE ACKNOWLEDGMENT FOR MESSAGE
DRIVEN BEANS
10 #HOOSE ALL THAT APPLY
R! -ESSAGE ACKNOWLEDGEMENT MODES CANNOT BE DElNED DECLARATIVELY
R" 4HE *-3 !0) SHOULD BE USED FOR MESSAGE ACKNOWLEDGMENT
R# &OR "-4 BEANS THE #ONTAINER USES THE ACKNOWLEDGE
MODE DEPLOYMENT
DESCRIPTOR ELEMENT
R$ &OR #-4 BEANS THE #ONTAINER USES THE ACKNOWLEDGE
MODE
DEPLOYMENT DESCRIPTOR ELEMENT
7HATS TRUE ABOUT THE DEPLOYMENT DESCRIPTOR FOR MESSAGE
DRIVEN BEANS
11 #HOOSE ALL THAT APPLY
R! 4HE BEAN PROVIDER MUST GUARANTEE THAT THE BEAN IS ASSOCIATED WITH A
SPECIlC QUEUE OR TOPIC
R" 4HE DEPLOYMENT DESCRIPTOR CAN INDICATE WHETHER A BEAN IS INTENDED FOR
A TOPIC OR A QUEUE
R# )T CAN INDICATE WHETHER A 1UEUE TYPE BEAN SHOULD SUPPORT DURABLE
SUBSCRIPTION OR NOT
R$ )T IS APPROPRIATE TO ASSOCIATE MULTIPLE BEANS WITH THE SAME *-3 QUEUE
\RXDUHKHUH
PRFNH[DPDQVZHUV
0RFN([DP$QVZHUV
(spec: 311-312)
7HATS TRUE ABOUT MESSAGE
DRIVEN BEANS #HOOSE ALL THAT APPLY
1
R! ! MESSAGE
DRIVEN BEAN HAS A HOME INTERFACE BUT NO COMPONENT
INTERFACE - MDBs have NO client view
R" ! CLIENT NEVER KNOWS A MESSAGE
DRIVEN BEANS IDENTITY
R# ! CLIENT SEES A MESSAGE
DRIVEN BEAN AS A *AVA-AIL MESSAGE CONSUMER
R$ 4HE LIFETIME OF A MESSAGE
DRIVEN BEAN IS CONTROLLED BY THE CONTAINER
7HICH INTERFACES MUST BE IMPLEMENTED IN A MESSAGE DRIVEN BEAN CLASS OR IN (spec: 314-315)
2 ONE OF ITS SUPERCLASSES #HOOSE ALL THAT APPLY
R! MDYD[MPV0HVVDJH
R" MDYD[MPV0HVVDJH/LVWHQHU - this is where the onMessage() method is deÞned
R# MDYD[MPV0HVVDJH&RQVXPHU
R$ MDYD[HME0HVVDJH'ULYHQ%HDQ
R% MDYD[HME0HVVDJH'ULYHQ&RQWH[W
7HICH LIST PROPERLY SEQUENCES THE METHODS CALLED IN THE LIFECYCLE OF A MESSAGE (spec: 319)
3 DRIVEN BEAN #HOOSE ALL THAT APPLY
R! HME&UHDWH QHZ,QVWDQFH VHW0HVVDJH'ULYHQ&RQWH[W
RQ0HVVDJH
R" RQ0HVVDJH QHZ,QVWDQFH HME&UHDWH
VHW0HVVDJH'ULYHQ&RQWH[W
R# QHZ,QVWDQFH VHW0HVVDJH'ULYHQ&RQWH[W HME&UHDWH
RQ0HVVDJH
R$ QHZ,QVWDQFH HME&UHDWH VHW0HVVDJH'ULYHQ&RQWH[W
RQ0HVVDJH
R% HME&UHDWH VHW0HVVDJH'ULYHQ&RQWH[W QHZ,QVWDQFH
RQ0HVVDJH
&KDSWHU
PHVVDJHGULYHQEHDQV
7HICH ARE VALID SIGNATURES FOR METHODS IN A MESSAGE DRIVEN BEAN #HOOSE
4 ALL THAT APPLY (spec: 324)
R! SXEOLFYRLGRQ0HVVDJH
R" SXEOLFYRLGHME&UHDWH
R# SXEOLFVWDWLFYRLGRQ0HVVDJH
R$ SXEOLFYRLGHME&UHDWH MDYD[MPV0HVVDJHP
R% SXEOLFYRLGRQ0HVVDJH MDYD[MPV0HVVDJHP
R& SXEOLFYRLGRQ0HVVDJH MDYD[MPV0HVVDJHP WKURZV
MDYDUPL5HPRWH([FHSWLRQ
- you must never declare a RemoteException
7HEN IS A MESSAGE DRIVEN BEAN ABLE TO ACCESS JAVACOMPENV VIA *.$) (spec: 320)
5
R! HME&UHDWH
R" HME5HPRYH
R# VHW0HVVDJH'ULYHQ&RQWH[W
R$ .ONE OF THE ABOVE
7HICH MESSAGE DRIVEN BEAN METHODS TAKE AN ARGUMENT #HOOSE ALL THAT (spec: 319, 324)
6 APPLY
R! HME&UHDWH
R"HME5HPRYH
R# RQ0HVVDJH - takes a mes
sage
R$ VHW0HVVDJH'ULYHQ&RQWH[W - takes a context
7 7HEN IS A MESSAGE DRIVEN BEAN ABLE TO ACCESS OTHER ENTERPRISE BEANS (spec: 320)
R! HME&UHDWH
ful
R" HME5HPRYH
on ly in a m et ho d with a Ômeaning
R# RQ0HVVDJH -transaction contextÕ
R$ VHW0HVVDJH'ULYHQ&RQWH[W
R% .ONE OF THE ABOVE
\RXDUHKHUH
PRFNH[DPDQVZHUV
7HATS TRUE ABOUT #ONTAINER SUPPORT FOR MESSAGE DRIVEN BEANS #HOOSE ALL (spec: 325-326)
8 THAT APPLY
R! 4HE #ONTAINER MUST SUPPORT THE DEPLOYMENT OF A MESSAGE DRIVEN BEAN
AS THE CONSUMER OF A *AVA-AIL QUEUE
R" 4HE #ONTAINER IS ./4 REQUIRED TO SUPPORT TRANSACTION SCOPING FOR
MESSAGE DRIVEN BEANS
R# 4HE #ONTAINER GUARANTEES lRST IN lRST DELIVERED MESSAGE PROCESSING
R$ 4HE #ONTAINER MUST ENSURE THAT THE BEAN INSTANCES ARE NON REENTRANT
7HEN IS A MESSAGE DRIVEN BEAN WITH "-4 DEMARCATION ABLE TO ACCESS RESOURCE (spec: 320)
9 MANAGERS
R! HME&UHDWH
R" HME5HPRYH
R# RQ0HVVDJH - when there is a Ômeaningful transaction contextÕ
R$ VHW0HVVDJH'ULYHQ&RQWH[W
R% .ONE OF THE ABOVE
7HATS TRUE ABOUT MESSAGE ACKNOWLEDGMENT FOR MESSAGE DRIVEN BEANS (spec: 317)
10 #HOOSE ALL THAT APPLY
R! -ESSAGE ACKNOWLEDGEMENT MODES CANNOT BE DElNED DECLARATIVELY
R" 4HE *-3 !0) SHOULD BE USED FOR MESSAGE ACKNOWLEDGMENT
R# &OR "-4 BEANS THE #ONTAINER USES THE ACKNOWLEDGE MODE DEPLOYMENT
DESCRIPTOR ELEMENT - can be Auto-acknowledge or
Dups-ok-acknowledge
R$ &OR #-4 BEANS THE #ONTAINER USES THE ACKNOWLEDGE MODE
DEPLOYMENT DESCRIPTOR ELEMENT
7HATS TRUE ABOUT THE DEPLOYMENT DESCRIPTOR FOR MESSAGE DRIVEN BEANS (spec: 317)
11 #HOOSE ALL THAT APPLY
R! 4HE BEAN PROVIDER MUST GUARANTEE THAT THE BEAN IS ASSOCIATED WITH A - thatÕs the
deployerÕs job
SPECIlC QUEUE OR TOPIC
R" 4HE DEPLOYMENT DESCRIPTOR CAN INDICATE WHETHER A BEAN IS INTENDED FOR
A TOPIC OR A QUEUE
R# )T CAN INDICATE WHETHER A 1UEUE TYPE BEAN SHOULD SUPPORT DURABLE - durable subscriptions are
SUBSCRIPTION OR NOT just for topics!
R$ )T IS APPROPRIATE TO ASSOCIATE MULTIPLE BEANS WITH THE SAME *-3 QUEUE
&KDSWHU
EJB transactions
5
4
4 7KH$WRPLF$JH ,WZDVDORQJ
WUDQVDFWLRQEXWVKHÀQDOO\
FRPPLWWHG6KHKDGSOHQW\
RIWLPHWRUROOEDFNEXW,
MXVWNHSWFDWFKLQJDOOWKH
H[FHSWLRQVVRLWDOOZRUNHG
RXWLQWKHHQG
7UDQVDFWLRQVSURWHFW\RX:LWKWUDQVDFWLRQV\RXFDQWDNHDULVN<RXFDQWU\
VRPHWKLQJ%,*NQRZLQJWKDWLIDQ\WKLQJJRHVZURQJDORQJWKHZD\\RXFDQMXVWSUHWHQG
WKHZKROHWKLQJGLGQ¶WKDSSHQ(YHU\WKLQJJRHVEDFNWRWKHZD\LWZDVEHIRUH7KHLGHDLV
VLPSOH²\RXHLWKHUFRPPLWWRHYHU\WKLQJLQWKHWUDQVDFWLRQRU\RXUROOEDFNVRWKDWQRERG\
VHHVZKDW\RXZHUHWU\LQJ EXWIDLOHG WRGR7UDQVDFWLRQVLQ(-%DUHDWKLQJRIEHDXW\²
\RXFDQGHSOR\DEHDQZLWKFXVWRPL]HGWUDQVDFWLRQEHKDYLRUZLWKRXWWRXFKLQJWKHEHDQ¶V
VRXUFHFRGH%XW\RXFDQZULWHWUDQVDFWLRQFRGHLI\RXQHHGWRVRZH¶OOOHDUQWKDWWRR
WKLVLVDQHZFKDSWHU
H[DPREMHFWLYHV
(QWHUSULVH-DYDEHDQV7UDQVDFWLRQV
2IILFLDO :KDWLWUHDOO\PHDQV
,GHQWLI\FRUUHFWDQGLQFRUUHFW <RXQHHGWRNQRZWKHUXOHVDQGLPSOLFDWLRQVRIEHDQ
VWDWHPHQWVRUH[DPSOHVDERXW PDQDJHG %07 YVFRQWDLQHUPDQDJHG &07 WUDQVDF
(-%WUDQVDFWLRQVLQFOXGLQJEHDQ WLRQGHPDUFDWLRQ)RUH[DPSOH\RXPXVWNQRZWKDWERWK
PDQDJHGWUDQVDFWLRQGHPDUFDWLRQ PHVVDJHGULYHQDQGVHVVLRQEHDQVFDQXVH&07RU
DQGFRQWDLQHUPDQDJHGWUDQVDFWLRQ %07EXWHQWLW\EHDQVFDQXVHRQO\&07$QGPHVVDJH
GHPDUFDWLRQ GULYHQEHDQVDQGVWDWHOHVVVHVVLRQEHDQVXVLQJ%07
PXVWHQGWKHWUDQVDFWLRQEHIRUHWKHHQGRIWKHPHWKRG
,GHQWLI\FRUUHFWDQGLQFRUUHFW EXWVWDWHIXOVHVVLRQEHDQVDUHDOORZHGWRNHHSDWUDQVDF
VWDWHPHQWVDERXWWKH$SSOLFDWLRQ WLRQRSHQDFURVVPXOWLSOHPHWKRGLQYRFDWLRQVIURPDFOL
$VVHPEOHU¶VUHVSRQVLELOLWLHVLQFOXGLQJ HQW<RXQHHGWRNQRZWKDWSURSDJDWLRQRIWUDQVDFWLRQVLQ
WKHXVHRIGHSOR\PHQWGHVFULSWRU %07LVDRQHZD\VWUHHW D%07WUDQVDFWLRQFDQSURSD
HOHPHQWVUHODWHGWRWUDQVDFWLRQVDQG JDWHRXWZLWKDEHDQ¶VPHWKRGFDOOV LHEHXVHGE\WKH
WKHLGHQWL¿FDWLRQRIWKHPHWKRGVRI FDOOHGPHWKRG EXWDQH[LVWLQJWUDQVDFWLRQFRQWH[WFDQ
DSDUWLFXODUEHDQW\SHIRUZKLFKD QHYHUEHSURSDJDWHGLQWRD%07EHDQ,QRWKHUZRUGVD
WUDQVDFWLRQDWWULEXWHPXVWEHVSHFL¿HG %07EHDQZLOOUXQRQO\LQWUDQVDFWLRQVWKHEHDQLWVHOIKDV
VWDUWHG
*LYHQDOLVWRIWUDQVDFWLRQEHKDYLRUV
PDWFKWKHPZLWKWKHDSSURSULDWH <RXPXVWEHYHU\FOHDUDERXWWKHHIIHFWVRIWUDQVDFWLRQ
WUDQVDFWLRQDWWULEXWH DWWULEXWHVIRU&07)RUH[DPSOH\RXPXVWXQGHUVWDQG
WKDWPHVVDJHGULYHQEHDQVFDQXVHRQO\WZRRIWKHVL[
DWWULEXWHV 1RW6XSSRUWHGDQG5HTXLUHG EHFDXVHWKH
*LYHQDOLVWRIUHVSRQVLELOLWLHVLGHQWLI\ RWKHUVGRQ¶WPDNHVHQVHIRUDPHVVDJHGULYHQEHDQ QR
WKRVHZKLFKDUHWKHFRQWDLQHU¶VZLWK FDOOLQJWUDQVDFWLRQFDQHYHUEHSURSDJDWHGLQWRDPHV
UHVSHFWWRWUDQVDFWLRQVLQFOXGLQJ VDJHGULYHQEHDQEHFDXVHLWLVRQO\WKHFRQWDLQHUWKDWLQ
WKHKDQGOLQJRIJHW5ROOEDFN2QO\ YRNHVWKHEHDQ¶VRQ0HVVDJH PHWKRG<RXDOVRKDYHWR
VHW5ROOEDFN2QO\JHW8VHU7UDQVDFWLRQ NQRZWKHPHWKRGVRIHDFKEHDQW\SH VHVVLRQHQWLW\RU
6HVVLRQ6\QFKURQL]DWLRQFDOOEDFNVIRU PHVVDJHGULYHQ IRUZKLFKWUDQVDFWLRQDWWULEXWHVPXVWEH
ERWKFRQWDLQHUDQGEHDQPDQDJHG VSHFL¿HG)RUH[DPSOHDQHQWLW\EHDQ¶VFUHDWH PHWKRG
WUDQVDFWLRQGHPDUFDWLRQ LVWUDQVDFWLRQDOEXWDVHVVLRQEHDQ¶VFUHDWH PHWKRG
UXQVLQ³DQXQVSHFL¿HGWUDQVDFWLRQFRQWH[W´<RXPXVWEH
1RWH ZHFRYHUWKHSDUWRIWKDW DEOHWRVSHFLI\WUDQVDFWLRQDWWULEXWHVLQWKHGHSOR\PHQW
GHDOVZLWK6HVVLRQ6\QFKURQL]DWLRQLQ GHVFULSWRU
WKH6HVVLRQ%HDQFKDSWHU
)LQDOO\\RXQHHGWRNQRZZKDW\RXUEHDQFDQFRXQWRQ
IURPWKHFRQWDLQHUZKHQLWFRPHVWRWUDQVDFWLRQV)RU
H[DPSOH\RXPXVWNQRZWKDWLI\RXLQYRNHJHW5ROOEDFN
2QO\RQDEHDQ¶VFRQWH[WWKHFRQWDLQHUPXVWQRWFRPPLW
&KDSWHU
(-%WUDQVDFWLRQV
$Q(-%WUDQVDFWLRQLVDQDWRPLFXQLWRIZRUN
, ! TRANSACTION MEANS YOUVE WRAPPED SOME WORK STATEMENTS METHOD CALLS
WHOLE METHODS ACCESS TO A DATABASE ETC INTO A SINGLE UNIT IN SUCH A WAY
THAT EITHER EVERYTHING SUCCEEDS OR EVERYTHING REVERTS TO ITS PREVIOUS STATE
)N OTHER WORDS YOU EITHER COMMIT OR ROLLBACK THE WHOLE ATOMIC UNIT
%ITHER IT ALL WORKS OR WE JUST FORGET THE WHOLE THING EVER HAPPENED
6KRSSLQJFDUWFKHFNRXW
DTXLQWHVVHQWLDO(-%WUDQVDFWLRQH[DPSOH
)MAGINE YOU HAVE AN ONLINE SHOPPING CART SYSTEM 7HEN IT COMES TIME
TO CHECKOUT WHAT NEEDS TO HAPPEN !T THE VERY LEAST
one unitÑ if
These must all happend,asALL of it
+DYHXVHUFRQILUPRUGHU
9DOLGDWHDQGGHELWXVHU·VFUHGLWFDUG ANY of this goes ba gh none of this
5HPRYHSXUFKDVHGLWHPVIURPLQYHQWRU\ should rollback as thou
&UHDWHDQGVXEPLWDVKLSSLQJRUGHU
ever happened...
9OU DONT WANT TO DEBIT THE INVENTORY IF THE CREDIT CARD ISNT VALID !ND
YOU DONT WANT TO SUBMIT A SHIPPING ORDER IF THE ITEMS ARENT YET IN STOCK
!ND YOU DONT WANT ANY OF IT TO HAPPEN IF THE USER DOESNT CONlRM THE
ORDER )F ANY OF THESE THINGS GO WRONG YOU WANT YOUR TRANSACTION TO END
WITH A ROLLBACK RATHER THAN A COMMIT 4HINK OF THE HORROR YOUD GO
THROUGH IF YOU COULDNT DO A TRANSACTION ROLLBACK )MAGINE THAT YOU WENT
THROUGH THE lRST THREE OUT OF THE FOUR STEPS ONLY TO lND THE USER DOESNT
CONlRM THE ORDER 9OU WOULD HAVE TO GO BACK AND ADD MONEY TO THE
USERS CREDIT CARD CANCEL THE ORDER AND PUT THE ITEMS BACK IN INVENTORY
<RXGRQ¶WQHHGWRNQRZDERXW-76;$RUDQ\RWKHU
WUDQVDFWLRQ$3,VH[FHSWMDYD[WUDQVDFWLRQ8VHU7UDQVDFWLRQ
<RXZRQ¶WEHWHVWHGRQDQ\RIWKHORZHUOHYHOWUDQVDFWLRQ$3,GHWDLOV)RU
H[DPSOH\RXGRQ¶WQHHGWRNQRZDQ\WKLQJDERXW+2:WKHVHUYHUFRQWDLQHU
FRPPXQLFDWHVZLWKDWUDQVDFWLRQDOUHVRXUFHVXFKDVDGDWDEDVH$QGDOWKRXJK(-%
VXSSRUWVGLVWULEXWHGWUDQVDFWLRQV\RXZRQ¶WEHDVNHGDERXWKRZLWZRUNV:HNQRZLW¶V
GHSUHVVLQJWKDW\RXZRQ¶WJHWWRVKRZRII\RXUWZRSKDVHFRPPLWSURWRFROSURZHVV
\RXDUHKHUH
WKH$&,'WHVW
<PM)+1,\M[\
1[aW]Z\ZIV[IK\QWV[INM'
&IVE OUT OF lVE EXPERTS PLUS PRETTY MUCH THE ENTIRE REST
OF THE INDUSTRY AGREE ON FOUR CHARACTERISTICS OF A GOOD
SAFE TRANSACTION 4HIS IS NOT JUST AN %*" THING BY THE
WAYTHE !#)$ TEST GOES BACK LONG BEFORE *AVA WAS
A GLEAM IN 'OSLINGS EYE 4O PUT YOUR TRANSACTIONS
THROUGH THE !#)$ TEST MAKE SURE THE TRANSACTION IS
$WRPLF
%ITHER IT ALL WORKS OR IT ALL FAILS AND ROLLS BACK
! TRANSACTION ISNT ATOMIC IF ITS POSSIBLE FOR SOME OF IT TO
COMMIT WHILE OTHER PARTS DONT
&RQVLVWHQW
7HETHER IT WORKS COMMITS OR FAILS ROLLS BACK THE
DATA SHOULD STAY CONSISTENT WITH THE BUSINESS LOGIC REALITY
9OUD HAVE REAL TROUBLE IF SAY YOU COULD TAKE ITEMS OUT
OF INVENTORY WITHOUT ACTUALLY SUBMITTING AN ORDER 9OUD
END UP WITH ITEMS THAT EXIST IN THE REAL INVENTORY IE IN
A WAREHOUSE SOMEWHERE BUT THAT DONT SHOW UP IN
ANYBODYS COMPUTER RECORDS
,VRODWHG
,ETS SAY YOU HAVE TWO DIFFERENT TRANSACTIONS RUNNING
POTENTIALLY HITTING THE SAME DATABASE 9OU DONT WANT THE
EFFECT OF ONE TRANSACTION TO CORRUPT THE STATE OF ANOTHER
TRANSACTION )N OTHER WORDS THE TRANSACTIONS SHOULD BE
PROTECTED ISOLATED FROM ONE ANOTHER )SOLATION IS VERY SIMILAR
TO THREAD SYNCHRONIZATIONYOU DONT WANT ONE TRANSACTION
READING SOME DATA WITH THE INTENTION OF ACTING ON IT IF THAT
DATA IS SMACK IN THE MIDDLE OF ANOTHER TRANSACTION THAT HASNT
lNISHED COMMITTING ITS OWN CHANGES TO THE DATA
'XUDEOH
/NCE A TRANSACTION COMMITS THE CHANGES MADE BY THAT
TRANSACTION MUST BECOME PERMANENT %VEN IF THE SERVER GOES
DOWN IT MUST COME BACK UP AND lNISH WHAT IT STARTED TO COMMIT
&KDSWHU
(-%WUDQVDFWLRQV
,Q[\ZQJ]\ML\ZIV[IK\QWV["\ _WXPI[MKWUUQ\
-OST %*" CONTAINERS SUPPORT DISTRIBUTED TRANSACTIONS THROUGH A TWO
PHASE
COMMIT PROTOCOL )F YOURE A TRANSACTION MANAGER LIKE A *%% SERVER YOU
MIGHT HAVE MULTIPLE PARTICIPANTS INCLUDING A DATABASE ANOTHER BEAN AND
ANOTHER SERVER ON THE NETWORK /NCE YOUVE TOLD EVERYONE TO COMMIT
THERES NO GOOD WAY TO UNDO IT SO BEFORE YOU GIVE THE SIGNAL TO COMMIT
YOU NEED TO MAKE SURE THAT EVERYONE CAN DO WHAT YOURE ASKING !S THE
TRANSACTION MANAGER YOUR JOB IS TO lND OUT IF EVERYONE IS READY TO PERFORM
UPDATE THE DATABASE DEBIT THE ACCOUNT ETC AND THEN DEPENDING ON THE
RESULTS TELL THEM ALL TO DO IT COMMIT OR TELL THEM ALL TO FORGET IT ROLLBACK
3KDVH21( 3KDVH7:2
%HIRUH,WHOO ,WORRNVOLNH
HYHU\RQHWRFRPPLW HYHU\ERG\FDQGR
,KDYHWRPDNHVXUH LWVRQRZ,WHOOWKHP
WKDWHYHU\ERG\LV DOOWRFRPPLW
UHDG\WRGRLW
"
G\
U HD W
\RX R UL
UH J R RI
D
WR
J OHP
G U RE
J RR RS
Q
7UDQVDFWLRQ 7UDQVDFWLRQ
3DUWLFLSDQW 3DUWLFLSDQW
DUH\R JRIRU
XUHDG LW
\"
JRRG QRS
WRJ UREO
R HP
DUH JR
\R IRU
XU LW
HDG
JR \" 7UDQVDFWLRQ QR
RG SU 7UDQVDFWLRQ
WR 3DUWLFLSDQW RE 3DUWLFLSDQW
JR OHP
7UDQVDFWLRQ 7UDQVDFWLRQ
0DQDJHU 0DQDJHU
7UDQVDFWLRQ 7UDQVDFWLRQ
3DUWLFLSDQW 3DUWLFLSDQW
\RXDUHKHUH
WUDQVDFWLRQSURSRJDWLRQ
0W_Q\_WZS[QV-2*
<ZIV[IK\QWV[KIVXZWXIOI\M\PZW]OPUM\PWLKITT[
7HEN A BEAN IS RUNNING CODE IN A TRANSACTION AND CALLS A METHOD ON ANOTHER BEAN
THREE DIFFERENT SCENARIOS ARE POSSIBLE
! 4HE CALLED METHOD RUNS IN THE CALLERS TRANSACTION
" 4HE CALLED METHOD RUNS WITHOUT A TRANSACTION
# 4HE CALLED METHOD RUNS WITHIN ITS OWN NEW TRANSACTION
$ 7KHWUDQVDFWLRQVWDUWHGLQWKH¿UVWPHWKRGSURSDJDWHVWRDOORWKHU
PHWKRGVLQWKHFDOOVWDFN$OOFDOOHGPHWKRGVUXQZLWKLQWKHVDPH
WUDQVDFWLRQ ,QWKLVERRNZH¶OODEEUHYLDWH³WUDQVDFWLRQ´WR³W[´
EDU
IRR
JR
%HDQ %HDQ %HDQ
%HDQ·VJR PHWKRGVWDUWV %HDQ·VIRR PHWKRGUXQVLQ %HDQ·VEDU PHWKRGUXQV
DWUDQVDFWLRQ W[$ WKHWUDQVDFWLRQIURP%HDQ LQWKHWUDQVDFWLRQ W[$
W[$ DQGFDOOVPHWKRGEDU SURSDJDWHGIURP%HDQ
%HDQFDOOVPHWKRG RQ%HDQ7KHWUDQVDFWLRQ
IRR RQ%HDQDQGWKH W[$ LVSURSDJDWHGLQWRWKH ,IDV\VWHPH[FHSWLRQ OLNH
WUDQVDFWLRQLVSURSDJDWHG PHWKRGFDOORQ%HDQ (-%([FHSWLRQ KDSSHQVLQDQ\
LQWRWKHPHWKRGFDOORQ RIWKHPHWKRGVLQW[$WKH
%HDQ ZKROHWUDQVDFWLRQUROOVEDFN
EDU W[$
IRR W[$ IRR W[$
JR W[$ JR W[$ JR W[$
3O WHAT DOES IT MEAN FOR MULTIPLE METHODS TO RUN IN THE SAME TRANSACTION CONTEXT 4HAT
DEPENDS ON THE BEAN TYPE AND WHAT THE BEANS DO IN THEIR CODE &OR EXAMPLE IMAGINE
"EAN ! HAS A METHOD WITH *$"# CODE THAT DOES AN UPDATE TO A DATABASE ROW )F ANY OTHER
METHOD IN THE SAME TRANSACTION CAUSES A ROLLBACK "EAN !S UPDATE WONT COMMIT EVEN IF
THE DATABASE WOULD HAVE BEEN MORE THAN HAPPY TO DO IT
&KDSWHU
(-%WUDQVDFWLRQV
;WUM\ZIV[IK\QWV[LWV¼\XZWXIOI\M
<PMKITTMZ¼[\ZIV[IK\QWVUQOP\JM[][XMVLML
)F A TRANSACTIONAL BEAN METHOD CALLS ANOTHER METHOD THE CALLED
METHOD WHETHER ITS IN THE SAME OR A DIFFERENT BEAN MIGHT NOT RUN
IN THE SAME TRANSACTION 4HE CALLED METHOD IN THAT CASE WILL RUN
WITH EITHER A BRAND NEW TRANSACTION OR WITH NO TRANSACTION AT ALL )N
A FEW MINUTES WELL LOOK AT HOW THE CONTAINER DECIDES WHETHER TO
PROPAGATE THE TRANSACTION RUN WITHOUT ONE OR START A NEW ONE
% 7KH¿UVWWUDQVDFWLRQLVVXVSHQGHGDQGWKHVHFRQGPHWKRG
UXQVZLWKRXWDWUDQVDFWLRQ
IRR
JR
%HDQ %HDQ ily
sa c t io n A is temporasrwithout
Tra n n
nd foo() ru
suspended taion.
IRR QRW[ a transac
JR W[$ JR W[$
VXVSHQGHG
& 7KH¿UVWWUDQVDFWLRQLVVXVSHQGHGDQGWKHVHFRQGPHWKRG
UXQVZLWKLQDQHZWUDQVDFWLRQ
IRR
JR
%HDQ %HDQ arily
a n sa c t io n A is tempourns in its
Tr nd foo() r
suspended aransaction (tx B).
IRR W[% own new t
JR W[$ JR W[$
\RXDUHKHUH
XVLQJWUDQVDFWLRQV
0W_LW1UISMWZOM\I\ZIV[IK\QWV'
<_W_Ia["KWLMQ\WZLMKTIZMQ\
4HE CONTAINER MANAGES YOUR TRANSACTIONS BUT YOU HAVE TO TELL IT HOW 9OU
CAN EITHER PUT TRANSACTION CODE IN YOUR BEAN CLASS OR YOU CAN PUT TRANSACTION
DECLARATIONS IN THE $$ "Y FAR THE MOST COMMON APPROACH IS TO USE THE
$$ BECAUSE ITS SIMPLER SUPPORTS BEAN REUSE AND IS THE ONLY WAY YOU CAN
DO TRANSACTIONS FOR ENTITY BEANS "Y PUTTING TRANSACTION INFORMATION IN THE
$$ INSTEAD OF IN CODE YOU CAN DEPLOY THE SAME BEAN MULTIPLE TIMES AND GET
DIFFERENT TRANSACTION BEHAVIOR EACH TIME WITHOUT EVER TOUCHING THE CODE
that youÕre
:ULWHWUDQVDFWLRQFRGHLQ\RXUEHDQ
tell the DrDe of transactions
taking ca
WUDQVDFWLRQW\SH!%HDQ WUDQVDFWLRQW\SH!
%HDQPDQDJHG LPSRUW
MDYD[HME
8VHU7UDQVDFWLRQXW FRQWH[WJHW8VHU7UDQVDFWLRQ
WUDQVDFWLRQV %07 LPSRUWMDYD
XWEHJLQ
UPL5HPRWH([
FHSWLRQ WUDQVDFWLRQDOFRGH
ically
MDYD XWFRPPLW programmat
25
'HFODUHWUDQVDFWLRQVLQWKH''
WUDQVDFWLRQW\SH!&RQWDLQHU WUDQVDFWLRQW\SH!
&RQWDLQHUPDQDJHG ´87)´"!
PHWKRG!
WUDQVDFWLRQV &07
declaratively
'2&7<3(
HMEMDU HMEQDPH!0\%HDQ HMEQDPH!
38%,QF
PHWKRGQDPH!EDU PHWKRGQDPH!
[PO PHWKRG!
WUDQVDWWULEXWH!5HTXLUHG WUDQVDWWULEXWH!
<RXFDQ·WXVH%27+LQ
VDPHEHDQ< RX FD Q·W
WKH
P L[%07
DQG&07LQRQHEHDQ
VLQWKH
QRI%07DQG&07EHDQ
<RX&$1KDYHDFRPELQDWLR RQO \RQH WUDQ VDF WLRQ
QPXVWKDYH
VDPHHMEMDUEXWHDFKEHD DFWLRQ FR GHLQD EH DQ
VHHWUDQV
W\SH2QWKHH[DPLI\RX
WKH''IRUWKDWEHDQLWVD\V
PDNHVXUHWKDWLI\RXVHH FWL RQ W\S H!
Q WUDQVD
WUDQVDFWLRQW\SH!%HD
&KDSWHU
(-%WUDQVDFWLRQV
<ZIV[IK\QWVZMTI\MLUM\PWL[
IZMQV\ _WQV\MZNIKM[
8VHU7UDQVDFWLRQ (YHU\WKLQJLQWKH8VHU7UDQVDFWLRQ
LQWHUIDFHLVIRUEHDQVXVLQJEHDQ
EHJLQ
PDQDJHGWUDQVDFWLRQV %07
FRPPLW
JHW6WDWXV
%HDQVZLWKFRQWDLQHUPDQDJHG
UROOEDFN
VHW5ROOEDFN2QO\ WUDQVDFWLRQV &07 DUHQ·WDOORZHGWR
VHW7UDQVDFWLRQ7LPHRXW FDOO$1<7+,1*LQWKLVLQWHUIDFH
MDYD[WUDQVDFWLRQ8VHU7UDQVDFWLRQ
(-%&RQWH[WKDVPHWKRGVIRUERWK%07
(-%&RQWH[W DQG&07EHDQV
)RU%07EHDQVRQO\
JHW8VHU7UDQVDFWLRQ
JHW8VHU7UDQVDFWLRQ
JHW&DOOHU3ULQFLSDO
JHW(-%+RPH
JHW(-%/RFDO+RPH )RUERWK%07DQG&07
LV&DOOHU,Q5ROH DOOQRQWUDQVDFWLRQUHODWHGPHWKRGV
VHW5ROOEDFN2QO\ )RU&07EHDQVRQO\
JHW5ROOEDFN2QO\ JHW5ROOEDFN2QO\
VHW5ROOEDFN2QO\
MDYD[HME(-%&RQWH[W
6XSHUFODVVRI6HVVLRQ&RQWH[W(QWLW\&RQWH[WDQG0HVVDJH'ULYHQ&RQWH[W
7KLQNDERXWWKHGLIIHUHQFHVEHWZHHQ&07DQG%07
YiX`e
gfn\i ,IWLHGXSDQGIRUFHGWRSLFNRQHRYHUWKHRWKHUZKLFK
ZRXOG\RXSLFN"
&07
%07
:K\":KDWDUHWKHSURVDQGFRQV"
\RXDUHKHUH
%07WUDQVDFWLRQV
5ISQVOI*5<\ZIV[IK\QWV
*HWD8VHU7UDQVDFWLRQUHIHUHQFHIURP\RXU(-%&RQWH[W
FRQWH[WJHW8VHU7UDQVDFWLRQ
6WDUWWKHWUDQVDFWLRQ
XWEHJLQ
g
(QGWKHWUDQVDFWLRQ FRPPLWRUUROOEDFN
fe re n ce to somethin
XWFRPPLW
e
Get a r lements the
XWUROOEDFN (WeÕll look at the actual that imp saction interface b)y on
exceptions later when we get
to UserTran tUserTransaction(
the Exceptions chapter). calling ge Context.
the EJB
SXEOLFYRLGFKHFN2XW WKURZV([FHSWLRQ^
8VHU7UDQVDFWLRQXW FRQWH[WJHW8VHU7UDQVDFWLRQ
this says, ÒStart a new transaction now.Ó
XWEHJLQ
DQRWKHU%HDQYDOLGDWH&UHGLW FXVWRPHU1XP
s u m e t h e s e methods
e as ht
FKHFN,QYHQWRU\
m e o t h e r methods; rwansaction (they mig
o
call s nder this new t ter.)
will run u weÕll get to that la
not, but
now weÕre ending th
container, ÒGo aheade transaction by telling the
XWFRPPLW
happened in this tran and commit everything that
saction.Ó
RUXWUROOEDFN
(or, we could end it with a rollback)
GR1RQ7[6WXII this method is called without a transaction. We
` canÕt tell from this code if doNonTxStuff()
starts its own transaction. WeÕd have to see that
method to know for sure.
&KDSWHU
(-%WUDQVDFWLRQV
+ITT[\IKSWN\PMKPMKS7]\UM\PWL
UTBEGIN IS CALLED AND THE UTBEGIN COMPLETES VALIDATE#REDIT IS CALLED AND
TRANSACTION STARTS AND NOW THE CHECKOUT RUNS IN THE SAME TRANSACTION
METHOD IS RUNNING IN A AS CHECK/UT
TRANSACTION TX !
XWEHJLQ W[$ YDOLGDWH&UHGLW W[$
FKHFN2XW FKHFN2XW W[$ FKHFN2XW W[$
VALIDATE#REDIT COMPLETES CHECK)NVENTORY IS CALLED CHECK)NVENTORY COMPLETES
POPS OFF THE STACK AND THE AND RUNS IN THE SAME AND POPS OFF THE STACK 4HE
CHECK/UT METHOD IS STILL TRANSACTION TX ! TRANSACTION TX ! IS STILL
RUNNING IN TX ! OPEN
FKHFN,QYHQWRU\ W[$
FKHFN2XW
FKHFN2XW W[$ FKHFN2XW W[$ FKHFN2XW W[$
COMMIT IS CALLED WHICH COMMIT COMPLETES AND DO.ON4X3TUFF IS CALLED
ENDS THE TRANSACTION NOW CHECK/UT IS RUNNING WITHOUT A TRANSACTION
WITHOUT A TRANSACTION
FRPPLW W[$ GR1RQ7[6WXII QRW[
FKHFN2XW W[$ FKHFN2XW QRW[ FKHFN2XW QRW[
\RXDUHKHUH
%07WUDQVDFWLRQV
6KDUSHQ \RXU SHQFLO
SXEOLFYRLGWHVW WKURZV([FHSWLRQ^
EOXH
8VLQJWKLVFRGHOLVWLQJPDUNWKH 8VHU7UDQVDFWLRQXW FW[JHW8VHU7UDQVDFWLRQ
JUHHQ
PDWFKLQJFDOOVWDFNIUDPHVZLWKD XWEHJLQ
FKHFNPDUNLIWKDWIUDPHLVFXUUHQWO\ SXUSOH
LQDWUDQVDFWLRQ:HGLGRQHLQWKH XWFRPPLW
UHG
PLGGOHIRU\RX
`
YRLGEOXH ^JUHHQ `
YRLGJUHHQ ^`
YRLGSXUSOH ^UHG `
YRLGUHG ^`
JUHHQ
VWDUW EOXH EOXH EOXH JHW8VHU7UDQV
WHVW WHVW WHVW WHVW WHVW WHVW
UHG
JUHHQ EHJLQ SXUSOH SXUSOH
WHVW WHVW WHVW WHVW WHVW WHVW WHVW
SXUSOH FRPPLW UHG HQG
WHVW WHVW WHVW WHVW WHVW WHVW
&KDSWHU
(-%WUDQVDFWLRQV
<PQVO[aW]U][\67<LW_Q\P*5<
$%07EHDQPXVW127VWDUWDWUDQVDFWLRQ
EHIRUHHQGLQJWKHFXUUHQWWUDQVDFWLRQ
SXEOLFYRLGJR ^ YiX`e
8VHU7UDQVDFWLRQXW FRQWH[WJHW8VHU7UDQVDFWLRQ gfn\i
out
ction withthe
XWEHJLQ ,PDJLQHWKHLPSOLFDWLRQV
a t r a n s a
art or rollback
) RIVWDUWLQJDQHZ
GR6WXII O! CanÕt st
NO! NO! Ng (through a commitdo that, it would WUDQVDFWLRQEHIRUHHQGLQJ
XWEHJLQ completinone. If you COULD transactionsÓ. WKHFXUUHQWRQH:KDW
previous could have Ònested PLJKWKDSSHQLI\RXZHUH
u DOORZHGWRGRWKLV"
`
1HVWHGWUDQVDFWLRQV
DUHQRWDOORZHGLQ(-%
DWWKH
<RX¶UHH[SHFWHGWRNQRZZK
DQV DFWLRQ ´P HDQ V
WHUP³QHVWHGWU
DWLWPLJKWORRN OLNH LQFRGH
DQGZK
$%07VWDWHOHVVVHVVLRQRUPHVVDJHGULYHQEHDQ
PXVW127FRPSOHWHDWUDQVDFWLRQDOPHWKRG
ZLWKRXWHQGLQJWKHWUDQVDFWLRQ YiX`e
gfn\i
SXEOLFYRLGJR ^
:K\DUHVWDWHIXOVHVVLRQ
8VHU7UDQVDFWLRQXW FRQWH[WJHW8VHU7UDQVDFWLRQ EHDQVDOORZHGWRHQGD
PHWKRGZLWKRXWHQGLQJWKH
XWEHJLQ
WUDQVDFWLRQ"
hod
eÕre ending the met
This is a problem! eWtransaction we started. In
GR0RUH
)RUDVWDWHIXOEHDQFDQ
` without ending thereÕs no commit() or rollback(). \RXWKLQNRIDVFHQDULR
other words, th KHUH\RXPLJKWZDQW
RGRWKLV OHDYHWKH
2QO\67$7(
)8/VHVVLR
UDQVDFWLRQRSHQ "
EHDQVFDQO Q :KDWPLJKWJRZURQJLI
HDYHD
WUDQVDFWLRQ RXGRWKLV"
RSHQDWWK
HQGRIDPH H
WKRG
\RXDUHKHUH
%07WUDQVDFWLRQV
*5<\ZIV[IK\QWV[IZMWVM_Ia"
\PMaKIVXZWXIOI\MW]\\WI+5<
JMIVJ]\VWW\PMZ\ZIV[IK\QWV
KIVXZWXIOI\MQV\WI*5<JMIV
%RWK%07DQG&07EHDQ ,·PD&07EHDQ
WUDQVDFWLRQVSURSDJDWH DQGWKDWPHDQV,·P
SURPLVFXRXVZKHQLWFRPHV
LQWRD&07EHDQ
WRWUDQVDFWLRQV,·OOXVH
DQ\RQH·V
W[FR
P
&07 LQJIUR
&07EHDQ EHD PD
Q
$&07EHDQFDQUXQLQ
WUDQVDFWLRQVFRPLQJIURP
ERWK&07DQG%07EHDQV
7RWKHFDOOHG&07EHDQLW
D &07EHDQ
IURP PDNHVQRGLIIHUHQFHKRZ RU
%07EHDQ PLQJ
W[FR EHDQ E\ZKRP WKHWUDQVDFWLRQ
%07
ZDVVWDUWHG
$%07EHDQZLOO1(9(5XVHDQ\
RWKHUEHDQ·VWUDQVDFWLRQ7KHFDOOHU·V
WUDQVDFWLRQZLOOEHVXVSHQGHG ,SUDFWLFH
ns are VDIHW[7KHRQO\
Transactiod when they WUDQVDFWLRQV,UXQLQ
suspende BMP bean! DUHP\RZQ,IDFDOOHU·V
WUDQ
V get to a WUDQVDFWLRQFRPHVLQ,
&07EHDQ IURP DFWLRQV MXVWVD\´VXVSHQGµ
D& F
07E RPLQJ
HDQ
%07EHDQ
J
RPLQ
F W L R QVF Q
D H D
%07EHDQ WUDQV %07E 7KHRQO\WUDQVDFWLRQD%07
U R P D
I EHDQZLOOUXQLQLVRQHWKDWWKH
EHDQLWVHOIFUHDWHV
&KDSWHU
(-%WUDQVDFWLRQV
:KHQDWUDQVDFWLRQLV
?PI\LWM[Q\UMIV\W[][XMVL VXVSHQGHGLWZDLWVXQWLOLW
I\ZIV[IK\QWV' FDQSLFNXSZKHUHLWOHIW
RII%XWWKLVPHDQVWKDWWKH
)F A TRANSACTION IS IN PROGRESS WHEN A METHOD ON A "-4
BEAN IS CALLED THE TRANSACTION IS SUSPENDED 4EMPORARILY WKLQJVWKDWKDSSHQZKLOHWKH
4HE TRANSACTION JUST SITS THERE WAITING FOR THE "-4 BEAN WUDQVDFWLRQLVVXVSHQGHGDUH
TO COMPLETE ITS WORK 7ORK THATS NOT PART OF THE CALLERS
ORIGINAL TRANSACTION /NCE THE "-4 METHOD lNISHES AND 127SDUWRIWKHVDPHDWRPLF
IS POPPED OFF THE STACK THE ORIGINAL TRANSACTION KICKS
BACK IN RIGHT WHERE IT LEFT OFF
XQLW,QRWKHUZRUGVWKH
)MAGINE THIS SCENARIO A #-4 BEAN BEAN ONE IS RUNNING WKLQJVWKDWKDSSHQZKLOHWKH
A METHOD FOO IN A TRANSACTION TX ! WHEN IT CALLS A WUDQVDFWLRQLVVXVSHQGHGZRQ·W
METHOD BAR ON BEAN TWO A "-4 BEAN /NCE BAR
COMPLETES AND POPS OFF THE STACK METHOD FOO INVOKES EHUROOHGEDFNLIWKHVXVSHQGHG
ANOTHER METHOD BEE BUT THIS TIME THE CALLED BEAN IS
ANOTHER #-4 BEAN BEAN THREE
WUDQVDFWLRQ DIWHULWFRPHV
EDFNWROLIH IDLOVWRFRPPLW
%07EHDQ
&07EHDQLQ VXVSHQGVW[$DQG
DU
DOOVE
W[$ F UXQVEDU LQDQHZ
WUDQVDFWLRQW[%
FDOO
VE
HH &07EHDQJHWVWKH
WUDQVDFWLRQDQGUXQV
PHWKRGIRR
EHH LQW[$
VWDUWV
EDU W[% EHH W[$
IRR W[$ IRR W[$ IRR W[$
VXVSHQGHG
-ETHOD FOO OF A #-4 BEAN -ETHOD BAR SUSPENDS 7HEN METHOD BAR COM
IS RUNNING IN TRANSACTION ! TRANSACTION ! AND STARTS A PLETES FOO RESUMES AND
-ETHOD FOO THEN INVOKES NEW TRANSACTION " -ETHOD PICKS UP TRANSACTION ! AGAIN
METHOD BAR ON A "-4 BEAN BAR RUNS IN THE NEW )T THEN CALLS METHOD BEE
TRANSACTION " THEN COMPLETES ON BEAN THREE A #-4 BEAN
-ETHOD BEE RUNS IN FOO S
EXISTING TRANSACTION !
\RXDUHKHUH
WKH8VHU7UDQVDFWLRQLQWHUIDFH
<PM=[MZ<ZIV[IK\QWVQV\MZNIKM
JAVAXTRANSACTION5SER4RANSACTION
6KDUSHQ \RXU SHQFLO
4HE 5SER4RANSACTION INTERFACE HAS SIX METHODS FOR
THE THINGS A "-4 BEAN MIGHT WANT TO DO 4RY TO FIGURE
OUT THE METHOD NAMES BASED ON THE DESCRIPTION OF
WHAT YOU WANT TO DO 4HE ANSWERS ARE AT THE BOTTOM
UPSIDE DOWN SO DONT LOOK DOWN THERE
%HJLQDWUDQVDFWLRQ
XWBBBBBBBBBBBBBBBBBBBBBB
(QGDWUDQVDFWLRQ
XWBBBBBBBBBBBBBBBBBBBBBB
8VHU7UDQ
VDFWLRQL
IRU%07E V
RU HDQVRQO\
$&07EH
DQ
XWBBBBBBBBBBBBBBBBBBBBBB VXSSRVHG LVQHYHU
WRJHW R
WRXVH D UWU \
UHIHUHQF
8VHU7UDQ HWRD
0DUNDWUDQVDFWLRQIRUUROOEDFN VDFWLRQ
XWBBBBBBBBBBBBBBBBBBBBBB
7
FWLRQLV12
)LQGRXWWKHVWDWXVRIWKHWUDQVDFWLRQ
8VHU7UDQVD
IRUHQWLW\E
HD QV 6LQ F H
V086 7
HQWLW\EHDQ
XWBBBBBBBBBBBBBBBBBBBBBB 7LI\R XVHH
EH&0 Q
FWLRQFRGHL
8VHU7UDQVD X N Q RZ
HDQ\R
DQHQWLW\E OH JD O
6HWWKHWUDQVDFWLRQWLPHRXW R W
WKHFRGH·VQ
XWBBBBBBBBBBBBBBBBBBBBBB
7KHUH¶VQRWKLQJDERXWWUDQVDFWLRQ
WLPHRXWRQWKHH[DP
$OOWUDQVDFWLRQVKDYHVRPHGHIDXOWWLPHRXWYDOXH
EXW\RXFDQFKDQJHWKDWZLWK
VHW7UDQVDFWLRQ7LPHRXW DQ,QW9DOXH $VDEHDQGHYHORSHU
\RX¶OOSUREDEO\QHYHUXVHDQ\WKLQJEXWWKHGHIDXOWWLPHRXW JHW6WDWXV VHW7UDQVDFWLRQ7LPHRXW
YDOXHVRZHGRQ¶WWHVWIRULWRQWKHH[DP EHJLQ FRPPLW RUUROOEDFN VHW5ROOEDFN2QO\
&KDSWHU
(-%WUDQVDFWLRQV
[M\:WTTJIKS7VTa
<PM[W]VLWNI\ZIV[IK\QWV¼[LMI\P
7HEN A BEAN CALLS SET2OLLBACK/NLY IT MEANS
THAT TRANSACTION IS GOING DOWN /NCE YOU INVOKE
SET2OLLBACK/NLY THE TRANSACTION IS DOOMED TO NEVER EVER
COMMIT
3O WHAT DOES IT MEAN TO SENTENCE A TRANSACTION TO
DEATH )T MEANS THE TRANSACTION DElNITELY WONT
COMMIT $UH "UT IT ALSO MEANS THAT ANY PARTICIPANT ,W·VWUDJLF
IN THE TRANSACTION IE ANY BEAN CAN CHECK TO SEE IF
THE TRANSACTION IS ALREADY MARKED FOR DEATH :KHQ\RXFDOOWKH
VHW5ROOEDFN2QO\ PHWKRG
2EMEMBER A TRANSACTION STARTED BY A "-4 BEAN \RXVHWDÁDJWKDWFDQ
MIGHT PROPAGATE TO METHOD CALLS THAT THE "-4 WHOORWKHUEHDQVWKDWWKH
BEAN MAKES ON #-4 BEANS ! #-4 BEAN IN A WUDQVDFWLRQZLOOHQGRQO\
"-4
STARTED TRANSACTION MIGHT WANT TO SENTENCE THE RQHZD\KRUULEO\
TRANSACTION TO DEATH OR AT LEAST lND OUT WHETHER ITS
ALREADY DOOMED ,I\RXNQRZLQ\RXUFRGH
)N A #-4 BEAN SET2OLLBACK/NLY IS HOW YOU TELL THE WKDWWKLQJVDUHQ·WJRLQJWR
CONTAINER THAT IT MUST NOT COMMIT THE TRANSACTION )F YOU ZRUNFDOOWKLVPHWKRG
CAN lGURE OUT IN YOUR BUSINESS LOGIC THAT A TRANSACTION ,IWKHWUDQVDFWLRQLVJRLQJ
IS GOING TO END BADLY CALL SET2OLLBACK/NLY 4HE WRGLHLW·VSUREDEO\IRUWKH
CONTAINER WONT END THE TRANSACTION AT THAT POINT BUT EHVW,WZDVPHDQWWREH
WHEN IT DOES END AT ITS NATURAL TIME IT DElNITELY WONT ,W·VJRLQJWRDEHWWHUSODFH
COMMIT
3O WHEN DOES A TRANSACTION END !SSUMING NO 3YSTEM
%XCEPTIONS ARE THROWN A TRANSACTION ENDS WHEN THE
#-4 METHOD THAT STARTED THE TRANSACTION COMPLETES OR
FOR A "-4 BEAN WHEN THE BEANS CODE CALLS COMMIT OR
ROLLBACK
nsaction can ra call
t ra
Any bea n in t h is
() t o m a k e su re t nsaction
y
setRollbackOmnlits.
Z neve r co m
nly(), it
B ea n B ca ll s setRollbackOdoes -- the
If what Bean C be
wonÕt matterl code in Bean C will nevern C
transactio na if B ea
%HDQ$ DPHWKRGLQ
DPHWKRGLQ
%HDQ&LVFDOOHG committed. Would
nÕt it be nice Bean C does
VWDUWVW[= %HDQ%LVFDOOHG O R E
out BEF hat in a minute.
DQGUXQVLQW[=
DQGUXQVLQW[=
could Þnd that rk? WeÕll see t
a bunch of wo
\RXDUHKHUH
WKHVHW5ROOEDFN2QO\ PHWKRG
,·PVWLOOPLVVLQJ
VRPHWKLQJKHUHLI,·P
XVLQJ%07ZK\ZRXOG,FDOO
VHW5ROOEDFN2QO\ ZKHQ,FDQ
MXVWFDOOUROOEDFN DQGHQGLW
ULJKWWKHUH"
<RXPLJKWNQRZ+2:D%07WUDQVDFWLRQVKRXOGHQG
EHIRUHLW·VWLPHWRDFWXDOO\HQGLW
)N YOUR "-4 CODE YOU MIGHT HAVE A SINGLE PLACE AT THE END OF THE
TRANSACTIONAL CODE WHERE YOU SAY EITHER UTCOMMIT OR UTROLLBACK
4HAT SINGLE PLACE MIGHT BE A SIMPLE IF TEST
LI WKLQJV/RRN*RRG ^ f
XWFRPPLW pi c al ex a m p le : at the endolloback
A ty n, commit or r
HOVH^ the transactmioe conditions.
XWUROOEDFN based on so
`
"UT IF SOMEWHERE EARLIER IN YOUR CODE YOU CAN TELL THAT THE TRANSACTION
IS DOOMED YOU SHOULD CALL SET2OLLBACK/NLY
LI WKLQJV/RRN%DG ^
XWVHW5ROOEDFN2QO\
`
4HIS GIVES OTHER TRANSACTION PARTICIPANTS A SIGNAL IF THEY CARE TO
CHECK THAT THE TRANSACTION IS ALREADY DOOMED
%VEN IF YOUR "-4 CODE DOESNT CALL SET2OLLBACK/NLY SOME OTHER
CODE IN THE TRANSACTION COULD HAVE SO YOU MIGHT WANT TO lND THAT
OUT )N JUST A FEW MORE PAGES FROM NOW WELL LEARN HOW A BEAN CAN
CHECK WHETHER ANYONE HAS MARKED A TRANSACTION FOR ROLLBACK
&KDSWHU
(-%WUDQVDFWLRQV
[M\:WTTJIKS7VTaTQ^M[QV<?7QV\MZNIKM[
8VHU7UDQVDFWLRQ (-%&RQWH[W
EHJLQ
FRPPLW JHW&DOOHU3ULQFLSDO
JHW6WDWXV JHW(-%+RPH
UROOEDFN JHW(-%/RFDO+RPH
VHW5ROOEDFN2QO\
VHW7UDQVDFWLRQ7LPHRXW
JHW5ROOEDFN2QO\
JHW8VHU7UDQVDFWLRQ
%H685(\
RX
LV&DOOHU,Q5ROH NQRZWKHU
XOHV
VHW5ROOEDFN2QO\ IRU%27+R
IWKH
VHW5ROOEDF
(YHU\WKLQJLQ8VHU7UDQVDFWLRQ N2QO\
PHWKRGV
LVIRU%07EHDQV21/<
%HUHDG\IRUW
KHH[DPWRWH
VHW5ROOEDFN2QO\ LQ(-%&RQWH[W WKHXVHRIVHW VW\RXRQ
5ROOEDFN2QO\
LVIRU&07EHDQV21/< %07DQG&0 IRUERWK
7EHDQV
(-%&RQWH[WV
4HE METHODS IN THE 5SER4RANSACTION INTERFACE ARE HW5ROOEDFN2QO
\
FOR "-4 BEANS ONLY #-4 BEANS CANT USE ANYTHING IN 8VHU7UDQVDF
WLRQVHW5ROOEDF
5SER4RANSACTION N2QO\
5HPHPEHUQR
4HE %*"#ONTEXT INTERFACE ON THE OTHER HAND IS VLQJOHEHDQF
DQHYHU
XVH%27+RIW
FOR BOTH "-4 AND #-4 BEANS EXCEPT FOR THE TWO KHVH
TRANSACTION METHODS &07EHDQVFD
QXVHRQO\WK
4HE SET2OLLBACK/NLY AND GET2OLLBACK/NLY (-%&RQWH[WV H
HW5ROOEDFN2QO
\
METHODS IN %*"#ONTEXT ARE OFF
LIMITS TO "-4 BEANS
%07EHDQVFD
QXVHRQO\WK
"OTTOM LINE "-4 BEANS CALL SET2OLLBACK/NLY ON A 8VHU7UDQVDF H
WLRQVHW5ROOEDF
5SER4RANSACTION #-4 BEANS CALL SET2OLLBACK/NLY N2QO\
ON AN %*"#ONTEXT ([SHFWWRVHH
FRGHH[DPSOHV
\RX¶OOQHHGWR Z
¿JXUHRXWLIWKH KHUH
%07RU&07 EHDQLV
O\ E\ORRNLQJDWWK
EDFN2Q HFRGH
VHW5ROO $QGLWZRQ¶WEH
6 7 E
KD
HL
WF
$EHDQW QDWUDQVDFWLR
D OOV
Q
21/<
WRJHW8VHU7UD
FDOOWR(-%&RQ
DVREYLRXVDV
QVDFWLRQ ,I\R
DFDOO
XVHHD
0 8
P D% 07EHDQ LQ WH[WVHW5ROOEDF
2QO\ I UR RQO\ZLWK IRUH[DPSOH\ N2
RXNQRZWKDWWK QO\
Q FD OOV H W5ROOEDFN ,Q R WKHUZRUGV LW RU EHD&07EH LVPXVW
<RXFD QVDFWLR Q WFRPP DQ6RLIWKDWV
QVLGHDWUD XWEHJLQ DQGDX WKDWFDOOV ODWHUVWDUWVD8 DPHEHDQ
LI\RX¶UHL H HQ D HWKR G VHU7UDQVDFWLR
FRGHWKDW¶
VEHWZ
07EHDQ
WKHP DFWLRQ NQRZWKHFRGH Q\RX
) RUD & SS URS ULDWHWUDQV LVLOOHJDO
D FN D YH D QD R Z
XWUROOE XVWK IURPQ
FN2QO\ P HZSDJHV
VHW5ROOED ¶OOJHWLQWRWKDWDI
ZH
DWWULEXWH
\RXDUHKHUH
JHW5ROOEDFN2QO\ PHWKRG
OM\:WTTJIKS7VTa
*MKI][MTQNM¼[\WW[PWZ\NWZIJMIV\W_I[\M\QUM
&07EHDQVFDOO
/NCE A BEAN HAS CALLED SET2OLLBACK/NLY THE TRANSACTION
IS SENTENCED TO DEATH )T WILL NEVER COMMIT "UT THE
JHW5ROOEDFN2QO\ WR
TRANSACTION MIGHT STILL HAVE A LONG WAY TO GO WITH PLENTY OF ILQGRXWLIWKHWUDQVDFWLRQ
OTHER METHODS IN OTHER BEANS AND WITH LOTS OF HEAVY CODE
)MAGINE YOURE A BEAN (OW WOULD YOU FEEL IF THE WKH\·UHLQLVDOUHDG\
TRANSACTION WERE ALREADY DOOMED BEFORE YOUR METHODS
WERE CALLED BUT NOBODY TOLD YOU
GRRPHG,IWKHWUDQVDFWLRQ
LVQHYHUJRLQJWRFRPPLW
2K
OLNH,GRQ·WKDYH
ZK\VKRXOGWKHEHDQZDVWH
%(77(5WKLQJVWRGRWKDQ
UXQP\OLQHVRIFRGH
WLPHZLWKORWVRIFRGH"
ZKHQLW·VDOUHDG\D'HDG
7UDQVDFWLRQ:DONLQJ"
)F YOURE A #-4 BEAN YOU CAN CALL GET2OLLBACK/NLY TO l ND
OUT IF YOUR TRANSACTION HAS ALREADY BEEN SENTENCED TO DEATH
)F IT HAS WHY BOTHER DOING ANY WORK
LI JHW5ROOEDFN2QO\ ^
VDYH:RUOG
JHW5ROOED
FN2QO\
LV127IR
U%07
`HOVH^ EHDQV2
QO\&07
EHDQVFD
QFDOO
DEDQGRQ$OO+RSH JHW5ROOED
FN2QO\
&KDSWHU
(-%WUDQVDFWLRQV
*5<JMIV[][MOM\;\I\][QV[\MILWNOM\:WTTJIKS7VTa
8VHU7UDQVDFWLRQ (-%&RQWH[W
EHJLQ
FRPPLW JHW&DOOHU3ULQFLSDO
JHW6WDWXV JHW(-%+RPH
UROOEDFN JHW(-%/RFDO+RPH
VHW5ROOEDFN2QO\ JHW5ROOEDFN2QO\
VHW7UDQVDFWLRQ7LPHRXW JHW8VHU7UDQVDFWLRQ
LV&DOOHU,Q5ROH
VHW5ROOEDFN2QO\
7KHUH·VQRJHW5ROOEDFN2QO\
LQ8VHU7UDQVDFWLRQ%07EHDQV
FDOOJHW6WDWXV LQVWHDG
JHW5ROOEDFN2QO\ LVIRU&07
EHDQVRQO\
4HE GET2OLLBACK/NLY METHOD RETURNS A BOOLEANTRUE IF THE METHOD HAS
BEEN MARKED FOR ROLLBACK FALSE IF NOBODYS ASKED FOR A ROLLBACK 4HATS ALL A
#-4 BEAN CAN AND NEEDS TO KNOW ABOUT THE TRANSACTIONS STATUS
"-4 BEANS ON THE OTHER HAND ARE MORE INVOLVED IN CONTROLLING THE
TRANSACTION AND THEY MIGHT WANT TO KNOW A LOT MORE 4HE GET3TATUS METHOD
IN 5SER4RANSACTION CAN TELL YOU ANYTHING YOUD EVER WANT TO KNOW AND SO
MUCH MORE ABOUT HOW THE TRANSACTION IS DOING
<RXGRQ¶WQHHGWRPHPRUL]HWKHVWDWXVFRQVWDQWV
7KHJHW6WDWXV PHWKRGUHWXUQVDQLQWUHSUHVHQWLQJDFRQVWDQW
IRUWKLQJVOLNH 67$786B$&7,9(67$786B&200,77('67$786B
&200,77,1*67$786B7+,1.,1*B$%287B&200,77,1* MXVWNLGGLQJRQWKLVRQH
67$786B0$5.('B52//%$&.67$786B52//,1*B%$&.DQGRXUSHUVRQDODQG
PRVWXVHIXOIDYRULWH67$786B81.12:1
7KHVHFRQVWDQWVDUHGH¿QHGLQWKHMDYD[WUDQVDFWLRQ6WDWXVLQWHUIDFH ZKLFKKDVQR
PHWKRGVMXVWDSLOHRIWKHVHVWDWXVFRQVWDQWV DQG\RXPLJKW¿QGWKHPKHOSIXOLI
\RX¶UHZULWLQJ%07FRGH%XWWKH\¶UHQRWRQWKHH[DP<RX'2QHHGWRNQRZWKDWWKH
JHW6WDWXV PHWKRGLVLQ8VHU7UDQVDFWLRQDQGWKDWLW¶VWKHRQO\ZD\D%07EHDQFDQ
¿QGRXWLIVRPHERG\FDOOHGVHW5ROOEDFN2QO\ EXWWKDW¶VLW
\RXDUHKHUH
%07FDQKXUWUHXVH
*5<KIVJMIZMITTa*),QLMI
*5<P]Z\[JMIVZM][M
#AN YOU lGURE OUT WHY
4HINK ABOUT WHAT YOU LEARNED ON THE LAST FEW PAGES ESPECIALLY ABOUT TRANSACTION
PROPAGATION THE WHOLE ONE
WAY THING
,I\RXZULWHD%07EHDQQRERG\HOVHFDQHYHULQFOXGH
\RXUEHDQLQWKHLUWUDQVDFWLRQ
9OUR "-4 BEAN PUTS UP A BIG FAT WALL SO CALLING TRANSACTIONS CANT PASS 2EMEMBER
A "-4 BEAN WILL RUN ONLY IN THE TRANSACTIONS THE BEAN ITSELF CREATES AND STARTS 9OU
DEFEAT THE WHOLE POINT OF A COMPONENT MODEL IF YOU LOCK DOWN THE TRANSACTION
DEMARCATION INSIDE THE BEAN 2EMEMBER THE COOL THING ABOUT A COMPONENT MODEL IS
THAT COMPONENTS CAN BE MIXED AND COMBINED IN NEW WAYS TO MAKE NEW APPLICATIONS
THAT THE "EAN 0ROVIDER HADNT EVER THOUGHT ABOUT 4HE PURPOSE OF THE DEPLOYMENT
DESCRIPTOR IS TO GIVE THE APPLICATION ASSEMBLER A WAY TO CONlGURE TRANSACTIONS SPECIlC
TO A PARTICULAR APPLICATION WITHOUT TOUCHING THE BEAN CODE
,ILW·VVREDGWRXVH%07ZK\LVLWWKHUH"
"ECAUSE IT LETS YOU DO A FEW THINGS YOU SIMPLY CANNOT DO WITH #-4 "UT MOST OF THE
TIME YOU WONT NEED THESE THINGS
:LWK%07\RXFDQUHGXFHWKHVFRSHRIDWUDQVDFWLRQ
5SING #-4 YOU CANNOT MARK A TRANSACTION AT ANYTHING SMALLER THAN A SINGLE METHOD
9OU PUT IN THE DEPLOYMENT DESCRIPTOR WHICH TRANSACTION ATTRIBUTE WERE GETTING
THERE GOES WITH WHICH METHOD 9OU CANT SPECIFY A PART OF A METHOD "UT WITH
"-4 YOU CAN START THE TRANSACTION AND END IT AT A SMALLER SCOPE 4HIS CAN IMPROVE
PERFORMANCE BECAUSE THE LONGER A TRANSACTION LASTS THE MORE LIKELY YOU ARE TO HURT
YOUR CONCURRENCY "UT THE TRADEOFFHURTING YOUR REUSEIS ALMOST NEVER WORTH IT AND
THERE ARE USUALLY MUCH BETTER WAYS OF INCREASING THE PERFORMANCE
:LWK%07\RXFDQOHDYHDVWDWHIXOVHVVLRQEHDQWUDQVDFWLRQRSHQDFURVV
PXOWLSOHLQYRFDWLRQVIURPWKHFOLHQW
7ITH "-4 YOU CAN OPEN A TRANSACTION CALL UTBEGIN IN ONE METHOD AND END THE
METHOD WITHOUT ENDING THE TRANSACTION ! BIG NO
NO FOR MESSAGE
DRIVEN OR STATELESS
SESSION BEANS "UT THIS IS ALMOST ALWAYS A REALLY BAD DESIGN IDEA SO ITS PROBABLY NEVER
GOING TO BE A GOOD REASON FOR "-4
:LWK%07\RXVHSDUDWHWUDQVDFWLRQFRPPLWVWDWXVIURPPHVVDJH
DFNQRZOHGJPHQW7KLVPLJKWEHDJRRGUHDVRQIRU%07
7E COVERED THIS IN MORE DETAIL IN THE -$" CHAPTER BUT THE SHORT VERSION IS WITH #-4
MESSAGE ACKNOWLEDGMENT IS SENT ONLY WHEN AND IF THE TRANSACTION COMMITS )N SOME
DESIGNS YOU CAN END UP WITH POISON MESSAGES
&KDSWHU
(-%WUDQVDFWLRQV
,PDQDJH
\RXUWUDQVDFWLRQVE\
ORRNLQJDWZKDW\RXSXWLQWKH
GHSOR\PHQWGHVFULSWRUIRUHDFKPHWKRG
,I\RXUPHWKRGQHHGVDWUDQVDFWLRQ,·OO
VWDUWRQHRUDGG\RXWRWKHFDOOHU·V
GHSHQGLQJRQWKHDWWULEXWHV,FDQHYHQ
VXVSHQGDWUDQVDFWLRQLI\RXQHHGWR
UXQZLWKRXWRQH
+WV\IQVMZUIVIOML\ZIV[IK\QWV[
.OW THAT WEVE LOOKED AT THE DO
IT
YOURSELF WAY TO DEMARCATE
TRANSACTIONS YOULL SEE HOW EASY IT IS WITH #-4 3O EASY THAT
YOU DONT WRITE ANYTHING TRANSACTIONAL IN YOUR CODE EXCEPT
MAYBE AN OCCASIONAL CALL TO %*"#ONTEXTSET2OLLBACK/NLY OR
%*"#ONTEXTGET2OLLBACK/NLY
7ITH #-4 TRANSACTIONS ARE STARTED AND COMPLETED WITH
EITHER A COMMIT OR ROLLBACK BY THE CONTAINER BASED SOLELY
ON THE DEPLOYMENT DESCRIPTOR 9OU /+ TECHNICALLY
THE !PPLICATION !SSEMBLER MARK SOME ATTRIBUTES IN THE
DEPLOYMENT DESCRIPTOR AND THATS IT
!LMOST
5NLESS YOU UNDERSTAND EXACTLY WHAT THE SIX TRANSACTION
ATTRIBUTES ARE AND THE IMPLICATIONS OF HOW DIFFERENT ATTRIBUTES
INTERACT AT RUNTIME YOU WONT HAVE A CLUE ABOUT WHETHER YOUR
BEAN IS EVEN GOING TO BE IN A TRANSACTION /R HOW BIG THE
TRANSACTION WILL BE /R WHETHER YOUVE CREATED A DANGEROUS
SITUATION THAT COULD BLOWUP AT RUNTIME
&ORTUNATELY THERE ARE ONLY SIX !ND THE RULES FOR HOW THE
CONTAINER BEHAVES WITH EACH OF THOSE ATTRIBUTES IS VERY CLEAR
AND SIMPLE
\RXDUHKHUH
WUDQVDFWLRQDWWULEXWHV
0W_I\\ZQJ]\M[_WZS
0DUNDPHWKRGZLWKRQHRIVL[
WUDQVDFWLRQDWWULEXWHV
5HTXLUHG )RR%HDQ
5HTXLUHV1HZ VHW)RR Required
0DQGDWRU\ JHW)RR Supports
6XSSRUWV GR%DU Required
GR%LJ7KLQJ
1RW6XSSRUWHG RequiresNew
1HYHU
:KHQWKHPHWKRGLVFDOOHGWKH
FRQWDLQHUXVHVWKHDWWULEXWHWRGR
RQHRIÀYHWKLQJV
YRLGJR ^
5XQWKHPHWKRGLQWKHFDOOHU·V D)RR%HDQVHW)RR
WUDQVDFWLRQ `
25
6XVSHQGWKHFDOOHU·VWUDQVDFWLRQDQG /HW·VVHHWKH
VWDUWDQHZWUDQVDFWLRQ JR PHWKRGLVDOUHDG\LQD
25 WUDQVDFWLRQZKHQLWFDOOVVHW)RR
DQGVHW)RR KDVD5HTXLUHGW[
6XVSHQGWKHFDOOHU·VWUDQVDFWLRQDQGUXQ DWWULEXWHVR,ZLOOUXQVHW)RR LQ
WKHPHWKRGZLWKRXWDWUDQVDFWLRQ
WKHVDPHWUDQVDFWLRQDVJR
25
7KURZDQH[FHSWLRQEHFDXVHWKHFDOOHU
GRHVQRWKDYHDWUDQVDFWLRQ
25
7KURZDQH[FHSWLRQEHFDXVHWKHFDOOHU
GRHVKDYHDWUDQVDFWLRQ
&KDSWHU
(-%WUDQVDFWLRQV
$VDQ$SSOLFDWLRQ
$VVHPEOHU,KDYHWR
NQRZP\DWWULEXWHVVRWKDW,
FDQJHWWKHEHKDYLRU,GHVLUH
IURPP\EHDQV
3VW_aW]ZI\\ZQJ]\M[
+RZDQDWWULEXWHDIIHFWVEHKDYLRUGHSHQGVRQ
RQHWKLQJ
,VWKHFDOOLQJPHWKRGLQDWUDQVDFWLRQ"
(tx A)
foo() is in a transactioann ot
on her
when it calls bar() is
SXEOLFYRLGIRR ^
bean. The bar() me th od
D%HDQEDU
` marked as Required.
-ETHOD FOO IS IN A TRANSACTION TX !
IRR W[$
-ETHOD BAR IS MARKED WITH THE 2EQUIRED
TRANSACTION ATTRIBUTE
PHWKRG!
HMEQDPH!0\%HDQ HMEQDPH!
PHWKRGQDPH!EDU PHWKRGQDPH!
PHWKRG!
WUDQVDWWULEXWH!5HTXLUHG WUDQVDWWULEXWH!
The bar() metho
transaction as fodo(runs in the same
Required and foo() ) because bar() is marked
foo() had NOT be has a transaction. If 4HE BAR METHOD RUNS IN THE CALLERS TRANSACTION TX !
the container wou en in a transaction,
transaction for bald have started a new
r() to run in. EDU W[$
IRR W[$
\RXDUHKHUH
DWWULEXWHVWKDWUHTXLUHDWUDQVDFWLRQ
7UDQVDFWLRQDWWULEXWHVWKDW
UHTXLUHDWUDQVDFWLRQ
$WWULEXWHIRUEDU IRR WUDQVDFWLRQVWDWXV UHVXOW
5HTXLUHG
, EDU W[$
, IRR W[$ ° , IRR W[$
,IWKHPHWKRGLVFDOOHG
LQWUDQVDFWLRQ$ W[$ EDU UXQVLQW[$
ZLWKDQH[LVWLQJ
WUDQVDFWLRQFRQWH[WWKH
PHWKRGUXQVLQWKDW
H[LVWLQJWUDQVDFWLRQ,I , EDU W[$
WKHUHLVQ¶WDWUDQVDFWLRQ IRR BBB ° IRR BBBB
WKHFRQWDLQHUZLOOVWDUWD
QHZRQH QRWUDQVDFWLRQ FRQWDLQHUVWDUWVDQHZWUDQVDFWLRQ
W[$ IRUEDU
5HTXLUHV1HZ
, EDU W[%
, IRR W[$ ° , IRR W[$
7KHPHWKRGZLOO
LQWUDQVDFWLRQ$ W[$ FRQWDLQHUVXVSHQGVW[$DQGVWDUWV
DOZD\VUXQZLWKDQHZ DQHZWUDQVDFWLRQ W[% IRUEDU
WUDQVDFWLRQ,IWKH
PHWKRGLVFDOOHGZLWK
DQH[LVWLQJWUDQVDFWLRQ , EDU W[$
FRQWH[WWKHFDOOHU¶V IRR BBB ° IRR BBBB
WUDQVDFWLRQLVVXVSHQGHG
XQWLOWKLVPHWKRG QRWUDQVDFWLRQ FRQWDLQHUVWDUWVDQHZWUDQVDFWLRQ
FRPSOHWHV W[$ IRUEDU
0DQGDWRU\
, EDU W[$
, IRR W[$ ° , IRR W[$
'DQJHU0DQGDWRU\
LQWUDQVDFWLRQ$ W[$ EDU UXQVLQW[$
UHDOO\PHDQV
³5HTXLUHV([LVWLQJ´,IWKH
PHWKRGLVFDOOHGZLWKRXW
V
- `K M X \ Q W
DQH[LVWLQJWUDQVDFWLRQ
BBB
FRQWH[WWKHFRQWDLQHU IRR °
WKURZVDQH[FHSWLRQ
QRWUDQVDFWLRQ
&KDSWHU
(-%WUDQVDFWLRQV
7UDQVDFWLRQDWWULEXWHVWKDWGR
QRWUHTXLUHDWUDQVDFWLRQ
$WWULEXWHIRUEDU IRR WUDQVDFWLRQVWDWXV UHVXOW
6XSSRUWV
, EDU W[$
, IRR W[$ ° , IRR W[$
,IWKHPHWKRGLVFDOOHG
LQWUDQVDFWLRQ$ W[$ EDU UXQVLQW[$
ZLWKDQH[LVWLQJ
WUDQVDFWLRQFRQWH[WWKH
PHWKRGUXQVLQWKDW
EDU BBBB
WUDQVDFWLRQ,IWKHUHLVQ¶W
DWUDQVDFWLRQWKHPHWKRG IRR BBB ° IRR BBBB
UXQVZLWKDQ³XQVSHFL¿HG
WUDQVDFWLRQFRQWH[W´ QRWUDQVDFWLRQ EDU UXQVZLWKDQ³XQVSHFL¿HG
WUDQVDFWLRQFRQWH[W´
EDU BBBB
1RW6XSSRUWHG
, IRR W[$ ° , IRR W[$
,IWKHPHWKRGLVFDOOHGZLWK
LQWUDQVDFWLRQ$ W[$ FRQWDLQHUVXVSHQGVW[$EDU UXQV
DQH[LVWLQJWUDQVDFWLRQ ZLWKDQ³XQVSHFL¿HGWUDQVDFWLRQ
FRQWH[WWKHFDOOHU¶V FRQWH[W´
WUDQVDFWLRQLVVXVSHQGHG
EDU BBBB
5HJDUGOHVVRIZKHWKHU
BBB
WKHUHLVDQH[LVWLQJ IRR ° IRR BBBB
WUDQVDFWLRQWKHPHWKRG
ZLOOUXQLQDQ³XQVSHFL¿HG QRWUDQVDFWLRQ EDU UXQVZLWKDQ³XQVSHFL¿HG
WUDQVDFWLRQFRQWH[W´ WUDQVDFWLRQFRQWH[W´
V
- `K M X \ Q W
1HYHU
, IRR W[$ °
1HYHUPHDQV³1R3UH
LQWUDQVDFWLRQ$ W[$
([LVWLQJ´,IWKHPHWKRG
LVFDOOHGZLWKDQH[LVWLQJ
WUDQVDFWLRQFRQWH[WWKH
FRQWDLQHUWKURZVDQ EDU BBBB
H[FHSWLRQ,IWKHUHLVQ¶WD IRR BBB ° IRR BBBB
WUDQVDFWLRQWKHPHWKRG
UXQVZLWKDQ³XQVSHFL¿HG QRWUDQVDFWLRQ EDU UXQVZLWKDQ³XQVSHFL¿HG
WUDQVDFWLRQFRQWH[W´ WUDQVDFWLRQFRQWH[W´
\RXDUHKHUH
WUDQVDFWLRQDWWULEXWHV
6KDUSHQ \RXU SHQFLO
.QRZ\RXUDWWULEXWHV
4HE EXAM EXPECTS YOU TO FIGURE OUT WHICH COMBINATION OF ATTRIBUTES CAN OR WILL LEAD
TO A PARTICULAR OUTCOME 9OU MIGHT BE ASKED TO LOOK AT A SEQUENCE OF METHODS WHERE
THE METHODS SHOW WHICH TRANSACTION THEYRE RUNNING IN AND YOU HAVE TO FIGURE OUT
WHICH COMBINATION OF TRANSACTION ATTRIBUTES COULD MAKE THAT SCENARIO POSSIBLE 4HEY
MIGHT BE FORMATTED SOMETHING LIKE THIS
4HE ANSWERS ARE AT THE BOTTOM OF THE NEXT PAGE
0HWKRG5 0HWKRG6
7[EDU 7[EDU
0HWKRG4
7[IRR
0HWKRG7 0HWKRG8 0HWKRG9
7[IRR BBBB BBBB
15%34)/. 7HICH TWO COMBINATIONS OF ATTRIBUTES WOULD MAKE THIS POSSIBLE
2 3UPPORTS 3 2EQUIRED 4 -ANDATORY 5 .OT3UPPORTED 6 .EVER
2 2EQUIRES.EW 3 2EQUIRED 4 2EQUIRED 5 .EVER 6 .OT3UPPORTED
2 2EQUIRES.EW 3 3UPPORTS 4 3UPPORTS 5 .OT3UPPORTED 6 3UPPORTS
2 2EQUIRES 3 -ANDATORY 4 -ANDATORY 5 3UPPORTS 6 .EVER
2 2EQUIRES.EW 3 2EQUIRED 4 2EQUIRED 5 .OT3UPPORTED 6 .OT3UPPORTED
&KDSWHU
(-%WUDQVDFWLRQV
6KDUSHQ \RXU SHQFLO
&OR THE EXAM AND BEAN DEVELOPER LIFE IN GENERAL YOU HAVE TO KNOW SOME 2%!,,9
IMPORTANT RULES ABOUT TRANSACTIONS AND IT WILL BE MUCH EASIER FOR YOU IF YOU TAKE
THE TIME NOW TO FIGURE SOME OF THIS OUT FOR YOURSELF 5NDERSTANDING IS MUCH
BETTER THAN MEMORIZING AND ITS NOT LIKE YOU DONT HAVE ENOUGH TO MEMORIZE AS
IT IS 9OULL FIND ALL OF THESE QUESTIONS ANSWERED OVER THE NEXT FEW PAGES BUT YOU
SHOULD REALLY TRY TO DO THIS FIRST
/F THE SIX TRANSACTION ATTRIBUTES WHICH ONE OR ONES MUST ./4 BE USED BY
A BEAN THAT CALLS GET2OLLBACK/NLY OR SET2OLLBACK/NLY
7HICH TRANSACTION ATTRIBUTE OR ATTRIBUTES MUST ./4 BE USED BY A
MESSAGE
DRIVEN BEAN
(INT REMEMBER A MESSAGE
DRIVEN BEAN DOESNT HAVE A hCLIENTv THE CONTAINER
INVOKES THE ON-ESSAGE METHOD
5NDER WHAT CIRCUMSTANCES DO YOU THINK THE CONTAINER SHOULD AUTOMATICALLY ROLL
BACK A TRANSACTION
)F THE BEAN GETS A RUNTIME EXCEPTION
)F THE BEAN THROWS AN APPLICATION EXCEPTION EG )NSUFlCIENT&UNDS%XCEPTION
/F THE SIX TRANSACTION ATTRIBUTES THREE OF THEM CAN BE DANGEROUS WITH
ONE IN PARTICULAR BEING %842%-%,9 RISKY +EEPING IN MIND THAT THE
"EAN 0ROVIDER IS ./4 THE ONE WHO SPECIlES THE ATTRIBUTES FOR THE BEANS
METHODS WHICH OF THE SIX IS POTENTIALLY THE MOST DANGEROUS
DQVZHUWRWKH$WWULEXWHVVKDUSHQ WKUHHDQGILYH
\RXDUHKHUH
PHWKRGVWKDWPXVWKDYHDQDWWULEXWH
<PM[MIZM\PMUM\PWL[aW]
5=;<UIZS_Q\PIVI\\ZQJ]\M
NWZI+5<JMIV
6HVVLRQEHDQV (-%2EMHFW (-%+RPH
JHW(-%+RPH JHW+RPH+DQGOH
%XVLQHVVPHWKRGVLQWKHFRPSRQHQWLQWHUIDFH JHW+DQGOH UHPRYH 2EMHFWSN
UHPRYH UHPRYH +DQGOHK
121(RIWKHRWKHUPHWKRGVWKHFOLHQWVHHVLQ LV,GHQWLFDO (-%2EMHFWR JHW(-%0HWD'DWD
WKHFRPSRQHQWLQWHUIDFH IURP(-%2EMHFWRU JHU3ULPDU\.H\
(-%/RFDO2EMHFW
121(RIWKHPHWKRGVLQWKHKRPHLQWHUIDFH
LQFOXGLQJWKRVHZULWWHQE\WKH%HDQ3URYLGHUDV $GYLFH $GYLFH+RPH
ZHOODVWKRVHIURP(-%+RPHRU(-%/RFDO+RPH
JHW$GYLFH FUHDWH
s LJQRUH$GYLFH
r e t h e o n ly method
these a e to mark in th e
you hav ent descriptor
deploym
(QWLW\EHDQV (-%2EMHFW (-%+RPH
%XVLQHVVPHWKRGVLQWKHFRPSRQHQWLQWHUIDFH JHW(-%+RPH JHW+RPH+DQGOH
JHW+DQGOH UHPRYH 2EMHFWSN
121(RIWKHRWKHUPHWKRGVWKHFOLHQWVHHVLQ UHPRYH UHPRYH +DQGOHK
LV,GHQWLFDO (-%2EMHFWR JHW(-%0HWD'DWD
WKHFRPSRQHQWLQWHUIDFH IURP(-%2EMHFWRU JHW3ULPDU\.H\
(-%/RFDO2EMHFW H[FHSWUHPRYH
$//RIWKHKRPHLQWHUIDFHPHWKRGVZULWWHQE\WKH
%HDQ3URYLGHUDVZHOODVWKHUHPRYH PHWKRGV
IURP(-%+RPHRU(-%/RFDO+RPH &XVWRPHU &XVWRPHU+RPH
JHW1DPH FUHDWH
h
more methods wit
VHW1DPH ILQG%\3ULPDU\.H\
You have to emwarhek n you use entity beans r, JHW,' JHW&XVWRPHU/LVW
an attribut with session beans..Remembe
than you do remove() are a Big Deal to
create() and ert and delete!).
an entity (ins
A message-driven bean doesnÕt
0HVVDJHGULYHQEHDQV have any client interfaces.
RQ0HVVDJH RQ0HVVDJH
&KDSWHU
(-%WUDQVDFWLRQV
+PPPPZKDWKDSSHQVLI
,XVH´6XSSRUWVµ"+RZZLOO,UHDOO\NQRZ
LIWKHUH·VDWUDQVDFWLRQ"$QGZKDWDERXW
1RW6XSSRUWHG"1HYHU":KDWDERXWHME&UHDWH
DQGHME5HPRYH IRUVHVVLRQEHDQV":KDW
KDSSHQVLI,TXLWP\MREDQGEHFRPHD
VXUÀQJ LQVWUXFWRULQ.DXDL"
¹=V[XMKQNQML<ZIV[IK\QWV+WV\M`\º
4HE TERM hAN UNSPECIl ED TRANSACTION CONTEXTv IS THE %*"
SPECS WAY OF SAYING h9OU HAVE NO CLUE ) THE CONTAINER
CAN DO WHATEVER ) WANT AND YOULL JUST HAVE TO DEALv
9OU MUST KNOW FOR THE EXAM THE METHODS AND
CIRCUMSTANCES THAT MIGHT BE RUNNING IN AN hUNSPECIl ED
TRANSACTION CONTEXTv
$Q\&07PHWKRGPDUNHG1RW6XSSRUWHG1HYHURU6XSSRUWV
1RW6XSSRUWHGDQG1HYHUDUHVXSSRVHGWRPHDQ´QRWUDQVDFWLRQµ
EXWLQUHDOLW\WKHFRQWDLQHUFDQGRZKDWHYHULWZDQWV$QGZLWK
6XSSRUWV\RXQHYHUNQRZDQ\ZD\ ZKLFKLVZK\ZHWKLQNLW·VD
UHDOO\GXPEDWWULEXWHWKDWQRERG\VKRXOGHYHUXVH
&07VHVVLRQEHDQPHWKRGVHME&UHDWH DQ\RIWKHP
HME5HPRYH HME3DVVLYDWH HME$FWLYDWH
7KHFUHDWHDQGUHPRYHPHWKRGVRIDVHVVLRQEHDQDUHQRW
FRQVLGHUHGSDUWRIDFOLHQW·VWUDQVDFWLRQ XQOLNHWKHZD\LWZRUNV
ZLWKHQWLW\EHDQV $QGUHPHPEHUDFWLYDWHDQGSDVVLYDWHZLOO
QHYHUEHFDOOHGLIWKHVHVVLRQEHDQLVLQDWUDQVDFWLRQ
&07PHVVDJHGULYHQEHDQPHWKRGVHME&UHDWH DQG
LQWLV HME5HPRYH
7KHSR
<28'2
1·7.1
2:
5HPHPEHUIRUDPHVVDJHGULYHQEHDQHME&UHDWH DQG
HME5HPRYH DUHFDOOHGE\WKHFRQWDLQHUZKHQLWZDQWVWRDGGRU
W127
LV WK DW\RXPXV UHPRYHEHDQVIURPWKHSRRO7KHUH·VQRFDOOLQJFOLHQWWUDQVDFWLRQ
UH
SRLQWKH HKDYLRUIURPWKH
7KHNH\ H[ DFWE Q¶WN Q RZ EHFDXVHDPHVVDJHGULYHQEHDQGRHVQ·WKDYHDUHDOFOLHQW
Q\ G R
UHO\RQD HFDXVH\RXMXVW DE O\
UE SURE
FRQWDLQH HY H ORS HU\RX¶OO Y H U WK LV 3O IS THERE A TRANSACTION OR NOT 7HY IS IT hUNSPECIl EDv
QG W¶VVOHHS
R
$VDEHD R P HQ LV Q¶W
HDP LVDQG 7HY ISNT IT JUST hDEl NITELY NO TRANSACTIONv
QHYHUORV GWRNQRZZKDW
HH
%XW\RXQ 4HE SPEC LETS THE #ONTAINER DO WHATEVER IT WANTS 4HE
DUD QWH HG
JX SPEC SUGGESTS SEVERAL OPTIONS INCLUDING EVERYTHING FROM
EXECUTING WITHOUT ANY TRANSACTION AT ALL TO MERGING
:HWKLQNEHLQJDVQRZERDUGLQVWUXFWRULVEHWWHU MULTIPLE CALLS TO A RESOURCE MANAGER TOGETHER INTO ONE
WKDQWHDFKLQJVXUILQJ-XVWDVIXQEXWZLWKRXWDOO
TRANSACTION
WKDWQHRSUHQH2UVKDUNV
\RXDUHKHUH
WUDQVDFWLRQQRWHV
*]ZV\PM[MQV
4HESE ARE ALL THINGS YOU MIGHT BE TESTED ON "UT REMEMBER YOU WONT BE
ASKED A SIMPLE TRUE OR FALSE QUESTION LIKE h4HE GET2OLLBACK/NLY METHOD
CAN BE CALLED FROM A METHOD WITH A TRANSACTION ATTRIBUTE OF .OT3UPPORTEDv
)N WHICH CASE THE ANSWER WOULD BE FALSE OF COURSE .O YOURE LIKELY TO SEE
SOMETHING MUCH MORE CLEVER LIKE BEAN CODE PLUS THE BEANS DEPLOYMENT
DESCRIPTOR AND YOU HAVE TO DECIDE IF IT ALL WORKS TOGETHER
JHW5ROOEDFN2QO\
0867EHFDOOHG
0HVVDJHG
ULYHQEHDQ
IURPDEHDQLQD FDQXVHRQ
O\7:2
V
WUDQVDFWLRQ DWWULEXWHV
5HTXLUHV
DQG1RW6X
7KLQNDERXWLW SSRUWHG
WJHW5ROOEDFN2QO\ $PHVVDJH
<RXDOUHDG\NQRZWKD KDYHDFDOOLQ GULYHQEHDQ
O\E\& 07EHDQV JFOLHQW7KH GRHVQ¶W
FDQEHFDOOHGRQ 0HVVDJH P FRQWDLQHUFDO
WWK HPHWK RG H[ LVWV RQO\LQ HWKRGVRLWGR OVWKHRQ
DQGWKD WRXVHWKHRW HV
7LQ8 VHU7UDQVDFWLRQ KHURQHV5HT Q¶WPDNHDQ\VHQVH
(-%&RQWH[WDQG12 XVHOHVVEHFD XLUHV1HZ"7
QVFDQFDOO XVHWKHUHZLOO KDW¶V
5HPHPEHU"%07EHD LQJWUDQVDFWLR QHYHUEHDSU
VDFWLRQEXWWKH\ Q0DQGDWRU\ HH[LVW
JHW6WDWXV RQ8VHU7UDQ XSHYHU\WLP "7KDWZRXOG
FN2 QO\ H E\³EORZX EORZ
FDQ¶WFDOOJHW5ROOED H[FHSWLRQ E S´ZHPHDQ
WKURZDQ
HFDXVH0DQ
3UH([LVWLQJ´ GDWRU\PHDQV
O\ WRZRUNWKH 1HYHU":HO ³5HTXLUHV
%XWIRUJHW5ROOEDFN2Q FDVHDQ\ZD\ OWKDWLVDOZD\
DWUDQ VDFWLRQZKLFK DQG6XSSRUWV VWKH
PHWKRGPXVWEHLQ LVVLOO\WRR<
RXFDQ
5HTXLUHV
5HPHPE
HU RQO\6
H[FHSWLR <67(0
QVFDXVH
DXWRPDWL DQ
FUROOEDF
:H¶OOFRYHU N
WKLVLQGHWD
EXWIRUQRZ LOLQWKH([FH
EHDZDUHW SWLRQVFKDS
KDWDSSOLFD WH
127DXWRP
DWLFDOO\FDX WLRQH[FHSWLR U
H[FHSWLRQLV VHDUROOEDFN QVGR
DQ $QDSSOLFD
RQDEHDQLQ \FKHFNHGH[FHSWLRQW WLRQ
WHUIDFHXQOH KDWLVGHFOD
5HPRWH([F VVLW¶VD5H UHG
HSWLRQLVLQ PRWH([FHS
DVSHFLDOF WLRQ
DWHJRU\
/HW¶VVD\\R
XVHHVRPH
VKRZVWKHE FRGHRQWK
HDQWKURZLQ HH[DPWKD
VD\D)LQG JDQDSSOLF W
HU([FHSWLRQ DWLRQH[FHS
DFWLRQZLOOE 'R127V WLRQ
HUROOHGEDFN D\WKDWWKHW
GHFLGHLQ\ ,I<28 % UDQV
RXUORJLFWK HDQ3URYLG
DOORZWKHWUD D WWKHVLWXDWLR HU
QVDFWLRQWR QLVWRREOH
VHW5ROOEDFN FRQWLQXHWK DNWR
2QO\ 7KH HQ<28PX
UROOEDFN21 FRQWDLQHUG VWFDOO
/<IRUV\VWH RHVDQDXWR
FHSWLRQRUD PH[FHSWLR PDWLF
Q\RWKHUUX QV OLNH(-%
QWLPHH[FH ([
SWLRQ
&KDSWHU
(-%WUDQVDFWLRQV
(We caught a BMT bean and a
CMT bean arguing at the bar.)
%07 AW][]KS %07 AW]ZMITTaPI^M\WI[S\PI\73TM\UMJZMISQ\LW_V
[W\PI\M^MVaW]KIV]VLMZ[\IVL"\ZIV[IK\QWV[P]Z\KWVK]ZZMVKa
&07 7P\PI\¼[[WKTM^MZ?PI\I_Ia_Q\P_WZL[)VL_PI\LW
<PI\UMIV[\PMaP]Z\XMZNWZUIVKMIVL[KITIJQTQ\a)VL\PI\
aW]UMIVJa\PI\')VLQ[Q\R][\UMXMZ[WVITTaWZITT+5<JMIV[
UMIV[¸
QVOMVMZIT'
&07 CQV\MZZ]X\QVOEAMIPaMIP1SVW_ITT\PI\*]\_Q\PW]\
%07 )TTWN aW]?MMVQM[AW]¼ZMVW\JMIVMVW]OP\WPIVLTM
\ZIV[IK\QWV[aW]KIV¼\M^MVZ]VaW]ZJ][QVM[[
aW]ZW_V\ZIV[IK\QWV[[WaW]TMI^MQ\ITT]X\W\PMKWV\IQVMZ
AW]¼ZMXZWJIJTaINZIQLWN \PMOIZJIOMKWTTMK\WZ\WW %07 ,]P1¼UVW\\ITSQVOIJW]\VW\][QVO\ZIV[IK\QWV[1¼U
\ITSQVOIJW]\SMMXQVO\PMUI[[PWZ\I[XW[[QJTM1\¼[R][\TQSM\PMLQN
&07 ?MMVQM',WV¼\\MTTUMaW]IK\]ITTaJMTQM^M\PI\aW]¼ZMUIV
NMZMVKMJM\_MMV[aVKPZWVQbQVOIVMV\QZMUM\PWL^MZ[][UISQVOI
IOQVOaW]ZW_V\ZIV[IK\QWV['<PMKWV\IQVMZQ[IT_Ia[QVKPIZOM
[aVKPZWVQbMLJTWKS
UaNZQMVL;IUMNWZaW]I[Q\Q[NWZUM
&07 1¼UVW\[]ZM\PI\ZMITTaUI\\MZ[J]\736W_IQ\QN
%07 <PI\¼[VW\\Z]M 1[\IZ\\PM\ZIV[IK\QWVIVL1LMKQLM
aW]ZUM\PWL[IZM\PI\JQOaW]XZWJIJTaPI^MIJIL77LM[QOV
QN¸IVL_PMV¸\WKWUUQ\WZZWTTJIKS?PMZM¼[\PMKWV\IQVMZQV
IVa_Ia;WQN \PI\¼[\PMWVTaJMVMÅ\\W*5<
ITT\PI\'1UMIV[]ZM\PMKWV\IQVMZPI[\WOQ^MUM\PM\ZIV[IK\QWV
J]\IN\MZ\PI\1¼UQVKPIZOM %07 1\¼[VW\1KIVLW\PQVO[aW]KIV¼\M^MZLW
&07 6WaW]¼ZMVW\ &07 .WZM`IUXTM'
%07 AM[1IU %07 4QSMWXMVI\ZIV[IK\QWVQVWVM[\I\MN]TJMIVUM\PWLIVL
KTW[M\PM\ZIV[IK\QWVQV[WUMW\PMZUM\PWLWN \PI\JMIV
&07 )TTaW]¼ZMLWQVOQ[LMUIZKI\QVO\PMJW]VLIZQM[WN \PM
\ZIV[IK\QWVAW]OM\\W[Ia_PMZMQ\[\IZ\[IVL[\WX[-VLWN [\WZa &07 7PaMIPTQSM\PI\¼[VW\OWVVISQTTaW]ZXMZNWZUIVKM'
,WV¼\aW]SVW_PW_U]KP\PI\P]Z\[aW]Z[KITIJQTQ\a'<PI\
%07 =PaW]¼ZMNWZOM\\QVO\PI\1PI^M\PMXW_MZ\WZWTTJIKS
XZM^MV\[aW]Z[\I\MN]TJMIV[NZWUJMQVOXI[[Q^I\ML AW]ZQ[S
&07 ;WLW1 R][\TMI^QVO\PM\ZIV[IK\QWVWXMVTQSMNWZM^MZ)VLPW_IZMaW]
OWVVIM^MVO]IZIV\MM\PI\\PMUM\PWL\PI\[\IZ\[\PM\ZIV[IK\QWV
%07 6WaW]LWV¼\
_QTTJMKITTMLJMNWZM\PMUM\PWL\PI\MVL[Q\'/MMbaW]KW]TLKITT
&07 AM[1LW?PI\LWaW]\PQVS[M\:WTTJIKS7VTaQ[NWZ' KWUUQ\WZZWTTJIKSJMNWZMaW]M^MZ[IQLJMOQV
%07 AW]KIV¼\KITT\PI\<PI\¼[QV\PM=[MZ<ZIV[IK\QWVQV\MZ %07 AMIPJ]\QN [WUMWVMVMML[\WLW\PI\*5<Q[\PMWVTa
NIKMIVL\PI\¼[WNNTQUQ\[\WaW]+5<XMI[IV\[ _Ia\WLWQ\
&07 1KIV¼\JMTQM^M\PMaTM\aW]JMIJMIVAW]SVW_\PI\-2* &07 -`KMX\ITUW[\VWJWLaM^MZVMML[\WLW\PI\ 7Z[PW]TL
+WV\M`\PI[I[M\:WTTJIKS7VTaUM\PWLR][\NWZ+5<JMIV[ 73aM[1¼TTIOZMM\PI\QN QV\PM]VJMTQM^IJTaIVLQVKZMLQJTa]V
%07 7P1NWZOW\IJW]\\PI\*]\[W_PI\'AW][\QTTIZMV¼\QV TQSMTaM^MV\\PI\ILM^MTWXMZVMML[\WLW\PI\aW]¼ZM\PMWVTa_Ia
KWV\ZWTWN aW]Z\ZIV[IK\QWVJW]VLIZQM[ *]\\PMZM¼[VWW\PMZZMI[WV1KIV[MM\W][M*5<M[XMKQITTa[QVKM
*5<LMNMI\[\PM_PWTMZM][IJTMKWUXWVMV\\PQVO0W_IZZWOIV\
&07 *]\_PI\LWM[\PI\UI\\MZ'5aUM\PWL[IZMITTUIZSML KIVaW]JM'AW]KIVVM^MZZ]VQVIVaJWLaMT[M¼[\ZIV[IK\QWV[
_Q\PPW_1_IV\\ZIV[IK\QWV[\WJMIXXTQML[WPW_Q[\PI\LQNNMZ 7VTaaW]ZW_V<ITSIJW]\¹LWM[V¼\XTIa_MTT_Q\PW\PMZ[º
MV\NZWUKWV\ZWTTQVO\PMJW]VLIZQM[WN I\ZIV[IK\QWV'
%07 ?MTT73UIaJM1ZMITTaIUR][\NWZ[XMKQITWKKI[QWV[
%07 0-447 AW]Z\ZIV[IK\QWV[U][\JMI\TMI[\I[TWVOI[I J]\VM`\\QUM_M¼TTPI^M\W\ITSIJW]\XZM^MV\QVOXWQ[WVUM[[IOM
_PWTMUM\PWL 1KIV[KWXMUa\ZIV[IK\QWV[\W[WUM\PQVOUWZM LZQ^MVJMIVUM[[IOM[1¼U\PMWVTaWVM_PWKIVLW\PI\
OZIV]TIZ\PIV\PM_PWTMLIZVUM\PWL
&07 AMIP_MTT_M¼TTR][\PI^M\W[MMIJW]\\PI\_PMV_MOM\
&07 *]\_Pa_W]TLaW]M^MZ_IV\\W' \W\PM5,*KPIX\MZ1¼UW]\\IPMZM
\RXDUHKHUH
WUDQVDFWLRQVLQWKHGHSOR\PHQWGHVFULSWRU
5IZSQVO\ZIV[IK\QWV[QV\PM,,
!LL BEANS MUST SAY WHETHER THEYRE USING BEAN
OR CONTAINER
MANAGED
TRANSACTIONS &OR "-4 BEANS THATS IT FOR THE $$
"UT FOR #-4 BEANS THATS JUST THE BEGINNING
6XUH,·OOPDQDJH
\RXUWUDQVDFWLRQVEXW
\RXKDYHWRWHOOPH+2:6LQFH
+H\FRQWDLQHU,ZDQW\RXWR \RXVDLG´FRQWDLQHUµLQWKH''IRU
WDNHFDUHRIHYHU\WKLQJVR,·OOVD\ WUDQVDFWLRQW\SH,QHHGWRNQRZWKH
WUDQVDFWLRQW\SH!&RQWDLQHU WUDQVDFWLRQDWWULEXWHVIRU\RXU
WUDQVDFWLRQW\SH!LQWKH'' PHWKRGV
7UDQVDFWLRQUHODWHG''LQIROLYHVLQWZRSODFHV
)RUERWK&07DQG%07EHDQV
4HE TRANSACTION
TYPE ELEMENT IN THE ENTERPRISE
BEANS SECTION
HQWHUSULVHEHDQV!
VHVVLRQ!
WUDQVDFWLRQW\SH!&RQWDLQHU WUDQVDFWLRQW\SH!
VHVVLRQ!
HQWHUSULVHEHDQV!
the type is Bean
for BMT,
)RU&07EHDQVRQO\
4HE CONTAINER
TRANSACTION ELEMENT IN THE ASSEMBLY
DESCRIPTOR SECTION
DVVHPEO\GHVFULSWRU!
,FRXOGPDQDJHP\RZQ FRQWDLQHUWUDQVDFWLRQ!
WUDQVDFWLRQVLI,ZDQWHGWR1RUHDOO\ PHWKRG!
,MXVWGRQ·WZDQWWR%XWWKDWGRHV127
PDNHPHDZHHQLH
HMEQDPH!0\%HDQ HMEQDPH!
PHWKRGQDPH!EDU PHWKRGQDPH!
PHWKRG!
WUDQVDWWULEXWH!5HTXLUHG WUDQVDWWULEXWH!
FRQWDLQHUWUDQVDFWLRQ!
DVVHPEO\GHVFULSWRU!
&KDSWHU
(-%WUDQVDFWLRQV
,,M`IUXTMNWZ+5<
,QWKH HQWHUSULVHEHDQV!HOHPHQW
HQWHUSULVHEHDQV!
VHVVLRQ!
GLVSOD\QDPH!$GYLFH%HDQ GLVSOD\QDPH!
HMEQDPH!$GYLFH%HDQ HMEQDPH!
KRPH!KHDG¿UVW$GYLFH+RPH KRPH!
UHPRWH!KHDG¿UVW$GYLFH UHPRWH!
HMEFODVV!KHDG¿UVW$GYLFH%HDQ HMEFODVV!
T y o u Õd sa y (surpriser!)Ó
VHVVLRQW\SH!6WDWHOHVV VHVVLRQW\SH! for BM ead of ÒContaine
WUDQVDFWLRQW\SH!&RQWDLQHU WUDQVDFWLRQW\SH!
VHFXULW\LGHQWLW\!
ÒBeanÓ inst
XVHFDOOHULGHQWLW\! XVHFDOOHULGHQWLW\!
VHFXULW\LGHQWLW\!
VHVVLRQ!
HQWHUSULVHEHDQV!
,QWKH DVVHPEO\GHVFULSWRU!HOHPHQW
DVVHPEO\GHVFULSWRU!
FRQWDLQHUWUDQVDFWLRQ!
PHWKRG! there are a few va
HMEQDPH!0\2WKHU%HDQ HMEQDPH! <method> elemen riations of the
PHWKRGQDPH!IRR PHWKRGQDPH! t (w
on the next page) eÕll look at them
PHWKRG!
WUDQVDWWULEXWH!5HTXLUHV1HZ WUDQVDWWULEXWH!
FRQWDLQHUWUDQVDFWLRQ!
DVVHPEO\GHVFULSWRU!
9OU SPECIFY ATTRIBUTES BY LISTING A SPECIlC ATTRIBUTE 2EQUIRES.EW
3UPPORTS ETC AND PUTTING IN ALL OF THE METHODS THAT ARE SUPPOSED
TO HAVE THAT ATTRIBUTE 9OU MIGHT THINK YOURE SUPPOSED TO lRST
SPECIFY A METHOD AND THEN GIVE THE ATTRIBUTE FOR THAT METHOD
BECAUSE THATS HOW IT LOOKS IN THIS EXAMPLE BUT THATS NOT HOW IT
WORKS )TLL ALL MAKE SENSE ON THE NEXT PAGE
\RXDUHKHUH
WUDQVDFWLRQVLQWKHGHSOR\PHQWGHVFULSWRU
5WZM,,M`IUXTM[NWZ+5<
2SWLRQ :LOGFDUG
5SE A WILDCARD TO SAY THAT ALL METHODS IN THE SPECIlED BEAN HAVE THE e
ATTRIBUTE IN THE TRANS
ATTRIBUTE TAG in g t h e bean nama
yg iv e us e
e c if y a method bame. But here, wmethods
FRQWDLQHUWUDQVDFWLRQ! S p method n s ÒALL
PHWKRG!
and thed (*) which meanesNew attribute.Ó
HMEQDPH!%LJ%HDQ HMEQDPH!
wildcar ean have Requir
of BigB
PHWKRGQDPH!
PHWKRGQDPH!
PHWKRG!
WUDQVDWWULEXWH!5HTXLUHV1HZ WUDQVDWWULEXWH!
FRQWDLQHUWUDQVDFWLRQ!
2SWLRQ ,QGLYLGXDOO\QDPHGPHWKRGV
3PECIFY EACH METHOD OF EACH #-4 BEAN IN THE EJB
JAR UNLESS YOU USE
THE WILDCARD TO INDICATE ALL METHODS OF THE SPECIlED BEAN CLASS HAVE THE
SPECIlED ATTRIBUTE
FRQWDLQHUWUDQVDFWLRQ!
PHWKRG!
Here we have three differ
two different beans, that ent methods, in
HMEQDPH!%LJ%HDQ HMEQDPH!
PHWKRGQDPH!IRR PHWKRGQDPH!
RequiresNew attribute. all hav e the
PHWKRG!
PHWKRG!
HMEQDPH!7LQ\%HDQ HMEQDPH!
PHWKRGQDPH!JR PHWKRGQDPH!
PHWKRG!
PHWKRG!
HMEQDPH!0\%HDQ HMEQDPH!
PHWKRGQDPH!EDU PHWKRGQDPH!
PHWKRG!
e
WUDQVDWWULEXWH!5HTXLUHV1HZ WUDQVDWWULEXWH!
r a n s a c t io n attributhod
FRQWDLQHUWUDQVDFWLRQ!
ifferent t the met
FRQWDLQHUWUDQVDFWLRQ! This is a des -- so here we listhat weÕre
PHWKRG! -- Requirs Requires. Notice tsed in the
HMEQDPH!%LJ%HDQ HMEQDPH! that use he same bean we u tion> element.
PHWKRGQDPH!GR6WXII PHWKRGQDPH!
naming t container-transac
PHWKRG!
WUDQVDWWULEXWH!5HTXLUHG WUDQVDWWULEXWH! previous <
FRQWDLQHUWUDQVDFWLRQ!
&KDSWHU
(-%WUDQVDFWLRQV
:DLWDPLQXWHDUH\RX
WHOOLQJPH,FDQ·WKDYHRYHUORDGHG
PHWKRGV",GRQ·WVHHDQ\DUJXPHQW
OLVWVLQWKHUH,IDOO,JHWWRSXW
LQLVWKHPHWKRGQDPH,·P
VFUHZHG
$ONT WORRY
#HANCES ARE YOUR DESIGN WILL TREAT ALL VERSIONS OF AN
OVERLOADED METHOD IN THE SAME WAY FOR TRANSACTIONS
)N THE EXAMPLES WEVE SEEN SO FAR A METHOD NAME
REPRESENTS ALL OVERLOADED VERSIONS OF THAT METHOD
"UT JUST IN CASE YOU DO NEED TO DISTINGUISH BETWEEN
DIFFERENT OVERLOADED METHODS THERE IS A WAY TO SPECIFY
THE ARGUMENTS 4HE OPTIONAL METHOD
PARAMS TAG LOOKS
LIKE THIS
FRQWDLQHUWUDQVDFWLRQ!
PHWKRG!
HMEQDPH!6KRSSLQJ%HDQ HMEQDPH!
PHWKRGQDPH!DGG,WHP PHWKRGQDPH!
PHWKRGSDUDPV!
PHWKRGSDUDP!MDYDODQJ6WULQJ PHWKRGSDUDP!
PHWKRGSDUDP!LQW PHWKRGSDUDP!
PHWKRGSDUDPV!
d m e t h o d , PHWKRG!
e a n o ve r lo ade s
Here we hawvhere one version takte her FRQWDLQHUWUDQVDFWLRQ!
WUDQVDWWULEXWH!5HTXLUHV1HZ WUDQVDWWULEXWH!
addItem, nd an int, and the o e FRQWDLQHUWUDQVDFWLRQ!
a String a an int. The Þrst on nd PHWKRG!
takes onlyiresNew and the seco ve to HMEQDPH!6KRSSLQJ%HDQ HMEQDPH!
uses Requ s Required. So we hasion PHWKRGQDPH!DGG,WHP PHWKRGQDPH!
version useHICH overloaded ver tion. PHWKRGSDUDPV!
specify W ing about in each sec and PHWKRGSDUDP!LQW PHWKRGSDUDP!
weÕre talk nal <method-params> a PHWKRGSDUDPV!
The optio param> tags give you WUDQVDWWULEXWH!5HTXLUHV WUDQVDWWULEXWH!
PHWKRG!
d -
<metho that.
o FRQWDLQHUWUDQVDFWLRQ!
way to d
\RXDUHKHUH
WUDQVDFWLRQDWWULEXWHVLQWKH''
7UDQVDFWLRQDWWULEXWHVDUH
SDUWRIDSSOLFDWLRQDVVHPEO\
<HV\RX'2
127EHDQGHYHORSPHQW
QHHGWRNQRZ
WKHWDJVIRU 7KDWPHDQVWKHDWWULEXWHVDUH
WUDQVDFWLRQV
PRUL]H
VSHFLILHGLQWKHDVVHPEO\SDUW
<RX¶UHQRWH[SHFWHGWRPH
HYHU\W DJLQW KH ZK ROH '' EX W\RX
LI\
RIWKH''UDWKHUWKDQLQWKH
ZW RV SHF
'2QHHGWRNQRZKR
WUDQVDFWLRQDWW ULEX WHV LQFOX GLQ J EHDQSDUW
LOGFDUG
WKHZD\\RXFDQXVHWKHZ
HP HWK RGVRI
WRUHSUHVHQWDOOWK 7KHRQO\WKLQJ\RXVD\DERXW
GWK DWWKHU H,6 DZ D\WR
DEHDQDQ
PH WKR GV GLIIHUHQW
JLYHR YHU ORD GHG
WUDQVDFWLRQVLQWKHEHDQSDUW
WUDQVDFWLRQDWWULEXWHV
QVDFWLRQ LVZKHWKHUWKHEHDQLVXVLQJ
%HVXUH\RXNQRZWKDWWUD
L¿HG LQ
DWWULEXWHVDUH12
USULVH
7V
EHD
SHF
QV! SD UWR IWKH &RQWDLQHURU%HDQPDQDJHG
WKH HQWH
PE O\
''EXWUDWKHULQWKH D
FWLR Q7 KLQ
VVH
ND ERX W WUDQVDFWLRQV
GHVFULSWRU!VH
DWP DNH VV HQV HD% HDQ
ZK\WK
''
3URYLGHUKDVWRVD\ LQWKH
ZKHWKHUWKHEHD QLV XV
7KH
LQJ %0
DS S
7 Q: #AN ) COMBINE THE WILDCARD WITH SPECIl C METHOD NAMES )
RU&07 EX WWK DW¶VLW MEAN WHAT HAPPENS IF ) WANT TO HAVE ALL THE BEANS METHODS EXCEPT
JODWHUDQG
DVVHPEOHUZLOOFRPHDORQ ONE USE 2EQUIRES.EW AND JUST ONE METHOD TO USE .OT3UPPORTED
O\K RZ WUD QVD FWLRQV
GHFLGHH[DFW
WKLV SD UWLFXODU
VKRXOG EH KD QGO
GHSOR\PHQWRIWKHE
HG IRU
HDQ A: .O PROBLEM 5SING THE WILDCARD IS LIKE SAYING h!LL METHODS NOT
OTHERWISE SPECIFIED IN THE $$ SHOULD USE THIS ATTRIBUTEv 3O GO AHEAD
AND USE THE WILDCARD FOR THE 2EQUIRES.EW PART OF THE $$ AND WHEN
YOU GET TO THE .OT3UPPORTED ATTRIBUTE GIVE THE METHOD NAME
FRQWDLQHUWUDQVDFWLRQ!
PHWKRG!
HMEQDPH!%LJ%HDQ HMEQDPH!
PHWKRGQDPH!
PHWKRGQDPH!
PHWKRG!
WUDQVDWWULEXWH!5HTXLUHV1HZ WUDQVDWWULEXWH!
FRQWDLQHUWUDQVDFWLRQ!
FRQWDLQHUWUDQVDFWLRQ!
PHWKRG!
HMEQDPH!%LJ%HDQ HMEQDPH!
PHWKRGQDPH!XVH2OG'DWDEDVH PHWKRGQDPH!
PHWKRG!
WUDQVDWWULEXWH!1RW6XSSRUWHG WUDQVDWWULEXWH!
FRQWDLQHUWUDQVDFWLRQ!
&KDSWHU
(-%WUDQVDFWLRQV
6KDUSHQ \RXU SHQFLO
:KLFKPHWKRGVQHHGWUDQVDFWLRQDWWULEXWHV"
7KLVRQHLVDFRPELQDWLRQRIKRZPXFK\RXUHPHPEHUDQGKRZPXFK\RXFDQ
WKLQNWKURXJKZKDWPDNHVVHQVH/RRNLQJDWWKHLQWHUIDFHVEHORZRQHIRUD
VHVVLRQEHDQDQGRQHIRUDQHQWLW\EHDQILJXUHRXWZKLFKPHWKRGV0867KDYH
WUDQVDFWLRQDWWULEXWHVZKHQWKHEHDQLVXVLQJ&073XWDFKHFNPDUNE\LWFLUFOHLW
UXQ\RXUKLJKOLJKWHUWKURXJKLW%XWGRQ·WWU\WRVLPSO\UHPHPEHUZKDW\RX·YHVHHQ
LQWKLVFKDSWHUUHDOO\WKLQNDERXWLW
(-%2EMHFW (-%+RPH
JHW(-%+RPH JHW+RPH+DQGOH
JHW+DQGOH UHPRYH 2EMHFWSN
ch
UHPRYH UHPRYH +DQGOHK HereÕs a suggestion--foreseea
6HVVLRQEHDQ LV,GHQWLFDO (-%2EMHFWR JHW(-%0HWD'DWD method, ask yourself th
JHW3ULPDU\.H\ questions:
thod
* Is there a reason thistiome n? Is
MUST be in a tr an sac
g th at mi gh t be
$GYLFH $GYLFH+RPH it doing anythin an sac tio n?
JHW$GYLFH FUHDWH risky if itÕs no t in a tr
LJQRUH$GYLFH
* Is there any reason thinis a
method should NOT be
transaction?
the
* Is there any reason thratthis
transaction behavior foletely up
(-%2EMHFW (-%+RPH
JHW(-%+RPH JHW+RPH+DQGOH
method should be comp use it
JHW+DQGOH UHPRYH 2EMHFWSN
to the Container... becawhat the
(QWLW\EHDQ has no connection with
UHPRYH UHPRYH +DQGOHK
clientÕs trying to do?
LV,GHQWLFDO (-%2EMHFWR JHW(-%0HWD'DWD
JHW3ULPDU\.H\
&XVWRPHU &XVWRPHU+RPH
JHW1DPH FUHDWH
VHW1DPH ILQG%\3ULPDU\.H\
JHW,' JHW&XVWRPHU/LVW
\RXDUHKHUH
;]UUIZaWN*MIVUIVIOMLLMUIZKI\QWV
%HDQPDQDJHG %07
8VHGE\VWDWHOHVVDQGVWDWHIXOVHVVLRQEHDQV 7KH8VHU7UDQVDFWLRQLQWHUIDFHGRHV127KDYH
DJHW5ROOEDFN2QO\ PHWKRGEXW%07EHDQV
8VHGE\PHVVDJHGULYHQEHDQV FDQFDOOJHW6WDWXV WRILQGRXWLIVRPHRQHLQWKH
0XVW127EHXVHGE\HQWLW\EHDQV WUDQVDFWLRQKDVFDOOHGVHW5ROOEDFN2QO\
&DQEHXVHGWRUHGXFHWKHVFRSHRIDWUDQVDFWLRQ 7KHJHW6WDWXV PHWKRGUHWXUQVDQLQWUHSUHVHQWLQJ
ZKLFKFDQKHOSSHUIRUPDQFH DFRQVWDQWRQHRIZKLFKLV67$786B0$5.('B
52//%$&.
&DQEHXVHGWRNHHSDWUDQVDFWLRQRSHQDFURVV
PXOWLSOHLQYRFDWLRQVWRDVWDWHIXOPHWKRGEHDQ 6HVVLRQEHDQVXVLQJ%07PXVWQRWLPSOHPHQW
6HVVLRQ6\QFKURQL]DWLRQ
&DQEHXVHGE\DPHVVDJHGULYHQEHDQWR
DFNQRZOHGJHDPHWKRGHYHQWKRXJKWKHWUDQVDFWLRQ
HQGVLQDUROOEDFN
0HVVDJHGULYHQEHDQVPXVWFRPSOHWHDWUDQVDFWLRQ
E\WKHHQGRIRQ0HVVDJH
6WDWHOHVVVHVVLRQEHDQVPXVWFRPSOHWHD
WUDQVDFWLRQE\WKHHQGRIWKHEXVLQHVVPHWKRGLQ
ZKLFKWKHWUDQVDFWLRQZDVVWDUWHG
7KH%07EHDQPXVWQRWVWDUWDWUDQVDFWLRQZLWKRXW #-4 BEANS RU
N
ILUVWHQGLQJWKHSUHYLRXVWUDQVDFWLRQ 5HPHPEHU TRANSACTIONS
UNKNOWN
QRQHVWHGWUDQVDFWLRQVLQ(-% WHILE "-4 BE
ANS
7KH%07EHDQPXVWQRWXVHWKHJHW5ROOEDFN2QO\ USE ONLY THEI
R OWN
DQGVHW5ROOEDFN2QO\ PHWKRGVRI(-%&RQWH[W
/+ NOT OUR B
7KH%07EHDQFDQFDOOWKHVHW5ROOEDFN2QO\ EST WORK WE KN
DONT YOU TR Y OW 3O WHY
IT -EMOR Y DE
PHWKRGRQWKH8VHU7UDQVDFWLRQ HELP BUT THEY VICES CAN
WORK MUCH BE
YOU CREATE TH TTER WHEN
7KHEHDQJHWVD8VHU7UDQVDFWLRQIURPWKHEHDQ·V EM YOURSELF
(-%&RQWH[W
3URSDJDWLRQRIWUDQVDFWLRQVLQD%07EHDQDUH
RQHZD\ DEHDQVWDUWHGWUDQVDFWLRQFDQSURSDJDWH
RXWWRRWKHUEHDQVEXWQRWUDQVDFWLRQFDQHYHUEH
SURSDJDWHGLQWRDEHDQXVLQJ%07
&KDSWHU
(-%WUDQVDFWLRQV
&RQWDLQHUPDQDJHG &07
8VHGE\DOOEHDQW\SHV $&07EHDQWKDWFDOOVVHW5ROOEDFN2QO\ RU
JHW5ROOEDFN2QO\ 0867KDYHDQDWWULEXWHRI
&RPSXOVRU\IRUHQWLW\EHDQV 5HTXLUHG5HTXLUHV1HZRU0DQGDWRU\
7UDQVDFWLRQDWWULEXWHVDUHVSHFLILHGLQWKH $&07VHVVLRQEHDQPXVWVSHFLI\DWWULEXWHVIRU
GHSOR\PHQWGHVFULSWRU
DOOEXVLQHVVPHWKRGVLQWKHFRPSRQHQWLQWHUIDFH
7KHVL[WUDQVDFWLRQDWWULEXWHVDUH 5HTXLUHG QRQHRIWKHPHWKRGVLQWKHKRPHDQGQRQHRIWKH
5HTXLUHV1HZ6XSSRUWV0DQGDWRU\1HYHU1RW PHWKRGVIURP(-%2EMHFW RU(-%/RFDO2EMHFW
6XSSRUWHG
$OOHQWLW\EHDQVPXVWVSHFLI\DWWULEXWHVIRU DOO
7UDQVDFWLRQVFDQEHSURSDJDWHGLQWRDQGRXWRID EXVLQHVVPHWKRGVLQWKHFRPSRQHQWLQWHUIDFH
&07EHDQ DOOWKHPHWKRGVGHFODUHGE\WKH%HDQ3URYLGHULQ
WKHKRPHLQWHUIDFHDQGDQ\UHPRYH PHWKRG
7KH&07EHDQPXVWQRWDWWHPSWWRXVH%07 WKDWWKHFOLHQWFDQDFFHVV LHWKHRQHVGHILQHG
LQFOXGLQJJHWWLQJD8VHU7UDQVDFWLRQUHIHUHQFH LQ(-%+RPH(-%/RFDO+RPHRU(-%2EMHFWDQG
7KH&07EHDQPXVWQRWXVHWKHVHW5ROOEDFN2QO\ (-%/RFDO2EMHFW
PHWKRGRI8VHU7UDQVDFWLRQ *XHVV\RXFRXOG <RXSUREDEO\GRQRWZDQWWRXVH6XSSRUWVEHFDXVH
ILJXUHWKDWRXWIURPWKHSUHYLRXVEXOOHWSRLQW \RXFDQ·WNQRZIRUFHUWDLQZKHWKHU\RXUEHDQLV
7KH&07EHDQFDQXVHWKHJHW5ROOEDFN2QO\DQG JRLQJWRUXQLQDWUDQVDFWLRQ,I\RX·YHZULWWHQFDOOV
VHW5ROOEDFN2QO\PHWKRGVRI(-%&RQWH[W WRJHW5ROOEDFN2QO\ RUVHW5ROOEDFN2QO\ WKHEHDQ
FDQJHWDQH[FHSWLRQ
&07WUDQVDFWLRQVFDQQRWVWD\RSHQDFURVVPXOWLSOH
PHWKRGLQYRFDWLRQVIURPDVWDWHIXOVHVVLRQFOLHQW $PHVVDJHGULYHQEHDQFDQXVHRQO\WZRDWWULEXWHV
%07WUDQVDFWLRQVFDQ 5HTXLUHGRU1RW6XSSRUWHG
&07WUDQVDFWLRQVDUHVFRSHGDWWKHPHWKRG
OHYHO(LWKHUWKHZKROHPHWKRGUXQVLQDSDUWLFXODU
WUDQVDFWLRQFRQWH[WRULWGRHVQ·W
&DOOLQJVHW5ROOEDFN2QO\RQDQ(-%&RQWH[WPHDQV
WKHFRQWDLQHUPXVW127FRPPLWWKHWUDQVDFWLRQ
\RXDUHKHUH
VHVVLRQV\QFKURQL]DWLRQ
-V\Q\aJMIV[PI^MMRJ4WIL\W[\Ia[aVKPZWVQbML
M^MVQN\PM\ZIV[IK\QWVZWTT[JIKS
LPLW
1 HZ/
VHW
&OLHQWFDOOVPHWKRGVRQ EXPPHU
WKHEHDQWKDWFKDQJHWKH
EHDQ·VLQWHUQDOVWDWH
%HDQKDVDSUREOHPDQGFDQ·WFRP
PLWWKHWUDQVDFWLRQ%XWQRZWKDW
OHDYHVWKHEHDQRXWRIV\QFZLWK
WKHGDWDEDVH7KHEHDQ·VOLPLW
VWDWHLVEXWWKHOLPLWLQWKH
GDWDEDVHLVH[DFWO\ZKHUHLW
&RQWDLQHUVLPSO\GRHVDQHZ
ZDVEHIRUHWKHWUDQVDFWLRQEHJDQ
ORDGRQWKHEHDQWRUHIUHVK
LWZLWKWKHRULJLQDOGDWDIURP
WKHGDWDEDVH
HFW '%
VHO
HM 1RZHYHU\WKLQJLVMXVW
E/
RD OLNHLWZDVEHIRUH$VLI
G QRWKLQJHYHUKDSSHQHG
%HDQLVKDSS\DQGQRZDOORILWV
SHUVLVWHQWVWDWHPDWFKHVWKH
HQWLW\·VGDWDLQWKHGDWDEDVH
&KDSWHU
(-%WUDQVDFWLRQV
;M[[QWV;aVKPZWVQbI\QWV
JMKI][M[M[[QWVJMIV[LWV¼\PI^MMRJ4WILIVLMRJ;\WZM
4HE POINT IS THIS
!N ENTITY BEAN HAS EJB,OAD AND EJB3TORE TO TELL IT WHEN TO
SYNCHRONIZE WITH THE DATABASE )F THE TRANSACTION IS ABOUT TO COMMIT
EJB3TORE IS CALLED TO GIVE THE BEAN ONE LAST CHANCE TO GET ITS
PERSISTENT STATE IN ORDER READY TO BE WRITTEN TO THE DATABASE !ND IF
THE TRANSACTION DOES NOT COMMIT THE BEAN JUST GETS ANOTHER EJB,OAD
TO RETURN IT TO ITS ORIGINAL PRE
TRANSACTION STATE AND EVERYTHING IS l NE
"UT A SESSION BEAN DOESNT HAVE THAT LUXURY .O EJB,OAD OR
EJB3TORE TO TELL IT WHEN ITS TIME TO SYNCHRONIZE ITSELF WITH A DATABASE
"UT IF YOUR SESSION BEAN IMPLEMENTS 3ESSION3YNCHRONIZATION YOU CAN
GIVE A SESSION BEAN THREE NEW CONTAINER CALLBACKS THAT NOTIFY THE BEAN
OF THREE MORE SPECIAL MOMENTS IN THE BEANS TRANSACTIONAL LIFE WHEN A
TRANSACTION STARTS WHEN ITS ABOUT TO END AND WHEN ITS OVER
6HVVLRQ%HDQLQWHUIDFH 6HVVLRQ6\QFKURQL]DWLRQLQWHUIDFH
MDYD[HME6HVVLRQ%HDQ MDYD[HME6HVVLRQ6\QFKURQL]DWLRQ
LQWHUIDFH!! LQWHUIDFH!!
6HVVLRQ%HDQ 6HVVLRQ6\QFKURQL]DWLRQ
VHW6HVVLRQ&RQWH[W 6HVVLRQ&RQWH[WVF DIWHU%HJLQ
HME$FWLYDWH EHIRUH&RPSOHWLRQ
HME3DVVLYDWH DIWHU&RPSOHWLRQ ERROHDQFRPPLWWHG
HME5HPRYH
&DUW%HDQ
VHW6HVVLRQ&RQWH[W 6HVVLRQ&RQWH[WVF
HME$FWLYDWH
A session bean can implement
BOTH the SessionBean and
HME3DVVLYDWH
SessionSynchronization interfaces,
HME5HPRYH for a total of 7 methods to
DIWHU%HJLQ implement.
EHIRUH&RPSOHWLRQ
DIWHU&RPSOHWLRQ ERROHDQFRPPLWWHG
EXVLQHVVDQGFUHDWHPHWKRGV
\RXDUHKHUH
6HVVLRQ6\QFKURQL]DWLRQFDOOEDFNV
;M[[QWV;aVKPZWVQbI\QWV¹[XMKQITUWUMV\[º
025(VSHFLDO
PRPHQWV"
stateful
CMT bean
DIWHU%HJLQ EHIRUH&RPSOHWLRQ DIWHU&RPSOHWLRQ
$WWKHEHJLQQLQJRIDVWDWHIXO -XVWEHIRUHWKHWUDQVDFWLRQ $IWHUWKHWUDQVDFWLRQKDVHQGHG
:KHQLW·VFDOOHG EHDQ·VWUDQVDFWLRQ%()25( HQGV$)7(5WKHEXVLQHVV HLWKHULQDFRPPLWRUUROOEDFN
WKHEXVLQHVVPHWKRGWKDW·V PHWKRGFRPSOHWHV 7KHPHWKRGSDVVHVDERROHDQ
JRLQJWRUXQLQWKHWUDQVDFWLRQ DUJXPHQWWRWHOO\RXZKHWKHU
LVFDOOHG WKHWUDQVDFWLRQFRPPLWWHG
HME/RDG HME6WRUH 1RWKLQJLQWKHHQWLW\EHDQ
:KLFKHQWLW\EHDQ
OLIHF\FOHFRUUHVSRQGVWRWKLV
PHWKRGLW·VPRVWOLNH
%HFDXVHWKHUH·VQRQHHG
/RDGLQGDWDIURPWKHGDWDEDVH /DVWFKDQFHWRXSGDWHWKH )LQGRXWKRZWKHWUDQVDFWLRQ
NQRZLQJWKDWWKHGDWDEDVH GDWDEDVHEHIRUHWKHWUDQVDF ZHQWDQGGRZKDWHYHU\RXKDYH
UHVRXUFHLVQRZSDUWRIWKH WLRQFRPPLWVDQGWKHORFNVRQ WRGRWRVWD\V\QFHGZLWKWKH
WUDQVDFWLRQVR\RXFDQFDFKH WKHGDWDEDVHDUHUHOHDVHG GDWDEDVH)RUH[DPSOHLI\RX
:KDWWRGRZKHQ WKHGDWDLQWKHEHDQIRUWKHUHVW ZHUHFDFKLQJQHZO\FKDQJHG
\RX·UHLQLW RIWKHWUDQVDFWLRQ GDWDLQWHPSRUDU\YDULDEOHV\RX
FDQQRZDVVLJQWKHWHPSRUDU\
YDOXHVWR\RXUSHUPDQHQWVWDWH
YDULDEOHV2ULIWKHWUDQVDFWLRQ
UROOHGEDFN\RXPLJKWKDYHWR
UHVHWVRPHYDOXHVZLWKGDWD
IURPWKHGDWDEDVH
&DOOPHWKRGVRQ\RXU <RX·UHVWLOOLQDWUDQVDFWLRQ &DOOPHWKRGVRQ\RXU
%HDQWKLQJV\RXFDQ
6HVVLRQ&RQWH[W JHW\RXU VR\RXFDQGRWKHVDPHWKLQJV 6HVVLRQ&RQWH[W JHW\RXU
GRZKLOH\RX·UHLQLW
KRPHJHW\RXU(-%REMHFWJHW \RXFDQGRLQDIWHU%HJLQ KRPHJHW\RXU(-%REMHFWJHW
FDOOHUVHFXULW\LQIRIRUFHWKH FDOOHUVHFXULW\LQIR<RXFDQ·WGR
WUDQVDFWLRQWRUROOEDFNFKHFN DQ\WUDQVDFWLRQUHODWHGWKLQJV
WKHUROOEDFNVWDWXV EHFDXVH\RX·UHQRORQJHU
LQDWUDQVDFWLRQ<RXFDQDF
$FFHVV \RXUVSHFLDO-1', FHVV21/<\RXUVSHFLDO-1',
FRQWH[WUHVRXUFHPDQDJHUV FRQWH[W,W·VQRWVDIHWRDFFHVV
DQGRWKHUEHDQV<RX·UHLQD UHVRXUFHPDQDJHUVRURWKHU
WUDQVDFWLRQVRLW·VDOOVDIH EHDQV
&KDSWHU
(-%WUDQVDFWLRQV
6WDWHOHVVVHVVLRQ
EHDQVFDQ·WLPSOHPHQ
W
RQ
6HVVLRQ6\QFKURQL]DWL WKHUH DUH QR
'XPE 4XHVWLRQV
DQVFDQLPSOHPHQW
2QO\VWDWH)8/VHVVLRQEH
6HVVLRQ6\QFKURQL]DWLRQEH
¶WDOORZ
FDXVHVWDWHOHVV
HG WRPDLQWDLQD
Q: )F YOU WANT SYNCHRONIZATION SO
VHVVLRQEHDQ¶VDUHQ BADLY WHY NOT JUST USE AN ENTITY BEAN
FHDP HWK RGKDV HQGHG
WUDQVDFWLRQRQ
A: "ECAUSE YOUR BEAN MIGHT
REPRESENT A PROCESS AND NOT AN ENTITY
.OT EVERYTHING THAT INVOLVES DATABASE
DATA IS AN ENTITY )F YOUR SESSION BEAN
REPRESENTS A PROCESS LIKE A SHOPPING
SESSION BUT IT STILL USES A DATABASE YOU
6HVVLRQ6\QFK
URQL]DWLRQ
MIGHT WANT TO WAIT UNTIL THE TRANSACTION
IS COMPLETE BEFORE UPDATING INFORMATION
LVIRU&07EH IN THE DATABASE
DQV21/<
'RHVLWPDNHVH
QVHIRUD%07EH /N THE OTHER HAND USING A SESSION BEAN
6HVVLRQ6\QFKUR DQWRXVH
QL]DWLRQ"1R5 AS AS A hPOOR
MANS ENTITY BEANv JUST FOR
SRLQWRI6HVVLRQ6 HPHPEHUWKH
\QFKURQL]DWLRQLV THE SAKE OF AVOIDING ENTITY BEANS IS SILLY
EHDQWKUHHPRUH WRJLYHWKH
³VSHFLDOPRPHQ )F YOU NEED AN ENTITY MAKE IT AN ENTITY
PHWKRGVVRWKDW W´FDOOEDFN
WKHEHDQFDQ¿Q BEAN AND GET ALL THE ADVANTAGES THE
DWUDQVDFWLRQVWDU GRXWZKHQ
WVDQGHQGVDQG #ONTAINER HAS TO OFFER LIKE AUTOMATIC
HQGV DOVRKRZLW
SYNCHRONIZATION WITH THE PERSISTENT
%XWWKLQNDERXWLW
D%07EHDQN STORE "UT IF YOUR BEAN IS A PROCESS BUT
(;$&7/<ZKHQ QRZV
DWUDQVDFWLRQVW STILL NEEDS TO STAY ON TOP OF HOW THE
EHFDXVHWKHEH DUWVDQGHQGV
DQLVWKHRQHGH TRANSACTION IS GOING YOUVE GOT THE
WUDQVDFWLRQERXQ PDUFDWLQJWKH
GDULHV OPTION WITH 3ESSION3YNCHRONIZATION AS
,W¶VWKHEHDQWK
DWVD\VZKHQWK LONG AS ITS A STATEFUL #-4 BEAN
VWDUWVDQGHQG HWUDQVDFWLRQ
V
1RERG\FDQHQG
WKDWWUDQVDFWLRQ
EHDQWKDWVWDUWH H[FHSWWKH
GLWVRWKHUHDUHQ
WKHEHDQQHHGV ¶WDQ\VXUSULVHV
WREH³WROG´DER
XW
\RXDUHKHUH
WUDQVDFWLRQVSX]]OH
VOID BMT-ETHOD7ITH4RANSACTIONS [
3RRO3X]]OH ??????????????????
9OUR JOB IS TO TAKE CODE SNIPPETS FROM THE CCMT2EQUIRES.EW
POOL AND PLACE THEM INTO THE BLANK
LINES IN THE CODE 9OU WILL USE EACH ??????????????????
SNIPPET EXACTLY ONCE
??????????????????
9OUR GOAL IS TO MAKE A METHOD IN
A "-4 BEAN THAT WILL CREATE A TOTAL OF
??????????????????
FIVE TRANSACTIONS "UT WAIT THERES MORE
%XACTLY 47)#% DURING THIS METHOD A
??????????????????
TRANSACTION WILL BE TEMPORARILY SUSPENDED
7E WONT TELL YOU WHETHER ITS THE SAME ??????????????????
TRANSACTION SUSPENDED TWICE OR TWO
DIFFERENT TRANSACTIONS !NY METHOD WITH ??????????????????
hCMTv IN ITS NAME IS FROM A #-4 BEAN AND ITS
TRANSACTION ATTRIBUTE IS REVEALED IN ITS NAME ??????????????????
!SSUME THAT THE VARIABLES hCv AND hUTv
HAVE BEEN PROPERLY INITIALIZED AS INSTANCE ??????????????????
VARIABLES
??????????????????
/H YEAH YOU MUST ./4 THROW ANY
TRANSACTION RELATED EXCEPTIONS ??????????????????
!NSWERS ARE ON THE NEXT PAGE SO DONT LOOK ]
UNLESS YOU HAVE ABSOLUTELY NO CONCERN FOR
THE LOSS OF SELF
ESTEEM THAT YOULL EXPERIENCE
BY GOING STRAIGHT FOR THE ANSWERS
.OTE %ACH SNIPPET
FROM THE POOL CAN BE
USED ONLY ONCE
UTBEGIN
CCMT.EVER
UTCOMMIT
CCMT-ANDATORY
CCMT3UPPORTS CCMT-ANDATORY
CCMT2EQUIRES.EW
CCMT2EQUIRED UTBEGIN
UTCOMMIT
CCMT.OT3UPPORTED
&KDSWHU
\RXDUHKHUH
VOID BMT-ETHOD7ITH4RANSACTIONS [
ut.begin();
?????????????????? tx 1
CCMT2EQUIRES.EW tx 2, suspend tx 1
c.cmtMandatory);
?????????????????? tx 1 (tx 2 ended when the previous method completed)
c.cmtRequiresNew();
??????????????????
tx 3, suspend tx 1 (thatÕs the second and Þnal transaction suspension.)
ut.commit(); now thereÕs no tx
??????????????????
c.cmtNotSupported(); still no tx
??????????????????
c.cmtNever();
??????????????????
still no tx
c.cmtRequired(); tx 4
??????????????????
ut.begin();
??????????????????
tx 5 (tx 4 ended when the previous method completed)
c.cmtSupports(); tx 5
??????????????????
c.cmtMandatory()); tx 5
??????????????????
ut.commit(); Done
??????????????????
]
YOUVE COMPLETED THE PUZZLE ON THE PREVIOUS PAGE
7HICH OF COURSE YOU WONT BE LOOKING AT UNTIL
3RRO3X]]OH6ROXWLRQ
(-%WUDQVDFWLRQV
FRIIHHFUDPPRFNH[DP
0RFN([DP
7HICH ARE TRUE ABOUT TRANSACTIONS IN %*" #HOOSE ALL THAT APPLY
1
R! %*" CONTAINERS MUST SUPPORT BOTH *4! AND *43
R" %*" SUPPORTS NESTED TRANSACTIONS
R# 4HE MDYD[WUDQVDFWLRQ8VHU7UDQVDFWLRQ !0) ALLOWS YOU TO SET
ISOLATION LEVELS
R$ ! BEAN INSTANCE CAN RUN MULTIPLE TRANSACTIONS IN PARALLEL
R% ! MESSAGE
DRIVEN BEAN INSTANCE MUST COMPLETE A TRANSACTION BEFORE THE
@ON-ESSAGE METHOD RETURNS
7HEN USING "-4 DEMARCATION WHICH OF THE FOLLOWING MUST COMMIT A
2 TRANSACTION BEFORE THE METHOD THAT INITIATED THE TRANSACTION RETURNS #HOOSE
ALL THAT APPLY
R! MESSAGE
DRIVEN BEANS
R" STATEFUL SESSION BEANS
R# STATELESS SESSION BEANS
R$ NONE OF THE ABOVE
7HICH TWO ARE TRUE ABOUT CONTAINER
MANAGED TRANSACTIONS IN %*"
3 #HOOSE ALL THAT APPLY
R! $IFFERENTIATING BETWEEN OVERLOADED METHODS IS POSSIBLE IN THE BEANS
DEPLOYMENT DESCRIPTOR
R" %VERY BUSINESS METHOD IN THE BEAN CLASS MUST HAVE A TRANSACTION
ATTRIBUTE
R# )F AN ON-ESSAGE METHOD RETURNS BEFORE COMMITTING A TRANSACTION THE
CONTAINER WILL THROW AN EXCEPTION
R$ ! MESSAGE
DRIVEN BEAN WITH #-4 DEMARCATION MUST NOT INVOKE THE
%*"#ONTEXTGET5SER4RANSACTION METHOD
&KDSWHU
(-%WUDQVDFWLRQV
7HATS TRUE WHEN SPECIFYING TRANSACTION ATTRIBUTES IN THE DEPLOYMENT
4 DESCRIPTOR #HOOSE ALL THAT APPLY
R! &OR SESSION BEANS TRANSACTION ATTRIBUTES CAN BE APPLIED ONLY TO
METHODS IN THE BEANS COMPONENT INTERFACE
R" 4HE METHOD
NAME TAG CAN TAKE A WILD CARD
R# ! SINGLE METHOD CAN HAVE MULTIPLE TRANSACTION ATTRIBUTES SPECIlED IN
THE DEPLOYMENT DESCRIPTOR
R$ 4RANSACTION ATTRIBUTES MUST ./4 BE SPECIlED FOR METHODS IN AN ENTITY
BEANS HOME INTERFACE
7HICH TRANSACTION ATTRIBUTES CAN CAUSE AN IN
PROGRESS TRANSACTION TO BE
5 SUSPENDED #HOOSE ALL THAT APPLY
R! .OT3UPPORTED
R" 2EQUIRED
R# 3UPPORTS
R$ 2EQUIRES.EW
R% -ANDATORY
R& .EVER
4HE USE OF WHICH TRANSACTION ATTRIBUTE CAN CAUSE A
6 MDYD[WUDQVDFWLRQ7UDQVDFWLRQ5HTXLUHG([FHSWLRQ EXCEPTION TO BE
THROWN
R! .OT3UPPORTED
R" 2EQUIRED
R# 3UPPORTS
R$ 2EQUIRES.EW
R% -ANDATORY
R& .EVER
\RXDUHKHUH
FRIIHHFUDPPRFNH[DP
)F A SET OF #-4 BEAN METHODS HAS THE FOLLOWING TRANSACTION ATTRIBUTES
7 -ETHOD
3UPPORTS
-ETHOD
2EQUIRED
-ETHOD
.OT3UPPORTED
-ETHOD
2EQUIRES.EW
)N THE DIAGRAMS THAT FOLLOW AN ARROW INDICATES THAT THE METHOD ON THE
LEFT CALLS THE METHOD ON THE RIGHT AND THE hTXv NUMBER INDICATES A UNIQUE
TRANSACTION 7HICH DIAGRAMS WORK WITH THE TRANSACTION ATTRIBUTES LISTED ABOVE
#HOOSE ALL THAT APPLY
R! - 4X
- .O 4X
- .O 4X
- 4X
R" - .O 4X
- 4X
< <
- 4X
<
- 4X
R# - .O 4X
- 4X
- .O 4X
<
- 4X
R$ - 4X
- 4X
- 4X
- 4X
7HICH METHODS OF A SESSION BEAN WITH CONTAINER
MANAGED TRANSACTION
8 DEMARCATION RUN IN AN UNSPECIlED TRANSACTION CONTEXT #HOOSE ALL THAT
APPLY
R! HME$FWLYDWH
R" HME3DVVLYDWH
R# "USINESS METHOD MARKED µ1RW6XSSRUWHG¶
R$ HME5HPRYH
R% "USINESS METHOD MARKED @2EQUIRES.EW
)F A SESSION BEANS BUSINESS METHOD INVOKES
9 (-%&RQWH[WVHW5ROOEDFN2QO\ WHICH TRANSACTION ATTRIBUTE SETTINGS CAN
CAUSE THE CONTAINER TO THROW THE MDYDODQJ,OOHJDO6WDWH([FHSWLRQ
#HOOSE ALL THAT APPLY
R! .OT3UPPORTED
R" 2EQUIRED
R# 3UPPORTS
R$ 2EQUIRES.EW
R% -ANDATORY
R& .EVER
&KDSWHU
(-%WUDQVDFWLRQV
7HICH METHOD CAN BE CALLED SUCCESSFULLY BY A BEAN USING BEAN
MANAGED
10 TRANSACTION DEMARCATION
R! JHW8VHU7UDQVDFWLRQ
R" DIWHU%HJLQ
R# DIWHU&RPSOHWLRQ
R$ JHW5ROOEDFN2QO\
\RXDUHKHUH
PRFNH[DPDQVZHUV
0RFN([DP$QVZHUV
7HICH ARE TRUE ABOUT TRANSACTIONS IN %*" #HOOSE ALL THAT APPLY
(spec: 340-341)
1
R! %*" CONTAINERS MUST SUPPORT BOTH *4! AND *43 - just UserTransaction from JTA
R" %*" SUPPORTS NESTED TRANSACTIONS
R# 4HE MDYD[WUDQVDFWLRQ8VHU7UDQVDFWLRQ !0) ALLOWS YOU TO SET
ISOLATION LEVELS - No
R$ ! BEAN INSTANCE CAN RUN MULTIPLE TRANSACTIONS IN PARALLEL
R% ! MESSAGE
DRIVEN BEAN INSTANCE MUST COMPLETE A TRANSACTION BEFORE THE
@ON-ESSAGE METHOD RETURNS - Yes!
7HEN USING "-4 DEMARCATION WHICH OF THE FOLLOWING MUST COMMIT A (spec: 340-341)
2 TRANSACTION BEFORE THE METHOD THAT INITIATED THE TRANSACTION RETURNS #HOOSE
ALL THAT APPLY
R! MESSAGE
DRIVEN BEANS
R" STATEFUL SESSION BEANS
R# STATELESS SESSION BEANS
R$ NONE OF THE ABOVE
7HICH TWO ARE TRUE ABOUT CONTAINER MANAGED TRANSACTIONS IN %*" (spec: 353-356)
3 #HOOSE ALL THAT APPLY
R! $IFFERENTIATING BETWEEN OVERLOADED METHODS IS POSSIBLE IN THE BEANS
DEPLOYMENT DESCRIPTOR
R" %VERY BUSINESS METHOD IN THE BEAN CLASS MUST HAVE A TRANSACTION
ATTRIBUTE
R# )F AN ON-ESSAGE METHOD RETURNS BEFORE COMMITTING A TRANSACTION THE
CONTAINER WILL THROW AN EXCEPTION - No
R$ ! MESSAGE DRIVEN BEAN WITH #-4 DEMARCATION MUST NOT INVOKE THE
%*"#ONTEXTGET5SER4RANSACTION METHOD
&KDSWHU
(-%WUDQVDFWLRQV
4 7HATS TRUE WHEN SPECIFYING TRANSACTION ATTRIBUTES IN THE DEPLOYMENT (spec: 351-354)
DESCRIPTOR #HOOSE ALL THAT APPLY
R! &OR SESSION BEANS TRANSACTION ATTRIBUTES CAN BE APPLIED ONLY TO
METHODS IN THE BEANS COMPONENT INTERFACE
R" 4HE METHOD NAME TAG CAN TAKE A WILD CARD
R# ! SINGLE METHOD CAN HAVE MULTIPLE TRANSACTION ATTRIBUTES SPECIlED IN
THE DEPLOYMENT DESCRIPTOR
R$ 4RANSACTION ATTRIBUTES MUST ./4 BE SPECIlED FOR METHODS IN AN ENTITY
BEANS HOME INTERFACE - they must be speciÞed
7HICH TRANSACTION ATTRIBUTES CAN CAUSE AN IN PROGRESS TRANSACTION TO BE (spec: 357-359)
5 SUSPENDED #HOOSE ALL THAT APPLY
R! .OT3UPPORTED
R" 2EQUIRED
R# 3UPPORTS
R$ 2EQUIRES.EW
R% -ANDATORY
R& .EVER
6 4HE USE OF WHICH TRANSACTION ATTRIBUTE CAN CAUSE A (spec: 357-359)
MDYD[WUDQVDFWLRQ7UDQVDFWLRQ5HTXLUHG([FHSWLRQ EXCEPTION TO BE
THROWN
R! .OT3UPPORTED
R" 2EQUIRED
R# 3UPPORTS
R$ 2EQUIRES.EW
R% -ANDATORY
R& .EVER
\RXDUHKHUH
PRFNH[DPDQVZHUV
7
)F A SET OF #-4 BEAN METHODS HAS THE FOLLOWING TRANSACTION ATTRIBUTES
(spec: 357-359)
-ETHOD
3UPPORTS
-ETHOD
2EQUIRED
-ETHOD
.OT3UPPORTED
-ETHOD
2EQUIRES.EW
)N THE DIAGRAMS THAT FOLLOW AN ARROW INDICATES THAT THE METHOD ON THE
LEFT CALLS THE METHOD ON THE RIGHT AND THE hTXv NUMBER INDICATES A UNIQUE
TRANSACTION 7HICH DIAGRAMS WORK WITH THE TRANSACTION ATTRIBUTES LISTED ABOVE
#HOOSE ALL THAT APPLY
R! - 4X
- .O 4X
- .O 4X
- 4X
R" - .O 4X
- 4X
< <
- 4X
<
- 4X
R# - .O 4X
- 4X
- .O 4X
<
- 4X
R$ - 4X
- 4X
- 4X
- 4X
376)
7HICH METHODS OF A SESSION BEAN WITH CONTAINER
MANAGED TRANSACTION (spec: 363-364,
8 DEMARCATION RUN IN AN UNSPECIlED TRANSACTION CONTEXT #HOOSE ALL THAT
APPLY
R! HME$FWLYDWH
R" HME3DVVLYDWH
R# "USINESS METHOD MARKED µ1RW6XSSRUWHG¶
R$ HME5HPRYH
R% "USINESS METHOD MARKED @2EQUIRES.EW
)F A SESSION BEANS BUSINESS METHOD INVOKES
9 (-%&RQWH[WVHW5ROOEDFN2QO\ WHICH TRANSACTION ATTRIBUTE SETTINGS CAN (spec: 360-361)
CAUSE THE CONTAINER TO THROW THE MDYDODQJ,OOHJDO6WDWH([FHSWLRQ
#HOOSE ALL THAT APPLY
R! .OT3UPPORTED
R" 2EQUIRED
R# 3UPPORTS
R$ 2EQUIRES.EW
R% -ANDATORY
R& .EVER
&KDSWHU
(-%WUDQVDFWLRQV
7HICH METHOD CAN BE CALLED SUCCESSFULLY BY A BEAN USING BEAN MANAGED (spec: 361)
10 TRANSACTION DEMARCATION
R! JHW8VHU7UDQVDFWLRQ
acks from
R" DIWHU%HJLQ } These areyncachllbronization
R# DIWHU&RPSOHWLRQ } Sessi
onS
R$ JHW5ROOEDFN2QO\ - this is for CMT beans only
\RXDUHKHUH
exceptions in EJB
5
4 :KHQEHDQVJREDG 4
(YHU\WKLQJ ZDVJRLQJ
VRZHOOZHKDGLWDOODQLFH
WUDQVDFWLRQQRQFRUUXSWFRQYHUVDWLRQDO
VWDWHDJUHDWJURXSRIUHIHUHQFHV
DQGWKHQVRPHWKLQJZHQWKRUULEO\ZURQJ
DQGQRZKH·V VQLII!JRQHIRUHYHU$QG
DOO,KDYHOHIWLVDORJHQWU\
([SHFWWKHXQH[SHFWHG'HVSLWH\RXUEHVWHIIRUWVWKLQJVFDQJRZURQJ
7HUULEO\WUDJLFDOO\ZURQJ<RXQHHGWRSURWHFW\RXUVHOI2WKHUVGHSHQGRQ\RX<RX
FDQ¶WOHW\RXUHQWLUHSURJUDPFROODSVHMXVWEHFDXVHRQHEHDQLQWKHIDPLO\WKURZVDQ
H[FHSWLRQ7KHDSSOLFDWLRQPXVWJRRQ<RXFDQ¶WSUHYHQWWUDJHG\EXW\RXFDQSUHSDUH
IRULW<RXQHHGWRNQRZZKDWLVDQGLVQRWUHFRYHUDEOHDQGZKRLVUHVSRQVLEOHZKHQD
SUREOHPRFFXUV6KRXOGWKH%HDQ3URYLGHUWHOOWKH&RQWDLQHUWKHUH¶VVWLOOKRSH"6KRXOG
WKH&RQWDLQHUWHOOWKHFOLHQWWRWU\DJDLQ"2UVKRXOGWKH&RQWDLQHUFXWLWVORVVHVNLOOWKH
EHDQDQGOHWWKH6\V$GPLQVRUWLWRXWODWHU
WKLVLVDQHZFKDSWHU
H[DPREMHFWLYHV
([FHSWLRQV
2IILFLDO :KDWLWUHDOO\PHDQV
,GHQWLI\FRUUHFWDQGLQFRUUHFWVWDWHPHQWV <RXKDYHWRNQRZWKDWDSSOLFDWLRQH[FHSWLRQVDUH
RUH[DPSOHVDERXWH[FHSWLRQKDQGOLQJLQ WKLQJVWKHFOLHQWH[SHFWVDQGPLJKWUHFRYHUIURP
(-% ZKLOHV\VWHPH[FHSWLRQVDUHIRUWKLQJVWKHFOLHQWFDQ¶W
UHFRYHUIURP<RXQHHGWRNQRZWKH¿YHVWDQGDUG
(-%DSSOLFDWLRQH[FHSWLRQVDQGDOORIWKHFRPPRQ
V\VWHPH[FHSWLRQV<RXKDYHWRNQRZH[DFWO\KRZ
WKH&RQWDLQHUEHKDYHVZKHQWKHEHDQWKURZVDQ
DSSOLFDWLRQH[FHSWLRQYVDV\VWHPH[FHSWLRQDQG
\RXKDYHWRNQRZWKHGLIIHUHQFHEHWZHHQH[FHSWLRQV
IRUORFDOFOLHQWVDQGH[FHSWLRQVIRUUHPRWHFOLHQWV
*LYHQDOLVWRIUHVSRQVLELOLWLHVUHODWHGWR <RXQHHGWRNQRZWKDWLIWKHEHDQWKURZVDQDSSOLFD
H[FHSWLRQVLGHQWLI\WKRVHZKLFKDUHWKH WLRQH[FHSWLRQWKH&RQWDLQHUGRHVQRWDXWRPDWLFDOO\
%HDQ3URYLGHU¶VDQGWKRVHZKLFKDUH UROOEDFNWKHWUDQVDFWLRQDQGWKDWWKH&RQWDLQHUJLYHV
WKHUHVSRQVLELOLW\RIWKH&RQWDLQHU%H WKHH[FHSWLRQWRWKHFOLHQWH[DFWO\DVWKHEHDQWKUHZLW
SUHSDUHGWRUHFRJQL]HUHVSRQVLELOLWLHVIRU :LWKV\VWHPH[FHSWLRQVKRZHYHUWKH&RQWDLQHUDO
ZKLFKQHLWKHUWKHEHDQRU&RQWDLQHUDUH ZD\VUROOVEDFNWKHWUDQVDFWLRQDQGJLYHVWKHH[FHS
UHVSRQVLEOH WLRQWRDUHPRWHFOLHQWDVD5HPRWH([FHSWLRQDQG
WRDORFDOFOLHQWDVDQ(-%([FHSWLRQ<RX¶OOQHHGWR
NQRZWKDWLIDEHDQZDQWVWRUROOEDFNDWUDQVDFWLRQDV
SDUWRIDQDSSOLFDWLRQH[FHSWLRQWKHEHDQPXVWFDOO
VHW5ROOEDFN2QO\ VLQFHWKHUROOEDFNZRQ¶WKDSSHQDX
WRPDWLFDOO\<RXQHHGWRNQRZWKDWWKH&RQWDLQHUZLOO
ORJV\VWHPH[FHSWLRQVEXWQRWDSSOLFDWLRQH[FHSWLRQV
DQGWKDWWKH&RQWDLQHUZLOONLOODQ\EHDQWKDWUDLVHVD
V\VWHPH[FHSWLRQ
,GHQWLI\FRUUHFWDQGLQFRUUHFWVWDWHPHQWVRU ,I\RX¶UHJRLQJWRDQVZHUWKHVHTXHVWLRQVFRUUHFWO\
H[DPSOHVDERXWDSSOLFDWLRQH[FHSWLRQVDQG \RXKDYHWRNQRZEHDQGHWDLOVIURPSUHYLRXVFKDSWHUV
V\VWHPH[FHSWLRQVLQHQWLW\EHDQVVHVVLRQ )RUH[DPSOH\RXKDYHWRNQRZWKDWDPHVVDJHGULYHQ
EHDQVDQGPHVVDJHGULYHQEHDQV EHDQGRHVQ¶WKDYHDFOLHQWYLHZ LHFOLHQWLQWHUIDFHV
*LYHQDSDUWLFXODUPHWKRGFRQGLWLRQLGHQWLI\ VRDPHVVDJHGULYHQEHDQFDQ¶WGHFODUHRUWKURZDQ\
WKHIROORZLQJ ZKHWKHUDQH[FHSWLRQZLOOEH DSSOLFDWLRQH[FHSWLRQV$QG\RXKDYHWRNQRZIRUH[
WKURZQWKHW\SHRIH[FHSWLRQWKURZQWKH DPSOHWKDWDEHDQZLOOJHWDQ,OOHJDO6WDWH([FHSWLRQLILW
&RQWDLQHU¶VDFWLRQDQGWKHFOLHQW¶VYLHZ WULHVWRFDOOPHWKRGVRQLWVFRQWH[WIURPSODFHVZKHUH
WKRVHRSHUDWLRQVDUHQ¶WDOORZHG
&KDSWHU
H[FHSWLRQVLQ(-%
?PI\KIVOW_ZWVO'
,QWKH%HDQ
7KHEXVLQHVVORJLFLQDPHWKRGUHDOL]HVWKDWLWFDQQRWGRLWVMREEHFDXVHRIDSUREOHP
WKHFOLHQWH[SHFWV)RUH[DPSOHDEDQNLQJEHDQFDQ·WGRDEDODQFHWUDQVIHUEHFDXVH
WKH¶WUDQVIHUIURP·DFFRXQWGRHVQ·WKDYHDQ\PRQH\
7KHEHDQFDWFKHVDFKHFNHGH[FHSWLRQZKLOHUXQQLQJEXVLQHVVORJLF)RUH[DPSOHWKH
EHDQIDLOVWRJHWD-'%&FRQQHFWLRQRUD-1',ORRNXSWKURZVD1DPLQJ([FHSWLRQWR
WKHEHDQ7KLVLVDSUREOHPWKDWWKHEHDQH[SHFWVEXWWKHFOLHQWGRHVQ·W
$PHWKRGLQWKHEHDQ RUDPHWKRGWKHEHDQFDOOV WKURZVDUXQWLPHH[FHSWLRQ OLNH
1XOO3RLQWHU([FHSWLRQ WKDWWKHEHDQGRHVQ·WFDWFKDQGWKHFOLHQWGRHVQ·WH[SHFW
,QWKH&RQWDLQHU
7KH&RQWDLQHUFDQ·WFRPSOHWHDQRSHUDWLRQIRUZKLFKLWVUHVSRQVLEOHVXFKDVXSGDWLQJWKH
VWDWHRIDQHQWLW\EHDQLQWKHGDWDEDVHWKDWFDXVHVDSUREOHPWKHFOLHQWH[SHFWV
7KH&RQWDLQHUFDWFKHVDFKHFNHGH[FHSWLRQWKURZQE\WKHEHDQWKDWWKHFOLHQWH[SHFWV
$&RQWDLQHUFDWFKHVDUXQWLPHH[FHSWLRQWKURZQE\WKHEHDQRUE\VRPHRWKHUREMHFWWKH
&RQWDLQHULQWHUDFWVZLWK7KLVLVDSUREOHPWKDWWKHFOLHQWGRHVQRWH[SHFW
,QWKH50,VXEV\VWHPRUVRPHRWKHUSDUWRIWKH
FRPPXQLFDWLRQSDWKEHWZHHQFOLHQWDQGFRQWDLQHU
7KH(-%REMHFWWKURZVDUXQWLPHH[FHSWLRQEHIRUHLWFRPPXQLFDWHVZLWKWKHFOLHQW
DERXWWKHUHVXOWRIDFOLHQW·VEXVLQHVVPHWKRGFDOOWRWKHEHDQ
7KH50,VXEV\VWHPFDQ·WFRPPXQLFDWHZLWKWKHFOLHQW
7KHFOLHQWVWXEWKURZVDUXQWLPHH[FHSWLRQRUD5HPRWH([FHSWLRQZKLOHWU\LQJWRVHQG
DPHWKRGFDOORUUHFHLYHDUHWXUQYDOXH
\RXDUHKHUH
-DYDH[FHSWLRQV
:MUMUJMZ2I^IM`KMX\QWV[KIVJMKPMKSMLWZ]VKPMKSML
7KURZDEOH
Checked exceptions are
subclasses of Exception, as
long as they arenÕt subcla
(UURU ([FHSWLRQ of RuntimeException sses
2XW2I0HPRU\(UURU )LOH,2([FHSWLRQ 5XQWLPH([FHSWLRQ
(UURU &KHFNHGH[FHSWLRQV
1XOO3RLQWHU([FHSWLRQ
Although you COULD catch an
ions MUST
error... what the heck would Checked except le or declare
8QFKHFNHG UXQWLPH H[FHSWLRQV
you DO with it? If you get, say, follow the hand piler forces
a VirtualMachineError, youÕre rule--the comledge when you Exceptions that extend
pretty much screwed. 99% you to acknowd that declares
of the time, youÕll catch only call a metho ... RuntimeException are Ôexem
checked Exceptions, and NOT one of these from the handle or declare ptÕ
errors or runtime exceptions. You donÕt have to acknowledlaw.
them... they just happen. ge
7E KNOW THAT YOU REMEMBER ALL OF THIS BUT JUST SO WERE ALL SPEAKING THE SAME LANGUAGE
HERE*AVA HAS BOTH CHECKED AND UNCHECKED EXCEPTIONS #HECKED AS IN COMPILER
CHECKED )F YOU
CALL A METHOD THAT DECLARES A THROWS CLAUSE WITH A CHECKED EXCEPTION YOU MUST REASSURE THE
COMPILER THAT YOU KNOW ALL ABOUT THIS POTENTIAL PROBLEM AND YOURE READY TO TAKE THE RISK )TS
THE HANDLE OR DECLARE RULE 9OU EITHER WRAP THE RISKY METHOD CALL IN A TRYCATCH OR YOU DECLARE
THAT YOU TOO THROW THE EXCEPTION
2EMEMBER DECLARING AN EXCEPTION MEANS DUCKING ITLETTING SOMEONE ELSE IN THE CALL STACK
DEAL WITH IT $ECLARING AN EXCEPTION IS LIKE SAYING h) DONT WANT TO CATCH THIS EXCEPTION
BECAUSE ) THINK SOMEONE ELSE CAN DO A BETTER JOB OF HANDLING IT OR SOMEONE ELSE SHOULD BE
HANDLING IT
)F YOU HANDLE AN EXCEPTION AND EXIT THE CATCH BLOCK IT SHOULD MAKE NO DIFFERENCE WHETHER THE
EXCEPTION OCCURRED OR NOT )F IT DOES MATTER THEN YOU ARENT HANDLING THE EXCEPTION CORRECTLY
AND YOU PROBABLY SHOULD HAVE DUCKED IT INSTEAD
2UNTIME EXCEPTIONS ARE UNCHECKED THEY MATTER ONLY AT RUNTIME NOT COMPILE TIME 9OU CAN
DECLARE THEM CATCH THEM AND THROW THEM IN CODE ANY WAY THAT YOU LIKE BUT THE COMPILER
WONT CARE "UT IF YOUR CODE CAUSES A RUNTIME EXCEPTION THE CALL STACKTHREAD OF EXECUTION
YOURE RUNNING IN DIES )F THATS THE LAST NON
DAEMON THREAD IN YOUR PROGRAM YOUR WHOLE
PROGRAM SHUTS DOWN
&KDSWHU
H[FHSWLRQVLQ(-%
1\¼[ITTIJW]\M`XMK\I\QWV[
%XCEPTION HANDLING IN %*" OR *AVA IN GENERAL
CENTERS ON EXPECTATIONS 9OU HOPE THAT EVERYTHING :UDSSLQJDULVN\PHWKRGFDOOLQD
WORKS CORRECTLY 9OU HOPE THAT YOU DONT GET A RUNTIME
EXCEPTION "UT YOU TAKE RISKS 3O YOU EXPECT THAT SOME WU\FDWFKWHOOVWKHFRPSLOHU DQG
THINGS WILL GO WRONG 4HE KEY IS IN KNOWING WHAT THOSE
THINGS ARE AND WHAT YOU CAN DO TO RECOVER \RXUGHVLJQ WKDW\RXH[SHFWWKDW
-OST OF THE TIME THE THINGS THAT CAN GO WRONG ARE
PRETTY OBVIOUS 9OU DO A *.$) LOOKUP BUT THE OBJECT
FHUWDLQWKLQJVPLJKWJRZURQJ
ISNT THERE 9OU TRY TO CONNECT TO A NAMING SERVICE AND
CANT 9OU TRY TO CONNECT TO THE DATABASE AND CANT <RXKRSHWKDWHYHU\WKLQJZRUNV
9OU TRY TO CREATE A NEW ENTITY BEAN AND THE INSERT
FAILS BECAUSE YOU HAVE A DUPLICATE PRIMARY KEY !ND FRUUHFWO\EXW\RXFDQ·WJXDUDQWHH
FOR EACH OF THOSE YOU CAN WRITE A CATCH BLOCK THAT
NOWS HOW TO DEAL WITH THE SPECIlC PROBLEM YOU HAVE
LWVR\RXKDYHDOLVWRIFDWFK
#ANT CONNECT TO THE NAMING SERVICE -AYBE YOU HAVE
A SECOND NAMING SERVICE TO TRY #ANT CONNECT TO THE
EORFNVIRUWKLQJV\RXH[SHFW
DATABASE -AYBE YOU CAN TRY USING A LOCAL CACHE FOR 0,*+7JRZURQJ
NOW UNTIL YOU CAN RE
ESTABLISH YOUR CONNECTION #ANT
DO THE INSERT 4RY AGAIN USING A DIFFERENT PRIMARY KEY
7HEN YOU PROVIDE A CATCH BLOCK FOR A RISKY METHOD %UHDWKLQJLQ,OHWJRRIP\
CALL YOURE SAYING THAT YOU EXPECT SOMETHING SPECIlC DWWDFKPHQWV%UHDWKLQJRXW,OHWJRRI
MIGHT GO WRONG !LMOST EVERY EXCEPTION FOR WHICH YOU P\H[SHFWDWLRQV%UHDWKLQJLQ,OHWJR
PROVIDE A CATCH BLOCK IS AN EXCEPTION THAT YOU EXPECT RIP\DWWDFKPHQWV%UHDWKLQJRXW,OHWJRRI
3O YOU MIGHT FOR EXAMPLE EXPECT A .AMING%XCEPTION P\H[SHFWDWLRQWKDWP\ERVVZLOOJLYHPHWKH
OR A &INDER%XCEPTION OR A #REATE%XCEPTION UHFRJQLWLRQ,GHVHUYH%UHDWKLQJLQ,OHWJRRI
P\QHHGWREDFNP\689RYHUP\ERVV
DJDLQDQGDJDLQDQG
As it is in all of life,
with exceptions, the
key to happiness is to
manage expectations.
\RXDUHKHUH
H[FHSWLRQSDWKZD\V
([FHSWLRQSDWKZD\V
%HDQWKURZVVRPHWKLQJWKHFOLHQWH[SHFWV
´+H\FOLHQWVRPHWKLQJ\RX ´7HOOFOLHQWWKDWVRPHWKLQJ
H[SHFWKDVKDSSHQHGµ VKHH[SHFWVKDVKDSSHQHGµ
exception
object
%HDQWKURZVVRPHWKLQJWKHFOLHQWGRHV127H[SHFW
´6RUU\FOLHQWEXWVRPHWKLQJ ´7HOOFOLHQWWKDWVRPHWKLQJ
WHUULEOHKDVKDSSHQHGµ WHUULEOHKDVKDSSHQHGµ
&RQWDLQHUWKURZVVRPHWKLQJWKHFOLHQWH[SHFWV
´+H\FOLHQWVRPHWKLQJ\RX
H[SHFWKDVKDSSHQHGµ
As far as theveerbeytanhiÕsng
concerned,
is going Þne.
&KDSWHU
H[FHSWLRQVLQ(-%
&RQWDLQHUWKURZVVRPHWKLQJWKHFOLHQWGRHV127H[SHFW
´6RUU\FOLHQWEXWVRPHWKLQJ
WHUULEOHKDVKDSSHQHGµ
Bean doesnÕt dilemrectly
caus e th e pr ob .
7KHVWXEWKURZVVRPHWKLQJWKHFOLHQWH[SHFWV
´6RPHWKLQJ\RXH[SHFW
KDVKDSSHQHGµ
VWXE
Both the n
the Containbea
er
and
t
everything is Þ hink
ne.
7KHVWXEWKURZVVRPHWKLQJWKHFOLHQWGRHV127H[SHFW
´6RPHWKLQJWHUULEOH
KDVKDSSHQHGµ
VWXE
no problems with the
bean or the Container
\RXDUHKHUH
$SSOLFDWLRQDQG6\VWHPH[FHSWLRQV
1V-2*M`KMX\QWV[KWUMQV\ _WNTI^WZ["
IXXTQKI\QWVIVL[a[\MU
!PPLICATION EXCEPTIONS ARE THINGS THE CLIENT EXPECTS WHICH MEANS THE CLIENT HAS TO
HANDLE THEM ONE WAY OR ANOTHER 4HIS MEANS THAT APPLICATION EXCEPTIONS ARE
DECLARED IN THE INTERFACES EXPOSED TO THE CLIENT AND THE CLIENT USES A TRYCATCH
WHEN SHE CALLS THE METHOD 3INCE THE CLIENT CAN CATCH THE EXPECTED EXCEPTION THE
CLIENT MIGHT BE ABLE TO RECOVER AND KEEP GOING !PPLICATION EXCEPTIONS INCLUDE
THINGS LIKE #REATE%XCEPTION MAYBE THE CLIENT
SUPPLIED ARGUMENTS WERENT VALID OR
!CCOUNT"ALANCE%XCEPTION PERHAPS THE CLIENT CAN TRY A DIFFERENT ACCOUNT WITH THE
NEXT CALL OR /BJECT.OT&OUND%XCEPTION THAT ENTITY IS NO LONGER IN THE DATABASE
!PPLICATION EXCEPTIONS INCLUDE ALL CHECKED EXCEPTIONS THROWN BY A BEAN OR A #ONTAINER
EXCEPT JAVARMI2EMOTE%XCEPTION !LTHOUGH 2EMOTE%XCEPTION IS CHECKED AND THE
CLIENT CATCHES IT AS FAR AS THE CLIENT IS CONCERNED WHATEVER CAUSED THE 2EMOTE%XCEPTION
ON THE SERVER WAS UNEXPECTED
3YSTEM EXCEPTIONS ARE FOR THINGS THE CLIENT DOES NOT EXPECT ANDOR CANT RECOVER FROM 4HIS
COULD BE VIRTUALLY ANY RUNTIME EXCEPTION THAT HAPPENS ON THE SERVER FROM THE BEAN
OR THE #ONTAINER OR ANY OTHER OBJECT ON THE SERVER OR EVEN IN THE CLIENTS LOCAL STUB
OBJECT 3YSTEM EXCEPTIONS ARE THINGS THE CLIENT REALLY CANT RECOVER FROM EITHER BECAUSE
THEYRE NOT RECOVERABLE LIKE A FAILURE IN THE DATABASE OR A .ULL0OINTER%XCEPTION OR
BECAUSE THE CLIENT DOESNT HAVE ENOUGH INFORMATION TO KNOW WHAT TO DO LIKE WITH A
2EMOTE%XCEPTION WHICHEVEN THOUGH IT IS A CHECKED EXCEPTION THE CLIENT CATCHESTELLS
THE CLIENT ONLY THAT SOMETHING UNEXPECTEDLY BAD HAPPENED ON THE SERVER
*RWWDORYHDSSOLFDWLRQ
2KVK
$V\VWHP H[FHSWLRQV,FDQ
H[FHSWLRQ1RWKLQJ,FDQ UHFRYHUIURPWKLVLI,SXW
GRDERXWLW7KHUHJRHVP\ LQDGLIIHUHQWYDOXHIRUWKH
VWDWHIXOEHDQ,·OOKDYHWR DUJXPHQWWRWKHFUHDWH
VWDUWRYHU PHWKRG
&KDSWHU
H[FHSWLRQVLQ(-%
?Q\PIV)XXTQKI\QWV-`KMX\QWV\PM+WV\IQVMZ_QTT
VHQGLWEDFNWRWKHFOLHQW(;$&7/<DVLWZDVWKURZQ
$FFRXQW%DODQFH([FHSWLRQ $FFRXQW%DODQFH([FHSWLRQ
$KDQ
$FFRXQW%DODQFH
H[FHSWLRQ
127VHWWKHWUDQVDFWLRQWRUROOEDFN
,·OOOHWWKH ,·OOWKURZWKHH[FHSWLRQVR
WUDQVDFWLRQFRQWLQXH WKH&RQWDLQHUFDQWHOOWKH
$FFRXQW%DODQFH([FHSWLRQ FOLHQWEXWWKHWUDQVDFWLRQLV
HYHQWKRXJK,·PJRQQD
VWLOOVDIHWRFRQWLQXHVR,ZRQ·W
WKURZWKLVWRWKH
DVNLWWRUROOEDFN,IWKLQJVJHW
FOLHQW EDGODWHU,FDQDOZD\VFDOO
VHW5ROOEDFN2QO\
VSDUHWKHEHDQ·VOLIH
,·OOOHWWKHEHDQ
:KHZ7KDQNP\OXFN\
OLYHVLQFHDQDSSOLFDWLRQ
HOHFWURQVLWZDVDQDSSOLFDWLRQ
H[FHSWLRQGRHVQ·WQHFHVVDULO\ H[FHSWLRQDQGQRWDV\VWHP
PHDQWKHEHDQLVFRUUXSW H[FHSWLRQRUHOVH,·GEH
RQO\WKLVWLPHLWZRXOGQ·WEH
MXVWDQDFW
\RXDUHKHUH
6\VWHPH[FHSWLRQV
?Q\PI;a[\MU-`KMX\QWV\PM+WV\IQVMZ_QTT
VHQGLWEDFNWRD5HPRWHFOLHQWDVD5HPRWH([FHSWLRQ
RUWRDORFDOFOLHQWDVDQ(-%([FHSWLRQ
,KDYHQR 5HPRWH([FHSWLRQ 1XOO3RLQWHU([FHSWLRQ
LGHDZKDWZHQW
ZURQJ
remotte
clien
DOZD\VFDXVHDWUDQVDFWLRQUROOEDFN
7KLVLVEDG$OO
KRSHLVORVWIRUWKLV
1XOO3RLQWHU([FHSWLRQ 7KHUH·V12ZD\WKLV
WUDQVDFWLRQVR,·PUROOLQ·
WUDQVDFWLRQLVVDIH
LWEDFNEDE\
QRZ 1RWWKDW,·PJRLQJ
WRFDUH
NLOOWKHEHDQDQGORJWKHH[FHSWLRQ
e bean dies, it
this time, wheann th
7KLVEHDQLVKLVWRU\:KR
.12:6ZKDWVWDWHLWVYDULDEOHV STANCE is r
DUHLQQRZ,KDYHWRDVVXPHLW·V means the bed mIN ad e eligible fo
FRUUXSWDQGNLOOLW,·OOORJLWIRU discarded an ction. If itÕs an
WKHV\VDGPLQ garbage colle the real entity is
entity bean, d can be reloaded
still alive, an an instance.
/2* into a new be
&KDSWHU
H[FHSWLRQVLQ(-%
$SSOLFDWLRQ([FHSWLRQV 6\VWHP([FHSWLRQV
FOLHQWFDQWU\WR FOLHQWFDQ·W
UHFRYHU UHFRYHU
&OLHQWUHFRYHU\
7UDQVDFWLRQVWDWXV
WUDQVDFWLRQSURFHHGV XQOHVV DXWRPDWLFUROOEDFN
EHDQFDOOVVHW5ROOEDFN2QO\
%HDQLQVWDQFH
LQVWDQFHOLYHV LQVWDQFHGLHV
/2* /2*
/RJJLQJ
127ORJJHG H[FHSWLRQORJJHG
([DPSOHV &UHDWH([FHSWLRQ 5HPRWH([FHSWLRQ UHPRWHFOLHQW
5HPRYH([FHSWLRQ (-%([FHSWLRQ ORFDOFOLHQW
)LQGHU([FHSWLRQ ,OOHJDO6WDWH([FHSWLRQ
2EMHFW1RW)RXQG([FHSWLRQ 7UDQVDFWLRQ5HTXLUHG([FHSWLRQ
'XSOLFDWH.H\([FHSWLRQ 1R6XFK2EMHFW([FHSWLRQ
$UUD\,QGH[2XW2I%RXQGV([FHSWLRQ
$FFRXQW%DODQFH([FHSWLRQ 1XOO3RLQWHU([FHSWLRQ
%DG4XHU\$UJV([FHSWLRQ 5XQWLPH([FHSWLRQ
%RRN0DSSLQJ([FHSWLRQ
([FHSWLRQ
&RPSLOHUFKHFNLQJ $OODSSOLFDWLRQH[FHSWLRQV0867 7KHRQO\V\VWHPH[FHSWLRQWKDWLV
DQGRWKHUUXOHV EHFKHFNHGH[FHSWLRQVDQGPXVW FKHFNHGLV5HPRWH([FHSWLRQ$OO
127H[WHQG5HPRWH([FHSWLRQ RWKHUVDUHD5XQWLPH([FHSWLRQ RU
RQHRILWVVXEFODVVHV
\RXDUHKHUH
$SSOLFDWLRQH[FHSWLRQV
7KDWFDQ·WEHULJKWLI
,WKURZDQDSSOLFDWLRQ
H[FHSWLRQ,WKLQNWKHUH·VDGDUQ
JRRGFKDQFHWKDW,GR127ZDQW
WKHWUDQVDFWLRQWRFRPPLW
YiX`e
gfn\i
:KDWLIDQ\WKLQJFDQ\RXGRLI\RXNQRZ\RX
ZDQWWRWKURZDQDSSOLFDWLRQH[FHSWLRQWRWKH
FOLHQWEXW\RXGR127ZDQWWKHWUDQVDFWLRQWR
FRPPLW"
7KLQNDERXWWKDWIRUDPRPHQW
:H¶OOWDNHDORRNDWWKLVVFHQDULRLQDIHZSDJHV
&KDSWHU
H[FHSWLRQVLQ(-%
?IZVQVO :MUW\M-`KMX\QWVQ[KPMKSML
J]\VW\M`XMK\ML
.ORMALLY WHEN WE THINK OF EXPECTED VS UNEXPECTED
EXCEPTIONS WE MAP IT TO CHECKED VS UNCHECKED EXCEPTIONS !
&ILE)/%XCEPTION IS EXPECTED ! .ULL0OINTER%XCEPTION IS NOT
$SSOLFDWLRQH[FHSWLRQVDUH
!NY DIRECT SUBCLASS OF %XCEPTION IS EXPECTED ! SUBCLASS OF DOZD\VFRPSLOHUFKHFNHG
2UNTIME%XCEPTION IS NOT ! CHECKED EXCEPTION MUST BE HANDLED
!N UNCHECKED EXCEPTION USUALLY WONT BE H[FHSWLRQVH[FHSWIRU
"UT THERES ONE BIG EXCEPTION TO THE WHOLE EXCEPTIONS AND 5HPRWH([FHSWLRQ
EXPECTATIONS THINGJAVARMI2EMOTE%XCEPTION
2EMOTE%XCEPTION IS A CHECKED EXCEPTION OF COURSE SO THE CLIENT
IS FORCED TO ACKNOWLEDGE A 2EMOTE%XCEPTION BY HANDLING IT WITH 7KLQNRI5HPRWH([FHSWLRQ
A TRYCATCH "UT UNLIKE THE OTHER CHECKED EXCEPTIONS A CLIENT
SEES IN A BEANS INTERFACE 2EMOTE%XCEPTION IS STILL CONSIDERED DV´DUXQWLPHH[FHSWLRQRQ
UNEXPECTED /+ NOT EXACTLY UNEXPECTED BUT UNEXPECTED WKHVHUYHUµHYHQWKRXJK
&ROM THE CLIENTS POINT OF VIEW THINK OF 2EMOTE%XCEPTION A KIND
OF RUNTIME EXCEPTION ON THE REMOTE PART OF THE APPLICATION 5HPRWH([FHSWLRQLVD
"ECAUSE THATS OFTEN WHAT IT MEANS ! .ULL0OINTER%XCEPTION FKHFNHGH[FHSWLRQWRWKH
ON THE SERVER MEANS A 2EMOTE%XCEPTION TO THE CLIENT !
$IVIDE"Y:ERO%XCEPTION ON THE SERVER MEANS A 2EMOTE%XCEPTION FOLHQW
TO THE CLIENT ! #LASS#AST%XCEPTION ON THE SERVER MEANS A
2EMOTE%XCEPTION TO THE CLIENT 4HOSE ARE ALL UNCHECKED
EXCEPTIONS ON THE SERVER BUT THEY PROPAGATE BACK TO THE CLIENT ,QRWKHUZRUGVDUHPRWH
AS A CHECKED 2EMOTE%XCEPTION )N OTHER WORDS THE CLIENT HAS TO
EXPECT THAT THE SERVER CAN THROW SOMETHING UNEXPECTED FOLHQWPXVW(;3(&7
$OES THIS MEAN THAT EVERY 2EMOTE%XCEPTION ON THE CLIENT WAS WKDWWKHVHUYHUFDQWKURZ
ORIGINALLY TRIGGERED BY A BEAN GETTING A RUNTIME EXCEPTION .O
! BEAN MIGHT FOR EXAMPLE CATCH A CHECKED EXCEPTION AS PART OF VRPHWKLQJ81(;3(&7('
ITS BUSINESS LOGIC AND THEN REALIZE IT CANT RECOVER !T THAT POINT
THE BEAN TURNS WHAT WAS ORIGINALLY A CHECKED EXCEPTION FROM
THE BEANS PERSPECTIVE TO AN UNCHECKED SYSTEM EXCEPTION BY
WRAPPING AND RETHROWING IT AS AN %*"%XCEPTION WHICH ULTIMATELY
SHOWS UP AS A 2EMOTE%XCEPTION ON THE REMOTE CLIENT
)N FACT THE CLIENT CAN GET A 2EMOTE%XCEPTION EVEN WITHOUT THE
SERVER ! STUB FOR EXAMPLE MIGHT THROW A 2EMOTE%XCEPTION
BECAUSE IT CANT EVEN REACH THE SERVER 4HE KEY HERE IS TO THINK OF
APPLICATION EXCEPTIONS AS CHECKED EXCEPTIONS THAT THE CLIENT MUST
ACKNOWLEDGE AND MIGHT RECOVER FROM AND SYSTEM EXCEPTIONS AS ALL
OTHER EXCEPTIONS INCLUDING 2EMOTE%XCEPTION AND ITS SUBCLASSES
\RXDUHKHUH
GHFODULQJH[FHSWLRQV
):MUW\MMV\Q\aJMIVPWUMQV\MZNIKMLMKTIZM[IXXTQKI\QWV
M`KMX\QWV[IVLWVM[a[\MUM`KMX\QWV:MUW\M-`KMX\QWV
SDFNDJHKHDG¿UVW
LPSRUWMDYD[HME
LPSRUWMDYDUPL5HPRWH([FHSWLRQ
system
applicationn
LPSRUWMDYDXWLO&ROOHFWLRQ
exception
SXEOLFLQWHUIDFH&XVWRPHU+RPHH[WHQGV(-%+RPH^ exceptio
SXEOLF&XVWRPHUFUHDWH 6WULQJODVW6WULQJ¿UVW WKURZV&UHDWH([FHSWLRQ5HPRWH([FHSWLRQ
SXEOLF&XVWRPHU¿QG%\3ULPDU\.H\ 6WULQJNH\ WKURZV)LQGHU([FHSWLRQ5HPRWH([FHSWLRQ
SXEOLF&ROOHFWLRQ¿QG%\&LW\ 6WULQJFLW\ WKURZV)LQGHU([FHSWLRQ5HPRWH([FHSWLRQ
`
ed
something the client ects, and something unexpee ct er, so
can potentially recoveexp happened on th se rv
ver.
application exception) r from (an the client ca nÕ t re co
)TWKITMV\Q\aJMIVPWUMQV\MZNIKMLMKTIZM[WVTa
IXXTQKI\QWVM`KMX\QWV[
SDFNDJHKHDG¿UVW
LPSRUWMDYD[HME
application
LPSRUWMDYDXWLO&ROOHFWLRQ exception
SXEOLFLQWHUIDFH&XVWRPHU+RPH/RFDOH[WHQGV(-%/RFDO+RPH^
SXEOLF&XVWRPHUFUHDWH 6WULQJODVW6WULQJ¿UVW WKURZV&UHDWH([FHSWLRQ
SXEOLF&XVWRPHU¿QG%\3ULPDU\.H\ 6WULQJNH\ WKURZV)LQGHU([FHSWLRQ
SXEOLF&ROOHFWLRQ¿QG%\&LW\ 6WULQJFLW\ WKURZV)LQGHU([FHSWLRQ
`
n
applicatioion
exce p t
&KDSWHU
H[FHSWLRQVLQ(-%
:MUW\M-`KMX\QWVOWM[\WZMUW\MKTQMV\[
-2*-`KMX\QWVOWM[\WTWKITKTQMV\[
7HEN SOMETHING UNEXPECTED HAPPENS ON THE SERVER THE #ONTAINER
TELLS THE CLIENT BY THROWING EITHER A 2EMOTE%XCEPTION OR AN :KHQVRPHWKLQJ
%*"%XCEPTION
2EMOTE%XCEPTION IS FOR REMOTE CLIENTS ONLY AND EVEN THOUGH IT IS A XQH[SHFWHGKDSSHQVRQ
CHECKED EXCEPTION ITS TELLING THE CLIENT THAT SOMETHING UNEXPECTED
HAPPENED 3OMETHING FROM WHICH THE CLIENT CANT RECOVER
WKHVHUYHUDORFDOFOLHQW
%*"%XCEPTION IS FOR LOCAL CLIENTS ONLY AND ITS UNCHECKED )N OTHER JHWVD5XQWLPH([FHSWLRQ
WORDS %*"%XCEPTION IS A SUBCLASS OF 2UNTIME%XCEPTION 4O THE
CLIENT GETTING AN %*"%XCEPTION ISNT MUCH DIFFERENT FROM GETTING
(-%([FHSWLRQ EXW
SAY AN !RRAY)NDEX/UT/F"OUNDS%XCEPTION )T MEANS SOMETHING DUHPRWHFOLHQWJHWV
UNEXPECTED WENT WRONG AND THERES NOTHING YOU CAN DO TO
RECOVER 4HE ONLY DIFFERENCE IS THAT THE CLIENT DOES HAVE TO CATCH THE DFRPSLOHUFKHFNHG
2EMOTE%XCEPTION BUT ONCE HE CATCHES IT THE CLIENT USUALLY WONT
BE ABLE TO TELL WHAT HAPPENED AT LEAST NOT IN ANY RECOVERABLE WAY 5HPRWH([FHSWLRQ
5HPRWHFOLHQW
,FDXJKWWKH
5HPRWH([FHSWLRQEXW, 5HPRWH([FHSWLRQ 1XOO3RLQWHU([FHSWLRQ
KDYHQRLGHDZKDWZHQW
ZURQJ
FOLHQWKHDS VHUYHUKHDS
/RFDOFOLHQW
<LNHV,JRW
D5XQWLPH([FHSWLRQ
(-%([FHSWLRQ 1XOO3RLQWHU([FHSWLRQ
QRWKLQJ,FDQGR
VHUYHUKHDS
\RXDUHKHUH
TXHVWLRQRQH[FHSWLRQV
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: )N THE PICTURE YOU SHOW THE CLIENT
THINKING h) HAVE NO IDEA WHAT HAPPENEDv
WHEN SHE GETS A 2EMOTE%XCEPTION "UT WHEN )
GET A 2EMOTE%XCEPTION IN MY SHELL TERMINAL IT
USUALLY TELLS ME WHAT HAPPENED WITH A MESSAGE
LIKE h! .ULL0OINTER%XCEPTION OCCURRED ON THE
SERVERv OR SOMETHING LIKE THAT
A: !ND AT RUNTIME THAT HELPS YOU HOW 3URE IT
HELPS YOU A 4/. AT DEVELOPMENT AND TESTING TIME
BUT WHEN YOUR APPLICATION IS ACTUALLY RUNNING
YOUR CLIENT CODE PROBABLY ISNT GOING TO PARSE
THE STACK TRACE 7HEN WE SAY THAT THE CLIENT
HAS NO IDEA WHAT HAPPENED WE MEAN THAT THE
CLIENT WASNT ABLE TO CATCH SOMETHING SPECIFIC
SOMETHING RECOVERABLE
#ONTRAST THAT WITH SOMETHING LIKE
#REATE%XCEPTION WHERE THE CLIENT CAN CATCH THE
EXCEPTION AND FROM THE CATCH BLOCK TRY THE CREATE
AGAIN POSSIBLY WITH DIFFERENT ARGUMENTS
,W·VWHPSWLQJWRWKLQNR
H[FHSWLRQVYV V\V WHP
IDSSOLFDWLRQ
H[ FHSWLRQVDVVLPSO\
G
FKHFNHGYVXQFKHFNH
PH[FHSWLRQV
SHUVSHFWLYHWKHRQO\V\VWH
$QGLQIDFWIURPWKHFOLHQW¶V FHS WLRQ VD UH5 HP RWH([FHSWLRQV
XQWLPH H[
WKDWDUH127XQFKHFNHG U FNH GH[FHSWLRQV
VWHPH[FHSWLRQVDUHXQFKH
6RIRUORFDOFOLHQWV$//V\ SOLFDWLR QH [FH SWLRQVDUH
HSWLRQ ZKLOHDOODS
VXEFODVVHVRI5XQWLPH([F HSW )RU
LRQ
HSWLRQEXWQRW5XQWLPH([F
FKHFNHG VXEFODVVHVRI([F HG EX WWKHUHLVDOVR
QH[FHSWLRQVDUHFKHFN
UHPRWHFOLHQWVDOODSSOLFDWLR V\ VWH PH [FH SWLR Q)URP
W¶VFRQVLGHUHGD
RQHFKHFNHGH[FHSWLRQWKD HSWLRQ EHLQJ
DV
XFDQWKLQNRI5HPRWH([F
WKHFOLHQW¶VSRLQWRIYLHZ\R DWKDSS HQVRQWKH
GUXQWLPHH[FHSWLRQWK
DZUDSSHUIRUDQXQFKHFNH LHZ WKHR ULJLQDO H[FHSWLRQ
EHDQ¶VSRLQWRIY
VHUYHU $OWKRXJKIURPWKH HE HDQ NQHZLW
H[FHSWLRQEXWRQHWKDWWK
PLJKWKDYHEHHQDFKHFNHG
FRXOGQ¶WUHFRYHUIURP
&KDSWHU
H[FHSWLRQVLQ(-%
*MIV8ZW^QLMZ¼[ZM[XWV[QJQTQ\QM[
,I\RXUEXVLQHVVORJLFFDWFKHV RUFUHDWHV DQDSSOLFDWLRQ
H[FHSWLRQWKURZLWWRWKH&RQWDLQHUDVWKHDSSOLFDWLRQH[FHSWLRQ
)N BEAN CODE IF YOU CATCH AN APPLICATION EXCEPTION THROWN BY OTHER CODE OR YOU CREATE
THE EXCEPTION AS PART OF YOUR BUSINESS LOGIC THROW IT TO THE #ONTAINER EXACTLY AS
IS &OR
EXAMPLE IF YOUR BEAN CODE GETS A &INDER%XCEPTION WHILE TRYING TO LOOK UP ANOTHER BEAN
IN OTHER WORDS WHILE CALLING A lNDER METHOD ON ANOTHER BEANS HOME INTERFACE GIVE
THE &INDER%XCEPTION TO THE #ONTAINER EXACTLY AS YOU GOT IT 4HAT MEANS EITHER DECLARING IT
DUCKING IT AND LETTING IT PROPAGATE BACK DOWN THE STACK TO THE #ONTAINER
row it,
if you intend to th
re it (just
you have to adlaecwla)
SXEOLFYRLGVRPH%XVLQHVV0HWKRG WKURZV)LQGHU([FHSWLRQ^
&XVWRPHU+RPHKRPH QXOO
WU\^ regular Jav
,QLWLDO&RQWH[WLF QHZ,QLWLDO&RQWH[W
2EMHFWR LFORRNXS ³&XVWRPHUV´
KRPH &XVWRPHU+RPH 3RUWDEOH5HPRWH2EMHFWQDUURZ R&XVWRPHU+RPHFODVV
`FDWFK 1DPLQJ([FHSWLRQQH ^
GHDOZLWK1DPLQJ([FHSWLRQ
`
We catc
and Remohta NamingException
WU\^
&XVWRPHUFXVW KRPH¿QG%\3ULPDU\.H\ ³´
PRUHVWXII the Finder eException, but N
`FDWFK 5HPRWH([FHSWLRQUH ^ FinderExceException, so the OT
GHDOZLWK5HPRWH([FHSWLRQ the Containption propagates
er automat ba
` ically ck to
`
/R CATCHING IT AND RETHROWING IT AS AS
SXEOLFYRLGVRPH2WKHU%XVLQHVV0HWKRG WKURZV)LQGHU([FHSWLRQ^ still have to declare
&XVWRPHU+RPHKRPH QXOO it, of course
WU\^
,QLWLDO&RQWH[WLF QHZ,QLWLDO&RQWH[W
2EMHFWR LFORRNXS ³&XVWRPHUV´
KRPH &XVWRPHU+RPH 3RUWDEOH5HPRWH2EMHFWQDUURZ R&XVWRPHU+RPHFODVV
`FDWFK 1DPLQJ([FHSWLRQQH ^
GHDOZLWKQDPLQJH[FHSWLRQ
`
WU\^
&XVWRPHUFXVW KRPH¿QG%\3ULPDU\.H\ ³´
PRUHVWXII
`FDWFK 5HPRWH([FHSWLRQUH ^
GHDOZLWKLW
r,
if we canÕt recove
`FDWFK )LQGHU([FHSWLRQIH ^
LI UHFRYHUDEOH ^
W e caught it, buextactly as we got it
WKURZIH
we rethrow it
`HOVH^RWKHUVWXII`
`
`
\RXDUHKHUH
%HDQ3URYLGHUDQGH[FHSWLRQV
*MIV8ZW^QLMZ¼[ZM[XWV[QJQTQ\QM[
,I\RXFDWFKDQDSSOLFDWLRQH[FHSWLRQDQGÀQGWKDW\RX
FDQ·WFRQWLQXHWKHWUDQVDFWLRQFDOOVHW5ROOEDFN2QO\ EHIRUH
WKURZLQJWKHH[FHSWLRQWRWKH&RQWDLQHU
2EMEMBER THE #ONTAINER WONT ROLLBACK A TRANSACTION JUST BECAUSE THERES AN APPLICATION
EXCEPTION 7ITH AN APPLICATION EXCEPTION THE #ONTAINER ASSUMES THAT THE WHOLE THING
MIGHT BE RECOVERABLE AND THAT THE TRANSACTION CAN CONTINUE 5NLESS YOU lND OUT IN
YOUR BUSINESS LOGIC THAT COMMITTING WOULD BE A 2EALLY "AD )DEA IT OFTEN IS 7HATS YOUR
OPTION &ORCE THE #ONTAINER TO ROLLBACK THE TRANSACTION USING SET2OLLBACK/NLY ON YOUR
%*"#ONTEXT FOR A #-4 BEAN OR ON YOUR 5SER4RANSACTION FOR A "-4 BEAN
SXEOLFYRLGVRPH2WKHU%XVLQHVV0HWKRG WKURZV)LQGHU([FHSWLRQ^
&XVWRPHU+RPHKRPH QXOO
WU\^
,QLWLDO&RQWH[WLF QHZ,QLWLDO&RQWH[W
2EMHFWR LFORRNXS ³&XVWRPHUV´
KRPH &XVWRPHU+RPH 3RUWDEOH5HPRWH2EMHFWQDUURZ R&XVWRPHU+RPHFODVV
`FDWFK 1DPLQJ([FHSWLRQQH ^
GHDOZLWKQDPLQJH[FHSWLRQ
`
WU\^
&XVWRPHUFXVW KRPH¿QG%\3ULPDU\.H\ ³´
PRUHVWXII
`FDWFK 5HPRWH([FHSWLRQUH ^
GHDOZLWKLW
`FDWFK )LQGHU([FHSWLRQIH ^ t we know that
LI UHFRYHUDEOH ^ We caught it,vebur AND we canÕt
FRQWH[WVHW5ROOEDFN2QO\ we canÕt recosaction commit!!
WKURZIH let the tran
`HOVH^RWKHUVWXII`
`
`
&KDSWHU
H[FHSWLRQVLQ(-%
*MIV8ZW^QLMZ¼[ZM[XWV[QJQTQ\QM[
,I\RXUEXVLQHVVORJLFFDWFKHVDQH[FHSWLRQWKHFOLHQWLVQRW
H[SHFWLQJ LQRWKHUZRUGVQRWGHFODUHGLQ\RXUFOLHQWYLHZ
ZUDSLWDQGUHWKURZLWDVDQ(-%([FHSWLRQ
(OW MUCH SHOULD THE CLIENT KNOW ABOUT YOUR INTERNAL BEHAVIOR ,ITTLE OR NOTHING RIGHT
&OR EXAMPLE IS IT ANY OF THE CLIENTS BUSINESS THAT YOURE USING *$"# TO GET YOUR WORK DONE
!ND THAT YOU MIGHT AS PART OF YOUR BUSINESS LOGIC CATCH AN 31,%XCEPTION 4HROWING AN
%*"%XCEPTION IS THE PROGRAMMERS WAY OF TELLING THE #ONTAINER h)VE LOST CONTROLv
/HJDOEXWDEDGLGHD
&DQ\RXVD\´WRRPXFK
SXEOLFLQWHUIDFH%DG6HUYLFHH[WHQG(-%/RFDO2EMHFW^
LQIRUPDWLRQ"µ,5($//<GLGQ·W
SXEOLFYRLGVRPH0HWKRG WKURZV64/([FHSWLRQ
QHHGWRNQRZWKDWDERXW\RX8P
LQWKHIXWXUH,VXJJHVWWKDW `
\RXGR127H[SRVH\RXUSULYDWH
Do you really think th e
SUREOHPVWRWKHZRUOG
clien t sho uld KNOW th at
youÕre using SQL?
SXEOLFFODVV%DG6HUYLFH%HDQLPSOHPHQWV6HVVLRQ%HDQ^
SXEOLFYRLGVRPH0HWKRG WKURZV64/([FHSWLRQ^
GRVWXIIWKDWPLJKWFDXVHDQ64/([FHSWLRQ
`
RWKHUEHDQPHWKRGV
`
7KHZD\\RX6+28/'GRLW
SXEOLFLQWHUIDFH*RRG6HUYLFHH[WHQG(-%/RFDO2EMHFW^
SXEOLFYRLGVRPH0HWKRG
`
SXEOLFFODVV*RRG6HUYLFH%HDQLPSOHPHQWV6HVVLRQ%HDQ^
SXEOLFYRLGVRPH0HWKRG ^ EJBEx tio
WU\^ runtimeceexpce n is a
GRVWXII donÕt have toption, so you
`FDWFK 64/([FHSWLRQVH ^ declare it.
LIZHFDQ¶WUHFRYHU
WKURZQHZ(-%([FHSWLRQ VH
`
`
as
wrap and theprotiwon
an EJBExc
\RXDUHKHUH
%HDQ3URYLGHUDQGH[FHSWLRQV
*MIV8ZW^QLMZ¼[ZM[XWV[QJQTQ\QM[
,I\RXUEXVLQHVVORJLFHQFRXQWHUVDUXQWLPHH[FHSWLRQ
OHWLWSURSDJDWHWRWKH&RQWDLQHU'RQ·WWU\WRFDWFKLW
*UST DONT DO IT $ONT USE A TRYCATCH TO CATCH SAY %XCEPTION 4HAT WOULD
MEAN YOUD CATCH EVERYTHING AND THE WORST THING YOU CAN DO IS TO EAT
RUNTIME EXCEPTIONS WITHOUT LETTING THEM PASS BACK UP TO THE #ONTAINER
)F YOU DO NEED TO CATCH A RUNTIME EXCEPTION BUT THEN l ND THAT YOU CANT
RECOVER YOU CAN SIMPLY THROW IT AS
IS "UT WHATEVER YOU DO DONT DO THIS
FYRLGGXPE0HWK
E0H
catch all Exceptions
U\
WU\^ Really stupid idea. DonÕt
Throwables!) Catch only
(or even worse -- all ur siness logic, and let
FDWFK ([FHSWLR
FK
`FDWFK ([FHSWLRQH[ ^` what you need for yo ceptbuions propagate back
`
the other runtime ex the Container.
down the call stack to
,I\RXUEXVLQHVVORJLFJHQHUDWHVDQDSSOLFDWLRQ
H[FHSWLRQ\RXPXVWKDYHGHFODUHGWKHH[FHSWLRQLQ
ERWK\RXUFOLHQWLQWHUIDFH$1'\RXUEHDQFODVV
2EMEMBER JUST BECAUSE YOU DECLARE AN EXCEPTION IN AN INTERFACE DOESNT
MEAN YOU HAVE TO DECLARE THE EXCEPTION IN YOUR IMPLEMENTATION OF THE
METHOD 4HATS TRUE REGARDLESS OF WHETHER YOU IMPLEMENT THE METHOD IN
THE FORMAL *AVA WAY BECAUSE YOUR CLASS SAYS hEXTENDS 4HIS)NTERFACEv "UT IF
THERES A CHANCE THAT YOULL THROW AN APPLICATION EXCEPTION EITHER BECAUSE
YOU HAVE A TRYCATCH IN YOUR CODE OR BECAUSE YOUR OWN BUSINESS LOGIC CAN
CREATE ONE YOU MUST DECLARE THE EXCEPTION IN YOUR BEAN CLASS
You have to
declare it, if you
SXEOLFYRLGZLWKGUDZ GRXEOHG WKURZV$FFRXQW%DODQFH([FHSWLRQ^ might throw it.
LI EDODQFHG ^
WKURZQHZ$FFRXQW%DODQFH([FHSWLRQ RYHUGUDZQ0VJ
`HOVH^
EDODQFH G
`
`
`
SXEOLFDEVWUDFWYRLGZLWKGUDZ GRXEOHG WKURZV$FFRXQW%DODQFH([FHSWLRQ
&KDSWHU
H[FHSWLRQVLQ(-%
*MIV8ZW^QLMZ¼[ZM[XWV[QJQTQ\QM[
,I\RXFUHDWH\RXURZQDSSOLFDWLRQH[FHSWLRQVWKH\PXVWH[WHQG
GLUHFWO\RULQGLUHFWO\ ([FHSWLRQEXWQRW5XQWLPH([FHSWLRQRU
5HPRWH([FHSWLRQ
!LTHOUGH YOURE ENCOURAGED TO USE OR EXTEND THE STANDARD %*" EXCEPTIONS WELL GET TO
THOSE IN A MINUTE WHEN YOUR DESIGN CALLS FOR YOUR OWN CUSTOM EXCEPTIONS YOU MUST MAKE
THEM CHECKED EXCEPTIONS 4HAT MEANS THEY MUST EXTEND JAVALANG%XCEPTION OR ONE OF ITS
SUBCLASSES AS LONG AS IT DOES NOT EXTEND JAVALANG2UNTIME%XCEPTION 4HE OTHER RESTRICTION
IS THAT APPLICATION EXCEPTIONS MUST NOT EXTEND JAVARMI2EMOTE%XCEPTION DIRECTLY OR
INDIRECTLY 2EMEMBER AN APPLICATION EXCEPTION IS ANY CHECKED EXCEPTION DECLARED IN THE
CLIENT VIEW EXCEPT 2EMOTE%XCEPTION
SXEOLFYRLGZLWKGUDZ GRXEOHG WKURZV$FFRXQW%DODQFH([FHSWLRQ^
LI EDODQFHG ^
WKURZQHZ$FFRXQW%DODQFH([FHSWLRQ RYHUGUDZQ0VJ
`HOVH^EDODQFH G `
`
`
FODVV$FFRXQW%DODQFH([FHSWLRQH[WHQGV([FHSWLRQ^
$FFRXQW%DODQFH([FHSWLRQ 6WULQJV ^
VXSHU V
`
`
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: ) JUST REALIZED SOMETHING THE CONTAINER Q: 9OU SAID THE INTERFACES DONT DECLARE ANY
CALLBACKS DECLARED IN THE 3ESSION"EAN AND %NTITY"EAN CHECKED EXCEPTIONS 4(!4 9/5 #!. 53% 7HAT DOES
INTERFACES DONT DECLARE CHECKED EXCEPTIONS RIGHT 3O THAT MEAN 7HATS AN EXAMPLE OF A DECLARED CHECKED
DOESNT THIS MEAN THAT YOU CANT THROW AN APPLICATION EXCEPTION THAT YOU CANT USE
EXCEPTION FROM SAY EJB!CTIVATE
A: A: )F YOU GO TO THE *%% !0) WELL WAIT WHILE YOU DO
4HATS RIGHT 9OU CAN THROW ONLY UNCHECKED THAT STILL WAITING WAITING WAITING YOU CAN SEE THAT
EXCEPTIONS FROM A CONTAINER CALLBACK THAT IS NOT PART OF ALL OF THE METHODS DECLARE A 2EMOTE%XCEPTION 9ES A "IG
YOUR CLIENT VIEW 4HIS IS JUST PLAIN OLD *AVA YOU CANT &AT #HECKED EXCEPTION 4HEY ALSO DECLARE %*"%XCEPTION
THROW A CHECKED EXCEPTION FROM A METHOD THAT DOESNT AS A NICE GESTURE BUT NOT A REQUIREMENT SINCE
DECLARE THE EXCEPTION AND SINCE THOSE INTERFACES DONT %*"%XCEPTION IS A SUBCLASS OF 2UNTIME%XCEPTION $OES
DECLARE ANY CHECKED EXCEPTIONS THAT YOU CAN USE YOURE THIS MEAN YOU CAN THROW A 2EMOTE%XCEPTION YOURSELF
STUCK WITH RUNTIME EXCEPTIONS 4HE ONLY THING YOU ,IKE IF YOU CAUGHT ONE WHILE YOUR BEAN IS BEING A CLIENT
SHOULD THROW FROM ONE OF THE CONTAINER CALLBACKS OF TO ANOTHER BEAN FOR EXAMPLE ./ ./ ! TIMES ./
3ESSION"EAN %NTITY"EAN OR -ESSAGE$RIVEN"EAN IS AN )N THE DAYS OF STEAM
DRIVEN CONTAINERS THE %*" SPEC
%*"%XCEPTION ALLOWED YOU TO THROW 2EMOTE%XCEPTIONS FROM YOUR
BEAN 4HOSE DAYS ARE OVER AND %*" DOESNT ALLOW IT
3O UNLESS YOURE A POOR SOUL TASKED WITH LEGACY BEAN
MAINTENANCE YOU SHOULD AVERT YOUR GAZE WHEN YOU
LOOK AT THE !0) DOCS AND PRETEND YOU NEVER SAW THAT
2EMOTE%XCEPTION
\RXDUHKHUH
7KH&RQWDLQHUDQGH[FHSWLRQV
<PM+WV\IQVMZ¼[ZM[XWV[QJQTQ\QM[
,IWKHEHDQWKURZVDQDSSOLFDWLRQH[FHSWLRQVHQGLWEDFNWR
WKHFOLHQW(;$&7/<DVLWZDVWKURZQDQGGR127UROOEDFNWKH
WUDQVDFWLRQ
)F THE BEAN THROWS A #REATE%XCEPTION SEND THAT EXCEPTION TO THE CLIENT )F THE BEAN
THROWS A &INDER%XCEPTION SEND THAT EXCEPTION TO THE CLIENT )F THE BEAN THROWS AN
!CCOUNT"ALANCE%XCEPTION SEND THAT EXCEPTION TO THE CLIENT
)T MAKES NO DIFFERENCE WHETHER THE EXCEPTION IS ONE OF THE STANDARD %*" EXCEPTIONS
FROM THE JAVAEJB PACKAGE OR ONE THAT THE "EAN 0ROVIDER DElNED
,ZDV $FFRXQW%DODQFH([FHSWLRQ $FFRXQW%DODQFH([FHSWLRQ
UHDG\IRUDQ
$FFRXQW%DODQFH
H[FHSWLRQ
,IWKHEHDQWKURZVDV\VWHPH[FHSWLRQ LQFOXGLQJ(-%([FHSWLRQ
RUDQ\UXQWLPHH[FHSWLRQ
7KURZD5HPRWH([FHSWLRQLIWKHFOLHQWLV5HPRWH
7KURZDQ(-%([FHSWLRQLIWKHFOLHQWLVORFDO
/RJWKHH[FHSWLRQ
5ROOEDFNWKHWUDQVDFWLRQ
'LVFDUGWKHEHDQLQVWDQFH DVVXPHLW·VWRDVW
:HOOWKDWVXFNV, (-%([FHSWLRQ 1XOO3RLQWHU([FHSWLRQ
JRWD5XQWLPH([FHSWLRQ
/2*
ORFDOFOLHQW
&KDSWHU
H[FHSWLRQVLQ(-%
YiX`e 6KDUSHQ \RXU SHQFLO
gfn\i
)URPWKHOLVWRISRVVLEOHRSWLRQVVHOHFWZKDW
7KLQNDERXWWKHFOLHQWIRUDPRPHQW,IWKHFOL \RXDVD%HDQ3URYLGHUVKRXOGGRLQHDFK
HQWJHWVD5HPRWH([FHSWLRQGRHVWKHFOLHQW RIWKHIROORZLQJVFHQDULRV$VVXPHWKDWWKH\
NQRZIRUFHUWDLQWKDWWKHEXVLQHVVPHWKRG DOOWDNHSODFHZLWKLQDEXVLQHVVPHWKRGRID
FRPSOHWHG" VHVVLRQEHDQ
'RHVWKHFOLHQWNQRZIRUFHUWDLQWKDWWKH 2SWLRQV \RXPD\XVHDQRSWLRQPRUHWKDQRQFH
WUDQVDFWLRQZDVUROOHGEDFN" $7KURZDQ(-%([FHSWLRQ
,VWKHUHDQ\ZD\WKHFOLHQWPLJKWEHDEOHWR %7KURZD5HPRWH([FHSWLRQ
¿QGRXW"
:KDWLIWKHFOLHQWLVDQRWKHUEHDQ" &,QYRNHVHW5ROOEDFN2QO\
'$OORZWKHH[FHSWLRQWRSURSDJDWH LQ
RWKHUZRUGVGXFNLW
6FHQDULRV
QWKHH[DP
7KHUH¶VQRWKLQJR
LHQWVWUDWHJLHV <RXFDWFKDFKHFNHGH[FHSWLRQLQ\RXU
DERXWQRQ-((FO
DQVDFWLRQIDLOXUHV HME$FWLYDWHPHWKRG7KHPHWKRGLVQRWLQ
IRUFRSLQJZLWKWU DWUDQVDFWLRQ
ERXWZKDWPLJKW
\RXQHHGWRWKLQND
%XWDVDGHYHORSHU UV LWXDWLRQVLQ
QWVLGHHVSHFLDOO\IR
KDSSHQRQWKHFOLH UDQ VD FWL RQVXFFHHGHG $'LYLGH%\=HURH[FHSWLRQRFFXUVDV\RXU
ZZKHWKHUDW
ZKLFK\RXGRQ¶WNQR I\RXU-(( EXVLQHVVORJLFLVUXQQLQJ<RXGRQRW
QRUDQRWKHUSDUWR
,I\RXUFOLHQWLVDEHD - ((FOLHQW KDYHDWU\FDWFKIRUWKLV
QJRRGVKDSH7KH
DSSOLFDWLRQ\RX¶UHL WK HW UDQ VD FWLRQ%XWD
WWKHVWDWXVRI
FDQXVXDOO\¿QGRX HF QLVPRUDW
KD
QHHGVRPHRWKHUP <RXWKURZD&UHDWH([FHSWLRQIURP\RXU
QRQ-((FOLHQWZLOO WHP SWVWKHVDPH
QWHHWKDWLIKHDW HME&UHDWH PHWKRGDQG\RXUHDOL]HWKDW
OHDVWDZD\WRJXDUD G\ VX FF HH GHG EXWKH
WHULWDOUHD \RXSUREDEO\FDQQRWVDIHO\FRPSOHWH
WUDQVDFWLRQDJDLQDI \VXEVHTXHQW
WWKHVHFRQG RUDQ \RXUWUDQVDFWLRQ
GRHVQ¶WNQRZ WKD Q\ RXKDYHDQ
HSUREOHPV:KH
DWWHPSWZRQ¶WFDXV RE OHP VL ID WWHPSWHGDIWHU
¶WFDXVHSU
RSHUDWLRQWKDWZRQ RSHUDWLRQLV <RXFDWFKDFKHFNHGH[FHSWLRQLQD
GWKDWPHDQV\RXU
LWVDOUHDG\VXFFHHGH GR Q¶W OLNHWKHVRXQGRI EXVLQHVVPHWKRGDQGUHDOL]HWKDW\RXU
W¶$QGW KRXJKZHUHDOO\
µLGHP SR WHQ JULW\RI\RXUDSS EHDQLVSUREDEO\FRUUXSW
HFULWLFDOWRWKHLQWH
WKDWZRUGLWPLJKWE
\RXDUHKHUH
$SSOLFDWLRQH[FHSWLRQV
<PMNQ^M[\IVLIZL-2*IXXTQKI\QWVM`KMX\QWV[
4HE JAVAXEJB PACKAGE HAS l VE STANDARD APPLICATION EXCEPTIONS USED BY THE %*" CONTAINER BUT
YOU CAN USE THEM AS WELL EITHER DIRECTLY OR AS SUPERCLASSES TO YOUR OWN CUSTOM EXCEPTIONS
([FHSWLRQ MDYDODQJSDFNDJH
&UHDWH([FHSWLRQ )LQGHU([FHSWLRQ 5HPRYH([FHSWLRQ
'XSOLFDWH.H\([FHSWLRQ 2EMHFW1RW)RXQG([FHSWLRQ
MDYD[HMESDFNDJH
&UHDWH([FHSWLRQ
4HE #ONTAINER THROWS THIS FROM YOU GUESSED IT A CREATE METHOD IF SOMETHING
GOES WRONG DURING CREATION 4HIS INCLUDES SCENARIOS IN WHICH THE BEAN CODE THROWS
#REATE%XCEPTION ITSELF WHILE RUNNING A CREATE METHOD !LTHOUGH IF THE BEANS GONNA
THROW IT THE BEANS GOTTA DECLARE IT IN THE BEAN CLASS NOT JUST THE HOME INTERFACE
'XSOLFDWH.H\([FHSWLRQ
4HE #ONTAINER THROWS THIS TO THE CLIENT FROM AN ENTITY BEAN CREATE METHOD SEE HOW ITS A
SUBCLASS OF #REATE%XCEPTION IF THE BUSINESS LOGIC RELATED TO THE CREATE ASKS THE #ONTAINER TO
INSERT A NEW ENTITY USING A PRIMARY KEY THAT HAS ALREADY BEEN ASSIGNED TO ANOTHER ENTITY
)LQGHU([FHSWLRQ
4HE #ONTAINER THROWS THIS TO THE CLIENT FROM AN ENTITY BEANS l NDER METHOD TO TELL THE
CLIENT THAT SOMETHING WENT WRONG DURING THE l NDER 4HE BEAN MIGHT HAVE THROWN IT "-0
BEANS ONLY BUT FOR #-0 BEANS ONLY THE #ONTAINER CAN THROW THIS METHOD
2EMHFW1RW)RXQG([FHSWLRQ
4HE #ONTAINER THROWS THIS TO THE CLIENT /.,9 DURING SINGLE
ENTITY l NDER METHODS WHEN
THERES NO ENTITY IN THE DATABASE MATCHING THE PRIMARY KEY PARAMETER OF THE l NDER METHOD
5HPRYH([FHSWLRQ
4HE #ONTAINER THROWS THIS TO THE CLIENT FROM A SESSION OR ENTITY BEAN WHEN SOMETHING
GOES WRONG IN A REMOVE METHOD "UT THE BEAN PROVIDER CAN THROW THIS EXCEPTION IF FOR
EXAMPLE HE DOESNT WANT TO LET CLIENTS REMOVE ENTITY BEANS
&KDSWHU
H[FHSWLRQVLQ(-%
<PMNQ^M[\IVLIZLIXXTQKI\QWVM`KMX\QWV[NZWU\PM
KTQMV\¼[XWQV\WN^QM_
4WO OF THE lVE ARE MORE SPECIlC$UPLICATE+EY%XCEPTION AND
/BJECT.OT&OUND%XCEPTION )F THE CLIENT GETS AN /BJECT.OT&OUND%XCEPTION THE
CLIENT HAS MORE INFORMATION THAN IF HE GETS A MORE ABSTRACT &INDER%XCEPTION !ND IF
THE CLIENT GETS A $UPLICATE+EY%XCEPTION HE KNOWS A LOT MORE ABOUT WHAT WENT WRONG
THAN IF HE GETS A GENERIC #REATE%XCEPTION
" &UHDWH([FHSWLRQ
4HE CLIENT DOES NOT KNOW FOR CERTAIN WHETHER THE BEAN WAS
ACTUALLY CREATED 4HE #ONTAINER MIGHT HAVE HAD A PROBLEM AFTER
THE TRANSACTION COMMITTED
'XSOLFDWH.H\([FHSWLRQ
*RWLW
)F THE CLIENT CATCHES A $UPLICATE+EY%XCEPTION SHE CAN BE
CERTAIN THAT THE BEAN WAS NOT CREATED
)LQGHU([FHSWLRQ
" 4HE CLIENT DOES NOT KNOW WHETHER A MATCHING ENTITY OR
ENTITIES FOR MULTIPLE
ENTITY lNDERS EXISTS IN THE DATABASE
4HE #ONTAINER MIGHT THROW A &INDER%XCEPTION BECAUSE OF
SOMETHING THAT WENT WRONG BEFORE IT WAS ABLE TO LOOK IN THE
DATBASE
*RWLW 2EMHFW1RW)RXQG([FHSWLRQ
)F THE CLIENT CATCHES AN /BJECT.OT&OUND%XCEPTION SHE CAN
BE CERTAIN THAT THERE WAS NO MATCH FOR THIS PRIMARY KEY
IN THE DATABASE 2EMEMBER /BJECT.OT&OUND%XCEPTION IS
FOR SINGLE
ENTITY lNDERS ONLY SO A CLIENT WILL NEVER GET THIS FOR
A MULTI
ENTITY lNDER
5HPRYH([FHSWLRQ
"
4HE CLIENT DOES NOT KNOW FOR CERTAIN WHETHER THE BEAN WAS
ACTUALLY REMOVED 4HE BEAN PROVIDER MIGHT SIMPLY HAVE
REJECTED THE CLIENTS REQUEST AS IN h9OU CAN ASK ALL DAY LONG
BUT THERE IS NO 7!9 THAT )M GOING TO REMOVE THAT ENTITY FROM
THE DATABASEv /R THE ENTITY MIGHT HAVE BEEN REMOVED FROM THE
DATABASE BUT THEN SOMETHING ELSE WENT WRONG THAT TRIGGERED
THE 2EMOVE%XCEPTION
\RXDUHKHUH
$SSOLFDWLRQH[FHSWLRQV
WKHUH DUH QR
'XPE 4XHVWLRQV
6WDWHOHVVVHVVLRQE
Q: )F A 2EMOVE%XCEPTION MAKES NO SENSE
HDQ FOR A STATELESS SESSION BEAN WHY ARE YOU
FOLHQWVZLOO1(9(5JH ALLOWED TO THROW IT ASSUMING YOU DECLARE IT
WD
5HPRYH([FHSWLRQ ON YOUR BEANS REMOVE METHOD
,I\RXVHHDVFHQDULRZK
HUHWKHFOLHQWJHWVD
5HPRYH([FHSWLRQ\RXFDQ
VHVVLRQEHDQV7KLQNDERX
UXOHRXWVWDWHOHVV
WLWDVWDWHOHVVVHV
A: 2EMEMBER THERES NOTHING IN THE BEAN
VLRQEHDQ¶VUHPRYDOLV1( CLASS THAT CAN TELL YOU WHETHER THE BEAN IS
9(5WLHGWRDFOLHQWVR
WKHUH¶VQRERG\WRJLYHWK DEFINITELY STATELESS 9OU CAN TELL IF A BEAN IS
HH[FHSWLRQWR<RXFDQ
WKURZD5HPRYH([FHSWLR STATEFUL OF COURSE BECAUSE ANY BEAN WITH
QIURP\RXUHME5H
PRYH PHWKRGEXWWKHF OVERLOADED CREATES OR ITS ONLY CREATE HAS ARGS
OLHQWZLOOQHYHUVHHLWLI
WKHEHDQLVDVWDWHOHVVVHV MUST BE STATEFUL "UT EVEN IF A SESSION BEAN HAS
VLRQEHDQ
ONLY A SINGLE NO
ARG CREATE METHOD YOU STILL
DONT KNOW WHETHER THAT BEAN IS GOING TO BE
MARKED STATELESS OR STATEFUL AT DEPLOYTIME
4HIS WOULD ALL BE DIFFERENT IF THERE WERE A
7KHFOLHQWPLJKW
SEPARATE INTERFACE FOR 3TATELESS3ESSION"EAN
AND 3TATEFUL3ESSION"EAN THAT YOUR BEAN HAD
127JHWWKH TO IMPLEMENT INSTEAD OF JUST 3ESSION"EAN BUT
PRVWVSHFLÀF THATS NOT HOW IT WORKS
H[FHSWLRQ
'RQ¶WFRXQWRQ$/:$<6J
PRVWVSHFL¿FH[FHSWLRQR
HWWLQJWKH
QWK HFOLHQW
Q: )F THE "EAN 0ROVIDER DOESNT WANT TO LET
WQR WD FFR UGLQJ ENTITY BEAN CLIENTS REMOVE A BEAN WHY DOES
7KH&RQWDLQHUPLJK HE HAVE A REMOVE METHOD
FVHQG WKH FOLH QWD
WRWKHVSH
HQLIWKDWLV
'XSOLFDWH.H\([FHSWLRQHY
WKHSUREOHP
:KDWGRHVWKLVPHDQWRWKH
FOLHQW" A: !RENT YOU FORGETTING SOMETHING OBVIOUS
DF DWF K HERE 7HERE DO THE REMOVE METHODS LIVE
,IWKHFOLHQW¶VFRGHKDV (OW ARE THEY EXPOSED TO THE CLIENT 4HATS RIGHT
H([ FHS WLRQ DQ GD
IRUERWKD&UHDW )N THE CLIENT INTERFACES 2EMEMBER THERE ARE
.H\ ([F HSW LRQ WK HF OLHQ W
'XSOLFDWH THREE REMOVE METHODS AVAILABLE TO A REMOTE
UWDL QWK DWLI
FDQ¶WEHFRPSOHWHO\FH ENTITY BEAN CLIENT THE NO
ARG IN THE %*"/BJECT
SWLRQWKH
VKHFDWFKHVD&UHDWH([FH
PLV1 27 DG XSO LFD WHN H\LVVXH INTERFACE AND THE REMOVE THAT TAKES A KEY AND
SUREOH
RUH [DP SOHWKH THE REMOVE THAT TAKES A HANDLE IN THE %*"(OME
7KLVZRXOGEHEDGLII
WNH SWWU\LQ JWR FUH DWH INTERFACE ! LOCAL ENTITY BEAN CLIENT HAS TWO
FOLHQWFRGHMXV REMOVE METHODSTHE ONE IN %*"/BJECT AND
LQN LQJ ´,
VHQGLQJLQWKHVDPHNH\WK
WH. H\( [FH SWLR QVR THE ONE IN THE HOME THAT TAKES A PRIMARY KEY 3O
GLGQ¶WJHWD'XSOLFD THERES NOTHING YOU CAN DO TO HIDE THE REMOVE
FDQ ¶WEHWK HS URE OHP ´
,NQRZ7+$7 METHODS FROM A CLIENT BUT IF YOU DONT SUPPORT
Q
,I\RXJHWD&UHDWH([FHSWLR IT FROM YOUR BEAN THROW A 2EMOVE%XCEPTION
RQWKHFOLHQWDQG127D FROM YOUR BEANS EJB2EMOVE METHOD AND THE
XZRQ¶W
'XSOLFDWH.H\([FHSWLRQ\R
NH \LVR.,W¶V #ONTAINER WONT GO THROUGH WITH THE REMOVE
NQRZIRUFHUWDLQWKDWWKH
UZ KHW KHU LWJLYHV 4HIS IS YOUR WAY OF TELLING THE #ONTAINER h$ONT
XSWRWKH&RQWDLQH
UHV SHF L¿FH [FH SWLR Q DO IT ) DONT CARE WHAT THE CLIENT SAYS DONT YOU
\RXWKHPR
DARE GO THROUGH WITH THE REMOVEv
&KDSWHU
H[FHSWLRQVLQ(-%
+WUUWV[a[\MUM`KMX\QWV[
"ESIDES THE STANDARD APPLICATION EXCEPTIONS FOR %*" THERE ARE SEVERAL
IMPORTANT SYSTEM EXCEPTIONS ! FEW INCLUDING %*"%XCEPTION ARE PART OF
THE *%% !0) BUT TWO OF THE MOST LIKELY SYSTEM EXCEPTIONS IN %*" INCLUDE
JAVARMI.O3UCH/BJECT%XCEPTION AND JAVALANG)LLEGAL3TATE%XCEPTION
/RFDOFOLHQWVDQG
EHDQVZLOOJHWWKHVH
XQFKHFNHG 5XWLPH([FHSWLRQ
MDYDODQJSDFNDJH
MDYD[HMESDFNDJH (-%([FHSWLRQ ,OOHJDO6WDWH([FHSWLRQ
1R6XFK2EMHFW/RFDO([FHSWLRQ 1R6XFK(QWLW\([FHSWLRQ
2QO\5HPRWHFOLHQWVZLOOJHWWKHVH FKHFNHG
MDYDUPLSDFNDJH 5HPRWH([FHSWLRQ
1R6XFK2EMHFW([FHSWLRQ 7UDQVDFWLRQ5HTXLUHG([FHSWLRQ 7UDQVDFWLRQ5ROOHGEDFN([FHSWLRQ
MDYD[HMESDFNDJH
\RXDUHKHUH
6\VWHPH[FHSWLRQV
+WUUWV[a[\MUM`KMX\QWV[
,OOHJDO6WDWH([FHSWLRQ
4HE #ONTAINER THROWS THIS TO A BEAN IF THE BEAN CALLS A METHOD ON ITS CONTEXT THAT ISNT
ALLOWED AT THAT TIME &OR EXAMPLE A SESSION BEAN CANT ASK ITS CONTEXT FOR A REFERENCE TO
ITS %*" OBJECT WHILE IN THE SET3ESSION#ONTEXT METHOD )TS TOO EARLY ! BEAN CAN ALSO
GET AN )LLEGAL3TATE%XCEPTION IF IT CALLS A TRANSACTION METHOD LIKE SET2OLLBACK/NLY OR
GET2OLLBACK/NLY WHEN THERES NO TRANSACTION
(-%([FHSWLRQ
4HE BEAN THROWS THIS TO TELL THE #ONTAINER A SYSTEM EXCEPTION HAS OCCURRED WHICH FORCES THE
#ONTAINER TO ROLLBACK THE TRANSACTION LOG THE EXCEPTION KILL THE BEAN AND GIVE A LOCAL CLIENT
THE %*"%XCEPTION AND A REMOTE CLIENT A 2EMOTE%XCEPTION "UT THE #ONTAINER CAN ALSO THROW
THIS FOR A VARIETY OF OTHER REASONS WELL LOOK AT IN A MINUTE
1R6XFK2EMHFW/RFDO([FHSWLRQ
4HIS EXCEPTION IS KIND OF A LOCAL COMPANION TO JAVARMI.O3UCH/BJECT%XCEPTION 4HE
#ONTAINER THROWS IT TO THE CLIENT WHEN THE CLIENT INVOKES A METHOD ON A LOCAL HOME OR
COMPONENT INTERFACE BUT THERES NO UNDERLYING BEAN TO SUPPORT THE OBJECT 4HIS CAN
HAPPEN FOR EXAMPLE IF THE BEAN HAS ALREADY BEEN REMOVED EITHER THROUGH A PREVIOUS CLIENT
CALL TO REMOVE OR BECAUSE THE #ONTAINER KILLED THE BEAN DUE TO AN EXCEPTION STATEFUL BEAN
TIMEOUT OR TO REDUCE THE SIZE OF THE POOL
1R6XFK(QWLW\([FHSWLRQ
9OU PROBABLY WONT SEE OR USE THIS EXCEPTION MUCH ESPECIALLY WITH #-0 BUT ITS FOR YOU TO
THROW FROM YOUR BEAN CODE WHEN YOU WANT TO TELL THE #ONTAINER THAT THE ENTITY YOURE TRYING TO
ACCESS IS NO LONGER IN THE DATABASE PERHAPS BECAUSE IT WAS REMOVED BY AN ADMIN APPLICATION
7UDQVDFWLRQ5HTXLUHG/RFDO([FHSWLRQ7UDQVDFWLRQ5HTXLUHG([FHSWLRQ
4HE #ONTAINER THROWS THIS TO THE CALLER WHEN THE CALLED METHOD HAS A TRANSACTION ATTRIBUTE
OF MANDATORY BUT THERES NO TRANSACTION CONTEXT COMING IN WITH THE CALL )N OTHER WORDS ITS
MANDATORY THAT THE CALLER INVOKES THE METHOD WITHIN AN EXISTING TRANSACTION AND IF THERE ISNT
ONE THE APPROPRIATE 4RANSACTION2EQUIRED EXCEPTION IS THROWN DEPENDING ON WHETHER THE
CLIENT IS LOCAL OR REMOTE
7UDQVDFWLRQ5ROOHGEDFN([FHSWLRQ7UDQVDFWLRQ5ROOHGEDFN/RFDO([FHSWLRQ
4HE #ONTAINER THROWS THIS TO THE CALLER WHEN THE #ONTAINER CANT COMMIT THE TRANSACTION AND THE
CALLER INVOKED THE METHOD WITHIN AN EXISTING TRANSACTION CONTEXT "UT THE #ONTAINER WILL NOT THROW
THIS EXCEPTION IF THE FAILURE TO COMMIT IS BECAUSE THE BEAN EXPLICITLY CALLED THE SET2OLLBACK/NLY
METHOD )N THAT CASE THE #ONTAINER WILL ROLLBACK THE TRANSACTION AND PASS THE BUSINESS METHOD
RESULT BACK TO THE CLIENT UNLESS THE BEAN ALSO THROWS AN APPLICATION EXCEPTION
&KDSWHU
H[FHSWLRQVLQ(-%
<RX·UHNLGGLQJULJKW"
+RZDP,VXSSRVHGWRUHPHPEHU
WKHGLIIHUHQFHEHWZHHQVD\
1R6XFK2EMHFWDQG2EMHFW1RW)RXQG
H[FHSWLRQV",ZRQGHUZKDWJHQLXVFDPH
XSZLWKVXFKFOHDUHDV\WRGLVWLQJXLVK
the only one thatÕs NO T in
QDPHV2QDQGOHWPHJXHVV
javax.ej b is in jav a.r mi . It means
the
WKH\·UHRQWKHH[DPULJKW"
the client has a stugone. t
b, bu
Remote objec t is
checked
MDYDUPL1R6XFK2EMHFW([FHSWLRQ
this was added to B
when local interfaceEJ
in version 2.0. It meas ns
came
not checked the client has an invalid
MDYD[HME1R6XFK2EMHFW/RFDO([FHSWLRQ EJB object reference.
checked
MDYD[HME2EMHFW1RW)RXQG([FHSWLRQ this is ONLY for Þnder ders)
methods! (single-entity Þn
not checked clients will never see th
MDYD[HME1R6XFK(QWLW\([FHSWLRQ youÕll probably never useis,it.and
just donÕt confuse it with ..
of the others! any
/+ WE AGREE 4HE NAMES FEEL A LITTLE
SHALL WE SAY ARBITRARY "UT REMEMBER THE
.O3UCH/BJECT%XCEPTION CAME lRST )T WAS
DESIGNED FOR THE SCENARIO WHERE THE CLIENT HAS A
STUB TO A 2EMOTE OBJECT AND FOR WHATEVER REASON
THE 2EMOTE OBJECT IS NO LONGER USABLE -IGHT HAVE
BEEN A SERVER CRASH -IGHT BE THAT THE SERVICE
ITSELF HAS BEEN UNDEPLOYED $OESNT MATTER !S
FAR AS THE CLIENTS CONCERNED THE PHONE HAS BEEN
DISCONNECTED OVER AT THE SERVER SIDE
.O3UCH/BJECT,OCAL%XCEPTION WAS ADDED WHEN
LOCAL CLIENT VIEWS WERE ADDED IN %*" 4HE
CONCEPT IS SLIGHTLY DIFFERENT BECAUSE THE LOCAL
CLIENT IS USING NOT A STUB BUT A REAL *AVA OBJECT
REFERENCE "UT FROM THE CLIENTS PERSPECTIVE
IT REALLY DOESNT MATTER WHETHER ITS LOCAL OR
2EMOTEA .O3UCH/BJECT WHATEVER EXCEPTION
MEANS YOU CANT USE YOUR %*" OBJECT REFERENCE TO
GET TO A BEAN 9OU HAVE TO GO BACK THROUGH THE
HOME AND START OVER
\RXDUHKHUH
FRQIXVLQJO\QDPHGH[FHSWLRQV
,WULHGWRÀQGKLPEXWDQ
H[RWLFGDQFHUQDPHG3DXO
$UH\RXVXUH\RX :KHDWRQZDV1RW)RXQG
ORRNHGHYHU\ZKHUH" DQ\ZKHUHLQWKHUHFRUGV0D\EHLI
$QG\RXVWLOOGLGQ·WÀQG ZHXSJUDGHGWRDGDWDEDVHWKDW·VLQ
DQ\UHFRUGRI3DXO FRORU,FRXOGDFWXDOO\JHWVRPHWKLQJ
:KHDWRQ" GRQHDURXQGKHUH
,·PVRUU\EXWWKHUH·V1R6XFK
SHUVRQKHUH<HV,UHDOL]HWKDW
WKLVLVKRZ\RXFRQWDFWHGKLP
LQWKHSDVW%XWWUXVWPHKRQH\
+H·VEHHQUHPRYHG,SXWKLVERG\
WKURXJKWKHZRRGFKLSSHUQRW
WZRGD\VDJR
2EMHFW1RW)RXQG([FHSWLRQLVD)LQGHU([FHSWLRQ
1R6XFK2EHFW([FHSWLRQLVZKHQWKHFOLHQWVWLOOKDV
DVWXEWRD5HPRWHREMHFWEXWWKHREMHFWKDVEHHQ
UHPRYHG RULVQRORQJHUYDOLGIRUDQ\RWKHUUHDVRQ
1R6XFK2EMHFW/RFDO([FHSWLRQLVZKHQWKHORFDOFOLHQW
KDVDUHIHUHQFHWRDQ(-%REMHFWIRUDEHDQWKDW¶VEHHQ
UHPRYHG RULVQRORQJHUYDOLGIRUDQ\RWKHUUHDVRQ
&KDSWHU
H[FHSWLRQVLQ(-%
:MDD=LHGAFLK
([FHSWLRQVLQ-DYDFDQEHFKHFNHGRUXQFKHFNHG ,IWKH%HDQ3URYLGHUFDWFKHVDQH[FHSWLRQIURP
&KHFNHGH[FHSWLRQVH[WHQGMDYDODQJ([FHSWLRQ ZKLFKWKHEHDQFDQQRWUHFRYHUKHVKRXOGZUDS
EXWQRWMDYDODQJ5XQWLPH([FHSWLRQ DQGUHWKURZWKHH[FHSWLRQDVDQ(-%([FHSWLRQ D
UXQWLPHH[FHSWLRQVRKHGLGQ·WQHHGWRGHFODUHLW
([FHSWLRQVLQ(-%FDQEHWKURZQIURPWKHEHDQWR
WKH&RQWDLQHUDQGIURPWKH&RQWDLQHUWRWKHEHDQ 7KHUHDUHILYHVWDQGDUG(-%DSSOLFDWLRQH[FHSWLRQV
&UHDWH([FHSWLRQ'XSOLFDWH.H\([FHSWLRQ
(-%H[FHSWLRQVFRPHLQWZRW\SHV DSSOLFDWLRQDQG H[WHQGV&UHDWH([FHSWLRQ )LQGHU([FHSWLRQ
V\VWHP
2EMHFW1RW)RXQG([FHSWLRQ H[WHQGV
$SSOLFDWLRQH[FHSWLRQVDUHFKHFNHGH[FHSWLRQVWKDW )LQGHU([FHSWLRQ DQG5HPRYH([FHSWLRQ
WKHFOLHQWLVH[SHFWLQJDQGPLJKWEHDEOHWRUHFRYHU
&RPPRQV\VWHPH[FHSWLRQVLQFOXGH(-%([FHSWLRQ
IURP7KLVLQFOXGHVDOOFKHFNHGH[FHSWLRQVH[FHSW
,OOHJDO6WDWH([FHSWLRQ7UDQVDFWLRQ5HTXLUHG/RFDO([
MDYDUPL5HPRWH([FHSWLRQDQGLWVVXEFODVVHV
FHSWLRQDQG1R6XFK2EMHFW/RFDO([FHSWLRQ
6\VWHPH[FHSWLRQVDUHDOORWKHUH[FHSWLRQV 2EMHFW1RW)RXQG([FHSWLRQLVIRUZKHQVLQJOH
DQGLQFOXGHDOOUXQWLPHH[FHSWLRQVSOXV
HQWLW\ILQGHUPHWKRGVFDQQRWILQGDQHQWLW\LQWKH
5HPRWH([FHSWLRQ
SHUVLVWHQWVWRUHWKDWPDWFKHVWKHSULPDU\NH\
)RUWKHFOLHQWD5HPRWH([FHSWLRQFDQEHWUHDWHG DUJXPHQWWRWKHILQGHUPHWKRG
DVWKRXJKDUXQWLPHH[FHSWLRQ LHVRPHWKLQJ
1R6XFK2EMHFW([FHSWLRQLVDQ50,H[FHSWLRQIRU
XQH[SHFWHG KDSSHQHGRQWKHVHUYHU
ZKHQD5HPRWHFOLHQWKDVDVWXEWRD5HPRWH
:KHQWKH&RQWDLQHUJHWVDV\VWHPH[FHSWLRQLW REMHFWWKDW·VEHHQUHPRYHGRULVLQYDOLGIRUVRPH
ZLOOUROOEDFNWKHWUDQVDFWLRQORJWKHH[FHSWLRQDQG RWKHUUHDVRQ
WKURZDZD\WKHEHDQ
1R6XFK2EMHFW/RFDO([FHSWLRQLVDUXQWLPH
:KHQWKH&RQWDLQHUJHWVDQDSSOLFDWLRQH[FHSWLRQ H[FHSWLRQIRUZKHQDORFDOFOLHQWKDVDUHIHUHQFH
LWZLOOVHQGLWWRWKHFOLHQWH[DFWO\DVLWZDVUHFHLYHG WRDQ(-%REMHFWWKDW·VQRORQJHUYDOLG PRVWOLNHO\
7KHWUDQVDFWLRQZLOOQRWDXWRPDWLFDOO\UROOEDFNDQG EHFDXVHWKHEHDQKDVDOUHDG\EHHQUHPRYHG
WKHEHDQ·VOLIHZLOOEHVSDUHG
7KH%HDQ3URYLGHUVKRXOGWKURZDSSOLFDWLRQ
H[FHSWLRQVWRWKH&RQWDLQHUDVLVVRWKDWWKH
&RQWDLQHUFDQSDVVWKHPRQWRWKHFOLHQW,IWKH
EHDQ·VWUDQVDFWLRQLVSRVVLEO\FRUUXSWWKH%HDQ
3URYLGHUVKRXOGFDOOVHW5ROOEDFN2QO\ EHIRUH
WKURZLQJDSSOLFDWLRQH[FHSWLRQVRWKDWWKH
&RQWDLQHUZLOOQRWFRPPLWWKHWUDQVDFWLRQ
\RXDUHKHUH
H[FHSWLRQVFHQDULRV
;KMVIZQW["_PI\LWaW]\PQVSPIXXMV['
4ECHNICALLY THIS SECTION IS LIKE A BIG STEALTH 3HARPEN 9OUR 0ENCIL EXERCISE /NLY
WE JUST TOLD YOU SO MAYBE NOT SO STEALTHY 3URE WE COULD JUST TELL YOU EVERYTHING
ONE FACT AFTER ANOTHER BUT YOULL HAVE A MUCH BETTER CHANCE AT REMEMBERING
IT IF YOU WORK IT OUT FOR YOURSELF 7E SUMMARIZE EVERYTHING NEAR THE END OF THE
CHAPTER BUT DO ./4 JUMP THERE NOW %VEN IF YOURE SOMEONE WHO NEVER DOES
THE EXERCISES DO THIS SCENARIO WALK
THROUGH 9OULL THINK OF US FONDLY WHEN YOURE
HOLDING YOUR LOVELY LAPEL PIN THAT YOU GET FROM PASSING THE CERTIlCATION EXAM
$PHVVDJHGULYHQEHDQ¶VRQ0HVVDJH PHWKRGFDWFKHVDQDSSOLFDWLRQH[FHSWLRQ
&DQLWUHWKURZWKHDSSOLFDWLRQH[FHSWLRQWRWKH&RQWDLQHU"
+LQW ZKDWGRHVD&RQWDLQHUXVXDOO\GRZKHQLWJHWVDQDSSOLFDWLRQH[FHSWLRQIURPD
EHDQ":RXOGWKH&RQWDLQHUEHDEOHWRGRWKDWLQWKLVVFHQDULR"
$VHVVLRQEHDQXVLQJ&07KDVDPHWKRGPDUNHGZLWKWKH1RW6XSSRUWHGWUDQVDFWLRQ
DWWULEXWH:KLOHWKHPHWKRGLVUXQQLQJWKHEHDQFDOOVVHW5ROOEDFN2QO\ RQLWVFRQWH[W
:LOOWKLVFDXVHDQH[FHSWLRQ":KDWNLQG"
+LQW WKLQNDERXWZKDWVHW5ROOEDFN2QO\ GRHVDQGZKDWVWDWHWKHEHDQKDVWREHLQ
$PHVVDJHGULYHQEHDQLQWKHRQ0HVVDJH PHWKRGFDOOVJHW&DOOHU3ULQFLSDO :KDW
KDSSHQV"
+LQW ZKDW¶VJHW&DOOHU3ULQFLSDO XVHGIRU"'RHVWKDWPDNHVHQVHKHUH"
$VHVVLRQEHDQXVLQJ&07KDVDPHWKRGPDUNHGZLWKWKH0DQGDWRU\WUDQVDFWLRQ
DWWULEXWH7KHFOLHQWFDOOLQJWKHPHWKRGLVQRWLQDWUDQVDFWLRQ:KDWKDSSHQV"
+LQW 7KLQNDERXWWKHQDPHVRIWKHFRPPRQV\VWHPH[FHSWLRQV,VWKHUHRQHWKDW
PDNHVVHQVHKHUH"
$EHDQUHDOL]HVLWFDQ¶WFRPPLWDWUDQVDFWLRQEXWLWGRHVQ¶WZDQWWKHFOLHQWWRJHWDQ
H[FHSWLRQ:KDWFDQWKHEHDQGR"
$EHDQZDQWVWKHFOLHQWWRJHWDQDSSOLFDWLRQH[FHSWLRQEXWWKHEHDQVWLOOZDQWVWKH
WUDQVDFWLRQWRFRPPLW:KDWVKRXOGWKHEHDQGR"
&KDSWHU
H[FHSWLRQVLQ(-%
6KDUSHQ \RXU SHQFLO 0DWFKWKHVFHQDULRVZLWKWKHH[FHSWLRQ V WKDWPLJKW
RFFXUZLWKWKDWVFHQDULR'RQ¶WWXUQWKHSDJH7KH
DQVZHUVDUHMXVWDSDJHDZD\
6FHQDULRV 7UDQVDFWLRQV
$&07EHDQFDOOVFRQWH[WJHW8VHU7UDQVDFWLRQ ,OOHJDO6WDWH([FHSWLRQ
&OLHQWFDOOVUHPRYH RQDEHDQWKDW¶VDOUHDG\EHHQUHPRYHG (-%([FHSWLRQ
&OLHQWFDOOVUHPRYH RQDVWDWHIXOEHDQWKDWLVVWLOOLQDQRSHQ &UHDWH([FHSWLRQ
WUDQVDFWLRQ
5HPRYH([FHSWLRQ
$VHVVLRQEHDQFDOOVJHW3ULPDU\.H\ RQLWVFRQWH[W
2EMHFW1RW)RXQG([FHSWLRQ
$&07EHDQFDOOVJHW5ROOEDFN2QO\ IURPDPHWKRGPDUNHG
1RW6XSSRUWHG 1R6XFK2EMHFW([FHSWLRQ
&OLHQWFDOOVDPHWKRGRQD5HPRWH&07EHDQDQGWKH 5HPRWH([FHSWLRQ
PHWKRGLVPDUNHG0DQGDWRU\7KHFDOOHUGRHVQRWKDYHD
7UDQVDFWLRQ5HTXLUHG([FHSWLRQ
WUDQVDFWLRQFRQWH[WLQSODFHZKHQWKHFDOOFRPHVLQ
1RW6XSSRUWHG([FHSWLRQ
$PHVVDJHGULYHQEHDQFDOOVLV&DOOHU,Q5ROH RQLWVFRQWH[W
IURPZLWKLQWKHRQ0HVVDJH PHWKRG 5XQWLPH([FHSWLRQ
&OLHQWFDOOVWKHKRPHUHPRYHPHWKRGRQWKH/2&$/KRPH 1R6XFK2EMHFW/RFDO([FHSWLRQ
LQWHUIDFHRIDVHVVLRQEHDQ
'XSOLFDWH.H\([FHSWLRQ
$VWDWHOHVVVHVVLRQEHDQFDOOVJHW&DOOHU3ULQFLSDO RQLWV
FRQWH[WGXULQJWKHVHW6HVVLRQ&RQWH[WPHWKRG 6\VWHP([FHSWLRQ
&OLHQW)RRFDOOVDPHWKRGRQDUHPRWHVWDWHIXOEHDQZKLOH 1R6XFK(QWLW\([FHSWLRQ
WKDWVDPHEHDQLVDOUHDG\H[HFXWLQJDPHWKRGIRUFOLHQW%DU
&OLHQWFDOOVJHW3ULPDU\.H\ RQWKHORFDOFRPSRQHQWLQWHUIDFH
RIDVHVVLRQEHDQ
$PHVVDJHGULYHQEHDQFDWFKHVD1DPLQJ([FHSWLRQIURP
ZKLFKLWFDQ¶WUHFRYHU:KLFKH[FHSWLRQ LIDQ\ FDQWKHEHDQ
WKURZWRWHOOWKH&RQWDLQHU"
$VHVVLRQEHDQZDQWVWKH&RQWDLQHUWRNQRZWKDWWKH
WUDQVDFWLRQVKRXOGEHUROOHGEDFNDQGWKHEHDQVKRXOGEH
NLOOHG
&OLHQWFDOOV¿QG%\3ULPDU\.H\ ³´ ZKHUHWKHUHLVQRHQWLW\
ZLWKDSULPDU\NH\RI³´
$OWKRXJKWKHEHDQLV¿QHWKH&RQWDLQHUKDVDV\VWHP
H[FHSWLRQLWZDQWVWRWKURZWRDORFDOFOLHQW
\RXDUHKHUH
H[FHSWLRQVFHQDULRV
;KMVIZQW;]UUIZa
7UDQVDFWLRQ6FHQDULRV
$&07EHDQFDOOVFRQWH[WJHW8VHU7UDQVDFWLRQ
7KHEHDQJHWVDQ,OOHJDO6WDWH([FHSWLRQ 2QO\%07EHDQVFDQJHWD
8VHU7UDQVDFWLRQ
&OLHQWFDOOVUHPRYH RQDVWDWHIXOEHDQWKDWLVVWLOOLQDQRSHQ
WUDQVDFWLRQ
7KHFOLHQWJHWVD5HPRYH([FHSWLRQ<RXFDQ¶WUHPRYHDVWDWHIXOEHDQ
ZKLOHLWVLQDWUDQVDFWLRQ :KLFKLVMXVWRQHRIDJD]LOOLRQUHDVRQVZK\LW¶V
D%DG,GHDWROHDYHDWUDQVDFWLRQRSHQDFURVVPXOWLSOHFOLHQWLQYRFDWLRQV
,QRWKHUZRUGVLI\RXEHJLQD%07WUDQVDFWLRQLQDPHWKRG\RXVKRXOG
HQGLWLQWKDWPHWKRG
$&07EHDQFDOOVJHW5ROOEDFN2QO\ IURPDPHWKRGPDUNHG
1RW6XSSRUWHG
7KHEHDQJHWVDQ,OOHJDO6WDWH([FHSWLRQ<RXPXVWEHLQDWUDQVDFWLRQ
ZKHQ\RXFDOOJHW5ROOEDFN2QO\ RUVHW5ROOEDFN2QO\ 7KDWPHDQV\RX
FDQ¶WFDOOWKHPZLWKLQDPHWKRGPDUNHG1RW6XSSRUWHG1HYHURU6XSSRUWV
VHVVLRQDQGHQWLW\EHDQV RU1RW6XSSRUWHG PHVVDJHGULYHQEHDQV²
UHPHPEHUPHVVDJHGULYHQEHDQVFDQ¶WXVH1HYHURU6XSSRUWVEHFDXVH
WKH\GRQ¶WPDNHVHQVHJLYHQWKDWWUDQVDFWLRQVFDQQHYHUSURSDJDWHLQWRD
PHVVDJHGULYHQEHDQ
&OLHQWFDOOVDPHWKRGRQD5HPRWH&07EHDQDQGWKHPHWKRGLV
PDUNHG0DQGDWRU\7KHFDOOHUGRHVQRWKDYHDWUDQVDFWLRQFRQWH[WLQ
SODFHZKHQWKHFDOOFRPHVLQ
7KHFOLHQWJHWVD7UDQVDFWLRQ5HTXLUHG([FHSWLRQ DORFDOFOLHQWZRXOGJHW
7UDQVDFWLRQ5HTXLUHG/RFDO([FHSWLRQ
$VHVVLRQEHDQZDQWVWKH&RQWDLQHUWRNQRZWKDWWKHWUDQVDFWLRQ
VKRXOGEHUROOHGEDFNDQGWKHEHDQVKRXOGEHNLOOHG
7KHEHDQVKRXOGWKURZDQ(-%([FHSWLRQ7KH&RQWDLQHUWDNHVRYHU
DQGGRHVLWVQRUPDO&RQWDLQHUWKLQJIRUV\VWHPH[FHSWLRQV²UROOEDFN
WKHWUDQVDFWLRQORJWKHH[FHSWLRQNLOOWKHEHDQDQGWKURZD
5HPRWH([FHSWLRQWRD5HPRWHFOLHQWRUWKH(-%([FHSWLRQWRDORFDOFOLHQW
&KDSWHU
H[FHSWLRQVLQ(-%
;KMVIZQW;]UUIZa
&OLHQW6FHQDULRV
&OLHQWFDOOVUHPRYH RQDEHDQWKDW¶VDOUHDG\EHHQUHPRYHG
<RXPLJKWEHWHPSWHGWRVD\5HPRYH([FHSWLRQEXWWKDW¶VQRWLW5HPHPEHU
UHPRYH LVMXVWDQRWKHUPHWKRGLQWKHEHDQ¶VLQWHUIDFHDQGLI\RXFDOOLW
RQDUHPRYHGEHDQ\RX¶OOJHWWKHVDPHH[FHSWLRQ\RX¶GVHHLI\RXFDOOHG
DQ\RWKHUEXVLQHVVPHWKRGRQDUHPRYHGEHDQ²UHPRWHFOLHQWVJHW
5HPRWH([FHSWLRQDQGORFDOFOLHQWVJHW(-%([FHSWLRQ
&OLHQWFDOOVWKHKRPHUHPRYHPHWKRGRQWKH/2&$/KRPHLQWHUIDFHRI
DVHVVLRQEHDQ
7KHFOLHQWJHWVD5HPRYH([FHSWLRQ:K\"%HFDXVHWKHRQO\UHPRYH
PHWKRGLQDVHVVLRQEHDQ¶VORFDOKRPHLVWKHRQHWKDWWDNHVDSULPDU\NH\
DQGWKDWFDQQHYHUZRUN5HPRWHFOLHQWVZRXOGDOVRJHWD5HPRYH([FHSWLRQ
&OLHQW)RRFDOOVDPHWKRGRQDUHPRWHVWDWHIXOEHDQZKLOHWKDWVDPH
EHDQLVDOUHDG\H[HFXWLQJDPHWKRGIRUFOLHQW%DU
&OLHQW)RRJHWVD5HPRWH([FHSWLRQ LIFOLHQW)RRKDGEHHQORFDOKH¶GJHWDQ
(-%([FHSWLRQ $VHVVLRQEHDQKDQGOHRQO\RQHFOLHQWDWDWLPH
&OLHQWFDOOVJHW3ULPDU\.H\ RQWKHORFDOFRPSRQHQWLQWHUIDFHRID
VHVVLRQEHDQ
7KLVLVMXVWOLNHWKHRQHZKHUHWKHFOLHQWFDOOVUHPRYH RQDORFDOEHDQ¶V
KRPH7KHFOLHQWJHWVDQ(-%([FHSWLRQ LIWKHFOLHQWZHUHORFDOKH¶GJHWD
5HPRWH([FHSWLRQ 7KHSRLQWLV"6HVVLRQEHDQVGRQ¶WKDYHSULPDU\NH\V
$Q\PHWKRG\RXFDOOUHODWHGWRWKHSULPDU\NH\RIDEHDQZLOOIDLOLIWKDWEHDQ
LVDVHVVLRQEHDQ
&OLHQWFDOOV¿QG%\3ULPDU\.H\ ³´ ZKHUHWKHUHLVQRHQWLW\ZLWKD
SULPDU\NH\RI³´
7KHFOLHQWJHWVDQ2EMHFW1RW)RXQG([FHSWLRQDVXEFODVVRI)LQGHU([FHSWLRQ
$OWKRXJKWKHEHDQLV¿QHWKH&RQWDLQHUKDVDV\VWHPH[FHSWLRQLW
ZDQWVWRWKURZWRDORFDOFOLHQW
7KHFOLHQWJHWVDQ(-%([FHSWLRQ
\RXDUHKHUH
H[FHSWLRQVFHQDULRV
;KMVIZQW;]UUIZa
%HDQ6FHQDULRV
$VHVVLRQEHDQFDOOVJHW3ULPDU\.H\ RQLWVFRQWH[W
7KHEHDQJHWVDQ,OOHJDO6WDWH([FHSWLRQ<RXNQRZZK\6HVVLRQEHDQV
DQGSULPDU\NH\VGRQ¶WJRWRJHWKHU
$PHVVDJHGULYHQEHDQFDOOVLV&DOOHU,Q5ROH RQLWVFRQWH[WIURP
ZLWKLQWKHRQ0HVVDJH PHWKRG
7KLQNDERXWLW'RHVDPHVVDJHGULYHQEHDQKDYHDFDOOLQJFOLHQW ZH
GRQ¶WUHDOO\FRXQWWKH&RQWDLQHUDVDµFOLHQW¶DOWKRXJKLWLVFDOOLQJWKH
EHDQ¶VPHWKRGV ,IWKHUH¶VQRFOLHQWWKHQ:+26(VHFXULW\LQIRUPDWLRQ
ZRXOGWKHEHDQJHW"7KHEHDQJHWVDQ,OOHJDO6WDWH([FHSWLRQMXVWIRU
EHLQJFOXHOHVVHQRXJKWRHYHQWU\
$VWDWHOHVVVHVVLRQEHDQFDOOVJHW&DOOHU3ULQFLSDO RQLWVFRQWH[W
GXULQJWKHVHW6HVVLRQ&RQWH[WPHWKRG
7KHEHDQJHWVDQ,OOHJDO6WDWH([FHSWLRQEHFDXVHVHW6HVVLRQ&RQWH[W
LVWRRHDUO\LQWKHEHDQ¶VOLIHWRJHWFOLHQWLQIRUPDWLRQ,QIDFWD
VWDWHOHVVEHDQFDQJHWFOLHQWVHFXULW\LQIRUPDWLRQ21/<ZKLOHUXQQLQJ
DEXVLQHVVPHWKRGRIWKHFRPSRQHQWLQWHUIDFH$QGHYHQLIWKHEHDQ
ZHUHVWDWH)8/LWZRXOGVWLOOEHWRRHDUO\IRUFOLHQWLQIRUPDWLRQDOWKRXJK
DVWDWHIXOEHDQ EXWQRWVWDWHOHVV FRXOGFDOOJHW&DOOHU3ULQFLSDO DQG
LV&DOOHU,Q5ROH IURPZLWKLQHME&UHDWH
$PHVVDJHGULYHQEHDQFDWFKHVD1DPLQJ([FHSWLRQIURPZKLFK
LWFDQ¶WUHFRYHU:KLFKH[FHSWLRQ LIDQ\ FDQWKHEHDQWKURZWR
WHOOWKH&RQWDLQHU"
7KHEHDQVKRXOGWKURZDQ(-%([FHSWLRQ5HPHPEHUPHVVDJHGULYHQ
EHDQVGRQ¶WKDYHFOLHQWV7KH\GRQ¶WKDYHFOLHQWLQWHUIDFHV6RWKHUH¶V
QRSODFHWRGHFODUHDSSOLFDWLRQH[FHSWLRQV7KDWPHDQV\RXUEHDQ
FDQ¶WWKURZDQ\WKLQJEXWV\VWHPH[FHSWLRQV7KHRQO\H[FHSWLRQWKH
PHVVDJHGULYHQEHDQVKRXOGHYHUWKURZLV(-%([FHSWLRQ,WFDQQHYHU
WKURZDSSOLFDWLRQH[FHSWLRQVDQGLWVKRXOGOHWRWKHUV\VWHPH[FHSWLRQV
SURSDJDWHWRWKH&RQWDLQHU
&KDSWHU
H[FHSWLRQVLQ(-%
)LOOWKLVFKDUWLQWRGHVFULEHWKHGLIIHUHQFHVEHWZHHQ
UHPRWHDQGORFDOFOLHQWV<RX¶OOZDQWWRXVHWKLVDVD
FKHDWVKHHWEHIRUHWKHH[DPVRGRQ¶WVFUHZLWXS
([HUFLVH
Some things might be the same 5HPRWHFOLHQWV /RFDOFOLHQWV
for both remote and local
clients, but we arenÕt telling.
+RZV\VWHPH[FHSWLRQVLQWKH
EHDQDUHGHOLYHUHGWRWKHFOLHQW
7KHH[FHSWLRQIRUZKHQWKHFOLHQW
FDOOVDPHWKRGRQDEHDQWKDW·V
EHHQUHPRYHG
7KHH[FHSWLRQIRUZKHQ
WKHFOLHQWFDOOVDPHWKRG
PDUNHG0DQGDWRU\ZLWKRXWD
WUDQVDFWLRQFRQWH[WLQSODFH
7KHH[FHSWLRQIRUZKHQWKHFOLHQW
VWDUWVDWUDQVDFWLRQDQGWKH
&RQWDLQHUKDVWRUROOLWEDFN
7KHH[FHSWLRQIRUZKHQWKH
FOLHQWFDOOVJHW3ULPDU\.H\ RQ
WKHFRPSRQHQWLQWHUIDFHRID
VHVVLRQEHDQ
7KHH[FHSWLRQIRUZKHQWKHFOLHQW
FDOOVDPHWKRGLQDVHVVLRQEHDQ
DQGWKHEHDQLVDOUHDG\H[HFXWLQJ
DPHWKRGIRUDQRWKHUFOLHQW
7KHH[FHSWLRQIRUZKHQWKHFOLHQW
FDOOVDUHPRYH PHWKRGRQD
VWDWHIXOVHVVLRQEHDQWKDW·VVWLOOLQD
WUDQVDFWLRQ
\RXDUHKHUH
H[FHSWLRQH[HUFLVH
'HMDYX"<HV\RX¶YHVHHQWKLV1HDUWKHEHJLQQLQJRI
WKLVFKDSWHU([FHSWLWZDVDOO¿OOHGLQ1RZLW¶V\RXUWXUQ
%RQXVSRLQWVLI\RXXVHGUDZLQJVDORQJZLWK\RXUZRUGV
([HUFLVH
$SSOLFDWLRQ([FHSWLRQV 6\VWHP([FHSWLRQV
&OLHQWUHFRYHU\
7UDQVDFWLRQVWDWXV
%HDQLQVWDQFH
/RJJLQJ
([DPSOHV
&RPSLOHUFKHFNLQJ
DQGRWKHUUXOHV
&KDSWHU
H[FHSWLRQVLQ(-%
0RFN([DP
7HAT IS TRUE WHEN AN ENTITY BEANS CLIENT RECEIVES A JAVAXEJB%*"%XCEPTION
1 #HOOSE ALL THAT APPLY
R! 4HE CLIENT MUST BE REMOTE
R" 4HE CLIENT MUST BE LOCAL
R# ! CLIENT WILL NEVER RECEIVE THIS EXCEPTION
R$ 4HE CLIENT MUST HANDLE OR DECLARE THIS EXCEPTION
R% 4HIS EXCEPTION CAN ONLY OCCUR IF THE CLIENT IS IN A TRANSACTION
7HICH SCENARIO WILL CAUSE A JAVARMI.O3UCH/BJECT%XCEPTION TO BE THROWN
2 #HOOSE ALL THAT APPLY
R! ! REMOTE CLIENT INVOKES A METHOD ON A STATEFUL SESSION BEAN WHICH HAS
BEEN REMOVED
R" ! REMOTE CLIENT INVOKES A METHOD ON AN ENTITY BEAN WHICH HAS BEEN
REMOVED
R# ! REMOTE CLIENT INVOKES A lNDER METHOD WITH INVALID ARGUMENTS
R$ 4HE CONTAINER INVOKES AN EJB0ASSIVATE METHOD ON A BEAN THAT IS NOT
READY TO BE SERIALIZED
7HICH IS A SUBCLASS OF JAVALANG2UNTIME%XCEPTION #HOOSE ALL THAT APPLY
3
R! MDYD[HME(-%([FHSWLRQ
R" MDYD[HME5HPRYH([FHSWLRQ
R# MDYD[HME&UHDWH([FHSWLRQ
R$ MDYD[HME1R6XFK(QWLW\([FHSWLRQ
R% MDYDUPL5HPRWH([FHSWLRQ
R& MDYD[HME2EMHFW1RW)RXQG([FHSWLRQ
R' MDYDUPL1R6XFK2EMHFW([FHSWLRQ
\RXDUHKHUH
FRIIHHFUDPPRFNH[DP
7HICH OF THE FOLLOWING ARE %*" SPECIlCATION GUIDELINES REGARDING SYSTEM
4 EXCEPTIONS #HOOSE ALL THAT APPLY
R! "EAN METHODS SHOULD CATCH 2UNTIME%XCEPTION EXCEPTIONS
R" "EAN METHODS SHOULD WRAP UNRECOVERABLE CHECKED EXCEPTIONS IN A
MDYD[HME(-%([FHSWLRQ EXCEPTION
R# &OR REMOTE CLIENTS BEAN METHODS SHOULD WRAP UNRECOVERABLE CHECKED
EXCEPTIONS IN A MDYDUPL5HPRWH([FHSWLRQ
R$ )F A #-4 BEAN THROWS A SYSTEM EXCEPTION THE TRANSACTION WILL STILL
COMMIT UNLESS THE BEAN INVOKES VHW5ROOEDFN2QO\
)F A BUSINESS METHOD OF A #-4 DEMARCATED BEAN THROWS A SYSTEM EXCEPTION IN
5 WHICH CASE WILL THE CONTAINER ALWAYS THROW A
MDYD[WUDQVDFWLRQ7UDQVDFWLRQ5ROOHGEDFN([FHSWLRQ #HOOSE ALL
THAT APPLY
R! )F THE METHODS TRANSACTION ATTRIBUTE IS MARKED @2EQUIRES.EW
R" )F THE METHODS TRANSACTION ATTRIBUTE IS MARKED @-ANDATORY
R# )F THE METHODS TRANSACTION ATTRIBUTE IS MARKED @.EVER
R$ )F THE METHODS TRANSACTION ATTRIBUTE IS MARKED @.OT3UPPORTED
7HICH IS A SUBCLASS OF JAVAXEJB&INDER%XCEPTION #HOOSE ALL THAT APPLY
6
R! #REATE%XCEPTION
R" .O3UCH%NTITY%XCEPTION
R# 2EMOVE%XCEPTION
R$ $UPLICATE+EY%XCEPTION
R% /BJECT.OT&OUND%XCEPTION
&ROM WHICH METHODS CAN -$"S WITH #-4 DEMARCATION THROW APPLICATION
7 EXCEPTIONS #HOOSE ALL THAT APPLY
R! RQ0HVVDJH
R" HME&UHDWH
R# HME5HPRYH
R$ JHW8VHU7UDQVDFWLRQ
R% VHW0HVVDJH'ULYHQ&RQWH[W
R& NONE OF THE ABOVE
&KDSWHU
H[FHSWLRQVLQ(-%
7HATS TRUE FOR A LOCAL CLIENT THAT RECEIVES AN EXCEPTION FROM AN %*"
8 INVOCATION #HOOSE ALL THAT APPLY
R! 4HE EXCEPTION MIGHT BE FROM THE JAVARMI PACKAGE
R" 4HE EXCEPTION MIGHT BE AN APPLICATION EXCEPTION
R# 4HE EXCEPTION MIGHT BE A SYSTEM EXCEPTION
R$ .ONE OF THE ABOVE
7HICH ACTIONS WILL THE CONTAINER TAKE IF A MESSAGE DRIVEN BEAN WITH "-4
9 DEMARCATION THROWS A SYSTEM EXCEPTION #HOOSE ALL THAT APPLY
R! ,OG THE EXCEPTION
R" $ISCARD THE INSTANCE
R# -ARK THE TRANSACTION FOR ROLLBACK
R$ #OMMIT THE TRANSACTION UNLESS THE BEAN HAS INVOKED
VHW5ROOEDFN2QO\
R% .ONE OF THE ABOVE
&ROM WHICH TYPES OF BEANS CAN CLIENTS RECEIVE SYSTEM EXCEPTIONS #HOOSE ALL
10 THAT APPLY
R! 3ESSION BEANS WITH #-4 DEMARCATION
R" 3ESSION BEANS WITH "-4 DEMARCATION
R# -ESSAGE
DRIVEN BEANS WITH #-4 DEMARCATION
R$ -ESSAGE
DRIVEN BEANS WITH "-4 DEMARCATION
R% %NTITY BEANS WITH #-4 DEMARCATION
\RXDUHKHUH
PRFNH[DPDQVZHUV
0RFN([DP$QVZHUV
(spec: 374)
7HAT IS TRUE WHEN AN ENTITY BEANS CLIENT RECEIVES A JAVAXEJB%*"%XCEPTION
1 #HOOSE ALL THAT APPLY
R! 4HE CLIENT MUST BE REMOTE - Remote clients get RemoteException
R" 4HE CLIENT MUST BE LOCAL
R# ! CLIENT WILL NEVER RECEIVE THIS EXCEPTION
R$ 4HE CLIENT MUST HANDLE OR DECLARE THIS EXCEPTION
R% 4HIS EXCEPTION CAN ONLY OCCUR IF THE CLIENT IS IN A TRANSACTION
(spec: 374)
7HICH SCENARIO WILL CAUSE A JAVARMI.O3UCH/BJECT%XCEPTION TO BE THROWN
2 #HOOSE ALL THAT APPLY
R! ! REMOTE CLIENT INVOKES A METHOD ON A STATEFUL SESSION BEAN WHICH HAS
BEEN REMOVED
R" ! REMOTE CLIENT INVOKES A METHOD ON AN ENTITY BEAN WHICH HAS BEEN
REMOVED - client gets
R# ! REMOTE CLIENT INVOKES A lNDER METHOD WITH INVALID ARGUMENTS FinderException or
ObjectNotFoundException
R$ 4HE CONTAINER INVOKES AN EJB0ASSIVATE METHOD ON A BEAN THAT IS NOT (subclass of
READY TO BE SERIALIZED FinderException)
7HICH IS A SUBCLASS OF JAVALANG2UNTIME%XCEPTION #HOOSE ALL THAT APPLY
3
R! MDYD[HME(-%([FHSWLRQ
R" MDYD[HME5HPRYH([FHSWLRQ
R# MDYD[HME&UHDWH([FHSWLRQ (API docs)
R$ MDYD[HME1R6XFK(QWLW\([FHSWLRQ
R% MDYDUPL5HPRWH([FHSWLRQ
R& MDYD[HME2EMHFW1RW)RXQG([FHSWLRQ
R' MDYDUPL1R6XFK2EMHFW([FHSWLRQ
&KDSWHU
H[FHSWLRQVLQ(-%
)
7HICH OF THE FOLLOWING ARE %*" SPECIlCATION GUIDELINES REGARDING SYSTEM (spec: 373-374
4 EXCEPTIONS #HOOSE ALL THAT APPLY
R! "EAN METHODS SHOULD CATCH 2UNTIME%XCEPTION EXCEPTIONS
R" "EAN METHODS SHOULD WRAP UNRECOVERABLE CHECKED EXCEPTIONS IN A
MDYD[HME(-%([FHSWLRQ EXCEPTION
No, the Container
R# &OR REMOTE CLIENTS BEAN METHODS SHOULD WRAP UNRECOVERABLE CHECKED will do this
EXCEPTIONS IN A MDYDUPL5HPRWH([FHSWLRQ
R$ )F A #-4 BEAN THROWS A SYSTEM EXCEPTION THE TRANSACTION WILL STILL - system exceptions always
COMMIT UNLESS THE BEAN INVOKES VHW5ROOEDFN2QO\ cause a tx rollback
5 )F A BUSINESS METHOD OF A #-4 DEMARCATED BEAN THROWS A SYSTEM EXCEPTION IN (spec: 375-376)
WHICH CASE WILL THE CONTAINER ALWAYS THROW A
MDYD[WUDQVDFWLRQ7UDQVDFWLRQ5ROOHGEDFN([FHSWLRQ #HOOSE ALL
THAT APPLY
The others are wrong because
R! )F THE METHODS TRANSACTION ATTRIBUTE IS MARKED @2EQUIRES.EW they indicate that the callerÕs tx
was not the active tx when the
R" )F THE METHODS TRANSACTION ATTRIBUTE IS MARKED @-ANDATORY exception occurred. ThereÕs no
R# )F THE METHODS TRANSACTION ATTRIBUTE IS MARKED @.EVER need to tell a caller (through an
exception) unless itÕs the callerÕs
R$ )F THE METHODS TRANSACTION ATTRIBUTE IS MARKED @.OT3UPPORTED transaction that is rolled back!
)
7HICH IS A SUBCLASS OF JAVAXEJB&INDER%XCEPTION #HOOSE ALL THAT APPLY (spec: 263-264
6
R! #REATE%XCEPTION
R" .O3UCH%NTITY%XCEPTION
R# 2EMOVE%XCEPTION
R$ $UPLICATE+EY%XCEPTION - subclass of CreateException
R% /BJECT.OT&OUND%XCEPTION
(spec: 377)
&ROM WHICH METHODS CAN -$"S WITH #-4 DEMARCATION THROW APPLICATION
7 EXCEPTIONS #HOOSE ALL THAT APPLY
R! RQ0HVVDJH - MDBs cannot declare / throw any
R" HME&UHDWH application exceptions... who would catch
them? thereÕs no client.
R# HME5HPRYH
R$ JHW8VHU7UDQVDFWLRQ
R% VHW0HVVDJH'ULYHQ&RQWH[W
R& NONE OF THE ABOVE
\RXDUHKHUH
PRFNH[DPDQVZHUV
8 7HATS TRUE FOR A LOCAL CLIENT THAT RECEIVES AN EXCEPTION FROM AN %*" (spec: 381-382)
INVOCATION #HOOSE ALL THAT APPLY
R! 4HE EXCEPTION MIGHT BE FROM THE JAVARMI PACKAGE
R" 4HE EXCEPTION MIGHT BE AN APPLICATION EXCEPTION
R# 4HE EXCEPTION MIGHT BE A SYSTEM EXCEPTION
R$ .ONE OF THE ABOVE
7HICH ACTIONS WILL THE CONTAINER TAKE IF A MESSAGE DRIVEN BEAN WITH "-4 (spec: 378)
9 DEMARCATION THROWS A SYSTEM EXCEPTION #HOOSE ALL THAT APPLY
R! ,OG THE EXCEPTION
R" $ISCARD THE INSTANCE
R# -ARK THE TRANSACTION FOR ROLLBACK
R$ #OMMIT THE TRANSACTION UNLESS THE BEAN HAS INVOKED
VHW5ROOEDFN2QO\
R% .ONE OF THE ABOVE
&ROM WHICH TYPES OF BEANS CAN CLIENTS RECEIVE SYSTEM EXCEPTIONS #HOOSE ALL (spec: 377)
10 THAT APPLY
R! 3ESSION BEANS WITH #-4 DEMARCATION
R" 3ESSION BEANS WITH "-4 DEMARCATION
R# -ESSAGE DRIVEN BEANS WITH #-4 DEMARCATION
- MDBs have no clients!
R$ -ESSAGE DRIVEN BEANS WITH "-4 DEMARCATION
R% %NTITY BEANS WITH #-4 DEMARCATION
&KDSWHU
security in EJB
5
4
4 3URWHFW<RXU6HFUHWV
QR ZD\<RXFDQ·W
OHW6XVLHKHDUWKLV,EHWWHU
SXWVRPHPHWKRGSHUPLVVLRQVLQ
P\''WRVWRSKHUIURPFDOOLQJ
/HW·VSXWKHULQWKH¶FU\EDE\·
VHFXULW\UROH
.HHS\RXUVHFUHWV6HFXULW\LVDERXWDXWKHQWLFDWLRQDQGDXWKRUL]DWLRQ)LUVW
\RXKDYHWRSURYH\RXULGHQWLW\DQGWKHQZH¶OOWHOO\RXZKDW\RX¶UHDOORZHGWRGR6HFXULW\
LVHDV\LQ(-%EHFDXVH\RX¶UHRQO\GHDOLQJZLWKDXWKRUL]DWLRQ<RXGHFLGHZKRJHWVWR
FDOOZKLFKPHWKRGVRQ\RXUEHDQV([FHSWRQHSUREOHPLI\RX¶UHD%HDQ3URYLGHURU
$SS$VVHPEOHU\RXSUREDEO\GRQ¶WNQRZZKRWKHXVHUVDUHJRLQJWREH6R\RXPDNH
VWXIIXS<RXPDNHXSUROHVOLNHMREWLWOHVLQFOXGLQJ0DQDJHU6XSHUYLVRU$GPLQHWFDQG
ZKHQVRPHRQHGHSOR\V\RXUDSSOLFDWLRQLQDUHDOFRPSDQ\WKDW'HSOR\HUPDSVEHWZHHQ
\RXUPDGHXSQDPHV 0DQDJHU DQGUHDOSHRSOHZKRZLOOXVHWKHDSS
WKLVLVDQHZFKDSWHU
H[DPREMHFWLYHV
6HFXULW\
2IILFLDO :KDWLWUHDOO\PHDQV
,GHQWLI\FRUUHFWDQGLQFRUUHFWVWDWHPHQWV <RXKDYHWRNQRZWKDW\RXFDQGRWZRNLQGVRI
DERXWWKH(-%VXSSRUWIRUVHFXULW\ VHFXULW\LQ(-% SURJUDPPDWLFDQGGHFODUDWLYH
PDQDJHPHQWLQFOXGLQJVHFXULW\UROHV 'HFODUDWLYHPHDQV\RXUVHFXULW\LVGH¿QHGLQWKH
VHFXULW\UROHUHIHUHQFHVDQGPHWKRG 'HSOR\PHQW'HVFULSWRU<RXQHHGWRNQRZWKDW
SHUPLVVLRQV VHFXULW\LQ(-%LVPRVWO\DERXWGHFODULQJDVHWRI
DEVWUDFWVHFXULW\UROHVWKHQGHFODULQJZKLFKPHWKRGV
HDFKRIWKRVHUROHVLVDOORZHGWRFDOO
)URPDOLVWRIUHVSRQVLELOLWLHVLGHQWLI\ 3D\FORVHDWWHQWLRQWRWKLVLQWKHFKDSWHU<RXQHHGWR
ZKLFKEHORQJWRWKH$SSOLFDWLRQ$VVHPEOHU WKLQNDERXWWKHZKROHSURFHVVLQDFRPSRQHQWEDVHG
%HDQ3URYLGHU'HSOR\HU&RQWDLQHU GHYHORSPHQWZD\WRNQRZZKRLVUHVSRQVLEOHIRU
3URYLGHURU6\VWHP$GPLQLVWUDWRU ZKDW<RXQHHGWRNQRZWKDWWKH%HDQ3URYLGHUXVX
DOO\ZRQ¶WKDYHDQ\VHFXULW\UHVSRQVLELOLWLHVEXWWKDW
LIKHGRHVXVHWKHLV&DOOHU,Q5ROH PHWKRGWKHQKH
PXVWWHOOWKH$SS$VVHPEOHUZKDWQDPHKHKDUGFRG
HGLQDVWKHDUJXPHQWWRWKHLV&DOOHU,Q5ROH PHWKRG
E\SXWWLQJDVHFXULW\UROHUHIHUHQFHLQWKH''<RX
PXVWNQRZWKDWWKH$SS$VVHPEOHU¶VMRELVWRGH¿QH
VHFXULW\UROHVPHWKRGSHUPLVVLRQVDQGUROHOLQNV
PDSSLQJIURPWKHSURJUDPPHU¶VPDGHXSUROHUHIHU
HQFHVDQGWKH$SS$VVHPEOHU¶VUHDOVHFXULW\UROHV)L
QDOO\\RXPXVWNQRZWKDWWKH'HSOR\HULVUHVSRQVLEOH
IRUPDSSLQJ LQDYHQGRUVSHFL¿FZD\ EHWZHHQUHDO
XVHUVDQGJURXSVDQGWKH$SS$VVHPEOHU¶VDEVWUDFW
VHFXULW\UROHVDQGWKDWWKLVLVGRQHXVLQJ&RQWDLQHU
WRROVRUSURSHUW\¿OHV
*LYHQDFRGHOLVWLQJGHWHUPLQHZKHWKHU <RXKDYHWRNQRZHYHU\WKLQJDERXWWKH''WDJVUH
LWLVDOHJDODQGRUDSSURSULDWHZD\WR ODWHGWRVHFXULW\LQFOXGLQJWKDWVHFXULW\UROHUHIHUHQFHV
SURJUDPPDWLFDOO\DFFHVVDFDOOHU¶V DQGUROHOLQNVDUHLQWKH HQWHUSULVHEHDQ!VHFWLRQ
VHFXULW\FRQWH[W EXWVHFXULW\UROHVDQGPHWKRGSHUPLVVLRQVDUHLQWKH
*LYHQDVHFXULW\UHODWHGGHSOR\PHQW DSSOLFDWLRQDVVHPEO\!SDUW<RXPXVWNQRZKRZWKH
GHVFULSWRUWDJLGHQWLI\FRUUHFWDQG VHFXULW\LGHQWLW\!WDJLVXVHGDQGWKDWPHVVDJHGULY
LQFRUUHFWVWDWHPHQWVDQGRUFRGHUHODWHG HQEHDQVPXVWQHYHU XVHFDOOHULGHQWLW\!<RXQHHG
WRWKDWWDJ WRNQRZWKDWWKHWZRSURJUDPPDWLFVHFXULW\PHWKRGV
DUHFDOOHGRQDVHVVLRQRUHQWLW\EHDQ¶VFRQWH[W
&KDSWHU
VHFXULW\LQ(-%
1UIOQVMaW]¼ZM_ZQ\QVOIXIaZWTTIXXTQKI\QWV
7KLVZLOOEHZLWKRXWDGRXEW
WKHEHVWSD\UROOSURJUDPHYHU
ZULWWHQ,·PJRQQD58/(WKH
session bean to
pay information update e entity
,7GHSDUWPHQWZKHQWKH\VHHWKLV
DSS(YHQ,DPVWLOODVWRQLVKHGE\ employe
P\VXSHULRUFRGLQJVNLOOV
&KDQJH3D\ (PSOR\HH
VHW6DODU\
JHW1DPH
JLYH%RQXV
VHW1DPH
UHLQEXUVH
JHW6DODU\
DGMXVW3D\
VHW6DODU\
JHW(PSOR\HH,'
JLYH%RQXV
PRUH
:HOOZHOOZKDWGRZHKDYHKHUH"
6RPHERG\IRUJRWWRSURWHFWWKH&KDQJH3D\
PHWKRGV,WKLQN,·OOMXVWJLYHP\VHOIDOLWWOHVDODU\
DGMXVWPHQW7KH\GRQ·WSD\PHKDOIRIZKDW,·PZRUWK
DQ\ZD\EXWZKDWHYHUWKH\·UHSD\LQJ%LOOWKHJX\
ZKRGHYHORSHGWKLVDSSLW·VZDDDDD\WRRPXFK
+HGLGQ·WHYHQWKLQNDERXWVHFXULW\
\RXDUHKHUH
(-%VHFXULW\
?PI\KIVaW]LW'
7HO REALLY IS RESPONSIBLE FOR MAKING THE PROGRAM SECURE (OW DOES IT HAPPEN
4HERES GOOD NEWS AND BAD NEWS WITH %*" SECURITY
6HFXULW\LQ(-%LVHDV\,W·VDERXW$87+25,=$7,21
0RVWRIWKHWLPH\RXGRQ·WSXWDQ\VHFXULW\UHODWHGFRGHLQWR\RXUEHDQFODVVHV
,QIDFWWKH%HDQ3URYLGHUGRHVQRWHYHQWKLQNDERXWVHFXULW\H[FHSWLQYHU\VSHFLDO
FDVHVZH·OOORRNDWLQWKHODVWSDUWRIWKLVFKDSWHU
6HFXULW\LQ(-%LVDERXWVD\LQJ:+2FDQFDOO:+$7<RXFDQUHVWULFWDFFHVVIRUHDFK
LQGLYLGXDOPHWKRGLQ\RXUDSSOLFDWLRQWRRQO\WKRVHLQGLYLGXDOVWKDWDUHLQDSULYLOHJHG
¶UROH· 'LUHFWRU3D\UROO$GPLQ3D\UROO$VVLVWDQWHWF
7KH(-%SDUWRIWKHVHFXULW\³WKHSDUWWKDWVSHFLILHVWKHUROHVDQGWKHPHWKRGVWKRVHUROHV
FDQDFFHVV³LVGRQHGHFODUDWLYHO\LQWKHGHSOR\PHQWGHVFULSWRUXVLQJVLPSOH;0/WDJV
$WWKH(-%OHYHOLWUHDOO\LVDVVLPSOHDVVD\LQJ´7KHVHW6DODU\ PHWKRGFDQEH
DFFHVVHGE\21/<'LUHFWRUVDQG3D\UROO$GPLQLVWUDWRUVµ
6HFXULW\LQ(-%LVDEVWUDFW,W·V127DERXW$87+(17,&$7,21
7KH(-%VSHFPDNHVLWYHU\HDV\WRGHILQHUROHVDQGWRDVVLJQUROHVWRPHWKRGVLQRUGHUWR
FRQWURODFFHVVWRWKHPHWKRGV%XWWKHVSHFVD\V127+,1*DERXWKRZWKHV\VWHPZLOO.12:
ZKLFKUHDOKXPDQEHLQJVEHORQJWRWKRVHUROHV6RPHZKHUHRXWVLGHRIWKH(-%GHSOR\PHQW
GHVFULSWRU DQGRXWVLGHWKHVSHFLILFDWLRQ \RXVWLOOKDYHWRVD\WKDW-DFN2·%U\DQLVLQWKH'LUHFWRU
UROH DQGSUREDEO\RWKHUUROHVDVZHOO 2UVD\WKDWDOO3D\UROO0DQDJHUVLQFRPSDQ\;<=DUH
TXDOLILHGWREHLQWKHUROHRIZKDWWKHDSSOLFDWLRQKDVODEHOHG3D\UROO$GPLQ
7KHVSHFDOVRGRHVQRWGHILQHKRZDUHDOKXPDQEHLQJFDQEHDXWKHQWLFDWHGWRWKHV\VWHP
,QRWKHUZRUGVWKHUH·VQRWKLQJLQ(-%DERXWKRZ\RXZLOONQRZWKDWVD\WKHSHUVRQORJJLQJLQDV
-DFN2·%U\DQUHDOO\LV-DFN2·%U\DQ7KLVPLJKWKDSSHQLQDYDULHW\RIZD\VDOWKRXJKRQHW\SLFDO
RSWLRQLVWRKDYHFOLHQWVDXWKHQWLFDWHWKURXJKWKHZHEWLHU WKH\ORJLQXVLQJDEURZVHU RID-((
IULHQGO\ZHEVHUYHU
7KHVHFXULW\LQWKHUHDORSHUDWLQJHQYLURQPHQW³WKHFRPSDQ\UXQQLQJWKHDSSOLFDWLRQ³PXVWKDYH
DVHFXULW\VWUXFWXUHLQSODFHDQGLQDIRUPDWWKDW\RXUVSHFLILF(-%VHUYHUFDQKRRNLQWR2UDW
WKHYHU\OHDVW\RXQHHGDVHUYHUWKDWOHWV\RXVSHFLILFDOO\FRQILJXUHDVHFXULW\UHDOP(YHQLILW·V
QRWKLQJPRUHWKDQDOLVWRIQDPHVSDVVZRUGVDQGWKH¶UROHV·WKRVHQDPHVEHORQJWR\RXVWLOO
QHHGVRPHLQIUDVWUXFWXUHRXWVLGHRI(-%
&KDSWHU
VHFXULW\LQ(-%
0W_\WLW[MK]ZQ\aQV-2*
0\ MRE LV PRUH LQYROYHG,GHFLGH
0\MRELVHDV\0RVWRI
ZKLFKUROHVPDNHVHQVHLQWKHDSSOLFDWLRQ
WKHWLPH,GRQ·WHYHQKDYHWR )RU%LOO·VSD\UROOEHDQV SOXV,DGGHG
WKLQNDERXWVHFXULW\ZKHQ,·PZULWLQJD VRPHRIP\RZQEHDQVWRPDNHWKHFRPSOHWH
EHDQ$QGWKDW·VJRRGEHFDXVHP\ DSS ,FKRVH3D\UROO$GPLQ3D\UROO$VVLVWDQW
SKLORVRSK\LV´6HFXULW\LVKDUG DQG3D\UROO'LUHFWRUDVWKHUROHV7KHQ,VHW
GRQ·WGRLWµ XSPHWKRGSHUPLVVLRQVLQWKH''WRVD\
ZKLFKUROHVFDQFDOOZKLFKPHWKRGV
$QQLHWKH
$SSOLFDWLRQ
$VVHPEOHU
%LOOWKH%HDQ
3URYLGHU
$QQLHFDQVHWXSDVPDQ\UROHVDVVKH
ZDQWVEXWXQOHVV,PDSUHDOSHRSOHRUJURXSV
LQWRWKRVHUROHVLWZRQ·WPDWWHUEHFDXVH
12%2'<ZLOOEHDEOHWRFDOOWKRVHPHWKRGV,
KDYHWRFRQÀJXUHWKHVHUYHUWRXVHWKHUHDOXVHUVDQG
JURXSVLQRXULQWHUQDOHPSOR\HHV\VWHPDQG,KDYHWR
PDSEHWZHHQRXUJURXSVDQG$QQLH·VUROHV6ROHW·V
VHH,·OOPDNHRXU3D\UROO0DQDJHUVJURXSPDS
WRZKDW$QQLHFDOOHG´3D\UROO$GPLQµ
'LFNWKH
'HSOR\HU
\RXDUHKHUH
WKH$SS$VVHPEOHUDQGVHFXULW\
<PM)XXTQKI\QWV)[[MUJTMZ¼[RWJ"IKKM[[KWV\ZWT
4HE !PP !SSEMBLER KNOWS THE APPLICATION 3HE KNOWS WHAT THE METHODS DO
AND HOW THEYRE SUPPOSED TO BE USED 4HE !PP !SSEMBLER KNOWS THE ABSTRACT
ROLES THAT MAKE SENSE LOGICALLY FOR THIS APPLICATION &OR EXAMPLE SHE KNOWS
THAT THERES NO NEED FOR A -ARKETING ROLE IN THE PAYROLL APPLICATION "UT SHE
KNOWS THAT THERE SHOULD BE A LEAST THREE LEVELS OF ACCESS FOR THE APP
0EOPLE WHO HAVE FULL CONTROL AND CAN BOTH VIEW AND CHANGE AN EMPLOYEES PAYROLL DATA
0EOPLE WHO CAN READ EVERYTHING AND MODIFY SOME THINGS
0EOPLE WHO CAN READ SOME THINGS BUT CANT MODIFY ANYTHING
3O HER JOB IS BROKEN INTO TWO PARTS
'HÀQHWKHUROHV
)LJXUHRXWZKLFKUROHVPDNHVVHQVHLQWKHDSSOLFDWLRQDQGFRPHXSZLWKQDPHVIRUWKHVHUROHV
6LQFHWKH$SS$VVHPEOHUPLJKWQRWEHZRUNLQJLQWKHUHDOHQYLURQPHQWZKHUHWKHDSSOLFDWLRQZLOO
UXQVKH·VMXVWPDNLQJXSDEVWUDFWQDPHV,QRWKHUZRUGVKHUQDPHVGRQ·WKDYHWRFRUUHVSRQG
WRDQ\WKLQJLQWKHUHDOZRUOG)RUDOOZHFDUHVKHFRXOGQDPHWKHWKUHHUROHV&ORZQ0LPHDQG
-XJJOHU$VORQJDVVKHFDQGHVFULEHWKHPZHOOHQRXJKIRUWKHGHSOR\HUWRILJXUHRXWZKLFKUHDO
SHRSOHEHORQJWRWKRVHUROHVLWGRHVQ·WPDWWHUWKDWWKHQDPHVDUHPDGHXS
,QWKHGHSOR\PHQWGHVFULSWRUGHILQHD VHFXULW\UROH!HOHPHQWIRUHDFKUROHLQWKH
DSSOLFDWLRQ
,QWKHGHSOR\PHQWGHVFULSWRUXVHWKH UROHQDPH!HOHPHQWWRGHILQHWKHPDGHXSQDPHIRU
WKLVUROH
$VVLJQPHWKRGSHUPLVVLRQV
)LJXUHRXWWKHPHWKRGVIURPWKHFOLHQWYLHZWRZKLFKHDFKRIWKHUROHVVKRXOGKDYHDFFHVV
5HPHPEHUWKHFOLHQWYLHZLQFOXGHVQRWRQO\WKHPHWKRGVWKH%HDQ3URYLGHUGHFODUHGLQWKH
KRPHDQGFRPSRQHQWLQWHUIDFHRIWKHEHDQEXWDOVRWKHPHWKRGVRIWKHVXSHULQWHUIDFHV
(-%2EMHFW(-%+RPHRU(-%/RFDO2EMHFWDQG(-%/RFDO+RPH
,QWKHGHSOR\PHQWGHVFULSWRUGHILQHD PHWKRGSHUPLVVLRQ!HOHPHQWWKDWOLVWVRQHRU
PRUHVHFXULW\UROHVDQGRQHRUPRUHPHWKRGV
,IVKHFKRRVHVWKH$SS$VVHPEOHUFDQFDQXVHWKH XQFKHFNHG!HOHPHQWWRLQGLFDWHWKDW
DSDUWLFXODUPHWKRGGRHVQ·WUHTXLUHDQ\DXWKRUL]DWLRQ LQRWKHUZRUGVDQ\ERG\FDQFDOOLW
,IVKHFKRRVHVVKHFDQXVHWKH H[FOXGHOLVW!HOHPHQWWRGHILQHDOLVWRIPHWKRGVWKDW
QRERG\FDQFDOOHYHU,QRWKHUZRUGVQRUROHZLOOEHDEOHWRFDOOWKHPHWKRGVRQWKHH[FOXGHOLVW
&KDSWHU
VHFXULW\LQ(-%
WKHUH DUH QR 6KDUSHQ \RXU SHQFLO
'XPE 4XHVWLRQV
Q: 9OU MENTION AN EXCLUDE LIST /RRNDWWKHIROORZLQJDSSOLFDWLRQVDQGWU\WR
)F NOBODY WILL BE ALLOWED TO CALL THE FRPHXSZLWKVHFXULW\UROHVWKDWPLJKWPDNH
METHOD THEN WHY IS THE METHOD VHQVHIRUWKHVHDSSOLFDWLRQV/DWHUZH¶OO¿JXUH
THERE RXWZKLFKPHWKRGVHDFKRIWKHUROHVVKRXOGEH
DOORZHGWRFDOO
A: 2EMEMBER BEANS ARE REUSABLE
COMPONENTS MEANT TO BE ASSEMBLED
IN MULTIPLE APPLICATIONS ! METHOD $QLQYHQWRU\V\VWHPIRUDQRQOLQHVWRUHNHHSV
THAT MAKES SENSE IN ONE APPLICATION WUDFNRISURGXFWVVROGDQGVKLSSHGLQYHQWRU\
MIGHT NOT MAKE SENSE IN ANOTHER &OR OHYHOVDQGSULFHV
EXAMPLE A 0RODUCT)NVENTORY BEAN
THAT REPRESENTS PRODUCTS IN A DATABASE
MIGHT HAVE METHODS FOR AN INVENTORY
ADMINISTRATOR TO ADD PRODUCTS OR
CHANGE PRICES ETC BUT A CLIENT CATALOG
PROGRAM USING THAT SAME BEAN SHOULD
NEVER NEED TO SEE ANYTHING BUT THE
READ ONLY METHODS IE JUST THE GETTERS
$QDSSOLFDWLRQIRUUHVHUYLQJDQGERRNLQJGXGH
UDQFKYDFDWLRQVWKURXJKDWUDYHODJHQW
Q: ) WOULD THINK THAT THE PERSON
WRITING THE BEANS WOULD BE THE ONE
WHO 2%!,,9 KNOWS WHAT THE ROLES
SHOULD BE
A: 2EMEMBER BEANS ARE REUSABLE
COMPONENTS 9ES WE JUST SAID THAT IN $UXOHEDVHGSURGXFWUHFRPPHQGDWLRQV\VWHP
THE PREVIOUS QUESTION BUT IT WORKS WKDWDVNVWKHXVHUDVHULHVRITXHVWLRQVDQGWKHQ
HERE TOO 4HE "EAN 0ROVIDER SHOULD JLYHVDSSURSULDWHDGYLFHRQZKLFKSURGXFWWKH
NOT KNOW EXACTLY HOW THESE BEANS XVHUVKRXOGSXUFKDVH
ARE BEING USED )F HE GETS TOO SPECIFIC
WHEN HE DESIGNS THE CODE AND WRITES
THE BEANS THEN THE BEANS PROBABLY
WONT WORK WELL OUTSIDE THE SPECIFIC
PAYROLL APPLICATION THAT HE HAS IN MIND
/NLY THE !PPLICATION !SSEMBLER KNOWS
FOR SURE HOW THE DIFFERENT PIECES OF THE
APPLICATION RELATED TO ONE ANOTHER AND
WHICH ROLES MAKE SENSE 4HERE IS ONE
SMALL EXCEPTION TO THIS THAT WELL TALK
ABOUT LATER IN THE CHAPTER WHEN WE $QRQOLQHPDWFKPDNLQJSHUVRQDODGVHUYLFH
LOOK AT @PROGRAMMATIC SECURITY
\RXDUHKHUH
GHFODUDWLYHVHFXULW\
,MNQVQVO\PMZWTM[
<PM$[MK]ZQ\aZWTM&MTMUMV\
&UHDWHWKHVHFXULW\UROHVLQWKH DVVHPEO\GHVFULSWRU!SDUWRIWKH
GHSOR\PHQWGHVFULSWRU5HPHPEHUWKHGHSOR\PHQWGHVFULSWRUKDVWZR
SDUWV
7KH HQWHUSULVHEHDQV!VHFWLRQWKDW¶VFUHDWHGE\WKH%HDQ3URYLGHU
DQGGHVFULEHVHDFKEHDQLQWKHDSSOLFDWLRQ
7KH DVVHPEO\GHVFULSWRU!SDUWWKDW¶VFUHDWHGE\WKH$SS$VVHPEOHU
DQGGHVFULEHVFKDUDFWHULVWLFVRIWKHDSSOLFDWLRQDVDZKROHLQFOXGLQJWKH
ZD\VLQZKLFKEHDQVUHIHUWRRQHDQRWKHUPRVWVHFXULW\LQIRUPDWLRQDQG
WUDQVDFWLRQDWWULEXWHV
DVVHPEO\GHVFULSWRU!
VHFXULW\UROH!
UROHQDPH!3D\UROO'LUHFWRU UROHQDPH!
VHFXULW\UROH!
VHFXULW\UROH!
UROHQDPH!3D\UROO$GPLQ UROHQDPH!
VHFXULW\UROH!
VHFXULW\UROH!
UROHQDPH!3D\UROO$VVLVWDQW UROHQDPH!
VHFXULW\UROH!
DVVHPEO\GHVFULSWRU!
the only element yo mu
<security-role> elemeu nt st have in a
is <role-name>
&KDSWHU
VHFXULW\LQ(-%
,MNQVQVO\PMZWTM[IJM\\MZ_Ia
<PM$[MK]ZQ\aZWTM&MTMUMV\_Q\PLM[KZQX\QWV[
'HVFULSWLRQVDUHRSWLRQDOHOHPHQWVIRUWKH
VHFXULW\UROH!HOHPHQW
%XWWKLQNDERXWLW :KDW·VWKH
GLIIHUHQFHEHWZHHQ
7KLQNDERXWWKHSRRURYHUZRUNHGXQGHUSDLG 3D\UROO$GPLQDQG
GHSOR\HU ZKLFKLQUHDOLW\LVSUREDEO\\RX 'LUHFWRU":KDWZDV
VKHWKLQNLQJ"""
VLQFHFKDQFHVDUHJRRGWKDW\RX¶UHZHDULQJDOO
WKUHHKDWV %HDQ3URYLGHU$SS$VVHPEOHUDQG
'HSOR\HU²DQGZKDWWKHKHFNSUREDEO\VRPH
6\V$GPLQLQWKHUHWRR
+H·VQRWDPLQGUHDGHU
DVVHPEO\GHVFULSWRU!
VHFXULW\UROH!
GHVFULSWLRQ!
ke it M UC H
7KLVUROHLVIRUWKHHPSOR\HHVZKRKDYHWKH
descriptions ma r to
SRZHUWRYLHZDQGFKDQJHDOOHPSOR\HHSD\UROO
easier for th e de plo ye
ct LQIRUPDWLRQ
ra GHVFULSWLRQ!
map the made-up abstou ps
roles to the REAL gr e th
UROHQDPH!3D\UROO'LUHFWRU UROHQDPH!
e
in the comp an y wh er VHFXULW\UROH!
application will run.
VHFXULW\UROH!
GHVFULSWLRQ!
7KLVUROHLVIRUWKHHPSOR\HHVZKRKDYHWKH
SRZHUWRYLHZDOOHPSOR\HHLQIRUPDWLRQDQG
FKDQJHVRPHSLHFHV
GHVFULSWLRQ!
UROHQDPH!3D\UROO$GPLQ UROHQDPH!
VHFXULW\UROH!
VHFXULW\UROH!
GHVFULSWLRQ!
7KLVUROHLVIRUWKHHPSOR\HHVZKRKDYHWKH
SRZHUWRYLHZDOOHPSOR\HHSD\UROO
LQIRUPDWLRQ
GHVFULSWLRQ!
UROHQDPH!3D\UROO$VVLVWDQW UROHQDPH!
VHFXULW\UROH!
DVVHPEO\GHVFULSWRU!
\RXDUHKHUH
GHFODUDWLYHVHFXULW\
,MNQVQVO\PMUM\PWLXMZUQ[[QWV[
<PM$UM\PWLXMZUQ[[QWV&MTMUMV\
(YHU\WKLQJLQDEHDQ¶VKRPHDQGFRPSRQHQWLQWHUIDFHLVSRWHQWLDOO\FDOODEOH
E\FOLHQWV1RZWKDWWKH$SS$VVHPEOHUKDVGH¿QHGWKHUROHVVKHFDQGH¿QH
ZKLFKPHWKRGVHDFKUROHLVDOORZHGWRFDOO$VVKHGLGZLWKWKHVHFXULW\UROH
GH¿QLWLRQVVKH¶OOSXWWKHPHWKRGSHUPLVVLRQVLQWKH DVVHPEO\GHVFULSWRU!
VHFWLRQRIWKHGHSOR\PHQWGHVFULSWRU
DVVHPEO\GHVFULSWRU!
A method permissth ion starts
says which
with a role, an beenans this role
d
methods in which
PHWKRGSHUPLVVLRQ!
UROHQDPH!3D\UROO'LUHFWRU UROHQDPH!
is allowed to call
PHWKRG!
HMEQDPH!&KDQJH3D\ HMEQDPH!
PHWKRGQDPH!
PHWKRGQDPH!
this method permission
client in the role of ÔPasayrys, ÒA
PHWKRG!
PHWKRG! DirectorÕ is allowed to ca oll
HMEQDPH!(PSOR\HH HMEQDPH! methods in the ChangePa ll ALL
PHWKRGQDPH! PHWKRGQDPH! client view (i.e. the home y beanÕs
PHWKRG! component interfaces) an and
methods in the Employee d ALL
PHWKRGSHUPLVVLRQ! client view. beanÕs
PHWKRGSHUPLVVLRQ!
UROHQDPH!3D\UROO$GPLQ UROHQDPH!
t in
PHWKRG!
pe r m is si o n says ÒA clienÕ can
this in
ÔPayroll Adm
HMEQDPH!&KDQJH3D\ HMEQDPH!
PHWKRGQDPH!UHLPEXUVH PHWKRGQDPH! the role ofimburse and giveBonus ,
PHWKRG! call the re f the ChangePay bean
methods o tSalary method of
PHWKRG!
and the geyee bean.
the Emplo
HMEQDPH!&KDQJH3D\ HMEQDPH!
PHWKRGQDPH!JLYH%RQXV PHWKRGQDPH!
PHWKRG!
PHWKRG!
HMEQDPH!(PSOR\HH HMEQDPH!
PHWKRGQDPH!JHW6DODU\ PHWKRGQDPH!
PHWKRG!
PHWKRGSHUPLVVLRQ!
DVVHPEO\GHVFULSWRU!
&KDSWHU
VHFXULW\LQ(-%
,MNQVQVO\PMUM\PWLXMZUQ[[QWV[
<PZMMLQNNMZMV\_Ia[\W[XMKQNaUM\PWL[
<RXMXVWVDZWZRZD\VWRVSHFLI\DEHDQ¶VPHWKRGQDPH WKHZLOGFDUG
ZKLFK
PHDQV$//PHWKRGVLQWKHEHDQDQGWKHDFWXDOQDPHRIWKHPHWKRG%XWWKHQDPH
DORQHLVQ¶WDOZD\VHQRXJK:HWDONHGDERXWWKLVEHIRUH²LQWKHWUDQVDFWLRQVFKDSWHU
ZHIDFHGWKHVDPHSUREOHPZKHQZHKDGWRVSHFLI\WUDQVDFWLRQDWWULEXWHV:KDW
KDSSHQVLIWKHPHWKRGLVRYHUORDGHG"
&KDQFHVDUH\RXUGHVLJQZLOOWUHDWDOOYHUVLRQVRIDQRYHUORDGHGPHWKRGLQWKHVDPH
ZD\%XWWKHUH¶VDQRSWLRQDO PHWKRGSDUDPV!HOHPHQWMXVWLQFDVH\RXZDQWVD\
DSDUWLFXODUVHFXULW\UROHWRKDYHSHUPLVVLRQIRURQO\RQHYHUVLRQRIDQRYHUORDGHG
PHWKRGEXWQRWWKHRWKHUV
%\ZLOGFDUG
IRU$//PHWKRGV
PHWKRG!
HMEQDPH!:RUOG'RPLQDWLRQ HMEQDPH! an asterisk (*) is
PHWKRGQDPH!
PHWKRGQDPH! wildcard that mea the
PHWKRG! ALL methods ns
beanÕs interfacesin the
%\QDPHDORQHIRUDOOPHWKRGVZLWKWKLV
QDPHUHJDUGOHVVRIDUJXPHQWVRUZKHWKHU
WKH\·UHLQWKHKRPHRUFRPSRQHQWLQWHUIDFH
PHWKRG! ALL
HMEQDPH!:RUOG'RPLQDWLRQ HMEQDPH! this means thathods
PHWKRGQDPH!WDNH2YHU PHWKRGQDPH!
et
overloaded m verÕ will be
PHWKRG! named ÔtakeO e role.
accessible to th
%\QDPHDQGDUJXPHQWVWRGLVWLQJXLVKEHWZHHQ
RYHUORDGHGPHWKRGV
PHWKRG!
HMEQDPH!:RUOG'RPLQDWLRQ HMEQDPH!
this speciÞes O
takeOver methoNdLY the
PHWKRGQDPH!WDNH2YHU PHWKRGQDPH!
PHWKRGSDUDPV!
PHWKRGSDUDP!6WULQJ PHWKRGSDUDP! takes a String, bu that
PHWKRGSDUDPV! no other overloadedt
PHWKRG! versions.
\RXDUHKHUH
GHFODUDWLYHVHFXULW\
0HWKRGSHUPLVVLRQVLQWHUDFW
ZLWKRQHDQRWKHUDVDXQLRQ
-ETHOD PERMISSIONS DO NOT RELATE TO ONE ANOTHER IN THE SAME WAY THAT TRANSACTION ATTRIBUTES
DO 7ITH TRANSACTION ATTRIBUTES USING A WILDCARD SAYS h%VERY METHOD IN THIS BEAN WILL HAVE
THIS ATTRIBUTE UNLESS ) SAY OTHERWISE BY NAMING A SPECIlC METHOD IN A DIFFERENT CONTAINER
TRANSACTION TAGv )N OTHER WORDS NAMING A SPECIlC METHOD OVERRIDES THE WILDCARD SETTING
"UT WITH METHOD PERMISSIONS USING THE WILDCARD SAYS h!LL METHODS IN THIS BEAN CAN BE
ACCESSED BY THIS ROLEv .OTHING ELSE YOU DO IN ANY OTHER METHOD PERMISSION WILL CHANGE THAT
7UDQVDFWLRQDWWULEXWHV
FRQWDLQHUWUDQVDFWLRQ! 7KLVVD\VWKDWDOOPHWKRGVLQ
PHWKRG! %LJ%HDQZLOOXVHWKH5HTXLUHV1HZ
HMEQDPH!%LJ%HDQ HMEQDPH! DWWULEXWH(;&(37WKH
PHWKRGQDPH!
PHWKRGQDPH! XVH2OG'DWDEDVHPHWKRGZKLFKZLOO
PHWKRG! XVHWKH1RW6XSSRUWHGDWWULEXWH
WUDQVDWWULEXWH!5HTXLUHV1HZ WUDQVDWWULEXWH!
FRQWDLQHUWUDQVDFWLRQ! 7KHVHFRQG FRQWDLQHUWUDQVDFWLRQ!
RYHUULGHVWKHZLOGFDUGRQHDQG
FRQWDLQHUWUDQVDFWLRQ!
PHWKRG! WDNHVWKHXVH2OG'DWDEDVHPHWKRG
HMEQDPH!%LJ%HDQ HMEQDPH! RXWRIWKH5HTXLUHV1HZOLVWDQG
PHWKRGQDPH!XVH2OG'DWDEDVH PHWKRGQDPH! PRYHVLWWRWKH1RW6XSSRUWHGOLVW
PHWKRG!
WUDQVDWWULEXWH!1RW6XSSRUWHG WUDQVDWWULEXWH!
FRQWDLQHUWUDQVDFWLRQ!
0HWKRGSHUPLVVLRQV
7KLVVD\VWKDWWKHUROH0LQLRQ
PHWKRGSHUPLVVLRQ! FDQDFFHVV$//PHWKRGVRI
UROHQDPH!0LQLRQ UROHQDPH! :RUOG'RPLQDWLRQ
PHWKRG!
HMEQDPH!:RUOG'RPLQDWLRQ HMEQDPH!
$1'WKDWWKH%RVVUROHFDQDFFHVV
PHWKRGQDPH!
PHWKRGQDPH! 21/<WKHOHDUQ3ODQPHWKRGRI
PHWKRG! :RUOG'RPLQDWLRQ
PHWKRGSHUPLVVLRQ!
7KHVHFRQG PHWKRGSHUPLVVLRQ!
DGGVWRWKHILUVW
PHWKRGSHUPLVVLRQ!
UROHQDPH!%RVV UROHQDPH!
PHWKRG!
HMEQDPH!:RUOG'RPLQDWLRQ HMEQDPH!
PHWKRGQDPH!OHDUQ3ODQ PHWKRGQDPH!
PHWKRG!
PHWKRGSHUPLVVLRQ!
&KDSWHU
VHFXULW\LQ(-%
:DWFKRXWIRU XQFKHFNHG!
4HINK OF UNCHECKED AS STANDING IN FOR A ROLE
NAME IN A METHOD
PERMISSION "UT BECAUSE OF THE WAY METHOD PERMISSIONS INTERACT IF YOU HAVE
A METHOD PERMISSION DElNED FOR A METHOD USING UNCHECKED IT WONT
MATTER WHAT OTHER METHOD PERMISSIONS YOU SET UP FOR THAT METHOD /NE LITTLE
UNCHECKED AND IT MEANS THE METHOD IS FREE FOR ANYONE TO CALL REGARDLESS OF
THEIR PRINCIPAL OR SECURITY ROLE
0HWKRGSHUPLVVLRQVZLWK XQFKHFNHG!
PHWKRGSHUPLVVLRQ! This says that Acc
allowed to call th ountManager is
UROHQDPH!$FFRXQW0DQDJHU UROHQDPH!
e
method on the Acc increaseLimit()
ount bean.
PHWKRG!
HMEQDPH!$FFRXQW HMEQDPH!
PHWKRGQDPH!LQFUHDVH/LPLW PHWKRGQDPH!
PHWKRG!
PHWKRGSHUPLVVLRQ
PHWKRGSHUPLVVLRQ! But who cares??!! By say tha
there is a method-permissioingn for t
XQFKHFNHG! Account that says ALL me
>
<uncheckedc/e of unchecked, it doesnÕt matterthowhds are
goes in p la PHWKRG!
else we say about the Account at
the <role-na
me> HMEQDPH!$FFRXQW HMEQDPH!
methods. They are all uncheckedbeanÕs
PHWKRGQDPH! PHWKRGQDPH! !
element PHWKRG!
PHWKRGSHUPLVVLRQ
7KH XQFKHFNHG!HOHPHQW
RYHUULGHV$//RWKHUPHWKRG
SHUPLVVLRQVIRUDPHWKRG
\RXDUHKHUH
GHFODUDWLYHVHFXULW\
:DLW,MXVWWKRXJKWRI
VRPHWKLQJHOVH6XSSRVH,KDYH
WKHVDPHPHWKRGQDPHLQ%27+
WKHKRPHDQGFRPSRQHQWLQWHUIDFH"
$QG,ZDQWWKHPWRKDYHGLIIHUHQW
DFFHVVFRQWUROV"
+RZWRGHDOZLWKDEHDQWKDWKDVWZR
PHWKRGVRIWKHVDPHQDPHEXWRQHLV
LQWKHKRPHLQWHUIDFHDQGWKHRWKHULV
LQWKHFRPSRQHQWLQWHUIDFH
<HVZHOLHGWKHUHDUHDFWXDOO\IRXUZD\VWRGHVFULEH
DPHWKRG E\ZLOGFDUG
E\QDPHE\QDPHDQG
SDUDPHWHUVDQGE\QDPHDQGLQWHUIDFH
PHWKRG!
HMEQDPH!:RUOG'RPLQDWLRQ HMEQDPH!
PHWKRGLQWI!5HPRWH PHWKRGLQWI!
PHWKRGQDPH!WDNH2YHU PHWKRGQDPH!
PHWKRG!
7KHYDOXHRI PHWKRGLQWI!PXVW
EHRQHRIWKHVHIRXU
PHWKRGLQWI!5HPRWH PHWKRGLQWI!
PHWKRGLQWI!+RPH PHWKRGLQWI!
PHWKRGLQWI!/RFDO PHWKRGLQWI!
PHWKRGLQWI!/RFDO+RPH PHWKRGLQWI!
&KDSWHU
VHFXULW\LQ(-%
<PM,MXTWaMZ¼[ RWJ"UIXXQVOIK\]ITP]UIV[\WIJ[\ZIK\ZWTM[
4HE !PP !SSEMBLER KNOWS THE APPLICATION BUT THE $EPLOYER KNOWS THE
OPERATIONAL ENVIRONMENT 7E AND THE SPEC USE THE TERM OPERATIONAL ENVIRONMENT
AS A FANCY WAY OF SAYING THE BUSINESS WHERE THE APPLICATION IS RUNNING -AYBE THE
COMPANY BOUGHT THE APP OFF
THE
SHELF -AYBE THEY BUILT IT IN
HOUSE $OESNT
MATTER 4HE $EPLOYER WORKS THERE (E KNOWS THE PLACE -OST IMPORTANTLY HE
KNOWS HOW SECURITY IS MANAGED AT THE COMPANY FOR EXAMPLE THE COMPANY
MIGHT HAVE ALL THE EMPLOYEE NAMES AND PASSWORDS AS PART OF AN ,$!0 SYSTEM
(ES THE BEST PERSON TO KNOW HOW THE ABSTRACT ROLES THE !PP !SSEMBLER PUT IN
SHOULD MAP TO REAL PEOPLE AND GROUPS IN HIS COMPANY
(E HAS TWO MAIN JOBS
$VVLJQLQJWKHVHFXULW\GRPDLQDQGSULQFLSDOUHDOPWRWKHDSS
7KHFRPSDQ\ZKHUHWKHDSSLVUXQQLQJKDVUHDOHPSOR\HHV6RPHKRZWKRVHHPSOR\HHVKDYHD
ZD\RIDXWKHQWLFDWLQJWKHPVHOYHVWRDVHUYHUSUREDEO\ZLWKDQDPHDQGDSDVVZRUG7KHVHFXULW\
LQIRUPDWLRQLQWKHRSHUDWLRQDOHQYLURQPHQWKDVWREHFRQILJXUHGLQWRWKHVHUYHULQVXFKDZD\WKDW
WKHVHUYHUFDQWHOOZKRLVDFWXDOO\FDOOLQJWKHPHWKRG
7KLVKDSSHQVRXWVLGHRIWKH(-%VSHFLILFDWLRQ,QRWKHUZRUGVLW·VYHQGRUVSHFLILF
0DSSLQJXVHUVDQGRUJURXSVWRWKHDEVWUDFWVHFXULW\UROHV
7KH$SS$VVHPEOHUPDGHXSWKHDEVWUDFWVHFXULW\UROHVWKDWEHVWILWWKHSD\UROODSS%XWWKRVH
UROHVGRQ·WPHDQDQ\WKLQJLQWKHFRPSDQ\ZKHUHWKHDSSLVJRLQJWRUXQ7KH'HSOR\HUKDVWR
PDSEHWZHHQZKDW$QQLH WKH$SS$VVHPEOHU GHILQHG 3D\UROO'LUHFWRU3D\UROO$GPLQ3D\UROO
$VVLVWDQWWRZKDWUHDOO\H[LVWVLQWKH'HSOR\HU·VFRPSDQ\ 3D\UROO0DQDJHU3D\UROO6XSHUYLVRU
+5$GPLQ
7KLVWRRKDSSHQVRXWVLGHRIWKH(-%VSHFLILFDWLRQLQDYHQGRUVSHFLILFZD\
erm
ec uses the t
Note: the sprity rolesÓ to refer to
Òlogical secue calling the Òabstract
what weÕr lesÓ, but we like the
HGWR security ro ractÓ. Just know that ct
)RUWKHH[DP\RXGRQ¶WQH term Òabst rity rolesÓ and Òabstraing.
SOR \HUGR HVWKLV
Òlogical secuolesÓ mean the same th
NQRZ+2:WKH 'H
WKLQJV
RQO\WKDWKH0867GRWKHVH security r
H[SHFW\RXWRNQRZDERXW
5HPHPEHUWKHH[DPGRHVQ¶W
W\%XW\RX'2KDYHWR
DQ\YHQGRUVSHFL¿FIXQFWLRQDOL
VSRQVLELOLW\WRGRWKLV
NQRZWKDWLWLVWKH'HSOR\HU¶VUH
ZHHQUH DOK XPDQVDQGWKH$SS
OHYHORIPDSSLQJEHW
$VVHPEOHU¶VDEVWUDFWUROHV
\RXDUHKHUH
(-%VHFXULW\
8ZQVKQXIT[IVL:WTM[=[MZ[IVL/ZW]X[
$AN *OHNSSON AUTHENTICATES TO THE SYSTEM USING HIS LOGIN NAME AND PASSWORD AND IS NOW
REPRESENTED BY AN INSTANCE OF TYPE 0RINCIPAL )N A VENDOR
SPECIlC WAY THE $EPLOYER HAS TOLD
THE %*" APPLICATION THAT $ANS 0RINCIPAL IS ASSOCIATED WITH ONE OR MORE ROLES 3O WHENEVER
$AN AS THE CLIENT CALLS A METHOD ON ONE OF THE BEANS CLIENT INTERFACES HIS 0RINCIPAL AND
THE ROLES TO WHICH THAT 0RINCIPAL HAS BEEN ASSIGNED PROPAGATES WITH THE CALL 4HAT MEANS
EVERY CALL ON THE CONCEPTUAL CALL STACK WILL SEE $ANS 0RINCIPAL AS THE CALLER
,Q(-%
3ULQFLSDO
7KHFOLHQWDXWKHQWLFDWHGWRWKHV\VWHPLVUHSUHVHQWHGE\DMDYDVHFXULW\3ULQFLSDOREMHFW7KLV
3ULQFLSDOLVDQDEVWUDFWUHSUHVHQWDWLRQRIVRPHWKLQJDVVRFLDWHGZLWKDQDPHEXWWKHUH·VQRJXDUDQWHH
WKDWWKH3ULQFLSDOQDPHPDWFKHVWKHORJLQQDPHRIWKHFOLHQW,WDOOGHSHQGVRQKRZ\RXUV\VWHP
KDQGOHVVHFXULW\DXWKHQWLFDWLRQ$QGGRQ·WEHWRRDWWDFKHGWRWKLQNLQJWKDWD3ULQFLSDOLVDOZD\VD
DEVWUDFWDFWRULQ XQLTXHLQGLYLGXDO6RPHWLPHVD3ULQFLSDOUHSUHVHQWVDODUJHUJURXSOLNHVD\6\V$GPLQ7KH3ULQFLSDO
WKHV\VWHP XVXDOO\ LVDVVRFLDWHGZLWKRQHRUPRUHDEVWUDFWVHFXULW\UROHVWKDWWKH$SS$VVHPEOHUGHILQHG$ERXWWKHRQO\
PDSVWRDSHUVRQ XVHIXOWKLQJDEHDQFDQGRZLWKD3ULQFLSDOREMHFWLVJHWLWVQDPH D3ULQFLSDOJHW1DPH EXWWKDW·V
ULVN\EHFDXVH\RXZRQ·WEHDEOHWRNQRZH[DFWO\ZKDWWKDWQDPHUHSUHVHQWVXQOHVV\RXNQRZWKH
H[DFWHQYLURQPHQWLQZKLFKWKHEHDQLVUXQQLQJ<XFN
0DQDJHU 5ROH
.H\$FFRXQW ,Q(-%DVHFXULW\UROHLVDQDEVWUDFWUROHGHILQHGE\WKH$SS$VVHPEOHUDQGDOWKRXJKLWGRHVQ·WPDWFK
&XVWRPHU
DQ\WKLQJLQWKHUHDOZRUOGWKH'HSOR\HUZLOOPDSUHDOXVHUVDQGJURXSVLQWKHFRPSDQ\ZKHUHWKH
3D\UROO'LUHFWRU
6ZHGLVK7HDP DSSOLFDWLRQLVUXQQLQJWRWKHDEVWUDFWUROHV)RUH[DPSOHWKH´(PSOR\HHµDEVWUDFWUROHPLJKWPDSWR
6ZLQJ'DQFHUV WKH´6ODYHVµJURXSLQWKH'HSOR\HU·VFRPSDQ\
,QWKHRSHUDWLRQDOHQYLURQPHQW
8VHUV
8VHUVDUHSHRSOHLQWKHUHDOHQYLURQPHQW5HDOXVHUV/LYLQJEUHDWKLQJKXPDQV7KH\·UHUHSUHVHQWHG
LQWKHUHDOHQYLURQPHQWLQVRPHZD\EXWRIFRXUVHLQ(-%ZHKDYHQRZD\RINQRZLQJLQDGYDQFH
WKDWVD\WKHFRPSDQ\XVHVDQ/'$3VHUYHUWRKROGWKHXVHUVHFXULW\LQIRUPDWLRQ7\SLFDOO\XVHUV
DUHPDSSHGWRDORJLQQDPHDQGSDVVZRUGDQGWKDWLQIRUPDWLRQLVVWRUHGVRPHZKHUHDQGLI\RX·UH
OXFN\DQGPDNHWKHULJKWVHUYHUGHFLVLRQ\RXU(-%VHUYHUFDQEHFRQILJXUHGGLUHFWO\WRWKHV\VWHP
KROGLQJ\RXUVHFXULW\LQIR3UHWW\PXFKWKHODVWWKLQJ\RXZDQWWRGRLVVLWWKHUHDQGW\SHXVHU
QDPHVDQGSDVVZRUGVLQWR\RXU(-%VHUYHU·VSURSHUW\ILOHVVLPSO\EHFDXVH\RXU(-%VHUYHUZDVQ·W
FRPSDWLEOHZLWKZKDWHYHU\RXUFRPSDQ\LVXVLQJWRVWRUHXVHUVHFXULW\LQIRUPDWLRQ
&XVWRPHU *URXSV
3D\UROO0DQDJHU
6ZHGHQ 7\SLFDOO\VHFXULW\LQIRUPDWLRQRUJDQL]HVXVHUVLQWRRQHRUPRUHJURXSVRIWHQE\GHSDUWPHQWRU
6DOVD'DQFHUV ORFDWLRQ7KH'HSOR\HUFDQRIWHQPDSGLUHFWO\IURPJURXSVWRDEVWUDFWVHFXULW\UROHVEXWKHPLJKWDOVR
KDYHWRPDSLQGLYLGXDOXVHUV
&KDSWHU
VHFXULW\LQ(-%
2.,NQRZ,·PQRWVXSSRVHG
WREHWKLQNLQJDERXWWKLVZKHQ,ZULWH
P\FRGHEXWWKHUH·VVRPHWKLQJEXJJLQJPH
/RRNLQJDWWKHGHSOR\PHQWGHVFULSWRULWOHWV
\RXVD\ZKRFDQDFFHVVZKLFKEHDQW\SH
%XW\RXFDQ·WVD\ZKLFKLQVWDQFHRI
WKDWEHDQW\SH
, NQRZ ZKDW KH·V JHWWLQJ DWEHFDXVH
,ZDVWKLQNLQJWKHVDPHWKLQJ:KDWGR
,GRLI,ZDQWHPSOR\HHVWREHDEOHWRKDYH
DFFHVVWRVRPHRIWKHLURZQGDWD³EXWRQO\
WKHLU2:1GDWD+RZGR,VHWLQGLYLGXDOHQWLW\
OHYHOFRQWURO"2WKHUZLVH,·GKDYHWRHLWKHUEORFN
$//HPSOR\HHVIURPWKHVHPHWKRGVRUOHW$//
HPSOR\HHVKDYHDFFHVVWRWKHPHWKRGVWKDWZRXOG
ZRUNRQ$1<HQWLW\EHDQ+RZFDQ,OHWWKHUROH
RI¶HPSOR\HH·FDOOVD\JHW6DODU\ EXWRQO\
VHHKLV2:1VDODU\"
\RXDUHKHUH
SURJUDPPDWLFVHFXULW\
+TI[[TM^MT^[QV[\IVKMTM^MT[MK]ZQ\a
?PMVLMKTIZI\Q^M[MK]ZQ\aQ[VW\MVW]OPaW]UQOP\VMMLXZWOZIUUI\QK
[MK]ZQ\a\WZM[\ZQK\IKKM[[\WI[XMKQNQKQV[\IVKMWNIJMIV
3O FAR ALL THE SECURITY WEVE LOOKED AT HAS BEEN DECLARATIVENOT HARD
CODED INTO
THE BEAN CLASS $ECLARATIVE SECURITY IS COOL BECAUSE IT SUPPORTS THE WHOLE IDEA
OF COMPONENT
BASED DEVELOPMENTYOU CAN CUSTOMIZE THE BEAN AT DEPLOY
TIME WITHOUT TOUCHING THE CODE #OMPANY ! MIGHT BE USING A BEAN IN ONE
APPLICATION AND NEED A PARTICULAR TYPE OF ACCESS CONTROL THATS COMPLETELY
DIFFERENT FROM THE WAY #OMPANY " IS USING THAT SAME BEAN /R EVEN TWO USES
OF THE SAME BEAN IN THE SAME COMPANY MIGHT NEED DIFFERENT ACCESS CONTROL
"UT DECLARATIVE SECURITY IS AT THE CLASS
LEVEL 9OU SPECIFY WHICH METHODS A
PARTICULAR ROLE CAN CALL BUT IT MEANS THAT ROLE CAN CALL THE METHOD ON !.9
INSTANCE OF THE BEAN CLASS )F YOU NEED INSTANCE
LEVEL SECURITY YOU CANT DO IT
IN THE DEPLOYMENT DESCRIPTOR "UT YOU CAN DO PROGRAMMATIC SECURITY WHICH
OF COURSE YOU ALREADY KNOW YOUVE SEEN THE TWO SECURITY
RELATED METHODS IN
3ESSION#ONTEXT AND %NTITY#ONTEXT
6RWKHUH,6
VRPHWKLQJ,FDQSXW
LQP\EHDQFRGH
SXEOLFYRLGGR6HFXULW\ ^
MDYDVHFXULW\3ULQFLSDOS FRQWH[WJHW&DOOHU3ULQFLSDO
6WULQJQDPH SJHW1DPH
QRZGRDFRPSDULVRQE\FKHFNLQJWKHQDPH
DJDLQVWWKHSHUVLVWHQW¿HOGLQWKHEHDQ
WKDWVKRXOGPDWFKWKHSULQFLSDOQDPH
`
"UT BE CAREFUL 4HERE IS NO GUARANTEE THAT THE NAME COMING FROM THE GET.AME METHOD
ON THE PRINCIPAL MATCHES THE USERS LOG
IN NAME 3O YOU HAVE TO ASSUME THAT AS SOON
AS YOU PUT PROGRAMMATIC SECURITY INTO YOUR BEAN YOURE DRASTICALLY REDUCING ITS
REUSABILITY AND PORTABILITY !ND IT MEANS THE "EAN 0ROVIDER MIGHT NEED TO BE
MORE TIGHTLY
COUPLED TO THE OPERATIONAL ENVIRONMENT THAN YOUD NORMALLY WANT
"ECAUSE THE "EAN 0ROVIDER IS MAKING AN ASSUMPTION THAT THE NAME COMING
FROM THE GET.AME METHOD WILL MATCH A PERSISTENT lELD IN THE ENTITY BEAN
AND THAT MIGHT NOT BE TRUE IN ALL ENVIRONMENTS DEPENDING ON HOW YOUR SYSTEM
HANDLES SECURITY
&KDSWHU
SURJUDPPDWLFVHFXULW\ VHFXULW\LQ(-%
=[QVOXZWOZIUUI\QK[MK]ZQ\a\W
K][\WU\IQTWZIUM\PWL
7E JUST LOOKED AT GET#ALLER0RINCIPAL TO SEE HOW YOU COULD lND
OUT EXACTLY 7(/ THE CONTAINER BELIEVES IS CALLING THE METHOD "UT
WE CAN ALSO USE THE IS#ALLER)N2OLE METHOD TO TEST WHETHER THE
PRINCIPAL WHOEVER IT IS AND IN THIS CASE WE DONT CARE IS A MEMBER :LWKLV&DOOHU,Q5ROH \RX
OF A SPECIlC ROLE THAT WE DO CARE ABOUT )MAGINE THAT YOU HAVE A
PRIVATE PRICING METHOD CALLED BY ONE OF YOUR BUSINESS METHODS FDQXVHVHFXULW\LQIRUPDWLRQ
THAT CHECKS TO SEE IF THIS CUSTOMER AUTHENTICATED AS A MEMBER OF WRWDLORUWKHZD\DPHWKRG
YOUR SPECIAL 6)0 CUSTOMER GROUP )F HE IS YOU TREAT HIM DIFFERENTLY
THAN IF HE ISNT -AYBE YOU GIVE HIM A DISCOUNT -AYBE YOU RAISE UXQVGHSHQGLQJRQZKLFK
THE PRICE 7HATEVER YOUR BUSINESS LOGIC TELLS YOU TO DO UROHFDOOHGWKHPHWKRG
SULYDWHYRLGGHWHUPLQH3ULFH ^ 7KLVLVXVXDOO\127DJRRG
ZD\WRKDQGOHVHFXULW\7R
LI FRQWH[WLV&DOOHU,Q5ROH ³9,3&XVWRPHU´ ^
WUHDWFXVWRPHUZHOO FRQWURODFFHVVWRDPHWKRG
`HOVH^ \RX·UHPXFKEHWWHURIIXVLQJ
WUHDWKLPOLNHWKHORVHUKHLV
` WKHPHWKRGSHUPLVVLRQV
` WRVWRSDQXQDXWKRUL]HG
"ESIDES THE OBVIOUS PROBLEM WITH HARD
CODING SECURITY INFORMATION
UROHIURPHYHUFDOOLQJWKH
CUTS DOWN YOUR REUSE INCREASES THE CHANCES THAT THINGS WONT PHWKRG
WORK IN A PORTABLE WAY ETC THERES ANOTHER BIG PROBLEMHOW
THE HECK DOES THE "EAN 0ROVIDER KNOW IN ADVANCE WHAT ROLES THE %XW\RXFDQVWLOO86(WKH
!PP !SSEMBLER IS GOING TO ASSIGN
FDOOHU·VUROHLQIRUPDWLRQWR
(E DOESNT /R AT LEAST HE PROBABLY SHOULDNT 7E KNOW WE KNOW
)N REALITY THE "EAN 0ROVIDER AND !PP !SSEMBLER ARE IF NOT THE GRRWKHUQRQVHFXULW\WKLQJV
SAME PERSON CLOSELY RELATED PROFESSIONALLY
SPEAKING OF COURSE LQ\RXUFRGH
"UT WERE STILL PUSHING FOR A COMPONENT
BASED DEVELOPMENT MODEL
HERE AND AT THE VERY LEAST WE WANT THE !PP !SSEMBLER TO TAKE
WHAT THE "EAN 0ROVIDER HAS DONE AND SOMEHOW lT IT INTO HER OWN
APPLICATION !ND THAT MIGHT MEAN INTEGRATING THE BEAN WITH BEANS
FROM OTHER PROVIDERS
3O NOW IMAGINE THIS SCENARIO !NNIE THE !PP !SSEMBLER IS
BUILDING A NEW APP FROM FOUR EXISTING BEANS TWO OF WHICH CAME
FROM DIFFERENT PROVIDERS 0ROVIDERS WHO DIDNT WORK FOR THE SAME
COMPANY OR KNOW ONE ANOTHER (OW COULD THEY HAVE COMMUNICATED
IN ADVANCE TO KNOW WHICH ROLES !NNIE WAS GOING TO CHOOSE FOR HER
APPLICATION
\RXDUHKHUH
SURJUDPPDWLFVHFXULW\
<PMXZWJTMU_Q\PQ[+ITTMZ1V:WTM
\PM*MIV8ZW^QLMZPIZLKWLM[IZWTMVIUMJ]\PW_LWM[
PMSVW__PI\ZWTM[\PM)XX)[[MUJTMZ_QTT][M')VL
_PI\QN\PMZM¼[UWZM\PIVWVM*MIV8ZW^QLMZ '
,·OOFDOOWKH
ELJDFFRXQWVUROH
¶9,3&XVWRPHUµLQP\
FRGH ,·OOFDOOWKHUROHIRU
LPSRUWDQWDFFRXQWV
´(QOLJKWHQHG&XVWRPHUVµ
6HHWKHSUREOHP",KDYH
WR LQWHJUDWHWKHVHEHDQVLQWRRQHDSS
EXW%LOOSLFNHGWKHQDPH´9,3&XVWRPHUµWR
KDUGFRGHLQWRKLVEHDQDQG5D\6XQVKLQH
WKHUHGHFLGHGWKHUROHVKRXOGEHFDOOHG
´(QOLJKWHQHG&XVWRPHUVµ6RQRZ,KDYHWRVRPHKRZ
PDS7+(,5FRPSOHWHO\PDGHXSQDPHVWRWKH
DEVWUDFWVHFXULW\UROHVWKDW,SXWLQWKHGHSOR\PHQW
GHVFULSWRU,KDYHWRWHOOWKHDSSWKDWERWKRIWKHLU
QDPHV5($//<PHDQ´.H\$FFRXQWVµ$QGKRZZLOO,
HYHQ.12:WKDWWKH\XVHGWKHVHQDPHVLI
,GRQ·WVHHWKHVRXUFHFRGH""" 5D\6XQVKLQH
%LOOSURYLGHGEHDQ$ SURYLGHGEHDQ%
7KH$SS$VVHPEOHUPXVWPDS
$QQLHQHHGVWRXVH%27+ EHWZHHQWKHSURJUDPPHU·V
EHDQVLQKHUDSSEXWVKH
KDUGFRGHG FRPSOHWHO\IDNH
ZDQWVWRGHÀQHKHUUROH
QDPHDV´.H\$FFRXQWVµ UROHQDPHDQGWKHDEVWUDFW
UROHVKHZDQWVWRGHÀQHIRU
WKLVDSSOLFDWLRQ
DEVWUDFWUROHQDPH .H\$FFRXQWV
EHDQ$UROHQDPH 9,3&XVWRPHU
EHDQ%UROHQDPH (QOLJKWHQHG
&XVWRPHUV
ME
d iffe re nt na mes for the SrAto map
three ts the deploye
role!! Annie weran groups to ÒKeyAccountsÓse
REAL custom other two names, but tho he
and not thosecode, and she canÕt touch t
names are in de !
Java source co
&KDSWHU
SURJUDPPDWLFVHFXULW\ VHFXULW\LQ(-%
0DSGHFODUDWLYHVHFXULW\UROHVWRWKH
SURJUDPPHU·VKDUGFRGHG IDNH UROHV
4HE !PP !SSEMBLER MAPS BETWEEN SECURITY ROLE REFERENCES HARD
CODED
ROLE NAMES THE PROGRAMMER MADE UP AND SECURITY ROLES ABSTRACT ROLE
NAMES SHE CHOSE FOR THIS APP USING THE UROHOLQN! ELEMENT
%HDQ3URYLGHU L the
der has to TEL
The Bean Prorvi what he did in code, by
App Assemble<security-role-ref> tag
HQWHUSULVHEHDQV!
VHVVLRQ!
putting in a
2K\HDKWKH$SS
$VVHPEOHUQHHGVWRNQRZWKDW HMEQDPH!6KRSSLQJ&DUW HMEQDPH!
,SXWDUROHQDPHLQP\FRGH,·OO
PDNHDVHFXULW\UROHUHIHUHQFH VHFXULW\UROHUHI!
LQWKH'',PDNHIRUWKLV GHVFULSWLRQ!
EHDQ WKLVUROHVKRXOGEHDVVLJQHGWRWKH
DFFRXQWVWKDWJHWVSHFLDO9,3SULFLQJ
GHVFULSWLRQ!
UROHQDPH!9,3&XVWRPHU UROHQDPH!
VHFXULW\UROHUHI! t MATCH.
These names tmusin the ÔrealÕ
VHVVLRQ! You donÕt pu u put in the
HQWHUSULVHEHDQV! role name, yo gu-
the ar
one you used aslerInRole()
ment to isCal
FRQWH[WLV&DOOHU,Q5ROH ³9,3&XVWRPHU´
$SS$VVHPEOHU
,KDYHWRJR
LQWRKLVEHDQGHVFULSWLRQDQG
DGGD UROHOLQN!HOHPHQWIRU
WKLVVHFXULW\UROHUHIHUHQFHVR
The App Assembler ad
WKDWWKH&RQWDLQHUZLOONQRZWKDW
what the Bean Providedsr pua <role-link> to
role-ref>, to map the CO t in his <security-
´9,3&XVWRPHUµUHDOO\PHDQV
´.H\$FFRXQWVµ
VHFXULW\UROHUHI! App AssemblerÕs true abstrDED role to the
act role
GHVFULSWLRQ!
WKLVUROHVKRXOGEHDVVLJQHGWRWKH
DFFRXQWVWKDWJHWVSHFLDO9,3SULFLQJ
GHVFULSWLRQ!
UROHQDPH!9,3&XVWRPHUV UROHQDPH!
UROHOLQN!.H\$FFRXQWV UROHOLQN!
VHFXULW\UROHUHI!
\RXDUHKHUH
(-%VHFXULW\PDSSLQJ
7KHFRPSOHWHVHFXULW\PDSSLQJSLFWXUH
VHFXULW\UROHUHI! VHFXULW\UROH! XVHUVDQGJURXSV UHDOSHRSOH
$SS$VVHPEOHUPDSVWKH 'HSOR\HUPDSVWKH$SS 6RPHRQHLQWKHRSHUDWLRQDO
SURJUDPPHU·VKDUGFRGHG $VVHPEOHU·VDEVWUDFW HQYLURQPHQWVHWVXSXVHUV
VHFXULW\UROHUHIHUHQFHVWR VHFXULW\UROHVWRXVHUVDQG DQGJURXSVLQWKHUHDO
KHUDEVWUDFWVHFXULW\UROHV JURXSVLQWKH'HSOR\HU·V FRPSDQ\3UREDEO\VRPHNLQG
XVLQJWKH UROHOLQN!HOHPHQW FRPSDQ\XVLQJDYHQGRU RIV\VDGPLQUHVSRQVLEOH
VSHFLÀFPDSSLQJ FRXOGEHD IRUDVVLJQLQJORJLQLQIRDQG
SURSHUWLHVÀOH SDVVZRUGVWRHPSOR\HHV
:KHUHDQGKRZWKHPDSSLQJKDSSHQV
,QWKH(-% ,QDYHQGRU ,QDFRPSDQ\
'HSOR\PHQW VSHFL¿FZD\ VSHFL¿FZD\
'HVFULSWRU
VHFXULW\UROHUHI! VHFXULW\UROH! XVHUVDQGJURXSV UHDOSHRSOH
this is the part thatÕs
the part you have to kninowthe spec, and youÕll Þnd this out from youron way out of the scope of
on the exam
vendor/product documentati a bean developerÕs job
&KDSWHU
VHFXULW\LQ(-%
=[M$Z]VI[&[MK]ZQ\aQLMV\Q\a\W
XZM\MVL[WUMWVMMT[MQ[KITTQVO
7HEN A CLIENT CALLS A METHOD THE #ONTAINER ALWAYS
KNOWS THE CLIENTS 0RINCIPAL WHICH INCLUDES THE ABSTRACT 1RZZKHQHYHU,FDOODQRWKHUEHDQ
SECURITY ROLES THE $EPLOYER ASSIGNED TO THAT 0RINCIPAL LQWKHDSSOLFDWLRQWKDWEHDQWKLQNV
!ND REMEMBER THE CALLERS SECURITY CONTEXT IS PROPAGATED ,·PVRPHRQHVSHFLDO6RPHRQHFRROHU
THROUGHOUT THE APPLICATION AS THE CLIENTS ORIGINAL METHOD 6RPHRQHZLWKSRZHUZKRFDQUHDOO\*2
GOES ABOUT DOING ITS WORK %ACH METHOD CALLED IN THE SODFHV6RPHRQHD/27PRUHLQWHUHVWLQJ
WKDQWKHFOLHQWZKRFDOOHGWKHEXVLQHVV
CONCEPTUAL CALL STACK WILL GET THE SECURITY CONTEXT ALONG WITH
PHWKRGWKDWVWDUWHGDOOWKLV
THE CALL
"UT LETS SAY THAT YOU DONT WANT THE CLIENTS SECURITY CONTEXT
TO KEEP PROPAGATING ,ETS SAY THAT WHEN THE CLIENT CALLS "EAN
! AND "EAN ! IN TURN CALLS "EAN " YOU WANT "EAN " TO THINK
THAT SOMEONE ELSE IS CALLING )N OTHER WORDS WHAT IF YOU WANT
"EAN ! TO PRETEND TO BE SOMEONE ELSE 4HAT WAY ANY BEAN
THAT "EAN ! CALLS WILL THINK THE 0RINCIPAL AND ROLES OF THE
CALLER IS SOMETHING OTHER THAN THE ORIGINAL CLIENTS
7HY WOULD YOU DO THIS "EAN " MIGHT HAVE TIGHTER ACCESS
CONTROL 0ERHAPS "EAN " WONT ALLOW OUTSIDE CLIENTS TO CALL ITS
METHODS SO IT DOESNT HAVE METHOD PERMISSIONS SET UP FOR
ANY OF THE ABSTRACT ROLES MAPPED TO CLIENTS USERS AND GROUPS
"UT PERHAPS YOU HAVE A SPECIAL ROLE SET
UP JUST FOR OTHER
BEANS AND "EAN " WILL TAKE CALLS FROM OTHER BEANS AS LONG AS
THOSE BEANS ARE IN THAT ROLE
:KHQ\RXZDQWWKHEHDQWR%(VRPH ([SOLFLWO\VD\LQJWKDW\RXZDQWWKH
RQHRWKHUWKDQWKHFDOOLQJFOLHQW FDOOLQJFOLHQW·VLGHQWLW\WREHXVHG
HQWHUSULVHEHDQV! HQWHUSULVHEHDQV!
VHVVLRQ! VHVVLRQ!
HMEQDPH!%HDQ$ HMEQDPH! HMEQDPH!%HDQ$ HMEQDPH!
VHFXULW\LGHQWLW\! VHFXULW\LGHQWLW\!
UXQDV! XVHFDOOHULGHQWLW\!
UROHQDPH!6XSHU%HDQ UROHQDPH! VHFXULW\LGHQWLW\!
UXQDV!
This is what you get by
VHFXULW\LGHQWLW\! VHVVLRQ!
HQWHUSULVHEHDQV! donÕt
VHVVLRQ!
ust
role-name emal abstract default, if you
HQWHUSULVHEHDQV! match a r by put in a <security-
set up identity> element at all.
security-rossleembler
the App A So you donÕt have to say
this, but you can.
\RXDUHKHUH
UXQDV!VHFXULW\LGHQWLW\
;MK]ZQ\aKWV\M`\XZWXIOI\QWV
_Q\P$Z]VI[&
&OLHQWFDOOVZLWKDVHFXULW\ 5DWKHUWKDQSURSDJDWHWKH %HDQ%GRHVQ·WNQRZDERXWWKH
FRQWH[WWKDWVD\VVKH·VD FOLHQW·VVHFXULW\LGHQWLW\ RULJLQDOFOLHQWDQGWKLQNVWKH
PHPEHURIWKH´FXVWRPHUVµ %HDQ$WDNHVRQWKHUROH FDOOHU·VVHFXULW\LGHQWLW\LV
UROH RI¶6XSHU%HDQ·WKHQFDOOVD ¶6XSHU%HDQ·8QOHVV%HDQ%KDV
PHWKRGRQ%HDQ% LWV2:1UXQDVLGHQWLW\LWZLOO
SURSDJDWH¶6XSHU%HDQ·ZLWKDQ\
FDOOV%HDQ%PDNHVRQRWKHUEHDQV
%HDQ$ 6WLOO%HDQ$
EXWQRZUXQQLQJ %HDQ%
DV¶6XSHU%HDQ·
&OLHQWLQWKH
¶FXVWRPHUV·UROH
%HDQ$·V VHFXULW\LGHQWLW\!
LVQRWDERXWZKR%HDQ$
0HVVDJHGULYHQEHDQV
PXVW127 VKRXOGVHHDVLWVFDOOHUEXW
HULGHQWLW\!
VD\ XVHFDOO
UDWKHUZKDW%HDQ%ZLOOVHH
:KLFKFDOOHUZRXOGWKDWEH
"0HVVDJHGULYHQEHDQV
GRQ¶W
HQW
ZKHQ%HDQ$FDOOVLW
DWFKRXWIRUDGHSOR \P
+$9(DFDOOLQJFOLHQW6RZ EHD QZ LWKD
GHVFULSWRUWKDWVKRZVDPH
VVDJHGULY
XV
HQ
HFDOOHULGHQWLW\!+RZH
YHU ,QRWKHUZRUGV VHFXULW\
VHFXULW \LGHQW LW\WKDWVD \V
$QG
PHVVDJHGULYHQEHDQV&$
1KDYHD UXQDV
VVD JH
!LGHQW
GULY
LW\
HQ EHD Q
LGHQWLW\!LVQRWDERXW
UJHWWKDWD PH
ZKLOHZH¶UHKHUHGRQ¶WIR FKDQJLQJWKHLQFRPLQJ
HYH UWU\ WRDVN LWV0H VVDJH'ULYHQ&RQWH[WIRUWKH
PXVWQ LGH QWLW\! GRH VQ¶W
QWLW\$ VHFXULW\
FDOOLQJFOLHQW¶VVHFXULW\LGH ,7EX WUDWKH UZ KR WKH FOLHQWLGHQWLW\EXWDERXW
LVFDOOLQJ
VSHFLI\ZKRWKHEHDQWKLQNV 5E HDQ V
LWPDNHVFDOOVWR27+( FKDQJLQJZKDWWKHEHDQ
EHDQSUHWHQGVWREHZKHQ
SURSDJDWHVDVWKHRXWJRLQJ
LGHQWLW\ZKHQWKHEHDQ
FDOOVRWKHUEHDQV
under the name
(Like registering at a hoteuÕrl e ACTUALLY
ÒJennifer LopezÓ, when yoe hotel clerk canÕt tell.
ÒSimon RobertsÓ... and th , youÕre J-Lo.)
As far as he is concerned
&KDSWHU
VHFXULW\LQ(-%
0RFN([DP
7HATS TRUE ABOUT SECURITY FOR %*"S #HOOSE ALL THAT APPLY
1
R! !LL SECURITY POLICIES MUST BE EXPRESSED DECLARATIVELY
R" 4HE DEFAULT SECURITY PRINCIPAL UNDER WHICH A METHOD INVOCATION IS
PERFORMED IS THAT OF THE COMPONENTS CREATOR
R# 5SING %*"S METHOD PERMISSIONS CAN BE DECLARED USING %*" 1, IN THE
DEPLOYMENT DESCRIPTOR
R$ 3ECURITY AUTHORIZATION CAN BE BYPASSED ON A METHOD BY METHOD BASIS
R% 3ECURITY AUTHORIZATION CAN BE BYPASSED ON AN INSTANCE BY INSTANCE BASIS
7HATS TRUE ABOUT METHODS THAT SHOULD RUN WITHOUT BEING CHECKED FOR
2 AUTHORIZATION #HOOSE ALL THAT APPLY
R! 4HEY CAN BE LISTED IN THE EXCLUDE
LIST ELEMENT
R" 4HEY CAN BE LISTED IN THE UNCHECKED ELEMENT
R# 7HEN THE UNCHECKED ELEMENT IS USED IT SHOULD BE PLACED WHERE THE
ROLE
NAME ELEMENT NORMALLY OCCURS IN THE DEPLOYMENT DESCRIPTOR
R$ 7HEN A METHOD PERMISSION RELATION SPECIlES BOTH UNCHECKED AND A
SECURITY ROLE THE CONTAINER WILL USE THE SECURITY ROLE
7HICH ROLES SHOULD TYPICALLY DElNE THE APPROPRIATE SECURITY POLICIES FOR AN
3 APPLICATION #HOOSE ALL THAT APPLY
R! BEAN PROVIDER
R" APPLICATION ASSEMBLER
R# DEPLOYER
R$ SYSTEM ADMINISTRATOR
R% SERVER PROVIDER
\RXDUHKHUH
FRIIHHFUDPPRFNH[DP
)N WHICH OF THE FOLLOWING METHODS CAN A STATEFUL SESSION BEAN INVOKE THE
4 LV&DOOHU,Q5ROH METHOD IN ORDER TO PERFORM A SECURITY CHECK #HOOSE ALL
THAT APPLY
R! HME&UHDWH
R" HME$FWLYDWH
R# HME3DVVLYDWH
R$ .ONE OF THE ABOVE
7HICH ARE THE BEAN PROVIDERS RESPONSIBILITIES WHEN MAKING AN APPLICATION
5 SECURE #HOOSE ALL THAT APPLY
R! !SSIGNING THE SECURITY DOMAIN TO THE APPLICATION
R" !UTHENTICATION OF PRINCIPALS
R# -APPING THE PRINCIPALS USED BY THE CLIENT TO THE PRINCIPALS DElNED FOR
THE BEAN
R$ .ONE OF THE ABOVE
)N WHICH OF THE FOLLOWING METHODS CAN A #-0 ENTITY BEAN INVOKE THE
6 GET#ALLER0RINCIPAL METHOD IN ORDER TO PERFORM A SECURITY CHECK #HOOSE
ALL THAT APPLY
R! HME&UHDWH
R" HME$FWLYDWH
R# HME3DVVLYDWH
R$ HME3RVW&UHDWH
R% "USINESS METHODS
)N WHICH OF THE FOLLOWING METHODS CAN A "-0 ENTITY BEAN INVOKE THE
7 JHW&DOOHU3ULQFLSDO METHOD IN ORDER TO PERFORM A SECURITY CHECK
#HOOSE ALL THAT APPLY
R! HME/RDG
R" HME6WRUH
R# HME3DVVLYDWH
R$ HME3RVW&UHDWH
R% "USINESS METHODS
&KDSWHU
VHFXULW\LQ(-%
7HEN DESCRIBING METHOD PERMISSIONS IN THE DEPLOYMENT DESCRIPTOR FOR A
8 SPECIlC BEAN WHATS TRUE #HOOSE ALL THAT APPLY
R! ! WILD
CARD CHARACTER CAN REFER TO ALL OF THE BEANS METHODS
R" )NDIVIDUAL OVERLOADED METHODS CANNOT BE DISTINGUISHED FROM EACH
OTHER
R# ! METHOD IN THE HOME INTERFACE CANNOT BE DISTINGUISHED FROM A
METHOD WITH THE SAME NAME IN THE COMPONENT INTERFACE
R$ )NDIVIDUAL METHODS CAN BE REFERRED TO
4HE UROHQDPH! ELEMENT CAN BE USED WITHIN WHAT OTHER SECURITY RELATED
9 DEPLOYMENT DESCRIPTOR ELEMENTS #HOOSE ALL THAT APPLY
R! VHFXULW\UROH!
R" UXQDV!
R# PHWKRGQDPH!
R$ H[FOXGHOLVW!
R% VHFXULW\UROHUHI!
7HICH ROLES HAVE WHAT RESPONSIBILITIES WHEN IMPLEMENTING SECURITY FOR %*"
10 APPLICATIONS #HOOSE ALL THAT APPLY
R! 4HE !PPLICATION !SSEMBLER TYPICALLY SPECIlES WHEN RUN
AS IDENTITY
SHOULD BE USED IN AN APPLICATION
R" 4HE "EAN 0ROVIDER MAPS SECURITY ROLE REFERENCES TO SECURITY ROLES
R# 4HE "EAN 0ROVIDER IS TYPICALLY RESPONSIBLE FOR ASSIGNING THE SECURITY
DOMAIN AND PRINCIPAL REALM TO THE APPLICATION
R$ 4HE $EPLOYER MAPS SECURITY ROLE REFERENCES TO SECURITY ROLES
7ITHIN THE VHFXULW\UROHUHI! DEPLOYMENT DESCRIPTOR ELEMENT WHICH
11 SUB
ELEMENTS ARE OPTIONAL #HOOSE ALL THAT APPLY
R! UROHQDPH!
R" UROHOLQN!
R# GHVFULSWLRQ!
R$ .ONE OF THE ABOVE ARE OPTIONAL
\RXDUHKHUH
GHFODUDWLYHVHFXULW\
0RFN([DP$QVZHUV
)
7HATS TRUE ABOUT SECURITY FOR %*"S #HOOSE ALL THAT APPLY (spec: 434-435
1
R! !LL SECURITY POLICIES MUST BE EXPRESSED DECLARATIVELY
R" 4HE DEFAULT SECURITY PRINCIPAL UNDER WHICH A METHOD INVOCATION IS
PERFORMED IS THAT OF THE COMPONENTS CREATOR
R# 5SING %*"S METHOD PERMISSIONS CAN BE DECLARED USING %*" 1, IN THE
DEPLOYMENT DESCRIPTOR
R$ 3ECURITY AUTHORIZATION CAN BE BYPASSED ON A METHOD BY METHOD BASIS
R% 3ECURITY AUTHORIZATION CAN BE BYPASSED ON AN INSTANCE BY INSTANCE BASIS
7HATS TRUE ABOUT METHODS THAT SHOULD RUN WITHOUT BEING CHECKED FOR
(spec: 443)
2 AUTHORIZATION #HOOSE ALL THAT APPLY
R! 4HEY CAN BE LISTED IN THE EXCLUDE
LIST ELEMENT - For methods that must
NEVER be called
R" 4HEY CAN BE LISTED IN THE UNCHECKED ELEMENT
R# 7HEN THE UNCHECKED ELEMENT IS USED IT SHOULD BE PLACED WHERE THE
ROLE
NAME ELEMENT NORMALLY OCCURS IN THE DEPLOYMENT DESCRIPTOR
R$ 7HEN A METHOD PERMISSION RELATION SPECIlES BOTH UNCHECKED AND A
SECURITY ROLE THE CONTAINER WILL USE THE SECURITY ROLE
7HICH ROLES SHOULD TYPICALLY DElNE THE APPROPRIATE SECURITY POLICIES FOR AN (spec: 435-436)
3 APPLICATION #HOOSE ALL THAT APPLY
R! BEAN PROVIDER
R" APPLICATION ASSEMBLER
R# DEPLOYER
R$ SYSTEM ADMINISTRATOR
R% SERVER PROVIDER
&KDSWHU
VHFXULW\LQ(-%
4 )N WHICH OF THE FOLLOWING METHODS CAN A STATEFUL SESSION BEAN INVOKE THE (spec: 80)
LV&DOOHU,Q5ROH METHOD IN ORDER TO PERFORM A SECURITY CHECK #HOOSE ALL
THAT APPLY
R! HME&UHDWH
R" HME$FWLYDWH
R# HME3DVVLYDWH
R$ .ONE OF THE ABOVE
)
7HICH ARE THE BEAN PROVIDERS RESPONSIBILITIES WHEN MAKING AN APPLICATION (spec: 448-454
5 SECURE #HOOSE ALL THAT APPLY
R! !SSIGNING THE SECURITY DOMAIN TO THE APPLICATION Typically the DeployerÕs job
R" !UTHENTICATION OF PRINCIPALS
R# -APPING THE PRINCIPALS USED BY THE CLIENT TO THE PRINCIPALS DElNED FOR
THE BEAN
R$ .ONE OF THE ABOVE
)N WHICH OF THE FOLLOWING METHODS CAN A #-0 ENTITY BEAN INVOKE THE (spec: 179-180)
6 GET#ALLER0RINCIPAL METHOD IN ORDER TO PERFORM A SECURITY CHECK #HOOSE
ALL THAT APPLY
R! HME&UHDWH
R" HME$FWLYDWH client be?
- who would the
R# HME3DVVLYDWH
R$ HME3RVW&UHDWH
R% "USINESS METHODS
7 )N WHICH OF THE FOLLOWING METHODS CAN A "-0 ENTITY BEAN INVOKE THE (spec: 257)
JHW&DOOHU3ULQFLSDO METHOD IN ORDER TO PERFORM A SECURITY CHECK
#HOOSE ALL THAT APPLY
R! HME/RDG
R" HME6WRUH
R# HME3DVVLYDWH - who would t
he client be?
R$ HME3RVW&UHDWH
R% "USINESS METHODS
\RXDUHKHUH
GHFODUDWLYHVHFXULW\
7HEN DESCRIBING METHOD PERMISSIONS IN THE DEPLOYMENT DESCRIPTOR FOR A (spec: 444)
8 SPECIlC BEAN WHATS TRUE #HOOSE ALL THAT APPLY
R! ! WILD CARD CHARACTER CAN REFER TO ALL OF THE BEANS METHODS
R" )NDIVIDUAL OVERLOADED METHODS CANNOT BE DISTINGUISHED FROM EACH The <method-intf>
OTHER element does this
R# ! METHOD IN THE HOME INTERFACE CANNOT BE DISTINGUISHED FROM A
METHOD WITH THE SAME NAME IN THE COMPONENT INTERFACE
R$ )NDIVIDUAL METHODS CAN BE REFERRED TO
7)
4HE UROHQDPH! ELEMENT CAN BE USED WITHIN WHAT OTHER SECURITY RELATED (spec: 444-44
9 DEPLOYMENT DESCRIPTOR ELEMENTS #HOOSE ALL THAT APPLY
R! VHFXULW\UROH!
R" UXQDV!
R# PHWKRGQDPH!
R$ H[FOXGHOLVW!
R% VHFXULW\UROHUHI!
9)
7HICH ROLES HAVE WHAT RESPONSIBILITIES WHEN IMPLEMENTING SECURITY FOR %*" (spec: 446-44
10 APPLICATIONS #HOOSE ALL THAT APPLY
R! 4HE !PPLICATION !SSEMBLER TYPICALLY SPECIlES WHEN RUN
AS IDENTITY
SHOULD BE USED IN AN APPLICATION
Usually deÞned by the
R" 4HE "EAN 0ROVIDER MAPS SECURITY ROLE REFERENCES TO SECURITY ROLES Application assembler
R# 4HE "EAN 0ROVIDER IS TYPICALLY RESPONSIBLE FOR ASSIGNING THE SECURITY
DOMAIN AND PRINCIPAL REALM TO THE APPLICATION
R$ 4HE $EPLOYER MAPS SECURITY ROLE REFERENCES TO SECURITY ROLES
11 7ITHIN THE VHFXULW\UROHUHI! DEPLOYMENT DESCRIPTOR ELEMENT WHICH (spec: 527)
SUB ELEMENTS ARE OPTIONAL #HOOSE ALL THAT APPLY
R! UROHQDPH!
R" UROHOLQN! Usually deÞned by the Application assembler
R# GHVFULSWLRQ!
R$ .ONE OF THE ABOVE ARE OPTIONAL
&KDSWHU
a beanÕs environment
5
4
47KH-R\RI'HSOR\PHQW
7KDQNVWRWKH
EHQHÀWVRIGHSOR\WLPH
FXVWRPL]DWLRQ,KDYHH[WUD ,KHDUG\RXU
WLPHWRHQMR\PRUHORYHO\ H[ZLIHVWLOOFKDQJHV
PHDOVZLWK\RX VRXUFHFRGH
<RXZRUNHGKDUGRQWKDWEHDQ<RXFRGHG\RXFRPSLOHG\RXWHVWHG$ERXW
DKXQGUHG]LOOLRQWLPHV7KHODVWWKLQJ\RXZDQWWRWRXFKLVDOUHDG\WHVWHGVRXUFHFRGH
MXVWEHFDXVHVRPHWKLQJVLPSOHFKDQJHGLQWKHGHSOR\PHQWFRQ¿JXUDWLRQ0D\EHWKHQDPH
RIWKHGDWDEDVHLVGLIIHUHQW0D\EH\RXKDUGFRGHGDWD[UDWH UHPHPEHU²EHDQ¶VFDQ¶W
DFFHVVSURSHUW\¿OHV $QGZKDWLI\RXGRQ¶WHYHQKDYHWKHVRXUFHFRGH"0D\EH\RXJRW
LWIURP%HDQVU8VDQGWKH\ZRQ¶WVHOO\RXWKHVRXUFH QRWRQ\RXUEXGJHWDQ\ZD\ (-%
VXSSRUWVEHDQUHXVHWKURXJKWKH'HSOR\PHQW'HVFULSWRUDQGDEHDQ¶VVSHFLDOHQYLURQPHQW
WKLVLVDQHZFKDSWHU
H[DPREMHFWLYHV
$%HDQ·V(QYLURQPHQW
2IILFLDO :KDWLWUHDOO\PHDQV
,GHQWLI\FRUUHFWDQGLQFRUUHFW <RXPXVWNQRZWKHZD\VLQZKLFKDEHDQFDQEHFXVWRP
VWDWHPHQWVRUH[DPSOHVDERXWDQ L]HGDWGHSOR\PHQWWLPHZLWKRXWFKDQJLQJVRXUFHFRGH
HQWHUSULVHEHDQ¶V-1',QDPLQJ :KHQDEHDQGRHVD-1',ORRNXSXVLQJWKHEHDQ¶V
RZQVSHFLDOHQYLURQPHQW\RXPXVWNQRZKRZWKHFRGH
,GHQWLI\FRUUHFWDQGLQFRUUHFW UHODWHVWRZKDW¶VLQWKHGHSOR\PHQWGHVFULSWRUDQGD
VWDWHPHQWVDERXWWKHSXUSRVHDQGRU EXQFKRI¿QLFN\GHWDLOVWKDWPHDQWKHGLIIHUHQFHEHWZHHQ
XVHRIWKHGHSOR\PHQWGHVFULSWRU DVXFFHVVIXOGHSOR\PHQWRURQHWKDWZRQ¶WGHSOR\2U
HOHPHQWVIRUHQYLURQPHQWHQWULHV PXFKZRUVHRQHWKDWGHSOR\VEXWEORZVXSVRPHWLPH
(-%UHIHUHQFHVUHVRXUFHPDQDJHU ODWHUZKLOHLWVUXQQLQJ
FRQQHFWLRQIDFWRU\UHIHUHQFHV
LQFOXGLQJZKHWKHUDJLYHQFRGHOLVWLQJ <RXQHHGWRNQRZZKDWLVDQGLVQRWJXDUDQWHHGE\WKH
LVDSSURSULDWHDQGFRUUHFWZLWKUHVSHFW (-%VSHFL¿FDWLRQ)RUH[DPSOHDQ(-%FRQWDLQHU
WRDSDUWLFXODU''HOHPHQW LVQRWUHTXLUHGWRVXSSRUW-;7$-0;6HUYOHWVRU-63V
EXWLWLVUHTXLUHGWRVXSSRUW-1',-06DQG-$;3<RX
*LYHQDOLVWRIUHVSRQVLELOLWLHVLGHQWLI\ QHHGWRNQRZZKDW(-%UHDOO\JLYHV\RX
ZKLFKEHORQJWRWKH'HSOR\HU%HDQ
3URYLGHU$SS$VVHPEOHU&RQWDLQHU <RXDOVRQHHGWRNQRZZKDW\RXFDQDQGFDQQRWGRLQ
6\V$GPLQRUDQ\FRPELQDWLRQ (-%LI\RXZDQWWRPDNHDEHDQWKDWLVSRUWDEOHDFURVV
DOO(-%FRPSOLDQWFRQWDLQHUV)RUH[DPSOH\RXFDQ¶W
OLVWHQRQD6HUYHU6RFNHWEXW\RXFDQFUHDWHDFOLHQW
*LYHQDOLVWRIWHFKQRORJ\
VSHFL¿FDWLRQVLGHQWLI\ZKLFKDUH 6RFNHW<RXFDQ¶WDFFHVVWKHVHUYHU¶VORFDO¿OHV\VWHP
UHTXLUHPHQWVIRUDQ(-%FRQWDLQHU RUPDNH\RXURZQWKUHDGV%XW\RXFDQPDNH\RXUEHDQ
FODVVH[WHQGDQRWKHU
,GHQWLI\FRUUHFWDQGLQFRUUHFW <RXQHHGWRNQRZDERXWWKH(-%UROHV %HDQ3URYLGHU
VWDWHPHQWVRUH[DPSOHVDERXW(-%
$SSOLFDWLRQ$VVHPEOHUHWF DQGZKRGRHVZKDWGXULQJ
SURJUDPPLQJUHVWULFWLRQV
GHYHORSPHQWDQGGHSOR\PHQW$OWKRXJK\RXZRQ¶WKDYH
PDQ\TXHVWLRQVDERXWWKLVLW¶VDQDUHDWKHH[DPEHWD
0DWFK(-%UROHVZLWKWKH WHVWHUVVWUXJJOHGZLWKVRLIZHZHUH\RXZH¶GVWXG\WKLV
FRUUHVSRQGLQJGHVFULSWLRQRIWKHUROH¶V SDUWFDUHIXOO\
UHVSRQVLELOLWLHVZKHUHWKHGHVFULSWLRQ
PD\LQFOXGHGHSOR\PHQWGHVFULSWRU )LQDOO\\RXPXVWNQRZZKDWLVDQGLVQRWVXSSRVHGWREH
LQIRUPDWLRQ LQDQHMEMDU¿OH)RUH[DPSOHWKHKRPHDQGFRPSRQHQW
LQWHUIDFHPXVWEHWKHUH XQOHVV\RX¶UHXVLQJDPHVVDJH
*LYHQDOLVWLGHQWLI\ZKLFKDUH GULYHQEHDQ EXWWKHVWXEVPXVWQRWEHWKHUH
UHTXLUHPHQWVIRUDQHMEMDU¿OH
FKDSWHU
DEHDQ¶VHQYLURQPHQW
,MXVW/29(WRFKDQJH
VRXUFHFRGH7KDW·VZK\,KDYH
DKLJKSD\LQJMREZRUNLQJLQ
DUHVSHFWHG,7FRPSDQ\
FDIHWHULD
5DLVH\RXUKDQGLI\RXOLNHFKDQJLQJ
\RXUVRXUFHFRGHHYHU\WLPH\RXQHHG
WRFKDQJHWKHZD\\RXUEHDQEHKDYHV
/F COURSE YOU DONT LIKE GOING BACK TO YOUR SOURCE
CODE JUST BECAUSE SAY SOMEBODY CHANGED THE NAME
OF THE DATABASE 9OU ALREADY KNOW THAT YOU CAN
CHANGE TRANSACTION ATTRIBUTES AND SECURITY ACCESS JUST
BY TWEAKING THE DEPLOYMENT DESCRIPTOR "UT WAIT
THERES MORE
%VERY %*" CONTAINER GIVES YOUR BEAN ITS OWN SPECIAL
ENVIRONMENT THAT YOUR BEAN CAN USE TO LOOK UP FOUR
DIFFERENT THINGS
(QYLURQPHQW(QWULHV
7KHVHDUHGHSOR\WLPHYDOXHV VR\RXGRQ·WKDYHWR
FRGHLQYDOXHVOLNHWKHFXUUHQWGLVFRXQWSHUFHQWDJHRU
WD[UDWH
5HVRXUFH0DQDJHU&RQQHFWLRQ
)DFWRULHV
<RX·OOXVHWKHVHWRJHWDFRQQHFWLRQWRDGDWDEDVH
(QWHUSULVH%HDQ5HIHUHQFHV
:KHQRQHEHDQZDQWVWRORRNXSDQRWKHUEHDQ<RX·OO
GRWKLVDORW0RVWGHVLJQVLQYROYHDWOHDVWVRPHOHYHORI
EHDQWREHDQFRPPXQLFDWLRQ
5HVRXUFH(QYLURQPHQW5HIHUHQFHV
<RX·OOXVHWKLVWRJHWDUHIHUHQFHWRVRPHWKLQJFDOOHG
´DQDGPLQLVWHUHGREMHFWµIURPWKHVHUYHUOLNHD-06
GHVWLQDWLRQ
\RXDUHKHUH
GHSOR\WLPHFXVWRPL]DWLRQ
)JMIV¼[[XMKQITXTIKMRI^I"KWUXMV^
9OUR BEAN IS ENTITLED TO A *.$) CONTEXT ALL ITS OWN ! SPECIAL
PLACE THATS JUST FOR YOUR BEAN WHERE YOUR BEAN CAN LOOK THINGS
UP )T ALL STARTS WITH AN )NITIAL#ONTEXT BUT THE JAVACOMPENV
SUBCONTEXT IS WHERE THE BEAN BEGINS NAVIGATING WHEN HE WANTS
TO LOOK SOMETHING UP
IRR
$-1',¶YLUWXDO
GLUHFWRU\WUHH·
EDU
ED] 'XGH,ÀQDOO\
REM KDYHDSODFHRIP\
RZQ-XVWIRUPH
$GYLVRU
WN special
This is the beanÕs beO an starts MDYD FRPSHQY
subcontext. The here when he
navigating from environment to
wants to use his
look stuff up.
REM
HME MGEF
WD[5DWH
This bean ca
value of taxRnatlook up the
java:comp/env/ e using
taxRate REM
REM
UHIHUHQFHWRD'DWD6RXUFH
UHIHUHQFHWR$GYLVRU IRUWKH&XVWRPHUGDWDEDVH
This bean ca e
other beans inn look up be an ca n lo ok up a DataSourc
This p/env/jdbc
java:comp/env/ the in the java:com
subcontext ejb subcontext
FKDSWHU
DEHDQ¶VHQYLURQPHQW
*]\Q\¼[VW\XMZJMIVQV[\IVKM
1\¼[XMZJMIVPWUM
4HE SCOPE OF A BEANS ENVIRONMENT IS FOR ALL BEANS FROM THE SAME HOME )F
YOU DEPLOYED A PARTICULAR BEAN TYPE INTO YOUR SERVER THREE TIMES EACH OF
THE THREE DEPLOYMENTS WOULD HAVE ITS OWN UNIQUE HOME SO THERED BE
THREE DIFFERENT ENVIRONMENTS
$OOEHDQVIURPWKH
VDPHKRPHKDYHWKH
VDPHHQYLURQPHQW
MDYD FRPSHQY
7KLVVXFNV
,KDWHVKDULQJ
&XVWRPHU%HDQ DOOWKHRWKHU&XVWRPHU%HDQV
,QLWLDO&RQWH[WLF QHZ,QLWLDO&RQWH[W
'RXEOHGLVFRXQW 'RXEOH LFORRNXS ³MDYD FRPSHQYFXVW'LVFRXQW´
This value will be th
no matter which inste same
CustomerBean runs ance of
this code.
\RXDUHKHUH
GHSOR\WLPHFXVWRPL]DWLRQ
(QYLURQPHQWVXEFRQWH[WV
MDYD FRPSHQYMGEF&XVWRPHU'%
ouÕre
the priva a m e o f the ÔthingÕ ryesource
for this btee environment Th e n
n this case ,
an type looking up (ifactory to the
A subcontext we named ÔjdbcÕ by connection se)
convention (although ÔjdbcÕ is not ÔCustomerDBÕ databa
required, and we could have said
java:comp/env/CustomerDB
LQDEHDQ·VEXVLQHVVPHWKRG
,QLWLDO&RQWH[WLF QHZ,QLWLDO&RQWH[W
'DWD6RXUFHGV 'DWD6RXUFH LFORRNXS ³MDYD FRPSHQYMGEF&XVWRPHU'%´
&RQQHFWLRQFRQQ GVJHW&RQQHFWLRQ
YS starts
Navigation ALWAt. So you will MDYD FRPSHQY
with this contexava:comp/envÓ
ALWAYS see Òj e code when a
somewhere in th hing up in its
bean looks somet
environment
e MGEF
The spec recommends usingJDthBC
ÔjdbcÕ subcontext for all n
resource manager connectiotext for
factories, the ÔmailÕ subconyou guess
mail connections and can ns? REM
what it is for url connectio
DUHIHUHQFHWRWKHFRQQHFWLRQ
IDFWRU\IRUWKHFXVWRPHUGDWDEDVH
QDPHG´&XVWRPHU'%µRULVLW"
how the heck do
programmer knowes the
of the database??the name
FKDSWHU
DEHDQ¶VHQYLURQPHQW
'HMDYXLW·VWKHVDPHLVVXH
ZHKDGZLWKVHFXULW\,KDYH
WRSXW620(7+,1*LQFRGHEXW
,GRQ·WNQRZWKHUHDOQDPHRIWKH
GDWDEDVH+PPPP
YiX`e
gfn\i
+RZFDQZHGHDOZLWKWKLV"+RZGRHVWKH
SURJUDPPHUKDUGFRGHDORRNXS6WULQJOLNH
³MDYD FRPSHQYMGEF&XVWRPHU'%´ZLWKRXW
NQRZLQJKRZWKHGDWDEDVHZDVFRQ¿JXUHG
LQWRWKHVHUYHU"
KLQW KRZGLGZHGHDOZLWKLWHDUOLHUZKHQ
WKH%HDQ3URYLGHUXVHGSURJUDPPDWLF
VHFXULW\ZLWKLV&DOOHU,Q5ROH ³VRPH5ROH´ "
\RXDUHKHUH
GHSOR\WLPHFXVWRPL]DWLRQ
1\¼[[QUXTM
QN\PMXZWOZIUUMZX]\[IUILM]X26,1VIUMQVKWLM
PMPI[\WIVVW]VKM\PI\\W\PMLMXTWaMZQV\PM,,
4HE $EPLOYER HAS NO CLUE WHAT THE "EAN 0ROVIDER PUT IN CODE UNLESS THE
"EAN 0ROVIDER
! 4ELLS HIM
" 7RITES THE NAMES ON A STICKY NOTE AND STICKS IT ON THE $EPLOYERS MONITOR
OR
# $ECLARES REFERENCES IN THE $EPLOYMENT $ESCRIPTOR COMPLETE WITH HELPFUL
DESCRIPTIONS THAT MAKE IT VERY CLEAR WHAT THE $EPLOYER IS SUPPOSED TO MAP TO
THE PROGRAMMERS MADE
UP NAMES
+HEHWWHUGHFODUHDOOKLV
-1',HQYLURQPHQWUHIHUHQFHV
7KHGHSOR\HUJHWVUHDOO\
LQWKH''VR,FDQPDSWKHPWR
SLVVHGRIILI\RXGRQ·WGHFODUH
\RXU-1',ORRNXSVWULQJVLQ
5($/QDPHVWKDWRQO\,NQRZ$QG
WKHGHSOR\PHQWGHVFULSWRU$VN LIKHGRHVQ·W,·OOVKRZKLPZKDW
PHDERXWWKHÀJKWZHKDGODVW WKUHH\HDUVRI3LODWHVFDQGR
PRQWK6HULRXVO\$VNPH
'HFODUHVWKHPDGHXS-1',QDPHV 0DSVWKHSURJUDPPHU·VPDGHXS
LQWKH'HSOR\PHQW'HVFULSWRUIRU IDNHQDPHVWRWKH5($/-1',
WKH'HSOR\HU QDPHVXQGHUZKLFKWKHUHVRXUFHV
ZHUHGHSOR\HGRUFRQÀJXUHGLQWR
WKHVHUYHU
FKDSWHU
DEHDQ¶VHQYLURQPHQW
(QYLURQPHQWHQWULHV GHSOR\WLPHFRQVWDQWV
)MAGINE YOURE WRITING A SIMPLE CHECKOUT BEAN FOR AN ONLINE SHOPPING
CART SYSTEM 9OU DONT KNOW WHERE THAT BEAN MIGHT END UP %VEN IF YOU DO
YOU KNOW THAT THINGS LIKE TAX RATES AND DISCOUNT POLICIES CAN CHANGE EVEN
WITHIN THE SAME COMPANY
%NVIRONMENT ENTRIES LET YOU WRITE YOUR CODE USING A VARIABLE THAT YOULL l LL
IN AT RUNTIME USING A *.$) LOOKUP 2EMEMBER THE "EAN 0ROVIDER CHOOSES
THE NAME AND ITS UP TO THE $EPLOYER TO l LL IN THE VALUE this is the part of
the lookup that must
LQDEHDQ·VEXVLQHVVPHWKRG go in the DD
,QLWLDO&RQWH[WLF QHZ,QLWLDO&RQWH[W
'RXEOHGEO 'RXEOH LFORRNXS ³MDYD FRPSHQYVPDUW&XVWRPHU'LVFRXQW´
FXVWRPHU'LVFRXQW GEOGRXEOH9DOXH
XVHWKHSULPLWLYHGRXEOHYDOXHWRFDOFXODWHWKHGLVFRXQW
a va :c o m p/env/Ó !
j r
NO T p ut the Ò descriptor. Eve at
You do he deployment Y the part th
t
LQWKH'HSOR\PHQW'HVFULSWRU part in , you put ONL p/env/Ó
D m
HQWLW\! In the ter the Òjava:co
D
comes a f if you have any
compassion at
HQYHQWU\! all, youÕll put in a
er
The programm GHVFULSWLRQ!GLVFRXQWIRUVPDUWFXVWRPHUV GHVFULSWLRQ! description for the
is na me
made up th HQYHQWU\QDPH!VPDUW&XVWRPHU'LVFRXQW HQYHQWU\QDPH! poor Deployer.
HQYHQWU\W\SH!MDYDODQJ'RXEOH HQYHQWU\W\SH!
HQYHQWU\YDOXH! HQYHQWU\YDOXH!
the type must be
HQYHQWU\! either a String or a
wrapper class
HQWLW\!
The value is optional for the Bean Provider, but he can use
<RXFDQ·WFKDQJHD
YDOXHG\QDPLFDOO\
this element to supply a default. But the Deployer MUST SOR\HGWKHUHLV
ensure that thereÕs a valid value before the bean is deployed. 2QFHDEHDQKDVEHHQGH
HWKHY DOXHRIWKHHQYL
12:$<WRFKDQJ
Environment entries are different from the other ZD\WRXSGDWH
URQPHQWYDULDEOH7KHRQO\
LVWRUHGHSOR\WKH
customizations in that the Deployer doesnÕt map from the WKHYDOXHDEHDQVHHV
EHDQZLWKWKHQHZ' '
Bean ProviderÕs name to some other real name. Environment
entries donÕt exist until the Bean Provider says they do, by
putting in the <env-entry>. As long as the <env-entry> has a
value when its deployed, the environment entry will be created.
\RXDUHKHUH
GHSOR\WLPHFXVWRPL]DWLRQ
WKHUH DUH QR
'XPE 4XHVWLRQV
<RX0867NQRZ
WKHVFRSHRI
Q: 7HY CANT YOU JUST USE *AVA PROPERTY l LES :DWFKLW DQHQYLURQPHQW
HQWU\
INSTEAD OF ENVIRONMENT ENTRIES
W
<RX¶UHH[SHFWHGWRNQRZWKD
A: 9OURE NOT ALLOWED TO USE PROPERTIES BECAUSE HQYLURQPHQWH
XQLTXH WRHDF
QWUL
KK
HV
RP
DUH
H,
SUL
I\R
YDW
XG
HDQG
HSOR\
YOU CANT ACCESS THE FILE SYSTEM TO READ THEM IN AND µIR R¶Z LWKD
YOU DONT HAVE ANY CONTROL OVER SYSTEM PROPERTIES FOR DQHQYLURQPHQWHQWU\
RUWKH &X VWR PH UEH DQ
EXAMPLE YOU HAVE NO WAY TO SET A PROPERTY AS A *6- YDOXHRII
DQ ZLOO
COMMAND
LINE ARGUMENT DOOLQVWDQFHVRI&XVWRPHU%H
ZK HQ WKH \G RD
JHWWKDWVDPHYDOXH
LQJMDY D FRP SH QY IRR IURP
ORRNXSXV
Q: 7HY CANT ) HAVE AN ENVIRONMENT ENTRY THATS DEXVLQHVVPHWKRG
SHARED AMONG MULTIPLE BEANS IN THE SAME APP /R AT WU\µIRR¶
LEAST WITHIN THE SAME EJB
JAR %XW\RXUHQYLURQPHQWHQ
LQJ FROOL
GRHV127FDXVHDQDP
HU% ($ 1W \SH
VLRQZLWKDQ\RWK
A: "ECAUSE BECAUSE YOU CANT 4HERES SIMPLY WKDW¶VEHH QGHSO
VDPHHQYLURQPHQWH
R\H GZ
QWU
LWK
\Q
WKH
DP
H
NO MECHANISM FOR SHARING THE BEANS ENVIRONMENT WKHVDPH
BECAUSE THAT WOULD DEFEAT THE WHOLE PURPOSE OF THE &XVWRPHUEHDQ¶VµIRR¶LVQRW
HQWKRXJK
BEAN HAVING HIS OWN PRIVATE SPACE (AVING A BEANS DV$GYLFHEHDQ¶VµIRR¶HY
GHQ WLFDO
ENVIRONMENT PREVENTS WHAT WOULD BE AN EXTREMELY WKHORRNXSVWULQJVDUHL
FRPS HQ YIR R´ DQG
LIKELY DISASTER NAMING COLLISIONS BETWEEN DIFFERENT LFORRNXS ³MDYD
HVDPH
BEANS )N OTHER WORDS DIFFERENT BEANS DEPLOYED WITH HYHQLIERWKEHDQVDUHLQWK
DUFKLY H HDU
ENVIRONMENT ENTRIES OR OTHER REFERENCES THAT USE THE HMEMDURUHQWHUSULVH
SAME NAME VLQJOH
%XWZH¶UHQRWGRQH\HWD
27 EH GH SOR\HG
)F YOU HAVE A SHARED RESOURCE OR ENVIRONMENT ENTRY EHDQW\SHPXVW1
YOU -534 CONFIGURE IT WITH EACH BEAN YOU DEPLOY 4HIS KDQ RQ HµW KLQ J¶R IWKH
ZLWKPRUHW
IS ./4 PER $EPLOYMENT $ESCRIPTOR BUT PER EVERY INDI
HQ DP H6R\ RX FDQ ¶WF DOODQHQ
VDP
UHVRXUFH
VIDUAL BEAN REGARDLESS OF WHERE THE BEAN LIVES YLURQPHQWHQWU\µIRR¶DQGD
RQQ HFW LRQ IDF WRU\ µIRR¶LQ
PDQDJHUF
JD V\RX
WKH&XVWRPHUEHDQ$VORQ
(QYLURQPHQWHQWULHVPXVW WK RXJ K\ RX¶ UH2.
XVHVXEFRQWH[WV
EHRQHRIWKHVHW\SHV HµMGEF IRR ¶LVGLII HUH QWIURP
%HFDXV
&$ 1K DYH
MXVWµIRR¶DORQH6R\RX
6WULQJ ERWK
%\WH 2QO\6WULQJV MDYD FRPSHQYIRR
6KRUW DQG
DQGZUDSSHUV MDYD FRPSHQYMGEFIRR
,QWHJHU DUHDOORZHGIRU EXW127WZRWKLQJVQDPHG
/RQJ HQYLURQPHQW
LIWKRVHWZR
)ORDW
HQWULHV MDYD FRPSHQYIRRHYHQ
HW\SHV
WKLQJVDUHGLIIHUHQWUHVRXUF
'RXEOH
&KDUDFWHU
%RROHDQ
FKDSWHU
DEHDQ¶VHQYLURQPHQW
,W·VVXEFRQWH[WVDOOWKHZD\GRZQ
2EMEMBER YOUR JAVACOMPENV SPACE IS JUST A SUBCONTEXT ! SPECIAL ONE
SURE BUT STILL A CONTEXT 3O YOU CAN SAVE THAT IN A #ONTEXT VARIABLE AND SAVE
YOURSELF FROM HAVING TO RETYPE hJAVACOMPENVv EVERY FRICKIN TIME YOU WANT
TO LOOK SOMETHING UP
6DYLQJ\RXUVSHFLDOHQYLURQPHQWFRQWH[W
,QLWLDO&RQWH[WLF QHZ,QLWLDO&RQWH[W
&RQWH[WP\6SHFLDO3ODFH &RQWH[W LFORRNXS ³MDYD FRPSHQY´
QRZORRNVRPHWKLQJXSRQP\6SHFLDO3ODFH
'RXEOHGEO 'RXEOH P\6SHFLDO3ODFHORRNXS ³VPDUW&XVWRPHU'LVFRXQW´
text,
taxInfo is a subconronment.
8VLQJDVXEFRQWH[W of the beanÕs envi
MDYD FRPSHQY
,QLWLDO&RQWH[WLF QHZ,QLWLDO&RQWH[W
&RQWH[WP\7D[,QIR&W[ &RQWH[W LFORRNXS ³MDYD FRPSHQYWD[,QIR´
QRZORRNVRPHWKLQJXSRQP\7D[,QIR&W[VXEFRQWH[W
'RXEOHGEO 'RXEOH P\7D[,QIR&W[ORRNXS ³WD[5DWH´
WD[,QIR
ct
Note: you donÕt need to narrow anything comi
ng taxRate is an objeo
out of JNDI lookups EXCEPT for stubs within the ta xI nf
(Remote home interface references), so all you subcontext
REM need is a plain old cast.
WD[5DWH
&UHDWLQJDVXEFRQWH[W
! SUBCONTEXT EXISTS SIMPLY BECAUSE YOU SAY IT DOES )F YOU TYPE hJAVACOMP
ENVFOOBARv INTO YOUR LOOKUP CODE YOUVE SAID h4HERE IS A SUBCONTEXT IN
In the DD for trthe MY ENVIRONMENT NAMED hFOOv AND IT CONTAINS THE OBJECT hBARv !S LONG AS YOU
environment en y
USE THE SAME SUBCONTEXT IN THE DEPLOYMENT DESCRIPTOR WHEN YOU DEPLOY THE
BEAN THE SUBCONTEXT WILL MAGICALLY EXIST JUST BECAUSE YOU SAID IT DOES )N OTHER
name, anything sh
followed by a slacomes
WORDS YOU DONT HAVE TO GO THROUGH A PROCESS OF SOMEHOW CREATING A NEW
automatically be
*.$) CONTEXT AND NAMING IT !CT LIKE ITS THERE AND ITS THERE $ONT YOU WISH
a subcontext!
EVERYTHING WORKED THAT WAY
HQYHQWU\QDPH!WD[,QIRWD[5DWH HQYHQWU\QDPH!
putting ÒtaxInfo / Ó before ÒtaxRateÓ
automatically creates the taxRate
subcontext when this bean is deployed
\RXDUHKHUH
GHSOR\WLPHFXVWRPL]DWLRQ
5HVRXUFHPDQDJHUFRQQHFWLRQIDFWRULHV
WKLQN GDWDEDVH
!NY BEAN CAN USE A DATABASE )N FACT EVEN AN ENTITY BEAN WITH CONTAINER
MANAGED PERSISTENCE CAN GET A CONNECTION TO A DATABASE AS LONG AS ITS USING
THAT DATABASE FOR SOMETHING OTHER THAN MANAGING ITS OWN PERSISTENCE 4HE
CODE IS SIMPLE LOOK UP A $ATA3OURCE AND ASK IT FOR A #ONNECTION /NCE YOU
HAVE A #ONNECTION YOU CAN SEND *$"# STATEMENTS TO DO YOUR 31,
!LTHOUGH JAVAXSQL$ATA3OURCE IS BY FAR THE MOST COMMONLY
USED RESOURCE
MANAGER CONNECTION FACTORY YOU CAN HAVE OTHERS INCLUDING A MAIL OR 52,
CONNECTION this is the part of
the lookup that must
go in the DD
LQDEHDQ·VEXVLQHVVPHWKRG
,QLWLDO&RQWH[WLF QHZ,QLWLDO&RQWH[W
'DWD6RXUFHGV 'DWD6RXUFH LFORRNXS ³MDYD FRPSHQYMGEF&XVWRPHU'% ´
&RQQHFWLRQFRQQ GVJHW&RQQHFWLRQ
XVHWKHFRQQHFWLRQWRGR-'%&
LQWKH'HSOR\PHQW'HVFULSWRU
Be SURE to leave off e
comp/env/ part, and beth
HQWLW\! java:
gin
UHVRXUFHUHI! Þrst subcontext (jdbc) wit h the
ade-
ProgrammerÕs mthe UHVUHIQDPH!MGEF&XVWRPEHU'% UHVUHIQDPH!
up name. NOTe!.
read DB nam UHVW\SH!MDYD[VTO'DWD6RXUFH UHVW\SH! the resource manager
connection factory type
e if UHVDXWK!&RQWDLQHU UHVDXWK!
Who checks to see right
the user has th for UHVVKDULQJVFRSH!6KDUHDEOH UHVVKDULQJVFRSH!
the
security accessher the
database? Eit onta UHVRXUFHUHI!
iner <res-sharing-scope> is optio
Bean or the C ÒS hareableÓ. It means that otnal, and defaults to
HQWLW\! same app, using the same re her beans in the
transaction, can use the samsource, in the SAME
disable sharing, the value sho e connection. To
uld be ÒUnshareableÓ
FKDSWHU
DEHDQ¶VHQYLURQPHQW
5HVRXUFHPDQDJHUFRQQHFWLRQIDFWRU\W\SHV
9OU CANT PUT ARBITRARY TYPES INTO THE $$ &OR THE FOUR STANDARD RESOURCE MANAGER
CONNECTION FACTORIES lVE IF YOU COUNT *-3 TOPICS AND QUEUES AS TWO DIFFERENT
TYPES YOU MUST USE ONE OF THE FOLLOWING
UHVW\SH!MDYD[VTO'DWD6RXUFH UHVW\SH!
UHVW\SH!MDYD[MPV4XHXH&RQQHFWLRQ)DFWRU\ UHVW\SH!
-06 UHVW\SH!MDYD[MPV7RSLF&RQQHFWLRQ)DFWRU\ UHVW\SH!
UHVW\SH!MDYD[PDLO6HVVLRQ UHVW\SH!
KWWS ZZZKHDGILUVWFRP UHVW\SH!MDYD[QHW85/ UHVW\SH!
!LTHOUGH THESE FOUR ARE THE ONLY TYPES STANDARD TO %*" YOU CAN USE THE
#ONNECTOR ARCHITECTURE IF YOU NEED ACCESS TO OTHER RESOURCES LIKE LEGACY SYSTEMS
#ONNECTORS ARE OUT OF SCOPE FOR THIS BOOK AND THE EXAM SO YOU CAN RELAX "UT
YOU DO NEED TO KNOW ITS OUT THERE IF YOU NEED IT
5HVRXUFHDXWKRUL]DWLRQ
!UTHENTICATION TO THE %*" SERVER ITSELF IS ONE THING BUT CHANCES ARE THE DATABASE
HAS ITS OWN LOG
IN SCHEME ! USER MIGHT NEED A LOG
IN NAME AND PASSWORD THAT IS
DIFFERENT FROM THE ONE HE USES TO AUTHENTICATE TO THE %*" SERVER
!S A "EAN 0ROVIDER YOU CAN CHOOSE BETWEEN TWO WAYS TO GIVE THE RESOURCE
MANAGER SUCH AS A DATABASE THE USERS LOG
IN DATA
UHVDXWK!&RQWDLQHU UHVDXWK!
&RQWDLQHUDXWKRUL]DWLRQPHDQVWKH'HSOR\HUPXVWFRQ¿JXUHWKHVLJQRQ
LQIRUPDWLRQIRUWKHUHVRXUFHPDQDJHU,W¶VFRPSOHWHO\YHQGRUDQGUHVRXUFHVSHFL¿F
DQGPLJKWPHDQWKDWWKHGHSOR\HUKDVWRPDSEHWZHHQWKHSULQFLSDOVDQGUROHV
XVHGLQ(-%VHFXULW\WRZKDWHYHUWKHUHVRXUFHPDQDJHUQHHGV$WWKHVLPSOHVW
OHYHOWKH'HSOR\HUPLJKWVSHFLI\DQDPHDQGSDVVZRUGWKDW¶OOOHWDQ\ERG\LQ
UHVDXWK!%HDQ UHVDXWK!
%HDQDXWKRUL]DWLRQPHDQVWKHSURJUDPPHUXVHVWKHRYHUORDGHGYHUVLRQRI
JHW&RQQHFWLRQ WKDWWDNHVDQDPHDQGDSDVVZRUG
&RQQHFWLRQFRQQ GVJHW&RQQHFWLRQ XVHU1DPHSDVVZRUG
\RXDUHKHUH
PDSSLQJUHVRXUFHV
7KHFRPSOHWHUHVRXUFHPDSSLQJSLFWXUH
IDNH-1',QDPH
UHVRXUFHUHI!&XVW'% UHVRXUFHUHI! DFWXDO-1',QDPH &XVW'DWDEDVH 5($/GDWDEDVHQDPH &XVWRPHU'DWD
sys-admin
,QFRGHWKH%HDQ3URYLGHUGRHV 'HSOR\HUPDSVWKH%HDQ 7KH6\V$GPLQ RUVRPHRQHLQ
D-1',ORRNXSRQD'DWD6RXUFH 3URYLGHU·VPDGHXS UHVRXUFHUHI! WKHRSHUDWLRQDOHQYLURQPHQW
ZKLFKKHXVHVWRJHWDGDWDEDVH QDPHWRWKHDFWXDO-1',QDPH FRQÀJXUHVWKHGDWDEDVHLQWRWKH
FRQQHFWLRQ +HGRHVQ·WNQRZWKH XQGHUZKLFKWKH'DWD6RXUFHLV VHUYHUDQGJLYHVLWD-1',QDPH
UHDO-1',QDPHRIWKHGDWDEDVH UHJLVWHUHG
DQGKH'(),1,7(/<GRHVQ·W
NQRZDFWXDOGDWDEDVHQDPH VR
KHPDNHVRQHXS%XWKHWHOOV
WKHGHSOR\HUZKDWKH·VGRQH
E\GHFODULQJD UHVRXUFHUHI!
HOHPHQWLQWKH''
:KHUHDQGKRZWKHPDSSLQJKDSSHQV
,QWKH(-% ,QDYHQGRU ,QDYHQGRU
'HSOR\PHQW VSHFL¿FZD\ VSHFL¿FZD\
'HVFULSWRU
UHVRXUFHUHI! GDWDEDVH-1', UHDOGDWDEDVH
QDPH
this is the part thatÕs in
spec, and the part you ha the youÕll Þnd out how to do this way out of the scope of
to know on the exam ve mapping from your vendor/ a bean developerÕs job
product documentation
FKDSWHU
DEHDQ¶VHQYLURQPHQW
(-%UHIHUHQFHV
ZKHQDEHDQZDQWVDQRWKHUEHDQ
"EANS WHO NEED OTHER BEANS ARE THE LUCKIEST BEANS IN THE SERVER "UT
REMEMBER BEANS HAVE TO GO THROUGH THE HOME INTERFACE JUST LIKE EVERYBODY
ELSE )F "EAN ! WANTS TO DO A *.$) LOOKUP ON "EAN "S HOME WEVE GOT THE
SAME PROBLEM AS ALWAYSWHATS "EAN "S *.$) NAME !S A "EAN 0ROVIDER
YOURE JUST MAKING ONE UP !T DEPLOY TIME THE $EPLOYER WILL MAP YOUR
FAKE CODED NAME TO THE REAL *.$) NAME MATCHING A BEAN OF THE TYPE YOU
SPECIlED IN THE $$
Òejb/AdviceGiverÓ must go
in the
DD (without the quotes).
Reme
when coding you have no ide mber,
LQDEHDQ·VEXVLQHVVPHWKRG a what
the REAL name will be...
,QLWLDO&RQWH[WLF QHZ,QLWLDO&RQWH[W
2EMHFWR LFORRNXS ³MDYD FRPSHQYHME$GYLFH*LYHU´
$GYLFH+RPHKRPH $GYLFH+RPH 3RUWDEOH5HPRWH2EMHFWQDUURZ R$GYLFH+RPHFODVV
$GYLFHDGYLVRU KRPHFUHDWH
FDOOPHWKRGVRQ$GYLVRU
LQWKH'HSOR\PHQW'HVFULSWRU Be SURE to leave off e
HQWLW\! comp/env/ part, and beth
gin
java:
Þrst subcontext (ejb) wit h the
HMEUHI!
ade-
ProgrammerÕs mthe HMEUHIQDPH!HME$GYLFH*LYHU HMEUHIQDPH!
T
up name. NO me of
real JNDI na HMEUHIW\SH!6HVVLRQ HMEUHIW\SH! this must be either
the bean. Session or Entity
KRPH!KHDG¿UVW$GYLFH+RPH KRPH!
The fully-qualiÞed name of
the home interface
UHPRWH!KHDG¿UVW$GYLFH UHPRWH!
The fully-
HMEUHI! the componqeualiÞed name of
nt interface
HQWLW\!
\RXDUHKHUH
GHSOR\WLPHFXVWRPL]DWLRQ
(-%ORFDOUHIHUHQFHV
5SE THE EJB LOCAL REF TAG IF YOU WANT TO LOOK UP THE BEANS LOCAL HOME
HMEORFDOUHI!
HMEUHIQDPH!HME$GYLFH*LYHU HMEUHIQDPH!
e
The sub-elementsearlocal HMEUHIW\SH!6HVVLRQ HMEUHIW\SH!
different for th -home>
interfaces: <local and <local>
ORFDOKRPH!KHDG¿UVW$GYLFH+RPH/RFDO ORFDOKRPH!
instead of <h om e> ORFDO!KHDG¿UVW$GYLFH/RFDO ORFDO!
in st ea d of <rem ot e>
HMEORFDOUHI!
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: ) UNDERSTAND THE ELEMENT NAMES FOR HOME AND
UHVUHI
W\S
LOCAL
HOME -AKES SENSE "UT WHATS UP WITH REMOTE 127EHD H!PXVW
PHVVDJ
AND LOCAL 3HOULDNT IT BE COMPONENT AND LOCAL
GULYHQE H
7KH UHVU HDQ
COMPONENT HIW\SH!H
³6HVVLRQ´ OHPHQWFD
RU³(QWLW\´ QE
DQ\RQHOH 7KDW¶VLW+ HHLWKHU
WDORQHDE RZFRXOG
A: 9OU CAN RUN FROM YOUR PAST BUT YOU CANT HIDE "EFORE
VDJHGULYH
GULYHQEHD
QEHDQ"5
QVGRQ¶WK
HDQORRNX
HPHPEHU
SDPHV
PHVVDJH
%*" THERE WAS NO CONCEPT OF LOCAL INTERFACES 3O THE KDYHKRP DYHFOLHQWV
CLIENT VIEW WAS ALWAYS CALLED (OME AND 2EMOTE !LTHOUGH HV7KHUH 7KH\GRQ
XSLQ-1' ¶VQRLQWHUI ¶W
,6RGRQ¶W DFH
EVEN THAT WAS AN INCONSISTENT NAME SCHEME SINCE BOTH THE EHWULFNHG WRORRN
HOME AND THE BUSINESS METHOD INTERFACE WERE 2EMOTE AS
IN JAVARMI2EMOTE "UT ONCE LOCAL INTERFACES CAME ON THE
SCENE THINGS GOT A BIT MORE COMPLICATED h,ETS SEE WE CAN
NAME THE LOCAL HOME hLOCAL
HOMEv AND THEN WELL NAME THE
LOCAL REMOTE hLOCAL
REMOTEv 3EE THE PROBLEM 3O WITH %*"
WE STOPPED CALLING THE BUSINESS INTERFACE hTHE REMOTE
INTERFACEv AND STARTED CALLING IT hTHE COMPONENT INTERFACEv
!ND NOW WE CALL THEM hLOCAL COMPONENT INTERFACESv AND
hREMOTE COMPONENT INTERFACESv
<RXGR127VSHFLI\WK
EHDQW\SHLQ HMEUHI!
H
QNWKDW\RXVKRXOG
Q: 5M YOU STILL DIDNT ANSWER MY QUESTION (OW COME
%XWLVLV62WHPSWLQJWRWKL
<RXSXWLQ21/<WKHKRPH
DQGFRPSRQHQW
DQEXWQRWWKHEHDQ
THE TAG STILL SAYS hREMOTEv FOR THE REMOTE COMPONENT LQWHUIDFHW\SHVIRUWKHEH
EHD QW\ SH"7KLQNDERXWWKH
INTERFACE AND hLOCALv FOR THE LOCAL COMPONENT INTERFACE FODVV:K\QRWWKH
LQNDERXWKRZWLJKWO\
ÀH[LELOLW\WKLVJLYHV\RX7K
DQG'HSOR\HUZRXOG
FRXSOHGWKH%HDQ3URYLGHU
A: "ECAUSE OF THE PAST "ACKWARD COMPATIBILITY AND QHHGWREHLIWKH %HD Q3 URY LGHUKDGWRNQRZWKH
Q
ALL THAT )N %*" THE EJB
REF TAGS SAID HOME AND H[DFWFODVVW\SHRIWKHEHD
REMOTE SO THEY STILL DO 4HE NAMING SCHEME IS BASICALLY
THIS h4HE COMPONENT INTERFACE IS EITHER LOCAL OR REMOTE
)F THE TAG
DOESNT EXPLICITLY SAY hHOMEv THEN YOURE
TALKING ABOUT THE COMPONENT INTERFACE 4HESE QUIRKY LITTLE
INCONSISTENCIES ARE JUST PART OF %*"S CHARM
FKDSWHU
DEHDQ¶VHQYLURQPHQW
8VLQJ HMEOLQN!ZLWK(-%UHIHUHQFHV
)F THE !PPLICATION !SSEMBLER SEES THAT ONE BEANS %*" REFERENCE IT
TO ANOTHER BEAN IN THE SAME APPLICATION SHE SHOULD USE THE EJB
LINK TO LINK THE EJB
REF TO ANOTHER BEAN SPECIl ED IN THE DEPLOYMENT
DESCRIPTOR 4HINK OF EJB
LINK AS A KIND OF hJUMP TO THIS LABELv THING
WHERE THE VALUE OF THE LINK MATCHES THE VALUE OF AN EJB
NAME
HMEOLQN!YDOXHV0867
ELEMENT SOMEWHERE ELSE PDWFKWKHYDOXHRIVRPH
6RPHZKHUHLQWKH'' 27+(5EHDQ·V HMEQDPH!
HQWLW\! $QGUHPHPEHU HMEQDPH!
LVQRWKLQJPRUHWKDQDODEHO
HMEUHI!
HMEUHIQDPH!HME$GYLFH*LYHU HMEUHIQDPH! LQWKH'',WGRHVQ·WKDYH
HMEUHIW\SH!6HVVLRQ HMEUHIW\SH! WRPDWFKWKHFODVVQDPH
KRPH!KHDG¿UVW$GYLFH+RPH KRPH! LQWHUIDFHQDPH-1',QDPH
UHPRWH!KHDG¿UVW$GYLFH UHPRWH!
HMEOLQN!$GYLFH(-% HMEOLQN!
RUDQ\WKLQJHOVH,W·VMXVW
HMEUHI!
The <ejb-link> MUST match the
WKHODEHOLQWKH''IRUD
value of an <ejb-name> for some SDUWLFXODUEHDQ
HQWLW\! other bean in this DD (or another
DD in the same J2EE app). 1RERG\EXW\RXUFRZRUNHUV
6RPHZKHUHHOVH ZLOOFDUHLI\RXQDPH\RXU
LQWKH'' EHDQVDIWHUVD\\RXUSHWV
VHVVLRQ!
HMEQDPH!$GYLFH(-% HMEQDPH!
Remember, <ejb-name> is just a label in the DD, for
VHVVLRQ! other parts of the DD to refer to. ItÕs not the real
BEAN class name or anything (unless you happen to
make your ejb-name the same as the bean class).
'' ZKLFKPHDQV
QLTXHZLWKLQDVLQJOH
HMEQDPH!PXVWEHX
DVLQJOHHMEMDU EXWQ
RWZLWKLQDVLQJOH-
(( DSS
H!
XVWKDYHXQLTXH HMEQDP
12 7P HDQ DOOEH DQV LQWKHVDPH-((DSSP EMDUD QG HDF KR I
%XWWKLVG RHV LWKRQH''SHUHM
DYHPXOWLSOHHMEMDU¿OHVZ OHP
YDOXHV$VLQJOHHDUFDQK KEXW7+ (1 WKH UH¶V DS URE
HWKHVDPH HMEQDPH!$
WKH''¶VLQWKHDSSFDQKDY WLUHDSSQRWMXVWWKHFXUUHQW''IRUDPDWF
KLQJ
LQN !Z KLFKOR RNV LQWKH HQ QWLFDO HME QDPH!
ZLWK H MEO WKHDSSZLWK LGH
,I\RX'2KDYHWZR''¶VLQ QN¶V
HMEQDPH!1RWWRZRUU\ V\QWD[WRDGGWKHSDWKW RWKHH MEMDUZ KHU HWK LVOL
HD OWHUQDW H HME OLQN! UUHQ W''¶V MDU
HQWULHVXVHWK UHODWLYHWRWKHFX
LQJ H MEQ DP H!OLYH V7 KHSDWK IROORZHGE\³´ LV
PDWFK MEOLQN!
DGYLFHMDU$GYLFH(-% H
HMEOLQN!FXVW6HUYLFHV
\RXDUHKHUH
GHSOR\WLPHFXVWRPL]DWLRQ
5HVRXUFHHQYLURQPHQWUHIHUHQFHV
WKLQN -06GHVWLQDWLRQV
!S A "EAN 0ROVIDER YOU CAN LOOK UP TWO DIFFERENT KINDS OF RESOURCE
RELATED
THINGS IN *.$) A RESOURCE MANAGER CONNECTION FACTORY REFERENCE AND A
REFERENCE TO SOMETHING KNOWN AS AN ADMINISTERED OBJECT 4HE MAIN DIFFERENCE
IS THAT A RESOURCE ENVIRONMENT REFERENCE IS TO A THING YOU WANT NOT THE
FACTORY THAT GIVES YOU A CONNECTION TO THE THING YOU WANT )N OTHER WORDS
THE ADMINISTERED OBJECT IS THE DESTINATION WHEREAS A RESOURCE MANAGER
CONNECTION FACTORY REFERENCE IS JUST THE lRST STEP IN GETTING WHAT YOU REALLY
WANT A CONNECTION
"UT TODAY JUST DO A MENTAL SEARCH AND REPLACE IN YOUR MIND SO THAT
EVERYWHERE YOU SEE RESOURCE ENVIRONMENT REFERENCE YOU SUBSTITUTE *-3
DESTINATION "ECAUSE THATS PRETTY MUCH ALL YOULL USE IT FOR NOW 9ES THEY
COULD HAVE CALLED IT h*-3 DESTINATION REFERENCEv BUT THAT WOULD BE TOO
LIMITING FOR THE FUTURE .OT TO MENTION TOO CLEAR UNAMBIGUOUS AND
MEANINGFUL TO HAVE ANY VALUE WHATSOEVER AS A COGNITIVE CHALLENGE
LQDEHDQ·VEXVLQHVVPHWKRG
,QLWLDO&RQWH[WLF QHZ,QLWLDO&RQWH[W
2EMHFWR LFORRNXS ³MDYD FRPSHQYMPV1HZ&XVWRPHU4XHXH´
MDYD[MPV4XHXHFXVW4 MDYD[MPV4XHXH R
XVHWKHFXVW4
YouÕre now tired of he
LQWKH'HSOR\PHQW'HVFULSWRU that you need to leave arofing
HQWLW\! java:comp/env/ part, and f the
with the Þrst subcontext begin
UHVRXUFHHQYUHI! (jms)
ProgrammerÕs e. UHVRXUFHHQYUHIQDPH!MPV1HZ&XVWRPHU4XHXH UHVRXUFHHQYUHIQDPH!
made-up nam
NOT the read UHVRXUFHHQYUHIW\SH!MDYD[MPV4XHXH UHVRXUFHHQYUHIW\SH!
JNDI name of
the Queue This could also be
UHVRXUFHHQYUHI! javax.jms.Topic
(youÕre not limit
ed
HQWLW\!
destinations, but to just JMS
th
standard thing w atÕs the only
e have right now
.
FKDSWHU
DEHDQ¶VHQYLURQPHQW
*MIV8ZW^QLMZIVL)XXTQKI\QWV)[[MUJTMZ
ZM[XWV[QJQTQ\aNWZ\PM,MXTWaUMV\,M[KZQX\WZ
'RQ¶WZRUU\DERXWPHPRUL]LQJDOORIWKHVHQRZ,WZLOOPDNHPRUH
VHQVHDVZHJHWIDUWKHULQWRWKHWRSLFV)RUQRZLW¶V2.IRU\RXWR
KDYHMXVWDQRYHUDOOFRQFHSWRIZKDWHDFKLVUHVSRQVLEOHIRU
Annie puts in mostly thing s
be an s
about how two or more her in
Bill puts in mostly ot
are related to one an etimes
things that are related the application, and som info
to the code in the bean she customizes the bean ion.
classes for a particular applicat
%HDQ3URYLGHU $SSOLFDWLRQ$VVHPEOHU
EHDQQDPH 0RGLILFDWLRQVWR%HDQ3URYLGHULQIRUPDWLRQ
IXOO\TXDOLILHGQDPHRIEHDQFODVVDQG YDOXHVRIHQYLURQPHQWHQWULHV
KRPHDQGFRPSRQHQWLQWHUIDFHV GHVFULSWLRQILHOGV FKDQJHRUFUHDWH
EHDQW\SH VHVVLRQHQWLW\HWF UHODWLRQVKLSQDPHPRGLILFDWLRQV
UHHQWUDQF\ IRUHQWLW\EHDQVRQO\ PHVVDJHGULYHQEHDQPHVVDJHVHOHFWRU
VWDWHPDQDJHPHQWIRUVHVVLRQEHDQV PD\UHVWULFWEXWQRWUHSODFH
VWDWHOHVVRUVWDWHIXO
WUDQVDFWLRQGHPDUFDWLRQW\SH EHDQRU $SSOLFDWLRQ$VVHPEO\LQIRUPDWLRQ DOO
FRQWDLQHU RSWLRQDO
HQWLW\EHDQSHUVLVWHQFHPDQDJHPHQW ELQGLQJHQWHUSULVHEHDQUHIHUHQFHV LH
EHDQRUFRQWDLQHU OLQNLQJRQHEHDQWRDQRWKHULQWKHVDPH
SULPDU\NH\FODVV HMEMDURU-((DSS
IRU&03DEVWUDFWVFKHPDQDPH&03 VHFXULW\UROHV WKHUHFRPPHQGHGUROHVIRU
ILHOGV&05UHODWLRQVKLSVILQGHUDQGVHOHFW FOLHQWVRIWKHEHDQV
TXHULHV PHWKRGSHUPLVVLRQV DUHODWLRQVKLS
UHVRXUFHPDQDJHUFRQQHFWLRQIDFWRU\ EHWZHHQVHFXULW\UROHVDQGPHWKRGVRIWKH
UHIHUHQFHV KRPHDQGFRPSRQHQWLQWHUIDFHRIWKHEHDQ
HQYLURQPHQWHQWU\GHFODUDWLRQV OLQNLQJVHFXULW\UROHUHIHUHQFHVWRVHFXULW\
UROHV
(-%UHIHUHQFHV ORFDODQGUHPRWH
VHFXULW\LGHQWLW\W\SH FDOOHURUUXQDV
VHFXULW\UROHUHIHUHQFHV
WUDQVDFWLRQDWWULEXWHVIRUPHWKRGVRID&07
IRUPHVVDJHGULYHQEHDQV GHVWLQDWLRQ
EHDQ
PHVVDJHVHOHFWRUDQGDFNQRZOHGJHPHQW
PRGH
\RXDUHKHUH
WKH'HSOR\HU¶VUHVSRQVLELOLWLHV
,MXTWaMZZM[XWV[QJQTQ\aNWZ\PM
,MXTWaUMV\,M[KZQX\WZ
0RGLILFDWLRQVWR%HDQ3URYLGHULQIRUPDWLRQ
HQVXUHOHJDOYDOXHVIRUDOOHQYLURQPHQWHQWULHV
2WKHUWDVNVUHODWHGWRWKHGHSOR\PHQWGHVFULSWRU$OODUHGRQHLQ
DYHQGRUVSHFLILFWRRODQG127DSDUWRIWKHHMEMDUGHSOR\PHQW
GHVFULSWRU
6(&85,7<
DVVLJQRIWKHVHFXULW\GRPDLQDQGSULQFLSDOUHDOPWRWKHDSS
'HSOR\HU DVVLJQSULQFLSDOVDQGRUJURXSVWRVHFXULW\UROHVEXW127WKHVHFX
ULW\UROHUHIHUHQFHV
SULQFLSDOGHOHJDWLRQIRULQWHUFRPSRQHQWFDOOV LHFRQILJXULQJWKH
UXQDVSULQFLSDO
(6285&(0$1$*(5&211(&7,21)$&725,(6
7KH'HSOR\HU
GRHVWKLQJV ELQGLQJRIUHVRXUFHPDQDJHUFRQQHFWLRQIDFWRU\UHIHUHQFHVWRDQ
XVLQJYHQGRU DFWXDOUHVRXUFHPDQDJHUFRQQHFWLRQIDFWRU\LQWKHRSHUDWLRQDO
VSHFLÀFWRROV HQYLURQPHQW
DERXW FRQILJXUDWLRQVLJQRQLQIRIRUFRQWDLQHUDXWKRUL]HGUHVRXUFHDFFHVV
<RXPLJKWVHHDTXHVWLRQ
VUH ODWHG
WKHGHSOR\HUDQGWKLQJ
QWG HVF ULSW RU
WRWKHGHSOR\PH -%5()(5(1&(6
QN ³7K HGHSO R\H ULV Q¶W
DQGWKL
WKH
VXSSRVHGWRWRXFKWKLQJVLQ HQVXUHWKDWDOO(-%UHIHUHQFHVDUHERXQGWRWKHKRPHVRIEHDQV
DQ¶WEH KLV MRE ´
''VRWKLVF WKDWH[LVWLQWKHRSHUDWLRQDOHQYLURQPHQW
YH
%XWWKHGHSOR\HUGRHVKD
VUH ODWH G HQVXUHWKDWWKHWDUJHWEHDQLVW\SHFRPSDWLEOHZLWKWKHW\SHV
DORWRIUHVSRQVLELOLWLH
KH '' VR ORR N GHFODUHGLQWKH(-%UHIHUHQFH
WRWKLQJVLQW
RIWKH
FDUHIXOO\DWWKHGHVFULSWLRQ
WDVN
(6285&((19,5210(175()(5(1&(6 -06WRSLFRUTXHXH
)RUH[DPSOHZKRPDSV
OH
VHFXULW\UROHVWRVHFXULW\UR HQVXUHWKDWDOOGHFODUHGUHVRXUFHUHIHUHQFHVDUHERXQGWRREMHFWV
$S S$ VVH PEOHU
UHIHUHQFHV"7KH WKDWH[LVWLQWKHRSHUDWLRQDOHQYLURQPHQWDQGHQVXUHWKDWWKHWDUJHW
SU LQF LSD OVW RV HFX ULW\
:KRPDSV REMHFWLVW\SHFRPSDWLEOHZLWKWKHGHFODUHGW\SH
UROHV"7KH'HSOR\HU
FKDSWHU
DEHDQ¶VHQYLURQPHQW
:MUMUJMZQVO_PWLWM[_PI\
7KLQNDERXWLW
KRZFDQ,SRVVLEO\NQRZWKH
QDPHVRIWKLQJVLQWKHVHUYHUZKHUH
WKLVEHDQPLJKWUXQ",ZULWHFRGH
ZLWKRXWNQRZLQJZKHUHWKHEHDQVZLOO
HQGXS6R,KDYHWRFRGHLQJXHVVHVDERXW
VHFXULW\UROHQDPHVRUWKH-1',QDPHRI
DQRWKHUEHDQP\EHDQLVXVLQJ ,·PWKHRQO\RQHZKR
UHDOO\NQRZVKRZWKHVHUYHULV
FRQÀJXUHGDQGZKDW-1',QDPHV
HYHU\WKLQJKDV$QG,·PWKHRQO\RQH
ZKRNQRZVDERXWWKHVHFXULW\GRPDLQLQ
WKLVFRPSDQ\%XW,GRQ·WNQRZZKDW·VLQWKH
FRGHVR,·PFRXQWLQJRQWKH%HDQ3URYLGHU
%HDQ3URYLGHU WRWHOOPH YLDWKHGHSOR\PHQWGHVFULSWRU
DERXWKLV¶PDGHXS·QDPHVVR,FDQ
PDSWKRVHIDNHQDPHVWRUHDO
QDPHVLQWKHVHUYHU
'HSOR\HU
,KDYHWR
LQWHJUDWHWZRRUPRUH
EHDQV SRVVLEO\IURPGLIIHUHQW
YHQGRUV 6RLI%HDQ$XVHVWKHPDGH
XSVHFXULW\UHIHUHQFH´(PSOR\HHµ
DQG%HDQ%KDVFRGHXVLQJWKHPDGH
XSVHFXULW\UHIHUHQFH´0LQLRQVµ,KDYH
WRPDSWKHPERWKWRDVLQJOHVHFXULW\
UROH´6ODYHVµ7KH%HDQ3URYLGHU
GHFODUHVWKHPDGHXSQDPHLQWKH''
7KDW·VKRZKHWHOOVPHZKDWKH·V
GRQHLQWKHFRGH
$SSOLFDWLRQ
$VVHPEOHU
\RXDUHKHUH
GHSOR\WLPHFXVWRPL]DWLRQ
6W_TM\¼[TWWSI\\PMJMIV¼[Z]V\QUMMV^QZWVUMV\
7ERE ALMOST DONE WITH THE BEANS WORLD .OW THAT WEVE SEEN THE BEANSSPECIAL
*.$) ENVIRONMENT WE STILL HAVE A FEW MORE LITTLE DETAILS ON THE BEANS RUNTIME
ENVIRONMENT %ACH OF THESE IS COVERED BY THE EXAM OBJECTIVES SO DONT FALL ASLEEP
NOW 7ERE ALMOST DONE
*XDUDQWHHG$3,V
<RXPXVWZKLFK$3,VDUHDQGDUHQRWJXDUDQWHHGWREHSDUWRI
HYHU\(-%FRQWDLQHU)RUH[DPSOH-06LVVXSSRUWHG-;7$LV
QRW
*XDUDQWHHGVHUYLFHV
<RXPXVWNQRZZKDWLVDQGLVQRWJXDUDQWHHGWREHVXSSRUWHG
E\HYHU\(-%FRQWDLQHU)RUH[DPSOHWUDQVDFWLRQVXSSRUWLV
JXDUDQWHHGORDGEDODQFLQJLVQRW
6WUXFWXUHRIWKHHMEMDU
0D\EHWKLVLVQ·WUHDOO\DUXQWLPHHQYLURQPHQWWKLQJEXWZHGLGQ·W
KDYHDQRWKHUJRRGSODFHWRVWLFNLWDQG\RXKDYHWRNQRZLW
6RKHUHLWLVMXVWLQFDVH\RXGRQ·WUHPHPEHUZKDWZHFRYHUHG
ZDDDDD\EDFNLQFKDSWHU)RUH[DPSOH\RXPXVWNQRZWKDWWKH
DQHMEMDUGRHVQRWKDYHDPDQLIHVWEXW0867KDYHD0(7$,1)
GLUHFWRU\DQGWKDWGLUHFWRU\0867KROGWKHGHSOR\PHQWGHVFULSWRU
:KLFKRK\HV0867EHQDPHG´HMEMDU[POµ
3URJUDPPLQJUHVWULFWLRQV
,I\RXZDQW\RXUEHDQWREHSRUWDEOHWRFRPSDWLEOHZLWKDQ\(-%
FRPSOLDQWFRQWDLQHU\RXPXVWQRWGRDQ\RIWKHWKLQJVRQ
WKHOLVWHYHQLI\RXUYHQGRUDOORZVLW ZKLFKWKHYHQGRUPD\GR
XQLQWHQWLRQDOO\
$QGLW·VQRWMXVWIRUSRUWDELOLW\EXWIRUVDIHW\,I\RXWU\WRPDQDJH
\RXURZQWKUHDGVIRUH[DPSOH\RX·UHVWHSSLQJRQWKH&RQWDLQHU·V
WRHVDQGZKRNQRZVZKDWNLQGRIPHVV\RX·OOHQGXSZLWK<RXGR
QRWZDQWWRPHVVZLWKWKH&RQWDLQHU·VMRE
-XVWEHFDXVH\RXU&RQWDLQHUSHUPLWVLWGRHVQ·WPDNHLWULJKW$QG
IRUWKHH[DP\RXPXVWNQRZZKDW·VUHVWULFWHGLQWKHVSHF
,IWKHH[DPDVNVLIVRPHWKLQJLVSRVVLEOHDQGLW·VRQHRIWKH
H[SOLFLWO\UHVWULFWHGWKLQJVLQWKHVSHF\RXPXVWVD\12HYHQLI
\RXUYHQGRUOHWV\RXGRLW$VIDUDVWKHH[DPLVFRQFHUQHGLI\RX
FDQ·WGRLWDQGUHPDLQSRUWDEOH\RXFDQ·WGRLW
FKDSWHU
DEHDQ¶VHQYLURQPHQW
?PQKP)81[LWM[-2*O]IZIV\MM'
6XSSRUWHG$3,V
-6(VXS
-DYD6WDQGDUG(GLWLRQY -6( -DYD
SRUWLV
127
-1',$3,
-XVWEHFDX
VHDQ$3,LV
-7$H[WHQVLRQ WKH8VHU7UDQVDFWLRQ -6(VWDQG
DUGOLEUDU\I
LQWKH
LQWHUIDFHRQO\ GRHVQ RUYHUVLRQ
RWPHDQWK
JXDUDQWHHG DW$3,LV
IRU(-%7
-'%&H[WHQVLRQ VSHFUHTXLU
HV
KH(-%
VRLI\R RQO\-6(YHUVLRQ
-06H[WHQVLRQ XZULWHDE
UHOLHVRQVR HDQWKDW
PH
\RXUEHDQLV WKLQJLQ-6(
-DYD0DLOVHQGLQJPDLORQO\ EHSRUWDEOH
QRWJXDUDQ
WHHGWR
DFURVVDQ
-$;3 FRQWDLQHU \(-%
7KDWPHDQ
VIRUH[DP
WKDWWKH-D SOH
YD&U\SWRJ
([WHQVLRQ UDSK\
-&( $3,VD
JXDUDQWHHG UHQRW
<RXGRQ¶WKDYHWRPHPRUL]HDOORI WREHVXSS
(-%H RUWHGE\
WKHH[DFWYHUVLRQQXPEHUV YHQWKRXJK
QRZSDUWR WKH\DUH
IWKH-6(
7KHH[DPLVQ¶WJRLQJWRWULFN\RXRQVRPHWKLQJ DVRIYHUVLR SODWIRUP
Q
DVWULYLDODVUHPHPEHUZKHWKHU-DYD0DLOLVRU
RUZKHWKHUWKH-7$H[WHQVLRQLVRU7KHRQO\
QXPEHUV\RXUHDOO\QHHGWRNQRZ EHVLGHVWKHLQ
(-% DUHWKH-'%&H[WHQVLRQDQGWKDWRQO\
YHUVLRQ QRWQHFHVVDULO\ RI-6(LVJXDUDQWHHG
6KDUSHQ \RXU SHQFLO
-6(
:LWKRXWORRNLQJLWXSZULWH -1',
GRZQZKDWHDFKRIWKHVH
$3,VGR,I\RXGRQ¶WNQRZ -7$
WDNHDJRRGJXHVVEDVHG
RQZKDW\RXNQRZDERXW -'%&
(-%
-06
:H¶OOVWDUW\RXRIIE\JLYLQJ
\RXWKHPRVWGLI¿FXOWRQH
-DYD0DLO sending mail
-$;3
\RXDUHKHUH
PHPRUL]LQJWKH$3,VLQ(-%
$3,VWKD
WDUH
127LQWK
H
(-%VSHF
%HFDUHIXOR
I$3,VWKDW
JXDUDQWHHG DUHQ¶W
6RPH$3
6HUYOHWVRU ,VOLNH
-63DUHJX
E\WKH-( DUDQWHHG
(VSHFEX
WKH(-%VS WQRWE\
HFDQGWKH
FDUHVRQO\D H[DP
THAT ERXWZKDW¶V
E LI V E RS A PIC TURE OP (-%VSHF LQWKH
SENGER D AIL ON T
B T H E * -3 MES A PIECE OF *AVA- :KDW¶VQRW
SDUWRI(-%
"O ITH "
"# CAN W BOX UNDERNEATH +HUHDUHV
HAS A *$ N A M IN G PLJKWWULFN
RPHRIWKH
RQHVWKDW
$) 0
AND A *. CH OF *AX *AVA
\RX
V E RS I T TO A BUN A GED BY A NOW
(E DE LI I S M A N -;7$
ELIVERY ELL SO
A N K FU LLY HIS D A N D A LL GOES W -76
4 H 4!
ON !0) * NCH
4RANSAC TI AKE A HOUR LU L BURN
-LQL NOT guaranteed as
HE GETS T
O T
P IC TURES WIL M -0;
STORY WIT
H T H E
G THE EXA part of EJB 2.0 !!
ZING THIS IER TO RECALL DURIN -&$
MEMORI E A S -63
MAKE IT
IT IN AND 6HUYOHWV
7KLVGHOLYHU\PDQDJHGE\ ,·P
-DYD7UDQVDFWLRQ$3, -7$ ,·P-DFN -DFN ,·P-DFN
JavaMail
Java Messaging
Service (JMS)
TheyÕre
all Jacks
Bob takes a 1.3 hour (JAXP)
lunch (J2SE 1.3)
FKDSWHU
DEHDQ¶VHQYLURQPHQW
6RPHRIWKHNH\JXDUDQWHHG
VHUYLFHVDQGEHKDYLRU
'LVWULEXWHGWUDQVDFWLRQV
7KUHDGVDIHW\
&RQWDLQHUPDQDJHGSHUVLVWHQFHIRUHQWLW\EHDQV
$VHFXULW\GRPDLQDQGRQHSULQFLSDOUHDOP PXOWLSOHUHDOPV
LVQRWJXDUDQWHHG
(QIRUFHFOLHQWDFFHVVVHFXULW\SROLFLHVVSHFLILHGE\WKH
GHSOR\PHQWGHVFULSWRUDQGRWKHUGHSOR\PHQWWRROV
,XVHGWRWKLQNFOXVWHULQJ
,PSOHPHQWDWLRQRIWKHMDYD FRPSHQYHQYLURQPHQWQDPLQJ IDLORYHUDQGORDGEDODQFLQJZHUH
FRQWH[WSURYLGHGWRWKHEHDQ SDUWRIWKHVSHF%XWWKH\DUHQ·W,I
,QHHGWKRVHIHDWXUHV,KDYHWRÀQG
*HQHUDWLRQRIFODVVHVWKDWLPSOHPHQWWKHKRPHDQG DYHQGRUWKDWVXSSRUWVWKHP0DQ\
FRPSRQHQWLQWHUIDFHVDQGVWXEFODVVHVIRUUHPRWHREMHFWV GREXWGRQ·WEHIRROHGLQWRWKLQNLQJ
WKLVLVSDUWRIWKH(-%VSHF
,PSOHPHQWDWLRQRIWKHUHVRXUFHPDQDJHUFRQQHFWLRQ
IDFWRU\FODVVHVIRUUHVRXUFHVFRQILJXUHGZLWKWKHVHUYHU
6RPHWKLQJV
VRXQGJRRG
EXWDUHQ·W
JXDUDQWHHG
U
(YHU\ERG\WDONVDERXWWKHL
DQF HG IDX OW
FOXVWHUHGORDGEDO
VWHP2K \H DK ZLW KIDLO
WROHUDQWV\
WLW\ GD WD ,W·VDOZD\VDERXW
RYHUOD]\ORDGLQJRIHQ
DQGLQPHPRU\G DWDFD FKL QJ \RXUQHHGV
UV
$OWKRXJKPRVW-((YHQGR
SURYLGHRQHRUP RUH RI
Q¶W
WKHVHFDSDELOLWLHVWKH\DUH
JXDUDQWHHGLQWKHVSHF
HUHQFH
%HVXUH\RXNQRZWKHGLII
DQW HHG
EHWZHHQZKDWLVJXDU
RW/RR NLQWKH
DQGZKDWLVQ
WOHG
VSHFXQGHUWKHVHFWLRQVWL
UUHVSR QVL ELOLW\´
³&RQWDLQHU3URYLGH
\RXDUHKHUH
WKHHMEMDU
<RXKDYHWR
NQRZZKDW
?PI\5=;<JMQVIVMRJRIZ' LV127LQWKH
HMEMDU
DW¶V
<RX¶UHH[SHFWHGWRNQRZZK
beans 127LQWKHHMEMDU¿ OH1R WLFH
J" 7KH WKLQJ \RX
ZKDW¶VPLVVLQ
-$5 HFW WR QG
¿ LQD-$5 "+ HUH¶V
H[S
XDOO\
DKLQWLW¶VWKHWKLQJWKDWXV
0( 7$,1) GLU HFW RU\
JRHVLQWKH
HMEMDU '2&7<3(
deployment descriptor W7KH
)LJXUHLWRXW"7KHPDQLIHV
HMEMDU
38%,QF
OHLVQRWUHTX LUHG DV
HMEMDU[PO PDQLIHVW¿
-% <R X& $1 SX WRQ HLQ
RI(
QG XVX DOO\ QR W
EXWLW¶VRSWLRQDOD
QHHGHG
867
<RXDOVRPXVWNQRZZKDW0
LQWKH HME MDU FODVV HV JHQ
QRWEH
U5 HP HP
;\Z]K\]ZMWNIVMRJRIZ HUDWHGE\WKHFRQWDLQH
HUL PS OHP HQW VWK H
EHUWKHFRQWDLQ
QG FRP SRQ HQW LQWHUID FH
KRPHD
WHUIDFHV
DQGPDNHVVWXEVLIWKHLQ
LVG RHV Q¶W KDSSHQ
-$5 DUHUHPRWH7K
HSO R\P HQW VRWK H\ DUHQ¶W
XQWLOG
Q3 URY LGHU
SDUWRIZKDWWKH%HD
$V VHP EOH USX WLQWR
HMEMDU RU$SSOLFDWLRQ
LUG HOLYHUD EOH ²W KH HME MDU¿OH
WKH
The classes MUST 0(7$,1)
FRP
be in a directory
structure that
matches the package.
KHDGILUVW
'2&7<3(
HMEMDU
38%,QF
7KHQDPLQJ
HMEMDU[PO FRQYHQWLRQLV
r
deployment descripto QRWUHTXLUHG
MUST be na me d
T
ejb-jar.xml and MUS
7KHQDPLQJFRQYHQWLR
QIRUDEHDQ
N F LVWRSXWWKHFRPSRQHQ
be in the M ET A -I WKHFRPSRQHQWLQWHUIDF
WQDPHDV
HQDPH
directory
$GYLFHFODVV
WKHQDGGµKRPH¶RUµEH
DQ¶WRFRPH
$GYLFH+RPHFODVV $GYLFH%HDQFODVV XSZLWKWKHRWKHUWZRQ
DPHV:H
VWURQJO\UHFRPPHQGWK
ome and The bean class Þle DW\RXIRO
The beannÕst hinterfaces ORZLW LWPDNHVGHSOR\
PHQWPXFK
e
compon ion and entity HDVLHUDQGOHW¶VRWKHUV
UHDG\RXU
(for sessot message-driven)
FRGH%XWLW¶VQRWDUHT
XLUHPHQW
beans, n
FKDSWHU
DEHDQ¶VHQYLURQPHQW
8ZWOZIUUQVOZM[\ZQK\QWV[
:KDWWRDYRLGLQ(-%LI\RXZDQWWRJXDU
DQWHH\RXUEHDQFDQEHGHSOR\HGRQ$1<
(-%FRPSOLDQWVHUYHU
'RQ·WEHI
RROHG
E\WKLQJVW
KD
RQO\6((0 W
EDG
get security
get sec y <RX¶UHH[SHF
EXWDUHQ·W
ServerSocket
erverSocke
verSo policyy info
inf FDQDQGFDQ¶
WHGWRNQRZ
WGRLQ(-%
ZKDW\RX
WKLQNDERXWL ,I\RX
WWRRPXFK\
SV\FK\RXUVH RXFDQ
OILQWRWKLQNLQJ
H[DP WKDWD RQWKH
Q\WKLQJFRXO
GEHEDG
Read/Write
Read/Writ
ead/ +HUHDUHDIH
ZWKLQJVWKDW
staticc ffiel
ield &$1GRLQ(
XSRQWKHH[
-%WKDWPLJ
DP
\RX
KWWULS\RX
MDYDQHW6R
FNHWSODLQ
load
oad native
ad a nati 6RFNHWVDUH
OLVWHQRQD6
¿QH<RXMX
ROGFOLHQW
VWFDQ¶W
HUYHU6RFNHW
library
ibra ([WHQGDQR
WKHUFODVVIU
EHDQFODVV RP\RXU
AWT output
T for outpp or WDQFHLV2.
QRUPDOMDYD
IRUDEHDQF
LQKHUL
keyboard input
boardd inp
in 0DUNDEHD
ODVV
Q¿HOGVWDWL
¿QDOLQID FDQG
FWWKDW¶VWKH
\RX¶UHVXSSR RQO\ZD\
VHGWRPDUN
Threads
hread ¿HOG VHHWK
UHDGZULWHVW
HUHVWULFWLRQ
DVWDWLF
DERXWQR
DWLF¿HOGV
create
reate gget a
ate or ge
class
ass loader
oade
java.io
va.io
a.io package
pac
pack YiX`e
gfn\i
9OU REALLY WANT TO REMEMBER THESE PROGRAMMING RESTRICTIONS 4HE BEST
WAY TO MAKE THAT HAPPEN 3TOP RIGHT NOW AND THINK ABOUT EACH OF
THESE RESTRICTED THINGS AND COME UP WITH ONE OR MORE REASONS FOR WHY
THE RESTRICTION EXISTS 7HEN YOURE DONE TURN TO PAGE IN THE %*"
SPEC WHERE THESE RESTRICTIONS AND OTHERS ARE DESCRIBED
\RXDUHKHUH
GHSOR\WLPHFXVWRPL]DWLRQ
0HPRUL]H7+,6
([HUFLVH
/RRNLQJDWWKHSLFWXUHEHORZVHHLI\RX
FDQWHOOWKHVWRU\SXWWLQJLQWKH$3,¶V
ZKHUHWKH\EHORQJ:HGLGRQHIRU\RX
j2se 1.3
He takes a 1.3 hour
lunch-break.
Draw the structure of
the JAR Þle here:
8VLQJWKHSLHFHVEHORZ DQG21/<WKHSLHFHV
EHORZ UHDVVHPEOHWKHPLQWRWKHLUFRUUHFW
FRQ¿JXUDWLRQ GUDZLQJOLQHVDVQHHGHG 'UDZ
\RXU¿QLVKHGVWUXFWXUHLQWKHVSDFHDWWKHULJKW
DQGZULWHWKHFRUUHFWQDPHVRQWKHGLUHFWRULHV
DQGQDPHWKH[PO¿OH7KHEHDQLVLQWKH
FRPKHDG¿UVWSDFNDJH
-$5
HMEMDU
'2&7<3(
HMEMDU
38%,QF
BBBBBB[PO
$GYLFHFODVV
$GYLFH+RPHFODVV
$GYLFH%HDQFODVV
FKDSWHU
DEHDQ¶VHQYLURQPHQW
0RFN([DP
7HICH !0)S ARE GUARANTEED TO BE SUPPORTED BY %*" CONTAINERS #HOOSE
1 ALL THAT APPLY
R! *!80
R" *.$)
R# *84!
R$ *$"#
R% *-3
7HATS TRUE ABOUT AN ENTERPRISE BEANS ENVIRONMENT #HOOSE ALL THAT APPLY
2
R! %NVIRONMENT ENTRIES CAN BE UNIQUE FOR INSTANCES OF THE SAME
ENTERPRISE BEAN TYPE
R" 7ITHIN A SINGLE %*" CONTAINER AN %*" CAN HAVE MULTIPLE SETS OF
ENVIRONMENT ENTRIES
R# !N %*"S ENVIRONMENT ENTRYS VALUES CAN BE MODIlED BY THE %*" AT
RUNTIME
R$ %NVIRONMENT ENTRY VALUES MAY BE PRIMITIVES OR WRAPPER TYPES
7HICH !0)S ARE GUARANTEED TO BE SUPPORTED BY %*" CONTAINERS #HOOSE
3 ALL THAT APPLY
R! *3%
R" *!8"
R# *!82
R$ *!80
\RXDUHKHUH
FRIIHHFUDPPRFNH[DP
'IVEN A BEAN NAMED @#USTOMER AND AN ENVIRONMENT ENTRY NAMED @LAST.AME
4 WHICH CODE FRAGMENTS INSIDE OF THE BEAN CLASS WOULD RETURN THE VALUE OF THE
ENVIRONMENT ENTRY #HOOSE ALL THAT APPLY
R! &RQWH[WF QHZ6HVVLRQ&RQWH[W
&RQWH[WH &RQWH[W FORRNXS ³MDYD FRPSHQY´
6WULQJQDPH 6WULQJ HORRNXS ³ODVW1DPH´
R" &RQWH[WF QHZ,QLWLDO&RQWH[W
&RQWH[WH &RQWH[W FORRNXS ³MDYD FRPSHQY
&XVWRPHU´
6WULQJQDPH 6WULQJ HORRNXS ³ODVW1DPH´
R# &RQWH[WH QHZ/RRNXS ³MDYD FRPSHQY´
&RQWH[WF QHZ,QLWLDO&RQWH[W H
6WULQJQDPH 6WULQJ FORRNXS ³ODVW1DPH´
R$ &RQWH[WF QHZ,QLWLDO&RQWH[W ³&XVWRPHU´
&RQWH[WH &RQWH[W FORRNXS ³MDYD FRPSHQY´
6WULQJQDPH 6WULQJ HORRNXS ³ODVW1DPH´
R% &RQWH[WF QHZ,QLWLDO&RQWH[W
&RQWH[WH &RQWH[W FORRNXS ³MDYD FRPSHQY´
6WULQJQDPH 6WULQJ HORRNXS ³ODVW1DPH´
7HEN PROGRAMMING A SESSION BEAN CLASS WHICH TECHNIQUES SHOULD ALWAYS BE
5 AVOIDED TO ENSURE BEAN PORTABILITY ACROSS ALL %*" CONTAINERS #HOOSE ALL
THAT APPLY
R! 5SING THE MDYDQHW6RFNHW CLASS
R" 5SING INNER CLASSES
R# 5SING THE @lNAL MODIlER FOR lELDS
R$ 0ASSING @THIS AS AN ARGUMENT
FKDSWHU
DEHDQ¶VHQYLURQPHQW
7HICH OF THE FOLLOWING ARE VALID DATA TYPES IN A HQYHQWU\W\SH! ELEMENT
6 IN A BEANS DEPLOYMENT DESCRIPTOR #HOOSE ALL THAT APPLY
R! E\WH
R" VKRUW
R# $UUD\/LVW
R$ MDYDODQJ%RROHDQ
R% MDYDODQJ&KDUDFWHU
7HEN PROGRAMMING %*"S WHICH DECLARATIONS SHOULD BE AVOIDED TO ENSURE
7 BEAN PORTABILITY ACROSS ALL %*" CONTAINERS #HOOSE ALL THAT APPLY
R! ¿QDOLQW[
R" VWDWLFLQW[
R# ¿QDOVWDWLFLQW[
R$ ¿QDOWUDQVLHQWLQW[
7HO IS TYPICALLY RESPONSIBLE FOR SPECIFYING lNDER AND SELECT QUERIES IN THE
8 BEANS DEPLOYMENT DESCRIPTOR
R! 4HE BEAN PROVIDER
R" 4HE APPLICATION ASSEMBLER
R# 4HE DEPLOYER
R$ 4HE SYSTEM ADMINISTRATOR
R% 4HE SERVER PROVIDER
7HICH DEPLOYMENT DESCRIPTOR ELEMENTS WOULD BE USED WHEN OBTAINING A
9 *$"# CONNECTION #HOOSE ALL THAT APPLY
R! HMEUHI!
R" HMEOLQN!
R# UROHQDPH!
R$ HQYHQWU\!
R% UHVRXUFHUHI!
\RXDUHKHUH
FRIIHHFUDPPRFNH[DP
7HO WILL TYPICALLY MERGE MULTIPLE EJB JAR lLES INTO A SINGLE EJB JAR lLE
10
R! 4HE BEAN PROVIDER
R" 4HE APPLICATION ASSEMBLER
R# 4HE DEPLOYER
R$ 4HE SYSTEM ADMINISTRATOR
R% 4HE SERVER PROVIDER
7HICH DEPLOYMENT DESCRIPTOR ELEMENTS WOULD BE USED BY A BEAN PROVIDER TO
11 LOCATE THE HOME INTERFACES OF OTHER %*"S #HOOSE ALL THAT APPLY
R! HMEUHI!
R" UHVW\SH!
R# HQYHQWU\!
R$ UROHQDPH!
R% UHVRXUFHUHI!
7HICH ARE BEAN PROVIDER RESPONSIBILITIES CONCERNING RESOURCE MANAGER
12 CONNECTION FACTORY REFERENCES #HOOSE ALL THAT APPLY
R! #ONlGURE RESOURCE MANAGERS IN THE %*" SERVER
R" #ONlGURE SIGN
ON INFORMATION FOR THE RESOURCE MANAGER
R# !SSIGN SUCH A REFERENCE TO THE DEPLOYMENT DESCRIPTOR
R$ #REATING A SYMBOLIC LINK TO *.$)
4HE EJB
JAR lLE IS CONSIDERED TO BE PART OF THE CONTRACT BETWEEN WHICH PAIRS
13 #HOOSE ALL THAT APPLY
R! BEAN PROVIDER AND SYSTEM ADMINISTRATOR
R" BEAN PROVIDER AND APPLICATION ASSEMBLER
R# APPLICATION ASSEMBLER AND DEPLOYER
R$ APPLICATION ASSEMBLER AND SYSTEM ADMINISTRATOR
R% DEPLOYER AND SYSTEM ADMINISTRATOR
FKDSWHU
DEHDQ¶VHQYLURQPHQW
7HICH CLASS lLES MUST BE INCLUDED EITHER DIRECTLY OR BY REFERENCE IN EVERY EJB
14 JAR lLE #HOOSE ALL THAT APPLY
R! 4HE ENTERPRISE BEAN CLASS
R" 4HE STUB CLASS FOR THE %*"/BJECT INTERFACE
R# 4HE ENTERPRISE BEANS SUPER CLASSES
R$ !NY *3% CLASSES USED AS ARGUMENTS OR RETURN TYPES
7HICH ROLE IS TYPICALLY RESPONSIBLE FOR DECLARING THE RESOURCE CONNECTION
15 FACTORY REFERENCES IN THE DEPLOYMENT DESCRIPTOR
R! BEAN PROVIDER
R" APPLICATION ASSEMBLER
R# DEPLOYER
R$ CONTAINER PROVIDER
R% SYSTEM ADMINISTRATOR
7HATS TRUE ABOUT A LEGAL EJB
JAR lLE #HOOSE ALL THAT APPLY
16
R! )T MUST CONTAIN BOTH A HOME INTERFACE AND A COMPONENT INTERFACE
R" 4HE DEPLOYMENT DESCRIPTOR IS OPTIONAL
R# )T MUST CONTAIN ANY *%% CLASSES USED BY THE BEAN
R$ 4HE ENTERPRISE BEAN CLASS IS OPTIONAL
7HICH ROLE WOULD TYPICALLY SET UP RESOURCE MANAGER SIGN
ON INFORMATION
17
R! BEAN PROVIDER
R" APPLICATION ASSEMBLER
R# DEPLOYER
R$ CONTAINER PROVIDER
R% SYSTEM ADMINISTRATOR
\RXDUHKHUH
PRFNH[DPDQVZHUV
0RFN([DP$QVZHUV
7HICH !0)S ARE GUARANTEED TO BE SUPPORTED BY %*" CONTAINERS #HOOSE (spec: 493)
1 ALL THAT APPLY
R! *!80
R" *.$)
R# *84!
R$ *$"#
R% *-3
)
2 7HATS TRUE ABOUT AN ENTERPRISE BEANS ENVIRONMENT #HOOSE ALL THAT APPLY (spec: 410-412
R! %NVIRONMENT ENTRIES CAN BE UNIQUE FOR INSTANCES OF THE SAME
ENTERPRISE BEAN TYPE
R" 7ITHIN A SINGLE %*" CONTAINER AN %*" CAN HAVE MULTIPLE SETS OF
ENVIRONMENT ENTRIES
R# !N %*"S ENVIRONMENT ENTRYS VALUES CAN BE MODIlED BY THE %*" AT
RUNTIME
R$ %NVIRONMENT ENTRY VALUES MAY BE PRIMITIVES OR WRAPPER TYPES - Only Strings and Wrappers
)
3 7HICH !0)S ARE GUARANTEED TO BE SUPPORTED BY %*" CONTAINERS #HOOSE (spec: 496-497
ALL THAT APPLY
R! *3%
R" *!8"
R# *!82
R$ *!80
FKDSWHU
DEHDQ¶VHQYLURQPHQW
4 'IVEN A BEAN NAMED @#USTOMER AND AN ENVIRONMENT ENTRY NAMED @LAST.AME
WHICH CODE FRAGMENTS INSIDE OF THE BEAN CLASS WOULD RETURN THE VALUE OF THE
(spec: 411-412)
ENVIRONMENT ENTRY #HOOSE ALL THAT APPLY
R! &RQWH[WF QHZ6HVVLRQ&RQWH[W - SessionContext is not the sam
e as JNDI Context
&RQWH[WH &RQWH[W FORRNXS ³MDYD FRPSHQY´
6WULQJQDPH 6WULQJ HORRNXS ³ODVW1DPH´
R" &RQWH[WF QHZ,QLWLDO&RQWH[W
&RQWH[WH &RQWH[W FORRNXS ³MDYD FRPSHQY
&XVWRPHU´
6WULQJQDPH 6WULQJ HORRNXS ³ODVW1DPH´
R# &RQWH[WH QHZ/RRNXS ³MDYD FRPSHQY´
&RQWH[WF QHZ,QLWLDO&RQWH[W H
6WULQJQDPH 6WULQJ FORRNXS ³ODVW1DPH´
R$ &RQWH[WF QHZ,QLWLDO&RQWH[W ³&XVWRPHU´ - no argument here
&RQWH[WH &RQWH[W FORRNXS ³MDYD FRPSHQY´
6WULQJQDPH 6WULQJ HORRNXS ³ODVW1DPH´
R% &RQWH[WF QHZ,QLWLDO&RQWH[W
&RQWH[WH &RQWH[W FORRNXS ³MDYD FRPSHQY´
6WULQJQDPH 6WULQJ HORRNXS ³ODVW1DPH´
)
5 7HEN PROGRAMMING A SESSION BEAN CLASS WHICH TECHNIQUES SHOULD ALWAYS BE (spec: 494-495
AVOIDED TO ENSURE BEAN PORTABILITY ACROSS ALL %*" CONTAINERS #HOOSE ALL
THAT APPLY
R! 5SING THE MDYDQHW6RFNHW CLASS - client Sockets are
R" 5SING INNER CLASSES just not a ServerSocOK
ket
,
R# 5SING THE @lNAL MODIlER FOR lELDS
R$ 0ASSING @THIS AS AN ARGUMENT
\RXDUHKHUH
PRFNH[DPDQVZHUV
7HICH OF THE FOLLOWING ARE VALID DATA TYPES IN A HQYHQWU\W\SH! ELEMENT (spec: 413)
6 IN A BEANS DEPLOYMENT DESCRIPTOR #HOOSE ALL THAT APPLY
R! E\WH
R" VKRUW
R# $UUD\/LVW
R$ MDYDODQJ%RROHDQ
- only Wrappers and Strings are supported
R% MDYDODQJ&KDUDFWHU
7HEN PROGRAMMING %*"S WHICH DECLARATIONS SHOULD BE AVOIDED TO ENSURE (spec: 494)
7 BEAN PORTABILITY ACROSS ALL %*" CONTAINERS #HOOSE ALL THAT APPLY
R! ¿QDOLQW[
R" VWDWLFLQW[ - statics should also be Þnal
R# ¿QDOVWDWLFLQW[
R$ ¿QDOWUDQVLHQWLQW[
)
8 7HO IS TYPICALLY RESPONSIBLE FOR SPECIFYING lNDER AND SELECT QUERIES IN THE (spec: 456-457
BEANS DEPLOYMENT DESCRIPTOR
R! 4HE BEAN PROVIDER
R" 4HE APPLICATION ASSEMBLER
R# 4HE DEPLOYER
R$ 4HE SYSTEM ADMINISTRATOR
R% 4HE SERVER PROVIDER
9 7HICH DEPLOYMENT DESCRIPTOR ELEMENTS WOULD BE USED WHEN OBTAINING A (spec: 424)
*$"# CONNECTION #HOOSE ALL THAT APPLY
R! HMEUHI!
R" HMEOLQN!
R# UROHQDPH!
R$ HQYHQWU\!
R% UHVRXUFHUHI!
FKDSWHU
DEHDQ¶VHQYLURQPHQW
7HO WILL TYPICALLY MERGE MULTIPLE EJB JAR lLES INTO A SINGLE EJB JAR lLE (spec: 458)
10
R! 4HE BEAN PROVIDER
R" 4HE APPLICATION ASSEMBLER
R# 4HE DEPLOYER
R$ 4HE SYSTEM ADMINISTRATOR
R% 4HE SERVER PROVIDER
7HICH DEPLOYMENT DESCRIPTOR ELEMENTS WOULD BE USED BY A BEAN PROVIDER TO
11 LOCATE THE HOME INTERFACES OF OTHER %*"S #HOOSE ALL THAT APPLY (spec: 416)
R! HMEUHI!
R" UHVW\SH!
R# HQYHQWU\!
R$ UROHQDPH!
R% UHVRXUFHUHI!
12 7HICH ARE BEAN PROVIDER RESPONSIBILITIES CONCERNING RESOURCE MANAGER
(spec: 421)
CONNECTION FACTORY REFERENCES #HOOSE ALL THAT APPLY
R! #ONlGURE RESOURCE MANAGERS IN THE %*" SERVER
R" #ONlGURE SIGN
ON INFORMATION FOR THE RESOURCE MANAGER
R# !SSIGN SUCH A REFERENCE TO THE DEPLOYMENT DESCRIPTOR
R$ #REATING A SYMBOLIC LINK TO *.$)
13 4HE EJB JAR lLE IS CONSIDERED TO BE PART OF THE CONTRACT BETWEEN WHICH PAIRS (spec: 487)
#HOOSE ALL THAT APPLY
R! BEAN PROVIDER AND SYSTEM ADMINISTRATOR
R" BEAN PROVIDER AND APPLICATION ASSEMBLER
R# APPLICATION ASSEMBLER AND DEPLOYER
R$ APPLICATION ASSEMBLER AND SYSTEM ADMINISTRATOR
R% DEPLOYER AND SYSTEM ADMINISTRATOR
\RXDUHKHUH
PRFNH[DPDQVZHUV
14 7HICH CLASS lLES MUST BE INCLUDED EITHER DIRECTLY OR BY REFERENCE IN EVERY EJB (spec: 488)
JAR lLE #HOOSE ALL THAT APPLY
R! 4HE ENTERPRISE BEAN CLASS
R" 4HE STUB CLASS FOR THE %*"/BJECT INTERFACE
R# 4HE ENTERPRISE BEANS SUPER CLASSES
R$ !NY *3% CLASSES USED AS ARGUMENTS OR RETURN TYPES - ItÕll already be there, baby!
15 7HICH ROLE IS TYPICALLY RESPONSIBLE FOR DECLARING THE RESOURCE CONNECTION (spec: 423)
FACTORY REFERENCES IN THE DEPLOYMENT DESCRIPTOR
R! BEAN PROVIDER
R" APPLICATION ASSEMBLER
R# DEPLOYER
R$ CONTAINER PROVIDER
R% SYSTEM ADMINISTRATOR
7HATS TRUE ABOUT A LEGAL EJB JAR lLE #HOOSE ALL THAT APPLY (spec: 488)
16
R! )T MUST CONTAIN BOTH A HOME INTERFACE AND A COMPONENT INTERFACE
R" 4HE DEPLOYMENT DESCRIPTOR IS OPTIONAL
R# )T MUST CONTAIN ANY *%% CLASSES USED BY THE BEAN
R$ 4HE ENTERPRISE BEAN CLASS IS OPTIONAL
7HICH ROLE WOULD TYPICALLY SET UP RESOURCE MANAGER SIGN ON INFORMATION (spec: 422)
17
R! BEAN PROVIDER
R" APPLICATION ASSEMBLER
R# DEPLOYER
R$ CONTAINER PROVIDER
R% SYSTEM ADMINISTRATOR
FKDSWHU
Appendix A:
Final Mock Exam
'R127WU\WRWDNHWKLVH[DPXQWLO\RXEHOLHYH\RX¶UHUHDG\IRUWKHUHDOWKLQJ,I\RXWDNH
LWWRRVRRQWKHQZKHQ\RX¿QDOO\FRPHEDFNWRLW\RX¶OODOUHDG\KDYHVRPHPHPRU\RI
WKHTXHVWLRQVDQGLWFRXOGJLYH\RXDQDUWL¿FLDOO\KLJKVFRUH:HUHDOO\GRZDQW\RXWR
SDVVWKH¿UVWWLPH 8QOHVVWKHUHZHUHVRPHZD\WRFRQYLQFH\RXWKDW\RXQHHGWREX\D
IUHVKFRS\RIWKLVERRNHDFKWLPH\RXUHWDNHWKHH[DP
7RKHOSGHIHDWWKH³,UHPHPEHUWKLVTXHVWLRQ´SUREOHPZH¶YHPDGHWKLVH[DPMXVWDOLWWOH
KDUGHUWKDQWKHUHDOH[DPE\QRWWHOOLQJ\RXKRZPDQ\DQVZHUVDUHFRUUHFWIRUHDFK
RIRXUTXHVWLRQV2XUTXHVWLRQVDQGDQVZHUVDUHYLUWXDOO\LGHQWLFDOWRWKHWRQHVW\OH
GLI¿FXOW\DQGWRSLFVRIWKHUHDOH[DPEXWE\QRWWHOOLQJ\RXKRZPDQ\DQVZHUVWRFKRRVH
\RXFDQ¶WDXWRPDWLFDOO\HOLPLQDWHDQ\RIWKHDQVZHUV,W¶VFUXHORIXVUHDOO\DQGZHZLVK
ZHFRXOGWHOO\RXWKDWLWKXUWVXVPRUHWKDQLWKXUWV\RXWRKDYHWRWDNHWKHH[DPWKLVZD\
%XWEHJUDWHIXO²XQWLODIHZ\HDUVDJR6XQ¶VUHDO-DYDH[DPVZHUHZULWWHQWKLVZD\
ZKHUHPRVWTXHVWLRQVHQGHGZLWK³&KRRVHDOOWKDWDSSO\´
0RVWH[DPFDQGLGDWHVKDYHVDLGWKDWRXUPRFNH[DPVDUHDOLWWOHPRUHGLI¿FXOWWKDQWKH
UHDO6&%&'EXWWKDWWKHLUVFRUHVRQRXUH[DPDQGRQWKHUHDORQHZHUHYHU\FORVH7KLV
PRFNH[DPLVDSHUIHFWZD\WRVHHLI\RX¶UHUHDG\EXWRQO\LI\RX
*LYH\RXUVHOIQRPRUHWKDQWZRKRXUVWRFRPSOHWHLWMXVWOLNHWKHUHDOH[DP
'RQ¶WORRNDQ\ZKHUHHOVHLQWKHERRNZKLOH\RX¶UHWDNLQJWKHH[DP
'RQ¶WWDNHLWRYHUDQGRYHUDJDLQ%\WKHIRXUWKWLPH\RXPLJKWEHJHWWLQJ DQG\HW
VWLOOQRWEHDEOHWRSDVVWKHUHDOH[DPVLPSO\EHFDXVH\RXZHUHPHPRUL]LQJRXUH[DFW
TXHVWLRQVDQGDQVZHUV
:DLWXQWLODIWHU\RX¿QLVKWKHH[DPWRFRQVXPHODUJHTXDQWLWLHVRIDOFRKRORURWKHU
PLQGDOWHULQJVXEVWDQFHV %HQDQG-HUU\¶V)XGJH%URZQLH5HG%XOO)URVWHG
)ODNHVFHUHDOWRQDPHDIHZRIWKHPRUHGHDGO\RQHV
WKLVLVDQHZDSSHQGL[
FRIIHHFUDPPRFNH[DP
0DVWHU0RFN([DP
7HICH ARE BENElTS OF %*" #HOOSE ALL THAT APPLY
1
R! -$"S SURVIVE SERVER CRASHES
R" 2EPRESENTATIONS OF A SINGLE ENTITY CAN BE SHARED AMONG MULTIPLE CLI
ENTS
R# 3UPPORT FOR NESTED TRANSACTIONS
R$ $YNAMIC SERVICE DISCOVERY
R% $ECLARATIVE ISOLATION LEVEL SETTINGS
7HICH METHODS ARE DIRECTLY INVOKED BY THE CLIENT #HOOSE ALL THAT APPLY
2
R! HME3DVVLYDWH
R" BUSINESS METHODS
R# VHW6HVVLRQ&RQWH[W
R$ QHZ,QVWDQFH
R% FUHDWH
7HICH METHODS CAN BE FOUND IN THE %*"(OME INTERFACE #HOOSE ALL THAT
3 APPLY
R! REMOVE(ANDLE HANDLE
R" REMOVE/BJECT PRIMARY+EY
R# GET(ANDLE
R$ NONE OF THE ABOVE
DSSHQGL[$
DSSHQGL[$ILQDOPRFNH[DP
7HICH METHODS CAN BE RUN BY A #-0 BEAN IN THE POOLED STATE #HOOSE ALL
4 THAT APPLY
R! HME/RDG
R" HME)LQG
R# HME6WRUH
R$ HME&UHDWH
R% "USINESS METHOD
R& HME+RPH
7HATS TRUE ABOUT MESSAGE
DRIVEN BEANS #HOOSE ALL THAT APPLY
5
R! !LL CALLS TO A MESSAGE
DRIVEN BEAN INSTANCE MUST BE SERIALIZED
R" 4HE CONTAINER GUARANTEES THAT MESSAGES WILL BE PROCESSED IN THE ORDER
IN WHICH THEY ARE RECEIVED
R# 4HE BEANS HME&UHDWH METHOD MUST TAKE A SINGLE ARGUMENT OF TYPE
MDYD[MPV0HVVDJH
R$ 4HE BEAN PROVIDER USES THE DEPLOYMENT DESCRIPTOR TO INDICATE WHETHER
INSTANCES OF THE BEAN CLASS ARE INTENDED FOR TOPICS OR QUEUES
7HATS TRUE ABOUT AN ENTERPRISE BEANS ENVIRONMENT #HOOSE ALL THAT APPLY
6
R! "EFORE A BEAN CAN ACCESS ITS ENVIRONMENT ENTRIES THE BEAN MUST lRST
OBTAIN THE NAMING CONTEXT USING A 6HVVLRQ&RQWH[W OBJECT
R" /NLY THE BEAN PROVIDER CAN SET AN ENVIRONMENT ENTRY VALUE
R# ! BEANS ENVIRONMENT ENTRIES CAN BE STORED ONLY IN
µMDYD FRPSHQY¶OR ONE OF ITS SUBCONTEXTS
R$ %VERY ENVIRONMENT ENTRY LOOKUP IN A BEANS CODE MUST HAVE A MATCHING
HQYHQWU\! ELEMENT IN THE BEANS DEPLOYMENT DESCRIPTOR
7HATS TRUE ABOUT SECURITY ROLES IN %*"S #HOOSE ALL THAT APPLY
7
R! 3ECURITY ROLES ARE DElNED IN THE DEPLOYMENT DESCRIPTOR USING SECURITY
ROLE ELEMENTS
R" 3ECURITY ROLES ARE SCOPED TO THE INSTANCE LEVEL
R# -ANY METHODS CAN BE MAPPED TO A SINGLE SECURITY ROLE
R$ ! METHOD CAN APPEAR IN ONLY ONE SECURITY ROLE
\RXDUHKHUH
FRIIHHFUDPPRFNH[DP
!N %*" CONTAINER MUST SUPPORT AT LEAST A SUBSET OF WHICH !0)S #HOOSE ALL
8 THAT APPLY
R! *4!
R" *$"#
R# *-3
R$ *!8
2#0
7HICH STATEMENTS CONCERNING STATELESS SESSION BEANS ARE TRUE #HOOSE ALL THAT
9 APPLY
R! 4HEY CAN USE BEAN
MANAGED TRANSACTION DEMARCATION
R" 4HEY MUST HAVE ONE NO
ARGUMENT CREATE METHOD
R# ! SINGLE INSTANCE CAN SUPPORT CONCURRENT CALLS
R$ 4HEY MUST EXTEND JAVAXEJB3ESSION"EAN
7HAT CAPABILITY EXISTS IN /.,9 /.% OF THE TWO BUT NOT BOTH
10
AN ENTITY OBJECTS REMOTE COMPONENT INTERFACE
AN ENTITY OBJECTS LOCAL COMPONENT INTERFACE
#HOOSE ALL THAT APPLY
R! 2EMOVING THE OBJECT
R" /BTAINING THE OBJECTS HANDLE
R# )NVOKING BUSINESS METHODS
R$ /BTAINING THE OBJECTS PRIMARY KEY
7HEN CREATING A #-0 ENTITY BEAN WHICH METHODS ARE OPTIONAL #HOOSE ALL
11 THAT APPLY
R! HME/RDG
R" HME&UHDWH
R# HME5HPRYH
R$ HME6HOHFW
R% HME3DVVLYDWH
R& VHW(QWLW\&RQWH[W
DSSHQGL[$
DSSHQGL[$ILQDOPRFNH[DP
7HICH METHODS CAN BE CALLED ON A BEAN IN THE POOLED STATE #HOOSE ALL
12 THAT APPLY
R! HME)LQG
R" HME/RDG
R# HME6WRUH
R$ HME6HOHFW
R% HME3DVVLYDWH
7HATS TRUE ABOUT THE LIFECYCLE OF A MESSAGE
DRIVEN BEAN #HOOSE ALL THAT AP
13 PLY
R! 7HEN THE THE OQ0HVVDJH METHOD COMPLETES THE CONTAINER WILL TYPI
CALLY CALL EJB2EMOVE
R" 4HE ON0HVVDJH METHOD CAN THROW APPLICATION EXCEPTIONS
R# -ESSAGE
DRIVEN BEANS CAN RUN ONLY WITH #-4 DEMARCATION
R$ 4HE JHW5ROOEDFN2QO\ METHOD CAN BE CALLED ONLY FROM THE
ON-ESSAGE METHOD
7HICH STATEMENTS CONCERNING MESSAGE DRIVEN BEAN CLASSES ARE TRUE
14 #HOOSE ALL THAT APPLY
R! 4HEY MUST IMPLEMENT DIRECTLY OR INDIRECTLY MDYD[MPV0HVVDJH
R" 4HEY MUST HAVE A PUBLIC CONSTRUCTOR THAT TAKES A SINGLE ARGUMENT OF
TYPE MDYD[MPV0HVVDJH
R# )MPLEMENTING THE ¿QDOL]H METHOD IS ALLOWED
R$ )MPLEMENTING THE HME&UHDWH METHOD IS OPTIONAL
R% 4HE CLASS MUST NOT BE DECLARED @lNAL
7ITHIN THE DEPLOYMENT DESCRIPTORS HMEORFDOUHI! ELEMENT WHICH ELE
15 MENTS ARE OPTIONAL #HOOSE ALL THAT APPLY
R! ORFDO!
R" HMEOLQN!
R# ORFDOKRPH!
R$ GHVFULSWLRQ!
R% HMEUHIQDPH!
R& HMEUHIW\SH!
\RXDUHKHUH
FRIIHHFUDPPRFNH[DP
7HATS TRUE ABOUT RESOURCE MANAGER CONNECTION FACTORIES #HOOSE ALL THAT
16 APPLY
R4HE UHVVKDULQJVFRSH! DEPLOYMENT DESCRIPTOR ELEMENT IS USED TO
INDICATE WHETHER CONNECTIONS TO A RESOURCE MANAGER ARE SHAREABLE
ACROSS MULTIPLE %*"S IN AN APPLICATION
R" 4HE UHVVKDULQJVFRSH! DEPLOYMENT DESCRIPTOR ELEMENT CONTAINS
THE UHVRXUFHUHI! ELEMENT
R# !LL OF A BEANS RESOURCE MANAGER CONNECTION FACTORY REFERENCES ARE
DECLARED IN A SINGLE UHVRXUFHUHI! ELEMENT USING
UHVUHIQDPH! ELEMENTS TO DISTINGUISH THEM
R$ "Y DEFAULT CONNECTIONS TO A GIVEN RESOURCE MANAGER ARE SHAREABLE
ACROSS MULTIPLE BEANS IN AN APPLICATION
7HATS TRUE ABOUT SECURITY ROLES REFERENCED FROM AN %*"S CODE #HOOSE ALL
17 THAT APPLY
R! )N THE DEPLOYMENT DESCRIPTOR SUCH REFERENCES ARE CONTAINED IN THE
VHFXULW\UROHUHI! ELEMENT
R" 4HE VHFXULW\UROH! ELEMENT INCLUDES THE VHFXULW\UROH
UHI! ELEMENT
R# 7ITHIN THE VHFXULW\UROHUHI! ELEMENT THE UROHQDPH!
ELEMENTS VALUE IS THE SAME AS THE ARGUMENT FOR THE BEANS INVOCATION
OF THE LV&DOOHU,Q5ROH METHOD
R$ 4HE UROHOLQN! ELEMENT IS USED TO LINK TWO
VHFXULW\UROHUHI! ELEMENTS
7HATS TRUE ABOUT THE CLIENTS VIEW OF SECURITY #HOOSE ALL THAT APPLY
18
R! ! TRANSACTIONAL CLIENT CANNOT CHANGE ITS PRINCIPAL ASSOCIATION WITHIN A
TRANSACTION
R" ! SESSION BEANS CLIENT CANNOT CHANGE ITS PRINCIPAL ASSOCIATION FOR THE
DURATION OF THE COMMUNICATION WITH THE SESSION OBJECT
R# 4RANSACTIONAL REQUESTS WITHIN A SINGLE TRANSACTION CANNOT ARRIVE FROM
MULTIPLE CLIENTS
R$ .ONE OF THE ABOVE
DSSHQGL[$
DSSHQGL[$ILQDOPRFNH[DP
7HEN PROGRAMMING AN ENTITY BEAN CLASS WHICH TECHNIQUES SHOULD BE
19 !6/)$%$ TO ENSURE BEAN PORTABILITY ACROSS ALL %*" CONTAINERS #HOOSE ALL
THAT APPLY
R! #HANGING A THREADS PRIORITY
R" 5SING THE REmECTION !0)
R# 5SING WRAPPER CLASSES
R$ 5SING STATIC NESTED CLASSES
7HEN PROGRAMMING A MESSAGE
DRIVEN BEAN CLASS WHICH TECHNIQUES SHOULD
20 BE AVOIDED TO ENSURE BEAN PORTABILITY ACROSS ALL %*" CONTAINERS #HOOSE
ALL THAT APPLY
R! 5SING 3WING !0)S FOR A '5)
R" 5SING THE @TRANSIENT MODIlER
R# 5SING NATIVE LIBRARIES
R$ 2EADING lLE DESCRIPTORS
7HAT IS REQUIRED OF THE CONTAINER WHEN IT PASSIVATES A STATEFUL SESSION BEAN
21
R! 4HE BEANS INSTANCE STATE WILL ALWAYS UNDERGO *AVA PROGRAMMING LAN
GUAGE 3ERIALIZATION
R" )T MUST SAVE ALL OF THE BEANS INSTANCE lELD STATE REGARDLESS OF THE lELDS
MODIlERS
R# )T MUST SAVE ANY REFERENCES TO THE BEANS 3ESSION#ONTEXT OBJECT
R$ )T MUST SAVE ALL NON
NULL TRANSIENT VARIABLES
7HICH CAPABILITIES ARE DElNED IN THE MDYD[HME(-%/RFDO2EMHFW INTER
22 FACE #HOOSE ALL THAT APPLY
R! 2EMOVE AN ENTITY OBJECT
R" /BTAIN AN ENTITY OBJECTS PRIMARY KEY
R# /BTAIN A LOCAL HOME INTERFACE FOR THE ENTITY OBJECT
R$ /BTAIN A REMOTE COMPONENT INTERFACE FOR THE ENTITY OBJECT
R% %XPOSE THE METHODS OF THE MDYD[HME(QWLW\%HDQ INTERFACE TO THE
CLIENT
\RXDUHKHUH
FRIIHHFUDPPRFNH[DP
7HATS TRUE ABOUT EJB3ELECT METHODS #HOOSE ALL THAT APPLY
23
R! 4HEY CAN BE EXPOSED TO THE CLIENT
R" 4HEY CAN RETURN ONLY %*"/BJECTS OR %*",OCAL/BJECTS
R# 4HEY CAN BE INVOKED ONLY BY A BEAN IN THE READY STATE
R$ 4HEY MUST BE ASSOCIATED WITH A QUERY ELEMENT IN THE DEPLOYMENT DE
SCRIPTOR
7HICH METHODS CAN .%6%2 BE SUCCESSFULLY INVOKED FROM A MESSAGE
DRIVEN
24 BEAN #HOOSE ALL THAT APPLY
R! LV&DOOHU,Q5ROH
R" JHW(-%+RPH
R# JHW5ROOEDFN2QO\
R$ VHW5ROOEDFN2QO\
R% JHW&DOOHU3ULQFLSDO
7HICH ROLE IS TYPICALLY RESPONSIBLE FOR ADDING EJB
LINK ELEMENTS TO AN %*"S
25 DEPLOYMENT DESCRIPTOR
R! BEAN PROVIDER
R" APPLICATION ASSEMBLER
R# DEPLOYER
R$ CONTAINER PROVIDER
R% SYSTEM ADMINISTRATOR
)N WHICH OF THE FOLLOWING METHODS CAN A STATELESS SESSION BEAN INVOKE THE
26 LV&DOOHU,Q5ROH METHOD IN ORDER TO PERFORM A SECURITY CHECK #HOOSE
ALL THAT APPLY
R! HME&UHDWH
R" HME5HPRYH
R# VHW6HVVLRQ&RQWH[W
R$ .ONE OF THE ABOVE
DSSHQGL[$
DSSHQGL[$ILQDOPRFNH[DP
7HICH TWO ARE TYPICALLY RESPONSIBLE FOR CREATING EJB
JAR lLES #HOOSE TWO
27
R! 4HE BEAN PROVIDER
R" 4HE APPLICATION ASSEMBLER
R# 4HE DEPLOYER
R$ 4HE SYSTEM ADMINISTRATOR
7HICH OF THE FOLLOWING STATELESS SESSION BEAN CONTAINER CALLBACK METHODS
28 TAKES AN ARGUMENT #HOOSE ALL THAT APPLY
R! HME5HPRYH
R" HME&UHDWH
R# HME&UHDWH
R$ HME3DVVLYDWH
R% VHW6HVVLRQ&RQWH[W
7HICH OF THESE CAN NEVER BE CALLED ON A 3ESSION#ONTEXT INTERFACE #HOOSE ALL
29 THAT APPLY
R! JHW(-%+RPH
R" JHW(-%2EMHFW
R# JHW(-%7UDQVDFWLRQ
R$ LV&DOOHU,Q5ROH
R% JHW8VHU7UDQVDFWLRQ
7HATS TRUE ABOUT AN ENTITY BEANS REMOTE COMPONENT INTERFACE #HOOSE ALL
30 THAT APPLY
R! )F A CLIENT ATTEMPTS TO INVOKE A METHOD ON AN ENTITY THAT DOES NOT EXIST A
MDYDUPL1R6XFK5HPRWH2EMHFW([FHSWLRQ WILL BE THROWN
R" )T MUST EXTEND MDYD[HME(-%+RPH
R# )TS METHODS MUST DECLAREMDYDUPL5HPRWH([FHSWLRQ
R$ )T DElNES AUHPRYH +DQGOHKDQGOH METHOD
\RXDUHKHUH
FRIIHHFUDPPRFNH[DP
7HICH ARE TRUE ABOUT lNDER METHODS IN AN ENTITY BEANS LOCAL HOME INTERFACE
31 #HOOSE ALL THAT APPLY
R! 4HEY CAN HAVE ANY LEGAL *AVA NAME
R" 4HEY MUST ALL DECLARE MDYD[HME)LQGHU([FHSWLRQ
R# 4HEY CAN OPTIONALLY DECLARE MDYDUPL5HPRWH([FHSWLRQ
R$ 4HE ¿QG%\3ULPDU\.H\ METHOD CAN BE OVERLOADED
R% 4HE ¿QG%\3ULPDU\.H\ METHODS RETURN TYPE MUST BE THE BEANS LOCAL
COMPONENT INTERFACE
R& ! METHOD CALLED hlND888v MUST HAVE THE BEANS LOCAL COMPONENT
INTERFACE AS ITS DECLARED RETURN TYPE
7HICH ARE TRUE FOR A MESSAGE
DRIVEN BEAN #HOOSE ALL THAT APPLY
32
R! 4HE $EPLOYER USES THE DEPLOYMENT DESCRIPTOR TO DETERMINE WHETHER A BEAN
IS INTENDED FOR A 1UEUE OR A 4OPIC
R" 4HE CLASS MUST BE DECLARED lNAL
R# 4HE CLASS MUST DElNE ONE HME5HPRYH METHOD
R$ 4HE CLASS CAN HAVE OVERLOADED HME&UHDWH METHODS
R% 4HE CLASS MUST DElNE A NO
ARGUMENT ON-ESSAGE METHOD
'IVEN THE FOLLOWING SUBSET OF A DEPLOYMENT DESCRIPTOR
33 HQWLW\!
HMEQDPH!3D\UROO HMEQDPH!
VHFXULW\UROHUHI!
UROHQDPH!FOHUN UROHQDPH!
VHFXULW\UROHUHI!
HQWLW\!
7HICH CODE SNIPPETS MAKES A LEGAL SECURITY CHECK #HOOSE ALL THAT APPLY
R! FRQWH[WLV&DOOHU,Q5ROH ³3D\UROO´
R" FRQWH[WLV&DOOHU,Q5ROH ³FOHUN´
R# FRQWH[WLV&DOOHU,Q5ROH ³3D\UROOFOHUN´
R$ FRQWH[WLV&DOOHU,Q5ROH ³3D\UROOFOHUN´
DSSHQGL[$
DSSHQGL[$ILQDOPRFNH[DP
7HICH ARE VALID LOCAL HOME INTERFACES FOR A STATEFUL SESSION BEAN #HOOSE ALL
34 THAT APPLY
R! SXEOLFLQWHUIDFH7HVW%HDQLPSOHPHQWV
MDYD[HME(-%/RFDO+RPH^
Y
RLGFUHDWH WKURZV&UHDWH([FHSWLRQ
`
R" SXEOLFLQWHUIDFH7HVW%HDQH[WHQGV
MDYD[HME(-%/RFDO+RPH^
7
HVW%HDQ/RFDOHME&UHDWH WKURZV&UHDWH([FHSWLRQ
`
R# SXEOLFLQWHUIDFH7HVW%HDQH[WHQGV
MDYD[HME(-%/RFDO+RPH^
7HVW%HDQ/RFDOFUHDWH WKURZV&UHDWH([FHSWLRQ
`
R$ SXEOLFLQWHUIDFH7HVW%HDQH[WHQGV
MDYD[HME(-%/RFDO+RPH^
7
HVW%HDQ/RFDOFUHDWH WKURZV&UHDWH([FHSWLRQ
5HPRWH([FHSWLRQ
`
R% SXEOLFLQWHUIDFH7HVW%HDQH[WHQGV
MDYD[HME(-%/RFDO+RPH^
7
HVW%HDQ/RFDOFUHDWH WKURZV/RFDO([FHSWLRQ
`
7HICH METHODS CAN BE CALLED BY A BEAN PROVIDER #HOOSE ALL THAT APPLY
35
R! UHPRYH
R" HME&UHDWH
R# DIWHU%HJLQ
R$ JHW&DOOHU3ULQFLSDO
R% HME3DVVLYDWH
\RXDUHKHUH
FRIIHHFUDPPRFNH[DP
7HO WILL TYPICALLY SPECIFY WHETHER A BEAN IS RE
ENTRANT IN THE BEANS DEPLOY
36 MENT DESCRIPTOR
R! 4HE BEAN PROVIDER
R" 4HE APPLICATION ASSEMBLER
R# 4HE DEPLOYER
R$ 4HE SYSTEM ADMINISTRATOR
7HICH STATEMENTS ABOUT STATEFUL AND STATELESS SESSION BEANS ARE TRUE
37 #HOOSE ALL THAT APPLY
R! /NLY STATEFUL SESSION BEANS SUPPORT TRANSACTIONS
R" /NLY STATEFUL SESSION BEANS CAN BE PASSIVATED
R# /NLY STATEFUL SESSION BEANS HAVE A µVHW6HVVLRQ&RQWH[W¶ METHOD
R$ "OTH STATEFUL AND STATELESS SESSION BEANS CAN SUPPORT OVERLOADED
µHME&UHDWH¶METHODS
R% "OTH STATEFUL AND STATELESS SESSION BEANS CAN IMPLEMENT THE
MDYD[HME6HVVLRQ6\QFKURQL]DWLRQ INTERFACE
R& "OTH STATEFUL AND STATELESS SESSION BEANS CAN HAVE INSTANCE VARIABLE STATE
7HICH MUST BE INCLUDED IN EVERY EJB
JAR lLE #HOOSE ALL THAT APPLY
38
R! 4HE STUB FOR THE %*"(OME INTERFACE EITHER DIRECTLY OR BY REFERENCE
R" 4HE *!2 -ANIFEST lLE
R# ! DEPLOYMENT DESCRIPTOR
R$ 4HE *.$) CONTEXT
R% 4HE %*"S HOME INTERFACE EITHER DIRECTLY OR BY REFERENCE
7HICH METHODS ARE DECLARED IN THE JAVAXEJB%*"(OME INTERFACE #HOOSE
39 ALL THAT APPLY
R! FUHDWH
R" ORRNXS
R# JHW+DQGOH
R$ JHW+RPH+DQGOH
R% VHW6HVVLRQ&RQWH[W
DSSHQGL[$
DSSHQGL[$ILQDOPRFNH[DP
(OW MANY JAVAXEJB%*",OCAL(OME INTERFACE METHODS CAN BE CALLED WITHOUT
40 AN EXCEPTION FROM A SESSION BEAN CLIENT
R!
R"
R#
R$
R%
7HICH OF THE FOLLOWING IF CALLED ALWAYS HAVE THE SAME TRANSACTION CONTEXT AS A
41 SESSION BEANS BUSINESS METHODS #HOOSE ALL THAT APPLY
R! CONSTRUCTOR
R" VHW6HVVLRQ&RQWH[W
R# DIWHU%HJLQ
R$ DIWHU&RPSOHWLRQ
R% EHIRUH&RPSOHWLRQ
'IVEN A STATEFUL SESSION BEAN WITH CONTAINER
MANAGED TRANSACTION DEMARCATION
42 FROM WHICH METHODS CAN YOU ACCESS ANOTHER BEAN #HOOSE ALL THAT APPLY
R! VHW6HVVLRQ&RQWH[W
R" HME&UHDWH
R# DIWHU%HJLQ
R$ EHIRUH&RPSOHWLRQ
R% DIWHU&RPSOHWLRQ
7HICH DEPLOYMENT DESCRIPTOR ELEMENTS CAN OPTIONALLY SPECIFY CASCADE DELETE
43 FUNCTIONALITY #HOOSE ALL THAT APPLY
R! HMEUHODWLRQ!
R" DEVWUDFWVFKHPDQDPH!
R# HMEUHODWLRQVKLSUROH!
R$ UHODWLRQVKLSUROHVRXUFH!
\RXDUHKHUH
FRIIHHFUDPPRFNH[DP
7HATS TRUE ABOUT CASCADE
DELETE #HOOSE ALL THAT APPLY
44
R! )T IS DECLARED IN THE HME5HPRYH METHOD
R" 7HEN A CASCADE
DELETE ENABLED BEAN IS DELETED IT CAUSES ALL OF THE
BEANS WITH RELATIONSHIPS TO IT TO BE AUTOMATICALLY DELETED TOO
R# )T CAN BE SPECIlED FOR ONE
TO
ONE ONE
TO
MANY OR MANY
TO
MANY RELA
TIONSHIPS
R$ ! CASCADE
DELETE ENABLED BEAN IS AUTOMATICALLY REMOVED WHEN ANY
hMULTIPLICITY OF ONEv BEAN WITH WHICH IT IS RELATED IS REMOVED
7HICH METHODS FROM THE %NTITY#ONTEXT INTERFACE CAN BE INVOKED REGARDLESS
45 OF TRANSACTION CONTEXT #HOOSE ALL THAT APPLY
R! JHW(-%+RPH
R" JHW(-%2EMHFW
R# VHW5ROOEDFN2QO\
R$ JHW5ROOEDFN2QO\
7HATS TRUE ABOUT AN ENTITY BEANS PRIMARY KEY #HOOSE ALL THAT APPLY
46
R! 0RIMARY KEY lELDS MUST BE CMP
lELDS
R" 3ETTER METHODS FOR lELDS ASSOCIATED WITH A PRIMARY KEY MUST NOT BE
EXPOSED THROUGH A CLIENT VIEW
R# )F TWO ENTITY OBJECTS HAVE THE SAME HOME AND THE SAME PRIMARY KEY
THEY ARE CONSIDERED IDENTICAL
R$ 4HE JHW3ULPDU\.H\ METHOD CAN BE INVOKED ON REFERENCES TO ONLY
REMOTE HOME INTERFACES NOT LOCAL HOME INTERFACES
7HICH INTERFACES ARE USED BY THE BEAN PROVIDER TO PERFORM "-4 DEMARCA
47 TION #HOOSE ALL THAT APPLY
R! MDYD[WUDQVDFWLRQ7UDQVDFWLRQ
R" MDYD[WUDQVDFWLRQ8VHU7UDQVDFWLRQ
R# MDYD[WUDQVDFWLRQ6\QFKURQL]DWLRQ
R$ MDYD[WUDQVDFWLRQ7UDQVDFWLRQ0DQDJHU
DSSHQGL[$
DSSHQGL[$ILQDOPRFNH[DP
7HICH OF THE FOLLOWING ARE LEGAL %*" 1, QUERIES #HOOSE ALL THAT APPLY
48
R! 3%,%#4 C
&2/- #USTOMER C
R" 3%,%#4 /"*%#4 CNAME
&2/- #USTOMER C
R# 3%,%#4 /"*%#4 C
7(%2% #USTOMER C
R$ 3%,%#4 /"*%#4 C
&2/- #USTOMER C
R% 3%,%#4 CNAME
&2/- #USTOMER C
7HICH ARE TRUE ABOUT TRANSACTIONS IN %*" #HOOSE ALL THAT APPLY
49
R! /NLY ONE DATABASE CAN BE UPDATED WITHIN A SINGLE TRANSACTION
R" %NTITY BEANS WITH "-4 DEMARCATION MUST USE THE SET3TATUS METHOD
INSTEAD OF THE VHW5ROOEDFN2QO\ METHOD
R# %NTITY BEANS WITH "-4 DEMARCATION MUST USE THE GET3TATUS METHOD
INSTEAD OF THE JHW5ROOEDFN2QO\ METHOD
R$ "-4 DEMARCATION SHOULD BE USED WHEN BEANS ACCESS RESOURCE MANAG
ERS THAT DO NOT SUPPORT TRANSACTIONS
R% 4HE @3ESSION3YNCHRONIZATION INTERFACE CAN BE USED ONLY BY STATEFUL
SESSION BEANS
4O ENSURE BEAN PORTABILITY WHICH TRANSACTION ATTRIBUTES SHOULD BE USED ON THE
50 BUSINESS METHODS IN THE COMPONENT INTERFACE OF AN ENTITY BEAN USING #-0
#HOOSE ALL THAT APPLY
R! .OT3UPPORTED
R" 2EQUIRED
R# 3UPPORTS
R$ 2EQUIRES.EW
R% -ANDATORY
R& .EVER
\RXDUHKHUH
FRIIHHFUDPPRFNH[DP
7HICH OF THE FOLLOWING EXCEPTIONS WOULD CAUSE A BEAN TO BE DISCARDED BY THE
51 CONTAINER #HOOSE ALL THAT APPLY
R! MDYD[HME2EMHFW1RW)RXQG([FHSWLRQ
R" MDYD[HME&UHDWH([FHSWLRQ
R# MDYD[HME1R6XFK(QWLW\([FHSWLRQ
R$ MDYD[HME)LQGHU([FHSWLRQ
R% MDYD[HME5HPRYH([FHSWLRQ
)N WHICH CASES SHOULD THE CONTAINER LOG AN EXCEPTION THROWN BY A BUSINESS
52 METHOD OF A #-4 DEMARCATED BEAN #HOOSE ALL THAT APPLY
R! )F THE METHOD RUNS WITH AN UNSPECIlED TRANSACTION CONTEXT AND THROWS
A SYSTEM EXCEPTION
R" )F THE METHOD RUNS WITH AN UNSPECIlED TRANSACTION CONTEXT AND THROWS
AN APPLICATION EXCEPTION
R# )F THE METHOD RUNS WITH A 2EQUIRES.EW CONTEXT AND THROWS A SYSTEM
EXCEPTION
R$ )F THE METHOD RUNS WITH A 2EQUIRED CONTEXT AND THROWS A SYSTEM EXCEP
TION
R% )F THE METHOD RUNS WITH A 2EQUIRES.EW CONTEXT AND THROWS AN APPLICA
TION EXCEPTION
R& )F THE METHOD RUNS WITH A 2EQUIRED CONTEXT AND THROWS AN APPLICATION
EXCEPTION
7HICH SESSION BEAN COMPONENT INTERFACE METHODS CAN BE CALLED SUCCESSFULLY
53 BY A LOCAL CLIENT #HOOSE ALL THAT APPLY
R! UHPRYH
R" JHW+DQGOH
R# LV,GHQWLFDO
R$ JHW(-%+RPH
DSSHQGL[$
DSSHQGL[$ILQDOPRFNH[DP
)N WHAT SCENARIOS CAN A BEANS BUSINESS METHOD CALL THE LV&DOOHU,Q5ROH
54 METHOD OF THE 3ESSION#ONTEXT INTERFACE #HOOSE ALL THAT APPLY
R! ! STATEFUL SESSION BEAN WITH CONTAINER
MANAGED TRANSACTION DEMARCA
TION
R" ! STATELESS SESSION BEAN WITH CONTAINER
MANAGED TRANSACTION DEMARCA
TION
R# ! STATEFUL SESSION BEAN WITH BEAN
MANAGED TRANSACTION DEMARCATION
R$ ! STATELESS SESSION BEAN WITH BEAN
MANAGED TRANSACTION DEMARCATION
R% .ONE OF THE ABOVE
7HEN CREATING AN ENTITY BEAN USING CONTAINER MANAGED PERSISTENCE WHICH CAN
55 BE ACCESSED THROUGH THE BEANS REMOTE COMPONENT INTERFACE #HOOSE ALL THAT
APPLY
R! !CCESSOR METHODS FOR THE RELATIONSHIP lELDS
R" 4HE LOCAL INTERFACE OF THE ENTITY BEAN
R# 4HE BEANS BUSINESS METHODS
R$ 4HE COLLECTION CLASSES USED FOR CONTAINER MANAGED RELATIONSHIPS
R% !CCESSOR METHODS FOR THE PERSISTENT lELDS
'IVEN THE CONTAINER MANAGED ONE TO ONE BIDIRECTIONAL RELATIONSHIP
56 )RR !%DU
!ND THE OBJECT RELATIONS
I
!E
I !E
7HICH BOOLEAN EXPRESSION WILL BE TRUE AFTER THE FOLLOWING CODE RUNS
E
VHW)RR EJHW)RR
#HOOSE ALL THAT APPLY
R!IJHW%DU QXOO
R" EJHW)RR QXOO
R# IJHW%DU QXOO
R$ NONE OF THE ABOVE
\RXDUHKHUH
FRIIHHFUDPPRFNH[DP
7HATS TRUE ABOUT AN ENTITY BEANS IDENTITY #HOOSE ALL THAT APPLY
57
R! )F TWO ENTITY OBJECT REFERENCES ARE COMPARED USING THE OPERATOR THE
CONTAINER PROVIDER IS NOT REQUIRED TO PRODUCE CONSISTENT RESULTS
R" )F TWO ENTITY OBJECT REFERENCES ARE COMPARED USING THE HTXDOV
METHOD THE CONTAINER WILL RETURN TRUE IF THE TWO ENTITY OBJECTS HAVE THE
SAME PRIMARY KEY
R# )F TWO ENTITY OBJECT REFERENCES ARE COMPARED USING THE LV,GHQWL
FDO METHOD THE CONTAINER WILL RETURN TRUE IF THE TWO ENTITY OBJECTS
HAVE THE SAME PRIMARY KEY
R$ .ONE OF THE ABOVE STATEMENTS ARE TRUE
'IVEN #-0 BEANS #USTOMER"EAN /RDER"EAN AND ,INE)TEMS"EAN WITH THE
58 FOLLOWING RELATIONSHIPS
#USTOMER"EAN /RDER"EAN N
/RDER"EAN ,INE)TEMS"EAN N
7HICH WILL RETURN A SET OF CUSTOMERS THAT HAVE ORDERS #HOOSE ALL THAT APPLY
R! 3%,%#4 #USTOMER
&2/- /RDER
R" 3%,%#4 $)34).#4 #USTOMER
&2/- /RDER
R# 3%,%#4 OCUSTNUM
&2/- /RDER O #USTOMER C
7(%2% CCUSTNUM OCUSTNUM
R$ 3%,%#4 /"*%#4 C
&2/- #USTOMER C /RDER O
7(%2% CCUSTNUM OCUSTNUM
R% 3%,%#4 $)34).#4 /"*%#4 C
&2/- #USTOMER C /RDER O
7(%2% CCUSTNUM OCUSTNUM
DSSHQGL[$
DSSHQGL[$ILQDOPRFNH[DP
'IVEN
59
0
HWKRG 7[ !0HWKRG 7[ !0HWKRG 7[
?!0HWKRG 7[
)F THE CALLING METHOD IS ON THE LEFT SIDE OF AN ARROW AND THE CALLED METHOD ON
THE RIGHT WHICH SET OF TRANSACTION ATTRIBUTES WILL SUPPORT THE TRANSACTION SCOPE
SPECIlED #HOOSE ALL THAT APPLY
R! 0 1HYHU
0 6XSSRUWV
0 5HTXLUHG
0 5HTXLUHV1HZ
R" 0 5HTXLUHG
0 6XSSRUWV
0 0DQGDWRU\
0 5HTXLUHV1HZ
R# 0 5HTXLUHV1HZ
0 5HTXLUHV1HZ
0 6XSSRUWV
0 5HTXLUHV1HZ
R$ 0 5HTXLUHG
0 0DQGDWRU\
0 6XSSRUWV
0 6XSSRUWV
'IVEN THE %*" 1, EXPRESSION
60 SGLVFRXQW127%(7:((1$1'
7HICH EXPRESSION IS EQUIVALENT
R! SGLVFRXQW 25SGLVFRXQW!
R" SGLVFRXQW 25SGLVFRXQW!
R# SGLVFRXQW 25SGLVFRXQW!
R$ SGLVFRXQW 25SGLVFRXQW!
\RXDUHKHUH
FRIIHHFUDPPRFNH[DP
7HEN A BUSINESS METHOD IN AN ENTITY BEAN CALLS THE JHW5ROOEDFN2QO\
61 METHOD WHICH TRANSACTION ATTRIBUTE SETTINGS COULD CAUSE THE CONTAINER TO
THROW AN EXCEPTION #HOOSE ALL THAT APPLY
R! .OT3UPPORTED
R" 2EQUIRED
R# 3UPPORTS
R$ 2EQUIRES.EW
R% -ANDATORY
R& .EVER
7HICH OF THE FOLLOWING IS PERFORMED BY THE CONTAINER IF A MESSAGE
DRIVEN BEAN
62 DOES NOT COMPLETE ITS TRANSACTION BEFORE THE END OF THE ON-ESSAGE METHOD
#HOOSE ALL THAT APPLY
R! ,OG AN APPLICATION ERROR
R" 2OLL BACK THE STARTED TRANSACTION
R# $ISCARD THE INSTANCE OF THE BEAN
R$ 4HROW AN EXCEPTION
&ROM WHICH CLASSES CAN APPLICATION EXCEPTIONS EXTEND #HOOSE ALL THAT AP
63 PLY
R! MDYDODQJ([FHSWLRQ
R" MDYDODQJ5XQWLPH([FHSWLRQ
R# MDYDUPL5HPRWH([FHSWLRQ
R$ MDYD[HME&UHDWH([FHSWLRQ
7HATS TRUE ABOUT APPLICATION EXCEPTIONS #HOOSE ALL THAT APPLY
64
R! 4HEY ARE INTENDED TO BE HANDLED BY THE SYSTEM ADMINISTRATOR
R" 4HEY SHOULD REPORT SYSTEM LEVEL PROBLEMS
R# 4HEY CAUSE AUTOMATIC MARKING OF TRANSACTIONS FOR ROLLBACK
R$ 4HEY MUST NOT EXTEND MDYDODQJ5XQWLPH([FHSWLRQ
R% 4HEY MAY EXTENDMDYDUPL5HPRWH([FHSWLRQ
DSSHQGL[$
DSSHQGL[$ILQDOPRFNH[DP
7HICH CASES CAN CAUSE A SESSION BEAN INSTANCE TO BE DESTROYED WITHOUT THE
65 CONTAINER CALLING HME5HPRYH #HOOSE ALL THAT APPLY
R! ! TRANSACTION IS ROLLED BACK ON A STATEFUL SESSION BEAN WITH CONTAINER
MANAGED TRANSACTION DEMARCATION
R" ! SYSTEM EXCEPTION IS THROWN FROM A BUSINESS METHOD
R# !N INACTIVE CLIENT IS TIMED OUT WHILE THE BEAN IS IN A PASSIVATED STATE
R$ 4HE CLIENT INVOKES THE REMOVE METHOD WHILE THE BEAN IS IN A TRANSAC
TION
7HICH DEPLOYMENT DESCRIPTOR ELEMENTS ARE USED TO SPECIFY A #OLLECTION
66 INTERFACE #HOOSE ALL THAT APPLY
R! HMEQDPH!
R" FPU¿HOG!
R# HMEUHODWLRQ!
R$ FPU¿HOGW\SH!
R% DEVWUDFWVFKHPDQDPH!
)F A BEAN CATCHES A CHECKED EXCEPTION FROM WHICH IT CANNOT RECOVER WHAT
67 SHOULD IT DO #HOOSE ALL THAT APPLY
R! )F THE CLIENT IS REMOTE THROW A MDYDUPL5HPRWH([FHSWLRQ
R" 0RINT A STACK TRACE
R# 2EGARDLESS OF THE CLIENT THROW A MDYD[HME(-%([FHSWLRQ
R$ 2EGARDLESS OF THE CLIENT PROPAGATE THE SAME EXCEPTION TO THE CONTAIN
ER
7HICH ARE REQUIREMENTS FOR A #-0 ENTITY BEAN CLASS #HOOSE ALL THAT APPLY
68
R! !LL HME6HOHFW METHODS MUST BE DECLARED AS ABSTRACT
R" 4HE CLASS MUST ./4 DElNE AN HME&UHDWH METHOD
R# 4HE HME3RVW&UHDWH METHODS ARE IMPLEMENTED BY THE CONTAINER
R$ (ELPER METHODS MUST ./4 BE IMPLEMENTED IN THE BEAN CLASS
R% -ETHODS STARTING WITH @HME)LQG MUST NOT BE IMPLEMENTED
\RXDUHKHUH
FRIIHHFUDPPRFNH[DP
7HICH ARE VALID DEPLOYMENT DESCRIPTOR SEGMENTS TO DElNE A CMR lELD
69 #HOOSE ALL THAT APPLY
R! HMEUHODWLRQVKLSUROH!
DVVXPHPDQGDWRU\HMEUHODWLRQVKLSUROHHOHPHQWV
LQVHUWHGKHUH!
FPU¿HOG!
FPU¿HOGW\SH!MDYDXWLO&ROOHFWLRQ FPU¿HOGW\SH!
FPU¿HOG!
HMEUHODWLRQVKLSUROH!
R" HMEUHODWLRQVKLSUROH!
DVVXPHPDQGDWRU\HMEUHODWLRQVKLSUROHHOHPHQWV
LQVHUWHGKHUH!
FPU¿HOG!
FPU¿HOGQDPH!OLQH,WHPV FPU¿HOGQDPH!
FPU¿HOGW\SH!MDYDXWLO&ROOHFWLRQ FPU¿HOGW\SH!
FPU¿HOG!
HMEUHODWLRQVKLSUROH!
R# UHODWLRQVKLSUROHVRXUFH!
DVVXPHPDQGDWRU\UHODWLRQVKLSUROHVRXUFHHOH
PHQWVLQVHUWHGKHUH!
FPU¿HOG!
FPU¿HOGW\SH!MDYDXWLO&ROOHFWLRQ FPU¿HOGW\SH!
FPU¿HOG!
UHODWLRQVKLSUROHVRXUFH!
R$ UHODWLRQVKLSUROHVRXUFH!
DVVXPHPDQGDWRU\UHODWLRQVKLSUROHVRXUFHHOH
PHQWVLQVHUWHGKHUH!
FPU¿HOG!
FPU¿HOGQDPH!OLQH,WHPV FPU¿HOGQDPH!
FPU¿HOGW\SH!MDYDXWLO&ROOHFWLRQ FPU¿HOGW\SH!
FPU¿HOG!
UHODWLRQVKLSUROHVRXUFH!
DSSHQGL[$
DSSHQGL[$ILQDOPRFNH[DP
7HATS TRUE ABOUT A REMOTE CLIENTS VIEW OF EXCEPTIONS RECEIVED FROM AN ENTITY
70 BEAN #HOOSE ALL THAT APPLY
R! )F THE CONTAINER MARKS A TRANSACTION FOR ROLLBACK THE CONTAINER WILL
ALWAYS ISSUE A MDYD[WUDQVDFWLRQ7UDQVDFWLRQ5ROOHGEDFN([FH
SWLRQ EXCEPTION
R" )F THE CLIENT RECEIVES A MDYD[WUDQVDFWLRQ7UDQVDFWLRQ5ROOHG
%DFN([FHSWLRQ THE CONTAINER GUARANTEES THAT THAT TRANSACTION WILL
NEVER COMMIT
R# ! MDYD[WUDQVDFWLRQ7UDQVDFWLRQ5HTXLUHG([FHSWLRQ EXCEP
TION INFORMS THE CLIENT THAT THE BEAN NEEDED TO BE CALLED WITHIN THE
CONTEXT OF A TRANSACTION
R$ )F THE CONTAINER DISCOVERS THAT A REQUESTED BEAN NO LONGER EXISTS IT WILL
ALWAYS THROW THE MDYD[HME1R6XFK2EMHFW(QWLW\([FHSWLRQ
\RXDUHKHUH
PRFNH[DPDQVZHUV
0DVWHU0RFN([DP$QVZHUV
7HICH ARE BENElTS OF %*" #HOOSE ALL THAT APPLY (spec: 108)
1
R! -$"S SURVIVE SERVER CRASHES
R" 2EPRESENTATIONS OF A SINGLE ENTITY CAN BE SHARED AMONG MULTIPLE CLI
ENTS
R# 3UPPORT FOR NESTED TRANSACTIONS
R$ $YNAMIC SERVICE DISCOVERY - ThatÕs a Jini thing
R% $ECLARATIVE ISOLATION LEVEL SETTINGS
7HICH METHODS ARE DIRECTLY INVOKED BY THE CLIENT #HOOSE ALL THAT APPLY
2
R! HME3DVVLYDWH - invoked by the Container
R" BUSINESS METHODS
R# VHW6HVVLRQ&RQWH[W
R$ QHZ,QVWDQFH - invoked by the Container
R% FUHDWH
7HICH METHODS CAN BE FOUND IN THE %*"(OME INTERFACE #HOOSE ALL THAT
3 APPLY (API docs)
R! REMOVE(ANDLE HANDLE
R" REMOVE/BJECT PRIMARY+EY
R# GET(ANDLE - this is in EJBObject
R$ NONE OF THE ABOVE
DSSHQGL[$
DSSHQGL[$ILQDOPRFNH[DP
7HICH METHODS CAN BE RUN BY A #-0 BEAN IN THE POOLED STATE #HOOSE ALL (spec: 168)
4 THAT APPLY
R! HME/RDG - The bean doesnÕt leave the pool for
R" HME)LQG home and Þnder methods
R# HME6WRUH
R$ HME&UHDWH
R% "USINESS METHOD
R& HME+RPH
324)
7HATS TRUE ABOUT MESSAGE DRIVEN BEANS #HOOSE ALL THAT APPLY
(spec: 314, 316,
5
R! !LL CALLS TO A MESSAGE DRIVEN BEAN INSTANCE MUST BE SERIALIZED
R" 4HE CONTAINER GUARANTEES THAT MESSAGES WILL BE PROCESSED IN THE ORDER
IN WHICH THEY ARE RECEIVED
must have a no-arg create,
R# 4HE BEANS HME&UHDWH METHOD MUST TAKE A SINGLE ARGUMENT OF TYPE onMessa ge takes the
MDYD[MPV0HVVDJH message as its argument
R$ 4HE BEAN PROVIDER USES THE DEPLOYMENT DESCRIPTOR TO INDICATE WHETHER
INSTANCES OF THE BEAN CLASS ARE INTENDED FOR TOPICS OR QUEUES
7HATS TRUE ABOUT AN ENTERPRISE BEANS ENVIRONMENT #HOOSE ALL THAT APPLY (spec: 412-413)
6
R! "EFORE A BEAN CAN ACCESS ITS ENVIRONMENT ENTRIES THE BEAN MUST lRST
OBTAIN THE NAMING CONTEXT USING A 6HVVLRQ&RQWH[W OBJECT
ypic al ly se t by the Deployer or
- t
R" /NLY THE BEAN PROVIDER CAN SET AN ENVIRONMENT ENTRY VALUE Application Assembler
R# ! BEANS ENVIRONMENT ENTRIES CAN BE STORED ONLY IN
µMDYD FRPSHQY¶OR ONE OF ITS SUBCONTEXTS
- donÕt confuse a JNDI context and an
EJBContext (like SessionContext)
R$ %VERY ENVIRONMENT ENTRY LOOKUP IN A BEANS CODE MUST HAVE A MATCHING
HQYHQWU\! ELEMENT IN THE BEANS DEPLOYMENT DESCRIPTOR - otherwise the code would have
nothing to look up!
7HATS TRUE ABOUT SECURITY ROLES IN %*"S #HOOSE ALL THAT APPLY
7 (spec: 440-44
3)
R! 3ECURITY ROLES ARE DElNED IN THE DEPLOYMENT DESCRIPTOR USING SECURITY
ROLE ELEMENTS
R" 3ECURITY ROLES ARE SCOPED TO THE INSTANCE LEVEL
R# -ANY METHODS CAN BE MAPPED TO A SINGLE SECURITY ROLE
R$ ! METHOD CAN APPEAR IN ONLY ONE SECURITY ROLE
\RXDUHKHUH
PRFNH[DPDQVZHUV
)
!N %*" CONTAINER MUST SUPPORT AT LEAST A SUBSET OF WHICH !0)S #HOOSE ALL (spec: 493-493
8 THAT APPLY
R! *4!
R" *$"#
R# *-3
R$ *!8
2#0
7HICH STATEMENTS CONCERNING STATELESS SESSION BEANS ARE TRUE #HOOSE ALL THAT (spec: 95)
9 APPLY
R! 4HEY CAN USE BEAN MANAGED TRANSACTION DEMARCATION
R" 4HEY MUST HAVE ONE NO ARGUMENT CREATE METHOD
R# ! SINGLE INSTANCE CAN SUPPORT CONCURRENT CALLS
R$ 4HEY MUST EXTEND JAVAXEJB3ESSION"EAN - implements : )
7HAT CAPABILITY EXISTS IN /.,9 /.% OF THE TWO BUT NOT BOTH
10
AN ENTITY OBJECTS REMOTE COMPONENT INTERFACE
AN ENTITY OBJECTS LOCAL COMPONENT INTERFACE
#HOOSE ALL THAT APPLY
R! 2EMOVING THE OBJECT
R" /BTAINING THE OBJECTS HANDLE not for local interfaces
R# )NVOKING BUSINESS METHODS
R$ /BTAINING THE OBJECTS PRIMARY KEY
7HEN CREATING A #-0 ENTITY BEAN WHICH METHODS ARE OPTIONAL #HOOSE ALL (spec: 171-174)
11 THAT APPLY
R! HME/RDG s
- yo u d on Õt ha ve to allow client
R" HME&UHDWH tities
to insert new en
R# HME5HPRYH
R$ HME6HOHFW
R% HME3DVVLYDWH
R& VHW(QWLW\&RQWH[W
DSSHQGL[$
DSSHQGL[$ILQDOPRFNH[DP
7HICH METHODS CAN BE CALLED ON A BEAN IN THE POOLED STATE #HOOSE ALL (spec: 168)
12 THAT APPLY
R! HME)LQG Þnder and seenleÕtctspeciÞc
R" HME/RDG methods arity
to one ent
R# HME6WRUH
R$ HME6HOHFW
R% HME3DVVLYDWH
7HATS TRUE ABOUT THE LIFECYCLE OF A MESSAGE DRIVEN BEAN #HOOSE ALL THAT AP (spec: 318-320)
13 PLY
R! 7HEN THE THE OQ0HVVDJH METHOD COMPLETES THE CONTAINER WILL TYPI
CALLY CALL EJB2EMOVE - bean just goes back to the pool
R" 4HE ON0HVVDJH METHOD CAN THROW APPLICATION EXCEPTIONS - to whom ?
R# -ESSAGE DRIVEN BEANS CAN RUN ONLY WITH #-4 DEMARCATION
R$ 4HE JHW5ROOEDFN2QO\ METHOD CAN BE CALLED ONLY FROM THE
ON-ESSAGE METHOD
14 7HICH STATEMENTS CONCERNING MESSAGE DRIVEN BEAN CLASSES ARE TRUE (spec: 323)
#HOOSE ALL THAT APPLY
R! 4HEY MUST IMPLEMENT DIRECTLY OR INDIRECTLY MDYD[MPV0HVVDJH - itÕs MessageListener
R" 4HEY MUST HAVE A PUBLIC CONSTRUCTOR THAT TAKES A SINGLE ARGUMENT OF
TYPE MDYD[MPV0HVVDJH
R# )MPLEMENTING THE ¿QDOL]H METHOD IS ALLOWED -No! not in any bean
R$ )MPLEMENTING THE HME&UHDWH METHOD IS OPTIONAL
R% 4HE CLASS MUST NOT BE DECLARED @lNAL- the Container might want to dep
loy a subclass of your bean
7ITHIN THE DEPLOYMENT DESCRIPTORS HMEORFDOUHI! ELEMENT WHICH ELE
15 MENTS ARE OPTIONAL #HOOSE ALL THAT APPLY (spec: 466)
R! ORFDO!
R" HMEOLQN!
R# ORFDOKRPH!
R$ GHVFULSWLRQ!
R% HMEUHIQDPH!
R& HMEUHIW\SH!
\RXDUHKHUH
PRFNH[DPDQVZHUV
7HATS TRUE ABOUT RESOURCE MANAGER CONNECTION FACTORIES #HOOSE ALL THAT (spec: 423, 481)
16 APPLY
R4HE UHVVKDULQJVFRSH! DEPLOYMENT DESCRIPTOR ELEMENT IS USED TO
INDICATE WHETHER CONNECTIONS TO A RESOURCE MANAGER ARE SHAREABLE
ACROSS MULTIPLE %*"S IN AN APPLICATION
R" 4HE UHVVKDULQJVFRSH! DEPLOYMENT DESCRIPTOR ELEMENT CONTAINS - backwards
THE UHVRXUFHUHI! ELEMENT
R# !LL OF A BEANS RESOURCE MANAGER CONNECTION FACTORY REFERENCES ARE - each must be individually
DECLARED IN A SINGLE UHVRXUFHUHI! ELEMENT USING speciÞed with a
UHVUHIQDPH! ELEMENTS TO DISTINGUISH THEM <resource-ref>
R$ "Y DEFAULT CONNECTIONS TO A GIVEN RESOURCE MANAGER ARE SHAREABLE
ACROSS MULTIPLE BEANS IN AN APPLICATION
446)
7HATS TRUE ABOUT SECURITY ROLES REFERENCED FROM AN %*"S CODE #HOOSE ALL (spec: 439-441,
17 THAT APPLY
R! )N THE DEPLOYMENT DESCRIPTOR SUCH REFERENCES ARE CONTAINED IN THE
VHFXULW\UROHUHI! ELEMENT
R" 4HE VHFXULW\UROH! ELEMENT INCLUDES THE
VHFXULW\UROHUHI! ELEMENT
R# 7ITHIN THE VHFXULW\UROHUHI! ELEMENT THE UROHQDPH! - this is NOT the same as a real
<security-role> role name
ELEMENTS VALUE IS THE SAME AS THE ARGUMENT FOR THE BEANS INVOCATION
OF THE LV&DOOHU,Q5ROH METHOD
R$ 4HE UROHOLQN! ELEMENT IS USED TO LINK TWO - no, it links a <security-role-ref> to a
VHFXULW\UROHUHI! ELEMENTS <security-role>
7HATS TRUE ABOUT THE CLIENTS VIEW OF SECURITY #HOOSE ALL THAT APPLY (spec: 450)
18
R! ! TRANSACTIONAL CLIENT CANNOT CHANGE ITS PRINCIPAL ASSOCIATION WITHIN A
TRANSACTION
R" ! SESSION BEANS CLIENT CANNOT CHANGE ITS PRINCIPAL ASSOCIATION FOR THE
DURATION OF THE COMMUNICATION WITH THE SESSION OBJECT
R# 4RANSACTIONAL REQUESTS WITHIN A SINGLE TRANSACTION CANNOT ARRIVE FROM
MULTIPLE CLIENTS
R$ .ONE OF THE ABOVE
DSSHQGL[$
DSSHQGL[$ILQDOPRFNH[DP
)
(spec: 494-495
7HEN PROGRAMMING AN ENTITY BEAN CLASS WHICH TECHNIQUES SHOULD BE
19 !6/)$%$ TO ENSURE BEAN PORTABILITY ACROSS ALL %*" CONTAINERS #HOOSE ALL
THAT APPLY
R! #HANGING A THREADS PRIORITY
R" 5SING THE REmECTION !0)
R# 5SING WRAPPER CLASSES
R$ 5SING STATIC NESTED CLASSES
)
20 7HEN PROGRAMMING A MESSAGE
DRIVEN BEAN CLASS WHICH TECHNIQUES SHOULD (spec: 494-495
BE AVOIDED TO ENSURE BEAN PORTABILITY ACROSS ALL %*" CONTAINERS #HOOSE
ALL THAT APPLY
R! 5SING 3WING !0)S FOR A '5)
R" 5SING THE @TRANSIENT MODIlER
R# 5SING NATIVE LIBRARIES
R$ 2EADING lLE DESCRIPTORS
7HAT IS REQUIRED OF THE CONTAINER WHEN IT PASSIVATES A STATEFUL SESSION BEAN (spec: 71)
21
R! 4HE BEANS INSTANCE STATE WILL ALWAYS UNDERGO *AVA PROGRAMMING LAN
GUAGE 3ERIALIZATION - it might be something similar
R" )T MUST SAVE ALL OF THE BEANS INSTANCE lELD STATE REGARDLESS OF THE lELDS
MODIlERS
R# )T MUST SAVE ANY REFERENCES TO THE BEANS 3ESSION#ONTEXT OBJECT
R$ )T MUST SAVE ALL NON NULL TRANSIENT VARIABLES - no, it wonÕt save transient variables, but
it might not reset them to default values...
7HICH CAPABILITIES ARE DElNED IN THE MDYD[HME(-%/RFDO2EMHFW INTER
22 FACE #HOOSE ALL THAT APPLY
R! 2EMOVE AN ENTITY OBJECT
R" /BTAIN AN ENTITY OBJECTS PRIMARY KEY
R# /BTAIN A LOCAL HOME INTERFACE FOR THE ENTITY OBJECT
R$ /BTAIN A REMOTE COMPONENT INTERFACE FOR THE ENTITY OBJECT
R% %XPOSE THE METHODS OF THE MDYD[HME(QWLW\%HDQ INTERFACE TO THE
CLIENT
\RXDUHKHUH
PRFNH[DPDQVZHUV
7HATS TRUE ABOUT EJB3ELECT METHODS #HOOSE ALL THAT APPLY (spec: 183)
23
R! 4HEY CAN BE EXPOSED TO THE CLIENT
R" 4HEY CAN RETURN ONLY %*"/BJECTS OR %*",OCAL/BJECTS - They can return almost anything
R# 4HEY CAN BE INVOKED ONLY BY A BEAN IN THE READY STATE - No, theyÕre good for home biz methods
R$ 4HEY MUST BE ASSOCIATED WITH A QUERY ELEMENT IN THE DEPLOYMENT DE
SCRIPTOR
7HICH METHODS CAN .%6%2 BE SUCCESSFULLY INVOKED FROM A MESSAGE DRIVEN (spec: 320-321)
24 BEAN #HOOSE ALL THAT APPLY
ient
R! LV&DOOHU,Q5ROH MDBs have ynohaclve no
R" JHW(-%+RPH view, so theient security
home or cl n
R# JHW5ROOEDFN2QO\ informatio
R$ VHW5ROOEDFN2QO\
R% JHW&DOOHU3ULQFLSDO
7HICH ROLE IS TYPICALLY RESPONSIBLE FOR ADDING EJB LINK ELEMENTS TO AN %*"S (spec: 418)
25 DEPLOYMENT DESCRIPTOR
R! BEAN PROVIDER
R" APPLICATION ASSEMBLER - linking one bean that refers to another
R# DEPLOYER
R$ CONTAINER PROVIDER
R% SYSTEM ADMINISTRATOR
26 )N WHICH OF THE FOLLOWING METHODS CAN A STATELESS SESSION BEAN INVOKE THE (spec: 90)
LV&DOOHU,Q5ROH METHOD IN ORDER TO PERFORM A SECURITY CHECK #HOOSE
ALL THAT APPLY
R! HME&UHDWH - isCallerInRole() can be called
R" HME5HPRYH from business methods only
R# VHW6HVVLRQ&RQWH[W
R$ .ONE OF THE ABOVE
DSSHQGL[$
DSSHQGL[$ILQDOPRFNH[DP
7HICH TWO ARE TYPICALLY RESPONSIBLE FOR CREATING EJB JAR lLES #HOOSE TWO (spec: 487)
27
R! 4HE BEAN PROVIDER
R" 4HE APPLICATION ASSEMBLER
R# 4HE DEPLOYER
R$ 4HE SYSTEM ADMINISTRATOR
7HICH OF THE FOLLOWING STATELESS SESSION BEAN CONTAINER CALLBACK METHODS (spec: 77)
28 TAKES AN ARGUMENT #HOOSE ALL THAT APPLY
R! HME5HPRYH
R" HME&UHDWH
R# HME&UHDWH
R$ HME3DVVLYDWH
t ak es a S es si on Context object
R% VHW6HVVLRQ&RQWH[W -
7HICH OF THESE CAN NEVER BE CALLED ON A 3ESSION#ONTEXT INTERFACE #HOOSE ALL (spec: 74)
29 THAT APPLY
R! JHW(-%+RPH
R" JHW(-%2EMHFW
R# JHW(-%7UDQVDFWLRQ - no such method : )
R$ LV&DOOHU,Q5ROH
R% JHW8VHU7UDQVDFWLRQ
7HATS TRUE ABOUT AN ENTITY BEANS REMOTE COMPONENT INTERFACE #HOOSE ALL (spec: 190)
30 THAT APPLY
R! )F A CLIENT ATTEMPTS TO INVOKE A METHOD ON AN ENTITY THAT DOES NOT EXIST A
MDYDUPL1R6XFK5HPRWH2EMHFW([FHSWLRQ WILL BE THROWN - itÕs NoSuchObjectException
R" )T MUST EXTEND MDYD[HME(-%+RPH - itÕs EJBObject
R# )TS METHODS MUST DECLAREMDYDUPL5HPRWH([FHSWLRQ
R$ )T DElNES AUHPRYH +DQGOHKDQGOH METHOD - This is only in the hom
e
\RXDUHKHUH
PRFNH[DPDQVZHUV
7HICH ARE TRUE ABOUT lNDER METHODS IN AN ENTITY BEANS LOCAL HOME INTERFACE
(spec: 196)
31 #HOOSE ALL THAT APPLY
R! 4HEY CAN HAVE ANY LEGAL *AVA NAME - must start with ÒÞndÓ
R" 4HEY MUST ALL DECLARE MDYD[HME)LQGHU([FHSWLRQ
R# 4HEY CAN OPTIONALLY DECLARE MDYDUPL5HPRWH([FHSWLRQ - not in a local interface!
R$ 4HE ¿QG%\3ULPDU\.H\ METHOD CAN BE OVERLOADED
R% 4HE ¿QG%\3ULPDU\.H\ METHODS RETURN TYPE MUST BE THE BEANS LOCAL
COMPONENT INTERFACE
R& ! METHOD CALLED hlND888v MUST HAVE THE BEANS LOCAL COMPONENT
INTERFACE AS ITS DECLARED RETURN TYPE - it could also be a Collection
, 317)
7HICH ARE TRUE FOR A MESSAGE
DRIVEN BEAN #HOOSE ALL THAT APPLY (spec: 324-325
32
R! 4HE $EPLOYER USES THE DEPLOYMENT DESCRIPTOR TO DETERMINE WHETHER A BEAN
IS INTENDED FOR A 1UEUE OR A 4OPIC
R" 4HE CLASS MUST BE DECLARED lNAL
R# 4HE CLASS MUST DElNE ONE HME5HPRYH METHOD
R$ 4HE CLASS CAN HAVE OVERLOADED HME&UHDWH METHODS - thereÕs no client
R% 4HE CLASS MUST DElNE A NO
ARGUMENT ON-ESSAGE METHOD - onMessage takes a message
'IVEN THE FOLLOWING SUBSET OF A DEPLOYMENT DESCRIPTOR
33 HQWLW\! (spec: 440)
HMEQDPH!3D\UROO HMEQDPH!
VHFXULW\UROHUHI!
UROHQDPH!FOHUN UROHQDPH!
VHFXULW\UROHUHI!
HQWLW\!
7HICH CODE SNIPPETS MAKES A LEGAL SECURITY CHECK #HOOSE ALL THAT APPLY
R! FRQWH[WLV&DOOHU,Q5ROH ³3D\UROO´
R" FRQWH[WLV&DOOHU,Q5ROH ³FOHUN´
R# FRQWH[WLV&DOOHU,Q5ROH ³3D\UROOFOHUN´
R$ FRQWH[WLV&DOOHU,Q5ROH ³3D\UROOFOHUN´
DSSHQGL[$
DSSHQGL[$ILQDOPRFNH[DP
34 7HICH ARE VALID LOCAL HOME INTERFACES FOR A STATEFUL SESSION BEAN #HOOSE ALL (spec: 98)
THAT APPLY
R! SXEOLFLQWHUIDFH7HVW%HDQLPSOHPHQWV
MDYD[HME(-%/RFDO+RPH^ Must:
Y
RLGFUHDWH WKURZV&UHDWH([FHSWLRQ - throw CreateException
`
- return local interface type
- start with ÒcreateÓ
R" SXEOLFLQWHUIDFH7HVW%HDQH[WHQGV - NOT throw RemoteException
MDYD[HME(-%/RFDO+RPH^
7
HVW%HDQ/RFDOHME&UHDWH WKURZV&UHDWH([FHSWLRQ
`
R# SXEOLFLQWHUIDFH7HVW%HDQH[WHQGV
MDYD[HME(-%/RFDO+RPH^
7HVW%HDQ/RFDOFUHDWH WKURZV&UHDWH([FHSWLRQ
`
R$ SXEOLFLQWHUIDFH7HVW%HDQH[WHQGV
MDYD[HME(-%/RFDO+RPH^
7
HVW%HDQ/RFDOFUHDWH WKURZV&UHDWH([FHSWLRQ
5HPRWH([FHSWLRQ
`
R% SXEOLFLQWHUIDFH7HVW%HDQH[WHQGV
MDYD[HME(-%/RFDO+RPH^
7
HVW%HDQ/RFDOFUHDWH WKURZV/RFDO([FHSWLRQ
`
7HICH METHODS CAN BE CALLED BY A BEAN PROVIDER #HOOSE ALL THAT APPLY
35
R! UHPRYH - the callback is ejbRemove
R" HME&UHDWH
R# DIWHU%HJLQ The others caarllbe acks
R$ JHW&DOOHU3ULQFLSDO Container
R% HME3DVVLYDWH
\RXDUHKHUH
PRFNH[DPDQVZHUV
7HO WILL TYPICALLY SPECIFY WHETHER A BEAN IS RE ENTRANT IN THE BEANS DEPLOY (spec: 457)
36 MENT DESCRIPTOR
R! 4HE BEAN PROVIDER
R" 4HE APPLICATION ASSEMBLER
R# 4HE DEPLOYER
R$ 4HE SYSTEM ADMINISTRATOR
7HICH STATEMENTS ABOUT STATEFUL AND STATELESS SESSION BEANS ARE TRUE
37 #HOOSE ALL THAT APPLY
R! /NLY STATEFUL SESSION BEANS SUPPORT TRANSACTIONS
R" /NLY STATEFUL SESSION BEANS CAN BE PASSIVATED
R# /NLY STATEFUL SESSION BEANS HAVE A µVHW6HVVLRQ&RQWH[W¶ METHOD le,
- st at el es s must have a sing
R$ "OTH STATEFUL AND STATELESS SESSION BEANS CAN SUPPORT OVERLOADED
µHME&UHDWH¶METHODS
arg ejbCreate
no-
R% "OTH STATEFUL AND STATELESS SESSION BEANS CAN IMPLEMENT THE- only stateful
MDYD[HME6HVVLRQ6\QFKURQL]DWLRQ INTERFACE ve state,
- stateless iecantn -haspeciÞc
R& "OTH STATEFUL AND STATELESS SESSION BEANS CAN HAVE INSTANCE VARIABLE STATE just not cl
state
)
38 7HICH MUST BE INCLUDED IN EVERY EJB
JAR lLE #HOOSE ALL THAT APPLY (spec: 488-490
R! 4HE STUB FOR THE %*"(OME INTERFACE EITHER DIRECTLY OR BY REFERENCE
- This is the
R" 4HE *!2 -ANIFEST lLE - not n ContainerÕs jo
eeded as of E b
R# ! DEPLOYMENT DESCRIPTOR J B 2 .0
R$ 4HE *.$) CONTEXT
R% 4HE %*"S HOME INTERFACE EITHER DIRECTLY OR BY REFERENCE
7HICH METHODS ARE DECLARED IN THE JAVAXEJB%*"(OME INTERFACE #HOOSE (API docs)
39 ALL THAT APPLY
R! FUHDWH
R" ORRNXS
R# JHW+DQGOH
R$ JHW+RPH+DQGOH
R% VHW6HVVLRQ&RQWH[W
DSSHQGL[$
DSSHQGL[$ILQDOPRFNH[DP
(OW MANY JAVAXEJB%*",OCAL(OME INTERFACE METHODS CAN BE CALLED WITHOUT (spec: 60)
40 AN EXCEPTION FROM A SESSION BEAN CLIENT
R!
The only method in EJBLocalHome is
R" remove that takes a primary key
R#
R$
R%
7HICH OF THE FOLLOWING IF CALLED ALWAYS HAVE THE SAME TRANSACTION CONTEXT AS A (spec: 76)
41 SESSION BEANS BUSINESS METHODS #HOOSE ALL THAT APPLY
R! CONSTRUCTOR
R" VHW6HVVLRQ&RQWH[W
R# DIWHU%HJLQ
R$ DIWHU&RPSOHWLRQ - transaction is over
R% EHIRUH&RPSOHWLRQ
42 'IVEN A STATEFUL SESSION BEAN WITH CONTAINER MANAGED TRANSACTION DEMARCATION (spec: 80)
FROM WHICH METHODS CAN YOU ACCESS ANOTHER BEAN #HOOSE ALL THAT APPLY
R! VHW6HVVLRQ&RQWH[W
R" HME&UHDWH setSessionContext and
R# DIWHU%HJLQ afterCompletion have
NO meaningful tx context
R$ EHIRUH&RPSOHWLRQ
R% DIWHU&RPSOHWLRQ
7HICH DEPLOYMENT DESCRIPTOR ELEMENTS CAN OPTIONALLY SPECIFY CASCADE DELETE (spec: 468)
43 FUNCTIONALITY #HOOSE ALL THAT APPLY
R! HMEUHODWLRQ!
R" DEVWUDFWVFKHPDQDPH!
R# HMEUHODWLRQVKLSUROH!
R$ UHODWLRQVKLSUROHVRXUFH!
\RXDUHKHUH
PRFNH[DPDQVZHUV
7HATS TRUE ABOUT CASCADE DELETE #HOOSE ALL THAT APPLY (spec: 133)
44
R! )T IS DECLARED IN THE HME5HPRYH METHOD
- cascade-delete says Òdelete
R" 7HEN A CASCADE DELETE ENABLED BEAN IS DELETED IT CAUSES ALL OF THE ME if my partner is removedÓ
BEANS WITH RELATIONSHIPS TO IT TO BE AUTOMATICALLY DELETED TOO
- not for many-to-many
R# )T CAN BE SPECIlED FOR ONE TO ONE ONE TO MANY OR MANY TO MANY RELA
TIONSHIPS
R$ ! CASCADE DELETE ENABLED BEAN IS AUTOMATICALLY REMOVED WHEN ANY
hMULTIPLICITY OF ONEv BEAN WITH WHICH IT IS RELATED IS REMOVED
7HICH METHODS FROM THE %NTITY#ONTEXT INTERFACE CAN BE INVOKED REGARDLESS (spec: 180)
45 OF TRANSACTION CONTEXT #HOOSE ALL THAT APPLY
R! JHW(-%+RPH
R" JHW(-%2EMHFW
R# VHW5ROOEDFN2QO\
R$ JHW5ROOEDFN2QO\
7HATS TRUE ABOUT AN ENTITY BEANS PRIMARY KEY #HOOSE ALL THAT APPLY
(spec: 120, 130)
46
R! 0RIMARY KEY lELDS MUST BE CMP lELDS - you can use a compound key
R" 3ETTER METHODS FOR lELDS ASSOCIATED WITH A PRIMARY KEY MUST NOT BE
EXPOSED THROUGH A CLIENT VIEW
R# )F TWO ENTITY OBJECTS HAVE THE SAME HOME AND THE SAME PRIMARY KEY
THEY ARE CONSIDERED IDENTICAL
R$ 4HE JHW3ULPDU\.H\ METHOD CAN BE INVOKED ON REFERENCES TO ONLY
REMOTE HOME INTERFACES NOT LOCAL HOME INTERFACES
7HICH INTERFACES ARE USED BY THE BEAN PROVIDER TO PERFORM "-4 DEMARCA (spec: 332)
47 TION #HOOSE ALL THAT APPLY
R! MDYD[WUDQVDFWLRQ7UDQVDFWLRQ
R" MDYD[WUDQVDFWLRQ8VHU7UDQVDFWLRQ
R# MDYD[WUDQVDFWLRQ6\QFKURQL]DWLRQ
R$ MDYD[WUDQVDFWLRQ7UDQVDFWLRQ0DQDJHU
DSSHQGL[$
DSSHQGL[$ILQDOPRFNH[DP
7HICH OF THE FOLLOWING ARE LEGAL %*" 1, QUERIES #HOOSE ALL THAT APPLY (spec: 236)
48
R! 3%,%#4 C -needs Object (c) or a path
&2/- #USTOMER C
R" 3%,%#4 /"*%#4 CNAME - Just all wrong! must be OBJECT(c) or
&2/- #USTOMER C c.name (see answers D and E)
R# 3%,%#4 /"*%#4 C - must have a FROM, and (c)
7(%2% #USTOMER C
R$ 3%,%#4 /"*%#4 C
&2/- #USTOMER C
R% 3%,%#4 CNAME
&2/- #USTOMER C
7HICH ARE TRUE ABOUT TRANSACTIONS IN %*" #HOOSE ALL THAT APPLY
(spec: 339, 348)
49
R! /NLY ONE DATABASE CAN BE UPDATED WITHIN A SINGLE TRANSACTION - This would elinimate a key
EJB 2.0 feature of
R" %NTITY BEANS WITH "-4 DEMARCATION MUST USE THE SET3TATUS METHOD distributed transactions
INSTEAD OF THE VHW5ROOEDFN2QO\ METHOD
R# %NTITY BEANS WITH "-4 DEMARCATION MUST USE THE GET3TATUS METHOD
INSTEAD OF THE JHW5ROOEDFN2QO\ METHOD
R$ "-4 DEMARCATION SHOULD BE USED WHEN BEANS ACCESS RESOURCE MANAG
- use CMT
ERS THAT DO NOT SUPPORT TRANSACTIONS with ÒNotSuppo
rtedÓ
R% 4HE @3ESSION3YNCHRONIZATION INTERFACE CAN BE USED ONLY BY STATEFUL
SESSION BEANS
50 4O ENSURE BEAN PORTABILITY WHICH TRANSACTION ATTRIBUTES SHOULD BE USED ON THE (spec: 352)
BUSINESS METHODS IN THE COMPONENT INTERFACE OF AN ENTITY BEAN USING #-0
#HOOSE ALL THAT APPLY
R! .OT3UPPORTED
R" 2EQUIRED
R# 3UPPORTS
R$ 2EQUIRES.EW
R% -ANDATORY
R& .EVER
\RXDUHKHUH
PRFNH[DPDQVZHUV
)
7HICH OF THE FOLLOWING EXCEPTIONS WOULD CAUSE A BEAN TO BE DISCARDED BY THE (spec: 372-374
51 CONTAINER #HOOSE ALL THAT APPLY
R! MDYD[HME2EMHFW1RW)RXQG([FHSWLRQ The others are recoverable
R" MDYD[HME&UHDWH([FHSWLRQ application exceptions
R# MDYD[HME1R6XFK(QWLW\([FHSWLRQ
R$ MDYD[HME)LQGHU([FHSWLRQ
R% MDYD[HME5HPRYH([FHSWLRQ
)N WHICH CASES SHOULD THE CONTAINER LOG AN EXCEPTION THROWN BY A BUSINESS (spec: 376)
52 METHOD OF A #-4 DEMARCATED BEAN #HOOSE ALL THAT APPLY
R! )F THE METHOD RUNS WITH AN UNSPECIlED TRANSACTION CONTEXT AND THROWS
A SYSTEM EXCEPTION
- system exceptions are
R" )F THE METHOD RUNS WITH AN UNSPECIlED TRANSACTION CONTEXT AND THROWS always logged
AN APPLICATION EXCEPTION
R# )F THE METHOD RUNS WITH A 2EQUIRES.EW CONTEXT AND THROWS A SYSTEM
EXCEPTION
R$ )F THE METHOD RUNS WITH A 2EQUIRED CONTEXT AND THROWS A SYSTEM EXCEP
TION
R% )F THE METHOD RUNS WITH A 2EQUIRES.EW CONTEXT AND THROWS AN APPLICA
TION EXCEPTION
R& )F THE METHOD RUNS WITH A 2EQUIRED CONTEXT AND THROWS AN APPLICATION
EXCEPTION
7HICH SESSION BEAN COMPONENT INTERFACE METHODS CAN BE CALLED SUCCESSFULLY
53 BY A LOCAL CLIENT #HOOSE ALL THAT APPLY
R! UHPRYH
R" JHW+DQGOH - local client views donÕt have handles
R# LV,GHQWLFDO
R$ JHW(-%+RPH - should
be getEJBLo
calHome()
DSSHQGL[$
DSSHQGL[$ILQDOPRFNH[DP
)N WHAT SCENARIOS CAN A BEANS BUSINESS METHOD CALL THE LV&DOOHU,Q5ROH
54 METHOD OF THE 3ESSION#ONTEXT INTERFACE #HOOSE ALL THAT APPLY
Transaction demarcation
R! ! STATEFUL SESSION BEAN WITH CONTAINER
MANAGED TRANSACTION DEMARCA
doesnÕt matter here
TION
R" ! STATELESS SESSION BEAN WITH CONTAINER
MANAGED TRANSACTION DEMARCA
TION
R# ! STATEFUL SESSION BEAN WITH BEAN
MANAGED TRANSACTION DEMARCATION
R$ ! STATELESS SESSION BEAN WITH BEAN
MANAGED TRANSACTION DEMARCATION
R% .ONE OF THE ABOVE
7HEN CREATING AN ENTITY BEAN USING CONTAINER MANAGED PERSISTENCE WHICH CAN
(spec: 130)
55 BE ACCESSED THROUGH THE BEANS REMOTE COMPONENT INTERFACE #HOOSE ALL THAT
APPLY
R! !CCESSOR METHODS FOR THE RELATIONSHIP lELDS
R" 4HE LOCAL INTERFACE OF THE ENTITY BEAN
R# 4HE BEANS BUSINESS METHODS
R$ 4HE COLLECTION CLASSES USED FOR CONTAINER MANAGED RELATIONSHIPS
idea...
R% !CCESSOR METHODS FOR THE PERSISTENT lELDS - legal, just not a good
'IVEN THE CONTAINER MANAGED ONE TO ONE BIDIRECTIONAL RELATIONSHIP (spec: 138)
56 )RR !%DU
!ND THE OBJECT RELATIONS
I
!E
I !E
7HICH BOOLEAN EXPRESSION WILL BE TRUE AFTER THE FOLLOWING CODE RUNS
E
VHW)RR EJHW)RR
#HOOSE ALL THAT APPLY
When b2 took b1Õs Foo, he replaced his own
foo2 with foo1. So now, foo2 has no bar.
R!IJHW%DU QXOO
I
E
R" EJHW)RR QXOO
IE
R# IJHW%DU QXOO
R$ NONE OF THE ABOVE
\RXDUHKHUH
PRFNH[DPDQVZHUV
7HATS TRUE ABOUT AN ENTITY BEANS IDENTITY #HOOSE ALL THAT APPLY
57 (spec: 121)
R! )F TWO ENTITY OBJECT REFERENCES ARE COMPARED USING THE OPERATOR THE
CONTAINER PROVIDER IS NOT REQUIRED TO PRODUCE CONSISTENT RESULTS
R" )F TWO ENTITY OBJECT REFERENCES ARE COMPARED USING THE HTXDOV
METHOD THE CONTAINER WILL RETURN TRUE IF THE TWO ENTITY OBJECTS HAVE THE
SAME PRIMARY KEY - not guaranteed
R# )F TWO ENTITY OBJECT REFERENCES ARE COMPARED USING THE LV,GHQWLFDO
METHOD THE CONTAINER WILL RETURN TRUE IF THE TWO ENTITY OBJECTS HAVE THE
SAME PRIMARY KEY
R$ .ONE OF THE ABOVE STATEMENTS ARE TRUE
'IVEN #-0 BEANS #USTOMER"EAN /RDER"EAN AND ,INE)TEMS"EAN WITH THE (spec: 232)
58 FOLLOWING RELATIONSHIPS
#USTOMER"EAN /RDER"EAN N
/RDER"EAN ,INE)TEMS"EAN N
7HICH WILL RETURN A SET OF CUSTOMERS THAT HAVE ORDERS #HOOSE ALL THAT APPLY
R! 3%,%#4 #USTOMER - need OBJECT or path
&2/- /RDER
R" 3%,%#4 $)34).#4 #USTOMER - need OBJECT or path
&2/- /RDER
R# 3%,%#4 OCUSTNUM
&2/- /RDER O #USTOMER C
- not a Customer type
7(%2% CCUSTNUM OCUSTNUM
R$ 3%,%#4 /"*%#4 C - doesnÕt guarantee you wonÕt
&2/- #USTOMER C /RDER O get duplicates
7(%2% CCUSTNUM OCUSTNUM
R% 3%,%#4 $)34).#4 /"*%#4 C
&2/- #USTOMER C /RDER O
7(%2% CCUSTNUM OCUSTNUM
DSSHQGL[$
DSSHQGL[$ILQDOPRFNH[DP
'IVEN
59
(spec: 357-359)
0
HWKRG 7[ !0HWKRG 7[ !0HWKRG 7[
?!0HWKRG 7[
)F THE CALLING METHOD IS ON THE LEFT SIDE OF AN ARROW AND THE CALLED METHOD ON
THE RIGHT WHICH SET OF TRANSACTION ATTRIBUTES WILL SUPPORT THE TRANSACTION SCOPE
SPECIlED #HOOSE ALL THAT APPLY
a
R! 0 1HYHU
V E R . M et ho d 1 could not Nbeeviner
N E w as
0 6XSSRUWV - Never meannsif...its transaction attribute
0 5HTXLUHG trans ac t io
0 5HTXLUHV1HZ
R" 0 5HTXLUHG
0 6XSSRUWV
0 0DQGDWRU\
0 5HTXLUHV1HZ
R# 0 5HTXLUHV1HZ
ho d tion, but
1Õs transacra
nn in g in m et t nsaction
0 5HTXLUHV1HZ
- method 2Reqis uiruresNew, it would be a new
0 6XSSRUWV if it had
0 5HTXLUHV1HZ
R$ 0 5HTXLUHG - method 4 starts a
0 0DQGDWRU\ does not have Supportsnew transaction, so it obviously
0 6XSSRUWV
as an attribute
0 6XSSRUWV
'IVEN THE %*" 1, EXPRESSION (spec: 229)
60 SGLVFRXQW127%(7:((1$1' - 10 and 15 a
re EXCLUDE
7HICH EXPRESSION IS EQUIVALENT D
R! SGLVFRXQW 25SGLVFRXQW!
R" SGLVFRXQW 25SGLVFRXQW!
R# SGLVFRXQW 25SGLVFRXQW!
R$ SGLVFRXQW 25SGLVFRXQW!
\RXDUHKHUH
PRFNH[DPDQVZHUV
7HEN A BUSINESS METHOD IN AN ENTITY BEAN CALLS THE JHW5ROOEDFN2QO\ (spec: 361)
61 METHOD WHICH TRANSACTION ATTRIBUTE SETTINGS COULD CAUSE THE CONTAINER TO
THROW AN EXCEPTION #HOOSE ALL THAT APPLY
R! .OT3UPPORTED
R" 2EQUIRED
R# 3UPPORTS - because there might not be one
R$ 2EQUIRES.EW
R% -ANDATORY
R& .EVER
7HICH OF THE FOLLOWING IS PERFORMED BY THE CONTAINER IF A MESSAGE DRIVEN BEAN (spec: 356)
62 DOES NOT COMPLETE ITS TRANSACTION BEFORE THE END OF THE ON-ESSAGE METHOD
#HOOSE ALL THAT APPLY
R! ,OG AN APPLICATION ERROR
R" 2OLL BACK THE STARTED TRANSACTION
R# $ISCARD THE INSTANCE OF THE BEAN
R$ 4HROW AN EXCEPTION - to whom?
&ROM WHICH CLASSES CAN APPLICATION EXCEPTIONS EXTEND #HOOSE ALL THAT AP (spec: 373)
63 PLY
R! MDYDODQJ([FHSWLRQ
R" MDYDODQJ5XQWLPH([FHSWLRQ - they must be checked
R# MDYDUPL5HPRWH([FHSWLRQ - you just canÕt do this, even though it IS a
checked exception... itÕs Bean Law
R$ MDYD[HME&UHDWH([FHSWLRQ
7HATS TRUE ABOUT APPLICATION EXCEPTIONS #HOOSE ALL THAT APPLY (spec: 372-373)
64
R! 4HEY ARE INTENDED TO BE HANDLED BY THE SYSTEM ADMINISTRATOR
R" 4HEY SHOULD REPORT SYSTEM LEVEL PROBLEMS
They are intended to be
handled by the client
R# 4HEY CAUSE AUTOMATIC MARKING OF TRANSACTIONS FOR ROLLBACK
R$ 4HEY MUST NOT EXTEND MDYDODQJ5XQWLPH([FHSWLRQ
R% 4HEY MAY EXTENDMDYDUPL5HPRWH([FHSWLRQ - NO
DSSHQGL[$
DSSHQGL[$ILQDOPRFNH[DP
7HICH CASES CAN CAUSE A SESSION BEAN INSTANCE TO BE DESTROYED WITHOUT THE (spec: 79)
65 CONTAINER CALLING HME5HPRYH #HOOSE ALL THAT APPLY
R! ! TRANSACTION IS ROLLED BACK ON A STATEFUL SESSION BEAN WITH CONTAINER
MANAGED TRANSACTION DEMARCATION
R" ! SYSTEM EXCEPTION IS THROWN FROM A BUSINESS METHOD
R# !N INACTIVE CLIENT IS TIMED OUT WHILE THE BEAN IS IN A PASSIVATED STATE
R$ 4HE CLIENT INVOKES THE REMOVE METHOD WHILE THE BEAN IS IN A TRANSAC
TION - client gets exception, bean survives
7HICH DEPLOYMENT DESCRIPTOR ELEMENTS ARE USED TO SPECIFY A #OLLECTION (spec: 462)
66 INTERFACE #HOOSE ALL THAT APPLY
R! HMEQDPH!
R" FPU¿HOG!
R# HMEUHODWLRQ!
R$ FPU¿HOGW\SH! - fororÒmanyÓ multiplicity, to indicate
Set Collection
R% DEVWUDFWVFKHPDQDPH!
)F A BEAN CATCHES A CHECKED EXCEPTION FROM WHICH IT CANNOT RECOVER WHAT (spec: 373)
67 SHOULD IT DO #HOOSE ALL THAT APPLY
R! )F THE CLIENT IS REMOTE THROW A MDYDUPL5HPRWH([FHSWLRQ - a bean must NEVER throw
R" 0RINT A STACK TRACE RemoteException. Only the
Container can do it.
R# 2EGARDLESS OF THE CLIENT THROW A MDYD[HME(-%([FHSWLRQ
R$ 2EGARDLESS OF THE CLIENT PROPAGATE THE SAME EXCEPTION TO THE CONTAIN
ER
7HICH ARE REQUIREMENTS FOR A #-0 ENTITY BEAN CLASS #HOOSE ALL THAT APPLY (spec: 190-191)
68
R! !LL HME6HOHFW METHODS MUST BE DECLARED AS ABSTRACT
R" 4HE CLASS MUST ./4 DElNE AN HME&UHDWH METHOD
R# 4HE HME3RVW&UHDWH METHODS ARE IMPLEMENTED BY THE CONTAINER
R$ (ELPER METHODS MUST ./4 BE IMPLEMENTED IN THE BEAN CLASS
R% -ETHODS STARTING WITH @HME)LQG MUST NOT BE IMPLEMENTED
\RXDUHKHUH
PRFNH[DPDQVZHUV
7HICH ARE VALID DEPLOYMENT DESCRIPTOR SEGMENTS TO DElNE A CMR lELD (spec: 162, 463)
69 #HOOSE ALL THAT APPLY
R! HMEUHODWLRQVKLSUROH!
DVVXPHPDQGDWRU\HMEUHODWLRQVKLSUROHHOHPHQWV
LQVHUWHGKHUH!
me
FPU¿HOG!
-missing Þeld na
FPU¿HOGW\SH!MDYDXWLO&ROOHFWLRQ FPU¿HOGW\SH!
FPU¿HOG!
HMEUHODWLRQVKLSUROH!
R" HMEUHODWLRQVKLSUROH!
DVVXPHPDQGDWRU\HMEUHODWLRQVKLSUROHHOHPHQWV
LQVHUWHGKHUH!
FPU¿HOG!
FPU¿HOGQDPH!OLQH,WHPV FPU¿HOGQDPH!
FPU¿HOGW\SH!MDYDXWLO&ROOHFWLRQ FPU¿HOGW\SH!
FPU¿HOG!
HMEUHODWLRQVKLSUROH!
R# UHODWLRQVKLSUROHVRXUFH!
DVVXPHPDQGDWRU\UHODWLRQVKLSUROHVRXUFHHOH
PHQWVLQVHUWHGKHUH!
FPU¿HOG!
- missing name, and in
FPU¿HOGW\SH!MDYDXWLO&ROOHFWLRQ FPU¿HOGW\SH! role source, as opposed
FPU¿HOG! to role
UHODWLRQVKLSUROHVRXUFH!
R$ UHODWLRQVKLSUROHVRXUFH!
DVVXPHPDQGDWRU\UHODWLRQVKLSUROHVRXUFHHOH
PHQWVLQVHUWHGKHUH!
FPU¿HOG! le source
FPU¿HOGQDPH!OLQH,WHPV FPU¿HOGQDPH! -canÕt be in a ro
FPU¿HOGW\SH!MDYDXWLO&ROOHFWLRQ FPU¿HOGW\SH!
FPU¿HOG!
UHODWLRQVKLSUROHVRXUFH!
DSSHQGL[$
DSSHQGL[$ILQDOPRFNH[DP
7HATS TRUE ABOUT A REMOTE CLIENTS VIEW OF EXCEPTIONS RECEIVED FROM AN ENTITY (spec: 383)
70 BEAN #HOOSE ALL THAT APPLY
- only if the callerÕs
R! )F THE CONTAINER MARKS A TRANSACTION FOR ROLLBACK THE CONTAINER WILL
ALWAYS ISSUE A MDYD[WUDQVDFWLRQ7UDQVDFWLRQ5ROOHGEDFN([FH transac
tion was rolled
SWLRQ EXCEPTION
back (as opposed to
suspended)
R" )F THE CLIENT RECEIVES A MDYD[WUDQVDFWLRQ7UDQVDFWLRQ5ROOHG
%DFN([FHSWLRQ THE CONTAINER GUARANTEES THAT THAT TRANSACTION WILL
NEVER COMMIT
happens with
R# ! MDYD[WUDQVDFWLRQ7UDQVDFWLRQ5HTXLUHG([FHSWLRQ EXCEP -Mandat
the
ory tx attribute
TION INFORMS THE CLIENT THAT THE BEAN NEEDED TO BE CALLED WITHIN THE
CONTEXT OF A TRANSACTION
R$ )F THE CONTAINER DISCOVERS THAT A REQUESTED BEAN NO LONGER EXISTS IT WILL
ALWAYS THROW THE MDYD[HME1R6XFK2EMHFW(QWLW\([FHSWLRQ
- java.rmi.NoS
uchObjectExce
ption
\RXDUHKHUH
JRRGOXFN
This isnÕt goodbye
%ULQJ\RXUEUDLQRYHUWR
'RQ·W\RXNQRZWKHUH·VPRUHRQWKH ZLFNHGO\VPDUWFRP
ZLFNHGO\VPDUWFRPZHEVLWH"<RX·OOÀQGVRPH
FRGHVRPHPRUHPRFNH[DPTXHVWLRQVDQG
$QGGRQ·WIRUJHWWRZULWHDQGWHOOXV
PD\EHHYHQRXUIDYRULWHPDUWLQLUHFLSH
ZKHQ\RXSDVVWKHH[DP
$QGLI\RX·UHJRLQJWRWDNHWKHH[DPEHVXUHWRGURSE\
MDYDUDQFKFRPDQGVSHQGVRPHWLPHLQWKH6&%&'
,NLFNHGEXWW#ZLFNHGO\VPDUWFRP
VWXG\IRUXP)RONVWKHUHDUHMXVWVRGDPQ :H¶OOKDYHDGULQNLQ\RXUKRQRU
IULHQGO\LW·OOPDNH\RXZDQWWRWKURZXS
RXWWDNHV
&RYHU5RXJK'UDIWVIRUWKHVHULHV
,WZDVDWRXJKGHFLVLRQ
%HIRUHZHÀQDOO\VHWWOHGRQ
ZHNLFNHGDURXQG
DORWRISURPLVLQJ
FDQGLGDWHV
We were
the wholethhainnking this might play u
do you think? ds-on approach... whatp
-K & B
0IVL[.QZ[\ ZHOOVLQFHLW·VEUDLQEDVHG ZK\
GRQ·WZHHPSKDVL]HWK H+($'DQG
FDOOLW+HDG)LUVW" DUNHWLQJ
P
Hey, is this what you had in
mind by Òemphasize the Head?Ó
-K&B
>XPQRPDUNHWLQJ@
, .1 2: W KL V RQ H LV PRUHIHVWLYHE(XWOHDYH
0MIL.QZ[
\
<HV
ZKDWWKHA#URG RHVLWPHDQ"3/($6
VVLRQDOV
WKLVWRWKHSIHPDUNHWLQJ
WasnÕt this the one
we agreed on last
week? - K & B
/]Q\IZ.QZ[\
0MIL.QZ[\
\RXDUHKHUH
Index
Symbols <env-entry> 607
<exclude-list> 574
<abstract-schema-name> 384, 394, 406 <message-driven-destination> 449
<acknowledge-mode> 460 <message-driven> 449
<assembly-descriptor> 503 <method-intf> 582
<cascade-delete/> 393 <method-param> 505
<cmp-field> 384 <method-params> 505, 579
<cmr-field-name> 388 <method-permission> 574, 578
<cmr-field-type> 388 <method> 504, 579
<cmr-field> 388 <multiplicity> 388, 422
<container-transaction> 502 <persistence-type> 385
<destination-type> 449 <relationships> 395
<ejb-link> 615 <res-auth> 610, 611
<ejb-local-ref> 614 <res-ref-name> 610
<ejb-ref-name> 613 <res-sharing-scope> 610
<ejb-ref-type> 613 <res-type> 610
<ejb-ref> 613 <resource-env-ref> 616
<ejb-relation> 388 <resource-ref> 610
<ejb-relationship-role-name> 388 <role-link> 589
<ejb-relationship-role> 388 <role-name> 574
<env-entry-name> 607 <run-as> 591, 592
<env-entry-type> 607 <security-identity> 591
<env-entry-value> 607 <security-role-ref> 589
this is a new appendix 685
the index
<security-role> 574 architectural overview 63
<trans-attribute> 476, 502, 504 arguments 67
<transaction-type> 476, 502 Atomic 472
<unchecked/> 574, 581 attributes. See transaction attributes
authentication 572
authorization 572
A Auto-acknowledge 460
B
abstract 313
abstract getters and setters 315, 383
abstract getter and setter 313
abstract persistence schema 384, 387 Bean-managed transactions. See BMT
abstract schema type 408 beanness 188, 191, 196
ACID test 472 beans 11. See also entity beans; See also message-driven
beans; See also session beans
acknowledgement. See message acknowledgement
bean inheritance 186
actor playing an entity 350
five things you do to build a bean 16
administered object 616
overview 98
Advice Guy bean 15
bean creation 188, 192, 194, 196. See also entity beans
afterBegin() 512
bean getting shot 283
afterCompletion() 512
Bean Provider 26
Application 33
exception responsibilities 541
making a new J2EE app in the deploytool 33
passivation responsibility for stateful session beans
Application Assembler 26 203
Application Assembler’s responsibility responsibility for the Deployment Descriptor 617
<ejb-link> 615 security responsibilities 589
deployment descriptor 617 writing a CMP entity bean 313
security 574, 588 writing a message-driven bean 447
Application exceptions 532 beat box. See also appendix A
application exceptions 500, 548 beforeCompletion() 512
686 index
the index
begin() 476, 478
Being John Entity Bean 350 C
BETWEEN 416. See EJB-QL
cascade-delete 387, 388
BMP 303
cast 120
BMT 476, 478, 482, 485, 487, 490, 502, 508
narrow before cast 120
getStatus() 489
client 55
restrictions 481
client Code 57, 219
summary of bean-managed demarcation 508
client view 111
bodyguard 94
component interface 136
bullet points 166
exceptions 159
architectural overview 97
local 145
client view 131
code example 119
EJB-QL 420
creating a test client 55
entity client view 287
InitialContext 117
entity relationships 420
local client code 160
exceptions 555
lookup 116
local interfaces 166
Client before and after message-driven beans 441
overview 14
client Jar 51
Remote interfaces 144
client view 111, 131
RMI 76
EJBHome methods 129
session bean lifecycle 221
EJBObject methods 137
business interface 79
entity bean 287
business methods 199, 226
exceptions 159
local 145
local interface code 156
CMP 302
vs. BMP 303
CMR 383, 396. See also cascade-delete
cmr-field 387
you are here4 687
the index
CMR field 383, 386 chapter 4: session beans 244
CMT 476, 482, 485, 487, 499, 502, 509 chapter 5: entity bean client view 288
summary of container-managed transactions 509 chapter 6: entity bean synchronization 362
CMT. 491 chapter 7: entity relationships and EJB-QL 425
code examples chapter 8: message-driven beans 463
AdviceStatefulBean code 218 chapter 9: transactions 516
client 119 commit 471, 473
AdviceStatefulBean client 219 commit() 478
exceptions in client interfaces 538 commit options 356
CMP entity bean complete 318 compare
CustomerBeanCMP 318 equals() vs. isIdentical() 150
Customer BMT entity bean 268 Remote vs. local interfaces 154
Customer CMT entity bean 316 compiling a bean 30
entity bean Remote home interface 275 component-based development 3
exceptions in client interfaces 538 component interface 87, 133, 234, 271, 272
local client code 160 implementing 87
local client interfaces 156 confusingly-named exceptions 554
message-driven beans 446 Consistent 472
MovieBean CMP code 396 constructor 195, 196
MovieHomeRemote interface 398 container 6
Remote home interface 126 container-managed persistence. See CMP
WelcomeBean 446 container-managed relationship. See CMR
Coffee Cram Container-managed transactions. See CMT
appendix A: final mock exam 637 container callbacks 181, 310
chapter 1: overview 59 ejbActivate() 183
chapter 10: exceptions 563 ejbCreate() 181
chapter 11: security 593 ejbPassivate() 183
chapter 12: environment and programming restric- ejbRemove() 183
tions 627
implementing in a session bean 183
chapter 3: client view 168
setSessionContext() 183
688 index
the index
Container responsibilities abstract persistence schema 384
exceptions 546 abstract schema 394
create() 123, 232, 237 intro 23
entity vs. session bean 281 message-driven bean 449
CreateException 125, 548 resource manager connection factories 610
create methods 159, 181 transactions 502, 503, 504
creation method parameters 505
entity beans 329 wildcard 579
entity vs. session bean 281 deploytool 32
session beans 188, 192 deserializing 71
Director 378
Director talking to entity bean 284
D distributed transactions 473
two-phase commit 473
DuplicateKeyException 548
database 301
Dups-ok-acknowledge 460
database to entity mapping 400
Durable 472
DataSource 602, 610
durable subscription 450
dead bean 284
entity vs. instance death 285
E
declarative security 572
declarative transactions. See CMT
DELETE 265
deploy-time customization 602, 618 EJB
Deployer 27 and RMI 81
deployment descriptor responsibilities 618 architectural overview 63
responsibilities for mapping abstract roles to people EJBObject 82
583
ejb-jar 24, 620, 624
deployment descriptor
requirements 24
<ejb-link> 615
ejb-jar.xml 624
you are here4 689
the index
EJB-QL 401, 402, 411 EJBLocalObject 145, 156
AND 405 EJBMetaData 149
BETWEEN 416 EJBObject 82, 94, 133, 137
Collection types 413 ejbPassivate() 183, 200, 204, 207, 308, 314, 355
FROM clause 403 ejbPostCreate() 334, 396
identifiers 410 ejbRemove() 183, 210, 213, 214, 216, 314
IN operator for the FROM clause 415 missed ejbRemove() in session beans 213
IN with the WHERE clause 417 ejbStore() 314, 355
IS EMPTY 418 EJB 2.0 guarantees
IS NOT EMPTY 418 services and behavior 623
LIKE expression 419 supported APIs 621
parameters 405 EJB references 613
path navigation 404 <ejb-local-ref> 614
reserved words 410 EJB Roles and Responsibilities 26
SELECT clause 403, 406 Application Assembler 26
String literals 417 Bean Provider 26
topics and queues 450 Deployer 27
using collections in a path 414 EJB security mapping 590
WHERE 412 EntityBean 312, 314
WHERE clause 403, 411 entity beans 99
ejb-relation 387 activation 352, 354
ejb-relationship-role 387 actor playing an entity 350
ejbActivate() 183, 200, 204, 207, 308, 314, 354 business method 348
EJBContext 477 client view 287
ejbCreate() 181, 195, 196, 237, 331, 333 CMP bean construction 326, 327
EJBException 537, 539, 552, 558 CMP bean creation 328, 338
EJBHome 128 ejbCreate() 331, 333
methods 129 ejbPostCreate() 334
ejbLoad() 314, 354 OID for bean creation 329
EJBLocalHome 145 CMP class example 316
690 index
the index
CMP complete class code 318 exam objectives
container callbacks 310, 312 bean environment 600
ejbActivate() 308 client view 112
ejbPassivate() 308 EJB overview 2
ejbPostCreate() 396 entity bean client view 260
entity realization (how a bean becomes an entity) entity bean lifecycle 296
306
entity relationships: CMP and CMR 374
entity vs. instance death 285
exceptions 526
finder methods 276, 339, 341
message-driven beans 438
home business method 345
security 570
home interface 273, 275
session beans 174
lifecycle 320
transactions 470
mapping from abstract schema to a real database
400 exceptions 555
overview 268 application exceptions 533, 548
passivation 308, 355 client interfaces 159
relationships 378 common system exceptions 551
unidirectional 391 CreateException 548
relationship assignments 421 DuplicateKeyException 548
remove() 282, 283, 284 EJBException 537, 539
session remove vs. entity remove 282 FinderException 538, 548
synchronization 298, 301 logging system exceptions 535
environment ObjectNotFoundException 548
creating a subcontext 609 RemoteException 78, 133, 537
resource mapping 612 RemoveException 548
subcontexts 604 scenarios 556
environment entries 607 system exceptions 534
scope 608 exception pathways 530
types 608 exception scenarios 556
equals() 150 Exercise. See Sharpen your pencil
exotic casting 122. See narrow
you are here4 691
the index
F H
findByPrimaryKey() 274 Handle 139, 149
FinderException 538, 548, 559 handle 149
finder methods 274, 276, 339, 341 home 91
Container writes all the code 342 business methods 278
FROM 411 create() 123
EJBHome 128
home interface 114
G methods 129
home business method 278, 345
home interface 273
getCallerPrincipal() 241, 587
EJBHome 128
getEJBHome() 137, 241
entity bean Remote home interface 273, 279
getEJBLocalHome() 241
methods 129
getEJBLocalObject() 241
rules 125
getEJBMetaData() 129
home object 91
getEJBObject() 241
getHandle() 137
I
getHomeHandle() 129
getPrimaryKey() 137
getRollbackOnly() 241, 488, 500
getStatus() 489 IIOP 90
getUserTransaction() 241, 476, 477, 478 IllegalStateException 551, 552, 558, 560
IN. See EJB-QL
inheritance 186
InitialContext 117
input parameters 412. See EJB-QL
INSERT 265
692 index
the index
instance-level security 586
interface J
business interface 79
J2EE Reference Implementation (RI)
comparing Remote vs. local 154, 163
Client Jar 51
component interface 82, 133, 271
deploytool 32
EJBHome 129
JNDI name 52
EJBObject 137
New Enterprise Bean Wizard 37
extending 85
server 31
home interface 91, 114, 125, 273
verifier 47
javax.ejb.EntityBean 182
java.net.Socket 625
javax.ejb.EntityContext 182
java:comp/env 602, 603
javax.ejb.MessageDrivenBean 182
subcontexts 604
javax.ejb.MessageDrivenContext 182
JavaMail 621
javax.ejb.SessionBean 182
javax.ejb.EJBContext 477
javax.ejb.SessionContext 182
javax.ejb.EntityBean 312. See also EntityBean
local client interfaces 145, 166
javax.ejb.SessionBean 182. See also SessionBean
exceptions 159
javax.ejb.SessionSynchronization 511
Remote 78
javax.jms.QueueConnectionFactory 611
squeamish about not implementing 86
javax.jms.Topic 449
isCallerInRole 587
javax.jms.TopicConnectionFactory 611
isCallerInRole() 587
javax.mail.Session 611
isCallerInRole(String s) 241
javax.transaction.UserTransaction 471, 477
isIdentical 141
JAXP 621
isIdentical() 142
JDBC 621
isIdentical(Object o) 137
JMS 452, 621
Isolated 472
JNDI 92, 602
IS EMPTY. See EJB-QL
bean’s special context 189, 602
IS NOT EMPTY. See EJB-QL
InitialContext 117, 602
lookup 116
you are here4 693
the index
narrow the result 120 JMS 452
JNDI API 1.2 621 lifecycle 445
JNDI name 52 MessageDrivenContext 455, 456
JTA 621 MessageListener 452
JTS 471 message acknowledgement 458, 460
queues 454
rules for writing the class 448
L topics 453
transaction attribute 500
MessageDrivenContext 455, 456
LIKE expression
MessageListener 452
EJB-QL. See EJB-QL
message acknowledgement 458
local client view 145
methods
local interface 148, 156
afterBegin() 512
exceptions 159
afterCompletion() 512
vs. Remote interface 154
beforeCompletion() 512
locking (database) 301
begin() 476
logging 535
create() 128, 274
lookup 116
create methods 159
ejbActivate() 183, 200, 204, 207, 309, 354
ejbCreate() 183, 195, 331, 333
M ejbLoad() 354
ejbPassivate() 183, 200, 204, 207, 309
Mandatory 492 ejbPostCreate() 334
Many-to-Many 380 ejbRemove() 213, 214, 216
message-driven beans 106, 437, 442 findByPrimaryKey() 274
BMT 460 getCallerPrincipal() 587
CMT 460, 500 getEJBHome() 137
concurrent processing 444 getEJBMetaData() 129
getHandle() 137
694 index
the index
getHomeHandle() 129
getPrimaryKey() 137 N
getRollbackOnly() 488
narrow 120
getStatus() 489
PortableRemoteObject.narrow() 121
getUserTransaction() 476
network transparency 65, 66
isIdentical(Object o) 137, 141
Never 492, 495
remove() 137, 282
NoSuchEntityException 551, 552
remove(Handle h) 129
NoSuchObjectException 551, 553
remove(Object key) 129
NoSuchObjectLocalException 551, 552, 553
remove methods 159
NotSupported 492, 495
setRollbackOnly() 485
NOT IN. See EJB-QL
setSessionContext() 183
setSessionContext(SessionContext sc) 195
O
method permissions 578
<unchecked/> 581
union 580
missed ejbRemove() in session beans 213, 215 objectives. See exam objectives
mock exam. See Coffee cram ObjectNotFoundException 548, 553, 559
Movie 378 ome business method 346
MovieBean code 396 One-to-Many 380
MovieHomeRemote interface 398 One-to-One 380
MovieSchema 408
multiplicity 380, 387, 422
P
affects return type 382
Many-to-Many 380
One-to-Many 380
One-to-One 380 passing objects remotely 68
passivation
stateful session bean 200
transactions 206
you are here4 695
the index
pass by copy 69
pass by reference 68 R
path navigation 404
relationships 378, 394
persistent field 313
unidirectional 391
virtual 315
relationship assignments 421
point-to-point 451. See also queue; See also topic
Remote 65
PortableRemoteObject.narrow() 121
arguments 67, 72
primary key 332, 333
Serializable 72
Principal 584
business interface 79
programmatic security 586, 589
component interface 82
programmatic transactions. See BMT
home interface 125
programming restrictions 625
interface 78
propagation
PortableRemoteObject.narrow() 121
transactions 474, 482
RemoteException 78
proxy. See stub
return values 67, 72
publish/subscribe 451
Serializable 72
vs. local interface 154
Q
RemoteException 78, 133, 537, 559
Remote home interface 125, 279
EJBHome 128
queries 406. See EJB-QL Remote interface 78, 144
queues 450, 454 component interface 82, 137, 271
home interface 125
EJBHome 128
vs. local interface 154
Remote Method Invocation 63, 64
Remote object 65, 67
EJBObject 82
remove 129, 151, 159, 282
696 index
the index
entity beans 284 rollback() 478
entity vs. session bean 282, 283 RPC 67
remove() 137, 151, 208, 282, 286 run-as 591
entity vs. session bean 283 RuntimeException 545
remove(Handle h) 129
remove(Object key) 129
RemoveException 548, 559
remove methods 159 S
Required 492
scalable
RequiresNew 492
stateless session beans 103
resource manager connection factory 610
security
resource authorization 611
App Assembler 574, 576
return values 67
authentication 572
Serializable 72
authorization 572
RMI 63
context propagation 592
arguments 67
declarative security 572
how its used by EJB 81
Deployer 583
IIOP 90
identity 591
PortableRemoteObject.narrow() 121
instance-level security 586
RemoteException 78
isCallerInRole() 587
Remote object 65
Principal 584
return values 67
programmatic security 586
RMI-IIOP 90
roles 574
rmic 90
role definition 576
skeleton 65, 67
security identity 592
stub 64
security mapping 590
rmic 90
security roles 574, 576
Role 584
<method-permission> 578
role reference 589
SELECT 265, 402, 406
rollback 473
you are here4 697
the index
Serializable 67, 72 setSessionContext(SessionContext sc) 195
server 31 Sharpen your pencil
Server dude at the pool 441 APIs 621
SessionBean 182, 183 architectural overview 107
SessionContext 189, 199, 240, 241 bean table 108
SessionSynchronization 511, 512 bean types 13
callbacks 512 client view exercise 165
session beans 182 CMP entity creation 359
bean lifecycle 180, 184 compiler checked? 447
container callbacks 182 EJB-QL 407
implementing 183 EJB architecture 10, 80
missed ejbRemove() calls 215 EJB Lifecycle 96
overview 98, 100 EntityBean interface 323
passivation 200, 207 entity bean 280
removal 208, 210 entity bean callbacks 353
scalability 103 entity bean class methods 361
SessionBean interface 182 entity bean relationships (Director-to-Movie) 390
stateful session beans 178, 184 entity business method 360
creation 179, 192, 196 entity CMP code annotation 319
OID for bean creation 194 entity lifecycle activity 324
passivation/activation 207 environment 626
removal 210 exceptions 561
stateless session bean 102, 222 exception exercise 562
creation exception scenarios 557
OID for bean creation 227 home interface 132
session context 240 local and Remote client interfaces 155
setEntityContext(EntityContext ec) 314 local clients 158
setRollbackOnly() 485, 487 local client view 147
setRollbackOnly(boolean b) 241 message-driven bean 461
setSessionContext(SessionContext ctx) 183 message-driven bean context methods 455
698 index
the index
Multiplicity and Assignments 423 supported APIs 621
package name 119 Supports 492, 495
security roles 575 suspended transactions 483
SessionBean interface 186 synchronization 298
session bean overview 104 system exceptions 500, 551
stateful session bean state diagram 187 logging 535
stateless to stateful 220
transactions 480
transactions puzzle 514
transaction attributes 496, 497, 507 T
UserTransaction 484
The Advice Guy 15
write an entity bean 317
Tikibean Lounge
skeleton 65, 67
BMT/CMT 501
squeamish 86
EJBObject/bean 89
stateful session bean 178
session bean/bartender 14
creation 179, 194, 196
topics 450, 453
Object Interaction Diagram (OID) for bean creation
194 durable subscription 450
removal 210 topics and queues 450
SessionSynchronization 512 TransactionRequiredException 551, 552
stateless session TransactionRequiredLocalException 551, 552
transactions in 481 TransactionRolledbackException 551, 552
stateless session bean 102, 222 TransactionRolledbackLocalException 551, 552
business methods 226 transactions 471, 473. See also commit; See also roll-
back; See also setRollbackOnly()
creation 224
Bean-managed transactions 476
Object Interaction Diagram (OID) for bean creation
227 begin() 476
String literals. See EJB-QL BMT 476, 481
stub 64, 67 call stack example 479
subcontexts 604 database locking 301
you are here4 699
the index
deployment descriptor 503 UserTransaction 476, 477
getRollbackOnly() 488, 500 getStatus() 489
message-driven beans 460, 500
propagation 474, 482
SessionSynchronization 512
stateful session bean passivation 206 V
suspension 475, 483
vendor lock-in 5
transaction attributes 492
verifier 47
two-phase commit 473
virtual persistent fields 315
unspecified transaction context 499
transaction attributes 492, 493, 498
attributes that require a transaction 494
Mandatory 492
Never 492, 495
W
NotSupported 492, 495 WHERE 403, 411, 412
Required 492 wildcard
RequiresNew 492 method elements 504
Supports 492, 495 transaction attributes 504
Tutorial 28
two-phase commit 473
U
unidirectional 391
unsetEntityContext() 314
unspecified transaction context 499
UPDATE 265
Users 584
700 index
Interface summary
javax.ejb.EJBContext
getCallerPrincipal()
getEJBHome()
getEJBLocalHome()
getRollbackOnly()
getUserTransaction()
isCallerInRole(String role)
setRollbackOnly()
javax.ejb.EntityContext javax.ejb.SessionContext javax.ejb.MessageDrivenContext
getEJBLocalObject() getEJBLocalObject() // adds no methods
getEJBObject() getEJBObject()
getPrimaryKey()
java.rmi.Remote
// no methods declared
javax.ejb.EJBHome javax.ejb.EJBObject javax.ejb.EJBLocalHome javax.ejb.EJBLocalObject
getEJBMetaData() getEJBHome() remove(Object PK) getEJBLocalHome()
getHomeHandle() getHandle() getPrimaryKey()
remove(Handle h) getPrimaryKey() isIdentical(EJBLocalObject
remove(Object PK) isIdentical(EJBObject o) o)
remove()
Interface summary
java.io.Serializable
// no methods declared
javax.ejb.EnterpriseBean javax.ejb.Handle javax.ejb.HomeHandle
// no methods declared getEJBObject() getEJBHome()
javax.ejb.EntityBean javax.ejb.MessageDrivenBean
ejbActivate() ejbRemove()
ejbLoad() javax.ejb.SessionBean setMessageDrivenContext
ejbPassivate() (MessageDrivenContext ctx)
ejbRemove() ejbActivate()
ejbStore() ejbPassivate()
setEntityContext ejbRemove()
(EntityContext ctx) setSessionContext
unsetEntityContext() (SessionContext ctx)
Interface summary
javax.ejb.SessionSynchronization
javax.transaction.UserTransaction afterBegin()
afterCompletion( boolean committed)
begin()
beforeCompletion()
commit()
getStatus()
rollback()
setRollbackOnly()
setTransactionTimeout(int seconds)
javax.jms.MessageListener
onMessage(Message message)
am...
tTra ns ac ti on Tim eo ut() is not on thfoereexthe
se e elapsed time be
it lets you tunedeth d th e tr ansaction has timed
Contai ne r de ci
rolls it back.
out, and automatically
Das könnte Ihnen auch gefallen
- VDU BasicsDokument29 SeitenVDU Basicsabdulrauf95767% (3)
- Introduction To Advanced UNIX 2010Dokument22 SeitenIntroduction To Advanced UNIX 2010Alok TiwariNoch keine Bewertungen
- SignalR Blueprints - Sample ChapterDokument25 SeitenSignalR Blueprints - Sample ChapterPackt PublishingNoch keine Bewertungen
- EJB Concepts: N This ChapterDokument39 SeitenEJB Concepts: N This Chapterapi-3827215100% (1)
- Search Tech Interviews QuestionsDokument9 SeitenSearch Tech Interviews Questionsvvskum2k04Noch keine Bewertungen
- EJB's 101 DamnationsDokument14 SeitenEJB's 101 DamnationsAntonio PazoNoch keine Bewertungen
- EJBOverview SpeakernotedDokument133 SeitenEJBOverview Speakernotedapi-26793394Noch keine Bewertungen
- Spring MVC Introduction To EJB 3.0: Yet Another Web Framework Easy Enterprise DevelopmentDokument22 SeitenSpring MVC Introduction To EJB 3.0: Yet Another Web Framework Easy Enterprise DevelopmentAlmog GoldbergNoch keine Bewertungen
- Ejb Annotations PrimerDokument81 SeitenEjb Annotations PrimerCleverton HeusnerNoch keine Bewertungen
- EJB Faqs ShyamDokument13 SeitenEJB Faqs Shyamapi-3760419Noch keine Bewertungen
- XB3 EjbDokument120 SeitenXB3 EjbmarkjenniferNoch keine Bewertungen
- Objectives: Session BeansDokument37 SeitenObjectives: Session BeanssameerroushanNoch keine Bewertungen
- EJB Questions and AnswersDokument9 SeitenEJB Questions and Answersksabha99Noch keine Bewertungen
- EJB Interview QuestionsDokument66 SeitenEJB Interview Questionsapi-26345612Noch keine Bewertungen
- Head First Java 2nd EditionDokument690 SeitenHead First Java 2nd Editionweipanda100% (2)
- Distributed Computing With The Bea Weblogic Server: Dean Jacobs Architect Bea SystemsDokument31 SeitenDistributed Computing With The Bea Weblogic Server: Dean Jacobs Architect Bea SystemsFadhel BouzaieneNoch keine Bewertungen
- Block-2 MS-051 Unit-3Dokument18 SeitenBlock-2 MS-051 Unit-3Abhi kumarNoch keine Bewertungen
- Best Practices To Improve Performance in EJBDokument38 SeitenBest Practices To Improve Performance in EJBPriyanka Mathur0% (1)
- 01 Models EJBDokument28 Seiten01 Models EJBraisjeuNoch keine Bewertungen
- Introduction To Application Server: EJB 3.0 BasicsDokument4 SeitenIntroduction To Application Server: EJB 3.0 BasicssatyanarayanaNoch keine Bewertungen
- Chapter 03Dokument13 SeitenChapter 03Galacticsolutions PltNoch keine Bewertungen
- How To Fix Memory Leaks in Java - JavalobbyDokument16 SeitenHow To Fix Memory Leaks in Java - JavalobbyPriyank PaliwalNoch keine Bewertungen
- EJB Essentials: Key Concepts, Benefits and Design ConsiderationsDokument48 SeitenEJB Essentials: Key Concepts, Benefits and Design ConsiderationsNwwarNoch keine Bewertungen
- Unit 2Dokument14 SeitenUnit 2Sumita Barun kumarNoch keine Bewertungen
- Enterprise Javabeans: Ejb Container / Application ServerDokument9 SeitenEnterprise Javabeans: Ejb Container / Application Serversap1313Noch keine Bewertungen
- EJB Roseindia NotesDokument126 SeitenEJB Roseindia NotesSonxScrbd77Noch keine Bewertungen
- Spring MVC Session Beans: Yet Another Web Framework Handling Business LogicDokument43 SeitenSpring MVC Session Beans: Yet Another Web Framework Handling Business LogicAlmog GoldbergNoch keine Bewertungen
- 04 - Implementing Business LogicDokument18 Seiten04 - Implementing Business Logicsuresh1130Noch keine Bewertungen
- Introduction EJB3Dokument52 SeitenIntroduction EJB3api-27341052Noch keine Bewertungen
- Ejb 3Dokument6 SeitenEjb 3api-26793394100% (2)
- Contents:: Overview Enterprise Java Beans Using Ejbs As Web Dynpro ModelDokument28 SeitenContents:: Overview Enterprise Java Beans Using Ejbs As Web Dynpro ModelGijs PetersNoch keine Bewertungen
- EJB - An IntroductionDokument25 SeitenEJB - An IntroductionMridul Kumar SrivastavaNoch keine Bewertungen
- 02 01 Why SpringDokument10 Seiten02 01 Why SpringRohit SolankiNoch keine Bewertungen
- Unit8 LeftDokument1 SeiteUnit8 LeftCharles RushNoch keine Bewertungen
- 14 EJBS SlidesDokument27 Seiten14 EJBS Slidesshamsher3052Noch keine Bewertungen
- Standard Way Implement Back-End Business Code EJBDokument5 SeitenStandard Way Implement Back-End Business Code EJBsridharegspNoch keine Bewertungen
- Presentation On IT Skill SetDokument33 SeitenPresentation On IT Skill SetVishal KrishnaNoch keine Bewertungen
- E JB IntroductionDokument14 SeitenE JB IntroductiontesterNoch keine Bewertungen
- EJB Introduction: Standard Distributed Component ArchitectureDokument7 SeitenEJB Introduction: Standard Distributed Component Architecturesangram245Noch keine Bewertungen
- Enterprise Java Beans: An OverviewDokument20 SeitenEnterprise Java Beans: An OverviewVibhu TiwariNoch keine Bewertungen
- Enterprise Java Unit 4Dokument15 SeitenEnterprise Java Unit 4aryansingh152003Noch keine Bewertungen
- Ejbs Are Not PortableDokument7 SeitenEjbs Are Not Portablerhinowar99Noch keine Bewertungen
- EJB Interview Questions: Types, Life Cycle, Transaction AttributesDokument84 SeitenEJB Interview Questions: Types, Life Cycle, Transaction Attributesabu1882Noch keine Bewertungen
- Paper: Developing Enterprise Javabeans ApplicationsDokument60 SeitenPaper: Developing Enterprise Javabeans ApplicationsMuthu Vijay DeepakNoch keine Bewertungen
- Java - ms32m - mx128m For Resizing The JVM Heap SpaceDokument99 SeitenJava - ms32m - mx128m For Resizing The JVM Heap SpaceTapas NayakNoch keine Bewertungen
- EJB Interview QuestionsDokument39 SeitenEJB Interview QuestionsiniyarajNoch keine Bewertungen
- Enterprise Java BeanDokument13 SeitenEnterprise Java BeanJai BalajiNoch keine Bewertungen
- J2 EEFeb 11Dokument24 SeitenJ2 EEFeb 11DominicNoch keine Bewertungen
- Block-2 MS-051 Unit-4Dokument20 SeitenBlock-2 MS-051 Unit-4Abhi kumarNoch keine Bewertungen
- EJB Architecture and DesignDokument62 SeitenEJB Architecture and DesignSENTHIL RNoch keine Bewertungen
- Unit - 2 JavaDokument16 SeitenUnit - 2 Javaswarajpatil180Noch keine Bewertungen
- 05 Laboratory Exercise 1Dokument2 Seiten05 Laboratory Exercise 1nuzu apitNoch keine Bewertungen
- Kotlin As A Backend: An UsecaseDokument13 SeitenKotlin As A Backend: An UsecaseYgor CastorNoch keine Bewertungen
- Ise Vii Java and J2EE (10is753) NotesDokument73 SeitenIse Vii Java and J2EE (10is753) NotesAbid HussainNoch keine Bewertungen
- Enterprise JavaBeans FAQ From JguruDokument366 SeitenEnterprise JavaBeans FAQ From Jguruapi-3706318Noch keine Bewertungen
- How EJB Invocation HappensDokument4 SeitenHow EJB Invocation Happensapi-3831588Noch keine Bewertungen
- Getting Started With Enterprise Javabeans Technology: Section 1. About This TutorialDokument104 SeitenGetting Started With Enterprise Javabeans Technology: Section 1. About This TutorialAye KayNoch keine Bewertungen
- The Java Persistence API - A Simpler Programming Model For Entity PersistenceDokument9 SeitenThe Java Persistence API - A Simpler Programming Model For Entity PersistenceJuan Ángel García PenaNoch keine Bewertungen
- 4.3 - Local Storage Exercise How-ToDokument32 Seiten4.3 - Local Storage Exercise How-ToMd Noorullah RazaNoch keine Bewertungen
- EJB 3.0 Database Persistence with Oracle Fusion Middleware 11g: LITEVon EverandEJB 3.0 Database Persistence with Oracle Fusion Middleware 11g: LITENoch keine Bewertungen
- Sans PDFDokument4 SeitenSans PDFSandro MeloNoch keine Bewertungen
- School Management System PPT - Soumya - RefrenceDokument19 SeitenSchool Management System PPT - Soumya - RefrencetempNoch keine Bewertungen
- 9 Content: Software Design and Development Stage 6 HSC CourseDokument28 Seiten9 Content: Software Design and Development Stage 6 HSC CourseDodoy Leandro Frincillo CrebelloNoch keine Bewertungen
- DFC20123 - Topic 2 - 1Dokument15 SeitenDFC20123 - Topic 2 - 1Zoro RoNoch keine Bewertungen
- Forklift Battery Connectors - REMA & APP - TVH PartsDokument5 SeitenForklift Battery Connectors - REMA & APP - TVH Partsikperha jomafuvweNoch keine Bewertungen
- J8pF3RMRxmfKRd0TFcZFw Learning Log Template Define Problems and Ask Questions With DataDokument1 SeiteJ8pF3RMRxmfKRd0TFcZFw Learning Log Template Define Problems and Ask Questions With Datatemp 2Noch keine Bewertungen
- Project Assignment Computer Science - Final - 2013 - VijayDokument17 SeitenProject Assignment Computer Science - Final - 2013 - VijayMehul SrivastavaNoch keine Bewertungen
- Impacts of E-Service Quality On Customer Satisfaction A Case Study of LazadaDokument10 SeitenImpacts of E-Service Quality On Customer Satisfaction A Case Study of LazadaMai MaiNoch keine Bewertungen
- Appraisal of Costs & Benefits of Smart Meter Roll Out Options (PDFDrive)Dokument244 SeitenAppraisal of Costs & Benefits of Smart Meter Roll Out Options (PDFDrive)hhhhNoch keine Bewertungen
- Chapter2 ERDokument44 SeitenChapter2 ERMichael WilsonNoch keine Bewertungen
- Social NetworkingDokument20 SeitenSocial NetworkingSatyabrata DasNoch keine Bewertungen
- English - Assignment AnsweredDokument4 SeitenEnglish - Assignment AnsweredMostafa MansourNoch keine Bewertungen
- VM Series Life Safety Control SystemDokument10 SeitenVM Series Life Safety Control SystemJovanny HenriquezNoch keine Bewertungen
- C 7 WiproDokument20 SeitenC 7 WiproSaksham AnandNoch keine Bewertungen
- Ultrasonic Navigation For Blind With Audio Interface DocumentationDokument55 SeitenUltrasonic Navigation For Blind With Audio Interface DocumentationGoutham Raj Mode60% (5)
- APN 087 - Process Bus IEC 61850 Simulation and TestDokument30 SeitenAPN 087 - Process Bus IEC 61850 Simulation and TestWalter Andres Estevez VasquezNoch keine Bewertungen
- CD-compiler Designe AkashDokument70 SeitenCD-compiler Designe AkashElon muskNoch keine Bewertungen
- How To Fill ILC With TIME@IBMv2Dokument11 SeitenHow To Fill ILC With TIME@IBMv2Arun NatarajanNoch keine Bewertungen
- Cardiovisions Guide For Programming and Evaluating Measurements Made byDokument49 SeitenCardiovisions Guide For Programming and Evaluating Measurements Made byNikita KaplenkoNoch keine Bewertungen
- GMOD Data-SheetDokument2 SeitenGMOD Data-SheetAli AhmedNoch keine Bewertungen
- BOTDokument21 SeitenBOTАртур МикитюкNoch keine Bewertungen
- Information Systems Today Learning Objectives: Chapter # 7Dokument6 SeitenInformation Systems Today Learning Objectives: Chapter # 7Leena MuniandyNoch keine Bewertungen
- Zte Ax326 Wimax Usb Modem Spec v1.0Dokument11 SeitenZte Ax326 Wimax Usb Modem Spec v1.0Ramiz RzaogluNoch keine Bewertungen
- Arm Cortex-M3 Processor DatasheetDokument10 SeitenArm Cortex-M3 Processor DatasheetthuhienktvNoch keine Bewertungen
- Java Collections FrameworkDokument18 SeitenJava Collections FrameworkPiyushNoch keine Bewertungen
- Icd BP250 PDFDokument68 SeitenIcd BP250 PDFbtbsNoch keine Bewertungen
- Module 1.1b Using Functions To Model Real-Life SituationsDokument14 SeitenModule 1.1b Using Functions To Model Real-Life SituationsMarvin C. NarvaezNoch keine Bewertungen
- Project Title: Chat-On: Submitted By: Submitted ToDokument10 SeitenProject Title: Chat-On: Submitted By: Submitted ToDivyam GoelNoch keine Bewertungen
- 400 To 500Dokument5 Seiten400 To 500Anonymous h2rz52Noch keine Bewertungen
- Epson R300 R310 Service Manual CompleteDokument108 SeitenEpson R300 R310 Service Manual Completeotaner42100% (1)
