Headfirst Java 2 ND Edition PDF

Table of Contents
Dedication.............................................................................................................................. 2
What they're saying about Head First..................................................................................... 3
Praise for Head First Java............................................................................................................................................................................................................... 3
Praise for other Head First books co-authored by Kathy and Bert................................................................................................................................................ 3
Other related books from O'Reilly.................................................................................................................................................................................................. 3
Intro....................................................................................................................................... 7
Who is this book for?....................................................................................................................................................................................................................... 7
We know what you're thinking........................................................................................................................................................................................................ 7
And we know what your brain is thinking...................................................................................................................................................................................... 7
Metacognition: thinking about thinking......................................................................................................................................................................................... 7
Here's what WE did:........................................................................................................................................................................................................................ 7
Here's what YOU can do to bend your brain into submission........................................................................................................................................................ 7
What you need for this book:.......................................................................................................................................................................................................... 7
Last-minute things you need to know:............................................................................................................................................................................................ 7
Technical Editors............................................................................................................................................................................................................................. 7
Other people to credit:..................................................................................................................................................................................................................... 7
Just when you thought there wouldn't be any more acknowledgements....................................................................................................................................... 7
Chapter 1. Breaking the Surface............................................................................................ 19
Section 1.1. The Way Java Works.................................................................................................................................................................................................. 20
Section 1.2. What you'll do in Java................................................................................................................................................................................................ 21
Section 1.3. A very brief history of Java........................................................................................................................................................................................ 22
Section 1.4. Sharpen your pencil................................................................................................................................................................................................... 23
Section 1.5. Sharpen your pencil answers..................................................................................................................................................................................... 24
Section 1.6. Code structure in Java............................................................................................................................................................................................... 25
Section 1.7. Anatomy of a class...................................................................................................................................................................................................... 26
Section 1.8. Writing a class with a main........................................................................................................................................................................................ 27
Section 1.9. What can you say in the main method?.................................................................................................................................................................... 28
Section 1.10. Looping and looping and......................................................................................................................................................................................... 29
Section 1.11. there are no Dumb Questions.................................................................................................................................................................................. 30
Section 1.12. Conditional branching.............................................................................................................................................................................................. 31
Section 1.13. Coding a Serious Business Application.................................................................................................................................................................... 32
Section 1.14. Monday morning at Bob's........................................................................................................................................................................................ 33
Section 1.15. Phrase-O-Matic........................................................................................................................................................................................................ 35
Section 1.16. Fireside Chats........................................................................................................................................................................................................... 36
Section 1.17. Exercise: Code Magnets........................................................................................................................................................................................... 38
Section 1.18. Exercise: BE The compiler....................................................................................................................................................................................... 39
Section 1.19. JavaCross 7.0........................................................................................................................................................................................................... 40
Section 1.20. Mixed Messages....................................................................................................................................................................................................... 41
Section 1.21. Pool Puzzle................................................................................................................................................................................................................ 42
Section 1.22. Exercise Solutins: Code Magnets:........................................................................................................................................................................... 43
Chapter 2. A Trip to Objectville............................................................................................. 45
Section 2.1. Chair Wars................................................................................................................................................................................................................. 46
Section 2.2. Brain Power................................................................................................................................................................................................................ 51
Section 2.3. Making your first object............................................................................................................................................................................................ 54
Section 2.4. Making and testing Movie objects............................................................................................................................................................................. 55
Section 2.5. Quick! Get out of main!............................................................................................................................................................................................. 56
Section 2.6. Running the Guessing Game..................................................................................................................................................................................... 58
Section 2.7. Who am I?.................................................................................................................................................................................................................. 63
Chapter 3. Know Your Variables........................................................................................... 67
Section 3.1. Declaring a variable................................................................................................................................................................................................... 68
Section 3.2. "I'd like a double mocha, no, make it an int."........................................................................................................................................................... 69
Section 3.3. You really don't want to spill that............................................................................................................................................................................. 70
Section 3.4. Back away from that keyword!.................................................................................................................................................................................. 71
Section 3.5. This table reserved..................................................................................................................................................................................................... 71
Section 3.6. Controlling your Dog object...................................................................................................................................................................................... 72
Section 3.7. An object reference is just another variable value.................................................................................................................................................... 73
Section 3.8. There are no Dumb Question.................................................................................................................................................................................... 74
Section 3.9. Java Exposed............................................................................................................................................................................................................. 74
Section 3.10. Life on the garbage-collectible heap........................................................................................................................................................................ 75
Section 3.11. Life and death on the heap....................................................................................................................................................................................... 76
Section 3.12. An array is like a tray of cups................................................................................................................................................................................... 77
Section 3.13. Arrays are objects too............................................................................................................................................................................................... 77
Section 3.14. Make an array of Dogs............................................................................................................................................................................................. 78
Section 3.15. Control your Dog...................................................................................................................................................................................................... 79
Section 3.16. A Dog example......................................................................................................................................................................................................... 80
Section 3.17. Exercise: BE the compiler........................................................................................................................................................................................ 81
Section 3.19. Pool Puzzle............................................................................................................................................................................................................... 83
Section 3.20. A Heap o' Trouble................................................................................................................................................................................................... 84
Head First Java, 2nd Edition. Head First Java, 2nd Edition, ISBN: 0596009208
Prepared for e.simons@icarin.fiuc.org, Eduard Simons
Copyright © 2005 Bert Bates and Kathy Sierra. This PDF is made available for personal use only during the relevant subscription term, subject to the Safari Terms of Service. Any other use
requires prior written consent from the copyright owner. Unauthorized use, reproduction and/or distribution are strictly prohibited and violate applicable laws. All rights reserved.
Section 3.21. Five-Minute Mystery............................................................................................................................................................................................... 85
Section 3.22. Exercise Solutions: Code Magnets.......................................................................................................................................................................... 86
Section 3.23. Puzzle Solutions....................................................................................................................................................................................................... 87
Chapter 4. How Objects Behave............................................................................................ 89
Section 4.1. Remember: a class describes what an object knows and what an object does........................................................................................................ 90
Section 4.2. The size affects the bark............................................................................................................................................................................................. 91
Section 4.3. You can send things to a method.............................................................................................................................................................................. 92
Section 4.4. You can get things back from a method.................................................................................................................................................................... 93
Section 4.5. You can send more than one thing to a method....................................................................................................................................................... 94
Section 4.6. there are no Dumb Questions................................................................................................................................................................................... 96
Section 4.7. Reminder: Java cares about type!............................................................................................................................................................................. 96
Section 4.8. Cool things you can do with parameters and return types....................................................................................................................................... 97
Section 4.9. Encapsulation............................................................................................................................................................................................................ 98
Section 4.10. Encapsulating the GoodDog class......................................................................................................................................................................... 100
Section 4.11. How do objects in an array behave?....................................................................................................................................................................... 101
Section 4.12. Declaring and initializing instance variables........................................................................................................................................................ 102
Section 4.13. The difference between instance and local variables............................................................................................................................................ 103
Section 4.14. there are no Dumb Questions................................................................................................................................................................................ 103
Section 4.15. Comparing variables (primitives or references).................................................................................................................................................... 104
Section 4.16. Exercise: BE the compiler...................................................................................................................................................................................... 106
Section 4.17. Who am I?............................................................................................................................................................................................................... 107
Section 4.18. Mixed Messages..................................................................................................................................................................................................... 108
Section 4.19. Pool Puzzle............................................................................................................................................................................................................. 109
Section 4.20. Five Minute Mystery.............................................................................................................................................................................................. 110
Section 4.21. Puzzle Solutions...................................................................................................................................................................................................... 112
Chapter 5. Extra-Strength Methods..................................................................................... 113
Section 5.1. Let's build a Battleship-style game: "Sink a Dot Com"............................................................................................................................................ 114
Section 5.2. First, a high-level design.......................................................................................................................................................................................... 115
Section 5.3. The "Simple Dot Com Game" a gentler introduction.............................................................................................................................................. 116
Section 5.4. Developing a Class.................................................................................................................................................................................................... 117
Section 5.5. BRAIN POWER........................................................................................................................................................................................................ 117
Section 5.6. There are no Dumb Questions................................................................................................................................................................................. 121
Section 5.7. There are no Dumb Questions................................................................................................................................................................................. 124
Section 5.8. Exercise: BE the JVM.............................................................................................................................................................................................. 136
Section 5.10. Java Cross............................................................................................................................................................................................................... 138
Section 5.11. Exercise Solutions................................................................................................................................................................................................... 140
Chapter 6. Using the Java Library....................................................................................... 143
Section 6.1. In our last chapter, we left you with the cliff-hanger. A bug................................................................................................................................... 144
Section 6.2. So what happened?.................................................................................................................................................................................................. 145
Section 6.3. How do we fix it?...................................................................................................................................................................................................... 146
Section 6.4. Option one is too clunky.......................................................................................................................................................................................... 147
Section 6.5. Option two is a little better, but still pretty clunky................................................................................................................................................. 147
Section 6.6. Wake up and smell the library................................................................................................................................................................................. 150
Section 6.7. Some things you can do with ArrayList................................................................................................................................................................... 151
Section 6.9. Java Exposed............................................................................................................................................................................................................ 153
Section 6.10. Comparing ArrayList to a regular array................................................................................................................................................................ 154
Section 6.11. Comparing ArrayList to a regular array................................................................................................................................................................. 155
Section 6.12. Let's fix the DotCom code...................................................................................................................................................................................... 156
Section 6.13. New and improved DotCom class.......................................................................................................................................................................... 157
Section 6.14. Let's build the REAL game: "Sink a Dot Com"...................................................................................................................................................... 158
Section 6.15. What needs to change?........................................................................................................................................................................................... 159
Section 6.16. Who does what in the DotComBust game (and when)......................................................................................................................................... 160
Section 6.17. Prep code for the real DotComBust class............................................................................................................................................................... 162
Section 6.18. The final version of the Dotcom class.................................................................................................................................................................... 168
Section 6.19. Super Powerful Boolean Expressions.................................................................................................................................................................... 169
Section 6.20. Ready-bake Code................................................................................................................................................................................................... 170
Section 6.21. Ready-bake Code.................................................................................................................................................................................................... 171
Section 6.22. Using the Library (the Java API)........................................................................................................................................................................... 172
Section 6.23. You have to know the full name of the class you want to use in your code.......................................................................................................... 173
Section 6.26. How to play with the API....................................................................................................................................................................................... 176
Section 6.27. Code Magnets......................................................................................................................................................................................................... 179
Section 6.28. JavaCross 7.0......................................................................................................................................................................................................... 180
Section 6.29. Exercise Solutions.................................................................................................................................................................................................. 181
Section 6.30. JavaCross answers................................................................................................................................................................................................. 182
Chapter 7. Better Living in Objectville................................................................................. 183
Section 7.1. Chair Wars Revisited................................................................................................................................................................................................ 184
Section 7.2. BRAIN POWER........................................................................................................................................................................................................ 185
Section 7.5. brain power.............................................................................................................................................................................................................. 206
Section 7.6. there are no Dumb Questions................................................................................................................................................................................. 207
Section 7.7. Exercise: Mixed Messages....................................................................................................................................................................................... 210
Section 7.8. Exercise BE the Compiler......................................................................................................................................................................................... 211
Section 7.9. Exercise Solutions: BE the Compiler....................................................................................................................................................................... 213
Chapter 8. Serious Polymorphism....................................................................................... 215
Section 8.1. Did we forget about something when we designed this?........................................................................................................................................ 216
Section 8.2. BRAIN POWER....................................................................................................................................................................................................... 220
Section 8.4. Pool Puzzle.............................................................................................................................................................................................................. 250
Section 8.5. Exercise Solutions.................................................................................................................................................................................................... 251
Chapter 9. Life and Death of an Object................................................................................ 253
Section 9.1. The Stack and the Heap: where things live............................................................................................................................................................. 254
Section 9.2. Methods are stacked................................................................................................................................................................................................ 255
Section 9.3. What about local variables that are objects?.......................................................................................................................................................... 256
Section 9.5. If local variables live on the stack, where do instance variables live?.................................................................................................................... 257
Section 9.6. The miracle of object creation................................................................................................................................................................................. 258
Section 9.7. Construct a Duck..................................................................................................................................................................................................... 260
Section 9.8. Initializing the state of a new Duck......................................................................................................................................................................... 261
Section 9.10. Using the constructor to initialize important Duck state..................................................................................................................................... 262
Section 9.11. Make it easy to make a Duck.................................................................................................................................................................................. 263
Section 9.12. Doesn't the compiler always make a no-arg constructor for you? No!................................................................................................................. 264
Section 9.15. Wait a minute... we never DID talk about superclasses and inheritance and how that all fits in with constructors.......................................... 268
Section 9.16. Making a Hippo means making the Animal and Object parts too....................................................................................................................... 270
Section 9.17. How do you invoke a superclass constructor?....................................................................................................................................................... 271
Section 9.18. Can the child exist before the parents?................................................................................................................................................................. 272
Section 9.19. Superclass constructors with arguments............................................................................................................................................................... 273
Section 9.20. Invoking one overloaded constructor from another............................................................................................................................................ 274
Section 9.21. Now we know how an object is born, but how long does an object live?............................................................................................................. 276
Section 9.22. What about reference variables?........................................................................................................................................................................... 278
Chapter 10. Numbers Matter............................................................................................... 291
Section 10.1. MATH methods: as close as you'll ever get to a global method............................................................................................................................ 292
Section 10.2. The difference between regular (non-static) and static methods......................................................................................................................... 293
Section 10.3. What it means to have a class with static methods............................................................................................................................................... 294
Section 10.4. Static methods can't use non-static (instance) variables!.................................................................................................................................... 295
Section 10.5. Static methods can't use non-static methods, either!........................................................................................................................................... 296
Section 10.6. Static variable: value is the same for ALL instances of the class.......................................................................................................................... 297
Section 10.7. Initializing a static variable................................................................................................................................................................................... 299
Section 10.8. static final variables are constants........................................................................................................................................................................ 300
Section 10.9. final isn't just for static variables........................................................................................................................................................................... 301
Section 10.10. there are no Dumb Questions............................................................................................................................................................................. 302
Section 10.11. Math methods...................................................................................................................................................................................................... 304
Section 10.12. Wrapping a primitive........................................................................................................................................................................................... 305
Section 10.13. Before Java 5.0, YOU had to do the work........................................................................................................................................................... 306
Section 10.14. Autoboxing: blurring the line bet ween primitive and object............................................................................................................................. 307
Section 10.15. Autoboxing works almost everywhere................................................................................................................................................................ 308
Section 10.16. But wait! There's more! Wrappers have static utility methods too!................................................................................................................... 310
Section 10.17. And now in reverse... turning a primitive number into a String.......................................................................................................................... 311
Section 10.18. Number formatting.............................................................................................................................................................................................. 312
Section 10.19. Formatting deconstructed.................................................................................................................................................................................... 313
Section 10.20. The percent (%) says, "insert argument here" (and format it using these instructions)................................................................................... 314
Section 10.21. The format String uses its own little language syntax......................................................................................................................................... 315
Section 10.22. The format specifier............................................................................................................................................................................................. 316
Section 10.23. The only required specifier is for TYPE............................................................................................................................................................... 317
Section 10.24. What happens if I have more than one argument?............................................................................................................................................. 318
Section 10.25. So much for numbers, what about dates?........................................................................................................................................................... 319
Section 10.26. Working with Dates............................................................................................................................................................................................. 320
Section 10.27. Moving backward and for ward in time............................................................................................................................................................... 321
Section 10.28. Getting an object that extends Calendar............................................................................................................................................................. 322
Section 10.29. Working with Calendar objects........................................................................................................................................................................... 323
Section 10.30. Highlights of the Calendar API........................................................................................................................................................................... 324
Section 10.31. Even more Statics!... static imports..................................................................................................................................................................... 325
Section 10.32. Lunar Code Magnets........................................................................................................................................................................................... 330
Chapter 11. Risky Behavior.................................................................................................. 333
Section 11.1. Let's make a Music Machine................................................................................................................................................................................... 334
Section 11.2. We'll start with the basics....................................................................................................................................................................................... 335
Section 11.3. First we need a Sequencer...................................................................................................................................................................................... 336
Section 11.4. Something's wrong!................................................................................................................................................................................................ 336
Section 11.5. What happens when a method you want to call (probably in a class you didn't write) is risky?......................................................................... 337
Section 11.6. Methods in Java use exceptions to tell the calling code, "Some thing Bad Happened. I failed."......................................................................... 338
Section 11.7. The compiler needs to know that YOU know you're calling a risky method........................................................................................................ 339
Section 11.8. An exception is an object… of type Exception....................................................................................................................................................... 340
Section 11.9. If it's your code that catches the exception, then whose code throws it?.............................................................................................................. 341
Section 11.10. there are no Dumb Questions.............................................................................................................................................................................. 342
Section 11.11. Flow control in try/catch blocks........................................................................................................................................................................... 344
Section 11.12. Finally: for the things you want to do no matter what........................................................................................................................................ 345
Section 11.13. Sharpen your pencil:Flow Control....................................................................................................................................................................... 346
Section 11.14. Did we mention that a method can throw more than one exception?................................................................................................................ 347
Section 11.15. Exceptions are polymorphic................................................................................................................................................................................. 348
Section 11.16. Multiple catch blocks must be ordered from smallest to biggest........................................................................................................................ 350
Section 11.17. You can't put bigger baskets above smaller baskets............................................................................................................................................. 351
Section 11.18. Sharpen your pencil.............................................................................................................................................................................................. 352
Section 11.19. When you don't want to handle an exception…................................................................................................................................................... 353
Section 11.20. Ducking (by declaring) only delays the inevitable.............................................................................................................................................. 354
Section 11.21. Getting back to our music code…......................................................................................................................................................................... 356
Section 11.22. Code Kitchen......................................................................................................................................................................................................... 357
Section 11.23. Making actual sound............................................................................................................................................................................................ 358
Section 11.24. Your very first sound player app.......................................................................................................................................................................... 360
Section 11.25. Making a MidiEvent (song data).......................................................................................................................................................................... 361
Section 11.26. MIDI message: the heart of a MidiEvent............................................................................................................................................................. 362
Section 11.27. Anatomy of a message.......................................................................................................................................................................................... 362
Section 11.28. Version 2: Using command-line args to experiment with sounds...................................................................................................................... 364
Section 11.29. Exercise: True or False......................................................................................................................................................................................... 366
Section 11.30. Exercise: Code Magnets....................................................................................................................................................................................... 367
Section 11.31. JavaCross 7.0........................................................................................................................................................................................................ 368
Section 11.32. Exercise Solutions: True or False........................................................................................................................................................................ 369
Section 11.33. Code Magnets....................................................................................................................................................................................................... 369
Section 11.34. JavaCross Answers............................................................................................................................................................................................... 370
Chapter 12. A Very Graphic.................................................................................................. 371
Section 12.1. It all starts with a window...................................................................................................................................................................................... 372
Section 12.2. Your first GUI: a button on a frame...................................................................................................................................................................... 373
Section 12.3. Getting a user event............................................................................................................................................................................................... 375
Section 12.4. Getting a button's ActionEvent............................................................................................................................................................................. 378
Section 12.5. There are no Dumb Questions.............................................................................................................................................................................. 380
Section 12.6. Make your own drawing widget............................................................................................................................................................................ 382
Section 12.7. Because life's too short to paint the circle a solid color when there's a gradient blend waiting for you.............................................................. 385
Section 12.8. BULLET POINTS.................................................................................................................................................................................................. 386
Section 12.9. We can get an event............................................................................................................................................................................................... 387
Section 12.10. Let's try it with TWO buttons.............................................................................................................................................................................. 390
Section 12.11. Java Exposed: This weeks interview: Instance of an Inner Class....................................................................................................................... 398
Section 12.12. There are no Dumb Questions............................................................................................................................................................................. 400
Section 12.13. Code Kitchen........................................................................................................................................................................................................ 404
Section 12.14. Exercise: Who am I?............................................................................................................................................................................................. 412
Section 12.15. Exercise: BE the compiler..................................................................................................................................................................................... 413
Section 12.16. Pool Puzzle............................................................................................................................................................................................................ 414
Section 12.17. Exercise Solutions: Who am I?............................................................................................................................................................................. 415
Section 12.18. Pool Puzzle............................................................................................................................................................................................................ 416
Chapter 13. Work on Your Swing......................................................................................... 417
Section 13.1. Swing components.................................................................................................................................................................................................. 418
Section 13.2. Layout Managers.................................................................................................................................................................................................... 419
Section 13.3. How does the layout manager decide?.................................................................................................................................................................. 420
Section 13.4. The Big Three layout managers: border, flow, and box........................................................................................................................................ 421
Section 13.6. Playing with Swing components............................................................................................................................................................................ 431
Section 13.8. Code Kitchen.......................................................................................................................................................................................................... 436
Section 13.9. Making the BeatBox............................................................................................................................................................................................... 437
Section 13.10. Exercise: Which code goes with which layout?................................................................................................................................................... 442
Section 13.11. Code Fragments.................................................................................................................................................................................................... 443
Chapter 14. Saving Objects.................................................................................................. 447
Section 14.1. Capture the Beat..................................................................................................................................................................................................... 448
Section 14.2. Saving State............................................................................................................................................................................................................ 449
Section 14.3. Writing a serialized object to a file........................................................................................................................................................................ 450
Section 14.4. Data moves in streams from one place to another................................................................................................................................................ 451
Section 14.5. What really happens to an object when it's serialized?......................................................................................................................................... 452
Section 14.6. But what exactly IS an object's state? What needs to be saved?........................................................................................................................... 453
Section 14.7. If you want your class to be serializable, implement Serializable......................................................................................................................... 455
Section 14.9. Deserialization: restoring an object...................................................................................................................................................................... 459
Section 14.10. What happens during deserialization?............................................................................................................................................................... 460
Section 14.12. Saving and restoring the game characters........................................................................................................................................................... 462
Section 14.13. The GameCharacter class..................................................................................................................................................................................... 463
Section 14.14. Object Serialization.............................................................................................................................................................................................. 464
Section 14.15. Writing a String to a Text File.............................................................................................................................................................................. 465
Section 14.16. Text File Example: e-Flashcards.......................................................................................................................................................................... 466
Section 14.17. Quiz Card Builder (code outline)......................................................................................................................................................................... 467
Section 14.18. The java.io.File class............................................................................................................................................................................................ 470
Section 14.19. The beauty of buffers............................................................................................................................................................................................ 471
Section 14.20. Reading from a Text File..................................................................................................................................................................................... 472
Section 14.21. Quiz Card Player (code outline)........................................................................................................................................................................... 473
Section 14.22. Parsing with String split()................................................................................................................................................................................... 476
Section 14.24. Version ID: A Big Serialization Gotcha............................................................................................................................................................... 478
Section 14.25. Using the serialVersionUID................................................................................................................................................................................. 479
Section 14.26. Code Kitchen....................................................................................................................................................................................................... 480
Section 14.27. Saving a BeatBox pattern..................................................................................................................................................................................... 481
Section 14.28. Restoring a BeatBox pattern............................................................................................................................................................................... 482
Section 14.29. Sharpen your pencil: Can they be saved?........................................................................................................................................................... 483
Section 14.30. Exercise: True or False........................................................................................................................................................................................ 484
Section 14.31. Code Magnets....................................................................................................................................................................................................... 485
Section 14.32. Exercise Solutions............................................................................................................................................................................................... 486
Chapter 15. Make a Connection........................................................................................... 488
Section 15.1. Real-time Beat Box Chat........................................................................................................................................................................................ 489
Section 15.2. Connecting, Sending, and Receiving..................................................................................................................................................................... 491
Section 15.3. Make a network Socket connection....................................................................................................................................................................... 492
Section 15.4. A TCP port is just a number: A 16-bit number that identifies a specific program on the server......................................................................... 493
Section 15.5. To read data from a Socket, use a BufferedReader............................................................................................................................................... 495
Section 15.6. To write data to a Socket, use a PrintWriter......................................................................................................................................................... 496
Section 15.7. DailyAdviceClient code.......................................................................................................................................................................................... 498
Section 15.8. Writing a simple server......................................................................................................................................................................................... 500
Section 15.9. DailyAdviceServer code.......................................................................................................................................................................................... 501
Section 15.10. Writing a Chat Client........................................................................................................................................................................................... 503
Section 15.11. Java has multiple threads but only one Thread class.......................................................................................................................................... 507
Section 15.12. What does it mean to have more than one call stack?........................................................................................................................................ 508
Section 15.13. Every Thread needs a job to do: A method to put on the new thread stack........................................................................................................ 510
Section 15.14. To make a job for your thread, implement the Runnable interface..................................................................................................................... 511
Section 15.15. The Thread Scheduler........................................................................................................................................................................................... 514
Section 15.16. there are no Dumb Questions............................................................................................................................................................................... 517
Section 15.17. Putting a thread to sleep....................................................................................................................................................................................... 518
Section 15.18. Using sleep to make our program more predictable........................................................................................................................................... 519
Section 15.19. Making and starting two threads......................................................................................................................................................................... 520
Section 15.20. What will happen?............................................................................................................................................................................................... 520
Section 15.21. Um, yes. There IS a dark side. Threads can lead to concurrency 'issues'............................................................................................................ 521
Section 15.22. The Ryan and Monica problem, in code.............................................................................................................................................................. 523
Section 15.23. The Ryan and Monica example........................................................................................................................................................................... 524
Section 15.24. We need the makeWithdrawal ( ) method to run as one atomic thing............................................................................................................... 527
Section 15.25. Using an object's lock........................................................................................................................................................................................... 528
Section 15.26. The dreaded "Lost Update" problem................................................................................................................................................................... 529
Section 15.27. Let's run this code................................................................................................................................................................................................ 530
Section 15.28. Make the increment() method atomic. Synchronize it!...................................................................................................................................... 531
Section 15.30. The deadly side of synchronization..................................................................................................................................................................... 533
Section 15.31. New and improved SimpleChatClient.................................................................................................................................................................. 535
Section 15.32. Ready-bake Code: The really really simple Chat Server..................................................................................................................................... 537
Section 15.34. Code Kitchen........................................................................................................................................................................................................ 540
Section 15.35. Exercise: Code Magnets....................................................................................................................................................................................... 541
Section 15.36. Exercise Solutions................................................................................................................................................................................................ 543
Section 15.37. Five-Minute Mystery............................................................................................................................................................................................ 544
Chapter 16. Data structures................................................................................................ 546
Section 16.1. Tracking song popularity on your jukebox............................................................................................................................................................ 547
Section 16.2. Here's what you have so far, without the sort:...................................................................................................................................................... 548
Section 16.3. But the ArrayList class does NOT have a sort() method!..................................................................................................................................... 549
Section 16.4. ArrayList is not the only collection........................................................................................................................................................................ 550
Section 16.5. You could use a TreeSet... Or you could use the Collections.sort() method......................................................................................................... 551
Section 16.6. Adding Collections.sort() to the Jukebox code..................................................................................................................................................... 552
Section 16.7. But now you need Song objects, not just simple Strings....................................................................................................................................... 553
Section 16.8. Changing the Jukebox code to use Songs instead of Strings................................................................................................................................ 554
Section 16.9. It won't compile!.................................................................................................................................................................................................... 555
Section 16.10. The sort() method declaration............................................................................................................................................................................. 555
Section 16.11. Generics means more type-safety......................................................................................................................................................................... 557
Section 16.12. Learning generics................................................................................................................................................................................................. 558
Section 16.13. Using generic CLASSES....................................................................................................................................................................................... 559
Section 16.14. Using type parameters with ArrayList................................................................................................................................................................. 560
Section 16.15. Using generic METHODS..................................................................................................................................................................................... 561
Section 16.16. Here's where it gets weird.................................................................................................................................................................................... 562
Section 16.17. Revisiting the sort() method................................................................................................................................................................................ 564
Section 16.18. In generics, "extends" means "extends or implements"...................................................................................................................................... 565
Section 16.19. Finally we know what's wrong............................................................................................................................................................................. 566
Section 16.20. The new, improved, comparable Song class....................................................................................................................................................... 567
Section 16.21. We can sort the list, but....................................................................................................................................................................................... 568
Section 16.22. Using a custom comparator................................................................................................................................................................................. 569
Section 16.23. Updating the Jukebox to use a Comparator........................................................................................................................................................ 570
Section 16.24. Sharpen your pencil: Reverse Engineer.............................................................................................................................................................. 570
Section 16.25. Sharpen your pencil: Fill-in-the-blanks.............................................................................................................................................................. 572
Section 16.26. Uh-oh. The sorting all works, but now we have duplicates................................................................................................................................ 573
Section 16.27. We need a Set instead of a List............................................................................................................................................................................ 574
Section 16.28. The Collection API (part of it)............................................................................................................................................................................. 575
Section 16.29. Using a HashSet instead of ArrayList.................................................................................................................................................................. 576
Section 16.30. What makes two objects equal?........................................................................................................................................................................... 577
Section 16.31. How a HashSet checks for duplicates: hashCode() and equals()........................................................................................................................ 578
Section 16.32. The Song class with overridden hashCode() and equals().................................................................................................................................. 579
Section 16.33. there are no Dumb Questions............................................................................................................................................................................. 580
Section 16.34. And if we want the set to stay sorted, we've got TreeSet..................................................................................................................................... 581
Section 16.35. What you MUST know about TreeSet................................................................................................................................................................. 582
Section 16.36. TreeSet elements MUST be comparable............................................................................................................................................................. 583
Section 16.37. We've seen Lists and Sets, now we'll use a Map.................................................................................................................................................. 584
Section 16.38. Finally, back to generics...................................................................................................................................................................................... 585
Section 16.39. Using polymorphic arguments and generics...................................................................................................................................................... 586
Section 16.40. But will it work with ArrayList<Dog> ?.............................................................................................................................................................. 587
Section 16.41. What could happen if it were allowed................................................................................................................................................................. 588
Section 16.42. Wildcards to the rescue........................................................................................................................................................................................ 591
Section 16.43. Alternate syntax for doing the same thing.......................................................................................................................................................... 592
Section 16.45. Exercise: BE the compiler, advanced.................................................................................................................................................................. 593
Section 16.46. Solution to the "Reverse Engineer" sharpen exercise......................................................................................................................................... 594
Section 16.47. Exercise Solution.................................................................................................................................................................................................. 595
Section 16.48. BE the compiler solution..................................................................................................................................................................................... 596
Chapter 17. Release Your Code............................................................................................ 598
Section 17.1. Deploying your application.................................................................................................................................................................................... 599
Section 17.2. Imagine this scenario............................................................................................................................................................................................ 600
Section 17.3. Separate source code and class files...................................................................................................................................................................... 601
Section 17.4. Put your Java in a JAR.......................................................................................................................................................................................... 602
Section 17.5. Running (executing) the JAR................................................................................................................................................................................ 603
Section 17.6. Put your classes in packages!................................................................................................................................................................................ 604
Section 17.7. Preventing package name conflicts....................................................................................................................................................................... 605
Section 17.8. Compiling and running with packages.................................................................................................................................................................. 607
Section 17.9. The -d flag is even cooler then we said.................................................................................................................................................................. 608
Section 17.10. Making an executable JAR with packages.......................................................................................................................................................... 609
Section 17.11. So where did the manifest file go?........................................................................................................................................................................ 610
Section 17.12. Java Web Start...................................................................................................................................................................................................... 614
Section 17.13. The .jnlp file.......................................................................................................................................................................................................... 616
Section 17.14. Steps for making and deploying a Java Web Start app........................................................................................................................................ 617
Section 17.15. What's First?......................................................................................................................................................................................................... 618
Section 17.16. True or False......................................................................................................................................................................................................... 619
Section 17.17. Summary-Cross 7.0.............................................................................................................................................................................................. 620
Chapter 18. Distributed Computing.................................................................................... 624
Section 18.1. Method calls are always bet ween two objects on the same heap......................................................................................................................... 625
Section 18.2. What if you want to invoke a method on an object running on another machine?............................................................................................. 626
Section 18.3. Object A, running on Little, wants to call a method on Object B, running on Big............................................................................................... 627
Section 18.4. But you can't do that.............................................................................................................................................................................................. 627
Section 18.5. The role of the 'helpers'......................................................................................................................................................................................... 629
Section 18.6. Java RMI gives you the client and service helper objects!.................................................................................................................................... 631
Section 18.7. How does the client get the stub object?............................................................................................................................................................... 637
Section 18.8. How does the client get the stub class?................................................................................................................................................................. 638
Section 18.9. Be sure each machine has the class files it needs................................................................................................................................................. 639
Section 18.10. Sharpen your pencil: What's First?..................................................................................................................................................................... 640
Section 18.11. Yeah, but who really uses RMI?........................................................................................................................................................................... 641
Section 18.12. What about Servlets?........................................................................................................................................................................................... 642
Section 18.13. A very simple Ser vlet........................................................................................................................................................................................... 644
Section 18.14. HTML page with a link to this servlet................................................................................................................................................................. 644
Section 18.16. Just for fun, let's make the Phrase-O-Matic work as a servlet............................................................................................................................ 646
Section 18.17. Phrase-O-Matic code, servlet-friendly................................................................................................................................................................. 647
Section 18.18. Enterprise JavaBeans: RMI on steroids.............................................................................................................................................................. 648
Section 18.19. For our final trick... a little Jini........................................................................................................................................................................... 649
Section 18.20. Adaptive discovery in action............................................................................................................................................................................... 650
Section 18.21. Self-healing net work in action............................................................................................................................................................................ 652
Section 18.22. Final Project: the Universal Service browser...................................................................................................................................................... 653
Section 18.23. How it works:....................................................................................................................................................................................................... 654
Section 18.24. The classes and interfaces:.................................................................................................................................................................................. 656
Section 18.25. Sharpen your pencil............................................................................................................................................................................................. 661
Section 18.26. Congratulations!.................................................................................................................................................................................................. 665
Appendix A. Final Code Kitchen.......................................................................................... 666
Section A.1. Final BeatBox client program.................................................................................................................................................................................. 667
Appendix B. The Top Ten Topics that almost made it into the Real Book............................. 676
Section B.1. #10 Bit Manipulation............................................................................................................................................................................................... 677
Section B.2. #9 Immutability...................................................................................................................................................................................................... 678
Section B.3. #8 Assertions........................................................................................................................................................................................................... 679
Section B.4. #7 Block Scope........................................................................................................................................................................................................ 680
Section B.5. #6 Linked Invocations............................................................................................................................................................................................. 681
Section B.6. #5 Anonymous and Static Nested Classes............................................................................................................................................................. 682
Section B.7. #5 Anonymous and Static Nested Classes, continued........................................................................................................................................... 683
Section B.8. #4 Access Levels and Access Modifiers (Who Sees What).................................................................................................................................... 684
Section B.9. #4 Access Levels and Access Modifiers, cont......................................................................................................................................................... 684
Section B.10. #3 String and StringBuffer/StringBuilder Methods............................................................................................................................................ 686
Section B.11. #2 Multidimensional Arrays.................................................................................................................................................................................. 687
Section B.12. And the number one topic that didn't quite make it in... #1 Enumerations (also called Enumerated Types or Enums).................................. 688
Section B.13. Using "if" and "switch" with Enums..................................................................................................................................................................... 689
Section B.14. #1 Enumerations, completed................................................................................................................................................................................ 690
Section B.15. Five-Minute Mystery: A Long Trip Home............................................................................................................................................................. 691
Section B.16. Five-Minute Mystery Solution.............................................................................................................................................................................. 692
+HDG)LUVW-DYD
6HFRQG(GLWLRQ
BY+ATHY3IERRAAND"ERT"ATES
#OPYRIGHT¥BY/2EILLY-EDIA)NC!LLRIGHTSRESERVED

0RINTEDINTHE5NITED3TATESOF!MERICA
0UBLISHEDBY/2EILLY-EDIA)NC'RAVENSTEIN(IGHWAY.ORTH3EBASTOPOL#!

/2EILLY-EDIABOOKSMAYBEPURCHASEDFOREDUCATIONALBUSINESSORSALESPROMOTIONALUSE
/NLINEEDITIONSAREALSOAVAILABLEFORMOSTTITLESSAFARIOREILLYCOM &ORMOREINFORMATION
CONTACTOURCORPORATEINSTITUTIONALSALESDEPARTMENT ORCORPORATE OREILLYCOM
(GLWRU -IKE,OUKIDES
&RYHU'HVLJQHU %DIE&REEDMAN
,QWHULRU'HVLJQHUV+ATHY3IERRAAND"ERT"ATES
3ULQWLQJ+LVWRU\
-AY &IRST%DITION
&EBRUARY 3ECOND%DITION
9OUMIGHTWANTTOPICKUPACOPYOFBOTHEDITIONSFORYOURKIDS4HINKE"AY©
4HE/2EILLYLOGOISAREGISTEREDTRADEMARKOF/2EILLY-EDIA)NC*AVAANDALL*AVA BASED

TRADEMARKSANDLOGOSARETRADEMARKSORREGISTEREDTRADEMARKSOF3UN-ICROSYSTEMS)NCINTHE
5NITED3TATESANDOTHERCOUNTRIES/2EILLY-EDIA)NCISINDEPENDENTOF3UN-ICROSYSTEMS
-ANYOFTHEDESIGNATIONSUSEDBYMANUFACTURERSANDSELLERSTODISTINGUISHTHEIRPRODUCTSARE
CLAIMEDASTRADEMARKS
7HERETHOSEDESIGNATIONSAPPEARINTHISBOOKAND/2EILLY-EDIA)NCWASAWAREOFATRADEMARK
CLAIMTHEDESIGNATIONSHAVEBEENPRINTEDINCAPSORINITIALCAPS
7HILEEVERYPRECAUTIONHASBEENTAKENINTHEPREPARATIONOFTHISBOOKTHEPUBLISHERANDTHE
AUTHORSASSUMENORESPONSIBILITYFORERRORSOROMISSIONSORFORDAMAGESRESULTINGFROMTHEUSEOF
THEINFORMATIONCONTAINEDHEREIN
)NOTHERWORDSIFYOUUSEANYTHINGIN(EAD&IRST*AVA©TOSAYRUNANUCLEARPOWERPLANTORAIR
TRAFlCCONTROLSYSTEMYOUREONYOUROWN
)3".
;-=
4OOURBRAINSFORALWAYSBEINGTHERE
Licensed by
DESPITESHAKYEVIDENCE
Eduard Simons
104038
:KDWWKH\·UHVD\LQJDERXW+HDG)LUVW
!MAZONNAMED(EAD&IRST*AVA 3OFTWARE$EVELOPMENT-AGAZINENAMED
A4OP4EN%DITORS#HOICEFOR (EAD&IRST*AVAAlNALISTFORTHETH!NNUAL
#OMPUTER"OOKSOF *OLT#OLA0RODUCT%XCELLENCE!WARDS
lRSTEDITION
h+ATHYAND"ERTS@(EAD&IRST*AVATRANSFORMSTHEPRINTEDPAGEINTOTHECLOSESTTHINGTOA'5)YOUVE
EVERSEEN)NAWRYHIPMANNERTHEAUTHORSMAKELEARNING*AVAANENGAGING@WHATRETHEYGONNADO
NEXTEXPERIENCEv
7ARREN+EUFFEL3OFTWARE$EVELOPMENT-AGAZINE
hTHEONLYWAYTODECIDETHEWORTHOFATUTORIALISTODECIDEHOWWELLITTEACHES(EAD&IRST*AVAEXCELSAT
TEACHING/+)THOUGHTITWASSILLYTHEN)REALIZEDTHAT)WASTHOROUGHLYLEARNINGTHETOPICSAS)WENT
THROUGHTHEBOOKv
h4HESTYLEOF(EAD&IRST*AVAMADELEARNINGWELLEASIERv
SLASHDOTHONESTPUCKSREVIEW
h"EYONDTHEENGAGINGSTYLETHATDRAGSYOUFORWARDFROMKNOW NOTHINGINTOEXALTED*AVAWARRIORSTATUS
(EAD&IRST*AVACOVERSAHUGEAMOUNTOFPRACTICALMATTERSTHATOTHERTEXTSLEAVEASTHEDREADEDhEXERCISE
FORTHEREADERv)TSCLEVERWRYHIPANDPRACTICALTHEREARENTALOTOFTEXTBOOKSTHATCANMAKETHATCLAIM
ANDLIVEUPTOITWHILEALSOTEACHINGYOUABOUTOBJECTSERIALIZATIONANDNETWORKLAUNCHPROTOCOLSv
$R$AN2USSELL$IRECTOROF5SER3CIENCESAND%XPERIENCE2ESEARCH
)"-!LMADEN2ESEARCH#ENTERANDTEACHES!RTIlCIAL)NTELLIGENCEAT3TANFORD5NIVERSITY
h)TSFASTIRREVERENTFUNANDENGAGING"ECAREFULYOUMIGHTACTUALLYLEARNSOMETHINGv

+EN!RNOLDFORMER3ENIOR%NGINEERAT3UN-ICROSYSTEMS
#O AUTHORWITH*AMES'OSLINGCREATOROF*AVA h4HE*AVA0ROGRAMMING,ANGUAGEv
h*AVATECHNOLOGYISEVERYWHERE)FYOUDEVELOPSOFTWAREANDHAVENTLEARNED*AVAITSDElNITELY
TIMETODIVEIN(EAD&IRSTv
3COTT-C.EALY3UN-ICROSYSTEMS#HAIRMAN0RESIDENTAND#%/
h(EAD&IRST*AVAISLIKE-ONTY0YTHONMEETSTHEGANGOFFOURTHETEXTISBROKENUPSOWELLBYPUZZLES
ANDSTORIESQUIZZESANDEXAMPLESTHATYOUCOVERGROUNDLIKENOCOMPUTERBOOKBEFOREv
$OUGLAS2OWE#OLUMBIA*AVA5SERS'ROUP
3UDLVHIRU+HDG)LUVW-DYD
h2EAD(EAD&IRST*AVAANDYOUWILLONCEAGAINEXPERIENCEFUNINLEARNING&ORPEOPLEWHOLIKETOLEARN
NEWPROGRAMMINGLANGUAGESANDDONOTCOMEFROMACOMPUTERSCIENCEORPROGRAMMINGBACKGROUND
THISBOOKISAGEM4HISISONEBOOKTHATMAKESLEARNINGACOMPLEXCOMPUTERLANGUAGEFUN)HOPE
THATTHEREAREMOREAUTHORSWHOAREWILLINGTOBREAKOUTOFTHESAMEOLDMOLDOF@TRADITIONALWRITING
STYLES,EARNINGCOMPUTERLANGUAGESSHOULDBEFUNNOTONEROUSv
*UDITH4AYLOR3OUTHEAST/HIO-ACROMEDIA5SER'ROUP
h)FYOUWANTTOLEARN*AVALOOKNOFURTHERWELCOMETOTHElRST'5) BASEDTECHNICALBOOK4HIS

PERFECTLY EXECUTEDGROUND BREAKINGFORMATDELIVERSBENElTSOTHER*AVATEXTSSIMPLYCANT
0REPAREYOURSELFFORATRULYREMARKABLERIDETHROUGH*AVALANDv
.EIL2"AUMAN#APTAIN#%/'EEK#RUISESWWW'EEK#RUISESCOM
h)FYOURERELATIVELYNEWTOPROGRAMMINGANDYOUAREINTERESTEDIN*AVAHERESYOURBOOK#OVERING
EVERYTHINGFROMOBJECTSTOCREATINGGRAPHICALUSERINTERFACES'5) EXCEPTIONERROR HANDLINGTONET
WORKINGSOCKETS ANDMULTITHREADINGEVENPACKAGINGUPYOURPILEOFCLASSESINTOONEINSTALLATIONlLE
THISBOOKISQUITECOMPLETE)FYOULIKETHESTYLE)MCERTAINYOULLLOVETHEBOOKANDLIKEMEHOPE
THATTHE(EAD&IRSTSERIESWILLEXPANDTOMANYOTHERSUBJECTSv
,INUX1UESTIONSORG
h)WAS!$$)#4%$TOTHEBOOKSSHORTSTORIESANNOTATEDCODEMOCKINTERVIEWSANDBRAINEXERCISESv

-ICHAEL9UANAUTHOR%NTERPRISE*-%
h@(EAD&IRST*AVAGIVESNEWMEANINGTOTHEIRMARKETINGPHRASE{4HERESAN/2EILLYFORTHAT{)
PICKEDTHISUPBECAUSESEVERALOTHERS)RESPECTHADDESCRIBEDITINTERMSLIKE@REVOLUTIONARYANDA
DESCRIBEDARADICALLYDIFFERENTAPPROACHTOTHETEXTBOOK4HEYWEREARE RIGHT)NTYPICAL/2EILLY
FASHIONTHEYVETAKENASCIENTIlCANDWELLCONSIDEREDAPPROACH4HERESULTISFUNNYIRREVERENTTOPICAL
INTERACTIVEANDBRILLIANT2EADINGTHISBOOKISLIKESITTINGINTHESPEAKERSLOUNGEATAVIEWCONFERENCE
LEARNINGFROMnANDLAUGHINGWITHnPEERS)FYOUWANTTO5.$%234!.$*AVAGOBUYTHISBOOKv
!NDREW0OLLACKWWWTHENORTHCOM
h)FANYONEINTHEWORLDISFAMILIARWITHTHECONCEPTOF@(EAD&IRSTITWOULDBEME4HIS
BOOKISSOGOOD)DMARRYITON46v
2ICK2OCKWELL#OMEDIAN
4HEORIGINAL&/84ELEVISIONh7HO7ANTSTO-ARRYA-ILLIONAIREvGROOM
h4HISSTUFFISSOFRICKINGGOODITMAKESMEWANNA7%%0)MSTUNNEDv
&LOYD*ONES3ENIOR4ECHNICAL7RITER0OOLBOY"%!
h!FEWDAYSAGO)RECEIVEDMYCOPYOF(EAD&IRST*AVABY+ATHY3IERRAAND"ERT"ATES)MONLYPARTWAY
THROUGHTHEBOOKBUTWHATSAMAZEDMEISTHATEVENINMYSLEEP DEPRIVEDSTATETHATlRSTEVENING)FOUND
MYSELFTHINKING@/+JUSTONEMOREPAGETHEN)LLGOTOBEDh
*OE,ITTON
3UDLVHIRURWKHU+HDG)LUVWERRNVFRDXWKRUHGE\.DWK\DQG%HUW
!MAZONNAMED(EAD&IRST3ERVLETS 3OFTWARE$EVELOPMENT-AGAZINENAMED
A4OP4EN%DITORS#HOICEFOR (EAD&IRST3ERVLETSAND(EAD&IRST$ESIGN
#OMPUTER"OOKSOF 0ATTERNSlNALISTSFORTHETH!NNUAL
lRSTEDITION 0RODUCT%XCELLENCE!WARDS
h)FEELLIKEATHOUSANDPOUNDSOFBOOKSHAVEJUSTBEENLIFTEDOFFOFMYHEADv
7ARD#UNNINGHAMINVENTOROFTHE7IKI
ANDFOUNDEROFTHE(ILLSIDE'ROUP
h)LAUGHED)CRIEDITMOVEDMEv

$AN3TEINBERG%DITOR IN #HIEFJAVANET
h-YlRSTREACTIONWASTOROLLONTHEmOORLAUGHING!FTER)PICKEDMYSELFUP)REALIZEDTHATNOTONLYISTHE
BOOKTECHNICALLYACCURATEITISTHEEASIESTTOUNDERSTANDINTRODUCTIONTODESIGNPATTERNSTHAT)HAVESEENv
$R4IMOTHY!"UDD!SSOCIATE0ROFESSOROF#OMPUTER3CIENCEAT/REGON3TATE5NIVERSITY
AUTHOROFMORETHANADOZENBOOKSINCLUDING#FOR*AVA0ROGRAMMERS
h*USTTHERIGHTTONEFORTHEGEEKED OUTCASUAL COOLGURUCODERINALLOFUS4HERIGHTREFERENCEFORPRAC

TICALDEVELOPMENTSTRATEGIESGETSMYBRAINGOINGWITHOUTHAVINGTOSLOGTHROUGHABUNCHOFTIRED
STALEPROFESSOR SPEAKv
4RAVIS+ALANICK&OUNDEROF3COURAND2ED3WOOSH
-EMBEROFTHE-)442
h&).!,,9 A*AVABOOKWRITTENTHEWAY)WOULDAWROTEITIF)WEREME
3ERIOUSLYTHOUGH THISBOOKABSOLUTELYBLOWSAWAYEVERYOTHERSOFTWAREBOOK)VEEVERREAD
!GOODBOOKISVERYDIFlCULTTOWRITEYOUHAVETOTAKEALOTOFTIMETOMAKETHINGSUNFOLDINA
NATURALhREADERORIENTEDvSEQUENCE)TSALOTOFWORK-OSTAUTHORSCLEARLYARENTUPTOTHECHALLENGE
#ONGRATULATIONSTOTHE(EAD&IRST%*"TEAMFORAlRSTCLASSJOB
7ALLY&LINT
h)COULDNOTHAVEIMAGINEDAPERSONSMILINGWHILESTUDYINGAN)4BOOK5SING(EAD&IRST%*"
MATERIALS)GOTAGREATSCORE ANDSETAWORLDRECORDASTHEYOUNGEST3#"#$YEARSv
!FSAH3HAFQUATWORLDSYOUNGEST3#"#$
h4HIS(EAD&IRST3ERVLETSBOOKISASGOODASTHE(EAD&IRST%*"BOOKWHICHMADEMELAUGH
!.$GAVEMEONTHEEXAMv
*EF#UMPS*%%CONSULTANT#RONOS
Other related books from O’Reilly
$QW7KH'H¿QLWLYH*XLGH
%HWWHU)DVWHU/LJKWHU-DYD
(QWHUSULVH-DYD%HDQV
+LEHUQDWH$'HYHORSHU¶V1RWHERRN
-DYD7LJHU$'HYHORSHU¶V1RWHERRN
-DYD&RRNERRN
-DYDLQD1XWVKHOO
-DYD1HWZRUN3URJUDPPLQJ
-DYD6HUYOHW -63&RRNERRN
-DYD6ZLQJ
-DYD6HUYHU)DFHV
-DYD6HUYHU3DJHV
3URJUDPPLQJ-DNDUWD6WUXWV
7RPFDW7KH'HILQLWLYH*XLGH
Other books in O’Reilly’s Head First series

+HDG)LUVW-DYD
+HDG)LUVW2EMHFW2ULHQWHG$QDO\VLVDQG'HVLJQ22$ '
+HDG5XVK$MD[
+HDG)LUVW+70/ZLWK&66DQG;+70/
+HDG)LUVW'HVLJQ3DWWHUQV
+HDG)LUVW(-%
+HDG)LUVW303
+HDG)LUVW64/
+HDG)LUVW6RIWZDUH'HYHORSPHQW
+HDG)LUVW&
+HDG)LUVW-DYD6FULSW
+HDG)LUVW3URJUDPPLQJ
+HDG)LUVW$MD[
+HDG)LUVW3K\VLFV
+HDG)LUVW6WDWLVWLFV
+HDG)LUVW5XE\RQ5DLOV
+HDG)LUVW3+3 0\64/
KRZWRXVHWKLVERRN
,QWUR
,FDQ·WEHOLHYHWKH\
SXWWKDWLQD-DYD
SURJUDPPLQJERRN

DQ VZ HU W KH E XU QLQJTXHVWLRQPP
LQ J ERRN"µ
H UD
,QWKLVVHFWLRQWZKH\SXWWKDWLQD-DYDSURJ
´6RZK\','
[[L
KRZWRXVHWKLVERRN
?PWQ[\PQ[JWWSNWZ'
)FYOUCANANSWERhYESvTOALLOFTHESE
7KLVLV127DUHIHUHQFH
+DYH\RXGRQHVRPHSURJUDPPLQJ" ERRN+HDG)LUVW-DYDLVD
ERRNGHVLJQHGIRUOHDUQLQJ
'R\RXZDQWWROHDUQ-DYD" QRWDQHQF\FORSHGLDRI
-DYDIDFWV
'R\RXSUHIHUVWLPXODWLQJGLQQHUSDUW\
FRQYHUVDWLRQWRGU\GXOOWHFKQLFDO
OHFWXUHV"
THISBOOKISFORYOU
?PW[PW]TLXZWJIJTaJIKSI_IaNZWU\PQ[JWWS'
)FYOUCANANSWERhYESvTOANYONEOFTHESE
,V\RXUSURJUDPPLQJEDFNJURXQGOLPLWHG
WR+70/RQO\ZLWKQRVFULSWLQJODQJXDJH
H[SHULHQFH"
)FYOUVEDONEANYTHINGWITHLOOPINGORIFTHEN
LOGICYOULLDOlNEWITHTHISBOOKBUT(4-,
TAGGINGALONEMIGHTNOTBEENOUGH
$UH\RXDNLFNEXWW&SURJUDPPHU
ORRNLQJIRUDUHIHUHQFHERRN"
$UH\RXDIUDLGWRWU\VRPHWKLQJGLIIHUHQW"
:RXOG\RXUDWKHUKDYHDURRWFDQDOWKDQ
PL[VWULSHVZLWKSODLG"'R\RXEHOLHYH
WKDQDWHFKQLFDOERRNFDQ·WEHVHULRXVLI
WKHUH·VDSLFWXUHRIDGXFNLQWKHPHPRU\
PDQDJHPHQWVHFWLRQ"
THISBOOKISNOTFORYOU
>QRWHIURPPDUNHWLQJZKRWRRNRXW
WKHSDUWDERXWKRZ
WKLVERRNLVIRUDQ\RQHZLW YDOLGFUHGLWFDUG"$QGZKD W
DERXWWKDW´*LYHWKH*LIWRKDI-
GLVFXVVHG)UHG@ DYDµKROLGD\SURPRWLRQZH
[[LL LQWUR
WKHLQWUR
?MSVW__PI\aW]¼ZM\PQVSQVO
h(OWCANTHISBEASERIOUS*AVAPROGRAMMINGBOOKv
h7HATSWITHALLTHEGRAPHICSv
h#AN)ACTUALLYLEARNITTHISWAYv
h$O)SMELLPIZZAv
\RXUEUDLQ
7+,6LVLP WKLQNV
SRUWDQW
)VL_MSVW__PI\aW]ZJZIQVQ[\PQVSQVO
9OURBRAINCRAVESNOVELTY)TSALWAYSSEARCHINGSCANNINGWAITINGFOR
SOMETHINGUNUSUAL)TWASBUILTTHATWAYANDITHELPSYOUSTAYALIVE
4ODAYYOURELESSLIKELYTOBEATIGERSNACK"UTYOURBRAINSSTILL
LOOKING9OUJUSTNEVERKNOW
3OWHATDOESYOURBRAINDOWITHALLTHEROUTINEORDINARYNORMAL
THINGSYOUENCOUNTER%VERYTHINGITCANTOSTOPTHEMFROM
INTERFERINGWITHTHEBRAINSREALJOBRECORDINGTHINGSTHATMATTER)T
DOESNTBOTHERSAVINGTHEBORINGTHINGSTHEYNEVERMAKEITPASTTHE
hTHISISOBVIOUSLYNOTIMPORTANTvlLTER
(OWDOESYOURBRAINKNOWWHATSIMPORTANT3UPPOSEYOUREOUTFOR
ADAYHIKEANDATIGERJUMPSINFRONTOFYOUWHATHAPPENSINSIDEYOUR
HEAD
*UHDW2QO\
.EURONSlRE%MOTIONSCRANKUP#HEMICALSSURGE PRUHGXOOGU\
ERULQJSDJHV
!NDTHATSHOWYOURBRAINKNOWS
WKLQNV
7KLVPXVWEHLPSRUWDQW'RQ·WIRUJHWLW
\RXUEUDQLQ·WZRUWK
"UTIMAGINEYOUREATHOMEORINALIBRARY)TSASAFEWARMTIGER FREE 7+,6LQJLV
ZONE9OURESTUDYING'ETTINGREADYFORANEXAM/RTRYINGTOLEARN VDY
SOMETOUGHTECHNICALTOPICYOURBOSSTHINKSWILLTAKEAWEEKTENDAYS
ATTHEMOST
*USTONEPROBLEM9OURBRAINSTRYINGTODOYOUABIGFAVOR)TS
TRYINGTOMAKESURETHATTHISOBVIOUSLYNON IMPORTANTCONTENT
DOESNTCLUTTERUPSCARCERESOURCES2ESOURCESTHATAREBETTER
SPENTSTORINGTHEREALLYBIGTHINGS,IKETIGERS,IKETHEDANGEROF
lRE,IKEHOWYOUSHOULDNEVERAGAINSNOWBOARDINSHORTS
!NDTHERESNOSIMPLEWAYTOTELLYOURBRAINh(EYBRAINTHANK
YOUVERYMUCHBUTNOMATTERHOWDULLTHISBOOKISANDHOW
LITTLE)MREGISTERINGONTHEEMOTIONALRICHTERSCALERIGHTNOW)
REALLYDOWANTYOUTOKEEPTHISSTUFFAROUNDv
\RXDUHKHUH [[LLL
KRZWRXVHWKLVERRN
W-DYDµ UHDGHUDVDOHDUQHU
:HWKLQNRID´+HDG)LUV
HVXUH
YHWRJHWLWWKHQPDN
WDN HW R OHD UQ VR PH WKLQJ")LUVW\RXKD QW KH
6RZKDWGRHVLW RXUKHDG%DVH GR
W LW ,W ·VQ RWDE RX WSXVKLQJIDFWVLQWR\ SV \F KR ORJ \
\RXGRQ·WIRUJH QGHGXFDWLRQDO
KL QF RJ QLW LYH VF LHQFHQHXURELRORJ\D \R XU EUD LQ RQ
ODWHVWUHVHDUF QRZZKDWWXUQV
HV D ORW P RUH WK DQ WH[WRQDSDJH:HN
OHDUQLQJWDN
LQFLSOHV
G)LUVWOHDUQLQJSU QHHGVWRFDOOD
6RPHRI WKH+HD PHWKRGRQWKH
VHUYHU 50,UHPRWH
MORABLETHANWORDS VHUYLFH
AGESAREFARMOREME
0DNHLWYLVXDO)M FFEC TIVE 5 PTO
GMUCHMOREE
ALONEANDMAKELEARNIN ALSOMAKES
GR&DOF
ANDTRANSFERSTUDIES )T
Licensed by
IMPROVEM ENT IN REC ALL
VZ LWK LQ
NDABLE3XWWKHZRUG
THINGSMOREUNDERSTA THANONTHE UHWXUQYDOXH
DS KLF VTHEYRELATETORATHER
RUQHDUWKHJU WI LLB EU PTO TWICE
RPAGEANDLE ARN ERS
BOTTOMORONANOTHE NT
LYT OS OLV EP ROB LEM SRELATEDTOTHECONTE
ASLIKE
Eduard Simons
TSTUDIES
DOL]HGVW\OH)NRECEN
RQDODQGSHUVRQ ECONTENTSPOKE
8VHDFRQYHUVDWL RNIN GTE STS IFTH
TSP ERFO RME DU PTO BETTERONPOST LEA ERTHAN
STUDEN ONVERSATIONALSTYLERATH
,WUHDOO\VXFNVWREHD
Q USINGAFIRST PERSONC UAGE$ONT
DIRECTLYTOTHEREADER SECASU ALL ANG
DEVWUDFWPHWKRG<RX
SINSTEADOFLECTURING5
TAK ING AFORMALTONE4ELLSTORIE REA TTE NTIO NTO AS TIMULATING
GRQ·WKDYHDERG\ ICHWOULDYOUPAYMO
104038
SELF TOO SER IOU SLY7H
TAKEYOUR
ONORALECTURE
DINNERPARTYCOMPANI
SS R
O\)NOTHERWORDSUNLE 'RHVLWPDNHVHQVHW
WW KH OH DUQ HU WR WKLQNPRUHGHHS AD VD\ 7XE, 6$ %DWKURRP"
*H HAPPENSINYOUR HE 2ULV
EURONSNOTHINGMUCH %DWKURRP,6$7XE"
YOUAC TIVELYFLEXYOURN RIOU SA NDINSPIREDTO 6$ UHODWLRQVKLS"
ATEDE NGA GED CU LWD +$
!READERHASTOBEMOTIV RATENEWK NOWLEDGE
PRO BLE MS DR AW CONCLUSIONSANDGENE
SOL VE DTHOUGHT
CHALLENGES ERCISESAN
EX
!NDFORTHATYOUNEED VOLVEBOTHSIDES
SANDACTIVITIESTHATIN
DEVWUDFWYRLGURDP PROVOK INGQUESTION
LESENSES
OFTHEBRAINANDMULTIP

ERG\ LFRORQ
WKRG P DGHU·VDWWHQWLRQ7
EVEALL
1RPH ZLWKDVH *H W³ DQGNHHS³WKHUH PAST
(QG LW HISBUT)CANTSTAY AW AKE
HADTHE h)REALLYWANTTOLEARNT UT
NTOTHINGSTHATAREO
9OURBRAINPAYSATTENTIO
PAGEONEvEXPERIENCE ECT ED,E ARN ING AN EW
NGUNEXP
TINGSTRANGEEYE CATCHI CHMOREQUICKLYIFITSN
OT
OFTHEORDINARYINTERES BO RING 9OURBRAINWILLLEARNMU
OES NT HAV ETO BE
TOUGHTECHNICALTOPICD
INGISLARGELY
TYTOREMEMBERSOMETH
PR WLR QV 7 EN OWKNOWTHATYOURABILI URE MEMBERWHEN
7RXFKWKHLUH OUT9O
MBERWHATYOUCAREAB
ENT ON ITS EM OTIO NALCONTENT9OUREME OUT AB OY AND HISDOG
DEPEND
TTA LKIN GH EAR T WRENCHINGSTORIESAB
OW ERE NO )2ULEv
YOUFEELSOMETHING. ANDTHEFEELINGOFh
NS LIKE SU RPR ISECU RIOSITYFUNhWHATTHEv ARD OR REALIZE
7ERETALK INGEMOTIO SH
EVERYBODYELSETHINKSI
HEN YO US OLV EA PU ZZLELEARNSOMETHING RING DO ESN T
THATCOMESW NGI NEE
HANTHOUv"OBFROME
ATh)MMORETECHNICALT
YOUKNOWSOMETHINGTH
[[LY LQWUR
WKHLQWUR
5M\IKWOVQ\QWV"\PQVSQVOIJW]\\PQVSQVO
)FYOUREALLYWANTTOLEARNANDYOUWANTTOLEARNMOREQUICKLYANDMOREDEEPLY ,ZRQGHUKRZ,
PAYATTENTIONTOHOWYOUPAYATTENTION4HINKABOUTHOWYOUTHINK,EARNHOW FDQWULFNP\EUDLQ
YOULEARN LQWRUHPHPEHULQJ
WKLVVWXII
-OSTOFUSDIDNOTTAKECOURSESONMETACOGNITIONORLEARNINGTHEORYWHENWEWERE
GROWINGUP7EWEREEXPECTEDTOLEARNBUTRARELYTAUGHTTOLEARN
"UTWEASSUMETHATIFYOUREHOLDINGTHISBOOKYOUWANTTOLEARN*AVA!NDYOU
PROBABLYDONTWANTTOSPENDALOTOFTIME
4OGETTHEMOSTFROMTHISBOOKORANYBOOKORLEARNINGEXPERIENCETAKE
RESPONSIBILITYFORYOURBRAIN9OURBRAINONTHATCONTENT
4HETRICKISTOGETYOURBRAINTOSEETHENEWMATERIALYOURELEARNING
AS2EALLY)MPORTANT#RUCIALTOYOURWELL BEING!SIMPORTANTAS
ATIGER/THERWISEYOUREINFORACONSTANTBATTLEWITHYOURBRAIN
DOINGITSBESTTOKEEPTHENEWCONTENTFROMSTICKING
6RMXVWKRZ'2\RXJHW\RXUEUDLQWRWUHDW-DYDOLNHLW
ZDVDKXQJU\WLJHU"
4HERESTHESLOWTEDIOUSWAYORTHEFASTERMOREEFFECTIVEWAY4HE
SLOWWAYISABOUTSHEERREPETITION9OUOBVIOUSLYKNOWTHATYOUARE
ABLETOLEARNANDREMEMBEREVENTHEDULLESTOFTOPICSIFYOUKEEPPOUNDING
ONTHESAMETHING7ITHENOUGHREPETITIONYOURBRAINSAYSh4HISDOESNTFEEL
IMPORTANTTOHIMBUTHEKEEPSLOOKINGATTHESAMETHINGOVERANDOVERANDOVERSO
)SUPPOSEITMUSTBEv
4HEFASTERWAYISTODOANYTHINGTHATINCREASESBRAINACTIVITYESPECIALLYDIFFERENTTYPES
OFBRAINACTIVITY4HETHINGSONTHEPREVIOUSPAGEAREABIGPARTOFTHESOLUTION
ANDTHEYREALLTHINGSTHATHAVEBEENPROVENTOHELPYOURBRAINWORKINYOURFAVOR
&OREXAMPLESTUDIESSHOWTHATPUTTINGWORDSWITHINTHEPICTURESTHEYDESCRIBEAS
OPPOSEDTOSOMEWHEREELSEINTHEPAGELIKEACAPTIONORINTHEBODYTEXT CAUSES
YOURBRAINTOTRYTOMAKESSENSEOFHOWTHEWORDSANDPICTURERELATEANDTHIS
CAUSESMORENEURONSTOlRE-ORENEURONSlRINGMORECHANCESFORYOURBRAIN
TOGETTHATTHISISSOMETHINGWORTHPAYINGATTENTIONTOANDPOSSIBLYRECORDING
!CONVERSATIONALSTYLEHELPSBECAUSEPEOPLETENDTOPAYMOREATTENTIONWHENTHEY
PERCEIVETHATTHEYREINACONVERSATIONSINCETHEYREEXPECTEDTOFOLLOWALONGAND
HOLDUPTHEIREND4HEAMAZINGTHINGISYOURBRAINDOESNTNECESSARILYCARETHAT
THEhCONVERSATIONvISBETWEENYOUANDABOOK/NTHEOTHERHANDIFTHEWRITING
STYLEISFORMALANDDRYYOURBRAINPERCEIVESITTHESAMEWAYYOUEXPERIENCEBEING
LECTUREDTOWHILESITTINGINAROOMFULOFPASSIVEATTENDEES.ONEEDTOSTAYAWAKE
"UTPICTURESANDCONVERSATIONALSTYLEAREJUSTTHEBEGINNING
\RXDUHKHUH [[Y
KRZWRXVHWKLVERRN
0MZM¼[_PI\?-LQL"
kar]
7EUSEDPICTURESBECAUSEYOURBRAINISTUNEDFORVISUALSNOTTEXT!SFARASYOUR
BRAINSCONCERNEDAPICTUREREALLYISWORTHWORDS!NDWHENTEXTANDPICTURES LQW
â\g FW

WORKTOGETHERWEEMBEDDEDTHETEXTINTHEPICTURESBECAUSEYOURBRAINWORKS 'RJREMH
MOREEFFECTIVELYWHENTHETEXTISWITHINTHETHINGTHETEXTREFERSTOASOPPOSEDTOIN 'RJ
'RJ
ACAPTIONORBURIEDINTHETEXTSOMEWHERE
7EUSEDREPETITIONSAYINGTHESAMETHINGINDIFFERENTWAYSANDWITHDIFFERENTMEDIA
TYPESANDMULTIPLESENSESTOINCREASETHECHANCETHATTHECONTENTGETSCODEDCODED
INTOMORETHANONEAREAOFYOURBRAIN "%THECOMPILER
7EUSEDCONCEPTSANDPICTURESINUNEXPECTEDWAYSBECAUSEYOURBRAINISTUNEDFOR
NOVELTYANDWEUSEDPICTURESANDIDEASWITHATLEASTSOMEEMOTIONALCONTENTBECAUSE
YOURBRAINISTUNEDTOPAYATTENTIONTOTHEBIOCHEMISTRYOFEMOTIONS4HATWHICH
CAUSESYOUTOFEELSOMETHINGISMORELIKELYTOBEREMEMBEREDEVENIFTHATFEELINGIS
NOTHINGMORETHANALITTLEHUMORSURPRISEORINTEREST
7EUSEDAPERSONALIZEDCONVERSATIONALSTYLEBECAUSEYOURBRAINISTUNEDTOPAYMORE
ATTENTIONWHENITBELIEVESYOUREINACONVERSATIONTHANIFITTHINKSYOUREPASSIVELY
7KLV LV OOH
3X]]OH9L
LISTENINGTOAPRESENTATION9OURBRAINDOESTHISEVENWHENYOUREREADING
7EINCLUDEDMORETHANEXERCISESBECAUSEYOURBRAINISTUNEDTOLEARNAND
REMEMBERMOREWHENYOUDOTHINGSTHANWHENYOUREADABOUTTHINGS!NDWE
MADETHEEXERCISESCHALLENGING YET DO ABLEBECAUSETHATSWHATMOSTPEOPLEPREFER
7EUSEDMULTIPLELEARNINGSTYLESBECAUSEYOUMIGHTPREFERSTEP BY STEPPROCEDURES
WHILESOMEONEELSEWANTSTOUNDERSTANDTHEBIGPICTURElRSTWHILESOMEONEELSE
JUSTWANTSTOSEEACODEEXAMPLE"UTREGARDLESSOFYOUROWNLEARNINGPREFERENCE :MDD=LHGAFLK
EVERYONEBENElTSFROMSEEINGTHESAMECONTENTREPRESENTEDINMULTIPLEWAYS
7EINCLUDECONTENTFORBOTHSIDESOFYOURBRAINBECAUSETHEMOREOFYOURBRAINYOU
ENGAGETHEMORELIKELYYOUARETOLEARNANDREMEMBERANDTHELONGERYOUCAN
STAYFOCUSED3INCEWORKINGONESIDEOFTHEBRAINOFTENMEANSGIVINGTHEOTHERSIDE ,CXC
ACHANCETORESTYOUCANBEMOREPRODUCTIVEATLEARNINGFORALONGERPERIODOF 'ZRQUGF
TIME
!NDWEINCLUDEDSTORIESANDEXERCISESTHATPRESENTMORETHANONEPOINTOFVIEW
BECAUSEYOURBRAINISTUNEDTOLEARNMOREDEEPLYWHENITSFORCEDTOMAKE
OO
%UDLQ%DUEH
EVALUATIONSANDJUDGEMENTS
DUEHOO
EUDLQ E
7EINCLUDEDCHALLENGESWITHEXERCISESANDBYASKINGQUESTIONSTHATDONTALWAYSHAVE
ASTRAIGHTANSWERBECAUSEYOURBRAINISTUNEDTOLEARNANDREMEMBERWHENITHAS
TOWORKATSOMETHINGJUSTASYOUCANTGETYOURBODYINSHAPEBYWATCHINGPEOPLE
ATTHEGYM "UTWEDIDOURBESTTOMAKESURETHATWHENYOUREWORKINGHARDITS
ONTHERIGHTTHINGS4HATYOURENOTSPENDINGONEEXTRADENDRITEPROCESSINGAHARD TO
UNDERSTANDEXAMPLEORPARSINGDIFlCULTJARGON LADENOREXTREMELYTERSETEXT
7EUSEDANAPPROACH7EASSUMETHATIFYOUREGOINGFORA0H$IN*AVA
THISWONTBEYOURONLYBOOK3OWEDONTTALKABOUTEVERYTHING*USTTHESTUFFYOULL
ACTUALLYUSE
[[YL LQWUR
WKHLQWUR
0MZM¼[_PI\A7=KIVLW\WJMVLaW]Z
JZIQVQV\W[]JUQ[[QWV
3OWEDIDOURPART4HERESTISUPTOYOU4HESETIPSAREA
STARTINGPOINT,ISTENTOYOURBRAINANDlGUREOUTWHATWORKS
FORYOUANDWHATDOESNT4RYNEWTHINGS
FXWWKLVRXW
RQ\RXUUHIULGDQJHGUDVWLFNLW
WRU

6ORZGRZQ7KHPRUH\RXXQGHUVWDQG 'ULQNZDWHU/RWVRILW
WKHOHVV\RXKDYHWRPHPRUL]H 9OURBRAINWORKSBESTINANICEBATHOFmUID
$ONTJUSTREAD3TOPANDTHINK7HENTHE $EHYDRATIONWHICHCANHAPPENBEFOREYOU
BOOKASKSYOUAQUESTIONDONTJUSTSKIPTO EVERFEELTHIRSTY DECREASESCOGNITIVEFUNCTION
THEANSWER)MAGINETHATSOMEONEREALLYIS
ASKINGTHEQUESTION4HEMOREDEEPLYYOU 7DONDERXWLW2XWORXG
FORCEYOURBRAINTOTHINKTHEBETTERCHANCE 3PEAKINGACTIVATESADIFFERENTPARTOF
YOUHAVEOFLEARNINGANDREMEMBERING THEBRAIN)FYOURETRYINGTOUNDERSTAND
SOMETHINGORINCREASEYOURCHANCEOF
'RWKHH[HUFLVHV:ULWH\RXURZQQRWHV REMEMBERINGITLATERSAYITOUTLOUD"ETTER
7EPUTTHEMINBUTIFWEDIDTHEMFORYOU STILLTRYTOEXPLAINITOUTLOUDTOSOMEONE
THATWOULDBELIKEHAVINGSOMEONEELSE ELSE9OULLLEARNMOREQUICKLYANDYOUMIGHT
DOYOURWORKOUTSFORYOU!NDDONTJUST UNCOVERIDEASYOUHADNTKNOWNWERETHERE
LOOKATTHEEXERCISES5SEAPENCIL4HERES WHENYOUWEREREADINGABOUTIT
PLENTYOFEVIDENCETHATPHYSICALACTIVITY
WHILELEARNINGCANINCREASETHELEARNING /LVWHQWR\RXUEUDLQ
0AYATTENTIONTOWHETHERYOURBRAINISGETTING
5HDGWKH´7KHUHDUH1R'XPE4XHVWLRQVµ OVERLOADED)FYOUlNDYOURSELFSTARTINGTOSKIM
4HATMEANSALLOFTHEM4HEYRENOT THESURFACEORFORGETWHATYOUJUSTREADITS
OPTIONALSIDE BARSTHEYREPARTOFTHECORE TIMEFORABREAK/NCEYOUGOPASTACERTAIN
CONTENT3OMETIMESTHEQUESTIONSAREMORE POINTYOUWONTLEARNFASTERBYTRYINGTOSHOVE
USEFULTHANTHEANSWERS MOREINANDYOUMIGHTEVENHURTTHEPROCESS
'RQ·WGRDOO\RXUUHDGLQJLQRQHSODFH )HHOVRPHWKLQJ
3TAND UPSTRETCHMOVEAROUNDCHANGE 9OURBRAINNEEDSTOKNOWTHATTHISMATTERS'ET
CHAIRSCHANGEROOMS)TLLHELPYOURBRAIN INVOLVEDWITHTHESTORIES-AKEUPYOUROWN
FEELSOMETHINGANDKEEPSYOURLEARNINGFROM CAPTIONSFORTHEPHOTOS'ROANINGOVERABAD
BEINGTOOCONNECTEDTOAPARTICULARPLACE JOKEISSTILLBETTERTHANFEELINGNOTHINGATALL
0DNHWKLVWKHODVWWKLQJ\RXUHDGEHIRUH 7\SHDQGUXQWKHFRGH
EHG2UDWOHDVWWKHODVWFKDOOHQJLQJWKLQJ 4YPEANDRUNTHECODEEXAMPLES4HENYOU
0ARTOFTHELEARNINGESPECIALLYTHETRANSFER CANEXPERIMENTWITHCHANGINGANDIMPROVING
TOLONG TERMMEMORY HAPPENSAFTERYOUPUT THECODEORBREAKINGITWHICHISSOMETIMES
THEBOOKDOWN9OURBRAINNEEDSTIMEON THEBESTWAYTOlGUREOUTWHATSREALLY
ITSOWNTODOMOREPROCESSING)FYOUPUTIN HAPPENING &ORLONGEXAMPLESOR2EADY BAKE
SOMETHINGNEWDURINGTHATPROCESSING TIME CODEYOUCANDOWNLOADTHESOURCElLESFROM
SOMEOFWHATYOUJUSTLEARNEDWILLBELOST HEADlRSTJAVACOM
\RXDUHKHUH [[YLL
KRZWRXVHWKLVERRN
?PI\aW]VMMLNWZ\PQ[JWWS"
9OUDONOTNEEDANYOTHERDEVELOPMENTTOOLSUCHASAN)NTEGRATED
$EVELOPMENT%NVIRONMENT)$% 7ESTRONGLYRECOMMENDTHATYOUNOT
USEANYTHINGBUTABASICTEXTEDITORUNTILYOUCOMPLETETHISBOOKAND
ESPECIALLYNOTUNTILAFTERCHAPTER !N)$%CANPROTECTYOUFROMSOMEOF
THEDETAILSTHATREALLYMATTERSOYOUREMUCHBETTEROFFLEARNINGFROMTHE
COMMAND LINEANDTHENONCEYOUREALLYUNDERSTANDWHATSHAPPENING
MOVETOATOOLTHATAUTOMATESSOMEOFTHEPROCESS
K=LLAF?MHB9N9
,I\RXGRQ·WDOUHDG\KDYHDRUJUHDWHU-DYD6WDQGDUG(GLWLRQ6'.6RIWZDUH
'HYHORSPHQW.LW\RXQHHGLW,I\RX·UHRQ/LQX[:LQGRZVRU6RODULV\RXFDQJHWLWIRUIUHH
IURPMDYDVXQFRP6XQ·VZHEVLWHIRU-DYDGHYHORSHUV,WXVXDOO\WDNHVQRPRUHWKDQWZRFOLFNV
IURPWKHPDLQSDJHWRJHWWRWKH-6(GRZQORDGVSDJH*HWWKHODWHVWQRQEHWDYHUVLRQSRVWHG
7KH6'.LQFOXGHVHYHU\WKLQJ\RXQHHGWRFRPSLOHDQGUXQ-DYD
,I\RX·UHUXQQLQJ0DF26;WKH-DYD6'.LVDOUHDG\LQVWDOOHG,W·VSDUWRI26;DQG\RX
GRQ·WKDYHWRGRDQ\WKLQJHOVH,I\RX·UHRQDQHDUOLHUYHUVLRQRI26;\RXKDYHDQHDUOLHU
YHUVLRQRI-DYDWKDWZLOOZRUNIRURIWKHFRGHLQWKLVERRN
1RWH7KLVERRNLVEDVHGRQ-DYDEXWIRUVWXQQLQJO\XQFOHDUPDUNHWLQJUHDVRQVVKRUWO\
EHIRUHUHOHDVH6XQUHQDPHGLW-DYDZKLOHVWLOONHHSLQJ´µDVWKHYHUVLRQQXPEHUIRUWKH
GHYHORSHU·VNLW6RLI\RXVHH-DYDRU-DYDRU-DYDRU7LJHUYHUVLRQ·VRULJLQDO
FRGHQDPHWKH\DOOPHDQWKHVDPHWKLQJ7KHUHZDVQHYHUD-DYDRU³LWMXPSHGIURP
YHUVLRQWREXW\RXZLOOVWLOOILQGSODFHVZKHUHLW·VFDOOHGLQVWHDGRI'RQ
WDVN
2KDQGMXVWWRPDNHLWPRUHHQWHUWDLQLQJ-DYDDQGWKH0DF26;ZHUHERWKJLYHQWKH
VDPHFRGHQDPHRI´7LJHUµDQGVLQFH26;LVWKHYHUVLRQRIWKH0DF26\RXQHHGWRUXQ
-DYD\RX·OOKHDUSHRSOHWDONDERXW´7LJHURQ7LJHUµ,WMXVWPHDQV-DYDRQ26;
7KH6'.GRHVQRWLQFOXGHWKH$3,GRFXPHQWDWLRQDQG\RXQHHGWKDW*REDFNWRMDYDVXQ
FRPDQGJHWWKH-6($3,GRFXPHQWDWLRQ<RXFDQDOVRDFFHVVWKH$3,GRFVRQOLQHZLWKRXW
GRZQORDGLQJWKHPEXWWKDW·VDSDLQ7UXVWXVLW·VZRUWKWKHGRZQORDG
<RXQHHGDWH[WHGLWRU9LUWXDOO\DQ\WH[WHGLWRUZLOOGRYLHPDFVSLFRLQFOXGLQJWKH*8,RQHV
WKDWFRPHZLWKPRVWRSHUDWLQJV\VWHPV1RWHSDG:RUGSDG7H[W(GLWHWFDOOZRUNDVORQJDV
\RXPDNHVXUHWKH\GRQ·WDSSHQGD´W[WµRQWRWKHHQGRI\RXUVRXUFHFRGH
2QFH\RX·YHGRZQORDGHGDQGXQSDFNHG]LSSHGZKDWHYHUGHSHQGVRQZKLFKYHUVLRQDQGIRU
ZKLFK26\RXQHHGWRDGGDQHQWU\WR\RXU3$7+HQYLURQPHQWYDULDEOHWKDWSRLQWVWRWKHELQ
GLUHFWRU\LQVLGHWKHPDLQ-DYDGLUHFWRU\)RUH[DPSOHLIWKH-6'.SXWVDGLUHFWRU\RQ\RXU
GULYHFDOOHG´MVGNµORRNLQVLGHWKDWGLUHFWRU\DQG\RX·OOILQGWKHÉLQµGLUHFWRU\ZKHUHWKH
-DYDELQDULHVWKHWRROVOLYH7KDELQGLUHFWRU\LVWKHRQH\RXQHHGD3$7+WRVRWKDWZKHQ\RX
W\SH
MDYDF
DWWKHFRPPDQGOLQH\RXUWHUPLQDOZLOONQRZKRZWRILQGWKHMDYDFFRPSLOHU
1RWHLI\RXKDYHWURXEOHZLWK\RXLQVWDOODWLRQZHUHFRPPHQG\RXJRWRMDYDUDQFKFRPDQGMRLQ
WKH-DYD%HJLQQLQJIRUXP$FWXDOO\\RXVKRXOGGRWKDWZKHWKHU\RXKDYHWURXEOHRUQRW
1RWHPXFKRIWKHFRGHIURPWKLVERRNLVDYDLODEOHDWZLFNHGO\VPDUWFRP
[[YLLL LQWUR
WKHLQWUR
4I[\UQV]\M\PQVO[aW]VMML\WSVW_"
4HISISALEARNINGEXPERIENCENOTAREFERENCEBOOK7EDELIBERATELY
STRIPPEDOUTEVERYTHINGTHATMIGHTGETINTHEWAYOFLEARNINGWHATEVERIT
ISWEREWORKINGONATTHATPOINTINTHEBOOK!NDTHElRSTTIMETHROUGH
YOUNEEDTOBEGINATTHEBEGINNINGBECAUSETHEBOOKMAKESASSUMPTIONS
PSOHU
ABOUTWHATYOUVEALREADYSEENANDLEARNED :HXVHDGVLIDX[80/
PRGLILH
:HXVHVLPSOH80/OLNHGLDJUDPV 'RJ
)FWEDUSEDPURE5-,YOUDBESEEINGSOMETHINGTHATLOOKSLIKE*AVABUT
WITHSYNTAXTHATSJUSTPLAINWRONG3OWEUSEASIMPLIlEDVERSIONOF5-, VL]H
THATDOESNTCONmICTWITH*AVASYNTAX)FYOUDONTALREADYKNOW5-,YOU
WONTHAVETOWORRYABOUTLEARNING*AVAAND5-,ATTHESAMETIME EDUN
HDW
FKDVH&DW
:HGRQ·WZRUU\DERXWRUJDQL]LQJDQGSDFNDJLQJ\RXURZQ
FRGHXQWLOWKHHQGRIWKHERRN
)NTHISBOOKYOUCANGETONWITHTHEBUSINESSOFLEARNING*AVAWITHOUT
STRESSINGOVERSOMEOFTHEORGANIZATIONALORADMINISTRATIVEDETAILSOF
DEVELOPING*AVAPROGRAMS9OUWILLINTHEREALWORLDNEEDTOKNOWAND <RXVKRXOGGRSH$//
XU
USETHESEDETAILSSOWECOVERTHEMINDEPTH"UTWESAVETHEMFORTHEEND RIWKH´6K WLHVQ\R
DU
OFTHEBOOKCHAPTER 2ELAXWHILEYOUEASEINTO*AVAGENTLY SHQFLOµDFWLYL
6KDUSHQ \RXU SHQFLO
7KHHQGRIFKDSWHUH[HUFLVHVDUHPDQGDWRU\SX]]OHVDUH
RSWLRQDO$QVZHUVIRUERWKDUHDWWKHHQGRIHDFKFKDSWHU
/NETHINGYOUNEEDTOKNOWABOUTTHEPUZZLESTHEYREPUZZLES!SINLOGIC
PUZZLESBRAINTEASERSCROSSWORDPUZZLESETC4HEEXERCISESAREHERETOHELP $FWLYLWLH
YOUPRACTICEWHATYOUVELEARNEDANDYOUSHOULDDOTHEMALL4HEPUZZLES ([HUFLVHVUPXQDUNHGZLWKWKH
AREADIFFERENTSTORYANDSOMEOFTHEMAREQUITECHALLENGINGINAPUZZLE DUHPDQGDWR QLQJVKRHORJR
WKHPLI\ X·UU\'RQ·WVNLS
WAY4HESEPUZZLESAREMEANTFORPUZZLERSANDYOUPROBABLYALREADYKNOWIF
OHDUQLQJ-DRYD HVHULRXVDER
XW
YOUAREONE)FYOURENOTSUREWESUGGESTYOUGIVESOMEOFTHEMATRYBUT
WHATEVERHAPPENSDONTBEDISCOURAGEDIFYOUCANTSOLVEAPUZZLEORIFYOU
SIMPLYCANTBEBOTHEREDTOTAKETHETIMETOWORKTHEMOUT
7KH¶6KDUSHQ<RXU3HQFLO·H[HUFLVHVGRQ·WKDYHDQVZHUV
.OTPRINTEDINTHEBOOKANYWAY&ORSOMEOFTHEMTHEREISNORIGHT 1dQÔU_Q
ANSWERANDFORTHEOTHERSPARTOFTHELEARNINGEXPERIENCEFORTHE3HARPEN
ACTIVITIESISFORYOUTODECIDEIFANDWHENYOURANSWERSARERIGHT3OMEOF
OURSUGGESTEDANSWERSAREAVAILABLEONWICKEDLYSMARTCOM WKH
V H HW K H3 X]]OHORJRI\RX
,I\RX LVRSWLRQDODQGL URVV
7KHFRGHH[DPSOHVDUHDVOHDQDVSRVVLEOH DFWLYLW\ HWZLVW\ORJLFRUF HWKHVH
)TSFRUSTRATINGTOWADETHROUGHLINESOFCODELOOKINGFORTHETWOLINES GRQ·WOLN]]OHV\RXZRQ·WOLN
YOUNEEDTOUNDERSTAND-OSTEXAMPLESINTHISBOOKARESHOWNWITHINTHE ZRUGSX
SMALLESTPOSSIBLECONTEXTSOTHATTHEPARTYOURETRYINGTOLEARNISCLEARAND HLWKHU
SIMPLE3ODONTEXPECTTHECODETOBEROBUSTOREVENCOMPLETE4HATS
YOURASSIGNMENTFORAFTERYOUlNISHTHEBOOK4HEBOOKEXAMPLESARE
WRITTENSPECIlCALLYFORLEARNINGANDARENTALWAYSFULLY FUNCTIONAL
\RXDUHKHUH [[L[
WHFKHGLWLQJ-HVVLFDDQG9DOHQWLQ
<MKPVQKIT-LQ\WZ[
h#REDITGOESTOALLBUTMISTAKESARETHESOLEREPONSIBILITYOFTHE
AUTHORv$OESANYONEREALLYBELIEVETHAT3EETHETWOPEOPLEON
THISPAGE)FYOUlNDTECHNICALPROBLEMSITSPROBABLYTHEIRFAULT
9DOHQWLQ&UHWWD]
,
-HVVLFD·V0,1 -HVVLFD6DQW
9DOHQWLQ·VWLH
6ALENTIN6ALENTIN#RETTAZHASA-ASTERSDEGREE
IN)NFORMATIONAND#OMPUTER3CIENCEFROM
*ESSWORKSAT(EWLETT 0ACKARDONTHE3ELF THE3WISS&EDERAL)NSTITUTEOF4ECHNOLOGYIN
(EALING3ERVICES4EAM3HEHASA"ACHELORS ,AUSANNE%0&, (EHASWORKEDASASOFTWARE
IN#OMPUTER%NGINEERINGFROM6ILLANOVA ENGINEERWITH32))NTERNATIONAL-ENLO0ARK
5NIVERSITYHASHER3#0*AND3#7#$ #! ANDASAPRINCIPALENGINEERINTHE3OFTWARE
CERTIlCATIONSANDISLITERALLYMONTHSAWAY %NGINEERING,ABORATORYOF%0&,
FROMRECEIVINGHER-ASTERSIN3OFTWARE 6ALENTINISTHECO FOUNDERAND#4/OF#ONDRIS
%NGINEERINGAT$REXEL5NIVERSITYWHEW 4ECHNOLOGIESACOMPANYSPECIALIZINGINTHE
7HENSHESNOTWORKINGSTUDYINGOR DEVELOPMENTOFSOFTWAREARCHITECTURESOLUTIONS
MOTORINGINHER-).)#OOPER3*ESSCAN (ISRESEARCHANDDEVELOPMENTINTERESTS
BEFOUNDlGHTINGHERCATFORYARNASSHE INCLUDEASPECT ORIENTEDTECHNOLOGIESDESIGN
COMPLETESHERLATESTKNITTINGORCROCHET ANDARCHITECTURALPATTERNSWEBSERVICESAND
PROJECTANYBODYWANTAHAT 3HEIS SOFTWAREARCHITECTURE"ESIDESTAKINGCAREOF
ORIGINALLYFROM3ALT,AKE#ITY5TAHNO HISWIFEGARDENINGREADINGANDDOINGSOME
SHESNOT-ORMONYESYOUWERETOO SPORT6ALENTINMODERATESTHE3#"#$AND
GOINGTOASK ANDISCURRENTLYLIVINGNEAR 3#$*73FORUMSAT*AVARANCHCOM(EHOLDS
0HILADELPHIAWITHHERHUSBAND-ENDRAAND THE3#*03#*$3#"#$3#7#$AND3#$*73
TWOCATS#HAIAND3AKE CERTIlCATIONS(EHASALSOHADTHEOPPORTUNITY
9OUCANCATCHHERMODERATINGTECHNICAL TOSERVEASACO AUTHORFOR7HIZLABS3#"#$
FORUMSATJAVARANCHCOM %XAM3IMULATOR
7ERESTILLINSHOCKFROMSEEINGHIMINATIE
[[[ LQWUR
WKHLQWUR
FUHGLW
7\PMZXMWXTM\WJTIUM" 6RPHRIRXU-DYD
H[SHUWUHYLHZHUV
!T/2EILLY -HI&XPSV
QH
/URBIGGESTTHANKSTO-IKE,OUKIDESAT/2EILLYFORTAKINGA &RUH\0F*OR
CHANCEONTHISANDHELPINGTOSHAPETHE(EAD&IRSTCONCEPTINTO
ABOOKANDSERIES !STHISSECONDEDITIONGOESTOPRINTTHERE
ARENOWlVE(EAD&IRSTBOOKSANDHESBEENWITHUSALLTHEWAY
4O4IM/2EILLYFORHISWILLINGNESSTOLAUNCHINTOSOMETHING
COMPLETELYNEWANDDIFFERENT4HANKSTOTHECLEVER+YLE(ARTFOR
lGURINGOUTHOW(EAD&IRSTlTSINTOTHEWORLDANDFORLAUNCHING
THESERIES&INALLYTO%DIE&REEDMANFORDESIGNINGTHE(EAD&IRST
hEMPHASIZETHEHEADvCOVER -RKDQQH
VGH-RQ
/URINTREPIDBETATESTERSANDREVIEWERTEAM J
/URTOPHONORSANDTHANKSGOTOTHEDIRECTOROFOURJAVARANCH
TECHREVIEWTEAM*OHANNESDE*ONG4HISISYOURlFTHTIMEAROUND
WITHUSONA(EAD&IRSTBOOKANDWERETHRILLEDYOURESTILLSPEAKING
TOUS*EFF#UMPSISONHISTHIRDBOOKWITHUSNOWANDRELENTLESS
ABOUTlNDINGAREASWHEREWENEEDEDTOBEMORECLEARORCORRECT
#OREY-C'LONEYOUROCK!NDWETHINKYOUGIVETHECLEAREST
G
EXPLANATIONSONJAVARANCH9OULLPROBABLYNOTICEWESTOLEONEOR -DVRQ0HQDU
TWOOFTHEM*ASON-ENARDSAVEDOURTECHNICALBUTTSONMORE
7KRPDV3DXO
THANAFEWDETAILSAND4HOMAS0AULASALWAYSGAVEUSEXPERT
FEEDBACKANDFOUNDTHESUBTLE*AVAISSUESTHERESTOFUSMISSED
*ANE'RISCTIHASHER*AVACHOPSANDKNOWSATHINGORTWOABOUT
WRITING ANDITWASGREATTOHAVEHERHELPINGONTHENEWEDITION
ALONGWITHLONG TIMEJAVARANCHER"ARRY'AUNT
-ARILYNDE1UEIROZGAVEUSEXCELLENTHELPONBOTHEDITIONSOFTHE
BOOK#HRIS*ONES*OHN.YQUIST*AMES#UBETA4ERRI#UBETA
AND)RA"ECKERGAVEUSATONOFHELPONTHElRSTEDITION
3PECIALTHANKSTOAFEWOFTHE(EAD&IRSTERSWHOVEBEENHELPING 0DULO\PGH
4XHLUR]
USFROMTHEBEGINNING!NGELO#ELESTE-IKALAI:AIKINAND
4HOMAS$UFFTWDUFFCOM !NDTHANKSTOOURTERRIlCAGENT$AVID
2OGELBERGOF3TUDIO"BUTSERIOUSLYWHATABOUTTHEMOVIERIGHTS
7HUUL&XEHWD &KULV-RQHV
-DPHV&XEHWD ,UD%HFNHU -RKQ1\TXLVW
5RGQH\-
:RRGUXII
\RXDUHKHUH [[[L
VWLOOPRUHDFNQRZOHGJHPHQWV
2][\_PMVaW]\PW]OP\\PMZM_W]TLV¼\JMIVa
UWZMIKSVW_TMLOMUMV\[
-ORE*AVATECHNICALEXPERTSWHOHELPEDOUTONTHElRSTEDITIONINPSEUDO RANDOMORDER
%MIKO(ORI-ICHAEL4AUPITZ-IKE'ALLIHUGH-ANISH(ATWALNE*AMES#HEGWIDDEN
3HWETA-ATHUR-OHAMED-AZAHIM*OHN0AVERD*OSEPH"IH3KULRAT0ATANAVANICH
3UNIL0ALICHA3UDDHASATWA'HOSH2AMKI3RINIVASAN!LFRED2AOUF!NGELO#ELESTE
-IKALAI:AIKIN*OHN:OETEBIER*IM0LEGER"ARRY'AUNTAND-ARK$IELEN
4HElRSTEDITIONPUZZLETEAM
$IRK3CHRECKMANN-ARYh*AVA#ROSS#HAMPIONv,ENERS2ODNEY*7OODRUFF'AVIN"ONG
AND*ASON-ENARD*AVARANCHISLUCKYTOHAVEYOUALLHELPINGOUT
/THERCO CONSPIRATORSTOTHANK
0AUL7HEATONTHEJAVARANCH4RAIL"OSSFORSUPPORTINGTHOUSANDSOF*AVALEARNERS
3OLVEIG(AUGLANDMISTRESSOF*%%ANDAUTHOROFh$ATING$ESIGN0ATTERNSv
!UTHORS$ORI3MITHAND4OM.EGRINOBACKUPBRAINCOM FORHELPINGUSNAVIGATETHE
TECHBOOKWORLD
/UR(EAD&IRSTPARTNERSINCRIME%RIC&REEMANAND"ETH&REEMANAUTHORSOF(EAD&IRST
$ESIGN0ATTERNS FORGIVINGUSTHE"AWLS©TOlNISHTHISONTIME
3HERRY$ORRISFORTHETHINGSTHATREALLYMATTER
"RAVE%ARLY!DOPTERSOFTHE(EAD&IRSTSERIES
*OE,ITTON2OSS0'OLDBERG$OMINIC$A3ILVAHONESTPUCK$ANNY"ROMBERG3TEPHEN
,EPP%LTON(UGHES%RIC#HRISTENSEN6ULINH.GUYEN-ARK2AU!BDULHAF.ATHAN
/LIPHANT-ICHAEL"RADLY!LEX$ARROW-ICHAEL&ISCHER3ARAH.OTTINGHAM4IM!LLEN
"OB4HOMASAND-IKE"IBBYTHElRST
7KHODUJHQXPEHURIDFNQRZOHGJHPHQWVLVEHFDXVHZH¶UHWHVWLQJWKHWKHRU\WKDWHYHU\RQHPHQWLRQHGLQ
DERRNDFNQRZOHGJHPHQWZLOOEX\DWOHDVWRQHFRS\SUREDEO\PRUHZKDWZLWKUHODWLYHVDQGHYHU\WKLQJ,I
\RX¶GOLNHWREHLQWKHDFNQRZOHGJHPHQWRIRXUQH[WERRNDQG\RXKDYHDODUJHIDPLO\ZULWHWRXV
[[[LL LQWUR
GLYHLQ$4XLFN'LS
%UHDNLQJWKH6XU IDFH
&RPHRQWKHZDWHU·V
JUHDW:H·OOGLYHULJKWLQDQG
ZULWHVRPHFRGHWKHQFRPSLOHDQG
UXQLW:H·UHWDONLQJV\QWD[ORRSLQJ
DQGEUDQFKLQJDQGDORRNDWZKDW
PDNHV-DYDVRFRRO<RX·OOEH
FRGLQJLQQRWLPH
-DYDWDNHV\RXWRQHZSODFHV&ROMITSHUMBLERELEASETOTHEPUBLICASTHE
WIMPY VERSION*AVASEDUCEDPROGRAMMERSWITHITSFRIENDLYSYNTAXOBJECT ORIENTEDFEATURES
MEMORYMANAGEMENTANDBESTOFALLTHEPROMISEOFPORTABILITY4HELUREOFZULWHRQFHUXQ
DQ\ZKHUHISJUSTTOOSTRONG!DEVOTEDFOLLOWINGEXPLODEDASPROGRAMMERSFOUGHTAGAINSTBUGS
LIMITATIONSANDOHYEAHTHEFACTTHATITWASDOGSLOW"UTTHATWASAGESAGO)FYOUREJUSTSTARTINGIN
*AVA\RX·UHOXFN\3OMEOFUSHADTOWALKlVEMILESINTHESNOWUPHILLBOTHWAYSBAREFOOT TO
GETEVENTHEMOSTTRIVIALAPPLETTOWORK"UTYOUWHYYOUGETTORIDETHEVOHHNHUIDVWHUPXFK
PRUHSRZHUIXO*AVAOFTODAY
WKLVLVDQHZFKDSWHU
WKHZD\-DYDZRUNV
<PM?Ia2IÎ?WZS[
7KHJRDOLVWRZULWHRQHDSSOLFDWLRQLQWKLV
H[DPSOHDQLQWHUDFWLYHSDUW\LQYLWDWLRQDQGKDYH
LWZRUNRQZKDWHYHUGHYLFH\RXUIULHQGVKDYH
VRXUFHFRGHIRU
WKHLQWHUDFWLYH
SDUW\LQYLWDWLRQ
Licensed by 0HWKRG3DUW\
DORDGB
LQYRNHVSH
FLDO0HWKRG
MDYDODQJ2EMHFW!
Eduard Simons
UHWXUQ
;W]ZKM 7]\X]\
Qgm:]l
KWLM
104038
K`gglE]
+WUXQTMZ >QZ\]IT
#REATEASOURCE 5IKPQVM[
DOCUMENT5SEAN
4HECOMPILERCREATESA
ESTABLISHEDPROTOCOL
2UNYOURDOCUMENT NEWDOCUMENTCODED

INTHISCASETHE*AVA
THROUGHASOURCECODE INTO*AVABYTECODE
LANGUAGE 9OURFRIENDSDONTHAVE
COMPILER4HECOMPILER !NYDEVICECAPABLEOF
CHECKSFORERRORSAND RUNNING*AVAWILLBEABLE APHYSICAL*AVA-ACHINE
WONTLETYOUCOMPILE TOINTERPRETTRANSLATE BUTTHEYALLHAVEA
UNTILITSSATISlEDTHAT THISlLEINTOSOMETHING VIRTUAL*AVAMACHINE
EVERYTHINGWILLRUN ITCANRUN4HECOMPILED IMPLEMENTEDIN
CORRECTLY B
YTECODEISPLATFORM SOFTWARE RUNNINGINSIDE
INDEPENDENT THEIRELECTRONICGADGETS
4HEVIRTUALMACHINEREADS
ANDRUNSTHEBYTECODE
FKDSWHU
GLYH,Q$4XLFN'LS
?PI\aW]¼TTLWQV2IÎ
<RX·OOW\SHDVRXUFHFRGHÀOHFRPSLOHLWXVLQJWKH
MDYDFFRPSLOHUWKHQUXQWKHFRPSLOHGE\WHFRGH
RQD-DYDYLUWXDOPDFKLQH
)LOH(GLW:LQGRZ+HOS3OHDG )LOH(GLW:LQGRZ+HOS6ZHDU
LPSRUWMDYDDZW 0HWKRG3DUW\
MDYDF3DUW\MDYD MDYD3DUW\
LPSRUWMDYDDZWHYHQW DORDGB
FODVV3DUW\^
LQYRNHVSHFLDO0HWKRG
SXEOLFYRLGEXLOG,QYLWH^ MDYDODQJ2EMHFW!
)UDPHI QHZ)UDPH
UHWXUQ
/DEHOO QHZ/DEHO´3DUW\DW7LP·Vµ
%XWWRQE QHZ%XWWRQ´<RXEHWµ 0HWKRGYRLGEXLOG,QYLWH
%XWWRQF QHZ%XWWRQ´6KRRWPHµ +WUXQTMZ QHZ&ODVVMDYDDZW)UDPH!
3DQHOS QHZ3DQHO >QZ\]IT
SDGGO GXS
`PRUHFRGHKHUH LQYRNHVSHFLDO0HWKRG
5IKPQVM[
`
MDYDDZW)UDPH!
#OMPILETHE0ARTYJAVA
;W]ZKM lLEBYRUNNINGMDYDF
THECOMPILERAPPLICATION 2UNTHEPROGRAMBY
)FYOUDONTHAVEERRORS
7]\X]\ STARTINGTHE*AVA6IRTUAL
YOULLGETASECONDDOCU -ACHINE*6- WITHTHE
MENTNAMED0ARTYCLASS KWLM 0ARTYCLASSlLE4HE*6-
4YPEYOURSOURCECODE TRANSLATESTHEBYTECODE
4HECOMPILER GENERATED
3AVEAS0ARTYJAVA 0ARTYCLASSlLEISMADEUP INTOSOMETHINGTHE
UNDERLYINGPLATFORM
OFBYTECODES
#OMPILEDCODE0ARTYCLASS UNDERSTANDSANDRUNS
YOURPROGRAM
1RWHWKLVLVQRWPHDQWWREHDWXWRULDO\RX·OOEH
ZULWLQJUHDOFRGHLQDPRPHQWEXWIRUQRZZHMXVW
ZDQW\RXWRJHWDIHHOIRUKRZLWDOOILWVWRJHWKHU
\RXDUHKHUH
)^MZaJZQMNPQ[\WZaWN2IÎ
&ODVVHVLQWKH-DYDVWDQGDUGOLEUDU\

2IÎ 2IÎ 2IÎ 2IÎ

CLASSES CLASSES ^MZ[QWV[· ^M Z[QWV[IVL]X
3LOW !LITTLEFASTER CLASSES CLASSES

#UTENAMEANDLOGO -ORECAPABLEFRIENDLIER -UCHFASTER -OREPOWEREASIERTO
&UNTOUSE,OTSOF "ECOMINGVERYPOPULAR #ANSOMETIMES RUNAT DEVELOPWITH
BUGS!PPLETSARE "ETTER'5)CODE NATIVESPEEDS3ERIOUS "ESIDESADDINGMORETHANA
THE"IG4HING POWERFUL#OMESINTHREE THOUSANDADDITIONALCLASSES
mAVORS-ICRO%DITION*-% *AVAKNOWNASh4IGERv
KLVWRU\RI -DYD
FKDSWHU
3TANDARD%DITION*3% AND ADDEDMAJORCHANGESTO
%NTERPRISE%DITION*%% THELANGUAGEITSELFMAKING
"ECOMESTHELANGUAGEOF ITEASIERATLEASTINTHEORY
CHOICEFORNEWENTERPRISE FORPROGRAMMERSANDGIVING
ESPECIALLYWEB BASED AND ITNEWFEATURESTHATWERE
MOBILEAPPLICATIONS POPULARINOTHERLANGUAGES

GLYH,Q$4XLFN'LS
6KDUSHQ \RXU SHQFLO

4WWSPW_MI[aQ\
4RYTOGUESSWHATEACHLINEOFCODEISDOING
Q[\W_ZQ\M2IÎ ANSWERSAREONTHENEXTPAGE
LQWVL]H GHFODUHDQLQWHJHUYDULDEOHQDPHG¶VL]H·DQGJLYHLWWKHYDOXH

6WULQJQDPH ´)LGRµ
'RJP\'RJ QHZ'RJQDPHVL]H
[ VL]H
LI[P\'RJEDUN
ZKLOH[!^
P\'RJSOD\
`
LQW>@QXP/LVW ^`
6\VWHPRXWSULQW´+HOORµ
6\VWHPRXWSULQW´'RJ´QDPH
6WULQJQXP ´µ
LQW] ,QWHJHUSDUVH,QWQXP
WU\^
UHDG7KH)LOH´P\)LOHW[Wµ
`
FDWFK)LOH1RW)RXQG([FHSWLRQH[^
6\VWHPRXWSULQW´)LOHQRWIRXQGµ
`
Q: )SEE*AVAAND*AVABUTWASTHEREA*AVA
ONCEAGAINTHATTHECHANGESWERESODRAMATICTHATA
NEWNAMEWASNEEDEDANDMOSTDEVELOPERSAGREED SO
AND!NDWHYISIT*AVABUTNOT*AVA THEYLOOKEDATTHEOPTIONS4HENEXTNUMBERINTHENAME
SEQUENCEWOULDBEhvBUTCALLING*AVA*AVASEEMED
A:
4HEJOYSOFMARKETINGWHENTHEVERSIONOF*AVA
SHIFTEDFROMTOTHECHANGESTO*AVAWERESO
MORECONFUSINGSOTHEYDECIDEDTONAMEIT*AVATO
MATCHTHEhvINVERSIONhv
3OTHEORIGINAL*AVAWASVERSIONSTHEFIRSTOFFICIAL
DRAMATICTHATTHEMARKETERSDECIDEDWENEEDEDAWHOLE RELEASE THROUGHWEREJUSTh*AVAv6ERSIONSAND
NEWhNAMEvSOTHEYSTARTEDCALLINGIT*AVAEVENTHOUGH WEREh*AVAv!NDBEGINNINGWITHVERSION*AVAIS
THEACTUALVERSIONOF*AVAWAS"UTVERSIONSAND CALLEDh*AVAv"UTYOULLALSOSEEITCALLEDh*AVAvWITHOUT
WERESTILLCONSIDERED*AVA4HERENEVERWASA*AVAOR THEhv ANDh4IGERvITSORIGINALCODE NAME 7EHAVENO
"EGINNINGWITH*AVAVERSIONTHEMARKETERSDECIDED IDEAWHATWILLHAPPENWITHTHENEXTRELEASE
\RXDUHKHUH
ZK\-DYDLVFRRO
6KDUSHQ \RXU SHQFLO JW\`N[\
$ONTWORRYABOUTWHETHERYOUUNDERSTANDANYOFTHISYET
4WWSPW_MI[aQ\ %VERYTHINGHEREISEXPLAINEDINGREATDETAILINTHEBOOKMOST
Q[\W_ZQ\M2IÎ WITHINTHElRSTPAGES )F*AVARESEMBLESALANGUAGEYOUVE
USEDINTHEPASTSOMEOFTHISWILLBESIMPLE)FNOTDONTWORRY
ABOUTIT7ELLGETTHERE
LQWVL]H GHFODUHDQLQWHJHUYDULDEOHQDPHG¶VL]H·DQGJLYHLWWKHYDOXH

6WULQJQDPH ´)LGRµ GHFODUHDVWULQJRIFKDUDFWHUVYDULDEOHQDPHG¶QDPH·DQGJLYHLWWKHYDOXH´)LGRµ
'RJP\'RJ QHZ'RJQDPHVL]H GHFODUHDQHZ'RJYDULDEOH¶P\'RJ·DQGPDNHWKHQHZ'RJXVLQJ¶QDPH·DQG¶VL]H·
[ VL]H VXEWUDFWIURPYDOXHRI¶VL]H·DQGDVVLJQLWWRDYDULDEOHQDPHG¶[·
LI[P\'RJEDUN LI[YDOXHRILVOHVVWKDQWHOOWKHGRJWREDUNWLPHV
ZKLOH[!^ NHHSORRSLQJDVORQJDV[LVJUHDWHUWKDQ

P\'RJSOD\ WHOOWKHGRJWRSOD\ZKDWHYHU7+$7PHDQVWRDGRJ
` WKLVORRNVOLNHWKHHQGRIWKHORRSHYHU\WKLQJLQ^`LVGRQHLQWKHORRS
LQW>@QXP/LVW ^` GHFODUHDOLVWRILQWHJHUVYDULDEOH¶QXP/LVW·DQGSXWLQWRWKHOLVW

6\VWHPRXWSULQW´+HOORµ SULQWRXW´+HOORµSUREDEO\DWWKHFRPPDQGOLQH
6\VWHPRXWSULQW´'RJ´QDPH SULQWRXW´+HOOR)LGRµWKHYDOXHRI¶QDPH·LV´)LGRµDWWKHFRPPDQGOLQH
6WULQJQXP ´µ GHFODUHDFKDUDFWHUVWULQJYDULDEOH¶QXP·DQGJLYHLWWKHYDOXHRI´µ
LQW] ,QWHJHUSDUVH,QWQXP FRQYHUWWKHVWULQJRIFKDUDFWHUV´µLQWRDQDFWXDOQXPHULFYDOXH
WU\^ WU\WRGRVRPHWKLQJPD\EHWKHWKLQJZH·UHWU\LQJLVQ·WJXDUDQWHHGWRZRUN
UHDG7KH)LOH´P\)LOHW[Wµ UHDGDWH[WILOHQDPHG´P\)LOHW[WµRUDWOHDVW75<WRUHDGWKHILOH
` PXVWEHWKHHQGRIWKH´WKLQJVWRWU\µVR,JXHVV\RXFRXOGWU\PDQ\WKLQJV
FDWFK)LOH1RW)RXQG([FHSWLRQH[^ WKLVPXVWEHZKHUH\RXILQGRXWLIWKHWKLQJ\RXWULHGGLGQ·WZRUN
6\VWHPRXWSULQW´)LOHQRWIRXQGµ LIWKHWKLQJZHWULHGIDLOHGSULQW´)LOHQRWIRXQGµRXWDWWKHFRPPDQGOLQH
` ORRNVOLNHHYHU\WKLQJLQWKH^`LVZKDWWRGRLIWKH¶WU\·GLGQ·WZRUN
FKDSWHU
GLYH,Q$4XLFN'LS
+WLM[\Z]K\]ZMQV2IÎ
SXEOLFFODVV'RJ^
:KDWJRHVLQD
VRXUFHILOH"
!SOURCECODElLEWITHTHEJAVA
EXTENSION HOLDSONECLASSDElNI
TION4HECLASSREPRESENTSAPIECE
OFYOURPROGRAMALTHOUGHAVERY
TINYAPPLICATIONMIGHTNEEDJUST
ASINGLECLASS4HECLASSMUSTGO
WITHINAPAIROFCURLYBRACES ` KTI[[
3XWDFODVVLQDVRXUFHÀOH :KDWJRHVLQD SXEOLFFODVV'RJ^

FODVV" YRLGEDUN^
3XWPHWKRGVLQDFODVV
!CLASSHASONEORMOREMETHODS
)NTHE$OGCLASSTHEBARKMETHOD
3XWVWDWHPHQWVLQDPHWKRG WILLHOLDINSTRUCTIONSFORHOWTHE
$OGSHOULDBARK9OURMETHODS
`
MUSTBEDECLAREDINSIDEACLASS
INOTHERWORDSWITHINTHECURLY `
BRACESOFTHECLASS UM\PWL
SXEOLFFODVV'RJ^
:KDWJRHVLQD
YRLGEDUN^
PHWKRG"
VWDWHPHQW
7ITHINTHECURLYBRACESOFA
METHODWRITEYOURINSTRUCTIONS VWDWHPHQW
FORHOWTHATMETHODSHOULDBE `
PERFORMED-ETHODCODEISBASI
CALLYASETOFSTATEMENTSANDFOR `
NOWYOUCANTHINKOFAMETHOD [\I\MUMV\[
KINDOFLIKEAFUNCTIONORPROCE
DURE
\RXDUHKHUH
D-DYDFODVV
)VI\WUaWNIKTI[[
7HENTHE*6-STARTSRUNNINGITLOOKSFORTHECLASSYOUGIVEITATTHECOM
MANDLINE4HENITSTARTSLOOKINGFORASPECIALLY WRITTENMETHODTHATLOOKS
EXACTLYLIKE
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^
\RXUFRGHJRHVKHUH
`
.EXTTHE*6-RUNSEVERYTHINGBETWEENTHECURLYBRACES[]OFYOURMAIN
METHOD%VERY*AVAAPPLICATIONHASTOHAVEATLEASTONECLASSANDATLEAST
ONEMAINMETHODNOTONEMAINPERCLASSJUSTONEMAINPERAPPLICATION
WKLVLVD WKHQDPHRI RSHQLQJFXUO\EUDFH

SXEOLFVRHYHU\RQH FODVVGXK WKLVFODVV RIWKHFODVV
FDQDFFHVVLW
SXEOLFFODVV0\)LUVW$SS^ DUJXPHQWVWRWKHPHWKRG
7KLVPHWKRGPXVWEHJLYHQ
WKHUHWXUQW\SH DQDUUD\RI LQJVDQGWKH
ZH·OOFRYHUWKLV YRLGPHDQVWKHUH·V WKHQDPHRI DUUD\ZLOOEHF6WU
DOOHG¶DUJV· RSHQ
RQHODWHU QRUHWXUQYDOXH WKLVPHWKRG LQJ
RIWKH EUDFH
PHWKRG
6\VWHPRXWSULQW³,5XOH´ HQW0867

HYHU\VWDWHP RQ
RO
HQGLQDVHPLF
WKLVVD\VSULQWWRVWDQGDUGRXWSXW WKH6WULQJ\RX
GHIDXOWVWRFRPPDQGOLQH
ZDQWWRSULQW
` FORVLQJEUDFHRIWKHPDLQPHWKRG
`
FORVLQJEUDFHRIWKH0\)LUVW$SSFODVV
'RQ·WZRUU\DERXWPHPRUL]LQJDQ\WKLQJULJKWQRZ
WKLVFKDSWHULVMXVWWRJHW\RXVWDUWHG
FKDSWHU
GLYH,Q$4XLFN'LS
?ZQ\QVOIKTI[[_Q\PIUIQV
)N*AVAEVERYTHINGGOESINACLASS9OULLTYPEYOURSOURCECODElLEWITHA
JAVAEXTENSION THENCOMPILEITINTOANEWCLASSlLEWITHACLASSEXTENSION
7HENYOURUNYOURPROGRAMYOUREREALLYRUNNINGACLASS
2UNNINGAPROGRAMMEANSTELLINGTHE*AVA6IRTUAL-ACHINE*6- TOh,OADTHE
+HOORCLASSTHENSTARTEXECUTINGITSPDLQMETHOD+EEPRUNNING@TILALLTHE
CODEINMAINISlNISHEDv
)NCHAPTERWEGODEEPERINTOTHEWHOLECLASSTHINGBUTFORNOWALLYOUNEEDTO
THINKISHOWDO)WRITE*AVACODESOTHATITWILLRUN!NDITALLBEGINSWITHMAIN
4HEMAIN METHODISWHEREYOURPROGRAMSTARTSRUNNING
.OMATTERHOWBIGYOURPROGRAMISINOTHERWORDSNOMATTERHOWMANYCLASSES
YOURPROGRAMUSES THERESGOTTOBEAMAIN METHODTOGETTHEBALLROLLING
SXEOLFFODVV0\)LUVW$SS^ N6DYH

SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ 0\)LUVW$SSMDYD
SXEOLFFODVV0\)LUVW$SS^
6\VWHPRXWSULQWOQ³,5XOH´
SXEOLFVWDWLFYRLGPDLQ
6WULQJ>@DUJV^ 6\VWHPRXWSULQWOQ³7KH:RUOG´
`
N&RPSLOH
6\VWHPRXWSULQW´,5XOHµ
`

`
` MDYDF0\)LUVW$SSMDYD
0\)LUVW$SSMDYD
FRPSLOHU N5XQ

)LOH(GLW:LQGRZ+HOS6FUHDP
0HWKRG3DUW\DORDGB
MDYD0\)LUVW$SS
LQYRNHVSHFLDO0HWKRG
MDYDODQJ2EMHFW!
UHWXUQ
,5XOH
0HWKRGYRLG
PDLQMDYDODQJ6WULQJ>@ 7KH:RUOG
JHWVWDWLF)LHOG
0\)LUVW$SSFODVV
\RXDUHKHUH
VWDWHPHQWVORRSLQJEUDQFKLQJ
ORRSV
?PI\KIVaW][IaQV\PMUIQVUM\PWL' V
H PHQW EUDQFKLQJ
/NCEYOUREINSIDEMAINORANYMETHOD THEFUN VWDW
BEGINS9OUCANSAYALLTHENORMALTHINGSTHATYOUSAY
INMOSTPROGRAMMINGLANGUAGESTOMAKETHECOMPUTER
DOSOMETHING
9OURCODECANTELLTHE*6-TO
LW[WUM\PQVO
3TATEMENTSDECLARATIONSASSIGNMENTS
METHODCALLSETC
LQW[
6WULQJQDPH ³'LUN´
[ [
6\VWHPRXWSULQW³[LV´[
GRXEOHG 0DWKUDQGRP 6\QWD[
WKLVLVDFRPPHQW
)XQ
LW[WUM\PQVOIOIQVIVLIOIQV
,OOPSFORANDWHILE
ZKLOH[
!^
[ [
`
%ACHSTATEMENTMUSTENDINA
SEMICOLON
[ [
IRULQW[ [[ [^
6\VWHPRXWSULQW³[LVQRZ´[
` !SINGLE LINECOMMENTBEGINS
WITHTWOFORWARDSLASHES
[
LW[WUM\PQVO]VLMZ\PQ[KWVLQ\QWV WKLVOLQHGLVWXUEVPH
"RANCHINGIFELSETESTS
LI[ ^ -OSTWHITESPACEDOESNTMATTER
6\VWHPRXWSULQW³[PXVWEH´ [
`HOVH^
6\VWHPRXWSULQW³[LVQ¶W´ 6ARIABLESAREDECLAREDWITHA
NAMEANDATYPEYOULLLEARNABOUT
`
LI[ QDPHHTXDOV³'LUN´^ ALLTHE*AVATYPESINCHAPTER
6\VWHPRXWSULQWOQ³*HQWO\´ LQWZHLJKW
` W\SHLQWQDPHZHLJKW
6\VWHPRXWSULQW³WKLVOLQHUXQVQRPDWWHUZKDW´
#LASSESANDMETHODSMUSTBE
DEFINEDWITHINAPAIROFCURLYBRACES
SXEOLFYRLGJR^
DPD]LQJFRGHKHUH
`
FKDSWHU
GLYH,Q$4XLFN'LS
ZKLOHPRUH%DOOV WUXH^

NHHS-XJJOLQJ
`
;QUXTMJWWTMIV\M[\[
9OUCANDOASIMPLEBOOLEANTESTBYCHECKING
4WWXQVOIVLTWWXQVOIVL THEVALUEOFAVARIABLEUSINGACOMPARISONOPERATOR
INCLUDING
*AVAHASTHREESTANDARDLOOPINGCONSTRUCTSWHILE
DO WHILEANDFOR9OULLGETTHEFULLLOOPSCOOPLATER LESSTHAN
INTHEBOOKBUTNOTFORAWHILESOLETSDOWHILEFOR
GREATERTHAN
NOW
4HESYNTAXNOTTOMENTIONLOGIC ISSOSIMPLE EQUALITY YESTHATSTWOEQUALSSIGNS
YOUREPROBABLYASLEEPALREADY!SLONGASSOME .OTICETHEDIFFERENCEBETWEENTHEASSIGNMENT
CONDITIONISTRUEYOUDOEVERYTHINGINSIDETHE OPERATORASINGLEEQUALSSIGN ANDTHEEQUALS
LOOPBLOCK4HELOOPBLOCKISBOUNDEDBYAPAIROF OPERATORTWOEQUALSSIGNS ,OTSOFPROGRAMMERS
CURLYBRACESSOWHATEVERYOUWANTTOREPEATNEEDS ACCIDENTALLYTYPEWHENTHEYWANT"UTNOT
TOBEINSIDETHATBLOCK YOU
4HEKEYTOALOOPISTHECONDITIONALTEST)N*AVAA LQW[ DVVLJQWR[
CONDITIONALTESTISANEXPRESSIONTHATRESULTSINA ZKLOH[!^
BOOLEANVALUEINOTHERWORDSSOMETHINGTHATIS ORRSFRGHZLOOUXQEHFDXVH
EITHERTRUEORFALSE
[LVJUHDWHUWKDQ
)FYOUSAYSOMETHINGLIKEh7HILEICE#REAM)N4HE4UB [ [RUZH¶GORRSIRUHYHU
ISTRUEKEEPSCOOPINGvYOUHAVEACLEARBOOLEAN `
TEST4HEREEITHERISICECREAMINTHETUBORTHERE LQW]
ISNT"UTIFYOUWERETOSAYh7HILE"OBKEEP
ZKLOH] ^
SCOOPINGvYOUDONTHAVEAREALTEST4OMAKE
ORRSFRGHZLOOQRWUXQEHFDXVH
THATWORKYOUDHAVETOCHANGEITTOSOMETHING
]LVQRWHTXDOWR
LIKEh7HILE"OBISSNORINGvORh7HILE"OBISNOT
WEARINGPLAIDv `
\RXDUHKHUH
-DYDEDVLFV
WKHUH DUH QR
'XPE 4XHVWLRQV -ÌUXTMWNIZKLOHTWWX
Q: 7HYDOESEVERYTHINGHAVE
SXEOLFFODVV/RRS\^
TOBEINACLASS
LQW[
A: *AVAISANOBJECT ORIENTED
// LANGUAGE)TSNOTLIKETHE
6\VWHPRXWSULQWOQ³%HIRUHWKH/RRS´
ZKLOH[^
6\VWHPRXWSULQWOQ³,QWKHORRS´
OLDDAYSWHENYOUHADSTEAM
6\VWHPRXWSULQWOQ³9DOXHRI[LV´[
DRIVENCOMPILERSANDWROTEONE
MONOLITHICSOURCEFILEWITHAPILE [ [
OFPROCEDURES)NCHAPTERYOULL `
LEARNTHATACLASSISABLUEPRINTFOR 6\VWHPRXWSULQWOQ³7KLVLVDIWHUWKHORRS´
ANOBJECTANDTHATNEARLYEVERY
Licensed by
`
THINGIN*AVAISANOBJECT
`
WKLVLVW
Q: $O)HAVETOPUTAMAININ
EVERYCLASS)WRITE
MDYD/RRS\ KHRXWS
XW
%HIRUHWKH/RRS
Eduard Simons
,QWKHORRS
A: .OPE!*AVAPROGRAM
9DOXHRI[LV
,QWKHORRS
MIGHTUSEDOZENSOFCLASSESEVEN
HUNDREDS BUTYOUMIGHTONLY 9DOXHRI[LV
104038
HAVEONEWITHAMAINMETHOD ,QWKHORRS
THEONETHATSTARTSTHEPROGRAM 9DOXHRI[LV
RUNNING9OUMIGHTWRITETEST
7KLVLVDIWHUWKHORRS
CLASSESTHOUGHTHATHAVEMAIN
METHODSFORTESTINGYOUROTHER
CLASSES
Q: )NMYOTHERLANGUAGE)CAN
:MDD=LHGAFLK
6WDWHPHQWVHQGLQDVHPLFRORQ
DOABOOLEANTESTONANINTEGER
)N*AVACAN)SAYSOMETHINGLIKE
&RGHEORFNVDUHGHILQHGE\DSDLURIFXUO\EUDFHV^`
LQW[
'HFODUHDQLQWYDULDEOHZLWKDQDPHDQGDW\SHLQW[
ZKLOH[^`
7KHDVVLJQPHQWRSHUDWRULVRQHHTXDOVVLJQ
A: .O!BOOLEANANDAN 7KHHTXDOVRSHUDWRUXVHVWZRHTXDOVVLJQV
INTEGERARENOTCOMPATIBLETYPESIN
*AVA3INCETHERESULTOFACONDI
$ZKLOHORRSUXQVHYHU\WKLQJZLWKLQLWVEORFNGHILQHGE\FXUO\
TIONALTESTMUSTBEABOOLEANTHE
EUDFHVDVORQJDVWKHFRQGLWLRQDOWHVWLVWUXH
ONLYVARIABLEYOUCANDIRECTLYTEST ,IWKHFRQGLWLRQDOWHVWLVIDOVHWKHZKLOHORRSFRGHEORFNZRQ·W
WITHOUTUSINGACOMPARISONOP
UXQDQGH[HFXWLRQZLOOPRYHGRZQWRWKHFRGHLPPHGLDWHO\
ERATOR ISABOOLEAN&OREXAMPLE
YOUCANSAY
DIWHUWKHORRSEORFN
ERROHDQLV+RW WUXH 3XWDERROHDQWHVWLQVLGHSDUHQWKHVHV

ZKLOHLV+RW^`
ZKLOH[ ^`
FKDSWHU
GLYH,Q$4XLFN'LS
+WVLQ\QWVITJZIVKPQVO ;a[\MUW]\XZQV\^[
)N*AVAANIFTESTISBASICALLYTHESAMEASTHEBOOLEANTESTINA
WHILELOOPnEXCEPTINSTEADOFSAYINGhWHILETHERESSTILLBEERv ;a[\MUW]\XZQV\TV
YOULLSAYhIFTHERESSTILLBEERv )FYOUVEBEENPAYINGATTENTIONOF
COURSEYOUHAVE THENYOUVENOTICEDUS
FODVV,I7HVW^ SWITCHINGBETWEENPRINTANDPRINTLN
$IDYOUSPOTTHEDIFFERENCE
LQW[
3YSTEMOUTPRINTLNINSERTSANEWLINE
LI[ ^
THINKOFPRINTLNASPRINTNEWLINEWHILE
6\VWHPRXWSULQWOQ³[PXVWEH´ 3YSTEMOUTPRINTKEEPSPRINTINGTO
` THESAMELINE)FYOUWANTEACHTHING
6\VWHPRXWSULQWOQ³7KLVUXQVQRPDWWHUZKDW´ YOUPRINTOUTTOBEONITSOWNLINEUSE
` PRINTLN)FYOUWANTEVERYTHINGTOSTICK
TOGETHERONONELINEUSEPRINT
`
FRGHRXW
MDYD,I7HVW SXW
[PXVWEH 6KDUSHQ \RXU SHQFLO
7KLVUXQVQRPDWWHUZKDW
'IVENTHEOUTPUT
4HECODEABOVEEXECUTESTHELINETHATPRINTShXMUSTBEvONLY
IFTHECONDITIONXISEQUALTO ISTRUE2EGARDLESSOFWHETHER MDYD'RR%HH
ITSTRUETHOUGHTHELINETHATPRINTSh4HISRUNSNOMATTERWHATv 'RR%HH'RR%HH'R
WILLRUN3ODEPENDINGONTHEVALUEOFXEITHERONESTATEMENT
ORTWOWILLPRINTOUT &ILLINTHEMISSINGCODE
"UTWECANADDANELSETOTHECONDITIONSOTHATWECAN PUBLICCLASS$OO"EE[

SAYSOMETHINGLIKEh)FTHERESSTILLBEERKEEPCODINGELSE
PUBLICSTATICVOIDMAIN3TRING;=ARGS [
OTHERWISE GETMOREBEERANDTHENCONTINUEONv
INTX
FODVV,I7HVW^ WHILEX????? [
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ 3YSTEMOUT?????????h$OOv
LQW[
3YSTEMOUT?????????h"EEv
LI[ ^
XX
6\VWHPRXWSULQWOQ³[PXVWEH´
`HOVH^ ]
6\VWHPRXWSULQWOQ³[LV127´ IFX?????? [
` 3YSTEMOUTPRINTh$Ov
6\VWHPRXWSULQWOQ³7KLVUXQVQRPDWWHUZKDW´ ]
`
]
`
]
QHZRXWSXW
MDYD,I7HVW
[LV127
7KLVUXQVQRPDWWHUZKDW
\RXDUHKHUH
VHULRXV-DYDDSS
+WLQVOI;MZQW][*][QVM[[
)XXTQKI\QWV
,ETSPUTALLYOURNEW*AVASKILLSTOGOODUSEWITH
SOMETHINGPRACTICAL7ENEEDACLASSWITHAMAIN ANINT
ANDA3TRINGVARIABLEAWHILELOOPANDANIFTEST!LITTLE
MOREPOLISHANDYOULLBEBUILDINGTHATBUSINESSBACK
ENDINNOTIME"UTBEFOREYOULOOKATTHECODEONTHIS
PAGETHINKFORAMOMENTABOUTHOWYOUWOULDCODETHAT
CLASSICCHILDRENSFAVORITEhBOTTLESOFBEERv
SXEOLFFODVV%HHU6RQJ^
LQWEHHU1XP
6WULQJZRUG ³ERWWOHV´
ZKLOHEHHU1XP!^
LIEHHU1XP ^
ZRUG ³ERWWOH´VLQJXODUDVLQ21(ERWWOH
`
6\VWHPRXWSULQWOQEHHU1XP³´ZRUG³RIEHHURQWKHZDOO´
6\VWHPRXWSULQWOQEHHU1XP³´ZRUG³RIEHHU´
6\VWHPRXWSULQWOQ³7DNHRQHGRZQ´
6\VWHPRXWSULQWOQ³3DVVLWDURXQG´
EHHU1XP EHHU1XP
LIEHHU1XP!^
6\VWHPRXWSULQWOQEHHU1XP³´ZRUG³RIEHHURQWKHZDOO´
`HOVH^
6\VWHPRXWSULQWOQ³1RPRUHERWWOHVRIEHHURQWKHZDOO´
`HQGHOVH
`HQGZKLOHORRS
`HQGPDLQPHWKRG
`HQGFODVV
4HERESSTILLONELITTLEFLAWINOUR
CODE)TCOMPILESANDRUNSBUTTHE
OUTPUTISNTPERFECT3EEIF
YOUCANSPOTTHEFLAWANDFIXIT
FKDSWHU
GLYH,Q$4XLFN'LS
5WVLIaUWZVQVOI\*WJ¼[
*WJ¼[ITIZUKTWKSZQVO[I\ "5WVLIaUWZVQVOR][\TQSMM^MZaW\PMZ_MMSLIa -DYDLQVLGH
*]\*WJPILI_QTL_MMSMVLIVLZMIKPM[NWZ\PM;677B-J]\\WV
)VL\PI\¼[_PMV\PMIK\QWV[\IZ\[IVL\PM2IÎMVIJTMLIXXTQIVKM[
KWUM\WTQNM
.QZ[\\PMITIZUKTWKS[MVL[IUM[[IOM\W\PMKWNNMMUISMZ¹0Ma\PMOMMS¼[
[TMMXQVOQVIOIQVLMTIa\PMKWNNMMUQV]\M[º
<PMKWNNMMUISMZ[MVL[IUM[[IOM\W\PM5W\WZWTI -DYDKHUHWRR
\WI[\MZ¹0WTL\PM\WI[\*WJ¼[[VWWbQVOº
<PMITIZUKTWKS\PMV[MVL[IUM[[IOM\W*WJ¼[
6WSQI6I^QOI\WZKMTTXPWVM¹+ITT*WJ¼[!
W¼KTWKSIVL\MTTPQU_M¼ZMZ]VVQVOITQ\\TMTI\Mº
.QVITTa\PMITIZUKTWKS[MVL[IUM[[IOM\W OODU
-DYD ;IU¼[;IUQ[\PMLWO_QZMTM[[KWTTIZ_Q\P\PM\WWNIUQTQIZ[QOVIT\PI\ 6DP·VFYRD
WRDVWHU UMIV[¹/M\\PMXIXMZJ]\LWV¼\M`XMK\I_ITSº KDV-D
)NM_UQV]\M[TI\MZ\PMITIZUOWM[WNN IOIQV)VLIOIQV*WJ
PQ\[;677B-IVL\PMIXXTQIVKM[[\IZ\KPI\\MZQVO.QVITTa
\PMITIZUZQVO[I\PQZL\QUM*]\R][\I[*WJZMIKPM[NWZ\PM
[VWWbMJ]\\WV\PMKTWKS[MVL[\PM¹R]UXIVLJIZSº[QOVIT\W;IU¼[
KWTTIZ;PWKSML\WN]TTKWV[KQW][VM[[*WJZQ[M[OZI\MN]T\PI\PQ[2IÎ
[SQTT[IVLITQ\\TM\ZQX\W:ILQW;PIKSPI^MMVPIVKML\PMLIQTa
ZW]\QVM[WN PQ[TQNM
EXWWHUKHUH
0Q[\WI[\Q[\WI[\ML
0Q[KWNNMM[\MIU[
0Q[XIXMZI_IQ\[
2][\IVW\PMZ_WVLMZN]TUWZVQVOQV<PM2IÎ-VIJTML0W][M
AW]KIVPI^MI2IÎMVIJTMLPWUM;\QKS_Q\PI[MV[QJTM[WT]\QWV][QVO2IÎ
-\PMZVM\IVL2QVQ\MKPVWTWOa*M_IZMWN QUQ\I\QWV[][QVOW\PMZ[WKITTML¹XT]O
IVLXTIaº_PQKPIK\]ITTaUMIV[¹XT]OIVLXTIa_Q\PQ\NWZ\PMVM`\\PZMMLIa[
\ZaQVO\WOM\Q\\W_WZSºWZ¹XWZ\IJTMºXTI\NWZU[*WJ¼[[Q[\MZ*M\\a\ZQMLWVMWN $6 ,
) 21
\PW[MW\PMZ[IVL\PMZM[]T\[_MZM_MTTVW\^MZaIXXMITQVOWZ[INM
*Q\WN I[PIUMIJW]\PMZLWO\WW 79
#OULDTHISSTORYBETRUE9ESANDNO7HILETHEREAREVERSIONSOF*AVARUNNINGINDE
VICESINCLUDING0$!SCELLPHONESESPECIALLYCELLPHONES PAGERSRINGSSMARTCARDS
ANDMOREnYOUMIGHTNOTFINDA*AVATOASTERORDOGCOLLAR"UTEVENIFYOUCANT
FINDA*AVA ENABLEDVERSIONOFYOURFAVORITEGADGETYOUCANSTILLRUNITASIFITWEREA
*AVADEVICEBYCONTROLLINGITTHROUGHSOMEOTHERINTERFACESAYYOURLAPTOP THATIS
RUNNING*AVA4HISISKNOWNASTHE*INISURROGATEARCHITECTURE9ESYOUCANHAVETHAT
GEEKDREAMHOME

)0MULTICASTIFYOUREGONNABEALLPICKYABOUTPROTOCOL
\RXDUHKHUH
OHW·VZULWHDSURJUDP
7U\P\QHZ
SKUDVHRPDWLFDQG
\RX·OOEHDVOLFNWDONHU
MXVWOLNHWKHERVVRU
WKRVHJX\VLQPDUNHWLQJ
SXEOLFFODVV3KUDVH20DWLF^
''eYc]l`j]]k]lkgôgj\klg[`ggk]^jge&9\\qgmjgof
6WULQJ>@ZRUG/LVW2QH ^³´´PXOWL
7LHU´ÍRRW´´%WR%´´ZLQZLQ´ÍURQW
HQG´³ZHEEDVHG´´SHUYDVLYH´³VPDUW´³VL[
VLJPD´´FULWLFDOSDWK´³G\QDPLF´`
6WULQJ>@ZRUG/LVW7ZR ^³HPSRZHUHG´³VWLFN\´
³YDOXHDGGHG´³RULHQWHG´³FHQWULF´³GLVWULEXWHG´
³FOXVWHUHG´³EUDQGHG´´RXWVLGHWKHER[´³SRVLWLRQHG´
³QHWZRUNHG´³IRFXVHG´³OHYHUDJHG´³DOLJQHG´
³WDUJHWHG´³VKDUHG´³FRRSHUDWLYH´³DFFHOHUDWHG´`
6WULQJ>@ZRUG/LVW7KUHH ^³SURFHVV´³WLSSLQJ
/+SOTHEBEERSONGWASNTREALLYASERIOUS
BUSINESSAPPLICATION3TILLNEEDSOMETHING SRLQW´³VROXWLRQ´³DUFKLWHFWXUH´³FRUHFRPSHWHQF\´
PRACTICALTOSHOWTHEBOSS#HECKOUTTHE ³VWUDWHJ\´³PLQGVKDUH´³SRUWDO´³VSDFH´³YLVLRQ´
0HRASE / -ATICCODE ³SDUDGLJP´³PLVVLRQ´`
''Úf\gml`goeYfqogj\kYj]af]Y[`dakl
LQWRQH/HQJWK ZRUG/LVW2QHOHQJWK
LQWWZR/HQJWK ZRUG/LVW7ZROHQJWK
QRWHZKHQ\ LQWWKUHH/HQJWK ZRUG/LVW7KUHHOHQJWK
WKHFRGHGR RXW\SHWKLVLQWRDQHG
1HYHUKLWWKLWVRZQZRUGOLQHZUDSLWRUOHW ''_]f]jYl]l`j]]jYf\gefmeZ]jk
LQWUDQG
D6WULQJDWHUHWXUQNH\ZKHQ\RX·UHSLQJ LQW0DWKUDQGRP RQH/HQJWK
ZRQ·WFRPSLO KLQJEHWZHHQ´TXRWHVµ W\SLQJ LQWUDQG LQW0DWKUDQGRP WZR/HQJWK
WKLVSDJHDUHH6RWKHK\SKHQV\RXVHRULW LQWUDQG LQW0DWKUDQGRP WKUHH/HQJWK
EXWGRQ·WKLW UHDODQG\RXFDQW\SHHRQ
\RX·YHFORVHG WKHUHWXUQNH\XQWLO$ WKHP ''fgoZmad\Yh`jYk]
D6WULQJ )7(5 6WULQJSKUDVH ZRUG/LVW2QH>UDQG@³³
ZRUG/LVW7ZR>UDQG@³³ZRUG/LVW7KUHH>UDQG@
''hjaflgmll`]h`jYk]
6\VWHPRXWSULQWOQ³:KDWZHQHHGLVD³SKUDVH
`
`
FKDSWHU
GLYH,Q$4XLFN'LS
8PZI[M75I\QK
0W_Q\_WZS[
)NANUTSHELLTHEPROGRAMMAKESTHREELISTSOFWORDSTHENRANDOMLYPICKSONEWORD
FROMEACHOFTHETHREELISTSANDPRINTSOUTTHERESULT$ONTWORRYIFYOUDONTUNDER
STANDEXACTLYWHATSHAPPENINGINEACHLINE&ORGOSHSAKESYOUVEGOTTHEWHOLEBOOK
AHEADOFYOUSORELAX4HISISJUSTAQUICKLOOKFROMAFOOTOUTSIDE THE BOX
TARGETEDLEVERAGEDPARADIGM
1. 4HElRSTSTEPISTOCREATETHREE3TRINGARRAYSnTHECONTAINERSTHATWILLHOLDALLTHE
WORDS$ECLARINGANDCREATINGANARRAYISEASYHERESASMALLONE
6WULQJ>@SHWV ^³)LGR´³=HXV´³%LQ´`
%ACHWORDISINQUOTESASALLGOOD3TRINGSMUSTBE ANDSEPARATEDBYCOMMAS
2. &OREACHOFTHETHREELISTSARRAYS THEGOALISTOPICKARANDOMWORDSOWEHAVE

TOKNOWHOWMANYWORDSAREINEACHLIST)FTHEREAREWORDSINALISTTHENWENEED
ARANDOMNUMBERBETWEENAND*AVAARRAYSAREZERO BASEDSOTHElRSTWORDISAT
ZKDWZHQHHG
POSITIONTHESECONDWORDPOSITIONANDTHELASTWORDISPOSITIONINA ELEMENT
KHUHLVD
ARRAY 1UITEHANDILYA*AVAARRAYISMORETHANHAPPYTOTELLYOUITSLENGTH9OUJUST
HAVETOASK)NTHEPETSARRAYWEDSAY
LQW[ SHWVOHQJWK SHUYDVLYHWDUJHWHG
AND[WOULDNOWHOLDTHEVALUE SURFHVV
3.7ENEEDTHREERANDOMNUMBERS*AVASHIPSOUT OF THE BOXOFF THE SHELFSHRINK

WRAPPEDANDCORECOMPETENTWITHASETOFMATHMETHODSFORNOWTHINKOFTHEMAS
G\QDPLFRXWVLGH
WKHER[WLSSLQJ
SRLQW
FUNCTIONS 4HEUDQGRPMETHODRETURNSARANDOMNUMBERBETWEENANDNOT
QUITE SOWEHAVETOMULTIPLYITBYTHENUMBEROFELEMENTSTHEARRAYLENGTH INTHE
LISTWEREUSING7EHAVETOFORCETHERESULTTOBEANINTEGERNODECIMALSALLOWED SO VPDUWGLVWULEXWHG
WEPUTINACASTYOULLGETTHEDETAILSINCHAPTER )TSTHESAMEASIFWEHADANYmOAT FRUHFRPSHWHQF\
INGPOINTNUMBERTHATWEWANTEDTOCONVERTTOANINTEGER
LQW[ LQW
HPSRZHUHG
PLQGVKDUH
4. .OWWEGETTOBUILDTHEPHRASEBYPICKINGAWORDFROMEACHOFTHETHREELISTS
ANDSMOOSHINGTHEMTOGETHERALSOINSERTINGSPACESBETWEENWORDS 7EUSETHEhv
OPERATORWHICHCONCATENATESWEPREFERTHEMORETECHNICAL@SMOOSHES THE3TRINGOBJECTS IRRWZLQZLQ
YLVLRQ
TOGETHER4OGETANELEMENTFROMANARRAYYOUGIVETHEARRAYTHEINDEXNUMBERPOSI
TION OFTHETHINGYOUWANTUSING
6WULQJV SHWV>@VLVQRZWKH6WULQJ³)LGR´ VL[VLJPDQHW
V V³³³LVDGRJ´VLVQRZ³)LGRLVDGRJ´ ZRUNHGSRUWDO
5.&INALLYWEPRINTTHEPHRASETOTHECOMMAND LINEANDVOILA7EREINMARKETING

\RXDUHKHUH
WKHFRPSLOHUDQGWKH-90
<WVQOP\¼[<ITS"<PMKWUXQTMZIVL
\PM2>5JI\\TMW^MZ\PMY]M[\QWV
¹?PW¼[UWZMQUXWZ\IV\'º
<PM2IÎ>QZ\]IT5IKPQVM <PM+WUXQTMZ
7HATAREYOUKIDDING(%,,/)AM*AVA
)MTHEGUYWHOACTUALLYMAKESAPROGRAM
RUN4HECOMPILERJUSTGIVESYOUAlLE4HATS
IT*USTAlLE9OUCANPRINTITOUTANDUSEIT
FORWALLPAPERKINDLINGLININGTHEBIRDCAGE
WHATEVERBUTTHElLEDOESNTDOANYTHINGUN
LESS)MTHERETORUNIT
)DONTAPPRECIATETHATTONE
!NDTHATSANOTHERTHINGTHECOMPILERHAS
NOSENSEOFHUMOR4HENAGAINIFYOUHADTO
SPENDALLDAYCHECKINGNIT PICKYLITTLESYNTAX
VIOLATIONS %XCUSEMEBUTWITHOUTMEWHATEXACTLY
WOULDYOURUN4HERESAREASON*AVAWAS
DESIGNEDTOUSEABYTECODECOMPILERFORYOUR
INFORMATION)F*AVAWEREAPURELYINTERPRETED
LANGUAGEWHEREATRUNTIMETHEVIRTUAL
MACHINEHADTOTRANSLATESTRAIGHT FROM A TEXT
EDITORSOURCECODEA*AVAPROGRAMWOULD
RUNATALUDICROUSLYGLACIALPACE*AVASHADA
CHALLENGINGENOUGHTIMECONVINCINGPEOPLE
THATITSlNALLYFASTANDPOWERFULENOUGHFOR
)MNOTSAYINGYOURELIKECOMPLETELYUSELESS MOSTJOBS
"UTREALLYWHATISITTHATYOUDO3ERIOUSLY)
HAVENOIDEA!PROGRAMMERCOULDJUSTWRITE
BYTECODEBYHANDAND)DTAKEIT9OUMIGHT
BEOUTOFAJOBSOONBUDDY
%XCUSEMEBUTTHATSQUITEANIGNORANTNOT
TOMENTIONARROGANT PERSPECTIVE7HILEIT
ISTRUETHATTHEORETICALLYYOUCANRUNANY
PROPERLYFORMATTEDBYTECODEEVENIFITDIDNT
COMEOUTOFA*AVACOMPILERINPRACTICETHATS
ABSURD!PROGRAMMERWRITINGBYTECODEBY
HANDISLIKEDOINGYOURWORDPROCESSINGBY
WRITINGRAWPOSTSCRIPT!ND)WOULDAPPRECIATE
ITIFYOUWOULDNOTREFERTOMEAShBUDDYv
)RESTMYCASEONTHEHUMORTHING "UTYOU
STILLDIDNTANSWERMYQUESTIONWHATDOYOU
ACTUALLYDO
FKDSWHU
GLYH,Q$4XLFN'LS
<PM2IÎ>QZ\]IT5IKPQVM <PM+WUXQTMZ
2EMEMBERTHAT*AVAISASTRONGLY TYPEDLAN
GUAGEANDTHATMEANS)CANTALLOWVARIABLES
TOHOLDDATAOFTHEWRONGTYPE4HISISA
CRUCIALSAFETYFEATUREAND)MABLETOSTOPTHE
"UTSOMESTILLGETTHROUGH)CANTHROW#LASS VASTMAJORITYOFVIOLATIONSBEFORETHEYEVERGET
#AST%XCEPTIONSANDSOMETIMES)GETPEOPLE TOYOU!ND)ALSO
TRYINGTOPUTTHEWRONGTYPEOFTHINGINAN
ARRAYTHATWASDECLAREDTOHOLDSOMETHING
ELSEAND
%XCUSEMEBUT)WASNTDONE!NDYESTHERE
ARESOMEDATATYPEEXCEPTIONSTHATCANEMERGE
ATRUNTIMEBUTSOMEOFTHOSEHAVETOBE
ALLOWEDTOSUPPORTONEOF*AVASOTHERIMPOR
TANTFEATURESDYNAMICBINDING!TRUNTIME
A*AVAPROGRAMCANINCLUDENEWOBJECTSTHAT
WERENTEVENKNOWNTOTHEORIGINALPROGRAM
MERSO)HAVETOALLOWACERTAINAMOUNTOF
mEXIBILITY"UTMYJOBISTOSTOPANYTHINGTHAT
WOULDNEVERCOULDNEVERSUCCEEDATRUN
TIME5SUALLY)CANTELLWHENSOMETHINGWONT
WORKFOREXAMPLEIFAPROGRAMMERACCIDEN
TALLYTRIEDTOUSEA"UTTONOBJECTASA3OCKET
CONNECTION)WOULDDETECTTHATANDTHUS
/+3URE"UTWHATABOUTSECURITY,OOKATALL PROTECTHIMFROMCAUSINGHARMATRUNTIME
THESECURITYSTUFF)DOANDYOURELIKEWHAT
CHECKINGFORSEMICOLONS/OOOHHHBIGSECURITY
RISK4HANKGOODNESSFORYOU %XCUSEMEBUT)AMTHElRSTLINEOFDEFENSE
ASTHEYSAY4HEDATATYPEVIOLATIONS)PREVIOUS
LYDESCRIBEDCOULDWREAKHAVOCINAPROGRAM
IFTHEYWEREALLOWEDTOMANIFEST)AMALSO
THEONEWHOPREVENTSACCESSVIOLATIONSSUCH
ASCODETRYINGTOINVOKEAPRIVATEMETHODOR
CHANGEAMETHODTHATnFORSECURITYREASONS
nMUSTNEVERBECHANGED)STOPPEOPLEFROM
TOUCHINGCODETHEYRENOTMEANTTOSEE
INCLUDINGCODETRYINGTOACCESSANOTHERCLASS
CRITICALDATA)TWOULDTAKEHOURSPERHAPSDAYS
EVENTODESCRIBETHESIGNIlCANCEOFMYWORK
7HATEVER)HAVETODOTHATSAMESTUFFTOO
THOUGHJUSTTOMAKESURENOBODYSNUCKIN
AFTERYOUANDCHANGEDTHEBYTECODEBEFORE /FCOURSEBUTAS)INDICATEDPREVIOUSLYIF)
RUNNINGIT DIDNTPREVENTWHATAMOUNTSTOPERHAPS
OFTHEPOTENTIALPROBLEMSYOUWOULDGRINDTO
AHALT!NDITLOOKSLIKEWEREOUTOFTIMESO
WELLHAVETOREVISITTHISINALATERCHAT
/HYOUCANCOUNTONIT"UDDY
\RXDUHKHUH
H[HUFLVH&RGH0DJQHWV
1dQÔU_Q Code Magnets

!WORKING*AVAPROGRAMISALLSCRAMBLEDUP
ONTHEFRIDGE#ANYOUREARRANGETHECODE
SNIPPETSTOMAKEAWORKING*AVAPROGRAM
THATPRODUCESTHEOUTPUTLISTEDBELOW
3OMEOFTHECURLYBRACESFELLONTHEFLOOR LI[

^
ANDTHEYWERETOOSMALLTOPICKUPSOFEEL
6\
FREETOADDASMANYOFTHOSEASYOUNEED VWHP
RXWS
[ ULQW
[ ´Gµ

`
LI[ ^
6\VWHPRXWSULQWÉFµ
`
FODVV6KXIÁH^
SXEOLFVWDWL
FYR LGPDLQ6WULQJ
>@DUJV^
[!^
LI
ULQW´Dµ
VWHPRXWS
6\
`
LQW[
[
[
6\
VWHPRXW
SULQW´
µ
^
H[!
ZKLO
)LOH(GLW:LQGRZ+HOS6OHHS
7]\X]\"
MDYD6KXIIOH
DEFG
FKDSWHU
GLYH,Q$4XLFN'LS
1dQÔU_Q %
LQW[
ZKLOH[!^
[ [
"%THECOMPILER LI[^

6\VWHPRXWSULQWOQ´VPDOO[µ
(DFKRIWKH-DYDILOHVRQWKLVSDJH `
UHSUHVHQWVDFRPSOHWHVRXUFHILOH
`
<RXUMRELVWRSOD\FRPSLOHUDQG
GHWHUPLQHZKHWKHUHDFKRIWKHVH `
ILOHVZLOOFRPSLOH,IWKH\
ZRQ·WFRPSLOHKRZ
ZRXOG\RXIL[WKHP"
&
$
FODVV([HUFLVHE^
FODVV([HUFLVHE^
LQW[
ZKLOH[!^
LQW[
[ [
ZKLOH[^
LI[^
LI[!^
6\VWHPRXWSULQWOQÉLJ[µ
`
`
`
`
`
`
`
\RXDUHKHUH
SX]]OHFURVVZRUG

-DYD&URVV

,ETSGIVEYOURRIGHTBRAINSOMETHINGTODO
)TSYOURSTANDARDCROSSWORDBUTALMOSTALL
OFTHESOLUTIONWORDSAREFROMCHAPTER*UST
Licensed by

TOKEEPYOUAWAKEWEALSOTHREWINAFEW
NON *AVA WORDSFROMTHEHIGH TECHWORLD

Eduard Simons

!CROSS
#OMMAND LINEINVOKER
104038
"ACKAGAIN
#ANTGOBOTHWAYS
!CRONYMFORYOURLAPTOPSPOWER
NUMBERVARIABLETYPE
!CRONYMFORACHIP $OWN
3AYSOMETHING .OTANINTEGEROR?????YOURBOAT
1UITEACREWOFCHARACTERS #OMEBACKEMPTY HANDED
!NNOUNCEANEWCLASSORMETHOD /PENHOUSE
7HATSAPROMPTGOODFOR @4HINGSHOLDERS
5NTILATTITUDESIMPROVE
3OURCECODECONSUMER
#ANTPINITDOWN
$EPTOF,!.JOCKEYS
3HOCKINGMODIlER
*USTGOTTAHAVEONE
(OWTOGETTHINGSDONE
"YTECODECONSUMER
FKDSWHU
GLYH,Q$4XLFN'LS
!SHORT*AVAPROGRAMISLISTEDBELOW/NEBLOCKOFTHEPROGRAM
ISMISSING9OURCHALLENGEISTOMATCHTHECANDIDATEBLOCKOF
CODEONTHELEFT WITHTHEOUTPUTTHATYOUDSEEIFTHEBLOCK
WEREINSERTED.OTALLTHELINESOFOUTPUTWILLBEUSEDANDSOME
-IXED OFTHELINESOFOUTPUTMIGHTBEUSEDMORETHANONCE$RAWLINES
-ESSAGES CONNECTINGTHECANDIDATEBLOCKSOFCODEWITHTHEIRMATCHING
COMMAND LINEOUTPUT4HEANSWERSAREATTHEENDOFTHECHAPTER
FODVV7HVW^
LQW[
LQW\
ZKLOH[^ FDQGLGDWH
JRHVKHUH FRGH

6\VWHPRXWSULQW[³³\³³

[ [
`
`
`
#ANDIDATES 0OSSIBLEOUTPUT
\ [\
PDWFKHDFKLWK
FDQGLGDWHZ \ \[
RQHRIWKHSXWV
SRVVLEOHRXW \ \
LI\!^
\ \
`
[ [
\ \[

LI\^
[ [
LI\^
[ [
`
`
\ \
\RXDUHKHUH
SX]]OH3RRO3X]]OH
FODVV3RRO3X]]OH2QH^
LQW[
3RRO3X]]OH ZKLOHBBBBBBBBBB^

9OURJOBISTOTAKECODESNIPPETSFROMTHE
POOLANDPLACETHEMINTOTHEBLANK BBBBBBBBBBBBBBBBBBBBBBBBBBBBB
LINESINTHECODE9OUMAYNOTUSETHE LI[^
SAMESNIPPETMORETHANONCEAND
BBBBBBBBBBBBBBBBBBBBBBBBBBB
YOUWONTNEEDTOUSEALLTHESNIP
`
PETS9OURGOALISTOMAKEACLASSTHAT
BBBBBBBBBBBBBBBBBBBBBBBBBBBBB
WILLCOMPILEANDRUNANDPRODUCETHE
OUTPUTLISTED$ONTBEFOOLEDTHISONES
HARDERTHANITLOOKS LIBBBBBBBBBB^

BBBBBBBBBBBBBBBBBBBBBBBBBBBB

BBBBBBBBBBB
/UTPUT `
LI[ ^
)LOH(GLW:LQGRZ+HOS&KHDW
MDYD3RRO3X]]OH2QH BBBBBBBBBBBBBBBBBBBBBBBBBBBB
DQRLVH `
LIBBBBBBBBBBB^
DQQR\V
DQR\VWHU BBBBBBBBBBBBBBBBBBBBBBBBBBBB
`
6\VWHPRXWSULQWOQ´´
BBBBBBBBBBBB
`
`
`
.OTE%ACHSNIPPET
FROMTHEPOOLCANBE
USEDONLYONCE X
X
X
X XX
X XX 3YSTEMOUTPRINThNOYSh
3YSTEMOUTPRINThv XX 3YSTEMOUTPRINThOISEh
3YSTEMOUTPRINThAh XX 3YSTEMOUTPRINThOYSTERh
3YSTEMOUTPRINThNh 3YSTEMOUTPRINThANNOYSv
3YSTEMOUTPRINThANh 3YSTEMOUTPRINThNOISEv
FKDSWHU
GLYH,Q$4XLFN'LS
FODVV([HUFLVHE^
LQW[
%XERCISE3OLUTIONS
ZKLOH[^
[ [
LI[!^
$
6\VWHPRXWSULQWOQÉLJ[µ
`
&RGH0DJQHWV
`
FODVV6KXIÁH^
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ `7KLVZLOOFRPSLOHDQGUXQQRRXWSXWEXW
`ZLWKRXWDOLQHDGGHGWRWKHSURJUDPLW
LQW[ ZRXOGUXQIRUHYHULQDQLQÀQLWH¶ZKLOH·ORRS
ZKLOH[!^
LI[!^
6\VWHPRXWSULQW´Dµ
FODVV)RR^
`
[ [ LQW[
6\VWHPRXWSULQW´µ ZKLOH[!^
[ [
LI[ ^ LI[^
6\VWHPRXWSULQWÉFµ
%
`
`
LI[ ^ `7KLVÀOHZRQ·WFRPSLOHZLWKRXWD
6\VWHPRXWSULQW´Gµ `FODVVGHFODUDWLRQDQGGRQ·WIRUJHW
[ [ `WKHPDWFKLQJFXUO\EUDFH
`
`
`
`
FODVV([HUFLVHE^
)LOH(GLW:LQGRZ+HOS3RHW
LQW[
MDYD6KXIIOH
ZKLOH[!^
DEFG
[ [
& LI[^
`
`
7KH¶ZKLOH·ORRSFRGHPXVWEHLQ
`
VLGHDPHWKRG,WFDQ·WMXVWEH
`
KDQJLQJRXWLQVLGHWKHFODVV
\RXDUHKHUH
SX]]OHDQVZHUV

) 9 3

-$9$ 2
/ 23 8

5 : 2 , %

5
%$1&+ $ ' & 9 /

$ , 17 2 $ ,

< / 0 5 ,&

6 <7(28735,17
6 0
FODVV3RRO3X]]OH2QH^ 7 $ , $

SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ $ , / % 0
LQW[
1
65,*
7 '(&/$5(
ZKLOH;^ , 5 ( 7

& - +
6\VWHPRXWSULQW´Dµ
LI[^ 9 2

6\VWHPRXWSULQW´´ &200$1'
`
6\VWHPRXWSULQW´Qµ FODVV7HVW^
LI;!^ LQW[
LQW\

ZKLOH[^
6\VWHPRXWSULQW´R\VWHUµ
[ [
`
LI[ ^ 6\VWHPRXWSULQW[³³\³³

[ [
6\VWHPRXWSULQW´QR\Vµ `
`
` `
LI;^
\ [\
6\VWHPRXWSULQW´RLVHµ
` \ \[

6\VWHPRXWSULQWOQ´´
\ \
)LOH(GLW:LQGRZ+HOS&KHDW LI\!^
; ; \ \
MDYD3RRO3X]]OH2QH
` `
DQRLVH
` DQQR\V
` [ [
DQR\VWHU \ \[

LI\^
[ [
LI\^
[ [
`
`
\ \
FKDSWHU
FODVVHVDQGREMHFWV
$7ULSWR2EMHFWYLOOH
:H·UHJRLQJWR
2EMHFWYLOOH:H·UH
OHDYLQJWKLVGXVW\RO·
SURFHGXUDOWRZQIRUJRRG
,·OOVHQG\RXDSRVWFDUG
,ZDVWROGWKHUHZRXOGEHREMHFWV)NCHAPTERWEPUTALLOFOURCODEINTHE
MAIN METHOD4HATSNOTEXACTLYOBJECT ORIENTED)NFACTTHATSNOTOBJECT ORIENTEDATALL7ELL
WEDIDUSEAFEWOBJECTSLIKETHE3TRINGARRAYSFORTHE0HRASE / -ATICBUTWEDIDNTACTUALLY
DEVELOPANYOFOUROWNOBJECTTYPES3ONOWWEVEGOTTOLEAVETHATPROCEDURALWORLDBEHIND
GETTHEHECKOUTOFMAIN ANDSTARTMAKINGSOMEOBJECTSOFOUROWN7ELLLOOKATWHATMAKES
OBJECT ORIENTED// DEVELOPMENTIN*AVASOMUCHFUN7ELLLOOKATTHEDIFFERENCEBETWEEN
ACLASSANDANOBJECT7ELLLOOKATHOWOBJECTSCANGIVEYOUABETTERLIFEATLEASTTHEPROGRAM
MINGPARTOFYOURLIFE.OTMUCHWECANDOABOUTYOURFASHIONSENSE 7ARNINGONCEYOUGET
TO/BJECTVILLEYOUMIGHTNEVERGOBACK3ENDUSAPOSTCARD
WKLVLVDQHZFKDSWHU
RQFHXSRQDWLPHLQ2EMHFWYLOOH
+PIQZ?IZ[
WZ0W_7JRMK\[+IV+PIVOMAW]Z4QNM
\PM [XMK
A
NCEUPONATIMEINASOFTWARESHOPTWO
PROGRAMMERSWEREGIVENTHESAMESPECANDTOLDTO
hBUILDITv4HE2EALLY!NNOYING0ROJECT-ANAGER
FORCEDTHETWOCODERSTOCOMPETE
BYPROMISINGTHATWHOEVERDELIVERS
lRSTGETSONEOFTHOSECOOL!ERON©
CHAIRSALLTHE3ILICON6ALLEYGUYSHAVE
,ARRYTHEPROCEDURALPROGRAMMERAND
"RADTHE//GUYBOTHKNEWTHISWOULD
BEAPIECEOFCAKE
,ARRYSITTINGINHISCUBETHOUGHTTO
HIMSELFh7HATARETHETHINGSTHISPROGRAM
HASTODO7HATPROCEDURESDOWENEEDv
!NDHEANSWEREDHIMSELFhROTATEAND
PLAY3OUNDv3OOFFHEWENTTOBUILDTHE
PROCEDURES!FTERALLWHATISAPROGRAMIFNOT
APILEOFPROCEDURES
"RADMEANWHILEKICKEDBACKATTHECAFE
ANDTHOUGHTTOHIMSELFh7HATARETHETHINGS
INTHISPROGRAMWHOARETHEKEYPLAYERSv(E
lRSTTHOUGHTOF4HE3HAPES/FCOURSETHERE
WEREOTHEROBJECTSHETHOUGHTOFLIKETHE5SERTHE3OUND
ANDTHE#LICKINGEVENT"UTHEALREADYHADALIBRARYOFCODE
FORTHOSEPIECESSOHEFOCUSEDONBUILDING3HAPES2EAD
ONTOSEEHOW"RADAND,ARRYBUILTTHEIRPROGRAMSAND \PM KPIQZ
FORTHEANSWERTOYOURBURNINGQUESTIONh3OWHOGOTTHE
!ERONv
1V4IZZa¼[K]JM )\*ZIL¼[TIX\WXI\\PMKINM
!SHEHADDONEAGAZILLIONTIMESBEFORE,ARRY "RADWROTEACLASSFOREACHOFTHETHREESHAPES
SETABOUTWRITINGHIS)MPORTANT0ROCEDURES
(EWROTEROTATEANDPLAY3OUNDINNOTIME
URWDWHVKDSH1XP^
PDNHWKHVKDSHURWDWH
`
SOD\6RXQGVKDSH1XP^
XVHVKDSH1XPWRORRNXSZKLFK `
$,)VRXQGWRSOD\DQGSOD\LW
`
`
`
FKDSWHU
FODVVHVDQGREMHFWV
4IZZa\PW]OP\PM¼LVIQTMLQ\0MKW]TLITUW[\NMMT\PMZWTTML
[\MMTWN\PM)MZWVJMVMI\PPQ[
*]\_IQ\ <PMZM¼[JMMVI[XMKKPIVOM
h/+TECHNICALLYYOUWERElRST,ARRYvSAIDTHE-ANAGERhBUTWEHAVETOADDJUSTONE
TINYTHINGTOTHEPROGRAM)TLLBENOPROBLEMFORCRACKPROGRAMMERSLIKEYOUTWOv
h)F)HADADIMEFOREVERYTIME)VEHEARDTHATONEvTHOUGHT,ARRYKNOWINGTHATSPEC
CHANGE NO PROBLEMWASAFANTASYh!NDYET"RADLOOKSSTRANGELYSERENE7HATSUPWITH
THATv3TILL,ARRYHELDTIGHTTOHISCOREBELIEFTHATTHE//WAYWHILECUTEWASJUST
SLOW!NDTHATIFYOUWANTEDTOCHANGEHISMINDYOUDHAVETOPRYITFROMHISCOLD
DEADCARPAL TUNNELLEDHANDS
M
MJI [PIX
Z M _ QT T J M IV IUW W\PMZ[
<PM P \PM _PI\ OW\ ILLML \W \PM [XMK
ZMMV _Q\
WV \PM [K [MZ KTQKS[ WV \PM
M] M \PM
?PMV \P QTT Z W\I\M TQS L NQTM
Q\ _
IUWMJI PQN [W]V
\ P M Z [ I VL XTIa I
W
*IKSQV4IZZa¼[K]JM )\*ZIL¼[TIX\WXI\\PMJMIKP
4HEROTATEPROCEDUREWOULDSTILLWORKTHECODEUSED "RADSMILEDSIPPEDHISMARGARITAANDWROTEONE
ALOOKUPTABLETOMATCHASHAPE.UMTOANACTUAL NEWCLASS3OMETIMESTHETHINGHELOVEDMOST
SHAPEGRAPHIC"UTPLAY3OUNDWOULDHAVETOCHANGE ABOUT//WASTHATHEDIDNTHAVETOTOUCHCODE
!NDWHATTHEHECKISAHIFlLE HEDALREADYTESTEDANDDELIVEREDh&LEXIBILITY
SOD\6RXQGVKDSH1XP^ EXTENSIBILITYvHEMUSEDREmECTINGONTHE
LIWKHVKDSHLVQRWDQDPRHED BENElTSOF//
XVHVKDSH1XPWRORRNXSZKLFK $PRHED
$,)VRXQGWRSOD\DQGSOD\LW URWDWH^
HOVH FRGHWRURWDWHDQDPRHED
SOD\DPRHEDKLIVRXQG `
`
SOD\6RXQG^
)TTURNEDOUTNOTTOBESUCHABIGDEALBUTITSTILL
FRGHWRSOD\WKHQHZ
MADEHIMQUEASYTOTOUCHPREVIOUSLY TESTEDCODE/F KLIILOHIRUDQDPRHED
ALLPEOPLEHESHOULDKNOWTHATNOMATTERWHATTHE `
PROJECTMANAGERSAYSTHESPECALWAYSCHANGES
\RXDUHKHUH
4IZZa[V]KSQVR][\UWUMV\[IPMILWN*ZIL
(AH3OMUCHFORTHATFOOFY//NONSENSE "UTTHESMIRKON,ARRYSFACEMELTEDWHENTHE
2EALLY!NNOYING0ROJECT-ANAGERSAIDWITHTHATTONEOFDISAPPOINTMENT h/HNOTHATSNOT
HOWTHEAMOEBAISSUPPOSEDTOROTATEv
4URNSOUTBOTHPROGRAMMERSHADWRITTENTHEIRROTATECODELIKETHIS
GHWHUPLQHWKHUHFWDQJOHWKDWVXUURXQGVWKHVKDSH
FDOFXODWHWKHFHQWHURIWKDWUHFWDQJOHDQGURWDWHWKHVKDSHDURXQGWKDWSRLQW
"UTTHEAMOEBASHAPEWASSUPPOSEDTOROTATEAROUNDAPOINTONONEENDLIKEACLOCKHAND
h)MTOASTvTHOUGHT,ARRYVISUALIZINGCHARRED7ONDERBREAD©h!LTHOUGHHMMMM)COULD
JUSTADDANOTHERIFELSETOTHEROTATEPROCEDUREANDTHENJUSTHARD CODETHEROTATIONPOINT
CODEFORTHEAMOEBA4HATPROBABLYWONTBREAKANYTHINGv"UTTHELITTLEVOICEATTHEBACKOF
HISHEADSAIDh"IG-ISTAKE$OYOUHONESTLYTHINKTHESPECWONTCHANGEAGAINv
4IZZa
XWQV\ QV
ZW\I\QWV
)UMWJI ^MZ[QWV"
¼[
IVL *ZIL
?PI\ \PM [XMK KWV^MVQMV\Ta
NWZOW\ \W UMV\QWV
ZW\ I\QWV
M IUMJI
?PMZM \P
]TL JM"
XWQV\ [PW
*IKSQV4IZZa¼[K]JM )\*ZIL¼[TIX\WXWVPQ[TI_V
(ElGUREDHEBETTERADDROTATIONPOINTARGUMENTS KPIQZI\\PM<MTT]ZQLM*T]MOZI[[.M[\QÎT
TOTHEROTATEPROCEDURE!LOTOFCODEWASAFFECTED 7ITHOUTMISSINGABEAT"RADMODIlEDTHEROTATE
4ESTINGRECOMPILINGTHEWHOLENINEYARDSALLOVER METHODBUTONLYINTHE!MOEBACLASS(ENEVER
AGAIN4HINGSTHATUSEDTOWORKDIDNT TOUCHEDTHETESTEDWORKING
URWDWHVKDSH1XP[3W\3W^ COMPILEDCODEFORTHEOTHER $PRHED
LIWKHVKDSHLVQRWDQDPRHED PARTSOFTHEPROGRAM4O LQW[3RLQW
GIVETHE!MOEBAAROTA LQW\3RLQW
FDOFXODWHWKHFHQWHUSRLQW
TIONPOINTHEADDEDAN URWDWH^
EDVHGRQDUHFWDQJOH
ATTRIBUTETHATALL!MOEBAS FRGHWRURWDWHDQDPRHED
WKHQURWDWH WOULDHAVE(EMODI XVLQJDPRHED·V[DQG\
HOVH lEDTESTEDANDDELIVERED `
XVHWKH[3WDQG\3WDV WIRELESSLY THEREVISED SOD\6RXQG^
WKHURWDWLRQSRLQWRIIVHW PROGRAMDURINGASINGLE FRGHWRSOD\WKHQHZ
"ELA&LECKSET KLIILOHIRUDQDPRHED
DQGWKHQURWDWH `
`
FKDSWHU
FODVVHVDQGREMHFWV
;W*ZIL\PM77O]aOW\\PMKPIQZZQOP\ '
.OTSOFAST,ARRYFOUNDAmAWIN"RADSAPPROACH!ND
SINCEHEWASSURETHATIFHEGOTTHECHAIRHEDALSOGET,UCY
INACCOUNTINGHEHADTOTURNTHISTHINGAROUND
,!2299OUVEGOTDUPLICATEDCODE4HEROTATE
PROCEDUREISINALLFOUR3HAPETHINGS
"2!$)TSAMETHODNOTAPROCEDURE!NDTHEYRECLASSES
NOTTHINGS
,!2297HATEVER)TSASTUPIDDESIGN9OUHAVETO
MAINTAINFOURDIFFERENTROTATEhMETHODSv(OWCANTHAT
EVERBEGOOD
"2!$/H)GUESSYOUDIDNTSEETHElNALDESIGN,ETME
SHOWYOUHOW//INHERITANCEWORKS,ARRY
?PI\ 4IZZa _IV\ML
NQO]ZML \PM KPIQZ _W]TL QUXZM[[ PMZ

6TXDUH &LUFOH 7ULDQJOH $PRHED
1 TWWSML I\ _PI\ ITT NW]Z
URWDWH URWDWH URWDWH URWDWH KTI[[M[ PI^M QV KWUUWV
SOD\6RXQG SOD\6RXQG SOD\6RXQG SOD\6RXQG

<PMa¼ZM ;PIXM[ IVL \PMa ITT ZW\I\M IVL 6KDSH
XTIa;W]VL ;W 1 IJ[\ZIK\ML W]\ \PM
KWUUWV NMI\]ZM[ IVL X]\ \PMU QV\W I
URWDWH
SOD\6RXQG

VM_ KTI[[ KITTML ;PIXM <PMV1TQVSML\PMW\PMZ
6KDSH
[]XMZKTI[[ NW]Z[PIXMKTI[[M[\W
URWDWH
SOD\6RXQG \PMVM_;PIXMKTI[[
QVIZMTI\QWV[PQXKITTML
QVPMZQ\IVKM
<RXFDQUHDGWKLVDV´6TXDUHLQKHULWVIURP6KDSHµ
´&LUFOHLQKHULWVIURP6KDSHµDQGVRRQ,UHPRYHG []JKTI[[M[
URWDWHDQGSOD\6RXQGIURPWKHRWKHUVKDSHVVRQRZ
WKHUH·VRQO\RQHFRS\WRPDLQWDLQ
7KH6KDSHFODVVLVFDOOHGWKHVXSHUFODVVRIWKHRWKHUIRXU
FODVVHV7KHRWKHUIRXUDUHWKHVXEFODVVHVRI6KDSH7KH
VXEFODVVHVLQKHULWWKHPHWKRGVRIWKHVXSHUFODVV,QRWKHU
ZRUGVLIWKH6KDSHFODVVKDVWKHIXQFWLRQDOLW\WKHQWKH
VXEFODVVHVDXWRPDWLFDOO\JHWWKDWVDPHIXQFWLRQDOLW\
\RXDUHKHUH
?PI\IJW]\\PM)UWMJIZW\I\M'
,!2297ASNTTHATTHEWHOLEPROBLEMHERETHATTHEAMOEBASHAPE
HADACOMPLETELYDIFFERENTROTATEANDPLAY3OUNDPROCEDURE
UULGH 1RZ
"2!$-ETHOD YH
2
,!2297HATEVER(OWCANAMOEBADOSOMETHINGDIFFERENTIF
$V Z
IThINHERITSvITSFUNCTIONALITYFROMTHE3HAPECLASS N 0H +R
"2!$4HATSTHELASTSTEP4HE!MOEBACLASSOVERRIDESTHE
METHODSOFTHE3
HAPECLASS4HENATRUNTIMETHE*6-KNOWSEXACTLY
WHICHROTATE METHODTORUNWHENSOMEONETELLSTHE!MOEBATOROTATE
[]XMZKTI[[
Licensed by
6KDSH
UWZM IJ[\ZIK\
URWDWH
SOD\6RXQG
11UILM\PM)UWMJIKTI[[W^MZZQLM
UILM \PM )UWMJI KTI[[ W^MZZQLM
\PMZW\I\MIVLXTIa;W]VL
\PM ZW\I\M UM\PWL WN \PM
UM\PWL[WN\PM[]XMZKTI[[;PIXM
[]XMZKTI[[ ;PIXM
Eduard Simons
[]JKTI[[M[ 7^MZZQLQVOR][\UMIV[\PI\I
UWZM [XMKQNQK 7^MZZQLQVO R][\ UMIV[ \PI\ I
[]JKTI[[ZMLMNQVM[WVMWNQ\[
[]JKTI[[ ZMLMNQVM[ WVM WN Q\[
QVPMZQ\MLUM\PWL[_PMVQ\VMML[
QVPMZQ\ML UM\PWL[ _PMV Q\ VMML[
6TXDUH &LUFOH 7ULDQJOH $PRHED \WKPIVOMWZM`\MVL\PMJMPI^QWZ
\W KPIVOM WZ M`\MVL \PM JMPI^QWZ
104038
WN\PI\UM\PWL
WN \PI\ UM\PWL
URWDWH ^
DPRHEDVSHFLILF
URWDWH FRGH ^
7^MZZQLQVO UM\PWL[
SOD\6RXQG ^
DPRHEDVSHFLILF
VRXQG FRGH ^
,FDQWDNH
,!229(OWDOYOUhTELLvAN!MOEBATO
FDUHRIP\VHOI
DOSOMETHING$ONTYOUHAVETOCALLTHE ,NQRZKRZDQ$PRHED
PROCEDURESORRYMETHODANDTHENTELLIT ,NQRZKRZD6KDSHLV LVVXSSRVHGWRURWDWH
WHICHTHINGTOROTATE VXSSRVHGWREHKDYH<RXU DQGSOD\DVRXQG
MRELVWRWHOOPHZKDWWR
"2!$4HATSTHEREALLYCOOLTHINGABOUT//
GRDQGP\MRELVWRPDNHLWKDSSHQ
7HENITSTIMEFORSAYTHETRIANGLETOROTATE 'RQ·W\RXZRUU\\RXUOLWWOHSURJUDP
THEPROGRAMCODEINVOKESCALLS THEROTATE PHUKHDGDERXWKRZ,GRLW
METHODONTHETRIANGLEOBJECT4HERESTOFTHE
PROGRAMREALLYDOESNTKNOWORCAREHOWTHE
TRIANGLEDOESIT!NDWHENYOUNEEDTOADD
SOMETHINGNEWTOTHEPROGRAMYOUJUSTWRITE
ANEWCLASSFORTHENEWOBJECTTYPESOTHENEW
OBJECTSWILLHAVETHEIROWNBEHAVIOR
FKDSWHU
FODVVHVDQGREMHFWV
<PM[][XMV[MQ[SQTTQVOUM
?PWOW\\PMKPIQZ'
!MYFROMTHESECONDmOOR
UNBEKNOWNSTTOALLTHE0ROJECT
-ANAGERHADGIVENTHESPECTO
THREEPROGRAMMERS
YiXè
?PI\LWaW]TQSMIJW]\77' gfn\i
4IMETOPUMPSOMENEURONS
´,WKHOSVPHGHVLJQLQDPRUHQDWXUDOZD\7KLQJV 9OUJUSTREADASTORYBOUTAPROCEDURAL
KDYHDZD\RIHYROYLQJµ PROGRAMMERGOINGHEAD TO HEADWITHAN//
-R\VRIWZDUHDUFKLWHFW PROGRAMMER9OUGOTAQUICKOVERVIEWOFSOME
KEY//CONCEPTSINCLUDINGCLASSESMETHODSAND
ATTRIBUTES7ELLSPENDTHERESTOFTHECHAPTER
´1RWPHVVLQJDURXQGZLWKFRGH,·YHDOUHDG\ LOOKINGATCLASSESANDOBJECTSWELLRETURNTO
WHVWHGMXVWWRDGGDQHZIHDWXUHµ INHERITANCEANDOVERRIDINGINLATERCHAPTERS
%UDGSURJUDPPHU "ASEDONWHATYOUVESEENSOFARANDWHATYOU
MAYKNOWFROMAPREVIOUS//LANGUAGEYOUVE
WORKEDWITH TAKEAMOMENTTOTHINKABOUT
´,OLNHWKDWWKHGDWDDQGWKHPHWKRGVWKDWRSHU
THESEQUESTIONS
DWHRQWKDWGDWDDUHWRJHWKHULQRQHFODVVµ
-RVKEHHUGULQNHU 7HATARETHEFUNDAMENTALTHINGSYOUNEEDTO
THINKABOUTWHENYOUDESIGNA*AVACLASS7HAT
´5HXVLQJFRGHLQRWKHUDSSOLFDWLRQV:KHQ,ZULWH ARETHEQUESTIONSYOUNEEDTOASKYOURSELF
DQHZFODVV,FDQPDNHLWÁH[LEOHHQRXJKWREH )FYOUCOULDDESIGNACHECKLISTTOUSEWHEN
XVHGLQVRPHWKLQJQHZODWHUµ YOUREDESIGNINGACLASSWHATWOULDBEONTHE
&KULVSURMHFWPDQDJHU CHECKLIST
´,FDQ·WEHOLHYH&KULVMXVWVDLGWKDW+HKDVQ·W
ZULWWHQDOLQHRIFRGHLQ\HDUVµ
'DU\OZRUNVIRU&KULV PHWDFRJQLWLYH WLS
,I \RX·UH VWXFN RQ DQ H[HUFLVH WU\ WDONLQJ DERXW
´%HVLGHVWKHFKDLU"µ
LW RXW ORXG 6SHDNLQJ DQG KHDULQJ DFWLYDWHV
$P\SURJUDPPHU
D GLIIHUHQW SDUW RI \RXU EUDLQ $OWKRXJK LW
ZRUNV EHVW LI \RX KDYH DQRWKHU SHUVRQ WR
GLVFXVV LW ZLWK SHWV ZRUN WRR 7KDW·V KRZ
RXU GRJ OHDUQHG SRO\PRUSKLVP
\RXDUHKHUH
WKLQNLQJDERXWREMHFWV
?PMVaW]LM[QOVIKTI[[\PQVSIJW]\\PMWJRMK\[\PI\
_QTTJMKZM I\MLNZWU\PI\KTI[[\ aXM<PQVSIJW]\"
NWKLQJVWKHREMHFWNQRZV
NWKLQJVWKHREMHFWGRHV
6KRSSLQJ&DUW %XWWRQ $ODUP
ODEHO DODUP7LPH
FDUW&RQWHQWV SVW_[ FRORU SVW_[ DODUP0RGH SVW_[
VHW&RORU VHW$ODUP7LPH
DGG7R&DUW LWM[ VHW/DEHO LWM[ JHW$ODUP7LPH
VHW$ODUP LWM[
UHPRYH)URP&DUW GH3UHVV LV$ODUP6HW
FKHFN2XW XQ'HSUHVV VQRR]H
<PQVO[IVWJRMK\SVW_[IJW]\Q\[MTNIZMKITTML 6RQJ
NLQVWDQFHYDULDEOHV QV[\IVKM WLWOH SVW_[

ÎZQIJTM[ DUWLVW
VWDWH
VHW7LWOH
<PQVO[IVWJRMK\KIVLWIZMKITTML UM\PWL[ VHW$UWLVW LWM[
EHKDYLRU SOD\
NPHWKRGV
4HINGSANOBJECTKNOWSABOUTITSELFARECALLEDINSTANCE 6KDUSHQ \RXU SHQFLO

VARIABLES4HEYREPRESENTANOBJECTSSTATETHEDATA AND
CANHAVEUNIQUEVALUESFOREACHOBJECTOFTHATTYPE &ILLINWHATATELEVISIONOBJECT
MIGHTNEEDTOKNOWANDDO
7KLQNRILQVWDQFHDVDQRWKHUZD\RIVD\LQJREMHFW
4HINGSANOBJECTCANDOARECALLEDMETHODS7HENYOU
DESIGNACLASSYOUTHINKABOUTTHEDATAANOBJECTWILLNEED
TOKNOWABOUTITSELFANDYOUALSODESIGNTHEMETHODS
THATOPERATEONTHATDATA)TSCOMMONFORANOBJECTTO
HAVEMETHODSTHATREADORWRITETHEVALUESOFTHEINSTANCE
VARIABLES&OREXAMPLE!LARMOBJECTSHAVEANINSTANCE
VARIABLETOHOLDTHEALARM4IMEANDTWOMETHODSFOR
GETTINGANDSETTINGTHEALARM4IME
3OOBJECTSHAVEINSTANCEVARIABLESANDMETHODSBUTTHOSE
INSTANCEVARIABLESANDMETHODSAREDESIGNEDASPARTOFTHE
CLASS
FKDSWHU
FODVVHVDQGREMHFWV
:KDW·VWKHGLIIHUHQFHEHWZHHQ
DFODVVDQGDQREMHFW"
)KTI[[Q[VW\IVWJRMK\
J]\Q\¼[][ML\WKWV[\Z]K\\PMU
!CLASSISABLUEPRINTFORANOBJECT)TTELLSTHE
VIRTUALMACHINEHOWTOMAKEANOBJECTOFTHAT
-90
PARTICULARTYPE%ACHOBJECTMADEFROMTHAT
CLASSCANHAVEITSOWNVALUESFORTHE
INSTANCEVARIABLESOFTHATCLASS&OR
EXAMPLEYOUMIGHTUSETHE"UTTON
CLASSTOMAKEDOZENSOFDIFFERENT
BUTTONSANDEACHBUTTONMIGHTHAVE
FODVV
ITSOWNCOLORSIZESHAPELABELANDSOON
/RRNDWLWWKLVZD\ !NOBJECTISLIKEONEENTRYINYOURADDRESSBOOK
/NEANALOGYFOROBJECTSISAPACKETOFUNUSED2OLODEX»CARDS
%ACHCARDHASTHESAMEBLANKFIELDSTHEINSTANCEVARIABLES 7HEN
YOUFILLOUTACARDYOUARECREATINGANINSTANCEOBJECT ANDTHE
ENTRIESYOUMAKEONTHATCARDREPRESENTITSSTATE
4HEMETHODSOFTHECLASSARETHETHINGSYOUDOTOAPARTICULARCARD
GET.AME CHANGE.AME SET.AME COULDALLBEMETHODSFOR
CLASS2OLODEX
3OEACHCARDCANDOTHESAMETHINGSGET.AME CHANGE.AME
ETC BUTEACHCARDKNOWSTHINGSUNIQUETOTHATPARTICULARCARD
\RXDUHKHUH
PDNLQJREMHFWV
5ISQVOaW]ZNQZ[\WJRMK\
3OWHATDOESITTAKETOCREATEANDUSEANOBJECT9OUNEEDTWOCLASSES/NE
CLASSFORTHETYPEOFOBJECTYOUWANTTOUSE$OG!LARM#LOCK4ELEVISION 7KH'RW2SHUDWRU
ETC ANDANOTHERCLASSTOTESTYOURNEWCLASS4HETESTERCLASSISWHEREYOUPUT
THEMAINMETHODANDINTHATMAIN METHODYOUCREATEANDACCESSOBJECTS 4HEDOTOPERATOR GIVES
OFYOURNEWCLASSTYPE4HETESTERCLASSHASONLYONEJOBTOTRYOUTTHEMETH YOUACCESSTOANOBJECTS
ODSANDVARIABLESOFYOURNEWOBJECTCLASSTYPE STATEANDBEHAVIORINSTANCE
VARIABLESANDMETHODS
&ROMTHISPOINTFORWARDINTHEBOOKYOULLSEETWOCLASSESINMANYOF
OUREXAMPLES/NEWILLBETHEREALCLASSnTHECLASSWHOSEOBJECTSWE
REALLYWANTTOUSEANDTHEOTHERCLASSWILLBETHETESTERCLASSWHICHWE MAKEANEWOBJECT
CALLWHATEVER9OUR#LASS.AME)S7HVW'ULYH&OREXAMPLEIFWEMAKEA $OGDNEW$OG
%XQJHHCLASSWELLNEEDA%XQJHH7HVW'ULYHCLASSASWELL/NLYTHE
SOME#LASS.AME7HVW'ULYHCLASSWILLHAVEAMAIN METHODANDITSSOLE
PURPOSEISTOCREATEOBJECTSOFYOURNEWTYPETHENOT THE TESTERCLASS AND TELLITTOBARKBYUSINGTHE
THENUSETHEDOTOPERATOR TOACCESSTHEMETHODSANDVARIABLESOFTHENEW DOTOPERATORONTHE
VARIABLEDTOCALLBARK
OBJECTS4HISWILLALLBEMADESTUNNINGLYCLEARBYTHEFOLLOWINGEXAMPLES
DBARK
:ULWH\RXUFODVV
SETITSSIZEUSINGTHE
FODVV'RJ^ DOTOPERATOR
LQVWDQFHYD '2*
ULDEOHV DSIZE
LQWVL]H VL]H
6WULQJEUHHG EUHHG
QDPH
6WULQJQDPH
DPHWKRG EDUN
YRLGEDUN^
6\VWHPRXWSULQWOQ³5XII5XII´
`
` :ULWHDWHVWHU7HVW'ULYHFODVV
FODVV'RJ7HVW'ULYH^
KRG
V W D P DLQPHW RGH SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^
X F
M
·U H J R QQDSXHW[WVWHS 'RJWHVWFRGHJRHVKHUH
ZH LWLQWKHQ `
LQ `
,Q\RXUWHVWHUPDNHDQREMHFWDQGDFFHVV
WKHREMHFW·VYDULDEOHVDQGPHWKRGV
FODVV'RJ7HVW'ULYH^
'RJG QHZ'RJ PDNHD'RJR
EMHFW
GVL]H XVHWKHGRWRSHUDWRU
GRW WRG
U EDUN WRVHWWKHVL]HRIWKH'
RJ
RSHUD ` DQGWRFDOOLWVEDU
NPHWKRG
,I\RXDOUHDG\KDYHVRPH22VDYY\
\RX·OONQRZZH·UHQRWXVLQJHQFDSVXODWLRQ
` :H·OOJHWWKHUHLQFKDSWHU
FKDSWHU
FODVVHVDQGREMHFWV
5ISQVOIVL\M[\QVO5W^QMWJRMK\[
FODVV0RYLH^
6WULQJWLWOH
6WULQJJHQUH
LQWUDWLQJ
YRLGSOD\,W^
6\VWHPRXWSULQWOQ³3OD\LQJWKHPRYLH´
`
`
SXEOLFFODVV0RYLH7HVW'ULYH^
0RYLHRQH QHZ0RYLH
RQHWLWOH ³*RQHZLWKWKH6WRFN´
RQHJHQUH ³7UDJLF´
RQHUDWLQJ
0RYLHWZR QHZ0RYLH
WZRWLWOH ³/RVWLQ&XELFOH6SDFH´
WZRJHQUH ³&RPHG\´
WZRUDWLQJ
WZRSOD\,W
0RYLHWKUHH QHZ0RYLH
WKUHHWLWOH ³%\WH&OXE´
WKUHHJHQUH ³7UDJLFEXWXOWLPDWHO\XSOLIWLQJ´
WKUHHUDWLQJ
`
`
6KDUSHQ \RXU SHQFLO
WLWOH
029,(
REMHFW JHQUH
WLWOH
JHQUH UDWLQJ
UDWLQJ
SOD\,W
WLWOH
4HE-OVIE4EST$RIVECLASSCREATESOBJECTSINSTANCES OF REMHFW JHQUH

THE-OVIECLASSANDUSESTHEDOTOPERATOR TOSETTHE
UDWLQJ
INSTANCEVARIABLESTOASPECIFICVALUE4HE-OVIE4EST$RIVE
CLASSALSOINVOKESCALLS AMETHODONONEOFTHEOBJECTS
&ILLINTHECHARTTOTHERIGHTWITHTHEVALUESTHETHREE WLWOH
OBJECTSHAVEATTHEENDOFMAIN
REMHFW JHQUH
UDWLQJ
\RXDUHKHUH
JHWWKHKHFNRXWRI PDLQ
9]QKS /M\W]\WNUIQV
!SLONGASYOUREINMAIN YOURENOTREALLYIN/BJECTVILLE)TSlNEFORATEST
PROGRAMTORUNWITHINTHEMAINMETHODBUTINATRUE//APPLICATIONYOU
NEEDOBJECTSTALKINGTOOTHEROBJECTSASOPPOSEDTOASTATICMAIN METHOD
CREATINGANDTESTINGOBJECTS
<PM\ _W][M[WNUIQV"
NWRWHVW\RXUUHDOFODVV
NWRODXQFKVWDUW\RXU-DYDDSSOLFDWLRQ
!REAL*AVAAPPLICATIONISNOTHINGBUTOBJECTSTALKINGTOOTHEROBJECTS)NTHIS
CASETALKINGMEANSOBJECTSCALLINGMETHODSONONEANOTHER/NTHEPREVIOUS
PAGEANDINCHAPTERWELOOKATUSINGAMAIN METHODFROMASEPARATE
4EST$RIVECLASSTOCREATEANDTESTTHEMETHODSANDVARIABLESOFANOTHERCLASS)N
CHAPTERWELOOKATUSINGACLASSWITHAMAIN METHODTOSTARTTHEBALLROLLING
ONAREAL*AVAAPPLICATIONBYMAKINGOBJECTSANDTHENTURNINGTHOSEOBJECTS
*DPH/DXQFKHU
LOOSETOINTERACTWITHOTHEROBJECTSETC
PDNH
!SA@SNEAKPREVIEWTHOUGHOFHOWAREAL*AVAAPPLICATIONMIGHTBEHAVE *XHVV*VD
HERESALITTLEEXAMPLE"ECAUSEWERESTILLATTHEEARLIESTSTAGESOFLEARNING*AVA REMHFW DPH
WEREWORKINGWITHASMALLTOOLKITSOYOULLlNDTHISPROGRAMALITTLECLUNKY PDLQ6WULQJ>@DUJV WHOOV DQG
ANDINEFlCIENT9OUMIGHTWANTTOTHINKABOUTWHATYOUCOULDDOTOIMPROVE VWDUW*LWWR
ITANDINLATERCHAPTERSTHATSEXACTLYWHATWELLDO$ONTWORRYIFSOMEOFTHE DPH
CODEISCONFUSINGTHEKEYPOINTOFTHISEXAMPLEISTHATOBJECTSTALKTOOBJECTS
<PM/]M[[QVO/IUM *XHVV*DPH
LQVWDQ
3UMMARY S YDULDEOHFVH
S IRUWK
SOD\HUVHWKUHH
4HEGUESSINGGAMEINVOLVESA@GAMEOBJECTANDTHREE@PLAYEROBJECTS4HEGAMEGEN
ERATESARANDOMNUMBERBETWEENANDANDTHETHREEPLAYEROBJECTSTRYTOGUESS S
IT7EDIDNTSAYITWASAREALLYEXCITINGGAME
VWDUW*DPH
#LASSES
*XHVV*DPHFODVV3OD\HUFODVV*DPH/DXQFKHUFODVV
WKH
3OD\HU WKLVSQOXPEHU
4HE,OGIC
JXHVVHGD\HU
4HE'AME,AUNCHERCLASSISWHERETHEAPPLICATIONSTARTSITHASTHEMAIN METHOD QXPEHU
)NTHEMAIN METHODA'UESS'AMEOBJECTISCREATEDANDITSSTART'AME METHOD PHWK
PDNLQJRGIRU
ISCALLED JXHVV
4HE'UESS'AMEOBJECTSSTART'AME METHODISWHERETHEENTIREGAMEPLAYSOUT JXHVV D

)TCREATESTHREEPLAYERSTHENhTHINKSvOFARANDOMNUMBERTHETARGETFORTHEPLAYERS
TOGUESS )TTHENASKSEACHPLAYERTOGUESSCHECKSTHERESULTANDEITHERPRINTSOUT
INFORMATIONABOUTTHEWINNINGPLAYERS ORASKSTHEMTOGUESSAGAIN
FKDSWHU
FODVVHVDQGREMHFWV
SXEOLFFODVV*XHVV*DPH^ *XHVV*DPHKDVW HH
3OD\HUS YDULDEOHVIRUWKHKU
W KU
LQVWDQFH
3OD\HUS REMHFWV HH3OD\HU
3OD\HUS
SXEOLFYRLGVWDUW*DPH^ FUHDWHWKUHH3OD\
S QHZ3OD\HU
DVVLJQWKHPWRWKHHUWRE
KU
MHFWVDQG
HH
S QHZ3OD\HU
LQVWDQFHYDULDEOHV 3OD\HU
S QHZ3OD\HU

LQWJXHVVS GHFODUHWKUHHYDULDEOHVWRKROGWKH
LQWJXHVVS
LQWJXHVVS
WKUHHJXHVVHVWKH3OD\HUVP DNH
ERROHDQSLV5LJKW IDOVH
GHFODUHWKUHHYDULDEOHVWRKROGDWUXH
IDOVHEDVHGRQWKHSOD\HU·VDQVZHU RU
LQWWDUJHW1XPEHU LQW0DWKUDQGRP PDNHD¶WDUJHW·QXPEHUWKDWWKH
6\VWHPRXWSULQWOQ³,¶PWKLQNLQJRIDQXPEHUEHWZHHQDQG´ SOD\HUVKDYHWRJXHVV
ZKLOHWUXH^
6\VWHPRXWSULQWOQ³1XPEHUWRJXHVVLV³WDUJHW1XPEHU
SJXHVV
SJXHVV
FDOOHDFKSOD\HU·VJXHVVPHWKRG
SJXHVV
JXHVVS SQXPEHU
6\VWHPRXWSULQWOQ³3OD\HURQHJXHVVHG³JXHVVS
JXHVVS SQXPEHU JHWHDFKSOD\HU·VJXHVVWKHUHVXOWRI LU
6\VWHPRXWSULQWOQ³3OD\HUWZRJXHVVHG³JXHVVS JXHVVPHWKRGUXQQLQJE\DFFHVVLQJWWKH
KH
JXHVVS SQXPEHU QXPEHUYDULDEOHRIHDFKSOD\HU
6\VWHPRXWSULQWOQ³3OD\HUWKUHHJXHVVHG³JXHVVS

LIJXHVVS WDUJHW1XPEHU^
SLV5LJKW WUXH
` FKHFNHDFKSOD\HU·VJXHVVWRVHHLILWPDWFKHV
LIJXHVVS WDUJHW1XPEHU^ WKHWDUJHWQXPEHU,IDSOD\HULVULJKW
SLV5LJKW WUXH WKHQVHWWKDWSOD\HU·VYDULDEOHWREHWUXH
` UHPHPEHUZHVHWLWIDOVHE\GHIDXOW
LIJXHVVS WDUJHW1XPEHU^
SLV5LJKW WUXH
`
LISOD\HURQH25SOD\HUWZR25SOD\HUWKUHHLVULJ
LISLV5LJKW__SLV5LJKW__SLV5LJKW^
WKH__RSHUDWRUPHDQV25 KW

6\VWHPRXWSULQWOQ³:HKDYHDZLQQHU´
6\VWHPRXWSULQWOQ³3OD\HURQHJRWLWULJKW"³SLV5LJKW
6\VWHPRXWSULQWOQ³3OD\HUWZRJRWLWULJKW"³SLV5LJKW
6\VWHPRXWSULQWOQ³3OD\HUWKUHHJRWLWULJKW"³SLV5LJKW
6\VWHPRXWSULQWOQ³*DPHLVRYHU´
EUHDNJDPHRYHUVREUHDNRXWRIWKHORRS
RWKHUZLV
SOD\HUVIHRUVDWD\LQWKHORRSDQGDVN
`HOVH^
ZHPXVWNHHSJRLQJEHFDXVHQRERG\JRWLWULJKW
6\VWHPRXWSULQWOQ³3OD\HUVZLOOKDYHWRWU\DJDLQ´
QRWKHUJXHVV WKH
`HQGLIHOVH
`HQGORRS
`HQGPHWKRG
`HQGFODVV
\RXDUHKHUH
*XHVVLQJ*DPH
:]VVQVO\PM/]M[[QVO/IUM
SXEOLFFODVV3OD\HU^
LQWQXPEHU ZKHUHWKHJXHVVJRHV

SXEOLFYRLGJXHVV^ /UTPUTITWILLBEDIFFERENTEACHTIMEYOURUNIT
QXPEHU LQW0DWKUDQGRP
6\VWHPRXWSULQWOQ³,¶PJXHVVLQJ³ )LOH(GLW:LQGRZ+HOS([SORGH
QXPEHU MDYD*DPH/DXQFKHU
`
` ,¶PWKLQNLQJRIDQXPEHUEHWZHHQDQG
1XPEHUWRJXHVVLV
SXEOLFFODVV*DPH/DXQFKHU^ ,¶PJXHVVLQJ
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ ,¶PJXHVVLQJ
*XHVV*DPHJDPH QHZ*XHVV*DPH
JDPHVWDUW*DPH ,¶PJXHVVLQJ
` 3OD\HURQHJXHVVHG
`
3OD\HUWZRJXHVVHG
3OD\HUWKUHHJXHVVHG
3OD\HUVZLOOKDYHWRWU\DJDLQ
-DYDWDNHVRXWWKH
*DUEDJH 1XPEHUWRJXHVVLV
,¶PJXHVVLQJ
%ACHTIMEANOBJECTISCREATED
IN*AVAITGOESINTOANAREAOF ,¶PJXHVVLQJ
MEMORYKNOWNAS4HE(EAP ,¶PJXHVVLQJ
!LLOBJECTSNOMATTERWHENWHERE
3OD\HURQHJXHVVHG
ORHOWTHEYRECREATEDnLIVEONTHE
HEAP"UTITSNOTJUSTANYOLDMEMORY 3OD\HUWZRJXHVVHG
HEAPTHE*AVAHEAPISACTUALLYCALLEDTHE 3OD\HUWKUHHJXHVVHG
'ARBAGE #OLLECTIBLE(EAP7HENYOU
CREATEANOBJECT*AVAALLOCATESMEMORY
3OD\HUVZLOOKDYHWRWU\DJDLQ
SPACEONTHEHEAPACCORDINGTOHOW 1XPEHUWRJXHVVLV
MUCHTHATPARTICULAROBJECTNEEDS!N ,¶PJXHVVLQJ
OBJECTWITHSAYINSTANCEVARIABLES
WILLPROBABLYNEEDMORESPACETHANAN ,¶PJXHVVLQJ
OBJECTWITHONLYTWOINSTANCEVARIABLES ,¶PJXHVVLQJ
"UTWHATHAPPENSWHENYOUNEEDTO 3OD\HURQHJXHVVHG
RECLAIMTHATSPACE(OWDOYOUGETAN
OBJECTOUTOFTHEHEAPWHENYOUREDONE 3OD\HUWZRJXHVVHG
WITHIT*AVAMANAGESTHATMEMORY 3OD\HUWKUHHJXHVVHG
FORYOU7HENTHE*6-CAN@SEETHATAN
:HKDYHDZLQQHU
OBJECTCANNEVERBEUSEDAGAINTHAT
OBJECTBECOMESELIGIBLEFORGARBAGE 3OD\HURQHJRWLWULJKW"WUXH
COLLECTION!NDIFYOURERUNNINGLOWON 3OD\HUWZRJRWLWULJKW"IDOVH
MEMORYTHE'ARBAGE#OLLECTORWILLRUN
THROWOUTTHEUNREACHABLEOBJECTSAND 3OD\HUWKUHHJRWLWULJKW"IDOVH
FREEUPTHESPACESOTHATTHESPACECAN *DPHLVRYHU
BEREUSED)NLATERCHAPTERSYOULLLEARN
MOREABOUTHOWTHISWORKS
FKDSWHU
FODVVHVDQGREMHFWV
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: 7HATIF)NEEDGLOBAL Q: 7HATISA*AVAPROGRAM
VARIABLESANDMETHODS(OW 7HATDOYOUACTUALLYDELIVER
DO)DOTHATIFEVERYTHINGHASTO
GOINACLASS
A: !*AVAPROGRAMISAPILE
0DNH LW 6WLF
A: 4HEREISNTACONCEPTOF
OFCLASSESORATLEASTONECLASS
)NA*AVAAPPLICATIONONEOF
N
@GLOBALVARIABLESANDMETHODSIN THECLASSESMUSTHAVEAMAIN
!CLASSISLI
A*AVA//PROGRAM)NPRACTICAL METHODUSEDTOSTART UPTHE KEARECIP
E
USEHOWEVERTHEREARETIMES PROGRAM3OASAPROGRAMMER /BJECTSA
RELIKE
WHENYOUWANTAMETHODOR YOUWRITEONEORMORECLASSES COOKIES
ACONSTANT TOBEAVAILABLE !NDTHOSECLASSESAREWHATYOU
TOANYCODERUNNINGINANY DELIVER)FTHEEND USERDOESNT
PARTOFYOURPROGRAM4HINK HAVEA*6-THENYOULLALSO
OFTHEUDQGRPMETHODIN NEEDTOINCLUDETHATWITH
THE0HRASE / -ATICAPPITSA YOURAPPLICATIONSCLASSES
METHODTHATSHOULDBECALLABLE SOTHATTHEYCANRUNYOUR
FROMANYWHERE/RWHATABOUT PROGRAM4HEREAREANUMBER
ACONSTANTLIKEPI9OULLLEARN OFINSTALLERPROGRAMSTHAT
INCHAPTERTHATMARKING LETYOUBUNDLEYOURCLASSES
AMETHODASSXEOLFAND WITHAVARIETYOF*6-SSAYFOR
VWDWLFMAKESITBEHAVEMUCH DIFFERENTPLATFORMS ANDPUTITALL
LIKEA@GLOBAL!NYCODEINANY ONA#$ 2/-4HENTHEEND USER :MDD=LHGAFLK
CLASSOFYOURAPPLICATIONCAN CANINSTALLTHECORRECTVERSIONOF
THE*6-ASSUMINGTHEYDONT
2EMHFWRULHQWHGSURJUDPPLQJOHWV\RXH[WHQG
ACCESSAPUBLICSTATICMETHOD
ALREADYHAVEITONTHEIRMACHINE
DSURJUDPZLWKRXWKDYLQJWRWRXFKSUHYLRXVO\
!NDIFYOUMARKAVARIABLEAS
SXEOLFVWDWLFAND¿QDO WHVWHGZRUNLQJFRGH
nYOUHAVEESSENTIALLYMADEA $OO-DYDFRGHLVGHILQHGLQDFODVV
GLOBALLY AVAILABLECONSTANT
Q: 7HATIF)HAVEAHUNDRED $FODVVGHVFULEHVKRZWRPDNHDQREMHFWRI
WKDWFODVVW\SH$FODVVLVOLNHDEOXHSULQW
CLASSES/RATHOUSAND)SNT
Q: 4HENHOWISTHISOBJECT
THATABIGPAINTODELIVER
ALLTHOSEINDIVIDUALlLES
$QREMHFWFDQWDNHFDUHRILWVHOI\RXGRQ·W
KDYHWRNQRZRUFDUHKRZWKHREMHFWGRHVLW
ORIENTEDIFYOUCANSTILLMAKE #AN)BUNDLETHEMINTOONE
$QREMHFWNQRZVWKLQJVDQGGRHVWKLQJV
GLOBALFUNCTIONSANDGLOBAL !PPLICATION4HING
DATA 7KLQJVDQREMHFWNQRZVDERXWLWVHOIDUHFDOOHG
LQVWDQFHYDULDEOHV7KH\UHSUHVHQWWKHVWDWH
A: A: 9ESITWOULDBEABIG RIDQREMHFW

&IRSTOFALLEVERYTHING PAINTODELIVERAHUGEBUNCHOF 7KLQJVDQREMHFWGRHVDUHFDOOHGPHWKRGV
IN*AVAGOESINACLASS3OTHE INDIVIDUALFILESTOYOUREND USERS 7KH\UHSUHVHQWWKHEHKDYLRURIDQREMHFW
CONSTANTFORPIANDTHEMETHOD BUTYOUWONTHAVETO9OUCAN
FORUDQGRPALTHOUGHBOTH PUTALLOFYOURAPPLICATIONFILES :KHQ\RXFUHDWHDFODVV\RXPD\DOVRZDQW
PUBLICANDSTATICAREDEFINED INTOA*AVA!RCHIVEnAJARFILEn WRFUHDWHDVHSDUDWHWHVWFODVVZKLFK\RX·OO
WITHINTHE0DWKCLASS!NDYOU THATSBASEDONTHEPKZIPFORMAT XVHWRFUHDWHREMHFWVRI\RXUQHZFODVVW\SH
MUSTKEEPINMINDTHATTHESE )NTHEJARFILEYOUCANINCLUDE $FODVVFDQLQKHULWLQVWDQFHYDULDEOHVDQG
STATICGLOBAL LIKE THINGSARETHE ASIMPLETEXTFILEFORMATTEDAS PHWKRGVIURPDPRUHDEVWUDFWVXSHUFODVV
EXCEPTIONRATHERTHANTHERULE SOMETHINGCALLEDAMANIFESTTHAT
IN*AVA4HEYREPRESENTAVERY DEFINESWHICHCLASSINTHATJAR $WUXQWLPHD-DYDSURJUDPLVQRWKLQJPRUH
SPECIALCASEWHEREYOUDONT HOLDSTHEMAIN METHODTHAT WKDQREMHFWV¶WDONLQJ·WRRWKHUREMHFWV
HAVEMULTIPLEINSTANCESOBJECTS SHOULDRUN
\RXDUHKHUH
H[HUFLVH%HWKH&RPSLOHU
1dQÔU_Q "%THECOMPILER
(DFKRIWKH-DYDILOHVRQWKLVSDJH
GHWHUPLQHZKHWKHUHDFKRI
WKHVHILOHVZLOOFRPSLOH
,IWKH\ZRQ·WFRPSLOH
KRZZRXOG\RXIL[WKHP
DQGLIWKH\GRFRPSLOH
ZKDWZRXOGEHWKHLURXWSXW"

FODVV7DSH'HFN^
$ Licensed by
ERROHDQFDQ5HFRUG IDOVH
YRLGSOD\7DSH^
Eduard Simons
FODVV'9'3OD\HU^
%
104038
6\VWHPRXWSULQWOQ´WDSHSOD\LQJµ ERROHDQFDQ5HFRUG IDOVH
`
YRLGUHFRUG'9'^
YRLGUHFRUG7DSH^ 6\VWHPRXWSULQWOQ´'9'UHFRUGLQJµ
6\VWHPRXWSULQWOQ´WDSHUHFRUGLQJµ `
` `
`
FODVV'9'3OD\HU7HVW'ULYH^
FODVV7DSH'HFN7HVW'ULYH^ SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^
'9'3OD\HUG QHZ'9'3OD\HU
WFDQ5HFRUG WUXH GFDQ5HFRUG WUXH
WSOD\7DSH GSOD\'9'
LIWFDQ5HFRUG WUXH^ LIGFDQ5HFRUG WUXH^

WUHFRUG7DSH GUHFRUG'9'
` `
` `
` `
FKDSWHU
FODVVHVDQGREMHFWV
Code Magnets
1dQÔU_Q !*AVAPROGRAMISALLSCRAMBLEDUPON
THEFRIDGE#ANYOURECONSTRUCTTHE
CODESNIPPETSTOMAKEAWORKING*AVA
PROGRAMTHATPRODUCESTHEOUTPUTLISTED GSOD\6QDUH
BELOW3OMEOFTHECURLYBRACESFELLON
THEFLOORANDTHEYWERETOOSMALLTOPICK 'UXP.LWG QHZ'UXP.LW
UPSOFEELFREETOADDASMANYOFTHOSE
ASYOUNEED
WUXH
ERROHDQWRS+DW
WUXH
ERROHDQVQDUH
YRLGSOD\6QDUH^
EDEDQJµ
6\VWHPRXWSULQWOQÉDQJEDQJ
`
L
IGVQ
DUH WUXH
^
GSOD\
6QDUH
`
GVQDUH IDOVH
FODVV'UXP.LW7HVW'ULYH^
DW
SO D\7RS+
G
FODVV'UXP.LW^
YRLGSOD
\7RS+DW^
6\VWHP
RXWSULQWOQ
´GLQJGLQJ
)LOH(GLW:LQGRZ+HOS'DQFH
` GDGLQJµ
MDYD'UXP.LW7HVW'ULYH
EDQJEDQJEDEDQJ
GLQJGLQJGDGLQJ
\RXDUHKHUH
SX]]OH3RRO3X]]OH
SXEOLFFODVV(FKR7HVW'ULYH^
(FKRH QHZ(FKR
BBBBBBBBBBBBBBBBBBBBBBBBB
3RRO3X]]OH LQW[
9OURJOBISTOTAKECODESNIPPETSFROM ZKLOHBBBBBBBBBBB^
THEPOOLANDPLACETHEMINTOTHE
BLANKLINESINTHECODE9OUMAY HKHOOR
USETHESAMESNIPPETMORETHAN BBBBBBBBBBBBBBBBBBBBBBBBBB
ONCEANDYOUWONTNEEDTOUSE
LIBBBBBBBBBBBB^
ALLTHESNIPPETS9OURGOALISTO
MAKECLASSESTHATWILLCOMPILEAND HFRXQW HFRXQW
RUNANDPRODUCETHEOUTPUTLISTED `
LIBBBBBBBBBBBB^
/UTPUT HFRXQW HFRXQWHFRXQW
)LOH(GLW:LQGRZ+HOS,PSORGH `
MDYD(FKR7HVW'ULYH [ [
KHOORRRR `
KHOORRRR 6\VWHPRXWSULQWOQHFRXQW
KHOORRRR `
KHOORRRR `

FODVVBBBBBBBBBBBB^
LQWBBBBBBBBB
YRLGBBBBBBBBBBB^
"ONUS1UESTION
6\VWHPRXWSULQWOQ´KHOORRRR´
)FTHELASTLINEOFOUTPUTWAS `
INSTEADOFHOWWOULD `
YOUCOMPLETETHEPUZZLE
.OTE%ACHSNIPPET
FROMTHEPOOLCANBE
USEDMORETHANONCE
X X
Y X %CHO
E X 4ESTER
COUNT X ECHO EE
EE COUNT %CHOE
ECOUNT HELLO %CHOEE
%CHOENEW%CHO X
ECOUNTCOUNT
X
ECOUNTECOUNT
FKDSWHU
FODVVHVDQGREMHFWV
!BUNCHOF*AVACOMPONENTSINFULLCOSTUMEAREPLAYINGAPARTY

GAMEh7HOAM)v4HEYGIVEYOUACLUEANDYOUTRYTOGUESSWHO
THEYAREBASEDONWHATTHEYSAY!SSUMETHEYALWAYSTELLTHETRUTH
ABOUTTHEMSELVES)FTHEYHAPPENTOSAYSOMETHINGTHATCOULDBETRUE
FORMORETHANONEOFTHEMCHOOSEALLFORWHOMTHATSENTENCECAN
P , " APPLY&ILLINTHEBLANKSNEXTTOTHESENTENCEWITHTHENAMESOFONEOR
MOREATTENDEES4HEFIRSTONESONUS
KR D 4ONIGHTSATTENDEES
: #LASS-ETHOD/BJECT)NSTANCEVARIABLE
,DPFRPSLOHGIURPDMDYDILOH FODVV
0\LQVWDQFHYDULDEOHYDOXHVFDQ
EHGLIIHUHQWIURPP\EXGG\·V
YDOXHV
,EHKDYHOLNHDWHPSODWH
,OLNHWRGRVWXII
,FDQKDYHPDQ\PHWKRGV
,UHSUHVHQW¶VWDWH·
,KDYHEHKDYLRUV
,DPORFDWHGLQREMHFWV
,OLYHRQWKHKHDS
,DPXVHGWRFUHDWHREMHFWLQVWDQFHV
0\VWDWHFDQFKDQJH
,GHFODUHPHWKRGV
,FDQFKDQJHDWUXQWLPH
\RXDUHKHUH
H[HUFLVHVROXWLRQV
%HWKH&RPSLOHU
1dQÔU_Q FODVV7DSH'HFN^
%XERCISE3OLUTIONS YRLGSOD\7DSH^
6\VWHPRXWSULQWOQ´WDSHSOD\LQJµ
$ `
YRLGUHFRUG7DSH^
6\VWHPRXWSULQWOQ´WDSHUHFRUGLQJµ
`
`
&RGH0DJQHWV FODVV7DSH'HFN7HVW'ULYH^
FODVV'UXP.LW^
7DSH'HFNW QHZ7DSH'HFN
ERROHDQWRS+DW WUXH WFDQ5HFRUG WUXH
ERROHDQVQDUH WUXH WSOD\7DSH
YRLGSOD\7RS+DW^ LIWFDQ5HFRUG WUXH^

6\VWHPRXWSULQWOQ´GLQJGLQJGDGLQJµ WUHFRUG7DSH
` `
`:H·YHJRWWKHWHPSODWHQRZZHKDYH
YRLGSOD\6QDUH^ `WRPDNHDQREMHFW
6\VWHPRXWSULQWOQÉDQJEDQJEDEDQJµ
`
`
FODVV'9'3OD\HU^
FODVV'UXP.LW7HVW'ULYH^
YRLGUHFRUG'9'^
6\VWHPRXWSULQWOQ´'9'UHFRUGLQJµ

`
'UXP.LWG QHZ'UXP.LW
YRLGSOD\'9'^
GSOD\6QDUH
6\VWHPRXWSULQWOQ´'9'SOD\LQJµ
GVQDUH IDOVH
`
GSOD\7RS+DW
`
LIGVQDUH WUXH^
FODVV'9'3OD\HU7HVW'ULYH^
GSOD\6QDUH
`
'9'3OD\HUG QHZ'9'3OD\HU
`
` % GFDQ5HFRUG WUXH
GSOD\'9'
LIGFDQ5HFRUG WUXH^
GUHFRUG'9'
MDYD'UXP.LW7HVW'ULYH
`
EDQJEDQJEDEDQJ
`7KHOLQHGSOD\'9'ZRXOGQ·W
GLQJGLQJGDGLQJ
`FRPSLOHZLWKRXWDPHWKRG
FKDSWHU
FODVVHVDQGREMHFWV
0UZZLE3OLUTIONS
8WWT8]bbTM
SXEOLFFODVV(FKR7HVW'ULYH^
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ 7HOAM)
(FKRH QHZ(FKR
(FKRH QHZ(FKRWKHFRUUHFWDQVZHU ,DPFRPSLOHGIURPDMDYDILOH FODVV
RU 0\LQVWDQFHYDULDEOHYDOXHVFDQEH
(FKRH HLVWKHERQXVDQVZHU GLIIHUHQWIURPP\EXGG\·VYDOXHV REMHFW
LQW[
ZKLOH[^
,EHKDYHOLNHDWHPSODWH FODVV
HKHOOR ,OLNHWRGRVWXII REMHFWPHWKRG
HFRXQW HFRXQW
LI[ ^ ,FDQKDYHPDQ\PHWKRGV FODVVREMHFW
HFRXQW HFRXQW ,UHSUHVHQW¶VWDWH· LQVWDQFHYDULDEOH
`
LI[!^
,KDYHEHKDYLRUV REMHFWFODVV
HFRXQW HFRXQWHFRXQW ,DPORFDWHGLQREMHFWV PHWKRGLQVWDQFHYDULDEOH
`
[ [ ,OLYHRQWKHKHDS REMHFW
` ,DPXVHGWRFUHDWHREMHFW
6\VWHPRXWSULQWOQHFRXQW LQVWDQFHV FODVV
`
` 0\VWDWHFDQFKDQJH REMHFWLQVWDQFHYDULDEOH
,GHFODUHPHWKRGV FODVV
FODVV(FKR^
LQWFRXQW ,FDQFKDQJHDWUXQWLPH REMHFWLQVWDQFHYDULDEOH
YRLGKHOOR^
6\VWHPRXWSULQWOQ´KHOORRRR´ 1RWHERWKFODVVHVDQGREMHFWVDUHVDLGWRKDYHVWDWHDQGEHKDYLRU
` 7KH\·UHGHÀQHGLQWKHFODVVEXWWKHREMHFWLVDOVRVDLGWR¶KDYH·
` WKHP5LJKWQRZZHGRQ·WFDUHZKHUHWKH\WHFKQLFDOO\OLYH
)LOH(GLW:LQGRZ+HOS$VVLPLODWH
MDYD(FKR7HVW'ULYH
KHOORRRR
KHOORRRR
KHOORRRR
KHOORRRR

\RXDUHKHUH
SULPLWLYHVDQGUHIHUHQFHV
.QRZ<RXU9DULDEOHV
9DULDEOHVFRPHLQWZRIODYRUVSULPLWLYHDQGUHIHUHQFH3OFARYOUVE
USEDVARIABLESINTWOPLACESASOBJECTVWDWHINSTANCEVARIABLES ANDASORFDOVARIABLES
VARIABLESDECLAREDWITHINAMETHOD ,ATERWELLUSEVARIABLESASDUJXPHQWVVALUESSENTTOA
METHODBYTHECALLINGCODE ANDASUHWXUQW\SHVVALUESSENTBACKTOTHECALLEROFTHEMETHOD
9OUVESEENVARIABLESDECLAREDASSIMPLESULPLWLYHINTEGERVALUESTYPELQW 9OUVESEEN
VARIABLESDECLAREDASSOMETHINGMOREFRPSOH[LIKEA3TRINGORANARRAY"UTWKHUH·VJRWWDEH
PRUHWROLIHTHANINTEGERS3TRINGSANDARRAYS7HATIFYOUHAVEA0ET/WNEROBJECTWITHA$OG
INSTANCEVARIABLE/RA#ARWITHAN%NGINE)NTHISCHAPTERWELLUNWRAPTHEMYSTERIESOF*AVA
TYPESANDLOOKATWHATYOUCANDECLAREASAVARIABLEWHATYOUCANPUTINAVARIABLEANDWHATYOU
CANDOWITHAVARIABLE!NDWELLFINALLYSEEWHATLIFEISTRULYLIKEONTHEGARBAGE COLLECTIBLEHEAP
WKLVLVDQHZFKDSWHU
GHFODULQJDYDULDEOH
,MKTIZQVOIÎZQIJTM
*AVACARESABOUTTYPE)TWONTLETYOUDO
SOMETHINGBIZARREANDDANGEROUSLIKESTUFFA
'IRAFFEREFERENCEINTOA2ABBITVARIABLEWHAT
HAPPENSWHENSOMEONETRIESTOASKTHESO CALLED
2ABBITTOKRS!NDITWONTLETYOUPUTA
mOATINGPOINTNUMBERINTOANINTEGERVARIABLE
UNLESSYOUACKNOWLEDGETOTHECOMPILERTHATYOU
KNOWYOUMIGHTLOSEPRECISIONLIKEEVERYTHING
AFTERTHEDECIMALPOINT
4HECOMPILERCANSPOTMOSTPROBLEMS
5DEELWKRSSHU QHZ*LUDIIH
\SH
D Y D FD U H VDERXWW DIIH $ONTEXPECTTHATTOCOMPILE4HANKFULLY
- SXWD*LU
<RXFDQ·W LWYDULDEOH &ORALLTHISTYPE SAFETYTOWORKYOUMUSTDECLARE
LQD5DEE THETYPEOFYOURVARIABLE)SITANINTEGERA$OG
!SINGLECHARACTER6ARIABLESCOMEINTWOmAVORS
PRIMITIVEANDOBJECTREFERENCE0RIMITIVESHOLD
FUNDAMENTALVALUESTHINKSIMPLEBITPATTERNS
INCLUDINGINTEGERSBOOLEANSANDmOATINGPOINT
NUMBERS/BJECTREFERENCESHOLDWELLREFERENCES
TOOBJECTSGEEDIDNTTHATCLEARITUP
7ELLLOOKATPRIMITIVESlRSTANDTHENMOVE
ONTOWHATANOBJECTREFERENCEREALLYMEANS
"UTREGARDLESSOFTHETYPEYOUMUSTFOLLOWTWO
DECLARATIONRULES
YDULDEOHVPXVWKDYHDW\SH
"ESIDESATYPEAVARIABLENEEDSANAMESOTHAT
YOUCANUSETHATNAMEINCODE
YDULDEOHVPXVWKDYHDQDPH
LQWFRXQW
W\SH QDPH
.OTE7HENYOUSEEASTATEMENTLIKEhANOBJECT
OFTYPE8vTHINKOFTYPEANDCLASSASSYNONYMS
7ELLRElNETHATALITTLEMOREINLATERCHAPTERS
FKDSWHU
¹1¼LTQSMILW]JTMUWKPIVWUISMQ\IVQV\º 3ULPLWLYH7\SHV
7HENYOUTHINKOF*AVAVARIABLESTHINKOFCUPS#OFFEECUPSTEACUPSGIANT 7\SH%LW'HSWK 9DOXH5DQJH
CUPSTHATHOLDLOTSANDLOTSOFBEERTHOSEBIGCUPSTHEPOPCORNCOMESINAT ERROHDQDQGFKDU
THEMOVIESCUPSWITHCURVYSEXYHANDLESANDCUPSWITHMETALLICTRIMTHAT
YOULEARNEDCANNEVEREVERGOINTHEMICROWAVE BOOLEAN*6- SPECIFIC TRUEORFALSE
!VARIABLEISJUSTACUP!CONTAINER)THOLDSSOMETHING CHAR BITS TO
)THASASIZEANDATYPE)NTHISCHAPTERWEREGOINGTOLOOKlRSTATTHE QXPHULFDOODUHVLJQHG

VARIABLESCUPS THATHOLDPRIMITIVESTHENALITTLELATERWELLLOOKATCUPS LQWHJHU
THATHOLDREFERENCESTOOBJECTS3TAYWITHUSHEREONTHEWHOLECUPANALOGYAS
BYTE BITS TO
SIMPLEASITISRIGHTNOWITLLGIVEUSACOMMONWAYTOLOOKATTHINGSWHEN
THEDISCUSSIONGETSMORECOMPLEX!NDTHATLLHAPPENSOON SHORT BITS TO

0RIMITIVESARELIKETHECUPSTHEYHAVEATTHECOFFEEHOUSE)FYOUVEBEENTOA
3TARBUCKSYOUKNOWWHATWERETALKINGABOUTHERE4HEYCOMEINDIFFERENT INT BITS
SIZESANDEACHHASANAMELIKE@SHORT@TALLANDh)DLIKEA TO
@GRANDEMOCHAHALF CAFFWITHEXTRAWHIPPEDCREAMv LONG BITS HUGETOHUGE
9OUMIGHTSEETHECUPSDISPLAYEDONTHECOUNTER
SOYOUCANORDERAPPROPRIATELY ÀRDWLQJSRLQW
FLOAT BITS VARIES
DOUBLE BITS VARIES
VPDOOVKRUWWDOOJUDQGH 3ULPLWLYHGHFODUDWLRQV
ZLWKDVVLJQPHQWV
INTX
!NDIN*AVAPRIMITIVESCOMEINDIFFERENTSIZESANDTHOSESIZES
HAVENAMES7HENYOUDECLAREAVARIABLEIN*AVA X
YOUMUSTDECLAREITWITHASPECIlCTYPE4HE BYTEB
FOURCONTAINERSHEREAREFORTHEFOUR BOOLEANIS&UNTRUE
INTEGERPRIMITIVESIN*AVA
DOUBLED
CHARC@F
ORQJLQWVKRUWE\WH INTZX
%ACHCUPHOLDSAVALUESOFOR*AVAPRIMITIVESRATHERTHANSAYINGh)DLIKEA BOOLEANIS0UNK2OCK
TALLFRENCHROASTvYOUSAYTOTHECOMPILERh)DLIKEANINTVARIABLEWITHTHE
IS0UNK2OCKFALSE
NUMBERPLEASEv%XCEPTFORONETINYDIFFERENCEIN*AVAYOUALSOHAVETO
GIVEYOURCUPANAME3OITSACTUALLYh)DLIKEANINTPLEASEWITHTHEVALUE BOOLEANPOWER/N
OFANDNAMETHEVARIABLEHEIGHTv%ACHPRIMITIVEVARIABLEHASAlXED POWER/NIS&UN
NUMBEROFBITSCUPSIZE 4HESIZESFORTHESIXNUMERICPRIMITIVESIN*AVA LONGBIG
ARESHOWNBELOW
FLOATFF

RWWDKDYHWKDW
1RWHWKH¶I·* FDXVH-DYDWKLQNV
ZLWKD
IORDWEH WLV
DIORDWLQJSRLQ
E\WHVKRUWLQWORQJ ÁRDWGRXEOH DQ\W ZLWK \RXXVH¶I·
KL QJ
0).+*.,+*., DGRXEOHXQOHVV
\RXDUHKHUH
SULPLWLYHDVVLJQPHQW
AW]ZMITTaLWV¼\_IV\\W[XQTT\PI\ 6KDUSHQ \RXU SHQFLO

"ESURETHEVALUECANlTINTOTHEVARIABLE
9OUCANTPUTALARGEVALUEINTOA
SMALLCUP 4HECOMPILERWONTLETYOUPUT
AVALUEFROMALARGECUPINTO
7ELL/+YOUCANBUTYOULL ASMALLONE"UTWHATABOUT
LOSESOME9OULLGETASWESAY THEOTHERWAYPOURINGA
SPILLAGE4HECOMPILERTRIESTO SMALLCUPINTOABIGONE.O
HELPPREVENTTHISIFITCANTELL PROBLEM
FROMYOURCODETHATSOMETHINGS "ASEDONWHATYOUKNOW
NOTGOINGTOlTINTHECONTAINER ABOUTTHESIZEANDTYPEOFTHE
VARIABLECUP YOUREUSING PRIMITIVEVARIABLESSEEIFYOU
CANFIGUREOUTWHICHOFTHESE
&OREXAMPLEYOUCANTPOURAN
Licensed by
ARELEGALANDWHICHARENT
INT FULLOFSTUFFINTOABYTE SIZED 7EHAVENTCOVEREDALLTHE
CONTAINERASFOLLOWS RULESYETSOONSOMEOFTHESE
LQW[ YOULLHAVETOUSEYOURBEST
JUDGMENT4IP4HECOMPILER
E\WHE [
Eduard Simons
ALWAYSERRSONTHESIDEOF
SAFETY
ZRQ¶WZRUN
&ROMTHEFOLLOWINGLIST#IRCLE
THESTATEMENTSTHATWOULDBE
7HYDOESNTTHISWORKYOUASK!FTERALLTHEVALUEOFXISANDISDElNITELY
104038
LEGALIFTHESELINESWEREINA
SMALLENOUGHTOlTINTOABYTE9OUKNOWTHATANDWEKNOWTHATBUTALLTHE SINGLEMETHOD
COMPILERCARESABOUTISTHATYOURETRYINGTOPUTABIGTHINGINTOASMALLTHING
ANDTHERESTHEPOSSIBILITYOFSPILLING$ONTEXPECTTHECOMPILERTOKNOWWHATTHE LQW[
VALUEOFXISEVENIFYOUHAPPENTOBEABLETOSEEITLITERALLYINYOURCODE ERROHDQERR [
9OUCANASSIGNAVALUETOAVARIABLEINONEOFSEVERALWAYSINCLUDING
LQWJ
NTYPEALITERALVALUEAFTERTHEEQUALSSIGNXIS'OODTRUEETC
LQW\ J
NASSIGNTHEVALUEOFONEVARIABLETOANOTHERXY
\ \
NUSEANEXPRESSIONCOMBININGTHETWOXY
)NTHEEXAMPLESBELOWTHELITERALVALUESAREINBOLDITALICS VKRUWV
LQWVL]H GHFODUHDQLQWQDPHGVL]HDVVLJQLWWKHYDOXH V \

FKDULQLWLDO µM¶ GHFODUHDFKDUQDPHGLQLWLDODVVLJQLWWKHYDOXH¶M· E\WHE
GRXEOHG GHFODUHDGRXEOHQDPHGGDVVLJQLWWKHYDOXH
E\WHY E
ERROHDQLV&UD]\ GHFODUHDERROHDQQDPHGLV&UD]\QRDVVLJQPHQW
VKRUWQ
LV&UD]\ WUXH DVVLJQWKHYDOXHWUXHWRWKHSUHYLRXVO\GHFODUHGLV&UD]\
LQW\ [ GHFODUHDQLQWQDPHG\DVVLJQLWWKHYDOXHWKDWLVWKHVXP Y Q
RIZKDWHYHU[LVQRZSOXV
E\WHN
FKDSWHU
*IKSI_IaNZWU\PI\SMa_WZL
9OUKNOWYOUNEEDANAMEANDATYPEFORYOURVARIABLES
9OUALREADYKNOWTHEPRIMITIVETYPES
"UTWHATCANYOUUSEASNAMES4HERULESARESIMPLE9OU
CANNAMEACLASSMETHODORVARIABLEACCORDINGTOTHE
WLFN
0DNH LW 6
FOLLOWINGRULESTHEREALRULESARESLIGHTLYMOREmEXIBLE
BUTTHESEWILLKEEPYOUSAFE

YPESARE ATDOUB
LE
Q ,WPXVWVWDUWZLWKDOHWWHUXQGHUVFRUHBRU RI MITIVET
GROODUVLJQ<RXFDQ·WVWDUWDQDPHZLWKD 4HEE IG H T P
O RT I N T LONGFLO
TESH HEM
CHARBY BERINGT
QXPEHU BOOLEAN O N IC F O RREMEM
M
SAMNE RGE
Q $IWHUWKHÀUVWFKDUDFWHU\RXFDQXVHQXPEHUVDV !NDHERE )NGEST,A
ZHOO-XVWGRQ·WVWDUWLWZLWKDQXPEHU A RS 3 H OULDNT
L"E
"E#AREFU ER
Q ,WFDQEHDQ\WKLQJ\RXOLNHVXEMHFWWRWKRVHWZR G S VENBETT
& URR Y$O O W N I T LLSTICKE
UXOHVMXVWVRORQJDVLWLVQ·WRQHRI-DYD·VUHVHUYHG OUR
AKEUPY
)FYOUM ?
ZRUGV ,?&?$
? # ? " ?3?)?
THERTHINGS THATTHECOMPILERRECOGNIZES "
AREKEYWORDSANDO
!NDIFYOUREALLYWANTTOPLAYCONFUSE A COMPILERTHENJUSTTRY
USINGARESERVEDWORDASANAME
9OUVEALREADYSEENSOMERESERVEDWORDSWHENWELOOKEDAT
1RPDWWHUZKDW
WRITINGOURlRSTMAINCLASS GR Q·W \RXKHDUGRQRW,UHSHDW
IRU\RXVHDQ\RI GRQRWOHWPHLQJHVW
XURZQ WKHVH DQRWKHUODUJHIXUU\GRJ
SXEOLFVWDWLFYRLG QDPHV
!NDTHEPRIMITIVETYPESARERESERVEDASWELL
ERROHDQFKDUE\WHVKRUWLQWORQJÀRDWGRXEOH
"UTTHEREAREALOTMOREWEHAVENTDISCUSSEDYET%VENIFYOUDONT
NEEDTOKNOWWHATTHEYMEANYOUSTILLNEEDTOKNOWYOUCANTUSE
@EMYOURSELF$ONOTnUNDERANYCIRCUMSTANCESnTRYTOMEMORIZETHESE
NOW4OMAKEROOMFORTHESEINYOURHEADYOUDPROBABLYHAVETO
LOSESOMETHINGELSE,IKEWHEREYOURCARISPARKED$ONTWORRYBY
THEENDOFTHEBOOKYOULLHAVEMOSTOFTHEMDOWNCOLD
<PQ[\IJTMZM[MZ ^ML
Zggd]Yf Zql] [`Yj \gmZd] ÛgYl afl dgf_ k`gjl hmZda[ hjanYl]
hjgl][l]\ YZkljY[l ÚfYd fYlan] klYla[ klja[l^h kqf[`jgfar]\ ljYfka]fl ngdYlad] a^
]dk] \g oàd] koal[` [Yk] \]^Ymdl ^gj Zj]Yc [gflafm] Ykk]jl
[dYkk ]pl]f\k aehd]e]flk aehgjl afklYf[]g^ afl]j^Y[] f]o hY[cY_] kmh]j làk
[Yl[` ÚfYddq ljq l`jgo l`jgok j]lmjf nga\ [gfkl _glg ]fme
-DYD¶VNH\ZRUGVDQGRWKHUUHVHUYHGZRUGVLQQRXVHIXORUGHU,I\RXXVHWKHVHIRUQDPHVWKHFRPSLOHUZLOOEHYHU\YHU\XSVHW
\RXDUHKHUH
REMHFWUHIHUHQFHV
+WV\ZWTTQVOaW]Z,WOWJRMK\
9OUKNOWHOWTODECLAREAPRIMITIVEVARIABLEANDASSIGNITA
VALUE"UTNOWWHATABOUTNON PRIMITIVEVARIABLES)NOTHER
WORDSWHATABOUTOBJECTS 'RJG QHZ'RJ
N 7KHUHLVDFWXDOO\QRVXFKWKLQJDVDQREMHFWYDULDEOH

G EDUN
N 7KHUH·VRQO\DQREMHFWUHIHUHQFHYDULDEOH WKLQNRIWKLV
N $QREMHFWUHIHUHQFHYDULDEOHKROGVELWVWKDWUHSUHVHQWD
ZD\WRDFFHVVDQREMHFW OLNHWKLV
N ,WGRHVQ·WKROGWKHREMHFWLWVHOIEXWLWKROGVVRPHWKLQJ
OLNHDSRLQWHU2UDQDGGUHVV([FHSWLQ-DYDZHGRQ·W
UHDOO\NQRZZKDWLVLQVLGHDUHIHUHQFHYDULDEOH:HGR
NQRZWKDWZKDWHYHULWLVLWUHSUHVHQWVRQHDQGRQO\RQH
REMHFW$QGWKH-90NQRZVKRZWRXVHWKHUHIHUHQFHWR
JHWWRWKHREMHFW
9OUCANTSTUFFANOBJECTINTOAVARIABLE7EOFTENTHINKOF
ITTHATWAYWESAYTHINGSLIKEh)PASSEDTHE3TRINGTOTHE
3YSTEMOUTPRINTLN METHODv/Rh4HEMETHODRETURNSA$OGv
ORh)PUTANEW&OOOBJECTINTOTHEVARIABLENAMEDMY&OOv
"UTTHATSNOTWHATHAPPENS4HEREARENTGIANT
EXPANDABLECUPSTHATCANGROWTOTHESIZEOFANY 7KLQNRID'RJ
OBJECT/BJECTSLIVEINONEPLACEANDONEPLACE UHIHUHQFHYDULDEOHDV
ONLYTHEGARBAGECOLLECTIBLEHEAP9OULL
LEARNMOREABOUTTHATLATERINTHISCHAPTER D'RJUHPRWHFRQWURO
!LTHOUGHAPRIMITIVEVARIABLEISFULLOF <RXXVHLWWRJHWWKH
BITSREPRESENTINGTHEACTUALVALUEOFTHE
REMHFWWRGRVRPHWKLQJ
VARIABLEANOBJECTREFERENCEVARIABLEISFULL
OFBITSREPRESENTINGAWAYTOGETTOTHE LQYRNHPHWKRGV
OBJECT
9OUUSETHEDOTOPERATOR
ONAREFERENCEVARIABLETOSAY
hUSETHETHINGBEFORETHEDOTTO
GETMETHETHINGAFTERTHEDOTv&OR
EXAMPLE
P\'RJEDUN
MEANShUSETHEOBJECTREFERENCEDBYTHEVARIABLEMY$OGTO
INVOKETHEBARK METHODv7HENYOUUSETHEDOTOPERATORON
ANOBJECTREFERENCEVARIABLETHINKOFITLIKEPRESSINGABUTTON
ONTHEREMOTECONTROLFORTHATOBJECT
FKDSWHU
7KHVWHSVRIREMHFW
GHFODUDWLRQFUHDWLRQDQG
DVVLJQPHQW

E\WHVKRUWLQWORQJ UHIHUHQFH

'RJP\'RJ QHZ'RJ
0).+*., Zal\]hl`fglj]d]nYfl!
)VWJRMK\ZMNMZMVKMQ[R][\ 'HFODUHDUHIHUHQFH

IVW\PMZÎZQIJTMÎT]M YDULDEOH
3OMETHINGTHATGOESINACUP 'RJP\'RJ QHZ'RJ

/NLYTHISTIMETHEVALUEISAREMOTECONTROL 4ELLSTHE*6-TOALLOCATESPACEFORA
REFERENCEVARIABLEANDNAMESTHAT
8ZQUQ\Q^M>IZQIJTM VARIABLEMY$OG4HEREFERENCEVARIABLE eq<g_

ISFOREVEROFTYPE$OG)NOTHERWORDS
E\WH[ AREMOTECONTROLTHATHASBUTTONSTO
4HEBITSREPRESENTINGGO
SULPLWLYH CONTROLA$OGBUTNOTA#ATORA"UTTON 'RJ
INTOTHEVARIABLE
YDOXH ORA3OCKET
E\WH
:MNMZMVKM>IZQIJTM &UHDWHDQREMHFW
HFW
'RJP\'RJ QHZ'RJ
EM
'RJP\'RJ QHZ'RJ 'RJR

4HEBITSREPRESENTINGAWAYTOGETTO 4ELLSTHE*6-TOALLOCATESPACEFORA
THE$OGOBJECTGOINTOTHEVARIABLE NEW$OGOBJECTONTHEHEAPWELL
UHIHUHQFH LEARNALOTMOREABOUTTHATPROCESS
4HE$OGOBJECTITSELFDOESNOTGOINTO YDOXH ESPECIALLYINCHAPTER
THEVARIABLE 'RJ 'RJREMHFW
PbmaikbfbmboôZkbZ[e^l%maôZen^h_maôZkb&
Z[e^bl'''maôZen^!.%&+/'0%Z"' /LQNWKHREMHFW
Pbmak^_^k^g\ôZkbZ[e^l%maôZen^h_ma^ DQGWKHUHIHUHQFH
oZkbZ[e^bl'''[bmlkîk^l^gmbg`ZpZrmh`^mmh 'RJP\'RJ QHZ'RJ
Zli^\bÛ\h[c^\m'
!SSIGNSTHENEW$OGTOTHEREFERENCE
Rhn]hgmdghp!hk\Zk^"ahpZgriZkmb\neZk VARIABLEMY$OG)NOTHERWORDS
COFbfie^f^gmlh[c^\mk^_^k^g\^l'Lnk^%ma^r PROGRAMSTHEREMOTECONTROL
fbàm[^Zihbgm^kmhZihbgm^kmh'''[nmô^g
b_rhndghp%rhnlmbee\Zgmnl^ma^[bml_hk 'RJREMHFW
Zgrmabg`hma^kmaZgZ\\^llbg`Zgh[c^\m'
eq<g_
:HGRQ¶WFDUHKRZPDQ\¶VDQG¶VWKHUHDUHLQDUHIHUHQFHYDULDEOH,W¶VXSWRHDFK
-90DQGWKHSKDVHRIWKHPRRQ 'RJ
\RXDUHKHUH
REMHFWUHIHUHQFHV
WKHUH DUH QR
'XPE 4XHVWLRQV ,CXC'ZRQUGF
Q: (OWBIGISAREFERENCE 7KLVZHHN·VLQWHUYLHZ
VARIABLE
2EMHFW5HIHUHQFH
A: 9OUDONTKNOW5NLESS
YOURECOZYWITHSOMEONEONTHE
+HDG)LUVW;W\MTT][_PI\¼[TQNMTQSMNWZIVWJRMK\ZMNMZMVKM'
5HIHUHQFH8ZM\\a[QUXTMZMITTa1¼UIZMUW\MKWV\ZWTIVL1KIVJMXZWOZIUUML\W
*6-SDEVELOPMENTTEAMYOU KWV\ZWTLQNNMZMV\WJRMK\[
DONTKNOWHOWAREFERENCEIS
REPRESENTED4HEREAREPOINTERS
+HDG)LUVW,WaW]UMIVLQNNMZMV\WJRMK\[M^MV_PQTMaW]¼ZMZ]VVQVO'4QSMKIVaW]
INTHERESOMEWHEREBUTYOU ZMNMZ\WI,WOIVL\PMVÅ^MUQV]\M[TI\MZZMNMZ\WI+IZ'
CANTACCESSTHEM9OUWONT 5HIHUHQFH7N KW]Z[MVW\7VKM1¼ULMKTIZML\PI\¼[Q\1N 1¼UI,WOZMUW\MKWV\ZWT
NEEDTO/+IFYOUINSISTYOU \PMV1¼TTVM^MZJMIJTM\WXWQV\WWX[·UaJIL_M¼ZMVW\[]XXW[ML\W[IaXWQV\1UMIVZMNMZ
MIGHTASWELLJUSTIMAGINEIT
\WIVa\PQVOJ]\I,WO
TOBEA BITVALUE "UTWHEN
YOURETALKINGABOUTMEMORY +HDG)LUVW,WM[\PI\UMIVaW]KIVZMNMZ\WWVTaWVM,WO'
ALLOCATIONISSUESYOUR"IG
5HIHUHQFH6W1KIVJMZMNMZZQVO\WWVM,WOIVL\PMVÅ^MUQV]\M[TI\MZ1KIVZMNMZ\W
#ONCERNSHOULDBEABOUTHOW
MANYOBJECTSASOPPOSEDTO [WUMW\PMZ,WO)[TWVOI[Q\¼[I,WO1KIVJMZMLQZMK\MLTQSMZMXZWOZIUUQVOaW]ZZMUW\M
OBJECTREFERENCES YOURECREATING \WILQNNMZMV\<>\WQ\=VTM[[VWVM^MZUQVL
ANDHOWBIGTHEYTHEOBJECTS +HDG)LUVW6W\MTTUM?PI\_MZMaW]OWVVI[Ia'
REALLYARE
5HIHUHQFH1LWV¼\\PQVSaW]_IV\\WOM\QV\W\PQ[VW_J]\1¼TTR][\OQ^MaW]\PM[PWZ\
^MZ[QWV·QN 1¼UUIZSMLI[¿QDO\PMVWVKM1IUI[[QOVMLI,WO1KIVVM^MZJMZMXZW
OZIUUML\WIVa\PQVOMT[MJ]\\PI\WVMIVLWVTa,WO1VW\PMZ_WZL[VWW\PMZWJRMK\KIV
Q: 3ODOESTHATMEANTHAT JMI[[QOVML\WUM
ALLOBJECTREFERENCESARETHE +HDG)LUVWAW]¼ZMZQOP\_MLWV¼\_IV\\W\ITSIJW]\\PI\VW_73[W]VTM[[aW]¼ZM
SAMESIZEREGARDLESSOFTHESIZE
¿QDO\PMVaW]KIVZMNMZ\WWVM,WOIVL\PMVZMNMZ\WILQNNMZMV\,WOTI\MZ+IVaW]M^MZ
OFTHEACTUALOBJECTSTOWHICH
ZMNMZ\WVW\PQVOI\ITT'1[Q\XW[[QJTM\WVW\JMXZWOZIUUML\WIVa\PQVO'
THEYREFER
5HIHUHQFHAM[J]\Q\LQ[\]ZJ[UM\W\ITSIJW]\Q\
A: 9EP!LLREFERENCESFORA
GIVEN*6-WILLBETHESAME
+HDG)LUVW?PaQ[\PI\'
5HIHUHQFH*MKI][MQ\UMIV[1¼UQXOOIVL\PI\¼[]X[M\\QVO\WUM
SIZEREGARDLESSOFTHEOBJECTS
+HDG)LUVWAW]UMIVJMKI][M\PMVaW]PI^MVWÎT]M'
THEYREFERENCEBUTEACH*6-
MIGHTHAVEADIFFERENTWAYOF 5HIHUHQFH7PQXOOQ[IÎT]M1¼U[\QTTIZMUW\MKWV\ZWTJ]\Q\¼[TQSMaW]JZW]OP\
REPRESENTINGREFERENCESSO PWUMIVM_]VQ^MZ[ITZMUW\MKWV\ZWTIVLaW]LWV¼\PI^MI<>1¼UVW\XZWOZIUUML\W
REFERENCESONONE*6-MAYBE KWV\ZWTIVa\PQVO<PMaKIVXZM[[UaJ]\\WV[ITTLIaTWVOJ]\VW\PQVOOWWLPIXXMV[1
SMALLERORLARGERTHANREFERENCES R][\NMMT[W][MTM[[)_I[\MWN JQ\[/ZIV\MLVW\\PI\UIVaJQ\[J]\[\QTT)VL\PI\¼[VW\
ONANOTHER*6-
\PM_WZ[\XIZ\1N 1IU\PMWVTaZMNMZMVKM\WIXIZ\QK]TIZWJRMK\IVL\PMV1¼U[M\\WQXOO
Q: #AN)DOARITHMETICONA
LMXZWOZIUUMLQ\UMIV[\PI\VW_VWJWLaKIVOM\\W\PI\WJRMK\1PILJMMVZMNMZZQVO\W
+HDG)LUVW)VL\PI\¼[JILJMKI][M
REFERENCEVARIABLEINCREMENTIT
YOUKNOWn#STUFF 5HIHUHQFHAW]PI^M\WI[S'0MZM1¼^MLM^MTWXMLIZMTI\QWV[PQX_Q\P\PQ[WJRMK\IV
QV\QUI\MKWVVMK\QWVIVL\PMV\PM\QMQ[[]LLMVTaKZ]MTTa[M^MZML)VL1_QTTVM^MZ[MM
\PI\WJRMK\IOIQVJMKI][MVW_Q\¼[MTQOQJTMNWZCXZWL]KMZK]M\ZIOQKU][QKEOIZJIOMKWTTMK\QWV
A: .OPE3AYITWITHMEAGAIN
h*AVAISNOT#v
;VQNN*]\LWaW]\PQVSXZWOZIUUMZ[M^MZKWV[QLMZ\PI\';VQN?Pa_PaKIV¼\1JMIXZQUQ
\Q^M'1PI\MJMQVOIZMNMZMVKM<PMZM[XWV[QJQTQ\aITT\PMJZWSMVI\\IKPUMV\[
FKDSWHU
4QNMWV\PMOIZJIOMKWTTMK\QJTMPMIX

%RRNE QHZ%RRN
%R
RNREMHFW

%RRNF QHZ%RRN
$ECLARETWO"OOKREFERENCE
EAP
VARIABLES#REATETWONEW"OOK Z %R
RNREMHFW
LEH
OBJECTS!SSIGNTHE"OOKOBJECTSTO
THEREFERENCEVARIABLES
C TIB
%RRN
L LE
4HETWO"OOKOBJECTSARENOWLIVING
CO
ONTHEHEAP
E
; AG
B
2EFERENCES
AR
G
/BJECTS
%RRN
%RRNG F
$ECLAREANEW"OOKREFERENCEVARIABLE
2ATHERTHANCREATINGANEWTHIRD"OOK
OBJECTASSIGNTHEVALUEOFVARIABLECTO
%R
RNREMHFW

VARIABLED"UTWHATDOESTHISMEAN
)TSLIKESAYINGh4AKETHEBITSINCMAKEA
COPYOFTHEMANDSTICKTHATCOPYINTODv
W
Z
EAP
% RR F
%RWKFDQGGUHIHUWRWKHVDPH NREMH
LEH
REMHFW
C TIB
7KHFDQGGYDULDEOHVKROG
%RRN
L LE
WZRGLIIHUHQWFRSLHVRIWKH CO
E
VDPHYDOXH7ZRUHPRWHV ; AG
B
AR
SURJUDPPHGWRRQH79 G
2EFERENCES %RRN \
/BJECTS
%RRN
F E
!SSIGNTHEVALUEOFVARIABLEBTO
VARIABLEC"YNOWYOUKNOWWHAT
W
THISMEANS4HEBITSINSIDEVARIABLE F
BARECOPIEDANDTHATNEWCOPYIS %RRNREMH
STUFFEDINTOVARIABLEC

W
Z
EAP
%RWKEDQGFUHIHUWRWKH % RR F
VDPHREMHFW NREMH
LEH
C TIB
2EFERENCES %RRN
L LE
/BJECTS CO
E
; AG
B
AR
G
\
\RXDUHKHUH
REMHFWVRQWKHKHDS
4QNMIVLLMI\PWV\PMPMIX

%RRNE QHZ%RRN
%R
RNREMHFW

%RRNF QHZ%RRN
$ECLARETWO"OOKREFERENCEVARIABLES
EAP
#REATETWONEW"OOKOBJECTS!SSIGN Z %R
RNREMHFW
LEH
THE"OOKOBJECTSTOTHEREFERENCE
C TIB
VARIABLES
%RRN
L LE
4HETWOBOOKOBJECTSARENOWLIVING CO
E
ONTHEHEAP AG
;
B
AR
!CTIVE2EFERENCES G
2EACHABLE/BJECTS
%RRN
E F DVW
!SSIGNTHEVALUEOFVARIABLECTOVARIABLEB 7KLVJX\LVWRFWRUEDLW
JDUEDJHFROOH

4HEBITSINSIDEVARIABLECARECOPIEDAND
THATNEWCOPYISSTUFFEDINTOVARIABLEB
%R
RNREMHFW
"OTHVARIABLESHOLDIDENTICALVALUES

%RWKEDQGFUHIHUWRWKHVDPH
REMHFW2EMHFWLVDEDQGRQHG
EAP
DQGHOLJLEOHIRU*DUEDJH&ROOHF
W
Z F
LEH
% RR
WLRQ*& NREMH
C TIB
!CTIVE2EFERENCES
L LE
%RRN CO
2EACHABLE/BJECTS
E
AG
B
!BANDONED/BJECTS
AR
; G
4HEFIRSTOBJECTTHATBREFERENCED/BJECT
HASNOMOREREFERENCES)TSUNREACHABLE
%RRN
F QXOO
!SSIGNTHEVALUEQXOOTOVARIABLEC 6WLOOWRDVW
4HISMAKESCANULLREFERENCEMEANING 1RW\HWWRDJVWDVE
ITDOESNTREFERTOANYTHING"UTITSSTILL
%R VDIHDVORQ
RNREMHFW UHIHUVWRLW
AREFERENCEVARIABLEANDANOTHER"OOK

OBJECTCANSTILLBEASSIGNEDTOIT
EAP
2EMHFWVWLOOKDVDQDFWLYH

W
UHIHUHQFHEDQGDVORQJ Z F
LEH
% RR
DVLWGRHVWKHREMHFWLVQRW NREMH
C TIB
HOLJLEOHIRU*&
L LE
!CTIVE2EFERENCES
%RRN CO
E
AG
NULL2EFERENCES
QXOOUHIHUHQFH GWRDQ\WKLQJ
B
AR
; PH G
2EACHABLE/BJECTS
QRWSURJUDP
!BANDONED/BJECTS
%RRN
FKDSWHU
)VIZZIaQ[TQSMI\ZIaWNK]X[
'HFODUHDQLQWDUUD\YDULDEOH$QDUUD\YDULDEOHLV
DUHPRWHFRQWUROWRDQDUUD\REMHFW
LQW>@QXPV
&UHDWHDQHZLQWDUUD\ZLWKDOHQJWK
RIDQGDVVLJQLWWRWKHSUHYLRXVO\
GHFODUHGLQW>@YDULDEOHQXPV
QXPV QHZLQW>@
*LYHHDFKHOHPHQWLQWKHDUUD\
LQWYDULDEOHV
DQLQWYDOXH
5HPHPEHUHOHPHQWVLQDQLQW
DUUD\DUHMXVWLQWYDULDEOHV
OHV
QXPV>@
YDULDE
LQWLQWLQWLQWLQWLQWLQW
QXPV>@
LQW
QXPV>@
QXPV>@ LQWDUUD\REMHFWLQW>@
QXPV>@ QXPV
QXPV>@
QXPV>@ LQW>@ 1RWLFHWKDWWKHDUUD\LWVHOILVDQREMHFW
HYHQWKRXJKWKHHOHPHQWVDUHSULPLWLYHV
)ZZIa[IZMWJRMK\[\WW
4HE*AVASTANDARDLIBRARYINCLUDES REFERENCEVARIABLE!NYTHINGYOU "ESURETONOTICEONEKEYTHING
LOTSOFSOPHISTICATEDDATASTRUCTURES WOULDPUTINAVARIABLEOFTHATTYPE INTHEPICTUREABOVEnTHEARRAYIS
INCLUDINGMAPSTREESANDSETS CANBEASSIGNEDTOANARRAYELEMENT ANOBJECTEVENTHOUGHITSANARRAYOF
SEE!PPENDIX" BUTARRAYSARE OFTHATTYPE3OINANARRAYOFTYPE PRIMITIVES
GREATWHENYOUJUSTWANTAQUICK INTINT;= EACHELEMENTCANHOLD !RRAYSAREALWAYSOBJECTSWHETHER
ORDEREDEFlCIENTLISTOFTHINGS ANINT)NA$OGARRAY$OG;= EACH THEYREDECLAREDTOHOLDPRIMITIVES
!RRAYSGIVEYOUFASTRANDOM ELEMENTCANHOLDA$OG.O OROBJECTREFERENCES"UTYOUCAN
ACCESSBYLETTINGYOUUSEANINDEX REMEMBERTHATAREFERENCEVARIABLE HAVEANARRAYOBJECTTHATSDECLARED
POSITIONTOGETTOANYELEMENTIN JUSTHOLDSAREFERENCEAREMOTE TOHOLDPRIMITIVEVALUES)NOTHER
THEARRAY CONTROL NOTTHEOBJECTITSELF3O WORDSTHEARRAYOBJECTCANHAVE
%VERYELEMENTINANARRAYISJUST INA$OGARRAYEACHELEMENTCAN ELEMENTSWHICHAREPRIMITIVESBUT
AVARIABLE)NOTHERWORDSONEOF HOLDAREMOTECONTROLTOA$OG/F THEARRAYITSELFISNEVERAPRIMITIVE
THEEIGHTPRIMITIVEVARIABLETYPES COURSEWESTILLHAVETOMAKETHE 2EGARDLESSOFWHATTHEARRAYHOLDS
THINK,ARGE&URRY$OG ORA $OGOBJECTSANDYOULLSEEALLTHAT THEARRAYITSELFISALWAYSANOBJECT
ONTHENEXTPAGE
\RXDUHKHUH
DQDUUD\RI REMHFWV
5ISMIVIZZIaWN,WO[
'HFODUHD'RJDUUD\YDULDEOH

'RJ>@SHWV
&UHDWHDQHZ'RJDUUD\ZLWK
DOHQJWKRIDQGDVVLJQLWWR
WKHSUHYLRXVO\GHFODUHG'RJ>@
YDULDEOHSHWV
SHWV QHZ'RJ>@
'RJ'RJ'RJ'RJ'RJ'RJ'RJ
?PI\¼[UQ[[QVO'
$OGS7EHAVEANARRAY SHWV
OF$OGREFERENCESBUTNO
ACTUAL$OGOBJECTS 'RJDUUD\REMHFW'RJ>@
'RJ>@
&UHDWHQHZ'RJREMHFWVDQG
DVVLJQWKHPWRWKHDUUD\ J2EMHFW
'R J2EMHFW
HOHPHQWV 'R
5HPHPEHUHOHPHQWVLQD'RJ
DUUD\DUHMXVW'RJUHIHUHQFH
YDULDEOHV:HVWLOOQHHG'RJV
SHWV>@ QHZ'RJ
SHWV>@ QHZ'RJ
6KDUSHQ \RXU SHQFLO
7HATISTHECURRENTVALUEOF 'RJ'RJ'RJ'RJ'RJ'RJ'RJ
PETS;=???????????
7HATCODEWOULDMAKE SHWV
PETS;=REFERTOONEOFTHE
TWOEXISTING$OGOBJECTS 'RJDUUD\REMHFW'RJ>@
???????????????????????
'RJ>@
FKDSWHU
'RJ +WV\ZWTaW]Z,WO
QDPH _Q\PIZMNMZMVKMÎZQIJTM
'RJ¿GR QHZ'RJ
EDUN fYe]
HDW ¿GRQDPH ³)LGR´
FKDVH&DW
7ECREATEDA$OGOBJECTAND 6WULQJ
USEDTHEDOTOPERATORONTHE
FW

REFERENCEVARIABLElDOTOACCESS 'RJREMH
THENAMEVARIABLE
7ECANUSETHElDOREFERENCE â\g
TOGETTHEDOGTOBARK OR
EAT ORCHASE#AT
'RJ
¿GREDUN
RXWW\SH
-DYDFDUHVDE ¿GRFKDVH&DW
\\RX
FODUHGDQDU UD
2QFH\RX·YHGH H [F HS WWKLQJV
WKLQJLQLW ?PI\PIXXMV[QN\PM,WOQ[QV
FDQ·WSXWDQ\ \ W\SH
GHFODUHGDU UD
WKDWDUHRIWKH I,WOIZZIa'
LQWRD'RJ
XFDQ·WSXWD&DW
)RUH[DPSOH\R \D ZI XO LI VRPHRQH 7EKNOWWECANACCESSTHE$OGS
HSUHWW
DUUD\LWZRXOGE UU D\VR
'RJVDUHLQWKHD INSTANCEVARIABLESANDMETHODSUSING
WKLQNVWKDWRQO\ N DQ G WK HQ WRWKHLU
HWREDU THEDOTOPERATORBUTONWHAT
WKH\DVNHDFKRQ XU NLQ J $QG
WKHUH·VDFDWO
KRUURUGLVFRYHU OH L QW RD QL QW DUUD\ 7HENTHE$OGISINANARRAYWEDONT
GRXE
\RXFDQ·WVWLFND RZHYHU
EHU"<RXFDQK HAVEANACTUALVARIABLENAMELIKE
VSLOODJHUHPHP D UU D\ E HF DXVHD
QL QW lDO )NSTEADWEUSEARRAYNOTATIONAND
SXWDE\WHLQWRD QW V L]H GFXS
VÀWLQWRDQL PUSHTHEREMOTECONTROLBUTTONDOT
E\WHZLOODOZD\ SOL FLW Z LG HQ LQJ:H·OO
Q LP
7KLVLVNQRZQDVD QRZMXVW
OPERATOR ONANOBJECTATAPARTICULAR
WDLOVODWHUIRU
JHWLQWRWKHGH PS LOH U ZR Q·WOHW\RX INDEXPOSITION INTHEARRAY
WK H FR
UHPHPEHUWKDW DU UD \ EDVHGRQ 'RJ>@P\'RJV QHZ'RJ>@
WKLQJLQDQ
SXWWKHZURQJ
ODUHGW\SH
WKHDUUD\·VGHF P\'RJV>@ QHZ'RJ
P\'RJV>@QDPH ³)LGR´
P\'RJV>@EDUN
<HVZHNQRZZH·UHQRWGHPRQVWUDWLQJHQFDSVXODWLRQKHUHEXWZH·UH
WU\LQJWRNHHSLWVLPSOH)RUQRZ:H·OOGRHQFDSVXODWLRQLQFKDSWHU
\RXDUHKHUH
XVLQJUHIHUHQFHV
FODVV'RJ^
6WULQJQDPH ),WOMÌUXTM
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ 'RJ
PDNHD'RJREMHFWDQGDFFHVVLW
QDPH
'RJGRJ QHZ'RJ
GRJEDUN EDUN
HDW
GRJQDPH ³%DUW´
FKDVH&DW
QRZPDNHD'RJDUUD\
'RJ>@P\'RJV QHZ'RJ>@ /UTPUT
DQGSXWVRPHGRJVLQLW )LOH(GLW:LQGRZ+HOS+RZO
Licensed by
P\'RJV>@ QHZ'RJ MDYD'RJ
P\'RJV>@ QHZ'RJ QXOOVD\V5XII
P\'RJV>@ GRJ ODVWGRJ¶VQDPHLV%DUW
QRZDFFHVVWKH'RJVXVLQJWKHDUUD\ )UHGVD\V5XII
Eduard Simons
UHIHUHQFHV 0DUJHVD\V5XII
P\'RJV>@QDPH ³)UHG´ %DUWVD\V5XII
P\'RJV>@QDPH ³0DUJH´

104038
+PPPPZKDWLVP\'RJV>@QDPH"
6\VWHPRXWSULQW³ODVWGRJ¶VQDPHLV³
:MDD=LHGAFLK
6\VWHPRXWSULQWOQP\'RJV>@QDPH
9DULDEOHVFRPHLQWZRIODYRUVSULPLWLYHDQG
QRZORRSWKURXJKWKHDUUD\ UHIHUHQFH
DQGWHOODOOGRJVWREDUN 9DULDEOHVPXVWDOZD\VEHGHFODUHGZLWKDQDPH
DQGDW\SH
LQW[
$SULPLWLYHYDULDEOHYDOXHLVWKHELWVUHSUHVHQWLQJ
ZKLOH[P\'RJVOHQJWK^ WKHYDOXH¶D·WUXHHWF
WK·
P\'RJV>[@EDUN
K DY H D YD ULDEOH¶OHQJ RI $UHIHUHQFHYDULDEOHYDOXHLVWKHELWV
[ [ DUUD\V \RXWKHQXPEHU UHSUHVHQWLQJDZD\WRJHWWRDQREMHFWRQWKH
` WKDWJLYHV WKHDUUD\ KHDS
`
HOHPHQWVLQ $UHIHUHQFHYDULDEOHLVOLNHDUHPRWHFRQWURO
8VLQJWKHGRWRSHUDWRURQDUHIHUHQFH
YDULDEOHLVOLNHSUHVVLQJDEXWWRQRQWKHUHPRWH
SXEOLFYRLGEDUN^
FRQWUROWRDFFHVVDPHWKRGRULQVWDQFHYDULDEOH
6\VWHPRXWSULQWOQQDPH³VD\V5XII´
$UHIHUHQFHYDULDEOHKDVDYDOXHRIQXOOZKHQ
` LWLVQRWUHIHUHQFLQJDQ\REMHFW
SXEOLFYRLGHDW^` $QDUUD\LVDOZD\VDQREMHFWHYHQLIWKHDUUD\
SXEOLFYRLGFKDVH&DW^` LVGHFODUHGWRKROGSULPLWLYHV7KHUHLVQRVXFK
WKLQJDVDSULPLWLYHDUUD\RQO\DQDUUD\WKDW
`
KROGVSULPLWLYHV
FKDSWHU
GHWHUPLQHZKHWKHUHDFKRIWKHVHILOHV
ZLOOFRPSLOH,IWKH\ZRQ·W
FRPSLOHKRZZRXOG\RX
IL[WKHP"
$ %
FODVV%RRNV^ FODVV+REELWV^
6WULQJWLWOH
6WULQJDXWKRU 6WULQJQDPH
`
FODVV%RRNV7HVW'ULYH^
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ +REELWV>@K QHZ+REELWV>@
LQW]
%RRNV>@P\%RRNV QHZ%RRNV>@
LQW[ ZKLOH]^
P\%RRNV>@WLWOH ´7KH*UDSHVRI-DYDµ ] ]
P\%RRNV>@WLWOH ´7KH-DYD*DWVE\µ K>]@ QHZ+REELWV
P\%RRNV>@WLWOH ´7KH-DYD&RRNERRNµ K>]@QDPH ÉLOERµ
P\%RRNV>@DXWKRU ÉREµ LI] ^
P\%RRNV>@DXWKRU ´VXHµ K>]@QDPH ÍURGRµ
P\%RRNV>@DXWKRU ´LDQµ `
LI] ^
ZKLOH[^ K>]@QDPH ´VDPµ
6\VWHPRXWSULQWP\%RRNV>[@WLWOH `
6\VWHPRXWSULQWÉ\´ 6\VWHPRXWSULQWK>]@QDPH´LVD´
6\VWHPRXWSULQWOQP\%RRNV>[@DXWKRU 6\VWHPRXWSULQWOQ´JRRG+REELWQDPHµ
[ [ `
` `
` `
`
\RXDUHKHUH
H[HUFLVH&RGH0DJQHWV
1dQÔU_Q Code Magnets

!WORKING*AVAPROGRAMISALLSCRAMBLEDUP
LQW\
ONTHEFRIDGE#ANYOURECONSTRUCTTHECODE
SNIPPETSTOMAKEAWORKING*AVAPROGRAM UHI LQGH[>\@
THATPRODUCESTHEOUTPUTLISTEDBELOW
3OMEOFTHECURLYBRACESFELLONTHEFLOOR
LVODQG
ANDTHEYWERETOOSMALLTOPICKUPSOFEEL V>@
´%HUP
FREETOADDASMANYOFTHOSEASYOUNEED LVODQG XGDµ
V>@
´)LML
LVODQG µ
V>@
´$]RU
LVODQG HVµ
V>@
´&R]X
PHOµ
LQWUHI
ZKLOH\^
6\VWHPRXWSULQWOQLVODQGV>UHI@

LQGH[>@

LQGH[>@

LQGH[>@

LQGH[>@
6WULQJ>@LVODQGV QHZ6WULQJ>@
6\VWHPRXWSULQW´LVODQG ´
LQW>@
LQGH[ Q
HZLQW> @
\ \
)LOH(GLW:LQGRZ+HOS%LNLQL
FODVV7HVW$UUD\V^
MDYD7HVW$UUD\V

LVODQG )LML
LVODQG &R]XPHO SXEOLFVWDWLFYR
LGPDLQ6WULQJ>@
LVODQG %HUPXGD DUJV^
LVODQG $]RUHV
FKDSWHU
·WXVH DVHSDUDWH
FODVV7ULDQJOH^
6 RP HWLPHVZHGRQZH·UHWU\LQJWR
DXVH
WHVWFODVVEHFWKHSDJH
GRXEOHDUHD
LQWKHLJKW
VDYHVSD FH R Q
3RRO3X]]OH LQWOHQJWK
9OURJOBISTOTAKECODESNIPPETSFROM BBBBBBBBBBBB
THEPOOLANDPLACETHEMINTOTHE BBBBBBBBBBBBBBBBBBBBBBB
BLANKLINESINTHECODE9OUMAY
USETHESAMESNIPPETMORETHAN ZKLOHBBBBBBBBBB^
ONCEANDYOUWONTNEEDTOUSE BBBBBBBBBBBBBBBBBBBBBBBBBB
ALLTHESNIPPETS9OURGOALISTO BBBBBBBBKHLJKW [
MAKEACLASSTHATWILLCOMPILEAND
RUNANDPRODUCETHEOUTPUTLISTED BBBBBBBBOHQJWK [
BBBBBBBBBBBBBBBBBBBBBBBBBB
6\VWHPRXWSULQW´WULDQJOH´[µDUHDµ
/UTPUT
6\VWHPRXWSULQWOQ´ ´BBBBBBBDUHD
)LOH(GLW:LQGRZ+HOS%HUPXGD BBBBBBBBBBBBBBBB
MDYD7ULDQJOH
`
WULDQJOHDUHD
BBBBBBBBBBBBBB
WULDQJOHDUHD
[
WULDQJOHDUHD
7ULDQJOHW WD>@
WULDQJOHDUHD BBBB
WD>@DUHD
\ BBBBBBBBBBBBBBBBBBBBBB
6\VWHPRXWSULQW´\ ´\
6\VWHPRXWSULQWOQ´WDUHD ´WDUHD
"ONUS1UESTION `
&OREXTRABONUSPOINTSUSESNIPPETS YRLGVHW$UHD^
FROMTHEPOOLTOFILLINTHEMISSING
OUTPUTABOVE BBBBBBBBBBBB KHLJKW OHQJWK
`
`
.OTE%ACHSNIPPET
FROMTHEPOOLCANBE
USEDMORETHANONCE
TAREA
TAREA
AREA
TAREA INTX
TAAREA
TAREA INTY XX TAX
X TAXAREA
INTX XX TAX
Y TA;X=AREA
TA;X=SET!REA INTX XX X
TA;X=
4RIANGLE;=TANEW4RIANGLE TAXSET!REA INTYX X
4RIANGLETANEW;=4RIANGLE;= TA;X=SET!REA TANEW4RIANGLE

4RIANGLE;=TANEW4RIANGLE;= TA;X=NEW4RIANGLE

TAXNEW4RIANGLE
\RXDUHKHUH
SX]]OH+HDSR·7URXEOH
FODVV+HDS4XL]^
LQWLG
!(EAPO³4ROUBLE SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^
LQW[
!SHORT*AVAPROGRAMISLISTEDTOTHE +HDS4XL]>@KT QHZ+HDS4XL]>@
RIGHT7HEN@DOSTUFFISREACHEDSOME
OBJECTSANDSOMEREFERENCEVARIABLES ZKLOH[^
WILLHAVEBEENCREATED9OURTASKIS KT>[@ QHZ+HDS4XL]
TODETERMINEWHICHOFTHEREFERENCE KT>[@LG [
VARIABLESREFERTOWHICHOBJECTS.OTALL [ [
THEREFERENCEVARIABLESWILLBEUSEDAND
SOMEOBJECTSMIGHTBEREFERREDTOMORE
`
THANONCE$RAWLINESCONNECTINGTHE KT>@ KT>@
REFERENCEVARIABLESWITHTHEIRMATCHING KT>@ KT>@
OBJECTS KT>@ QXOO
4IP5NLESSYOUREWAYSMARTERTHANUS KT>@ KT>@
YOUPROBABLYNEEDTODRAWDIAGRAMS KT>@ KT>@
LIKETHEONESONPAGEANDOFTHIS
KT>@ KT>@
CHAPTER5SEAPENCILSOYOUCANDRAW
ANDTHENERASEREFERENCELINKSTHE KT>@ KT>@
ARROWSGOINGFROMAREFERENCEREMOTE GRVWXII
CONTROLTOANOBJECT `
`
2EFERENCE6ARIABLES (EAP1UIZ/BJECTS
QL%
UHIHUHQFH KT>@
PDWFKHDFKKPDWFKLQJ
YDULDEOHZLW
REMHFWV KT>@
WKDYHWR
<RXPLJKWQHRIHUHQFH QL%
XVHHYHU\U
KT>@
KT>@
QL%
KT>@
FKDSWHU
7KHFDVHRIWKHSLOIHUHGUHIHUHQFHV
,WZDVDGDUNDQGVWRUP\QLJKW7DZQ\VWUROOHGLQWRWKHSURJUDPPHUV¶EXOOSHQOLNHVKH
RZQHGWKHSODFH6KHNQHZWKDWDOOWKHSURJUDPPHUVZRXOGVWLOOEHKDUGDWZRUNDQGVKH
ZDQWHGKHOS6KHQHHGHGDQHZPHWKRGDGGHGWRWKHSLYRWDOFODVVWKDWZDVWREHORDGHGLQWRWKH
FOLHQW¶VQHZWRSVHFUHW-DYDHQDEOHGFHOOSKRQH+HDSVSDFHLQWKHFHOOSKRQH¶VPHPRU\ZDV
DVWLJKWDV7DZQ\¶VWRSDQGHYHU\RQHNQHZLW7KHQRUPDOO\UDXFRXVEX]]LQWKHEXOOSHQIHOOWR
VLOHQFHDV7DZQ\HDVHGKHUZD\WRWKHZKLWHERDUG6KHVNHWFKHGDTXLFNRYHUYLHZRIWKHQHZ
PHWKRG¶VIXQFWLRQDOLW\DQGVORZO\VFDQQHGWKHURRP³:HOOER\VLW¶VFUXQFKWLPH´VKHSXUUHG
³:KRHYHUFUHDWHVWKHPRVWPHPRU\HI¿FLHQWYHUVLRQRIWKLVPHWKRGLVFRPLQJZLWKPHWRWKH
)LYH0LQXWH FOLHQW¶VODXQFKSDUW\RQ0DXLWRPRUURZWRKHOSPHLQVWDOOWKHQHZVRIWZDUH´
0\VWHU\ 7KHQH[WPRUQLQJ7DZQ\JOLGHGLQWRWKHEXOOSHQZHDULQJKHUVKRUW$ORKDGUHVV
³*HQWOHPHQ´VKHVPLOHG³WKHSODQHOHDYHVLQDIHZKRXUVVKRZPHZKDW\RX¶YH
JRW´%REZHQW¿UVWDVKHEHJDQWRVNHWFKKLVGHVLJQRQWKHZKLWHERDUG7DZQ\
VDLG³/HW¶VJHWWRWKHSRLQW%REVKRZPHKRZ\RXKDQGOHGXSGDWLQJWKHOLVWRIFRQ
WDFWREMHFWV´%RETXLFNO\GUHZDFRGHIUDJPHQWRQWKHERDUG
&RQWDFW>@FD QHZ&RQWDFW>@
ZKLOH[^PDNHFRQWDFWREMHFWV
FD>[@ QHZ&RQWDFW
[ [
`
GRFRPSOLFDWHG&RQWDFWOLVWXSGDWLQJVWXIIZLWKFD
³7DZQ\,NQRZZH¶UHWLJKWRQPHPRU\EXW\RXUVSHFVDLGWKDWZHKDGWREHDEOHWRDFFHVV
LQGLYLGXDOFRQWDFWLQIRUPDWLRQIRUDOOWHQDOORZDEOHFRQWDFWVWKLVZDVWKHEHVWVFKHPH,FRXOG
FRRNXS´VDLG%RE.HQWZDVQH[WDOUHDG\LPDJLQLQJFRFRQXWFRFNWDLOVZLWK7DZQ\³%RE´
KHVDLG³\RXUVROXWLRQ¶VDELWNOXGJ\GRQ¶W\RXWKLQN"´.HQWVPLUNHG³7DNHDORRNDWWKLV
EDE\´
&RQWDFWUHIF
ZKLOH[^PDNHFRQWDFWREMHFWV
UHIF QHZ&RQWDFW
[ [
`
GRFRPSOLFDWHG&RQWDFWOLVWXSGDWLQJVWXIIZLWKUHIF
³,VDYHGDEXQFKRIUHIHUHQFHYDULDEOHVZRUWKRIPHPRU\%RERULQRVRSXWDZD\\RXU
VXQVFUHHQ´PRFNHG.HQW³1RWVRIDVW.HQW´VDLG7DZQ\³\RX¶YHVDYHGDOLWWOHPHPRU\EXW
%RE¶VFRPLQJZLWKPH´
:K\GLG7DZQ\FKRRVH%RE¶VPHWKRGRYHU.HQW¶VZKHQ.HQW¶VXVHGOHVVPHPRU\"
\RXDUHKHUH
H[HUFLVHVROXWLRQV
FODVV%RRNV^
([HUFLVH6ROXWLRQV 6WULQJWLWOH
6WULQJDXWKRU
`
FODVV%RRNV7HVW'ULYH^
%RRNV>@P\%RRNV QHZ%RRNV>@
LQW[
$ P\%RRNV>@ QHZ%RRNV5HPHPEHU:HKDYHWR
&RGH0DJQHWV P\%RRNV>@ QHZ%RRNVDFWXDOO\PDNHWKH%RRNV
P\%RRNV>@ QHZ%RRNVREMHFWV
FODVV7HVW$UUD\V^ P\%RRNV>@WLWOH ´7KH*UDSHVRI-DYDµ
P\%RRNV>@WLWOH ´7KH-DYD*DWVE\µ
P\%RRNV>@WLWOH ´7KH-DYD&RRNERRNµ
LQW>@LQGH[ QHZLQW>@
P\%RRNV>@DXWKRU ÉREµ
LQGH[>@ P\%RRNV>@DXWKRU ´VXHµ
LQGH[>@ P\%RRNV>@DXWKRU ´LDQµ
LQGH[>@ ZKLOH[^
LQGH[>@ 6\VWHPRXWSULQWP\%RRNV>[@WLWOH
6WULQJ>@LVODQGV QHZ6WULQJ>@ 6\VWHPRXWSULQWÉ\´
6\VWHPRXWSULQWOQP\%RRNV>[@DXWKRU
LVODQGV>@ ´%HUPXGDµ
[ [
LVODQGV>@ ´)LMLµ `
LVODQGV>@ ´$]RUHVµ `
LVODQGV>@ ´&R]XPHOµ `
LQW\
LQWUHI FODVV+REELWV^
6WULQJQDPH
ZKLOH\^
UHI LQGH[>\@ +REELWV>@K QHZ+REELWV>@
6\VWHPRXWSULQW´LVODQG ´ LQW] 5HPHPEHUDUUD\VVWDUWZLWK
6\VWHPRXWSULQWOQLVODQGV>UHI@ ZKLOH]^HOHPHQW
\ \ ] ]
` K>]@ QHZ+REELWV
` %K>]@QDPH ÉLOERµ

LI] ^
` )LOH(GLW:LQGRZ+HOS%LNLQL K>]@QDPH ÍURGRµ
MDYD7HVW$UUD\V `
LVODQG )LML LI] ^
LVODQG &R]XPHO K>]@QDPH ´VDPµ
LVODQG %HUPXGD `
LVODQG $]RUHV 6\VWHPRXWSULQWK>]@QDPH´LVD´
6\VWHPRXWSULQWOQ´JRRG+REELWQDPHµ
`
`
`
FKDSWHU
3X]]OH6ROXWLRQV
<PMKI[MWN\PMXQTNMZMLZMNMZMVKM[
FODVV7ULDQJOH^ 4AWNYCOULDSEETHAT+ENTSMETHODHADASERIOUS
GRXEOHDUHD mAW)TSTRUETHATHEDIDNTUSEASMANYREFERENCE
LQWKHLJKW VARIABLESAS"OBBUTTHEREWASNOWAYTOACCESSANY
LQWOHQJWK BUTTHELASTOFTHE#ONTACTOBJECTSTHATHISMETHODCRE
LQW[
LQW[
ATED7ITHEACHTRIPTHROUGHTHELOOPHEWASASSIGN
7ULDQJOH>@WD
7ULDQJOH>@WD QHZ7ULDQJOH>@ INGANEWOBJECTTOTHEONEREFERENCEVARIABLESOTHE
ZKLOH[^
PREVIOUSLYREFERENCEDOBJECTWASABANDONEDONTHE
WD>[@ QHZ7ULDQJOH HEAPnUNREACHABLE7ITHOUTACCESSTONINEOFTHETEN
WD>[@KHLJKW [ OBJECTSCREATED+ENTSMETHODWASUSELESS
WD>[@OHQJWK [ 7KHVRIWZDUHZDVDKXJHVXFFHVVDQGWKHFOLHQWJDYH7DZQ\DQG%REDQH[WUDZHHN
WD>[@VHW$UHD LQ+DZDLL:H·GOLNHWRWHOO\RXWKDWE\ILQLVKLQJWKLVERRN\RXWRRZLOOJHWVWXIIOLNHWKDW
6\VWHPRXWSULQW´WULDQJOH´[µDUHDµ
6\VWHPRXWSULQWOQ´ ´WD>[@DUHD
[ [
2EFERENCE6ARIABLES (EAP1UIZ/BJECTS
`
LQW\
LQW\ [
[
7ULDQJOHW WD>@ QL%
WD>@DUHD KT>@
6\VWHPRXWSULQW´\ ´\
6\VWHPRXWSULQWOQ´WDUHD ´WDUHD
` KT>@
YRLGVHW$UHD^
DUHD
DUHD KHLJKW OHQJWK
QL%
KT>@
`
` )LOH(GLW:LQGRZ+HOS%HUPXGD
MDYD7ULDQJOH
WULDQJOHDUHD
WULDQJOHDUHD KT>@
WULDQJOHDUHD QL%
WULDQJOHDUHD
\ WDUHD
KT>@
\RXDUHKHUH
PHWKRGVXVHLQVWDQFHYDULDEOHV
+RZ2EMHFWV%HKDYH
7KLVRXJKWD
FKDQJHKHUVWDWH
6WDWHDIIHFWVEHKDYLRUEHKDYLRUDIIHFWVVWDWH7EKNOWTHATOBJECTS
HAVESTATEANDBEHAVIORREPRESENTEDBYINSTANCEVARIABLESANDMETHODS"UTUNTILNOWWE
HAVENTLOOKEDATHOWSTATEANDBEHAVIORARERELATED7EALREADYKNOWTHATEACHINSTANCEOFA
CLASSEACHOBJECTOFAPARTICULARTYPE CANHAVEITSOWNUNIQUEVALUESFORITSINSTANCEVARIABLES
$OG!CANHAVEANAMEh&IDOvANDAWEIGHTOFPOUNDS$OG"ISh+ILLERvANDWEIGHSPOUNDS
!NDIFTHE$OGCLASSHASAMETHODMAKE.OISE WELLDONTYOUTHINKA POUNDDOGBARKSA
BITDEEPERTHANTHELITTLE POUNDER!SSUMINGTHATANNOYINGYIPPYSOUNDCANBECONSIDERED
ABARK &ORTUNATELYTHATSTHEWHOLEPOINTOFANOBJECTITHASBEHAVIORTHATACTSONITSSTATE)N
OTHERWORDSMETHODSUSEINSTANCEVARIABLEVALUES,IKEhIFDOGISLESSTHANPOUNDSMAKE
YIPPYSOUNDELSEvORhINCREASEWEIGHTBYv,ETSGOCHANGESOMESTATE
WKLVLVDQHZFKDSWHU
REMHFWVKDYHVWDWHDQGEHKDYLRU
:MUMUJMZ"IKTI[[LM[KZQJM[_PI\IV
WJRMK\SVW_[IVL_PI\IVWJRMK\LWM[
!CLASSISTHEBLUEPRINTFORANOBJECT7HENYOU 6RQJ
WRITEACLASSYOUREDESCRIBINGHOWTHE*6- QV[\IVKM WLWOH
SHOULDMAKEANOBJECTOFTHATTYPE9OUALREADY SVW_[
ÎZQIJTM[ DUWLVW
KNOWTHATEVERYOBJECTOFTHATTYPECANHAVE VWDWH
DIFFERENTINSTANCEVARIABLEVALUES"UTWHATABOUT VHW7LWOH
THEMETHODS UM\PWL[ VHW$UWLVW LWM[
EHKDYLRU SOD\
+IVM^MZaWJRMK\WN\PI\\aXMPI^MLQNNMZMV\
UM\PWLJMPI^QWZ'
WDQFHV
Licensed by
7ELLSORTOF
I L Y H L QV
%VERYINSTANCEOFAPARTICULARCLASSHASTHESAME
6RQJ
METHODSBUTTHEMETHODSCANBEHAVEDIFFERENTLY
BASEDONTHEVALUEOFTHEINSTANCEVARIABLES
RIFODVV 3ROLWLN
Eduard Simons
4HE3ONGCLASSHASTWOINSTANCEVARIABLESTITLE &ROGSOD\ 0\:D\
ANDARTIST4HEPLAY METHODPLAYSASONGBUT 6LQDWUD
THEINSTANCEYOUCALLPLAY ONWILLPLAYTHESONG
REPRESENTEDBYTHEVALUEOFTHETITLEINSTANCE
0\:D\
VARIABLEFORTHATINSTANCE3OIFYOUCALLTHEPLAY 'DUNVWDU
104038
METHODONONEINSTANCEYOULLHEARTHESONG *UDWHIXO 6H[3LVWROV
h0OLITIKvWHILEANOTHERINSTANCEPLAYSh$ARKSTARv 'HDG 6LQJ
4HEMETHODCODEHOWEVERISTHESAME
7UDYLV
YRLGSOD\^
VRXQG3OD\HUSOD\6RXQGWLWOH
`
k+
l*
H
LQVWDQF
6RQJ
R Q WK LV
SOD\
6RQJ
6RQJW QHZ6RQJ \
&DOOLQJ H´6LQJµWRSOD
VSOD\
WVHW$UWLVW³7UDYLV´ V WSOD\
WVHW7LWOH³6LQJ´
ZLOOFDX
6RQJV QHZ6RQJ &DOOLQJSOD\RQWKLVLQVWDQFH
VVHW$UWLVW³6H[3LVWROV´ ZLOOFDXVH´0\:D\µWRSOD\
VVHW7LWOH³0\:D\´ EXWQRWWKH6LQDWUDRQH
<HVDQRWKHUVWXQQLQJO\FOHDUDQVZHU
FKDSWHU
<PM[QbMINNMK\[\PMJIZS
!SMALL$OGSBARKISDIFFERENTFROMABIG$OGSBARK
4HE$OGCLASSHASANINSTANCEVARIABLESIZETHATTHE
BARK METHODUSESTODECIDEWHATKINDOFBARKSOUND
TOMAKE
'RJ
FODVV'RJ^
LQWVL]H VL]H
QDPH
6WULQJQDPH
EDUN
YRLGEDUN^
LIVL]H!^
6\VWHPRXWSULQWOQ³:RRRI:RRRI´
`HOVHLIVL]H!^
6\VWHPRXWSULQWOQ³5XII5XII´
`HOVH^
6\VWHPRXWSULQWOQ³<LS<LS´
`
`
`
FODVV'RJ7HVW'ULYH^
'RJRQH QHZ'RJ
RQHVL]H
'RJWZR QHZ'RJ
WZRVL]H
'RJWKUHH QHZ'RJ
WKUHHVL]H
)LOH(GLW:LQGRZ+HOS3OD\GHDG
MDYD'RJ7HVW'ULYH
RQHEDUN
:RRRI:RRRI
WZREDUN
<LS<LS
WKUHHEDUN
5XII5XII
`
`
\RXDUHKHUH
PHWKRGSDUDPHWHUV
AW]KIV[MVL\PQVO[\WIUM\PWL
*USTASYOUEXPECTFROMANYPROGRAMMINGLANGUAGEYOUCANPASSVALUESINTO
YOURMETHODS9OUMIGHTFOREXAMPLEWANTTOTELLA$OGOBJECTHOWMANY
TIMESTOBARKBYCALLING
GEDUN
$EPENDINGONYOURPROGRAMMINGBACKGROUNDANDPERSONALPREFERENCES
YOUMIGHTUSETHETERMARGUMENTSORPERHAPSPARAMETERSFORTHEVALUESPASSED
INTOAMETHOD!LTHOUGHTHEREAREFORMALCOMPUTERSCIENCEDISTINCTIONSTHAT
PEOPLEWHOWEARLABCOATSANDWHOWILLALMOSTCERTAINLYNOTREADTHISBOOK
MAKEWEHAVEBIGGERlSHTOFRYINTHISBOOK3OYOUCANCALLTHEMWHATEVER
YOULIKEARGUMENTSDONUTSHAIRBALLSETC BUTWEREDOINGITLIKETHIS
$PHWKRGXVHVSDUDPHWHUV$FDOOHUSDVVHVDUJXPHQWV
!RGUMENTSARETHETHINGSYOUPASSINTOTHEMETHODS!NARGUMENTAVALUE
LIKEh&OOvORAREFERENCETOA$OG LANDSFACE DOWNINTOAWAITFORIT
PARAMETER!NDAPARAMETERISNOTHINGMORETHANALOCALVARIABLE!VARIABLE
WITHATYPEANDANAMETHATCANBEUSEDINSIDETHEBODYOFTHEMETHOD
"UTHERESTHEIMPORTANTPART)FAMETHODTAKESAPARAMETERYOUMUSTPASS
ITSOMETHING!NDTHATSOMETHINGMUSTBEAVALUEOFTHEAPPROPRIATETYPE
'RJG QHZ'RJ
&DOOWKHEDUNPHWKRGRQWKH'RJUHIHU
HQFHDQGSDVVLQWKHYDOXHDVWKH GEDUN
DUJXPHQWWRWKHPHWKRG
DUJXPHQW
7KHELWVUHSUHVHQWLQJWKHLQW
YDOXHDUHGHOLYHUHGLQWRWKH
EDUNPHWKRG

SDUDPHWHU

7KHELWVODQGLQWKHQXP2I%DUNV
SDUDPHWHUDQLQWVL]HGYDULDEOH
LQW
YRLGEDUNLQWQXP2I%DUNV^
8VHWKHQXP2I%DUNV
ZKLOHQXP2I%DUNV!^ SDUDPHWHUDVDYDULDEOHLQ
WKHPHWKRGFRGH
6\VWHPRXWSULQWOQ³UXII´
QXP2I%DUNV QXP2I%DUNV
`
`
FKDSWHU
AW]KIVOM\\PQVO[JIKSNZWUIUM\PWL
-ETHODSCANRETURNVALUES%VERYMETHODISDECLAREDWITHARETURN
TYPEBUTUNTILNOWWEVEMADEALLOFOURMETHODSWITHAYRLG
RETURNTYPEWHICHMEANSTHEYDONTGIVEANYTHINGBACK
YRLGJR^
` &XWH
"UTWECANDECLAREAMETHODTOGIVEASPECIlCTYPEOFVALUE EXWQRWH[DFWO\ZKDW,
BACKTOTHECALLERSUCHAS ZDVH[SHFWLQJ
LQWJLYH6HFUHW^
UHWXUQ
`
)FYOUDECLAREAMETHODTORETURNAVALUEYOUMUST
RETURNAVALUEOFTHEDECLAREDTYPE/RAVALUE
THATISCOMPATIBLEWITHTHEDECLAREDTYPE7ELLGET
INTOTHATMOREWHENWETALKABOUTPOLYMORPHISM
INCHAPTERANDCHAPTER
:KDWHYHU\RXVD\
\RX·OOJLYHEDFN\RX
EHWWHUJLYHEDFN
7KHFRPSLOHUZRQ·WOHW\RXUHWXUQWKHZURQJW\SHRIWKLQJ

LQW
LQWWKH6HFUHW OLIHJLYH6HFUHW
W\SHV
7KHVHPDWFK
PXVW DU H U H W XUQHGIURP
UHVHQWLQJ QWKH
LQWJLYH6HFUHW^ 7KHELWVUHSUHWPHWKRGDQGODQGL
WKHJLYH6HF HGWKH6HFUHW
UHWXUQ YDULDEOHQDP
` WKLVPXVWILW
LQDQLQW
\RXDUHKHUH
PXOWLSOHDUJXPHQWV
AW]KIV[MVLUWZM\PIVWVM\PQVO
\WIUM\PWL
-ETHODSCANHAVEMULTIPLEPARAMETERS3EPARATETHEM
WITHCOMMASWHENYOUDECLARETHEMANDSEPARATETHE
ARGUMENTSWITHCOMMASWHENYOUPASSTHEM-OST
IMPORTANTLYIFAMETHODHASPARAMETERSYOUMUSTPASS
ARGUMENTSOFTHERIGHTTYPEANDORDER
+ITTQVOI\ _WXIZIUM \MZUM \PWLIVL[MVLQVO

Q\\ _WIZO]UMV\[
YRLGJR^
7HVW6WXIIW QHZ7HVW6WXII
WWDNH7ZR 7KHDUJXPHQ
` RUGHU\RXSDVVWV\RXSDVVODQGLQWKHVDPH
LQWKHILUVWSDHGWKHP)LUVWDUJXPHQWO
WKHVHFRQGSDUDUDPHWHUVHFRQGDUJXPHQW DQGV
PHWHUDQGVR LQ
RQ
YRLGWDNH7ZRLQW[LQW\^
LQW] [\
6\VWHPRXWSULQWOQ³7RWDOLV´]
`
AW]KIVXI[[ÎZQIJTM[QV\WIUM \PWLI[TWVOI[
\PMÎZQIJTM\ aXMUI\KPM[\PMXIZIUM \MZ\ aXM
WKH
YRLGJR^ G E D U ODQGLQLWVLQ
DQ HE
LQWIRR Y D O X H V RIIRRHUV6RQRZWKIRRWKH
7KH \SDUDPHW WKHELWVLQ DQGWKH
LQWEDU [DQG LGHQWLFDOWR HLQWHJHU¶· WVLQEDU
[DUH WWHUQIRUWK FDOWRWKHEL
ELWSD \DUHLGHQWL
WWDNH7ZRIRREDU
` ELWVLQ
PH
]",W·VWKHRVDR
YRLGWDNH7ZRLQW[LQW\^
W K H YD OX H R I
LQW] [\ :KDW·V HWLI\RXDGGHG
I
UHVXOW\RX·GJWLP \ R XSD VV HG W KHPLQWR
6\VWHPRXWSULQWOQ³7RWDOLV´] W W K H H
EDUD HWKRG
` WKHWDNH7ZRP
FKDSWHU
2IÎQ[XI[[JaÎT]M
<PI\UMIV[XI[[JaKWXa

HFODUHDQLQWYDULDEOHDQGDVVLJQLW
'
LQW[ ; WKHYDOXH¶·7KHELWSDWWHUQIRU
LQW JRHVLQWRWKHYDULDEOHQDPHG[
= 'HFODUHDPHWKRGZLWKDQLQW
YRLGJRLQW]^` SDUDPHWHUQDPHG]
LQW
FRS\RI
[
&DOOWKHJRPHWKRGSDVVLQJ

WKHYDULDEOH[DVWKHDUJXPHQW
7KHELWVLQ[DUHFRSLHGDQG
; =
WKHFRS\ODQGVLQ]
LQW LQW
IRRJR[ YRLGJRLQW]^`
[GRHVQ DUHQ·W &KDQJHWKHYDOXHRI]LQVLGH

HYHQLI]·WGFKDQJH [DQGHF]WHG

WKHPHWKRG7KHYDOXHRI[
RHV
FRQQ
GRHVQ·WFKDQJH7KHDUJXPHQW
; =
SDVVHGWRWKH]SDUDPHWHUZDV
LQW
LQW RQO\DFRS\RI[
YRLGJRLQW]^ 7KHPHWKRGFDQ·WFKDQJHWKH
] ELWVWKDWZHUHLQWKHFDOOLQJ
YDULDEOH[
`
\RXDUHKHUH
DUJXPHQWVDQGUHWXUQYDOXHV
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: 7HATHAPPENSIFTHEARGUMENTYOUWANTTO 5HPLQGHU-DYD
PASSISANOBJECTINSTEADOFAPRIMITIVE
FDUHVDERXWW\SH
A: 9OULLLEARNMOREABOUTTHISINLATERCHAPTERS <RXFDQ·WUHWXUQD*LUDIIHZKHQ
WKHUHWXUQW\SHLVGHFODUHG
BUTYOUALREADYKNOWTHEANSWER*AVAPASSES
EVERYTHINGBYVALUE%VERYTHING"UTVALUEMEANS DVD5DEELW6DPHWKLQJZLWK
BITSINSIDETHEVARIABLE!NDREMEMBERYOUDONT SDUDPHWHUV<RXFDQ·WSDVVD
STUFFOBJECTSINTOVARIABLESTHEVARIABLEISAREMOTE *LUDIIHLQWRDPHWKRGWKDW
CONTROLAREFERENCETOANOBJECT3OIFYOUPASSA WDNHVD5DEELW
REFERENCETOANOBJECTINTOAMETHODYOUREPASSING
ACOPYOFTHEREMOTECONTROL3TAYTUNEDTHOUGHWELL
HAVELOTSMORETOSAYABOUTTHIS
Q: #ANAMETHODDECLAREMULTIPLERETURNVALUES
:MDD=LHGAFLK
/RISTHERESOMEWAYTORETURNMORETHANONE
VALUE &ODVVHVGHILQHZKDWDQREMHFWNQRZVDQGZKDWDQ
REMHFWGRHV
A: 3ORTOF!METHODCANDECLAREONLYONERETURN 7KLQJVDQREMHFWNQRZVDUHLWVLQVWDQFHYDULDEOHV
VWDWH
VALUE"54IFYOUWANTTORETURNSAYTHREEINTVALUES
THENTHEDECLAREDRETURNTYPECANBEANINTARRAY 7KLQJVDQREMHFWGRHVDUHLWVPHWKRGVEHKDYLRU
3TUFFTHOSEINTSINTOTHEARRAYANDPASSITONBACK)TS
ALITTLEMOREINVOLVEDTORETURNMULTIPLEVALUESWITH 0HWKRGVFDQXVHLQVWDQFHYDULDEOHVVRWKDWREMHFWV
DIFFERENTTYPESWELLBETALKINGABOUTTHATINALATER RIWKHVDPHW\SHFDQEHKDYHGLIIHUHQWO\
CHAPTERWHENWETALKABOUT!RRAY,IST
$PHWKRGFDQKDYHSDUDPHWHUVZKLFKPHDQV\RX
Q: $O)HAVETORETURNTHEEXACTTYPE)DECLARED
FDQSDVVRQHRUPRUHYDOXHVLQWRWKHPHWKRG
7KHQXPEHUDQGW\SHRIYDOXHV\RXSDVVLQPXVW
A: 9OUCANRETURNANYTHINGTHATCANBEIMPLICITLY
PDWFKWKHRUGHUDQGW\SHRIWKHSDUDPHWHUV
GHFODUHGE\WKHPHWKRG
PROMOTEDTOTHATTYPE3OYOUCANPASSABYTEWHERE
ANINTISEXPECTED4HECALLERWONTCAREBECAUSETHE 9DOXHVSDVVHGLQDQGRXWRIPHWKRGVFDQEH
BYTEFITSJUSTFINEINTOTHEINTTHECALLERWILLUSEFOR LPSOLFLWO\SURPRWHGWRDODUJHUW\SHRUH[SOLFLWO\FDVW
ASSIGNINGTHERESULT9OUMUSTUSEANEXPLICITCAST WRDVPDOOHUW\SH
WHENTHEDECLAREDTYPEISSMALLERTHANWHATYOURE
TRYINGTORETURN 7KHYDOXH\RXSDVVDVDQDUJXPHQWWRDPHWKRG
FDQEHDOLWHUDOYDOXH¶F·HWFRUDYDULDEOHRI
Q: $O)HAVETODOSOMETHINGWITHTHERETURN
WKHGHFODUHGSDUDPHWHUW\SHIRUH[DPSOH[ZKHUH
[LVDQLQWYDULDEOH7KHUHDUHRWKHUWKLQJV\RX
VALUEOFAMETHOD#AN)JUSTIGNOREIT
FDQSDVVDVDUJXPHQWVEXWZH·UHQRWWKHUH\HW
A: *AVADOESNTREQUIREYOUTOACKNOWLEDGEA
RETURNVALUE9OUMIGHTWANTTOCALLAMETHODWITH
$PHWKRGPXVWGHFODUHDUHWXUQW\SH$YRLGUHWXUQ
W\SHPHDQVWKHPHWKRGGRHVQ·WUHWXUQDQ\WKLQJ
ANON VOIDRETURNTYPEEVENTHOUGHYOUDONTCARE ,IDPHWKRGGHFODUHVDQRQYRLGUHWXUQW\SHLWPXVW
ABOUTTHERETURNVALUE)NTHISCASEYOURECALLING
UHWXUQDYDOXHFRPSDWLEOHZLWKWKHGHFODUHGUHWXUQ
THEMETHODFORTHEWORKITDOESINSIDETHEMETHOD
RATHERTHANFORWHATTHEMETHODGIVESRETURNS)N
W\SH
*AVAYOUDONTHAVETOASSIGNORUSETHERETURNVALUE
FKDSWHU
+WWT\PQVO[aW]KIVLW_Q\PXIZIUM\MZ[
IVLZM\]ZV\aXM[
.OWTHATWEVESEENHOWPARAMETERSANDRETURNTYPESWORKITS (OHFWULF*XLWDU
TIMETOPUTTHEMTOGOODUSE'ETTERSAND3ETTERS)FYOUREINTO
BEINGALLFORMALABOUTITYOUMIGHTPREFERTOCALLTHEM!CCESSORS EUDQG
AND-UTATORS"UTTHATSAWASTEOFPERFECTLYGOODSYLLABLES QXP2I3LFNXSV
"ESIDES'ETTERSAND3ETTERSlTSTHE*AVANAMINGCONVENTIONSO URFN6WDU8VHV,W
WKHVH
1RWH8VLQJ QWLRQV
THATSWHATWELLCALLTHEM
'ETTERSAND3ETTERSLETYOUWELLGETANDSETTHINGS)NSTANCEVARI
JHW%UDQG QDPLQJFRQYH H
ABLEVALUESUSUALLY!'ETTERSSOLEPURPOSEINLIFEISTOSENDBACK PHDQV\RX·OOE
ASARETURNVALUETHEVALUEOFWHATEVERITISTHATPARTICULAR'ETTER VHW%UDQG IROORZLQJDQDYD
ISSUPPOSEDTOBE'ETTING!NDBYNOWITSPROBABLYNOSURPRISE JHW1XP2I3LFNXSV LPSRUWDQW-
VWDQGDUG
THATA3ETTERLIVESANDBREATHESFORTHECHANCETOTAKEANARGU
MENTVALUEANDUSEITTOSETTHEVALUEOFANINSTANCEVARIABLE VHW1XP2I3LFNXSV
JHW5RFN6WDU8VHV,W
VHW5RFN6WDU8VHV,W
FODVV(OHFWULF*XLWDU^
6WULQJEUDQG
LQWQXP2I3LFNXSV
ERROHDQURFN6WDU8VHV,W
6WULQJJHW%UDQG^
UHWXUQEUDQG
`
YRLGVHW%UDQG6WULQJD%UDQG^
EUDQG D%UDQG
`
LQWJHW1XP2I3LFNXSV^
UHWXUQQXP2I3LFNXSV
`
YRLGVHW1XP2I3LFNXSVLQWQXP^
QXP2I3LFNXSV QXP
`
ERROHDQJHW5RFN6WDU8VHV,W^
UHWXUQURFN6WDU8VHV,W
`
YRLGVHW5RFN6WDU8VHV,WERROHDQ\HV2U1R^
URFN6WDU8VHV,W \HV2U1R
`
`
\RXDUHKHUH
UHDOGHYHORSHUVHQFDSVXODWH
-VKIX[]TI\QWV
,WQ\WZZQ[SP]UQTQI\QWVIVL
ZQLQK]TM
-HQVD\V\RX·UH
5NTILTHISMOSTIMPORTANTMOMENTWEVE
ZHOOHQFDSVXODWHG
BEENCOMMITTINGONEOFTHEWORST//
FAUXPASANDWERENOTTALKINGMINOR
VIOLATIONLIKESHOWINGUPWITHOUTTHE@"
IN"9/" .OWERETALKING&AUX0ASWITH
ACAPITAL@&!ND@0
/URSHAMEFULTRANSGRESSION
%XPOSINGOURDATA
(EREWEAREJUSTHUMMINGALONGWITHOUT
ACAREINTHEWORLDLEAVINGOURDATAOUT
THEREFORANYONETOSEEANDEVENTOUCH
9OUMAYHAVEALREADYEXPERIENCEDTHAT
VAGUELYUNSETTLINGFEELINGTHATCOMESWITH
LEAVINGYOURINSTANCEVARIABLESEXPOSED
%XPOSEDMEANSREACHABLEWITHTHEDOT
OPERATORASIN
WKH&DWKHLJKW
4HINKABOUTTHISIDEAOFUSINGOURREMOTE
CONTROLTOMAKEADIRECTCHANGETOTHE#AT
OBJECTSSIZEINSTANCEVARIABLE)NTHEHANDS
OFTHEWRONGPERSONAREFERENCEVARIABLE
REMOTECONTROL ISQUITEADANGEROUS
WEAPON"ECAUSEWHATSTOPREVENT VHWWHU
I RU FL QJ H YH U\ERG\WRFDOODDWIURP
DQ·W
\LNHV:HF SSHQ
%\ QSURWHFWWKHF
PHWKRGZHFDVL]HFKDQJHV
WKH&DWKHLJKW OHWWKLVKD XQDFFHSWDEOH
4HISWOULDBEA"AD4HING7ENEEDTO SXEOLFYRLGVHW+HLJKWLQWKW^

BUILDSETTERMETHODSFORALLTHEINSTANCE
LIKW!^
VARIABLESANDlNDAWAYTOFORCEOTHER :HSXWLQ
CODETOCALLTHESETTERSRATHERTHANACCESS KHLJKW KW WRJXDUDQWFKHFNV
THEDATADIRECTLY ` PLQLPXPFD HHD
WKHLJKW
`
FKDSWHU
0QLM\PMLI\I ,CXC'ZRQUGF
9ESITISTHATSIMPLETOGOFROM 7KLVZHHN·VLQWHUYLHZ
ANIMPLEMENTATIONTHATSJUST $Q2EMHFWJHWVFDQGLGDERXWHQFDSVXODWLRQ
BEGGINGFORBADDATATOONE
THATPROTECTSYOURDATAAND +HDG)LUVW?PI\¼[\PMJQOLMITIJW]\MVKIX[]TI\QWV'
PROTECTSYOURRIGHTTOMODIFY 2EMHFW73aW]SVW_\PI\LZMIU_PMZMaW]¼ZMOQ^QVOI\ITS\WXMWXTM_PMVaW]
YOURIMPLEMENTATIONLATER []LLMVTaZMITQbM·aW]¼ZMVISML'
/+SOHOWEXACTLYDOYOU +HDG)LUVWAMIP_M¼^MPIL\PI\WVM1\¼[ZQOP\]X\PMZM_Q\P\PMWVMIJW]\\PM8QTI\M[
HIDETHEDATA7ITHTHE UIKPQVMIVLVW_M_WV¼\OW\PMZM73[WaW]NMMTVISML*]\W\PMZ\PIVJMQVOITQ\\TM
SXEOLFANDSULYDWH M`XW[MLQ[\PMZMIVaLIVOMZ'
ACCESSMODIlERS9OURE 2EMHFW1[\PMZMIVaLIVOMZ'1[\PMZMIVaLIVOMZ'C[\IZ\[TI]OPQVOE0MaLQLITTaW]W\PMZ
FAMILIARWITHSXEOLFnWEUSE QV[\IVKM[PMIZ\PI\¹1[\PMZMIVaLIVOMZ'ºPMI[S['CNITT[WV\PMÆWWZTI]OPQVOE
ITWITHEVERYMAINMETHOD
+HDG)LUVW?PI\¼[N]VVaIJW]\\PI\';MMU[TQSMIZMI[WVIJTMY]M[\QWV
(ERESANENCAPSULATION
2EMHFW731¼TTM`XTIQVQ\1\¼[CJ]Z[\[W]\TI]OPQVOIOIQV]VKWV\ZWTTIJTaE
STARTERRULEOFTHUMBALLSTAN
DARDDISCLAIMERSABOUTRULES +HDG)LUVW+IV1OM\aW]IVa\PQVO'?I\MZ'
OFTHUMBAREINEFFECT MARK 2EMHFW?PM_ 7PJWa6W1¼UÅVMZMITTa1¼TTJM[MZQW][,MMXJZMI\P73OWWV
YOURINSTANCEVARIABLESPRIVATE
ANDPROVIDEPUBLICGETTERS +HDG)LUVW;W_PI\LWM[MVKIX[]TI\QWVXZW\MK\aW]NZWU'
ANDSETTERSFORACCESSCONTROL 2EMHFW-VKIX[]TI\QWVX]\[INWZKMÅMTLIZW]VLUaQV[\IVKMÎZQIJTM[[WVWJWLaKIV[M\
7HENYOUHAVEMOREDESIGN \PMU\WTM\¼[[Ia[WUM\PQVOQVIXXZWXZQI\M
ANDCODINGSAVVYIN*AVAYOU +HDG)LUVW+IVaW]OQ^MUMIVMÌUXTM'
WILLPROBABLYDOTHINGSALITTLE
DIFFERENTLYBUTFORNOWTHIS 2EMHFW,WM[V¼\\ISMI8P,PMZM5W[\QV[\IVKMÎZQIJTMÎT]M[IZMKWLML_Q\PKMZ\IQV
APPROACHWILLKEEPYOUSAFE I[[]UX\QWV[IJW]\\PMJW]VLIZQM[WN \PMÎT]M[4QSM\PQVSWN ITT\PM\PQVO[\PI\_W]TL
JZMISQN VMOI\Q^MV]UJMZ[_MZMITTW_ML6]UJMZWN JI\PZWWU[QVIVWNÅKM>MTWKQ\aWN
IVIQZXTIVM*QZ\PLIa[*IZJMTT_MQOP\+MTTXPWVMV]UJMZ[5QKZW_I^MW^MVXW_MZ
0DUNLQVWDQFH +HDG)LUVW1[MM_PI\aW]UMIV;WPW_LWM[MVKIX[]TI\QWVTM\aW][M\JW]VLIZQM['
YDULDEOHVSULYDWH 2EMHFW*aNWZKQVOW\PMZKWLM\WOW\PZW]OP[M\\MZUM\PWL[<PI\_Ia\PM[M\\MZUM\PWL
KIVÎTQLI\M\PMXIZIUM\MZIVLLMKQLMQN Q\¼[LWIJTM5IaJM\PMUM\PWL_QTTZMRMK\Q\IVL
LWVW\PQVOWZUIaJMQ\¼TT\PZW_IV-`KMX\QWVTQSMQN Q\¼[IV]TT[WKQIT[MK]ZQ\aV]UJMZ
0DUNJHWWHUVDQG NWZIKZMLQ\KIZLIXXTQKI\QWVWZUIaJM\PMUM\PWL_QTTZW]VL\PMXIZIUM\MZ[MV\QV\W
VHWWHUVSXEOLF \PMVMIZM[\IKKMX\IJTMÎT]M<PMXWQV\Q[aW]KIVLW_PI\M^MZaW]_IV\QV\PM[M\\MZ
UM\PWL_PMZMI[aW]KIV¼\LWIVa\PQVOQN aW]ZQV[\IVKMÎZQIJTM[IZMX]JTQK
+HDG)LUVW*]\[WUM\QUM[1[MM[M\\MZUM\PWL[\PI\[QUXTa[M\\PMÎT]M_Q\PW]\KPMKS
QVOIVa\PQVO1N aW]PI^MIVQV[\IVKMÎZQIJTM\PI\LWM[V¼\PI^MIJW]VLIZaLWM[V¼\\PI\
[M\\MZUM\PWLKZMI\M]VVMKM[[IZaW^MZPMIL')XMZNWZUIVKMPQ\'
´6DGO\%LOOIRUJRWWR
HQFDSVXODWHKLV&DWFODVVDQG 2EMHFW<PMXWQV\\W[M\\MZ[IVLOM\\MZ[\WWQ[\PI\aW]KIVKPIVOMaW]ZUQVLTI\MZ
HQGHGXSZLWKDIODWFDWµ _Q\PW]\JZMISQVOIVaJWLaMT[M¼[KWLM 1UIOQVMQN PITN \PMXMWXTMQVaW]ZKWU
RYHUKHDUGDWWKHZDWHUFRROHU XIVa][MLaW]ZKTI[[_Q\PX]JTQKQV[\IVKMÎZQIJTM[IVLWVMLIaaW][]LLMVTaZMITQbML
¹7WX[·\PMZM¼[[WUM\PQVO1LQLV¼\XTIVNWZ_Q\P\PI\ÎT]M1¼UOWQVO\WPI^M\W[_Q\KP\WI
[M\\MZUM\PWLºAW]JZMISM^MZaWVM¼[KWLM<PMKWWT\PQVOIJW]\MVKIX[]TI\QWVQ[\PI\aW]
OM\\WKPIVOMaW]ZUQVL)VLVWJWLaOM\[P]Z\<PMXMZNWZUIVKMOIQVNZWU][QVOÎZQIJTM[
LQZMK\TaQ[[WUQVQ[K]TMIVL_W]TLZIZMTa¸QN M^MZ¸JM_WZ\PQ\
\RXDUHKHUH
KRZREMHFWVEHKDYH
FODVV*RRG'RJ^
-VKIX[]TI\QVO\PM *RRG'RJ
/WWL,WOKTI[[ FH
SULYDWHLQWVL]H
H WK H LQVWDQ VL]H
0DN SULYDWH
H
YDULDEO
SXEOLFLQWJHW6L]H^
UHWXUQVL]H JHW6L]H
` VHW6L]H
EDUN
QG
JHWWHUD SXEOLFYRLGVHW6L]HLQWV^
0DNHWKHHWKRGVSXEOLF
VHWWHUP VL]H V
`
Licensed by
(YHQWKRXJKWKHPHWKRGVGFRRQ·WUHDOO\
YRLGEDUN^
LIVL]H!^
ROWKLQJ 6\VWHPRXWSULQWOQ³:RRRI:RRRI´
DGGQHZIXQFWLRQDOLW\WKHXUPLQG
Eduard Simons
\R
LVWKDW\RXFDQFKDQJH DQGPDNHD `HOVHLIVL]H!^
ODWHU\RXFDQFRPHEDFN WHU 6\VWHPRXWSULQWOQ³5XII5XII´
PHWKRGVDIHUIDVWHUEHW `HOVH^
104038
6\VWHPRXWSULQWOQ³<LS<LS´
`
`
`
$Q\SODFHZKHUHD
SDUWLFXODUYDOXHFDQ FODVV*RRG'RJ7HVW'ULYH^
EHXVHGDPHWKRG
FDOOWKDWUHWXUQVWKDW SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^
W\SHFDQEHXVHG *RRG'RJRQH QHZ*RRG'RJ
RQHVHW6L]H
*RRG'RJWZR QHZ*RRG'RJ
LQVWHDGRI
WZRVHW6L]H
LQW[
6\VWHPRXWSULQWOQ³'RJRQH³RQHJHW6L]H
\RXFDQVD\ 6\VWHPRXWSULQWOQ³'RJWZR³WZRJHW6L]H
LQW[ RQHJHW6L]H RQHEDUN
WZREDUN
`
`
FKDSWHU
0W_LWWJRMK\[QVIVIZZIa
JMPI^M'
*USTLIKEANYOTHEROBJECT4HEONLYDIFFERENCEIS
HOWYOUGETTOTHEM)NOTHERWORDSHOWYOUGET
THEREMOTECONTROL,ETSTRYCALLINGMETHODSON
$OGOBJECTSINANARRAY
'HFODUHDQGFUHDWHD'RJDUUD\
WRKROG'RJUHIHUHQFHV
'RJ>@SHWV
SHWV QHZ'RJ>@
SHWV
'RJDUUD\REMHFW'RJ>@
'RJ>@
&UHDWHWZRQHZ'RJREMHFWV
DQGDVVLJQWKHPWRWKHÀUVW J2EMHFW
'R J2EMHFW
WZRDUUD\HOHPHQWV
'R

SHWV>@ QHZ'RJ
SHWV>@ QHZ'RJ VL]H
VL]H
&DOOPHWKRGVRQWKHWZR'RJ
REMHFWV
SHWV>@VHW6L]H
LQW[ SHWV>@JHW6L]H
SHWV>@VHW6L]H
SHWV
'RJDUUD\REMHFW'RJ>@
'RJ>@
\RXDUHKHUH
LQLWLDOL]LQJLQVWDQFHYDULDEOHV
,MKTIZQVOIVLQVQ\QITQbQVO
QV[\IVKMÎZQIJTM[
,QVWDQFHYDULDEOHV
9OUALREADYKNOWTHATAVARIABLEDECLARATIONNEEDSATLEASTANAME
ANDATYPE DOZD\VJHWD
LQWVL]H GHIDXOWYDOXH,I
6WULQJQDPH
\RXGRQ·WH[SOLFLWO\
!NDYOUKNOWTHATYOUCANINITIALIZEASSIGNAVALUE TOTHE DVVLJQDYDOXH
VARIABLEATTHESAMETIME
WRDQLQVWDQFH
LQWVL]H
6WULQJQDPH ³'RQQ\´ YDULDEOHRU\RX
GRQ·WFDOODVHWWHU
"UTWHENYOUDONTINITIALIZEANINSTANCEVARIABLEWHATHAPPENS
WHENYOUCALLAGETTERMETHOD)NOTHERWORDSWHATISTHEVALUEOF
PHWKRGWKH
ANINSTANCEVARIABLEBEFOREYOUINITIALIZEIT LQVWDQFHYDULDEOH
EOHV VWLOOKDVDYDOXH
QVWDQFHYDULD
GHFODUHWZDRLVVLJQDYDOXH
FODVV3RRU'RJ^
LQWHJHUV
SULYDWHLQWVL]H EXWGRQ·W
SULYDWH6WULQJQDPH IORDWLQJSRLQWV

SXEOLFLQWJHW6L]H^ :KDWZLOOWKHVHUHWXUQ"" ERROHDQV IDOVH
UHWXUQVL]H
UHIHUHQFHV QXOO
`
SXEOLF6WULQJJHW1DPH^
UHWXUQQDPH
`
`
N ":LOO
SXEOLFFODVV3RRU'RJ7HVW'ULYH^
D W G R \RXWKLOLQH"
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ :K YHQFRPS
3RRU'RJRQH QHZ3RRU'RJ WKLVH
6\VWHPRXWSULQWOQ³'RJVL]HLV³RQHJHW6L]H
6\VWHPRXWSULQWOQ³'RJQDPHLV³RQHJHW1DPH
`

` HLQVWDQFHYDULDEOHV LWLDOL]
<RXGRQ·WKDYHOZWRD\LQVKDYHDGHIDXOWYDOXH1XPWEHIDUOVH
EHFDXVHWKH\DFOXGLQJFKDUJHWERROHDQVJH
)LOH(GLW:LQGRZ+HOS&DOO9HW
MDYD3RRU'RJ7HVW'ULYH SULPLWLYHVLQ HUHQFHYDULDEOHVJHWQXOO

DQGREMHFWUHI RQWUROWKDW
WPHDQVDUHPRRWHDQF\WKLQJ$
'RJVL]HLV
5 HPHP EHU Q XO OM XV
SURJUDPPHGW
'RJQDPHLVQXOO LVQ·WFRQWUROOLQJQ WXDOREMHFW
UHIHUHQFHEXW DF R
FKDSWHU
<PMLQNNMZMVKMJM\ _MMVQV[\IVKM
IVLTWKITÎZQIJTM[
,QVWDQFHYDULDEOHVDUHGHFODUHG
LQVLGHDFODVVEXWQRWZLWKLQDPHWKRG /RFDOYDULDEOHVGR
FODVV+RUVH^ 127JHWDGHIDXOW
SULYDWHGRXEOHKHLJKW YDOXH7KHFRPSLOHU
SULYDWH6WULQJEUHHG
PRUHFRGH FRPSODLQVLI\RX
` WU\WRXVHDORFDO
YDULDEOHEHIRUH
WKHYDULDEOHLV
/RFDOYDULDEOHVDUHGHFODUHGZLWKLQDPHWKRG LQLWLDOL]HG
FODVV$GG7KLQJ^
LQWD
LQWE
WKHUH DUH QR
'XPE 4XHVWLRQV
SXEOLFLQWDGG^
LQWWRWDO DE
UHWXUQWRWDO
Q: 7HATABOUTMETHODPARAMETERS
(OWDOTHERULESABOUTLOCALVARIABLES
` APPLYTOTHEM
`

A: -ETHODPARAMETERSAREVIRTUALLYTHE
SAMEASLOCALVARIABLESTHEYREDECLARED
/RFDOYDULDEOHV0867EHLQLWLDOL]HGEHIRUHXVH INSIDETHEMETHODWELLTECHNICALLYTHEYRE
FODVV)RR^ DECLAREDINTHEARGUMENTLISTOFTHEMETHOD
FDQ
SXEOLFYRLGJR^ :RQ·WFRPSLOHRX<WRXDYDOXH RATHERTHANWITHINTHEBODYOFTHEMETHOD
GHFODUH[ ZL WK BUTTHEYRESTILLLOCALVARIABLESASOPPOSEDTO
LQW[ WU\
EXWDVVRRQDVKH\FRXRP INSTANCEVARIABLES "UTMETHODPARAMETERS
LQW] [ LW W SLOHU WILLNEVERBEUNINITIALIZEDSOYOULLNEVERGET
WR86(
`
IUHDNVRXW ACOMPILERERRORTELLINGYOUTHATAPARAMETER
VARIABLEMIGHTNOTHAVEBEENINITIALIZED
`
"UTTHATSBECAUSETHECOMPILERWILLGIVE
YOUANERRORIFYOUTRYTOINVOKEAMETHOD
)LOH(GLW:LQGRZ+HOS<LNHV
WITHOUTSENDINGARGUMENTSTHATTHEMETHOD
MDYDF)RRMDYD NEEDS3OPARAMETERSARE!,7!93INITIALIZED
BECAUSETHECOMPILERGUARANTEESTHAT
)RRMDYDYDULDEOH[PLJKW METHODSAREALWAYSCALLEDWITHARGUMENTS
QRWKDYHEHHQLQLWLDOL]HG THATMATCHTHEPARAMETERSDECLAREDFORTHE
METHODANDTHEARGUMENTSAREASSIGNED
LQW] [ AUTOMATICALLY TOTHEPARAMETERS
HUURUA
\RXDUHKHUH
REMHFWHTXDOLW\
+WUXIZQVOÎZQIJTM[XZQUQ\Q^M[WZZMNMZMVKM[
3OMETIMESYOUWANTTOKNOWIFTWOPRIMITIVESARETHESAME4HATSEASY
ENOUGHJUSTUSETHEOPERATOR3OMETIMESYOUWANTTOKNOWIFTWO
8VH WRFRPSDUH
REFERENCEVARIABLESREFERTOASINGLEOBJECTONTHEHEAP%ASYASWELLJUSTUSE WZRSULPLWLYHV
THEOPERATOR"UTSOMETIMESYOUWANTTOKNOWIFTWOOBJECTSAREEQUAL RUWRVHHLIWZR
!NDFORTHATYOUNEEDTHEEQUALS METHOD4HEIDEAOFEQUALITYFOR UHIHUHQFHVUHIHUWR
OBJECTSDEPENDSONTHETYPEOFOBJECT&OREXAMPLEIFTWODIFFERENT3TRING WKHVDPHREMHFW
OBJECTSHAVETHESAMECHARACTERSSAYhEXPEDITIOUSv THEYAREMEANINGFULLY
EQUIVALENTREGARDLESSOFWHETHERTHEYARETWODISTINCTOBJECTSONTHEHEAP 8VHWKHHTXDOV
"UTWHATABOUTA$OG$OYOUWANTTOTREATTWO$OGSASBEINGEQUALIFTHEY PHWKRGWRVHH
HAPPENTOHAVETHESAMESIZEANDWEIGHT0ROBABLYNOT3OWHETHERTWO
DIFFERENTOBJECTSSHOULDBETREATEDASEQUALDEPENDSONWHATMAKESSENSEFOR
LIWZRGLIIHUHQW
THATPARTICULAROBJECTTYPE7ELLEXPLORETHENOTIONOFOBJECTEQUALITYAGAIN REMHFWVDUHHTXDO
INLATERCHAPTERSANDAPPENDIX" BUTFORNOWWENEEDTOUNDERSTANDTHAT 6XFKDVWZRGLIIHUHQW
THEOPERATORISUSEDONLYTOCOMPARETHEBITSINTWOVARIABLES7HATTHOSE 6WULQJREMHFWVWKDWERWK
BITSREPRESENTDOESNTMATTER4HEBITSAREEITHERTHESAMEORTHEYRENOT UHSUHVHQWWKHFKDUDFWHUV
LQ´)UHGµ
7RFRPSDUHWZRSULPLWLYHVXVHWKH RSHUDWRU
4HEOPERATORCANBEUSEDTOCOMPARETWOVARIABLESOFANYKINDANDIT WKHELW

SIMPLYCOMPARESTHEBITS VDPHVRSWDWWHUQVDUHWKH
HTXDOXVLQ KHVHWZRDUH
IFAB []LOOKSATTHEBITSINAANDBANDRETURNSTRUEIFTHEBITPATTERN J
ISTHESAMEALTHOUGHITDOESNTCAREABOUTTHESIZEOFTHEVARIABLESOALLTHE
EXTRAZEROESONTHELEFTENDDONTMATTER RHVRQ U

HPRUH]H
LQWD WKHUHDWUVLGHRIWKHLQRXWW

I
WKHOH GRQ·WFDUHDE D E
E\WHE
EXWZH HUH
LID E^WUXH` WKDWK LQW E\WH
7RVHHLIWZRUHIHUHQFHVDUHWKHVDPHZKLFKPHDQVWKH\
UHIHUWRWKHVDPHREMHFWRQWKHKHDSXVHWKH RSHUDWRU
WKHELW
2EMEMBERTHEOPERATORCARESONLYABOUTTHEPATTERNOFBITSINTHE VDPHIRUSDWWHUQVDUHWKH
VARIABLE4HERULESARETHESAMEWHETHERTHEVARIABLEISAREFERENCEOR DUHHTXDO DDQGFVRWKH
PRIMITIVE3OTHEOPERATORRETURNSTRUEIFTWOREFERENCEVARIABLESREFERTO XVLQJ \
THESAMEOBJECT)NTHATCASEWEDONTKNOWWHATTHEBITPATTERNISBECAUSE
ITSDEPENDENTONTHE*6-ANDHIDDENFROMUS BUTWEDOKNOWTHATWHATEVER
ITLOOKSLIKEITWILLBETHESAMEFORTWOREFERENCESTOASINGLEOBJECT
)RRD QHZ)RR
)RRE QHZ)RR
Y
)RRF D
LID EÎDOVH` )RR
D FLVWUXH Z
;
LID F^WUXH`
LIE FÎDOVH` D ELVIDOVH )RR
)RR
FKDSWHU
,DOZD\V
NHHSP\YDULDEOHV
SULYDWH,I\RXZDQWWR
VHHWKHP\RXKDYHWR
WDONWRP\PHWKRGV
LFN
SULY
DWH
0DNH LWRE6DW
2OSESARE
ISCHOPPY
THISPOEM
YVALU E
PASSINGB
BYCOPY
ISPASSING R
EPLACEOU
R4RYIT2
Y O U C AN DOBETTE N " E TT E RYET
/HLIKE ITHYOURO
W
S
NDLINEW WNWORD
DUMBSECO T H IN G W ITHYOURO
T H E W H OLE
REPLACE ETIT
NEVERFORG
6KDUSHQ \RXU SHQFLO ANDYOULL
LQWD FDOF$UHD

:KDW·VOHJDO" VKRUWF
*LYHQWKHPHWKRGEHORZZKLFK
RIWKHPHWKRGFDOOVOLVWHGRQWKH FDOF$UHDF
ULJKWDUHOHJDO"
LQWG FDOF$UHD
3XWDFKHFNPDUNQH[WWRWKH
FDOF$UHD
RQHVWKDWDUHOHJDO6RPH
VWDWHPHQWVDUHWKHUHWRDVVLJQ ORQJW
YDOXHVXVHGLQWKHPHWKRGFDOOV
LQWI FDOF$UHDW
LQWJ FDOF$UHD
LQWFDOF$UHDLQWKHLJKWLQWZLGWK^ FDOF$UHD
UHWXUQKHLJKW ZLGWK E\WHK FDOF$UHD
` LQWM FDOF$UHD
\RXDUHKHUH
H[HUFLVH%HWKH&RPSLOHU
GHWHUPLQHZKHWKHUHDFKRIWKHVHILOHV
ZLOOFRPSLOH,IWKH\ZRQ·W
FRPSLOHKRZZRXOG\RX
IL[WKHPDQGLIWKH\GR
FRPSLOHZKDWZRXOGEH
WKHLURXWSXW"
$ %
FODVV;&RS\^ FODVV&ORFN^
6WULQJWLPH
YRLGVHW7LPH6WULQJW^
LQWRULJ
WLPH W
;&RS\[ QHZ;&RS\ `
LQW\ [JRRULJ YRLGJHW7LPH^

UHWXUQWLPH
6\VWHPRXWSULQWOQRULJ´´\ `
`
`
LQWJRLQWDUJ^
FODVV&ORFN7HVW'ULYH^
DUJ DUJ SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^

UHWXUQDUJ &ORFNF QHZ&ORFN
`
`
FVHW7LPH´µ
6WULQJWRG FJHW7LPH
6\VWHPRXWSULQWOQ´WLPH´WRG
`
`
FKDSWHU
1dQÔU_Q !BUNCHOF*AVACOMPONENTSINFULLCOSTUMEAREPLAYINGAPARTY

GAMEh7HOAM)v4HEYGIVEYOUACLUEANDYOUTRYTOGUESSWHO
THEYAREBASEDONWHATTHEYSAY!SSUMETHEYALWAYSTELLTHETRUTH
ABOUTTHEMSELVES)FTHEYHAPPENTOSAYSOMETHINGTHATCOULDBETRUE
FORMORETHANONEGUYTHENWRITEDOWNALLFORWHOMTHATSENTENCE
APPLIES&ILLINTHEBLANKSNEXTTOTHESENTENCEWITHTHENAMESOFONE
ORMOREATTENDEES
4ONIGHTSATTENDEES
D P ," INSTANCEVARIABLEARGUMENTRETURNGETTERSETTER
:K R ENCAPSULATIONPUBLICPRIVATEPASSBYVALUEMETHOD
$FODVVFDQKDYHDQ\QXPEHURI WKHVH
$PHWKRGFDQKDYHRQO\RQHRI WKHVH
7KLVFDQEHLPSOLFLWO\SURPRWHG
,SUHIHUP\LQVWDQFHYDULDEOHVSULYDWH
,WUHDOO\PHDQV¶PDNHDFRS\·
2QO\VHWWHUVVKRXOGXSGDWHWKHVH
$PHWKRGFDQKDYHPDQ\RI WKHVH
,UHWXUQVRPHWKLQJE\GHILQLWLRQ
,VKRXOGQ·WEHXVHGZLWKLQVWDQFHYDULDEOHV
,FDQKDYHPDQ\DUJXPHQWV
%\GHILQLWLRQ,WDNHRQHDUJXPHQW
7KHVHKHOSFUHDWHHQFDSVXODWLRQ
,DOZD\VIO\VROR
\RXDUHKHUH
SX]]OH0L[HG0HVVDJHV
-IXED
-ESSAGES
!SHORT*AVAPROGRAMISLISTEDTOYOURRIGHT SXEOLFFODVV0L[^
4WOBLOCKSOFTHEPROGRAMAREMISSING
9OURCHALLENGEISTOMATCHTHECANDIDATE LQWFRXQWHU
BLOCKSOFCODEBELOW WITHTHEOUTPUT SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^
THATYOUDSEEIFTHEBLOCKSWEREINSERTED LQWFRXQW
.OTALLTHELINESOFOUTPUTWILLBEUSEDAND 0L[>@PD QHZ0L[>@
SOMEOFTHELINESOFOUTPUTMIGHTBEUSED
LQW[
MORETHANONCE$RAWLINESCONNECTING
THECANDIDATEBLOCKSOFCODEWITHTHEIR ZKLOH^
MATCHINGCOMMAND LINEOUTPUT
PD>[@ QHZ0L[
PD>[@FRXQWHU PD>[@FRXQWHU
FRXQW FRXQW
FRXQW FRXQWPD>[@PD\EH1HZ[
[ [
`
6\VWHPRXWSULQWOQFRXQW³³
PD>@FRXQWHU
#ANDIDATES 0OSSIBLEOUTPUT `

[ SXEOLFLQWPD\EH1HZLQWLQGH[^
LQGH[ LI^

0L[P QHZ0L[
[ PFRXQWHU PFRXQWHU
UHWXUQ
LQGH[ `

UHWXUQ
`
[
`
LQGH[
[
LQGH[
FKDSWHU
SXEOLFFODVV3X]]OH^
BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
LQW\
3RRO3X]]OH LQW[
9OURJOBISTOTAKECODESNIPPETSFROMTHE LQWUHVXOW
POOLANDPLACETHEMINTOTHEBLANKLINES ZKLOH[^
INTHECODE9OUMAYNOTUSETHESAME BBBBBBBBBBBBBBBBBBBBBBBBBBB
SNIPPETMORETHANONCEANDYOUWONT
BBBBBBBBBBBBBBBBBBBBBBBBBBB
NEEDTOUSEALLTHESNIPPETS9OURGOAL
ISTOMAKEACLASSTHATWILLCOMPILEAND \ \
RUNANDPRODUCETHEOUTPUTLISTED BBBBBBBBBBBBBBBBB
`
[
ZKLOH[!^
BBBBBBBBBBBBBBBBB
UHVXOW UHVXOWBBBBBBBBBBBBBBBBBBB
/UTPUT `
)LOH(GLW:LQGRZ+HOS%HOO\)ORS 6\VWHPRXWSULQWOQÚHVXOWÚHVXOW
`
MDYD3X]]OH
`
UHVXOW
FODVVBBBBBBBBBBB^
LQWLYDU
BBBBBBBBBBBBBBGR6WXIILQWBBBBBBBBB^
LILYDU!^
UHWXUQBBBBBBBBBBBBBBBBBBBBBBBBB
`HOVH^
UHWXUQBBBBBBBBBBBBBBBBBBBBBBBBB
`
`
`
.OTE%ACHSNIPPET
FROMTHEPOOLCANBE
USEDONLYONCE DO3TUFFX
OBSDO3TUFFX
OBS;X=DO3TUFFFACTOR
IVARX
OBS;X=DO3TUFFX IVARFACTOR
OBSIVARX 0UZZLE
OBS;X=IVARX IVAR IVAR
FACTOR 0UZZLEB INT
OBS;X=IVARY FACTOR IVAR
FACTOR 0UZZLEB SHORT
IVAR
FACTOR
0UZZLE;=OBSNEW0UZZLE;= PUBLIC
OBS;X=NEW0UZZLEBX
0UZZLEB;=OBSNEW0UZZLEB;= PRIVATE XX OBS;=NEW0UZZLEB
0UZZLEB;=OBSNEW0UZZLE;= XX OBS;X=NEW0UZZLEB
OBSNEW0UZZLEB
\RXDUHKHUH
SX]]OH)LYH0LQXWH0\VWHU\
)DVW7LPHVLQ6WLP&LW\
:KHQ%XFKDQDQMDPPHGKLVWZLWFKJXQLQWR-DL¶VVLGH-DLIUR]H-DLNQHZWKDW%XFKDQDQ
ZDVDVVWXSLGDVKHZDVXJO\DQGKHGLGQ¶WZDQWWRVSRRNWKHELJJX\%XFKDQDQRUGHUHG-DL
LQWRKLVERVV¶VRI¿FHEXW-DL¶GGRQHQRWKLQJZURQJODWHO\VRKH¿JXUHGDOLWWOHFKDWZLWK
%XFKDQDQ¶VERVV/HYHOHUFRXOGQ¶WEHWRREDG+H¶GEHHQPRYLQJORWVRIQHXUDOVWLPPHUVLQ
WKHZHVWVLGHODWHO\DQGKH¿JXUHG/HYHOHUZRXOGEHSOHDVHG%ODFNPDUNHWVWLPPHUVZHUHQ¶W
WKHEHVWPRQH\SXPSDURXQGEXWWKH\ZHUHSUHWW\KDUPOHVV0RVWRIWKHVWLPMXQNLHVKH¶G
VHHQWDSSHGRXWDIWHUDZKLOHDQGJRWEDFNWROLIHPD\EHMXVWDOLWWOHOHVVIRFXVHGWKDQEHIRUH
)LYH0LQXWH /HYHOHU¶VµRI¿FH¶ZDVDVNXQJ\ORRNLQJVNLPPHUEXWRQFH%XFKDQDQVKRYHGKLPLQ-DL
FRXOGVHHWKDWLW¶GEHHQPRGL¿HGWRSURYLGHDOOWKHH[WUDVSHHGDQGDUPRUWKDWDORFDOERVVOLNH
0\VWHU\
Licensed by
/HYHOHUFRXOGKRSHIRU³-DLP\ER\´KLVVHG/HYHOHU³SOHDVXUHWRVHH\RXDJDLQ´³/LNHZLVH
,¶PVXUH´VDLG-DLVHQVLQJWKHPDOLFHEHKLQG/HYHOHU¶VJUHHWLQJ³:HVKRXOGEHVTXDUH
/HYHOHUKDYH,PLVVHGVRPHWKLQJ"´³+D<RX¶UHPDNLQJLWORRNSUHWW\JRRG-DL\RXUYROXPH
LVXSEXW,¶YHEHHQH[SHULHQFLQJVKDOOZHVD\DOLWWOHµEUHDFK¶ODWHO\´VDLG/HYHOHU
Eduard Simons
-DLZLQFHGLQYROXQWDULO\KH¶GEHHQDWRSGUDZHUMDFNKDFNHULQKLVGD\$Q\WLPHVRPHRQH
¿JXUHGRXWKRZWREUHDNDVWUHHWMDFN¶VVHFXULW\XQZDQWHGDWWHQWLRQWXUQHGWRZDUG-DL³1R
ZD\LW¶VPHPDQ´VDLG-DL³QRWZRUWKWKHGRZQVLGH,¶PUHWLUHGIURPKDFNLQJ,MXVWPRYH
P\VWXIIDQGPLQGP\RZQEXVLQHVV´³<HDK\HDKÓDXJKHG/HYHOHU³,¶PVXUH\RX¶UH
FOHDQRQWKLVRQHEXW,¶OOEHORVLQJELJPDUJLQVXQWLOWKLVQHZMDFNKDFNHULVVKXW
104038
RXW´³:HOOEHVWRIOXFN/HYHOHUPD\EH\RXFRXOGMXVWGURSPHKHUHDQG,¶OOJR
PRYHDIHZPRUHµXQLWV¶IRU\RXEHIRUH,ZUDSXSWRGD\´VDLG-DL
³,¶PDIUDLGLW¶VQRWWKDWHDV\-DL%XFKDQDQKHUHWHOOVPHWKDWZRUGLV\RX¶UH
FXUUHQWRQ-1(´LQVLQXDWHG/HYHOHU³1HXUDO(GLWLRQ"VXUH,SOD\DURXQGDELWVR
ZKDW"´-DLUHVSRQGHGIHHOLQJDOLWWOHTXHDV\³1HXUDOHGLWLRQ¶VKRZ,OHWWKHVWLPMXQNLHV
NQRZZKHUHWKHQH[WGURSZLOOEH´H[SODLQHG/HYHOHU³7URXEOHLVVRPHVWLPMXQNLH¶VVWD\HG
VWUDLJKWORQJHQRXJKWR¿JXUHRXWKRZWRKDFNLQWRP\:DUH+RXVLQJGDWDEDVH´³,QHHGD
TXLFNWKLQNHUOLNH\RXUVHOI-DLWRWDNHDORRNDWP\6WLP'URS-1(FODVVPHWKRGVLQVWDQFH
YDULDEOHVWKHZKROHHQFKLODGDDQG¿JXUHRXWKRZWKH\¶UHJHWWLQJLQ,WVKRXOG´³+(<´
H[FODLPHG%XFKDQDQ³,GRQ¶WZDQWQRVFXPKDFNHUOLNH-DLQRVLQ¶DURXQGP\FRGH´³(DV\
ELJJX\´-DLVDZKLVFKDQFH³,¶PVXUH\RXGLGDWRSUDWHMREZLWK\RXUDFFHVVPRGL³'RQ¶W
WHOOPHELWWZLGGOHU´VKRXWHG%XFKDQDQ³,OHIWDOORIWKRVHMXQNLHOHYHOPHWKRGVSXEOLF
VRWKH\FRXOGDFFHVVWKHGURSVLWHGDWDEXW,PDUNHGDOOWKHFULWLFDO:DUH+RXVLQJPHWKRGV
SULYDWH1RERG\RQWKHRXWVLGHFDQDFFHVVWKRVHPHWKRGVEXGG\QRERG\´
³,WKLQN,FDQVSRW\RXUOHDN/HYHOHUZKDWVD\ZHGURS%XFKDQDQKHUHRIIDWWKHFRUQHU
DQGWDNHDFUXLVHDURXQGWKHEORFN´VXJJHVWHG-DL%XFKDQDQUHDFKHGIRUKLVWZLWFKJXQEXW
/HYHOHU¶VVWXQQHUZDVDOUHDG\RQ%XFKDQDQ¶VQHFN³/HWLWJR%XFKDQDQ´VQHHUHG/HYHOHU
³'URSWKHWZLWFKHUDQGVWHSRXWVLGH,WKLQN-DLDQG,KDYHVRPHSODQVWRPDNH´
:KDWGLG-DLVXVSHFW"
:LOOKHJHWRXWRI/HYHOHU¶VVNLPPHUZLWKDOOKLVERQHVLQWDFW"
FKDSWHU
FODVV&ORFN^
([HUFLVH6ROXWLRQV
6WULQJWLPH
YRLGVHW7LPH6WULQJW^
WLPH W
% `
6WULQJJHW7LPH^
UHWXUQWLPH
`
`
FODVV&ORFN7HVW'ULYH^
&ORFNF QHZ&ORFN
FVHW7LPH´µ
6WULQJWRG FJHW7LPH
6\VWHPRXWSULQWOQ´WLPH´WRG
`
`1RWH¶*HWWHU·PHWKRGVKDYHDUHWXUQ
$&ODVVµ;&RS\¶FRPSLOHVDQGUXQVDVLWVWDQGV7KH W\SHE\GHÀQLWLRQ
RXWSXWLVµ¶5HPHPEHU-DYDLVSDVVE\YDOXHZKLFK
PHDQVSDVVE\FRS\WKHYDULDEOHµRULJ¶LVQRWFKDQJHGE\WKH
JRPHWKRG
$FODVVFDQKDYHDQ\QXPEHURIWKHVH LQVWDQFHYDULDEOHVJHWWHUVHWWHUPHWKRG
$PHWKRGFDQKDYHRQO\RQHRIWKHVH UHWXUQ
7KLVFDQEHLPSOLFLWO\SURPRWHG UHWXUQDUJXPHQW
,SUHIHUP\LQVWDQFHYDULDEOHVSULYDWH HQFDSVXODWLRQ
,WUHDOO\PHDQVµPDNHDFRS\¶ SDVVE\YDOXH
2QO\VHWWHUVVKRXOGXSGDWHWKHVH LQVWDQFHYDULDEOHV
$PHWKRGFDQKDYHPDQ\RIWKHVH DUJXPHQW
,UHWXUQVRPHWKLQJE\GH¿QLWLRQ JHWWHU
,VKRXOGQ¶WEHXVHGZLWKLQVWDQFHYDULDEOHV SXEOLF
,FDQKDYHPDQ\DUJXPHQWV PHWKRG
%\GH¿QLWLRQ,WDNHRQHDUJXPHQW VHWWHU
7KHVHKHOSFUHDWHHQFDSVXODWLRQ JHWWHUVHWWHUSXEOLFSULYDWH
,DOZD\VÀ\VROR UHWXUQ
\RXDUHKHUH
SX]]OHDQVZHUV
3X]]OH6ROXWLRQV
$QVZHUWRWKHPLQXWHP\VWHU\
SXEOLFFODVV3X]]OH^
-DLNQHZWKDW%XFKDQDQZDVQ¶WWKHVKDUSHVW
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ SHQFLOLQWKHER[:KHQ-DLKHDUG%XFKDQDQ
3X]]OHE>@REV QHZ3X]]OHE>@ WDONDERXWKLVFRGH%XFKDQDQQHYHUPHQWLRQHG
LQW\ KLVLQVWDQFHYDULDEOHV-DLVXVSHFWHGWKDW
LQW[ ZKLOH%XFKDQDQGLGLQIDFWKDQGOHKLVPHWKRGV
LQWUHVXOW
FRUUHFWO\KHIDLOHGWRPDUNKLVLQVWDQFHYDULDEOHV
ZKLOH[^
SULYDWH7KDWVOLSXSFRXOGKDYHHDVLO\FRVW
REV>[@ QHZ3X]]OHE
/HYHOHUWKRXVDQGV
REV>[@LYDU \
\ \
[ [
`
[
ZKLOH[!^
[ [
UHVXOW UHVXOWREV>[@GR6WXII[ #ANDIDATES 0OSSIBLEOUTPUT
`
6\VWHPRXWSULQWOQÚHVXOWÚHVXOW [
`
`
LQGH[
FODVV3X]]OHE^
LQWLYDU
SXEOLFLQWGR6WXIILQWIDFWRU^ [
LILYDU!^
UHWXUQLYDU IDFWRU LQGH[
`HOVH^
UHWXUQLYDU IDFWRU
` /UTPUT [
` )LOH(GLW:LQGRZ+HOS%HOO\)ORS
` MDYD3X]]OH
LQGH[
UHVXOW
[
LQGH[
FKDSWHU
ZULWLQJDSURJUDP
([WUD6WUHQJWK0HWKRGV
,FDQOLIW
KHDY\REMHFWV
/HW·VSXWVRPHPXVFOHLQRXUPHWKRGV7EDABBLEDWITHVARIABLESPLAYED
WITHAFEWOBJECTSANDWROTEALITTLECODE"UTWEWEREWEAK7ENEEDMORETOOLS,IKE
OPERATORS7ENEEDMOREOPERATORSSOWECANDOSOMETHINGALITTLEMOREINTERESTINGTHANSAY
BARK!NDLOOPS7ENEEDLOOPSBUTWHATSWITHTHEWIMPYWHILELOOPS7ENEEDFORLOOPS
IFWEREREALLYSERIOUS-IGHTBEUSEFULTOGENERATERANDOMNUMBERS!NDTURNA3TRING
INTOANINTYEAHTHATWOULDBECOOL"ETTERLEARNTHATTOO!NDWHYDONTWELEARNITALLBY
BUILDINGSOMETHINGREALTOSEEWHATITSLIKETOWRITEANDTEST APROGRAMFROMSCRATCH-AYBE
AGAMELIKE"ATTLESHIPS4HATSAHEAVY LIFTINGTASKSOITLLTAKETWOCHAPTERSTOFINISH7ELLBUILD
ASIMPLEVERSIONINTHISCHAPTERANDTHENBUILDAMOREPOWERFULDELUXEVERSIONINCHAPTER
WKLVLVDQHZFKDSWHU
EXLOGLQJDUHDOJDPH
4M\¼[J]QTLI*I\\TM[PQX[\ aTM
OIUM"¹;QVSI,W\+WUº
)TSYOUAGAINSTTHECOMPUTERBUTUNLIKETHEREAL
"ATTLESHIPGAMEINTHISONEYOUDONTPLACEANYSHIPS <RX·UHJRLQJWREXLOGWKH
OFYOUROWN)NSTEADYOURJOBISTOSINKTHECOMPUTERS 6LQND'RW&RPJDPHZLWK
SHIPSINTHEFEWESTNUMBEROFGUESSES
D[JULGDQGWKUHH
/HANDWEARENTSINKINGSHIPS7EREKILLING$OT 'RW&RPV(DFK'RW&RP
#OMS4HUSESTABLISHINGBUSINESSRELEVANCYSOYOUCAN
WDNHVXSWKUHHFHOOV
EXPENSETHECOSTOFTHISBOOK
'OAL3INKALLOFTHECOMPUTERS$OT#OMSINTHEFEWEST
NUMBEROFGUESSES9OUREGIVENARATINGORLEVELBASED
ONHOWWELLYOUPERFORM
XIZ\WNIOIUMQV\MZIK\QWV
3ETUP7HENTHEGAMEPROGRAMISLAUNCHEDTHE
COMPUTERPLACESTHREE$OT#OMSONAVIRTUALX )LOH(GLW:LQGRZ+HOS6HOO
GRID7HENTHATSCOMPLETETHEGAMEASKSFORYOURlRST MDYD'RW&RP%XVW

GUESS (QWHUDJXHVV$
(OWYOUPLAY7EHAVENTLEARNEDTOBUILDA'5)YETSO PLVV
THISVERSIONWORKSATTHECOMMAND LINE4HECOMPUTER
WILLPROMPTYOUTOENTERAGUESSACELL THATYOULLTYPE (QWHUDJXHVV%
ATTHECOMMAND LINEASh!vh#vETC )NRESPONSE PLVV
TOYOURGUESSYOULLSEEARESULTATTHECOMMAND
(QWHUDJXHVV&
LINEEITHERh(ITvh-ISSvORh9OUSUNK0ETSCOMvOR
WHATEVERTHELUCKY$OT#OMOFTHEDAYIS 7HEN PLVV
YOUVESENTALLTHREE$OT#OMSTOTHATBIGINTHE (QWHUDJXHVV'
SKYTHEGAMEENDSBYPRINTINGOUTYOURRATING
HDFKER[µ
KLW
;JULG LVD´FHOO (QWHUDJXHVV'
KLW
!
(QWHUDJXHVV'
" 2XFK<RXVXQN3HWVFRP
'OCOM
# NLOO
(QWHUDJXHVV%
$ 0ETSCOM
PLVV
% (QWHUDJXHVV*
& KLW
(QWHUDJXHVV*
' !SK-ECOM
KLW
(QWHUDJXHVV*
2XFK<RXVXQN$VN0HFRP
VWDUWVDW]HUROLNH-DYDDUUD\V
NLOO
FKDSWHU (QWHUDJXHVV$
PLVV
(QWHU D JXHVV %
ZULWLQJDSURJUDP
.QZ[\IPQOPTM^MTLM[QOV
7EKNOWWELLNEEDCLASSESANDMETHODSBUTWHAT HDQV
SHOULDTHEYBE4OANSWERTHATWENEEDMORE $FLUFOHPILQLVK
INFORMATIONABOUTWHATTHEGAMESHOULDDO VWDUWRU
&IRSTWENEEDTOlGUREOUTTHEGENERALmOWOFTHE
OHLV
$UHFWDQUJHSUHVHQW
GAME(ERESTHEBASICIDEA 6WDUW
XVHGWR Q
DQDFWLR
8VHUVWDUWVWKHJDPH
*DPHVHWXS
) *
) *DPHFUHDWHVWKUHH'RW&RPV
* *DPHSODFHVWKHWKUHH'RW *HWXVHU
&RPVRQWRDYLUWXDOJULG JXHVV )
*DPHSOD\EHJLQV
PLVV &KHFN KLW UHPRYHORFD
5HSHDWWKHIROORZLQJXQWLOWKHUHDUH JXHVV WLRQFHOO
QRPRUH'RW&RPV *
) 3URPSWXVHUIRUDJXHVV NLOO
´$µ´&µHWF
UHPRYH
'RW&RP
* &KHFNWKHXVHUJXHVVDJDLQVW
DOO'RW&RPVWRORRNIRUDKLW
PLVVRUNLOO7DNHDSSURSUL
DWHDFWLRQLIDKLWGHOHWHFHOO $GLDPRQG
$'HWF,IDNLOOGHOHWH \HV VWLOOVRPH UHSUHVHQWVD
'RW&RP
'RW&RPV
DOLYH"
GHFLVLRQSRLQW
*DPHÀQLVKHV

QR
*LYHWKHXVHUDUDWLQJEDVHGRQ GLVSOD\XVHU
WKHQXPEHURIJXHVVHV VFRUHUDWLQJ
.OWWEHAVEANIDEAOFTHEKINDSOFTHINGSTHE
JDPH
PROGRAMNEEDSTODO4HENEXTSTEPISlGURING
RYHU
OUTWHATKINDOFOBJECTSWELLNEEDTODOTHE
WORK2EMEMBERTHINKLIKE"RADRATHERTHAN
,ARRYFOCUSlRSTONTHETHINGSINTHEPROGRAM
RATHERTHANTHEPROCEDURES
:KRD$UHDOÀRZFKDUW
\RXDUHKHUH
DVLPSOHUYHUVLRQRI WKHJDPH
<PM¹;QUXTM,W\+WU/IUMº
IOMV\TMZQV\ZWL]K\QWV *DPHVWDUWVDQGFUHDWHV21('RW&RP
DQGJLYHVLWDORFDWLRQRQWKUHHFHOOVLQ
)TLOOKSLIKEWEREGONNANEEDATLEASTTWOCLASSESA WKHVLQJOHURZRIVHYHQFHOOV
'AMECLASSANDA$OT#OMCLASS"UTBEFOREWEBUILD
THEFULLMONTY3INKA$OT#OMGAMEWELLSTARTWITH ,QVWHDGRI´$µ´&µDQGVRRQWKH
ORFDWLRQVDUHMXVWLQWHJHUVIRUH[DPSOH
ASTRIPPED DOWNSIMPLIlEDVERSION3IMPLE$OT#OM
DUHWKHFHOOORFDWLRQVLQWKLV
'AME7ELLBUILDTHESIMPLEVERSIONINTHISCHAPTER SLFWXUH
FOLLOWEDBYTHEDELUXEVERSIONTHATWEBUILDINTHE
NEXTCHAPTER
%VERYTHINGISSIMPLERINTHISGAME)NSTEADOFA $

GRIDWEHIDETHE$OT#OMINJUSTASINGLEROW!ND
INSTEADOFTHREE$OT#OMSWEUSEONE
*DPHSOD\EHJLQV3URPSWXVHUIRU
4HEGOALISTHESAMETHOUGHSOTHEGAMESTILLNEEDS DJXHVVWKHQFKHFNWRVHHLILWKLW
TOMAKEA$OT#OMINSTANCEASSIGNITALOCATION DQ\RIWKH'RW&RP·VWKUHHFHOOV
SOMEWHEREINTHEROWGETUSERINPUTANDWHENALL ,IDKLWLQFUHPHQWWKHQXP2I+LWV
OFTHE$OT#OMSCELLSHAVEBEENHITTHEGAMEISOVER YDULDEOH
4HISSIMPLIlEDVERSIONOFTHE
GAMEGIVESUSABIGHEADSTART 6LPSOH'RW&RP*DPH *DPHÀQLVKHVZKHQDOOWKUHHFHOOVKDYH
ONBUILDINGTHEFULLGAME EHHQKLWWKHQXP2I+LWVYDULDEOHYDO
XHLVDQGWHOOVWKHXVHUKRZPDQ\
)FWECANGETTHISSMALLONE
6LPSOH'RW&RP JXHVVHVLWWRRNWRVLQNWKH'RW&RP
WORKINGWECANSCALEITUPTO
THEMORECOMPLEXONELATER LQW>@ORFDWLRQ&HOOV
YRLGPDLQ LQWQXP2I+LWV
)NTHISSIMPLEVERSIONTHE )KWUXTM\MOIUMQV\MZIK\QWV
GAMECLASSHASNOINSTANCE
)LOH(GLW:LQGRZ+HOS'HVWUR\
VARIABLESANDALLTHEGAME 6WULQJFKHFN<RXUVHOI6WU
LQJJXHVV
CODEISINTHEMAIN METHOD MDYD6LPSOH'RW&RP*DPH
YRLGVHW/RFDWLRQ&HOOVLQ
)NOTHERWORDSWHENTHE W>@ORF HQWHUDQXPEHU
PROGRAMISLAUNCHEDAND KLW
MAIN BEGINSTORUNITWILL HQWHUDQXPEHU
MAKETHEONEANDONLY$OT#OM
INSTANCEPICKALOCATIONFORITTHREE KLW
CONSECUTIVECELLSONTHESINGLEVIRTUAL HQWHUDQXPEHU
SEVEN CELLROW ASKTHEUSERFORAGUESSCHECKTHE PLVV
GUESSANDREPEATUNTILALLTHREECELLSHAVEBEENHIT HQWHUDQXPEHU
+EEPINMINDTHATTHEVIRTUALROWISVIRTUAL)NOTHER NLOO
WORDSITDOESNTEXISTANYWHEREINTHEPROGRAM!S <RXWRRNJXHVVHV
LONGASBOTHTHEGAMEANDTHEUSERKNOWTHATTHE
$OT#OMISHIDDENINTHREECONSECUTIVECELLSOUTOFA
POSSIBLESEVENSTARTINGATZERO THEROWITSELFDOESNT
HAVETOBEREPRESENTEDINCODE9OUMIGHTBETEMPTED
TOBUILDANARRAYOFSEVENINTSANDTHENASSIGNTHE
$OT#OMTOTHREEOFTHESEVENELEMENTSINTHEARRAY
BUTYOUDONTNEEDTO!LLWENEEDISANARRAYTHAT
HOLDSJUSTTHETHREECELLSTHE$OT#OMOCCUPIES
FKDSWHU
ZULWLQJDSURJUDP
,M^MTWXQVOI+TI[[ <PM\PZMM\PQVO[_M¼TT_ZQ\MNWZ
MIKPKTI[["
!SAPROGRAMMERYOUPROBABLYHAVEAMETHODOLOGY
PROCESSAPPROACHTOWRITINGCODE7ELLSODOWE/UR
SEQUENCEISDESIGNEDTOHELPYOUSEEANDLEARN WHAT SUHSFRGH WHVWFRGH UHDOFRGH
WERETHINKINGASWEWORKTHROUGHCODINGACLASS)T
ISNTNECESSARILYTHEWAYWEORYOU WRITECODEINTHE
2EAL7ORLD)NTHE2EAL7ORLDOFCOURSEYOULLFOLLOW 4HISBARISDISPLAYEDONTHENEXTSETOFPAGESTOTELL
THEAPPROACHYOURPERSONALPREFERENCESPROJECTOR YOUWHICHPARTYOUREWORKINGON&OREXAMPLEIFYOU
EMPLOYERDICTATE7EHOWEVERCANDOPRETTYMUCH SEETHISPICTUREATTHETOPOFAPAGEITMEANSYOURE
WORKINGONPREPCODEFORTHE3IMPLE$OT#OMCLASS
WHATEVERWEWANT!NDWHENWECREATEA*AVACLASSASA
hLEARNINGEXPERIENCEvWEUSUALLYDOITLIKETHIS
6LPSOH'RW&RPFODVV
SUHSFRGH WHVWFRGH UHDOFRGH
&IGUREOUTWHATTHECLASSISSUPPOSEDTODO
,ISTTHEINSTANCEVARIABLESANDMETHODS
SUHSFRGH
7RITEPREPCODEFORTHEMETHODS9OULLSEE $IRUPRISVHXGRFRGHWRKHOS\RXIRFXVRQ
THISINJUSTAMOMENT WKHORJLFZLWKRXWVWUHVVLQJDERXWV\QWD[
7RITETESTCODEFORTHEMETHODS
WHVWFRGH
)MPLEMENTTHECLASS $FODVVRUPHWKRGVWKDWZLOOWHVWWKHUHDOFRGH
DQGYDOLGDWHWKDWLW¶VGRLQJWKHULJKWWKLQJ
4ESTTHEMETHODS
$EBUGANDREIMPLEMENTASNEEDED UHDOFRGH
7KHDFWXDOLPSOHPHQWDWLRQRIWKHFODVV7KLVLV
%XPRESSGRATITUDETHATWEDONTHAVETOTEST ZKHUHZHZULWHUHDO-DYDFRGH
<W,W"
OURSO CALLEDLEARNINGEXPERIENCEAPPON
ACTUALLIVEUSERS
VV
W&RPFOD
6LPSOH'R
SUHSFRGH
ZULWH
HWHVWFRGH
ZULW
FRGH
YiXè H¿QDO-DYD
ZULW
gfn\i W&RP*DP
H
6LPSOH'R
&LEXTHOSEDENDRITES FODVV
H
HSUHSFRG
(OWWOULDYOUDECIDEWHICHCLASSORCLASSES ZULW
H>QR@
TOBUILDlRSTWHENYOUREWRITINGAPROGRAM ULWHWHVWFRG
Z
!SSUMINGTHATALLBUTTHETINIESTPROGRAMS FRGH
H¿QDO-DYD
NEEDMORETHANONECLASSIFYOUREFOLLOWING ZULW
GOOD//PRINCIPLESANDNOTHAVINGONECLASS
DOMANYDIFFERENTJOBS WHEREDOYOUSTART
\RXDUHKHUH
6LPSOH'RW&RPFODVV
9OULLGETTHEIDEAOFHOWPREPCODEOURVERSIONOFPSEUDOCODE WORKSASYOU
READTHROUGHTHISEXAMPLE)TSSORTOFHALF WAYBETWEENREAL*AVACODEANDAPLAIN
6LPSOH'RW&RP
%NGLISHDESCRIPTIONOFTHECLASS-OSTPREPCODEINCLUDESTHREEPARTSINSTANCE
LQW>@ORFDWLRQ&HOOV
LQWQXP2I+LWV
VARIABLEDECLARATIONSMETHODDECLARATIONSMETHODLOGIC4HEMOSTIMPORTANT
PARTOFPREPCODEISTHEMETHODLOGICBECAUSEITDElNESWHATHASTOHAPPEN
6WULQJFKHFN<RXUVHOI6WULQJJXHVV
WHICHWELATERTRANSLATEINTOHOWWHENWEACTUALLYWRITETHEMETHODCODE
YRLGVHW/RFDWLRQ&HOOVLQW>@ORF
()'0%6)ERMRXEVVE]XSLSPHXLIPSGEXMSRGIPPW'EPPMXPSGEXMSR'IPPW
()'0%6)ERMRXXSLSPHXLIRYQFIVSJLMXW'EPPMXRYQ3J,MXWERH7)8MXXS
()'0%6)EGLIGO=SYVWIPJ QIXLSHXLEXXEOIWE7XVMRKJSVXLIYWIV´WKYIWW±²±²IXG

GLIGOWMXERHVIXYVRWEVIWYPXVITVIWIRXMRKE±LMX²±QMWW²SV±OMPP²
()'0%6)EWIX0SGEXMSR'IPPW WIXXIVQIXLSHXLEXXEOIWERMRXEVVE][LMGLLEWXLIXLVIIGIPP
PSGEXMSRWEWMRXWIXG
1)8,3(7XVMRKGLIGO=SYVWIPJ7XVMRKYWIV+YIWW
+)8XLIYWIVKYIWWEWE7XVMRKTEVEQIXIV
'32:)68XLIYWIVKYIWWXSERMRX
6)4)%8[MXLIEGLSJXLIPSGEXMSRGIPPWMRXLIMRXEVVE]
'314%6)XLIYWIVKYIWWXSXLIPSGEXMSRGIPP
-*XLIYWIVKYIWWQEXGLIW
-2'6)1)28XLIRYQFIVSJLMXW
*-2(398MJMX[EWXLIPEWXPSGEXMSRGIPP
-*RYQFIVSJLMXWMW6)8962±OMPP²EWXLIVIWYPX
)07)MX[EWRSXEOMPPWS6)8962±LMX²
)2(-*
)07)XLIYWIVKYIWWHMHRSXQEXGLWS6)8962±QMWW²
)2(-*
)2(6)4)%8
)2(1)8,3(
1)8,3(ZSMHWIX0SGEXMSR'IPPWMRX?AGIPP0SGEXMSRW
+)8XLIGIPPPSGEXMSRWEWERMRXEVVE]TEVEQIXIV
%77-+2XLIGIPPPSGEXMSRWTEVEQIXIVXSXLIGIPPPSGEXMSRWMRWXERGIZEVMEFPI
)2(1)8,3(

FKDSWHU
ZULWLQJDSURJUDP
WHVWFRGH
?ZQ\QVO\PMUM \PWL
QUXTMUMV\I\QWV[ 2KP\)RUDPLQXWH
WKHUH,WKRXJKW\RX
TM\¼[_ZQ\M\PMZMIT ZHUHQ·WJRQQDZULWH\RXU
UM\PWLKWLMVW_IVLOM\ WHVWFRGHÀUVW:KRR
\PQ[X]XXa_WZSQVO 'RQ·WVFDUHPHOLNHWKDW
"EFOREWESTARTCODINGTHE
METHODSTHOUGHLETSBACK
UPANDWRITESOMECODETO
TESTTHEMETHODS4HATSRIGHT
WEREWRITINGTHETESTCODE
BEFORETHERESANYTHINGTOTEST
4HECONCEPTOFWRITING
THETESTCODElRSTISONEOF
THEPRACTICESOF%XTREME
0ROGRAMMING80 AND
ITCANMAKEITEASIERAND
FASTER FORYOUTOWRITEYOUR
CODE7ERENOTNECESSARILY
SAYINGYOUSHOULDUSE80
BUTWEDOLIKETHEPARTABOUT
WRITINGTESTSlRST!ND80JUST
SOUNDSCOOL
([WUHPH3URJUDPPLQJ;3
% XTREME0ROGRAMMING80 ISANEWCOMERTOTHESOFTWARE $ONTPUTINANYTHINGTHATSNOTINTHESPECNOMATTER
DEVELOPMENTMETHODOLOGYWORLD#ONSIDEREDBYMANY HOWTEMPTEDYOUARETOPUTINFUNCTIONALITYhFORTHE
TOBEhTHEWAYPROGRAMMERSREALLYWANTTOWORKv80 FUTUREv
EMERGEDINTHELATESANDHASBEENADOPTEDBY 7RITETHETESTCODEFIRST
COMPANIESRANGINGFROMTHETWO PERSONGARAGESHOP
TOTHE&ORD-OTOR#OMPANY4HETHRUSTOF80ISTHATTHE .OKILLERSCHEDULESWORKREGULARHOURS
CUSTOMERGETSWHATHEWANTSWHENHEWANTSITEVEN 2EFACTORIMPROVETHECODE WHENEVERANDWHEREVERYOU
WHENTHESPECCHANGESLATEINTHEGAME NOTICETHEOPPORTUNITY
80ISBASEDONASETOFPROVENPRACTICESTHATAREALL $ONTRELEASEANYTHINGUNTILITPASSESALLTHETESTS
DESIGNEDTOWORKTOGETHERALTHOUGHMANYFOLKSDOPICK
ANDCHOOSEANDADOPTONLYAPORTIONOF80SRULES4HESE 3ETREALISTICSCHEDULESBASEDAROUNDSMALLRELEASES
PRACTICESINCLUDETHINGSLIKE +EEPITSIMPLE
-AKESMALLBUTFREQUENTRELEASES 0ROGRAMINPAIRSANDMOVEPEOPLEAROUNDSOTHAT
$EVELOPINITERATIONCYCLES EVERYBODYKNOWSPRETTYMUCHEVERYTHINGABOUTTHECODE
\RXDUHKHUH
6LPSOH'RW&RPFODVV
WHVWFRGH
?ZQ\QVO\M[\KWLMNWZ\PM;QUXTM,W\+WUKTI[[
7ENEEDTOWRITETESTCODETHATCANMAKEA3IMPLE$OT#OMOBJECT
ANDRUNITSMETHODS&ORTHE3IMPLE$OT#OMCLASSWEREALLY
CAREABOUTONLYTHECHECK9OURSELF METHODALTHOUGHWEWILLHAVE
TOIMPLEMENTTHESET,OCATION#ELLS METHODINORDERTOGETTHE
CHECK9OURSELF METHODTORUNCORRECTLY
4AKEAGOODLOOKATTHEPREPCODEBELOWFORTHECHECK9OURSELF
METHODTHESET,OCATION#ELLS METHODISANO BRAINERSETTERMETHOD
SOWERENOTWORRIEDABOUTITBUTINA@REALAPPLICATIONWEMIGHT
Licensed by
WANTAMOREROBUST@SETTERMETHODWHICHWEWOULDWANTTOTEST
4HENASKYOURSELFh)FTHECHECK9OURSELF METHODWERE
IMPLEMENTEDWHATTESTCODECOULD)WRITETHATWOULDPROVETOME
THEMETHODISWORKINGCORRECTLYv
Eduard Simons
*I[MLWV\PQ[ XZMXKWLM"
0MZM¼[_PI\_M[PW]TL\M[\"
104038

1)8,3(7XVMRKGLIGO=SYVWIPJ7XVMRKYWIV+YIWW ,QVWDQWLDWHD6LPSOH'RW&RPREMHFW
+)8XLIYWIVKYIWWEWE7XVMRKTEVEQIXIV $VVLJQLWDORFDWLRQDQDUUD\RILQWVOLNH
'32:)68XLIYWIVKYIWWXSERMRX ^`
6)4)%8[MXLIEGLSJXLIPSGEXMSRGIPPWMRXLIMRXEVVE] &UHDWHD6WULQJWRUHSUHVHQWDXVHUJXHVV

³´³´HWF
'314%6)XLIYWIVKYIWWXSXLIPSGEXMSRGIPP
,QYRNHWKHFKHFN<RXUVHOIPHWKRGSDVV
-*XLIYWIVKYIWWQEXGLIW LQJLWWKHIDNHXVHUJXHVV
-2'6)1)28XLIRYQFIVSJLMXW 3ULQWRXWWKHUHVXOWWRVHHLILW¶VFRUUHFW
*-2(398MJMX[EWXLIPEWXPSGEXMSRGIPP ³SDVVHG´RU³IDLOHG´
-*RYQFIVSJLMXWMW6)8962±/MPP²EWXLIVIWYPX
)07)MX[EWRSXEOMPPWS6)8962±,MX²
)2(-*
)07)XLIYWIVKYIWWHMHRSXQEXGLWS6)8962±1MWW²
)2(-*
)2(6)4)%8
)2(1)8,3(
FKDSWHU
ZULWLQJDSURJUDP
WHVWFRGH
WKHUH DUH QR <M[\KWLMNWZ\PM;QUXTM,W\+WUKTI[[

'XPE 4XHVWLRQV
Q: -AYBE)MMISSINGSOME SXEOLFFODVV6LPSOH'RW&RP7HVW'ULYH^ HD
LQVWDQWLDRWW&RP
THINGHEREBUTHOWEXACTLYDO
YOURUNATESTONSOMETHING SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ 6LPSOH'
THATDOESNTYETEXIST REMHFW
6LPSOH'RW&RPGRW QHZ6LPSOH'RW&RP
A: 9OUDONT7ENEVERSAID
NH DQ LQ
PD FDWLRQRI LQWV
IRU
WDUUDW\KHGRW
YOUSTARTBYRUNNINGTHETEST
YOUSTARTBYWRITINGTHETEST!T WKHORFRQVHFXWLYH
THETIMEYOUWRITETHETESTCODE LQW>@ORFDWLRQV ^` FRP DSRVVLEOH
YOUWONTHAVEANYTHINGTORUN RXWRI
ITAGAINSTSOYOUPROBABLYWONT GRWVHW/RFDWLRQ&HOOVORFDWLRQV
BEABLETOCOMPILEITUNTILYOU LQYRNHWK
WRITE@STUBCODETHATCANCOM PHWKRGRQHVHWWHU
PILEBUTTHATWILLALWAYSCAUSE WKHGRWF
THETESTTOFAILLIKERETURNNULL
RP
6WULQJXVHU*XHVV ³´ PDNHDIDNH
XVHUJXHVV
Q: 4HEN)STILLDONTSEETHE
6WULQJUHVXOW GRWFKHFN<RXUVHOIXVHU*XHVV
POINT7HYNOTWAITUNTILTHE
CODEISWRITTENANDTHENWHIP LQYRNHWKHF FN<
OUTTHETESTCODE 6WULQJWHVW5HVXOW ³IDLOHG´ PHWKRGRQWKHKH G
RXUVHOI
RW
REMHFWDQGS FRP
A: LIUHVXOWHTXDOV³KLW´^ IDNHJXHVV DVVLWWKH
4HEACTOFTHINKINGTHROUGH
ANDWRITING THETESTCODEHELPS
WHVW5HVXOW ³SDVVHG´
CLARIFYYOURTHOUGHTSABOUTWHAT
LIWKHIDNHJXHVVZVJLYHV
THEMETHODITSELFNEEDSTODO
EDFND´KLWµ LW· RUNLQJ
`
!SSOONASYOURIMPLEMENTATION
CODEISDONEYOUALREADYHAVE
TESTCODEJUSTWAITINGTOVALIDATE 6\VWHPRXWSULQWOQWHVW5HVXOW
IT"ESIDESYOUKNOWIFYOUDONT SULQWRXWWKH
DOITNOWYOULLNEVERDOIT ` SDVVHGRUIDLOHWHGµVW UHVXOW
4HERESALWAYSSOMETHINGMORE
INTERESTINGTODO
`
)DEALLYWRITEALITTLETESTCODE
THENWRITEONLYTHEIMPLEMENTA 6KDUSHQ \RXU SHQFLO
TIONCODEYOUNEEDINORDERTO )NTHENEXTCOUPLEOFPAGESWEIMPLEMENTTHE3IMPLE$OT#OMCLASS
PASSTHATTEST4HENWRITEALITTLE ANDTHENLATERWERETURNTOTHETESTCLASS,OOKINGATOURTESTCODE
MORETESTCODEANDWRITEONLY ABOVEWHATELSESHOULDBEADDED7HATAREWENOTTESTINGINTHIS
THENEWIMPLEMENTATIONCODE CODETHATWESHOULDBETESTINGFOR7RITEYOURIDEASORLINESOF
NEEDEDTOPASSTHATNEWTEST!T CODE BELOW
EACHTESTITERATIONYOURUNALL
THEPREVIOUSLY WRITTENTESTSSO
THATYOUALWAYSPROVETHATYOUR
LATESTCODEADDITIONSDONTBREAK
PREVIOUSLY TESTEDCODE
\RXDUHKHUH
6LPSOH'RW&RPFODVV
UHDOFRGH
<PMKPMKSAW]Z[MTNUM\PWL
4HEREISNTAPERFECTMAPPINGFROMPREPCODETOJAVACODEYOULLSEEAFEW
ADJUSTMENTS4HEPREPCODEGAVEUSAMUCHBETTERIDEAOFWHATTHECODENEEDSTO
DOANDNOWWEHAVETOlNDTHE*AVACODETHATCANDOTHEHOW
)NTHEBACKOFYOURMINDBETHINKINGABOUTPARTSOFTHISCODEYOUMIGHTWANT
ORNEED TOIMPROVE4HENUMBERSAREFORTHINGSSYNTAXANDLANGUAGE

FEATURES YOUHAVENTSEENYET4HEYREEXPLAINEDONTHEOPPOSITEPAGE
+)8XLIYWIV
SXEOLF6WULQJFKHFN<RXUVHOI6WULQJ
VWULQJ*XHVV^
KYIWW FRQYHUWWKH6WULQJ
LQWJXHVV ,QWHJHUSDUVH,QWVWULQJ*XHVV
'32:)68 WRDQLQW
XLIYWIVKYIWWXS
ERMRX 6WULQJUHVXOW ³PLVV´ PDNHDYDULDEOHWRKROG
UHWXUQSXW´PLVVµLQDV WKHUHVXOWZH·OO
LHZHDVVXPHD´PLVVµ WKHGHIDXOW
6)4)%8[MXL
IEGLGIPPMRXLIMRX IRULQWFHOOORFDWLRQ&HOOV^ UHSHDWZLWKH
EVVE] DUUD\HDFKF DFKFHOOLQWKHORFDWLRQ
HOOORFDWLRQR &H
-*XLIYWIVKYIWW LIJXHVV FHOO^
FRPSDUHWKHX IWKHREMHFW OOV

HOHPHQWFHOO VHUJXHVVWRWKLV
QEXGLIW
UHVXOW ³KLW´ LQWKHDUUD\
-2'6)1)28 ZHJRWDKLW
XLIRYQFIVSJ QXP2I+LWV
LMXW

EUHDN JHWRXWRIWKHO
WRWHVWWKHRWKHRRSQRQHHG
`HQGLI UFHOOV
`HQGIRU
*-2(398MJ
MX[EWXLIPEWXGIPP
LIQXP2I+LWV ORFDWLRQ&HOOVOHQJWK^
-*RYQFIVSJLMXW ZH·UHRXWRIWKHORRSEXWOHW·V
MW
UHVXOW ³NLOO´ QRZ¶GHDG·KLWWLPHVDQGFK VHHLIZH·UH
6)8962±OMPP²
UHVXOW6WULQJWR´.LOOµ DQJHWKH
EWXLIVIWYPX
`HQGLI
)07)MX[EW
RSXEOMPPWS
6)8962±LMX² 6\VWHPRXWSULQWOQUHVXOW GLVSOD\WKHUHVXOWIRUWKHXVHU
)07)
UHWXUQUHVXOW ´0LVVµXQOHVVLWZDVFKDQJHGWR´+LWµRU´.LOOµ
6)8962 UHWXUQWKHUHVXOWEDFNW
±QMWW²
`HQGPHWKRG WKHFDOOLQJPHWKRG R
FKDSWHU
ZULWLQJDSURJUDP
UHDOFRGH
2][\\PMVM_[\]NN
4HETHINGSWEHAVENTSEENBEFORE
AREONTHISPAGE3TOPWORRYING4HE $PHWKRGLQWKH
RESTOFTHEDETAILSAREATTHEENDOF ,QWHJHUFODVVWKDW
THECHAPTER4HISISJUSTENOUGHTOLET NQRZVKRZWR´SDUVHµ
KDW
YOUKEEPGOING $FODVVLWWK-DYD D6WULQJLQWRWKHLQW 7DNHV
D 6WULQ
VKLSV Z LWUHSUHVHQWV J
&RQYHUWLQJD
1V\MOMZXIZ[M1V\¹º
6WULQJWRDQLQW
UDWLRQDVÚHSHDW
5HDGWKLVIRUORRSGHFOD¶OR 7KHFROR
IRUHDFKHOHPHQWLQWKH HQW FDWLRQ&HOOV· ZKROHWKLQQ PHDQV´LQ
µVR
DUUD\WDNHWKHQH[W YDULDLQ
HOHP WKHDUUD\ YDOXH,1ORFJPHDQVÍRUHDFKWLKH
EOH OO·µ
¶FH DWLRQ&HOOV QW
DQGDVVLJQLWWRWKHLQW µ

7KHIRUORRS NWZQV\KMTT"TWKI\QWV+MTT[ce
RS
'HFODUHDYDULDEOHWKDWZLOOK
R Y H U LQWKHQORH[W
IURPWKHDUUD\(DFKWLPHWKROGRQHHOHPHQW \WRLWHU
DW H
ORRSWKH R
WKLVYDULDEOHLQWKLVFDVHDQLQURXJKWKHORRS 7KHDUULPD HWKURXJKWKHZLOOEHDVVLJQHGWWWKH
K W D \
(DF WLQWKHDUU RUHRQWKLV D
´FHOOµZLOOKROGDGLIIHUHQW WYDULDEOHQDPHG HOHPHQ ULDEOH´FHOOµ0
DUUD\XQWLOWKHUHDUHQRPRUHHOHPHQWIURPWKH WKHYD WKLVFKDSWHU
FRGHGRHVDÉUHDNµVHHHOHPHQWVRUWKH HQGRI
EHORZ
7KHPHDQVDGGWR
7KHSRVWLQFUHPHQW
ZKDWHYHU·VWKHUHLQRWKHU

RSHUDWRU
ZRUGVLQFUHPHQWE\
V]U7N0Q\[
QXP2I+LWVLVWKHVDPHLQ
WKLVFDVHDVVD\LQJQXP2I+LWV
QXP2I+LWVH[FHSWVOLJKWO\
PRUHHIILFLHQW

EUHDNVWDWHPHQW
JZMIS#
*HWV\RXRXWRIDORRS,PPHGLDWHO\5LJKWKHUH
1RLWHUDWLRQQRERROHDQWHVWMXVWJHWRXWQRZ
\RXDUHKHUH
6LPSOH'RW&RPFODVV
UHDOFRGH
.QVITKWLMNWZ;QUXTM,W\+WUIVL;QUXTM,W\+WU<M[\MZ
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: 7HATHAPPENSIN
SXEOLFFODVV6LPSOH'RW&RP7HVW'ULYH^
)NTEGERPARSE)NT IFTHETHINGYOU
PASSISNTANUMBER!NDDOESIT 6LPSOH'RW&RPGRW QHZ6LPSOH'RW&RP
RECOGNIZESPELLED OUTNUMBERS
LQW>@ORFDWLRQV ^`
LIKEhTHREEv
GRWVHW/RFDWLRQ&HOOVORFDWLRQV
A: )NTEGERPARSE)NT WORKSONLY
6WULQJXVHU*XHVV ³´
6WULQJUHVXOW GRWFKHFN<RXUVHOIXVHU*XHVV
ON3TRINGSTHATREPRESENTTHEASCII
VALUESFORDIGITS `
)FYOUTRYTOPARSESOMETHINGLIKE
`
hTWOvORhBLURPvTHECODEWILLBLOW
UPATRUNTIME"YBLOWUPWE
ACTUALLYMEANTHROWANEXCEPTION
BUTWEDONTTALKABOUTEXCEPTIONS
UNTILTHE%XCEPTIONSCHAPTER3OFOR SXEOLFFODVV6LPSOH'RW&RP^
NOWBLOWUPISCLOSEENOUGH
LQW>@ORFDWLRQ&HOOV
LQWQXP2I+LWV
Q: )NTHEBEGINNINGOFTHE

SXEOLFYRLGVHW/RFDWLRQ&HOOVLQW>@ORFV^
BOOKTHEREWASANEXAMPLEOFA ORFDWLRQ&HOOV ORFV
FORLOOPTHATWASREALLYDIFFERENT `
FROMTHISONEARETHERETWO
DIFFERENTSTYLESOFFORLOOPS SXEOLF6WULQJFKHFN<RXUVHOI6WULQJVWULQJ*XHVV^
6WULQJUHVXOW ³PLVV´
A: 9ES&ROMTHEFIRSTVERSIONOF
*AVATHEREHASBEENASINGLEKIND
IRULQWFHOOORFDWLRQ&HOOV^
LIJXHVV FHOO^
OFFORLOOPEXPLAINEDLATERINTHIS UHVXOW ³KLW´
CHAPTER THATLOOKSLIKETHIS QXP2I+LWV
EUHDN
FORINTIII [ ` 7HATSHOULDWESEE
DOSOMETHINGTIMES `RXWRIWKHORRS WHENWERUNTHISCODE
] 4HETESTCODEMAKESA
LIQXP2I+LWV 3IMPLE$OT#OMOBJECT
9OUCANUSETHISFORMATFORANY ORFDWLRQ&HOOVOHQJWK^ ANDGIVESITALOCATIONAT
KINDOFLOOPYOUNEED"UT UHVXOW ³NLOO´ 4HENITSENDSAFAKE
BEGINNINGWITH*AVA4IGER ` USERGUESSOFhvINTOTHE
YOUCANALSOUSETHEENHANCEDFOR 6\VWHPRXWSULQWOQUHVXOW CHECK9OUSELF METHOD
LOOPTHATSTHEOFFICIALDESCRIPTION UHWXUQUHVXOW )FTHECODEISWORKING
WHENYOURLOOPNEEDSTOITERATE `FORVHPHWKRG CORRECTLYWESHOULDSEETHE
OVERTHEELEMENTSINANARRAYOR `FORVHFODVV RESULTPRINTOUT
ANOTHERKINDOFCOLLECTIONASYOULL
SEEINTHENEXTCHAPTER 9OUCAN
ALWAYSUSETHEPLAINOLDFORLOOP MDYD6LPSOH'RW&RP7HVW'ULYH
7KHUH¶VDOLWWOHEXJOXUNLQJKHUH,WFRPSLOHVDQG KLW
TOITERATEOVERANARRAYBUTTHE UXQVEXWVRPHWLPHVGRQ¶WZRUU\DERXWLWIRUQRZ
ENHANCEDFORLOOPMAKESITEASIER EXWZHZLOOKDYHWRIDFHLWDOLWWOHODWHU
FKDSWHU
ZULWLQJDSURJUDP
6KDUSHQ \RXU SHQFLO

7E BUILT THE TESTCLASSANDTHE3IMPLE$OT#OMCLASS"UTWESTILLHAVENT
MADE THE ACTUAL GAME'IVENTHECODEONTHEOPPOSITEPAGEANDTHESPECFOR
THEACTUALGAMEWRITEINYOURIDEASFORPREPCODEFORTHEGAMECLASS7EVEGIVEN
4HE3IMPLE$OT#OM'AME
YOUAFEWLINESHEREANDTHERETOGETYOUSTARTED4HEACTUALGAMECODEISONTHE
NEEDSTODOTHIS
NEXTPAGESODONTTURNTHEPAGEUNTILYOUDOTHISEXERCISE
-AKETHESINGLE
9OUSHOULDHAVESOMEWHEREBETWEENANDLINESINCLUDINGTHEONESWEWROTE
3IMPLE$OT#OM/BJECT
BUTNOTINCLUDINGLINESTHATHAVEONLYACURLYBRACE
-AKEALOCATIONFORITTHREE
1)8,3(TYFPMGWXEXMGZSMHQEMR7XVMRK?AEVKW CONSECUTIVECELLSONASINGLE
()'0%6)ERMRXZEVMEFPIXSLSPHXLIRYQFIVSJYWIVKYIWWIWREQIHRYQ3J+YIWWIW ROWOFSEVENVIRTUALCELLS
!SKTHEUSERFORAGUESS
#HECKTHEGUESS
2EPEATUNTILTHEDOTCOMIS
DEAD
4ELLTHEUSERHOWMANY
GUESSESITTOOK
'31498)EVERHSQRYQFIVFIX[IIRERHXLEX[MPPFIXLIWXEVXMRKPSGEXMSRGIPPTSWMXMSR
)KWUXTM\MOIUMQV\MZIK\QWV
)LOH(GLW:LQGRZ+HOS5XQDZD\
MDYD6LPSOH'RW&RP*DPH
;,-0)XLIHSXGSQMWWXMPPEPMZI
HQWHUDQXPEHU
+)8YWIVMRTYXJVSQXLIGSQQERHPMRI
KLW
HQWHUDQXPEHU
KLW
HQWHUDQXPEHU
PLVV
HQWHUDQXPEHU
NLOO
<RXWRRNJXHVVHV
\RXDUHKHUH
6LPSOH'RW&RPFODVV
8ZMXKWLMNWZ\PM;QUXTM,W\+WU/IUMKTI[[
-^MZa\PQVOPIXXMV[QVUIQV
4HEREARESOMETHINGSYOULLHAVETOTAKEONFAITH&OREXAMPLEWEHAVEONE
LINEOFPREPCODETHATSAYSh'%4USERINPUTFROMCOMMAND LINEv,ETMETELL
YOUTHATSALITTLEMORETHANWEWANTTOIMPLEMENTFROMSCRATCHRIGHTNOW"UT
HAPPILYWEREUSING//!NDTHATMEANSYOUGETTOASKSOMEOTHERCLASSOBJECT
TODOSOMETHINGFORYOUWITHOUTWORRYINGABOUTHOWITDOESIT7HENYOUWRITE
PREPCODEYOUSHOULDASSUMETHATSOMEHOWYOULLBEABLETODOWHATEVERYOU
NEEDTODOSOYOUCANPUTALLYOURBRAINPOWERINTOWORKINGOUTTHELOGIC
TYFPMGWXEXMGZSMHQEMR7XVMRK?AEVKW
()'0%6)ERMRXZEVMEFPIXSLSPHXLIRYQFIVSJYWIVKYIWWIWREQIHRYQ3J+YIWWIWWIXMXXS
1%/)ERI[7MQTPI(SX'SQMRWXERGI
'31498)EVERHSQRYQFIVFIX[IIRERHXLEX[MPPFIXLIWXEVXMRKPSGEXMSRGIPPTSWMXMSR
1%/)ERMRXEVVE][MXLMRXWYWMRKXLIVERHSQP]KIRIVEXIHRYQFIVXLEXRYQFIVMRGVIQIRXIHF]
ERHXLEXRYQFIVMRGVIQIRXIHF]I\EQTPI
-2:3/)XLIWIX0SGEXMSR'IPPW QIXLSHSRXLI7MQTPI(SX'SQMRWXERGI
()'0%6)EFSSPIERZEVMEFPIVITVIWIRXMRKXLIWXEXISJXLIKEQIREQIHMW%PMZI7)8MXXSXVYI
;,-0)XLIHSXGSQMWWXMPPEPMZIMW%PMZI!!XVYI
+)8YWIVMRTYXJVSQXLIGSQQERHPMRI
',)'/XLIYWIVKYIWW
-2:3/)XLIGLIGO=SYVWIPJ QIXLSHSRXLI7MQTPI(SX'SQMRWXERGI
-2'6)1)28RYQ3J+YIWWIWZEVMEFPI
',)'/JSVHSXGSQHIEXL
-*VIWYPXMW±OMPP²
7)8MW%PMZIXSJEPWI[LMGLQIERW[I[SR´XIRXIVXLIPSSTEKEMR
46-28XLIRYQFIVSJYWIVKYIWWIW
)2(-*
)2(;,-0) METACOGNITIVETIP
)2(1)8,3( 'RQ·WZRUNRQHSDUWRIWKHEUDLQIRUWRRORQJDVWUHWFKDWRQHWLPH
:RUNLQJMXVWWKHOHIWVLGHRIWKHEUDLQIRUPRUHWKDQPLQXWHV
LVOLNHZRUNLQJMXVW\RXUOHIWDUPIRUPLQXWHV*LYHHDFKVLGH
RI\RXUEUDLQDEUHDNE\VZLWFKLQJVLGHVDWUHJXODULQWHUYDOV
:KHQ\RXVKLIWWRRQHVLGHWKHRWKHUVLGHJHWVWRUHVWDQG
UHFRYHU/HIWEUDLQDFWLYLWLHVLQFOXGHWKLQJVOLNHVWHSE\VWHS
VHTXHQFHVORJLFDOSUREOHPVROYLQJDQGDQDO\VLVZKLOHWKH
ULJKWEUDLQNLFNVLQIRUPHWDSKRUVFUHDWLYHSUREOHPVROYLQJ
SDWWHUQPDWFKLQJDQGYLVXDOL]LQJ
FKDSWHU
ZULWLQJDSURJUDP
:MDD=LHGAFLK
<RXU-DYDSURJUDPVKRXOGVWDUWZLWKDKLJK &KRRVHIRUORRSVRYHUZKLOHORRSVZKHQ\RX
OHYHOGHVLJQ NQRZKRZPDQ\WLPHV\RXZDQWWRUHSHDWWKH
ORRSFRGH
7\SLFDOO\\RX·OOZULWHWKUHHWKLQJVZKHQ\RX
FUHDWHDQHZFODVV 8VHWKHSUHSRVWLQFUHPHQWRSHUDWRUWRDGG
WRDYDULDEOH[
SUHSFRGH
WHVWFRGH 8VHWKHSUHSRVWGHFUHPHQWWRVXEWUDFWIURP
DYDULDEOH[
UHDO-DYDFRGH
8VH,QWHJHUSDUVH,QWWRJHWWKHLQW
3UHSFRGHVKRXOGGHVFULEHZKDWWRGRQRWKRZ YDOXHRID6WULQJ
WRGRLW,PSOHPHQWDWLRQFRPHVODWHU
,QWHJHUSDUVH,QWZRUNVRQO\LIWKH
8VHWKHSUHSFRGHWRKHOSGHVLJQWKHWHVW 6WULQJUHSUHVHQWVDGLJLW´µµµµµHWF
FRGH
8VHEUHDNWROHDYHDORRSHDUO\LHHYHQLI
:ULWHWHVWFRGHEHIRUH\RXLPSOHPHQWWKH WKHERROHDQWHVWFRQGLWLRQLVVWLOOWUXH
PHWKRGV
+RZPDQ\
KLWVGLG\RXJHW
ODVWPRQWK" ,QFOXGLQJ
UHSHDWYLVLWRUV"
<HV
+RZG\IURP*KRVW7RZQ
\RXDUHKHUH
6LPSOH'RW&RP*DPHFODVV
UHDOFRGH
<PMOIUM¼[UIQVUM\PWL
*USTASYOUDIDWITHTHE3IMPLE$OT#OMCLASSBETHINKINGABOUTPARTSOFTHISCODE
YOUMIGHTWANTORNEED TOIMPROVE4HENUMBEREDTHINGSAREFORSTUFFWE

WANTTOPOINTOUT4HEYREEXPLAINEDONTHEOPPOSITEPAGE/HIFYOUREWONDER
INGWHYWESKIPPEDTHETESTCODEPHASEFORTHISCLASSWEDONTNEEDATESTCLASSFOR
THEGAME)THASONLYONEMETHODSOWHATWOULDYOUDOINYOURTESTCODE-AKE
ASEPARATECLASSTHATWOULDCALLMAIN ONTHISCLASS7EDIDNTBOTHER

SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ OHWRWUDFNKHVRZ
PDNHDYDULDE KHXVHUP DN
()'0%6)EZEVM LQWQXP2I*XHVVHV PDQ\JXHVVHVW
EFPIXSLSPHYWIV
KYIWWGSYRXWIXMX
*DPH+HOSHUKHOSHU QHZ*DPH+HOSHU WKLVLVDVSHFLDOFODVVZHZURWHWKDWKDV
XS WKHPHWKRGIRUJHWWLQJXVHULQSXWIRU
QRZSUHWHQGLW·VSDUWRI-DYD
1%/)E7MQTPI(SX
'SQSFNIGX
6LPSOH'RW&RPWKH'RW&RP QHZ6LPSOH'RW&RP PDNHWKHGRWFRPREMHFW

'31498)ELQWUDQGRP1XP LQW0DWKUDQGRP PDNHDUDQGRPQXPEHUIRUWKHILUVW
VERHSQRYQFIV FHOODQGXVHLWWRPDNHWKHFHOO
FIX[IIRERH ORFDWLRQVDUUD\
1%/)ERMRXEVVE]
LQW>@ORFDWLRQV ÛDQGRP1XPUDQGRP1XPUDQGRP1XP`
[MXLXLIGIPPPSGE
QVWKHDUUD\
XMSRWERH
-2:3/)WIX0SGE
WKH'RW&RPVHW/RFDWLRQ&HOOVORFDWLRQV
JLYHWKHGRWFRPLWVORFDWLR
XMSR'IPPWSRXLIHSX
GSQSFNIGX ERROHDQLV$OLYH WUXH
PDNHDERROHDQYDULDEOHWRWUDFNZKHWKHUWKHJDPH
()'0%6)EFSSP LVVWLOODOLYHWRXVHLQWKHZKLOHORRSWHVWUHSHDW
IERMW%PMZI
ZKLOHJDPHLVVWLOODOLYH
SXW6WULQJ
;,-0)XLIHSX ZKLOHLV$OLYH WUXH^
GSQMWWXMPPEPMZI JHWXVHULQ
+)8YWIVMRTYX 6WULQJJXHVV KHOSHUJHW8VHU,QSXW³HQWHUDQXPEHU´
',)'/MX 6WULQJUHVXOW WKH'RW&RPFKHFN<RXUVHOIJXHVV DVNWKHGRWF
-2:3/)GLIGO=S WKHJXHVVVDYHRPWRFKHFN
YVWIPJ SRHSXGSQ
QXP2I*XHVVHV LQFUHPHQWJXHVVFRXQW UHVXOWLQD6WULWKHUHWXUQHG
-2'6)1)28
QJ
RYQ3J+YIWWIW LIUHVXOWHTXDOV³NLOO´^ ZDVLWDŃLOOµ"LIVRVHWLV$OLYH IDOV
-*VIWYPXMW±OMPP²
LV$OLYH IDOVH UHHQWHUWKHORRSDQGSULQWXVHWR HVRZHZRQ·W
UJXHVVFRXQW
7)8KEQI%PMZIXS
JEPWI 6\VWHPRXWSULQWOQ³<RXWRRN³QXP2I*XHVVHV³JXHVVHV´
46-28XLIRYQFIV
SJYWIVKYIWWIW `FORVHLI
`FORVHZKLOH
`FORVHPDLQ
FKDSWHU
ZULWLQJDSURJUDP
UHDOFRGH
ZIVLWUIVLOM\=[MZ1VX]\
4WOTHINGSTHATNEEDABITMORE 7KLVLVD¶FDVW·DQ WIRUF
EXPLAININGAREONTHISPAGE4HISIS LPPHGLDWHO\DIWHULGLWW HVWKHWKLQJ G
JUSTAQUICKLOOKTOKEEPYOUGOING RE HFR
W\SHRIWKHFDVWLHWKHW PHWKH 7KH0DWKUDQGRPPHWKR P]HURWR
MOREDETAILSONTHE'AME(ELPER SDUHQV0DWKUDQGRP \SHLQWKH UHWXUQVDQXPEHUIURRW UPXOD
CLASSAREATTHEENDOFTHISCHAPTER
UH WX UQV
VRZHKDYHWRFDVWLWWREH DGRXEOH MXVWOHVVWKDQRQH6 UQVKLVDIR
QXP EHU
ZDQWDQLFHZKROHQXP DQLQWZH ZLWKWKHFDVWUHWX
EHU EH IURPWR L H
DQG,QWKLVFDV WKHF WZHHQ
WKHIUDFWLRQDOSDUWHRI DVWORSVRII
WKHGRXEOH
FDVWWRDQLQW
0DNHDUDQGRP

QXPEHU
QV\ZIVLWU6]U%QV\5I\PZIVLWU
:HGHFODUHDQLQWYDULDEOHWRKROG $FODVVWKDWFRPHV $PHWKRGRIWKH

WKHUDQGRPQXPEHUZHJHWEDFN ZLWK-DYD 0DWKFODVV
7KLVP
DUJXPHQHWWKRGWDNHVD6WULQ
WKHXVHUD WKDWLWXVHVWRS J
:KDWHY WWKHFRPPDQ URPSW
$QLQVWDQFHZHPDGHHDUOLHU GLVSOD\HGHULQ\RXSDVVLQKHUGH OLQH
RIDFODVVWKDWZHEXLOWWR EHIRUH WKHWHUPLQD JHWV
*HWWLQJXVHULQSXW KHOSZLWKWKHJDPH,W·VFDOOHG ORRNLQJIWRKUHPHWKRGVWDUWOVMXVW

*DPH+HOSHUDQG\RXKDYHQ·W XVHULQSXW
XVLQJWKH*DPH+HOSHU
FODVV VHHQLW\HW\RXZLOO
;\ZQVOO]M[[%PMTXMZOM\=[MZ1VX]\¹MV\MZIV]UJMZº#
:HGHFODUHD6WULQJYDULDEOH $PHWKRGRIWKH*DPH+HOSHUFODVV
KROGWKHXVHULQSXW6W WR WKDWDVNVWKHXVHUIRUFRPPDQG
ULQJZH
JHWEDFN´µ´µHWF OLQHLQSXWUHDGVLWLQDIWHUWKH
XVHUKLWV5(7851DQGJLYHVEDFN
WKHUHVXOWDVD6WULQJ
\RXDUHKHUH
*DPH+HOSHUFODVV5HDG\EDNH
UHDOFRGH
7VMTI[\KTI[["/IUM0MTXMZ
7EMADETHEDOTCOMCLASS *USTCOPY
THECODEBELOWANDCOMPILEITINTO
7EMADETHEGAMECLASS ACLASSNAMED'AME(ELPER$ROPALLTHREE
CLASSES3IMPLE$OT#OM3IMPLE$OT#OM'AME
!LLTHATSLEFTISTHEHELPERCLASSTHEONEWITHTHE 'AME(ELPER INTOTHESAMEDIRECTORYANDMAKEIT
GET5SER)NPUT METHOD4HECODETOGETCOMMAND YOURWORKINGDIRECTORY
LINEINPUTISMORETHANWEWANTTOEXPLAINRIGHTNOW
)TOPENSUPWAYTOOMANYTOPICSBESTLEFTFORLATER 4GCF[DCMG
,ATERASINCHAPTER 7HENEVERYOUSEETHE %QFG LOGOYOURESEE
INGCODETHATYOUHAVETOTYPEAS ISANDTAKEONFAITH
Licensed by
4RUSTIT9OULLLEARNHOWTHATCODEWORKSLATER
,SUHFRRNHG
VRPHFRGHVR\RX
GRQ·WKDYHWRPDNH
Eduard Simons
LW\RXUVHOI
4GCF[DCMG
104038
%QFG
LPSRUWMDYDLR
SXEOLFFODVV*DPH+HOSHU^
SXEOLF6WULQJJHW8VHU,QSXW6WULQJSURPSW^
6WULQJLQSXW/LQH QXOO
6\VWHPRXWSULQWSURPSW³³
WU\^
%XIIHUHG5HDGHULV QHZ%XIIHUHG5HDGHU
QHZ,QSXW6WUHDP5HDGHU6\VWHPLQ
LQSXW/LQH LVUHDG/LQH
LILQSXW/LQHOHQJWK UHWXUQQXOO
`FDWFK,2([FHSWLRQH^
6\VWHPRXWSULQWOQ³,2([FHSWLRQ³H
`
UHWXUQLQSXW/LQH
`
`
:HNQRZKRZPXFK\RXHQMR\W\SLQJEXWIRUWKRVHUDUH
PRPHQWVZKHQ\RX¶GUDWKHUGRVRPHWKLQJHOVHZH¶YHPDGH
WKH5HDG\EDNH&RGHDYDLODEOHRQZLFNHGO\VPDUWFRP
FKDSWHU
ZULWLQJDSURJUDP
4M\¼[XTIa ?PI\¼[\PQ[')J]O '

*DVS
+HUH·VZKDWKDSSHQVZKHQZH +HUH·VZKDWKDSSHQVZKHQZH
UXQLWDQGHQWHUWKHQXPEHUV HQWHU
/RRNLQ·JRRG
)KWUXTM\MOIUMQV\MZIK\QWV )LQNNMZMV\OIUMQV\MZIK\QWV
YOURMILEAGEMAYVARY YIKES
)LOH(GLW:LQGRZ+HOS6PLOH )LOH(GLW:LQGRZ+HOS)DLQW
MDYD6LPSOH'RW&RP*DPH MDYD6LPSOH'RW&RP*DPH
HQWHUDQXPEHU HQWHUDQXPEHU
PLVV KLW
PLVV KLW
PLVV NLOO
HQWHUDQXPEHU <RXWRRNJXHVVHV
KLW
HQWHUDQXPEHU
KLW
HQWHUDQXPEHU
6KDUSHQ \RXU SHQFLO
NLOO
<RXWRRNJXHVVHV
)TSACLIFF HANGER
7ILLWEFINDTHEBUG
7ILLWEFIXTHEBUG
3TAYTUNEDFORTHENEXTCHAPTERWHEREWEANSWER
THESEQUESTIONSANDMORE
!NDINTHEMEANTIMESEEIFYOUCANCOMEUPWITH
IDEASFORWHATWENTWRONGANDHOWTOFIXIT
\RXDUHKHUH
IRUORRSV
5WZMIJW]\NWZTWWX[
7EVECOVEREDALLTHEGAMECODEFORTHISCHAPTERBUTWELLPICKITUPAGAIN
TOlNISHTHEDELUXEVERSIONOFTHEGAMEINTHENEXTCHAPTER 7EDIDNT
WANTTOINTERRUPTYOURWORKWITHSOMEOFTHEDETAILSANDBACKGROUNDINFO
SOWEPUTITBACKHERE7ELLSTARTWITHTHEDETAILSOFFORLOOPSANDIFYOURE
A#PROGRAMMERYOUCANJUSTSKIMTHESELASTFEWPAGES
:MO]TIZVWVMVPIVKMLNWZTWWX[
WKHFRG
UHSHDWJHRW
H
R
V
WKHERG\ KHUH
SRVWLQFUHPHQWRSHUDWRU
NWZQV\Q%#Q$#Qce ZMXMI\NWZZMX["
LQLWLDOL]DWLRQ ERROHDQWHVW LWHUDWLRQH[SUHVVLRQ
7HATITMEANSINPLAIN%NGLISHh2EPEATTIMESv
(OWTHECOMPILERSEESIT
CREATEAVARIABLEIANDSETITTO
REPEATWHILEIISLESSTHAN
ATTHEENDOFEACHLOOPITERATIONADDTOI
0ART/NEINITIALIZATION
5SETHISPARTTODECLAREANDINITIALIZEAVARIABLETOUSEWITHINTHELOOPBODY
9OULLMOSTOFTENUSETHISVARIABLEASACOUNTER9OUCANACTUALLYINITIALIZEMORE
THANONEVARIABLEHEREBUTWELLGETTOTHATLATERINTHEBOOK
0ART4WOBOOLEANTEST
4HISISWHERETHECONDITIONALTESTGOES7HATEVERSINTHEREITMUSTRESOLVETOA
BOOLEANVALUEYOUKNOWTRUEORFALSE 9OUCANHAVEATESTLIKEX ORYOU
CANEVENINVOKEAMETHODTHATRETURNSABOOLEAN
0ART4HREEITERATIONEXPRESSION
)NTHISPARTPUTONEORMORETHINGSYOUWANTTOHAPPENWITHEACHTRIPTHROUGH
THELOOP+EEPINMINDTHATTHISSTUFFHAPPENSATTHEENDOFEACHLOOP
FKDSWHU
ZULWLQJDSURJUDP
W]\X]\"
<ZQX[\PZW]OPITWWX )LOH(GLW:LQGRZ+HOS5HSHDW
IRULQWL LL^ MDYD7HVW

6\VWHPRXWSULQWOQL
`
6\VWHPRXWSULQWOQ³GRQH´

GHFODUHLQWL

VHWLWR

GRQH
LVL" WUXH HQWHUORRS
WKHERROHDQ
ERG\
WHVW

IDOVH 0REAND0OST)NCREMENT$ECREMENT/PERATOR
SULQWWKHYDOXH
SULQW´GRQHµ RIL 4HESHORTCUTFORADDINGORSUBTRACTINGFROMAVARIABLE
MXPSEHORZORRS
[
LQFUHPHQWL ISTHESAMEAS
WKHLWHUDWLRQ
H[SUHVVLRQ [ [
4HEYBOTHMEANTHESAMETHINGINTHISCONTEXT
hADDTOTHECURRENTVALUEOFXvORhINCREMENTXBYv
,QNNMZMVKMJM\ _MMVNWZIVL_PQTM !ND
!WHILELOOPHASONLYTHEBOOLEANTESTITDOESNTHAVE
[
ABUILT ININITIALIZATIONORITERATIONEXPRESSION!WHILE ISTHESAMEAS
LOOPISGOODWHENYOUDONTKNOWHOWMANYTIMESTO
[ [
LOOPANDJUSTWANTTOKEEPGOINGWHILESOMECONDI
TIONISTRUE"UTIFYOUKNOWHOWMANYTIMESTOLOOP /FCOURSETHATSNEVERTHEWHOLESTORY4HEPLACEMENTOFTHE
EGTHELENGTHOFANARRAYTIMESETC AFORLOOPIS OPERATOREITHERBEFOREORAFTERTHEVARIABLE CANAFFECTTHERE
CLEANER(ERESTHELOOPABOVEREWRITTENUSINGWHILE SULT0UTTINGTHEOPERATORBEFORETHEVARIABLEFOREXAMPLEX
MEANShlRSTINCREMENTXBYANDTHENUSETHISNEWVALUEOFXv
4HISONLYMATTERSWHENTHEXISPARTOFSOMELARGEREXPRES
ZHKDYHWRGHF SIONRATHERTHANJUSTINASINGLESTATEMENT
LQWL
LQLWLDOL]HWKH ODUHDQG
ZKLOHL^ FRXQWHU LQW[ LQW] [
PRODUCESXISZIS
6\VWHPRXWSULQWOQL
ZHKDYH "UTPUTTINGTHEAFTERTHEXGIVEYOUADIFFERENTRESULT
WKHFRXQWWHRLQFUHPHQW
L
LQW[ LQW] [
` U
PRODUCESXISBUTZISZGETSTHEVALUEOFXANDTHENXIS
6\VWHPRXWSULQWOQ³GRQH´ INCREMENTED
\RXDUHKHUH
HQKDQFHGIRU
<PMMVPIVKMLNWZTWWX
"EGINNINGWITH*AVA4IGER THE*AVALANGUAGEHASASECONDKINDOFFORLOOP
CALLEDTHEENHANCEDFORTHATMAKESITEASIERTOITERATEOVERALLTHEELEMENTSINAN
ARRAYOROTHERKINDSOFCOLLECTIONSYOULLLEARNABOUTOTHERCOLLECTIONSINTHENEXT
CHAPTER 4HATSREALLYALLTHATTHEENHANCEDFORGIVESYOUASIMPLERWAYTOWALK
THROUGHALLTHEELEMENTSINTHECOLLECTIONBUTSINCEITSTHEMOSTCOMMONUSEOFA
FORLOOPITWASWORTHADDINGITTOTHELANGUAGE7ELLREVISITTHEENHANCEDFORLOOPIN
THENEXTCHAPTERWHENWETALKABOUTCOLLECTIONSTHATARENTARRAYS
7KHFRG
'HFODUHDQLWHUDWLRQYDULDEHQW OH 7KHFROR UHSHDWJRHHWVR
WKDWZLOOKROG DV LQJOHH OHP PHDQV´,1Qµ WKHERG\ KHUH

LQWKHDUUD\
NWZ;\ZQVOVIUM"VIUM)ZZIace
DWHRYHU
7KHHOHPHQWVLQWKH :LWKHDFKLWHUDWLRQ
W RQ R I HOH PH QW V WK DW\RXZDQWWRGLWHU
DGLI IH UH QW HO HP HQ 7KHFROOHFWL RPHZKHUHHDUOLHUWKHFRGHVDL
DUUD\0867EH
LQWKHDUUD\ZLOO H ,PDJLQHWKDWV Eµ`
FRPSDWLEOHZLWKWKH
GHFODUHGYDULDEOHW\S H EHDVVLJQHGWRWK Q DP H$ UU D\ ^ ´)UHGµ´0DU\µ´%R
YDULDEOH´QDPHµ 6WULQJ >@
PH YDULDEOHKDVWK HYDOXHRI
DW LR Q WK H QD DU\µHWF
:LWKWKHILUVWLWLWKWKHVHFRQGLWHUDWLRQDYDOXHRI´0
HU
´)UHGµDQGZ
7HATITMEANSINPLAIN%NGLISHh&OREACHELEMENTINNAME!RRAYASSIGNTHE
ELEMENTTOTHE@NAMEVARIABLEANDRUNTHEBODYOFTHELOOPv
(OWTHECOMPILERSEESIT 1RWHGHSHQGLQJRQWKH
SURJUDPPLQJODQJXDJHWK H\·YH
#REATEA3TRINGVARIABLECALLEDNAMEANDSETITTONULL XVHGLQWKHSDVWVRP HRS
!SSIGNTHEFIRSTVALUEINNAME!RRAYTONAME UHIHUWRWKHHQKDQFHGHSIR OH
UD
WKHÍRUHDFKµRUWKHÍRU V
2UNTHEBODYOFTHELOOPTHECODEBLOCKBOUNDEDBYCURLYBRACES LQµORRSEHFDXVHWKDW·V ZLW
!SSIGNTHENEXTVALUEINNAME!RRAYTONAME UHDGVÍRU($&+WKLQJKR ,1WKH
FROOHFWLRQµ
2EPEATWHILETHEREARESTILLELEMENTSINTHEARRAY
0ART/NEITERATIONVARIABLEDECLARATION
5SETHISPARTTODECLAREANDINITIALIZEAVARIABLETOUSEWITHINTHELOOPBODY7ITHEACH
ITERATIONOFTHELOOPTHISVARIABLEWILLHOLDADIFFERENTELEMENTFROMTHECOLLECTION4HE
TYPEOFTHISVARIABLEMUSTBECOMPATIBLEWITHTHEELEMENTSINTHEARRAY&OREXAMPLE
YOUCANTDECLAREANINTITERATIONVARIABLETOUSEWITHA3TRING;=ARRAY
0ART4WOTHEACTUALCOLLECTION
4HISMUSTBEAREFERENCETOANARRAYOROTHERCOLLECTION!GAINDONTWORRYABOUTTHE
OTHERNON ARRAYKINDSOFCOLLECTIONSYETYOULLSEETHEMINTHENEXTCHAPTER
FKDSWHU
ZULWLQJDSURJUDP
#ONVERTINGA3TRINGTOANINT +I[\QVO
LQWJXHVV ,QWHJHUSDUVH,QWVWULQJ*XHVV XZQUQ\Q^M[
4HEUSERTYPESHISGUESSATTHECOMMAND
LINEWHENTHEGAMEPROMPTSHIM4HAT
GUESSCOMESINASA3TRINGhvhvETC
ANDTHEGAMEPASSESTHAT3TRINGINTOTHE
CHECK9OURSELF METHOD
"UTTHECELLLOCATIONSARESIMPLYINTSINAN
ARRAYANDYOUCANTCOMPAREANINTTOA
3TRING
&OREXAMPLETHISWONTWORK
3TRINGNUMhv ORQJ VKRUW
FDQEHFDVWWR
INTX ELWVRQ

VLGHZHUHWKHOHIW
IFXNUM HORRIBLEEXPLOSION

FXWRII
4RYINGTOCOMPILETHATMAKESTHECOMPILER
EXW\RXPLJKW
LAUGHANDMOCKYOU ORVHVRPHWKLQJ
RSHUDWRU FDQQRWEHDSSOLHGWR

LQWMDYDODQJ6WULQJ ,QFKDSWHUZHWDONHGDERXWWKHVL]HVRIWKHYDULRXVSULPLWLYHVDQGKRZ\RX
LI[ QXP^` FDQ·WVKRYHDELJWKLQJGLUHFWO\LQWRDVPDOOWKLQJ
O
RQJ\
A
LQW[ \ZRQ¶WFRPSLOH

3OTOGETAROUNDTHEWHOLEAPPLESAND $ORQJLVELJJHUWKDQDQLQWDQGWKHFRPSLOHUFDQ·WEHVXUHZKHUHWKDWORQJKDV
ORANGESTHINGWEHAVETOMAKETHE3TRING EHHQ,WPLJKWKDYHEHHQRXWGULQNLQJZLWKWKHRWKHUORQJVDQGWDNLQJRQUHDOO\
hvINTOTHEINT"UILTINTOTHE*AVACLASS ELJYDOXHV7RIRUFHWKHFRPSLOHUWRMDPWKHYDOXHRIDELJJHUSULPLWLYHYDULDEOH
LIBRARYISACLASSCALLED)NTEGERTHATSRIGHT LQWRDVPDOOHURQH\RXFDQXVHWKHFDVWRSHUDWRU,WORRNVOLNHWKLV
AN)NTEGERCLASSNOTTHEINTPRIMITIVE O
RQJ\ VRIDUVRJRRG
ANDONEOFITSJOBSISTOTAKE3TRINGSTHAT
REPRESENTNUMBERSANDCONVERTTHEMINTO LQW[ LQW\[ FRRO

ACTUALNUMBERS 3XWWLQJLQWKHFDVWWHOOVWKHFRPSLOHUWRWDNHWKHYDOXHRI\FKRSLWGRZQWRLQW
VL]HDQGVHW[HTXDOWRZKDWHYHULVOHIW,IWKHYDOXHRI\ZDVELJJHUWKDQWKH
PD[LPXPYDOXHRI[WKHQZKDW·VOHIWZLOOEHDZHLUGEXWFDOFXODEOH QXPEHU
DWVKLSV
DFODVVDWYKD
O
RQJ\
WDNHVD6WULQJ
ZLWK-

H[FHHGVWKHELWOLPLWRIDVKRUW

VKRUW[ VKRUW\[QRZHTXDOV

1V\MOMZXIZ[M1V\¹º 6WLOOWKHSRLQWLVWKDWWKHFRPSLOHUOHWV\RXGRLW$QGOHW·VVD\\RXKDYHDIORDW
LQJSRLQWQXPEHUDQG\RXMXVWZDQWWRJHWDWWKHZKROHQXPEHULQWSDUWRILW
ÀRDWI I

DPHWKRGLQWKH,QWHJHU LQW[ LQWI[ZLOOHTXDO

FODVVWKDWNQRZVKRZWR $QGGRQ·WHYHQWKLQNDERXWFDVWLQJDQ\WKLQJWRDERROHDQRUYLFHYHUVD³MXVW
´SDUVHµD6WULQJLQWRWKH ZDONDZD\
LQWLWUHSUHVHQWV
,WLQYROYHVVLJQELWVELQDU\¶WZR·VFRPSOHPHQW·DQGRWKHUJHHNHU\DOORIZKLFK
DUHGLVFXVVHGDWWKHEHJLQQLQJRIDSSHQGL[%
\RXDUHKHUH
H[HUFLVH%HWKH-90
1dQÔU_Q "%THE*6-
7KH-DYDILOHRQWKLVSDJH
UHSUHVHQWVDFRPSOHWHVRXUFH
ILOH<RXUMRELVWRSOD\-90
DQGGHWHUPLQHZKDWZRXOGEH
WKHRXWSXWZKHQWKH
SURJUDPUXQV"
)LOH(GLW:LQGRZ+HOS20
MDYD2XWSXW
FODVV2XWSXW^
2XWSXWR QHZ2XWSXW
RJR RU
`
)LOH(GLW:LQGRZ+HOS,QFHQVH
YRLGJR^ MDYD2XWSXW
[
LQW\
IRULQW[ [[^
\
LI[!^
6\VWHPRXWSULQW\´´ RU
`
)LOH(GLW:LQGRZ+HOS%HOLHYH
LI\!^
6\VWHPRXWSULQWOQ´[ ´[ MDYD2XWSXW
MDYD7HVW$UUD\V
[)LML
LVODQG
EUHDN LVODQG &R]XPHO
` LVODQG %HUPXGD
LVODQG $]RUHV
`
`
`
FKDSWHU
ZULWLQJDSURJUDP
Code Magnets
1dQÔU_Q !WORKING*AVAPROGRAMISALLSCRAMBLEDUPONTHEFRIDGE#ANYOU
RECONSTRUCTTHECODESNIPPETSTOMAKEAWORKING*AVAPROGRAMTHAT
PRODUCESTHEOUTPUTLISTEDBELOW3OMEOFTHECURLYBRACESFELLONTHE
FLOORANDTHEYWERETOOSMALLTOPICKUPSOFEELFREETOADDASMANYOF
THOSEASYOUNEED
[

LI[ ^
6\VWHPRXWSULQWOQ[´´\
FODVV
0XOW
L)R U^
\!\ ^
IRULQW\
IRULQW[ [[^
SXEOLF
VWDWLF
YRLGPD
LQ6WUL
QJ>@D
)LOH(GLW:LQGRZ+HOS5DLG
U JV^
MDYD0XOWL)RU

\RXDUHKHUH
SX]]OH-DYD&URVV

-DYD&URVV

(OWDOESACROSSWORDPUZZLE
HELPYOULEARN*AVA7ELLALL
OFTHEWORDSARE*AVARELATED
)NADDITIONTHECLUESPROVIDE
METAPHORSPUNSANDTHELIKE
4HESEMENTALTWISTSANDTURNS
BURNALTERNATEROUTESTO*AVA
KNOWLEDGERIGHTINTOYOUR
BRAIN

!CROSS $OWN
&ANCYCOMPUTERWORD !UTOMATICTOOLKIT )NCREMENTTYPE !SIF
FORBUILD #LASSSWORKHORSE !DDAFTER
,OOKSLIKEAPRIMITIVE
-ULTI PARTLOOP BUT 0IHOUSE
0REISATYPEOF?????
4ESTlRST 5N CASTABLE #OMPILEITAND????
&ORSITERATION??????
BITS -ATHMETHOD QUANTITY
%STABLISHlRSTVALUE
-ETHODSANSWER #ONVERTERMETHOD
7HILEOR&OR
0REPCODE ESQUE ,EAVEEARLY
5PDATEANINSTANCEVARIABLE
#HANGE 4OWARDSBLASTOFF
4HEBIGTOOLKIT !CYCLE
!NARRAYUNIT 4ALKATIVEPACKAGE
)NSTANCEORLOCAL -ETHODMESSENGER
ABBREV
FKDSWHU
ZULWLQJDSURJUDP
!SHORT*AVAPROGRAMISLISTEDBELOW/NEBLOCKOFTHEPROGRAM
ISMISSING9OURCHALLENGEISTOMATCHTHECANDIDATEBLOCKOF
CODEONTHELEFT WITHTHEOUTPUTTHATYOUDSEEIFTHEBLOCK
WEREINSERTED.OTALLTHELINESOFOUTPUTWILLBEUSEDANDSOME
-IXED OFTHELINESOFOUTPUTMIGHTBEUSEDMORETHANONCE$RAWLINES
-ESSAGES CONNECTINGTHECANDIDATEBLOCKSOFCODEWITHTHEIRMATCHING
COMMAND LINEOUTPUT
FODVV0L[)RU^
LQW[
LQW\
IRULQWRXWHU RXWHURXWHU^
IRULQWLQQHU LQQHU!LQQHU^
WH FDQGLGD
\ \ JRHVKHUH FRGH
LI[ ^
EUHDN
`
[ [
`
\ \
`
6\VWHPRXWSULQWOQ[³³\
`
`

[ [ PDWFKHDFKLWK

FDQGLGDWHZ
RQHRIWKHSXWV
[ [
[ [ SRVVLEOHRXW

[
[
[ [

\RXDUHKHUH
H[HUFLVHVROXWLRQV
%XERCISE3OLUTIONS
%HWKH-90 &RGH0DJQHWV
FODVV2XWSXW^ FODVV0XOWL)RU^
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^

2XWSXWR QHZ2XWSXW
IRULQW[ [[^
RJR
Licensed by

`
IRULQW\ \!\^
YRLGJR^ 6\VWHPRXWSULQWOQ[´´\
LQW\ `
Eduard Simons
IRULQW[ [[^
LI[ ^:KDWZRXOGKDSSHQ
\
[LIWKLVFRGHEORFNFDPH
LI[!^
ÈHIRUHWKH¶\·IRUORRS"
6\VWHPRXWSULQW\´´
104038
`
` `
LI\!^ `
)LOH(GLW:LQGRZ+HOS0RQRSROH
6\VWHPRXWSULQWOQ´[ ´[
MDYD0XOWL)RU
EUHDN

`

`
`

`'LG\RXUHPHPEHUWRIDFWRULQWKH
EUHDNVWDWHPHQW"+RZGLGWKDW
DIIHFWWKHRXWSXW"
)LOH(GLW:LQGRZ+HOS0RWRUF\FOH0DLQWHQDQFH
MDYD7HVW$UUD\V
MDYD2XWSXW
LVODQG
[)LML

LVODQG &R]XPHO
LVODQG %HUPXGD
LVODQG $]RUHV
FKDSWHU
ZULWLQJDSURJUDP
0UZZLE3OLUTIONS

,03/(0(170

5)25(

(;75(0(3,17

;/65(7851+

36(8'2&2'(5,2

5(27&$677'

(,&$3,-7,
675$2$

6(/(0(179$5,$%/(
,50$5,

2$(-$9$/$1*=
171,,(

,17(*(5230

27%22/($1

5$1'20867

813$56(,17+

1%5($./
[ [
[ [
[ [
[
[
[ [

\RXDUHKHUH
JHWWRNQRZWKH-DYD$3,
8VLQJWKH-DYD/LEUDU\
6RLW·VWUXH"
,FDQOLIW
:HGRQ·WKDYHWR
KHDY\REMHFWV
EXLOGLWRXUVHOYHV"
-DYDVKLSVZLWKKXQGUHGVRI SUHEXLOWFODVVHV9OUDONTHAVETO
REINVENTTHEWHEELIFYOUKNOWHOWTOFINDWHATYOUNEEDINTHE*AVALIBRARYKNOWNAS
THE*AVA!0)9OUVEGOTBETTERTHINGSTODO)FYOUREGOINGTOWRITECODEYOUMIGHTASWELL
WRITEONLYTHEPARTSTHATARETRULYCUSTOMFORYOURAPPLICATION9OUKNOWTHOSEPROGRAMMERS
WHOWALKOUTTHEDOOREACHNIGHTAT0-4HEONESWHODONTEVENSHOWUPUNTIL!-
4HEYUSETHE*AVA!0)!NDABOUTEIGHTPAGESFROMNOWSOWILLYOU4HECORE*AVALIBRARY
ISAGIANTPILEOFCLASSESJUSTWAITINGFORYOUTOUSELIKEBUILDINGBLOCKSTOASSEMBLEYOUROWN
PROGRAMOUTOFLARGELYPRE BUILTCODE4HE2EADY BAKE*AVAWEUSEINTHISBOOKISCODEYOU
DONTHAVETOCREATEFROMSCRATCHBUTYOUSTILLHAVETOTYPEIT4HE*AVA!0)ISFULLOFCODEYOU
DONTEVENHAVETOTYPE!LLYOUNEEDTODOISLEARNTOUSEIT
WKLVLVDQHZFKDSWHU
ZHVWLOOKDYHDEXJ
1VW]ZTI[\KPIX\MZ_MTMN \aW]
_Q\P\PMKTQNNPIVOMZ)J]O
0W_Q\¼[[]XXW[ML\WTWWS 0W_\PMJ]OTWWS[
+HUH·VZKDWKDSSHQVZKHQZH +HUH·VZKDWKDSSHQVZKHQZH
UXQLWDQGHQWHUWKHQXPEHUV HQWHU
/RRNLQ·JRRG
)KWUXTM\MOIUMQV\MZIK\QWV )LQNNMZMV\OIUMQV\MZIK\QWV
YOURMILEAGEMAYVARY YIKES
)LOH(GLW:LQGRZ+HOS6PLOH )LOH(GLW:LQGRZ+HOS)DLQW
MDYD6LPSOH'RW&RP*DPH MDYD6LPSOH'RW&RP*DPH
PLVV KLW
PLVV KLW
PLVV NLOO
HQWHUDQXPEHU <RXWRRNJXHVVHV
KLW
HQWHUDQXPEHU
KLW 1V\PMK]ZZMV\^MZ[QWVWVKM
HQWHUDQXPEHU aW]OM\IPQ\aW]KIV[QUXTa
NLOO ZMXMI\\PI\PQ\\ _WUWZM
<RXWRRNJXHVVHV \QUM[NWZ\PMSQTT
FKDSWHU
JHWWRNQRZWKH-DYD$3,
;W_PI\PIXXMVML'
SXEOLF6WULQJFKHFN<RXUVHOI6WULQJVWULQJ*XHVV^

&RQYHUWWKH6WULQJ
WRDQLQW
0DNHDYDULDEOHWRKROG
UHWXUQ3XW´PLVVµLQDV WKHUHVXOWZH·OO
LHZHDVVXPHD´PLVVµ WKHGHIDXOW
IRULQWFHOOORFDWLRQ&HOOV^ 5HSHDWZ

WKLQJLQW LWKHDFK
+HUH·VZKHUHLW LIJXHVV FHOO^ &RPSDUHWKHXVHU KHDUUD\
JRHVZURQJ:H JXHVVWRWKLVHOHPHQW
FRXQWHGDKLWHYHU\ UHVXOW ³KLW´ FHOOLQWKHDUUD\
WLPHWKHXVHU ZHJRWDKLW
JXHVVHGDFHOO QXP2I+LWV
ORFDWLRQHYHQLI
WKDWORFDWLRQKDG EUHDN *HWRXWRIWKH
DOUHDG\EHHQKLW WRWHVWWKH ORRSQRQHHG RWKHUFHOOV
`HQGLI
:HQHHGDZD\WR
`HQGIRU
NQRZWKDWZKHQ
DXVHUPDNHV
DKLWKHKDVQ·W :H·UHRXWRIWKHORRSEXW
SUHYLRXVO\KLWWKDW UHVXOW ³NLOO´
OHW·VVHHLIZH·UHQRZ¶GHDG·
FHOO,IKHKDVWKHQ KLWWLPHVDQGFKDQJHWKH
ZHGRQ·WZDQWWR `HQGLI UHVXOW6WULQJWRŃLOOµ
FRXQWLWDVDKLW
6\VWHPRXWSULQWOQUHVXOW 'LVSOD\WKHUHVXOWIRUWKHXVHU
´PLVVµXQOHVVLWZDVFKDQJHGWR´KLWµRUŃLOOµ
UHWXUQUHVXOW
5HWXUQWKHUHVXOWEDFN
`HQGPHWKRG WKHFDOOLQJPHWKRG WR
\RXDUHKHUH
IL[LQJWKHEXJ
0W_LW_MNQ`Q\ '
:HQHHGDZD\WRNQRZZKHWKHUDFHOOKDVDOUHDG\EHHQKLW/HW·VUXQ
WKURXJKVRPHSRVVLELOLWLHVEXWÀUVWZH·OOORRNDWZKDWZHNQRZVRIDU
:HKDYHDYLUWXDOURZRIFHOOVDQGD'RW&RPZLOORFFXS\WKUHH
FRQVHFXWLYHFHOOVVRPHZKHUHLQWKDWURZ7KLVYLUWXDOURZVKRZVD
'RW&RPSODFHGDWFHOOORFDWLRQVDQG
7KHYLU
FHOOORWFDXWDOURZZLWKWKH
'RW&RPRE LRQVIRUWKH
MHFW
7KH'RW&RPKDVDQLQVWDQFHYDULDEOH³DQLQWDUUD\³WKDWKROGVWKDW
'RW&RPREMHFW·VFHOOORFDWLRQV

7KHDUUD\ QVW
KROGVWKH'LRW DQFHYDULDEOHW
KDW
ORFDWLRQ&HOOV 7KLV'RW&RPK&RP·VFHOOORFDWLRQV
DQG7 ROG V WKH
KRVHDUHWKHYQDOXHVRI
LQVWDQFHYDULDEOHRI
WKH'RW&RP WKHXVHUQHHG VWRJXHVV XPEHUV
7X\QWVWVM
:HFRXOGPDNHDVHFRQGDUUD\DQGHDFKWLPHWKHXVHUPDNHVDKLWZH
VWRUHWKDWKLWLQWKHVHFRQGDUUD\DQGWKHQFKHFNWKDWDUUD\HDFKWLPH
ZHJHWDKLWWRVHHLIWKDWFHOOKDVEHHQKLWEHIRUH
$¶WUXH·LQDSD LFXODU
WKHFHOOORFDWLRQUW LQGH[LQWKHDUUD\PH
DQVW
DUUD\ORFDWLRQ&HOOV VDPHLQGH[LQWKH27+(5KDW
D W WK DW
KDVEHHQKLW
FALSE FALSE TRUE
7KLVDUUD\KR
KLW&HOOVDUUD\ WKH¶VWDWH·RIOGHDVFKWKUHHYDOXHVUHSUHVHQWLQJ
WKLVZRXOGEHD ORFDWLRQFHOOVDUUD\FHOOLQWKH'RW&RP·V

FHOODWLQGH[ )RUH[DPSOHLIWK
QHZERROHDQDUUD\ H
LQVWDQFHYDULDEOHRI WKH´KLW&HOOVµDULVUDKLWWKHQVHWLQGH[LQ
WKH'RW&RP \WR¶WUXH·
FKDSWHU
JHWWRNQRZWKH-DYD$3,
7X\QWVWVMQ[\WWKT]VSa
2SWLRQRQHVHHPVOLNHPRUHZRUNWKDQ\RX·GH[SHFW,WPHDQVWKDWHDFK
WLPHWKHXVHUPDNHVDKLW\RXKDYHWRFKDQJHWKHVWDWHRIWKHVHFRQG
DUUD\WKH¶KLW&HOOV·DUUD\RKEXWÀUVW\RXKDYHWR&+(&.WKH¶KLW&HOOV·
DUUD\WRVHHLIWKDWFHOOKDVDOUHDG\EHHQKLWDQ\ZD\,WZRXOGZRUNEXW
WKHUH·VJRWWREHVRPHWKLQJEHWWHU
7X\QWV\ _W
:HFRXOGMXVWNHHSWKHRQHRULJLQDODUUD\EXWFKDQJHWKHYDOXHRIDQ\KLW
FHOOVWR7KDWZD\ZHRQO\KDYH21(DUUD\WRFKHFNDQGPDQLSXODWH
DDWDSDUW
KDVDOUHDG\EHHQLFXKODUFHOOORFDWLRQPHDQVW
KDWWKH
QHJDWLYHQXPEHUVLQLWWVRZH·UHRQO\ORRNLQJIRUQRQFHOO
KHDUUD\
ORFDWLRQ&HOOV
LQVWDQFHYDULDEOHRI
WKH'RW&RP
7X\QWV\ _WQ[ITQ\\TMJM\\MZJ]\
[\QTTXZM\\ aKT]VSa
2SWLRQWZRLVDOLWWOHOHVVFOXQN\WKDQRSWLRQRQHEXWLW·VQRWYHU\HIÀFLHQW<RX·G
VWLOOKDYHWRORRSWKURXJKDOOWKUHHVORWVLQGH[SRVLWLRQVLQWKHDUUD\HYHQLI
RQHRUPRUHDUHDOUHDG\LQYDOLGEHFDXVHWKH\·YHEHHQ¶KLW·DQGKDYHDYDOXH
7KHUHKDVWREHVRPHWKLQJEHWWHU
\RXDUHKHUH
SUHSFRGH
7X\QWV\PZMM
:HGHOHWHHDFKFHOOORFDWLRQDVLWJHWVKLWDQGWKHQPRGLI\WKHDUUD\WR
EHVPDOOHU([FHSWDUUD\VFDQ·WFKDQJHWKHLUVL]HVRZHKDYHWRPDNHD
QHZDUUD\DQGFRS\WKHUHPDLQLQJFHOOVIURPWKHROGDUUD\LQWRWKHQHZ
VPDOOHUDUUD\

ORFDWLRQ&HOOVDUUD\ 7KHDUUD\VWDU
%()25(DQ\FHOOV RIDQGZHORRWVSRWKXWURZLWKDVL]H
KDYHEHHQKLW SRVLWLRQVLQWK XJKDOOFHOOV
DPDWFKEHWZHHHQDUWKUDH\WRORRNIRU
WKHFHOOYDOXH XVHUJXHVVDQG

:KHQFHOO¶·LVK
ORFDWLRQ&HOOVDUUD\
VPDOOHUDUUD\ZLWLWKZ HPDNHDQHZ
$)7(5FHOO¶·ZKLFK
LQJFHOOORFDWLRQVDQRQ O\WKHUHPDLQ
ZDVDWLQGH[LQWKH
DUUD\KDVEHHQKLW
RULJLQDOORFDWLRQ&HOOVG DVVLJQLWWRWKH
UHIHUHQFH

7X\QWV\PZMM_W]TLJMU]KPJM\\MZQN\PMIZZIaKW]TL[PZQVS[W\PI\_M_W]TLV¼\PI^M
\WUISMIVM_[UITTMZIZZIaKWXa\PMZMUIQVQVOÎT]M[QVIVLZMI[[QOV\PMZMNMZMVKM
<PMWZQOQVITXZMXKWLMNWZXIZ\WN\PM 4QNM_W]TLJMOWWLQNWVTa_MKW]TL
KPMKSAW]Z[MTNUM\PWL" KPIVOMQ\\W"
6)4)%8[MXLIEGLSJXLIPSGEXMSRGIPPWMRXLIMRXEVVE] 6)4)%8[MXLIEGLSJXLIVIQEMRMRKPSGEXMSRGIPPW
'314%6)XLIYWIVKYIWWXSXLIPSGEXMSRGIPP '314%6)XLIYWIVKYIWWXSXLIPSGEXMSRGIPP
-*XLIYWIVKYIWWQEXGLIW -*XLIYWIVKYIWWQEXGLIW
-2'6)1)28XLIRYQFIVSJLMXW 6)13:)XLMWGIPPJVSQXLIEVVE]
*-2(398MJMX[EWXLIPEWXPSGEXMSRGIPP *-2(398MJMX[EWXLIPEWXPSGEXMSRGIPP
-*RYQFIVSJLMXWMW6)8962±OMPP² -*XLIEVVE]MWRS[IQTX]6)8962±OMPP²
)07)MX[EWRSXEOMPPWS6)8962±LMX² )07)MX[EWRSXEOMPPWS6)8962±LMX²
)2(-* )2(-*
)07)YWIVKYIWWHMHRSXQEXGLWS6)8962±QMWW² )07)YWIVKYIWWHMHRSXQEXGLWS6)8962±QMWW²
)2(-* )2(-*
)2(6)4)%8 )2(6)4)%8
FKDSWHU
JHWWRNQRZWKH-DYD$3,
,IRQO\,FRXOGÀQGDQDUUD\
WKDWFRXOGVKULQNZKHQ\RXUHPRYH
VRPHWKLQJ$QGRQHWKDW\RXGLGQ·WKDYH
WRORRSWKURXJKWRFKHFNHDFKHOHPHQWEXW
LQVWHDG\RXFRXOGMXVWDVNLWLILWFRQWDLQV
ZKDW\RX·UHORRNLQJIRU$QGLWZRXOGOHW\RX
JHWWKLQJVRXWRILWZLWKRXWKDYLQJWRNQRZ
H[DFWO\ZKLFKVORWWKHWKLQJVDUHLQ
7KDWZRXOGEHGUHDP\%XW,NQRZLW·V
MXVWDIDQWDV\
\RXDUHKHUH
ZKHQDUUD\VDUHQ·WHQRXJK
?ISM]XIVL[UMTT\PMTQJZIZa
$VLIE\PDJLFWKHUHUHDOO\LVVXFKDWKLQJ
%XWLW·VQRWDQDUUD\LW·VDQ$UUD\/LVW
$FODVVLQWKHFRUH-DYDOLEUDU\WKH$3,
4HE*AVA3TANDARD%DITIONWHICHISWHATYOUHAVEUNLESSYOUREWORK
INGONTHE-ICRO%DITIONFORSMALLDEVICESANDBELIEVEMEYOUDKNOW
SHIPSWITHHUNDREDSOFPRE BUILTCLASSES*USTLIKEOUR2EADY "AKECODE
Licensed by
EXCEPTTHATTHESEBUILT INCLASSESAREALREADYCOMPILED
4HATMEANSNOTYPING
Eduard Simons
*USTUSE@EM T
!RRAY,IS
CTELEM
104038
IST
RTOTHEL
ADD/BJESTHEOBJECTPARAMETE
!D D
METER
2QHRIDJD]LOOLRQFODVVHVLQ NTINDEX CTATTHEINDEXPARA
WKH-DYDOLEUDU\ REMOVEI OB JE
THE
2EMOVES
<RXFDQXVHLWLQ\RXUFRGH M AY,IST
BJECTELE INTHE!RR
DVLI\RXZURWHLW\RXUVHOI REMOVE/VESTHISOBJECTIFIT S
2EMO
ARAMETER
S / B JE CTELEM ATCHFORTHEOBJECTP
CONTAIN THERESAM
RUEIF
2ETURNS@T
LEMENTS
IS%MPTY LIS THASNOE
RUEIFTHE
2ETURNS@T
TEROR
F / B JE C TELEM FTHEOBJECTPARAME
INDEX/ HERTHEIN
IT
DEXO
2ETURNSE
THELIST
ENTSCU RRENTLYIN
SIZE ENUMB EROFELEM
2ETURNSTH
1RWHWKHDGG2EMHFWHOHPPHWKRG METER
DEX NDEXPARA
T I N T I N E N TL YATTHEI
DFWXDOO\ORRNVDOLWWOHVWUDQJHUWKDQWKH G E EOBJEC T
C U RR
2 ETURNSTH
RQHZH·YHVKRZQKHUHZH·OOJHWWRWKH
UHDORQHODWHULQWKHERRN)RUQRZMXVW SOHRI620(RI
WKLQNRILWDVDQDGGPHWKRGWKDW 7KLVLVMXVWDVDP UUD\/LVW
WDNHVWKHREMHFW\RXZDQWWRDGG WKHPHWKRGVLQ$
FKDSWHU
JHWWRNQRZWKH-DYD$3,
;WUM\PQVO[aW]KIVLW_Q\P)ZZIa4Q[\
V\QWD[
QHZ(JJ!DQJOHEUDFNHW
'RQ·WZRUU\DERXWWKDQLVV´PDNHWKLVDOLVWRI(JJREMHFWVµ
0DNHRQH ULJKWQRZLWMXVWPH
V
$UUD\/LVW(JJ!P\/LVW QHZ$UUD\/LVW(JJ! /LVWREMHFWL
$QHZ$UUQDW\ KHKHDS,W·VOLWWOH
FUHDWHGRW·VHPSW\
3XWVRPHWKLQJLQLW EHFDXVHL
(JJV QHZ(JJ
1RZWKH$UUD\/LVWMHF JURZVDÉR[µ
WRKROGWKH ( JJ RE W
P\/LVWDGGV
V
3XWDQRWKHUWKLQJLQLW
(JJE QHZ(JJ 7KH$UUD\/LVW
JURZVDJ
WKHVHFRQG( JJREMHFW DLQWRKROG
P\/LVWDGGE
V E
)LQGRXWKRZPDQ\WKLQJVDUHLQLW ROGLQJREMHFWVVR
7KH$UUD\/LVWLVKUH V
LQWWKH6L]H P\/LVWVL]H WKHVL]HPHWKRG WXUQ
DLQWKH(JJREMHFW
)LQGRXWLILWFRQWDLQVVRPHWKLQJ 7KH$UUD\/LVW'2(6FRQW UHWXUQVWUXH
ERROHDQLV,Q P\/LVWFRQWDLQVV UHIHUHQFHGE\¶V·VRFRQWDLQV
DQVILUVWLQGH[LV
)LQGRXWZKHUHVRPHWKLQJLVLHLWVLQGH[ $UUD\/LVWLV]HUREDVHGPHFHGE\¶E·ZDVWKH
LQWLG[ P\/LVWLQGH[2IE DQGVLQFHWKHREMHFWUHIHUHQ[2IUHWXUQV
VHFRQGWKLQJLQWKHOLVWLQGH
)LQGRXWLILW·VHPSW\ LW·VGHILQLWHO\127HPSW
\VRLV(PSW\
ERROHDQHPSW\ P\/LVWLV(PSW\ UHWXUQVIDOVH
5HPRYHVRPHWKLQJIURPLW +H\ORRN³LWVKUDQN
P\/LVWUHPRYHV
E
\RXDUHKHUH
6KDUSHQ \RXU SHQFLO &ILLINTHERESTOFTHETABLEBELOWBYLOOKINGATTHE!RRAY,ISTCODE

ONTHELEFTANDPUTTINGINWHATYOUTHINKTHECODEMIGHTBEIFIT
WEREUSINGAREGULARARRAYINSTEAD7EDONTEXPECTYOUTOGETALL
OFTHEMEXACTLYRIGHTSOJUSTMAKEYOURBESTGUESS
)ZZIa4Q[\ ZMO]TIZIZZIa

$UUD\/LVW6WULQJ!P\/LVW QHZ
$UUD\/LVW6WULQJ!
6WULQJ>@P\/LVW QHZ6WULQJ>@
6WULQJD QHZ6WULQJ³ZKRRKRR´

6WULQJD QHZ6WULQJ´ZKRRKRRµ
P\/LVWDGGD
6WULQJE QHZ6WULQJ³)URJ´

6WULQJE QHZ6WULQJ´)URJµ
P\/LVWDGGE
LQWWKH6L]H P\/LVWVL]H
2EMHFWR P\/LVWJHW
P\/LVWUHPRYH
ERROHDQLV,Q P\/LVWFRQWDLQVE
FKDSWHU
JHWWRNQRZWKH-DYD$3,
WKHUH DUH QR
'XPE 4XHVWLRQV ,CXC'ZRQUGF
Q: 3O!RRAY,ISTISCOOLBUT
7KLVZHHN·VLQWHUYLHZ
$UUD\/LVWRQDUUD\V
HOWWOULD)KNOWITEXISTS
+HDG)LUVW;W)ZZIa4Q[\[IZMTQSMIZZIa[ZQOP\'
A: 4HEQUESTIONISREALLY
h(OWDO)KNOWWHATSINTHE
$UUD\/LVW1V\PMQZLZMIU[ 1IUIVWJRMK\\PIVSaW]^MZaU]KP
+HDG)LUVW1N 1¼UVW\UQ[\ISMVIZZIa[IZMWJRMK\[\WW<PMaTQ^MWV\PMPMIXZQOP\
!0)vANDTHATSTHEKEYTOYOUR
SUCCESSASA*AVAPROGRAMMER \PMZM_Q\PITT\PMW\PMZWJRMK\[
.OTTOMENTIONYOURKEYTO $UUD\/LVW;]ZMIZZIa[OWWV\PMPMIXL]PJ]\IVIZZIaQ[[\QTTI_IVVIJM
BEINGASLAZYASPOSSIBLEWHILE )ZZIa4Q[\)XW[MZ7JRMK\[PI^M[\I\MIVLJMPI^QWZZQOP\'?M¼ZMKTMIZWV\PI\*]\
STILLMANAGINGTOBUILDSOFTWARE PI^MaW]IK\]ITTa\ZQMLKITTQVOIUM\PWLWVIVIZZIa'
9OUMIGHTBEAMAZEDATHOW
MUCHTIMEYOUCANSAVEWHEN +HDG)LUVW6W_\PI\aW]UMV\QWVQ\KIV¼\[Ia1PI^M*]\_PI\UM\PWL_W]TL1
SOMEBODYELSEHASALREADYDONE KITTIVa_Ia'1WVTaKIZMIJW]\KITTQVOUM\PWL[WV\PM[\]NN 1X]\QV\PMIZZIaVW\
MOSTOFTHEHEAVYLIFTINGAND \PMIZZIaQ\[MTN)VL1KIV][MIZZIa[aV\I`_PMV1_IV\\WX]\\PQVO[QVIVL\ISM
ALLYOUHAVETODOISSTEPINAND \PQVO[W]\WN \PMIZZIa
CREATETHEFUNPART
$UUD\/LVW1[\PI\[W'AW]UMIV\W\MTTUMaW]IK\]ITTaZMUW^ML[WUM\PQVONZWUIV
"UTWEDIGRESSTHESHORT
IZZIa';PMM[P_PMZMLW\PMa\ZIQVaW]O]a['5K2IÎ¼['
ANSWERISTHATYOUSPENDSOME
TIMELEARNINGWHATSINTHECORE +HDG)LUVW7N KW]Z[M1\ISM[WUM\PQVOW]\WN \PMIZZIa1[Ia,WOL%LWO)ZZIaCE
!0)4HELONGANSWERISATTHE IVL1OM\\PM,WOWJRMK\I\QVLM`W]\WN \PMIZZIa
ENDOFTHISCHAPTERWHEREYOULL
LEARNHOWTODOTHAT $UUD\/LVW)TTZQOP\1¼TT\Za\W[XMIS[TW_Ta[WaW]KIVNWTTW_ITWVOAW]_MZMVW\
1ZMXMI\VW\ZMUW^QVO\PI\,WONZWU\PMIZZIa)TTaW]LQL_I[UISMIKWXaWN \PM
Q: "UTTHATSAPRETTYBIG
ZMNMZMVKM\W\PM,WOIVLI[[QOVQ\\WIVW\PMZ,WOÎZQIJTM
+HDG)LUVW7P1[MM_PI\aW]¼ZM[IaQVO6W1LQLV¼\IK\]ITTaZMUW^M\PM,WO
ISSUE.OTONLYDO)NEEDTO
KNOWTHATTHE*AVALIBRARY WJRMK\NZWU\PMIZZIa1\¼[[\QTT\PMZM*]\1KIVR][\[M\Q\[ZMNMZMVKM\WV]TT1O]M[[
COMESWITH!RRAY,ISTBUTMORE $UUD\/LVW*]\1¼UIÅZ[\KTI[[WJRMK\[W1PI^MUM\PWL[IVL1KIVIK\]ITTaaW]
IMPORTANTLY)HAVETOKNOW SVW_LW\PQVO[TQSMZMUW^M\PM,WO¼[ZMNMZMVKMNZWUUa[MTNVW\R][\[M\Q\\WV]TT
THAT!RRAY,ISTISTHETHINGTHAT )VL1KIVKPIVOMUa[QbMLaVIUQKITTaTWWSQ\]X2][\\Za\WOM\IVIZZIa\WLW\PI\
CANDOWHAT)WANT3OHOW
DO)GOFROMANEED TO DO +HDG)LUVW/MMPI\M\WJZQVO\PQ[]XJ]\\PMZ]UWZQ[\PI\aW]¼ZMVW\PQVOUWZM
SOMETHINGTOA WAY TO DO IT \PIVIOTWZQÅMLJ]\TM[[MNÅKQMV\IZZIa<PI\QVNIK\aW]¼ZMR][\I_ZIXXMZNWZIV
USINGTHE!0) IZZIaILLQVOM`\ZIUM\PWL[NWZ\PQVO[TQSMZM[QbQVO\PI\1_W]TLPI^MPIL\W_ZQ\M
Ua[MTN)VL_PQTM_M¼ZMI\Q\aW]KIV¼\M^MVPWTLXZQUQ\Q^M[ 1[V¼\\PI\IJQOTQUQ\I\QWV'
A: .OWYOUREREALLYATTHE
$UUD\/LVW1KIV¼\JMTQM^MaW]J]aQV\W\PI\]ZJIVTMOMVL6W1IUVW\R][\ITM[[
MNÅKQMV\IZZIa1_QTTILUQ\\PI\\PMZMIZMINM_M`\ZMUMTaZIZM[Q\]I\QWV[_PMZMIV
HEARTOFIT"YTHETIMEYOUVE
FINISHEDTHISBOOKYOULLHAVE IZZIaUQOP\JMR][\I\IL1ZMXMI\\ILJQ\NI[\MZNWZKMZ\IQV\PQVO[*]\Q[Q\_WZ\P\PM
AGOODGRASPOFTHELANGUAGE UQVQ[K]TMXMZNWZUIVKMOIQV\WOQ^M]XITT\PQ[XW_MZ;\QTTTWWSI\ITT\PQ[ÆM`QJQTQ\a)VL
ANDTHERESTOFYOURLEARNING I[NWZ\PMXZQUQ\Q^M[WN KW]Z[MaW]KIVX]\IXZQU\Q^MQVIV)ZZIa4Q[\I[TWVOI[Q\¼[
CURVEREALLYISABOUTKNOWING _ZIXXMLQVIXZQUQ\Q^M_ZIXXMZKTI[[aW]¼TT[MMITW\UWZMWV\PI\QVKPIX\MZ
HOWTOGETFROMAPROBLEMTO )VLI[WN 2IÎ\PI\_ZIXXQVOIVL]V_ZIXXQVO_PMVaW]\ISM\PMXZQUQ\Q^MW]\
ASOLUTIONWITHYOUWRITINGTHE IOIQVPIXXMV[I]\WUI\QKITTa)VLITTZQOP\1¼TTIKSVW_TMLOM\PI\aM[QN aW]¼ZM][QVOIV
LEASTAMOUNTOFCODE)FYOUCAN )ZZIa4Q[\WN XZQUQ\Q^M[Q\XZWJIJTaQ[NI[\MZ_Q\PIVIZZIaJMKI][MWN ITT\PM_ZIXXQVO
BEPATIENTFORAFEWMOREPAGES
IVL]V_ZIXXQVOJ]\[\QTT_PWZMITTa][M[XZQUQ\Q^M[\PM[MLIa['
WESTARTTALKINGABOUTITATTHE
ENDOFTHISCHAPTER 7PTWWSI\\PM\QUM 1¼UTI\MNWZ8QTI\M[?M¼TTPI^M\WLW\PQ[IOIQV[WUM\QUM
\RXDUHKHUH
GLIIHUHQFHEHWZHHQ$UUD\/LVWDQGDUUD\
+WUXIZQVO)ZZIa4Q[\\WIZMO]TIZIZZIa
)ZZIa4Q[\ ZMO]TIZIZZIa

$UUD\/LVW6WULQJ!P\/LVW QHZ 6WULQJ>@P\/LVW QHZ6WULQJ>@
$UUD\/LVW6WULQJ!
6WULQJD QHZ6WULQJ³ZKRRKRR´ 6WULQJD QHZ6WULQJ³ZKRRKRR´

P\/LVWDGGD P\/LVW>@ D
6WULQJE QHZ6WULQJ³)URJ´ 6WULQJE QHZ6WULQJ³)URJ´

P\/LVWDGGE P\/LVW>@ E
LQWWKH6L]H P\/LVWVL]H LQWWKH6L]H P\/LVWOHQJWK

UHLW
+HUH·VZKH ORRN
2EMHFWR P\/LVWJHW 6WULQJR P\/LVW>@ VWDUWVWR IHUHQW
UHDOO\GLI
P\/LVWUHPRYH P\/LVW>@ QXOO
ERROHDQLV,Q P\/LVWFRQWDLQVE ERROHDQLV,Q IDOVH
IRU6WULQJLWHPP\/LVW^
LIEHTXDOVLWHP^
LV,Q WUXH
EUHDN
`
`
.OTICEHOWWITH!RRAY,ISTYOUREWORKING 7ITHANARRAYYOUUSESPECIALARRAYSYNTAXLIKE

WITHANOBJECTOFTYPE!RRAY,ISTSOYOUREJUST MY,IST;=FOO THATYOUWONTUSEANYWHERE
INVOKINGREGULAROLDMETHODSONAREGULAROLD ELSEEXCEPTWITHARRAYS%VENTHOUGHAN
OBJECTUSINGTHEREGULAROLDDOTOPERATOR ARRAYISANOBJECTITLIVESINITSOWNSPECIAL
WORLDANDYOUCANTINVOKEANYMETHODSON
ITALTHOUGHYOUCANACCESSITSONEANDONLY
INSTANCEVARIABLELENGTH
FKDSWHU
JHWWRNQRZWKH-DYD$3,
+WUXIZQVO)ZZIa4Q[\\WIZMO]TIZIZZIa
$SODLQROGDUUD\KDVWRNQRZLWV $UUD\VXVHDUUD\V\QWD[WKDW·VQRW
VL]HDWWKHWLPHLW·VFUHDWHG XVHGDQ\ZKHUHHOVHLQ-DYD
"UTFOR!RRAY,ISTYOUJUSTMAKEANOBJECTOF "UT!RRAY,ISTSAREPLAINOLD*AVAOBJECTSSO
TYPE!RRAY,IST%VERYTIME)TNEVERNEEDSTO THEYHAVENOSPECIALSYNTAX
KNOWHOWBIGITSHOULDBEBECAUSEITGROWS
P\/LVW>@
ANDSHRINKSASOBJECTSAREADDEDORREMOVED
1HHGVDVL]H HVSHFLDO
QHZ6WULQJ>@
7KHDUUD\EUDFNHWV>@UUDU
D\ V
V\QWD[XVHGRQO\ IRUD
QHZ$UUD\/LVW6WULQJ!
1RVL]HUHTXLUHGDOWKRXJK\RXFDQ
JLYHLWDVL]HLI\RXZDQWWR
$UUD\/LVWVLQ-DYDDUH
7RSXWDQREMHFWLQDUHJXODUDUUD\ SDUDPHWHUL]HG
\RXPXVWDVVLJQLWWRDVSHFLÀF
7EJUSTSAIDTHATUNLIKEARRAYS!RRAY,ISTS
ORFDWLRQ
HAVENOSPECIALSYNTAX"UTTHEYDOUSE
$QLQGH[IURPWRRQHOHVVWKDQWKHOHQJWKRI SOMETHINGSPECIALTHATWASADDEDTO*AVA
WKHDUUD\ 4IGERPARAMETERIZEDTYPES
P\/LVW>@ E
$UUD\/LVW6WULQJ!
1HHGVDQLQGH[ 7KH6WULQJ!LQDQJOHEUDFNHWVLVD´W\SH
SDUDPHWHUµ$UUD\/LVW6WULQJ!PHDQVVLPSO\´D
)FTHATINDEXISOUTSIDETHEBOUNDARIESOFTHE
ARRAYLIKETHEARRAYWASDECLAREDWITHASIZEOF
OLVWRI6WULQJVµDVRSSRVHGWR$UUD\/LVW'RJ!
ANDNOWYOURETRYINGTOASSIGNSOMETHING ZKLFKPHDQV´DOLVWRI'RJVµ
TOINDEX ITBLOWSUPATRUNTIME 0RIORTO*AVATHEREWASNOWAYTODECLARE
7ITH!RRAY,ISTYOUCANSPECIFYANINDEXUS THETYPEOFTHINGSTHATWOULDGOINTHE
INGTHEADDAN)NTAN/BJECT METHODORYOU !RRAY,ISTSOTOTHECOMPILERALL!RRAY,ISTS
CANJUSTKEEPSAYINGADDAN/BJECT ANDTHE WERESIMPLYHETEROGENOUSCOLLECTIONSOF
!RRAY,ISTWILLKEEPGROWINGTOMAKEROOMFOR OBJECTS"UTNOWUSINGTHETYPE'OES(ERE
THENEWTHING SYNTAXWECANDECLAREANDCREATEAN
P\/LVWDGGE !RRAY,ISTTHATKNOWSANDRESTRICTS THE
TYPESOFOBJECTSITCANHOLD7ELLLOOKATTHE
1RLQGH[ DETAILSOFPARAMETERIZEDTYPESIN!RRAY,ISTS
INTHE#OLLECTIONSCHAPTERSOFORNOWDONT
THINKTOOMUCHABOUTTHEANGLEBRACKET
SYNTAXYOUSEEWHENWEUSE!RRAY,ISTS*UST
KNOWTHATITSAWAYTOFORCETHECOMPILERTO
ALLOWONLYASPECIlCTYPEOFOBJECTTHETYPEIN
ANGLEBRACKETS INTHE!RRAY,IST
\RXDUHKHUH
WKHEXJJ\'RW&RPFRGH

UHDOFRGH
4M\¼[NQ`\PM,W\+WUKWLM
5HPHPEHUWKLVLVKRZWKHEXJJ\YHUVLRQORRNV
HDGRI
:H·YHUHQDPHGWKH FODVV'RW&RPQRFHZGLQYHVWUVLRQEXWWKLV
SXEOLFFODVV'RW&RP^ WKHQHZDGYDQ DSWHU
6LPSOH'RW&RPIRRXUVD ZLQWKHODVWFK
LVWKHVDPHFRGH\
LQW>@ORFDWLRQ&HOOV
LQWQXP2I+LWV

SXEOLFYRLGVHW/RFDWLRQ&HOOVLQW>@ORFV^
ORFDWLRQ&HOOV ORFV
`
SXEOLF6WULQJFKHFN<RXUVHOI6WULQJVWULQJ*XHVV^
IRULQWFHOOORFDWLRQ&HOOV^
LIJXHVV FHOO^ :KHUHLW
FRXQWHGHDDFOOZHQWZURQJ:H
UHVXOW ³KLW´ ZLWKRXWFKHFKJXHVVDVDKLW
QXP2I+LWV KDGDOUHDG\ENLQJZKHWKHUWKDWF
HHQKLW HOO

EUHDN
`
`RXWRIWKHORRS

UHVXOW ³NLOO´
`
6\VWHPRXWSULQWOQUHVXOW
UHWXUQUHVXOW
`FORVHPHWKRG
`FORVHFODVV
FKDSWHU
JHWWRNQRZWKH-DYD$3,

UHDOFRGH
6M_IVLQUXZW^ML,W\+WUKTI[[
,JQRUHWK
QRZZHWDLVONOLQHIRU
LPSRUWMDYDXWLO$UUD\/LVW LWDWWKHHQ DERXW
FKDSWHU GRIWKH
SXEOLFFODVV'RW&RP^
SULYDWH$UUD\/LVW6WULQJ!ORFDWLRQ&HOOV
6WULQJV
D\/LVWWKDWKROGV
SULYDWHLQWQXP2I+LWV
JDU UD \WR D Q $ UU
GRQ¶WQHHGWKDWQRZ 6WULQ &KDQJHWKH
SXEOLFYRLGVHW/RFDWLRQ&HOOV$UUD\/LVW6WULQJ!ORF^
WQDPH
ORFDWLRQ&HOOV ORF
S UR Y H G DUJXPHQ
LP
`

1HZDQG
UJXHVVLVLQWKH
SXEOLF6WULQJFKHFN<RXUVHOI6WULQJXVHU,QSXW^ )LQGRXWLIW\KHDVXNLVHQJIRULWVLQGH[
$UUD\/LVWE WKHOLVWWKHQLQGH[2I
6WULQJUHVXOW ³PLVV´ ,ILW·VQRWLQ
UHWXUQVD
LQWLQGH[ ORFDWLRQ&HOOVLQGH[2IXVHU,QSXW

LILQGH[! ^ ,ILQGH[L V
]HURWKHXVHJUUHDJXWHUWKDQRUHTXDOWR
ORFDWLRQ&HOOVUHPRYHLQGH[ OLVWVRUHPRYHLW HVVLVGHILQLWHO\LQWKH

KLV
LIORFDWLRQ&HOOVLV(PSW\^ ,IWKHOLVWLVHPSW\W
ZDVWKHNLOOLQJ EO RZ
UHVXOW ³NLOO´
`HOVH^
UHVXOW ³KLW´
`FORVHLI

`FORVHRXWHULI

UHWXUQUHVXOW
`FORVHPHWKRG
`FORVHFODVV
\RXDUHKHUH
PDNLQJWKH'RW&RP%XVW
4M\¼[J]QTL\PM:-)4OIUM"
¹;QVSI,W\+WUº
7EVEBEENWORKINGONTHE@SIMPLEVERSIONBUTNOW
LETSBUILDTHEREALONE)NSTEADOFASINGLEROWWELL <RX·UHJRLQJWREXLOGWKH
USEAGRID!NDINSTEADOFONE$OT#OMWELLUSE 6LQND'RW&RPJDPHZLWK
THREE
D[JULGDQGWKUHH
'OAL3INKALLOFTHECOMPUTERS$OT#OMSINTHE 'RW&RPV(DFK'RW&RP
FEWESTNUMBEROFGUESSES9OUREGIVENARATINGLEVEL WDNHVXSWKUHHFHOOV
BASEDONHOWWELLYOUPERFORM
3ETUP7HENTHEGAMEPROGRAMISLAUNCHEDTHE
COMPUTERPLACESTHREE$OT#OMSRANDOMLYONTHE
VIRTUALXGRID7HENTHATSCOMPLETETHEGAME
ASKSFORYOURlRSTGUESS XIZ\WNIOIUMQV\MZIK\QWV
)LOH(GLW:LQGRZ+HOS6HOO
(OWYOUPLAY7EHAVENTLEARNEDTOBUILDA'5)
YETSOTHISVERSIONWORKSATTHECOMMAND LINE4HE MDYD'RW&RP%XVW
COMPUTERWILLPROMPTYOUTOENTERAGUESSACELL (QWHUDJXHVV$
WHICHYOULLTYPEATTHECOMMAND LINEASh!vh#v
ETC )NRESPONSETOYOURGUESSYOULLSEEARESULTAT PLVV
THECOMMAND LINEEITHERhHITvhMISSvORh9OUSUNK (QWHUDJXHVV%
0ETSCOMvORWHATEVERTHELUCKY$OT#OMOFTHEDAY PLVV
IS 7HENYOUVESENTALLTHREE$OT#OMSTOTHATBIG
INTHESKYTHEGAMEENDSBYPRINTINGOUTYOUR (QWHUDJXHVV&
RATING PLVV
HDFKER[µ (QWHUDJXHVV'
;JULG LVD´FHOO KLW
! (QWHUDJXHVV'
KLW
"
'OCOM
(QWHUDJXHVV'
# 2XFK<RXVXQN3HWVFRP
$ 0ETSCOM NLOO
(QWHUDJXHVV%
%
PLVV
& (QWHUDJXHVV*
' KLW
!SK-ECOM
(QWHUDJXHVV*

KLW
VWDUWVDW]HUROLNH-DYDDUUD\V (QWHUDJXHVV*
2XFK<RXVXQN$VN0HFRP
NLOO
FKDSWHU (QWHUDJXHVV$
PLVV
(QWHU D JXHVV %
JHWWRNQRZWKH-DYD$3,
?PI\VMML[\WKPIVOM' 'RW&RP%XVWFODVVFRQWLQXHG
7EHAVETHREECLASSESTHATNEEDTOCHANGETHE ~ 0UTTHE$OT#OMSONAGRIDRATHERTHAN
$OT#OMCLASSWHICHISNOWCALLED$OT#OMINSTEADOF JUSTASINGLEROWANDDOITFORALLTHREE
3IMPLE$OT#OM THEGAMECLASS$OT#OM"UST ANDTHE $OT#OMS
GAMEHELPERCLASSWHICHWEWONTWORRYABOUTNOW 4HISSTEPISNOWWAYMORECOMPLEXTHAN
BEFOREIFWEREGOINGTOPLACETHE$OT#OMS
) 'RW&RPFODVV RANDOMLY3INCEWERENOTHERETOMESS
~ !DDANAMEVARIABLE WITHTHEMATHWEPUTTHEALGORITHMFOR
TOHOLDTHENAMEOFTHE$OT#OM GIVINGTHE$OT#OMSALOCATIONINTOTHE
h0ETSCOMvh'OCOMvETC SOEACH$OT 'AME(ELPER2EADY BAKE CLASS
#OMCANPRINTITSNAMEWHENITSKILLEDSEE
THEOUTPUTSCREENONTHEOPPOSITEPAGE ~ #HECKEACHUSERGUESSWITHALLTHREE
$OT#OMSINSTEADOFJUSTONE
* 'RW&RP%XVWFODVVWKHJDPH ~ +EEPPLAYINGTHEGAMEIEACCEPTING
~ #REATETHREE$OT#OMSINSTEADOFONE USERGUESSESANDCHECKINGTHEMWITHTHE
REMAINING$OT#OMS UNTILTHEREARENOMORE
~ 'IVEEACHOFTHETHREE$OT#OMSANAME LIVE$OT#OMS
#ALLASETTERMETHODONEACH$OT#OM
INSTANCESOTHATTHE$OT#OMCANASSIGNTHE ~ 'ETOUTOFMAIN7EKEPTTHESIMPLEONEIN
NAMETOITSNAMEINSTANCEVARIABLE MAINJUSTTOKEEPITSIMPLE"UTTHATSNOT
WHATWEWANTFORTHEREALGAME
PD N H ' R W
W DQ GW R &RP
HU LQS X O R F
U SOD\ DW
LR
IR QV
HV G SOD \V Z L W K
&ODVVHV X V U HD W H V DQ
F
'RW&RP%XVW 'RW&RP *DPH+HOSHU
7KHJDPHFODVV 7KHDFWXDO 7KHKHOSHUFODVV

0DNHV'RW&RPV 'RW&RPREMHFWV 5HDG\%DNH
JHWVXVHULQSXW 'RW&RPVNQRZWKHLU ,WNQRZVKRZWR
SOD\VXQWLODOO'RW QDPHORFDWLRQDQG DFFHSWXVHUFRP
&RPVDUHGHDG KRZWRFKHFNDXVHU PDQGOLQHLQSXW
JXHVVIRUDPDWFK DQGPDNH'RW&RP
ORFDWLRQV
3OXV
$UUD\/LVWVIRU
WKH'RW&RP%XVW
2EMHFWV DQGIRUHDFK
RIWKH'RW&RP
REMHFWV
'RW&RP
'RW&RP%XVW 'RW&RP *DPH+HOSHU
'RW&RP
\RXDUHKHUH
GHWDLOHGVWUXFWXUHRI WKHJDPH
?PWLWM[_PI\QV\PM,W\+WU*][\OIUM
IVL_PMV
'RW&RP%XVW 7KHPDLQPHWKRG

7KHJDPH LQVWDQWLDWHV LQWKH'RW&RP%XVW
FODVV FODVVLQVWDQWLDWHVWKH
'RW&RP%XVWREMHFWWKDW
GRHVDOOWKHJDPHVWXII
'RW&RP%XVW
REMHFW
Licensed by
LQVWDQWLDWHV
Eduard Simons
`]dh]j
*DPH+HOSHU
REMHFW 7KH'RW&RP%XVWJDPH
REMHFWLQVWDQWLDWHVDQ

104038
LQVWDQFHRI*DPH+HOSHU
WKHREMHFWWKDWZLOOKHOS
'RW&RP%XVW WKHJDPHGRLWVZRUN
REMHFW
7KH'RW&RP%XVWREMHFW
LQVWDQWLDWHVDQ$UUD\/LVW
*DPH+HOSHU WKDWZLOOKROGWKH'RW&RP
REMHFW REMHFWV
`]dh]j \gl;gekDakl
'RW&RP%XVW
REMHFW
$UUD\/LVWREMHFWWR
KROG'RW&RPREMHFWV
FKDSWHU
JHWWRNQRZWKH-DYD$3,
7KH'RW&RP%XVWREMHFW
FUHDWHVWKUHH'RW&RP
[]ddk REMHFWVDQGSXWVWKHPLQ
WKH$UUD\/LVW
*DPH+HOSHU
REMHFW []ddk
`]dh]j \gl;gekDakl
\gl;ge \gl;ge
\gl;ge
( ) * []ddk
'RW&RP%XVW
REMHFW $UUD\/LVWREMHFWWR
'RW&RP
KROG'RW&RPREMHFWV
REMHFWV
7KH'RW&RP%XVWREMHFWDVNVWKH 7KH'RW&RP%XVWREMHFWJLYHVHDFKRIWKH'RW
KHOSHUREMHFWIRUDORFDWLRQIRUD &RPREMHFWVDORFDWLRQZKLFKWKH'RW&RP%XVW
'RW&RPGRHVWKLVWLPHVRQHIRU JRWIURPWKHKHOSHUREMHFWOLNH´$µ´%µ
HDFK'RW&RP HWF(DFK'RW&RPREMHFWSXWVKLVRZQWKUHH
WLRQ
NH OR F D ORFDWLRQFHOOVLQDQ$UUD\/LVW
PD
LWLV
KHUH $UUD\/LVWREMHFW
*DPH+HOSHU
`]dh]j \gl;gekDakl REMHFW []ddk
[]dd []dd []dd
( ) *
WRKROG'RW&RP
FHOOORFDWLRQV
[]ddk
$UUD\/LVW
'RW&RP%XVW []dd []dd []dd REMHFW
( ) *
\gl;ge \gl;ge
\gl;ge
REMHFW ( ) * []ddk
$UUD\/LVW
$UUD\/LVWREMHFWWR []dd []dd []dd REMHFW
'RW&RP ( ) *
KROG'RW&RPREMHFWV
REMHFWV
7KH'RW&RP%XVWREMHFWDVNVWKHKHOSHU 7KH'RW&RP%XVWREMHFWORRSVWKURXJKWKHOLVW
REMHFWIRUDXVHUJXHVVWKHKHOSHU RI'RW&RPVDQGDVNVHDFKRQHWRFKHFNWKHXVHU
SURPSWVWKHXVHUDQGJHWVLQSXWIURP JXHVVIRUDPDWFK7KH'RW&RPFKHFNVLWVORFDWLRQV
WKHFRPPDQGOLQH V $UUD\/LVWDQGUHWXUQVDUHVXOW´KLWµ´PLVVµHWF
V
H U JXH
WXV
JH
LWLV
KHUH
XHVV $UUD\/LVWREMHFW
*DPH+HOSHU L VJ
REMHFW N W K []ddk
[]dd []dd []dd WRKROG'RW&RP
`]dh]j \gl;gekDakl F ( ) *
KH ´KLWµ FHOOORFDWLRQV
F
[]ddk
$UUD\/LVW
'RW&RP%XVW []dd []dd []dd REMHFW
( ) *
\gl;ge \gl;ge
\gl;ge
REMHFW ( ) * []ddk
$QGVRWKHJDPHFRQWLQXHVJHW $UUD\/LVW
WLQJXVHULQSXWDVNLQJHDFK'RW&RP $UUD\/LVWREMHFWWR []dd []dd []dd REMHFW
WRFKHFNIRUDPDWFKDQGFRQWLQXLQJ 'RW&RP ( ) *
KROG'RW&RPREMHFWV
XQWLODOO'RW&RPVDUHGHDG REMHFWV
\RXDUHKHUH
WKH'RW&RP%XVWFODVVWKHJDPH
'RW&RP%XVW 8ZMXKWLMNWZ\PMZMIT,W\+WU*][\KTI[[
*DPH+HOSHUKHOSHU
$UUD\/LVWGRW&RPV/LVW 4HE$OT#OM"USTCLASSHASTHREEMAINJOBSSETUPTHEGAMEPLAYTHEGAME
LQWQXP2I*XHVVHV
UNTILTHE$OT#OMSAREDEADANDENDTHEGAME!LTHOUGHWECOULDMAP
THOSETHREEJOBSDIRECTLYINTOTHREEMETHODSWESPLITTHEMIDDLEJOBPLAYTHE
VHW8S*DPH
GAME INTOTWOMETHODSTOKEEPTHEGRANULARITYSMALLER3MALLERMETHODS
VWDUW3OD\LQJ MEANINGSMALLERCHUNKSOFFUNCTIONALITY HELPUSTESTDEBUGANDMODIFY
FKHFN8VHU*XHVV THECODEMOREEASILY
ILQLVK*DPH
()'0%6)ERHMRWXERXMEXIXLI+EQI,IPTIVMRWXERGIZEVMEFPIREQIHLIPTIV
()'0%6)ERHMRWXERXMEXIER%VVE]0MWXXSLSPHXLIPMWXSJ(SX'SQWMRMXMEPP]XLVII 'EPPMX
9DULDEOH HSX'SQW0MWX
()'0%6)ERMRXZEVMEFPIXSLSPHXLIRYQFIVSJYWIVKYIWWIWWSXLEX[IGERKMZIXLIYWIVE
'HFODUDWLRQV WGSVIEXXLIIRHSJXLIKEQI 2EQIMXRYQ3J+YIWWIWERHWIXMXXS
()'0%6)EWIX9T+EQI QIXLSHXSGVIEXIERHMRMXMEPMÎXLI(SX'SQSFNIGXW[MXLREQIW
ERHPSGEXMSRW(MWTPE]FVMIJMRWXVYGXMSRWXSXLIYWIV
()'0%6)EWXEVX4PE]MRK QIXLSHXLEXEWOWXLITPE]IVJSVKYIWWIWERHGEPPWXLI
0HWKRG
GLIGO9WIV+YIWW QIXLSHYRXMPEPPXLI(SX'SQSFNIGXWEVIVIQSZIHJVSQTPE]
'HFODUDWLRQV ()'0%6)EGLIGO9WIV+YIWW QIXLSHXLEXPSSTWXLVSYKLEPPVIQEMRMRK(SX'SQSFNIGXWERH
GEPPWIEGL(SX'SQSFNIGX´WGLIGO=SYVWIPJ QIXLSH
()'0%6)E½RMWL+EQI QIXLSHXLEXTVMRXWEQIWWEKIEFSYXXLIYWIV´WTIVJSVQERGIFEWIH
SRLS[QER]KYIWWIWMXXSSOXSWMROEPPSJXLI(SX'SQSFNIGXW
1)8,3(ZSMHWIX9T+EQI
QEOIXLVII(SX'SQSFNIGXWERHREQIXLIQ
'6)%8)XLVII(SX'SQSFNIGXW
0HWKRG
7)8EREQIJSVIEGL(SX'SQ
,PSOHPHQWDWLRQV %((XLI(SX'SQWXSXLIHSX'SQW0MWXXLI%VVE]0MWX
6)4)%8[MXLIEGLSJXLI(SX'SQSFNIGXWMRXLIHSX'SQW0MWXEVVE]
'%00XLITPEGI(SX'SQ QIXLSHSRXLILIPTIVSFNIGXXSKIXEVERHSQP]WIPIGXIH
PSGEXMSRJSVXLMW(SX'SQXLVIIGIPPWZIVXMGEPP]SVLSVM^SRXEPP]EPMKRIHSRE<KVMH
7)8XLIPSGEXMSRJSVIEGL(SX'SQFEWIHSRXLIVIWYPXSJXLITPEGI(SX'SQ GEPP
)2(6)4)%8
)2(1)8,3(
FKDSWHU
JHWWRNQRZWKH-DYD$3,
5M\PWLQUXTMUMV\I\QWV[KWV\QV]ML"
1)8,3(ZSMHWXEVX4PE]MRK
6)4)%8[LMPIER](SX'SQWI\MWX
+)8YWIVMRTYXF]GEPPMRKXLILIPTIVKIX9WIV-RTYX QIXLSH
):%09%8)XLIYWIV´WKYIWWF]GLIGO9WIV+YIWW QIXLSH
)2(6)4)%8
)2(1)8,3(
1)8,3(ZSMHGLIGO9WIV+YIWW7XVMRKYWIV+YIWW
¼RHSYXMJXLIVI³WELMXERHOMPP SRER](SX'SQ
-2'6)1)28XLIRYQFIVSJYWIVKYIWWIWMRXLIRYQ3J+YIWWIWZEVMEFPI
7)8XLIPSGEPVIWYPXZEVMEFPIE7XVMRK XS±QMWW²EWWYQMRKXLEXXLIYWIV´WKYIWW[MPPFIEQMWW
6)4)%8[MXLIEGLSJXLI(SX3FNIGXWMRXLIHSX'SQW0MWXEVVE]
):%09%8)XLIYWIV´WKYIWWF]GEPPMRKXLI(SX'SQSFNIGX´WGLIGO=SYVWIPJ QIXLSH
7)8XLIVIWYPXZEVMEFPIXS±LMX²SV±OMPP²MJETTVSTVMEXI
-*XLIVIWYPXMW±OMPP²6)13:)XLI(SX'SQJVSQXLIHSX'SQW0MWX
)2(6)4)%8
(-740%=XLIVIWYPXZEPYIXSXLIYWIV
)2(1)8,3(
1)8,3(ZSMHÞRMWL+EQI
(-740%=EKIRIVMG±KEQISZIV²QIWWEKIXLIR
-*RYQFIVSJYWIVKYIWWIWMWWQEPP
(-740%=EGSRKVEXYPEXMSRWQIWWEKI
)07)
(-740%=ERMRWYPXMRKSRI
)2(-*
)2(1)8,3(
6KDUSHQ \RXU SHQFLO

(OWSHOULDWEGOFROMPREPCODETOTHE METHODS!NDWHICHMETHODDOYOUTEST
FINALCODE&IRSTWESTARTWITHTESTCODEAND ANDWRITEFIRST3EEIFYOUCANWORKOUTSOME
THENTESTANDBUILDUPOURMETHODSBITBY PREPCODEFORASETOFTESTS0REPCODEOR
BIT7EWONTKEEPSHOWINGYOUTESTCODE EVENBULLETPOINTSAREGOODENOUGHFORTHIS
INTHISBOOKSONOWITSUPTOYOUTOTHINK EXERCISEBUTIFYOUWANTTOTRYTOWRITETHE
ABOUTWHATYOUDNEEDTOKNOWTOTESTTHESE REALTESTCODEIN*AVA KNOCKYOURSELFOUT
\RXDUHKHUH
WKH'RW&RP%XVWFRGHWKHJDPH
UHDOFRGH
6KDUSHQ \RXU SHQFLO
LPSRUWMDYDXWLO
$QQRWDWHWKHFRGH
SXEOLFFODVV'RW&RP%XVW^
\RXUVHOI
SULYDWH*DPH+HOSHUKHOSHU QHZ*DPH+HOSHU
0DWFKWKH

SULYDWH$UUD\/LVW'RW&RP!GRW&RPV/LVW QHZ$UUD\/LVW'RW&RP!
DQQRWDWLRQVDWWKH
SULYDWHLQWQXP2I*XHVVHV
ERWWRPRIHDFKSDJH
SULYDWHYRLGVHW8S*DPH^ ZLWKWKHQXPEHUV
¿UVWPDNHVRPHGRWFRPVDQGJLYHWKHPORFDWLRQV LQWKHFRGH:ULWH
WKHQXPEHULQWKH
'RW&RPRQH QHZ'RW&RP
VORWLQIURQWRIWKH
RQHVHW1DPH³3HWVFRP´ FRUUHVSRQGLQJ
'RW&RPWZR QHZ'RW&RP DQQRWDWLRQ
WZRVHW1DPH³H7R\VFRP´
'RW&RPWKUHH QHZ'RW&RP <RX·OOXVHHDFK
WKUHHVHW1DPH³*RFRP´ DQQRWDWLRQMXVWRQFH
DQG\RX·OOQHHGDOORI
GRW&RPV/LVWDGGRQH
WKHDQQRWDWLRQV
GRW&RPV/LVWDGGWZR
GRW&RPV/LVWDGGWKUHH
6\VWHPRXWSULQWOQ³<RXUJRDOLVWRVLQNWKUHHGRWFRPV´
6\VWHPRXWSULQWOQ³3HWVFRPH7R\VFRP*RFRP´
6\VWHPRXWSULQWOQ³7U\WRVLQNWKHPDOOLQWKHIHZHVWQXPEHURIJXHVVHV´

IRU'RW&RPGRW&RP7R6HWGRW&RPV/LVW^
$UUD\/LVW6WULQJ!QHZ/RFDWLRQ KHOSHUSODFH'RW&RP
GRW&RP7R6HWVHW/RFDWLRQ&HOOVQHZ/RFDWLRQ

`FORVHIRUORRS
`FORVHVHW8S*DPHPHWKRG
SULYDWHYRLGVWDUW3OD\LQJ^
ZKLOHGRW&RPV/LVWLV(PSW\^

6WULQJXVHU*XHVV KHOSHUJHW8VHU,QSXW³(QWHUDJXHVV´
FKHFN8VHU*XHVVXVHU*XHVV

`FORVHZKLOH
¿QLVK*DPH
`FORVHVWDUW3OD\LQJPHWKRG
DVNWKHKHOSHUIRUD'RW&RPORFDWLRQ
JHWXVHULQSXW
QLWLDOL]H UHSHDWZLWKHDFK'RW&RPLQWKHOLVW
GHFODUHDQEGOHLVZH·OOQHHG
WKHYDULD FDOOWKHVHWWHUPHW FDOORXURZQFKHFN8
SULQWEU LHI WR JLYHLWWKHORFDWLKRGRQWKLV'RW&RP VHU*XHVVPHWKRG
LQVWUXFWLRQVIRU IU RPWKHKHOSHU RQ\RXMXVWJRW
XVHU DVORQJDVWKH'RW&RP
PDNHWKUHH'RW&R PREMHFWVJLYH¶HP
WK H $U UD\/ LVW OLVWLV127HPSW\
FDOORXURZQILQLVK*DPHPHWKRG QDPHVDQGVWLFN¶HPLQ
FKDSWHU
JHWWRNQRZWKH-DYD$3,
UHDOFRGH
:KDWHYHU\RXGR
'21·7WXUQWKH
SDJH
SULYDWHYRLGFKHFN8VHU*XHVV6WULQJXVHU*XHVV^

QXP2I*XHVVHV 1RWXQWLO\RX·YH
ÀQLVKHGWKLV
6WULQJUHVXOW ³PLVV´ H[HUFLVH
IRU'RW&RPGRW&RP7R7HVWGRW&RPV/LVW^
2XUYHUVLRQLVRQ
UHVXOW GRW&RP7R7HVWFKHFN<RXUVHOIXVHU*XHVV

WKHQH[WSDJH
LIUHVXOWHTXDOV³KLW´^
EUHDN
`
LIUHVXOWHTXDOV³NLOO´^
GRW&RPV/LVWUHPRYHGRW&RP7R7HVW
EUHDN
`
`FORVHIRU
`FORVHPHWKRG

SULYDWHYRLG¿QLVK*DPH^
6\VWHPRXWSULQWOQ³$OO'RW&RPVDUHGHDG<RXUVWRFNLVQRZZRUWKOHVV´
LIQXP2I*XHVVHV ^
6\VWHPRXWSULQWOQ³,WRQO\WRRN\RX³QXP2I*XHVVHV³JXHVVHV´
6\VWHPRXWSULQWOQ³<RXJRWRXWEHIRUH\RXURSWLRQVVDQN´
`HOVH^
6\VWHPRXWSULQWOQ³7RRN\RXORQJHQRXJK³QXP2I*XHVVHV³JXHVVHV´
6\VWHPRXWSULQWOQ³)LVKDUHGDQFLQJZLWK\RXURSWLRQV´
`
`FORVHPHWKRG

'RW&RP%XVWJDPH QHZ'RW&RP%XVW
JDPHVHW8S*DPH
JDPHVWDUW3OD\LQJ

`FORVHPHWKRG
`
UHSHDWZLWKDOO'RW&RPVLQWKHOLVW SULQWWKH
WKLVJX\·VGHDGVRWDNHKLPRXWRIW SULQWDPHVVDJHWHOOLQJWKH UHVXOWIRU
'RW&RPVOLVWWKHQJHWRXWRIWKH KH XVHUKRZKHGLGLQWKHJDPH WKHXVHU
ORRS WHOOWKHJDPHREMHFW
HPH QWWKHQXPE HUR IJ XHVV HVW KHX VHUKDVPDGH WRVHWXSWKHJDPH
LQFU LVV· XQO HVV WROG RWK HUZ LVH
DVVXPH LW·V D¶P
WHOOWKHJDPH
JHWRXWRIWKHORRS JDPHSOD\ORR R E MH F W WRVWDUWWK
H P DVNWKH'RW&RPWRFKHFNWKHXVHUJXHVV
HDUO\QRSRLQWLQWHVWLQJ LQSXWDQGF S NHHSV LQJI D LQ ORRNLQJIRUDKLWRUN LOO
WKHRWKHUV KHFNLQJWKHDVN JXHVV
RUXVHU
FUHDWHWKHJDPHREMHFW
\RXDUHKHUH
WKH'RW&RP%XVWFRGHWKHJDPH

UHDOFRGH
LQLWLDOL]H
LPSRUWMDYDXWLO
'HFODUHDEQOHG VZH·OOQHHG
SXEOLFFODVV'RW&RP%XVW^ WKHYDULD
SULYDWH*DPH+HOSHUKHOSHU QHZ*DPH+HOSHU
SULYDWH$UUD\/LVW'RW&RP!GRW&RPV/LVW QHZ$UUD\/LVW'RW&RP!0DNHDQ$UUD\/LVWR
I
P RE MH FW V LQ RWKHU
SULYDWHLQWQXP2I*XHVVHV 'RW&R KROG
ZRUGVDOLVWWKDWREZMHLOO V
SULYDWHYRLGVHW8S*DPH^ 21/<'RW&RP @ZRFWXOG
P>
MXVWDV'RW&R RI'RW&RP
¿UVWPDNHVRPHGRWFRPVDQGJLYHWKHPORFDWLRQV
PHDQDQDUUD\
'RW&RPRQH QHZ'RW&RP
REMHFWV
RQHVHW1DPH³3HWVFRP´
'RW&RPWZR QHZ'RW&RP 0DNHWKUHH'RW&R PREMHFWV
WZRVHW1DPH³H7R\VFRP´ JLYH¶HPQDPHVD QG LFN¶HP
VW
LQWKH$UUD \/ LVW
'RW&RPWKUHH QHZ'RW&RP
WKUHHVHW1DPH³*RFRP´
GRW&RPV/LVWDGGRQH
GRW&RPV/LVWDGGWZR
GRW&RPV/LVWDGGWKUHH 3ULQWEULHI
LQVWUXFWLRQVIRUXVHU
6\VWHPRXWSULQWOQ³<RXUJRDOLVWRVLQNWKUHHGRWFRPV´
6\VWHPRXWSULQWOQ³3HWVFRPH7R\VFRP*RFRP´
6\VWHPRXWSULQWOQ³7U\WRVLQNWKHPDOOLQWKHIHZHVWQXPEHURIJXHVVHV´

IRU'RW&RPGRW&RP7R6HWGRW&RPV/LVW^ 5HSHDWZLWKHDFK'RW&RPLQWKHOLVW
$VNWKHKHOSHUIRUD
$UUD\/LVW6WULQJ!QHZ/RFDWLRQ KHOSHUSODFH'RW&RP 'RW&RPORFDWLRQDQ
$UUD\/LVWRI6WULQJV
GRW&RP7R6HWVHW/RFDWLRQ&HOOVQHZ/RFDWLRQ
&DOOWKHVHWWH PHW
'RW&RPWRJLYHULW KRGRQWKLV
`FORVHIRUORRS MXVWJRWIURPWKH WKHORFDWLRQ\RX
`FORVHVHW8SJDPHPHWKRG KHOSHU
SULYDWHYRLGVWDUW3OD\LQJ^
V127HPSW\WKHPHDQV127LW·V
$VORQJDVWKH'RW&RPOLVWLV(P IDOVH
ZKLOHGRW&RPV/LVWLV(PSW\^ WKHVDPHDVGRW&RPV/LVWL SW\

6WULQJXVHU*XHVV KHOSHUJHW8VHU,QSXW³(QWHUDJXHVV´ *HWXVHULQSXW
FKHFN8VHU*XHVVXVHU*XHVV
&DOORXURZQFKHFN
8VHU*XHVVPHWKRG
`FORVHZKLOH
¿QLVK*DPH &DOORXURZQILQLVK*DPHPHWKRG
`FORVHVWDUW3OD\LQJPHWKRG
FKDSWHU
JHWWRNQRZWKH-DYD$3,

UHDOFRGH
SULYDWHYRLGFKHFN8VHU*XHVV6WULQJXVHU*XHVV^

VHUKDVPDGH
QXP2I*XHVVHV LQFUHPHQWWKHQXPEHURIJXHVVHVWKHX

6WULQJUHVXOW ³PLVV´ DVVXPHLW·VD¶PLVV·XQOHVVWROGRWKHUZLVH
IRU'RW&RPGRW&RP7R7HVWGRW&RPV/LVW^ UHSHDWZLWKDOO'RW&RPVLQWKHOLVW
UHVXOW GRW&RP7R7HVWFKHFN<RXUVHOIXVHU*XHVV DVNWKH'RW&RPWRFKHFNWKH XVHU
JXHVVORRNLQJIRUD KLW RU NLOO
LIUHVXOWHTXDOV³KLW´^
JHWRXWRIWKHORRSHDUO\QRSRLQW
EUHDN LQWHVWLQJWKHRWKHUV
`
LIUHVXOWHTXDOV³NLOO´^

WKLVJX\·VGHDGVRWDNHKLPRXWRIW
GRW&RPV/LVWUHPRYHGRW&RP7R7HVW
'R W&RPVOLVWWKHQJHWRXWRIWKHORRS KH
EUHDN
`
`FORVHIRU
SULQ
WWKHUHVXOWIRUWKHXVHU
`FORVHPHWKRG
SULQWDPHVVDJHWHOOLQJWKH
XVHUKRZKHGLGLQWKHJDPH

SULYDWHYRLG¿QLVK*DPH^
6\VWHPRXWSULQWOQ³$OO'RW&RPVDUHGHDG<RXUVWRFNLVQRZZRUWKOHVV´
LIQXP2I*XHVVHV ^
6\VWHPRXWSULQWOQ³,WRQO\WRRN\RX³QXP2I*XHVVHV³JXHVVHV´
6\VWHPRXWSULQWOQ³<RXJRWRXWEHIRUH\RXURSWLRQVVDQN´
`HOVH^
6\VWHPRXWSULQWOQ³7RRN\RXORQJHQRXJK³QXP2I*XHVVHV³JXHVVHV´
6\VWHPRXWSULQWOQ³)LVKDUHGDQFLQJZLWK\RXURSWLRQV´
`
`FORVHPHWKRG

'RW&RP%XVWJDPH QHZ'RW&RP%XVW FUHDWHWKHJ
JDPHVHW8S*DPH DPHREMHFW
JDPHVWDUW3OD\LQJ WHOOWKHJDPH
REMHFWWRVHW
`FORVHPHWKRG
WHOOWKHJDPH XSWKHJDPH
` REMHFWW JDPHSOD\O R R
LQSXWDQGFKRHFSNHHSVDVNVLQWDUWWKHPDLQ
NLQJWKHJXHVVJIRUXVHU

\RXDUHKHUH
WKH'RW&RPFRGH

UHDOFRGH
<PMNQVIT^MZ[QWVWN\PM
,W\+WUKTI[[
LPSRUWMDYDXWLO
SXEOLFFODVV'RW&RP^
'RW&RP·VLQVWDQFHYDULDEOHV
SULYDWH$UUD\/LVW6WULQJ!ORFDWLRQ&HOOV DQ$UUD\/LVWRIFHOOORFDWLRQV
SULYDWH6WULQJQDPH WKH'RW&RP·VQDPH
SXEOLFYRLGVHW/RFDWLRQ&HOOV$UUD\/LVW6WULQJ!ORF^ $VHWWHUPHWKRGWKDWXSGDWHV

WKH'RW&RP·VORFDWLRQ \
ORFDWLRQ&HOOV ORF 5DQGRPORFDWLRQSURYLGHGERP
` WKH*DPH+HOSHUSODFH'RW&
PHWKRG
SXEOLFYRLGVHW1DPH6WULQJQ^ <RXUEDVLFVHWWHUPHWKRG
QDPH Q
` 7KH$UUD\/LVWLQGH[2IPHQHR WKRGLQ
DFWLRQ ,IWK HXV HUJ XHVV LVR IWKH
HQWULHVLQWKH$UUD\ /LVW LQG H[2 I
SXEOLF6WULQJFKHFN<RXUVHOI6WULQJXVHU,QSXW^
ZLOOUHW XUQ LWV$UU D\/ LVW ORFD WLRQ ,I
6WULQJUHVXOW ³PLVV´ QRWLQGH[2IZLOOUH WXU Q
LQWLQGH[ ORFDWLRQ&HOOVLQGH[2IXVHU,QSXW
LILQGH[! ^
8VLQJ$UUD\/LVW·VUHPRYHPHWKRGWRGHOHWHDQHQWU\
ORFDWLRQ&HOOVUHPRYHLQGH[

LIORFDWLRQ&HOOVLV(PSW\^ 8VLQJWKHLV(PSW\PHWKRGWRVHHLIDOO
UHVXOW ³NLOO´ RIWKHORFDWLRQVKDYHEHHQJXHVVHG
6\VWHPRXWSULQWOQ³2XFK<RXVXQN³QDPH³³
`HOVH^
UHVXOW ³KLW´ 7HOOWKHXVHUZKHQ
D'RW&RPKDVEHH
`FORVHLI QVXQN
`FORVHLI
UHWXUQUHVXOW
5HWXUQ¶PLVV·RU
¶KLW·RU¶NLOO·
`FORVHPHWKRG
`FORVHFODVV
FKDSWHU
JHWWRNQRZWKH-DYD$3,
;]XMZ8W_MZN]T*WWTMIV-`XZM[[QWV[
3OFARWHENWEVEUSEDBOOLEANEXPRESSIONSFOROURLOOPSOR 1RWHTXDOV DQG
LITESTSTHEYVEBEENPRETTYSIMPLE7EWILLBEUSINGMORE
POWERFULBOOLEANEXPRESSIONSINSOMEOFTHE2EADY "AKECODE ,ETSSAYTHATYOUHAVEALOGICLIKEhOFTHETENAVAILABLE
YOUREABOUTTOSEEANDEVENTHOUGHWEKNOWYOUWOULDNT CAMERAMODELSACERTAINTHINGISTRUEFORALLBUTONEh
PEEKWETHOUGHTTHISWOULDBEAGOODTIMETODISCUSSHOWTO LIPRGHO ^
ENERGIZEYOUREXPRESSIONS GRQRQPRGHOVWXII
`
¶$QG·DQG¶2U·2SHUDWRUV __
ORFORCOMPARINGOBJECTSLIKESTRINGS
,ETSSAYYOUREWRITINGACHOOSE#AMERA METHODWITHLOTSOFRULES
ABOUTWHICHCAMERATOSELECT-AYBEYOUCANCHOOSECAMERAS LIEUDQGHTXDOV´;µ^
RANGINGFROMTOBUTINSOMECASESYOUWANTTOLIMITTHE GRQRQEUDQG;VWXII
PRICERANGEMOREPRECISELY9OUWANTTOSAYSOMETHINGLIKE `
@)FTHEPRICERANGEISBETWEENANDTHENCHOOSE8 6KRUW&LUFXLW2SHUDWRUV __

4HEOPERATORSWEVELOOKEDATSOFARAND\\ARE
LISULFH! SULFH^ KNOWNASSHORTCIRCUITOPERATORS)NTHECASEOF
THEEXPRESSIONWILLBETRUEONLYIFBOTHSIDESOFTHE
FDPHUD ´;µ
ARETRUE3OIFTHE*6-SEESTHATTHELEFTSIDEOFA
` EXPRESSIONISFALSEITSTOPSRIGHTTHERE$OESNTEVEN
BOTHERTOLOOKATTHERIGHTSIDE
,ETSSAYTHATOFTHETENCAMERABRANDSAVAILABLEYOUHAVESOME 3IMILARLYWITH\\THEEXPRESSIONWILLBETRUEIFEITHERSIDEIS
LOGICTHATAPPLIESTOONLYAFEWOFTHELIST TRUESOIFTHE*6-SEESTHATTHELEFTSIDEISTRUEITDECLARES
THEENTIRESTATEMENTTOBETRUEANDDOESNTBOTHERTO
CHECKTHERIGHTSIDE
LIEUDQGHTXDOV´$µ__EUDQGHTXDOV´%µ^
7HYISTHISGREAT,ETSSAYTHATYOUHAVEAREFERENCE
GRVWXIIIRUONLYEUDQG$OREUDQG% VARIABLEANDYOURENOTSUREWHETHERITSBEENASSIGNED
` TOANOBJECT)FYOUTRYTOCALLAMETHODUSINGTHISNULL
REFERENCEVARIABLEIENOOBJECTHASBEENASSIGNED YOULL
GETA.ULL0OINTER%XCEPTION3OTRYTHIS
"OOLEANEXPRESSIONSCANGETREALLYBIGANDCOMPLICATED
LIUHI9DU QXOO

LI]RRP7\SHHTXDOV´RSWLFDOµ
UHI9DULV9DOLG7\SH^
]RRP'HJUHH! ]RRP'HJUHH __
GR¶JRWDYDOLGW\SH·VWXII
]RRP7\SHHTXDOV´GLJLWDOµ
`
]RRP'HJUHH! ]RRP'HJUHH ^
GRDSSURSULDWH]RRPVWXII 1RQ6KRUW&LUFXLW2SHUDWRUV _
` 7HENUSEDINBOOLEANEXPRESSIONSTHEAND\OPERATORS
)FYOUWANTTOGETREALLYTECHNICALYOUMIGHTWONDERABOUTTHE ACTLIKETHEIRAND\\COUNTERPARTSEXCEPTTHAT
PRECEDENCEOFTHESEOPERATORS)NSTEADOFBECOMINGANEXPERT THEYFORCETHE*6-TOALWAYSCHECKBOTHSIDESOFTHE
INTHEARCANEWORLDOFPRECEDENCEWERECOMMENDTHATYOUUSE EXPRESSION4YPICALLYAND\AREUSEDINANOTHERCONTEXT
FORMANIPULATINGBITS
PARENTHESESTOMAKEYOURCODECLEAR
\RXDUHKHUH
5HDG\EDNH*DPH+HOSHU
7KLVLVWKHKHOSHUFODVVIRUWKHJDPH%HVLGHVWKHXVHULQSXWPHWKRG
4GCF[DCMG WKDWSURPSWVWKHXVHUDQGUHDGVLQSXWIURPWKHFRPPDQGOLQHWKH
KHOSHU·V%LJ6HUYLFHLVWRFUHDWHWKHFHOOORFDWLRQVIRUWKH'RW&RPV
%QFG ,IZHZHUH\RXZH·GMXVWEDFNDZD\VORZO\IURPWKLVFRGHH[FHSW
WRW\SHLWLQDQGFRPSLOHLW:HWULHGWRNHHSLWIDLUO\VPDOOWR\RX
ZRXOGQ·WKDYHWRW\SHVRPXFKEXWWKDWPHDQVLWLVQ·WWKHPRVW
LPSRUWMDYDLR UHDGDEOHFRGH$QGUHPHPEHU\RXZRQ·WEHDEOHWRFRPSLOHWKH
LPSRUWMDYDXWLO 'RW&RP%XVWJDPHFODVVXQWLO\RXKDYHWKLVFODVV
SXEOLFFODVV*DPH+HOSHU^
SULYDWHVWDWLF¿QDO6WULQJDOSKDEHW ³DEFGHIJ´
1RWH)RUH[WUDFUHGLW\RXPLJKW
SULYDWHLQWJULG/HQJWK WU\¶XQFRPPHQWLQJ·WKH
SULYDWHLQWJULG6L]H 6\VWHPRXWSULQWOQ·VLQWKH
SULYDWHLQW>@JULG QHZLQW>JULG6L]H@ SODFH'RW&RPPHWKRGMXVW
SULYDWHLQWFRP&RXQW
Licensed by
WRZDWFKLWZRUN7KHVHSULQW
SXEOLF6WULQJJHW8VHU,QSXW6WULQJSURPSW^ VWDWHPHQWVZLOOOHW\RX´FKHDWµ
6WULQJ
LQSXW/LQH QXOO E\JLYLQJ\RXWKHORFDWLRQRIWKH
6\VWHPRXWSULQWSURPSW³³ 'RW&RPVEXWLWZLOOKHOS\RXWHVWLW
WU\^
Eduard Simons
%XIIHUHG5HDGHULV QHZ%XIIHUHG5HDGHU
QHZ,QSXW6WUHDP5HDGHU6\VWHPLQ
LQSXW/LQH LVUHDG/LQH
LILQSXW/LQHOHQJWK UHWXUQQXOO
`FDWFK,2([FHSWLRQH^
104038
6\VWHPRXWSULQWOQ³,2([FHSWLRQ³H
`
UHWXUQLQSXW/LQHWR/RZHU&DVH
`

SXEOLF$UUD\/LVW6WULQJ!SODFH'RW&RPLQWFRP6L]H^
$UUD\/LVW6WULQJ!DOSKD&HOOV QHZ$UUD\/LVW6WULQJ!
6WULQJ>@DOSKDFRRUGV QHZ6WULQJ>FRP6L]H@KROGVµI¶W\SHFRRUGV
6WULQJWHPS QXOOWHPSRUDU\6WULQJIRUFRQFDW
LQW>@FRRUGV QHZLQW>FRP6L]H@FXUUHQWFDQGLGDWHFRRUGV
LQWDWWHPSWV FXUUHQWDWWHPSWVFRXQWHU
ERROHDQVXFFHVV IDOVHÀDJ IRXQGDJRRGORFDWLRQ"
LQWORFDWLRQ FXUUHQWVWDUWLQJORFDWLRQ

FRP&RXQWQWKGRWFRPWRSODFH
LQWLQFU VHWKRUL]RQWDOLQFUHPHQW
LIFRP&RXQW ^LIRGGGRWFRPSODFHYHUWLFDOO\
LQFU JULG/HQJWKVHWYHUWLFDOLQFUHPHQW
`
ZKLOHVXFFHVV DWWHPSWV^PDLQVHDUFKORRS

ORFDWLRQ LQW0DWKUDQGRP JULG6L]HJHWUDQGRPVWDUWLQJSRLQW
6\VWHPRXWSULQW³WU\³ORFDWLRQ
LQW[ QWKSRVLWLRQLQGRWFRPWRSODFH
VXFFHVV WUXHDVVXPHVXFFHVV
ZKLOHVXFFHVV [FRP6L]HÔRRNIRUDGMDFHQWXQXVHGVSRWV
LIJULG>ORFDWLRQ@ ^LIQRWDOUHDG\XVHG
FKDSWHU
JHWWRNQRZWKH-DYD$3,
4GCF[DCMG /IUM0MTXMZKTI[[KWLMKWV\QV]ML
%QFG
FRRUGV>[@ ORFDWLRQVDYHORFDWLRQ
ORFDWLRQ LQFUWU\µQH[W¶DGMDFHQW
LIORFDWLRQ! JULG6L]H^RXWRIERXQGVµERWWRP¶
VXFFHVV IDOVHIDLOXUH
`
LI[! ORFDWLRQJULG/HQJWK ^RXWRIERXQGVULJKWHGJH
`
`HOVHÎRXQGDOUHDG\XVHGORFDWLRQ
6\VWHPRXWSULQW³XVHG³ORFDWLRQ
`
`
`HQGZKLOH

LQW[ WXUQORFDWLRQLQWRDOSKDFRRUGV
LQWURZ
LQWFROXPQ
6\VWHPRXWSULQWOQ³?Q´
ZKLOH[FRP6L]H^
JULG>FRRUGV>[@@ PDUNPDVWHUJULGSWVDVµXVHG¶
URZ LQWFRRUGV>[@JULG/HQJWKJHWURZYDOXH
FROXPQ FRRUGV>[@JULG/HQJWKJHWQXPHULFFROXPQYDOXH
WHPS 6WULQJYDOXH2IDOSKDEHWFKDU$WFROXPQFRQYHUWWRDOSKD

DOSKD&HOOVDGGWHPSFRQFDW,QWHJHUWR6WULQJURZ
PHQWWKDW
[
7 K LV L VWKHVWDWHZKHUHWKH
6\VWHPRXWSULQW³FRRUG³[´ ³DOSKD&HOOVJHW[ DFWO\
` WHOOV\RXH[ ORFDWHG
'RW&RPLV
6\VWHPRXWSULQWOQ³?Q´

UHWXUQDOSKD&HOOV
`
`
\RXDUHKHUH
$3,SDFNDJHV
=[QVO\PM4QJZIZa\PM2IÎ)81
9OUMADEITALLTHEWAYTHROUGHTHE$OT#OM"USTGAME
THANKSTOTHEHELPOF!RRAY,IST!NDNOWASPROMISED
ITSTIMETOLEARNHOWTOFOOLAROUNDINTHE*AVALIBRARY
,QWKH-DYD$3,FODVVHV
DUHJURXSHGLQWRSDFNDJHV
7RXVHDFODVVLQWKH$3,\RX
KDYHWRNQRZZKLFKSDFNDJH
WKHFODVVLVLQ
%VERYCLASSINTHE*AVALIBRARYBELONGSTOAPACKAGE
4HEPACKAGEHASANAMELIKEMDYD[VZLQJA
PACKAGETHATHOLDSSOMEOFTHE3WING'5)CLASSES
YOULLLEARNABOUTSOON !RRAY,ISTISINTHEPACKAGE
CALLEDMDYDXWLOWHICHSURPRISESURPRISEHOLDSA
PILEOFUTILITYCLASSES9OULLLEARNALOTMOREABOUT
PACKAGESINCHAPTERINCLUDINGHOWTOPUTYOUR
OWNCLASSESINTOYOUROWNPACKAGES&ORNOWTHOUGH
WEREJUSTLOOKINGTOUSESOMEOFTHECLASSESTHATCOME
WITH*AVA
5SINGACLASSFROMTHE!0)INYOUROWNCODEIS
SIMPLE9OUJUSTTREATTHECLASSASTHOUGHYOUWROTE
ITYOURSELFASTHOUGHYOUCOMPILEDITANDTHEREIT
SITSWAITINGFORYOUTOUSEIT7ITHONEBIGDIFFERENCE
SOMEWHEREINYOURCODEYOUHAVETOINDICATETHEFULL
NAMEOFTHELIBRARYCLASSYOUWANTTOUSEANDTHAT
MEANSPACKAGENAMECLASSNAME
%VENIFYOUDIDNTKNOWITYOUVEALREADYBEENUSING
CLASSESFROMAPACKAGE3YSTEM3YSTEMOUTPRINTLN
3TRINGAND-ATH-ATHRANDOM ALLBELONGTOTHE
MDYDODQJPACKAGE
FKDSWHU
JHWWRNQRZWKH-DYD$3,
<RXKDYHWRNQRZWKHIXOOQDPH WKHUH DUH QR

'XPE 4XHVWLRQV
RIWKHFODVV\RXZDQWWRXVHLQ
\RXUFRGH Q: 7HYDOESTHEREHAVETO
BEAFULLNAME)STHATTHEONLY
PURPOSEOFAPACKAGE
!RRAY,ISTISNOTTHEFULLNAMEOF!RRAY,ISTJUSTAS@+ATHY
ISNTAFULLNAMEUNLESSITSLIKE-ADONNAOR#HERBUTWE
WONTGOTHERE 4HEFULLNAMEOF!RRAY,ISTISACTUALLY A: 0ACKAGESAREIMPORTANT
FORTHREEMAINREASONS&IRSTTHEY
MDYDXWLO$UUD\/LVW HELPTHEOVERALLORGANIZATIONOFA
PROJECTORLIBRARY2ATHERTHANJUST
HAVINGONEHORRENDOUSLYLARGE
SDFNDJHQDPH
FODVVQDPH PILEOFCLASSESTHEYREALLGROUPED
INTOPACKAGESFORSPECIFICKINDS
OFFUNCTIONALITYLIKE'5)ORDATA
STRUCTURESORDATABASESTUFFETC
<RXKDYHWRWHOO-DYDZKLFK$UUD\/LVW\RX 3ECONDPACKAGESGIVEYOUANAME
ZDQWWRXVH<RXKDYHWZRRSWLRQV SCOPINGTOHELPPREVENTCOLLISIONS
IFYOUANDOTHERPROGRAMMERS
INYOURCOMPANYALLDECIDETO
MAKEACLASSWITHTHESAMENAME
) ,03257 )FYOUHAVEACLASSNAMED3ETAND
3XWDQLPSRUWVWDWHPHQWDWWKHWRSRI\RXUVRXUFHFRGH¿OH SOMEONEELSEINCLUDINGTHE*AVA
LPSRUWMDYDXWLO$UUD\/LVW !0) HASACLASSNAMED3ETYOU
NEEDSOMEWAYTOTELLTHE*6-
SXEOLFFODVV0\&ODVV^` WHICH3ETCLASSYOURETRYINGTOUSE
25 4HIRDPACKAGESPROVIDEALEVELOF
SECURITYBECAUSEYOUCANRESTRICT
THECODEYOUWRITESOTHATONLY
OTHERCLASSESINTHESAMEPACKAGE
CANACCESSIT9OULLLEARNALLABOUT
* 7<3( THATINCHAPTER
7\SHWKHIXOOQDPHHYHU\ZKHUHLQ\RXUFRGH(DFKWLPH
\RXXVHLW$Q\ZKHUH\RXXVHLW
/+BACKTOTHENAME Q:
COLLISIONTHING(OWDOESAFULL
:KHQ\RXGHFODUHDQGRULQVWDQWLDWHLW
NAMEREALLYHELP7HATSTO
MDYDXWLO$UUD\/LVW'RJ!OLVW QHZMDYDXWLO$UUD\/LVW'RJ! PREVENTTWOPEOPLEFROMGIVINGA
CLASSTHESAMEPACKAGENAME
:KHQ\RXXVHLWDVDQDUJXPHQWW\SH
SXEOLFYRLGJRMDYDXWLO$UUD\/LVW'RJ!OLVW^`
A: *AVAHASANAMINGCONVENTION
THATUSUALLYPREVENTSTHISFROM
HAPPENINGASLONGASDEVELOPERS
ADHERETOIT7ELLGETINTOTHATIN
:KHQ\RXXVHLWDVDUHWXUQW\SH MOREDETAILINCHAPTER
SXEOLFMDYDXWLO$UUD\/LVW'RJ!IRR^`

8QOHVVWKHFODVVLVLQWKHMDYDODQJSDFNDJH
\RXDUHKHUH
:MDD=LHGAFLK
$UUD\/LVWLVDFODVVLQWKH-DYD$3,
:KHUH·GWKDW¶[·FRPHIURP"
7RSXWVRPHWKLQJLQWRDQ$UUD\/LVWXVHDGG
RUZKDWGRHVLWPHDQZKHQ
DSDFNDJHVWDUWVZLWKMDYD[" 7RUHPRYHVRPHWKLQJIURPDQ$UUD\/LVWXVH
UHPRYH
)NTHEFIRSTANDSECONDVERSIONSOF*AVA
AND ALLCLASSESTHATSHIPPEDWITH*AVAIN 7RILQGRXWZKHUHVRPHWKLQJLVDQGLILWLVLQDQ
OTHERWORDSTHESTANDARDLIBRARY WEREINPACKAGES $UUD\/LVWXVHLQGH[2I
THATBEGANWITHJAVA4HEREWASALWAYSJAVALANGOFCOURSE
THEONEYOUDONTHAVETOIMPORT!NDTHEREWASJAVANET 7RILQGRXWLIDQ$UUD\/LVWLVHPSW\XVH
JAVAIOJAVAUTILALTHOUGHTHEREWASNOSUCHTHINGAS!RRAY,IST LV(PSW\
WAYBACKTHEN ANDAFEWOTHERSINCLUDINGTHEJAVAAWT
PACKAGETHATHELD'5) RELATEDCLASSES 7RJHWWKHVL]HQXPEHURIHOHPHQWVLQDQ
$UUD\/LVWXVHWKHVL]HPHWKRG
,OOMINGONTHEHORIZONTHOUGHWEREOTHERPACKAGESNOT
INCLUDEDINTHESTANDARDLIBRARY4HESECLASSESWEREKNOWNAS 7RJHWWKHOHQJWKQXPEHURIHOHPHQWVLQD
EXTENSIONSANDCAMEINTWOMAINFLAVORSSTANDARDANDNOT UHJXODUROGDUUD\UHPHPEHU\RXXVHWKHOHQJWK
STANDARD3TANDARDEXTENSIONSWERETHOSETHAT3UNCONSIDERED
YDULDEOH
OFFICIALASOPPOSEDTOEXPERIMENTALEARLYACCESSORBETA
PACKAGESTHATMIGHTORMIGHTNOTEVERSEETHELIGHTOFDAY $Q$UUD\/LVWUHVL]HVG\QDPLFDOO\WRZKDW
3TANDARDEXTENSIONSBYCONVENTIONALLBEGANWITHAN@X HYHUVL]HLVQHHGHG,WJURZVZKHQREMHFWV
APPENDEDTOTHEREGULARJAVAPACKAGESTARTER4HEMOTHEROFALL DUHDGGHGDQGLWVKULQNVZKHQREMHFWVDUH
STANDARDEXTENSIONSWASTHE3WINGLIBRARY)TINCLUDEDSEVERAL UHPRYHG
PACKAGESALLOFWHICHBEGANWITHJAVAXSWING
"UTSTANDARDEXTENSIONSCANGETPROMOTEDTOFIRST CLASSSHIPS
<RXGHFODUHWKHW\SHRIWKHDUUD\XVLQJDW\SH
WITH *AVASTANDARD OUT OF THE BOXLIBRARYPACKAGES!NDTHATS
SDUDPHWHUZKLFKLVDW\SHQDPHLQDQJOH
WHATHAPPENEDTO3WINGBEGINNINGWITHVERSIONWHICH EUDFNHWV([DPSOH$UUD\/LVW%XWWRQ!PHDQV
EVENTUALLYBECAMETHEFIRSTVERSIONDUBBED@*AVA WKH$UUD\/LVWZLOOEHDEOHWRKROGRQO\REMHFWVRI
W\SH%XWWRQRUVXEFODVVHVRI%XWWRQDV\RX·OO
h#OOLvEVERYONETHOUGHTINCLUDINGUS h.OWEVERYONEWHOHAS
*AVAWILLHAVETHE3WINGCLASSESANDWEWONTHAVETOFIGURE OHDUQLQWKHQH[WFRXSOHRIFKDSWHUV
OUTHOWTOGETTHOSECLASSESINSTALLEDWITHOUREND USERSv $OWKRXJKDQ$UUD\/LVWKROGVREMHFWVDQGQRW
4ROUBLEWASLURKINGBENEATHTHESURFACEHOWEVERBECAUSE SULPLWLYHVWKHFRPSLOHUZLOODXWRPDWLFDOO\´ZUDSµ
WHENPACKAGESGETPROMOTEDWELLOF#/523%THEYHAVETO DQG´XQZUDSµZKHQ\RXWDNHLWRXWDSULPL
STARTWITHJAVANOTJAVAX%VERYONE+./73THATPACKAGESIN WLYHLQWRDQ2EMHFWDQGSODFHWKDWREMHFWLQWKH
THESTANDARDLIBRARYDONTHAVETHAThXvANDTHATONLYEXTENSIONS $UUD\/LVWLQVWHDGRIWKHSULPLWLYH0RUHRQWKLV
HAVETHEhXv3OJUSTANDWEMEANJUST BEFOREVERSION
IHDWXUHODWHULQWKHERRN
WENTFINAL3UNCHANGEDTHEPACKAGENAMESANDDELETEDTHE
hXvAMONGOTHERCHANGES "OOKSWEREPRINTEDANDINSTORES &ODVVHVDUHJURXSHGLQWRSDFNDJHV
FEATURING3WINGCODEWITHTHENEWNAMES.AMINGCONVENTIONS
WEREINTACT!LLWASRIGHTWITHTHE*AVAWORLD $FODVVKDVDIXOOQDPHZKLFKLVDFRPELQD
%XCEPTTHEORSOSCREAMINGDEVELOPERSWHOREALIZED WLRQRIWKHSDFNDJHQDPHDQGWKHFODVVQDPH
THATWITHTHATSIMPLENAMECHANGECAMEDISASTER!LLOFTHEIR &ODVV$UUD\/LVWLVUHDOO\MDYDXWLO$UUD\/LVW
3WING USINGCODEHADTOBECHANGED4HEHORROR4HINKOFALL
THOSEIMPORTSTATEMENTSTHATSTARTEDWITHJAVAX
7RXVHDFODVVLQDSDFNDJHRWKHUWKDQMDYD
ODQJ\RXPXVWWHOO-DYDWKHIXOOQDPHRIWKH
!NDINTHEFINALHOURDESPERATEASTHEIRHOPESGREWTHINTHE FODVV
DEVELOPERSCONVINCED3UNTOhSCREWTHECONVENTIONSAVEOUR
CODEv4HERESTISHISTORY3OWHENYOUSEEAPACKAGEINTHE <RXXVHHLWKHUDQLPSRUWVWDWHPHQWDWWKHWRSRI
LIBRARYTHATBEGINSWITHJAVAXYOUKNOWITSTARTEDLIFEASAN \RXUVRXUFHFRGHRU\RXFDQW\SHWKHIXOOQDPH
EXTENSIONANDTHENGOTAPROMOTION HYHU\SODFH\RXXVHWKHFODVVLQ\RXUFRGH
FKDSWHU
JHWWRNQRZWKH-DYD$3,
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: $OESLPSRUWMAKEMY
CLASSBIGGER$OESITACTUALLY
COMPILETHEIMPORTEDCLASSOR
PACKAGEINTOMYCODE
0DNH LW 6WLFN
A: 0ERHAPSYOUREA#PRO
GRAMMER!NLPSRUWISNOTTHE
2OSESARERE
APPLESARER
D
IPE
SAMEASANLQFOXGH3OTHE IFYOUDONTI
MPORT
ANSWERISNOANDNO2EPEATAFTER YOULLJUSTH
AVETOT YPE
MEhANLPSRUWSTATEMENTSAVES 9OUMUSTT
YOUFROMTYPINGv4HATSREALLYIT ELL*AVATHE
YOUUSEUN FULLNAMEO
9OUDONTHAVETOWORRYABOUT LESSTHATCLA FEVERYCLA
PACKAGE! SSISINTHE SS
YOURCODEBECOMINGBLOATEDOR NLPSRUW JAVALANG
ORPACKAGE STATEMENT
SLOWERFROMTOOMANYIMPORTS ATTHETOPO FORTHECLAS
EASYWAY/ FYOURSOURC S
THER WISEYO ECO
!NLPSRUWISSIMPLYTHEWAYYOU
NAMEOFTH UHAVETOTYP DEISTHE
GIVE*AVATHEFULLNAMEOFACLASS ECLASSEVE ETHEFULL
RYWHEREYO
UUSEIT
Q: /+HOWCOME)NEVERHAD
TOIMPORTTHE3TRINGCLASS/R
3YSTEM
2QHPRUHWLPHLQWKHXQOLNHO\
HYHQWWKDW\RXGRQ·WDOUHDG\
KDYHWKLVGRZQ
A: 2EMEMBERYOUGETTHE
JAVALANGPACKAGESORTOFhPRE
IMPORTEDvFORFREE"ECAUSE
THECLASSESINJAVALANGARESO
FUNDAMENTALYOUDONTHAVETO
LPSRUW
USETHEFULLNAME4HEREISONLY
ONEJAVALANG3TRINGCLASSANDONE
JAVALANG3YSTEMCLASSAND*AVA RU
DARNWELLKNOWSWHERETOFIND
THEM
Q: $O)HAVETOPUTMYOWN
CLASSESINTOPACKAGES(OWDO)
DOTHAT#AN)DOTHAT
A: )NTHEREALWORLDWHICH
YOUSHOULDTRYTOAVOID YESYOU
WILLWANTTOPUTYOURCLASSESINTO
PACKAGES7ELLGETINTOTHATIN
DETAILINCHAPTER&ORNOWWE
WONTPUTOURCODEEXAMPLESINA
PACKAGE
\RXDUHKHUH
JHWWLQJWRNQRZWKH$3,
h'OODTOKNOWTHERESAN!RRAY,ISTIN
THEJAVAUTILPACKAGE"UTBYMYSELFHOW
WOULD)HAVElGUREDTHATOUTv
-XOLDKDQGPRGHO
0W_\WXTIa_Q\P\PM)81
7ZRWKLQJV\RXZDQWWRNQRZ
:KDWFODVVHVDUHLQWKHOLEUDU\"
2QFH\RXÀQGDFODVVKRZGR
\RXNQRZZKDWLWFDQGR"
%URZVHD%RRN
8VHWKH+70/$3,GRFV
FKDSWHU
JHWWRNQRZWKH-DYD$3,
%URZVHD%RRN
)OLSSLQJWKURXJKD
UHIHUHQFHERRNLVWKH
EHVWZD\WRÀQGRXW
ZKDW·VLQWKH-DYD
OLEUDU\<RXFDQHDVLO\
VWXPEOHRQDFODVVWKDW
ORRNVXVHIXOMXVWE\
EURZVLQJSDJHV
FODVVQDPH
SDFNDJHQDPH
LRQ
FODVVGHVFULSW
PHWKRGVDQGRWKH
ZH·OOWDONDERXWODWUWKLQJV
HU
\RXDUHKHUH
XVLQJWKH-DYD$3,GRFXPHQWDWLRQ
8VHWKH+70/$3,GRFV
*AVACOMESWITHAFABULOUSSETOFONLINEDOCS 4HEREFERENCEBOOKFOREXAMPLETELLSYOU
CALLEDSTRANGELYTHE*AVA!0)4HEYREPARTOF WHATTHEMETHODSTAKEASARGUMENTSANDWHAT
ALARGERSETCALLEDTHE*AVA3TANDARD%DITION THEYRETURN,OOKAT!RRAY,ISTFOREXAMPLE
$OCUMENTATIONWHICHDEPENDINGONWHAT )NTHEREFERENCEBOOKYOULLlNDTHEMETHOD
DAYOFTHEWEEKYOULOOK3UNMAYBEREFER INDEX/F THATWEUSEDINTHE$OT#OMCLASS
RINGTOASh*AVA3TANDARD%DITIONv AND "UTIFALLYOUKNEWISTHATTHEREISAMETHOD
YOUHAVETODOWNLOADTHEDOCSSEPARATELY CALLEDINDEX/F THATTAKESANOBJECTANDRE
THEYDONTCOMESHRINK WRAPPEDWITHTHE*AVA TURNSTHEINDEXANINT OFTHATOBJECTYOUSTILL
DOWNLOAD)FYOUHAVEAHIGH SPEEDINTERNET NEEDTOKNOWONECRUCIALTHINGWHATHAPPENS
CONNECTIONORTONSOFPATIENCEYOUCANALSO IFTHEOBJECTISNOTINTHE!RRAY,IST,OOKING
BROWSETHEMATJAVASUNCOM4RUSTUSYOU ATTHEMETHODSIGNATUREALONEWONTTELLYOU
PROBABLYWANTTHESEONYOURHARDDRIVE HOWTHATWORKS"UTTHE!0)DOCSWILLMOSTOF
THETIMEANYWAY 4HE!0)DOCSTELLYOUTHAT
4HE!0)DOCSARETHEBESTREFERENCEFORGET THEINDEX/F METHODRETURNSA IFTHEOBJECT
TINGMOREDETAILSABOUTACLASSANDITSMETHODS PARAMETERISNOTINTHE!RRAY,IST4HATSHOW
,ETSSAYYOUWEREBROWSINGTHROUGHTHEREFER WEKNEWWECOULDUSEITBOTHASAWAYTOCHECK
ENCEBOOKANDFOUNDACLASSCALLED#ALENDAR IFANOBJECTISEVENINTHE!RRAY,ISTANDTOGET
INJAVAUTIL4HEBOOKTELLSYOUALITTLEABOUTIT ITSINDEXATTHESAMETIMEIFTHEOBJECTWAS
ENOUGHTOKNOWTHATTHISISINDEEDWHATYOU THERE"UTWITHOUTTHE!0)DOCSWEMIGHTHAVE
WANTTOUSEBUTYOUSTILLNEEDTOKNOWMORE THOUGHTTHATTHEINDEX/F METHODWOULD
ABOUTTHEMETHODS BLOWUPIFTHEOBJECTWASNTINTHE!RRAY,IST

6FUROOWKURXJKWKH
DQGVHOHFWRQHFOLF SDFNDJHV
WRUHVWULFWWKHOLV NLW
ORZHUIUDPHWRRQOWLQWKH UHDOOWKH
IURPWKDWSDFNDJH\FODVVHV 7KLVLVZKH LV<RXFDQ
JRRGVWXIIXJKWKH
VFUROOWKUR RUDEULHI
HV PHWKRGVI UFOLFNRQ
WK UR X J K WKHFODVV WR

6FUROO RQHFOLFNLW LOO VXPPDU\RWRJHWIXOO
DQGVHOHFWHFODVVWKDWZLOOI DPHWKRG
FKRRVHWK EURZVHUIUDPH GHWDLOV
WKHPDLQ
FKDSWHU
JHWWRNQRZWKH-DYD$3,
1dQÔU_Q
Code Magnets SULQW$/D
#ANYOURECONSTRUCTTHECODESNIPPETSTOMAKEA DUHPRYH
SULQW$/D
WORKING*AVAPROGRAMTHATPRODUCESTHEOUTPUT
LISTEDBELOW./4%4ODOTHISEXERCISEYOUNEED DDGG
´]HUR´
ONE.%7PIECEOFINFOIFYOULOOKINTHE!0)FOR DDGG
!RRAY,ISTYOULLFINDASECONDADDMETHODTHATTAKES ´RQH´

TWOARGUMENTS
W6WULQJ!DO^
ADDINTINDEX/BJECTO SXEOLFVWDWLFYRLGSULQW$/$UUD\/LV
)TLETSYOUSPECIFYTOTHE
!RRAY,ISTWHERETOPUTTHEOBJECTYOUREADDING LIDFRQ
WDLQV³WZ
DDGG R´^
³´
`
DDGG´WZR´
6\VWHPRXWSULQWHOHPHQW³³
`
6\VWHPRXWSULQWOQ³³
LIDFRQWDLQV³WKUHH´^
DDGG³IRXU´
`
SXEOLFFODVV$UUD\/LVW0DJQHW^
LIDLQGH[2I³IRXU´ ^

DDGG³´
`
` `

LPSRUWMDYDXWLO
`
SULQW$/D
D\/LVW6WULQJ!
$UUD\/LVW6WULQJ!D QHZ$UU
IRU6WULQ
)LOH(GLW:LQGRZ+HOS'DQFH JHOHPHQW
DO^
MDYD$UUD\/LVW0DJQHW
]HURRQHWZRWKUHH
]HURRQHWKUHHIRXU KUHH´
]HURRQHWKUHHIRXU DDGG´W

]HURRQHWKUHHIRXU SULQW$/D
\RXDUHKHUH
SX]]OHFURVVZRUG

-DYD&URVV

(OWDOESTHISCROSSWORDPUZZLEHELPYOULEARN
*AVA7ELLALLOFTHEWORDSARE*AVARELATED

EXCEPTONEREDHERRING

(INT7HENINDOUBTREMEMBER!RRAY,IST
Licensed by

!CROSS
Eduard Simons
)CANTBEHAVE

/RINTHECOURTROOM
7HEREITSATBABY
!FORKSORIGIN $OWN
104038
'ROWAN!RRAY,IST 7HERETHE*AVAACTIONIS
7HOLLYMASSIVE !DDRESSABLEUNIT
6ALUECOPY NDSMALLEST
.OTANOBJECT &RACTIONALDEFAULT
!NARRAYONSTEROIDS ,IBRARYSGRANDEST
%XTENT -USTBELOWDENSITY
SCOUNTERPART (ESINTHERESOMEWHERE
3PANISHGEEKSNACKS.OTE4HISHAS !SIF
NOTHINGTODOWITH*AVA
DEARTHMETHOD
&ORLAZYlNGERS
7HATSHOPPINGANDARRAYSHAVEINCOMMON
7HEREPACKAGESROAM
,IBRARYACRONYM
7HATGOESAROUND
-ORE(INTS
(ESMAKINGA?????? .OTABOUT*AVA 3PANISHAPPETIZERS
4HINK!RRAY,IST !RRAYSEXTENT
0RIMITIVE #OMMONPRIMITIVE
4HINK!RRAY,IST 4HINK!RRAY,IST
7HATSOVERRIDABLE VARIETIES
$OWN !CROSS
FKDSWHU
JHWWRNQRZWKH-DYD$3,
LPSRUWMDYDXWLO
SXEOLFFODVV$UUD\/LVW0DJQHW^
%XERCISE3OLUTIONS
$UUD\/LVW6WULQJ!D QHZ$UUD\/LVW6WULQJ!
DDGG´]HUR´
DDGG´RQH´
MDYD$UUD\/LVW0DJQHW
]HURRQHWZRWKUHH DDGG´WZR´
]HURRQHWKUHHIRXU
]HURRQHWKUHHIRXU
DDGG´WKUHH´
]HURRQHWKUHHIRXU
SULQW$/D
LIDFRQWDLQV³WKUHH´^

DDGG³IRXU´
`
DUHPRYH
SULQW$/D
LIDLQGH[2I³IRXU´ ^

DDGG³´
`
SULQW$/D
LIDFRQWDLQV³WZR´^

DDGG³´
`
SULQW$/D
`
SXEOLFVWDWLFYRLGSULQW$/$UUD\/LVW6WULQJ!DO^
IRU6WULQJHOHPHQWDO^
6\VWHPRXWSULQWHOHPHQW³³
`
6\VWHPRXWSULQWOQ³³
`
`
\RXDUHKHUH
SX]]OHDQVZHUV

35,0,7,9(6

'(/+

-DYD&URVV 2%-(&7,1'(;2)
8+05

DQVZHUV %32,)(7&

/$''/21*2

*(7&271

.9$,17

$55$</,67/6$

*56,=(,

$/(1*7+601

3287$3$6

,03257$7

3/,%5$5<
6KDUSHQ \RXU SHQFLO

7RITEYOUR/7.SETOFCLUES,OOKATEACHWORDANDTRYTO
WRITEYOUROWNCLUES4RYMAKINGTHEMEASIERORHARDEROR
!CROSS MORETECHNICALTHANTHEONESWEHAVE
???????????????????????????????????
??????????????????????????????????? $OWN
??????????????????????????????????? ???????????????????????????????????
??????????????????????????????????? ???????????????????????????????????
??????????????????????????????????? ???????????????????????????????????
??????????????????????????????????? ???????????????????????????????????
??????????????????????????????????? ???????????????????????????????????
??????????????????????????????????? ???????????????????????????????????
??????????????????????????????????? ???????????????????????????????????
??????????????????????????????????? ???????????????????????????????????
??????????????????????????????????? ???????????????????????????????????
??????????????????????????????????? ???????????????????????????????????
??????????????????????????????????? ???????????????????????????????????
??????????????????????????????????? ???????????????????????????????????
FKDSWHU
LQKHULWDQFHDQGSRO\PRUSKLVP
:HZHUHXQGHUSDLG
%HWWHU/LYLQJLQ RYHUZRUNHGFRGHUV¶WLOOZH
WULHGWKH3RO\PRUSKLVP3ODQ%XW
2EMHFWYLOOH WKDQNVWRWKH3ODQRXUIXWXUHLV
EULJKW<RXUVFDQEHWRR
3ODQ\RXUSURJUDPVZLWKWKHIXWXUHLQPLQG)FTHEREWEREAWAYTOWRITE
*AVACODESUCHTHATYOUCOULDTAKEMOREVACATIONSHOWMUCHWOULDITBEWORTHTOYOU7HAT
IFYOUCOULDWRITECODETHATSOMEONEELSECOULDEXTENDEASILY!NDIFYOUCOULDWRITECODE
THATWASFLEXIBLEFORTHOSEPESKYLAST MINUTESPECCHANGESWOULDTHATBESOMETHINGYOURE
INTERESTEDIN4HENTHISISYOURLUCKYDAY&ORJUSTTHREEEASYPAYMENTSOFMINUTESTIMEYOU
CANHAVEALLTHIS7HENYOUGETONTHE0OLYMORPHISM0LANYOULLLEARNTHESTEPSTOBETTERCLASS
DESIGNTHETRICKSTOPOLYMORPHISMTHEWAYSTOMAKEFLEXIBLECODEANDIFYOUACTNOWA
BONUSLESSONONTHETIPSFOREXPLOITINGINHERITANCE$ONTDELAYANOFFERTHISGOODWILLGIVE
YOUTHEDESIGNFREEDOMANDPROGRAMMINGFLEXIBILITYYOUDESERVE)TSQUICKITSEASYANDITS
AVAILABLENOW3TARTTODAYANDWELLTHROWINANEXTRALEVELOFABSTRACTION
WKLVLVDQHZFKDSWHU
WKHSRZHURI LQKHULWDQFH
+PIQZ?IZ[:M^Q[Q\ML
2EMEMBERWAYBACKINCHAPTERWHEN,ARRYPROCEDURALGUY
AND"RAD//GUY WEREVYINGFORTHE!ERONCHAIR,ETSLOOKAT
AFEWPIECESOFTHATSTORYTOREVIEWTHEBASICSOFINHERITANCE
,!2299OUVEGOTDUPLICATEDCODE4HEROTATEPROCEDURE
ISINALLFOUR3HAPETHINGS)TSASTUPIDDESIGN9OUHAVETO
MAINTAINFOURDIFFERENTROTATEhMETHODSv(OWCANTHAT
EVERBEGOOD
"2!$/H)GUESSYOUDIDNTSEETHElNALDESIGN,ETME
SHOWYOUHOW//INHERITANCEWORKS,ARRY

1 TWWSML I\ _PI\ ITT NW]Z
URWDWH URWDWH URWDWH URWDWH KTI[[M[ PI^M QV KWUUWV
SOD\6RXQG SOD\6RXQG SOD\6RXQG SOD\6RXQG

<PMa¼ZM ;PIXM[ IVL \PMa ITT ZW\I\M IVL 6KDSH
XTIa;W]VL ;W 1 IJ[\ZIK\ML W]\ \PM URWDWH
KWUUWV NMI\]ZM[ IVL X]\ \PMU QV\W I SOD\6RXQG
VM_ KTI[[ KITTML ;PIXM <PMV1TQVSML\PMW\PMZ
6KDSH
[]XMZKTI[[ NW]Z[PIXMKTI[[M[\W
URWDWH
SOD\6RXQG \PMVM_;PIXMKTI[[
QVIZMTI\QWV[PQXKITTML
QVPMZQ\IVKM
<RXFDQUHDGWKLVDV´6TXDUHLQKHULWVIURP6KDSHµ
´&LUFOHLQKHULWVIURP6KDSHµDQGVRRQ,UHPRYHG []JKTI[[M[
URWDWHDQGSOD\6RXQGIURPWKHRWKHUVKDSHVVRQRZ
WKHUH·VRQO\RQHFRS\WRPDLQWDLQ
7KH6KDSHFODVVLVFDOOHGWKHVXSHUFODVVRIWKHRWKHUIRXU
FODVVHV7KHRWKHUIRXUDUHWKHVXEFODVVHVRI6KDSH7KH
VXEFODVVHVLQKHULWWKHPHWKRGVRIWKHVXSHUFODVV,QRWKHU
ZRUGVLIWKH6KDSHFODVVKDVWKHIXQFWLRQDOLW\WKHQWKH
VXEFODVVHVDXWRPDWLFDOO\JHWWKDWVDPHIXQFWLRQDOLW\
FKDSWHU
?PI\IJW]\\PM)UWMJIZW\I\M'
,!2297ASNTTHATTHEWHOLEPROBLEMHERETHATTHEAMOEBASHAPE
HADACOMPLETELYDIFFERENTROTATEANDPLAY3OUNDPROCEDURE
UULGH 1RZ
(OWCANAMOEBADOSOMETHINGDIFFERENTIFITINHERITSITS YH
2
FUNCTIONALITYFROMTHE3HAPECLASS
$V Z
"2!$4HATSTHELASTSTEP4HE!MOEBACLASSOVERRIDESTHE N 0H +R
METHODSOFTHE3HAPECLASS4HENATRUNTIMETHE*6-KNOWS
EXACTLYWHICHROTATE METHODTORUNWHENSOMEONETELLSTHE
!MOEBATOROTATE
[]XMZKTI[[
UWZM IJ[\ZIK\
6KDSH
URWDWH
SOD\6RXQG
1 UILM \PM )UWMJI KTI[[ W^MZZQLM
1UILM\PM)UWMJIKTI[[W^MZZQLM\PM
\PM ZW\I\M UM\PWL WN \PM
ZW\I\MIVLXTIa;W]VLUM\PWL[
[]XMZKTI[[ ;PIXM
WN\PM[]XMZKTI[[;PIXM7^MZZQLQVO
[]JKTI[[M[ R][\UMIV[\PI\I[]JKTI[[ZMLMNQVM[
UWZM [XMKQNQK 7^MZZQLQVO R][\ UMIV[ \PI\ I
WVMWNQ\[QVPMZQ\MLUM\PWL[_PMV
[]JKTI[[ ZMLMNQVM[ WVM WN Q\[
Q\VMML[\WKPIVOMWZM`\MVL\PM
QVPMZQ\ML UM\PWL[ _PMV Q\ VMML[
JMPI^QWZWN\PI\UM\PWL
\W KPIVOM WZ M`\MVL \PM JMPI^QWZ
URWDWH WN \PI\ UM\PWL
DPRHEDVSHFLILF
URWDWH FRGH
7^MZZQLQVO UM\PWL[
SOD\6RXQG
DPRHEDVSHFLILF
VRXQG FRGH
YiXè
gfn\i
(OWWOULDYOUREPRESENTAHOUSECATANDATIGERINAN
INHERITANCESTRUCTURE)SADOMESTICCATASPECIALIZED
VERSIONOFATIGER7HICHWOULDBETHESUBCLASSAND
WHICHWOULDBETHESUPERCLASS/RARETHEYBOTH
SUBCLASSESTOSOMEOTHERCLASS
(OWWOULDYOUDESIGNANINHERITANCESTRUCTURE7HAT
METHODSWOULDBEOVERRIDDEN
4HINKABOUTIT"EFOREYOUTURNTHEPAGE
\RXDUHKHUH
WKHZD\LQKHULWDQFHZRUNV
=VLMZ[\IVLQVO 1VPMZQ\IVKM
?PMV aW] LM[QOV _Q\P QVPMZQ\IVKM aW] X]\ KWUUWV KWLM QV
I KTI[[ IVL \PMV \MTT W\PMZ UWZM [XMKQNQK KTI[[M[ \PI\ \PM
KWUUWV UWZM IJ[\ZIK\ KTI[[ Q[ \PMQZ []XMZKTI[[ ?PMV WVM
KTI[[ QVPMZQ\[ NZWU IVW\PMZ \PM []JKTI[[ QVPMZQ\[ NZWU \PM
[]XMZKTI[[
1V 2IÎ _M [Ia \PI\ \PM []JKTI[[ M`\MVL[ \PM []XMZKTI[[
)V QVPMZQ\IVKM ZMTI\QWV[PQX UMIV[ \PI\ \PM []JKTI[[ QVPMZQ\[
\PM UMUJMZ[ WN \PM []XMZKTI[[ ?PMV _M [Ia ¹UMUJMZ[ WN
I KTI[[º _M UMIV \PM QV[\IVKM ÎZQIJTM[ IVL UM\PWL[
.WZ MÌUXTM QN 8IV\PMZ5IV Q[ I []JKTI[[ WN ;]XMZ0MZW \PM
8IV\PMZ5IV KTI[[ I]\WUI\QKITTa QVPMZQ\[ \PM QV[\IVKM ÎZQIJTM[
IVL UM\PWL[ KWUUWV \W ITT []XMZPMZWM[ QVKT]LQVO

IVL
[W WV *]\ \PM 8IV\PMZ5IV []JKTI[[ KIV ILL VM_
UM\PWL[ IVL QV[\IVKM ÎZQIJTM[ WN Q\[ W_V IVL Q\ KIV
W^MZZQLM \PM UM\PWL[ Q\ QVPMZQ\[ NZWU \PM []XMZKTI[[
;]XMZ0MZW
[]XMZKTI[[ 6XSHU+HUR
UWZM IJ[\ZIK\ VXLW
QV[\IVKM ÎZQIJTM[
WLJKWV
VSHFLDO3RZHU [\I\M I\\ZQJ]\M[
XVH6SHFLDO3RZHU UM\PWL[
SXW2Q6XLW JMPI^QWZ
[]JKTI[[M[
UWZM [XMKQNQK
3DQWKHU0DQ 7^MZZQLQVO
)ULHG(JJ0DQ
XVH6SHFLDO3RZHU UM\PWL[
SXW2Q6XLW
.ZQML-OO5IV LWM[V¼\ VMML IVa JMPI^QWZ \PI\¼[ ]VQY]M

[W PM LWM[V¼\ W^MZZQLM IVa UM\PWL[ <PM UM\PWL[ IVL
QV[\IVKM ÎZQIJTM[ QV ;]XMZ0MZW IZM []NNQKQMV\
8IV\PMZ5IV \PW]OP PI[ [XMKQNQK ZMY]QZMUMV\[ NWZ PQ[ []Q\
IVL [XMKQIT XW_MZ[ [W IVL
IZM JW\P W^MZZQLLMV QV \PM 8IV\PMZ5IV
KTI[[
1V[\IVKM ÎZQIJTM[ IZM VW\ W^MZZQLLMV JMKI][M \PMa
LWV¼\ VMML \W JM <PMa LWV¼\ LMNQVM IVa [XMKQIT JMPI^QWZ [W I
[]JKTI[[ KIV OQ^M IV QVPMZQ\ML QV[\IVKM ÎZQIJTM IVa ÎT]M Q\
KPWW[M[ 8IV\PMZ5IV KIV [M\ PQ[ QVPMZQ\ML
\W
X]ZXTM _PQTM .ZQML-OO5IV [M\[ PQ[ \W _PQ\M
FKDSWHU
)VQVPMZQ\IVKMMÌUXTM" ,LQKHULWHGP\
SXEOLFFODVV'RFWRU^ SURFHGXUHVVR,GLGQ·W
ERWKHUZLWKPHGLFDOVFKRRO
ERROHDQZRUNV$W+RVSLWDO 5HOD[WKLVZRQ·WKXUWDELW
QRZZKHUHGLG,SXWWKDW
YRLGWUHDW3DWLHQW^ SRZHUVDZ
SHUIRUPDFKHFNXS
`
`
SXEOLFFODVV)DPLO\'RFWRUH[WHQGV'RFWRU^
ERROHDQPDNHV+RXVH&DOOV
YRLGJLYH$GYLFH^
JLYHKRPHVSXQDGYLFH
`
SXEOLFFODVV6XUJHRQH[WHQGV'RFWRU^

YRLGWUHDW3DWLHQW^
SHUIRUPVXUJHU\
`
YRLGPDNH,QFLVLRQ^
PDNHLQFLVLRQ\LNHV
`
`
6KDUSHQ \RXU SHQFLO

[]XMZKTI[[
'RFWRU
+RZPDQ\LQVWDQFHYDULDEOHVGRHV
ZRUNV$W+RVSLWDO WVM QV[\IVKM ÎZQIJTM 6XUJHRQKDYH"
WUHDW3DWLHQW WVM UM\PWL +RZPDQ\LQVWDQFHYDULDEOHVGRHV
)DPLO\'RFWRUKDYH"
+RZPDQ\PHWKRGVGRHV'RFWRUKDYH"
[]JKTI[[M[ +RZPDQ\PHWKRGVGRHV6XUJHRQKDYH"
+RZPDQ\PHWKRGVGRHV)DPLO\'RFWRU
6XUJHRQ )DPLO\'RFWRU
$GGV RQH QHZ KDYH"
2YHUULGHV WKH LQKHULWHG PDNHV+RXVH&DOOV
LQVWDQFH YDULDEOH
WUHDW3DWLHQW PHWKRG WUHDW3DWLHQW &DQD)DPLO\'RFWRUGRWUHDW3DWLHQW"
JLYH$GYLFH $GGV RQH QHZ PHWKRG
$GGV RQH QHZ PHWKRG PDNH,QFLVLRQ &DQD)DPLO\'RFWRUGRPDNH,QFLVLRQ"
\RXDUHKHUH
GHVLJQLQJIRULQKHULWDQFH
4M\¼[LM[QOV\PMQVPMZQ\IVKM\ZMMNWZ
IV)VQUIT[QU]TI\QWVXZWOZIU
)MAGINEYOUREASKEDTODESIGNASIMULATIONPROGRAMTHAT
LETSTHEUSERTHROWABUNCHOFDIFFERENTANIMALSINTOAN
ENVIRONMENTTOSEEWHATHAPPENS7EDONTHAVETOCODETHE
THINGNOWWEREMOSTLYINTERESTEDINTHEDESIGN
7EVEBEENGIVENALISTOFSOMEOFTHEANIMALSTHATWILLBE
INTHEPROGRAMBUTNOTALL7EKNOWTHATEACHANIMALWILL
BEREPRESENTEDBYANOBJECTANDTHATTHEOBJECTSWILLMOVE
AROUNDINTHEENVIRONMENTDOINGWHATEVERITISTHATEACH
PARTICULARTYPEISPROGRAMMEDTODO
!NDWEWANTOTHERPROGRAMMERSTOBEABLETOADDNEW
KINDSOFANIMALSTOTHEPROGRAMATANYTIME
&IRSTWEHAVETOlGUREOUTTHECOMMONABSTRACT
CHARACTERISTICSTHATALLANIMALSHAVEANDBUILDTHOSE
CHARACTERISTICSINTOACLASSTHATALLANIMALCLASSESCANEXTEND
/RRNIRUREMHFWVWKDWKDYHFRPPRQ
DWWULEXWHVDQGEHKDYLRUV
:KDWGRWKHVHVL[W\SHVKDYHLQ
FRPPRQ"7KLVKHOSV\RXWRDEVWUDFW
RXWEHKDYLRUVVWHS
+RZDUHWKHVHW\SHVUHODWHG"7KLV
KHOSV\RXWRGHÀQHWKHLQKHULWDQFH
WUHHUHODWLRQVKLSVVWHS
FKDSWHU
=[QVOQVPMZQ\IVKM\WI^WQL
L]XTQKI\QVOKWLMQV[]JKTI[[M[
7EHAVElVEINSTANCEVARIABLES
PICTUREnTHElLENAMEREPRESENTINGTHE*0%'OFTHISANIMAL 'HVLJQDFODVVWKDWUHSUHVHQWV
FOODnTHETYPEOFFOODTHISANIMALEATS2IGHTNOWTHERE WKHFRPPRQVWDWHDQGEHKDYLRU
CANBEONLYTWOVALUESMEATORGRASS
7KHVHREMHFWVDUHDOODQLPDOVVR
HUNGERnANINTREPRESENTINGTHEHUNGERLEVELOFTHEANIMAL ZH·OOPDNHDFRPPRQVXSHUFODVV
)TCHANGESDEPENDINGONWHENANDHOWMUCH THE FDOOHG$QLPDO
ANIMALEATS :H·OOSXWLQPHWKRGVDQGLQVWDQFH
BOUNDARIESnVALUESREPRESENTINGTHEHEIGHTANDWIDTHOF YDULDEOHVWKDWDOODQLPDOVPLJKW
THE@SPACEFOREXAMPLEX THATTHEANIMALSWILL QHHG
ROAMAROUNDIN
LOCATIONnTHE8AND9COORDINATESFORWHERETHEANIMALIS $QLPDO
INTHESPACE
SLFWXUH
7EHAVEFOURMETHODS IRRG
KXQJHU
MAKE.OISE nBEHAVIORFORWHENTHEANIMALISSUPPOSEDTO
ERXQGDULHV
MAKENOISE ORFDWLRQ
EAT nBEHAVIORFORWHENTHEANIMALENCOUNTERSITS
PREFERREDFOODSOURCEMEATORGRASS PDNH1RLVH
HDW
SLEEP nBEHAVIORFORWHENTHEANIMALISCONSIDEREDASLEEP VOHHS
ROAM nBEHAVIORFORWHENTHEANIMALISNOTEATINGOR URDP
SLEEPINGPROBABLYJUSTWANDERINGAROUNDWAITINGTOBUMP
INTOAFOODSOURCEORABOUNDARY
/LRQ
VL]H
SLFWXUH :ROI
IRRG VL]H
SUH\ SLFWXUH
IRRG
&DW
SUH\
7LJHU
+LSSR VL]H
VL]H SLFWXUH
VL]H SLFWXUH 'RJ IRRG
SLFWXUH IRRG VL]H SUH\
IRRG SUH\ SLFWXUH
SUH\
IRRG
SUH\
\RXDUHKHUH
,WITTIVQUIT[MI\\PM[IUM_Ia'
!SSUMETHATWEALLAGREEONONETHINGTHEINSTANCE
VARIABLESWILLWORKFORALL!NIMALTYPES!LIONWILL
HAVEHISOWNVALUEFORPICTUREFOODWERETHINKING
MEAT HUNGERBOUNDARIESANDLOCATION!HIPPO
WILLHAVEDIFFERENTVALUESFORHISINSTANCEVARIABLES
'HFLGHLIDVXEFODVV
BUTHELLSTILLHAVETHESAMEVARIABLESTHATTHEOTHER QHHGVEHKDYLRUVPHWKRG
!NIMALTYPESHAVE3AMEWITHDOGTIGERANDSOON
"UTWHATABOUTBEHAVIOR LPSOHPHQWDWLRQVWKDWDUHVSHFLÀF
WRWKDWSDUWLFXODUVXEFODVVW\SH
?PQKPUM\PWL[[PW]TL_MW^MZZQLM' /RRNLQJDWWKH$QLPDOFODVV
ZHGHFLGHWKDWHDWDQG
Licensed by
$OESALIONMAKETHESAMENOISEASADOG$OES PDNH1RLVHVKRXOGEHRYHUULGGHQ
ACATEATLIKEAHIPPO-AYBEINYOURVERSIONBUT E\WKHLQGLYLGXDOVXEFODVVHV
INOURSEATINGANDMAKINGNOISEARE!NIMAL TYPE
SPECIlC7ECANTlGUREOUTHOWTOCODETHOSE
METHODSINSUCHAWAYTHATTHEYDWORKFORANY
Eduard Simons
ANIMAL/+THATSNOTTRUE7ECOULDWRITETHE
MAKE.OISE METHODFOREXAMPLESOTHATALLITDOES
ISPLAYASOUNDlLEDElNEDINANINSTANCEVARIABLE
,QWKHGRJ
FORTHATTYPEBUTTHATSNOTVERYSPECIALIZED3OME
ANIMALSMIGHTMAKEDIFFERENTNOISES FRPPXQLW\EDUNLQJLVDQ
104038
FORDIFFERENTSITUATIONSLIKEONE LPSRUWDQWSDUWRIRXUFXOWXUDO
FOREATINGANDANOTHERWHEN ,·PRQHEDG VV LGHQWLW\:HKDYHDXQLTXHVRXQG
BUMPINGINTOANENEMYETC SODQWHDWHU DQGZHZDQWWKDWGLYHUVLW\WR
EHUHFRJQL]HGDQGUHVSHFWHG
3OJUSTASWITHTHE!MOEBA
OVERRIDINGTHE3HAPECLASSROTATE
METHODTOGETMOREAMOEBA SPECIlCIN
OTHERWORDSUNIQUE BEHAVIORWELLHAVE
TODOTHESAMEFOROUR!NIMALSUBCLASSES
$QLPDO
SLFWXUH
IRRG
KXQJHU
ERXQGDULHV WKHVHWZRPHWKRGV\SHDHFWDQ
:HEHWWHURYHUULGHRW WH DFK DQ LPD OW
ORFDWLRQ
DQGPDNH1RLVHV LILKD HKDYLRUIRUHDWLQJDQGG
GHILQHLWVRZQVSHFRZFE ORRNVOLNHVOHHSDQ
PDNH1RLVH
PDNLQJQRLVH)RUQQHULW
HDW
VOHHS
URDPFDQVWD\JH LF
URDP
FKDSWHU
4WWSQVONWZUWZMQVPMZQ\IVKM
WXXWZ\]VQ\QM[
4HECLASSHIERARCHYISSTARTINGTOSHAPEUP7E /RRNIRUPRUHRSSRUWXQLWLHVWRXVH
HAVEEACHSUBCLASSOVERRIDETHEMAKE.OISE AND DEVWUDFWLRQE\ÀQGLQJWZRRUPRUH
EAT METHODSSOTHATTHERESNOMISTAKINGA$OG VXEFODVVHVWKDWPLJKWQHHGFRPPRQ
BARKFROMA#ATMEOWQUITEINSULTINGTOBOTH EHKDYLRU
PARTIES !NDA(IPPOWONTEATLIKEA,ION
:HORRNDWRXUFODVVHVDQGVHH
"UTPERHAPSTHERESMOREWECANDO7EHAVETO
WKDW:ROIDQG'RJPLJKWKDYHVRPH
LOOKATTHESUBCLASSESOF!NIMALANDSEEIFTWO EHKDYLRULQFRPPRQDQGWKHVDPHJRHV
ORMORECANBEGROUPEDTOGETHERINSOMEWAY IRU/LRQ7LJHUDQG&DW
ANDGIVENCODETHATSCOMMONTOONLYTHATNEW
GROUP7OLFAND$OGHAVESIMILARITIES3ODO
,ION4IGERAND#AT
$QLPDO
SLFWXUH
IRRG
KXQJHU
ERXQGDULHV
ORFDWLRQ
PDNH1RLVH
HDW
VOHHS
Q
H ULI/LRKDYH URDP :ROIDQG R
,Z R Q G XOG PD\EHWKH' JDUHERWKF
+PPPUDQG&DWZPR RQ DQLQ
%27+FODVVUHH·VVRPHWKLQJWKDWHV
H
7LJ WKLQJLQFR P VFRXOGXVH
VRPH
/LRQ
VL]H
SLFWXUH :ROI
IRRG
PDNH1RLVH VL]H
SUH\
HDW SLFWXUH
IRRG
PDNH1RLVH
&DW
SUH\
HDW
7LJHU
+LSSR VL]H
VL]H SLFWXUH
VL]H SLFWXUH 'RJ IRRG
PDNH1RLVH
SLFWXUH IRRG
PDNH1RLVH VL]H SUH\
HDW
IRRG
PDNH1RLVH SUH\
HDW SLFWXUH
SUH\
HDW IRRG
PDNH1RLVH
SUH\
HDW
\RXDUHKHUH
)LQLVKWKHFODVVKLHUDUFK\
6LQFHDQLPDOVDOUHDG\KDYHDQRUJDQL]DWLRQDO $QLPDO
KLHUDUFK\WKHZKROHNLQJGRPJHQXVSK\OXP
WKLQJZHFDQXVHWKHOHYHOWKDWPDNHVWKHPRVW SLFWXUH
VHQVHIRUFODVVGHVLJQ:H·OOXVHWKHELRORJLFDO IRRG
ÍDPLOLHVµWRRUJDQL]HWKHDQLPDOVE\PDNLQJD KXQJHU
)HOLQHFODVVDQGD&DQLQHFODVV ERXQGDULHV
ORFDWLRQ
:HGHFLGHWKDW&DQLQHVFRXOGXVHDFRPPRQ
URDPPHWKRGEHFDXVHWKH\WHQGWRPRYHLQ
PDNH1RLVH
SDFNV:HDOVRVHHWKDW)HOLQHVFRXOGXVHD HDW
FRPPRQURDPPHWKRGEHFDXVHWKH\WHQGWR VOHHS
DYRLGRWKHUVRIWKHLURZQNLQG:H·OOOHW+LSSR URDP
FRQWLQXHWRXVHLWVLQKHULWHGURDPPHWKRG³
WKHJHQHULFRQHLWJHWVIURP$QLPDO
6RZH·UHGRQHZLWKWKHGHVLJQIRUQRZZH·OO
FRPHEDFNWRLWODWHULQWKHFKDSWHU
)HOLQH
&DQLQH
URDP
+LSSR
URDP
VL]H
SLFWXUH
IRRG
PDNH1RLVH
SUH\
HDW
/LRQ
VL]H
SLFWXUH
IRRG
PDNH1RLVH
SUH\
HDW
'RJ
&DW
VL]H
VL]H SLFWXUH
7LJHU
SLFWXUH IRRG
PDNH1RLVH
VL]H IRRG :ROI SUH\
PDNH1RLVH HDW
SLFWXUH SUH\
HDW VL]H
IRRG
PDNH1RLVH
SUH\ SLFWXUH
HDW IRRG
PDNH1RLVH
SUH\
HDW
FKDSWHU
?PQKPUM\PWLQ[KITTML'
4HE7OLFCLASSHASFOURMETHODS/NE
INHERITEDFROM!NIMALONEINHERITEDFROM
#ANINEWHICHISACTUALLYANOVERRIDDEN
VERSIONOFAMETHODINCLASS!NIMAL AND
TWOOVERRIDDENINTHE7OLFCLASS7HEN
YOUCREATEA7OLFOBJECTANDASSIGNITTO
AVARIABLEYOUCANUSETHEDOTOPERATOR
ONTHATREFERENCEVARIABLETOINVOKEALL
$QLPDO
FOURMETHODS"UTWHICHVERSIONOFTHOSE
METHODSGETSCALLED PDNH1RLVH
HDW
VOHHS
URDP
PDNHDQHZ:ROIREMHFW :ROIZ QHZ:ROI
FDOOVWKHYHUVLRQLQ:ROI ZPDNH1RLVH
ZURDP &DQLQH
FDOOVWKHYHUVLRQLQ&DQLQH
URDP
FDOOVWKHYHUVLRQLQ:ROI ZHDW
FDOOVWKHYHUVLRQLQ$QLPDO ZVOHHS
7HENYOUCALLAMETHODONANOBJECT
:ROI
REFERENCEYOURECALLINGTHEMOSTSPECIlC
VL]H
VERSIONOFTHEMETHODFORTHATOBJECTTYPE PDNH1RLVH
SLFWXUH
HDW
IRRG
)NOTHERWORDSTHELOWESTONEWINS
SUH\
h,OWESTvMEANINGLOWESTONTHE
INHERITANCETREE#ANINEISLOWERTHAN
!NIMALAND7OLFISLOWERTHAN#ANINE
SOINVOKINGAMETHODONAREFERENCE
TOA7OLFOBJECTMEANSTHE*6-STARTS
LOOKINGlRSTINTHE7OLFCLASS)FTHE*6-
DOESNTlNDAVERSIONOFTHEMETHODIN
THE7OLFCLASSITSTARTSWALKINGBACKUP
THEINHERITANCEHIERARCHYUNTILITlNDSA
MATCH
\RXDUHKHUH
SUDFWLFHGHVLJQLQJDQLQKHULWDQFHWUHH
<QJ[YNW bX^[ YNWLRU

'UDZDQLQKHULWDQFHGLDJUDPKHUH
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: 9OUSAIDTHATTHE*6-STARTS A: 'OODQUESTION"UTYOUDONT 7HERETHEINHERITEDMETHODISDEFINED
WALKINGUPTHEINHERITANCETREE HAVETOWORRYABOUTTHAT4HECOMPILER INOTHERWORDSINWHICHSUPERCLASS
STARTINGATTHECLASSTYPEYOUINVOKED GUARANTEESTHATAPARTICULARMETHOD ITISDEFINED MAKESNODIFFERENCETO
THEMETHODONLIKETHE7OLFEXAMPLE ISCALLABLEFORASPECIFICREFERENCETYPE THECOMPILER"UTATRUNTIMETHE*6-
ONTHEPREVIOUSPAGE "UTWHAT BUTITDOESNTSAYORCARE FROMWHICH WILLALWAYSPICKTHERIGHTONE!ND
HAPPENSIFTHE*6-DOESNTEVERlND CLASSTHATMETHODACTUALLYCOMESFROM THERIGHTONEMEANSTHEMOSTSPECIFIC
AMATCH ATRUNTIME7ITHTHE7OLFEXAMPLETHE VERSIONFORTHATPARTICULAROBJECT
COMPILERCHECKSFORASLEEP METHOD
BUTDOESNTCARETHATSLEEP ISACTUALLY
DEFINEDINANDINHERITEDFROM CLASS
!NIMAL2EMEMBERTHATIFACLASS
INHERITSAMETHODITHASTHEMETHOD
FKDSWHU
=[QVO1;)IVL0);)
2EMEMBERTHATWHENONECLASS
INHERITSFROMANOTHERWESAYTHATTHE
SUBCLASSEXTENDSTHESUPERCLASS7HEN
YOUWANTTOKNOWIFONETHINGSHOULD
EXTENDANOTHERAPPLYTHE)3 !TEST
4RIANGLE)3 !3HAPEYEAHTHATWORKS 'RHV LW PDNH VHQVH WR
#AT)3 !&ELINETHATWORKSTOO VD\D7XE,6$%DWKURRP"2UD
3URGEON)3 !$OCTORSTILLGOOD %DWKURRP,6$7XE":HOOLWGRHVQ·WWR
4UBEXTENDS"ATHROOMSOUNDS PH7KHUHODWLRQVKLSEHWZHHQP\7XE

REASONABLE DQGP\%DWKURRPLV+$6$%DWKURRP
5NTILYOUAPPLYTHE)3 !TEST +$6$7XE7KDWPHDQV%DWKURRP
4OKNOWIFYOUVEDESIGNEDYOURTYPES K D VD7XELQVWDQFHYDULDEOH
CORRECTLYASKh$OESITMAKESENSETO
SAYTYPE8)3 !TYPE9v)FITDOESNT
YOUKNOWTHERESSOMETHINGWRONG
WITHTHEDESIGNSOIFWEAPPLYTHE)3 !
TEST4UB)3 !"ATHROOMISDElNITELY
FALSE
7HATIFWEREVERSEITTO"ATHROOM
EXTENDS4UB4HATSTILLDOESNTWORK
"ATHROOM)3 !4UBDOESNTWORK
4UBAND"ATHROOMARERELATEDBUT
NOTTHROUGHINHERITANCE4UBAND
"ATHROOMAREJOINEDBYA(!3 !
RELATIONSHIP$OESITMAKESENSETO
SAYh"ATHROOM(!3 !4UBv)FYES
THENITMEANSTHAT"ATHROOMHASA
4UBINSTANCEVARIABLE)NOTHERWORDS
"ATHROOMHASAREFERENCETOA4UBBUT
"ATHROOMDOESNOTEXTEND4UBAND
VICE VERSA
7XE
LQWVL]H
%DWKURRP %XEEOHVE
7XEEDWKWXE %XEEOHV
6LQNWKH6LQN
LQWUDGLXV
LQWFRORU$PW
%DWKURRP+$6$7XEDQG7XE+$6$%XEEOHV
%XWQRERG\LQKHULWVIURPH[WHQGVDQ\ERG\HOVH
\RXDUHKHUH
H[SORLWLQJWKHSRZHURI REMHFWV
*]\_IQ\ <PMZM¼[UWZM
4HE)3 !TESTWORKSANYWHEREINTHEINHERITANCETREE)FYOUR
INHERITANCETREEISWELL DESIGNEDTHE)3 !TESTSHOULDMAKE
SENSEWHENYOUASKANYSUBCLASSIFIT)3 !ANYOFITSSUPERTYPES
,IFODVV%H[WHQGVFODVV$FODVV%,6$FODVV$
7KLVLVWUXHDQ\ZKHUHLQWKHLQKHULWDQFHWUHH,I
FODVV&H[WHQGVFODVV%FODVV&SDVVHVWKH,6$
WHVWIRUERWK%DQG$
&DQLQHH[WHQGV$QLPDO $QLPDO 7ITHANINHERITANCETREELIKETHE

ONESHOWNHEREYOUREALWAYS
:ROIH[WHQGV&DQLQH PDNH1RLVH ALLOWEDTOSAYh7OLFEXTENDS
HDW !NIMALvORh7OLF)3 !!NIMALv
:ROIH[WHQGV$QLPDO VOHHS
URDP
)TMAKESNODIFFERENCEIF!NIMAL
ISTHESUPERCLASSOFTHESUPERCLASS
OF7OLF)NFACTASLONGAS!NIMAL
&DQLQH,6$$QLPDO ISSOMEWHEREINTHEINHERITANCE
HIERARCHYABOVE7OLF7OLF)3 !
:ROI,6$&DQLQH !NIMALWILLALWAYSBETRUE
&DQLQH
:ROI,6$$QLPDO 4HESTRUCTUREOFTHE!NIMAL
INHERITANCETREESAYSTOTHEWORLD
URDP
h7OLF)3 !#ANINESO7OLFCANDO
ANYTHINGA#ANINECANDO!ND
7OLF)3 !!NIMALSO7OLFCANDO
ANYTHINGAN!NIMALCANDOv
)TMAKESNODIFFERENCEIF7OLF
OVERRIDESSOMEOFTHEMETHODS
:ROI IN!NIMALOR#ANINE!SFARAS
VL]H
THEWORLDOFOTHERCODE IS
PDNH1RLVH
SLFWXUH CONCERNEDA7OLFCANDOTHOSE
HDW
IRRG FOURMETHODS(OWHEDOESTHEM
SUH\ ORINWHICHCLASSTHEYREOVERRIDDEN
MAKESNODIFFERENCE!7OLFCAN
MAKE.OISE EAT SLEEP AND
ROAM BECAUSEA7OLFEXTENDS
FROMCLASS!NIMAL
FKDSWHU
LFN
0DNH LW 6W
E
TSAREBLU RUE
SE S A RE REDVIOLE HEREVERSEISNTT
2O H A P E T
S A3
3QUAREI AR
TSAREDE BEER
S A RE R EDVIOLE RINKSARE
2OSE B U T NOTALLD
0W_LWaW]SVW_QNaW]¼^MOW\ "EERIS A
$RI N K
N E T H A
HEONE
TSHOWST MBERIF
KEO ME
TURN-A NSHIP2E
aW]ZQVPMZQ\IVKMZQOP\' /+YOUR FTHE)3 !RELATIO KESENSE
S O M A
WAY NES !9MU
ST
DS98)3
4HERESOBVIOUSLYMORETOITTHANWHATWEVE 8EX TEN
COVEREDSOFARBUTWELLLOOKATALOTMORE//
ISSUESINTHENEXTCHAPTERWHEREWEEVENTUALLY
RElNEANDIMPROVEONSOMEOFTHEDESIGNWORK
WEDIDINTHISCHAPTER
&ORNOWTHOUGHAGOODGUIDELINEISTOUSETHE
<QJ[YNW bX^[ YNWLRU
)3 !TEST)Fh8)3 !9vMAKESSENSEBOTHCLASSES
8AND9 SHOULDPROBABLYLIVEINTHESAME 3XW D FKHFN QH[W WR WKH UHODWLRQVKLSV WKDW
INHERITANCEHIERARCHY#HANCESARETHEYHAVE PDNH VHQVH
THESAMEOROVERLAPPINGBEHAVIORS
2YHQ H[WHQGV .LWFKHQ
.HHSLQPLQGWKDWWKH
LQKHULWDQFH,6$UHODWLRQVKLS *XLWDU H[WHQGV ,QVWUXPHQW
ZRUNVLQRQO\RQHGLUHFWLRQ 3HUVRQ H[WHQGV (PSOR\HH
4RIANGLE)3 !3HAPEMAKESSENSESOYOUCAN
)HUUDUL H[WHQGV (QJLQH
HAVE4RIANGLEEXTEND3HAPE
"UTTHEREVERSE3HAPE)3 !4RIANGLEDOES )ULHG(JJ H[WHQGV )RRG
NOTMAKESENSESO3HAPESHOULDNOTEXTEND %HDJOH H[WHQGV 3HW
4RIANGLE2EMEMBERTHATTHE)3 !RELATIONSHIP
IMPLIESTHATIF8)3 !9THEN8CANDOANYTHING &RQWDLQHU H[WHQGV -DU
A9CANDOANDPOSSIBLYMORE
0HWDO H[WHQGV 7LWDQLXP
*UDWHIXO'HDG H[WHQGV %DQG
%ORQGH H[WHQGV 6PDUW
%HYHUDJH H[WHQGV 0DUWLQL
+LQW DSSO\ WKH ,6$ WHVW
\RXDUHKHUH
ZKRLQKHULWVZKDW
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: 3OWESEEHOWASUBCLASSGETS Q: )NASUBCLASSWHATIF)WANTTO
TOINHERITASUPERCLASSMETHODBUT 9OUCANDESIGNYOURSUPERCLASS
USE"/4(THESUPERCLASSVERSIONAND
WHATIFTHESUPERCLASSWANTSTOUSE METHODSINSUCHAWAYTHATTHEY
MYOVERRIDINGSUBCLASSVERSIONOFA
THESUBCLASSVERSIONOFTHEMETHOD CONTAINMETHODIMPLEMENTATIONS
METHOD)NOTHERWORDS)DONTWANT
THATWILLWORKFORANYSUBCLASSEVEN
TOCOMPLETELYREPLACETHESUPERCLASS
THOUGHTHESUBCLASSESMAYSTILLNEED
A: !SUPERCLASSWONTNECESSARILY
KNOWABOUTANYOFITSSUBCLASSES
VERSION)JUSTWANTTOADDMORESTUFF
TOIT
TO@APPENDMORECODE)NYOURSUBCLASS
OVERRIDINGMETHODYOUCANCALLTHE
9OUMIGHTWRITEACLASSANDMUCH SUPERCLASSVERSIONUSINGTHEKEYWORD
LATERSOMEONEELSECOMESALONGAND
EXTENDSIT"UTEVENIFTHESUPERCLASS
A: 9OUCANDOTHIS!NDITSAN
IMPORTANTDESIGNFEATURE4HINKOFTHE
VXSHU)TSLIKESAYINGhFIRSTGORUNTHE
SUPERCLASSVERSIONTHENCOMEBACKAND
CREATORDOESKNOWABOUTANDWANTS FINISHWITHMYOWNCODEv
WORDhEXTENDSvASMEANINGh)WANT
TOUSE ASUBCLASSVERSIONOFAMETHOD
TOEXTENDTHEFUNCTIONALITYOFTHE
RI
WKLVFDOOVWKHLQKHULWHGYHUVLRQ
THERESNOSORTOFREVERSEORBACKWARDS
SUPERCLASSv
INHERITANCE4HINKABOUTITCHILDREN
INHERITFROMPARENTSNOTTHEOTHERWAY
SXEOLFYRLGURDP^
URDPWKHQFRPHVE DFN WRGR
\RXURZQVXEFODVVVSHFLILFFRGH
VXSHUURDP
AROUND
P\RZQURDPVWXII
`
?PW OM\[ \PM 8WZ[KPM _PW OM\[ \PM XWZKMTIQV' )KKM[[ TM^MT[ KWV\ZWT _PW [MM[ _PI\ IVL IZM KZ]KQIT
PW_ \W SVW_ _PI\ I []JKTI[[ KIV
PW_\WSVW__PI\I[]JKTI[[KIV \W PI^QVO _MTTLM[QOVML ZWJ][\ 2IÎ KWLM .WZ VW_ _M¼TT
QVPMZQ\NZWUQ\[[]XMZKTI[[
QVPMZQ\ NZWU Q\¼[ []XMZKTI[[ NWK][ R][\ WV X]JTQK IVL XZQÎ\M <PM Z]TM[ IZM [QUXTM NWZ
\PW[M \_W"
) []JKTI[[ QVPMZQ\[ UMUJMZ[ WN \PM SXEOLF PHPEHUV DUH LQKHULWHG
[]XMZKTI[[ 5MUJMZ[ QVKT]LM QV[\IVKM SULYDWH PHPEHUV DUH QRW LQKHULWHG
ÎZQIJTM[ IVL UM\PWL[ IT\PW]OP TI\MZ QV
\PQ[ JWWS _M¼TT TWWS I\ W\PMZ QVPMZQ\ML UMUJMZ[ )
[]XMZKTI[[ KIV KPWW[M _PM\PMZ WZ VW\ Q\ _IV\[ I ?PMV I []JKTI[[ QVPMZQ\[ I UMUJMZ Q\ Q[ I[ QN \PM
[]JKTI[[ \W QVPMZQ\ I XIZ\QK]TIZ UMUJMZ Ja \PM TM^MT WN []JKTI[[ LMNQVML \PM UMUJMZ Q\[MTN 1V \PM ;PIXM
IKKM[[ \PM XIZ\QK]TIZ UMUJMZ Q[ OQ^MV MÌUXTM ;Y]IZM QVPMZQ\ML \PM IVL

UM\PWL[ IVL \W \PM W]\[QLM _WZTL W\PMZ
<PMZM IZM NW]Z IKKM[[ TM^MT[ \PI\ _M¼TT KW^MZ QV \PQ[ JWWS KWLM \PM ;Y]IZM KTI[[ [QUXTa PI[ I IVL
5W^QVO NZWU UW[\ ZM[\ZQK\Q^M \W TMI[\ \PM NW]Z IKKM[[
UM\PWL
TM^MT[ IZM" <PM UMUJMZ[ WN I KTI[[ QVKT]LM \PM ÎZQIJTM[ IVL
SULYDWH GHIDXOW SURWHFWHG SXEOLF UM\PWL[ LMNQVML QV \PM KTI[[ XT][ IVa\PQVO QVPMZQ\ML
NZWU I []XMZKTI[[
1RWHJHWPRUHGHWDLOVDERXWGHIDXOWDQGSURWHFWHGLQFKDSWHU
GHSOR\PHQWDQGDSSHQGL[%
FKDSWHU
?PMVLM[QOVQVO_Q\PQVPMZQ\IVKM
IZMaW]][QVOWZIJ][QVO'
!LTHOUGHSOMEOFTHEREASONSBEHINDTHESERULESWONTBE
REVEALEDUNTILLATERINTHISBOOKFORNOWSIMPLYKNOWINGA
FEWRULESWILLHELPYOUBUILDABETTERINHERITANCEDESIGN
'2USEINHERITANCEWHENONECLASSISAMORESPECIlCTYPE
OFASUPERCLASS%XAMPLE7ILLOWISAMORESPECIlCTYPEOF
4REESO7ILLOWEXTENDS4REEMAKESSENSE
'2CONSIDERINHERITANCEWHENYOUHAVEBEHAVIOR :MDD=LHGAFLK
IMPLEMENTEDCODE THATSHOULDBESHAREDAMONG $VXEFODVVH[WHQGVDVXSHUFODVV
MULTIPLECLASSESOFTHESAMEGENERALTYPE%XAMPLE
3QUARE#IRCLEAND4RIANGLEALLNEEDTOROTATEANDPLAY $VXEFODVVLQKHULWVDOOSXEOLFLQVWDQFH
SOUNDSOPUTTINGTHATFUNCTIONALITYINASUPERCLASS3HAPE YDULDEOHVDQGPHWKRGVRIWKHVXSHUFODVVEXW
MIGHTMAKESENSEANDMAKESFOREASIERMAINTENANCEAND GRHVQRWLQKHULWWKHSULYDWHLQVWDQFHYDULDEOHV
EXTENSIBILITY"EAWAREHOWEVERTHATWHILEINHERITANCEIS DQGPHWKRGVRIWKHVXSHUFODVV
ONEOFTHEKEYFEATURESOFOBJECT ORIENTEDPROGRAMMING ,QKHULWHGPHWKRGVFDQEHRYHUULGGHQLQVWDQFH
ITSNOTNECESSARILYTHEBESTWAYTOACHIEVEBEHAVIORREUSE YDULDEOHVFDQQRWEHRYHUULGGHQDOWKRXJKWKH\
)TLLGETYOUSTARTEDANDOFTENITSTHERIGHTDESIGNCHOICE FDQEHUHGHILQHGLQWKHVXEFODVVEXWWKDW·V
BUTDESIGNPATTERNSWILLHELPYOUSEEOTHERMORESUBTLE QRWWKHVDPHWKLQJDQGWKHUH·VDOPRVWQHYHUD
ANDmEXIBLEOPTIONS)FYOUDONTKNOWABOUTDESIGN QHHGWRGRLW
PATTERNSAGOODFOLLOW ONTOTHISBOOKWOULDBE(EAD&IRST
$ESIGN0ATTERNS 8VHWKH,6$WHVWWRYHULI\WKDW\RXU
LQKHULWDQFHKLHUDUFK\LVYDOLG,I;H[WHQGV<
WKHQ;,6$<PXVWPDNHVHQVH
'2127USEINHERITANCEJUSTSOTHATYOUCANREUSE
CODEFROMANOTHERCLASSIFTHERELATIONSHIPBETWEENTHE 7KH,6$UHODWLRQVKLSZRUNVLQRQO\RQH
SUPERCLASSANDSUBCLASSVIOLATEEITHEROFTHEABOVETWO GLUHFWLRQ$+LSSRLVDQ$QLPDOEXWQRWDOO
RULES&OREXAMPLEIMAGINEYOUWROTESPECIALPRINTING $QLPDOVDUH+LSSRV
CODEINTHE!LARMCLASSANDNOWYOUNEEDPRINTINGCODE :KHQDPHWKRGLVRYHUULGGHQLQDVXEFODVV
INTHE0IANOCLASSSOYOUHAVE0IANOEXTEND!LARMSOTHAT DQGWKDWPHWKRGLVLQYRNHGRQDQLQVWDQFHRI
0IANOINHERITSTHEPRINTINGCODE4HATMAKESNOSENSE! WKHVXEFODVVWKHRYHUULGGHQYHUVLRQRIWKH
0IANOISNOTAMORESPECIlCTYPEOF!LARM3OTHEPRINTING PHWKRGLVFDOOHG7KHORZHVWRQHZLQV
CODESHOULDBEINA0RINTERCLASSTHATALLPRINTABLEOBJECTS
CANTAKEADVANTAGEOFVIAA(!3 !RELATIONSHIP ,IFODVV%H[WHQGV$DQG&H[WHQGV%FODVV
%,6$FODVV$DQGFODVV&,6$FODVV%DQG
FODVV&DOVR,6$FODVV$
'2127USEINHERITANCEIFTHESUBCLASSANDSUPERCLASS
DONOTPASSTHE)3 !TEST!LWAYSASKYOURSELFIFTHESUBCLASS
)3 !MORESPECIlCTYPEOFTHESUPERCLASS%XAMPLE4EA)3
!"EVERAGEMAKESSENSE"EVERAGE)3 !4EADOESNOT
\RXDUHKHUH
H[SORLWLQJWKHSRZHURI REMHFWV
;W_PI\LWM[ITT\PQ[
QVPMZQ\IVKMZMITTaJ]aaW]'
9OUGETALOTOF//MILEAGEBYDESIGNING
WITHINHERITANCE9OUCANGETRIDOFDUPLICATE
CODEBYABSTRACTINGOUTTHEBEHAVIORCOMMON
TOAGROUPOFCLASSESANDSTICKINGTHATCODE
<RXDYRLGGXSOLFDWH
INASUPERCLASS4HATWAYWHENYOUNEEDTO
MODIFYITYOUHAVEONLYONEPLACETOUPDATE FRGH
ANDTHECHANGEISMAGICALLYREmECTEDINALLTHE 3XWFRPPRQFRGHLQRQHSODFHDQGOHW
CLASSESTHATINHERITTHATBEHAVIOR7ELLTHERES WKHVXEFODVVHVLQKHULWWKDWFRGHIURPD
NOMAGICINVOLVEDBUTITISPRETTYSIMPLE
VXSHUFODVV:KHQ\RXZDQWWRFKDQJHWKDW
Licensed by
MAKETHECHANGEANDCOMPILETHECLASS
AGAIN4HATSIT9OUDONTHAVETOTOUCHTHE EHKDYLRU\RXKDYHWRPRGLI\LWLQRQO\
SUBCLASSES RQHSODFHDQGHYHU\ERG\HOVHLHDOOWKH
VXEFODVVHVVHHWKHFKDQJH
*USTDELIVERTHENEWLY CHANGEDSUPERCLASSAND
Eduard Simons
ALLCLASSESTHATEXTENDITWILLAUTOMATICALLYUSE
THENEWVERSION <RXGHÀQHDFRPPRQ
!*AVAPROGRAMISNOTHINGBUTAPILEOFCLASSES SURWRFROIRUDJURXSRI
SOTHESUBCLASSESDONTHAVETOBERECOMPILED
INORDERTOUSETHENEWVERSIONOFTHE
FODVVHV
104038
SUPERCLASS!SLONGASTHESUPERCLASSDOESNT 8PZKDW
BREAKANYTHINGFORTHESUBCLASSEVERYTHINGS WKHKHFNGRHV
7+$7PHDQ"
lNE7ELLDISCUSSWHATTHEWORD@BREAK
MEANSINTHISCONTEXTLATERINTHEBOOK&OR
NOWTHINKOFITASMODIFYINGSOMETHINGIN
THESUPERCLASSTHATTHESUBCLASSISDEPENDING
ONLIKEAPARTICULARMETHODSARGUMENTSOR
RETURNTYPEORMETHODNAMEETC
FKDSWHU
1VPMZQ\IVKMTM\[aW]O]IZIV\MM\PI\
ITTKTI[[M[OZW]XML]VLMZIKMZ\IQV
[]XMZ\ aXMPI^MITT\PMUM\PWL[\PI\
\PM[]XMZ\ aXMPI[
1VW\PMZ_WZL[aW]LMNQVMIKWUUWVXZW\WKWTNWZI $QG,FDUHEHFDXVH
[M\WNKTI[[M[ZMTI\ML\PZW]OPQVPMZQ\IVKM
"ECAUSEYOUGETTOTAKEADVANTAGEOF
7HENYOUDElNEMETHODSINASUPERCLASSTHATCANBE POLYMORPHISM
INHERITEDBYSUBCLASSESYOUREANNOUNCINGAKINDOF
PROTOCOLTOOTHERCODETHATSAYSh!LLMYSUBTYPESIE
SUBCLASSES CANDOTHESETHINGSWITHTHESEMETHODS :KLFKPDWWHUVWRPH
THATLOOKLIKETHISv EHFDXVH
)NOTHERWORDSYOUESTABLISHACONTRACT "ECAUSEY OUGETTOREFERTOASUBCLASS
#LASS!NIMALESTABLISHESACOMMONPROTOCOLFORALL OBJECTUSINGAREFERENCEDECLAREDASTHE
!NIMALSUBTYPES SUPERTYPE
RUOGWKDW
$QLPDO
$QGWKDWPHDQVWRPH
<RX·UHWHOOLQJWKHZ HVHIRXU
PDNH1RLVH
DQ\$QLPDOFDQGRWKWKHPHWKRG 9OUGETTOWRITEREALLYmEXIBLECODE
WKLQJV7KDWLQFOXGHVQW\SHV
HDW
VOHHS #ODETHATSCLEANERMOREEFlCIENT
URDP DUJXPHQWVDQGUHWXU SIMPLER #ODETHATSNOTJUSTEASIERTO
DEVELOPBUTALSOMUCHMUCHEASIERTO
EXTENDINWAYSYOUNEVERIMAGINEDAT
!NDREMEMBERWHENWESAYANY!NIMALWEMEAN THETIMEYOUORIGINALLYWROTEYOURCODE
!NIMALANDANYCLASSTHATEXTENDSFROM!NIMAL7HICH 4HATMEANSYOUCANTAKETHATTROPICAL
AGAINMEANSANYCLASSTHATHAS!NIMALSOMEWHEREABOVEIT VACATIONWHILEYOURCO WORKERSUPDATE
INTHEINHERITANCEHIERARCHY THEPROGRAMANDYOURCO WORKERSMIGHT
"UTWERENOTEVENATTHEREALLYCOOLPARTYETBECAUSE NOTEVENNEEDYOURSOURCECODE
WESAVEDTHEBESTPOLYMORPHISMFORLAST
9OULLSEEHOWITWORKSONTHENEXTPAGE
7HENYOUDElNEASUPERTYPEFORAGROUPOFCLASSES
ANYSUBCLASSOFTHATSUPERTYPECANBESUBSTITUTEDWHERETHE 7EDONTKNOWABOUTYOUBUT
SUPERTYPEISEXPECTED PERSONALLYWElNDTHEWHOLE
TROPICALVACATIONTHING
3AYWHAT
PARTICULARLYMOTIVATING
$ONTWORRYWERENOWHERENEARDONEEXPLAININGIT
4WOPAGESFROMNOWYOULLBEANEXPERT
:KHQZHVD\´DOOWKHPHWKRGVµZHPHDQ´DOOWKHLQKHULWDEOHPHWKRGVµZKLFK
IRUQRZDFWXDOO\PHDQV´DOOWKHSXEOLFPHWKRGVµDOWKRXJKODWHUZH·OOUHILQHWKDW
GHILQLWLRQDELWPRUH
\RXDUHKHUH
WKHZD\SRO\PRUSKLVPZRUNV
7KHVWHSVRIREMHFW
GHFODUDWLRQDQGDVVLJQPHQW

7RVHHKRZSRO\PRUSKLVP
ZRUNVZHKDYHWRVWHSEDFN 'RJP\'RJ QHZ'RJ
DQGORRNDWWKHZD\ZH
QRUPDOO\GHFODUHDUHIHUHQFH
DQGFUHDWHDQREMHFW 'HFODUHDUHIHUHQFH
YDULDEOH
'RJP\'RJ QHZ'RJ
4ELLSTHE*6-TOALLOCATESPACEFORA
REFERENCEVARIABLE4HEREFERENCEVARIABLE
ISFOREVEROFTYPE$OG)NOTHERWORDS eq<g_
AREMOTECONTROLTHATHASBUTTONSTO
CONTROLA$OGBUTNOTA#ATORA"UTTON
ORA3OCKET 'RJ
&UHDWHDQREMHFW
'RJP\'RJ QHZ'RJ
4ELLSTHE*6-TOALLOCATESPACEFOR
ANEW$OGOBJECTONTHEGARBAGE
COLLECTIBLEHEAP
'RJREMHFW
/LQNWKHREMHFW
DQGWKHUHIHUHQFH
'RJP\'RJ QHZ'RJ
!SSIGNSTHENEW$OGTOTHEREFER
ENCEVARIABLEMY$OG)NOTHERWORDS
PROGRAMTHEREMOTECONTROL
'RJREMHFW
eq<g_
'RJ
FKDSWHU
7KHLPSRUWDQWSRLQWLVWKDWWKH
UHIHUHQFHW\SH$1'WKHREMHFW
W\SHDUHWKHVDPH
,QWKLVH[DPSOHERWKDUH'RJ
eq<g_ 'R
JREMHFW
'RJ
7KHVHWZRDUHWKHVDPHW\SH7KHUHIHUHQFH
YDULDEOHW\SHLVGHFODUHGDV'RJDQGWKHREMHFW
LVFUHDWHGDVQHZ'RJ
%XWZLWKSRO\PRUSKLVPWKH
UHIHUHQFHDQGWKHREMHFWFDQ
EHGLIIHUHQW
$QLPDOP\'RJ QHZ'RJ
eq<g_ 'R
JREMHFW
$QLPDO
7KHVHWZRDUH127WKHVDPHW\SH7KH
UHIHUHQFHYDULDEOHW\SHLVGHFODUHGDV$QLPDO
EXWWKHREMHFWLVFUHDWHGDVQHZ'RJ
\RXDUHKHUH
SRO\PRUSKLVPLQDFWLRQ
:LWKSRO\PRUSKLVPWKHUHIHUHQFH
W\SHFDQEHDVXSHUFODVVRIWKH
DFWXDOREMHFWW\SH XKQRSH
6WLOOQRWJHWWLQ·LW
7HENYOUDECLAREAREFERENCEVARIABLE
ANYOBJECTTHATPASSESTHE)3 !TESTFORTHE
DECLAREDTYPEOFTHEREFERENCEVARIABLE
CANBEASSIGNEDTOTHATREFERENCE)N
OTHERWORDSANYTHINGTHATEXTENDSTHE
DECLAREDREFERENCEVARIABLETYPECAN
BEASSIGNEDTOTHEREFERENCE
VARIABLE4HISLETSYOUDO
THINGSLIKEMAKEPOLYMORPHIC
ARRAYS
GV
Q LPD O ,Q RWKHUZRDUO
W\SH$ $QLP
2.2.PD\EHDQH[DPSOHZLOOKHOS
H FOD U H D Q DUUD\RIKROGREMHFWVRIW\SH
' KDWZLOO
DQDUUD\W
$QLPDO>@DQLPDOV QHZ$QLPDO>@
DQLPDOV>@ QHZ'RJ
%XWORRNZKDW\RXJHWWRGR\RXFDQSXW$1<
DQLPDOV>@ QHZ&DW
DQLPDOV>@ QHZ:ROI VXEFODVVRI$QLPDOLQWKH$QLPDODUUD\

DQLPDOV>@ QHZ+LSSR
DQLPDOV>@ QHZ/LRQ $QGKHUH·VW

UDLVRQG·rWU KHEHVWSRO\PRUSKLFSD
JHWWRORRSWHIRUWKHZKROHH[DPSOHUWWKH
RIWKH$QLP KURXJKWKHDUUD\DQG \RX
REMHFWGRHV DOFODVVPHWKRGVDQGHFDOORQH
IRULQWL LDQLPDOVOHQJWKL^
WKHULJKWWK YHU\
LQJ
DQLPDOV>L@HDW
:KHQ¶L·LVD'RJLVDWLQGH[LQWKHDUUD\VR
DQLPDOV>L@URDP \RXJHWWKH'RJ·VHDWPHWKRG:KHQ¶L·LV\RX
JHWWKH&DW·VHDWPHWKRG
`
6DPHZLWKURDP
FKDSWHU
%XWZDLW7KHUH·VPRUH
<RXFDQKDYHSRO\PRUSKLF
DUJXPHQWVDQGUHWXUQW\SHV
)FYOUCANDECLAREAREFERENCEVARIABLE
OFASUPERTYPESAY!NIMALANDASSIGNA
SUBCLASSOBJECTTOITSAY$OGTHINKOFHOW
THATMIGHTWORKWHENTHEREFERENCEISAN
ARGUMENTTOAMETHOD
FODVV9HW^
Y
SXEOLFYRLGJLYH6KRW$QLPDOD^
7KH$QLPDOSDU
GRKRUULEOHWKLQJVWRWKH$QLPDODW $QLPDOW\SHDVWDPKHHWHUFDQWDNH$1<
WKHRWKHUHQGRIWKHµD¶SDUDPHWHU WKH9HWLVGRQHJL DUJXPHQW$QGZKHQ
$QLPDOWRPDNH1RLYLQJWKHVKRWLWWHOOVWKH
DPDNH1RLVH LVUHDOO\RXWWKHUH VHDQGZKDWHYHU$QLPDO
ZKRVHPDNH1RLVHP RQWKHKHDSWKDW·
` HWKRGZLOOUXQ V
`
FODVV3HW2ZQHU^
KRGFDQWDNHDQ\
SXEOLFYRLGVWDUW^
7KH9HW·VJLYH6KRWPHWQJDVWKHREMHFW
9HWY QHZ9HW $QLPDO\RXJLYHLW$VORPHQWLVDVXEFODVVRI
\RXSDVVLQDVWKHDUJX
'RJG QHZ'RJ $QLPDOLWZLOOZRUN
+LSSRK QHZ+LSSR
YJLYH6KRWG 'RJ·VPDNH1RLVHUXQV

YJLYH6KRWK +LSSR·VPDNH1RLVHUXQV
`
\RXDUHKHUH
H[SORLWLQJWKHSRZHURI SRO\PRUSKLVP
12:,JHWLW,I,ZULWH
P\FRGHXVLQJSRO\PRUSKLFDUJXPHQWV
ZKHUH,GHFODUHWKHPHWKRGSDUDPHWHUDVD
VXSHUFODVVW\SH,FDQSDVVLQDQ\VXEFODVVREMHFWDW
UXQWLPH&RRO%HFDXVHWKDWDOVRPHDQV,FDQZULWHP\
FRGHJRRQYDFDWLRQDQGVRPHRQHHOVHFDQDGGQHZ
VXEFODVVW\SHVWRWKHSURJUDPDQGP\PHWKRGVZLOO
VWLOOZRUNWKHRQO\GRZQVLGHLV,·PMXVWPDNLQJOLIH
HDVLHUIRUWKDWLGLRW-LP
?Q\PXWTaUWZXPQ[UaW]KIV_ZQ\MKWLM\PI\LWM[V¼\
PI^M\WKPIVOM_PMVaW]QV\ZWL]KMVM_[]JKTI[[
\aXM[QV\W\PMXZWOZIU
2EMEMBERTHAT6ETCLASS)FYOUWRITETHAT6ETCLASSUSING
ARGUMENTSDECLAREDASTYPE!NIMALYOURCODECANHANDLEANY
!NIMALSUBCLASS4HATMEANSIFOTHERSWANTTOTAKEADVANTAGEOF
YOUR6ETCLASSALLTHEYHAVETODOISMAKESURETHEIRNEW!NIMAL
TYPESEXTENDCLASS!NIMAL4HE6ETMETHODSWILLSTILLWORKEVEN
THOUGHTHE6ETCLASSWASWRITTENWITHOUTANYKNOWLEDGEOFTHE
NEW!NIMALSUBTYPESTHE6ETWILLBEWORKINGON
YiXè
gfn\i
7HYISPOLYMORPHISMGUARANTEEDTOWORKTHISWAY7HYIS
ITALWAYSSAFETOASSUMETHATANYSUBCLASSTYPEWILLHAVETHE
METHODSYOUTHINKYOURECALLINGONTHESUPERCLASSTYPETHE
SUPERCLASSREFERENCETYPEYOUREUSINGTHEDOTOPERATORON
FKDSWHU
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: !RETHEREANYPRACTICALLIMITS Q: #ANYOUEXTENDANYCLASS/R Q: 7HYWOULDYOUEVERWANTTO
ONTHELEVELSOFSUBCLASSING(OW ISITLIKECLASSMEMBERSWHEREIFTHE MAKEAlNALCLASS7HATADVANTAGE
DEEPCANYOUGO CLASSISPRIVATEYOUCANTINHERITIT WOULDTHEREBEINPREVENTINGACLASS
FROMBEINGSUBCLASSED
A: )FYOULOOKINTHE*AVA!0) A:
YOULLSEETHATMOSTINHERITANCE
HIERARCHIESAREWIDEBUTNOTDEEP
4HERESNOSUCHTHINGASA
PRIVATECLASSEXCEPTINAVERYSPECIAL
CASECALLEDANINNERCLASSTHATWE
A: 4YPICALLYYOUWONTMAKEYOUR
CLASSESFINAL"UTIFYOUNEEDSECURITY
-OSTARENOMORETHANONEORTWO HAVENTLOOKEDATYET"UTTHEREARE THESECURITYOFKNOWINGTHATTHE
LEVELSDEEPALTHOUGHTHEREARE THREETHINGSTHATCANPREVENTACLASS METHODSWILLALWAYSWORKTHEWAY
EXCEPTIONSESPECIALLYINTHE'5) FROMBEINGSUBCLASSED THATYOUWROTETHEMBECAUSETHEY
CLASSES 9OULLCOMETOREALIZETHAT
4HEFIRSTISACCESSCONTROL%VENTHOUGH CANTBEOVERRIDDEN AFINALCLASS
ITUSUALLYMAKESMORESENSETOKEEP
ACLASSCANTBEMARKEDSULYDWHA WILLGIVEYOUTHAT!LOTOFCLASSESIN
YOURINHERITANCETREESSHALLOWBUT
CLASSCANBENON PUBLICWHATYOU THE*AVA!0)AREFINALFORTHATREASON
THEREISNTAHARDLIMITWELLNOTONE
GETIFYOUDONTDECLARETHECLASSAS 4HE3TRINGCLASSFOREXAMPLEISFINAL
THATYOUDEVERRUNINTO BECAUSEWELLIMAGINETHEHAVOCIF
SXEOLF !NON PUBLICCLASSCANBE
SUBCLASSEDONLYBYCLASSESINTHE SOMEBODYCAMEALONGANDCHANGED
Q: (EY)JUSTTHOUGHTOF
SOMETHINGIFYOUDONTHAVE
SAMEPACKAGEASTHECLASS#LASSESIN
ADIFFERENTPACKAGEWONTBEABLETO
THEWAY3TRINGSBEHAVE
ACCESSTOTHESOURCECODEFORACLASS
BUTYOUWANTTOCHANGETHEWAYA
SUBCLASSOREVENUSEFORTHATMATTER
THENON PUBLICCLASS
Q: #ANYOUMAKEAMETHODlNAL
WITHOUTMAKINGTHEWHOLECLASS
METHODOFTHATCLASSWORKSCOULD 4HESECONDTHINGTHATSTOPSACLASS lNAL
YOUUSESUBCLASSINGTODOTHAT4O FROMBEINGSUBCLASSEDISTHEKEYWORD
EXTENDTHEhBADvCLASSANDOVERRIDE MODIFIER¿QDO!FINALCLASSMEANS
THEMETHODWITHYOUROWNBETTER
CODE
THATITSTHEENDOFTHEINHERITANCE
LINE.OBODYEVERCANEXTENDAFINAL
A: )FYOUWANTTOPROTECTASPECIFIC
METHODFROMBEINGOVERRIDDENMARK
CLASS THEMETHODWITHTHE¿QDOMODIFIER
A: 9EP4HATSONECOOLFEATURE
OF//ANDSOMETIMESITSAVESYOU
4HETHIRDISSUEISTHATIFACLASSHAS
ONLYSULYDWHCONSTRUCTORSWELL
-ARKTHEWHOLECLASSASFINALIFYOU
WANTTOGUARANTEETHATNONEOFTHE
LOOKATCONSTRUCTORSINCHAPTER IT METHODSINTHATCLASSWILLEVERBE
FROMHAVINGTOREWRITETHECLASS OVERRIDDEN
CANTBESUBCLASSED
FROMSCRATCHORTRACKDOWNTHE
PROGRAMMERWHOHIDTHESOURCECODE
\RXDUHKHUH
RYHUULGLQJPHWKRGV
3MMXQVO\PMKWV\ZIK\"Z]TM[NWZW^MZZQLQVO
7HENYOUOVERRIDEAMETHODFROMASUPERCLASSYOUREAGREEINGTO
FULlLLTHECONTRACT4HECONTRACTTHATSAYSFOREXAMPLEh)TAKENO
ARGUMENTSAND)RETURNABOOLEANv)NOTHERWORDSTHEARGUMENTS $SSOLDQFH
ANDRETURNTYPESOFYOUROVERRIDINGMETHODMUSTLOOKTOTHEOUTSIDE
WORLDEXACTLYLIKETHEOVERRIDDENMETHODINTHESUPERCLASS ERROHDQWXUQ2Q
4HEMETHODSARETHECONTRACT ERROHDQWXUQ2II
)FPOLYMORPHISMISGOINGTOWORKTHE4 OASTERSVERSIONOFTHE
OVERRIDDENMETHODFROM!PPLIANCEHASTOWORKATRUNTIME
2EMEMBERTHECOMPILERLOOKSATTHEREFERENCETYPETODECIDE
WHETHERYOUCANCALLAPARTICULARMETHODONTHATREFERENCE7ITH
AN!PPLIANCEREFERENCETOA4OASTERTHECOMPILERCARESONLYIFCLASS
!PPLIANCEHASTHEMETHODYOUREINVOKINGONAN!PPLIANCEREFERENCE 7RDVWHU
"UTATRUNTIMETHE*6-LOOKSNOTATTHEREFERENCETYPE!PPLIANCE BUT
ATTHEACTUAL4OASTEROBJECTONTHEHEAP3OIFTHECOMPILERHASALREADY ERROHDQWXUQ2QLQWOHYHO
APPROVEDTHEMETHODCALLTHEONLYWAYITCANWORKISIFTHEOVERRIDING
LV 1 2 7 DQ
METHODHASTHESAMEARGUMENTSANDRETURNTYPES/THERWISE 7KLV H
RYHUULG
SOMEONEWITHAN!PPLIANCEREFERENCEWILLCALLTURN/N ASANO
JHWKH
ARGMETHODEVENTHOUGHTHERESAVERSIONIN4OASTERTHATTAKESAN &DQ·WFQKWDVQ LQDQ
INT7HICHONEISCALLEDATRUNTIME4HEONEIN!PPLIANCE)NOTHER DUJXPH LQJPHWKRG
WORDSTHETURN/NINTLEVEL METHODIN4OASTERISNOTANOVERRIDE RYHUULG 7KLVLVDFWXDOO\DOHJDO
RYHU/2$'EXWQRWD
RYHU5,'( Q
$UJXPHQWVPXVWEHWKHVDPHDQGUHWXUQ
W\SHVPXVWEHFRPSDWLEOH
7KHFRQWUDFWRIVXSHUFODVVGH¿QHVKRZRWKHUFRGHFDQXVHDPHWKRG
:KDWHYHUWKHVXSHUFODVVWDNHVDVDQDUJXPHQWWKHVXEFODVVRYHU
ULGLQJWKHPHWKRGPXVWXVHWKDWVDPHDUJXPHQW$QGZKDWHYHUWKH
VXSHUFODVVGHFODUHVDVDUHWXUQW\SHWKHRYHUULGLQJPHWKRGPXVWGH $SSOLDQFH
FODUHHLWKHUWKHVDPHW\SHRUDVXEFODVVW\SH5HPHPEHUDVXEFODVV
REMHFWLVJXDUDQWHHGWREHDEOHWRGRDQ\WKLQJLWVVXSHUFODVVGHFODUHV SXEOLFERROHDQWXUQ2Q
VRLW¶VVDIHWRUHWXUQDVXEFODVVZKHUHWKHVXSHUFODVVLVH[SHFWHG
SXEOLFERROHDQWXUQ2Q
7KHPHWKRGFDQ·WEHOHVVDFFHVVLEOH
7KDWPHDQVWKHDFFHVVOHYHOPXVWEHWKHVDPHRUIULHQGOLHU7KDW
PHDQV\RXFDQ¶WIRUH[DPSOHRYHUULGHDSXEOLFPHWKRGDQGPDNH
LWSULYDWH:KDWDVKRFNWKDWZRXOGEHWRWKHFRGHLQYRNLQJZKDWLW

127/(*$/
WKLQNVDWFRPSLOHWLPHLVDSXEOLFPHWKRGLIVXGGHQO\DWUXQWLPH
WKH-90VODPPHGWKHGRRUVKXWEHFDXVHWKHRYHUULGLQJYHUVLRQ 7RDVWHU
FDOOHGDWUXQWLPHLVSULYDWH ·V Q R W D O H J DO
,W FDXVH\RXVV
6RIDUZH¶YHOHDUQHGDERXWWZRDFFHVVOHYHOVSULYDWHDQGSXEOLF RYHUULGHEGHW KHDFFH SULYDWHERROHDQWXUQ2Q
7KHRWKHUWZRDUHLQWKHGHSOR\PHQWFKDSWHU5HOHDVH\RXU&RGH UHVWULFWH LVLWDOHJDO
DQGDSSHQGL[%7KHUH¶VDOVRDQRWKHUUXOHDERXWRYHUULGLQJUHODWHG OHYHO1RU'EHFDXVH
WRH[FHSWLRQKDQGOLQJEXWZH¶OOZDLWXQWLOWKHFKDSWHURQH[FHSWLRQV RYHU/2$·WFKDQJH
5LVN\%HKDYLRUWRFRYHUWKDW \RXGLGQ V
DUJXPHQW
FKDSWHU
7^MZTWILQVOIUM\PWL
-ETHODOVERLOADINGISNOTHINGMORETHANHAVING
TWOMETHODSWITHTHESAMENAMEBUTDIFFERENT
ARGUMENTLISTS0ERIOD4HERESNOPOLYMORPHISM
INVOLVEDWITHOVERLOADEDMETHODS $QRYHUORDGHGPHWKRGLV
/VERLOADINGLETSYOUMAKEMULTIPLEVERSIONS
OFAMETHODWITHDIFFERENTARGUMENTLISTSFOR MXVWDGLIIHUHQWPHWKRGWKDW
CONVENIENCETOTHECALLERS&OREXAMPLEIFYOU KDSSHQVWRKDYHWKHVDPH
HAVEAMETHODTHATTAKESONLYANINTTHECALLING
CODEHASTOCONVERTSAYADOUBLEINTOANINT PHWKRGQDPH,WKDVQRWKLQJ
BEFORECALLINGYOURMETHOD"UTIFYOUOVERLOADED WRGRZLWKLQKHULWDQFHDQG
THEMETHODWITHANOTHERVERSIONTHATTAKESA
DOUBLETHENYOUVEMADETHINGSEASIERFORTHE SRO\PRUSKLVP$QRYHUORDGHG
CALLER9OULLSEEMOREOFTHISWHENWELOOKINTO
CONSTRUCTORSINTHEOBJECTLIFECYCLECHAPTER PHWKRGLV127WKHVDPHDV
3INCEANOVERLOADINGMETHODISNTTRYINGTO DQRYHUULGGHQPHWKRG
FULlLLTHEPOLYMORPHISMCONTRACTDElNEDBYITS
SUPERCLASSOVERLOADEDMETHODSHAVEMUCHMORE
mEXIBILITY
7KHUHWXUQW\SHVFDQEH /HJDOH[DPSOHVRIPHWKRG
GLIIHUHQW RYHUORDGLQJ
<RX¶UHIUHHWRFKDQJHWKHUHWXUQW\SHVLQ SXEOLFFODVV2YHUORDGV^
RYHUORDGHGPHWKRGVDVORQJDVWKHDUJXPHQWOLVWV
DUHGLIIHUHQW 6WULQJXQLTXH,'
<RXFDQ·WFKDQJH21/<WKH SXEOLFLQWDGG1XPVLQWDLQWE^

UHWXUQDE
UHWXUQW\SH `
,IRQO\WKHUHWXUQW\SHLVGLIIHUHQWLW¶VQRWD
YDOLGRYHUORDG²WKHFRPSLOHUZLOODVVXPH SXEOLFGRXEOHDGG1XPVGRXEOHDGRXEOHE^
\RX¶UHWU\LQJWRRYHUULGHWKHPHWKRG$QGHYHQ UHWXUQDE
WKDWZRQ¶WEHOHJDOXQOHVVWKHUHWXUQW\SHLV `
DVXEW\SHRIWKHUHWXUQW\SHGHFODUHGLQWKH
VXSHUFODVV7RRYHUORDGDPHWKRG\RX0867 SXEOLFYRLGVHW8QLTXH,'6WULQJWKH,'^
FKDQJHWKHDUJXPHQWOLVWDOWKRXJK\RXFDQ ORWVRIYDOLGDWLRQFRGHDQGWKHQ
FKDQJHWKHUHWXUQW\SHWRDQ\WKLQJ XQLTXH,' WKH,'
`
<RXFDQYDU\WKHDFFHVV SXEOLFYRLGVHW8QLTXH,'LQWVV1XPEHU^

OHYHOVLQDQ\GLUHFWLRQ 6WULQJQXP6WULQJ ³´VV1XPEHU
VHW8QLTXH,'QXP6WULQJ
<RX¶UHIUHHWRRYHUORDGDPHWKRGZLWKDPHWKRG `
WKDW¶VPRUHUHVWULFWLYH,WGRHVQ¶WPDWWHUVLQFHWKH `
QHZPHWKRGLVQ¶WREOLJDWHGWRIXO¿OOWKHFRQWUDFWRI
WKHRYHUORDGHGPHWKRG
\RXDUHKHUH
H[HUFLVH0L[HG0HVVDJHV
!SHORT*AVAPROGRAMISLISTEDBELOW/NEBLOCKOF
8Q[HG THEPROGRAMISMISSING9OURCHALLENGEISTOMATCH
MInZAJM[ THECANDIDATEBLOCKOFCODEONTHELEFT WITHTHE
OUTPUTTHATYOUDSEEIFTHEBLOCKWEREINSERTED
.OTALLTHELINESOFOUTPUTWILLBEUSEDANDSOMEOF
1dQÔU_Q D THELINESOFOUTPUTMIGHTBEUSEDMORETHANONCE
E $RAWLINESCONNECTINGTHECANDIDATEBLOCKSOF
D
CODEWITHTHEIRMATCHINGCOMMAND LINEOUTPUT
\PMXZWOZIU"
FODVV$^ FODVV&H[WHQGV%^
LQWLYDU YRLGP^
YRLGP^ 6\VWHPRXWSULQW´&·VP´LYDU
6\VWHPRXWSULQW´$·VP´ `
` `
Licensed by
YRLGP^
6\VWHPRXWSULQW´$·VP´ SXEOLFFODVV0L[HG^
` SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^
YRLGP^ $D QHZ$
6\VWHPRXWSULQW´$·VP´ %E QHZ%
Eduard Simons
` &F QHZ&
` $D QHZ& KIVLQLI\MKWLM
OWM[PMZM
FODVV%H[WHQGV$^
\PZMMTQVM[
104038
YRLGP^
6\VWHPRXWSULQW´%·VP´
` `
` `
KWLM EP W]\X]\"

KIVLQLI\M["
FP
DP ` $·VP$·VP&·VP
%·VP$·VP$·VP
`
FP
FP $·VP%·VP$·VP
FP
%·VP$·VP&·VP
`
DP
EP %·VP&·VP$·VP
FP %·VP$·VP&·VP
`
DP $·VP$·VP&·VP
DP
DP
FKDSWHU
"%THE#OMPILER
:KLFKRIWKH$%SDLUVRIPHWKRGVOLVWHGRQWKHULJKWLI
1dQÔU_Q LQVHUWHGLQWRWKHFODVVHVRQWKHOHIWZRXOGFRPSLOHDQG
SURGXFHWKHRXWSXWVKRZQ"7KH$PHWKRGLQVHUWHGLQWR
FODVV0RQVWHUWKH%PHWKRGLQVHUWHGLQWRFODVV9DPSLUH
SXEOLFFODVV0RQVWHU7HVW'ULYH^
ERROHDQIULJKWHQLQWG^
6\VWHPRXWSULQWOQ´DUUUJKµ
0RQVWHU>@PD QHZ0RQVWHU>@ )
UHWXUQWUXH
PD>@ QHZ9DPSLUH `
PD>@ QHZ'UDJRQ ERROHDQIULJKWHQLQW[^
PD>@ QHZ0RQVWHU * 6\VWHPRXWSULQWOQ´DELWH"µ
IRULQW[ [[^ UHWXUQIDOVH
PD>[@IULJKWHQ[ `
`
ERROHDQIULJKWHQLQW[^
`
) 6\VWHPRXWSULQWOQ´DUUUJKµ
`
UHWXUQWUXH
`
FODVV0RQVWHU^ LQWIULJKWHQLQWI^
* 6\VWHPRXWSULQWOQ´DELWH"µ
) UHWXUQ
` `
FODVV9DPSLUHH[WHQGV0RQVWHU^ ERROHDQIULJKWHQLQW[^

)
* UHWXUQIDOVH
`
`
ERROHDQVFDUHLQW[^
6\VWHPRXWSULQWOQ´DELWH"µ
*
FODVV'UDJRQH[WHQGV0RQVWHU^ UHWXUQWUXH
ERROHDQIULJKWHQLQWGHJUHH^ `
6\VWHPRXWSULQWOQÉUHDWKÀUHµ
UHWXUQWUXH ERROHDQIULJKWHQLQW]^
` )
)LOH(GLW:LQGRZ+HOS6DYH<RXUVHOI
)LOH(GLW:LQGRZ+HOS6OHHS UHWXUQWUXH
`
MDYD0RQVWHU7HVW'ULYH
MDYD7HVW$UUD\V `
DELWH" )LML
LVODQG ERROHDQIULJKWHQE\WHE^
EUHDWKILUH
LVODQG &R]XPHO * 6\VWHPRXWSULQWOQ´DELWH"µ
DUUUJK %HUPXGD
LVODQG UHWXUQWUXH
LVODQG $]RUHV `
\RXDUHKHUH
SX]]OH3RRO3X]]OH
8WWT8]bbTM
9OURJOBISTOTAKECODESNIPPETSFROMTHEPOOLANDPLACETHEMINTO
THEBLANKLINESINTHECODE9OUMAYUSETHESAMESNIPPETMORE
THANONCEANDYOUMIGHTNOTNEEDTOUSEALLTHESNIPPETS9OUR
GOALISTOMAKEASETOFCLASSESTHATWILLCOMPILEANDRUNTOGETHER
ASAPROGRAM$ONTBEFOOLEDnTHISONESHARDERTHANITLOOKS
SXEOLFFODVV5RZERDWBBBBBBBBBBBBBBBB^ SXEOLFFODVV7HVW%RDWV^
SXEOLFBBBBBBBBBBBURZ7KH%RDW^ BBBBBBBBBBBBBBBBBBBPDLQ6WULQJ>@DUJV^
6\VWHPRXWSULQW´VWURNHQDWDVKDµ BBBBBBBBBE QHZ%RDW
` 6DLOERDWE QHZBBBBBBBBBB
`
5RZERDWBBBBBBBB QHZ5RZERDW
SXEOLFFODVVBBBBBBBB^ EVHW/HQJWK
SULYDWHLQWBBBBBBBBBB EBBBBBBBBBB
BBBBBBBYRLGBBBBBBBBBBBBBBB^ EBBBBBBBBBB
OHQJWK OHQ BBBBBBBPRYH
` `
SXEOLFLQWJHW/HQJWK^ `
BBBBBBBBBBBBBBBBB SXEOLFFODVVBBBBBBBBBBBBBBBBBB%RDW^
` SXEOLFBBBBBBBBBBBBBBBB^
SXEOLFBBBBBBBBBBBPRYH^ 6\VWHPRXWSULQW´BBBBBBBBBBBµ
6\VWHPRXWSULQW´BBBBBBBBBBBµ `
`
`
`
/54054 GULIWGULIWKRLVWVDLO
2OWBOAT
3AILBOAT SUBCLASSES
"OAT 4ESTBOATS EXTENDS

INTLEN DRIFT HOISTSAIL
RETURN STROKENATASHA ROW4HE"OAT
CONTINUE INTLENGTH 3TRING MOVE
B BREAK INTB SET,ENGTH
INTB VOID
INTB PUBLIC
B B LENGTH INT STATIC GET,ENGTH
INTB PRIVATE
LEN
FKDSWHU
"%THE#OMPILER
6HWZLOOZRUN
6HWZLOOQRWFRPSLOHEHFDXVHRI9DPSLUH¶VUHWXUQ
%XERCISE W\SHLQW
3OLUTIONS 7KH9DPSLUH¶VIULJKWHQPHWKRG%LVQRWDOHJDO
RYHUULGH25RYHUORDGRI0RQVWHU¶VIULJKWHQPHWKRG
&KDQJLQJ21/<WKHUHWXUQW\SHLVQRWHQRXJK
WRPDNHDYDOLGRYHUORDGDQGVLQFHDQLQWLVQRW
FRPSDWLEOHZLWKDERROHDQWKHPHWKRGLVQRWDYDOLG
RYHUULGH5HPHPEHULI\RXFKDQJH21/<WKHUHWXUQ
W\SHLWPXVWEHWRDUHWXUQW\SHWKDWLVFRPSDWLEOH
ZLWKWKHVXSHUFODVVYHUVLRQ¶VUHWXUQW\SHDQGWKHQLW¶V
DQRYHUULGH
6HWVDQGZLOOFRPSLOHEXWSURGXFH
DUUUJK
EUHDWK¿UH
DUUUJK
5HPHPEHUFODVV9DPSLUHGLGQRWRYHUULGHFODVV
0RQVWHU¶VIULJKWHQPHWKRG7KHIULJKWHQPHWKRG
LQ9DPSLUH¶VVHWWDNHVDE\WHQRWDQLQW
KWLM
EP W]\X]\"
KIVLQLI\M[" FP
DP ` $·VP$·VP&·VP
8Q[HG %·VP$·VP$·VP
`
FP
MInZAJM[ FP
FP
$·VP%·VP$·VP
%·VP$·VP&·VP
DP
EP %·VP&·VP$·VP
`
FP %·VP$·VP&·VP
DP $·VP$·VP&·VP
DP
DP
\RXDUHKHUH
SX]]OHDQVZHUV
SXEOLFFODVV5RZERDWH[WHQGV%RDW^
SXEOLFYRLGURZ7KH%RDW^
6\VWHPRXWSULQW´VWURNHQDWDVKDµ
`
`
SXEOLFFODVV%RDW^
SULYDWHLQWOHQJWK
SXEOLFYRLGVHW/HQJWKLQWOHQ^
OHQJWK OHQ
`
SXEOLFLQWJHW/HQJWK^
UHWXUQOHQJWK
`
SXEOLFYRLGPRYH^
6\VWHPRXWSULQW´GULIWµ
`
`
SXEOLFFODVV7HVW%RDWV^
%RDWE QHZ%RDW
6DLOERDWE QHZ6DLOERDW
5RZERDWE QHZ5RZERDW
EVHW/HQJWK
EPRYH
EPRYH
EPRYH
`
`
SXEOLFFODVV6DLOERDWH[WHQGV%RDW^
SXEOLFYRLGPRYH^
6\VWHPRXWSULQW´KRLVWVDLOµ
`
`
/54054 GULIWGULIWKRLVWVDLO
FKDSWHU
LQWHUIDFHVDQGDEVWUDFWFODVVHV
6HULRXV3RO\PRUSKLVP
,QKHULWDQFHLVMXVWWKHEHJLQQLQJ4OEXPLOITPOLYMORPHISMWENEEDINTERFACES
ANDNOTTHE'5)KIND 7ENEEDTOGOBEYONDSIMPLEINHERITANCETOALEVELOFFLEXIBILITYAND
EXTENSIBILITYYOUCANGETONLYBYDESIGNINGANDCODINGTOINTERFACESPECIFICATIONS3OMEOFTHE
COOLESTPARTSOF*AVAWOULDNTEVENBEPOSSIBLEWITHOUTINTERFACESSOEVENIFYOUDONTDESIGN
WITHTHEMYOURSELFYOUSTILLHAVETOUSETHEM"UTYOULLWANTTODESIGNWITHTHEM9OULLNEED
TODESIGNWITHTHEM9OULLWONDERHOWYOUEVERLIVEDWITHOUTTHEM7HATSANINTERFACE)TS
AABSTRACTCLASS7HATSANABSTRACTCLASS)TSACLASSTHATCANTBEINSTANTIATED7HATSTHAT
GOODFOR9OULLSEEINJUSTAFEWMOMENTS"UTIFYOUTHINKABOUTTHEENDOFTHELASTCHAPTER
ANDHOWWEUSEDPOLYMORPHICARGUMENTSSOTHATASINGLE6ETMETHODCOULDTAKE!NIMAL
SUBCLASSESOFALLTYPESWELLTHATWASJUSTSCRATCHINGTHESURFACE)NTERFACESARETHEPOLYIN
POLYMORPHISM4HEABINABSTRACT4HECAFFEINEIN*AVA
WKLVLVDQHZFKDSWHU
GHVLJQLQJZLWKLQKHULWDQFH
,QL_MNWZOM\IJW]\[WUM\PQVO
_PMV_MLM[QOVML\PQ[' $QLPDO
4HECLASSSTRUCTUREISNTTOOBAD7EVEDESIGNED
SLFWXUH
ITSOTHATDUPLICATECODEISKEPTTOAMINIMUM
IRRG
ANDWEVEOVERRIDDENTHEMETHODSTHATWETHINK KXQJHU
SHOULDHAVESUBCLASS SPECIlCIMPLEMENTATIONS ERXQGDULHV
7EVEMADEITNICEANDmEXIBLEFROMA ORFDWLRQ
POLYMORPHICPERSPECTIVEBECAUSEWECANDESIGN
!NIMAL USINGPROGRAMSWITH!NIMALARGUMENTS PDNH1RLVH
ANDARRAYDECLARATIONS SOTHATANY!NIMAL HDW
SUBTYPEINCLUDINGTHOSEWENEVERIMAGINEDATTHE VOHHS
TIMEWEWROTEOURCODECANBEPASSEDINANDUSED URDP
ATRUNTIME7EVEPUTTHECOMMONPROTOCOLFOR
ALL!NIMALSTHEFOURMETHODSTHATWEWANTTHE
WORLDTOKNOWALL!NIMALSHAVE INTHE!NIMAL
SUPERCLASSANDWEREREADYTOSTARTMAKINGNEW
,IONSAND4IGERSAND(IPPOS
)HOLQH
&DQLQH
URDP
+LSSR
URDP
VL]H
SLFWXUH
IRRG
PDNH1RLVH
SUH\
HDW
/LRQ
VL]H
SLFWXUH
IRRG
PDNH1RLVH
SUH\
HDW
'RJ
&DW VL]H
SLFWXUH
VL]H IRRG
7LJHU PDNH1RLVH
SLFWXUH :ROI SUH\
VL]H IRRG HDW
PDNH1RLVH
SLFWXUH SUH\ VL]H
HDW SLFWXUH
IRRG
PDNH1RLVH
SUH\ IRRG
PDNH1RLVH
HDW
SUH\
HDW
FKDSWHU
LQWHUIDFHVDQGSRO\PRUSKLVP
:HNQRZZHFDQVD\
:ROID:ROI QHZ:ROI
YOgd^
:
$:ROIUHIHUHQFHWRD ROIREMHFW
:ROIREMHFW :ROI
7KHVHWZRDUHWKHVDPHW\SH
$QGZHNQRZZHFDQVD\
$QLPDOD+LSSR QHZ+LSSR
Y@ahhg
$QLPDOUHIHUHQFHWR +L W
SSR
D+LSSRREMHFW REMHF
$QLPDO
7KHVHWZRDUH127WKHVDPHW\SH
%XWKHUH·VZKHUHLWJHWVZHLUG
$QLPDODQLP QHZ$QLPDO
$QLPDOUHIHUHQFHWR Yfae
"
DQ$QLPDOREMHFW $Q
LPDO EMHFW

R
$QLPDO
7KHVHWZRDUHWKHVDPHW\SHEXW
ZKDWWKHKHFNGRHVDQ$QLPDOREMHFWORRNOLNH"
\RXDUHKHUH
ZKHQREMHFWVJREDG
:KDWGRHVDQHZ$QLPDOREMHFW
ORRNOLNH"
VFDU\REMHFWV
:KDWDUHWKHLQVWDQFHYDULDEOHYDOXHV"
6RPHFODVVHVMXVWVKRXOGQRWEH
LQVWDQWLDWHG
)TMAKESSENSETOCREATEA7OLFOBJECTORA(IPPO 9OUCANSTILLUSETHATABSTRACTTYPEASAREFERENCETYPE
OBJECTORA4IGEROBJECTBUTWHATEXACTLYISAN )NFACTTHATSABIGPARTOFWHYYOUHAVETHATA BSTRACT
!NIMALOBJECT7HATSHAPEISIT7HATCOLORSIZE CLASSINTHElRSTPLACETOUSEITASAPOLYMORPHIC
NUMBEROFLEGS ARGUMENTORRETURNTYPEORTOMAKEAPOLYMORPHIC
4RYINGTOCREATEANOBJECTOFTYPE!NIMALISLIKEA ARRAY
NIGHTMARE3TAR4REK©TRANSPORTERACCIDENT4HE 7HENYOUREDESIGNINGYOURCLASSINHERITANCE
ONEWHERESOMEWHEREINTHEBEAM ME UPPROCESS STRUCTUREYOUHAVETODECIDEWHICHCLASSESARE
SOMETHINGBADHAPPENEDTOTHEBUFFER ABSTRACTANDWHICHARECONCRETE#ONCRETECLASSESARE
"UTHOWDOWEDEALWITHTHIS7ENEEDAN!NIMAL THOSETHATARESPECIlCENOUGHTOBEINSTANTIATED!
CLASSFORINHERITANCEANDPOLYMORPHISM"UTWE CONCRETECLASSJUSTMEANSTHATITS/+TOMAKEOBJECTS
WANTPROGRAMMERSTOINSTANTIATEONLYTHELESS OFTHATTYPE
ABSTRACTSUBCLASSESOFCLASS!NIMALNOT!NIMALITSELF -AKINGACLASSABSTRACTISEASYPUTTHEKEYWORD
7EWANT4IGEROBJECTSAND,IONOBJECTSNOT!NIMAL DEVWUDFWBEFORETHECLASSDECLARATION
OBJECTS
&ORTUNATELYTHERESASIMPLEWAYTOPREVENTACLASS DEVWUDFWFODVV&DQLQHH[WHQGV$QLPDO^
FROMEVERBEINGINSTANTIATED)NOTHERWORDSTOSTOP
ANYONEFROMSAYINGhQHZvONTHATTYPE"YMARKING SXEOLFYRLGURDP^`
THECLASSASDEVWUDFWTHECOMPILERWILLSTOPANY `
CODEANYWHEREFROMEVERCREATINGANINSTANCEOF
THATTYPE
FKDSWHU
<PMKWUXQTMZ_WV¼\TM\aW]QV[\IV\QI\M
IVIJ[\ZIK\KTI[[
!NABSTRACTCLASSMEANSTHATNOBODYCANEVERMAKEANEW
INSTANCEOFTHATCLASS9OUCANSTILLUSETHATABSTRACTCLASSASA
DECLAREDREFERENCETYPEFORTHEPURPOSEOFPOLYMORPHISMBUT
YOUDONTHAVETOWORRYABOUTSOMEBODYMAKINGOBJECTSOFTHAT
TYPE4HECOMPILERGUARANTEESIT
DEVWUDFWSXEOLFFODVV&DQLQHH[WHQGV$QLPDO
^
SXEOLFYRLGURDP^`
`
LJQ
QDOZD\VDVVUHQFH
SXEOLFFODVV0DNH&DQLQH^
D X VH \RX F D
EHF HIH
SXEOLFYRLGJR^
7KLVLV2.EMHFWWRDVXSHUFODVVU
&DQLQHF R
DVXEFODVV VXSHUFODVVLVDEVWUDF W
F QHZ'RJ HYHQLIWKH
F QHZ&DQLQH
FODVV&DQLQH
FURDP VRWKHFRPS LVPDUNHGDEVWUDFW
LOHUZLOO127
` OHW\RXGRW
KLV
`
)LOH(GLW:LQGRZ+HOS%HDP0H8S
MDYDF0DNH&DQLQHMDYD
0DNH&DQLQHMDYD&DQLQHLVDEVWUDFW
FDQQRWEHLQVWDQWLDWHG
F QHZ&DQLQH
A
HUURU
$QDEVWUDFWFODVVKDVYLUWXDOO\ QRXVHQRYDOXHQR
SXUSRVHLQOLIHXQOHVVLWLVH[WHQGHG
:LWKDQDEVWUDFWFODVVWKHJX\VGRLQJWKHZRUNDWUXQWLPH
DUHLQVWDQFHVRIDVXEFODVVRI\RXUDEVWUDFWFODVV
7KHUHLVDQH[FHSWLRQWRWKLV³DQDEVWUDFWFODVVFDQ
KDYHVWDWLFPHPEHUVVHHFKDSWHU
\RXDUHKHUH
DEVWUDFWDQGFRQFUHWHFODVVHV
)J[\ZIK\^[+WVKZM\M DEVWUDFW
!CLASSTHATSNOTABSTRACTISCALLED $QLPDO
ACONCRETECLASS)NTHE!NIMAL
INHERITANCETREEIFWEMAKE
!NIMAL#ANINEAND&ELINE
ABSTRACTTHATLEAVES(IPPO7OLF
$OG4IGER,IONAND#ATASTHE
DEVWUDFW
&DQLQH
CONCRETESUBCLASSES FRQFUHWH
&LIPTHROUGHTHE*AVA!0)AND +LSSR
YOULLlNDALOTOFABSTRACTCLASSES DEVWUDFW
ESPECIALLYINTHE'5)LIBRARY7HAT
DOESA'5)#OMPONENTLOOK
)HOLQH
FRQFUHWH
Licensed by
LIKE4HE#OMPONENTCLASSISTHE 'RJ
SUPERCLASSOF'5) RELATEDCLASSES
FORTHINGSLIKEBUTTONSTEXTAREAS FRQFUHWH
SCROLLBARSDIALOGBOXESYOUNAME FRQFUHWH
&DW
IT9OUDONTMAKEANINSTANCEOF :ROI
FRQFUHWH
Eduard Simons
AGENERIC#OMPONENTANDPUTITON FRQFUHWH
THESCREENYOUMAKEA*"UTTON)N /LRQ
OTHERWORDSYOUINSTANTIATEONLYA 7LJHU
CONCRETESUBCLASSOF#OMPONENTBUT
NEVER#OMPONENTITSELF
YiXè
gfn\i
104038 DEVWUDFWRUFRQFUHWH"
(OWDOYOUKNOWWHENACLASSSHOULDBE
ABSTRACT7INEISPROBABLYABSTRACT"UTWHAT
+PPPPGR, +PPPPWKH&DPHORW ABOUT2EDAND7HITE!GAINPROBABLYABSTRACT
IHHOOLNHUHGRU 9LQH\DUGV3LQRW
ZKLWHWRQLJKW" 1RLUZDVDSUHWW\
FORSOMEOFUSANYWAY "UTATWHATPOINTINTHE
GHFHQW\HDU HIERARCHYDOTHINGSBECOMECONCRETE
$OYOUMAKE0INOT.OIRCONCRETEORISITABSTRACT
TOO)TLOOKSLIKETHE#AMELOT6INEYARDS
0INOT.OIRISPROBABLYCONCRETENOMATTERWHAT
"UTHOWDOYOUKNOWFORSURE
,OOKATTHE!NIMALINHERITANCETREEABOVE$OTHE
CHOICESWEVEMADEFORWHICHCLASSESAREABSTRACT
ANDWHICHARECONCRETESEEMAPPROPRIATE
7OULDYOUCHANGEANYTHINGABOUTTHE!NIMAL
INHERITANCETREEOTHERTHANADDINGMORE!NIMALS
OFCOURSE
FKDSWHU
)J[\ZIK\UM\PWL[
"ESIDESCLASSESYOUCANMARKMETHODSABSTRACTTOO!NABSTRACT
CLASSMEANSTHECLASSMUSTBEEXTENDEDANABSTRACTMETHODMEANS
THEMETHODMUSTBEOVERRIDDEN9OUMIGHTDECIDETHATSOMEORALL ,WUHDOO\VXFNVWR
BEHAVIORSINANABSTRACTCLASSDONTMAKEANYSENSEUNLESSTHEYRE
EHDQDEVWUDFWPHWKRG
IMPLEMENTEDBYAMORESPECIlCSUBCLASS)NOTHERWORDSYOUCANT
THINKOFANYGENERICMETHODIMPLEMENTATIONTHATCOULDPOSSIBLYBE <RXGRQ·WKDYHDERG\
USEFULFORSUBCLASSES7HATWOULDAGENERICEAT METHODLOOKLIKE
$QDEVWUDFWPHWKRGKDVQRERG\
"ECAUSEYOUVEALREADYDECIDEDTHEREISNTANYCODETHATWOULDMAKE
SENSEINTHEABSTRACTMETHODYOUWONTPUTINAMETHODBODY3ONO
CURLYBRACESJUSTENDTHEDECLARATIONWITHASEMICOLON
SXEOLFDEVWUDFWYRLGHDW

1RPHWKRGERDG\VHPLFRORQ
(QGLWZLW K
,I\RXGHFODUHDQDEVWUDFWPHWKRG\RX0867
PDUNWKHFODVVDEVWUDFWDVZHOO<RXFDQ·WKDYH
DQDEVWUDFWPHWKRGLQDQRQDEVWUDFWFODVV
)FYOUPUTEVENASINGLEABSTRACTMETHODINACLASSYOUHAVETO
MAKETHECLASSABSTRACT"UTYOUCANMIXBOTHABSTRACTANDNON
ABSTRACTMETHODSINTHEABSTRACTCLASS
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: 7HATISTHEPOINTOFANABSTRACTMETHOD)THOUGHT
THEWHOLEPOINTOFANABSTRACTCLASSWASTOHAVECOMMON
Q: 7HICHISGOODBECAUSE
CODETHATCOULDBEINHERITEDBYSUBCLASSES
A: 0OLYMORPHISM2EMEMBERWHATYOUWANTISTHE
A: )NHERITABLEMETHODIMPLEMENTATIONSINOTHERWORDS
METHODSWITHACTUALBODIES ARE!'OOD4HINGTOPUTINA
ABILITYTOUSEASUPERCLASSTYPEOFTENABSTRACT ASAMETHOD
ARGUMENTRETURNTYPEORARRAYTYPE4HATWAYYOUGETTO
ADDNEWSUBTYPESLIKEANEW!NIMALSUBCLASS TOYOUR
SUPERCLASS7HENITMAKESSENSE!NDINANABSTRACTCLASSIT PROGRAMWITHOUTHAVINGTOREWRITEORADD NEWMETHODS
OFTENDOESNTMAKESENSEBECAUSEYOUCANTCOMEUPWITH TODEALWITHTHOSENEWTYPES)MAGINEHOWYOUDHAVETO
ANYGENERICCODETHATSUBCLASSESWOULDFINDUSEFUL4HE CHANGETHE6ETCLASSIFITDIDNTUSE!NIMALASITSARGUMENT
POINTOFANABSTRACTMETHODISTHATEVENTHOUGHYOUHAVENT TYPEFORMETHODS9OUDHAVETOHAVEASEPARATEMETHOD
PUTINANYACTUALMETHODCODEYOUVESTILLDEFINEDPARTOF FOREVERYSINGLE!NIMALSUBCLASS/NETHATTAKESA,IONONE
THEPROTOCOLFORAGROUPOFSUBTYPESSUBCLASSES THATTAKESA7OLFONETHATTAKESAYOUGETTHEIDEA3OWITH
ANABSTRACTMETHODYOURESAYINGh!LLSUBTYPESOFTHISTYPE
HAVE4()3METHODvFORTHEBENEFITOFPOLYMORPHISM
\RXDUHKHUH
\RXPXVWLPSOHPHQWDEVWUDFWPHWKRGV
AW]5=;<QUXTMUMV\ITTIJ[\ZIK\UM\PWL[
,KDYHZRQGHUIXOQHZV
PRWKHU-RHÀQDOO\LPSOHPHQWHG
DOOKLVDEVWUDFWPHWKRGV1RZ
HYHU\WKLQJLVZRUNLQJMXVWWKH
ZD\ZHSODQQHG
,PSOHPHQWLQJDQDEVWUDFW
PHWKRGLVMXVWOLNH
RYHUULGLQJDPHWKRG
!BSTRACTMETHODSDONTHAVEABODYTHEYEXISTSOLELYFORPOLYMORPHISM4HAT
MEANSTHElRSTCONCRETECLASSINTHEINHERITANCETREEMUSTIMPLEMENTALLABSTRACT
METHODS
9OUCANHOWEVERPASSTHEBUCKBYBEINGABSTRACTYOURSELF)FBOTH!NIMALAND
#ANINEAREABSTRACTFOREXAMPLEANDBOTHHAVEABSTRACTMETHODSCLASS#ANINE
DOESNOTHAVETOIMPLEMENTTHEABSTRACTMETHODSFROM!NIMAL"UTASSOONASWE
GETTOTHElRSTCONCRETESUBCLASSLIKE$OGTHATSUBCLASSMUSTIMPLEMENTALLOFTHE
ABSTRACTMETHODSFROMBOTH!NIMALAND#ANINE
"UTREMEMBERTHATANABSTRACTCLASSCANHAVEBOTHABSTRACTANDNON ABSTRACT
METHODSSO#ANINEFOREXAMPLECOULDIMPLEMENTANABSTRACTMETHODFROM
!NIMALSOTHAT$OGDIDNTHAVETO"UTIF#ANINESAYSNOTHINGABOUTTHEABSTRACT
METHODSFROM!NIMAL$OGHASTOIMPLEMENTALLOF!NIMALSABSTRACTMETHODS
7HENWESAYhYOUMUSTIMPLEMENTTHEABSTRACTMETHODvTHATMEANSYOUMUST
PROVIDEABODY4HATMEANSYOUMUSTCREATEANON ABSTRACTMETHODINYOURCLASS
WITHTHESAMEMETHODSIGNATURENAMEANDARGUMENTS ANDARETURNTYPETHATIS
COMPATIBLEWITHTHEDECLAREDRETURNTYPEOFTHEABSTRACTMETHOD7HATYOUPUTIN
THATMETHODISUPTOYOU!LL*AVACARESABOUTISTHATTHEMETHODISTHEREINYOUR
CONCRETESUBCLASS
FKDSWHU
6KDUSHQ \RXU SHQFLO !BSTRACTVS#ONCRETE#LASSES

,ETSPUTALLTHISABSTRACTRHETORICINTOSOMECONCRETEUSE)NTHEMIDDLE
COLUMNWEVELISTEDSOMECLASSES9OURJOBISTOIMAGINEAPPLICATIONS
WHERETHELISTEDCLASSMIGHTBECONCRETEANDAPPLICATIONSWHERETHELISTED
CLASSMIGHTBEABSTRACT7ETOOKASHOTATTHElRSTFEWTOGETYOUGOING
&OREXAMPLECLASS4REEWOULDBEABSTRACTINATREENURSERYPROGRAMWHERE
DIFFERENCESBETWEENAN/AKANDAN!SPENMATTER"UTINAGOLFSIMULATION
PROGRAM4REEMIGHTBEACONCRETECLASSPERHAPSASUBCLASSOF/BSTACLE
BECAUSETHEPROGRAMDOESNTCAREABOUTORDISTINGUISHBETWEENDIFFERENT
TYPESOFTREES4HERESNOONERIGHTANSWERITDEPENDSONYOURDESIGN
#ONCRETE 3AMPLECLASS !BSTRACT
OWTNKW]Z[M[QU]TI\QWV 4REE \ZMMV]Z[MZaIXXTQKI\QWV
???????????????????? (OUSE IZKPQ\MK\IXXTQKI\QWV
[I\MTTQ\MXPW\WIXXTQKI\QWV 4OWN ?????????????????????
???????????????????? &OOTBALL0LAYER KWIKPQVOIXXTQKI\QWV
???????????????????? #HAIR ?????????????????????
???????????????????? #USTOMER ?????????????????????
???????????????????? 3ALES/RDER ?????????????????????
???????????????????? "OOK ?????????????????????
???????????????????? 3TORE ?????????????????????
???????????????????? 3UPPLIER ?????????????????????
???????????????????? 'OLF#LUB ?????????????????????
???????????????????? #ARBURETOR ?????????????????????
???????????????????? /VEN ?????????????????????
\RXDUHKHUH
SRO\PRUSKLVPH[DPSOHV
8WTaUWZXPQ[UQVIK\QWV
,ETSSAYTHATWEWANTTOWRITEOUROWNKINDOFLISTCLASSONETHATWILLHOLD
$OGOBJECTSBUTPRETENDFORAMOMENTTHATWEDONTKNOWABOUTTHE
!RRAY,ISTCLASS&ORTHElRSTPASSWELLGIVEITJUSTANADD METHOD7ELLUSE
ASIMPLE$OGARRAY$OG;= TOKEEPTHEADDED$OGOBJECTSANDGIVEITA
LENGTHOF7HENWEREACHTHELIMITOF$OGOBJECTSYOUCANSTILLCALLTHE
ADD METHODBUTITWONTDOANYTHING)FWERENOTATTHELIMITTHEADD
METHODPUTSTHE$OGINTHEARRAYATTHENEXTAVAILABLEINDEXP OSITIONTHEN
INCREMENTSTHATNEXTAVAILABLEINDEXNEXT)NDEX
%XLOGLQJRXURZQ'RJVSHFLÀFOLVW
3HUKDSVWKHZRUOG·VZRUVWDWWHPSWDWPDNLQJRXU
RZQ$UUD\/LVWNLQGRI FODVVIURPVFUDWFK
E RSI O 'RJDUUD\
SXEOLFFODVV0\'RJ/LVW^ 8VHDSODLQRVFOGHQHV
N
V

SULYDWH'RJ>@GRJV QHZ'RJ>@
EHKLQGWKH
0\'RJ/LVW
K
'RJ>@GRJV
SULYDWHLQWQH[W,QGH[ :H·OOLQFUHPHQWWKLVHGGDFHG
LQWQH[W,QGH[ WLPHDQHZ'RJ LV D

DGG'RJG SXEOLFYRLGDGG'RJG^
WKHOLPLW
,IZH·UHQRWDOUHDG\DGGWWKH'RJ
LIQH[W,QGH[GRJVOHQJWK^
RIWKHGRJVDUUD\D
GRJV>QH[W,QGH[@ G DQGSULQWDPHVVDJH
6\VWHPRXWSULQWOQ³'RJDGGHGDW³QH[W,QGH[
QH[W,QGH[
LQFUHPHQW
` QH[WLQGH[WWRJLYHXVWKH
RXVH
`
`
FKDSWHU
=PWPVW__MVMML\WSMMX+I\[\WW
7EHAVEAFEWOPTIONSHERE
-AKEASEPARATECLASS-Y#AT,ISTTOHOLD#ATOBJECTS0RETTYCLUNKY
-AKEASINGLECLASS$OG!ND#AT,ISTTHATKEEPSTWODIFFERENTARRAYSASINSTANCE
VARIABLESANDHASTWODIFFERENTADD METHODSADD#AT#ATC ANDADD$OG$OG
D !NOTHERCLUNKYSOLUTION
-AKEHETEROGENEOUS!NIMAL,ISTCLASSTHATTAKESANYKINDOF!NIMALSUBCLASS
SINCEWEKNOWTHATIFTHESPECCHANGEDTOADD#ATSSOONERORLATERWELLHAVE
SOMEOTHERKINDOFANIMALADDEDASWELL 7ELIKETHISOPTIONBESTSOLETSCHANGE
OURCLASSTOMAKEITMOREGENERICTOTAKE!NIMALSINSTEADOFJUST$OGS7EVE
HIGHLIGHTEDTHEKEYCHANGESTHELOGICISTHESAMEOFCOURSEBUTTHETYPEHAS
CHANGEDFROM$OGTO!NIMALEVERYWHEREINTHECODE
%XLOGLQJRXURZQ$QLPDOVSHFLÀFOLVW D
·W S D Q LF : H· UHQRWPDNLQNJLQJD
'RQ MHFWZH·UHPD
SXEOLFFODVV0\$QLPDO/LVW^
QHZ$QLPDOREEMHFWRIW\SH$QLPDO
E RSI O
QHZDUUD\R \RXFDQQRWPDNHDQHZ
N
V
5HPHPEHUDQDEVWUDFWW\SHEXW
SULYDWH$QLPDO>@DQLPDOV QHZ$QLPDO>@
SULYDWHLQWQH[W,QGH[
0\$QLPDO/LVW LQVWDQFHRI DNHDQDUUD\REMHFW
SXEOLFYRLGDGG$QLPDOD^ \RX&$1P +2/'WKDWW\SH
$QLPDO>@DQLPDOV
LIQH[W,QGH[DQLPDOVOHQJWK^
DQLPDOV>QH[W,QGH[@ D
GHFODUHGWR
LQWQH[W,QGH[
6\VWHPRXWSULQWOQ³$QLPDODGGHGDW³QH[W,QGH[
DGG$QLPDOD QH[W,QGH[

`
`
`
SXEOLFFODVV$QLPDO7HVW'ULYH^
0\$QLPDO/LVWOLVW QHZ0\$QLPDO/LVW
'RJD QHZ'RJ
&DWF QHZ&DW
OLVWDGGD
OLVWDGGF
`
`
)LOH(GLW:LQGRZ+HOS+DUP
MDYD$QLPDO7HVW'ULYH
$QLPDODGGHGDW
$QLPDODGGHGDW
\RXDUHKHUH
WKHXOWLPDWHVXSHUFODVV2EMHFW
?PI\IJW]\VWV)VQUIT['?PaVW\UISM
IKTI[[OMVMZQKMVW]OP\W\ISMIVa\PQVO'
DIHZRIWKH
9OUKNOWWHERETHISISHEADING7EWANTTOCHANGETHE
7KHVHDUHMXVWD\/LVWWKHUH
TYPEOFTHEARRAYALONGWITHTHEADD METHODARGUMENTTO E RSI O
PHWKRGVLQ$UU
N
V
DUHPDQ\PRUH
SOMETHINGABOVE!NIMAL3OMETHINGEVENMOREGENERICMORE
ABSTRACTTHAN!NIMAL"UTHOWCANWEDOIT7EDONTHAVEA
SUPERCLASSFOR!NIMAL
4HENAGAINMAYBEWEDO
!RRAY,IST
2EMEMBERTHOSEMETHODSOF!RRAY,IST
,OOKHOWTHEREMOVECONTAINSAND
INDEX/FMETHODALLUSEANOBJECTOFTYPE LEM
N R E M OVE/BJECTE ER2ETURNS
/BJECT BO O LE A DEXPARAMET
JECTATTHEIN
OB
2EMOVESTHE THELIST
LEMENTWASIN
(YHU\FODVVLQ-DYDH[WHQGV @TRUEIFTHEE
ELEM
FODVV2EMHFW TAINS/BJECT BJEC TPARAM
ETER
BOOLEANCON ATCHFORTHEO
IFTHERESAM
#LASS/BJECTISTHEMOTHEROFALLCLASSESITS 2ETURNS@TRUE
THESUPERCLASSOFEVERYTHING MPTY
BOOLEANIS% LISTHASNOEL
EMENTS
IFTHE
%VENIFYOUTAKEADVANTAGEOFPOLYMORPHISM 2ETURNS@TRUE

YOUSTILLHAVETOCREATEACLASSWITHMETHODS
/BJECTELEM AMETEROR
THATTAKEANDR ETURNYOURPOLYMORPHICTYPE INTINDEX/F ERTHEINDEXOFTHEOBJECTPAR
7ITHOUTACOMMONSUPERCLASSFOREVERYTHING 2ETURNSEITH
TINDEX
/BJECTGETIN
IN*AVATHEREDBENOWAYFORTHEDEVELOPERS THELIST
SPOSITIONIN
HI
OF*AVATOCREATECLASSESWITHMETHODSTHAT ELEMENTATT
2ETURNSTHE
COULDTAKEYOURCUSTOMTYPESTYPESTHEYNEVER
/BJECTELEM RETURNS@TRUE
KNEWABOUTWHENTHEYWROTETHE!RRAY,ISTCLASS BOOLEANADD TTOTHELIST
EN
!DDSTHEELEM
3OYOUWEREMAKINGSUBCLASSESOFCLASS/BJECT
FROMTHEVERYBEGINNINGANDYOUDIDNTEVEN MORE
KNOWIT%VERYCLASSYOUWRITEEXTENDS/BJECT
WITHOUTYOUREVERHAVINGTOSAYIT"UTYOUCAN

THINKOFITASTHOUGHACLASSYOUWRITELOOKSLIKE
\ RIW KH $ UU D\ / LVWPHWKRGVXVHWKH
THIS 0DQ LFW\SH2EMHFW6LQ
FH
SXEOLFFODVV'RJH[WHQGV2EMHFW^` XOWLPDWHSRO\PRUSK LVDVXEFODVVRI2EMHFW
HYHU\FODVVLQ-DYDHWKRGVFDQWDNHDQ\WKLQJ
WKHVH$UUD\/LVWP
"UTWAITAMINUTE$OGALREADYEXTENDSSOMETHING#ANINE
4HATS/+4HECOMPILERWILLMAKE#ANINEEXTEND/BJECT
D V RI -DY D W KHJHWDQGDGG
INSTEAD%XCEPT#ANINEEXTENDS!NIMAL.OPROBLEMTHENTHE 1RWH RNDOLWWOHGLIIHUHQW

COMPILERWILLJUSTMAKE!NIMALEXTEND/BJECT
PHWKRGVDFWXDOO\ORQKHUHEXWIRUQRZWKLV
$Q\FODVVWKDWGRHVQ·WH[SOLFLWO\H[WHQGDQRWKHU WKDQWKHRQHVVKRZ DERXWLW:H·OOJHWLQWR
FODVVLPSOLFLWO\H[WHQGV2EMHFW LVWKHZD\WRWKLQNWOHODWHU
3OSINCE$OGEXTENDS#ANINEITDOESNTDIRECTLYEXTEND/BJECT WKHIXOOVWRU\DOLW
ALTHOUGHITDOESEXTENDITINDIRECTLY ANDTHESAMEISTRUE
FOR#ANINEBUT!NIMALDOESDIRECTLYEXTEND/BJECT
FKDSWHU
;W_PI\¼[QV\PQ[]T\ZI[]XMZUMOIKTI[[7JRMK\'
)FYOUWERE*AVAWHATBEHAVIORWOULDYOUWANTEVERY
OBJECTTOHAVE(MMMMLETSSEEHOWABOUTA 2EMHFW
METHODTHATLETSYOUlNDOUTIFONEOBJECTISEQUAL
TOANOTHEROBJECT7HATABOUTAMETHODTHATCAN ERROHDQHTXDOV
TELLYOUTHEACTUALCLASSTYPEOFTHATOBJECT-AYBEA WKHPHWKRGV
-XVW620(RI
&ODVVJHW&ODVV
METHODTHATGIVESYOUAHASHCODEFORTHEOBJECTSO
RIFODVV2EMHFW
LQWKDVK&RGH
YOUCANUSETHEOBJECTINHASHTABLESWELLTALKABOUT 6WULQJWR6WULQJ
*AVASHASHTABLESINCHAPTERANDAPPENDIX"
/HHERESAGOODONEAMETHODTHATPRINTSOUTA
3TRINGMESSAGEFORTHATOBJECT
<RXU&ODVV+HUH (YHU\FODVV\RXZULWHLQKHULWVDOOWKH
!NDWHATDOYOUKNOW!SIFBYMAGICCLASS/BJECT
DOESINDEEDHAVEMETHODSFORTHOSEFOURTHINGS
PHWKRGVRIFODVV2EMHFW7KHFODVVHV
4HATSNOTALLTHOUGHBUTTHESEARETHEONESWE \RX·YHZULWWHQLQKHULWHGPHWKRGV\RX
REALLYCAREABOUT GLGQ·WHYHQN QRZ\RXKDG
HTXDOV2EMHFWR
KDVK&RGH
'RJD QHZ'RJ
&DWF QHZ&DW &DWF QHZ&DW
6\VWHPRXWSULQWOQFKDVK&RGH
LIDHTXDOVF^ )LOH(GLW:LQGRZ+HOS'URS
KFRGH
3ULQWVRXWDKDVIRU
6\VWHPRXWSULQWOQ³WUXH´
`HOVH^ MDYD7HVW2EMHFW
6\VWHPRXWSULQWOQ³IDOVH´ IRUWKHREMHFW WDVD
`
QRZWKLQNRIL
)LOH(GLW:LQGRZ+HOS6WRS XQLTXH,'
MDYD7HVW2EMHFW
7HOOV\RXLIWZRREMHFWVDUH
IDOVH FRQVLGHUHG¶HTXDO·ZH·OOWDON
DERXWZKDW¶HTXDO·UHDOO\ WR6WULQJ
PHDQVLQDSSHQGL[% &DWF QHZ&DW
6\VWHPRXWSULQWOQFWR6WULQJ
)LOH(GLW:LQGRZ+HOS/DSVH,QWR&RPD
MDYD7HVW2EMHFW
JHW&ODVV
&DWF QHZ&DW &DW#GI
6\VWHPRXWSULQWOQFJHW&ODVV
ULQJPHVVDJH
3ULQWVRXWD6WRIWKHFODVV
)LOH(GLW:LQGRZ+HOS)DLQW
MDYD7HVW2EMHFW *LYHV\RXEDFNWKH ZLWKWKHQDPH QXPEHUZH

FODVVWKDWREMHFWZDV DQGVRPHRWKHU W
FODVV&DW
LQVWDQWLDWHGIURP UDUHO\FDUHDERX
\RXDUHKHUH
2EMHFWDQGDEVWUDFWFODVVHV
WKHUH DUH QR
'XPE 4XHVWLRQV Q: /+BACKTOCLASS/BJECT Q: )FITSSOGOODTOUSE
Q: )SCLASS/BJECTABSTRACT
BEINGNON ABSTRACTSO)GUESS
THATMEANSITSCONCRETE (/7
CANYOULETSOMEBODYMAKEAN
POLYMORPHICTYPESWHY
DONTYOUJUSTMAKE!,,YOUR
METHODSTAKEANDRETURNTYPE
A: .O7ELLNOTINTHEFORMAL
*AVASENSEANYWAY/BJECTISA
/BJECTOBJECT)SNTTHATJUST
ASWEIRDASMAKINGAN!NIMAL
/BJECT
NON ABSTRACTCLASSBECAUSEITS
GOTMETHODIMPLEMENTATION
OBJECT
A: !HHHHTHINKABOUTWHAT
WOULDHAPPEN&ORONETHING
CODETHATALLCLASSESCANINHERIT
ANDUSEOUT OF THE BOXWITHOUT
A: 'OODQUESTION7HYIS
ITACCEPTABLETOMAKEANEW
YOUWOULDDEFEATTHEWHOLE
POINTOF@TYPE SAFETYONE
HAVINGTOOVERRIDETHEMETHODS /BJECTINSTANCE"ECAUSE OF*AVASGREATESTPROTECTION
SOMETIMESYOUJUSTWANTA MECHANISMSFORYOURCODE7ITH
TYPE SAFETY*AVAGUARANTEESTHAT
Q: 4HENCANYOUOVERRIDE
GENERICOBJECTTOUSEASWELLAS
ANOBJECT!LIGHTWEIGHTOBJECT
"YFARTHEMOSTCOMMONUSEOF
YOUWONTASKTHEWRONGOBJECT
TODOSOMETHINGYOUMEANTTO
THEMETHODSIN/BJECT
ANINSTANCEOFTYPE/BJECTISFOR ASKOFANOTHEROBJECTTYPE,IKE
A: 3OMEOFTHEM"UTSOMEOF
THEMAREMARKED¿QDOWHICH
THREADSYNCHRONIZATIONWHICH
YOULLLEARNABOUTINCHAPTER
ASKA&ERRARIWHICHYOUTHINKISA
4OASTER TOCOOKITSELF
"UTTHETRUTHISYOUDONTHAVE
&ORNOWJUSTSTICKTHATONTHE
MEANSYOUCANTOVERRIDETHEM BACKBURNERANDASSUMETHAT TOWORRYABOUTTHATFIERY&ERRARI
9OUREENCOURAGEDSTRONGLY TO YOUWILLRARELYMAKEOBJECTSOF SCENARIOEVENIFYOUDOUSE
OVERRIDEHASH#ODE EQUALS TYPE/BJECTEVENTHOUGHYOU /BJECTREFERENCESFOREVERYTHING
ANDTO3TRING INYOUROWN CAN "ECAUSEWHENOBJECTSARE
CLASSESANDYOULLLEARNHOWTO REFERREDTOBYAN/BJECT
DOTHATALITTLELATERINTHEBOOK
"UTSOMEOFTHEMETHODSLIKE Q: 3OISITFAIRTOSAYTHATTHE
REFERENCETYPE*AVATHINKSITS
REFERRINGTOANINSTANCEOFTYPE
GET#LASS DOTHINGSTHATMUST MAINPURPOSEFORTYPE/BJECT /BJECT!NDTHATMEANSTHE
WORKINASPECIFICGUARANTEED ISSOTHATYOUCANUSEITFORA ONLYMETHODSYOUREALLOWEDTO
WAY POLYMORPHICARGUMENTAND CALLONTHATOBJECTARETHEONES
RETURNTYPE,IKEIN!RRAY,IST DECLAREDINCLASS/BJECT3OIF
Q: )F!RRAY,ISTMETHODSARE
GENERICENOUGHTOUSE/BJECT A: 4HE/BJECTCLASSSERVES
YOUWERETOSAY
2EMHFWR QHZ)HUUDUL
THENWHATDOESITMEANTOSAY TWOMAINPURPOSESTOACTASA RJR)DVW1RWOHJDO
!RRAY,IST$OT#OM)THOUGHT POLYMORPHICTYPEFORMETHODS
)WASRESTRICTINGTHE!RRAY,ISTTO THATNEEDTOWORKONANYCLASS 9OUWOULDNTEVENMAKEITPAST
HOLDONLY$OT#OMOBJECTS THATYOUORANYONEELSEMAKES THECOMPILER
ANDTOPROVIDEREALMETHODCODE
A: 9OUWERERESTRICTINGIT
0RIORTO*AVA!RRAY,ISTS
THATALLOBJECTSIN*AVANEEDAT
RUNTIMEANDPUTTINGTHEMIN
"ECAUSE*AVAISASTRONGLY TYPED
LANGUAGETHECOMPILERCHECKS
CLASS/BJECTMEANSALLOTHER TOMAKESURETHATYOURECALLING
COULDNTBERESTRICTED4HEY CLASSESINHERITTHEM 3OMEOF AMETHODONANOBJECTTHATS
WEREALLESSENTIALLYWHATYOU THEMOSTIMPORTANTMETHODSIN ACTUALLYCAPABLEOFRESPONDING
GETIN*AVATODAYIFYOUWRITE /BJECTARERELATEDTOTHREADS )NOTHERWORDSYOUCANCALLA
!RRAY,IST/BJECT)NOTHER ANDWELLSEETHOSELATERINTHE METHODONANOBJECTREFERENCE
WORDSAN!RRAY,ISTRESTRICTED BOOK ONLYIFTHECLASSOFTHEREFERENCE
TOANYTHINGTHATSAN/BJECT
TYPEACTUALLYHASTHEMETHOD
WHICHMEANSANYOBJECTIN*AVA
7ELLCOVERTHISINMUCHGREATER
INSTANTIATEDFROMANYCLASSTYPE
DETAILALITTLELATERSODONTWORRY
7ELLCOVERTHEDETAILSOFTHISNEW
IFTHEPICTUREISNTCRYSTALCLEAR
TYPESYNTAXLATERINTHEBOOK
FKDSWHU
=[QVOXWTaUWZXPQKZMNMZMVKM[WN\aXM7JRMK\PI[IXZQKM
"EFOREYOURUNOFFANDSTARTUSINGTYPE/BJECTFORALLYOURULTRA mEXIBLEARGUMENTANDRETURN
TYPESYOUNEEDTOCONSIDERALITTLEISSUEOFUSINGTYPE/BJECTASAREFERENCE!NDKEEPINMIND
THATWERENOTTALKINGABOUTMAKINGINSTANCESOFTYPE/BJECTWERETALKINGABOUTMAKING
INSTANCESOFSOMEOTHERTYPEBUTUSINGAREFERENCEOFTYPE/BJECT
7HENYOUPUTANOBJECTINTOAN!RRAY,IST$OGITGOESINASA$OGANDCOMESOUTASA$OG
G
0DNHDQ$UUD\/LVWGHFODUH
$UUD\/LVW'RJ!P\'RJ$UUD\/LVW QHZ$UUD\/LVW'RJ! V
WRKROG'RJREMHFW
'RJD'RJ QHZ'RJ 0DNHD'RJ
P\'RJ$UUD\/LVWDGGD'RJ $GGWKH'RJWRWKHOLVW ULDEOH
WRDQHZ'RJUHIHUHQFHYD UHWXUQ
$VVLJQWKH'RJIURPWKHOLVW
JHWPHWKRGGHFO DUH VD ' RJ
'RJG P\'RJ$UUD\/LVWJHW
7KLQNRILWDVWKRXJKWKH \/LVW'RJ!
W\SHEHFDXVH\RXXVHG $ UUD
"UTWHATHAPPENSWHENYOUDECLAREITAS!RRAY,IST/BJECT)FYOUWANTTOMAKEAN!RRAY,IST
THATWILLLITERALLYTAKEANYKINDOF/BJECTYOUDECLAREITLIKETHIS
G
$UUD\/LVW2EMHFW!P\'RJ$UUD\/LVW QHZ$UUD\/LVW2EMHFW!
0DNHDQ$UUD\/LVWGHFODUH
WRKROGD Q\ W\S HR I2EMHFW
'RJD'RJ QHZ'RJ 0DNHD'RJ 7KHVHWZRVWHSVDUHWKHVDPH
P\'RJ$UUD\/LVWDGGD'RJ $GGWKH'RJWRWKHOLVW
"UTWHATHAPPENSWHENYOUTRYTOGETTHE$OGOBJECTANDASSIGNITTOA$OGREFERENCE
'RJG
G P\'RJ$UUD\/LVWJHW
P\'
P
P 12:RQ·WFRPSLOH:KHQ\RXXVH$UUD\/LVW2EMHFW!WKHJHWPHWKRG
UHWXUQVW\SH2EMHFW7KH&RPSLOHUNQRZVRQO\WKDWWKHREMHFWLQKHULWVIURP
2EMHFWVRPHZKHUHLQLWVLQKHULWDQFHWUHHEXWLWGRHVQ·WNQRZLW·VD'RJ
%VERYTHINGCOMESOUTOFAN!RRAY,IST/BJECTASAREFERENCEOFTYPE/BJECTREGARDLESSOFWHATTHE
ACTUALOBJECTISORWHATTHEREFERENCETYPEWASWHENYOUADDEDTHEOBJECTTOTHELIST
7KHREMHFWVJR,1
DV6RFFHU%DOO 2EMHFWVFRPHRXWRI
)LVK*XLWDUDQG DQ$UUD\/LVW2EMHFW!
&DU DFWLQJOLNHWKH\·UH
JHQHULFLQVWDQFHV
RIFODVV2EMHFW7KH
$UUD\/LVW2EMHFW! &RPSLOHUFDQQRW
DVVXPHWKHREMHFW
%XWWKH\FRPH WKDWFRPHVRXWLVRI
287DVWKRXJK DQ\W\SHRWKHUWKDQ
WKH\ZHUHRIW\SH 2EMHFW
2EMHFW 2EMHFW 2EMHFW 2EMHFW 2EMHFW
\RXDUHKHUH
:KHQD'RJORVHVLWV'RJQHVV
?PMVI,WO_WV¼\IK\TQSMI,WO ,GRQ·WNQRZZKDW\RX·UH
WDONLQJDERXW6LW"6WD\"
4HEPROBLEMWITHHAVINGEVERYTHINGTREATED EDUN"+PPPP,GRQ·W
POLYMORPHICALLYASAN/BJECTISTHATTHEOBJECTS UHFDOONQRZLQJWKRVH
APPEARTOLOSEBUTNOTPERMANENTLY THEIR
TRUEESSENCE4HE$OGAPPEARSTOLOSEITSDOGNESS
,ETSSEEWHATHAPPENSWHENWEPASSA$OGTO
AMETHODTHATRETURNSAREFERENCETOTHESAME
$OGOBJECTBUTDECLARESTHERETURNTYPEASTYPE
/BJECTRATHERTHAN$OG
KHPHWKRGKH
Licensed by Q W K RX J KW
Q·WZRUN(
YH RJW
SXEOLFYRLGJR^
HU\VDPH'
'RJD'RJ QHZ'RJ 7KLVOLQHZRUHIHUHQFHWRWKHYHWXUQW\SH2EMHFW UQHG
%$' 'RJVDPH'RJ JHW2EMHFWD'RJ
J J
UHWXUQHGDUHIHUUHGWRWKHU \RXDVVLJQWKHUHWX
/ ` DUJXPHQW FRPSLOHUZRQ·WOHW EMHFW
PHDQVWKH WRDQ\WKLQJEXW2
UHWXUQR
`
Eduard Simons
SXEOLF2EMHFWJHW2EMHFW2EMHFWR^
UHIHUHQFH
QFHWRWKHVDPH'RJEXW
DVD
:H·UHUHWXUQLQJDUHIHUH7KLVSDUWLVSHUIHFWO\OHJDO1RWH
UHWXUQW\SHRI2EMHFW JHWPHWKRGZRUNVZKHQ\RXKDYH
104038
WKLVLVVLPLODUWRKRZWKH WKHUWKDQDQ$UUD\/LVW'RJ!
DQ$UUD\/LVW2EMHFW!UD
)LOH(GLW:LQGRZ+HOS5HPHPEHU
'RJ3RO\7HVWMDYDLQFRPSDWLEOHW\SHV
7KHFRPSLOHUGRHVQ·WNQRZWKDWWKH
IRXQGMDYDODQJ2EMHFW
WKLQJUHWXUQHGIURPWKHPHWKRGLV
DFWXDOO\D'RJVRLWZRQ·WOHW\RX
UHTXLUHG'RJ
DVVLJQLWWRD'RJUHIHUHQFH<RX·OO
'RJVDPH'RJ WDNH2EMHFWVD'RJ
VHHZK\RQWKHQH[WSDJH
HUURUA
SXEOLFYRLGJR^ 7KLVZRUNVDOWKRXJKLWPD\QRWEHYHU\

'RJD'RJ QHZ'RJ XVHIXODV\RX·OOVHHLQDPRPHQWEHFDXVH\RX
*22' 2EMHFWVDPH'RJ JHW2EMHFWD'RJ FDQDVVLJQ$1<7+,1*WRDUHIHUHQFHRIW\SH
- ` 2EMHFWVLQFHHYHU\FODVVSDVVHVWKH,6 $WHVW
IRU2EMHFW(YHU\REMHFWLQ-DYDLVDQLQVWDQFH
SXEOLF2EMHFWJHW2EMHFW2EMHFWR^ RIW\SH2EMHFWEHFDXVHHYHU\FODVVLQ-DYDKDV
UHWXUQR 2EMHFWDWWKHWRSRILWVLQKHULWDQFHWUHH
`
FKDSWHU
7JRMK\[LWV¼\JIZS
3ONOWWEKNOWTHATWHENANOBJECTIS
REFERENCEDBYAVARIABLEDECLAREDASTYPE
/BJECTITCANTBEASSIGNEDTOAVARIABLE
g
DECLAREDWITHTHEACTUALOBJECTSTYPE
' RJ W
!NDWEKNOWTHATTHISCANHAPPENWHEN REMHF
2EMHFW
ARETURNTYPEORARGUMENTISDECLARED
ASTYPE/BJECTASWOULDBETHECASE
FOREXAMPLEWHENTHEOBJECTISPUT :KHQ\RXJHWDQREMHFWUHIHUHQFHIURP
INTOAN!RRAY,ISTOFTYPE/BJECTUSING
!RRAY,IST/BJECT"UTWHATARETHE
DQ$UUD\/LVW2EMHFW!RUDQ\PHWKRG
IMPLICATIONSOFTHIS)SITAPROBLEMTO WKDWGHFODUHV2EMHFWDVWKHUHWXUQW\SH
HAVETOUSEAN/BJECTREFERENCEVARIABLE LWFRPHVEDFNDVDSRO\PRUSKLFUHIHUHQFH
TOREFERTOA$OGOBJECT,ETSTRYTOCALL W\SHRI2EMHFW6R\RXKDYHDQ2EMHFW
$OGMETHODSONOUR$OG 4HAT #OMPILER UHIHUHQFHWRLQWKLVFDVHD'RJLQVWDQFH
4HINKS )S !N /BJECT
DVD
2EMHFWR DOJHWLQGH[ LQ H & OD VV 2EMHFWK FDQFDOO

7KLVLVI PHWKRGVR\RX WLQ-DYD
LQWL RKDVK&RGH KDVK&RGH KRGRQ$1<REMHF
WKDWPHW
REDUN
RED
RE
:RQ·WFRPSLOH &DQ·WGRWKLV7KH2EMHFWFODVVKDVQRLGHDZKDW
LWPHDQVWREDUN(YHQWKRXJK<28NQRZLW·V
UHDOO\D'RJDWWKDWLQGH[WKHFRPSLOHUGRHVQ·W
KDVK&RG
H
7KHFRPSLOHUGHFLGHVZKHWKHU
\RXFDQFDOODPHWKRGEDVHG
RQWKHUHIHUHQFHW\SHQRWWKH
DFWXDOREMHFWW\SH g
W
' RJ
REMHF
%VENIFYOUKNOWTHEOBJECTISCAPABLE 2EMHFW
hBUTITREALLYISA$OGHONESTv THE
COMPILERSEESITONLYASAGENERIC/BJECT 2EMHFW
7KHPHWKRG\RX·UHFDOOLQJRQD
&ORALLTHECOMPILERKNOWSYOUPUTA HTXDOV UHIHUHQFH0867EHLQWKHFODVVRI
"UTTONOBJECTOUTTHERE/RA-ICROWAVE JHW&ODVV WKDWUHIHUHQFHW\SH'RHVQ·WPDWWHU
OBJECT/RSOMEOTHERTHINGTHATREALLY KDVK&RGH ZKDWWKHDFWXDOREMHFWLV
DOESNTKNOWHOWTOBARK WR6WULQJ
4HECOMPILERCHECKSTHECLASSOFTHE
REFERENCETYPENOTTHEOBJECTTYPETO RKDVK&RGH
SEEIFYOUCANCALLAMETHODUSINGTHAT
REFERENCE
7KH´RµUHIHUHQFHZDVGHFODUHGDVW\SH
2EMHFWVR\RXFDQFDOOPHWKRGVRQO\LI
WKRVHPHWKRGVDUHLQFODVV2EMHFW
\RXDUHKHUH
REMHFWVDUH2EMHFWV
+HWUHDWVPHOLNHDQ
2EMHFW%XW,FDQGRVR
PXFKPRUHLIRQO\KH·GVHH
PHIRUZKDW,UHDOO\DP
/M\QV\W]KP_Q\Pa W]ZQVVMZ7JRMK\
!NOBJECTCONTAINSEVERYTHINGITINHERITSFROMEACHOFITS
SUPERCLASSES4HATMEANSEVERYOBJECTREGARDLESSOFITS
ACTUALCLASSTYPEISALSOANINSTANCEOFCLASS/BJECT4HAT
MEANSANYOBJECTIN*AVACANBETREATEDNOTJUSTASA$OG
"UTTONOR3NOWBOARDBUTALSOASAN/BJECT7HENYOU
SAYQHZ6QRZERDUGYOUGETASINGLEOBJECTONTHE
HEAPA3NOWBOARDOBJECTBUTTHAT3NOWBOARDWRAPS
ITSELFAROUNDANINNERCOREREPRESENTINGTHE/BJECT
CAPITALh/v PORTIONOFITSELF
2EMHFW
HTXDOV $VLQJOHREMHFW
JHW&ODVV RQWKHKHDS
KDVK&RGH

WR6WULQJ G WXUQ

UH
KDVK
VK
U LQJ
&R
W
W R6
GH
2EMHFW

6QRZERDUG 6QRZERDUGLQKHULWVPHWKRGV
HTX
IURPVXSHUFODVV2EMHFWDQG V
DO
HTXDOV V

JHW
OD
V
JHW&
URO
JHW&ODVV DGGVIRXUPRUH
$L

QW
R
U
KDVK&RGH
ORVH&
WR6WULQJ
6QRZERDUG
WXUQ W
6Q MHF
RZ E
VKUHG
RDUGRE
JHW$LU
ORVH&RQWURO
7KHUHLVRQO\21(REMHFWRQWKHKHDSKHUH$6QRZERDUG
REMHFW%XWLWFRQWDLQVERWKWKH6QRZERDUGFODVVSDUWVRI
LWVHOIDQGWKH2EMHFWFODVVSDUWVRILWVHOI
FKDSWHU
¶3RO\PRUSKLVP·PHDQV :KHQ\RXSXW
¶PDQ\IRUPV· DQREMHFWLQDQ
<RXFDQWUHDWD6QRZERDUGDVD $UUD\/LVW2EMHFW!\RX
6QRZERDUGRUDVDQ2EMHFW FDQWUHDWLWRQO\DVDQ
)FAREFERENCEISLIKEAREMOTECONTROLTHE
2EMHFWUHJDUGOHVVRI
REMOTECONTROLTAKESONMOREANDMOREBUTTONS WKHW\SHLWZDVZKHQ
ASYOUMOVEDOWNTHEINHERITANCETREE! \RXSXWLWLQ
REMOTECONTROLREFERENCE OFTYPE/BJECTHAS
ONLYAFEWBUTTONSTHEBUTTONSFORTHEEXPOSED :KHQ\RXJHWD
METHODSOFCLASS/BJECT"UTAREMOTECONTROL UHIHUHQFHIURPDQ
OFTYPE3NOWBOARDINCLUDESALLTHEBUTTONSFROM $UUD\/LVW2EMHFW!WKH
CLASS/BJECTPLUSANYNEWBUTTONSFORNEW UHIHUHQFHLVDOZD\VRI
METHODS OFCLASS3NOWBOARD4HEMORESPECIlC
W\SH2EMHFW
THECLASSTHEMOREBUTTONSITMAYHAVE
/FCOURSETHATSNOTALWAYSTRUEASUBCLASSMIGHT 7KDWPHDQV\RXJHWDQ
NOTADDANYNEWMETHODSBUTSIMPLYOVERRIDE 2EMHFWUHPRWHFRQWURO
THEMETHODSOFITSSUPERCLASS4HEKEYPOINTIS
THATEVENIFTHEOBJECTISOFTYPE3NOWBOARDAN
/BJECTREFERENCETOTHE3NOWBOARDOBJECTCANTSEE
THE3NOWBOARD SPECIlCMETHODS

6QRZERDUGV QHZ6QRZERDUG UH G WXUQ

K
VK
J DVK
2EMHFWR V ULQ
&R
W
W R6
GH
2EMHFW

HTX

V
DO

JH
OD
V
JHW&
URO
W$
QW
R
LU
ORVH&
V
6QRZERDUG
7KH6QRZERDUGUHPRWHFRQWURO 6Q
RZ E MHF
W
UHIHUHQFHKDVPRUHEXWWRQVWKDQ IHZHUPHWKRGVKHUH RDUGRE
DQ2EMHFWUHPRWHFRQWURO7KH R
6QRZERDUGUHPRWHFDQVHHWKHIXOO
6QRZERDUGQHVVRIWKH6QRZERDUG 7KH2EMHFWUHIHUHQFHFDQVHHRQO\WKH
REMHFW,WFDQDFFHVVDOOWKHPHWKRGV 2EMHFWSDUWVRIWKH6QRZERDUGREMHFW
LQ6QRZERDUGLQFOXGLQJERWKWKH ,WFDQDFFHVVRQO\WKHPHWKRGVRIFODVV
LQKHULWHG2EMHFWPHWKRGVDQGWKH 2EMHFW,WKDVIHZHUEXWWRQVWKDQWKH
PHWKRGVIURPFODVV6QRZERDUG 6QRZERDUGUHPRWHFRQWURO
\RXDUHKHUH
FDVWLQJREMHFWV
:DLWDPLQXWHZKDWJRRG
LVD'RJLILWFRPHVRXWRIDQ
$UUD\/LVW2EMHFW!DQGLWFDQ·WGR &DVWLQJDQREMHFWUHIHUHQFH
DQ\'RJWKLQJV"7KHUH·VJRWWDEHD EDFNWRLWVUHDOW\SH
ZD\WRJHWWKH'RJEDFNWRDVWDWH
RI'RJQHVV
g
W
' RJ
REMHF
2EMHFW
,KRSHLWGRHVQ·WKXUW
)TSREALLYSTILLA$OGOBJECTBUTIFYOUWANTTOCALL
$QGZKDW·VVRZURQJZLWK
VWD\LQJDQ2EMHFW"2.,FDQ·W
$OG SPECIlCMETHODSYOUNEEDAREFERENCEDECLARED
IHWFKVXUHEXW,FDQJLYH\RX
ASTYPE$OG)FYOURESURE
THEOBJECTISREALLYA
DUHDOQLFHKDVKFRGH
$OGYOUCANMAKEANEW$OGREFERENCETOITBY
COPYINGTHE/BJECTREFERENCEANDFORCINGTHAT
COPYTOGOINTOA$OGREFERENCEVARIABLEUSINGA
CAST$OG 9OUCANUSETHENEW$OGREFERENCETO
CALL$OGMETHODS
EMHFWEDFNUHWR
2EMHFWR DOJHWLQGH[
'RJG 'RJR FDVWWKH2NQ LVWKH
GURDP D'RJZH RZ
g
' RJ W
REMHF
2EMHFW
&DVWWKHVRFDOOHG¶2EMHFW·EXW
ZHNQRZKH·VDFWXDOO\D'RJWR \
W\SH'RJVRWKDW\RXFDQWUHDW
'RJ
KLPOLNHWKH'RJKHUHDOO\LV

)FYOURENOTSUREITSA$OGYOUCANUSETHE
LQVWDQFHRIOPERATORTOCHECK"ECAUSEIF
YOUREWRONGWHENYOUDOTHECASTYOULLGETA
#LASS#AST%XCEPTIONATRUNTIMEANDCOMETOA
GRINDINGHALT
LIRLQVWDQFHRI'RJ^
'RJG 'RJR
`
FKDSWHU
6RQRZ\RX·YHVHHQKRZPXFK-DYD
FDUHVDERXWWKHPHWKRGVLQWKH
FODVVRIWKHUHIHUHQFHYDULDEOH
<RXFDQFDOODPHWKRGRQDQREMHFWRQO\LI
WKHFODVVRIWKHUHIHUHQFHYDULDEOHKDVWKDW
PHWKRG
7KLQNRIWKHSXEOLFPHWKRGVLQ\RXUFODVVDV
\RXUFRQWUDFW\RXUSURPLVHWRWKHRXWVLGH
ZRUOGDERXWWKHWKLQJV\RXFDQGR
7HENYOUWRITEACLASSYOUALMOSTALWAYSEXPOSESOME
OFTHEMETHODSTOCODEOUTSIDETHECLASS4OEXPOSEA
METHODMEANSYOUMAKEAMETHODACCESSIBLEUSUALLYBY
MARKINGITPUBLIC
)MAGINETHISSCENARIOYOUREWRITINGCODEFORASMALL
BUSINESSACCOUNTINGPROGRAM!CUSTOMAPPLICATION
FORh3IMONS3URF3HOPv4HEGOODRE
$FFRXQW
USERTHATYOUAREYOUFOUNDAN!CCOUNT
CLASSTHATAPPEARSTOMEETYOURNEEDS GHELWGRXEOHDPW
PERFECTLYACCORDINGTOITSDOCUMENTATION
ANYWAY%ACHACCOUNTINSTANCEREPRESENTS FUHGLWGRXEOHDPW
ANINDIVIDUALCUSTOMERSACCOUNTWITHTHE
GRXEOHJHW%DODQFH
STORE3OTHEREYOUAREMINDINGYOUROWN
BUSINESSINVOKINGTHECREDIT ANDDEBIT
METHODSONANACCOUNTOBJECTWHENYOUREALIZEYOU
NEEDTOGETABALANCEONANACCOUNT.OPROBLEM
THERESAGET"ALANCE METHODTHATSHOULDDONICELY
%XCEPTWHENYOUINVOKETHEGET"ALANCE METHOD
THEWHOLETHINGBLOWSUPATRUNTIME&ORGETTHE
DOCUMENTATIONTHECLASSDOESNOTHAVETHATMETHOD
9IKES
"UTTHATWONTHAPPENTOYOUBECAUSEEVERYTIMEYOU
USETHEDOTOPERATORONAREFERENCEADO3TUFF THE
COMPILERLOOKSATTHEREFERENCETYPETHETYPE@AWAS
DECLAREDTOBE ANDCHECKSTHATCLASSTOGUARANTEETHE
CLASSHASTHEMETHODANDTHATTHEMETHODDOESINDEED
TAKETHEARGUMENTYOUREPASSINGANDRETURNTHEKINDOF
VALUEYOUREEXPECTINGTOGETBACK
*USTREMEMBERTHATTHECOMPILERCHECKSTHECLASSOFTHE
REFERENCEVARIABLENOTTHECLASSOFTHEACTUALOBJECTATTHE
OTHERENDOFTHEREFERENCE
\RXDUHKHUH
PRGLI\LQJDFODVVWUHH
?PI\QNaW]VMML\WKPIVOM
\PMKWV\ZIK\'
/+PRETENDYOUREA$OG9OUR$OGCLASS
ISNTTHEONLYCONTRACTTHATDElNESWHOYOU
ARE2EMEMBERYOUINHERITACCESSIBLEWHICH
USUALLYMEANSPUBLIC METHODSFROMALLOF
YOURSUPERCLASSES
4RUEYOUR$OGCLASSDElNESACONTRACT
"UTNOTALLOFYOURCONTRACT YiXè
%VERYTHINGINCLASS#ANINEISPARTOFYOUR gfn\i
CONTRACT
%VERYTHINGINCLASS!NIMALISPARTOFYOUR
CONTRACT 7KLQNDERXWZKDW<28ZRXOGGRLI<28ZHUH
%VERYTHINGINCLASS/BJECTISPARTOFYOUR WKH'RJFODVVSURJUDPPHUDQGQHHGHGWR
CONTRACT PRGLI\WKH'RJVRWKDWLWFRXOGGR3HWWKLQJV
!CCORDINGTOTHE)3 !TESTYOUAREEACHOF WRR:HNQRZWKDWVLPSO\DGGLQJQHZ3HWEH
THOSETHINGS#ANINE!NIMALAND/BJECT KDYLRUVPHWKRGVWRWKH'RJFODVVZLOOZRUN
"UTWHATIFTHEPERSONWHODESIGNEDYOUR DQGZRQ·WEUHDNDQ\RQHHOVH·VFRGH
CLASSHADINMINDTHE!NIMALSIMULATION %XWWKLVLVD3HW6KRSSURJUDP,WKDVPRUH
PROGRAMANDNOWHEWANTSTOUSEYOUCLASS
WKDQMXVW'RJV$QGZKDWLIVRPHRQHZDQWV
$OG FORA3CIENCE&AIR4UTORIALON!NIMAL
OBJECTS WRXVH\RXU'RJFODVVIRUDSURJUDPWKDWKDV
ZLOG'RJV":KDWGR\RXWKLQN\RXURSWLRQV
4HATS/+YOUREPROBABLYREUSABLEFORTHAT
PLJKWEHDQGZLWKRXWZRUU\LQJDERXWKRZ
"UTWHATIFLATERHEWANTSTOUSEYOUFORA -DYDKDQGOHVWKLQJVMXVWWU\WRLPDJLQHKRZ
0ET3HOPPROGRAM9OUDONTHAVEANY0ET
\RX·GOLNHWRVROYHWKHSUREOHPRIPRGLI\LQJ
BEHAVIORS!0ETNEEDSMETHODSLIKEBE&RIENDLY
ANDPLAY VRPHRI\RXU$QLPDOFODVVHVWRLQFOXGH3HW
EHKDYLRUV
/+NOWPRETENDYOURETHE$OGCLASS
PROGRAMMER.OPROBLEMRIGHT*USTADD 6WRSULJKWQRZDQGWKLQNDERXWLW
SOMEMOREMETHODSTOTHE$OGCLASS9OU EHIRUH\RXORRNDWWKHQH[WSDJHZKHUHZH
WONTBEBREAKINGANYONEELSESCODEBY
EHJLQWRUHYHDOHYHU\WKLQJ
ADDINGMETHODSSINCEYOUARENTTOUCHING
THEEXISTINGMETHODSTHATSOMEONEELSESCODE WKXVUHQGHULQJWKHZKROHH[HUFLVHFRPSOHWHO\XVHOHVVUREELQJ
MIGHTBECALLINGON$OGOBJECTS \RXRI\RXU2QH%LJ&KDQFHWREXUQVRPHEUDLQFDORULHV
#ANYOUSEEANYDRAWBACKSTOTHATAPPROACH
ADDING0ETMETHODSTOTHE$OGCLASS
FKDSWHU
4M\¼[M`XTWZM[WUMLM[QOVWX\QWV[
NWZZM][QVO[WUMWNW]ZM`Q[\QVO
KTI[[M[QVI8M\;PWXXZWOZIU
/NTHENEXTFEWPAGESWEREGOINGTOWALKTHROUGH
SOMEPOSSIBILITIES7ERENOTYETWORRIEDABOUT
WHETHER*AVACANACTUALLYDOWHATWECOMEUPWITH
7ELLCROSSTHATBRIDGEONCEWEHAVEAGOODIDEAOF
SOMEOFTHETRADEOFFS
7X\QWVWVM
:HWDNHWKHHDV\SDWKDQGSXWSHW
PHWKRGVLQFODVV$QLPDO
D O O W KHSHW SKHUH
8ZW[" SXW GFRGHX
$OOWKH$QLPDOVZLOOLQVWDQWO\LQKHULW PHWKR KHULWDQFH
WKHSHWEHKDYLRUV:HZRQ·WKDYHWR IRULQ
WRXFKWKHH[LVWLQJ$QLPDOVXEFODVVHV
DWDOODQGDQ\$QLPDOVXEFODVVHV $QLPDO
FUHDWHGLQWKHIXWXUHZLOODOVRJHWWR
WDNHDGYDQWDJHRILQKHULWLQJWKRVH
PHWKRGV7KDWZD\FODVV$QLPDOFDQ
EHXVHGDVWKHSRO\PRUSKLFW\SHLQ
DQ\SURJUDPWKDWZDQWVWRWUHDWWKH
$QLPDOVDVSHWV &DQLQH
+WV[" +LSSR
6RZKHQZDVWKHODVWWLPH\RX
VDZD+LSSRDWDSHWVKRS"/LRQ" )HOLQH
:ROI"&RXOGEHGDQJHURXVWRJLYH
QRQSHWVSHWPHWKRGV 'RJ
$OVRZHDOPRVWFHUWDLQO\:,//
KDYHWRWRXFKWKHSHWFODVVHV
&DW
OLNH'RJDQG&DWEHFDXVHLQ :ROI
RXUKRXVHDQ\ZD\'RJV
DQG&DWVWHQGWRLPSOH /LRQ
PHQWSHWEHKDYLRUV 7LJHU
9(5<GLIIHUHQWO\
\RXDUHKHUH
PRGLI\LQJH[LVWLQJFODVVHV

7X\QWV\ _W
:HVWDUWZLWK2SWLRQ2QHSXWWLQJWKHSHWPHWKRGV
LQFODVV$QLPDOEXWZHPDNHWKHPHWKRGVDEVWUDFW
IRUFLQJWKH$QLPDOVXEFODVVHVWRRYHUULGHWKHP
8ZW["

7KDWZRXOGJLYHXVDOOWKHEHQHÀWVRI2SWLRQ2QHEXWZLWK
S HW P HWKRGV
OWKH KQR
RXWWKHGUDZEDFNRIKDYLQJQRQSHW$QLPDOVUXQQLQJDURXQG
ZLWKSHWPHWKRGVOLNHEH)ULHQGO\$OO$QLPDOFODVVHV SXWDHOUHEXWZLQWV0DNHDOO
ZRXOGKDYHWKHPHWKRGEHFDXVHLW·VLQFODVV$QLPDOEXW XSK HPHQWDWLR DEVWUDFW
EHFDXVHLW·VDEVWUDFWWKHQRQSHW$QLPDOFODVVHVZRQ·W LPSO PHWKRGV
LQKHULWDQ\IXQFWLRQDOLW\$OOFODVVHV0867RYHUULGHWKH SHW
PHWKRGVEXWWKH\FDQPDNHWKHPHWKRGV´GRQRWKLQJVµ
$QLPDO
+WV["
%HFDXVHWKHSHWPHWKRGVLQWKH$QLPDOFODVVDUHDOO
DEVWUDFWWKHFRQFUHWH$QLPDOVXEFODVVHVDUHIRUFHGWR
LPSOHPHQWDOORIWKHP5HPHPEHUDOODEVWUDFWPHWKRGV
0867EHLPSOHPHQWHGE\WKHÀUVWFRQFUHWHVXEFODVV
GRZQWKHLQKHULWDQFHWUHH:KDWDZDVWHRIWLPH &DQLQH
<RXKDYHWRVLWWKHUHDQGW\SHLQHDFKDQGHYHU\
+LSSR
SHWPHWKRGLQWRHDFKDQGHYHU\FRQFUHWHQRQ
SHWFODVVDQGDOOIXWXUHVXEFODVVHVDVZHOO
$QGZKLOHWKLVGRHVVROYHWKHSUREOHPRI )HOLQH
QRQSHWVDFWXDOO\'2,1*SHWWKLQJV
DVWKH\ZRXOGLIWKH\LQKHULWHGSHW 'RJ
IXQFWLRQDOLW\IURPFODVV$QLPDOWKH
FRQWUDFWLVEDG(YHU\QRQSHW
FODVVZRXOGEHDQQRXQFLQJWRWKH
ZRUOGWKDWLWWRRKDVWKRVH &DW
:ROI
SHWPHWKRGVHYHQWKRXJK
WKHPHWKRGVZRXOGQ·W
DFWXDOO\'2DQ\WKLQJ /LRQ
ZKHQFDOOHG 7LJHU
7KLVDSSURDFKGRHVQ·W
ORRNJRRGDWDOO,WMXVW $VNPHWREHIULHQGO\
VHHPVZURQJWRVWXII 1RVHULRXVO\DVNPH
HYHU\WKLQJLQWRFODVV$QLPDO ,KDYHWKHPHWKRG
WKDWPRUHWKDQRQH$QLPDOW\SH
PLJKWQHHG81/(66LWDSSOLHVWR
$//$QLPDOVXEFODVVHV
FKDSWHU
7X\QWV\PZMM
3XWWKHSHWPHWKRGV21/<LQWKH
FODVVHVZKHUHWKH\EHORQJ
8ZW["
1RPRUHZRUULHVDERXW+LSSRVJUHHWLQJ\RXDWWKH
GRRURUOLFNLQJ\RXUIDFH7KHPHWKRGVDUHZKHUH
WKH\EHORQJDQG21/<ZKHUHWKH\EHORQJ'RJVFDQ
LQWKH
WKRGV21E/H<SHWV
LPSOHPHQWWKHPHWKRGVDQG&DWVFDQLPSOHPHQWWKH
PHWKRGVEXWQRERG\HOVHKDVWRNQRZDERXWWKHP K H S H W P H
3XWW ODVVHVWKDWFDQ
$QLPDOF ILQ$QLPDO
+WV[" LQVWHDGR
7ZR%LJ3UREOHPVZLWKWKLVDSSURDFK)LUVWRII\RX·G
KDYHWRDJUHHWRDSURWRFRODQGDOOSURJUDPPHUVRI
SHW$QLPDOFODVVHVQRZDQGLQWKHIXWXUHZRXOGKDYH
WR.12:DERXWWKHSURWRFRO%\SURWRFROZHPHDQ $QLPDO
WKHH[DFWPHWKRGVWKDWZH·YHGHFLGHGDOOSHWVVKRXOG
KDYH7KHSHWFRQWUDFWZLWKRXWDQ\WKLQJWREDFNLWXS
%XWZKDWLIRQHRIWKHSURJUDPPHUVJHWVLWMXVWDWLQ\
ELWZURQJ"/LNHDPHWKRGWDNHVD6WULQJZKHQLWZDV
VXSSRVHGWRWDNHDQLQW"2UWKH\QDPHGLWGR)ULHQGO\
LQVWHDGRIEH)ULHQGO\"6LQFHLWLVQ·WLQDFRQWUDFW &DQLQH
WKHFRPSLOHUKDVQRZD\WRFKHFN\RXWRVHHLI\RX·YH
+LSSR
LPSOHPHQWHGWKHPHWKRGVFRUUHFWO\6RPHRQH
FRXOGHDVLO\FRPHDORQJWRXVHWKHSHW$QLPDO
FODVVHVDQGÀQGWKDWQRWDOORIWKHPZRUN )HOLQH
TXLWHULJKW
'RJ
$QGVHFRQG\RXGRQ·WJHWWRXVH
SRO\PRUSKLVPIRUWKHSHWPHWKRGV
(YHU\FODVVWKDWQHHGVWRXVH
SHWEHKDYLRUVZRXOGKDYHWR &DW
:ROI
NQRZDERXWHDFKDQGHYHU\
FODVV,QRWKHUZRUGV
/LRQ
\RXFDQ·WXVH$QLPDO
7LJHU
DVWKHSRO\PRUSKLF
W\SHQRZEHFDXVHWKH
FRPSLOHUZRQ·WOHW\RXFDOO
D3HWPHWKRGRQDQ$QLPDO
UHIHUHQFHHYHQLILW·VUHDOO\D
'RJREMHFWEHFDXVHFODVV$QLPDO
GRHVQ·WKDYHWKHPHWKRG
\RXDUHKHUH
PXOWLSOHLQKHULWDQFH"
6RZKDWZH5($//<QHHGLV
$ZD\WRKDYHSHWEHKDYLRULQMXVWWKHSHWFODVVHV
$ZD\WRJXDUDQWHHWKDWDOOSHWFODVVHVKDYHDOORIWKHVDPH
PHWKRGVGHILQHGVDPHQDPHVDPHDUJXPHQWVVDPHUHWXUQ
W\SHVQRPLVVLQJPHWKRGVHWFZLWKRXWKDYLQJWRFURVV\RXU
ILQJHUVDQGKRSHDOOWKHSURJUDPPHUVJHWLWULJKW
$ZD\WRWDNHDGYDQWDJHRISRO\PRUSKLVPVRWKDWDOOSHWVFDQKDYH
WKHLUSHWPHWKRGVFDOOHGZLWKRXWKDYLQJWRXVHDUJXPHQWVUHWXUQ
W\SHVDQGDUUD\VIRUHDFKDQGHYHU\SHWFODVV
Licensed by
,WORRNVOLNHZHQHHG7:2
VXSHUFODVVHVDWWKHWRS
W UDFW
Eduard Simons
D E V
HZ HWDQG
NHDQ 3
:HPD ODVVFDOOHG WPHWKRGV
U F
VXSH DOOWKH S H
JLYHLW 3HW $QLPDO
104038
&DQLQH
+LSSR
)HOLQH
'RJ
'RJH
&DW /LRQ 3HWDQ[WHQGVERWK
:ROI
G$QLP
DO
HQGV
&DWQRZH[W QLPDO 7LJHU
IURPERWK$ LWJHWV
$1'3HWVR RIERWK
WKHPHWKRGV 7KHQRQSHW$QLPDOV
GRQ·WKDYHDQ\LQKHULWHG
3HWVWXII
FKDSWHU
7KHUH·VMXVWRQHSUREOHPZLWKWKH´WZRVXSHUFODVVHVµDSSURDFK
,W·VFDOOHG´PXOWLSOHLQKHULWDQFHµ
DQGLWFDQEHD5HDOO\%DG7KLQJ
7KDWLVLILWZHUHSRVVLEOHWRGRLQ-DYD
%XWLWLVQ·WEHFDXVHPXOWLSOHLQKHULWDQFHKDVDSUREOHP
NQRZQDV7KH'HDGO\'LDPRQGRI'HDWK
'HDGO\'LDPRQGRI'HDWK
UQHUERWK
'LJLWDO5HFRUGHU
G ' 9' % X LQWL
DQ
&'%XUQHU P'LJLWDO5HFRUGHU
U R
LQKHULW YHUULGHWKHEXUQ
I EXUQ
DQGERWKRRWKLQKHULWWKH´Lµ
PHWKRG% ULDEOH
LQVWDQFHYD W K H ´ Lµ LQVWDQFH XUQHU
KDW ' %
,PDJLQHWLVXVHGE\ERWK&LIIHUHQW
&'%XUQHU '9'%XUQHU

YDULDEOH %XUQHUZLWK &RPER'ULYHG
DQG'9'KDWKDSSHQVLI RI´Lµ"
EXUQ EXUQ
YDOXHV: XVHERWKYDOXHV
QHHGVWR
&RPER'ULYH
3UREOHPZLW
:KLFKEXUQKPXOWLSOHLQKHULWDQFH
FDOOEXUQR PHWKRGUXQVZKHQ\RX
QWKH&RPER
'ULYH"
!LANGUAGETHATALLOWSTHE$EADLY$IAMONDOF$EATHCANLEADTO
SOMEUGLYCOMPLEXITIESBECAUSEYOUHAVETOHAVESPECIALRULESTO
DEALWITHTHEPOTENTIALAMBIGUITIES!NDEXTRARULESMEANSEXTRA
WORKFORYOUBOTHINLEARNINGTHOSERULESANDWATCHINGOUTFOR
THOSEhSPECIALCASESv*AVAISSUPPOSEDTOBESIMPLEWITHCONSISTENT
RULESTHATDONTBLOWUPUNDERSOMESCENARIOS3O*AVAUNLIKE
# PROTECTSYOUFROMHAVINGTOTHINKABOUTTHE$EADLY$IA
MONDOF$EATH"UTTHATBRINGSUSBACKTOTHEORIGINALPROBLEM
(OWDOWEHANDLETHE!NIMAL0ETTHING
\RXDUHKHUH
LQWHUIDFHV
1V\MZNIKM\W\PMZM[K]M
*AVAGIVESYOUASOLUTION!NINTERFACE.OTA'5)INTERFACENOTTHEGENERIC
USEOFTHEWORDINTERFACEASINh4HATSTHEPUBLICINTERFACEFORTHE"UTTON
CLASS!0)vBUTTHE*AVAKEYWORDLQWHUIDFH
!*AVAINTERFACESOLVESYOURMULTIPLEINHERITANCEPROBLEMBYGIVINGYOU
MUCHOFTHEPOLYMORPHICBENElTSOFMULTIPLEINHERITANCEWITHOUTTHEPAIN
ANDSUFFERINGFROMTHE$EADLY$IAMONDOF$EATH$$$
4HEWAYINWHICHINTERFACESSIDE STEPTHE$$$ISSURPRISINGLYSIMPLEMAKE
ALLTHEMETHODSABSTRACT4HATWAYTHESUBCLASSMUSTIMPLEMENTTHEMETHODS
REMEMBERABSTRACTMETHODSMUSTBEIMPLEMENTEDBYTHElRSTCONCRETE
SUBCLASS SOATRUNTIMETHE*6-ISNTCONFUSEDABOUTWHICHOFTHETWO
INHERITEDVERSIONSITSSUPPOSEDTOCALL
7L[ $-DYDLQWHUIDFHLVOLNHD
SXUHDEVWUDFWFODVV

HIZ[YHJ[]VPKIL-YPLUKS`"
K R G VLQ D Q L QWHUIDFHDUH $
$OOPH W ,6
HIZ[YHJ[]VPKWSH`" Q\FODVVWKDW
DEVWUDFWVRDPSOHPHQWLHRYHUULGH
3HW0867L RI3HW
WKHPHWKRGV
7R'(),1(DQLQWHUIDFH
SXEOLFLQWHUIDFH3HW^`
8VHWKHNH
LQVWHDGRI\ZRUG´LQWHUIDFHµ
´FODVVµ
7R,03/(0(17DQLQWHUIDFH
SXEOLFFODVV'RJH[WHQGV&DQLQHLPSOHPHQWV3HW^`
ZHG
N H\ Z RU G ´ LP SOHPHQWVµIROOR
8VHWKH KDW
HQDPH1RWHW H\RX
E\ W KH L QW HUI DF DF
HQWDQLQWHUI
ZKHQ\RXLPSOHPHQGDFODVV
VWLOOJHWWRH[W
FKDSWHU
5ISQVOIVL1UXTMUMV\QVO LQWHUIDFHP
\PM8M\QV\MZNIKM DEVWUDFWVRHWW\KRSLGVDUHLPSOLFLWO\SXE
OLFDQG
LVRSWLRQDOLQIDFQJLQ¶SXEOLF·DQG¶DEVWUDFW·
VW\OH·WRW\SHWKH W LW·V QRWFR
MXVWWRUHLQIRUF ZRUGVLQEXWQVZLGHHUHG¶JRRG
IDFH·LQVWHDG GLGKHUH
EHHQVODYHVWRIDVHLWDQGEHFDXVHZH·YHQHYHU
<RXVD\¶LQKWHUHUH KLRQ
RI¶FODVV·

PHWKRGVDUH
SXEOLFLQWHUIDFH3HW^ $OOLQWHUIDFHWKH\0867HQGLQ
DEVWUDFWVR HPHPEHUWKH\KDYH
SXEOLFDEVWUDFWYRLGEH)ULHQGO\ VHPLFRORQV5
SXEOLFDEVWUDFWYRLGSOD\ QRERG\
`
·
QLPDO <RXVD\¶LPSOHPKHHQQWVDPH
'RJ,6$,$
6 $3HW E\ W
IROORZHG DFH
DQG'RJ SXEOLFFODVV'RJH[WHQGV&DQLQHLPSOHPHQWV3HW^ RIW
KHLQWHUI
SXEOLFYRLGEH)ULHQGO\^`
<RX6$,'
SXEOLFYRLGSOD\^` LPSOHPHQWW\KRXDUHD3HWVR\RX0
FRQWUDFW R H3HWPHWKRGV,W·V\ 867
LQVWHDGRIV1HP
WLFHWKHFXUO\ RXU
EUDFHV
LFRORQV
SXEOLFYRLGURDP^`
7KHVHDUHMXV
RYHUULGLQJPHWWKRQRGVUP
SXEOLFYRLGHDW^` DO

`
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: 7AITAMINUTEINTERFACESDONT
TYPESYOUCANPASSANYTHINGTHAT
IMPLEMENTSTHATINTERFACE!NDTHINK
TOEXTEND9OUCOULDJUSTGIVETHEM
THEINTERFACEANDSAYh(ERE)DONT
REALLYGIVEYOUMULTIPLEINHERITANCE ABOUTITWITHANINTERFACEACLASS CAREWHATKINDOFCLASSINHERITANCE
BECAUSEYOUCANTPUTANY DOESNTHAVETOCOMEFROMJUSTONE STRUCTUREYOUCOMEFROMJUST
IMPLEMENTATIONCODEINTHEM)FALL INHERITANCETREE!CLASSCANEXTEND IMPLEMENTTHISINTERFACEANDYOULLBE
THEMETHODSAREABSTRACTWHATDOES ONECLASSANDIMPLEMENTANINTERFACE GOODTOGOv
ANINTERFACEREALLYBUYYOU "UTANOTHERCLASSMIGHTIMPLEMENT 4HEFACTTHATYOUCANTPUTIN
THESAMEINTERFACEYETCOMEFROMA
IMPLEMENTATIONCODETURNSOUTNOTTO
COMPLETELYDIFFERENTINHERITANCETREE
A: 0OLYMORPHISMPOLYMORPHISM
POLYMORPHISM)NTERFACESARETHE
3OYOUGETTOTREATANOBJECTBYTHE
ROLEITPLAYSRATHERTHANBYTHECLASS
BEAPROBLEMFORMOSTGOODDESIGNS
BECAUSEMOSTINTERFACEMETHODS
WOULDNTMAKESENSEIFIMPLEMENTED
ULTIMATEINFLEXIBILITYBECAUSEIFYOU TYPEFROMWHICHITWASINSTANTIATED INAGENERICWAY)NOTHERWORDSMOST
USEINTERFACESINSTEADOFCONCRETE )NFACTIFYOUWROTEYOURCODETOUSE INTERFACEMETHODSWOULDNEEDTO
SUBCLASSESOREVENABSTRACTSUPERCLASS INTERFACESYOUWOULDNTEVENHAVETO BEOVERRIDDENEVENIFTHEMETHODS
TYPES ASARGUMENTSANDRETURN GIVEANYONEASUPERCLASSTHATTHEYHAD WERENTFORCEDTOBEABSTRACT
\RXDUHKHUH
LQWHUIDFHSRO\PRUSKLVP
&ODVVHVIURPGLIIHUHQWLQKHULWDQFHWUHHV
FDQLPSOHPHQWWKHVDPHLQWHUIDFH
5RERW
3HW $QLPDO
$JHQW
5RER'RJ
&DQLQH
&ODVV5RER' GRH
FRPHIURPWRJ
+LSSR
VQ·W
LQKHULWDQFHWUKHHH$EQLPDO
JHWVWREHD3HW XWLWVWLOO )HOLQH
'RJ
&DW /LRQ :ROI
7LJHU
7HENYOUUSEACLASSASAPOLYMORPHICTYPELIKEAN THEIRMETHODSINASEPARATETHREADOFEXECUTION
ARRAYOFTYPE!NIMALORAMETHODTHATTAKESA#ANINE )MPLEMENT2UNNABLE9OUGETTHEIDEA9OULL
ARGUMENT THEOBJECTSYOUCANSTICKINTHATTYPE LEARNMOREABOUT3ERIALIZABLEAND2UNNABLEINLATER
MUSTBEFROMTHESAMEINHERITANCETREE"UTNOTJUST CHAPTERSBUTFORNOWREMEMBERTHATCLASSESFROM
ANYWHEREINTHEINHERITANCETREETHEOBJECTSMUSTBE ANYPLACEINTHEINHERITANCETREEMIGHTNEEDTO
FROMACLASSTHATISASUBCLASSOFTHEPOLYMORPHICTYPE IMPLEMENTTHOSEINTERFACES.EARLYANYCLASSMIGHT
!NARGUMENTOFTYPE#ANINECANACCEPTA7OLFANDA WANTTOBESAVEABLEORRUNNABLE
$OGBUTNOTA#ATORA(IPPO
%HWWHUVWLOODFODVVFDQLPSOHPHQW
"UTWHENYOUUSEANINTERFACEASAPOLYMORPHIC PXOWLSOHLQWHUIDFHV
TYPELIKEANARRAYOF0ETS THEOBJECTSCANBE
FROMANYWHEREINTHEINHERITANCETREE4HEONLY !$OGOBJECT)3 !#ANINEAND)3 !!NIMALAND
REQUIREMENTISTHATTHEOBJECTSAREFROMACLASSTHAT )3 !/BJECTALLTHROUGHINHERITANCE"UTA$OG)3 !
IMPLEMENTSTHEINTERFACE!LLOWINGCLASSESINDIFFERENT 0ETTHROUGHINTERFACEIMPLEMENTATIONANDTHE$OG
INHERITANCETREESTOIMPLEMENTACOMMONINTERFACE MIGHTIMPLEMENTOTHERINTERFACESASWELL9OUCOULD
ISCRUCIALINTHE*AVA!0)$OYOUWANTANOBJECT SAY
TOBEABLETOSAVEITSSTATETOAlLE)MPLEMENTTHE SXEOLFFODVV'RJH[WHQGV$QLPDOLPSOHPHQWV
3ERIALIZABLEINTERFACE$OYOUNEEDOBJECTSTORUN 3HW6DYHDEOH3DLQWDEOH^`
FKDSWHU
W LFN
0DNH LW 6
BLUE
LETSARE TT WO
S E S A RE REDVIO PLEMEN
2O E B U T IM
ONLYON
%X TEND
ALUES
S I N O N FAMILYV CANHA
VE
*AVAWE
IGH
! * A VACLASS TPARENT
ARENTS/
NLY DTHA
LASS AN MPLE
3INGLE0 ARENTSUPERC "UTYOUCANI CES
LY O N E P O U A RE I N TE R FA
ON HOY HOSE
FINESW SANDT
CLASSDE IPLEINTER FACE
ULT
MENTM SYOUCANPLAY
E R OLE
DEFIN
+RZGR\RXNQRZZKHWKHUWRPDNHD
FODVVDVXEFODVVDQDEVWUDFWFODVVRU
DQLQWHUIDFH"
0DNHDFODVVWKDWGRHVQ·WH[WHQGDQ\WKLQJ
RWKHUWKDQ2EMHFWZKHQ\RXUQHZFODVVGRHVQ·W
SDVVWKH,6$WHVWIRUDQ\RWKHUW\SH
0DNHDVXEFODVVLQRWKHUZRUGVH[WHQGDFODVV
RQO\ZKHQ\RXQHHGWRPDNHDPRUHVSHFLÀF
YHUVLRQRIDFODVVDQGQHHGWRRYHUULGHRUDGG
QHZEHKDYLRUV
8VHDQDEVWUDFWFODVVZKHQ\RXZDQWWRGHÀQH
DWHPSODWHIRUDJURXSRIVXEFODVVHVDQG\RX
KDYHDWOHDVWVRPHLPSOHPHQWDWLRQFRGHWKDWDOO
VXEFODVVHVFRXOGXVH0DNHWKHFODVVDEVWUDFW
ZKHQ\RXZDQWWRJXDUDQWHHWKDWQRERG\FDQ
PDNHREMHFWVRIWKDWW\SH
8VHDQLQWHUIDFHZKHQ\RXZDQWWRGHÀQHDUROH
WKDWRWKHUFODVVHVFDQSOD\UHJDUGOHVVRIZKHUH
WKRVHFODVVHVDUHLQWKHLQKHULWDQFHWUHH
\RXDUHKHUH
XVLQJVXSHU
,QYRNLQJWKHVXSHUFODVV WKH
YHUVLRQRI
YHUVLRQRIDPHWKRG VXSHUFODVVRHVLPSRUWDQWVWXII
PHWKRGGFODVVHVFRXOGXVH
Q: 7HATIFYOUMAKEACONCRETESUBCLASS DEVWUDFWFODVV5HSRUW^
YRLGUXQ5HSRUW^
WKDWVXE
ANDYOUNEEDTOOVERRIDEAMETHODBUTYOU
VHWXSUHSRUW
WANTTHEBEHAVIORINTHESUPERCLASSVERSIONOF
`
THEMETHOD)NOTHERWORDSWHATIFYOUDONT YRLGSULQW5HSRUW^
NEEDTOREPLACETHEMETHODWITHANOVERRIDE JHQHULFSULQWLQJ
BUTYOUJUSTWANTTOADDTOITWITHSOME `
ADDITIONALSPECIlCCODE `
A: !HHHTHINKABOUTTHEMEANINGOFTHE
FODVV%X]]ZRUGV5HSRUWH[WHQGV5HSRUW^

UVLRQ
WORD@EXTENDS/NEAREAOFGOOD//DESIGNLOOKS YRLGUXQ5HSRUW^
F DOO V XSHUFODVVYNHDQG
DF
WKHQFRPHXEEFODVV
ATHOWTODESIGNCONCRETECODETHATSMEANTTO VXSHUUXQ5HSRUW
BEOVERRIDDEN)NOTHERWORDSYOUWRITEMETHOD EX]]ZRUG&RPSOLDQFH
CODEINSAYANABSTRACTCLASSTHATDOESWORK SULQW5HSRUW GRVRPHV WXII
THATSGENERICENOUGHTOSUPPORTTYPICALCONCRETE VSHFLILFV
IMPLEMENTATIONS"UTTHECONCRETECODEISNT `
ENOUGHTOHANDLEALLOFTHESUBCLASS SPECIFIC YRLGEX]]ZRUG&RPSOLDQFH^`
WORK3OTHESUBCLASSOVERRIDESTHEMETHOD `
ANDEXTENDSITBYADDINGTHERESTOFTHECODE
4HEKEYWORDSUPERLETSYOUINVOKEASUPERCLASS
VERSIONOFANOVERRIDDENMETHODFROMWITHINTHE
SUBCLASS
,IPHWKRGFRGHLQVLGHD LGHV
%X]]ZRUG5HSRUWVXEFODVVVD\V V V P HW K RGRYHUU
VXEFOD UFODVVYHUVLRQ
VXSHUUXQ5HSRUW
WKHVXSH
WKHUXQ5HSRUWPHWKRGLQVLGH UXQ5HSRUW
WKHVXSHUFODVV5HSRUWZLOOUXQ EX]]ZRUG&RPSOLDQFH VXSHUFODVVPHWKRGV GGHQ
UXQ5HSRUW
LQFOXGLQJWKHRYHUUL
SULQW5HSRUW UXQ5HSRUW
5HSRUW
VXSHUUXQ5HSRUW
%X]]ZRUG5HSRUW
$UHIHUHQFHWRWKHVXEFODVVREMHFW
%X]]ZRUG5HSRUWZLOODOZD\VFDOO
WKHVXEFODVVYHUVLRQRIDQRYHUULGGHQ
PHWKRG7KDW·VSRO\PRUSKLVP 7KHVXSHUNH\ZRUGLVUHDOO\DUHIHUHQFH
%XWWKHVXEFODVVFRGHFDQFDOO WRWKHVXSHUFODVVSRUWLRQRIDQREMHFW
VXSHUUXQ5HSRUWWRLQYRNHWKH :KHQVXEFODVVFRGHXVHVVXSHUDVLQ
VXSHUFODVVYHUVLRQ VXSHUUXQ5HSRUWWKHVXSHUFODVVYHUVLRQRI
WKHPHWKRGZLOOUXQ
FKDSWHU
:MDD=LHGAFLK Q: 4HERESSTILLSOMETHING
STRANGEHEREYOUNEVER
:KHQ\RXGRQ·WZDQWDFODVVWREHLQVWDQWLDWHGLQRWKHUZRUGV\RXGRQ·W
ZDQWDQ\RQHWRPDNHDQHZREMHFWRIWKDWFODVVW\SHPDUNWKHFODVVZLWKWKH
EXPLAINEDHOWITISTHAT
!RRAY,IST$OGGIVESBACK$OG
DEVWUDFWNH\ZRUG REFERENCESTHATDONTNEEDTOBE
CASTYETTHE!RRAY,ISTCLASSUSES
$QDEVWUDFWFODVVFDQKDYHERWKDEVWUDFWDQGQRQDEVWUDFWPHWKRGV /BJECTINITSMETHODSNOT$OG
OR$OT#OMORANYTHINGELSE
,IDFODVVKDVHYHQRQHDEVWUDFWPHWKRGWKHFODVVPXVWEHPDUNHGDEVWUDFW
7HATSTHESPECIALTRICKGOINGON
$QDEVWUDFWPHWKRGKDVQRERG\DQGWKHGHFODUDWLRQHQGVZLWKDVHPLFRORQQR
FXUO\EUDFHV
WHENYOUSAY!RRAY,IST$OG
$OODEVWUDFWPHWKRGVPXVWEHLPSOHPHQWHGLQWKHILUVWFRQFUHWHVXEFODVVLQWKH
LQKHULWDQFHWUHH
A: 9OURERIGHTFORCALLINGITA
SPECIALTRICK)NFACTITISASPECIAL
TRICKTHAT!RRAY,IST$OGGIVES
(YHU\FODVVLQ-DYDLVHLWKHUDGLUHFWRULQGLUHFWVXEFODVVRIFODVV2EMHFWMDYDODQJ
2EMHFW
BACK$OGSWITHOUTYOUHAVING
TODOANYCASTSINCEITLOOKSLIKE
!RRAY,ISTMETHODSDONTKNOW
0HWKRGVFDQEHGHFODUHGZLWK2EMHFWDUJXPHQWVDQGRUUHWXUQW\SHV
ANYTHINGABOUT$OGSORANYTYPE
<RXFDQFDOOPHWKRGVRQDQREMHFWRQO\LIWKHPHWKRGVDUHLQWKHFODVVRULQWHUIDFH
XVHGDVWKHUHIHUHQFHYDULDEOHW\SHUHJDUGOHVVRIWKHDFWXDOREMHFWW\SH6RD
BESIDES/BJECT
4HESHORTANSWERISTHATTHE
UHIHUHQFHYDULDEOHRIW\SH2EMHFWFDQEHXVHGRQO\WRFDOOPHWKRGVGHILQHGLQFODVV COMPILERPUTSINTHECASTFORYOU
2EMHFWUHJDUGOHVVRIWKHW\SHRIWKHREMHFWWRZKLFKWKHUHIHUHQFHUHIHUV 7HENYOUSAY!RRAY,IST$OG
THEREISNOSPECIALCLASSTHATHAS
$UHIHUHQFHYDULDEOHRIW\SH2EMHFWFDQ·WEHDVVLJQHGWRDQ\RWKHUUHIHUHQFHW\SH
ZLWKRXWDFDVW$FDVWFDQEHXVHGWRDVVLJQDUHIHUHQFHYDULDEOHRIRQHW\SHWRD
METHODSTOTAKEANDRETURN$OG
OBJECTSBUTINSTEADTHE$OG
UHIHUHQFHYDULDEOHRIDVXEW\SHEXWDWUXQWLPHWKHFDVWZLOOIDLOLIWKHREMHFWRQWKH ISASIGNALTOTHECOMPILERTHAT
KHDSLV127RIDW\SHFRPSDWLEOHZLWKWKHFDVW YOUWANTTHECOMPILERTOLET
([DPSOH'RJG 'RJ[JHW2EMHFWD'RJ YOUPUT/.,9$OGOBJECTSIN
ANDTOSTOPYOUIFYOUTRYTOADD
$OOREMHFWVFRPHRXWRIDQ$UUD\/LVW2EMHFW!DVW\SH2EMHFWPHDQLQJWKH\FDQEH
UHIHUHQFHGRQO\E\DQ2EMHFWUHIHUHQFHYDULDEOHXQOHVV\RXXVHDFDVW
ANYOTHERTYPETOTHELIST!ND
SINCETHECOMPILERSTOPSYOU
FROMADDINGANYTHINGBUT$OGS
0XOWLSOHLQKHULWDQFHLVQRWDOORZHGLQ-DYDEHFDXVHRIWKHSUREOHPVDVVRFLDWHGZLWK
WKH´'HDGO\'LDPRQGRI'HDWKµ7KDWPHDQV\RXFDQH[WHQGRQO\RQHFODVVLH\RX
TOTHE!RRAY,ISTTHECOMPILER
ALSOKNOWSTHATITSSAFETOCAST
FDQKDYHRQO\RQHLPPHGLDWHVXSHUFODVV ANYTHINGTHATCOMESOUTOFTHAT
!RRAY,ISTDOA$OGREFERENCE)N
$QLQWHUIDFHLVOLNHDSXUHDEVWUDFWFODVV,WGHILQHVRQO\DEVWUDFWPHWKRGV
OTHERWORDSUSING!RRAY,IST$OG
&UHDWHDQLQWHUIDFHXVLQJWKHLQWHUIDFHNH\ZRUGLQVWHDGRIWKHZRUGFODVV SAVESYOUFROMHAVINGTOCAST
THE$OGYOUGETBACK"UTITS
,PSOHPHQWDQLQWHUIDFHXVLQJWKHNH\ZRUGLPSOHPHQWV
([DPSOH'RJLPSOHPHQWV3HW
MUCHMOREIMPORTANTTHANTHAT
BECAUSEREMEMBERACASTCAN
FAILATRUNTIMEANDWOULDNTYOU
<RXUFODVVFDQLPSOHPHQWPXOWLSOHLQWHUIDFHV
RATHERHAVEYOURERRORSHAPPEN
$FODVVWKDWLPSOHPHQWVDQLQWHUIDFHPXVWLPSOHPHQWDOOWKHPHWKRGVRIWKH
LQWHUIDFHVLQFHDOOLQWHUIDFHPHWKRGVDUHLPSOLFLWO\SXEOLFDQGDEVWUDFW
ATCOMPILETIMERATHERTHANSAY
WHENYOURCUSTOMERISUSINGITFOR
SOMETHINGCRITICAL
7RLQYRNHWKHVXSHUFODVVYHUVLRQRIDPHWKRGIURPDVXEFODVVWKDW·VRYHUULGGHQWKH
PHWKRGXVHWKHVXSHUNH\ZRUG([DPSOHVXSHUUXQ5HSRUW
"UTTHERESALOTMORETOTHISSTORY
ANDWELLGETINTOALLTHEDETAILSIN
THE#OLLECTIONSCHAPTER
\RXDUHKHUH
H[HUFLVH:KDW·VWKH3LFWXUH"
(ERESYOURCHANCETODEMONSTRATEYOURARTISTICABILITIES/NTHELEFTYOULL
1dQÔU_Q lNDSETSOFCLASSANDINTERFACEDECLARATIONS9OURJOBISTODRAWTHEASSOCIATED
CLASSDIAGRAMSONTHERIGHT7EDIDTHElRSTONEFORYOU5SEADASHEDLINEFOR
hIMPLEMENTSvANDASOLIDLINEFORhEXTENDSv
/Q^MV" ?PI\¼[\PM8QK\]ZM'
LQWHUIDFH
)RR
SXEOLFLQWHUIDFH)RR^`
SXEOLFFODVV%DULPSOHPHQWV)RR^`

SXEOLFLQWHUIDFH9LQQ^`
SXEOLFDEVWUDFWFODVV9RXWLPSOHPHQWV9LQQ^` %DU
SXEOLFDEVWUDFWFODVV0XIÀHLPSOHPHQWV:KXIÀH^`
SXEOLFFODVV)OXIÀHH[WHQGV0XIÀH^`
SXEOLFLQWHUIDFH:KXIÀH^`
SXEOLFFODVV=RRS^`
SXEOLFFODVV%RRSH[WHQGV=RRS^`
SXEOLFFODVV*RRSH[WHQGV%RRS^`
SXEOLFFODVV*DPPDH[WHQGV'HOWDLPSOHPHQWV(SVLORQ^`
SXEOLFLQWHUIDFH(SVLORQ^`
SXEOLFLQWHUIDFH%HWD^`
SXEOLFFODVV$OSKDH[WHQGV*DPPDLPSOHPHQWV%HWD^`
SXEOLFFODVV'HOWD^`
FKDSWHU
/NTHELEFTYOULLlNDSETSOFCLASSDIAGRAMS9OURJOBISTOTURN
1dQÔU_Q THESEINTOVALID*AVADECLARATIONS7EDIDNUMBERFORYOU
ANDITWASATOUGHONE
?PI\¼[\PM,MKTIZI\QWV'
/Q^MV"
&OLFN SXEOLFFODVV&OLFN^`

SXEOLFFODVV&ODFNH[WHQGV&OLFN^`
7RS

&ODFN
7LS

)HH

)RR

)L
%DU
=HWD

%D]
%HWD
$OSKD .(<
EXTENDS
IMPLEMENTS
&ODFN CLASS
'HOWD
&ODFN INTERFACE
&ODFN ABSTRACTCLASS
\RXDUHKHUH
SX]]OH3RRO3X]]OH
9OURJOBISTOTAKECODESNIPPETSFROMTHEPOOLAND
3RRO PLACETHEMINTOTHEBLANKLINESINTHECODEANDOUT
PUT9OUMAYUSETHESAMESNIPPETMORETHANONCE
3X]]OH ANDYOUWONTNEEDTOUSEALLTHESNIPPETS9OUR
GOALISTOMAKEASETOFCLASSESTHATWILLCOMPILE
ANDRUNANDPRODUCETHEOUTPUTLISTED
BBBBBBBBBBBB1RVH^
SXEOLFBBBBBBBBBBBBBBBBBBBH[WHQGV&ORZQV^
BBBBBBBBBBBBBBBBBBBBBBBB
` SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^
BBBBBBBBBBBBBBBBBBBBBBBBBBBB
Licensed by
DEVWUDFWFODVV3LFDVVRLPSOHPHQWVBBBBBB^
L>@ QHZBBBBBBBBBB
BBBBBBBBBBBBBBBBBBBBBBBBB
L>@ QHZBBBBBBBBBB
UHWXUQ
` L>@ QHZBBBBBBBBBB
Eduard Simons
` IRULQW[ [[^
6\VWHPRXWSULQWOQBBBBBBBBBBBBBBBBBB
FODVVBBBBBBBBBBBBBBBBBBBBBBBBBBB^` ´´BBBBBBBJHW&ODVV
`
104038
FODVVBBBBBBBBBBBBBBBBBBBBBBBBBBB^ `
BBBBBBBBBBBBBBBBBBBBBBBBBBB ` /UTPUT )LOH(GLW:LQGRZ+HOS%H$IUDLG
UHWXUQ MDYDBBBBBBBBBBBBBB
` FODVV$FWV
` FODVV&ORZQV
BBBBBBBB2I
.OTE%ACHSNIPPET
FROMTHEPOOLCANBE
USEDMORETHANONCE
CLASS
!CTS EXTENDS I
.OSE INTERFACE I
/F IMPLEMENTS IX
#LOWNS I;X= CLASS
0ICASSO CLASS
CLASS !CTS
PUBLICINTI-ETHOD PUBLICCLASS .OSE
/F;=INEW.OSE;= PUBLICINTI-ETHOD[] /F
/F;=I PUBLICINTI-ETHOD [ II-ETHODX #LOWNS
.OSE;=INEW.OSE PUBLICINTI-ETHOD [] IX I-ETHOD;= 0ICASSO
.OSE;=INEW.OSE;= I;X=I-ETHOD
I;X=I-ETHOD;=
FKDSWHU
%XERCISE3OLUTIONS
?PI\¼[\PM8QK\]ZM'
LQWHUIDFH
9LQQ
LQWHUIDFH
:KXIILH
9RXW ?PI\¼[\PM,MKTIZI\QWV'
0XIILH
SXEOLFDEVWUDFWFODVV7RS^`
SXEOLFFODVV7LSH[WHQGV7RS^`
=RRS )OXIILH
SXEOLFDEVWUDFWFODVV)HH^`
SXEOLFDEVWUDFWFODVV)LH[WHQGV)HH^`
%RRS
SXEOLFLQWHUIDFH)RR^`

SXEOLFFODVV%DULPSOHPHQWV)RR^`
*RRS SXEOLFFODVV%D]H[WHQGV%DU^`
SXEOLFLQWHUIDFH=HWD^`
'HOWD
LQWHUIDFH
(SVLORQ
SXEOLFFODVV$OSKDLPSOHPHQWV=HWD^`
SXEOLFLQWHUIDFH%HWD^`
LQWHUIDFH
SXEOLFFODVV'HOWDH[WHQGV$OSKDLPSOHPHQWV%HWD^`
*DPPD %HWD
$OSKD
\RXDUHKHUH
SX]]OHVROXWLRQ
LQWHUIDFH1RVH^ SXEOLFFODVV2IH[WHQGV&ORZQV^
SXEOLFLQWL0HWKRG SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^
` 1RVH>@L QHZ1RVH>@
DEVWUDFWFODVV3LFDVVRLPSOHPHQWV1RVH^ L>@ QHZ$FWV
SXEOLFLQWL0HWKRG^
L>@ QHZ&ORZQV
UHWXUQ
L>@ QHZ2I
`
IRULQW[ [[^
`
FODVV&ORZQVH[WHQGV3LFDVVR^` 6\VWHPRXWSULQWOQL>[@L0HWKRG
´´L>[@JHW&ODVV
FODVV$FWVH[WHQGV3LFDVVR^ `
SXEOLFLQWL0HWKRG^ `
UHWXUQ `
`
`
/UTPUT )LOH(GLW:LQGRZ+HOS.LOO7KH0LPH
MDYD2I
FODVV$FWV
FODVV&ORZQV
FODVV2I
FKDSWHU
FRQVWUXFWRUVDQGJDUEDJHFROOHFWLRQ
/LIHDQG'HDWK WKHQKHVDLG
RIDQ2EMHFW ´,FDQ·WIHHOP\OHJVµDQG
,VDLG´-RH6WD\ZLWKPH-RHµ
%XWLWZDVWRRODWH7KHJDUEDJH
FROOHFWRUFDPHDQGKHZDVJRQH
%HVWREMHFW,HYHUKDG
2EMHFWVDUHERUQDQGREMHFWVGLH9OUREINCHARGEOFANOBJECTSLIFECYCLE
9OUDECIDEWHENANDHOWTOCONSTRUCTIT9OUDECIDEWHENTODESTROYIT%XCEPTYOUDONT
ACTUALLYDESTROYTHEOBJECTYOURSELFYOUSIMPLYABANDONIT"UTONCEITSABANDONEDTHE
HEARTLESS'ARBAGE#OLLECTORGC CANVAPORIZEITRECLAIMINGTHEMEMORYTHATOBJECTWAS
USING)FYOUREGONNAWRITE*AVAYOUREGONNACREATEOBJECTS3OONERORLATERYOUREGONNA
HAVETOLETSOMEOFTHEMGOORRISKRUNNINGOUTOF2!-)NTHISCHAPTERWELOOKATHOWOBJECTS
ARECREATEDWHERETHEYLIVEWHILETHEYREALIVEANDHOWTOKEEPORABANDONTHEMEFFICIENTLY
4HATMEANSWELLTALKABOUTTHEHEAPTHESTACKSCOPECONSTRUCTORSSUPERCONSTRUCTORSNULL
REFERENCESANDMORE7ARNINGTHISCHAPTERCONTAINSMATERIALABOUTOBJECTDEATHTHATSOME
MAYFINDDISTURBING"ESTNOTTOGETTOOATTACHED
WKLVLVDQHZFKDSWHU
WKHVWDFNDQGWKHKHDS
<PM;\IKSIVL\PM0MIX"_PMZM\PQVO[TQ^M
"EFOREWECANUNDERSTANDWHATREALLYHAPPENSWHEN RUNNING"UTUSUALLYYOUWONTHAVEANYTHINGTOSAY
YOUCREATEANOBJECTWEHAVETOSTEPBACKABIT7E ABOUTIT!NDWITHGOODPROGRAMMINGYOUPROBABLY
NEEDTOLEARNMOREABOUTWHEREEVERYTHINGLIVES WONTCAREMOREONTHATALITTLELATER
ANDFORHOWLONG IN*AVA4HATMEANSWENEEDTO 7EKNOWTHATALLOBJECTSLIVEONTHEGARBAGE COLLECTIBLE
LEARNMOREABOUTTHE3TACKANDTHE(EAP)N*AVAWE HEAPBUTWEHAVENTYETLOOKEDATWHEREVARIABLES
PROGRAMMERS CAREABOUTTWOAREASOFMEMORYTHE LIVE!NDWHEREAVARIABLELIVESDEPENDSONWHATKIND
ONEWHEREOBJECTSLIVETHEHEAP ANDTHEONE OFVARIABLEITIS!NDBYhKINDvWEDONTMEANTYPE
WHEREMETHODINVOCATIONSANDLOCALVARIABLESLIVE IEPRIMITIVEOROBJECTREFERENCE 4HETWOKINDSOF
THESTACK 7HENA*6-STARTSUPITGETSACHUNKOF VARIABLESWHOSELIVESWECAREABOUTNOWAREINSTANCE
MEMORYFROMTHEUNDERLYING/3ANDUSESITTORUN VARIABLESANDLOCALVARIABLES,OCALVARIABLESAREALSO
YOUR*AVAPROGRAM(OWMUCHMEMORYANDWHETHER KNOWNASSTACKVARIABLESWHICHISABIGCLUEFORWHERE
ORNOTYOUCANTWEAKITISDEPENDENTONWHICH THEYLIVE
VERSIONOFTHE*6-ANDONWHICHPLATFORM YOURE
<PM;\IKS <PM0MIX
QDV
7HEREMETHODINVOCATIONS DOVRNQRZUEDJH
´7KH*D OH+HDSµ
7HERE!,,OBJECTSLIVE
ANDLOCALVARIABLESLIVE
&ROOHFWLE
JR
HFW
'X
GR6WXII
W
FNREMHF
6Q
RZ
EM
E R DUG R
PDLQ
%X FW
WWRQREMH
,QVWDQFH9DULDEOHV /RFDO9DULDEOHV
)NSTANCEVARIABLESAREDECLAREDINSIDEACLASSBUTNOT ,OCALVARIABLESAREDECLAREDINSIDEAMETHODINCLUDING
INSIDEAMETHOD4HEYREPRESENTTHEhlELDSvTHATEACH METHODPARAMETERS4HEYRETEMPORARYANDLIVEONLYAS
INDIVIDUALOBJECTHASWHICHCANBElLLEDWITHDIFFERENT LONGASTHEMETHODISONTHESTACKINOTHERWORDSASLONGAS
VALUESFOREACHINSTANCEOFTHECLASS )NSTANCEVARIABLES THEMETHODHASNOTREACHEDTHECLOSINGCURLYBRACE
LIVEINSIDETHEOBJECTTHEYBELONGTO
SXEOLFYRLGIRRLQW[^

SXEOLFFODVV'XFN^
HWHU[DQG
Hµ LQWL [ 7KHSDUDP LDQGE
LQWVL]H
Y H U \ 'X F NKDVD´VL] WUXHWKHYDULDE
OHV
(
OYDULDEOHV
ERROHDQE
ULDEOH
` LQVWDQFHYD ` DUHDOOORFD
FKDSWHU
FRQVWUXFWRUVDQGJF
5M\PWL[IZM[\IKSML
7HENYOUCALLAMETHODTHEMETHODLANDSON $FDOOVWDFNZLWKWZRPHWKRGV
THETOPOFACALLSTACK4HATNEWTHINGTHATS
ACTUALLYPUSHEDONTOTHESTACKISTHESTACK WRSRIWKHVWDFN
DPHV
FRAMEANDITHOLDSTHESTATEOFTHEMETHOD VWDFNIU EDU V
INCLUDINGWHICHLINEOFCODEISEXECUTINGAND ORFDOYDULDEOHV
THEVALUESOFALLLOCALVARIABLES
4HEMETHODATTHETOPOFTHESTACKISALWAYS
IRR [ L E LQFOXGLQJ
SDUDPHWHU[
THECURRENTLY RUNNINGMETHODFORTHATSTACK
FORNOWASSUMETHERESONLYONESTACKBUTIN ERWWRPRIWKHVWDF
CHAPTERWELLADDMORE !METHODSTAYSON
N
THESTACKUNTILTHEMETHODHITSITSCLOSINGCURLY 7KHPHWKRGRQWKHWRSRIWKH
BRACEWHICHMEANSTHEMETHODSDONE )F VWDFNLVDOZD\VWKHFXUUHQWO\
METHODFOO CALLSMETHODBAR METHODBAR IS
H[HFXWLQJPHWKRG
STACKEDONTOPOFMETHODFOO
SXEOLFYRLGGR6WXII^ )[\IKS[KMVIZQW
ERROHDQE WUXH
JR 4HECODEONTHELEFTISASNIPPETWEDONTCAREWHATTHERESTOFTHE
` CLASSLOOKSLIKE WITHTHREEMETHODS4HElRSTMETHODDO3TUFF CALLS
SXEOLFYRLGJRLQW[^ THESECONDMETHODGO ANDTHESECONDMETHODCALLSTHETHIRD
LQW] [ CRAZY %ACHMETHODDECLARESONELOCALVARIABLEWITHINTHEBODY
FUD]\ OFTHEMETHODANDMETHODGO ALSODECLARESAPARAMETERVARIABLE
LPDJLQHPRUHFRGHKHUH WHICHMEANSGO HASTWOLOCALVARIABLES
`
SXEOLFYRLGFUD]\^
FKDUF µD¶
`
&RGHIURPDQRWKHU GR6WXIIFDOOVJR JRFDOOVFUD]\ FUD]\FRPSOHWHV

FODVVFDOOVGR6WXII JRLVSXVKHGRQ FUD]\LVQRZRQWKH DQGLWVVWDFNIUDPHLV
DQGGR6WXIIJRHV WRSRIWKHVWDFN WRSRIWKHVWDFN SRSSHGRIIWKHVWDFN
LQWRDVWDFNIUDPH 9DULDEOHV¶[·DQG¶]· ZLWKYDULDEOH¶F·LQ ([HFXWLRQJRHVEDFN
DWWKHWRSRIWKH DUHLQWKHJRVWDFN WKHIUDPH WRWKHJRPHWKRG
VWDFN7KHERROHDQ IUDPH DQGSLFNVXSDWWKH
YDULDEOHQDPHG¶E· OLQHIROORZLQJWKHFDOO
JRHVRQWKHGR6WXII WRFUD]\
VWDFNIUDPH
FUD]\ F
JR [ ] JR [ ] JR [ ]
GR6WXII E GR6WXII E GR6WXII E GR6WXII E
\RXDUHKHUH
REMHFWUHIHUHQFHVRQWKHVWDFN
?PI\IJW]\TWKITÎZQIJTM[\PI\IZMWJRMK\['
2EMEMBERANON PRIMITIVEVARIABLEHOLDSAREFERENCETOAN
OBJECTNOTTHEOBJECTITSELF9OUALREADYKNOWWHEREOBJECTS
LIVEONTHEHEAP)TDOESNTMATTERWHERETHEYREDECLAREDOR
CREATED)FTHELOCALVARIABLEISAREFERENCETOANOBJECTONLY
THEVARIABLETHEREFERENCEREMOTECONTROL GOESONTHESTACK
QHZ
4HEOBJECTITSELFSTILLGOESINTHEHEAP V DQ G F UHDWHVD LQFHLW·V
HFODUH ¶G·V
EDUIG IHUHQFHYDULDEOH KRGLW·VDORFDO
'XFNUH LQVLGHWKHPHW VWDFN
GHFODUHG DQGJRHVRQWKH
YDULDEOH
SXEOLFFODVV6WDFN5HI^
SXEOLFYRLGIRRI^
EDUI EDUI \ 'X
W
FNREMHF
`
+HDS
SXEOLFYRLGEDUI^ IRRI
'XFNG QHZ'XFN 1RPDWWHU:+(5
` UHIHUHQFHYDULDEOH(WKHREMHFW
` DPHWKRGYVDVD LVGHFODUHGLQVLGH
RIDFODVVWKHREQLQVWDQFHYDULDEOH
DOZD\VJRHVRQWK MHFWDOZD\VDOZD\V
HKHDS
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: /NEMORETIME7(9AREWELEARNINGTHE
WHOLESTACKHEAPTHING(OWDOESTHISHELPME
:MDD=LHGAFLK
$O)REALLYNEEDTOLEARNABOUTIT -DYDKDVWZRDUHDVRIPHPRU\ZHFDUHDERXW
WKH6WDFNDQGWKH+HDS
A: +NOWINGTHEFUNDAMENTALSOFTHE*AVA
,QVWDQFHYDULDEOHVDUHYDULDEOHVGHFODUHG
LQVLGHDFODVVEXWRXWVLGHDQ\PHWKRG
3TACKAND(EAPISCRUCIALIFYOUWANTTOUNDERSTAND
VARIABLESCOPEOBJECTCREATIONISSUESMEMORY
MANAGEMENTTHREADSANDEXCEPTIONHANDLING
/RFDOYDULDEOHVDUHYDULDEOHVGHFODUHGLQVLGHD
PHWKRGRUPHWKRGSDUDPHWHU
7ECOVERTHREADSANDEXCEPTIONHANDLINGINLATER
CHAPTERSBUTTHEOTHERSYOULLLEARNINTHISONE9OU $OOORFDOYDULDEOHVOLYHRQWKHVWDFNLQWKH
IUDPHFRUUHVSRQGLQJWRWKHPHWKRGZKHUHWKH
DONOTNEEDTOKNOWANYTHINGABOUTHOWTHE3TACK
YDULDEOHVDUHGHFODUHG
AND(EAPAREIMPLEMENTEDINANYPARTICULAR*6-
ANDORPLATFORM%VERYTHINGYOUNEEDTOKNOW
ABOUTTHE3TACKAND(EAPISONTHISPAGEANDTHE
2EMHFWUHIHUHQFHYDULDEOHVZRUNMXVWOLNHSULPL
WLYHYDULDEOHV³LIWKHUHIHUHQFHLVGHFODUHGDVD
PREVIOUSONE)FYOUNAILTHESEPAGESALLTHEOTHER ORFDOYDULDEOHLWJRHVRQWKHVWDFN
TOPICSTHATDEPENDONYOURKNOWINGTHISSTUFFWILL
GOMUCHMUCHMUCHEASIER/NCEAGAINSOMEDAY
YOUWILL3/THANKUSFORSHOVING3TACKSAND(EAPS
$OOREMHFWVOLYHLQWKHKHDSUHJDUGOHVVRI
ZKHWKHUWKHUHIHUHQFHLVDORFDORULQVWDQFH
DOWNYOURTHROAT YDULDEOH
FKDSWHU
FRQVWUXFWRUVDQGJF
1NTWKITÎZQIJTM[TQ^MWV\PM[\IKS &HOO3KRQHREMHFW
_PMZMLWQV[\IVKMÎZQIJTM[TQ^M'
p q
7HENYOUSAYNEW#ELL0HONE *AVAHASTOMAKE
SPACEONTHE(EAPFORTHAT#ELL0HONE"UTHOWMUCH LQW ORQJ
SPACE%NOUGHFORTHEOBJECTWHICHMEANSENOUGHTO
HOUSEALLOFTHEOBJECTSINSTANCEVARIABLES4HATSRIGHT
INSTANCEVARIABLESLIVEONTHE(EAPINSIDETHEOBJECT 2EMHFWZLWKWZRSULPLWLYHLQVWDQFHYDULDEOHV
THEYBELONGTO 6SDFHIRUWKHYDULDEOHVOLYHVLQWKHREMHFW
2EMEMBERTHATTHEVALUESOFANOBJECTSINSTANCE
VARIABLESLIVEINSIDETHEOBJECT)FTHEINSTANCEVARIABLES
AREALLPRIMITIVES*AVAMAKESSPACEFORTHEINSTANCE &HOO3KRQHREMHFW
VARIABLESBASEDONTHEPRIMITIVETYPE!NINTNEEDS
BITSALONGBITSETC*AVADOESNTCAREABOUTTHE
VALUEINSIDEPRIMITIVEVARIABLESTHEBIT SIZEOFANINT Yfl
VARIABLEISTHESAMEBITS WHETHERTHEVALUEOFTHE
INTISOR $QWHQQD
"UTWHATIFTHEINSTANCEVARIABLESAREOBJECTS7HATIF
#ELL0HONE(!3 !!NTENNA)NOTHERWORDS#ELL0HONE
HASAREFERENCEVARIABLEOFTYPE!NTENNA 2EMHFWZLWKRQHQRQSULPLWLYHLQVWDQFHYDULDEOH³
7HENTHENEWOBJECTHASINSTANCEVARIABLESTHATARE
DUHIHUHQFHWRDQ$QWHQQDREMHFWEXWQRDFWXDO
OBJECTREFERENCESRATHERTHANPRIMITIVESTHEREAL $QWHQQDREMHFW7KLVLVZKDW\RXJHWLI\RX
QUESTIONISDOESTHEOBJECTNEEDSPACEFORALLOF GHFODUHWKHYDULDEOHEXWGRQ·WLQLWLDOL]HLWZLWK
THEOBJECTSITHOLDSREFERENCESTO4HEANSWERISNOT DQDFWXDO$QWHQQDREMHFW
EXACTLY.OMATTERWHAT*AVAHASTOMAKESPACEFORTHE
SXEOLFFODVV&HOO3KRQH^
INSTANCEVARIABLEVALUES"UTREMEMBERTHATAREFERENCE
SULYDWH$QWHQQDDQW
VARIABLEVALUEISNOTTHEWHOLEOBJECTBUTMERELYAREMOTE
`
CONTROLTOTHEOBJECT3OIF#ELL0HONEHASANINSTANCE
VARIABLEDECLAREDASTHENON PRIMITIVETYPE!NTENNA
*AVAMAKESSPACEWITHINTHE#ELL0HONEOBJECTONLYFOR
THE!NTENNASREMOTECONTROLIEREFERENCEVARIABLE BUT
NOTTHE!NTENNAOBJECT &HOO3KRQHREMHFW $QWHQQDREMHFW
7ELLTHENWHENDOESTHE!NTENNAOBJECTGETSPACEON
THE(EAP&IRSTWEHAVETOlNDOUTWHENTHE!NTENNA
OBJECTITSELFISCREATED4HATDEPENDSONTHEINSTANCE Yfl
VARIABLEDECLARATION)FTHEINSTANCEVARIABLEISDECLARED
$QWHQQD
BUTNOOBJECTISASSIGNEDTOITTHENONLYTHESPACEFOR
THEREFERENCEVARIABLETHEREMOTECONTROL ISCREATED
SULYDWH$QWHQQDDQW 2EMHFWZLWKRQHQRQSULPLWLYHLQVWDQFHYDULDEOH
DQGWKH$QWHQQDYDULDEOHLVDVVLJQHGDQHZ
.OACTUAL!NTENNAOBJECTISMADEONTHEHEAPUNLESS $QWHQQDREMHFW
ORUNTILTHEREFERENCEVARIABLEISASSIGNEDANEW
!NTENNAOBJECT SXEOLFFODVV&HOO3KRQH^
SULYDWH$QWHQQDDQW QHZ$QWHQQD
SULYDWH$QWHQQDDQW QHZ$QWHQQD `
\RXDUHKHUH
REMHFWFUHDWLRQ
<PMUQZIKTMWNWJRMK\KZMI\QWV
.OWTHATYOUKNOWWHEREVARIABLESANDOBJECTSLIVEWECANDIVEINTO
THEMYSTERIOUSWORLDOFOBJECTCREATION2EMEMBERTHETHREESTEPS
OFOBJECTDECLARATIONANDASSIGNMENTDECLAREAREFERENCEVARIABLE
CREATEANOBJECTANDASSIGNTHEOBJECTTOTHEREFERENCE
"UTUNTILNOWSTEPTWOWHEREAMIRACLEOCCURSANDTHENEWOBJECT
IShBORNvHASREMAINEDA"IG-YSTERY0REPARETOLEARNTHEFACTSOF
OBJECTLIFE(OPEYOURENOTSQUEAMISH
5HYLHZWKHVWHSVRIREMHFW
GHFODUDWLRQFUHDWLRQDQGDVVLJQPHQW
'HFODUHDUHIHUHQFH
YDULDEOH
H
D QH Z UHIHUHQFU 'XFNP\'XFN eq<m[c
0DNH RIDFODVVR QHZ'XFN
YDULDEOH FHW\SH 'XFNUHIHUHQFH
LQWHUID
&UHDWHDQREMHFW
H
$PXLUUDVFKO HUH
'XFNP\'XFN QHZ'XFN
'XFNREMHFW
RFF
KHQHZ /LQNWKHREMHFWDQG
$VVLJQW RWKH WKHUHIHUHQFH
REMHFWW H 'XFNP\'XFN QHZ'XFN
UHIHUHQF
'XFNREMHFW
eq<m[c
'XFNUHIHUHQFH
FKDSWHU
FRQVWUXFWRUVDQGJF
$UHZHFDOOLQJDPHWKRGQDPHG'XFN"
%HFDXVHLWVXUHORRNVOLNHLW
R N V OL NH Z H·UHFDOOLQJ
,W OR
'XFNP\'XFN
DPHG'XFN
QHZ'XFN DPHWKRGQ HSDUHQWKHVHV
WK
EHFDXVHRI
1R
:H·UHFDOOLQJWKH'XFNFRQVWUXFWRU
!CONSTRUCTORDOESLOOKANDFEELALOTLIKEAMETHODBUTITSNOT
AMETHOD)TSGOTTHECODETHATRUNSWHENYOUSAYQHZ)NOTHER )KWV[\Z]K\WZPI[\PM
WORDSTHECODETHATRUNSWHENYOUINSTANTIATEANOBJECT
KWLM\PI\Z]V[_PMVaW]
4HEONLYWAYTOINVOKEACONSTRUCTORISWITHTHEKEYWORDQHZ QV[\IV\QI\MIVWJRMK\1V
FOLLOWEDBYTHECLASSNAME4HE*6-lNDSTHATCLASSANDINVOKES
W\PMZ_WZL[\PMKWLM\PI\
THECONSTRUCTORINTHATCLASS/+TECHNICALLYTHISISNTTHEONLY
WAYTOINVOKEACONSTRUCTOR"UTITSTHEONLYWAYTODOITFROM Z]V[_PMVaW][IaQHZWV
OUTSIDEACONSTRUCTOR9OUCANCALLACONSTRUCTORFROMWITHIN IKTI[[\aXM
ANOTHERCONSTRUCTORWITHRESTRICTIONSBUTWELLGETINTOALLTHAT
-^MZaKTI[[aW]KZMI\MPI[
LATERINTHECHAPTER
IKWV[\Z]K\WZM^MVQNaW]
%XWZKHUHLVWKHFRQVWUXFWRU" LWV¼\_ZQ\MQ\aW]Z[MTN
,IZHGLGQ·WZULWHLWZKRGLG"
9OUCANWRITEACONSTRUCTORFORYOURCLASSWEREABOUTTODO
THAT BUTIFYOUDONTTHECOMPILERWRITESONEFORYOU
(ERESWHATTHECOMPILERSDEFAULTCONSTRUCTORLOOKSLIKE
SXEOLF'XFN^

`
1RWLFHVRPHWKLQJPLVVLQJ"+RZLVWKLV
WKH
GLIIHUHQWIURPDPHWKRG"
V Q D PH LV WKHVDPHDVGDWRU\
,W 7KDW·VPDQ
FODVVQDPH
SXEOLF'XFN^
:KHUH·VWKHU
,IWKLVZHUHDHWXUQW\SH"
FRQVWUXFWRUFRGHJRHVKHUH
`
\RX·GQHHGDU PHWKRG
EHWZHHQ´SXE HWXUQW\SH
´'XFNµ OLFµDQG
\RXDUHKHUH
FRQVWUXFWLQJDQHZ'XFN
+WV[\Z]K\I,]KS ,ILW4XDFNVOLNHD
4HEKEYFEATUREOFACONSTRUCTORISTHATITRUNS FRQVWUXFWRU
BEFORETHEOBJECTCANBEASSIGNEDTOAREFERENCE
4HATMEANSYOUGETACHANCETOSTEPINAND
DOTHINGSTOGETTHEOBJECTREADYFORUSE)N
OTHERWORDSBEFOREANYONECANUSETHEREMOTE
CONTROLFORANOBJECTTHEOBJECTHASACHANCETO
HELPCONSTRUCTITSELF)NOUR$UCKCONSTRUCTOR
WERENOTDOINGANYTHINGUSEFULBUTITSTILL
DEMONSTRATESTHESEQUENCEOFEVENTS
SXEOLFFODVV'XFN^
SXEOLF'XFN^
Licensed by
Eduard Simons
6\VWHPRXWSULQWOQ³4XDFN´
` 7KHFRQVWUXFWRUJLYHV
RUFRGH
` \RXDFKDQFHWRVWHSLQWR
&RQVWUXFW WKHPLGGOHRIQHZ
SXEOLFFODVV8VH$'XFN^ 104038 )LOH(GLW:LQGRZ+HOS4XDFN
MDYD8VH$'XFN
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ 4XDFN
'XFNG QHZ'XFN
` 7KLVF
` FRQVWU DOOVWKH'XFN XFWRU
6KDUSHQ \RXU SHQFLO

,QFUHPHQWDFRXQWHUWRWUDFNKRZPDQ\REMHFWVRIWKLVFODVVW\SH
KDYHEHHQPDGH
!CONSTRUCTORLETSYOUJUMPINTOTHEMIDDLE
$VVLJQUXQWLPHVSHFLILFVWDWHGDWDDERXWZKDW·VKDSSHQLQJ12:
OFTHEOBJECTCREATIONSTEPINTOTHEMIDDLE
$VVLJQYDOXHVWRWKHREMHFW·VLPSRUWDQWLQVWDQFHYDULDEOHV
OFQHZ#ANYOUIMAGINECONDITIONSWHERE
*HWDQGVDYHDUHIHUHQFHWRWKHREMHFWWKDW·VFUHDWLQJWKHQHZREMHFW
THATWOULDBEUSEFUL7HICHOFTHESEMIGHT
BEUSEFULINA#ARCLASSCONSTRUCTORIFTHE#AR
$GGWKHREMHFWWRDQ$UUD\/LVW
ISPARTOFA2ACING'AME#HECKOFFTHEONES
&UHDWH+$6$REMHFWV
THATYOUCAMEUPWITHASCENARIOFOR
BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB\RXULGHDKHUH
FKDSWHU
FRQVWUXFWRUVDQGJF
1VQ\QITQbQVO\PM[\I\MWNIVM_,]KS WKHUH DUH QR

'XPE 4XHVWLRQV
-OSTPEOPLEUSECONSTRUCTORSTOINITIALIZETHESTATEOFANOBJECT
)NOTHERWORDSTOMAKEANDASSIGNVALUESTOTHEOBJECTS
INSTANCEVARIABLES
Q: 7HYDOYOUNEEDTOWRITE
ACONSTRUCTORIFTHECOMPILER
WRITESONEFORYOU
SXEOLF'XFN^
VL]H
` A: )FYOUNEEDCODETOHELP
INITIALIZEYOUROBJECTANDGET
4HATSALLWELLANDGOODWHENTHE$UCKCLASSDEVELOPERKNOWS ITREADYFORUSEYOULLHAVETO
HOWBIGTHE$UCKOBJECTSHOULDBE"UTWHATIFWEWANTTHE WRITEYOUROWNCONSTRUCTOR9OU
PROGRAMMERWHOISUSING$UCKTODECIDEHOWBIGAPARTICULAR MIGHTFOREXAMPLEBEDEPEN
$UCKSHOULDBE DENTONINPUTFROMTHEUSER
BEFOREYOUCANFINISHMAKING
)MAGINETHE$UCKHASASIZEINSTANCEVARIABLEANDYOUWANTTHE THEOBJECTREADY4HERESANOTHER
PROGRAMMERUSINGYOUR$UCKCLASSTOSETTHESIZEOFTHENEW REASONYOUMIGHTHAVETOWRITE
$UCK(OWCOULDYOUDOIT ACONSTRUCTOREVENIFYOUDONT
NEEDANYCONSTRUCTORCODE
7ELLYOUCOULDADDASET3IZE SETTERMETHODTOTHECLASS"UT YOURSELF)THASTODOWITHYOUR
THATLEAVESTHE$UCKTEMPORARILYWITHOUTASIZE
ANDFORCESTHE SUPERCLASSCONSTRUCTORANDWELL
$UCKUSERTOWRITETWOSTATEMENTSONETOCREATETHE$UCKAND TALKABOUTTHATINAFEWMINUTES
ONETOCALLTHESET3IZE METHOD4HECODEBELOWUSESASETTER
METHODTOSETTHEINITIALSIZEOFTHENEW$UCK
SXEOLFFODVV'XFN^
Q: (OWCANYOUTELLACON
STRUCTORFROMAMETHOD#AN
EOH
LQWVL]H VWDQFHYDULDLQ YOUALSOHAVEAMETHODTHATS
THESAMENAMEASTHECLASS
SXEOLF'XFN^

6\VWHPRXWSULQWOQ³4XDFN´ FRQVWUXFWRU A: *AVALETSYOUDECLAREA
` METHODWITHTHESAMENAMEAS
YOURCLASS4HATDOESNTMAKEIT
KRG
VHWWHUPHW
SXEOLFYRLGVHW6L]HLQWQHZ6L]H^ ACONSTRUCTORTHOUGH4HETHING
VL]H QHZ6L]H THATSEPARATESAMETHODFROMA
` CONSTRUCTORISTHERETURNTYPE
` -ETHODSMUSTHAVEARETURN
TYPEBUTCONSTRUCTORSCANNOT
HAVEARETURNTYPE
SXEOLFFODVV8VH$'XFN^
Q: !RECONSTRUCTORSINHER
ITED)FYOUDONTPROVIDEA
'XFNG QHZ'XFN CONSTRUCTORBUTYOURSUPERCLASS
7KHUH·VD

WKLVSRLQWLEQDGWKLQJKHUH7KH DOESDOYOUGETTHESUPERCLASS
GVHW6L]H
$QGWKH \ WKHFRGHEXWZLW'XFNLVDOLYHDW CONSTRUCTORINSTEADOFTHE
` WR.12:QW RX·UHUHO\LQJ K
RQWKH'RXXWFDVL]H
DEFAULT
` SURF K D W ' XFNF NXVHU
HVV UHD
WRFDOOWKRHQVHWRFDOOWKHFRQWVWLRUQLVDWZRSDUW A: .OPE#ONSTRUCTORSARE
HWWHU XFWRUDQGR
,QVWDQFHYDULDEOHVGRKDYHDGHIDXOWYDOXHRU
QH NOTINHERITED7ELLLOOKATTHATIN
IRUQXPHULFSULPLWLYHVIDOVHIRUERROHDQVDQG JUSTAFEWPAGES
QXOOIRUUHIHUHQFHV
\RXDUHKHUH
LQLWLDOL]LQJREMHFWVWDWH
=[QVO\PMKWV[\Z]K\WZ\WQVQ\QITQbM
QUXWZ\IV\,]KS[\I\M /HWWKHXVHUPDNHDQHZ'XFN
)FANOBJECTSHOULDNTBEUSEDUNTILONEOR DQGVHWWKH'XFN·VVL]HDOOLQ
RQHFDOO7KHFDOOWRQHZ
MOREPARTSOFITSSTATEINSTANCEVARIABLES HAVE 7KHFDOOWRWKH'XFN
BEENINITIALIZEDDONTLETANYONEGETAHOLDOF FRQVWUXFWRU
A$UCKOBJECTUNTILYOURElNISHEDINITIALIZING
)TSUSUALLYWAYTOORISKYTOLETSOMEONEMAKE
ANDGETAREFERENCETOANEW$UCKOBJECTTHAT
ISNTQUITEREADYFORUSEUNTILTHATSOMEONETURNS
AROUNDANDCALLSTHESET3IZE METHOD(OWWILL
THE$UCK USEREVENKNOWTHATHESREQUIREDTOCALL
THESETTERMETHODAFTERMAKINGTHENEW$UCK
4HEBESTPLACETOPUTINITIALIZATIONCODEISINTHE
CONSTRUCTOR!NDALLYOUNEEDTODOISMAKEA
RWKH
CONSTRUCTORWITHARGUMENTS
W
S D U D PHWHU
SXEOLFFODVV'XFN^ QLQW U
LQWVL]H $GGD FRQVWUXFWR
'XFN
SXEOLF'XFNLQWGXFN6L]H^
6\VWHPRXWSULQWOQ³4XDFN´ W
8VHWKHDUJXPHQWYDOXHWRVH
VL]H GXFN6L]H WKHVL]HLQVWDQFHYDULDEOH
6\VWHPRXWSULQWOQ³VL]HLV³VL]H
`
`
SXEOLFFODVV8VH$'XFN^
'XFNG QHZ'XFN
R Q O\ 3DVVDYDOXHW
HUH·V PDNH `
`
P H W K F RWKH
WL H RQVW UXFWRU
7KLV DWHPHQW: GVHW
RQHVW HZ'XFNDQ DWHPHQW )LOH(GLW:LQGRZ+HOS+RQN
WKHQ HLQRQHVW MDYD8VH$'XFN

LWVVL]
4XDFN
VL]HLV
1RWWRLPSO\WKDWQRWDOO'XFNVWDWHLVQRWXQLPSRUWDQW
FKDSWHU
FRQVWUXFWRUVDQGJF
5ISMQ\MI[a\WUISMI,]KS
*M[]ZMaW]PI^MIVWIZOKWV[\Z]K\WZ
7HATHAPPENSIFTHE$UCKCONSTRUCTORTAKESANARGUMENT
4HINKABOUTIT/NTHEPREVIOUSPAGETHERESONLYONE$UCK
CONSTRUCTORANDITTAKESANINTARGUMENTFORTHESIZEOFTHE
$UCK4HATMIGHTNOTBEABIGPROBLEMBUTITDOESMAKEIT 9OUREALLYWANT47/WAYSTO
HARDERFORAPROGRAMMERTOCREATEANEW$UCKOBJECTESPECIALLY
MAKEANEW$UCK
IFTHEPROGRAMMERDOESNTKNOWWHATTHESIZEOFA$UCKSHOULD
BE7OULDNTITBEHELPFULTOHAVEADEFAULTSIZEFORA$UCKSO
THATIFTHEUSERDOESNTKNOWANAPPROPRIATESIZEHECANSTILL SXEOLFFODVV'XFN^
MAKEA$UCKTHATWORKS LQWVL]H
,PDJLQHWKDW\RXZDQW'XFNXVHUVWRKDYH7:2RSWLRQV SXEOLF'XFN^
IRUPDNLQJD'XFN²RQHZKHUHWKH\VXSSO\WKH'XFN VXSSO\GHIDXOWVL]H
VL]HDVWKHFRQVWUXFWRUDUJXPHQWDQGRQHZKHUHWKH\ VL]H
GRQ¶WVSHFLI\DVL]HDQGWKXVJHW\RXUGHIDXOW'XFNVL]H `
9OUCANTDOTHISCLEANLYWITHJUSTASINGLECONSTRUCTOR SXEOLF'XFNLQWGXFN6L]H^

2EMEMBERIFAMETHODORCONSTRUCTORSAMERULES HAS XVHGXFN6L]HSDUDPHWHU
VL]H GXFN6L]H
APARAMETERYOUMUSTPASSANAPPROPRIATEARGUMENTWHEN
`
YOUINVOKETHATMETHODORCONSTRUCTOR9OUCANTJUSTSAYh)F `
SOMEONEDOESNTPASSANYTHINGTOTHECONSTRUCTORTHENUSE
THEDEFAULTSIZEvBECAUSETHEYWONTEVENBEABLETOCOMPILE
WITHOUTSENDINGANINTARGUMENTTOTHECONSTRUCTORCALL9OU 4OMAKEA$UCKWHENYOUKNOWTHESIZE
COULDDOSOMETHINGCLUNKLYLIKETHIS 'XFNG QHZ'XFN
SXEOLFFODVV'XFN^
OXHLV 4OMAKEA$UCKWHENYOUDONOTKNOW
PHWHUYD'XFND
LQWVL]H
K H S D U D THESIZE
,IW JLYHWKHQHZ ZLVHXVH
SXEOLF'XFNLQWQHZ6L]H^
]HUR OWVL]HRWKHU HIRU 'XFNG QHZ'XFN
LIQHZ6L]H ^
GHIDX DUDPHWHUYDOX U\JRRG
VL]H
WKHS H127DYH 3OTHISTWO OPTIONS TO MAKE A $UCKIDEA
`HOVH^
WKHVL]Q NEEDSTWOCONSTRUCTORS/NETHATTAKES
VL]H QHZ6L]H
`
VROXWLR ANINTANDONETHATDOESNT)FYOUHAVE
` MORETHANONECONSTRUCTORINACLASS
` ITMEANSYOUHAVEOVERLOADED
CONSTRUCTORS
"UTTHATMEANSTHEPROGRAMMERMAKINGANEW$UCKOBJECTHAS
TOKNOWTHATPASSINGAhvISTHEPROTOCOLFORGETTINGTHEDEFAULT
$UCKSIZE0RETTYUGLY7HATIFTHEOTHERPROGRAMMERDOESNT
KNOWTHAT/RWHATIFHEREALLYDOESWANTAZERO SIZE$UCK
!SSUMINGAZERO SIZED$UCKISALLOWED)FYOUDONTWANT
ZERO SIZED$UCKOBJECTSPUTVALIDATIONCODEINTHECONSTRUCTOR
TOPREVENTIT 4HEPOINTISITMIGHTNOTALWAYSBEPOSSIBLE
TODISTINGUISHBETWEENAGENUINEh)WANTZEROFORTHESIZEv
CONSTRUCTORARGUMENTANDAh)MSENDINGZEROSOYOULLGIVE
METHEDEFAULTSIZEWHATEVERTHATISvCONSTRUCTORARGUMENT
\RXDUHKHUH
RYHUORDGHGDQGGHIDXOWFRQVWUXFWRUV
,WM[V¼\\PMKWUXQTMZIT_Ia[
UISMIVWIZOKWV[\Z]K\WZ 2.OHW·VVHHKHUH´<RX
KDYHWKHULJKWWR\RXURZQ
NWZaW]' 1R FRQVWUXFWRUµ0DNHVVHQVH
9OUMIGHTTHINKTHATIFYOUWRITEONLY ´,I\RXFDQQRWDIIRUGDFRQVWUXFWRU
ACONSTRUCTORWITHARGUMENTSTHE
RQHZLOOEHSURYLGHGIRU\RXE\WKH
COMPILERWILLSEETHATYOUDONTHAVEA
NO ARGCONSTRUCTORANDSTICKONEINFOR FRPSLOHUµ*RRGWRNQRZ
YOU"UTTHATSNOTHOWITWORKS4HE
COMPILERGETSINVOLVEDWITHCONSTRUCTOR
MAKINGONLYIFYOUDONTSAYANYTHINGATALL
ABOUTCONSTRUCTORS
,I\RXZULWHDFRQVWUXFWRUWKDW
WDNHVDUJXPHQWVDQG\RXVWLOO
ZDQWDQRDUJFRQVWUXFWRU
\RX·OOKDYHWREXLOGWKHQRDUJ
FRQVWUXFWRU\RXUVHOI
!SSOONASYOUPROVIDEACONSTRUCTOR
!.9KINDOFCONSTRUCTORTHECOMPILER
BACKSOFFANDSAYSh/+"UDDYLOOKSLIKE
YOUREINCHARGEOFCONSTRUCTORSNOWv
,I\RXKDYHPRUHWKDQRQH
FRQVWUXFWRULQDFODVVWKH
FRQVWUXFWRUV0867KDYH
GLIIHUHQWDUJXPHQWOLVWV
4HEARGUMENTLISTINCLUDESTHEORDER
ANDTYPESOFTHEARGUMENTS!SLONGAS
THEYREDIFFERENTYOUCANHAVEMORE
THANONECONSTRUCTOR9OUCANDOTHIS
WITHMETHODSASWELLBUTWELLGETTOTHAT
INANOTHERCHAPTER
FKDSWHU
FRQVWUXFWRUVDQGJF
2YHUORDGHGFRQVWUXFWRUVPHDQV\RXKDYH
PRUHWKDQRQHFRQVWUXFWRULQ\RXUFODVV
7RFRPSLOHHDFKFRQVWUXFWRUPXVWKDYHD
GLIIHUHQWDUJXPHQWOLVW
4HECLASSBELOWISLEGALBECAUSEALLFOURCONSTRUCTORSHAVE
DIFFERENTARGUMENTLISTS)FYOUHADTWOCONSTRUCTORSTHATTOOK )RXUGLI
ONLYANINTFOREXAMPLETHECLASSWOULDNTCOMPILE7HATYOU
PHDQVI IHUHQWFRQVWU
PDNHD RXUGLIIHUHQW XFWRUV
NAMETHEPARAMETERVARIABLEDOESNTCOUNT)TSTHEVARIABLE
TYPEINT$OGETC ANDORDERTHATMATTERS9OUCANHAVETWO QHZPXV
CONSTRUCTORSTHATHAVEIDENTICALTYPESASLONGASTHEORDERIS KURRP ZD\VWR
DIFFERENT!CONSTRUCTORTHATTAKESA3TRINGFOLLOWEDBYANINTIS
NOTTHESAMEASONETHATTAKESANINTFOLLOWEDBYA3TRING
VL]HEXW\RX
SXEOLFFODVV0XVKURRP^ ZKHQ\RXNQRZWKH PDJLF
GRQ·WNQRZLILW·V
SXEOLF0XVKURRPLQWVL]H^`
RZDQ\WKLQJ
ZKHQ\RXGRQ·WNQ
SXEOLF0XVKURRP^`
ZKHQ\RXNQNQRZRZLI LW·VPDJLFRUQRW
KHV L] H
SXEOLF0XVKURRPERROHDQLV0DJLF^` EXWGRQ·W W
W KH ERROHDQLV0DJLFLQWVL]H ZKHQ\RXNQRZ LW·V
YH ZKHWKHURUQRWNQRZ
KD SXEOLF0XVKURRP ^`
WKHVHWZR WLQ
VDPHDUJV EX
LQWVL]HERROHDQLV0DJLF^` PDJLF$1 ZHOO
'\RX
HQ W R UG HU VR
SXEOLF0XVKURRP
VL] HDV
GLIIHU WKH
LW·V2. `
:MDD=LHGAFLK
,QVWDQFHYDULDEOHVOLYHZLWKLQWKHREMHFWWKH\EHORQJWRRQ
WKH+HDS
,I\RXZDQWDQRDUJFRQVWUXFWRUDQG\RX·YHDOUHDG\SXW
LQDFRQVWUXFWRUZLWKDUJXPHQWV\RX·OOKDYHWREXLOGWKH
QRDUJFRQVWUXFWRU\RXUVHOI
,IWKHLQVWDQFHYDULDEOHLVDUHIHUHQFHWRDQREMHFWERWK
WKHUHIHUHQFHDQGWKHREMHFWLWUHIHUVWRDUHRQWKH+HDS
$OZD\VSURYLGHDQRDUJFRQVWUXFWRULI\RXFDQWRPDNHLW
HDV\IRUSURJUDPPHUVWRPDNHDZRUNLQJREMHFW6XSSO\
$FRQVWUXFWRULVWKHFRGHWKDWUXQVZKHQ\RXVD\QHZRQ
DFODVVW\SH GHIDXOWYDOXHV
$FRQVWUXFWRUPXVWKDYHWKHVDPHQDPHDVWKHFODVVDQG 2YHUORDGHGFRQVWUXFWRUVPHDQV\RXKDYHPRUHWKDQRQH
FRQVWUXFWRULQ\RXUFODVV
PXVWQRWKDYHDUHWXUQW\SH
<RXFDQXVHDFRQVWUXFWRUWRLQLWLDOL]HWKHVWDWHLHWKH 2YHUORDGHGFRQVWUXFWRUVPXVWKDYHGLIIHUHQWDUJXPHQW

OLVWV
LQVWDQFHYDULDEOHVRIWKHREMHFWEHLQJFRQVWUXFWHG
,I\RXGRQ·WSXWDFRQVWUXFWRULQ\RXUFODVVWKHFRPSLOHU <RXFDQQRWKDYHWZRFRQVWUXFWRUVZLWKWKHVDPH
DUJXPHQWOLVWV$QDUJXPHQWOLVWLQFOXGHVWKHRUGHUDQGRU
ZLOOSXWLQDGHIDXOWFRQVWUXFWRU
W\SHRIDUJXPHQWV
7KHGHIDXOWFRQVWUXFWRULVDOZD\VDQRDUJFRQVWUXFWRU
,QVWDQFHYDULDEOHVDUHDVVLJQHGDGHIDXOWYDOXHHYHQ
,I\RXSXWDFRQVWUXFWRU³DQ\FRQVWUXFWRU³LQ\RXUFODVV
WKHFRPSLOHUZLOOQRWEXLOGWKHGHIDXOWFRQVWUXFWRU
ZKHQ\RXGRQ·WH[SOLFLWO\DVVLJQRQH7KHGHIDXOWYDOXHV
DUHIDOVHIRUSULPLWLYHVDQGQXOOIRUUHIHUHQFHV
\RXDUHKHUH
RYHUORDGHGFRQVWUXFWRUV
FODVV'XFN^
6KDUSHQ \RXU SHQFLO LQWSRXQGV
0DWFKWKHQHZ'XFNFDOOZLWKWKHFRQVWUXFWRU ÀRDWÀRDWDELOLW\ )
WKDWUXQVZKHQWKDW'XFNLVLQVWDQWLDWHG:HGLG 6WULQJQDPH ³*HQHULF´
ORQJ>@IHDWKHUV ^`
WKHHDV\RQHWRJHW\RXVWDUWHG
ERROHDQFDQ)O\ WUXH
LQWPD[6SHHG
SXEOLFFODVV7HVW'XFN^
SXEOLF'XFN^
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ 6\VWHPRXWSULQWOQ³W\SHGXFN´
`
LQWZHLJKW
ÀRDWGHQVLW\ ) SXEOLF'XFNERROHDQÀ\^
6WULQJQDPH ³'RQDOG´ FDQ)O\ À\
ORQJ>@IHDWKHUV ^` 6\VWHPRXWSULQWOQ³W\SHGXFN´
ERROHDQFDQ)O\ WUXH `
LQWDLUVSHHG
SXEOLF'XFN6WULQJQORQJ>@I^
'XFN>@G QHZ'XFN>@ QDPH Q
IHDWKHUV I
G>@ QHZ'XFN 6\VWHPRXWSULQWOQ³W\SHGXFN´
`
G>@ QHZ'XFNGHQVLW\ZHLJKW
SXEOLF'XFNLQWZÀRDWI^
G>@ QHZ'XFNQDPHIHDWKHUV SRXQGV Z
ÀRDWDELOLW\ I
G>@ QHZ'XFNFDQ)O\ 6\VWHPRXWSULQWOQ³W\SHGXFN´
`
G>@ QHZ'XFN)DLUVSHHG
SXEOLF'XFNÀRDWGHQVLW\LQWPD[^
G>@ QHZ'XFNIDOVH ÀRDWDELOLW\ GHQVLW\
PD[6SHHG PD[
G>@ QHZ'XFNDLUVSHHGGHQVLW\ 6\VWHPRXWSULQWOQ³W\SHGXFN´
` `
` `

Q:

%ARLIERYOUSAIDTHATITSGOODTOHAVEANO ARGU 7EREUSINGTHREEINTSFOR2'"VALUESHERE7ELLGETINTO
USING#OLORLATERINTHE3WINGCHAPTERS /THERWISEWHAT
MENTCONSTRUCTORSOTHATIFPEOPLECALLTHENO ARGCON
STRUCTORWECANSUPPLYDEFAULTVALUESFORTHEhMISSINGv WOULDYOUGET4HE*AVA!0)PROGRAMMERSCOULDHAVEDE
ARGUMENTS"UTARENTTHERETIMESWHENITSIMPOSSIBLETO CIDEDTHATIFYOUCALLANO ARG#OLORCONSTRUCTORYOULLGETA
COMEUPWITHDEFAULTS!RETHERETIMESWHENYOUSHOULD LOVELYSHADEOFMAUVE"UTGOODTASTEPREVAILED
NOTHAVEANO ARGCONSTRUCTORINYOURCLASS )FYOUTRYTOMAKEA#OLORWITHOUTSUPPLYINGANARGUMENT
A: 9OURERIGHT4HEREARETIMESWHENANO ARGCONSTRUC
TORDOESNTMAKESENSE9OULLSEETHISINTHE*AVA!0)SOME
&RORUF QHZ&RORU
4HECOMPILERFREAKSOUTBECAUSEITCANTFINDAMATCHINGNO
CLASSESDONTHAVEANO ARGCONSTRUCTOR4HE#OLORCLASSFOR ARGCONSTRUCTORINTHE#OLORCLASS
EXAMPLEREPRESENTSACOLOR#OLOROBJECTSAREUSEDTOFOR
)LOH(GLW:LQGRZ+HOS6WRS%HLQJ6WXSLG
EXAMPLESETORCHANGETHECOLOROFASCREENFONTOR'5)
BUTTON7HENYOUMAKEA#OLORINSTANCETHATINSTANCEIS FDQQRWUHVROYHV\PERO
FRQVWUXFWRU&RORU
OFAPARTICULARCOLORYOUKNOW$EATH BY #HOCOLATE"ROWN ORFDWLRQFODVV
"LUE 3CREEN OF $EATH"LUE3CANDALOUS2EDETC )FYOU MDYDDZW&RORU
MAKEA#OLOROBJECTYOUMUSTSPECIFYTHECOLORINSOMEWAY &RORUF QHZ&RORU
A
&RORUF QHZ&RORU HUURU
FKDSWHU
FRQVWUXFWRUVDQGJF
6IVWZM^QM_"NW]Z\PQVO[\W
YiXè
ZMUMUJMZIJW]\KWV[\Z]K\WZ[ gfn\i
7HATABOUTSUPERCLASSES
$FRQVWUXFWRULVWKHFRGHWKDWUXQVZKHQ
VRPHERG\VD\VQHZRQDFODVVW\SH 7HENYOUMAKEA$OG
'XFNG QHZ'XFN
SHOULDTHE#ANINE
CONSTRUCTORRUNTOO
)FTHESUPERCLASSISABSTRACT
SHOULDITEVENHAVEA
$FRQVWUXFWRUPXVWKDYHWKHVDPHQDPH
DVWKHFODVVDQGQRUHWXUQW\SH CONSTRUCTOR
SXEOLF'XFNLQWVL]H^`
7ELLLOOKATTHISONTHENEXT
FEWPAGESSOSTOPNOWAND
THINKABOUTTHEIMPLICATIONSOF
,I\RXGRQ·WSXWDFRQVWUXFWRULQ\RXUFODVV CONSTRUCTORSANDSUPERCLASSES
WKHFRPSLOHUSXWVLQDGHIDXOWFRQVWUXFWRU
7KHGHIDXOWFRQVWUXFWRULVDOZD\VDQRDUJ
FRQVWUXFWRU WKHUH DUH QR
SXEOLF'XFN^`
'XPE 4XHVWLRQV
Q: $OCONSTRUCTORSHAVETOBESXEOLF
A: .O#ONSTRUCTORSCANBESXEOLF
SULYDWHORDEFAULTWHICHMEANSNOACCESS
<RXFDQKDYHPRUHWKDQRQHFRQVWUXFWRULQ\RXUFODVV
DVORQJDVWKHDUJXPHQWOLVWVDUHGLIIHUHQW+DYLQJ MODIFIERATALL 7ELLLOOKMOREATDEFAULT
PRUHWKDQRQHFRQVWUXFWRULQDFODVVPHDQV\RXKDYH ACCESSINCHAPTERANDAPPENDIX"
RYHUORDGHGFRQVWUXFWRUV
SXEOLF'XFN^`
Q: (OWCOULDAPRIVATECONSTRUCTOR
EVERBEUSEFUL.OBODYCOULDEVERCALLIT
SONOBODYCOULDEVERMAKEANEWOBJECT
SXEOLF'XFNLQWVL]H^`
SXEOLF'XFN6WULQJQDPH^`

A: "UTTHATSNOTEXACTLYRIGHT-ARKING
SOMETHINGSULYDWHDOESNTMEANNOBODY
CANACCESSITITJUSTMEANSTHATNOBODY
SXEOLF'XFN6WULQJQDPHLQWVL]H^` OUTSIDETHECLASSCANACCESSIT"ETYOURE
THINKINGh#ATCHv/NLYCODEFROMTHE
SAMECLASSASTHECLASS WITH PRIVATE CON
STRUCTORCANMAKEANEWOBJECTFROMTHAT
CLASSBUTWITHOUTFIRSTMAKINGANOBJECT
HOWDOYOUEVERGETTORUNCODEFROMTHAT
CLASSINTHEFIRSTPLACE(OWDOYOUEVERGET
'RLQJDOOWKH%UDLQ%DUEHOOVKDVEHHQVKRZQWRSURGXFHDLQFUHDVHLQ TOANYTHINGINTHATCLASS0ATIENCEGRASSHOP
QHXURQVL]H$QG\RXNQRZZKDWWKH\VD\³%LJQHXURQV´ PER7ELLGETTHEREINTHENEXTCHAPTER
\RXDUHKHUH
VSDFHIRUDQREMHFW·VVXSHUFODVVSDUWV
?IQ\IUQV]\M_MVM^MZ,1,\ITSIJW]\
[]XMZKTI[[M[IVLQVPMZQ\IVKMIVLPW_\PI\ITT
NQ\[QV_Q\PKWV[\Z]K\WZ[
(ERESWHEREITGETSFUN2EMEMBERFROMTHELASTCHAPTERTHEPARTWHEREWELOOKEDAT
THE3NOWBOARDOBJECTWRAPPINGAROUNDANINNERCOREREPRESENTINGTHE/BJECTPORTION
OFTHE3NOWBOARDCLASS4HE"IG0OINTTHEREWASTHATEVERYOBJECTHOLDSNOTJUSTITSOWN
DECLAREDINSTANCEVARIABLESBUTALSOEVERYTHINGFROMITSSUPERCLASSESWHICHATAMINIMUM
MEANSCLASS/BJECTSINCEEVERYCLASSEXTENDS/BJECT
3OWHENANOBJECTISCREATEDBECAUSESOMEBODYSAIDQHZTHEREISNOOTHERWAYTOCREATE
ANOBJECTOTHERTHANSOMEONESOMEWHERESAYINGQHZONTHECLASSTYPE THEOBJECT
GETSSPACEFORALLTHEINSTANCEVARIABLESFROMALLTHEWAYUPTHEINHERITANCETREE4HINK
ABOUTITFORAMOMENTASUPERCLASSMIGHTHAVESETTERMETHODSE NCAPSULATINGAPRIVATE
VARIABLE"UTTHATVARIABLEHASTOLIVESOMEWHERE7HENANOBJECTISCREATEDITSALMOSTAS
THOUGHMULTIPLEOBJECTSMATERIALIZETHEOBJECTBEINGNEWDANDONEOBJECTPEREACH
SUPERCLASS#ONCEPTUALLYTHOUGHITSMUCHBETTERTOTHINKOFITLIKETHEPICTUREBELOW
WHERETHEOBJECTBEINGCREATEDHASLAYERSOFITSELFREPRESENTINGEACHSUPERCLASS
$VLQJOH
2EMHFW 2EMHFWKDVLQVWDQFHYDULDEOHV REMHFWRQ
)RRD HQFDSVXODWHGE\DFFHVVPHWKRGV WKHKHDS
Q
LQWE P
LQWF
7KRVHLQVWDQFHYDULDEOHVDUH R
FUHDWHGZKHQDQ\VXEFODVVLV
HTXDOV LQVWDQWLDWHG7KHVHDUHQ·WWKH
JHW&ODVV
KDVK&RGH
5($/2EMHFWYDULDEOHVEXWZH Y Z ;
WR6WULQJ GRQ·WFDUHZKDWWKH\DUHVLQFH
WKH\·UHHQFDSVXODWHG 2EMHFW
6QRZERDUG 6QRZERDUGDOVRKDVLQVWDQFH
)RR[ YDULDEOHVRILWVRZQVRWRPDNH 6QRZERDUG
)RR\ D6QRZERDUGREMHFWZHQHHG
LQW] 6Q W
VSDFHIRUWKHLQVWDQFHYDULDEOHV RZ E MHF
RDUGRE
WXUQ RIERWKFODVVHV
VKUHG
JHW$LU 7KHUHLVRQO\21(REMHFWRQWKHKHDSKHUH$
ORVH&RQWURO 6QRZERDUGREMHFW%XWLWFRQWDLQVERWKWKH
6QRZERDUGSDUWVRILWVHOIDQGWKH2EMHFWSDUWVRI
LWVHOI$OOLQVWDQFHYDULDEOHVIURPERWKFODVVHVKDYH
WREHKHUH
FKDSWHU
FRQVWUXFWRUVDQGJF
<PMZWTMWN[]XMZKTI[[KWV[\Z]K\WZ[
QVIVWJRMK\¼[TQNM
!LLTHECONSTRUCTORSINANOBJECTSINHERITANCE
TREEMUSTRUNWHENYOUMAKEANEWOBJECT
,ETTHATSINKIN
4HATMEANSEVERYSUPERCLASSHASACONSTRUCTOR
BECAUSEEVERYCLASSHASACONSTRUCTOR ANDEACH
CONSTRUCTORUPTHEHIERARCHYRUNSATTHETIMEAN
OBJECTOFASUBCLASSISCREATED
3AYINGQHZISA"IG$EAL)TSTARTSTHE P Q
WHOLECONSTRUCTORCHAINREACTION! NDYES
K 2EMHFW
EVENABSTRACTCLASSESHAVECONSTRUCTORS N
c
!LTHOUGHYOUCANNEVERSAYNEWONAN
ABSTRACTCLASSANABSTRACTCLASSISSTILL
Y ;
ASUPERCLASSSOITSCONSTRUCTORRUNS Z
WHENSOMEONEMAKESANINSTANCEOFA $QLPDO
CONCRETESUBCLASS
2EMHFW
4HESUPERCONSTRUCTORSRUNTOBUILD
OUTTHESUPERCLASSPARTSOFTHEOBJECT $QLPDO
2EMEMBERASUBCLASSMIGHTINHERIT
METHODSTHATDEPENDONSUPERCLASSSTATE +,SSR
+LSSR
INOTHERWORDSTHEVALUEOFINSTANCEVARIABLES
INTHESUPERCLASS &ORANOBJECTTOBEFULLY
FORMEDALLTHESUPERCLASSPARTSOFITSELFMUSTBE
$VLQJOH+LSSRREMHFWRQWKHKHDS
FULLY FORMEDANDTHATSWHYTHESUPERCONSTRUCTOR
MUSTRUN!LLINSTANCEVARIABLESFROMEVERYCLASS
INTHEINHERITANCETREEHAVETOBEDECLAREDAND $QHZ+LSSRREMHFWDOVR,6$$QLPDO
INITIALIZED%VENIF!NIMALHASINSTANCEVARIABLES DQG,6$2EMHFW,I\RXZDQWWRPDNHD
THAT(IPPODOESNTINHERITIFTHEVARIABLESARE +LSSR\RXPXVWDOVRPDNHWKH$QLPDO
PRIVATEFOREXAMPLE THE(IPPOSTILLDEPENDSON DQG2EMHFWSDUWVRIWKH+LSSR
THE!NIMALMETHODSTHATUSETHOSEVARIABLES
7KLVDOOKDSSHQVLQDSURFHVVFDOOHG
7HENACONSTRUCTORRUNSITIMMEDIATELYCALLSITS &RQVWUXFWRU&KDLQLQJ
SUPERCLASSCONSTRUCTORALLTHEWAYUPTHECHAIN
UNTILYOUGETTOTHECLASS/BJECTCONSTRUCTOR
/NTHENEXTFEWPAGESYOULLLEARNHOWSUPERCLASS
CONSTRUCTORSARECALLEDANDHOWYOUCANCALL
THEMYOURSELF9OULLALSOLEARNWHATTODOIFYOUR
SUPERCLASSCONSTRUCTORHASARGUMENTS
\RXDUHKHUH
REMHFWFRQVWUXFWLRQ
5ISQVOI0QXXWUMIV[UISQVO\PM
)VQUITIVL7JRMK\XIZ\[\WW 6KDUSHQ \RXU SHQFLO
7HATSTHEREALOUTPUT'IVENTHE
CODEONTHELEFTWHATPRINTSOUT
WHENYOURUN4EST(IPPO!OR"
SXEOLFFODVV$QLPDO^
THEANSWERISATTHEBOTTOMOFTHEPAGE
SXEOLF$QLPDO^
6\VWHPRXWSULQWOQ³0DNLQJDQ$QLPDO´
` )LOH(GLW:LQGRZ+HOS6ZHDU
` MDYD7HVW+LSSR
$ 6WDUWLQJ
Licensed by
SXEOLFFODVV+LSSRH[WHQGV$QLPDO^ 0DNLQJDQ$QLPDO
SXEOLF+LSSR^ 0DNLQJD+LSSR
6\VWHPRXWSULQWOQ³0DNLQJD+LSSR´
`
`
Eduard Simons
)LOH(GLW:LQGRZ+HOS6ZHDU
SXEOLFFODVV7HVW+LSSR^ MDYD7HVW+LSSR
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ % 6WDUWLQJ
6\VWHPRXWSULQWOQ³6WDUWLQJ´ 0DNLQJD+LSSR
+LSSRK QHZ+LSSR
104038
` 0DNLQJDQ$QLPDO
`
&RGHIURPDQRWKHU +LSSRLQYRNHV $QLPDOLQYRNHV 2EMHFWFRPSOHWHV

FODVVVD\VQHZ WKHVXSHUFODVV WKHVXSHUFODVV DQGLWVVWDFNIUDPH
+LSSRDQGWKH FRQVWUXFWRUZKLFK FRQVWUXFWRUZKLFK LVSRSSHGRIIWKH
+LSSRFRQVWUXFWRU SXVKHVWKH$QLPDO SXVKHVWKH2EMHFW VWDFN([HFXWLRQJRHV
JRHVLQWRDVWDFN FRQVWUXFWRURQWRWKH FRQVWUXFWRURQWR EDFNWRWKH$QLPDO
IUDPHDWWKHWRSRI WRSRIWKHVWDFN WKHWRSRIWKHVWDFN FRQVWUXFWRUDQG
WKHVWDFN VLQFH2EMHFWLVWKH SLFNVXSDWWKHOLQH
VXSHUFODVVRI$QLPDO IROORZLQJ$QLPDO·V
FDOOWRLWVVXSHUFODVV
FRQVWUXFWRU
2EMHFW
$QLPDO $QLPDO $QLPDO
+LSSR +LSSR +LSSR +LSSR
LW·VWKH$QLPDOFRQVWUXFWRUWKDWILQLVKHVILUVW
7KHILUVWRQH$7KH+LSSRFRQVWUXFWRULVLQYRNHGILUVWEXW
FKDSWHU
FRQVWUXFWRUVDQGJF
0W_LWaW]QV^WSMI[]XMZKTI[[KWV[\Z]K\WZ'
9OUMIGHTTHINKTHATSOMEWHEREINSAYA$UCKCONSTRUCTOR
IF$UCKEXTENDS!NIMALYOUDCALL!NIMAL "UTTHATSNOT
HOWITWORKS
SXEOLFFODVV'XFNH[WHQGV$QLPDO^
LQWVL]H
SXEOLF'XFNLQWQHZ6L]H^ $QGKRZLVLWWKDWZH·YH

$QLPDO JRWWHQDZD\ZLWKRXW
%$'VL]H QHZ6L]H 127KLV GRLQJLW"
LVQRWOH
JD O
` 9OUPROBABLYFIGUREDTHATOUT
` /URGOODFRIENDTHECOMPILER
PUTSINACALLTOSUPER IFYOU
DONT
4HEONLYWAYTOCALLASUPERCONSTRUCTORISBYCALLINGSUPER
4HATSRIGHTSUPER CALLSTHESUPERCONSTRUCTOR 3OTHECOMPILERGETSINVOLVEDIN
CONSTRUCTOR MAKINGINTWOWAYS
7HATARETHEODDS
SXEOLFFODVV'XFNH[WHQGV$QLPDO^ )FYOUDONTPROVIDEACONSTRUCTOR
LQWVL]H 4HECOMPILERPUTSONEINTHATLOOKSLIKE
SXEOLF&ODVV1DPH^
VXSHU
SXEOLF'XFNLQWQHZ6L]H^
`
VXSHU \RXMXVWVD\V
X SHU
VL]H QHZ6L]H
` )FYOUDOPROVIDEACONSTRUCTOR
BUTYOUDONOTPUTINTHECALLTO
` SUPER
4HECOMPILERWILLPUTACALLTOSUPER IN
!CALLTOSUPER INYOURCONSTRUCTORPUTSTHESUPERCLASS EACHOFYOUROVERLOADEDCONSTRUCTORS

CONSTRUCTORONTHETOPOFTHE3TACK!NDWHATDOYOU 4HECOMPILER SUPPLIEDCALLLOOKSLIKE
THINKTHATSUPERCLASSCONSTRUCTORDOES#ALLSITSSUPERCLASS
VXSHU
CONSTRUCTOR!NDSOITGOESUNTILTHE/BJECTCONSTRUCTORIS
ONTHETOPOFTHE3TACK/NCE/BJECT lNISHESITSPOPPED )TALWAYSLOOKSLIKETHAT4HECOMPILER
OFFTHE3TACKANDTHENEXTTHINGDOWNTHE3TACKTHE INSERTEDCALLTOSUPER ISALWAYSANO ARG
SUBCLASSCONSTRUCTORTHATCALLED/BJECT ISNOWONTOP CALL)FTHESUPERCLASSHASOVERLOADED
CONSTRUCTORSONLYTHENO ARGONEISCALLED
4HATCONSTRUCTORlNISHESANDSOITGOESUNTILTHEORIGINAL
CONSTRUCTORISONTHETOPOFTHE3TACKWHEREITCANNOW 8QOHVVWKHFRQVWUXFWRUFDOOVDQRWKHURYHUORDGHG
lNISH FRQVWUXFWRU\RX·OOVHHWKDWLQDIHZSDJHV
\RXDUHKHUH
REMHFWOLIHF\FOH
+IV\PMKPQTLM`Q[\JMNWZM
\PMXIZMV\[' (HZZZZWKDW
)FYOUTHINKOFASUPERCLASSASTHEPARENTTOTHESUBCLASSCHILD LV62FUHHS\7KHUH·V
YOUCANlGUREOUTWHICHHASTOEXISTlRST4HESUPERCLASSPARTS QRZD\,FRXOGKDYHEHHQ
OFANOBJECTHAVETOBEFULLY FORMEDCOMPLETELYBUILT BEFORETHE ERUQEHIRUHP\SDUHQWV
SUBCLASSPARTSCANBECONSTRUCTED2EMEMBER
7KDW·VMXVWZURQJ
THESUBCLASSOBJECTMIGHTDEPENDONTHINGSIT
INHERITSFROMTHESUPERCLASSSOITSIMPORTANT
THATTHOSEINHERITEDTHINGSBElNISHED.O
WAYAROUNDIT4HESUPERCLASSCONSTRUCTOR
MUSTlNISHBEFOREITSSUBCLASSCONSTRUCTOR
,OOKATTHE3TACKSERIESONPAGEAGAIN
ANDYOUCANSEETHATWHILETHE(IPPO
CONSTRUCTORISTHElRSTTOBEINVOKEDITS
THElRSTTHINGONTHE3TACK ITSTHELASTONE
TOCOMPLETE%ACHSUBCLASSCONSTRUCTOR
IMMEDIATELYINVOKESITSOWNSUPERCLASS
CONSTRUCTORUNTILTHE/BJECTCONSTRUCTOR
ISONTHETOPOFTHE3TACK4HEN/BJECTS
CONSTRUCTORCOMPLETESANDWEBOUNCE
BACKDOWNTHE3TACKTO!NIMALS
CONSTRUCTOR/NLYAFTER!NIMALSCONSTRUCTORCOMPLETES
DOWElNALLYCOMEBACKDOWNTOlNISHTHERESTOFTHE(IPPO
CONSTRUCTOR&ORTHATREASON
7KHFDOOWRVXSHUPXVWEHWKHÀUVWVWDWHPHQW
LQHDFKFRQVWUXFWRU
3RVVLEOHFRQVWUXFWRUVIRUFODVV%RRS
; SXEOLF%RRS^
; SXEOLF%RRS^ ` 7KHVHD
WKHFRPSULOHH2.EHFDXVH
FDOOWRVXSH UZLOOSXWD
VXSHU
7KHVHD
` WKHSURJUUHD2 .EHFDXVH ; SXEOLF%RRSLQWL^ ILUVWVWDWH ULQDVWKH
SOLFLWO\FRG PPHUH[ PHQW
VL]H L
WRVXSHU HGWKHFDOO
; SXEOLF%RRSLQWL^ VWDWHPHQW DVWKHILUVW `
VXSHU
VL]H L SXEOLF%RRSLQWL^ %$'7
<RXFDQ·WKHLVZRQ·WFRPSLOH
` VL]H L
WKHFDOO RV[SOLFLWO\SXW
VXSHU DQ\WKLQJW XSHU
HOVH EHORZ
`
7KHUH¶VDQH[FHSWLRQWRWKLVUXOH\RX¶OOOHDUQLWRQSDJH
FKDSWHU
FRQVWUXFWRUVDQGJF
;]XMZKTI[[KWV[\Z]K\WZ[_Q\PIZO]UMV\[
7HATIFTHESUPERCLASSCONSTRUCTORHASARGUMENTS#ANYOUPASSSOMETHINGINTO
THESUPER CALL/FCOURSE)FYOUCOULDNTYOUDNEVERBEABLETOEXTENDACLASS $QLPDO
THATDIDNTHAVEANO ARGCONSTRUCTOR)MAGINETHISSCENARIOALLANIMALSHAVEA
NAME4HERESAGET.AME METHODINCLASS!NIMALTHATRETURNSTHEVALUEOFTHE SULYDWH6WULQJQDPH
NAMEINSTANCEVARIABLE4HEINSTANCEVARIABLEISMARKEDPRIVATEBUTTHESUBCLASS
INTHISCASE(IPPO INHERITSTHEGET.AME METHOD3OHERESTHEPROBLEM $QLPDO6WULQJQ
(IPPOHASAGET.AME METHODTHROUGHINHERITANCE BUTDOESNOTHAVETHENAME 6WULQJJHW1DPH
INSTANCEVARIABLE(IPPOHASTODEPENDONTHE!NIMALPARTOFHIMSELFTOKEEPTHE
NAMEINSTANCEVARIABLEANDRETURNITWHENSOMEONECALLSGET.AME ONA(IPPO
OBJECT"UTHOWDOESTHE!NIMALPARTGETTHENAME4HEONLYREFERENCE(IPPO
HASTOTHE!NIMALPARTOFHIMSELFISTHROUGHSUPER SOTHATSTHEPLACEWHERE
(IPPOSENDSTHE(IPPOSNAMEUPTOTHE!NIMALPARTOFHIMSELFSOTHATTHE +LSSR
!NIMALPARTCANSTOREITINTHEPRIVATENAMEINSTANCEVARIABLE
SXEOLFDEVWUDFWFODVV$QLPDO^
+LSSR6WULQJQ
SULYDWH6WULQJQDPH $OODQLPDOVLQFOXGLQJ H
VXEFODVVHVKDYHDQDP >RWKHU+LSSRVSH
FLILFPHWKRGV@
SXEOLF6WULQJJHW1DPH^ $JHWWHU
UHWXUQQDPH +LSSRLQKHUPLWHWV KRGWKDW
`
7KH$QLPDOSDUWRI
SXEOLF$QLPDO6WULQJWKH1DPH^ PHQHHGVWRNQRZP\QDPH
7KHFRQV UXFW
QDPH WKH1DPH WDNHVWKHWQD RUWKDW VR,WDNHDQDPHLQP\RZQ
` LWWKHQDPHLQPHDQGDVVLJQV +LSSRFRQVWUXFWRUWKHQSDVV

YDULDEOH VWDQFH WKHQDPHWRVXSHU
`
SXEOLFFODVV+LSSRH[WHQGV$QLPDO^
DPH
SXEOLF+LSSR6WULQJQDPH^
FWRUWDNHVDQ
VXSHUQDPH +LSSRFRQVWUX
`
LWVHQGVW
` WKH$QLPDOKHFRQDPHXSWKH6WDFNWR
QVWUXFWRU
)LOH(GLW:LQGRZ+HOS+LGH
SXEOLFFODVV0DNH+LSSR^ MDYD0DNH+LSSR
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ 0DNHD+
QDPH´%XILSIS\RSDVVLQJWKH %XII\
+LSSRK QHZ+LSSR³%XII\´
FRQVWUXFW µWRWKH+LSSR
6\VWHPRXWSULQWOQKJHW1DPH +LSSR·VLQKRHUULW7KHQFDOOWKH
` HGJHW1DPH
`
\RXDUHKHUH
FDOOLQJRYHUORDGHGFRQVWUXFWRUV
1V^WSQVOWVMW^MZTWILMLKWV[\Z]K\WZ
NZWUIVW\PMZ
call a
7HATIFYOUHAVEOVERLOADEDCONSTRUCTORSTHATWITH
Use this( ) to
THEEXCEPTIONOFHANDLINGDIFFERENTARGUMENTTYPES
ALLDOTHESAMETHING9OUKNOWTHATYOUDONTWANT
o n s t r u c to r f r om another
c
DUPLICATECODESITTINGINEACHOFTHECONSTRUCTORSPAIN
e r lo a d e d c o n structor in
TOMAINTAINETC SOYOUDLIKETOPUTTHEBULKOFTHE
ov
CONSTRUCTORCODEINCLUDINGTHECALLTOSUPER INONLY
s.
ONEOFTHEOVERLOADEDCONSTRUCTORS9OUWANTWHICHEVER
CONSTRUCTORISlRSTINVOKEDTOCALL4HE2EAL#ONSTRUCTOR
the same clas
is( )
The call to th
ANDLET4HE2EAL#ONSTRUCTORlNISHTHEJOBOF
ly in a
CONSTRUCTION)TSSIMPLEJUSTSAYTHIS /RTHISA3TRING
/RTHISX )NOTHERWORDSJUSTIMAGINETHATTHE
n b e u s e d o n
ca
KEYWORDTHISISAREFERENCETOTHECURRENTOBJECT
t r u ct o r , a n d must be
9OUCANSAYTHIS ONLYWITHINACONSTRUCTORANDITMUST con s
BETHElRSTSTATEMENTINTHECONSTRUCTOR
f ir s t s t a t e m ent in a
"UTTHATSAPROBLEMISNTIT%ARLIERWESAIDTHAT the
SUPER MUSTBETHElRSTSTATEMENTINTHECONSTRUCTOR
constructor.
n have a
7ELLTHATMEANSYOUGETACHOICE
o n s t r u c t o r c a
(YHU\FRQVWUXFWRUFDQKDYHDFDOOWRVXSHU
Ac
RUWKLVEXWQHYHUERWK
t o s u p e r ( ) O R this( ),
call
h!
but never bot
FODVV0LQLH[WHQGV&DU^
&RORUFRORU
7KHQRDUJFRQV WUXFWRU
VXSSOLHVD GH IDXO W &RORUDQG
5HDO
SXEOLF0LQL^
FDOOVWKHRYHUOWRDKHRGQHWKDW
GH
WKLV&RORU5HG
&RQVWUXF WR U
FDOOVVXSHU
`
SXEOLF0LQL&RORUF^
7KLVLV7KH5HDO&RQVWUXFWR
VXSHU³0LQL´
GRHV7KH5HDO:RUNRI UWKDW
FRORU F
PRUHLQLWLDOL]DWLRQ
REMHFWLQFOXGLQJWKHFDOLQ LWLDOL]LQJWKH
OWRVXSHU
`
)LOH(GLW:LQGRZ+HOS'ULYH
SXEOLF0LQLLQWVL]H^ MDYDF0LQLMDYD
WKLV&RORU5HG
VXSHUVL]H :RQ·WZRUN&DQ·WKDYH 0LQLMDYDFDOOWRVXSHUPXVW
VXSHUDQGWKLVLQWK EHILUVWVWDWHPHQWLQFRQVWUXFWRU
FRQVWUXFWRUEHFDXVHWKHV
DPH
` H\ HDFK
` PXVWEHWKHILUVWVWDWHPHQW VXSHU
A
FKDSWHU
FRQVWUXFWRUVDQGJF
6KDUSHQ \RXU SHQFLO

3OMEOFTHECONSTRUCTORSINTHE3ON/F"OOCLASSWILLNOT
COMPILE3EEIFYOUCANRECOGNIZEWHICHCONSTRUCTORSARE
NOTLEGAL-ATCHTHECOMPILERERRORSWITHTHE3ON/F"OO 0DNH LW
CONSTRUCTORSTHATCAUSEDTHEMBYDRAWINGALINEFROMTHE
6WLFN
COMPILERERRORTOTHEhBADvCONSTRUCTOR 2OSESA
REREDV
9OURP IOLETSA
ARENTS REBLUE
COMEF
SXEOLFFODVV%RR^ IRSTWA
4HESU YBEFOR
SXEOLF%RRLQWL^` PERCLAS EYOU
FORMED SPAR TS
OFANO
SXEOLF%RR6WULQJV^` BEFORE B JE C TMUSTB
EXIST* THENE EFULLY
USTLIKE WSUBC
SXEOLF%RR6WULQJVLQWL^` T LASSOB
BEENB H E RESNOW JEC TCA
ORNBEFO AYYOUC N
` REYOUR OULDHA
PARENT VE
S
FODVV6RQ2I%RRH[WHQGV%RR^ )LOH(GLW:LQGRZ+HOS
MDYDF6RQ2I%RRMDYD
SXEOLF6RQ2I%RR^
VXSHU³ERR´ FDQQRWUHVROYHV\PERO
`
V\PEROFRQVWUXFWRU%RR
SXEOLF6RQ2I%RRLQWL^ MDYDODQJ6WULQJMDYDOD
VXSHU³)UHG´ QJ6WULQJ
`
SXEOLF6RQ2I%RR6WULQJV^ )LOH(GLW:LQGRZ+HOS<DGD\DGD\DGD

VXSHU MDYDF6RQ2I%RRMDYD
`
FDQQRWUHVROYHV\PERO
SXEOLF6RQ2I%RRLQWL6WULQJV^
` V\PEROFRQVWUXFWRU%RR

LQWMDYDODQJ6WULQJ
SXEOLF6RQ2I%RR6WULQJD6WULQJE6WULQJF^
VXSHUDE
`
)LOH(GLW:LQGRZ+HOS,P1RW/LVWHQLQJ
SXEOLF6RQ2I%RRLQWLLQWM^
VXSHU³PDQ´M MDYDF6RQ2I%RRMDYD
`
FDQQRWUHVROYHV\PERO
SXEOLF6RQ2I%RRLQWLLQW[LQW\^ V\PEROFRQVWUXFWRU%RR
VXSHUL³VWDU´
`
`

\RXDUHKHUH
REMHFWOLIHVSDQ
6W__MSVW_PW_IVWJRMK\Q[JWZV $ORFDOYDULDEOHOLYHVRQO\
J]\PW_TWVOLWM[IVWJRMK\TQ^M ' ZLWKLQWKHPHWKRGWKDW
!NOBJECTSLIFEDEPENDSENTIRELYONTHELIFEOFREFERENCES GHFODUHGWKHYDULDEOH
REFERRINGTOIT)FTHEREFERENCEISCONSIDEREDhALIVEvTHE SXEOLFYRLGUHDG^
OBJECTISSTILLALIVEONTHE(EAP)FTHEREFERENCEDIES LQWV
ANDWELLLOOKATWHATTHATMEANSINJUSTAMOMENT THE µV¶FDQEHXVHGRQO\
OBJECTWILLDIE ZLWKLQWKLVPHWKRG
:KHQWKLVPHWKRGHQGV
3OIFANOBJECTSLIFEDEPENDSONTHEREFERENCE µV¶GLVDSSHDUVFRPSOHWHO\
VARIABLESLIFEHOWLONGDOESAVARIABLELIVE `
4HATDEPENDSONWHETHERTHEVARIABLEISALOCALVARIABLE 6ARIABLE@SCANBEUSEDONLYWITHINTHE
ORANINSTANCEVARIABLE4HECODEBELOWSHOWSTHELIFEOFA READ METHOD)NOTHERWORDSTHEVARIABLE
LOCALVARIABLE)NTHEEXAMPLETHEVARIABLEISAPRIMITIVE ISINSCOPEONLYWITHINITSOWNMETHOD.O
BUTVARIABLELIFETIMEISTHESAMEWHETHERITSAPRIMITIVE OTHERCODEINTHECLASSORANYOTHERCLASS
ORREFERENCEVARIABLE CANSEE@S
SXEOLFFODVV7HVW/LIH2QH^
SXEOLFYRLGUHDG^ $QLQVWDQFHYDULDEOHOLYHV
LQWV ¶V·LVV DVORQJDVWKHREMHFW
VOHHS PHWKRGFRSHGWRWKHUHD GRHV,IWKHREMHFWLVVWLOO
` DQ\ZKHUH VRLWFDQ·WEH G
HOVH XVHG DOLYHVRDUHLWVLQVWDQFH
SXEOLFYRLGVOHHS^ YDULDEOHV
V

HJDOWR
` SXEOLFFODVV/LIH^
1 R W O LQWVL]H
`
%$' KHUH
XVH¶V· SXEOLFYRLGVHW6L]HLQWV^
VL]H V
EOH6LQFH
µV¶GLVDSSHDUVDWWKH
K H ¶V ·Y DU LD HQGRIWKLVPHWKRG
VHHW UDPH
VOHHSFDQ·WVOHHS·VRZQ6WDFNI RXWLW EXWµVL]H¶FDQEHXVHG
VOHHS LW·VQRWLQ VQ·WNQRZDQ\WKLQJDE
DQ\ZKHUHLQWKHFODVV
`
VOHHSGRH `
UHDG V 6ARIABLE@STHISTIMEAMETHODPARAMETER
ISINSCOPEONLYWITHINTHESET3IZE
METHOD"UTINSTANCEVARIABLESIZEIS
7KHYDULDE SCOPEDTOTHELIFEOFTHEOBJECTASOPPOSED
UHDGPHW OH¶V·LVDOLYHEXWLQ TOTHELIFEOFTHEMETHOD
RQWRSRI KRG:KHQVOHHSF VFRSHRQO\ZLWKLQWK
VWLOOVHH¶V· WKH6WDFNDQGUXQQ RPSOHWHVDQGUHDG H
WKH6WDFN :KHQUHDGFRPSOHLQJDJDLQUHDGFDQ LV
¶V·LVGHDG
3XVKLQJX WHVDQGLVSRSSHGRI
SGLJLWDOG I
DLVLHV
FKDSWHU
FRQVWUXFWRUVDQGJF
7KHGLIIHUHQFHEHWZHHQOLIHDQG
VFRSHIRUORFDOYDULDEOHV
SXEOLFYRLGGR6WXII^
ERROHDQE WUXH
/LIH JR
!LOCALVARIABLEISALIVEASLONGASITS3TACK `
FRAMEISONTHE3TACK)NOTHERWORDS SXEOLFYRLGJRLQW[^
UNTILTHEMETHODCOMPLETES LQW] [
FUD]\
LPDJLQHPRUHFRGHKHUH
6FRSH
`
!LOCALVARIABLEISINSCOPEONLYWITHINTHE
SXEOLFYRLGFUD]\^
METHODINWHICHTHEVARIABLEWASDECLARED
FKDUF µD¶
7HENITSOWNMETHODCALLSANOTHERTHE `
VARIABLEISALIVEBUTNOTINSCOPEUNTILITS
METHODRESUMES9OUCANUSEAVARIABLEONLY
WHENITISINSCOPE
FUD]\ F
JR [ ] JR [ ] JR [ ]
GR6WXII E GR6WXII E GR6WXII E GR6WXII E
GR6WXIIJRHVRQWKH JRSORSVRQWRSRI FUD]\LVSXVKHGRQWR FUD]\FRPSOHWHVDQG

6WDFN9DULDEOH¶E·LV WKH6WDFN¶[·DQG¶]· WKH6WDFNZLWK¶F·QRZ LVSRSSHGRIIWKH6WDFN
DOLYHDQGLQVFRSH DUHDOLYHDQGLQVFRSH DOLYHDQGLQVFRSH7KH VR¶F·LVRXWRIVFRSH
DQG¶E·LVDOLYHEXWQRW RWKHUWKUHHYDULDEOHV DQGGHDG:KHQJR
LQVFRSH DUHDOLYHEXWRXWRI UHVXPHVZKHUHLWOHIW
VFRSH RII¶[·DQG¶]·DUHERWK
DOLYHDQGEDFNLQVFRSH
9DULDEOH¶E·LVVWLOODOLYH
7HILEALOCALVARIABLEISALIVEITSSTATEPERSISTS EXWRXWRIVFRSHXQWLO
!SLONGASMETHODDO3TUFF ISONTHE3TACKFOR JRFRPSOHWHV
EXAMPLETHE@BVARIABLEKEEPSITSVALUE"UTTHE
@BVARIABLECANBEUSEDONLYWHILEDO3TUFF S
3TACKFRAMEISATTHETOP)NOTHERWORDSYOUCAN
USEALOCALVARIABLEONLYWHILETHATLOCALVARIABLES
METHODISACTUALLYRUNNINGASOPPOSEDTO
WAITINGFORHIGHER3TACKFRAMESTOCOMPLETE
\RXDUHKHUH
REMHFWOLIHF\FOH
?PI\IJW]\ZMNMZMVKMÎZQIJTM['
4HERULESARETHESAMEFORPRIMTIVESANDREFERENCES!REFERENCE
VARIABLECANBEUSEDONLYWHENITSINSCOPEWHICHMEANSYOUCANTUSE
ANOBJECTSREMOTECONTROLUNLESSYOUVEGOTAREFERENCEVARIABLETHATS
INSCOPE4HEREALQUESTIONIS
h(OWDOESVARIABLELIFEAFFECTOBJECTLIFEv ,YZMUPN_¿^WTQPSL^YZ

aLW`PYZXPLYTYRYZ
!NOBJECTISALIVEASLONGASTHEREARELIVEREFERENCESTOIT)FAREFERENCE
VARIABLEGOESOUTOFSCOPEBUTISSTILLALIVETHEOBJECTITREFERSTOISSTILL
[ZTY_`YWP^^^ZXPMZOd
ALIVEONTHE(EAP!NDTHENYOUHAVETOASKh7HATHAPPENSWHENTHE SL^L]PQP]PYNP_ZT_
3TACKFRAMEHOLDINGTHEREFERENCEGETSPOPPEDOFFTHE3TACKATTHEEND 4QdZ`NLY¿_RP__ZT_
OFTHEMETHODv
dZ`NLY¿_L^VT__ZOZ
)FTHATWASTHEONLYLIVEREFERENCETOTHEOBJECTTHEOBJECTISNOW LYd_STYRLYOT_¿Û`^_L
ABANDONEDONTHE(EAP4HEREFERENCEVARIABLED ISINTEGRATEDWITH MTRQL_bL^_PZQMT_^
THE3TACKFRAMESOTHEABANDONEDOBJECTISNOWOFlCIALLYTOAST4HE
TRICKISTOKNOWTHEPOINTATWHICHANOBJECTBECOMESELIGIBLEFORGARBAGE -`_TQLYZMUPN_T^
COLLECTION `Y]PLNSLMWP_SP
/NCEANOBJECTISELIGIBLEFORGARBAGECOLLECTION'# YOUDONTHAVE 2L]MLRP.ZWWPN_Z]bTWW
TOWORRYABOUTRECLAIMINGTHEMEMORYTHATOBJECTWASUSING)FYOUR ÈR`]P_SL_Z`_>ZZYP]
PROGRAMGETSLOWONMEMORY'#WILLDESTROYSOMEORALLOFTHEELIGIBLE Z]WL_P]_SL_ZMUPN_¿^
OBJECTSTOKEEPYOUFROMRUNNINGOUTOF2!-9OUCANSTILLRUNOUTOF
MEMORYBUTNOTBEFOREALLELIGIBLEOBJECTSHAVEBEENHAULEDOFFTOTHE
RZTY¿OZbY
DUMP9OURJOBISTOMAKESURETHATYOUABANDONOBJECTSIEMAKE
THEMELIGIBLEFOR'# WHENYOUREDONEWITHTHEMSOTHATTHEGARBAGE
COLLECTORHASSOMETHINGTORECLAIM)FYOUHANGONTOOBJECTS'#CANT
HELPYOUANDYOURUNTHERISKOFYOURPROGRAMDYINGAPAINFUL
OUT OF MEMORYDEATH
7KUHHZD\VWRJHWULGRIDQREMHFW·VUHIHUHQFH
$QREMHFWEHFRPHV
HOLJLEOHIRU*&ZKHQ 7KHUHIHUHQFHJRHVRXWRIVFRSHSHUPDQHQWO\
·GLHVDW
LWVODVWOLYHUHIHUHQFH YRLGJR^ UHIHUHQFH¶W]KRG
GLVDSSHDUV
/LIH] QHZ/LIH
` HQGRIPH
HG
WLVDEDQGR·QWR
7KHUHIHUHQFHLVDVVLJQHGDQRWKHUREMHFW
LU VW R E MH F
/LIH] QHZ/LIH WKHI ¶UHSURJUDPPHG
] QHZ/LIH ZKHQ]LV FW
DQHZREMH
7KHUHIHUHQFHLVH[SOLFLWO\VHWWRQXOO GRQHG
KH I LU VW R E MHFWLVDEDQHG·
/LIH] QHZ/LIH W HSURJUDPP
] QXOO ZKHQ]LV¶G
FKDSWHU
FRQVWUXFWRUVDQGJF
2EMHFWNLOOHU
5HIHUHQFHJRHV
RXWRIVFRSH
SHUPDQHQWO\
SXEOLFFODVV6WDFN5HI^
SXEOLFYRLGIRRI^ ,GRQ·WOLNHZKHUH
EDUI WKLVLVKHDGHG
`

SXEOLFYRLGEDUI^
'XFNG QHZ'XFN
`
`
IRRILVSXVKHGRQWRWKH
6WDFNQRYDULDEOHVDUH IRRI
GHFODUHG
WKH
Q H Z ' X FNJRHVRQ UI
7KH VED
+HDS DVORQJD
+HDSDQG WKH¶G·UHIHUHQFH

EDUILVSXVKHGRQWRWKH LVUXQQLQJ LQVFRSHVRWKH
D Q G
\ LVDOLYH QVLGHUHGDOLYH
6WDFNZKHUHLWGHFODUHV
EDUI 'X
'XFNLV F R
W
DUHIHUHQFHYDULDEOHDQG FNREMHF
FUHDWHVDQHZREMHFWDV
VLJQHGWRWKDWUHIHUHQFH IRRI
7KHREMHFWLVFUHDWHGRQ
WKH+HDSDQGWKHUHIHU
HQFHLVDOLYHDQGLQVFRSH
8KRK7KH¶G·YDULDEOH
+HDS ZHQWDZD\ZKHQWKHEDUI
6WDFNIUDPHZDVEORZQ
EDUIFRPSOHWHVDQGSRSV \
RIIWKHVWDFNVRWKH'XFN
RIIWKH6WDFN,WVIUDPH
'X LVDEDQGRQHG*DUEDJH
W
GLVLQWHJUDWHVVR¶G·LVQRZ FNREMHF
GHDGDQGJRQH([HFXWLRQ
UHWXUQVWRIRRIEXWIRRI
IRRI FROOHFWRUEDLW
FDQ·WXVH¶G·
\RXDUHKHUH
REMHFWOLIHF\FOH
2EMHFWNLOOHU
$VVLJQWKHUHIHUHQFH
WRDQRWKHUREMHFW
SXEOLFFODVV5H5HI^ 'XGHDOO\RX
KDGWRGRZDVUHVHW
'XFNG QHZ'XFN WKHUHIHUHQFH*XHVV
SXEOLFYRLGJR^ WKH\GLGQ·WKDYHPHPRU\
G QHZ'XFN PDQDJHPHQWEDFNWKHQ
`
Licensed by
`
'X
W
FNREMHF
5H
\
5 HI
REMH
FW
Eduard Simons +HDS
104038
HQFHG
7KHQHZ'XFNJRHVRQWKH+HDSUHIHU OHWKH
E\¶G·6LQFH¶G·LVDQLQVWDQFHYDULDE MHFW
'XFNZLOOOLYHDVORQJDVWKH5H5HIRE
WKDWLQVWDQWLDWHGLWLVDOLYH8QOHVV
DOOVWKH
:KHQVRPHRQHFKLV'XFNLV
JRPHWKRGWRQO\UHIHUHQFH
DEDQGRQHG+LV JUDPPHGIRUD
KDVEHHQUHSUR N
'X
GLIIHUHQW'XF
W
FNREMHF
\
5H
5 HI FW +HDS
REMH 'X
W
FNREMHF
LQJWKH
¶G·LVDVVLJQHGDQHZ'XFNREMHFWOHDYG7KDW
RULJLQDOILUVW'XFNREMHFWDEDQG RQH
ILUVW'XFNLVQRZDVJRRGDVGHDG
FKDSWHU
FRQVWUXFWRUVDQGJF
2EMHFWNLOOHU
([SOLFLWO\VHWWKH
UHIHUHQFHWRQXOO

SXEOLFFODVV5H5HI^
'X
W
'XFNG QHZ'XFN FNREMHF
SXEOLFYRLGJR^
\
G QXOO 5H
5 HI FW +HDS
` REMH
`
HQFHG
7KHQHZ'XFNJRHVRQWKH+HDSUHIHU
OHWKH
7KHPHDQLQJRIQXOO E\¶G·6LQFH¶G·LVDQLQVWDQFHYDULDE
5H 5HI RE MHFW
'XFNZLOOOLYHDVORQJDVWKH
7HENYOUSETAREFERENCETOQXOOYOURE
WKDWLQVWDQWLDWHGLWLVDOLYH8Q OHVV
DEPROGRAMMINGTHEREMOTECONTROL
)NOTHERWORDSYOUVEGOTAREMOTE
CONTROLBUTNO46ATTHEOTHEREND!NULL
EDQGRQHG
REFERENCEHASBITSREPRESENTING@NULLWE
DONTKNOWORCAREWHATTHOSEBITSAREAS 7KLV'XFNLVD FHKDVEHHQ
HQ
LONGASTHE*6-KNOWS +LVRQO\UHIHU
VHWWRQXOO
)FYOUHAVEANUNPROGRAMMEDREMOTE
CONTROLINTHEREALWORLDTHEBUTTONSDONT
'X
W
DOANYTHINGWHENYOUPRESSTHEM"UT FNREMHF
IN*AVAYOUCANTPRESSTHEBUTTONSIE
USETHEDOTOPERATOR ONANULLREFERENCE
\
BECAUSETHE*6-KNOWSTHISISARUNTIME 5H
5 HI FW +HDS
ISSUENOTACOMPILERERROR THATYOURE REMH
EXPECTINGABARKBUTTHERESNO$OGTHERE JDUHPRWH
TODOIT ¶G·LVVHWWRQXOOZKLFKLVMXVWOLNHKDYLQ J<RX·UHQRW
WKLQ
FRQWUROWKDWLVQ·WSURJUDPPHGWRDQ\
DWR UR Q¶G·XQWLOLW·V
)FYOUUSETHEDOTOPERATORON HYHQDOORZHGWRXVHWKHGRWRSHU
ANULLREFERENCEYOULLGETA UHSURJUDPPHGDVVLJQHGDQREMHFW
.ULL0OINTER%XCEPTIONATRUNTIME9OULL
LEARNALLABOUT%XCEPTIONSINTHE2ISKY
"EHAVIORCHAPTER
\RXDUHKHUH
REMHFWOLIHF\FOH
<WVQOP\¼[<ITS")VQV[\IVKMÎZQIJTMIVL
ITWKITÎZQIJTMLQ[K][[TQNMIVLLMI\P
_Q\PZMUIZSIJTMKQ^QTQ\a
1V[\IVKM>IZQIJTM 4WKIT>IZQIJTM
)DLIKETOGOlRSTBECAUSE)TENDTOBEMORE
IMPORTANTTOAPROGRAMTHANALOCALVARIABLE
)MTHERETOSUPPORTANOBJECTUSUALLY
THROUGHOUTTHEOBJECTSENTIRELIFE!FTERALL
WHATSANOBJECTWITHOUTSTATE!NDWHATIS )APPRECIATEYOURPOINTOFVIEWAND)CERTAINLY
STATE6ALUESKEPTININSTANCEVARIABLES APPRECIATETHEVALUEOFOBJECTSTATEANDALL
BUT)DONTWANTFOLKSTOBEMISLED,OCAL
VARIABLESAREREALLYIMPORTANT4OUSEYOUR
PHRASEh!FTERALLWHATSANOBJECTWITHOUT
BEHAVIORv!NDWHATISBEHAVIOR!LGORITHMS
INMETHODS!NDYOUCANBETYOURBITSTHERELL
BESOMELOCALVARIABLESINTHERETOMAKETHOSE
.ODONTGETMEWRONG)DOUNDERSTANDYOUR ALGORITHMSWORK
ROLEINAMETHODITSJUSTTHATYOURLIFEISSO
SHORT3OTEMPORARY4HATSWHYTHEYCALLYOU
GUYShTEMPORARYVARIABLESv 7ITHINTHELOCAL VARIABLECOMMUNITYTHE
PHRASEhTEMPORARYVARIABLEvISCONSIDERED
DEROGATORY7EPREFERhLOCALvhSTACKvhAUTO
-YAPOLOGIES)UNDERSTANDCOMPLETELY MATICvORv3COPE CHALLENGEDv
!NYWAYITSTRUETHATWEDONTHAVEALONG
LIFEANDITSNOTAPARTICULARLYGOODLIFEEITHER
&IRSTWERESHOVEDINTOA3TACKFRAMEWITH
ALLTHEOTHERLOCALVARIABLES!NDTHENIFTHE
METHODWEREPARTOFCALLSANOTHERMETHOD
ANOTHERFRAMEISPUSHEDONTOPOFUS!NDIF
THATMETHODCALLSANOTHERMETHODANDSOON
3OMETIMESWEHAVETOWAITFOREVERFORALLTHE
OTHERMETHODSONTOPOFTHE3TACKTOCOM
)NEVERREALLYTHOUGHTABOUTITLIKETHAT7HAT PLETESOTHATOURMETHODCANRUNAGAIN
AREYOUDOINGWHILETHEOTHERMETHODSARE
RUNNINGANDYOUREWAITINGFORYOURFRAMETO
.OTHING.OTHINGATALL)TSLIKEBEINGIN
BETHETOPOFTHE3TACKAGAIN
STASISTHATTHINGTHEYDOTOPEOPLEINSCIENCE
lCTIONMOVIESWHENTHEYHAVETOTRAVELLONG
DISTANCES3USPENDEDANIMATIONREALLY7E
JUSTSITTHEREONHOLD!SLONGASOURFRAMEIS
STILLTHEREWERESAFEANDTHEVALUEWEHOLD
ISSECUREBUTITSAMIXEDBLESSINGWHENOUR
FKDSWHU
FRQVWUXFWRUVDQGJF
1V[\IVKM>IZQIJTM 4WKIT>IZQIJTM
FRAMEGETSTORUNAGAIN/NTHEONEHANDWE
GETTOBEACTIVEAGAIN/NTHEOTHERHANDTHE
CLOCKSTARTSTICKINGAGAINONOURSHORTLIVES
4HEMORETIMEOURMETHODSPENDSRUNNING
THECLOSERWEGETTOTHEENDOFTHEMETHOD
7ESAWANEDUCATIONALVIDEOABOUTITONCE 7EALLKNOWWHATHAPPENSTHEN
,OOKSLIKEAPRETTYBRUTALENDING)MEAN
WHENTHATMETHODHITSITSENDINGCURLYBRACE
THEFRAMEISLITERALLYBLOWNOFFTHE3TACK.OW 4ELLMEABOUTIT)NCOMPUTERSCIENCETHEYUSE
THATSGOTTAHURT THETERMPOPPEDASINhTHEFRAMEWASPOPPED
OFFTHE3TACKv4HATMAKESITSOUNDFUNOR
MAYBELIKEANEXTREMESPORT"UTWELLYOU
SAWTHEFOOTAGE3OWHYDONTWETALKABOUT
YOU)KNOWWHATMYLITTLE3TACKFRAMELOOKS
LIKEBUTWHEREDOYOULIVE
)LIVEONTHE(EAPWITHTHEOBJECTS7ELLNOT
WITHTHEOBJECTSACTUALLYINANOBJECT4HE
OBJECTWHOSESTATE)STORE)HAVETOADMITLIFE
CANBEPRETTYLUXURIOUSONTHE(EAP!LOTOF
USFEELGUILTYESPECIALLYAROUNDTHEHOLIDAYS "UTYOUDONTALWAYSLIVEASLONGASTHEOBJECT
WHODECLAREDYOURIGHT3AYTHERESA$OG
OBJECTWITHA#OLLARINSTANCEVARIABLE)MAGINE
YOUREANINSTANCEVARIABLEOFTHE#OLLAROBJECT
MAYBEAREFERENCETOA"UCKLEORSOMETHING
SITTINGTHEREALLHAPPYINSIDETHE#OLLAROBJECT
WHOSALLHAPPYINSIDETHE$OGOBJECT"UT
WHATHAPPENSIFTHE$OGWANTSANEW#OLLAR
ORNULLSOUTITS#OLLARINSTANCEVARIABLE4HAT
MAKESTHE#OLLAROBJECTELIGIBLEFOR'#3O
IFYOUREANINSTANCEVARIABLEINSIDETHE#OLLAR
/+HYPOTHETICALLYYESIF)MANINSTANCE ANDTHEWHOLE#OLLARISABANDONEDWHAT
VARIABLEOFTHE#OLLARANDTHE#OLLARGETS HAPPENSTOYOU
'#DTHENTHE#OLLARSINSTANCEVARIABLES
WOULDINDEEDBETOSSEDOUTLIKESOMANYPIZZA
BOXES"UT)WASTOLDTHATTHISALMOSTNEVER
HAPPENS
!NDYOUBELIEVEDIT4HATSWHATTHEYSAYTO
KEEPUSMOTIVATEDANDPRODUCTIVE"UTARENT
YOUFORGETTINGSOMETHINGELSE7HATIFYOURE
ANINSTANCEVARIABLEINSIDEANOBJECTANDTHAT
OBJECTISREFERENCEDONLYBYALOCALVARIABLE)F
)MTHEONLYREFERENCETOTHEOBJECTYOUREIN
WHEN)GOYOURECOMINGWITHME,IKEITOR
NOTOURFATESMAYBECONNECTED3O)SAYWE
FORGETABOUTALLTHISANDGOGETDRUNKWHILE
4HEYLETUSDRINK WESTILLCAN#ARPE2!-ANDALLTHAT
\RXDUHKHUH
H[HUFLVH%HWKH*DUEDJH&ROOHFWRU
"%THE'ARBAGE#OLLECTOR
1dQÔU_Q :KLFKRIWKHOLQHVRIFRGHRQWKHULJKWLIDGGHG
WRWKHFODVVRQWKHOHIWDWSRLQW$ZRXOGFDXVH
H[DFWO\RQHDGGLWLRQDOREMHFWWREHHOLJLEOHIRUWKH
*DUEDJH&ROOHFWRU"$VVXPHWKDWSRLQW$FDOO
PRUHPHWKRGVZLOOH[HFXWHIRUDORQJWLPHJLYLQJWKH
*DUEDJH&ROOHFWRUWLPHWRGRLWVVWXII
SXEOLFFODVV*&^
SXEOLFVWDWLF*&GR6WXII^
*&QHZ*& QHZ*& FRS\*& QXOO
GR6WXIIQHZ*&
UHWXUQQHZ*& JF QXOO
`
QHZ*& JF
*&JF JF QXOO
*&JF QHZ*&
*&JF QHZ*& QHZ*& QXOO
*&JF JF
JF GR6WXII JF QXOO
)
JF JF
FDOOPRUHPHWKRGV
` JF JF
SXEOLFVWDWLFYRLGGR6WXII*&FRS\*&^ JF QXOO

*&ORFDO*&)LOH(GLW:LQGRZ+HOS6OHHS
FRS\*&
`
`
FKDSWHU
FRQVWUXFWRUVDQGJF
)NTHISCODEEXAMPLESEVERALNEWOBJECTSARECREATED
1dQÔU_Q 3RSXODU 9OURCHALLENGEISTOFINDTHEOBJECTTHATIS@MOSTPOPULAR

IETHEONETHATHASTHEMOSTREFERENCEVARIABLESREFERRING
TOIT4HENLISTHOWMANYTOTALREFERENCESTHEREAREFOR
FODVV%HHV^
2EMHFWV THATOBJECTANDWHATTHEYARE7ELLSTARTBYPOINTINGOUT
ONEOFTHENEWOBJECTSANDITSREFERENCEVARIABLE
'OOD,UCK
+RQH\>@EHH+$
`
FODVV5DFFRRQ^
.LWN
+RQH\UK
`
FODVV.LW^
+RQH\NK
`
FODVV%HDU^
+RQH\KXQQ\
`
SXEOLFFODVV+RQH\^
+RQH\KRQH\3RW QHZ+RQH\
+RQH\>@KD ^KRQH\3RWKRQH\3RWKRQH\3RWKRQH\3RW`
%HHVE QHZ%HHV
EEHH+$ KD
%HDU>@ED QHZ%HDU>@
IRULQW[ [[^
ED>[@ QHZ%HDU
ED>[@KXQQ\ KRQH\3RW
`
.LWN QHZ.LW
+HUH·VDQHZ
NNK KRQH\3RW
5DFFRRQREMHFW
5DFFRRQU QHZ5DFFRRQ
+HUH·VLWVUHIHUHQFH
UUK KRQH\3RW YDULDEOH¶U·
UN N
N QXOO
`HQGRIPDLQ
`
\RXDUHKHUH
SX]]OH)LYH0LQXWH0\VWHU\
´:H·YHUXQWKHVLPXODWLRQIRXUWLPHVDQGWKHPDLQPRGXOH·VWHPSHUDWXUHFRQVLVWHQWO\
GULIWVRXWRIQRPLQDOWRZDUGVFROGµ6DUDKVDLGH[DVSHUDWHG´:HLQVWDOOHGWKHQHZWHPSERWVODVW
ZHHN7KHUHDGLQJVRQWKHUDGLDWRUERWVGHVLJQHGWRFRROWKHOLYLQJTXDUWHUVVHHPWREHZLWKLQ
VSHFVRZH·YHIRFXVHGRXUDQDO\VLVRQWKHKHDWUHWHQWLRQERWVWKHERWVWKDWKHOSWRZDUPWKHTXDU
WHUVµ7RPVLJKHGDWÀUVWLWKDGVHHPHGWKDWQDQRWHFKQRORJ\ZDVJRLQJWRUHDOO\SXWWKHPDKHDG
RIVFKHGXOH1RZZLWKRQO\ÀYHZHHNVOHIWXQWLOODXQFKVRPHRIWKHRUELWHU·VNH\OLIHVXSSRUW
V\VWHPVZHUHVWLOOQRWSDVVLQJWKHVLPXODWLRQJDXQWOHW
)LYH0LQXWH ´:KDWUDWLRVDUH\RXVLPXODWLQJ"µ7RPDVNHG
0\VWHU\ ´:HOOLI,VHHZKHUH\RX·UHJRLQJZHDOUHDG\WKRXJKWRIWKDWµ6DUDKUHSOLHG´0LV
VLRQFRQWUROZLOOQRWVLJQRIIRQFULWLFDOV\VWHPVLIZHUXQWKHPRXWRIVSHF:HDUH
UHTXLUHGWRUXQWKHYUDGLDWRUERW·V6LP8QLWVLQDUDWLRZLWKWKHYUDGLDWRU·V
6LP8QLWVµ6DUDKFRQWLQXHG´2YHUDOOWKHUDWLRRIUHWHQWLRQERWVWRUDGLDWRUERWVLV
VXSSRVHGWRUXQµ
´+RZ·VSRZHUFRQVXPSWLRQ6DUDK"µ7RPDVNHG6DUDKSDXVHG´:HOOWKDW·V
DQRWKHUWKLQJSRZHUFRQVXPSWLRQLVUXQQLQJKLJKHUWKDQDQWLFLSDWHG:H·YHJRWDWHDP
WUDFNLQJWKDWGRZQWRREXWEHFDXVHWKHQDQRVDUHZLUHOHVVLW·VEHHQKDUGWRLVRODWHWKHSRZHU
FRQVXPSWLRQRIWKHUDGLDWRUVIURPWKHUHWHQWLRQERWVµ´2YHUDOOSRZHUFRQVXPSWLRQUDWLRVµ6DUDK
FRQWLQXHG´DUHGHVLJQHGWRUXQZLWKWKHUDGLDWRUVSXOOLQJPRUHSRZHUIURPWKHZLUHOHVVJULGµ
´2.6DUDKµ7RPVDLG´/HW·VWDNHDORRNDWVRPHRIWKHVLPXODWLRQLQLWLDWLRQFRGH
:H·YHJRWWRÀQGWKLVSUREOHPDQGÀQGLWTXLFNµ
LPSRUWMDYDXWLO
FODVV95DGLDWRU^
95DGLDWRU$UUD\/LVWOLVW^
IRULQW[ [[^
OLVWDGGQHZ6LP8QLW´95DGLDWRUµ
`
`
`
FODVV95DGLDWRUH[WHQGV95DGLDWRU^
95DGLDWRU$UUD\/LVWOJOLVW^
VXSHUOJOLVW
IRULQWJ JJ^
OJOLVWDGGQHZ6LP8QLW´95DGLDWRUµ
`
`
`
FODVV5HWHQWLRQ%RW^
5HWHQWLRQ%RW$UUD\/LVWUOLVW^
UOLVWDGGQHZ6LP8QLW´5HWHQWLRQµ
`
`
FKDSWHU
FRQVWUXFWRUVDQGJF
SXEOLFFODVV7HVW/LIH6XSSRUW6LP^
)LYH0LQXWH SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^
$UUD\/LVWD/LVW QHZ$UUD\/LVW
0\VWHU\ 95DGLDWRUY QHZ95DGLDWRUD/LVW
95DGLDWRUY QHZ95DGLDWRUD/LVW
FRQWLQXHG IRULQW] ]]^
5HWHQWLRQ%RWUHW QHZ5HWHQWLRQ%RWD/LVW
`
`
`
FODVV6LP8QLW^
6WULQJERW7\SH
6LP8QLW6WULQJW\SH^
ERW7\SH W\SH
`
LQWSRZHU8VH^
LI´5HWHQWLRQµHTXDOVERW7\SH^
UHWXUQ
`HOVH^
UHWXUQ
`
`
`
7RPJDYHWKHFRGHDTXLFNORRNDQGDVPDOOVPLOHFUHHSHGDFURVVKLVOLSV,WKLQN,·YH
IRXQGWKHSUREOHP6DUDKDQG,EHW,NQRZE\ZKDWSHUFHQWDJH\RXUSRZHUXVDJHUHDGLQJVDUHRII
WRR
:KDWGLG7RPVXVSHFW"+RZFRXOGKHJXHVVWKHSRZHUUHDGLQJVHUURUVDQGZKDWIHZ
OLQHVRIFRGHFRXOG\RXDGGWRKHOSGHEXJWKLVSURJUDP"
\RXDUHKHUH
REMHFWOLIHF\FOH
FRS\*& QXOO 1RWKLVOLQHDWWHPSWVWRDFFHVVDYDULDEOH

WKDWLVRXWRIVFRSH
%XERCISE3OLUTIONS JF QXOO 2.JFZDVWKHRQO\UHIHUHQFHYDULDEOH
UHIHUULQJWRWKDWREMHFW
QHZ*& JF 1RDQRWKHURXWRIVFRSHYDULDEOH
JF QXOO 2.JFKDGWKHRQO\UHIHUHQFHEHFDXVH

'# QHZ*&LVRXWRIVFRSH
QHZ*& QXOO 1RQHZ*&LVRXWRIVFRSH
JF QXOO 1RJFLVVWLOOUHIHUULQJWRWKDWREMHFW
JF JF 1RJFLVVWLOOUHIHUULQJWRWKDWREMHFW
JF JF 2.5HDVVLJQLQJWKHRQO\UHIHUHQFHWR

WKDWREMHFW
JF QXOO 1RJFLVVWLOOUHIHUULQJWRWKDWREMHFW
)TPROBABLYWASNTTOOHARDTOlGUREOUTTHATTHE(ONEYOBJECTlRSTREFERREDTOBYTHEHONEY0OTVARIABLEISBY
3RSXODU FARTHEMOST@POPULAROBJECTINTHISCLASS"UTMAYBEITWASALITTLETRICKIERTOSEETHATALLOFTHEVARIABLESTHAT
POINTFROMTHECODETOTHE(ONEYOBJECTREFERTOTHESAMEOBJECT4HEREAREATOTALOFACTIVEREFERENCESTO
2EMHFWV THISOBJECTRIGHTBEFORETHEMAIN METHODCOMPLETES4HEKKHVARIABLEISVALIDFORAWHILEBUTKGETSNULLED
ATTHEEND3INCERKSTILLREFERSTOTHE+ITOBJECTRKKHALTHOUGHNEVEREXPLICITYDECLARED REFERSTOTHEOBJECT
SXEOLFFODVV+RQH\^
+RQH\KRQH\3RW QHZ+RQH\
+RQH\>@KD ^KRQH\3RWKRQH\3RW
KRQH\3RWKRQH\3RW`
%HHVE QHZ%HHV
EEHH+$ KD
%HDU>@ED QHZ%HDU>@
IRULQW[ [[^
+RQH\
ED>[@ QHZ%HDU
2EMHFW ED>[@KXQQ\ KRQH\3RW
`
HQGVXSQXOO
.LWN QHZ.LW
NNK KRQH\3RW
5DFFRRQU QHZ5DFFRRQ
UUK KRQH\3RW
UN N
N QXOO
`HQGRIPDLQ
`
FKDSWHU
FRQVWUXFWRUVDQGJF
)LYH0LQXWH0\VWHU\6ROXWLRQ
7RPQRWLFHGWKDWWKHFRQVWUXFWRUIRUWKH95DGLDWRUFODVVWRRNDQ
$UUD\/LVW7KDWPHDQWWKDWHYHU\WLPHWKH95DGLDWRUFRQVWUXFWRUZDVFDOOHG
LWSDVVHGDQ$UUD\/LVWLQLWVVXSHUFDOOWRWKH95DGLDWRUFRQVWUXFWRU7KDW
PHDQWWKDWDQH[WUDÀYH95DGLDWRU6LP8QLWVZHUHFUHDWHG,I7RPZDVULJKW
WRWDOSRZHUXVHZRXOGKDYHEHHQQRWWKHWKDW6DUDK·VH[SHFWHGUDWLRV
SUHGLFWHG
6LQFHDOOWKH%RWFODVVHVFUHDWH6LP8QLWVZULWLQJDFRQVWUXFWRUIRU
WKH6LP8QLWFODVVWKDWSULQWHGRXWDOLQHHYHU\WLPHD6LP8QLWZDVFUHDWHG
ZRXOGKDYHTXLFNO\KLJKOLJKWHGWKHSUREOHP
\RXDUHKHUH
Licensed by
Eduard Simons
104038
QXPEHUVDQGVWDWLFV
1XPEHUV0DWWHU
'RWKH0DWK"UTTHERESMORETOWORKINGWITHNUMBERSTHANJUSTDOINGPRIMITIVE
ARITHMETIC9OUMIGHTWANTTOGETTHEABSOLUTEVALUEOFANUMBERORROUNDANUMBERORFIND
THELARGEROFTWONUMBERS9OUMIGHTWANTYOURNUMBERSTOPRINTWITHEXACTLYTWODECIMAL
PLACESORYOUMIGHTWANTTOPUTCOMMASINTOYOURLARGENUMBERSTOMAKETHEMEASIERTOREAD
!NDWHATABOUTWORKINGWITHDATES9OUMIGHTWANTTOPRINTDATESINAVARIETYOFWAYSOREVEN
MANIPULATEDATESTOSAYTHINGSLIKEhADDTHREEWEEKSTOTODAYSDATEv!NDWHATABOUTPARSING
A3TRINGINTOANUMBER/RTURNINGANUMBERINTOA3TRING9OUREINLUCK4HE*AVA!0)ISFULLOF
HANDYNUMBER TWEAKINGMETHODSREADYANDEASYTOUSE"UTMOSTOFTHEMARESTATICSOWELL
STARTBYLEARNINGWHATITMEANSFORAVARIABLEORMETHODTOBESTATICINCLUDINGCONSTANTSIN
*AVASTATICFINALVARIABLES
WKLVLVDQHZFKDSWHU
0DWKPHWKRGV
5)<0UM\PWL["I[KTW[MI[aW]¼TT
M^MZOM\\WIOTWJITUM\PWL
%XCEPTTHERESNOGLOBALANYTHINGIN*AVA"UTTHINKABOUT
THISWHATIFYOUHAVEAMETHODWHOSEBEHAVIORDOESNT
DEPENDONANINSTANCEVARIABLEVALUE4AKETHEROUND
METHODINTHE-ATHCLASSFOREXAMPLE)TDOESTHESAME
THINGEVERYTIMEROUNDSAmOATINGPOINTNUMBERTHE 0HWKRGVLQWKH0DWKFODVV
ARGUMENTTOTHEMETHOD TOTHENEARESTINTEGER%VERY GRQ·WXVHDQ\LQVWDQFH
TIME)FYOUHADINSTANCESOFCLASS-ATHANDRAN
THEROUND METHODYOUDGETANINTEGERVALUEOF YDULDEOHYDOXHV$QGEHFDXVH
%VERYTIME)NOTHERWORDSTHEMETHODACTSONTHE
ARGUMENTBUTISNEVERAFFECTEDBYANINSTANCEVARIABLE
WKHPHWKRGVDUH¶VWDWLF·
STATE4HEONLYVALUETHATCHANGESTHEWAYTHEROUND \RXGRQ·WQHHGWRKDYHDQ
METHODRUNSISTHEARGUMENTPASSEDTOTHEMETHOD
LQVWDQFHRI0DWK$OO\RX
$OESNTITSEEMLIKEAWASTEOFPERFECTLYGOODHEAPSPACE
TOMAKEANINSTANCEOFCLASS-ATHSIMPLYTORUNTHE QHHGLVWKH0DWKFODVV
ROUND METHOD!NDWHATABOUTOTHER-ATHMETHODS
LIKEMIN WHICHTAKESTWONUMERICALPRIMITIVESAND
RETURNSTHESMALLEROFTHETWO/RMAX /RABS WHICH LQW[ 0DWKURXQG
RETURNSTHEABSOLUTEVALUEOFANUMBER LQW\ 0DWKPLQ
LQW] 0DWKDEV
4HESEMETHODSNEVERUSEINSTANCEVARIABLEVALUES)NFACTTHE
-ATHCLASSDOESNTHAVEANYINSTANCEVARIABLES3OTHERES
NOTHINGTOBEGAINEDBYMAKINGANINSTANCEOFCLASS
-ATH3OGUESSWHAT9OUDONTHAVETO!SAMATTEROF 7KHVHPHWKRGVQHYHUX
FACTYOUCANT LQVWDQFHYDULDEOHVVRWVH
EHKDYLRUGRHVQ·WQHHG KHLU
NQRZDERXWDVSHF WR
LILFREMHFW
,I\RXWU\WRPDNHDQLQVWDQFHRI
FODVV0DWK
0DWKPDWK2EMHFW QHZ0DWK
<RX·OOJHWWKLVHUURU
)LOH(GLW:LQGRZ+HOS,ZDV7ROG7KHUH:RXOG%H1R0DWK
MDYDF7HVW0DWK
7HVW0DWKMDYD0DWKKDVSULYDWH 7KLVHUURUVKRZVWKDW
DFFHVVLQMDYDODQJ0DWK FRQVWUXFWRULV HG WKH0DWK
PHDQV\RXFDQ1PD(9UN(5SULYDWH7KDW
0DWKPDWK2EMHFW QHZ0DWK
0DWKFODVVWRPDNHD VD\¶QHZ·RQWKH
A QHZ0DWKREMHFW
HUURU
FKDSWHU
QXPEHUVDQGVWDWLFV
<PMLQNNMZMVKMJM\ _MMVZMO]TIZ
VWV[\I\QKIVL[\I\QKUM\PWL[
*AVAISOBJECT ORIENTEDBUTONCEINAWHILEYOUHAVEASPECIALCASE
TYPICALLYAUTILITYMETHODLIKETHE-ATHMETHODS WHERETHEREIS
NONEEDTOHAVEANINSTANCEOFTHECLASS4HEKEYWORDVWDWLFLETS
AMETHODRUNWITHOUTANYINSTANCEOFTHECLASS!STATICMETHODMEANS
hBEHAVIORNOTDEPENDENTONANINSTANCEVARIABLESONOINSTANCEOBJECT
ISREQUIRED*USTTHECLASSv
UHJXODUQRQVWDWLFPHWKRG VWDWLFPHWKRG
SXEOLFFODVV6RQJ^ DOXHDIIHFWV
FHYDULDEOHWYKH
,Q VW DQ SOD\
WKHEHKDYLRURI
6WULQJWLWOH
PHWKRG
SXEOLF6RQJ6WULQJW^
SXEOLFVWDWLFLQWPLQLQWDLQWE^
WLWOH W
UHWXUQVWKHOHVVHURIDDQGE
`
`
SXEOLFYRLGSOD\^
6RXQG3OD\HUSOD\HU QHZ6RXQG3OD\HU
0DWK
EOHV
1RLQVWDQFHYDUHKLDDYLRU
SOD\HUSOD\6RXQGWLWOH
PLQ
OH· 7KHPHWKRGE ZLWK
XHRIWKH¶WJLWWKDW
`
PD[
F XU UH QW Y DO
7KH
LQVWDQFHYDU\R LDEOHLVWKHVRQ DEV
GRHVQ·WFKDQJH HVWDWH
FDOOSOD\ LQVWDQFHYDULDEO
6RQJ
WLWOH SOD\VZKHQ X 0\:D\
6H[3LVWROV
MHFW
SOD\
3ROLWLN
RE
&ROGSOD\ 6RQJ
MHFW
0DWKPLQ
LQ V W D QFHV 6RQJ
RE
WZR VV6RQJ HUDWKHU
8VHWKH&ODVVQDP DULDEOH
RIFOD WKDQDUHIHUHQFH
Y
k+
k* QDPH
6RQJ
6RQJ
VSOD\
VSOD\ 122%-(
&DOOLQ &76
J
UHIHU SOD\R $EVROXWHO\

´3ROLW HQFHZLOO QWKLV &DOOLQJSOD\RQWKLV DQ\ZKHUHLQ 122%-(&76
LNµW F WKLVSLFWX
RSOD DXVH UHIHUHQFHZLOOFDXVH UH
\ ´0\:D\µWRSOD\
\RXDUHKHUH
VWDWLFPHWKRGV
&DOODVWDWLFPHWKRGXVLQJD
FODVVQDPH
0DWK 0DWKPLQ
PLQ
PD[
DEV

&DOODQRQVWDWLFPHWKRGXVLQJD
UHIHUHQFHYDULDEOHQDPH
6RQJW QHZ6RQJ
WSOD\
l*
?PI\Q\UMIV[\WPI^MI
KTI[[_Q\P[\I\QKUM\PWL[
/FTENALTHOUGHNOTALWAYS ACLASSWITHSTATIC 4HISDOESNOTMEANTHATACLASSWITHONEORMORE
METHODSISNOTMEANTTOBEINSTANTIATED)N#HAPTER STATICMETHODSSHOULDNEVERBEINSTANTIATED)NFACT
WETALKEDABOUTABSTRACTCLASSESANDHOWMARKING EVERYCLASSYOUPUTAMAIN METHODINISACLASSWITH
ACLASSWITHTHEDEVWUDFWMODIlERMAKESIT ASTATICMETHODINIT
IMPOSSIBLEFORANYONETOSAY@NEWONTHATCLASSTYPE 4YPICALLYYOUMAKEAMAIN METHODSOTHATYOU
)NOTHERWORDSITSIMPOSSIBLETOINSTANTIATEANABSTRACT CANLAUNCHORTESTANOTHERCLASSNEARLYALWAYSBY
CLASS INSTANTIATINGACLASSINMAINANDTHENINVOKINGA
"UTYOUCANRESTRICTOTHERCODEFROMINSTANTIATING METHODONTHATNEWINSTANCE
ANON ABSTRACTCLASSBYMARKINGTHECONSTRUCTOR 3OYOUREFREETOCOMBINESTATICANDNON STATIC
SULYDWH2EMEMBERAMETHODMARKEDPRIVATEMEANS METHODSINACLASSALTHOUGHEVENASINGLENON STATIC
THATONLYCODEFROMWITHINTHECLASSCANINVOKE METHODMEANSTHEREMUSTBESOMEWAYTOMAKEAN
THEMETHOD!CONSTRUCTORMARKEDPRIVATEMEANS INSTANCEOFTHECLASS4HEONLYWAYSTOGETANEW
ESSENTIALLYTHESAMETHINGONLYCODEFROMWITHIN OBJECTARETHROUGH@NEWORDESERIALIZATIONOR
THECLASSCANINVOKETHECONSTRUCTOR.OBODYCAN SOMETHINGCALLEDTHE*AVA2EmECTION!0)THATWE
SAY@NEWFROMOUTSIDETHECLASS4HATSHOWITWORKS DONTGOINTO .OOTHERWAY"UTEXACTLYWHOSAYSNEW
WITHTHE-ATHCLASSFOREXAMPLE4HECONSTRUCTOR CANBEANINTERESTINGQUESTIONANDONEWELLLOOKAT
ISPRIVATEYOUCANNOTMAKEANEWINSTANCEOF-ATH ALITTLELATERINTHISCHAPTER
4HECOMPILERKNOWSTHATYOURCODEDOESNTHAVE
ACCESSTOTHATPRIVATECONSTRUCTOR
FKDSWHU
QXPEHUVDQGVWDWLFV
;\I\QKUM\PWL[KIV¼\][MVWV[\I\QK
QV[\IVKMÎZQIJTM[
3TATICMETHODSRUNWITHOUTKNOWINGABOUTANYPARTICULAR
INSTANCEOFTHESTATICMETHODSCLASS!NDASYOUSAWON
,I\RXWU\WRXVHDQ
THEPREVIOUSPAGESTHEREMIGHTNOTEVENBEANYINSTANCES LQVWDQFHYDULDEOHIURP
OFTHATCLASS3INCEASTATICMETHODISCALLEDUSINGTHECLASS
-ATHRANDOM ASOPPOSEDTOANINSTANCEREFERENCETPLAY LQVLGHDVWDWLFPHWKRG
ASTATICMETHODCANTREFERTOANYINSTANCEVARIABLESOFTHE
CLASS4HESTATICMETHODDOESNTKNOWWHICHINSTANCESVARIABLE
WKHFRPSLOHUWKLQNV
VALUETOUSE ´,GRQ·WNQRZZKLFK
REMHFW·VLQVWDQFHYDULDEOH
,I\RXWU\WRFRPSLOHWKLVFRGH \RX·UHWDONLQJDERXWµ
XFN" ,I\RXKDYHWHQ'XFN
SXEOLFFODVV'XFN^
:KLFK'VL]H"
SULYDWHLQWVL]H
:KRVH REMHFWVRQWKHKHDSD
VWDWLFPHWKRGGRHVQ·W
6\VWHPRXWSULQWOQ³6L]HRIGXFNLV³VL]H
`
NQRZDERXWDQ\RIWKHP
,IWKHUH·VD'
WKHKHDSVRPHZXFKHNUHRQ
SXEOLFYRLGVHW6L]HLQWV^
GRQ·WNQRZDERXWLWZH
VL]H V
`
SXEOLFLQWJHW6L]H^
UHWXUQVL]H
` ,·PVXUHWKH\·UH
1R,·PSUHWW\VXUH
` WDONLQJDERXW0<
WKH\·UHWDONLQJDERXW
VL]HYDULDEOH
0<VL]HYDULDEOH
<RX·OOJHWWKLVHUURU
)LOH(GLW:LQGRZ+HOS4XDFN
MDYDF'XFNMDYD
'XFNMDYDQRQVWDWLFYDULDEOH
VL]HFDQQRWEHUHIHUHQFHGIURPD
VWDWLFFRQWH[W
6\VWHPRXWSULQWOQ³6L]H
RIGXFNLV³VL]H
A
\RXDUHKHUH
VWDWLFPHWKRGV
WKHUH DUH QR
;\I\QKUM\PWL[KIV¼\][MVWV[\I\QK 'XPE 4XHVWLRQV
UM\PWL[MQ\PMZ Q: 7HATIFYOUTRYTOCALLANON STATIC
METHODFROMASTATICMETHODBUTTHE
7HATDONON STATICMETHODSDO4HEYUSUALLYUSEINSTANCE NON STATICMETHODDOESNTUSEANYIN
VARIABLESTATETOAFFECTTHEBEHAVIOROFTHEMETHOD!GET.AME STANCEVARIABLES7ILLTHECOMPILERALLOW
METHODRETURNSTHEVALUEOFTHENAMEVARIABLE7HOSENAME THAT
4HEOBJECTUSEDTOINVOKETHEGET.AME METHOD
7KLVZRQ·WFRPSLOH
A: .O4HECOMPILERKNOWSTHAT
&DOOLQJJHW6 WHETHERYOUDOORDONOTUSEINSTANCE
WKHLQHYLWDEOHL]³HJHMXVWSRVWSRQHV VARIABLESINANON STATICMETHODYOUCAN
SXEOLFFODVV'XFN^
WKHVL]HLQVWDQFHYW6L]HXVHV !NDTHINKABOUTTHEIMPLICATIONSIFYOU
DULDEOH WEREALLOWEDTOCOMPILEASCENARIOLIKE
SULYDWHLQWVL]H THATTHENWHATHAPPENSIFINTHEFUTURE
YOUWANTTOCHANGETHEIMPLEMENTATION
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ OFTHATNON STATICMETHODSOTHATONEDAY
6\VWHPRXWSULQWOQ³6L]HLV³JHW6L]H ITDOESUSEANINSTANCEVARIABLE/RWORSE
` WHATHAPPENSIFASUBCLASSOVERRIDESTHE
METHODANDUSESANINSTANCEVARIABLEIN
SXEOLFYRLGVHW6L]HLQWV^ THEOVERRIDINGVERSION
VL]H V
`
SXEOLFLQWJHW6L]H^ Q: )COULDSWEAR)VESEENCODETHAT
DPHSUREOHP
%DFNWRWKHV
UHWXUQVL]H CALLSASTATICMETHODUSINGAREFERENCE
` VARIABLEINSTEADOFTHECLASSNAME
` ZKRVHVL]H"

)LOH(GLW:LQGRZ+HOS-DFNLQ
A: 9OUCANDOTHATBUTASYOURMOTHER
ALWAYSTOLDYOUh*USTBECAUSEITSLEGAL
MDYDF'XFNMDYD DOESNTMEANITSGOODv!LTHOUGHITWORKS
'XFNMDYDQRQVWDWLFPHWKRG TOCALLASTATICMETHODUSINGANYINSTANCE
OFTHECLASSITMAKESFORMISLEADINGLESS
JHW6L]HFDQQRWEHUHIHUHQFHG
READABLE CODE9OUCANSAY
IURPDVWDWLFFRQWH[W
'XFNG QHZ'XFN
6\VWHPRXWSULQWOQ³6L]H 6WULQJ>@V ^`
RIGXFNLV³JHW6L]H GPDLQV
A
4HISCODEISLEGALBUTTHECOMPILERJUST
RESOLVESITBACKTOTHEREALCLASSANYWAY
N
0D)RNUPH DWLWJHW6W'DLFWH7LPHVW,QDQVWFHDQFH h/+DISOFTYPE$UCKANDMAIN ISSTATIC
SO)LLCALLTHESTATICMAIN INCLASS$UCKv
'DWH PH,Q
DWJHW7L UFHQW,QVWDQFH )NOTHERWORDSUSINGDTOINVOKEMAIN
'DWH)RUP SADW RED 3H
2
HUO SE
)R UP REJHW DOESNTIMPLYTHATMAIN WILLHAVEANY
1XPE
NTOBLO OMLATE
ANDKNOW SPECIALKNOWLEDGEOFTHEOBJECTTHATDIS
REFERENCING)TSJUSTANALTERNATEWAYTO
NTSEE
3TATICSCA TE INVOKEASTATICMETHODBUTTHEMETHODIS
ARIABLESTA
INSTANCEV STILLSTATIC
FKDSWHU
QXPEHUVDQGVWDWLFV
;\I\QKÎZQIJTM"
W
V WD WLF GXFN&RXHQG21/<
ÎT]MQ[\PM[IUMNWZ)44
7KH OHLVLQLWLDOL] VW
YDULDE WKHFODVVLVILU LPHD
QV[\IVKM[WN\PMKTI[[ ZKHQ 127HDFKW H
SXEOLFFODVV'XFN^ ORDGHG VWDQFHLVPDG
)MAGINEYOUWANTEDTOCOUNTHOWMANY$UCK QHZLQ
INSTANCESAREBEINGCREATEDWHILEYOURPROGRAMIS SULYDWHLQWVL]H
RUNNING(OWWOULDYOUDOIT-AYBEANINSTANCE SULYDWHVWDWLFLQWGXFN&RXQW

VARIABLETHATYOUINCREMENTINTHECONSTRUCTOR
SXEOLF'XFN^ 1RZLWZ
FODVV'XFN^ GXFN&RXQW LQFUHPHQWLOLQOJNHHS
LQWGXFN&RXQW ` WKH' HDFKWLPH
XFNFRQVWUXF
SXEOLF'XFN^ EHFDXVHGXF WR
GXFN&RXQW WKLVZRXO OZ N&RXQWLVUVWUDXQV
DQGZRQ·WEH
` GXFN&RXQGWD D\VVH UHVHWWR WLF
` D WRHDFKWW
'XFNZDVP LPH SXEOLFYRLGVHW6L]HLQWV^
DGH VL]H V
`
.OTHATWOULDNTWORKBECAUSEDUCK#OUNTISAN SXEOLFLQWJHW6L]H^
INSTANCEVARIABLEANDSTARTSATFOREACH$UCK9OU UHWXUQVL]H
COULDTRYCALLINGAMETHODINSOMEOTHERCLASSBUT `
THATSKLUDGEY9OUNEEDACLASSTHATSGOTONLYASINGLE `
COPYOFTHEVARIABLEANDALLINSTANCESSHARETHATONE
COPY
4HATSWHATASTATICVARIABLEGIVESYOUAVALUESHARED RS\
BYALLINSTANCESOFACLASS)NOTHERWORDSONEVALUE
·W N H H S LWVRZQF
RHVQ
PERCLASSINSTEADOFONEVALUEPERINSTANCE REMHFWG
$'XFFNN&RXQW '
WV
XFNREMWHKFLQN
RIGX V W D W LF
WLV ILW<RXFDQ OLYHV
GXFN&RXQ R W
%HFDXVHUHDVLQJOHFRS\DVDYDULDEOHWFKWD
VK D E OH
DOO WDWLFYDULD RILQDQR E M H
RIDV /$66LQVWHDG
'XFN
LQD&
VL]H VL]H
GXFN&RXQW VWDWLFGXFN&RXQW VL]H
GXFN&RXQW
'X
FNREMHFW
JHW6L]H

'X
FNREMHFW

VHW6L]H
VL]H (DFK'XF
GXFN&RXQW VL]H
VL]HYDULDENOHREMHFWKDVLWVRZQ
GXFN&RXQW RQHFRS\ EXWWKHUH·VR
QO\
'X
FNREMHFW YDULDEOH³RWKIHWKHGXFN&RXQW

'X RQHLQWKHFOD
FNREMHFW

VV
\RXDUHKHUH
VWDWLFYDULDEOHV
VWDWLFYDULDEOH NLGLQVWDQFHWZR
QH LFH&UHDP
NLGLQVWDQFHR
Static variables are shared.
All instances of the same

class share a single copy of
the static variables.
LQVWDQFHYDULDEOHVSHULQVWDQFH
VWDWLFYDULDEOHVSHUFODVV
DLQ EDUEHOO
EU%UDLQ%DUEHOO
%ARLIERINTHISCHAPTERWESAWTHATAPRIVATE
CONSTRUCTORMEANSTHATTHECLASSCANTBEINSTANTIATED
FROMCODERUNNINGOUTSIDETHECLASS)NOTHERWORDS
ONLYCODEFROMWITHINTHECLASSCANMAKEANEW
INSTANCEOFACLASSWITHAPRIVATECONSTRUCTOR4HERES
AKINDOFCHICKEN AND EGGPROBLEMHERE
7HATIFYOUWANTTOWRITEACLASSINSUCHAWAYTHAT
ONLY/.%INSTANCEOFITCANBECREATEDANDANYONE
WHOWANTSTOUSEANINSTANCEOFTHECLASSWILLALWAYS
USETHATONESINGLEINSTANCE
FKDSWHU
QXPEHUVDQGVWDWLFV
1VQ\QITQbQVOI[\I\QKÎZQIJTM
3TATICVARIABLESAREINITIALIZEDWHENACLASSISLOADED!CLASSIS
LOADEDBECAUSETHE*6-DECIDESITSTIMETOLOADIT4YPICALLY $OOVWDWLFYDULDEOHV
THE*6-LOADSACLASSBECAUSESOMEBODYSTRYINGTOMAKEA
NEWINSTANCEOFTHECLASSFORTHElRSTTIMEORUSEASTATIC
LQDFODVVDUH
METHODORVARIABLEOFTHECLASS!SAPROGRAMMERYOUALSO LQLWLDOL]HGEHIRUH
HAVETHEOPTIONOFTELLINGTHE*6-TOLOADACLASSBUTYOURE DQ\REMHFWRI
NOTLIKELYTONEEDTODOTHAT)NNEARLYALLCASESYOUREBETTER
WKDWFODVVFDQEH
OFFLETTINGTHE*6-DECIDEWHENTOLOADTHECLASS
FUHDWHG
!NDTHEREARETWOGUARANTEESABOUTSTATICINITIALIZATION
3TATICVARIABLESINACLASSAREINITIALIZEDBEFOREANYOBJECTOFTHAT
CLASSCANBECREATED
3TATICVARIABLESINACLASSAREINITIALIZEDBEFOREANYSTATICMETHOD
OFTHECLASSRUNS
FODVV3OD\HU^ KHQWKHFODVVLVORDGHG
7KHSOD\HU&RXQWLVLQLWLDOL]HGZE XWZHGRQ·WQHHG
:HH[SOLFLWO\LQLWLDOL]HGLWWRHIRULQ
VWDWLFLQWSOD\HU&RXQW
WRVLQFHLVWKHGHID XOW YDOX WV6WDWLFYDUL
LQV WDQ FHYDULDEOHV
SULYDWH6WULQJQDPH
DEOHVJHWGHIDXOWYDOXHVMXVWOLNH
SXEOLF3OD\HU6WULQJQ^
QDPH Q
'HIDXOWYDOXHVI
SOD\HU&RXQW VWDWLFDQGLQVWDQFRUHGYDHFODUHGEXWXQLQLWLDOL]HG
`
ULDEOHVDUHWKHVDPH
SULPLWLYHLQWHJHUVORQJ
` VKRUWHWF
SULPLWLYHIORDWLQJSRLQW
VIORDWGRXEOH
SXEOLFFODVV3OD\HU7HVW'ULYH^ ERROHDQIDOVH
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ REMHFWUHIHUHQFHVQXOO
6\VWHPRXWSULQWOQ3OD\HUSOD\HU&RXQW
3OD\HURQH QHZ3OD\HU³7LJHU:RRGV´
6\VWHPRXWSULQWOQ3OD\HUSOD\HU&RXQW

$FFHVVDVWDWLFYDULDEOHMXVWO LNHDVWDWLF
`
` PHWKRG³Z LWK WKH FOD VVQ DPH
)LOH(GLW:LQGRZ+HOS:KDW"
3TATICVARIABLESAREINITIALIZEDWHENTHECLASSISLOADED)FYOU
DONTEXPLICITLYINITIALIZEASTATICVARIABLEBYASSIGNINGITA MDYD3OD\HU7HVW'ULYH
VALUEATTHETIMEYOUDECLAREIT ITGETSADEFAULTVALUESOINT EHIRUHDQ\LQVWDQFHVDUHPDGH
VARIABLESAREINITIALIZEDTOZEROWHICHMEANSWEDIDNTNEED

TOEXPLICITLYSAYhPLAYER#OUNTv$ECLARINGBUTNOTINITIAL
IZINGASTATICVARIABLEMEANSTHESTATICVARIABLEWILLGETTHEDE DIWHUDQREMHFWLVFU
HDWHG
FAULTVALUEFORTHATVARIABLETYPEINEXACTLYTHESAMEWAYTHAT
INSTANCEVARIABLESAREGIVENDEFAULTVALUESWHENDECLARED
\RXDUHKHUH
VWDWLFILQDOFRQVWDQWV
[\I\QKNQVITÎZQIJTM[IZMKWV[\IV\[
!VARIABLEMARKED¿QDOMEANSTHATONCEINITIALIZEDITCAN
NEVERCHANGE)NOTHERWORDSTHEVALUEOFTHESTATIClNALVARIABLE $VWDWLFLQLWLDOL]HULVDEORFN
WILLSTAYTHESAMEASLONGASTHECLASSISLOADED,OOKUP-ATH0) RI FRGHWKDWUXQVZKHQD
INTHE!0)ANDYOULLlND FODVVLVORDGHGEHIRUHDQ\
SXEOLFVWDWLF¿QDOGRXEOH3, RWKHUFRGHFDQXVHWKH
FODVVVRLW·VDJUHDWSODFH
4HEVARIABLEISMARKEDSXEOLFSOTHATANYCODECANACCESSIT
WRLQLWLDOL]HDVWDWLFILQDO
4HEVARIABLEISMARKEDVWDWLFSOTHATYOUDONTNEEDAN YDULDEOH
INSTANCEOFCLASS-ATHWHICHREMEMBERYOURENOTALLOWEDTO FODVV)RR^
CREATE
¿QDOVWDWLFLQW[
Licensed by
4HEVARIABLEISMARKED¿QDOBECAUSE0)DOESNTCHANGEASFARAS
*AVAISCONCERNED VWDWLF^
4HEREISNOOTHERWAYTODESIGNATEAVARIABLEASACONSTANTBUT [

THEREISANAMINGCONVENTIONTHATHELPSYOUTORECOGNIZEONE `
#ONSTANTVARIABLENAMESSHOULDBEINALLCAPS
Eduard Simons
`
,QLWLDOL]HDÀQDOVWDWLFYDULDEOH
$WWKHWLPH\RXGHFODUHLW
SXEOLFFODVV)RR^
104038 ,I\RXGRQ·WJLYHDYDOXHWRDÀQDOYDULDEOH
LQRQHRIWKRVHWZRSODFHV
SXEOLFVWDWLF¿QDOLQW)22B;
` SXEOLFFODVV%DU^
QRWLFHW SXEOLFVWDWLF¿QDOGRXEOH%$5B6,*1
ILQDOYDULDKHEQDPLQJFRQYHQWLRQ QRLQLWLDOL]
QDPHVK OHVDUHFRQVWD VWDWLF ` DWLRQ
XQGHUVFRRUXHOGEHDOOXSSHUFDQVHWVVRWKH
VHSDUDWLQJ
25 WKHZRUZGLWV KDQ
7KHFRPSLOHUZLOOFDWFKLW
,QDVWDWLFLQLWLDOL]HU )LOH(GLW:LQGRZ+HOS-DFNLQ
SXEOLFFODVV%DU^ MDYDF%DUMDYD
SXEOLFVWDWLF¿QDOGRXEOH%$5B6,*1
%DUMDYDYDULDEOH%$5B6,*1
VWDWLF^ PLJKWQRWKDYHEHHQLQLWLDOL]HG
%$5B6,*1 GRXEOH0DWKUDQGRP HUURU
`
`
WKLVFRG
LVORDGHGHUE XQVDVVRRQDVWKH
LVFDOOHGDQ HIRUHDQ\VWDWLFPFODVV
YDULDEOHFD GHYHQEHIRUHDQ HWKRG
QEHXVHG \VWDWLF
FKDSWHU
QXPEHUVDQGVWDWLFV
NQVITQ[V¼\R][\NWZ[\I\QK
ÎZQIJTM[
9OUCANUSETHEKEYWORD¿QDOTOMODIFYNON A final variable means you
STATICVARIABLESTOOINCLUDINGINSTANCEVARIABLES
LOCALVARIABLESANDEVENMETHODPARAMETERS)N
EACHCASEITMEANSTHESAMETHINGTHEVALUECANT
canÕt change its value.
BECHANGED"UTYOUCANALSOUSElNALTOSTOP
SOMEONEFROMOVERRIDINGAMETHODORMAKINGA
SUBCLASS
A final method means you
QRQVWDWLFÀQDOYDULDEOHV
canÕt override the method.
FODVV)RRI^
¿QDOLQWVL]H
QRZ\RXFDQ·WFKDQJHVL]H
¿QDOLQWZKXI¿H
)RRI^
ZKXI¿H QRZ\RXFDQ·WFKDQJHZKXIILH A final class means you
`
canÕt extend the class (i.e.
YRLGGR6WXII¿QDOLQW[^
\RXFDQ¶WFKDQJH[
`
you canÕt make a subclass).

YRLGGR0RUH^
¿QDOLQW]
\RXFDQ¶WFKDQJH] ,W·VDOOVRVRÀQDO
` ,PHDQLI,·GNQRZQ
` ,ZRXOGQ·WEHDEOHWR
FKDQJHWKLQJV
ÀQDOPHWKRG
FODVV3RRI^
¿QDOYRLGFDOF:KXI¿H^
LPSRUWDQWWKLQJV
WKDWPXVWQHYHUEHRYHUULGGHQ
`
`
ÀQDOFODVV
¿QDOFODVV0\0RVW3HUIHFW&ODVV^
FDQQRWEHH[WHQGHG
`
\RXDUHKHUH
VWDWLFDQGILQDO
WKHUH DUH QR
'XPE 4XHVWLRQV
:MDD=LHGAFLK
Q: !STATICMETHODCANTACCESSA $VWDWLFPHWKRGVKRXOGEHFDOOHGXVLQJWKHFODVV
NON STATICVARIABLE"UTCANANON STATIC QDPHUDWKHUWKDQDQREMHFWUHIHUHQFHYDULDEOH
METHODACCESSASTATICVARIABLE 0DWKUDQGRPYVP\)RRJR
$VWDWLFPHWKRGFDQEHLQYRNHGZLWKRXWDQ\LQVWDQFHV
A: /FCOURSE!NON STATICMETHODINA RIWKHPHWKRG·VFODVVRQWKHKHDS
CLASSCANALWAYSCALLASTATICMETHODINTHE $VWDWLFPHWKRGLVJRRGIRUDXWLOLW\PHWKRGWKDWGRHV
CLASSORACCESSASTATICVARIABLEOFTHECLASS
QRWDQGZLOOQHYHUGHSHQGRQDSDUWLFXODULQVWDQFH
YDULDEOHYDOXH
$VWDWLFPHWKRGLVQRWDVVRFLDWHGZLWKDSDUWLFXODU
Q: 7HYWOULD)WANTTOMAKEACLASS LQVWDQFH³RQO\WKHFODVV³VRLWFDQQRWDFFHVVDQ\
lNAL$OESNTTHATDEFEATTHEWHOLE LQVWDQFHYDULDEOHYDOXHVRILWVFODVV,WZRXOGQ·WNQRZ
PURPOSEOF// ZKLFKLQVWDQFH·VYDOXHVWRXVH
$VWDWLFPHWKRGFDQQRWDFFHVVDQRQVWDWLFPHWKRG
A: 9ESANDNO!TYPICALREASONFOR VLQFHQRQVWDWLFPHWKRGVDUHXVXDOO\DVVRFLDWHGZLWK
LQVWDQFHYDULDEOHVWDWH
MAKINGACLASSFINALISFORSECURITY9OU
CANTFOREXAMPLEMAKEASUBCLASSOFTHE ,I\RXKDYHDFODVVZLWKRQO\VWDWLFPHWKRGVDQG\RX
3TRINGCLASS)MAGINETHEHAVOCIFSOMEONE GRQRWZDQWWKHFODVVWREHLQVWDQWLDWHG\RXFDQPDUN
EXTENDEDTHE3TRINGCLASSANDSUBSTITUTED
WKHFRQVWUXFWRUSULYDWH
THEIROWN3TRINGSUBCLASSOBJECTS
POLYMORPHICALLYWHERE3TRINGOBJECTS $VWDWLFYDULDEOHLVDYDULDEOHVKDUHGE\DOOPHPEHUV
AREEXPECTED)FYOUNEEDTOCOUNTONA RIDJLYHQFODVV7KHUHLVRQO\RQHFRS\RIDVWDWLF
PARTICULARIMPLEMENTATIONOFTHEMETHODS YDULDEOHLQDFODVVUDWKHUWKDQRQHFRS\SHUHDFK
INACLASSMAKETHECLASSFINAL LQGLYLGXDOLQVWDQFHIRULQVWDQFHYDULDEOHV
$VWDWLFPHWKRGFDQDFFHVVDVWDWLFYDULDEOH
7RPDNHDFRQVWDQWLQ-DYDPDUNDYDULDEOHDVERWK
Q: )SNTITREDUNDANTTOHAVETOMARK VWDWLFDQGILQDO
THEMETHODSlNALIFTHECLASSISlNAL
$ILQDOVWDWLFYDULDEOHPXVWEHDVVLJQHGDYDOXHHLWKHU
DWWKHWLPHLWLVGHFODUHGRULQDVWDWLFLQLWLDOL]HU
A: )FTHECLASSISFINALYOUDONTNEEDTO VWDWLF^
'2*B&2'(
MARKTHEMETHODSFINAL4HINKABOUTITIF
ACLASSISFINALITCANNEVERBESUBCLASSED `
SONONEOFTHEMETHODSCANEVERBE
OVERRIDDEN
7KHQDPLQJFRQYHQWLRQIRUFRQVWDQWVILQDOVWDWLF
YDULDEOHVLVWRPDNHWKHQDPHDOOXSSHUFDVH
/NTHEOTHERHANDIFYOUDOWANTTOALLOW
OTHERSTOEXTENDYOURCLASSANDYOUWANT $ILQDOYDULDEOHYDOXHFDQQRWEHFKDQJHGRQFHLWKDV
THEMTOBEABLETOOVERRIDESOMEBUTNOT EHHQDVVLJQHG
ALLOFTHEMETHODSTHENDONTMARKTHE $VVLJQLQJDYDOXHWRDILQDOLQVWDQFHYDULDEOHPXVWEH
CLASSFINALBUTGOINANDSELECTIVELYMARK HLWKHUDWWKHWLPHLWLVGHFODUHGRULQWKHFRQVWUXFWRU
SPECIFICMETHODSASFINAL!FINALMETHOD
MEANSTHATASUBCLASSCANTOVERRIDETHAT $ILQDOPHWKRGFDQQRWEHRYHUULGGHQ
PARTICULARMETHOD $ILQDOFODVVFDQQRWEHH[WHQGHGVXEFODVVHG
FKDSWHU
QXPEHUVDQGVWDWLFV
6KDUSHQ \RXU SHQFLO
:KDW·V/HJDO"
'IVENEVERYTHINGYOUVEJUST
LEARNEDABOUTSTATICANDlNAL
WHICHOFTHESEWOULDCOMPILE
SXEOLFFODVV)RR^

VWDWLFLQW[
SXEOLFYRLGJR^ SXEOLFFODVV)RR^

6\VWHPRXWSULQWOQ[ VWDWLF¿QDOLQW[
`
` SXEOLFYRLGJR^
6\VWHPRXWSULQWOQ[
`
`
SXEOLFFODVV)RR^
LQW[
SXEOLFVWDWLFYRLGJR^ SXEOLFFODVV)RR^

6\VWHPRXWSULQWOQ[ VWDWLF¿QDOLQW[
`
` SXEOLFYRLGJR¿QDOLQW[^
6\VWHPRXWSULQWOQ[
`
`
SXEOLFFODVV)RR^
¿QDOLQW[
SXEOLFFODVV)RR^
SXEOLFYRLGJR^ LQW[
6\VWHPRXWSULQWOQ[
` SXEOLFVWDWLFYRLGJR¿QDOLQW[^
` 6\VWHPRXWSULQWOQ[
`
`
\RXDUHKHUH
0DWKPHWKRGV
5I\PUM\PWL[
.OWTHATWEKNOWHOWSTATIC
METHODSWORKLETSLOOK 0DWKUDQGRP
ATSOMESTATICMETHODSIN 5HWXUQVDGRXEOHEHWZHHQWKURXJKEXW
CLASS-ATH4HISISNTALLOF QRWLQFOXGLQJ
THEMJUSTTHEHIGHLIGHTS GRXEOHU 0DWKUDQGRP
#HECKYOUR!0)FORTHEREST LQWU LQW0DWKUDQGRP
INCLUDINGSQRT TAN CEIL
mOOR ANDASIN
0DWKDEV
5HWXUQVDGRXEOHWKDWLVWKHDEVROXWHYDOXHRI
WKHDUJXPHQW7KHPHWKRGLVRYHUORDGHGVR
LI\RXSDVVLWDQLQWLWUHWXUQVDQLQW3DVVLWD
GRXEOHLWUHWXUQVDGRXEOH
LQW[ 0DWKDEVUHWXUQV

GRXEOHG 0DWKDEVUHWXUQV
0DWKURXQG
5HWXUQVDQLQWRUDORQJGHSHQGLQJRQ
ZKHWKHUWKHDUJXPHQWLVDÁRDWRUDGRXEOH
URXQGHGWRWKHQHDUHVWLQWHJHUYDOXH
LQW[ 0DWKURXQGIUHWXUQV
LQW\ 0DWKURXQGIUHWXUQV
5HPHPEHUIORDWLQJSRLQWOLWHUD
WREHGRXEOHVXQOHVV\RX OVDUHDVVXPHG
DGGWKH¶I·
0DWKPLQ
5HWXUQVDYDOXHWKDWLVWKHPLQLPXPRIWKH
WZRDUJXPHQWV7KHPHWKRGLVRYHUORDGHGWR
WDNHLQWVORQJVÁRDWVRUGRXEOHV
LQW[ 0DWKPLQUHWXUQV
GRXEOH\ 0DWKPLQUHWXUQV
0DWKPD[
5HWXUQVDYDOXHWKDWLVWKHPD[LPXPRIWKH
WZRDUJXPHQWV7KHPHWKRGLVRYHUORDGHGWR
WDNHLQWVORQJVÁRDWVRUGRXEOHV
LQW[ 0DWKPD[UHWXUQV
GRXEOH\ 0DWKPD[UHWXUQV
FKDSWHU
QXPEHUVDQGVWDWLFV
?ZIXXQVOIXZQUQ\Q^M
3OMETIMESYOUWANTTOTREATAPRIMITIVELIKE
ANOBJECT&OREXAMPLEINALLVERSIONSOF*AVA
object
PRIORTOYOUCANNOTPUTAPRIMITIVEDIRECTLY
INTOACOLLECTIONLIKE!RRAY,ISTOR(ASH-AP
LQW[
$UUD\/LVWOLVW QHZ$UUD\/LVW
OLVWDGG[
7KLVZRQ·WZRUNXQOHVV\RX·UH
KHUH·VQ RDGGLQ
XVLQJ-DYDRU
WP HWKRGLQ$UUD\/LVW
primitive
JUHDWHU7 KDVDGGPHWKRGV
WKDWWDNHVDQLQW$UUD HVQRWQO\
\/L VWR
SULPLWLYHV
WKDWWDNHREMHFWUHIHUHQF When you need to treat
4HERESAWRAPPERCLASSFOREVERYPRIMITIVETYPE
ANDSINCETHEWRAPPERCLASSESAREINTHEJAVA a primitive like an object,
LANGPACKAGEYOUDONTNEEDTOIMPORTTHEM
9OUCANRECOGNIZEWRAPPERCLASSESBECAUSE
wrap it. If youÕre using any
EACHONEISNAMEDAFTERTHEPRIMITIVETYPEIT
WRAPSBUTWITHTHElRSTLETTERCAPITALIZEDTO
version of Java before 5.0,
FOLLOWTHECLASSNAMINGCONVENTION youÕll do this when you
/HYEAHFORREASONSABSOLUTELYNOBODYONTHE
PLANETISCERTAINOFTHE!0)DESIGNERSDECIDED need to store a primitive
NOTTOMAPTHENAMESEXACTLYFROMPRIMITIVE
TYPETOCLASSTYPE9OULLSEEWHATWEMEAN
value inside a collection like
%RROHDQ ArrayList or HashMap.
&KDUDFWHU
%\WH
:DWFKRXW7KHQDPHVDUHQ·WLYH H
6KRUW PDSSHGH[DFWO\WRWKHSULPLW LQWSULPLWLY
,QWHJHU
W\SHV7KHFODVVQDPHVDUHIXOO\
VSHOOHGRXW ,QWHJHUREMHFW
/RQJ

)ORDW
HFW
LQW
,Q
'RXEOH WHJHUREM
*LYHWKHSULPLWLYHWRWKH ·VLW
ZUDSSHUFRQVWUXFWRU7KDW
ZUDSSLQJDYDOXH
LQWL
,QWHJHUL:UDS QHZ,QWHJHUL
$OOWKHZUDSSHUVZRUN
OLNHWKLV%RROHDQKDVD
XQZUDSSLQJDYDOXH
ERROHDQ9DOXH&KDUDFWHU
KDVDFKDU9DOXHHWF 1RWHWKHSLFWXUHDWWKHWRSLVDFKRFRODWHLQDIRLOZUDSSHU*HW
LQWXQ:UDSSHG L:UDSLQW9DOXH LW":UDSSHU"6RPHSHRSOHWKLQNLWORRNVOLNHDEDNHGSRWDWREXW
WKDWZRUNVWRR
\RXDUHKHUH
VWDWLFPHWKRGV
7KLVLVVWXSLG<RXPHDQ,FDQ·W
MXVWPDNHDQ$UUD\/LVWRILQWV""",
KDYHWRZUDSHYHU\VLQJOHIULFNLQ·RQHLQDQHZ
,QWHJHUREMHFWWKHQXQZUDSLWZKHQ,WU\
WRDFFHVVWKDWYDOXHLQWKH$UUD\/LVW"
7KDW·VDZDVWHRIWLPHDQGDQHUURU
ZDLWLQJWRKDSSHQ
*MNWZM2IÎA7=PIL\WLW\PM_WZS
3HESRIGHT)NALLVERSIONSOF*AVAPRIORTOPRIMITIVESWEREPRIMITIVES
ANDOBJECTREFERENCESWEREOBJECTREFERENCESANDTHEYWERE.%6%2
TREATEDINTERCHANGEABLY)TWASALWAYSUPTOYOUTHEPROGRAMMERTODO
THEWRAPPINGANDUNWRAPPING4HEREWASNOWAYTOPASSAPRIMITIVETOA
METHODEXPECTINGANOBJECTREFERENCEANDNOWAYTOASSIGNTHERESULTOFA
METHODRETURNINGANOBJECTREFERENCEDIRECTLYTOAPRIMITIVEVARIABLEEVEN
WHENTHERETURNEDREFERENCEISTOAN)NTEGERANDTHEPRIMITIVEVARIABLEIS
ANINT4HEREWASSIMPLYNORELATIONSHIPBETWEENAN)NTEGERANDANINT
OTHERTHANTHEFACTTHAT)NTEGERHASANINSTANCEVARIABLEOFTYPEINTTOHOLD
THEPRIMITIVETHE)NTEGERWRAPS !LLTHEWORKWASUPTOYOU
$Q$UUD\/LVWRISULPLWLYHLQWV
:LWKRXWDXWRER[LQJ-DYDYHUVLRQVEHIRUH RW

5H PH PE HU E HI RUH\RXFRXOGEMQHFWV
SXEOLFYRLGGR1XPV2OG:D\^ 0DNHDQ$UUD\/LVWVRDOO$UUD\/LVWVZHUHOLVWVRI2
VSHFLI\WKH7<3(
$UUD\/LVWOLVW2I1XPEHUV QHZ$UUD\/LVW
S HOLVW
ULPLWLYH¶·WRWKIL
< RXF DQ·WD GG WKH U UVW
OLVW2I1XPEHUVDGGQHZ,QWHJHU ZUDSLWLQDQ,QWHJH
VR\RXKDYHWR

,QWHJHURQH ,QWHJHUOLVW2I1XPEHUVJHW
,WFRPHVRXWDVW\DQSHFDVW
F
2EMHFWEXW\RX ,QWHJHU
LQWLQW2QH RQHLQW9DOXH
`
WKH2EMHFWWRDQ
)LQDOO\\RXFDQJ
RXWRIWKH,QWHJ HWWKHSULPLWLYH
HU
FKDSWHU
QXPEHUVDQGVWDWLFV
)]\WJW`QVO"JT]ZZQVO\PMTQVM
JM\ _MMVXZQUQ\Q^MIVLWJRMK\
4HEAUTOBOXINGFEATUREADDEDTO*AVADOES
THECONVERSIONFROMPRIMITIVETOWRAPPEROBJECT
AUTOMATICALLY
,ETSSEEWHATHAPPENSWHENWEWANTTOMAKEAN
!RRAY,ISTTOHOLDINTS
$Q$UUD\/LVWRISULPLWLYHLQWV
:LWKDXWRER[LQJ-DYDYHUVLRQVRUJUHDWHU
RIW\SH,QWHJHU
SXEOLFYRLGGR1XPV1HZ:D\^ 0DNHDQ$UUD\/LVW
$UUD\/LVW,QWHJHU!OLVW2I1XPEHUV QHZ$UUD\/LVW,QWHJHU!
OLVW2I1XPEHUVDGG -XVWDGGLW $OWKRXJKWKHUHLV127DPHWKRGLQ$UUD\/LVW

IRUDGGLQWWKHFRPSLOHUGRHVDOOWKHZUDSSLQJ
LQWQXP OLVW2I1XPEHUVJHW ER[LQJIRU\RX,QRWKHUZRUGVWKHUHUHDOO\,6
` DQ,QWHJHUREMHFWVWRUHGLQWKH$UUD\/LVWEXW
$QGWKHFRPSLOHUDXWRPDWLF \RXJHWWR´SUHWHQGµWKDWWKH$UUD\/LVWWDNHV
WKH,QWHJHUREMHFWVR\RXF DOO\XQZUDSVXQER[HV LQWV<RXFDQDGGERWKLQWVDQG,QWHJHUVWRDQ
GLUHFWO\WRDSULPLWLYHZLWKDQDVVLJQWKHLQWYDOXH $UUD\/LVW,QWHJHU!
LQW9DOXHPHWKRGRQWKH,QWRXWKDYLQJWRFDOOWKH
HJHUREMHFW
Q: 7HYNOTDECLAREAN!RRAY,ISTINTIFYOUWANTTO
HOLDINTS
A: "ECAUSEYOUCANT2EMEMBERTHERULEFORGENERIC
TYPESISTHATYOUCANSPECIFYONLYCLASSORINTERFACETYPESNOT
PRIMITIVES3O!RRAY,ISTINTWILLNOTCOMPILE"UTASYOUCAN
SEEFROMTHECODEABOVEITDOESNTREALLYMATTERSINCETHE
COMPILERLETSYOUPUTINTSINTOTHE!RRAY,IST)NTEGER)NFACT
THERESREALLYNOWAYTOPREVENTYOUFROMPUTTINGPRIMITIVES
INTOAN!RRAY,ISTWHERETHETYPEOFTHELISTISTHETYPEOFTHAT
PRIMITIVESWRAPPERIFYOUREUSINGA*AVA COMPLIANTCOM
PILERSINCEAUTOBOXINGWILLHAPPENAUTOMATICALLY3OYOUCAN
PUTBOOLEANPRIMITIVESINAN!RRAY,IST"OOLEANANDCHARS
INTOAN!RRAY,IST#HARACTER
\RXDUHKHUH
VWDWLFPHWKRGV
)]\WJW`QVO_WZS[ITUW[\M^MZa_PMZM
!UTOBOXINGLETSYOUDOMORETHANJUSTTHEOBVIOUSWRAPPINGAND
UNWRAPPINGTOUSEPRIMITIVESINACOLLECTIONITALSOLETSYOUUSE
EITHERAPRIMITIVEORITSWRAPPERTYPEVIRTUALLYANYWHEREONEORTHE
OTHERISEXPECTED4HINKABOUTTHAT
)XQZLWKDXWRER[LQJ
0HWKRGDUJXPHQWV
,IDPHWKRGWDNHVDZUDSSHUW\SH\RX
FDQSDVVDUHIHUHQFHWRDZUDSSHURU
W
DSULPLWLYHRIWKHPDWFKLQJW\SH$QG ,Q
HF
WHJ REM LQW
RIFRXUVHWKHUHYHUVHLVWUXH³LID HU
PHWKRGWDNHVDSULPLWLYH\RXFDQ
SDVVLQHLWKHUDFRPSDWLEOHSULPLWLYH
RUDUHIHUHQFHWRDZUDSSHURIWKDW YRLGWDNH1XPEHU,QWHJHUL^`
SULPLWLYHW\SH
5HWXUQYDOXHV LQWJLYH1XPEHU^

,IDPHWKRGGHFODUHVDSULPLWLYH UHWXUQ[
UHWXUQW\SH\RXFDQUHWXUQHLWKHUD `
FRPSDWLEOHSULPLWLYHRUDUHIHUHQFH
WRWKHZUDSSHURIWKDWSULPLWLYHW\SH
$QGLIDPHWKRGGHFODUHVDZUDSSHU
UHWXUQW\SH\RXFDQUHWXUQHLWKHUD
W
,Q
HF
UHIHUHQFHWRWKHZUDSSHUW\SHRUD WHJ REM

SULPLWLYHRIWKHPDWFKLQJW\SH HU LQW
%RROHDQH[SUHVVLRQV WUXH
$Q\SODFHDERROHDQYDOXHLVH[SHFWHG WUXH
\RXFDQXVHHLWKHUDQH[SUHVVLRQWKDW
W
ER
HF
HYDOXDWHVWRDERROHDQ!RUD ROH REM ERROHDQ

D Q
SULPLWLYHERROHDQRUDUHIHUHQFHWRD
%RROHDQZUDSSHU
LIERRO^
6\VWHPRXWSULQWOQ³WUXH´
`
FKDSWHU
QXPEHUVDQGVWDWLFV
2SHUDWLRQVRQQXPEHUV
7KLVLVSUREDEO\WKHVWUDQJHVWRQH³\HV\RX
FDQQRZXVHDZUDSSHUW\SHDVDQRSHUDQG
LQRSHUDWLRQVZKHUHWKHSULPLWLYHW\SHLV

H[SHFWHG7KDWPHDQV\RXFDQDSSO\VD\
WKHLQFUHPHQWRSHUDWRUDJDLQVWDUHIHUHQFH
W
,Q
HF
WRDQ,QWHJHUREMHFW WHJ REM
HU LQW
%XWGRQ·WZRUU\³WKLVLVMXVWDFRPSLOHUWULFN
7KHODQJXDJHZDVQ·WPRGLÀHGWRPDNHWKH
RSHUDWRUVZRUNRQREMHFWVWKHFRPSLOHU L
VLPSO\FRQYHUWVWKHREMHFWWRLWVSULPLWLYH
W\SHEHIRUHWKHRSHUDWLRQ,WVXUHORRNV
ZHLUGWKRXJK
,QWHJHUL QHZ,QWHJHU
L
$QGWKDWPHDQV\RXFDQDOVRGRWKLQJVOLNH
,QWHJHUM QHZ,QWHJHU
,QWHJHUN M
$VVLJQPHQWV

<RXFDQDVVLJQHLWKHUDZUDSSHURUSULPLWLYH
W
WRDYDULDEOHGHFODUHGDVDPDWFKLQJZUDSSHU ,Q
HF
WHJ REM
RUSULPLWLYH)RUH[DPSOHDSULPLWLYHLQW HU LQW
YDULDEOHFDQEHDVVLJQHGWRDQ,QWHJHU
UHIHUHQFHYDULDEOHDQGYLFHYHUVD³D
UHIHUHQFHWRDQ,QWHJHUREMHFWFDQEH
'RXEOHG [
DVVLJQHGWRDYDULDEOHGHFODUHGDVDQLQW
SULPLWLYH
6KDUSHQ \RXU SHQFLO SXEOLFFODVV7HVW%R[^
,QWHJHUL
:LOOWKLVFRGHFRPSLOH":LOOLWUXQ",ILWUXQV LQWM
ZKDWZLOOLWGR"
7DNH\RXUWLPHDQGWKLQNDERXWWKLVRQHLW 7HVW%R[W QHZ7HVW%R[
EULQJVXSDQLPSOLFDWLRQRIDXWRER[LQJWKDW WJR
ZHGLGQ·WWDONDERXW `

<RX·OOKDYHWRJRWR\RXUFRPSLOHUWRILQG SXEOLFYRLGJR^
WKHDQVZHUV<HVZH·UHIRUFLQJ\RXWR M L
H[SHULPHQWIRU\RXURZQJRRGRIFRXUVH 6\VWHPRXWSULQWOQM
6\VWHPRXWSULQWOQL
`
`
\RXDUHKHUH
ZUDSSHUPHWKRGV
*]\_IQ\ <PMZM¼[UWZM ?ZIXXMZ[

PI^M[\I\QK]\QTQ\aUM\PWL[\WW
"ESIDESACTINGLIKEANORMALCLASSTHEWRAPPERSHAVEA
BUNCHOFREALLYUSEFULSTATICMETHODS7EVEUSEDONEIN
THISBOOKBEFORE)NTEGERPARSE)NT
4HEPARSEMETHODSTAKEA3TRINGANDGIVEYOUBACKA
PRIMITIVEVALUE
H
&RQYHUWLQJD6WULQJWRD
1RSUREOHPWRSDUV
SULPLWLYHYDOXHLVHDV\ ´µLQ WR
Licensed by
6WULQJV ³´
LQW[ ,QWHJHUSDUVH,QWV
GRXEOHG 'RXEOHSDUVH'RXEOH³´
Eduard Simons
ERROHDQE QHZ%RROHDQ³WUXHÉRROHDQ9DOXH
<RX·GWKLQNWKH UHZRXOGEHDQ·W\RX"%XWWKHUH
DQZRXOG
%RROHDQSDUVH WHO\OHWKHUH·VD%RROHDQFRQVWUXFW\RRUX
% RR
LVQ·W) RU WX QD WKH Q
6WULQJDQG LQJLW
WKDWWDNHVS DQGSDUVHVDH E\XQZUDSS
YD OX
104038
LY H
MXVWJHWWKH ULPLW
%XWLI\RXWU\WRGRWKLV
8KRK7KLVFRPSLOHVMXVWILQHEXW
6WULQJW ³WZR´ DWUXQWLPHLWEORZVXS$Q\WKLQJ
LQW\ ,QWHJHUSDUVH,QWW WKDWFDQ·WEHSDUVHGDVDQXPEHU
ZLOOFDXVHD1XPEHU)RUPDW([FHSWLRQ
<RX·OOJHWDUXQWLPHH[FHSWLRQ
)LOH(GLW:LQGRZ+HOS&OXH
(YHU\PHWKRGRU
MDYD:UDSSHUV
FRQVWUXFWRUWKDWSDUVHV
([FHSWLRQLQWKUHDG³PDLQ´
D6WULQJFDQWKURZD
MDYDODQJ1XPEHU)RUPDW([FHSWLRQWZR 1XPEHU)RUPDW([FHSWLRQ
DWMDYDODQJ,QWHJHUSDUVH,QW,QWHJHUMDYD ,W·VDUXQWLPHH[FHSWLRQ
DWMDYDODQJ,QWHJHUSDUVH,QW,QWHJHUMDYD VR\RXGRQ·WKDYHWR
DW:UDSSHUVPDLQ:UDSSHUVMDYD KDQGOHRUGHFODUHLW
%XW\RXPLJKWZDQWWR
:H¶OOWDONDERXW([FHSWLRQVLQWKH
QH[WFKDSWHU
FKDSWHU
QXPEHUVDQGVWDWLFV
)VLVW_QVZM^MZ[M\]ZVQVOI
XZQUQ\Q^MV]UJMZQV\WI;\ZQVO
4HEREARESEVERALWAYSTOTURNANUMBERINTOA3TRING
4HEEASIESTISTOSIMPLYCONCATENATETHENUMBERTOAN
HG
EXISTING3TRING SHUDWRULVRYHUORDG
5HPHPEHUWKHQO¶\·RRYHUORDGHGRSHUDWRUDVD
GRXEOHG LQ-DYDWKHRWHQDWRU$Q\WKLQJDGGHGWRD
6WULQJGRXEOH6WULQJ ³´G 6WULQJFRQFD HV6WULQJLILHG
6WULQJEHFRP
GRXEOHG
6WULQJGRXEOH6WULQJ 'RXEOHWR6WULQJG
$QRWKHUZD\WRGRLWXVLQJDVWD
PHWKRGLQFODVV'RXEOH WLF
<HDK
EXWKRZGR,PDNHLW
ORRNOLNHPRQH\":LWKDGROODU :KHUH·VP\SULQWI
VLJQDQGWZRGHFLPDOSODFHV OLNH,KDYHLQ&",V
OLNHRUZKDWLI,ZDQW QXPEHUIRUPDWWLQJSDUWRI
FRPPDVOLNHRU WKH,2FODVVHV"
ZKDWLI,ZDQWLWLQ
\RXDUHKHUH
QXPEHUIRUPDWWLQJ
6]UJMZNWZUI\\QVO
)N*AVAFORMATTINGNUMBERSANDDATESDOESNTHAVETOBECOUPLEDWITH)/4HINK
ABOUTIT/NEOFTHEMOSTTYPICALWAYSTODISPLAYNUMBERSTOAUSERISTHROUGHA
'5)9OUPUT3TRINGSINTOASCROLLINGTEXTAREAORMAYBEATABLE)FFORMATTINGWAS
BUILTONLYINTOPRINTSTATEMENTSYOUDNEVERBEABLETOFORMATANUMBERINTOANICE
3TRINGTODISPLAYINA'5)"EFORE*AVAMOSTFORMATTINGWASHANDLEDTHROUGH
CLASSESINTHEJAVATEXTPACKAGETHATWEWONTEVENLOOKATINTHISVERSIONOFTHE
BOOKNOWTHATTHINGSHAVECHANGED
)N*AVATHE*AVATEAMADDEDMOREPOWERFULANDmEXIBLEFORMATTINGTHROUGHA
&ORMATTERCLASSINJAVAUTIL"UTYOUDONTNEEDTOCREATEANDCALLMETHODSONTHE
&ORMATTERCLASSYOURSELFBECAUSE*AVAADDEDCONVENIENCEMETHODSTOSOMEOF
THE)/CLASSESINCLUDINGPRINTF ANDTHE3TRINGCLASS3OITSASIMPLEMATTEROF
CALLINGASTATIC3TRINGFORMAT METHODANDPASSINGITTHETHINGYOUWANTFORMATTED
ALONGWITHFORMATTINGINSTRUCTIONS
/FCOURSEYOUDOHAVETOKNOWHOWTOSUPPLYTHEFORMATTINGINSTRUCTIONSAND
THATTAKESALITTLEEFFORTUNLESSYOUREFAMILIARWITHTHEPRINTF FUNCTIONIN##
&ORTUNATELYEVENIFYOUDONTKNOWPRINTF YOUCANSIMPLYFOLLOWRECIPESFORTHE
MOSTBASICTHINGSTHATWERESHOWINGINTHISCHAPTER "UTYOUWILLWANTTOLEARN
HOWTOFORMATIFYOUWANTTOMIXANDMATCHTOGETANYTHINGYOUWANT
7ELLSTARTHEREWITHABASICEXAMPLETHENLOOKATHOWITWORKS.OTEWELLREVISIT
FORMATTINGAGAININTHE)/CHAPTER
)RUPDWWLQJDQXPEHUWRXVHFRPPDV
PDWZH
SXEOLFFODVV7HVW)RUPDWV^
7KHQXPEHUWRYHIFRURPPDV
ZDQWLWWR KD

6WULQJV 6WULQJIRUPDW³G´
6\VWHPRXWSULQWOQV
`
` 7KHIR UPDWWLQJLQVWUXFWLRQVI
VHFRQGDUJXPHQWZ RUKRZW IRUPDWWKH
5HPHPEHUWKHUHDUHKLF KLQWKLVFDVHLVDQRLQ WYDOXH
KHUH³WKHILUVWFRPPDRQO\WZRDUJXPHQWVWRWKLVPHWKRG
LV,16,'(WKH6WULQJOL
LWLVQ·WVHSDUDWLQJDUJXP
HQWVWRWKHIRUPDWPHW WHUDOVR
KRG
1RZZHJHWFRPP
DV LQVHUWHGLQWRWKH
QXPEHU
FKDSWHU
QXPEHUVDQGVWDWLFV
.WZUI\\QVOLMKWV[\Z]K\ML
!TTHEMOSTBASICLEVELFORMATTINGCONSISTSOFTWOMAINPARTS
THEREISMOREBUTWELLSTARTWITHTHISTOKEEPITCLEANER
)RUPDWWLQJLQVWUXFWLRQV
<RXXVHVSHFLDOIRUPDWVSHFLILHUVWKDWGHVFULEHKRZ
\NQRZSULQWI
WKHDUJXPHQWVKRXOGEHIRUPDWWHG
1RWHLI\RXDOUHRXDGFDQSUREDEO\MXVW
IURPF&\IHZSDJHV2WKHUZLVH
7KHDUJXPHQWWREHIRUPDWWHG VNLPWKHQH[W
$OWKRXJKWKHUHFDQEHPRUHWKDQRQHDUJXPHQWZH·OO UHDGFDUHIXOO\
VWDUWZLWKMXVWRQH7KHDUJXPHQWW\SHFDQ·WEHMXVW
DQ\WKLQJLWKDVWREHVRPHWKLQJWKDWFDQEHIRUPDWWHG
XVLQJWKHIRUPDWVSHFLILHUVLQWKHIRUPDWWLQJLQVWUXFWLRQV
)RUH[DPSOHLI\RXUIRUPDWWLQJLQVWUXFWLRQVVSHFLI\D
IORDWLQJSRLQWQXPEHU\RXFDQ·WSDVVLQD'RJRUHYHQD
6WULQJWKDWORRNVOLNHDIORDWLQJSRLQWQXPEHU
'RWKLV WRWKLV

IRUPDW³G´
8VHWKHVHLQVWUXFWLRQVRQWKLVDUJXPHQW
:KDWGRWKHVHLQVWUXFWLRQVDFWXDOO\VD\"
h4AKETHESECONDARGUMENTTOTHISMETHODAND
FORMATITASADECIMALINTEGERANDINSERTCOMMASv
+RZGRWKH\VD\WKDW"
/NTHENEXTPAGEWELLLOOKINMOREDETAILATWHATTHESYNTAXh
DvACTUALLYMEANSBUTFORSTARTERSANYTIMEYOUSEETHEPERCENT
SIGN INAFORMAT3TRINGWHICHISALWAYSTHElRSTARGUMENT
TOAFORMAT METHOD THINKOFITASREPRESENTINGAVARIABLE
ANDTHEVARIABLEISTHEOTHERARGUMENTTOTHEMETHOD4HEREST
OFTHECHARACTERSAFTERTHEPERCENTSIGNDESCRIBETHEFORMATTING
INSTRUCTIONSFORTHEARGUMENT
\RXDUHKHUH
WKHIRUPDWPHWKRG
<PMXMZKMV\ [Ia[¹QV[MZ\IZO]UMV\PMZMº
IVLNWZUI\Q\][QVO\PM[MQV[\Z]K\QWV[
4HElRSTARGUMENTTOAFORMAT METHODISCALLEDTHEFORMAT3TRINGANDIT
CANACTUALLYINCLUDECHARACTERSTHATYOUJUSTWANTPRINTEDAS ISWITHOUTEXTRA
FORMATTING7HENYOUSEETHESIGNTHOUGHTHINKOFTHEPERCENTSIGNASA
VARIABLETHATREPRESENTSTHEOTHERARGUMENTTOTHEMETHOD
0RUHFKDUDFWHUVWR
)RUPDWVSHFLILHUVIRU LQFOXGHLQWKH6WULQ
LQ FO XGH LQ VH FRQGDUJXPHQWWRWKHWKH WKHVHFRQGDUJXPHQWJDIWHU
&KDUDFWHUVWR UHWXUQ HG PH WKRGWKHQXPEHU IRUPDWWHGDQGLQVHUWHLV
WKHILQDO6WULQJ $UJXPHQWWREH
IURPIRUPDW
G IRUPDWWHG
IRUPDW³,KDYHIEXJVWR¿[´
,KDYHEXJVWR¿[
2XWSXW
1RWLFHZHOR
DIWHUWKHGHVWFLVPDORPHRIWKHQXPEHUV
ZKDWWKHÍµP SRLQW&DQ\RXJXHVV
HDQV"
4HEhvSIGNTELLSTHEFORMATTERTOINSERTTHEOTHERMETHODARGUMENTTHE
SECONDARGUMENTTOFORMAT THENUMBER HERE!.$FORMATITUSINGTHE
hFvCHARACTERSAFTERTHEPERCENTSIGN4HENTHERESTOFTHEFORMAT3TRING
hBUGSTOlXvISADDEDTOTHElNALOUTPUT
$GGLQJDFRPPD
IRUPDW³,KDYHIEXJVWR¿[´
,KDYHEXJVWR¿[
%\FKDQJLQJWKHIRUPDWLQV WUXFWLRQV
ZH
IURPÍµWRIµQXPEHJRWD
FRPPDLQWKH IRU PDW WHG U
FKDSWHU
QXPEHUVDQGVWDWLFV
%XWKRZGRHVLWHYHQ.12:
ZKHUHWKHLQVWUXFWLRQVHQGDQGWKH
UHVWRIWKHFKDUDFWHUVEHJLQ"+RZFRPH
LWGRHVQ·WSULQWRXWWKHÍµLQÍµ"2U
WKH´µ"+RZGRHVLWNQRZWKDWWKHI
ZDVSDUWRIWKHLQVWUXFWLRQVDQG127
SDUWRIWKH6WULQJ"
<PMNWZUI\;\ZQVO][M[Q\[
W_VTQ\\TMTIVO]IOM[aV\I`
9OUOBVIOUSLYCANTPUTJUSTANYTHINGAFTERTHEhv
SIGN4HESYNTAXFORWHATGOESAFTERTHEPERCENT
SIGNFOLLOWSVERYSPECIlCRULESANDDESCRIBES
HOWTOFORMATTHEARGUMENTTHATGETSINSERTEDAT
THATPOINTINTHERESULTFORMATTED 3TRING
9OUVEALREADYSEENTWOEXAMPLES
DMEANShINSERTCOMMASANDFORMATTHE
NUMBERASADECIMALINTEGERv
AND
FMEANShFORMATTHENUMBERASAmOATING
POINTWITHAPRECISIONOFTWODECIMALPLACESv
AND
FMEANShINSERTCOMMASANDFORMATTHE
NUMBERASAmOATINGPOINTWITHAPRECISIONOF
TWODECIMALPLACESv
4HEREALQUESTIONISREALLYh(OWDO)KNOWWHAT
TOPUTAFTERTHEPERCENTSIGNTOGETITTODOWHAT
)WANTv!NDTHATINCLUDESKNOWINGTHESYMBOLS
LIKEhDvFORDECIMALANDhFvFORmOATINGPOINT
ASWELLASTHEORDERINWHICHTHEINSTRUCTIONS
MUSTBEPLACEDFOLLOWINGTHEPERCENTSIGN&OR
EXAMPLEIFYOUPUTTHECOMMAAFTERTHEhDvLIKE
THIShDvINSTEADOFhDvITWONTWORK
/RWILLIT7HATDOYOUTHINKTHISWILLDO
6WULQJIRUPDW³,KDYHIEXJVWR¿[´
7ELLANSWERTHATONTHENEXTPAGE
\RXDUHKHUH
IRUPDWVSHFLILHU
<PMNWZUI\[XMKQNQMZ
%VERYTHINGAFTERTHEPERCENTSIGNUPTOANDINCLUDINGTHETYPEINDICATORLIKE
hDvORhFv AREPARTOFTHEFORMATTINGINSTRUCTIONS!FTERTHETYPEINDICATORTHE
FORMATTERASSUMESTHENEXTSETOFCHARACTERSAREMEANTTOBEPARTOFTHEOUTPUT
3TRINGUNTILORUNLESSITHITSANOTHERPERCENT SIGN(MMMMISTHATEVEN
POSSIBLE#ANYOUHAVEMORETHANONEFORMATTEDARGUMENTVARIABLE0UTTHAT
THOUGHTONHOLDFORRIGHTNOWWELLCOMEBACKTOITINAFEWMINUTES&ORNOW
LETSLOOKATTHESYNTAXFORTHEFORMATSPECIlERSTHETHINGSTHATGOAFTERTHE
PERCENT SIGNANDDESCRIBEHOWTHEARGUMENTSHOULDBEFORMATTED
$IRUPDWVSHFLÀHUFDQKDYHXSWRÀYHGLIIHUHQWSDUWVQRW
LQFOXGLQJWKH´µ(YHU\WKLQJLQEUDFNHWV>@EHORZLVRSWLRQDOVR
RQO\WKHSHUFHQWDQGWKHW\SHDUHUHTXLUHG%XWWKHRUGHULV
DOVRPDQGDWRU\VRDQ\SDUWV\RX'2XVHPXVWJRLQWKLVRUGHU
>DUJXPHQWQXPEHU@>ÀDJV@>ZLGWK@>SUHFLVLRQ@W\SH
:H·OOJHWWRWK 7KLVGHILQHVWKH <RXDOUHDG\NQRLQH Z DQGDWRU\

LWOHWV\RXVD\:LV+,ODW&+HU 0,1,080QXPEHU WKLVRQH LW GHI V 7\SHLVP [WSDJH
DUJXPHQWLIWKHUH·VPR 7KHVHDUHIRUDWWLQJ VH H WK H QH
WKDQRQH'RQ·WZRUU UH VSHFLDOIRUP LQVHUWLQJ RIFKDUDFWHUVWKDW WKHSUHFLVLRQ,Q DQGZLOOXVXDOO\EH
DERXWLWMXVW\HW \ RSWLRQVOLNH XWWLQJ ZLOOEHXVHG7KDW·V RWKHUZRUGVLWU ´GµIRUDGHFLPDO
FRPPDVRUS EHUVLQ PLQLPXP QRW VHWVWKHQXPEH HJHURUÍµIRU
QHJDWLYHQXPRUWR 727$/,IWKHQXPEHU RIGHFLPDOSODFHV LQW D RDWLQJSRLQW
IO
SDUHQWKHVHV PEHUV LVORQJHUWKDQWKH 'RQ·WIRUJHWWR QXPEHU
PDNHWKHQXHG ZLGWKLW·OOVWLOOEHXVHG LQFOXGHWKH´µLQ
OHIWMXVWLIL LQIXOOEXWLILW·VOHVV WKHUH
WKDQWKHZLGWKLW·OOEH
SDGGHGZLWK]HURHV
>DUJXPHQWQXPEHU@>ÀDJV@>ZLGWK@>SUHFLVLRQ@W\SH
IRUPDW³I´
7KHUH·VQR´DUJXPHQW
VSHFLILHGLQWKLVIRUPDQXPEHUµ
EXWDOOWKHRWKHUSLHF W6WULQJ
HVDUHWKHUH
FKDSWHU
QXPEHUVDQGVWDWLFV
<PMWVTaZMY]QZML[XMKQNQMZQ[NWZ<A8-
!LTHOUGHTYPEISTHEONLYREQUIREDSPECIlERREMEMBERTHATIFYOUDOPUT
INANYTHINGELSETYPEMUSTALWAYSCOMELAST4HEREAREMORETHANADOZEN
DIFFERENTTYPEMODIlERSNOTINCLUDINGDATESANDTIMESTHEYHAVETHEIROWN
SET BUTMOSTOFTHETIMEYOULLPROBABLYUSEDDECIMAL ORFmOATING
POINT !NDTYPICALLYYOULLCOMBINEFWITHAPRECISIONINDICATORTOSETTHE
NUMBEROFDECIMALPLACESYOUWANTINYOUROUTPUT
7KH7<3(LVPDQGDWRU\HYHU\WKLQJHOVHLVRSWLRQDO You must include a

G GHFLPDO
type in your format
$ZRXOGQ
IRUPDW³G´ ZRXOGEHWKHVD RWZRUN,W instructions, and if you
GLUHFWO\DVVLJQDPHDVWU\LQJWR
LQWYDULDEOH GRXEOHWRDQ specify things besides
4HEARGUMENTMUSTBECOMPATIBLEWITHANINTSOTHATMEANS type, the type must
ONLYBYTESHORTINTANDCHARORTHEIRWRAPPERTYPES
always come last.
I ÁRDWLQJSRLQW
+HUHZHFRPELQHLQ GWKHÍµ Most of the time,
IRUPDW³I´
ZLWKD SUH FLV LRQ GLFDWRU
´µVRZHHQ GH G XS ZLWK youÕll probably format
WKUHH ]H UR HV
numbers using either
4HEARGUMENTMUSTBEOFAmOATINGPOINTTYPESOTHAT
MEANSONLYAmOATORDOUBLEPRIMITIVEORWRAPPER ASWELL ÒdÓ for decimal or ÒfÓ
ASSOMETHINGCALLED"IG$ECIMALWHICHWEDONTLOOKATIN
THISBOOK
for floating point.
[ KH[DGHFLPDO
IRUPDW³[´
D
4HEARGUMENTMUSTBEABYTESHORTINTLONGINCLUDING

BOTHPRIMITIVEANDWRAPPERTYPES AND"IG)NTEGER
F FKDUDFWHU
IRUPDW³F´ HVHQWV
7KHQXPEHUUHSU
WKHFKDU´ µ
4HEARGUMENTMUSTBEABYTESHORTCHARORINTINCLUDING

BOTHPRIMITIVEANDWRAPPERTYPES
\RXDUHKHUH
IRUPDWDUJXPHQWV
?PI\PIXXMV[QN1PI^MUWZM\PIVWVMIZO]UMV\'
)MAGINEYOUWANTA3TRINGTHATLOOKSLIKETHIS
h4HERANKISOUTOFv
"UTTHENUMBERSARECOMINGFROMVARIABLES7HATDOYOUDO9OUSIMPLYADDTWO
ARGUMENTSAFTERTHEFORMAT3TRINGlRSTARGUMENT SOTHATMEANSYOURCALLTOFORMAT
WILLHAVETHREEARGUMENTSINSTEADOFTWO!NDINSIDETHATlRSTARGUMENTTHEFORMAT
3TRING YOULLHAVETWODIFFERENTFORMATSPECIlERSTWOTHINGSTHATSTARTWITHhv 4HE
lRSTFORMATSPECIlERWILLINSERTTHESECONDARGUMENTTOTHEMETHODANDTHESECOND
FORMATSPECIlERWILLINSERTTHETHIRDARGUMENTTOTHEMETHOD)NOTHERWORDSTHE
VARIABLEINSERTIONSINTHEFORMAT3TRINGUSETHEORDERINWHICHTHEOTHERARGUMENTSARE
PASSEDINTOTHEFORMAT METHOD
LQWRQH
GRXEOHWZR
6WULQJV 6WULQJIRUPDW³7KHUDQNLVGRXWRII´RQHWZR
:KHQ\RXKD
7KHUDQNLVRXWRI
DUJXPHQWWKHYH\·PUHRUHWKDQRQH
XVLQJWKHRUGHULQ LQVHUWHG
SDVVWKHPW ZKLFK\RX
:HDGGHGFRPPDVWRERWKYDULDEOHV
DQGUHVWULFWHGWKHIORDWLQJSRLQW PHWKRG RWKHIRUPDW
QXPEHUWKHVHFRQGYDULDEOHWRWZR
GHFLPDOSODFHV
!SYOULLSEEWHENWEGETTODATEFORMATTINGYOUMIGHTACTUALLYWANTTOAPPLYDIFFERENT
FORMATTINGSPECIlERSTOTHESAMEARGUMENT4HATSPROBABLYHARDTOIMAGINEUNTILYOU
SEEHOWDATEFORMATTINGASOPPOSEDTOTHENUMBERFORMATINGWEVEBEENDOING WORKS
*USTKNOWTHATINAMINUTEYOULLSEEHOWTOBEMORESPECIlCABOUTWHICHFORMAT
SPECIlERSAREAPPLIEDTOWHICHARGUMENTS
Q: 5MTHERESSOMETHING2%!,,9STRANGEGOINGONHERE*USTHOWMANYARGUMENTSCAN)
PASS)MEANHOWMANYOVERLOADEDFORMAT METHODSARE).THE3TRINGCLASS3OWHATHAPPENS
IF)WANTTOPASSSAYTENDIFFERENTARGUMENTSTOBEFORMATTEDFORASINGLEOUTPUT3TRING
A: 'OODCATCH9ESTHEREISSOMETHINGSTRANGEORATLEASTNEWANDDIFFERENT GOINGONAND

NOTHEREARENOTABUNCHOFOVERLOADEDFORMAT METHODSTOTAKEADIFFERENTNUMBEROFPOSSIBLE
ARGUMENTS)NORDERTOSUPPORTTHISNEWFORMATTINGPRINTF LIKE !0)IN*AVATHELANGUAGENEEDED
ANOTHERNEWFEATUREVARIABLEARGUMENTLISTSCALLEDVARARGSFORSHORT 7ELLTALKABOUTVARARGS
ONLYINTHEAPPENDIXBECAUSEOUTSIDEOFFORMATTINGYOUPROBABLYWONTUSETHEMMUCHINAWELL
DESIGNEDSYSTEM
FKDSWHU
QXPEHUVDQGVWDWLFV
;WU]KPNWZV]UJMZ[_PI\IJW]\LI\M['
)MAGINEYOUWANTA3TRINGTHATLOOKSLIKETHISh3UNDAY.OVv
.OTHINGSPECIALTHEREYOUSAY7ELLIMAGINETHATALLYOUHAVETOSTARTWITHISAVARIABLE
OFTYPE$ATE!*AVACLASSTHATCANREPRESENTATIMESTAMPANDNOWYOUWANTTOTAKETHAT
OBJECTASOPPOSEDTOANUMBER ANDSENDITTHROUGHTHEFORMATTER
4HEMAINDIFFERENCEBETWEENNUMBERANDDATEFORMATTINGISTHATDATEFORMATSUSEA
TWO CHARACTERTYPETHATSTARTSWITHhTvASOPPOSEDTOTHESINGLECHARACTERhFvORhDvFOR
EXAMPLE 4HEEXAMPLESBELOWSHOULDGIVEYOUAGOODIDEAOFHOWITWORKS
7KHFRPSOHWHGDWHDQGWLPH WF
6WULQJIRUPDW³WF´QHZ'DWH
6XQ1RY067
-XVWWKHWLPH WU
6WULQJIRUPDW³WU´QHZ'DWH
30
'D\RIWKHZHHNPRQWKDQGGD\ W$W%WG
4HEREISNTASINGLEFORMATSPECIlERTHATWILLDOEXACTLYWHATWE
%XWWKDWP
SDVVWKH'DWHDHQVREZHKDYHWR
WANTSOWEHAVETOCOMBINETHREEOFTHEMFORDAYOFTHEWEEK
T! MONTHT" ANDDAYOFTHEMONTHTD
WLPHVRQHIRUHDFMHFWLQWKUHH
'DWHWRGD\ QHZ'DWH
IR UPDWWKDWZHZK DQ
SDUWRIWKH
ZRUGVWKHW$Z W,QRWKHU
6WULQJIRUPDW³W$W%WG´WRGD\WRGD\WRGD\ WKHGD\RIWKH LOOJLYHXVMXVW
Z HH
ZHKDYHWRGRLW NEXWWKHQ
7KHFRPPDLVQRWSDUWRIWKHIRUPDWWLQJLW·V
MXVWWKHFKDUDFWHUZHZDQWSULQWHGDIWHUWKH MX VWWKHPRQWKDQGDJDLQWRJHW
ILUVWLQVHUWHGIRUPDWWHGDUJXPHQW GD\RIWKHPRQWK DJDLQIRUWKH

6XQGD\1RYHPEHU
6DPHDVDERYHEXWZLWKRXWGXSOLFDWLQJWKHDUJXPHQWV W$W%WG
'DWHWRGD\ QHZ'DWH 7KHDQJOHEUDFNHW´µLVMXVWDQRWKHU
6WULQJIRUPDW³W$W%WG´WRGD\ IODJLQWKHVSHFLILHUWKDWWHOOVWKH
IRUPDWWHUWR´XVHWKHSUHYLRXVDUJXPHQW
<RXFDQWKLQNRIWKLVDVNLQGRIOLNHFDOOLQJWKUHH DJDLQµ6RLWVDYHV\RXIURPUHSHDWLQJWKH
GLIIHUHQWJHWWHUPHWKRGVRQWKH'DWHREMHFWWR DUJXPHQWVDQGLQVWHDG\RXIRUPDWWKH
JHWWKUHHGLIIHUHQWSLHFHVRIGDWDIURPLW VDPHDUJXPHQWWKUHHGLIIHUHQWZD\V
\RXDUHKHUH
PDQLSXODWLQJGDWHV
/HW·VVHHKRZPDQ\ZRUN
GD\VZLOOWKHUHEHLIWKH
SURMHFWVWDUWVRQ)HEWKDQG
HQGVRQ$XJXVWWK"
Licensed by
?WZSQVO_Q\P,I\M[
9OUNEEDTODOMOREWITHDATESTHANJUSTGET
TODAYSDATE9OUNEEDYOURPROGRAMSTOADJUST
Eduard Simons
DATESlNDELAPSEDTIMESPRIORITIZESCHEDULES
HECKMAKESCHEDULES9OUNEEDINDUSTRIAL
STRENGTHDATEMANIPULATIONCAPABILITIES
9OUCOULDMAKEYOUROWNDATEROUTINESOF
104038
COURSEANDDONTFORGETABOUTLEAPYEARS
!NDOUCHTHOSEOCCASIONALPESKYLEAP
SECONDS7OWTHISCOULDGETCOMPLICATED4HE
GOODNEWSISTHATTHE*AVA!0)ISRICHWITH
CLASSESTHATCANHELPYOUMANIPULATEDATES
3OMETIMESITFEELSALITTLETOORICH
FKDSWHU
QXPEHUVDQGVWDWLFV
5W^QVOJIKS_IZLIVLNWZ _IZLQV\QUM
,ETSSAYYOURCOMPANYSWORKSCHEDULEIS-ONDAYTHROUGH&RIDAY
9OUVEBEENASSIGNEDTHETASKOFlGURINGOUTTHELASTWORKDAYIN
EACHCALENDARMONTHTHISYEAR
,WVHHPVWKDWMDYDXWLO'DWHLVDFWXDOO\RXWRIGDWH
For a time-stamp of ÒnowÓ,
%ARLIERWEUSEDJAVAUTIL$ATETOlNDTODAYSDATESOITSEEMS
use Date. But for everything
LOGICALTHATTHISCLASSWOULDBEAGOODPLACETOSTARTLOOKINGFOR else, use Calendar.
SOMEHANDYDATEMANIPULATIONCAPABILITIESBUTWHENYOUCHECK
OUTTHE!0)YOULLlNDTHATMOSTOF$ATESMETHODSHAVEBEEN
DEPRECATED
4HE$ATECLASSISSTILLGREATFORGETTINGAhTIMESTAMPvANOBJECT
THATREPRESENTSTHECURRENTDATEANDTIMESOUSEITWHENYOUWANT
TOSAYhGIVEME./7v
4HEGOODNEWSISTHATTHE!0)RECOMMENDSJAVAUTIL#ALENDAR
INSTEADSOLETSTAKEALOOK
8VHMDYDXWLO&DOHQGDUIRU\RXUGDWHPDQLSXODWLRQ
4HEDESIGNERSOFTHE#ALENDAR!0)WANTEDTOTHINKGLOBALLY
LITERALLY4HEBASICIDEAISTHATWHENYOUWANTTOWORKWITHDATES
YOUASKFORA#ALENDARTHROUGHASTATICMETHODOFTHE#ALENDAR
CLASSTHATYOULLSEEONTHENEXTPAGE ANDTHE*6-HANDSYOUBACK
ANINSTANCEOFACONCRETESUBCLASSOF#ALENDAR#ALENDARISACTUALLY
ANABSTRACTCLASSSOYOUREALWAYSWORKINGWITHACONCRETESUBCLASS
-OREINTERESTINGTHOUGHISTHATTHEKINDOFCALENDARYOUGET
BACKWILLBEAPPROPRIATEFORYOURLOCALE-UCHOFTHEWORLDUSESTHE
'REGORIANCALENDARBUTIFYOUREINANAREATHATDOESNTUSEA
'REGORIANCALENDARYOUCANGET*AVALIBRARIESTOHANDLEOTHER
CALENDARSSUCHAS"UDDHISTOR)SLAMICOR*APANESE
4HESTANDARD*AVA!0)SHIPSWITHJAVAUTIL'REGORIAN#ALENDARSO
THATSWHATWELLBEUSINGHERE&ORTHEMOSTPARTTHOUGHYOU
DONTEVENHAVETOTHINKABOUTTHEKINDOF#ALENDARSUBCLASSYOURE
USINGANDINSTEADFOCUSONLYONTHEMETHODSOFTHE#ALENDARCLASS
\RXDUHKHUH
JHWWLQJD&DOHQGDU
/M\\QVOIVWJRMK\\PI\M`\MVL[+ITMVLIZ
(OWINTHEWORLDDOYOUGETANhINSTANCEvOFANABSTRACTCLASS
7ELLYOUDONTOFCOURSETHISWONTWORK
7KLV:21·7ZRUN
7KHFRPSLOHUZRQ·WDOORZWKLV
&DOHQGDUFDO QHZ&DOHQGDU
,QVWHDGXVHWKHVWDWLF´JHW,QVWDQFHµPHWKRG
&DOHQGDUFDO &DOHQGDUJHW,QVWDQFH
7KLVV\QWD[VKRXOGORRNIDPLOLDUDWWKLV
SRLQWZH·UHLQYRNLQJDVWDWLFPHWKRG
:DLWDPLQXWH
,I\RXFDQ·WPDNHDQ
LQVWDQFHRIWKH&DOHQGDU
FODVVZKDWH[DFWO\DUH\RX
DVVLJQLQJWRWKDW&DOHQGDU
UHIHUHQFH"
<RXFDQ·WJHWDQLQVWDQFHRI&DOHQGDU
EXW\RXFDQFDQJHWDQLQVWDQFHRID
FRQFUHWH&DOHQGDUVXEFODVV
/BVIOUSLYYOUCANTGETANINSTANCEOF#ALENDARBECAUSE
#ALENDARISABSTRACT"UTYOURESTILLFREETOCALLSTATICMETHODS
ON#ALENDARSINCESTATICMETHODSARECALLEDONTHECLASS
RATHERTHANONAPARTICULARINSTANCE3OYOUCALLTHESTATIC
GET)NSTANCE ON#ALENDARANDITGIVESYOUBACKANINSTANCE
OFACONCRETESUBCLASS3OMETHINGTHATEXTENDS#ALENDAR
WHICHMEANSITCANBEPOLYMORPHICALLYASSIGNEDTO#ALENDAR
ANDWHICHBYCONTRACTCANRESPONDTOTHEMETHODSOFCLASS
#ALENDAR
)NMOSTOFTHEWORLDANDBYDEFAULTFORMOSTVERSIONSOF*AVA
YOULLBEGETTINGBACKAJAVAUTIL'REGORIAN#ALENDARINSTANCE
FKDSWHU
QXPEHUVDQGVWDWLFV
?WZSQVO_Q\P+ITMVLIZWJRMK\[
4HEREARESEVERALKEYCONCEPTSYOULLNEEDTOUNDERSTANDIN
ORDERTOWORKWITH#ALENDAROBJECTS
&IELDSHOLDSTATE !#ALENDAROBJECTHASMANYlELDSTHATAREUSEDTO
REPRESENTASPECTSOFITSULTIMATESTATEITSDATEANDTIME&ORINSTANCEYOU
CANGETANDSETA#ALENDARSYEARORMONTH
$ATESAND4IMESCANBEINCREMENTED 4HE#ALENDARCLASSHASMETHODSTHAT
ALLOWYOUTOADDANDSUBTRACTVALUESFROMVARIOUSlELDSFOREXAMPLEhADD
ONETOTHEMONTHvORhSUBTRACTTHREEYEARSv
$ATESAND4IMESCANBEREPRESENTEDINMILLISECONDS 4HE#ALENDARCLASS
LETSYOUCONVERTYOURDATESINTOANDOUTOFAMILLISECONDREPRESENTATION
3PECIlCALLYTHENUMBEROFMILLISECONDSTHATHAVEOCCUREDSINCE*ANUARY
ST 4HISALLOWSYOUTOPERFORMPRECISECALCULATIONSSUCHAShELAPSED
TIMEBETWEENTWOTIMESvORhADDHOURSANDMINUTESANDSECONDS
TOTHISTIMEv
$QH[DPSOHRIZRUNLQJZLWKD&DOHQGDUREMHFW
DW
R-DQ EDVHG
&DOHQGDUF &DOHQGDUJHW,QVWDQFH 6HWWLPHWWKHPRQWKLV]HUR
1RWLFH
FVHW
&RQYHUWWKLVWR DELJRO·
V
ORQJGD\ FJHW7LPH,Q0LOOLV DPRXQWRIPLOOLVHFRQG
GD\
$GGDQKRXU·VZRUWKRIPLOOLVWKHQXSGDWHWKHWLPH
FVHW7LPH,Q0LOOLVGD\ 1RWLFHWKH´ µLW·VOLNHGD\ GD\
6\VWHPRXWSULQWOQ³QHZKRXU³FJHWF+285B2)B'$<
FDGGF'$7( $GGGD\VWRWKHGDWHZKLFK
VKRXOGPRYHXVLQWR)HEUXDU\
6\VWHPRXWSULQWOQ³DGGGD\V³FJHW7LPH
FUROOF'$7(
´5ROOµGD\VRQWRWKLVGDWH7KLV
6\VWHPRXWSULQWOQ³UROOGD\V³FJHW7LPH ÚROOVµWKHGDWHDKHDGGD\VEXW
'2(6127FKDQJHWKHPRQWK
FVHWF'$7(
6\VWHPRXWSULQWOQ³VHWWR³FJHW7LPH :H·UHQRWLQ
GRLQJD´VHWµFURIHPWHQWLQJKHUHMXVW
KHGDWH
)LOH(GLW:LQGRZ+HOS7LPH)OLHV
QHZKRXU
DGGGD\V:HG)HE067 7KLVRXWSXWFRQILUPVKRZPLOOLV
UROOGD\V7XH)HE067 DGGUROODQGVHWZRUN
VHWWR6XQ)HE067
\RXDUHKHUH
&DOHQGDU$3,
0QOPTQOP\[WN\PM+ITMVLIZ)81
7EJUSTWORKEDTHROUGHUSINGAFEWOFTHElELDSAND
METHODSINTHE#ALENDARCLASS4HISISABIG!0)SO
WERESHOWINGONLYAFEWOFTHEMOSTCOMMONlELDS
ANDMETHODSTHATYOULLUSE/NCEYOUGETAFEWOF
THESEITSHOULDBEPRETTYEASYTOBENDTHERESTOFTHE
THIS!0)TOYOURWILL
+EY#ALENDAR-ETHODS
ADDINTlELDINTAMOUNT NDAR SFIELD

!DDSORSUBTRACTSTIMEFROMTHECALE

GETINTlELD
DARFIELD
2ETURNSTHEVALUEOFTHEGIVENCALEN
GET)NSTANCE
ALOCALE
2ETURNSA#ALENDARYOUCANSPECIFY
+EY#ALENDAR&IE
GET4IME)N-ILLIS LD S
LONG
2ETU RNSTHIS#ALENDARSTIMEINMILLISASA
$!4%$!9?/&?
-/.4(
ROLLINTlELDBOOLEANUP 'ETSETTHEDAYO
FMONTH
INGLARGERFIELDS
!DDSORSUBTRACTSTIMEWITHOUTCHANG
(/52(/52?/
&?$!9
SETINTlELDINTVALUE 'ETSETTHEHO
URORHOURVALUE
IELD
3ETSTHEVALUEOFAGIVEN#ALENDARF
-),,)3%#/.$
TE ALLINTS
SETYEARMONTHDAYHOURMINU 'ETSETTHEMILLI
SECONDS
MPLETETIME
!COMMONVARIETYOFSETTOSETACO
-).54%
SET4IME)N-ILLISLONGMILLIS 'ETSETTHEMINU
TE
NGMILLI TIME
3ETSA#ALENDARSTIMEBASEDONALO
-/.4(
MORE 'ETSETTHEMON
TH
9%!2
'ETSETTHEYEAR
:/.%?/&&3%4
'ETSETRAWOFFSE
TOF'-4INMILLIS
MORE
FKDSWHU
QXPEHUVDQGVWDWLFV
-^MVUWZM;\I\QK[ [\I\QKQUXWZ\[
.EWTO*AVAAREALMIXEDBLESSING3OMEPEOPLELOVE
THISIDEASOMEPEOPLEHATEIT3TATICIMPORTSEXISTONLYTOSAVE
YOUSOMETYPING)FYOUHATETOTYPEYOUMIGHTJUSTLIKETHIS
FEATURE4HEDOWNSIDETOSTATICIMPORTSISTHAT IFYOURENOT
CAREFUL USINGTHEMCANMAKEYOURCODEALOTHARDERTOREAD
4HEBASICIDEAISTHATWHENEVERYOUREUSINGASTATICCLASSA
STATICVARIABLEORANENUMMOREONTHOSELATER YOUCAN
IMPORTTHEMANDSAVEYOURSELFSOMETYPING Use Carefully:
static imports can
6RPHROGIDVKLRQHGFRGH make your code
LPSRUWMDYDODQJ0DWK confusing to read
FODVV1R6WDWLF^
6\VWHPRXWSULQWOQ³VTUW³0DWKVTUW
6\VWHPRXWSULQWOQ³WDQ³0DWKWDQ

VHZKHUQWV
`
[ W R X
WD R
` 7KHV\UQLQJVWDWLFLPS
GH F OD
6DPHFRGHZLWKVWDWLFLPSRUWV
LPSRUWVWDWLFMDYDODQJ6\VWHPRXW ;Yn]Ylk?gl[`Yk
LPSRUWVWDWLFMDYDODQJ0DWK ,I\RX·UHRQO\JRLQJWRXVHDVWDWLFPHPEHU
DIHZWLPHVZHWKLQN\RXVKRXOGDYRLG
FODVV:LWK6WDWLF^ VWDWLFLPSRUWVWRKHOSNHHSWKHFRGHPRUH
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ UHDGDEOH
,I\RX·UHJRLQJWRXVHDVWDWLFPHPEHUDORW
RXWSULQWOQ³VTUW³VTUW
OLNHGRLQJORWVRI0DWKFDOFXODWLRQVWKHQ
RXWSULQWOQ³WDQ³WDQ LW·VSUREDEO\2.WRXVHWKHVWDWLFLPSRUW
` 1RWLFHWKDW\RXFDQXVHZLOGFDUGV LQ

\RXUVWDWLFLPSRUWGHFODUDWLRQ
`
$ELJLVVXHZLWKVWDWLFLPSRUWVLVWKDWLW·V
QRWWRRKDUGWRFUHDWHQDPLQJFRQIOLFWV)RU
6WDWLFLPSRUWVLQDFWLRQ H[DPSOHLI\RXKDYHWZRGLIIHUHQWFODVVHV
ZLWKDQ´DGGµPHWKRGKRZZLOO\RXDQG
WKHFRPSLOHUNQRZZKLFKRQHWRXVH"
\RXDUHKHUH
VWDWLFYVLQVWDQFH
<WVQOP\¼[<ITS")VQV[\IVKMÎZQIJTM
\ISM[KPMIX[PW\[I\I[\I\QKÎZQIJTM
1V[\IVKM>IZQIJTM ;\I\QK>IZQIJTM
)DONTEVENKNOWWHYWEREDOINGTHIS
%VERYONEKNOWSSTATICVARIABLESAREJUSTUSED
FORCONSTANTS!NDHOWMANYOFTHOSEARE
THERE)THINKTHEWHOLE!0)MUSTHAVEWHAT
FOUR!NDITSNOTLIKEANYBODYEVERUSES
THEM
9OUREALLYSHOULDCHECKYOURFACTS7HEN
WASTHELASTTIMEYOULOOKEDATTHE!0))TS
FRICKINLOADEDWITHSTATICS)TEVENHASENTIRE
CLASSESDEDICATEDTOHOLDINGCONSTANTVALUES
4HERESACLASSCALLED3WING#ONSTANTSFOR
EXAMPLETHATSJUSTFULLOFTHEM
&ULLOFIT9EAHYOUCANSAYTHATAGAIN/+
SOTHEREAREAFEWINTHE3WINGLIBRARYBUT
EVERYBODYKNOWS3WINGISJUSTASPECIALCASE )TMIGHTBEASPECIALCASEBUTITSAREALLY
IMPORTANTONE!NDWHATABOUTTHE#OLOR
CLASS7HATAPAINIFYOUHADTOREMEMBERTHE
2'"VALUESTOMAKETHESTANDARDCOLORS"UT
THECOLORCLASSALREADYHASCONSTANTSDElNED
FORBLUEPURPLEWHITEREDETC6ERYHANDY
/KBUTBESIDESAFEW'5)THINGSGIVEMEAN
EXAMPLEOFJUSTONESTATICVARIABLETHATANYONE
WOULDACTUALLYUSE)NTHEREALWORLD (OWS3YSTEMOUTFORSTARTERS4HEOUTIN
3YSTEMOUTISASTATICVARIABLEOFTHE3YSTEM
CLASS9OUPERSONALLYDONTMAKEANEW
INSTANCEOFTHE3YSTEMYOUJUSTASKTHE3YSTEM
CLASSFORITSOUTVARIABLE
7ELLTHATSANOTHERSPECIALCASE!NDNOBODY
USESTHATEXCEPTFORDEBUGGINGANYWAY
/HLIKEDEBUGGINGISNTIMPORTANT
!NDHERESSOMETHINGTHATPROBABLYNEVER
CROSSEDYOURNARROWMINDLETSFACEITSTATIC
VARIABLESAREMOREEFlCIENT/NEPERCLASS
INSTEADOFONEPERINSTANCE4HEMEMORY
SAVINGSMIGHTBEHUGE
FKDSWHU
QXPEHUVDQGVWDWLFV
1V[\IVKM>IZQIJTM ;\I\QK>IZQIJTM
5MARENTYOUFORGETTINGSOMETHING
7HAT
3TATICVARIABLESAREABOUTASUN //ASITGETS
'EEWHYNOTJUSTGOTAKEAGIANTBACKWARDS
STEPANDDOSOMEPROCEDURALPROGRAMMING
WHILEWEREATIT
7HATDOYOUMEANUN //
9OURELIKEAGLOBALVARIABLEANDANY
PROGRAMMERWORTHHIS0$!KNOWSTHATS
USUALLYA"AD4HING
)AM./4AGLOBALVARIABLE4HERESNOSUCH
THING)LIVEINACLASS4HATSPRETTY//YOU
KNOWA#,!33)MNOTJUSTSITTINGOUTTHERE
INSPACESOMEWHERE)MANATURALPARTOFTHE
STATEOFANOBJECTTHEONLYDIFFERENCEISTHAT
)MSHAREDBYALLINSTANCESOFACLASS6ERY
EFlCIENT
9EAHYOULIVEINACLASSBUTTHEYDONTCALL
IT#LASS /RIENTEDPROGRAMMING4HATSJUST
STUPID9OUREARELIC3OMETHINGTOHELPTHE
OLD TIMERSMAKETHELEAPTOJAVA !LRIGHTJUSTSTOPRIGHTTHERE4(!4IS
DElNITELYNOTTRUE3OMESTATICVARIABLESARE
ABSOLUTELYCRUCIALTOASYSTEM!NDEVENTHE
ONESTHATARENTCRUCIALSUREAREHANDY
7ELL/+EVERYONCEINAWHILESUREITMAKES

SENSETOUSEASTATICBUTLETMETELLYOUABUSE
OFSTATICVARIABLESANDMETHODS ISTHEMARK
OFANIMMATURE//PROGRAMMER!DESIGNER
SHOULDBETHINKINGABOUTOBJECTSTATENOTCLASS
STATE 7HYDOYOUSAYTHAT!NDWHATSWRONGWITH
STATICMETHODS
3TATICMETHODSARETHEWORSTTHINGSOFALL
BECAUSEITUSUALLYMEANSTHEPROGRAMMERIS
THINKINGPROCEDURALLYINSTEADOFABOUTOBJECTS
DOINGTHINGSBASEDONTHEIRUNIQUEOBJECT 3URE)KNOWTHATOBJECTSSHOULDBETHEFOCUS
STATE OFAN//DESIGNBUTJUSTBECAUSETHEREARE
SOMECLUELESSPROGRAMMERSOUTTHEREDONT
THROWTHEBABYOUTWITHTHEBYTECODE4HERES
ATIMEANDPLACEFORSTATICSANDWHENYOU
NEEDONENOTHINGELSEBEATSIT
2IIIIIIGHT7HATEVERYOUNEEDTOTELLYOURSELF
\RXDUHKHUH
EHWKHFRPSLOHU
"%THECOMPILER
7KH-DYDILOHRQWKLVSDJHUHSUHVHQWVD
1dQÔU_Q FRPSOHWHSURJUDP<RXUMRELVWRSOD\
FRPSLOHUDQGGHWHUPLQHZKHWKHUWKLV
ILOHZLOOFRPSLOH,ILWZRQ·WFRPSLOH
KRZZRXOG\RXIL[LWDQG
LILWGRHVFRPSLOHZKDW
FODVV6WDWLF6XSHU^
ZRXOGEHLWVRXWSXW"
VWDWLF^
6\VWHPRXWSULQWOQ´VXSHUVWDWLFEORFNµ
`

6WDWLF6XSHU^ )FITCOMPILESWHICHOFTHESEIS
6\VWHPRXWSULQWOQ THEOUTPUT
´VXSHUFRQVWUXFWRUµ
` 0OSSIBLE/UTPUT
` )LOH(GLW:LQGRZ+HOS&OLQJ
MDYD6WDWLF7HVWV
VWDWLFEORFN
SXEOLFFODVV6WDWLF7HVWVH[WHQGV6WDWLF6XSHU^
LQPDLQ
VWDWLFLQWUDQG
VXSHUVWDWLFEORFN
VXSHUFRQVWUXFWRU
VWDWLF^
FRQVWUXFWRU
UDQG LQW0DWKUDQGRP
6\VWHPRXWSULQWOQ´VWDWLFEORFNÚDQG
`
6WDWLF7HVWV^ 0OSSIBLE/UTPUT
6\VWHPRXWSULQWOQ´FRQVWUXFWRUµ )LOH(GLW:LQGRZ+HOS(OHFWULFLW\
` MDYD6WDWLF7HVWV
VXSHUVWDWLFEORFN
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ VWDWLFEORFN
LQPDLQ
6\VWHPRXWSULQWOQ´LQPDLQµ
VXSHUFRQVWUXFWRU
6WDWLF7HVWVVW QHZ6WDWLF7HVWV
FRQVWUXFWRU
`
`
FKDSWHU
QXPEHUVDQGVWDWLFV
1dQÔU_Q 4HISCHAPTEREXPLOREDTHEWONDERFULSTATICWORLD

OF*AVA9OURJOBISTODECIDEWHETHEREACHOFTHE
FOLLOWINGSTATEMENTSISTRUEORFALSE
&=[^N X[ /JU\N'
4OUSETHE-ATHCLASSTHElRSTSTEPISTOMAKEANINSTANCEOFIT
9OUCANMARKACONSTRUCTORWITHTHEVWDWLFKEYWORD
3TATICMETHODSDONTHAVEACCESSTOINSTANCEVARIABLESTATEOFTHE@THISOBJECT
)TISGOODPRACTICETOCALLASTATICMETHODUSINGAREFERENCEVARIABLE
3TATICVARIABLESCOULDBEUSEDTOCOUNTTHEINSTANCESOFACLASS
#ONSTRUCTORSARECALLEDBEFORESTATICVARIABLESAREINITIALIZED
-!8?3):%WOULDBEAGOODNAMEFORASTATIClNALVARIABLE
!STATICINITIALIZERBLOCKRUNSBEFOREACLASSSCONSTRUCTORRUNS
)FACLASSISMARKEDlNALALLOFITSMETHODSMUSTBEMARKEDlNAL
!lNALMETHODCANONLYBEOVERRIDDENIFITSCLASSISEXTENDED
4HEREISNOWRAPPERCLASSFORBOOLEANPRIMITIVES
!WRAPPERISUSEDWHENYOUWANTTOTREATAPRIMITIVELIKEANOBJECT
4HEPARSE8XXMETHODSALWAYSRETURNA3TRING
&ORMATTINGCLASSESWHICHAREDECOUPLEDFROM)/ AREINTHEJAVAFORMAT
PACKAGE
\RXDUHKHUH
FRGHPDJQHWV
Lunar Code Magnets

4HISONEMIGHTACTUALLYBEUSEFUL)NADDITIONTOWHATYOUVELEARNEDINTHELASTFEW
PAGESABOUTMANIPULATINGDATESYOULLNEEDALITTLEMOREINFORMATION&IRSTFULL
MOONSHAPPENEVERYDAYSORSO3ECONDTHEREWASAFULLMOONON*ANTH
9OURJOBISTORECONSTRUCTTHECODESNIPPETSTOMAKEAWORKING*AVAPROGRAM
THATPRODUCESTHEOUTPUTLISTEDBELOWPLUSMOREFULLMOONDATES 9OUMIGHTNOT
NEEDALLOFTHEMAGNETSANDADDALLTHECURLYBRACESYOUNEED /HBYTHEWAYYOUR
OUTPUTWILLBEDIFFERENTIFYOUDONTLIVEINTHEMOUNTAINTIMEZONE
ORQJGD\ FJHW7LPH,Q0LOOLV
FVHW
HPRXW
MDYDODQJ6\VW
LPSRUWVWDWLF
Licensed by

VWDWLFLQW'$<B,0
³IXOOPRRQRQWF´F
FIRUPDW
&DOHQGDU
Eduard Simons
F QHZ
&DOHQ GDU
V^
FODVV)XOO0RRQ
104038 GD\ '$<B,0
IRULQW[ [[^

VWDWLFL
QW'$<B,
0

SULQWOQ
LPSRUWMDYDLR

³IXOOPRRQRQW´F
LPSRUWMDYDXWLO

VWDWLFLPSRUWMDYDODQJ6\VWHPRXW
FVHW RXWSULQWOQ

)LOH(GLW:LQGRZ+HOS+RZO
MDYD)XOO0RRQV FVHW7L
PH,Q0LOO
LVGD\
IXOOPRRQRQ)UL)HE067 6WULQJIRUPDW
IXOOPRRQRQ6DW0DU067
IXOOPRRQRQ0RQ$SU0'7 &DOHQGDUF &DOHQGDUJHW,QVWDQFH
FKDSWHU
QXPEHUVDQGVWDWLFV
%XERCISE3OLUTIONS 7UXHRU)DOVH
4OUSETHE-ATHCLASSTHElRSTSTEPISTO )DOVH

MAKEANINSTANCEOFIT
9OUCANMARKACONSTRUCTORWITHTHEKEY )DOVH
WORD@STATIC
3TATICMETHODSDONTHAVEACCESSTOAN 7UXH
OBJECTSINSTANCEVARIABLES
)TISGOODPRACTICETOCALLASTATICMETHOD )DOVH
USINGAREFERENCEVARIABLE
3TATICVARIABLESCOULDBEUSEDTOCOUNTTHE 7UXH
"%THECOMPILER INSTANCESOFACLASS
#ONSTRUCTORSARECALLEDBEFORESTATICVARI )DOVH
6WDWLF6XSHU^
ABLESAREINITIALIZED
6\VWHPRXWSULQWOQ -!8?3):%WOULDBEAGOODNAMEFORA 7UXH
´VXSHUFRQVWUXFWRUµ STATIClNALVARIABLE
` !STATICINITIALIZERBLOCKRUNSBEFOREACLASSS 7UXH
CONSTRUCTORRUNS
6WDWLF6XSHULVDFRQVWUXFWRUDQGPXVW )FACLASSISMARKEDlNALALLOFITSMETHODS )DOVH
KDYHLQLWVVLJQDWXUH1RWLFHWKDWDV
WKHRXWSXWEHORZGHPRQVWUDWHVWKHVWDWLF MUSTBEMARKEDlNAL
EORFNVIRUERWKFODVVHVUXQEHIRUHHLWKHU !lNALMETHODCANONLYBEOVERRIDDENIF )DOVH
RIWKHFRQVWUXFWRUVUXQ
ITSCLASSISEXTENDED
4HEREISNOWRAPPERCLASSFORBOOLEAN )DOVH
0OSSIBLE/UTPUT PRIMITIVES
)LOH(GLW:LQGRZ+HOS&OLQJ !WRAPPERISUSEDWHENYOUWANTTOTREATA 7UXH
MDYD6WDWLF7HVWV
PRIMITIVELIKEANOBJECT
VXSHUVWDWLFEORFN
VWDWLFEORFN 4HEPARSE8XXMETHODSALWAYSRETURNA )DOVH
LQPDLQ 3TRING
VXSHUFRQVWUXFWRU &ORMATTINGCLASSESWHICHAREDECOUPLED )DOVH
FRQVWUXFWRU
FROM)/ AREINTHEJAVAFORMATPACKAGE
\RXDUHKHUH
FRGHPDJQHWVVROXWLRQ
%XERCISE3OLUTIONS
.OTESONTHE,UNAR#ODE-AGNET
LPSRUWMDYDXWLO
9OUMIGHTDISCOVERTHATAFEWOFTHE
LPSRUWVWDWLFMDYDODQJ6\VWHPRXW DATESPRODUCEDBYTHISPROGRAMARE
FODVV)XOO0RRQV^ OFFBYADAY4HISASTRONOMICALSTUFF
ISALITTLETRICKYANDIFWEMADEIT
VWDWLFLQW'$<B,0 PERFECTITWOULDBETOOCOMPLEXTO
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ MAKEANEXERCISEHERE
&DOHQGDUF &DOHQGDUJHW,QVWDQFH (INTONEPROBLEMYOUMIGHTTRYTO

SOLVEISBASEDONDIFFERENCESINTIME
FVHW
ZONES#ANYOUSPOTTHEISSUE
ORQJGD\ FJHW7LPH,Q0LOOLV
IRULQW[ [[^
GD\ '$<B,0
FVHW7LPH,Q0LOOLVGD\
RXWSULQWOQ6WULQJIRUPDW³IXOOPRRQRQWF´F
`
`

)LOH(GLW:LQGRZ+HOS+RZO
MDYD)XOO0RRQV
IXOOPRRQRQ)UL)HE067
IXOOPRRQRQ6DW0DU067
IXOOPRRQRQ0RQ$SU0'7
FKDSWHU
H[FHSWLRQKDQGOLQJ
5LVN\%HKDYLRU
6XUHLW·VULVN\
EXW,FDQKDQGOHLWLI
VRPHWKLQJJRHVZURQJ
6WXII KDSSHQV7KHILOHLVQ·WWKHUH7KHVHUYHULVGRZQ.OMATTERHOW
GOODAPROGRAMMERYOUAREYOUCANTCONTROLEVERYTHING4HINGSCANGOWRONG6ERYWRONG
7HENYOUWRITEARISKYMETHODYOUNEEDCODETOHANDLETHEBADTHINGSTHATMIGHTHAPPEN
"UTHOWDOYOUKNOWWHENAMETHODISRISKY!NDWHEREDOYOUPUTTHECODETOHANDLETHE
EXCEPTIONALSITUATION3OFARINTHISBOOKWEHAVENTREALLYTAKENANYRISKS7EVECERTAINLYHAD
THINGSGOWRONGATRUNTIMEBUTTHEPROBLEMSWEREMOSTLYFLAWSINOUROWNCODE"UGS!ND
THOSEWESHOULDFIXATDEVELOPMENTTIME.OTHEPROBLEM HANDLINGCODEWERETALKINGABOUT
HEREISFORCODETHATYOUCANTGUARANATEEWILLWORKATRUNTIME#ODETHATEXPECTSTHEFILETOBE
INTHERIGHTDIRECTORYTHESERVERTOBERUNNINGORTHE4HREADTOSTAYASLEEP!NDWEHAVETODO
THISNOW"ECAUSEINTHISCHAPTERWEREGOINGTOBUILDSOMETHINGTHATUSESTHERISKY*AVA3OUND
!0)7EREGOINGTOBUILDA-)$)-USIC0LAYER
WKLVLVDQHZFKDSWHU
EXLOGLQJWKH0,',0XVLF3OD\HU
4M\¼[UISMI5][QK5IKPQVM
/VERTHENEXTTHREECHAPTERSWELLBUILDAFEWDIFFERENTSOUND
APPLICATIONSINCLUDINGA"EAT"OX$RUM-ACHINE)NFACT
BEFORETHEBOOKISDONEWELLHAVEAMULTI PLAYERVERSIONSO
YOUCANSENDYOURDRUMLOOPSTOANOTHERPLAYERKINDOFLIKE
ACHATROOM9OUREGOINGTOWRITETHEWHOLETHINGALTHOUGH
YOUCANCHOOSETOUSE2EADY BAKECODEFORTHE'5)PARTS
/+SONOTEVERY)4DEPARTMENTISLOOKINGFORANEW"EAT"OX
SERVERBUTWEREDOINGTHISTOLEARNMOREABOUT*AVA"UILDING
A"EAT"OXISJUSTAWAYTOHAVEFUNWHILEWERELEARNING*AVA
<PMNQVQ[PML*MI\*W`TWWS[[WUM\PQVOTQSM\PQ["
<RXPDNHDEHDWER[ORRSDE
E\SXWWLQJFKHFNPDUNVLQWKHER[HHDWGUXPSDWWHUQ
V
V
R X U P H VV D J HWKDWJHW HUV
\ RWKHUSOD\
GDQFHEHDW VHQWWRWKH\RXUFXUUHQW
DORQJZLWK UQZKHQ\RX
EHDWSDWWH µ
KLW´6HQG,W
$QG\JURRYH
&KULVJURRYHUHYLVHG
LQFRPLQJPH
RWKHUSOD\H VVDJHVIURP
1LJHOGDQFHEHDW
WRORDGWKH UV&OLFNRQH
JRHVZLWKLW SDWWHUQWKDW
¶6WDUW·WRS DQGWKHQFOLFN
OD\LW
0UTCHECKMARKSINTHEBOXESFOREACHOFTHE@BEATS&OREXAMPLEONBEAT
OF THE"ASSDRUMANDTHE-ARACASWILLPLAYONBEATNOTHINGAND
ONBEATTHE-ARACASAND#LOSED(I (ATYOUGETTHEIDEA7HENYOUHIT
@3TARTITPLAYSYOURPATTERNINALOOPUNTILYOUHIT@3TOP!TANYTIMEYOU
CANhCAPTUREvONEOFYOUROWNPATTERNSBYSENDINGITTOTHE"EAT"OXSERVER
WHICHMEANSANYOTHERPLAYERSCANLISTENTOIT 9OUCANALSOLOADANYOFTHE
INCOMINGPATTERNSBYCLICKINGONTHEMESSAGETHATGOESWITHIT
FKDSWHU
H[FHSWLRQKDQGOLQJ
?M¼TT[\IZ\_Q\P\PMJI[QK[
/BVIOUSLYWEVEGOTAFEWTHINGSTOLEARNBEFORETHEWHOLE
PROGRAMISlNISHEDINCLUDINGHOWTOBUILDA3WING'5)HOW
TOCONNECTTOANOTHERMACHINEVIANETWORKINGANDALITTLE)/
SOWECANSENDSOMETHINGTOTHEOTHERMACHINE
/HYEAHANDTHE*AVA3OUND!0)4HATSWHEREWELLSTARTINTHIS
CHAPTER&ORNOWYOUCANFORGETTHE'5)FORGETTHENETWORKING
ANDTHE)/ANDFOCUSONLYONGETTINGSOME-)$) GENERATED
0,',ILOH DWLRQ
SOUNDTOCOMEOUTOFYOURCOMPUTER!NDDONTWORRYIFYOU
, ILO H K DVLQIRUP OGEH
0,' RX
DONTKNOWATHINGABOUT-)$)ORATHINGABOUTREADINGOR DVRQJVK Q\
MAKINGMUSIC%VERYTHINGYOUNEEDTOLEARNISCOVEREDHERE DERXWKRZ LWGRHVQ·WKDYHD
W I
9OUCANALMOSTSMELLTHERECORDDEAL SOD\HGEX GGDWD,W·VNLQGR
V RX Q Q V
DFWXDO PXVLFLQVWUXFWLR

<PM2IÎ;W]VL)81 OLNHVKHHW USLDQR
H
IRUDSOD\
*AVA3OUNDISACOLLECTIONOFCLASSESANDINTERFACESADDEDTO
*AVASTARTINGWITHVERSION4HESEARENTSPECIALADD ONS
THEYREPARTOFTHESTANDARD*3%CLASSLIBRARY*AVA3OUNDISSPLIT
INTOTWOPARTS-)$)AND3AMPLED7EUSEONLY-)$)INTHIS
BOOK-)$)STANDSFOR-USICAL)NSTRUMENT$IGITAL)NTERFACE
HQW
,QVWUXP
ANDISASTANDARDPROTOCOLFORGETTINGDIFFERENTKINDSOF
ELECTRONICSOUNDEQUIPMENTTOCOMMUNICATE"UTFOR F D SD E OH
OUR"EAT"OXAPPYOUCANTHINKOF-)$)ASAKINDOF 0,',
SHEETMUSICTHATYOUFEEDINTOSOMEDEVICEYOUCANTHINK
OFLIKEAHIGH TECH@PLAYERPIANO)NOTHERWORDS-)$)
DATADOESNTACTUALLYINCLUDEANYSOUNDBUTITDOES
INCLUDETHEINSTRUCTIONSTHATA-)$) READINGINSTRUMENT
CANPLAYBACK/RFORANOTHERANALOGYYOUCANTHINKOF 0,',GHYLFHNQRZVKRZWR
A-)$)lLELIKEAN(4-,DOCUMENTANDTHEINSTRUMENT ¶UHDG·D0,',ILOHDQGSOD\EDFN
THATRENDERSTHE-)$)lLEIEPLAYSIT ISLIKETHE7EB WKHVRXQG7KHGHYLFHPLJKW
BROWSER EHDV\QWKHVL]HUNH\ERDUGRU
-)$)DATASAYSWHATTODOPLAYMIDDLE#ANDHERESHOWHARD 6SHDNHU VRPHRWKHUNLQGRILQVWUXPHQW
TOHITITANDHERESHOWLONGTOHOLDITETC BUTITDOESNTSAY 8VXDOO\D0,',LQVWUXPHQW
ANYTHINGATALLABOUTTHEACTUALSOUNDYOUHEAR-)$)DOESNT FDQSOD\D/27RIGLIIHUHQW
KNOWHOWTOMAKEAmUTEPIANOOR*IMMY(ENDRIXGUITAR VRXQGVSLDQRGUXPVYLROLQ
SOUND&ORTHEACTUALSOUNDWENEEDANINSTRUMENTA-)$)
DEVICE THATCANREADANDPLAYA-)$)lLE"UTTHEDEVICEIS
HWFDQGDOODWWKHVDPHWLPH
USUALLYMORELIKEANENTIREBANDORORCHESTRAOFINSTRUMENTS!ND 6RD0,',ILOHLVQ·WOLNHVKHHW
THATINSTRUMENTMIGHTBEAPHYSICALDEVICELIKETHEELECTRONIC PXVLFIRUMXVWRQHPXVLFLDQLQ
KEYBOARDSYNTHESIZERSTHEROCKMUSICIANSPLAYORITCOULD WKHEDQGLWFDQKROGWKH
EVENBEANINSTRUMENTBUILTENTIRELYINSOFTWARELIVINGINYOUR SDUWVIRU$//WKHPXVLFLDQV
COMPUTER SOD\LQJDSDUWLFXODUVRQJ
&OROUR"EAT"OXWEUSEONLYTHEBUILT INSOFTWARE ONLY
INSTRUMENTTHATYOUGETWITH*AVA)TSCALLEDASYNTHESIZERSOME
FOLKSREFERTOITASASOFTWARESYNTH BECAUSEITCREATESSOUND
3OUNDTHATYOUHEAR
\RXDUHKHUH
EXWLWORRNHGVRVLPSOH
.QZ[\_MVMMLI;MY]MVKMZ
"EFOREWECANGETANYSOUNDTOPLAYWENEEDA3EQUENCEROBJECT4HE
SEQUENCERISTHEOBJECTTHATTAKESALLTHE-)$)DATAANDSENDSITTOTHERIGHT
INSTRUMENTS)TSTHETHINGTHATPLAYSTHEMUSIC!SEQUENCERCANDOALOTOF
DIFFERENTTHINGSBUTINTHISBOOKWEREUSINGITSTRICTLYASAPLAYBACKDEVICE,IKE
A#$ PLAYERONYOURSTEREOBUTWITHAFEWADDEDFEATURES4HE3EQUENCERCLASS
ISINTHEJAVAXSOUNDMIDIPACKAGEPARTOFTHESTANDARD*AVALIBRARYASOFVERSION
3OLETSSTARTBYMAKINGSUREWECANMAKEORGET A3EQUENCEROBJECT
FNDJH
V R XQGPLGLSD
LPSRUWWKH MDY D [ REMHFW,W·VWKH
:HQHHGD6HTXHQFHU HYLFHLQVWUXPHQW
LPSRUWMDYD[VRXQGPLGL
,',G
SXEOLFFODVV0XVLF7HVW^ PDLQSDUWRIWKH0 LQJWKDWZHOO
·V WK H WK
ZH·UHXVLQJ,W

0 ,' ,LQIRUPDWLRQLQWR
VHTXHQFHVDOOWKH

SXEOLFYRLGSOD\^
·WPDNHDEUDQG
6HTXHQFHUVHTXHQFHU 0LGL6\VWHPJHW6HTXHQFHU D¶VRQJ·%XWZHGRQ KDYHWRDVNWKH
ZH

QHZRQHRXUVHOYHV RQH
V
6\VWHPRXWSULQWOQ³:HJRWDVHTXHQFHU´ 0LGL6\VWHPWRJLYHX
`FORVHSOD\
0XVLF7HVWPW QHZ0XVLF7HVW
PWSOD\
`FORVHPDLQ
`FORVHFODVV ;WUM\PQVO¼[_ZWVO
7KLVFRGHZRQ·WFRPSLOH7KHFRPSLOHUVD\VWKHU
H·VDQ
¶XQUHSRUWHGH[FHSWLRQ·WKDWPXVWEHFDXJKWRUGHF
ODUH G
)LOH(GLW:LQGRZ+HOS6D\:KDW"
MDYDF0XVLF7HVWMDYD
0XVLF7HVWMDYDXQUHSRUWHGH[FHSWLRQMDYD[VRXQGPLGL
0LGL8QDYDLODEOH([FHSWLRQPXVWEHFDXJKWRUGHFODUHGWREH
WKURZQ
6HTXHQFHUVHTXHQFHU 0LGL6\VWHPJHW6HTXHQFHU
A
HUURUV
FKDSWHU
H[FHSWLRQKDQGOLQJ
?PI\PIXXMV[_PMVIUM\PWLaW]_IV\\WKITT
XZWJIJTaQVIKTI[[aW]LQLV¼\_ZQ\MQ[ZQ[Sa'
VPHWKR
ZU L W H WXVH GV
KD LQ
W
/HW·VVD\\RXZDQW
WRFDOODPHWKRGLQD FODVV&RZ^
FODVV%DU^ YRLGPRR^
FODVVWKDW\RXGLGQ·W YRLGJR^
PRR
`
LIVHUYHU'RZQ^
H[SORGH
`
`
LQWVWXII^
ZULWH
`
[EHHS
`
`
\RXUFRGH FODVV\RX
\RX GLGQ·WZULWH
7KDWPHWKRGGRHV FODVV&RZ^
YRLGPRR^
LIVHUYHU'RZQ^
YRLGPRR^
H[SORGH
VRPHWKLQJULVN\ `
`
`
LIVHUYHU'RZQ^
VRPHWKLQJWKDWPLJKW
H[SORGH
QRWZRUNDWUXQWLPH FODVV\RX
`
GLGQ·WZULWH `
0\PRR
,ZRQGHULI PHWKRGZLOO
WKDWPHWKRG H[SORGHLIWKH
<RXQHHGWRNQRZ VHUYHULVGRZQ
FRXOGEORZXS
WKDWWKHPHWKRG
\RX·UHFDOOLQJLV FODVV&RZ^
YRLGPRR^
LIVHUYHU'RZQ^
ULVN\ H[SORGH
`
`
`
FODVV\RX
GLGQ·WZULWH
\RX
1RZWKDW,
NQRZ,FDQWDNH
SUHFDXWLRQV
ZULWHVDIHO
<RXWKHQZULWHFRGH \
WKDWFDQKDQGOHWKH
IDLOXUHLILWGRHV FODVV%DU^
YRLGJR^
WU\^
PRR
KDSSHQ<RXQHHGWREH `FDWFK0;P^

FU\
`
`
SUHSDUHGMXVWLQFDVH `
\RXUFRGH
\RX
\RXDUHKHUH
ZKHQWKLQJVPLJKWJRZURQJ
5M\PWL[QV2IÎ][MM`KMX\QWV[\W\MTT\PMKITTQVOKWLM
¹;WUM\PQVO*IL0IXXMVML1NIQTMLº
*AVASEXCEPTION HANDLINGMECHANISMISACLEANWELL LIGHTEDWAYTOHANDLEhEXCEPTIONAL

SITUATIONSvTHATPOPUPATRUNTIMEITLETSYOUPUTALLYOURERROR HANDLINGCODEINONE
EASY TO READPLACE)TSBASEDONYOUKNOWINGTHATTHEMETHODYOURECALLINGISRISKY
IETHATTHEMETHODMIGHTGENERATEANEXCEPTION SOTHATYOUCANWRITECODETODEAL
WITHTHATPOSSIBILITY)FYOUKNOWYOUMIGHTGETANEXCEPTIONWHENYOUCALLAPARTICULAR
METHODYOUCANBEPREPAREDFORPOSSIBLYEVENRECOVERFROMTHEPROBLEMTHATCAUSED
THEEXCEPTION
3OHOWDOYOUKNOWIFAMETHODTHROWSANEXCEPTION9OUlNDAWKURZVCLAUSEINTHE
RISKYMETHODSDECLARATION
7KHJHW6HTXHQFHUPHWKRGWDNHVDULVN,WFDQIDLODWUXQWLPH
6RLWPXVW¶GHFODUH·WKHULVN\RXWDNHZKHQ\RXFDOOLW
7KH$3,GRFVWHOO\RX
WKDWJHW6HTXHQFHU
FDQWKURZDQH[FHSWLRQ
0LGL8QDYDLODEOH([FHSWLRQ
$PHWKRGKDVWRGHFODUH
WKHH[FHSWLRQVLWPLJKW
WKURZ
7KLVSDUWWHOOV\R
X:+(1\RXPLJKW
H[FHSWLRQLQW JHWWKDW
KLVFDVHEHFDXVHR
UHVWULFWLRQVZKLFK I UHVRXUFH
FRXOGMXVWPHDQVWK
LVDOUHDG\EHLQJXV HVHTXHQFHU
HG
FKDSWHU
H[FHSWLRQKDQGOLQJ
6WSd5a_b[^
Wd
;]ài;Æ_
fS][`YSd[e]ZW
<PMKWUXQTMZVMML[\WSVW_ Va`ÆfkagfZ[`][ dWTgf
fÆeiadfZ[f1I
\PI\A7=SVW_aW]¼ZMKITTQVO eZag^V;Va1 ZSf
IZQ[SaUM\PWL e[Y`WVYWW]k
[ÌS[][][
)FYOUWRAPTHERISKYCODEINSOMETHINGCALLEDA
WU\FDWFKTHECOMPILERWILLRELAX
!TRYCATCHBLOCKTELLSTHECOMPILERTHATYOU 6WSdYWW]k
KNOWANEXCEPTIONALTHINGCOULDHAPPENINTHE
METHODYOURECALLINGANDTHATYOUREPREPARED >[XW[eeZadf
TOHANDLEIT4HATCOMPILERDOESNTCAREHOWYOU WebWU[S^^ka`fZ
WZWSb
HANDLEITITCARESONLYTHATYOUSAYYOURETAKING
CAREOFIT
FS]WfZWd[e]
fZ[`YeVa`Æfiad
fdk
[f 4gf\gef[`
USeW
LPSRUWMDYD[VRXQGPLGL S`kbdaT^W_eTW
]agfTWegdWfa
XadWS^^ZW^^TdWS
USfUZ
SXEOLFFODVV0XVLF7HVW^
]eâaeW
SXEOLFYRLGSOD\^
WU\^ KLQJ

6HTXHQFHUVHTXHQFHU 0LGL6\VWHP
JHW6HTXHQFHU
SXWWKHULVN\WN
6\VWHPRXWSULQWOQ³6XFFHVVIXOO\JRWDVHTXHQFHU´ LQD¶WU\·EORF
`FDWFK0LGL8QDYDLODEOH([FHSWLRQH[^
6\VWHPRXWSULQWOQ³%XPPHU´
`
`FORVHSOD\ PDNHD¶F
GRLIWK DWFK·EORFNIRU
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ KDSSHQV HH[FHSWLRQDOVLW ZKDWWR
0XVLF7HVWPW QHZ0XVLF7HVW 0LGL8QD LQRWKHUZRU XDWLRQ
E\WKHF YDLODEOH([FHSWLR GVD
PWSOD\ DOOWRJH Q
W6HTXHQF LVWKURZQ
`FORVHPDLQ HU
`FORVHFODVV
\RXDUHKHUH
H[FHSWLRQVDUHREMHFWV
,·PJRQQD
75<WKLVULVN\WKLQJ
DQG,·PJRQQD
&$7&+P\VHOILI,IDOO
)VM`KMX\QWVQ[IVWJRMK\
Licensed by WN\aXM-`KMX\QWV
Eduard Simons
7HICHISFORTUNATEBECAUSEITWOULDBEMUCHHARDER
TOREMEMBERIFEXCEPTIONSWEREOFTYPE"ROCCOLI
2EMEMBERFROMYOURPOLYMORPHISMCHAPTERSTHAT
ANOBJECTOFTYPE%XCEPTIONCANBEANINSTANCEOFANY
104038
SUBCLASSOF%XCEPTION
"ECAUSEAN%XCEPTIONISANOBJECTWHATYOUCATCHISAN
'RQ¶WWU\WKLVDWKRPH
OBJECT)NTHEFOLLOWINGCODETHEFDWFKARGUMENT
ISDECLAREDASTYPE%XCEPTIONANDTHEPARAMETER
REFERENCEVARIABLEISEX
7KURZDEOH
JHW0HVVDJH WU\^
J
SULQW6WDFN7UDFH NHGHFODULQ
GRULVN\WKLQJ LW·VMXVWOLDUJXPHQW
HSWLRQ
3DUWRIWKH([F KH\DOO DPHWKRG
FODVVKLHUDUFK\7RZDEOH `FDWFK([FHSWLRQH[^
H[WHQGFODVV7KUNH\ ([FHSWLRQ
DQGLQKHULWWZR WU\WRUHFRYHU
PHWKRGV ` 7KLVFRG
([FHSWLR HRQO\UXQVLIDQ
QLVWKURZ
Q
,2([FHSWLRQ ,QWHUUXSWHG([FHSWLRQ 7HATYOUWRITEINACATCHBLOCKDEPENDSONTHE
EXCEPTIONTHATWASTHROWN&OREXAMPLEIFASERVER
ISDOWNYOUMIGHTUSETHECATCHBLOCKTOTRYANOTHER
SERVER)FTHElLEISNTTHEREYOUMIGHTASKTHEUSER
FORHELPlNDINGIT
FKDSWHU
H[FHSWLRQKDQGOLQJ
1NQ\¼[aW]ZKWLM\PI\KI\KPM[\PMM`KMX\QWV
\PMV_PW[MKWLM\PZW_[Q\' KU
RZV
DQH[FHSWLR

QE
DF
W
N
9OULLSPENDMUCHMOREOFYOUR*AVACODINGTIMEHANDLING
EXCEPTIONSTHANYOULLSPENDCREATINGANDTHROWINGTHEMYOURSELF FODVV&RZ^
FODVV%DU^ YRLGPRR^
&ORNOWJUSTKNOWTHATWHENYOURCODECALLSARISKYMETHODA YRLGJR^ LIVHUYHU'RZQ^

H[SORGH

PRR
` `
`
METHODTHATDECLARESANEXCEPTIONITSTHERISKYMETHODTHAT LQWVWXII^
[EHHS
` FDOOVULVN\PHWKRG
`
`
THROWSTHEEXCEPTIONBACKTOYOUTHECALLER
\RXUFRGH FODVVZLWKD
)NREALITYITMIGHTBEYOUWHOWROTEBOTHCLASSES)TREALLY
ULVN\PHWKRG
DOESNTMATTERWHOWRITESTHECODEWHATMATTERSISKNOWING
WHICHMETHODTHROWSTHEEXCEPTIONANDW HICHMETHODCATCHESIT
7HENSOMEBODYWRITESCODETHATCOULDTHROWANEXCEPTIONTHEY
MUSTDECLARETHEEXCEPTION
E\
6 7 W H OO W KHZRUOG HSWLRQ
G08 DG([ F
5LVN\H[FHSWLRQWKURZLQJFRGH WKLVPHWKR WKDWLWWKURZVD%
GHFODULQJ
SXEOLFYRLGWDNH5LVNWKURZV%DG([FHSWLRQ^ One method will
LIDEDQGRQ$OO+RSH^
WKURZQHZ%DG([FHSWLRQ catch what another
`
FUHDWH method throws. An
`
REMHFW DQHZ([FHSWLR exception is always
DQGWKU
RZLW Q
thrown back to the
caller.
The method that
<RXUFRGHWKDWFDOOVWKHULVN\PHWKRG
throws has to declare
SXEOLFYRLGFURVV)LQJHUV^
WU\^
that it might throw
DQ2EMHFWWDNH5LVN the exception.
`FDWFK%DG([FHSWLRQH[^
6\VWHPRXWSULQWOQ³$DDUJK´ ,I\RXFDQ·WUHFRYHUIURP
WK
H[SULQW6WDFN7UDFH JHWDVWDFNWUDFHXVLQJWKH HH[FHSWLRQDW/($67
SU
` WKDWDOOH[FHSWLRQVLQKHULW LQW6WDFN7UDFHPHWKRG
\RXDUHKHUH
FKHFNHGDQGXQFKHFNHGH[FHSWLRQV
7KHFRPSLOHUFKHFNVIRUHYHU\WKLQJ
H[FHSW5XQWLPH([FHSWLRQV
([FHSWLRQVWKDWDUH127VXEFODVVHVRI 7KHFRPSLOHUJXDUDQWHHV
5XQWLPH([FHSWLRQDUHFKHFNHGIRUE\
WKHFRPSLOHU7KH\·UHFDOOHG´FKHFNHG )FYOUTHROWANEXCEPTIONINYOURCODEYOUMUSTDECLAREITUSING

THETHROWSKEYWORDINYOURMETHODDECLARATION
H[FHSWLRQVµ
([FHSWLRQ )FYOUCALLAMETHODTHATTHROWSANEXCEPTIONINOTHERWORDS
AMETHODTHATDECLARESITTHROWSANEXCEPTION YOUMUST
ACKNOWLEDGETHATYOUREAWAREOFTHEEXCEPTIONPOSSIBILITY
/NEWAYTOSATISFYTHECOMPILERISTOWRAPTHECALLINATRYCATCH
4HERESASECONDWAYWELLLOOKATALITTLELATERINTHISCHAPTER
E\WKH
,2([FHSWLRQ ,QWHUUXSWHG([FHSWLRQ 5XQWLPH([FHSWLRQ
P H( [F HS WL RQ V DUH127FKHFNHGULVHKHUH
5XQWL NQRZQDVELJVX
US

FRPSLOHU7KH\·UH WLRQVµ<RXFDQWKURZFDWFK
HS
´XQFKHFNHGH[F WLPH([FHSWLRQVEXW\RXGRQ ·W
DQGGHFODUH5XQ FRPSLOHUZRQ·WFKHFN
KDYHWRDQGWKH
&ODVV&DVW([FHSWLRQ 1XOO3RLQWHU([FHSWLRQ
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: 7AITJUSTAMINUTE(OWCOMETHISISTHE&)234TIME
WEVEHADTOTRYCATCHAN%XCEPTION7HATABOUTTHE
Q: )LLBITE7(9DOESNTTHECOMPILERCAREABOUTTHOSE
RUNTIMEEXCEPTIONS!RENTTHEYJUSTASLIKELYTOBRINGTHE
EXCEPTIONS)VEALREADYGOTTENLIKE.ULL0OINTER%XCEPTION WHOLESHOWTOASTOP
ANDTHEEXCEPTIONFOR$IVIDE"Y:ERO)EVENGOTA
.UMBER&ORMAT%XCEPTIONFROMTHE)NTEGERPARSE)NT
METHOD(OWCOMEWEDIDNTHAVETOCATCHTHOSE A: -OST2UNTIME%XCEPTIONSCOMEFROMAPROBLEMIN
YOURCODELOGICRATHERTHANACONDITIONTHATFAILSATRUNTIME
INWAYSTHATYOUCANNOTPREDICTORPREVENT9OUCANNOT
A: 4HECOMPILERCARESABOUTALLSUBCLASSESOF%XCEPTION
UNLESSTHEYAREASPECIALTYPE2UNTIME%XCEPTION!NY
GUARANTEETHEFILEISTHERE9OUCANNOTGUARANTEETHESERVER
ISUP"UTYOUCANMAKESUREYOURCODEDOESNTINDEXOFFTHE
EXCEPTIONCLASSTHATEXTENDS2UNTIME%XCEPTIONGETSA ENDOFANARRAYTHATSWHATTHELENGTHATTRIBUTEISFOR
FREEPASS2UNTIME%XCEPTIONSCANBETHROWNANYWHERE 9OU7!.42UNTIME%XCEPTIONSTOHAPPENATDEVELOPMENT
WITHORWITHOUTTHROWSDECLARATIONSORTRYCATCHBLOCKS ANDTESTINGTIME9OUDONTWANTTOCODEINATRYCATCHFOR
4HECOMPILERDOESNTBOTHERCHECKINGWHETHERAMETHOD EXAMPLEANDHAVETHEOVERHEADTHATGOESWITHITTOCATCH
DECLARESTHATITTHROWSA2UNTIME%XCEPTIONORWHETHERTHE SOMETHINGTHATSHOULDNTHAPPENINTHEFIRSTPLACE
CALLERACKNOWLEDGESTHATTHEYMIGHTGETTHATEXCEPTIONAT
RUNTIME !TRYCATCHISFORHANDLINGEXCEPTIONALSITUATIONSNOTFLAWS
INYOURCODE5SEYOURCATCHBLOCKSTOTRYTORECOVERFROM
SITUATIONSYOUCANTGUARANTEEWILLSUCCEED/RATTHEVERY
LEASTPRINTOUTAMESSAGETOTHEUSERANDASTACKTRACESO
SOMEBODYCANFIGUREOUTWHATHAPPENED
FKDSWHU
H[FHSWLRQKDQGOLQJ
:MDD=LHGAFLK
$PHWKRGFDQWKURZDQH[FHSWLRQZKHQVRPHWKLQJIDLOVDWUXQWLPH
$QH[FHSWLRQLVDOZD\VDQREMHFWRIW\SH([FHSWLRQ:KLFKDV\RX
UHPHPEHUIURPWKHSRO\PRUSKLVPFKDSWHUVPHDQVWKHREMHFWLVIURPD
FODVVWKDWKDV([FHSWLRQVRPHZKHUHXSLWVLQKHULWDQFHWUHH
7KHFRPSLOHUGRHV127SD\DWWHQWLRQWRH[FHSWLRQVWKDWDUHRI
W\SH5XQWLPH([FHSWLRQ$5XQWLPH([FHSWLRQGRHVQRWKDYHWREH
GHFODUHGRUZUDSSHGLQDWU\FDWFKDOWKRXJK\RX·UHIUHHWRGRHLWKHURU
ERWKRIWKRVHWKLQJV
$OO([FHSWLRQVWKHFRPSLOHUFDUHVDERXWDUHFDOOHG¶FKHFNHG
H[FHSWLRQV·ZKLFKUHDOO\PHDQVFRPSLOHUFKHFNHGH[FHSWLRQV2QO\ YQ`MO[SZUÙb QÙ\
5XQWLPH([FHSWLRQVDUHH[FOXGHGIURPFRPSLOHUFKHFNLQJ$OORWKHU PHWKLQJQHZ
WROHDUQVR
H[FHSWLRQVPXVWEHDFNQRZOHGJHGLQ\RXUFRGHDFFRUGLQJWRWKH ,I\RX·UHWU\LQJ WROHDUQ
H OD VWWKLQJ\RXWU\
PDNHWKDWWK H\RXSXWWKLV
UXOHV VOHHS6RRQF
EHIRUHJRLQJWR X FD Q WHDU\RXUVHOI
XPLQJ\R
$PHWKRGWKURZVDQH[FHSWLRQZLWKWKHNH\ZRUGWKURZIROORZHGE\ ERRNGRZQDVV LQ JHOVHPRUH
RQ·WUHDGDQ\WK
DQHZH[FHSWLRQREMHFW DZD\IURPLWG FN R ID & KHHULRV
WKHED
FKDOOHQJLQJWKDQ S UR FHVVZKDW
WKURZQHZ1R&DIIHLQH([FHSWLRQ UE UD LQ QHHGVWLPHWR
ER [ <RX RXOGWDNH
OHDUQHG7KDWF
\RX·YHUHDGDQG YH V RPHWKLQJ
0HWKRGVWKDWPLJKWWKURZDFKHFNHGH[FHSWLRQPXVWDQQRXQFHLWZLWK \RXWU\WRVKR
DIHZKRXUV,I DVRPHRIWKH
DWKURZV([FHSWLRQGHFODUDWLRQ WRSRI\RXU-DY
QHZLQULJKWRQ
¶VWLFN·
,I\RXUFRGHFDOOVDFKHFNHGH[FHSWLRQWKURZLQJPHWKRGLWPXVW -DYDPLJKWQRW
WOHDUQLQJ
GRHVQ·WUXOHRX
UHDVVXUHWKHFRPSLOHUWKDWSUHFDXWLRQVKDYHEHHQWDNHQ 2IFRXUVHWKLV \ RX UODWHVW
:RUNLQJRQ
DSK\VLFDOVNLOO . LFN %R [LQ JURXWLQH
,I\RX·UHSUHSDUHGWRKDQGOHWKHH[FHSWLRQZUDSWKHFDOOLQDWU\FDWFK %DOOURR P
IIHFW\RXU
DQGSXW\RXUH[FHSWLRQKDQGOLQJUHFRYHU\FRGHLQWKHFDWFKEORFN SUREDEO\ZRQ·WD
-DYDOHDUQLQJ
,I\RX·UHQRWSUHSDUHGWRKDQGOHWKHH[FHSWLRQ\RXFDQVWLOOPDNHWKH XOWVUHDGWKLV
)RUWKHEHVWUHV
VWORRNDW
FRPSLOHUKDSS\E\RIILFLDOO\¶GXFNLQJ·WKHH[FHSWLRQ:H·OOWDONDERXW ERRNRUDWOHD
WKH SL FW XU HV U LJKWEHIRUH
GXFNLQJDOLWWOHODWHULQWKLVFKDSWHU
JRLQJWRV OH HS
6KDUSHQ \RXU SHQFLO

4HINGSYOUWANTTODO 7HATMIGHTGOWRONG
??CONNECTTOAREMOTESERVER WKHVHUYHULVGRZQ
??????????????????????????????????
7HICHOFTHESEDOYOUTHINK
MIGHTTHROWANEXCEPTIONTHAT ??ACCESSANARRAYBEYONDITSLENGTH ??????????????????????????????????
THECOMPILERWOULDCAREABOUT ??DISPLAYAWINDOWONTHESCREEN ??????????????????????????????????
7EREONLYLOOKINGFORTHE
THINGSTHATYOUCANTCONTROLIN ??RETRIEVEDATAFROMADATABASE ??????????????????????????????????
YOURCODE7EDIDTHElRSTONE ??SEEIFATEXTlLEISWHEREYOUTHINKITIS ??????????????????????????????????
"ECAUSEITWASTHEEASIEST ??CREATEANEWlLE ??????????????????????????????????
??READACHARACTERFROMTHECOMMAND LINE ??????????????????????????????????
\RXDUHKHUH
H[FHSWLRQVDQGIORZFRQWURO
.TW_KWV\ZWTQV\ZaKI\KPJTWKS[
7HENYOUCALLARISKYMETHODONEOFTWOTHINGSCANHAP
PEN4HERISKYMETHODEITHERSUCCEEDSANDTHETRYBLOCK
COMPLETESORTHERISKYMETHODTHROWSANEXCEPTIONBACKTO
YOURCALLINGMETHOD
,IWKHWU\VXFFHHGV
GR5LVN\7KLQJGRHVQRW
WKURZDQH[FHSWLRQ
WU\^
)RRI
[GR5LVN\7KLQJ 7KHFRGHFN LQWKH
LQWE IJHW1XP FDWFK E OR QHYHU
ORFNUXQV UXQV
)LUVWWKHWU\E ORZWKH )LOH(GLW:LQGRZ+HOS5LVN$OO
EH
WKHQWKHFRGH `FDWFK([FHSWLRQH[^ MDYD7HVWHU
FDWFKUXQV 6\VWHPRXWSULQWOQ³IDLOHG´ :HPDGHLW
`
6\VWHPRXWSULQWOQ³:HPDGHLW´
,IWKHWU\IDLOV
EHFDXVHGR5LVN\7KLQJ
Y
EORFNQHJ
GRHVWKURZDQH[FHSWLRQ
W K H W U \ LQ
RI G7K
WU\^ 7KHUHVWZKLFKLVD*RRKHWU\
V W
HUUXQ WKHUHVWRI XFFHVVRI
WKH )RRI [GR5LVN\7KLQJ
NUXQVEXW KURZV

W U \ E OR F EHFDXVH SHQGVRQWKHV N\7KLQJ
7KH LVN\7KLQJ
W LQWE IJHW1XP GH WRGR5LV
FDOOWRGR5 QVRWKHUHVWRI WKHFDOO
DQH[FHSWLR FNGRHVQ·WUXQ `FDWFK([FHSWLRQH[^ )LOH(GLW:LQGRZ+HOS5LVN$OO
WKHWU\EOR HQ MDYD7HVWHU

FNUXQVWK
6\VWHPRXWSULQWOQ³IDLOHG´
F D W F K E OR
7KH VRQ ` IDLOHG
GFRQWLQXH
WKHPHWKR 6\VWHPRXWSULQWOQ³:HPDGHLW´ :HPDGHLW
FKDSWHU
H[FHSWLRQKDQGOLQJ
.QVITTa"NWZ\PM\PQVO[aW]_IV\
\WLWVWUI\\MZ_PI\
)FYOUTRYTOCOOKSOMETHINGYOUSTARTBYTURNINGON $UH\RXVXUH 1RPDWWHUZKDWGR127OHW
THEOVEN \RXZDQWWRWU\ PHIRUJHWWRWXUQRIIWKH
)FTHETHINGYOUTRYISACOMPLETEFAILURE WKLV" RYHQ/DVWWLPH,WRUFKHGKDOI
YOUHAVETOTURNOFFTHEOVEN WKHQHLJKERUKRRG
)FTHETHINGYOUTRYSUCCEEDS
YOUHAVETOTURNOFFTHEOVEN
9OUHAVETOTURNOFFTHEOVENNOMATTERWHAT
$ÀQDOO\EORFNLVZKHUH\RXSXW
FRGHWKDWPXVWUXQUHJDUGOHVV
RIDQH[FHSWLRQ
WU\^
WXUQ2YHQ2Q
[EDNH
`FDWFK%DNLQJ([FHSWLRQH[^
H[SULQW6WDFN7UDFH
`¿QDOO\^
WXUQ2YHQ2II
`
,IWKHWU\EORFNIDLOVDQH[FHSWLRQIORZ
7ITHOUTlNALLYYOUHAVETOPUTTHE
TURN/VEN/FF INBOTHTHETRYANDTHECATCH FRQWUROLPPHGLDWHO\PRYHVWRWKHFDWFKEORFN
BECAUSEYOUHAVETOTURNOFFTHEOVENNOMATTER :KHQWKHFDWFKEORFNFRPSOHWHVWKHILQDOO\
WHAT!lNALLYBLOCKLETSYOUPUTALLYOUR EORFNUXQV:KHQWKHILQDOO\EORFNFRPSOHWHV
IMPORTANTCLEANUPCODEINONEPLACEINSTEADOF WKHUHVWRI WKHPHWKRGFRQWLQXHVRQ
DUPLICATINGITLIKETHIS
WU\^ ,IWKHWU\EORFNVXFFHHGVQRH[FHSWLRQ

IORZFRQWUROVNLSVRYHUWKHFDWFKEORFNDQG
WXUQ2YHQ2Q
PRYHVWRWKHILQDOO\EORFN:KHQWKHILQDOO\
[EDNH
EORFNFRPSOHWHVWKHUHVWRI WKHPHWKRG
WXUQ2YHQ2II
FRQWLQXHVRQ
`FDWFK%DNLQJ([FHSWLRQH[^
H[SULQW6WDFN7UDFH
,IWKHWU\RUFDWFKEORFNKDVDUHWXUQ
WXUQ2YHQ2II VWDWHPHQWÀQDOO\ZLOOVWLOOUXQ)ORZ
` MXPSVWRWKHILQDOO\WKHQEDFNWRWKHUHWXUQ
\RXDUHKHUH
IORZFRQWUROH[HUFLVH
6KDUSHQ \RXU SHQFLO

,OOKATTHECODETOTHELEFT7HATDOYOUTHINKTHE
&LOW#ONTROL OUTPUTOFTHISPROGRAMWOULDBE7HATDOYOUTHINK
ITWOULDBEIFTHETHIRDLINEOFTHEPROGRAMWERE
CHANGEDTO6WULQJWHVW ´\HVµ
!SSUME3CARY%XCEPTIONEXTENDS%XCEPTION
SXEOLFFODVV7HVW([FHSWLRQV^
/UTPUTWHENWHVW ´QRµ
6WULQJWHVW ´QRµ
WU\^
6\VWHPRXWSULQWOQ´VWDUWWU\µ
GR5LVN\WHVW
6\VWHPRXWSULQWOQ´HQGWU\µ
`FDWFK6FDU\([FHSWLRQVH^
6\VWHPRXWSULQWOQ´VFDU\H[FHSWLRQµ
`ÀQDOO\^
6\VWHPRXWSULQWOQ´ÀQDOO\µ
`
6\VWHPRXWSULQWOQ´HQGRIPDLQµ
`
/UTPUTWHENWHVW ´\HVµ
VWDWLFYRLGGR5LVN\6WULQJWHVWWKURZV6FDU\([FHSWLRQ^

6\VWHPRXWSULQWOQ´VWDUWULVN\µ
LI´\HVµHTXDOVWHVW^
WKURZQHZ6FDU\([FHSWLRQ
`
6\VWHPRXWSULQWOQ´HQGULVN\µ
UHWXUQ
`
`
7HENTESThYESvSTARTTRY STARTRISKY SCARYEXCEPTION lNALLY ENDOFMAIN

7HENTESThNOvSTARTTRY STARTRISKY ENDRISKY ENDTRY lNALLY ENDOFMAIN
FKDSWHU
H[FHSWLRQKDQGOLQJ
,QL_MUMV\QWV\PI\IUM\PWLKIV
\PZW_UWZM\PIVWVMM`KMX\QWV'
!METHODCANTHROWMULTIPLEEXCEPTIONSIFITDARNWELLNEEDSTO"UT
AMETHODSDECLARATIONMUSTDECLAREALLTHECHECKEDEXCEPTIONSITCAN
THROWALTHOUGHIFTWOORMOREEXCEPTIONSHAVEACOMMONSUPERCLASSTHE
METHODCANDECLAREJUSTTHESUPERCLASS
+I\KPQVOU]T\QXTMM`KMX\QWV[
4HECOMPILERWILLMAKESURETHATYOUVEHANDLEDALLTHECHECKEDEXCEP
TIONSTHROWNBYTHEMETHODYOURECALLING3TACKTHECATCHBLOCKSUNDER
THETRYONEAFTERTHEOTHER3OMETIMESTHEORDERINWHICHYOUSTACKTHE
CATCHBLOCKSMATTERSBUTWELLGETTOTHATALITTLELATER
SXEOLFFODVV/DXQGU\^
SXEOLFYRLGGR/DXQGU\WKURZV3DQWV([FHSWLRQ
/LQJHULH([FHSWLRQ^

FRGHWKDWFRXOGWKURZHLWKHUH[FHSWLRQ
FRX QW¶HP
`
HW K R G GHFODUHVWZR
7KLVP
` SWLRQV
7:2H[FH
SXEOLFFODVV)RR^
SXEOLFYRLGJR^
/DXQGU\ODXQGU\ QHZ/DXQGU\ LIGR/DXQGU\WKURZVD
3DQWV([FHSWLRQLWODQGVLQWKH
WU\^
3DQWV([FHSWLRQFDWFKEORFN
ODXQGU\GR/DXQGU\
`FDWFK3DQWV([FHSWLRQSH[^
UHFRYHU\FRGH
`FDWFK/LQJHULH([FHSWLRQOH[^
WKURZVD
UHFRYHU\FRGH LIGR/DXQGU\ LRQLWODQGVLQWKH
SW
` /LQJHULH([FH LRQFDWFKEORFN
SW
` /LQJHULH([FH
`
\RXDUHKHUH
SRO\PRUSKLFH[FHSWLRQV
-`KMX\QWV[IZMXWTaUWZXPQK
%XCEPTIONSAREOBJECTSREMEMBER4HERESNOTHINGALLTHAT
DYH
SPECIALABOUTONEEXCEPTTHATITISATHINGTHATCANBETHROWN $OOH[FHSWLRQVK
3OLIKEALLGOODOBJECTS%XCEPTIONSCANBEREFERREDTO ([FHSWLRQ ([FHSWLRQDVD
POLYMORPHICALLY!,INGERIE%XCEPTIONOBJECTFOREXAMPLE VXSHUFODVV
COULDBEASSIGNEDTOA#LOTHING%XCEPTIONREFERENCE!
0ANTS%XCEPTIONCOULDBEASSIGNEDTOAN%XCEPTIONREFERENCE
9OUGETTHEIDEA4HEBENElTFOREXCEPTIONSISTHATAMETHOD
DOESNTHAVETOEXPLICITLYDECLAREEVERYPOSSIBLEEXCEPTIONIT
MIGHTTHROWITCANDECLAREASUPERCLASSOFTHEEXCEPTIONS
3AMETHINGWITHCATCHBLOCKSYOUDONTHAVETOWRITEACATCH ,2([FHSWLRQ &ORWKLQJ([FHSWLRQ
FOREACHPOSSIBLEEXCEPTIONASLONGASTHECATCHORCATCHES
YOUHAVECANHANDLEANYEXCEPTIONTHROWN
<RXFDQ'(&/$5(H[FHSWLRQVXVLQJ
DVXSHUW\SHRIWKHH[FHSWLRQV\RX
WKURZ
3DQWV([FHSWLRQ /LQJHULH([FHSWLRQ 6KLUW([FHSWLRQ
SXEOLFYRLGGR/DXQGU\WKURZV&ORWKLQJ([FHSWLRQ^

'HFODULQJD&OR
WK
DQ\VXEFODVVRI LQJ([FHSWLRQOHWV\RXWKURZ 7HH6KLUW([FHSWLRQ
'UHVV6KLUW([FHSWLRQ
&ORWKLQJ([FHSWL
GR/DXQGU\FDQ RQ7KDWPHDQV
W
/LQJHULH([FHSWL KURZD3DQWV([FHSWLRQ
RQ7HH6KLUW([F
'UHVV6KLUW([FHS HS
WLRQZLWKRXWH[S WLRQDQG
LQGLYLGXDOO\ OLFLWO\GHFODULQJ
WKHP
<RXFDQ&$7&+H[FHSWLRQVXVLQJD
VXSHUW\SHRIWKHH[FHSWLRQWKURZQ
QO\
FDQFDWFKR[FHSWLRQDQG
Q\ 7HH6KLUW( ([FHSWLRQ
FDQFDWFKD HSWLRQ
WU\^ WU\^
( [ F 'UHVV6KLUW
ODXQGU\GR/DXQGU\ &ORWKLQJ ODXQGU\GR/DXQGU\
VXEFODVV
`FDWFK&ORWKLQJ([FHSWLRQFH[^ `FDWFK6KLUW([FHSWLRQVH[^

UHFRYHU\FRGH UHFRYHU\FRGH
` `

FKDSWHU
H[FHSWLRQKDQGOLQJ
-XVWEHFDXVH\RX&$1FDWFKHYHU\WKLQJ
ZLWKRQHELJVXSHUSRO\PRUSKLFFDWFK
GRHVQ·WDOZD\VPHDQ\RX6+28/'
9OUCOULDWRITEYOUREXCEPTION HANDLINGCODESOTHAT
YOUSPECIFYONLYONECATCHBLOCKUSINGTHESUPERTYPE
%XCEPTIONINTHECATCHCLAUSESOTHATYOULLBEABLETO
CATCHANYEXCEPTIONTHATMIGHTBETHROWN
WU\^
ODXQGU\GR/DXQGU\
`FDWFK([FHSWLRQH[^ LOO
RP : + $ 7 " 7 KLVFDWFKEORFNZ
UHFRYHU\FRGH5HFRYHU\IU RXZRQ·W
WF K $1 < D QG D OOH[FHSWLRQVVR\
FD QJ
`
ZZKDWZHQWZUR

DXWRPDWLFDOO\NQR
:ULWHDGLIIHUHQWFDWFKEORFNIRUHDFK
H[FHSWLRQWKDW\RXQHHGWRKDQGOH
XQLTXHO\
&OREXAMPLEIFYOURCODEDEALSWITHORRECOVERS
FROM A4EE3HIRT%XCEPTIONDIFFERENTLYTHANITHANDLESA
,INGERIE%XCEPTIONWRITEACATCHBLOCKFOREACH"UTIFYOU
TREATALLOTHERTYPESOF#LOTHING%XCEPTIONINTHESAMEWAY
THENADDA#LOTHING%XCEPTIONCATCHTOHANDLETHEREST
WU\^
ODXQGU\GR/DXQGU\
DQG
H 6 KLU W ([FHSWLRQV HHGGLIIHUHQW
`FDWFK7HH6KLUW([FHSWLRQWH[^ 7H [FHSWLRQV
Q
XVH
UHFRYHU\IURP7HH6KLUW([FHSWLRQ /LQJHULH( RGHVR\RXVKRXOG
F
UHFRYHU\ FDWFKEORFNV
W
GLIIHUHQ
UHFRYHU\IURP/LQJHULH([FHSWLRQ
$OORWKHU&ORWK
LQ
`FDWFK&ORWKLQJ([FHSWLRQFH[^ DUHFDXJKWKHUH J([FHSWLRQV
UHFRYHU\IURPDOORWKHUV
`
\RXDUHKHUH
RUGHURI PXOWLSOHFDWFKEORFNV
5]T\QXTMKI\KPJTWKS[U][\JMWZLMZML &ORWKLQJ([FHSWLRQ
NZWU[UITTM[\\WJQOOM[\
DUH
LU W ( [ F HSWLRQV RWKHU
7HH6K KHUHEXWQR
FDXJKW QVZLOOILW
H[FHSWLR
FDWFK7HH6KLUW([FHSWLRQWH[
Licensed by
3DQWV([FHSWLRQ /LQJHULH([FHSWLRQ 6KLUW([FHSWLRQ 8QLIRUP([FHSWLRQ
ZLOO
K LU W ( [ FHSWLRQV DOO
7HH6 HWKHUHEXW
QHYHUJ KLUW([FHSWLRQ KHUH
Eduard Simons
RWKHU6 HVDUHFDXJKW
VXEFODVV 7HH6KLUW([FHSWLRQ 'UHVV6KLUW([FHSWLRQ
FDWFK6KLUW([FHSWLRQVH[
104038
SWLRQV 4HEHIGHERUPTHEINHERITANCETREETHEBIGGERTHE
& OR W K LQJ([FH DOWKRXJK CATCH@BASKET!SYOUM
OVEDOWNTHEINHERITANCE
$OO KWKHUH

G
DUHFDXJ W([FHSWLRQDQ YHU
TREETOWARDMOREANDMORESPECIALIZED%XCEPTION
6 K LU
7HH FHSWLRQZLO OQ H CLASSESTHECATCH@BASKETISSMALLER)TSJUSTPLAINOLD
6KLUW([ IDU POLYMORPHISM
JHWWKLV !3HIRT%XCEPTIONCATCHISBIGENOUGHTOTAKE
A4EE3HIRT%XCEPTIONORA$RESS3HIRT%XCEPTION
ANDANYFUTURESUBCLASSOFANYTHINGTHATEXTENDS
3HIRT%XCEPTION !#LOTHING%XCEPTIONISEVENBIGGER
FDWFK&ORWKLQJ([FHSWLRQFH[ IETHEREAREMORETHINGSTHATCANBEREFERENCED
USINGA#LOTHING%XCEPTIONTYPE )TCANTAKEAN
EXCEPTIONOFTYPE#LOTHING%XCEPTIONDUH AND
ANY#LOTHING%XCEPTIONSUBCLASSES0ANTS%XCEPTION
5NIFORM%XCEPTION,INGERIE%XCEPTIONAND
3HIRT%XCEPTION4HEMOTHEROFALLCATCHARGUMENTS
ISTYPE%XCEPTIONITWILLCATCHANYEXCEPTION
INCLUDINGRUNTIMEUNCHECKED EXCEPTIONSSOYOU
PROBABLYWONTUSEITOUTSIDEOFTESTING
FKDSWHU
H[FHSWLRQKDQGOLQJ
AW]KIV¼\X]\JQOOMZJI[SM\[
IJW^M[UITTMZJI[SM\[
7ELLYOUCANBUTITWONTCOMPILE#ATCH
BLOCKSARENOTLIKEOVERLOADEDMETHODS
WHERETHEBESTMATCHISPICKED7ITHCATCH
BLOCKSTHE*6-SIMPLYSTARTSATTHElRSTONE
ANDWORKSITSWAYDOWNUNTILITlNDSACATCH
THATSBROADENOUGHINOTHERWORDSHIGH
ENOUGHONTHEINHERITANCETREE TOHANDLE 6L]HPDWWHUVZKHQ
THEEXCEPTION)FYOURlRSTCATCHBLOCKIS \RXKDYHPXOWLSOHFDWFK
FDWFK([FHSWLRQH[THECOMPILER EORFNV7KHRQHZLWKWKHELJJHVW
KNOWSTHERESNOPOINTINADDINGANY EDVNHWKDVWREHRQWKHERWWRP
2WKHUZLVHWKHRQHVZLWK
OTHERSTHEYLLNEVERBEREACHED
VPDOOHUEDVNHWVDUHXVHOHVV
RWKLV
'RQ·WG
WU\^
ODXQGU\GR/DXQGU\
`FDWFK&ORWKLQJ([FHSWLRQFH[^
UHFRYHU\IURP&ORWKLQJ([FHSWLRQ
UHFRYHU\IURP/LQJHULH([FHSWLRQ
Siblings can be in any order, because they

canÕt catch one anotherÕs exceptions.
9OUCOULDPUT3HIRT%XCEPTIONABOVE
`FDWFK6KLUW([FHSWLRQVH[^
,INGERIE%XCEPTIONANDNOBODYWOULDMIND
UHFRYHU\IURP6KLUW([FHSWLRQ "ECAUSEEVENTHOUGH3HIRT%XCEPTIONISABIGGER
` BROADER TYPEBECAUSEITCANCATCHOTHERCLASSES
ITSOWNSUBCLASSES 3HIRT%XCEPTIONCANTCATCHA

,INGERIE%XCEPTIONSOTHERESNOPROBLEM
\RXDUHKHUH
SRO\PRUSKLFSX]]OH
!SSUMETHETRYCATCHBLOCKHEREISLEGALLYCODED9OURTASKISTODRAW
6KDUSHQ \RXU SHQFLO TWODIFFERENTCLASSDIAGRAMSTHATCANACCURATELYREmECTTHE%XCEPTION
CLASSES)NOTHERWORDSWHATCLASSINHERITANCESTRUCTURESWOULDMAKETHE
TRYCATCHBLOCKSINTHESAMPLECODELEGAL
WU\^
[GR5LVN\
`FDWFK$OSKD([D^
UHFRYHU\IURP$OSKD([
`FDWFK%HWD([E^
UHFRYHU\IURP%HWD([
`FDWFK*DPPD([F^
UHFRYHU\IURP*DPPD([
`FDWFK'HOWD([G^
UHFRYHU\IURP'HOWD([
`
9OURTASKISTOCREATETWODIFFERENTLEGALTRYCATCHSTRUCTURESSIMILARTO
THEONEABOVELEFT TOACCURATELYREPRESENTTHECLASSDIAGRAMSHOWNON
THELEFT!SSUME!,,OFTHESEEXCEPTIONSMIGHTBETHROWNBYTHEMETHOD
%D]([ WITHTHETRYBLOCK
)RR([
%DU([ %LII([
%RLQN([
FKDSWHU
H[FHSWLRQKDQGOLQJ
?PMVaW]LWV¼\_IV\\WPIVLTM
IVM`KMX\QWV
MXVWGXFNLW :KDWWKH"
7KHUHLV12ZD\,·P
FDWFKLQJWKDWWKLQJ,·PJHWWLQ·
RXWRIWKHZD\VRPHERG\
EHKLQGPHFDQKDQGOHLW
,I\RXGRQ·WZDQWWRKDQGOHDQ
H[FHSWLRQ\RXFDQGXFNLWE\
GHFODULQJLW
7HENYOUCALLARISKYMETHODTHECOMPILER
NEEDSYOUTOACKNOWLEDGEIT-OSTOFTHETIME
THATMEANSWRAPPINGTHERISKYCALLINATRY
CATCH"UTYOUHAVEANOTHERALTERNATIVESIMPLY
DUCKITANDLETTHEMETHODTHATCALLEDYOUCATCH
THEEXCEPTION
)TSEASYALLYOUHAVETODOISDECLARETHAT
YOUTHROWTHEEXCEPTIONS%VENTHOUGH
TECHNICALLYYOUARENTTHEONEDOINGTHE
THROWINGITDOESNTMATTER9OURESTILLTHEONE
LETTINGTHEEXCEPTIONWHIZRIGHTONBY
"UTIFYOUDUCKANEXCEPTIONTHENYOUDONT
HAVEATRYCATCHSOWHATHAPPENSWHENTHE
RISKYMETHODDO,AUNDRY DOESTHROWTHE
EXCEPTION
7HENAMETHODTHROWSANEXCEPTIONTHAT
METHODISPOPPEDOFFTHESTACKIMMEDIATELY
ANDTHEEXCEPTIONISTHROWNTOTHENEXT
METHODDOWNTHESTACKTHECALLER"UTIFTHE
CALLERISADUCKERTHENTHERESNOCATCHFORITSO
THECALLERPOPSOFFTHESTACKIMMEDIATELYAND
THEEXCEPTIONISTHROWNTOTHENEXTMETHOD
ANDSOONWHEREDOESITEND9OULLSEEA EXW
LITTLELATER
5 ( $ //<WKURZLW FK
<RXGRQ·W Q·WKDYHDWU\FDW
R
SXEOLFYRLGIRRWKURZV5HDOO\%DG([FHSWLRQ^ VLQFH\RXG PHWKRG\RXFDOO
N\ Gµ
FDOOULVN\PHWKRGZLWKRXWDWU\FDWFK IRUWKHULV ZWKHÚLVN\PHWKR
QR 8
<28DUH ZKRHYHUFDOOV<2
R Z
ODXQGU\GR/DXQGU\ %HFDXVH ZLWKWKHH[FHSW Q
Q LR
H D O
` KDVWRG
\RXDUHKHUH
KDQGOHRUGHFODUH
,]KSQVOJaLMKTIZQVOWVTa
LMTIa[\PMQVM^Q\IJTM
6RRQHURUODWHUVRPHERG\KDVWR
GHDOZLWKLW%XWZKDWLIPDLQ
GXFNVWKHH[FHSWLRQ"
WLRQ
XF N W K HH[FHS ERG\WR
G R
SXEOLFFODVV:DVKHU^
HWKRGV KHUH·VQ
/DXQGU\ODXQGU\ QHZ/DXQGU\ %RWKP ODULQJLW VRW HVMXVWILQH
LO
E\GHF 7KLVFRPS
SXEOLFYRLGIRRWKURZV&ORWKLQJ([FHSWLRQ^ O H LW
ODXQGU\GR/DXQGU\
KDQG
`
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJVWKURZV&ORWKLQJ([FHSWLRQ^

:DVKHUD QHZ:DVKHU
DIRR
`
`
GR/DXQGU\WKURZVD IRRGXFNVWKH PDLQGXFNVWKH 7KH-90

&ORWKLQJ([FHSWLRQ
H[FHSWLRQ
H[FHSWLRQ
VKXWVGRZQ
GR/DXQGU\
IRR IRR
PDLQ PDLQ PDLQ
PDLQFDOOVIRR GR/DXQGU\SRSVRIIWKH IRRSRSVRIIWKH
VWDFNLPPHGLDWHO\DQG VWDFNLPPHGLDWHO\DQG
IRRFDOOVGR/DXQGU\
WKHH[FHSWLRQLVWKURZQ WKHH[FHSWLRQLVWKURZQ
GR/DXQGU\LV EDFNWRIRR EDFNWRZKR":KDW"
UXQQLQJDQGWKURZVD 7KHUH·VQRERG\OHIW
%XWIRRGRHVQ·WKDYHD
&ORWKLQJ([FHSWLRQ EXWWKH-90DQGLW·V
WU\FDWFKVR
WKLQNLQJ´'RQ·WH[SHFW
0(WRJHW\RXRXWRI
WKLVµ
:H¶UHXVLQJWKHWHHVKLUWWRUHSUHVHQWD&ORWKLQJ
([FHSWLRQ:HNQRZZHNQRZ\RXZRXOG
KDYHSUHIHUUHGWKHEOXHMHDQV
FKDSWHU
H[FHSWLRQKDQGOLQJ
+DQGOHRU'HFODUH,W·VWKHODZ
6RQRZZH·YHVHHQERWKZD\VWRVDWLVI\WKHFRPSLOHU
ZKHQ\RXFDOODULVN\H[FHSWLRQWKURZLQJPHWKRG
+$1'/(
:UDSWKHULVN\FDOOLQDWU\FDWFK
7KLVKDGEHWWHUEHD
ELJ
WU\^ KDQGOHDOOH[FHSWLRQV HQRXJKFDWFKWR
ODXQGU\GR/DXQGU\ WKDWGR/DXQGU\
PLJKWWKURZ2UHOVH
WK
`FDWFK&ORWKLQJ([FHSWLRQFH[^ VWLOOFRPSODLQWKDW\ HFRPSLOHUZLOO
RX·UHQRWFDWFKLQJDOO
UHFRYHU\FRGH RIWKHH[FHSWLRQV
`

'(&/$5(GXFNLW

RGWKURZVD KH
'HFODUHWKDW<285PHWKRGWKURZVWKHVDPHH[FHSWLRQV
DVWKHULVN\PHWKRG\RX·UHFDOOLQJ G U \ P HW K
7KHGR/DXQ WLRQEXWE\GHFODULQJW
HS
YRLGIRRWKURZV&ORWKLQJ([FHSWLRQ^ &ORWKLQJ([F IRRPHWKRGJHWVWR
KH
ODXQGU\GR/DXQGU\ H[FHSWLRQW SWLRQ1RWU\FDWFK
H H [ FH
` GXFNWK
%XWQRZWKLVPHDQVWKDWZKRHYHUFDOOVWKHIRRPHWKRG
KDVWRIROORZWKH+DQGOHRU'HFODUHODZ,IIRRGXFNV
WKHH[FHSWLRQE\GHFODULQJLWDQGPDLQFDOOVIRRWKHQ
PDLQKDVWRGHDOZLWKWKHH[FHSWLRQ
SXEOLFFODVV:DVKHU^
/DXQGU\ODXQGU\ QHZ/DXQGU\
SXEOLFYRLGIRRWKURZV&ORWKLQJ([FHSWLRQ^
ODXQGU\GR/DXQGU\
` 7528%/(
H
R Q ·W F R P SLOHDQGZHUURU
Z LRQ µ
1RZPDLQXQUHSRUWHGH[FHSWFRQFHUQHG
:DVKHUD QHZ:DVKHU
DQ ´
JHW DVWKHFRPSLOH VDQ U ·V
DIRR
` $VIDU PHWKRGWKURZ
` %HFDXVHWKHIRRPH WKRGGXFN WKHIRR Q
&ORWKLQJ([FHSWLRQWKURZQE VWKH H[FHSWLR
\GR/DXQGU\
PDLQKDVWRZUDSDIRR
LQDWU\FDWFK
RUPDLQKDVWRGHFODUHW
KDW
WKURZV&ORWKLQJ([FHSWLRQ LWWRR
\RXDUHKHUH
IL[LQJWKH6HTXHQFHUFRGH
/M\\QVOJIKS\WW]ZU][QKKWLM
.OWTHATYOUVECOMPLETELYFORGOTTENWESTARTEDTHISCHAPTER
WITHAlRSTLOOKATSOME*AVA3OUNDCODE7ECREATEDA3E
QUENCEROBJECTBUTITWOULDNTCOMPILEBECAUSETHEMETHOD
-IDIGET3EQUENCER DECLARESACHECKEDEXCEPTION-IDI5NAVAIL
ABLE%XCEPTION "UTWECANlXTHATNOWBYWRAPPINGTHECALLINA

HTXHQFHU
TRYCATCH
OO LQ J J H W6
FD WU\
1RSUREOHP H·YHZUDSSHGLWLQD
W Z
QRZWKD
SXEOLFYRLGSOD\^
N
WU\^
FDWFKEORF
6\VWHPRXWSULQWOQ³6XFFHVVIXOO\JRWDVHTXHQFHU´
7KHFDW
`FDWFK0LGL8QDYDLODEOH([FHSWLRQH[^ WKH¶ULJ FKSDUDPHWHUK
K D
6\VWHPRXWSULQWOQ³%XPPHU´ ¶FDWFK) W·H[FHSWLRQ,I VWREH
FRGHZR LOH 1 RW) ZHVDLG
` XOGQRW RXQG([FHSWLRQ
PRUSKLF FRPSLOH IWKH
`FORVHSOD\ D
ZRQ·WI OO\D0LGL8QDY EHFDXVHSRO\
LWLQWRD LO
5HPHPE )LOH1RW DEOH([FHSWLRQ
H )RXQG(
FDWFKE ULW·VQRWHQRX [FHSWLRQ

ORFN\ J K W RKDYHD
WKLQJEH RXKDYH
LQJWKUR WRFDWF
ZQ KWKH
-`KMX\QWV:]TM[
<RXFDQQRWKDYHDFDWFKRUÀQDOO\ $WU\0867EHIROORZHGE\HLWKHUD
ZLWKRXWDWU\ FDWFKRUDÀQDOO\ /( *$/
YRLGJR^ $/
127/(* WU\" WU\^ KDYHDI EHFDXVH\RX
LQ
)RRI QHZ)RR
:KHUH·VW K H [GR6WXII WKRXJKW DOO\HYHQ
KHUH·VQR
IIRRI `¿QDOO\^ %XW\RX FDWFK
F
FDWFK)RR([FHSWLRQH[^` FOHDQXS WU\E\LW DQQRWKDYHD
` ` VHOI
<RXFDQQRWSXWFRGHEHWZHHQWKH $WU\ZLWKRQO\DÀQDOO\QRFDWFK

WU\DQGWKHFDWFK PXVWVWLOOGHFODUHWKHH[FHSWLRQ
(*$ 127/
FRGHEHWZH / <RXFDQ·WSXW
WU\^ YRLGJRWKURZV)RR([FHSWLRQ^
H K
WKHFDWFK QWKHWU\DQG RXWDFDWF
[GR6WXII WU\^
[GR6WXII $WU\ZLWK
`
LVI\WKH
LQW\ `¿QDOO\^` GRHVQ·WVDW HFODUHODZ
G
`FDWFK([FHSWLRQH[^` ` KDQGOHRU
FKDSWHU
H[FHSWLRQKDQGOLQJ
Code Kitchen
7KHUHLV12ZD\
%XWZK\GRQ·W ,·POHWWLQJ%HWW\ZLQWKH
\RXMXVWXVH FRGHRIIWKLV\HDUVR,·P
5HDG\EDNHFRGH" JRQQDPDNHLWP\VHOIIURP
VFUDWFK
You donÕt have to do it

yourself, but itÕs a lot
more fun if you do.
The rest of this chapter
is optional; you can use
Ready-bake code for all
the music apps.
But if you want to learn
more about JavaSound,
turn the page.
\RXDUHKHUH
-DYD6RXQG0,',FODVVHV
5ISQVOIK\]IT[W]VL
2EMEMBERNEARTHEBEGINNINGOFTHECHAPTERWELOOKEDATHOW-)$)DATAHOLDS
THEINSTRUCTIONSFORWHATSHOULDBEPLAYEDANDHOWITSHOULDBEPLAYED ANDWE
ALSOSAIDTHAT-)$)DATADOESNTACTUALLYCREATEANYSOUNDTHATYOUHEAR&ORSOUND
TOCOMEOUTOFTHESPEAKERSTHE-)$)DATAHASTOBESENTTHROUGHSOMEKINDOF
-)$)DEVICETHATTAKESTHE-)$)INSTRUCTIONSANDRENDERSTHEMINSOUNDEITHER
BYTRIGGERINGAHARDWAREINSTRUMENTORA@VIRTUALINSTRUMENTSOFTWARESYNTHE
SIZER )NTHISBOOKWEREUSINGONLYSOFTWAREDEVICESSOHERESHOWITWORKSIN
*AVA3OUND
<RXQHHG)285WKLQJV
7KHWKLQJWKDW 7KHPXVLFWREH 7KHSDUWRIWKH 7KHDFWXDOPXVLF

SOD\VWKHPXVLF SOD\HGDVRQJ 6HTXHQFHWKDW LQIRUPDWLRQ
KROGVWKHDFWXDO QRWHVWRSOD\
LQIRUPDWLRQ KRZORQJHWF
0LGL
SOD\V KDVD KROGV (YHQW
6HTXHQFHU 6HTXHQFH 7UDFN
0LGL
&ORTHISBOOKWEONLY (YHQW
NEEDONE4RACKSOJUST
IMAGINEAAMUSIC#$
WITHONLYONESONG!
SINGLE4RACK4HIS4RACK 0LGL
ISWHEREALLTHESONG (YHQW
4HE3EQUENCEISTHE DATA-)$)INFORMATION
SONGTHEMUSICALPIECE LIVES
4HE3EQUENCERISTHETHING THATTHE3EQUENCERWILL 0LGL
THATACTUALLYCAUSESASONG PLAY&ORTHISBOOKTHINK (YHQW
TOBEPLAYED4HINKOFITLIKE OFTHE3EQUENCEASA
AMUSIC#$PLAYER MUSIC#$BUTTHEWHOLE !-)$)EVENTISAMESSAGE
#$PLAYSJUSTONESONG THATTHE3EQUENCERCAN
UNDERSTAND!-)$)EVENT
HDVD MIGHTSAYIFITSPOKE
R I W K H6HTXHQF 7KH %NGLISH h!TTHISMOMENT
N
ERRNWKLQ QH7UDFN
)RUWKLV J&'KDVRQO\R OD\WKHVRQJ
INTIMEPLAYMIDDLE#PLAY
ITTHISFASTANDTHISHARD
Q S
VLQJOHVR QDERXWKRZWR 7UDFNLVSDUW ANDHOLDITFORTHISLONGh
P D W LR W K H
LQIRU
Q W K H 7 UDFNDQG !-)$)EVENTMIGHT
OLYHVR TXHQFH ALSOSAYSOMETHINGLIKE
H
RIWKH6 h#HANGETHECURRENT
INSTRUMENTTO&LUTEv
FKDSWHU
H[FHSWLRQKDQGOLQJ
$QG\RXQHHG),9(VWHSV
*HWD6HTXHQFHUDQGRSHQLW
6HTXHQFHUSOD\HU 0LGL6\VWHPJHW6HTXHQFHU
SOD\HURSHQ
0DNHDQHZ6HTXHQFH
6HTXHQFHVHT QHZ6HTXHQFHWLPLQJ
*HWDQHZ7UDFNIURPWKH6HTXHQFH
7UDFNW VHTFUHDWH7UDFN
)LOOWKH7UDFNZLWK0LGL(YHQWVDQG
JLYHWKH6HTXHQFHWRWKH6HTXHQFHU
WDGGP\0LGL(YHQW
SOD\HUVHW6HTXHQFHVHT $KKKK:H
IRUJRWWRSXVKWKH
3/$<EXWWRQ<RXKDYHWR
VWDUWWKH6HTXHQFHU
8KKDWHWREUHDNLW
WR\RXEXWWKDW·VRQO\
)285VWHSV
SOD\HUVWDUW
\RXDUHKHUH
DVRXQGDSSOLFDWLRQ
AW]Z^MZaNQZ[\[W]VLXTIaMZIXX
4YPEITINANDRUNIT9OULLHEARTHESOUNDOFSOMEONEPLAYINGA
SINGLENOTEONAPIANO/+MAYBENOTSOMEONEBUTSOMETHING
'RQ·WIRUJHWWRLP
LPSRUWMDYD[VRXQGPLGL SRUWWKHPLGLSDF
NDJH
SXEOLFFODVV0LQL0LQL0XVLF$SS^

0LQL0LQL0XVLF$SSPLQL QHZ0LQL0LQL0XVLF$SS
PLQLSOD\
`FORVHPDLQ
QLW
Licensed by
SXEOLFYRLGSOD\^
T X H Q F H U DQGRSH XHQFHU
JHWD6H QXVHLWD6HT Q
D
WU\^ VRZHF RPHDOUHDG\RSH
Q ·W F
6HTXHQFHUSOD\HU 0LGL6\VWHPJHW6HTXHQFHU GRHV
Eduard Simons

SOD\HURSHQ
W K H D U J XPHQWVWRWKH N
DER XW WKLQ

6HTXHQFHVHT QHZ6HTXHQFH6HTXHQFH334 'RQ·WZRUU\ UXFWRU-XVWFRS\WKHVH
VW

6HTXHQFHFRQ \EDNHDUJXPHQWV
104038
H DG
RI¶HPDV5

7UDFNWUDFN VHTFUHDWH7UDFN
$VNWKH6HTXHQFHIRUD
7
7UDFNOLYHVLQWKH6HTXH UDFN5HPHPEHUWKH
QFHDQGWKH0,',GDW
OLYHVLQWKH7UDFN D
6KRUW0HVVDJHD QHZ6KRUW0HVVDJH

DVHW0HVVDJH
0LGL(YHQWQRWH2Q QHZ0LGL(YHQWD 3XWVRPH0LGL(YHQWVLQWRWKH7UDFN7
WUDFNDGGQRWH2Q KLVSDUW
LVPRVWO\5HDG\EDNHFRGH7KHRQO\
WKLQJ\RX·OO
KDYHWRFDUHDERXWDUHWKHDUJXPHQWVWR
6KRUW0HVVDJHE QHZ6KRUW0HVVDJH WKH
VHW0HVVDJHPHWKRGDQGWKHDUJXPH
EVHW0HVVDJH QWVWR
WKH0LGL(YHQWFRQVWUXFWRU:H·OOORRN
0LGL(YHQWQRWH2II QHZ0LGL(YHQWE DWWKRVH
WUDFNDGGQRWH2II DUJXPHQWVRQWKHQH[WSDJH

SOD\HUVHW6HTXHQFHVHT

*LYHWKH6HTXHQFHWRWKH6HTXHQFHUOLNH
SOD\HUVWDUW SXWWLQJWKH&'LQWKH&'SOD\HU
6WDUWWKH
6HTXHQFHU
`FDWFK([FHSWLRQH[^ OLNHSXVKLQJ3
H[SULQW6WDFN7UDFH /$<
`
`FORVHSOD\
`FORVHFODVV
FKDSWHU
H[FHSWLRQKDQGOLQJ
5ISQVOI5QLQ-^MV\[WVOLI\I
!-IDI%VENTISANINSTRUCTIONFORPARTOFASONG!SERIESOF-IDI%VENTSIS
KINDOFLIKESHEETMUSICORAPLAYERPIANOROLL-OSTOFTHE-IDI%VENTSWE !-IDI%VENTSAYS
CAREABOUTDESCRIBEATHINGTODOANDTHEMOMENTINTIMETODOIT4HEMOMENT WHATTODOAND
INTIMEPARTMATTERSSINCETIMINGISEVERYTHINGINMUSIC4HISNOTEFOLLOWS
THISNOTEANDSOON!NDBECAUSE-IDI%VENTSARESODETAILEDYOUHAVETOSAY WHENTODOIT
ATWHATMOMENTTOSTARTPLAYINGTHENOTEA./4%/.EVENT ANDATWHAT
MOMENTTOSTOPPLAYINGTHENOTES./4%/&&EVENT 3OYOUCANIMAGINE %VERYINSTRUCTION
THATlRINGTHEhSTOPPLAYINGNOTE'v./4%/&&MESSAGE BEFORETHEhSTART
PLAYING.OTE'v./4%/. MESSAGEWOULDNTWORK MUSTINCLUDETHE
4HE-)$)INSTRUCTIONACTUALLYGOESINTOA-ESSAGEOBJECTTHE-IDI%VENTIS TIMINGFORTHAT
ACOMBINATIONOFTHE-ESSAGEPLUSTHEMOMENTINTIMEWHENTHATMESSAGE
SHOULD@lRE)NOTHERWORDSTHE-ESSAGEMIGHTSAYh3TARTPLAYING-IDDLE
INSTRUCTION
#vWHILETHE-IDI%VENTWOULDSAYh4RIGGERTHISMESSAGEATBEATv
)NOTHERWORDSAT
3OWEALWAYSNEEDA-ESSAGEANDA-IDI%VENT
4HE-ESSAGESAYSWHATTODOANDTHE-IDI%VENTSAYSWHENTODOIT
WHICHBEATTHAT
THINGSHOULDHAPPEN
0DNHD0HVVDJH

3XWWKH,QVWUXFWLRQLQWKH0HVVDJH
D UW S OD \ LQ JQRWHµ
HVD\V´VW KH
DVHW0HVVDJH
7KLVPHVVDJ WKHRWKHUQXPEHUVRQW
W
ZH·OOORRND
QH[WSDJ H
0DNHDQHZ0LGL(YHQWXVLQJWKH0HVVDJH
0LGL(YHQWQRWH2Q QHZ0LGL(YHQWD 7KHLQVWUXFWLRQVDUHLQ
W
(YHQWDGGVWKHPRPHQ KHPHVVDJHEXWWKH0LGL
WLQWLPHZKHQWKHLQVW
VKRXOGEHWULJJHUHG7 UXFWLRQ
KLV
$GGWKH0LGL(YHQWWRWKH7UDFN
PHVVDJH¶D·DWWKHILUV 0LGL(YHQWVD\VWRWULJJHU
WUDFNDGGQRWH2Q WEHDWEHDW
UJDQL]HV
YHQWREMHFWV7KH6HTXHQFHR
$7UDFNKROGVDOOWKH0LGL( QWLVVXSSRVHGWRKDSSHQDQGWKHQ
FKHYH
WKHPDFFRUGLQJWRZKHQHD LQWKDWRUGHU<RXFDQKDYHORWVRI
HP ED FN
WKH6HTXHQFHUSOD\VWK DPSOH
PHPRPHQWLQWLPH)RUH[ QW
DSS HQLQJ DW WK HH [D FW VD
HYHQWVK QGLIIHUH
SOD\HGVLPXOWDQHRXVO\RUHYH
\RXPLJKWZDQWWZRQRWHV LPH
QWVRXQGVDWWKHVDPHW
LQVWUXPHQWVSOD\LQJGLIIHUH
\RXDUHKHUH
FRQWHQWVRI D0LGLHYHQW
51,1UM[[IOM"\PMPMIZ\WNI5QLQ-^MV\
!-)$)MESSAGEHOLDSTHEPARTOFTHEEVENTTHATSAYSWHATTODO4HEACTUALINSTRUCTION
YOUWANTTHESEQUENCERTOEXECUTE4HElRSTARGUMENTOFANINSTRUCTIONISALWAYSTHETYPE
OFTHEMESSAGE4HEVALUESYOUPASSTOTHEOTHERTHREEARGUMENTSDEPENDONTHETYPEOF
MESSAGE&OREXAMPLEAMESSAGEOFTYPEMEANSh./4%/.v"UTINORDERTOCARRY
OUTA./4%/.THESEQUENCERNEEDSTOKNOWAFEWTHINGS)MAGINETHESEQUENCERSAYING
h/+)LLPLAYANOTEBUTWHICHCHANNEL)NOTHERWORDSDOYOUWANTMETOPLAYA$RUM
NOTEORA0IANONOTE!NDWHICHNOTE-IDDLE #$3HARP!NDWHILEWEREATITATWHICH
VELOCITYSHOULD)PLAYTHENOTE
4OMAKEA-)$)MESSAGEMAKEA3HORT-ESSAGEINSTANCEANDINVOKESET-ESSAGE PASSING
INTHEFOURARGUMENTSFORTHEMESSAGE"UTREMEMBERTHEMESSAGESAYSONLYWHATTODOSO
YOUSTILLNEEDTOSTUFFTHEMESSAGEINTOANEVENTTHATADDSWHENTHATMESSAGESHOULD@lRE
$QDWRP\RIDPHVVDJH
4HE-ESSAGESAYSWHATTODOTHE
7KHÀUVWDUJXPHQWWRVHW0HVVDJHDOZD\V
UHSUHVHQWVWKHPHVVDJH¶W\SH·ZKLOHWKHRWKHU -IDI%VENTSAYSWHENTODOIT
WKUHHDUJXPHQWVUHSUHVHQWGLIIHUHQWWKLQJV
GHSHQGLQJRQWKHPHVVDJHW\SH
SH \
W\ QHO WRSOD LW\
&KDQQHO
J H
VD KDQ RWH HORF
PHV F Q Y 7KLQNRIDFKDQQHOOLNHDPXVLFLDQLQ
DVHW0HVVDJH DEDQG&KDQQHOLVPXVLFLDQWKH
7KHODVWD NH\ERDUGSOD\HUFKDQQHOLVWKH
W\SH7KLVLVDUJVYDU\GHSHQGLQJRQWKH GUXPPHUHWF
RWKHUDUJVDUH 127(21PHVVDJHVRWPHVVDJH
WRNQRZLQRU IRUWKLQJVWKH6HTXHQF KH
GHUWRSOD\D HUQHHGV
QRWH 1RWHWRSOD\
$QXPEHUIURPWRJRLQJ
0HVVDJHW\SH IURPORZWRKLJKQRWHV
PHDQV
127(21

\LQJ
OD
VWD UWS
PHDQV
127(2))
9HORFLW\
+RZ IDVW DQG KDUG GLG
\RX SUHVV WKH NH\" LVVRVRIW\RX
\LQJ
RS SOD SUREDEO\ZRQ·WKHDUDQ\WKLQJEXWLVD
VW JRRGGHIDXOW
FKDSWHU
H[FHSWLRQKDQGOLQJ
+PIVOMIUM[[IOM
.OWTHATYOUKNOWWHATSINA-IDIMESSAGEYOUCANSTARTEXPERIMENTING9OU
CANCHANGETHENOTETHATSPLAYEDHOWLONGTHENOTEISHELDADDMORENOTES
ANDEVENCHANGETHEINSTRUMENT
&KDQJHWKHQRWH
7U\DQXPEHUEHWZHHQDQGLQWKHQRWH
RQDQGQRWHRIIPHVVDJHV

DVHW0HVVDJH

&KDQJHWKHGXUDWLRQRIWKHQRWH
&KDQJHWKHQRWHRIIHYHQWQRWWKHPHVVDJHVR
WKDWLWKDSSHQVDWDQHDUOLHURUODWHUEHDW
EVHW0HVVDJH
0LGL(YHQWQRWH2II QHZ0LGL(YHQWE
&KDQJHWKHLQVWUXPHQW
$GGDQHZPHVVDJH%()25(WKHQRWHSOD\LQJPHVVDJH
WKDWVHWVWKHLQVWUXPHQWLQFKDQQHOWRVRPHWKLQJRWKHU
WKDQWKHGHIDXOWSLDQR7KHFKDQJHLQVWUXPHQWPHVVDJH
LV¶·DQGWKHWKLUGDUJXPHQWUHSUHVHQWVWKHDFWXDO
LQVWUXPHQWWU\DQXPEHUEHWZHHQDQG
¿UVWVHW0HVVDJH

H V VDJH FLDQ HQW
WP XVL UXP
U X PHQ HOP WRLQVW
W Q
Q J H LQV QFKDQ
FKD L
\RXDUHKHUH
FKDQJHWKHLQVWUXPHQWDQGQRWH
>MZ[QWV"=[QVOKWUUIVLTQVMIZO[\WM`XMZQUMV\_Q\P[W]VL[
4HISVERSIONSTILLPLAYSJUSTASINGLENOTEBUTYOUGETTOUSECOMMAND LINEARGU
MENTSTOCHANGETHEINSTRUMENTANDNOTE%XPERIMENTBYPASSINGINTWOINTVALUES
FROMTO4HElRSTINTSETSTHEINSTRUMENTTHESECONDINTSETSTHENOTETOPLAY
SXEOLFFODVV0LQL0XVLF&PG/LQH^WKLVLVWKH¿UVWRQH

0LQL0XVLF&PG/LQHPLQL QHZ0LQL0XVLF&PG/LQH
LIDUJVOHQJWK^
6\VWHPRXWSULQWOQ³'RQ¶WIRUJHWWKHLQVWUXPHQWDQGQRWHDUJV´
`HOVH^
LQWLQVWUXPHQW ,QWHJHUSDUVH,QWDUJV>@
LQWQRWH ,QWHJHUSDUVH,QWDUJV>@
PLQLSOD\LQVWUXPHQWQRWH
`
`FORVHPDLQ
SXEOLFYRLGSOD\LQWLQVWUXPHQWLQWQRWH^
WU\^

6HTXHQFHUSOD\HU 0LGL6\VWHPJHW6HTXHQFHU
SOD\HURSHQ
6HTXHQFHVHT QHZ6HTXHQFH6HTXHQFH334

0LGL(YHQWHYHQW QXOO
6KRUW0HVVDJH¿UVW QHZ6KRUW0HVVDJH
¿UVWVHW0HVVDJHLQVWUXPHQW
0LGL(YHQWFKDQJH,QVWUXPHQW QHZ0LGL(YHQW¿UVW
WUDFNDGGFKDQJH,QVWUXPHQW
6KRUW0HVVDJHD QHZ6KRUW0HVVDJH 5XQLWZLWKWZRLQWDUJVIURP

DVHW0HVVDJHQRWH WR7U\WKHVHIRUVWDUWHUV
0LGL(YHQWQRWH2Q QHZ0LGL(YHQWD
WUDFNDGGQRWH2Q )LOH(GLW:LQGRZ+HOS$WWHQXDWH
MDYD0LQL0XVLF&PG/LQH
6KRUW0HVVDJHE QHZ6KRUW0HVVDJH
EVHW0HVVDJHQRWH MDYD0LQL0XVLF&PG/LQH
WUDFNDGGQRWH2II MDYD0LQL0XVLF&PG/LQH
SOD\HUVHW6HTXHQFHVHT
SOD\HUVWDUW
`FDWFK([FHSWLRQH[^H[SULQW6WDFN7UDFH`

`FORVHSOD\
`FORVHFODVV
FKDSWHU
H[FHSWLRQKDQGOLQJ
:KHUHZH·UHKHDGHGZLWKWKHUHVW
RIWKH&RGH.LWFKHQV
&KDSWHUWKHJRDO
:KHQZH·UHGRQHZH·OOKDYHDZRUNLQJ
%HDW%R[WKDW·VDOVRD'UXP&KDW&OLHQW
:H·OOQHHGWROHDUQDERXW*8,VLQFOXG
GDQFHEHDW
LQJHYHQWKDQGOLQJ,2QHWZRUNLQJDQG
WKUHDGV7KHQH[WWKUHHFKDSWHUV
DQGZLOOJHWXVWKHUH
$QG\JURRYH
&KULVJURRYHUHYLVHG
1LJHOGDQFHEHDW
&KDSWHU0,',HYHQWV
7KLV&RGH.LWFKHQOHWVXVEXLOGDOLWWOH
´PXVLFYLGHRµELWRIDVWUHWFKWRFDOOLW
WKDWWKDWGUDZVUDQGRPUHFWDQJOHVWR
WKHEHDWRIWKH0,',PXVLF:H·OOOHDUQ
KRZWRFRQVWUXFWDQGSOD\DORWRI0,',
HYHQWVLQVWHDGRIMXVWDFRXSOHDVZHGR EHDWRQH EHDWWZR EHDWWKUHH EHDWIRXU
LQWKHFXUUHQWFKDSWHU
&KDSWHU6WDQGDORQH
%HDW%R[
1RZZH·OODFWXDOO\EXLOGWKHUHDO%HDW%R[
*8,DQGDOO%XWLW·VOLPLWHG³DVVRRQDV\RX
FKDQJHDSDWWHUQWKHSUHYLRXVRQHLVORVW
7KHUH·VQR6DYHDQG5HVWRUHIHDWXUHDQG
LWGRHVQ·WFRPPXQLFDWHZLWKWKHQHWZRUN
%XW\RXFDQVWLOOXVHLWWRZRUNRQ\RXU
GUXPSDWWHUQVNLOOV
&KDSWHU6DYHDQG
5HVWRUH
<RX·YHPDGHWKHSHUIHFWSDWWHUQDQG
QRZ\RXFDQVDYHLWWRDÀOHDQGUHORDGLW
ZKHQ\RXZDQWWRSOD\LWDJDLQ7KLVJHWV
XVUHDG\IRUWKHÀQDOYHUVLRQFKDSWHU
ZKHUHLQVWHDGRIZULWLQJWKHSDWWHUQWRD
ÀOHZHVHQGLWRYHUDQHWZRUNWRWKHFKDW
VHUYHU
\RXDUHKHUH
H[HUFLVH7UXHRU)DOVH
4HISCHAPTEREXPLOREDTHEWONDERFULWORLDOF
EXCEPTIONS9OURJOBISTODECIDEWHETHEREACHOFTHE
FOLLOWINGEXCEPTION RELATEDSTATEMENTSISTRUEORFALSE
1dQÔU_Q
&=[^N X[ /JU\N'
!TRYBLOCKMUSTBEFOLLOWEDBYACATCHANDAlNALLYBLOCK
)FYOUWRITEAMETHODTHATMIGHTCAUSEACOMPILER CHECKEDEXCEPTIONYOU

MUSTWRAPTHATRISKYCODEINATRYCATCHBLOCK
#ATCHBLOCKSCANBEPOLYMORPHIC
/NLY@COMPILERCHECKEDEXCEPTIONSCANBECAUGHT
)FYOUDElNEATRYCATCHBLOCKAMATCHINGlNALLYBLOCKISOPTIONAL
)FYOUDElNEATRYBLOCKYOUCANPAIRITWITHAMATCHINGCATCHORlNALLYBLOCK
ORBOTH
)FYOUWRITEAMETHODTHATDECLARESTHATITCANTHROWACOMPILER CHECKEDEX
CEPTIONYOUMUSTALSOWRAPTHEEXCEPTIONTHROWINGCODEINATRYCATCHBLOCK
4HEMAIN METHODINYOURPROGRAMMUSTHANDLEALLUNHANDLEDEXCEPTIONS
THROWNTOIT
!SINGLETRYBLOCKCANHAVEMANYDIFFERENTCATCHBLOCKS
!METHODCANONLYTHROWONEKINDOFEXCEPTION
!lNALLYBLOCKWILLRUNREGARDLESSOFWHETHERANEXCEPTIONISTHROWN
!lNALLYBLOCKCANEXISTWITHOUTATRYBLOCK
!TRYBLOCKCANEXISTBYITSELFWITHOUTACATCHBLOCKORAlNALLYBLOCK
(ANDLINGANEXCEPTIONISSOMETIMESREFERREDTOAS@DUCKING
4HEORDEROFCATCHBLOCKSNEVERMATTERS
!METHODWITHATRYBLOCKANDAlNALLYBLOCKCANOPTIONALLYDECLARETHE
EXCEPTION
2UNTIMEEXCEPTIONSMUSTBEHANDLEDORDECLARED
FKDSWHU
H[FHSWLRQKDQGOLQJ
Code Magnets
!WORKING*AVAPROGRAMISSCRAMBLEDUPONTHEFRIDGE#ANYOU
1dQÔU_Q RECONSTRUCTALLTHECODESNIPPETSTOMAKEAWORKING*AVAPROGRAM
THATPRODUCESTHEOUTPUTLISTEDBELOW3OMEOFTHECURLYBRACESFELL
ONTHEFLOORANDTHEYWERETOOSMALLTOPICKUPSOFEELFREETOADDAS
MANYOFTHOSEASYOUNEED
WU\^
U´
6\VWHPRXWSULQW´
6\VWHPRXWSULQW
´W´
GR5LVN\WHVW
6\VWHPRXWSULQWOQ´V´ `ÀQDOO\^
6\VWHPRXWSULQW´R´
FODVV0\([H[WHQGV([FHSWLRQ^`

SXEOLFFODVV([7HVW'ULYH^
QW´Z´
6\VWHPRXWSUL
LI´\HV
µHTXDOV
W^
6\VWHPRXWSULQW´D´
WKURZQHZ0\([ `FDWFK0\([H

^
VWDWLFYRLGGR5LVN\6WULQJWWKURZV0\([^

6\VWHPRXWSULQW´Kµ
)LOH(GLW:LQGRZ+HOS7KURZ8S
MDYD([7HVW'ULYH\HV JV ^
PDLQ6WULQJ>@DU
WKDZV SXEOLFVWDWLFYRLG
JV>@
MDYD([7HVW'ULYHQR 6WULQJWHVW DU
WKURZV
\RXDUHKHUH
SX]]OHFURVVZRUG
-DYD&URVV

9OUKNOWWHATTODO

!CROSS #LASSHIERARCHY $OWN *AVACSAWITCOMING

4OGIVEVALUE 4OOHOTTOHANDLE #URRENTLYUSABLE !TTEMPTRISK
&LEWOFFTHETOP #OMMONPRIMITIVE 4EMPLATESCREATION !UTOMATICACQUISITION
!LLTHISANDMORE #ODERECIPE $ONTSHOWTHEKIDS #HANGINGMETHOD
3TART 5NRULYMETHODACTION -OSTLYSTATIC!0)CLASS !NNOUNCEADUCK
4HEFAMILYTREE .O0ICASSOHERE .OTABOUTBEHAVIOR $EALWITHIT
.ODUCKING 3TARTACHAINOFEVENTS 4HETEMPLATE #REATEBADNEWS
0ROBLEMOBJECTS 2OLLANOTHERONEOFF /NEOFMYROLES
THELINE
/NEOF*AVAS@
.OT!BSTRACT )NSTEADOFDECLARE
-ORE(INTS .UMBERS
&OR??????NOTEXAMPLE .OTA@GETTER 3TARTSAPROBLEM 3TARTAMETHOD
/RAMOUTHWASH ?????THEFAMILYFORTUNE 1UACK !*AVACHILD
$OWN /NLYPUBLICORDEFAULT !LSOATYPEOFCOLLECTION !CROSS
FKDSWHU
H[FHSWLRQKDQGOLQJ
%XERCISE3OLUTIONS
Code Magnets
FODVV0\([H[WHQGV([FHSWLRQ^`
SXEOLFFODVV([7HVW'ULYH^
=[^N X[ /JU\N SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^

6WULQJWHVW DUJV>@
WU\^
&ALSEEITHERORBOTH
&ALSEYOUCANDECLARETHEEXCEPTION 6\VWHPRXWSULQW´Wµ
4RUE GR5LVN\WHVW

&ALSERUNTIMEEXCEPTIONCANBECAUGHT
6\VWHPRXWSULQW´Rµ
4RUE
`FDWFK0\([H^
4RUEBOTHAREACCEPTABLE
&ALSETHEDECLARATIONISSUFlCIENT 6\VWHPRXWSULQW´Dµ
&ALSEBUTIFITDOESNTTHE*6-MAYSHUT `ÀQDOO\^

DOWN
4RUE 6\VWHPRXWSULQW´Zµ
`
&ALSE 6\VWHPRXWSULQWOQ´Vµ
`
4RUE)TSOFTENUSEDTOCLEAN UPPARTIALLY
COMPLETEDTASKS VWDWLFYRLGGR5LVN\6WULQJWWKURZV0\([^
&ALSE 6\VWHPRXWSULQW´Kµ
&ALSE LI´\HVµHTXDOVW^

&ALSEDUCKINGISSYNONOMOUSWITHDECLAR
WKURZQHZ0\([
ING
`
&ALSEBROADESTEXCEPTIONSMUSTBECAUGHT
BYTHELASTCATCHBLOCKS 6\VWHPRXWSULQWÚµ
&ALSEIFYOUDONTHAVEACATCHBLOCKYOU `

MUSTDECLARE ` )LOH(GLW:LQGRZ+HOS&KLOO
&ALSE MDYD([7HVW'ULYH\HV
WKDZV
MDYD([7HVW'ULYHQR
WKURZV
\RXDUHKHUH
SX]]OHDQVZHUV
-DYD&URVV$QVZHUV

$66,*10(17
$66,*10(173233('

0&15

Licensed by
$268%&/$66,192.(

73779&

+,(5$5&+<$+$1'/(/
11+77$
Eduard Simons

6&(7(;&(37,216
7(&516

$6.(<:25'+
104038

1(((75((

77'8&.&57

,17$$/*25,7+0

$(,7$75

7+52:6&21&5(7(2

($+(1(:
FKDSWHU
JHWWLQJJXL
$9HU\*UDSKLF
6WRU\
:RZ7KLVORRNVJUHDW
,KHDUG\RXU
,JXHVVSUHVHQWDWLRQ
H[ZLIHFRXOGRQO\FRRN
UHDOO\LVHYHU\WKLQJ
FRPPDQGOLQHPHDOV
)DFHLW\RXQHHGWRPDNH*8,V)FYOUREBUILDINGAPPLICATIONSTHATOTHER
PEOPLEAREGOINGTOUSEYOUNEEDAGRAPHICALINTERFACE)FYOUREBUILDINGPROGRAMSFORYOURSELF
YOUWANTAGRAPHICALINTERFACE%VENIFYOUBELIEVETHATTHERESTOFYOURNATURALLIFEWILLBE
SPENTWRITINGSERVER SIDECODEWHERETHECLIENTUSERINTERFACEISAWEBPAGESOONERORLATER
YOULLNEEDTOWRITETOOLSANDYOULLWANTAGRAPHICALINTERFACE3URECOMMAND LINEAPPSARE
RETROBUTNOTINAGOODWAY4HEYREWEAKINFLEXIBLEANDUNFRIENDLY7ELLSPENDTWOCHAPTERS
WORKINGON'5)SANDLEARNKEY*AVALANGUAGEFEATURESALONGTHEWAYINCLUDING%VENT
(ANDLINGAND)NNER#LASSES)NTHISCHAPTERWELLPUTABUTTONONTHESCREENANDMAKEITDO
SOMETHINGWHENYOUCLICKIT7ELLPAINTONTHESCREENWELLDISPLAYAJPEGIMAGEANDWELLEVEN
DOSOMEANIMATION
WKLVLVDQHZFKDSWHU
\RXUILUVWJXL
´,I,VHHRQHPRUH
1\ITT[\IZ\[_Q\PI_QVLW_ FRPPDQGOLQHDSS
\RX·UHILUHGµ
!*&RAMEISTHEOBJECTTHATREPRESENTS
AWINDOWONTHESCREEN)TSWHEREYOU
PUTALLTHEINTERFACETHINGSLIKEBUTTONS
CHECKBOXESTEXTlELDSANDSOON)TCAN
HAVEANHONEST TO GOODNESSMENUBAR
WITHMENUITEMS!NDITHASALLTHELITTLE
WINDOWINGICONSFORWHATEVERPLATFORM
YOUREONFORMINIMIZINGMAXIMIZINGAND
CLOSINGTHEWINDOW
4HE*&RAMELOOKSDIFFERENTDEPENDINGON
THEPLATFORMYOUREON4HISISA*&RAMEON
-AC/38
U
P H Z LW K DPHQXED RQ
D-)UD ¶ZLGJHWV·DEXWW
DQGWZR LREXWWRQ
DQGDUDG
0DNLQJD*8,LVHDV\
0DNHDIUDPHD-)UDPH
-)UDPHIUDPH QHZ-)UDPH
0DNHDZLGJHWEXWWRQWH[WÀHOGHWF
-%XWWRQEXWWRQ QHZ-%XWWRQ³FOLFNPH´
8]\_QLOM\[QV\PM_QVLW_
/NCEYOUHAVEA*&RAMEYOUCANPUT $GGWKHZLGJHWWRWKHIUDPH

THINGS@WIDGETS INITBYADDINGTHEM IUDPHJHW&RQWHQW3DQHDGGEXWWRQ
TOTHE*&RAME4HEREAREATONOF3WING
COMPONENTSYOUCANADDLOOKFORTHEM <RXGRQ·WDGGWKL
INTHEJAVAXSWINGPACKAGE4HEMOST GLUHFWO\7KLQNRI QJVWRWKHIUDPH
COMMONINCLUDE*"UTTON*2ADIO"UTTON WULPDURXQGWKHZWKHIUDPHDVWKH
*#HECK"OX*,ABEL*,IST*3CROLL0ANE
WKLQJVWRWKHZLQGRLQGRZDQG\RXDGG
*3LIDER*4EXT!REA*4EXT&IELDAND ZSDQH
*4ABLE-OSTAREREALLYSIMPLETOUSEBUT
SOMELIKE*4ABLE CANBEABITMORE
COMPLICATED 'LVSOD\LWJLYHLWDVL]HDQGPDNHLWYLVLEOH
IUDPHVHW6L]H
IUDPHVHW9LVLEOHWUXH
FKDSWHU
JHWWLQJJXL
AW]ZNQZ[\/=1"IJ]\\WVWVINZIUM
KLV
GRQ·WIRUJHWWRLPSRUWW
LPSRUWMDYD[VZLQJ
VZLQJSDFNDJH
SXEOLFFODVV6LPSOH*XL^
WWRQ
H D I UD P HDQGDEX
PDN QFRQVWUXFWRU
-)UDPHIUDPH QHZ-)UDPH \RXFDQSDVVWKHEXWRQWRWKHEXWWRQ
WKHWH[W\RXZDQW
IUDPHVHW'HIDXOW&ORVH2SHUDWLRQ-)UDPH(;,7B21B&/26(
WKLVOLQHPDNHVWK URJU
FORVHWKHZLQGRZLHS
I \R
DPTXLWDVVRRQDV\RX
XO
MXVWVLWWKHUHRQWKHVFUH HDYHWKLVRXWLWZLOO
IUDPHJHW&RQWHQW3DQHDGGEXWWRQ HQIRUHYHU
DGGWKHEXWWRQWR
FRQWHQWSDQH WKHIUDPH·V
IUDPHVHW6L]H
JLYHWKHIU
DPHDVL]H
IUDPHVHW9LVLEOHWUXH
LQSL[HOV
`
`
ILQDOO\PDNHLWYLVLE
WKLVVWHS\RXZRQ·WOH
VHH
LI\RXIRUJHW
\RXUXQWKLVFRGH D Q\WKLQJZKHQ
/HW·VVHHZKDWKDSSHQVZKHQZHUXQLW
MDYD6LPSOH*XL
:KRD7KDW·VD
5HDOO\%LJ%XWWRQ
7KHEXWWRQÀOOVDOOWKH
DYDLODEOHVSDFHLQWKHIUDPH
/DWHUZH·OOOHDUQWRFRQWURO
ZKHUHDQGKRZELJWKH
EXWWRQLVRQWKHIUDPH
\RXDUHKHUH
XVHULQWHUIDFHHYHQWV
WKHUH DUH QR
'XPE 4XHVWLRQV
*]\VW\PQVOPIXXMV[_PMV1KTQKSQ\
Q: 7ILLABUTTONLOOKLIKEA
7INDOWSBUTTONWHENYOURUNON
4HATSNOTEXACTLYTRUE7HENYOUPRESSTHEBUTTONITSHOWSTHAT 7INDOWS
@PRESSEDOR@PUSHEDINLOOKWHICHCHANGESDEPENDINGONTHE
PLATFORMLOOKANDFEELBUTITALWAYSDOESSOMETHINGTOSHOWWHEN
ITSBEINGPRESSED
A: )FYOUWANTITTO9OUCAN
CHOOSEFROMAFEWhLOOKAND
4HEREALQUESTIONISh(OWDO)GETTHEBUTTONTODOSOMETHING FEELSvCLASSESINTHECORELIBRARY
SPECIlCWHENTHEUSERCLICKSITv THATCONTROLWHATTHEINTERFACELOOKS
LIKE)NMOSTCASESYOUCANCHOOSE
BETWEENATLEASTTWODIFFERENTLOOKS
THESTANDARD*AVALOOKANDFEELALSO
:HQHHGWZRWKLQJV KNOWNAS-ETALANDTHENATIVELOOK
ANDFEELFORYOURPLATFORM4HE-AC

$PHWKRGWREHFDOOHGZKHQWKHXVHU /38SCREENSINTHISBOOKUSEEITHER
THE/38!QUALOOKANDFEELORTHE
FOLFNVWKHWKLQJ\RXZDQWWRKDSSHQDV -ETALLOOKANDFEEL
DUHVXOWRIWKHEXWWRQFOLFN
$ZD\WRNQRZZKHQWRWULJJHU
Q: #AN)MAKEAPROGRAMLOOK
LIKE!QUAALLTHETIME%VENWHEN
WKDWPHWKRG,QRWKHUZRUGVDZD\ ITSRUNNINGUNDER7INDOWS
WRNQRZZKHQWKHXVHUFOLFNVWKH
EXWWRQ
A: .OPE.OTALLLOOKANDFEELS
AREAVAILABLEONEVERYPLATFORM)F
YOUWANTTOBESAFEYOUCANEITHER
EXPLICITLYSETTHELOOKANDFEELTO
-ETALSOTHATYOUKNOWEXACTLYWHAT
YOUGETREGARDLESSOFWHERETHEAPP
ISRUNNINGORDONTSPECIFYALOOK
ANDFEELANDACCEPTTHEDEFAULTS
Q: )HEARD3WINGWASDOG SLOW
ANDTHATNOBODYUSESIT
:KHQWKHXVHUFOLFNVZHZDQW
WRNQRZ
A: 4HISWASTRUEINTHEPAST
BUTISNTAGIVENANYMORE/NWEAK
MACHINESYOUMIGHTFEELTHEPAINOF
:H·UHLQWHUHVWHGLQWKHXVHU 3WING"UTONTHENEWERDESKTOPS
ANDWITH*AVAVERSIONANDBE
WDNHVDFWLRQRQDEXWWRQHYHQW YONDYOUMIGHTNOTEVENNOTICETHE
DIFFERENCEBETWEENA3WING'5)AND
ANATIVE'5)3WINGISUSEDHEAVILY
TODAYINALLSORTSOFAPPLICATIONS
FKDSWHU
JHWWLQJJXL
/M\\QVOI][MZM^MV\ )LUVWWKHEXWWRQQHHGVWRNQRZ
)MAGINEYOUWANTTHETEXTONTHEBUTTONTO WKDWZHFDUH
CHANGEFROMCLICKMETO)VEBEENCLICKEDWHEN
THEUSERPRESSESTHEBUTTON&IRSTWECANWRITEA
METHODTHATCHANGESTHETEXTOFTHEBUTTONA
QUICKLOOKTHROUGHTHE!0)WILLSHOWYOUTHE

+H\EXWWRQ,FDUHDERXW
METHOD ZKDWKDSSHQVWR\RX
SXEOLFYRLGFKDQJH,W^
EXWWRQVHW7H[W³,¶YHEHHQFOLFNHG´
` \RXUFRGH
W
HF
EX
"UTNOWWHAT(OWWILLWEKNOWWHENTHIS
WWRQREM
METHODSHOULDRUN(OWWILLWEKNOWWHENTHE
BUTTONISCLICKED
7KHXVHUFOLFNHGPH
)N*AVATHEPROCESSOFGETTINGANDHANDLINGA
USEREVENTISCALLEDEVENT HANDLING4HEREARE 6HFRQGWKHEXWWRQQHHGVDZD\
MANYDIFFERENTEVENTTYPESIN*AVAALTHOUGH
WRFDOOXVEDFNZKHQDEXWWRQ
MOSTINVOLVE'5)USERACTIONS)FTHEUSERCLICKS
ABUTTONTHATSANEVENT!NEVENTTHATSAYS FOLFNHGHYHQWRFFXUV
h4HEUSERWANTSTHEACTIONOFTHISBUTTONTO
HAPPENv)FITSAh3LOW4EMPOvBUTTONTHEUSER
WANTSTHESLOW TEMPOACTIONTOOCCUR)FITSA
3ENDBUTTONONACHATCLIENTTHEUSERWANTSTHE
SEND MY MESSAGEACTIONTOHAPPEN3OTHEMOST
STRAIGHTFORWARDEVENTISWHENTHEUSERCLICKED
YiXè
THEBUTTONINDICATINGTHEYWANTANACTIONTO gfn\i
OCCUR
7ITHBUTTONSYOUUSUALLYDONTCAREABOUTANY
INTERMEDIATEEVENTSLIKEBUTTON IS BEING PRESSED (OWCOULDYOUTELLABUTTONOBJECTTHATYOU
ANDBUTTON IS BEING RELEASED7HATYOUWANTTO CAREABOUTITSEVENTS4HATYOUREACONCERNED
SAYTOTHEBUTTONISh)DONTCAREHOWTHEUSER LISTENER
PLAYSWITHTHEBUTTONHOWLONGTHEYHOLDTHE
MOUSEOVERITHOWMANYTIMESTHEYCHANGETHEIR
(OWWILLTHEBUTTONCALLYOUBACK!SSUME
MINDANDROLLOFFBEFORELETTINGGOETC*USTTELL
THATTHERESNOWAYFORYOUTOTELLTHEBUTTONTHE
MEWHENTHEUSERMEANSBUSINESS)NOTHERWORDS NAMEOFYOURUNIQUEMETHODCHANGE)T 3O
DONTCALLMEUNLESSTHEUSERCLICKSINAWAYTHAT WHATELSECANWEUSETOREASSURETHEBUTTONTHAT
INDICATESHEWANTSTHEDARNBUTTONTODOWHATIT WEHAVEASPECIFICMETHODITCANCALLWHENTHE
SAYSITLLDOv EVENTHAPPENS;HINTTHINK0ET=
\RXDUHKHUH
HYHQWOLVWHQHUV
,I \RXFDUHDERXWWKHEXWWRQ·VHYHQWV
LPSOHPHQWDQLQWHUIDFHWKDWVD\V
´,·POLVWHQLQJIRU\RXUHYHQWVµ
$OLVWHQHULQWHUIDFHLVWKHEULGJHEHWZHHQWKH :KHQ\RXLPSOHPHQWD
OLVWHQHU\RXDQGHYHQWVRXUFHWKHEXWWRQ OLVWHQHULQWHUIDFH\RXJLYH
4HE3WING'5)COMPONENTSAREEVENTSOURCES)N*AVATERMS WKHEXWWRQDZD\WRFDOO
ANEVENTSOURCEISANOBJECTTHATCANTURNUSERACTIONSCLICK \RXEDFN7KHLQWHUIDFHLV
AMOUSETYPEAKEYCLOSEAWINDOW INTOEVENTS!NDLIKE
VIRTUALLYEVERYTHINGELSEIN*AVAANEVENTISREPRESENTEDASAN ZKHUHWKHFDOOEDFNPHWKRG
OBJECT!NOBJECTOFSOMEEVENTCLASS)FYOUSCANTHROUGHTHE LVGHFODUHG
JAVAAWTEVENTPACKAGEINTHE!0)YOULLSEEABUNCHOFEVENT
CLASSESEASYTOSPOTTHEYALLHAVE%VENTINTHENAME 9OULL
lND-OUSE%VENT+EY%VENT7INDOW%VENT!CTION%VENTAND
SEVERALOTHERS LQ
W
$FWL HUIDFH!
RQ/
!NEVENTSOURCELIKEABUTTON CREATESANEVENTOBJECTWHENTHE DFWLR LVWHQ !
Q3HU HU
USERDOESSOMETHINGTHATMATTERSLIKECLICKTHEBUTTON -OST I
RUPH
G$F
OFTHECODEYOUWRITEANDALLTHECODEINTHISBOOK WILLRECEIVE WLRQ(Y
HQWH
EVENTSRATHERTHANCREATEEVENTS)NOTHERWORDSYOULLSPEND Y
MOSTOFYOURTIMEASANEVENTLISTENERRATHERTHANANEVENTSOURCE
%VERYEVENTTYPEHASAMATCHINGLISTENERINTERFACE)FYOUWANT
FH!!
-OUSE%VENTSIMPLEMENTTHE-OUSE,ISTENERINTERFACE7ANT LQWHUID U
QH
7INDOW%VENTS)MPLEMENT7INDOW,ISTENER9OUGETTHEIDEA ,WHP/LVWH
(YHQWHY
!NDREMEMBERYOURINTERFACERULESTOIMPLEMENTANINTERFACE &KDQ JHG,WHP
LWHP6WDWH
YOUDECLARETHATYOUIMPLEMENTITCLASS$OGIMPLEMENTS0ET
WHICHMEANSYOUMUSTWRITEIMPLEMENTATIONMETHODSFOREVERY
METHODINTHEINTERFACE
LQWHU
IDF
3OMEINTERFACESHAVEMORETHANONEMETHODBECAUSETHE .H\/LV H!!
EVENTITSELFCOMESINDIFFERENTmAVORS)FYOUIMPLEMENT WHQHU
NH\3UH
-OUSE,ISTENERFOREXAMPLEYOUCANGETEVENTSFOR VVHG.
H\(YHQ
NH\5HOH WHY
MOUSE0RESSEDMOUSE2ELEASEDMOUSE-OVEDETC%ACHOF DVHG.
H\(YHQ
NH\7\S WHY
THOSEMOUSEEVENTSHASASEPARATEMETHODINTHEINTERFACE HG.H\
(YHQWH
EVENTHOUGHTHEYALLTAKEA-OUSE%VENT)FYOUIMPLEMENT Y
-OUSE,ISTENERTHEMOUSE0RESSED METHODISCALLEDWHENTHE

USERYOUGUESSEDIT PRESSESTHEMOUSE!NDWHENTHEUSERLETS
GOTHEMOUSE2ELEASED METHODISCALLED3OFORMOUSEEVENTS
THERESONLYONEEVENTOBJECT-OUSE%VENTBUTSEVERALDIFFERENT
EVENTMETHODSREPRESENTINGTHEDIFFERENTTYPESOFMOUSEEVENTS
FKDSWHU
JHWWLQJJXL
+RZWKHOLVWHQHUDQGVRXUFH
FRPPXQLFDWH
´%XWWRQSOHDVHDGGPHWR
\RXUOLVWRIOLVWHQHUVDQGFDOO
P\DFWLRQ3HUIRUPHGPHWKRG
ZKHQWKHXVHUFOLFNV\RXµ
´2.\RX·UHDQ$FWLRQ/LVWHQHU
VR,NQRZKRZWRFDOO\RXEDFN
ZKHQWKHUH·VDQHYHQW,·OOFDOO
WKHDFWLRQ3HUIRUPHGPHWKRG
WKDW,NQRZ\RXKDYHµ
FWLRQ/LVWHQHUW
G G$ KLV
QD
W WR
EX

D F WLR HQW
Q3 H UIRU P H G WKH ( Y
The Listener The Event Source

)FYOURCLASSWANTSTOKNOWABOUT !BUTTONISASOURCEOF!CTION%VENTS
ABUTTONS!CTION%VENTSYOU SOITHASTOKNOWWHICHOBJECTSARE
IMPLEMENTTHE!CTION,ISTENER INTERESTEDLISTENERS4HEBUTTONHASAN
INTERFACE4HEBUTTONNEEDSTO ADD!CTION,ISTENER METHODTOGIVE
KNOWYOUREINTERESTEDSOYOU INTERESTEDOBJECTSLISTENERS AWAYTO
REGISTERWITHTHEBUTTONBYCALLINGITS TELLTHEBUTTONTHEYREINTERESTED
ADD!CTION,ISTENERTHIS ANDPASSINGAN
7HENTHEBUTTONS
!CTION,ISTENERREFERENCETOITINTHISCASE
ADD!CTION,ISTENER RUNSBECAUSE
YOUARETHE!CTION,ISTENERSOYOUPASS
APOTENTIALLISTENERINVOKEDIT THE
THIS 4HEBUTTONNEEDSAWAYTOCALLYOU
BUTTONTAKESTHEPARAMETERA
BACKWHENTHEEVENTHAPPENSSOITCALLS
REFERENCETOTHELISTENEROBJECT AND
THEMETHODINTHELISTENERINTERFACE!SAN
STORESITINALIST7HENTHEUSERCLICKS
!CTION,ISTENERYOUMUSTIMPLEMENTTHE
THEBUTTONTHEBUTTON@lRESTHEEVENT
INTERFACESSOLEMETHODACTION0ERFORMED
BYCALLINGTHEACTION0ERFORMED
4HECOMPILERGUARANTEESIT
METHODONEACHLISTENERINTHELIST
\RXDUHKHUH
JHWWLQJHYHQWV
*HWWLQJDEXWWRQ·V$FWLRQ(YHQW
,PSOHPHQWWKH$FWLRQ/LVWHQHULQWHUIDFH
5HJLVWHUZLWKWKHEXWWRQWHOOLW\RX
ZDQWWROLVWHQIRUHYHQWV
'HÀQHWKHHYHQWKDQGOLQJPHWKRGLPSOHPHQW
WKHDFWLRQ3HUIRUPHGPHWKRGIURPWKH
$FWLRQ/LVWHQHULQWHUUIDFH

UWV WDWH P HQ WIR UWKHSDFNDJHWKDW
LPSRUWMDYD[VZLQJ
DQHZLPSR QG$FWLRQ(YHQWD
UHLQ V
$FWLRQ/LVWHQHUD 7KLVVD\
LPSRUWMDYDDZWHYHQW
U I D F H
KHLQWH ,6$

, P SOHPHQWW RI6LPSOH*XL%
SXEOLFFODVV6LPSOH*XL%LPSOHPHQWV$FWLRQ/LVWHQHU^ DQFH
-%XWWRQEXWWRQ ´DQLQVW LVWHQHUµ R
$FWLRQ/ LY H H Y H Q WVRQO\W
OJ
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ WWRQZLO WHUV
6LPSOH*XL%JXL QHZ6LPSOH*XL% 7KHEX WHQHULPSOHPHQ
LV
JXLJR $FWLRQ/
`
SXEOLFYRLGJR^
W W R Q 7 KLVVD\V
KHE X HUVµ
VWZLWKW RXUOLVWRIOLVWHQ PD
EXWWRQ QHZ-%XWWRQ³FOLFNPH´
U LQ W H U H
\RX R\ IUR
UHJLVWHU WWRQ´$GGPHW 67EHDQREMHFW
X
WRWKHE HQW\RXSDVV08 Q/LVWHQHU
EXWWRQDGG$FWLRQ/LVWHQHUWKLV

P LR
7KHDUJX LPSOHPHQWV$FW
D W
IUDPHJHW&RQWHQW3DQHDGGEXWWRQ
FODVVWK
IUDPHVHW'HIDXOW&ORVH2SHUDWLRQ-)UDPH(;,7B21B&/26( H·V
IUDPHVHW6L]H
F W LR Q / LV W H QHULQWHUIDF
H$ KH
IUDPHVHW9LVLEOHWUXH
,PSOHPHQWWK HGPHWKRG7KLVLVW
R UP
DFWLRQ3HUI KDQGOLQJPHWKRG
`

DFWXDOHYHQW
SXEOLFYRLGDFWLRQ3HUIRUPHG$FWLRQ(YHQWHYHQW^
EXWWRQVHW7H[W³,¶YHEHHQFOLFNHG´
` 7KHEXWWRQFDOOVWKLVP
` HWKRGWROHW\R XNQRZDQHY
KDSSHQHG,WVHQGV\RXD
Q$FWLRQ(YHQWREMHFWDV HQW
DUJXPHQWEXWZHGRQ·W WKH
QHH
KDSSHQHGLVHQRXJKLQIR GLW.QRZLQJWKHHYHQW
IRUXV
FKDSWHU
JHWWLQJJXL
4Q[\MVMZ[;W]ZKM[IVL-^MV\[
&ORMOSTOFYOURSTELLAR*AVACAREERYOUWILLNOTBETHESOURCE
OFEVENTS
.OMATTERHOWMUCHYOUFANCYYOURSELFTHECENTEROFYOURSOCIAL
UNIVERSE
'ETUSEDTOIT9OURJOBISTOBEAGOODLISTENER
7HICHIFYOUDOITSINCERELYCANIMPROVEYOURSOCIALLIFE
$VDQHYHQWVRXUFHP\MRELVWR
$VDOLVWHQHUP\MRELVWR DFFHSWUHJLVWUDWLRQVIURPOLVWHQHUV
LPSOHPHQWWKHLQWHUIDFH JHWHYHQWVIURPWKHXVHUDQG
UHJLVWHUZLWKWKHEXWWRQDQG FDOOWKHOLVWHQHU·VHYHQWKDQGOLQJ
SURYLGHWKHHYHQWKDQGOLQJ PHWKRGZKHQWKHXVHUFOLFNVPH
6RXUFH6(1'6
WKHHYHQW
/LVWHQHU*(76WKH
HYHQW
+H\ZKDWDERXWPH",·PDSOD\HUWRR\RX
NQRZ$VDQHYHQWREMHFW,·PWKHDUJXPHQW
WRWKHHYHQWFDOOEDFNPHWKRGIURPWKH
LQWHUIDFHDQGP\MRELVWRFDUU\GDWDDERXW
WKHHYHQWEDFNWRWKHOLVWHQHU
(YHQWREMHFW
+2/'6'$7$
DERXWWKHHYHQW
W
(Y
HQWREMHF
\RXDUHKHUH
HYHQWKDQGOLQJ
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: 7HYCANT)BEASOURCEOFEVENTS Q: )DONTSEETHEIMPORTANCEOFTHEEVENTOBJECT
THATSPASSEDTOTHEEVENTCALL BACKMETHODS)F
A: 9OU#!.7EJUSTSAIDTHATMOSTOFTHETIME
SOMEBODYCALLSMYMOUSE0RESSEDMETHODWHAT
OTHERINFOWOULD)NEED
YOULLBETHERECEIVERANDNOTTHEORIGINATOROFTHE
EVENTATLEASTINTHEEARLYDAYSOFYOURBRILLIANT*AVA
CAREER -OSTOFTHEEVENTSYOUMIGHTCAREABOUT
ARE@FIREDBYCLASSESINTHE*AVA!0)ANDALLYOUHAVE
A: !LOTOFTHETIMEFORMOSTDESIGNSYOUDONT
NEEDTHEEVENTOBJECT)TSNOTHINGMORETHANALITTLE
TODOISBEALISTENERFORTHEM9OUMIGHTHOWEVER DATACARRIERTOSENDALONGMOREINFOABOUTTHEEVENT
DESIGNAPROGRAMWHEREYOUNEEDACUSTOMEVENTSAY "UTSOMETIMESYOUMIGHTNEEDTOQUERYTHEEVENTFOR
3TOCK-ARKET%VENTTHROWNWHENYOURSTOCKMARKET SPECIFICDETAILSABOUTTHEEVENT&OREXAMPLEIFYOUR
WATCHERAPPFINDSSOMETHINGITDEEMSIMPORTANT)N MOUSE0RESSED METHODISCALLEDYOUKNOWTHEMOUSE
Licensed by
THATCASEYOUDMAKETHE3TOCK7ATCHEROBJECTBEAN WASPRESSED"UTWHATIFYOUWANTTOKNOWEXACTLY
EVENTSOURCEANDYOUDDOTHESAMETHINGSABUTTON WHERETHEMOUSEWASPRESSED)NOTHERWORDSWHATIF
ORANYOTHERSOURCE DOESMAKEALISTENERINTERFACE YOUWANTTOKNOWTHE8AND9SCREENCOORDINATESFOR
FORYOURCUSTOMEVENTPROVIDEAREGISTRATIONMETHOD WHERETHEMOUSEWASPRESSED
ADD3TOCK,ISTENER ANDWHENSOMEBODYCALLSITADD
Eduard Simons
/RSOMETIMESYOUMIGHTWANTTOREGISTERTHESAME
THECALLERALISTENER TOTHELISTOFLISTENERS4HENWHEN
LISTENERWITHMULTIPLEOBJECTS!NONSCREENCALCULATOR
ASTOCKEVENTHAPPENSINSTANTIATEA3TOCK%VENTOBJECT
FOREXAMPLEHASNUMERICKEYSANDSINCETHEYALLDO
ANOTHERCLASSYOULLWRITE ANDSENDITTOTHELISTENERS
THESAMETHINGYOUMIGHTNOTWANTTOMAKEASEPARATE
INYOURLISTBYCALLINGTHEIRSTOCK#HANGED3TOCK%VENT
LISTENERFOREVERYSINGLEKEY)NSTEADYOUMIGHT
EV METHOD!NDDONTFORGETTHATFOREVERYEVENTTYPE
REGISTERASINGLELISTENERWITHEACHOFTHEKEYSAND
104038
THEREMUSTBEAMATCHINGLISTENERINTERFACESOYOULL
WHENYOUGETANEVENTBECAUSEYOUREVENTCALL BACK
CREATEA3TOCK,ISTENERINTERFACEWITHASTOCK#HANGED
METHODISCALLED YOUCANCALLAMETHODONTHEEVENT
METHOD
OBJECTTOFINDOUTWHOTHEREALEVENTSOURCEWAS)N
OTHERWORDSWHICHKEYSENTTHISEVENT
6KDUSHQ \RXU SHQFLO
%ACHOFTHESEWIDGETSUSERINTERFACEOBJECTS ARETHE
+RZGR\RX.12:LI
SOURCEOFONEORMOREEVENTS-ATCHTHEWIDGETSWITH DQREMHFWLVDQHYHQW
THEEVENTSTHEYMIGHTCAUSE3OMEWIDGETSMIGHTBEA VRXUFH"
SOURCEOFMORETHANONEEVENTANDSOMEEVENTSCANBE
GENERATEDBYMORETHANONEWIDGET /RRNLQWKH$3,
:LGJHWV (YHQWPHWKRGV 2./RRNIRUZKDW"

FKHFNER[ ZLQGRZ&ORVLQJ $PHWKRGWKDWVWDUWVZLWK
WH[W¿HOG DFWLRQ3HUIRUPHG ¶DGG·HQGVZLWK¶/LVWHQHU·
DQGWDNHVDOLVWHQHULQWHU
VFUROOLQJOLVW LWHP6WDWH&KDQJHG IDFHDUJXPHQW,I\RXVHH
EXWWRQ PRXVH3UHVVHG DGG.H\/LVWHQHU.H\/LVWHQHUN
GLDORJER[ NH\7\SHG \RXNQRZWKDWDFODVV

ZLWKWKLVPHWKRGLVD
UDGLREXWWRQ PRXVH([LWHG
VRXUFHRI.H\(YHQWV
PHQXLWHP IRFXV*DLQHG 7KHUH·VDQDPLQJSDWWHUQ
FKDSWHU
JHWWLQJJXL
/M\\QVOJIKS\WOZIXPQK[
.OWTHATWEKNOWALITTLEABOUTHOWEVENTSWORKWELLLEARN
MORELATER LETSGETBACKTOPUTTINGSTUFFONTHESCREEN
7ELLSPENDAFEWMINUTESPLAYINGWITHSOMEFUNWAYSTOGET
GRAPHICBEFORERETURNINGTOEVENTHANDLING
7KUHHZD\VWRSXWWKLQJVRQ\RXU*8,
3XWZLGJHWVRQDIUDPH
$GGEXWWRQVPHQXVUDGLREXWWRQVHWF
IUDPHJHW&RQWHQW3DQHDGGP\%XWWRQ
7KHMDYD[VZLQJSDFNDJHKDVPRUHWKDQDGR]HQ
ZLGJHWW\SHV
1XPEHURI+HDG
)LUVW-DYDERRNV
'UDZ'JUDSKLFVRQDZLGJHW PLVWDNHQO\
8VHDJUDSKLFVREMHFWWRSDLQWVKDSHV ERXJKWE\FRIIHH
KRXVHEDULVWDV
JUDSKLFV¿OO2YDO
<RXFDQSDLQWDORWPRUHWKDQER[HVDQGFLUFOHV
WKH-DYD'$3,LVIXOORIIXQVRSKLVWLFDWHG
JUDSKLFVPHWKRGV
DUW FKDUWVVV
VLPXODJWDPHV EXVLQH LFV
LRQVHW JUDSK
F HWF
3XWD-3(*RQDZLGJHW
<RXFDQSXW\RXURZQLPDJHVRQDZLGJHW
JUDSKLFVGUDZ,PDJHP\3LFWKLV
\RXDUHKHUH
PDNLQJDGUDZLQJSDQHO
5ISMaW]ZW_VLZI_QVO_QLOM\
)FYOUWANTTOPUTYOUROWNGRAPHICSONTHESCREENYOURBEST
BETISTOMAKEYOUROWNPAINTABLEWIDGET9OUPLOPTHATWIDGET
ONTHEFRAMEJUSTLIKEABUTTONORANYOTHERWIDGETBUTWHENIT
SHOWSUPITWILLHAVEYOURIMAGESONIT9OUCANEVENMAKETHOSE
IMAGESMOVEINANANIMATIONORMAKETHECOLORSONTHESCREEN
CHANGEEVERYTIMEYOUCLICKABUTTON
)TSAPIECEOFCAKE
0DNHDVXEFODVVRI-3DQHODQGRYHUULGHRQH
PHWKRGSDLQW&RPSRQHQW
!LLOFYOURGRAPHICSCODEGOESINSIDETHEPAINT#OMPONENT
METHOD4HINKOFTHEPAINT#OMPONENT METHODASTHEMETHOD
CALLEDBYTHESYSTEMTOSAYh(EYWIDGETTIMETOPAINTYOURSELFv
)FYOUWANTTODRAWACIRCLETHEPAINT#OMPONENT METHODWILL
HAVECODEFORDRAWINGACIRCLE7HENTHEFRAMEHOLDINGYOUR
DRAWINGPANELISDISPLAYEDPAINT#OMPONENT ISCALLEDANDYOUR
CIRCLEAPPEARS)FTHEUSERICONIlESMINIMIZESTHEWINDOWTHE
*6-KNOWSTHEFRAMENEEDShREPAIRvWHENITGETSDE ICONIlED
SOITCALLSPAINT#OMPONENT AGAIN!NYTIMETHE*6-THINKSTHE
DISPLAYNEEDSREFRESHINGYOURPAINT#OMPONENT METHODWILLBE
CALLED
/NEMORETHINGYOUNEVERCALLTHISMETHODYOURSELF4HEARGUMENT
TOTHISMETHODA'RAPHICSOBJECT ISTHEACTUALDRAWINGCANVAS
THATGETSSLAPPEDONTOTHEREALDISPLAY9OUCANTGETTHISBY
YOURSELFITMUSTBEHANDEDTOYOUBYTHESYSTEM9OULLSEE
LATERHOWEVERTHATYOUCANASKTHESYSTEMTOREFRESHTHEDISPLAY
REPAINT WHICHULTIMATELYLEADSTOPAINT#OMPONENT BEING
CALLED WKHVH
LPSRUWMDYDDZW Q H HG ERWKRI LGJHW
\RX
VX E FOD VV R I-3DQHODDPZ
H M XVWOLNH
LPSRUWMDYD[VZLQJ 0DNHD XFDQDGGWRDIU QHLV\RXU
WKDW\R HOVH([FHSWWKLVR
DQ\WKLQJ RPL]HGZLGJHW
FODVV0\'UDZ3DQHOH[WHQGV-3DQHO^ RZQFXVW KRG
%LJ,P SR UW DQ W*UDSKLFVPHW
7KLVLVWKH 5FDOOWKLV\RXUVHOI7KH
SXEOLFYRLGSDLQW&RPSRQHQW*UDSKLFVJ^
<RXZLOO1(9(DQGVD\V´+HUH·VDQLFH
V\VWHPFDOOVLW VXUIDFHRIW\SH*UDSKLFV
JVHW&RORU&RORURUDQJH IUHVKGUDZLQJ DLQWRQQRZµ
WKDW\RXPD\S
,PDJLQHWKDW¶J V
J¿OO5HFW WHOOLQJLWZKDW·L
FR OR
DSDLQWLQJPDFKLQH<
RX·UH
` ZKDWVKDSHWRSDLQ UWRSDLQWZLWKDQGWKHQ
ZKHUHLWJRHVDQG W Z LW KFRRU
` KRZELJLWLVGLQDWHVIRU
FKDSWHU
JHWWLQJJXL
.]V\PQVO[\WLWQVXIQV\+WUXWVMV\
,ETSLOOKATAFEWMORETHINGSYOUCANDOINPAINT#OMPONENT
4HEMOSTFUNTHOUGHISWHENYOUSTARTEXPERIMENTINGYOURSELF
4RYPLAYINGWITHTHENUMBERSANDCHECKTHE!0)FORCLASS
'RAPHICSLATERWELLSEETHATTHERESEVENMOREYOUCANDOBESIDES
WHATSINTHE'RAPHICSCLASS
'LVSOD\D-3(* HUH
QDP HJRHVK
SXEOLFYRLGSDLQW&RPSRQHQW*UDSKLFVJ^ \RXUILOH
,PDJHLPDJH QHZ,PDJH,FRQ³FDW]LOODMSJ´JHW,PDJH
JGUDZ,PDJHLPDJHWKLV

`
7KH[\FRRUG
OHIWFRUQHUVKLQRXDWHVIRUZKHUHWKHSLFWXUH·VW
WKHOHIWHGJHRIOGJR7KLVVD\V´SL[HOVIUR RS
WRSHGJHRIWKH WKHSDQHODQGSL[HOVIURPP
UHODWLYHWRWKH SDQHOµ7KHVHQXPEHUVDUHDOZWKH
VXEFODVVQRWWKHZLGJHWLQWKLVFDVH\RXU-3DQ D\V
HQWLUHIUDPH HO
3DLQWDUDQGRPO\FRORUHGFLUFOH
RQDEODFNEDFNJURXQG
ODFN
LUH S D Q HOZLWKE
SXEOLFYRLGSDLQW&RPSRQHQW*UDSKLFVJ^ HQW
ILOOWKHHIDXOWFRORU
WKH G
J¿OO5HFWWKLVJHW:LGWKWKLVJHW+HLJKW
7KHILUVWWZRDUJVGHILQHWKH[\
XSSHUOHIW
FRUQHUUHODWLYHWRWKHSDQHOIRUZKHU
VWDUWVVRPHDQV´VWDUWSL[HO HGUDZLQJ

OHIW VIURPWKH
HGJHDQGSL[HOVIURPWKHWRSHG
LQWUHG LQW0DWKUDQGRP
RWKHUWZRDUJVVD\´0DNHWKHZLGW JHµ7KH
LQWJUHHQ LQW0DWKUDQGRP KRIWKLV
UHFWDQJOHDVZLGHDVWKHSDQHOWKLVZLG
LQWEOXH LQW0DWKUDQGRP
PDNHWKHKHLJKWDVWDOODVWKHSDQHO WKDQG
WKLVKHLJKWµ
&RORUUDQGRP&RORU QHZ&RORUUHGJUHHQEOXH
JVHW&RORUUDQGRP&RORU
<RXFDQP
WRUHSUHVHQDWNHDFRORUE\SDVVLQJ
J¿OO2YDO
` W L KH5*%YDOX QLQWV
VWDUW HV
WKHWRSPSD L[HOVIURPWKHOHIW
SL[HOVWNHLWSL[HOVZLGIURP
DOO HDQG
\RXDUHKHUH
GUDZLQJJUDGLHQWVZLWK*UDSKLFV'
*MPQVLM^MZaOWWL/ZIXPQK[ZMNMZMVKM
Q[I/ZIXPQK[,WJRMK\
4HEARGUMENTTOPAINT#OMPONENT ISDECLAREDASTYPE
'RAPHICSJAVAAWT'RAPHICS
SXEOLFYRLGSDLQW&RPSRQHQW*UDSKLFVJ^` 0HWKRGV\RXFDQFDOORQD

*UDSKLFVUHIHUHQFH
3OTHEPARAMETER@G)3 !'RAPHICSOBJECT7HICHMEANSIT GUDZ,PDJH
COULDBEASUBCLASSOF'RAPHICSBECAUSEOFPOLYMORPHISM GUDZ/LQH
!NDINFACTITIS
GUDZ3RO\JRQ
4HEOBJECTREFERENCEDBYTHE@GPARAMETERISACTUALLYAN GUDZ5HFW
INSTANCEOFTHE'RAPHICS$CLASS
GUDZ2YDO
7HYDOYOUCARE"ECAUSETHEREARETHINGSYOUCANDOWITH
¿OO5HFW
A'RAPHICS$REFERENCETHATYOUCANTDOWITHA'RAPHICS
REFERENCE!'RAPHICS$OBJECTCANDOMORETHANA'RAPHICS ¿OO5RXQG5HFW
OBJECTANDITREALLYISA'RAPHICS$OBJECTLURKINGBEHINDTHE VHW&RORU
'RAPHICSREFERENCE
2EMEMBERYOURPOLYMORPHISM4HECOMPILERDECIDESWHICH
METHODSYOUCANCALLBASEDONTHEREFERENCETYPENOTTHE 7RFDVWWKH*UDSKLFV'REMHFWWR
OBJECTTYPE)FYOUHAVEA$OGOBJECTREFERENCEDBYAN!NIMAL D*UDSKLFV'UHIHUHQFH
REFERENCEVARIABLE
*UDSKLFV'JG *UDSKLFV'J
$QLPDOD QHZ'RJ
9OUCAN./4SAY
DEDUN
0HWKRGV\RXFDQFDOORQ
%VENTHOUGHYOUKNOWITSREALLYA$OGBACKTHERE4HE D*UDSKLFV'UHIHUHQFH
COMPILERLOOKSAT@ASEESTHATITSOFTYPE!NIMALANDlNDS
THATTHERESNOREMOTECONTROLBUTTONFORBARK INTHE!NIMAL ¿OO'5HFW
CLASS"UTYOUCANSTILLGETTHEOBJECTBACKTOTHE$OGITREALLYIS GUDZ'5HFW
BYSAYING
URWDWH
'RJG 'RJD
GEDUN VFDOH
3OTHEBOTTOMLINEWITHTHE'RAPHICSOBJECTISTHIS VKHDU
)FYOUNEEDTOUSEAMETHODFROMTHE'RAPHICS$CLASSYOU WUDQVIRUP

CANTUSETHETHEPAINT#OMPONENTPARAMETER@G STRAIGHT VHW5HQGHULQJ+LQWV
FROMTHEMETHOD"UTYOUCANCASTITWITHANEW'RAPHICS$
VARIABLE
WKHVHDUHQRWFRPSOHWHPHWKRGOLVWV
FKHFNWKH$3,IRUPRUH
FKDSWHU
JHWWLQJJXL
*MKI][MTQNM¼[\WW[PWZ\\WXIQV\\PM
KQZKTMI[WTQLKWTWZ_PMV\PMZM¼[I
OZILQMV\JTMVL_IQ\QVONWZaW]
REMHFWV
UDSKLFVU'H*
* KLF
LW·VU DGLQJDVDPH UDS
HD OO \ D
PDVTXHU
REMHFW

FDVWLWVRZHFDQFDOOVRPHWKLQJWKDW
*UDSKLFV'KDVEXW*UDSKLFVGRHVQ·W
*UDGLHQW3DLQWJUDGLHQW QHZ*UDGLHQW3DLQW&RORUEOXH&RORURUDQJH
VWDUWLQ VWDUWLQ HQGLQJ
JSRLQW JFRORU HQGLQJS FRORU
RLQW

WKLVVHWVWKHYLUWXDOSDLQ
WEUXVKWRD
JGVHW3DLQWJUDGLHQW JUDGLHQWLQVWHDGRI DVROLGFRORU
JG¿OO2YDO
LOO
HDOO\PHDQVR´QI\RXU
`
O P HW K RGU
WKHILOO2YDZLWKZKDWHYHULVORDGHG
WKHRYDO LHWKHJUDGLHQWµ
SDLQWEUXVK
ERYH
LQWUHG LQW0DWKUDQGRP LV MX VW O LN HWKHRQRHPDFRORUVIRU
WKLV WPDNHVUDQG VRIWKH
H[FHSWLUWDQGVWRSFRORU
LQWJUHHQ LQW0DWKUDQGRP
WKHVWD W7U\LW
LQWEOXH LQW0DWKUDQGRP
JUDGLHQ
&RORUVWDUW&RORU QHZ&RORUUHGJUHHQEOXH
UHG LQW0DWKUDQGRP

JUHHQ LQW0DWKUDQGRP
EOXH LQW0DWKUDQGRP
&RORUHQG&RORU QHZ&RORUUHGJUHHQEOXH
*UDGLHQW3DLQWJUDGLHQW QHZ*UDGLHQW3DLQWVWDUW&RORUHQG&RORU

JGVHW3DLQWJUDGLHQW
JG¿OO2YDO
`
\RXDUHKHUH
HYHQWVDQGJUDSKLFV
:MDD=LHGAFLK
=N=FLK ?J9H@A;K
7RPDNHD*8,VWDUWZLWKDZLQGRZXVXDOO\D-)UDPH <RXFDQGUDZ'JUDSKLFVGLUHFWO\RQWRDZLGJHW
<RXFDQGUDZDJLIRUMSHJGLUHFWO\RQWRDZLGJHW
<RXFDQDGGZLGJHWVEXWWRQVWH[WILHOGVHWFWRWKH
-)UDPHXVLQJ 7RGUDZ\RXURZQJUDSKLFVLQFOXGLQJDJLIRUMSHJ
IUDPHJHW&RQWHQW3DQHDGGEXWWRQ PDNHDVXEFODVVRI-3DQHODQGRYHUULGHWKHSDLQW&RP
SRQHQWPHWKRG
8QOLNHPRVWRWKHUFRPSRQHQWVWKH-)UDPHGRHVQ·WOHW
\RXDGGWRLWGLUHFWO\VR\RXPXVWDGGWRWKH-)UDPH·V 7KHSDLQW&RPSRQHQWPHWKRGLVFDOOHGE\WKH*8,
FRQWHQWSDQH V\VWHP<281(9(5&$//,7<2856(/)7KHDUJX
PHQWWRSDLQW&RPSRQHQWLVD*UDSKLFVREMHFWWKDW
7RPDNHWKHZLQGRZ-)UDPHGLVSOD\\RXPXVWJLYHLW JLYHV\RXDVXUIDFHWRGUDZRQZKLFKZLOOHQGXSRQ
DVL]HDQGWHOOLWEHYLVLEOH WKHVFUHHQ<RXFDQQRWFRQVWUXFWWKDWREMHFW\RXUVHOI
IUDPHVHW6L]H
IUDPHVHW9LVLEOHWUXH 7\SLFDOPHWKRGVWRFDOORQD*UDSKLFVREMHFWWKHSDLQW
&RPSRQHQWSDUDPHQWHUDUH
7RNQRZZKHQWKHXVHUFOLFNVDEXWWRQRUWDNHVVRPH JUDSKLFVVHW&RORU&RORUEOXH
RWKHUDFWLRQRQWKHXVHULQWHUIDFH\RXQHHGWROLVWHQIRU J¿OO5HFW
D*8,HYHQW
7RGUDZDMSJFRQVWUXFWDQ,PDJHXVLQJ
7ROLVWHQIRUDQHYHQW\RXPXVWUHJLVWHU\RXULQWHUHVW ,PDJHLPDJH QHZ,PDJH,FRQ³FDW]LOOD
ZLWKDQHYHQWVRXUFH$QHYHQWVRXUFHLVWKHWKLQJEXW MSJ´JHW,PDJH
WRQFKHFNER[HWFWKDW¶ILUHV·DQHYHQWEDVHGRQXVHU DQGGUDZWKHLPDJLQHXVLQJ
LQWHUDFWLRQ JGUDZ,PDJHLPDJHWKLV
7KHOLVWHQHULQWHUIDFHJLYHVWKHHYHQWVRXUFHDZD\ 7KHREMHFWUHIHUHQFHGE\WKH*UDSKLFVSDUDPHWHU
WRFDOO\RXEDFNEHFDXVHWKHLQWHUIDFHGHILQHVWKH WRSDLQW&RPSRQHQWLVDFWXDOO\DQLQVWDQFHRIWKH
PHWKRGVWKHHYHQWVRXUFHZLOOFDOOZKHQDQHYHQW *UDSKLFV'FODVV7KH*UDSKLFV'FODVVKDVDYDULHW\
KDSSHQV RIPHWKRGVLQFOXGLQJ
¿OO'5HFWGUDZ'5HFWURWDWHVFDOHVKHDU
7RUHJLVWHUIRUHYHQWVZLWKDVRXUFHFDOOWKHVRXUFH·V WUDQVIRUP
UHJLVWUDWLRQPHWKRG5HJLVWUDWLRQPHWKRGVDOZD\VWDNH
WKHIRUPRIDGG(YHQW7\SH!/LVWHQHU7RUHJLVWHUIRUD 7RLQYRNHWKH*UDSKLFV'PHWKRGV\RXPXVWFDVWWKH
EXWWRQ·V$FWLRQ(YHQWVIRUH[DPSOHFDOO SDUDPHWHUIURPD*UDSKLFVREMHFWWRD*UDSKLFV'
EXWWRQDGG$FWLRQ/LVWHQHUWKLV REMHFW
,PSOHPHQWWKHOLVWHQHULQWHUIDFHE\LPSOHPHQWLQJDOORI
WKHLQWHUIDFH·VHYHQWKDQGOLQJPHWKRGV3XW\RXUHYHQW
KDQGOLQJFRGHLQWKHOLVWHQHUFDOOEDFNPHWKRG)RU
$FWLRQ(YHQWVWKHPHWKRGLV
SXEOLFYRLGDFWLRQ3HUIRUPHG$FWLRQ(YHQW
HYHQW^
EXWWRQVHW7H[W³\RXFOLFNHG´
`
7KHHYHQWREMHFWSDVVHGLQWRWKHHYHQWKDQGOHUPHWKRG
FDUULHVLQIRUPDWLRQDERXWWKHHYHQWLQFOXGLQJWKHVRXUFH
RIWKHHYHQW
FKDSWHU
JHWWLQJJXL
?MKIVOM\IVM^MV\
?MKIVXIQV\OZIXPQK[
*]\KIV_MXIQV\OZIXPQK[_PMV_MOM\IVM^MV\'
,ETSHOOKUPANEVENTTOACHANGEINOURDRAWINGPANEL7ELLMAKETHECIRCLE
CHANGECOLORSEACHTIMEYOUCLICKTHEBUTTON(ERESHOWTHEPROGRAMmOWS
6WDUWWKHDSS
7KHIUDPHLVEXLOWZLWKWKHWZRZLGJHWV
\RXUGUDZLQJSDQHODQGDEXWWRQ$
OLVWHQHULVFUHDWHGDQGUHJLVWHUHGZLWK
WKHEXWWRQ7KHQWKHIUDPHLVGLVSOD\HG
DQGLWMXVWZDLWVIRUWKHXVHUWRFOLFN
7KHXVHUFOLFNVWKHEXWWRQDQGWKH
EXWWRQFUHDWHVDQHYHQWREMHFWDQG
FDOOVWKHOLVWHQHU·VHYHQWKDQGOHU
7KHHYHQWKDQGOHUFDOOVUHSDLQWRQWKH
IUDPH7KHV\VWHPFDOOVSDLQW&RPSRQHQW
RQWKHGUDZLQJSDQHO
9RLOD$QHZFRORULVSDLQWHGEHFDXVH
SDLQW&RPSRQHQWUXQVDJDLQÀOOLQJWKH
FLUFOHZLWKDUDQGRPFRORU
\RXDUHKHUH
EXLOGLQJD*8,IUDPH
:DLWDPLQXWHKRZ
GR\RXSXW7:2
WKLQJVRQDIUDPH"
/=1TIaW]\["X]\\QVOUWZM\PIVWVM
_QLOM\WVINZIUM
7ECOVER'5)LAYOUTSINTHENEXTCHAPTERBUTWELLDOA
QUICKIELESSONHERETOGETYOUGOING"YDEFAULTAFRAME
HASlVEREGIONSYOUCANADDTO9OUCANADDONLYONETHING
TOEACHREGIONOFAFRAMEBUTDONTPANIC4HATONETHING
MIGHTBEAPANELTHATHOLDSTHREEOTHERTHINGSINCLUDINGA
PANELTHATHOLDSTWOMORETHINGSANDYOUGETTHEIDEA)N
FACTWEWERE@CHEATINGWHENWEADDEDABUTTONTOTHEFRAME
USING
7KLVLVQ·W
VX D OO \ WRGRLWWUKHDOO\WKHZD\\RX
G X HRQHDUJ ·U
HWWHUD Q UDPH·V DGGPHWHKVXR SSRVHG
7KLVLVWRKUH\EZD\WRDGGWRDD\I VSHFLI \ G
PDQGDW FRQWHQWSDQH$OZ ZVDQWWKH
GHIDXOW ZKLFKUHJLRQ\RX IUDPHJHW&RQWHQW3DQHDGG%RUGHU/D\RXW&(17(5EXWWRQ
:+(5( RJR
ZLGJH W W JDGG
\ R X F D OO W KHVLQJOHXDOGUQ·WXVH ZHFDOOWKHWZRDUJXP
:KHQ WKHRQHZHVKR OO\ODQGLQ HQWDGGPHWKRG
P H W K R G DXWR P D W LF D WK DWWDNHVDUHJLRQXVLQ
LG J H W Z LO O DQ G WKHZLGJHWWRDGGWRJDFRQVWDQW
WKHZ WHUUHJVLRQ QRUWK WKDWUHJLRQ
WKHFHQ
HDVW
GHIDXOWUHJLRQ ZHVW FHQWHU 6KDUSHQ \RXU SHQFLO
*LYHQWKHSLFWXUHVRQSDJHZULWHWKH
FRGHWKDWDGGVWKHEXWWRQDQGWKHSDQHOWR
WKHIUDPH
VRXWK
FKDSWHU
JHWWLQJJXL
7KHFLUFOHFKDQJHVFRORUHDFKWLPH\RX 7KHFXVW
LQVWDQFHRRPGUDZLQJSDQHO
FOLFNWKHEXWWRQ LVLQWKH& I0\'UDZ3DQHO
RIWKHIUD(17(5UHJLRQ
PH
LPSRUWMDYD[VZLQJ
LPSRUWMDYDDZW
LPSRUWMDYDDZWHYHQW
SXEOLFFODVV6LPSOH*XL&LPSOHPHQWV$FWLRQ/LVWHQHU^
-)UDPHIUDPH
LQWKH
%XWWRQLVUHJLRQRI
6LPSOH*XL&JXL QHZ6LPSOH*XL&
6287+ PH
JXLJR
`
WKHIUD
SXEOLFYRLGJR^
IUDPH QHZ-)UDPH
LV
VWHQHUWK
$GGWKHEXOLWWRQ
-%XWWRQEXWWRQ QHZ-%XWWRQ³&KDQJHFRORUV´
WRWKH
0\'UDZ3DQHOGUDZ3DQHO QHZ0\'UDZ3DQHO
$GGWKHWZRZL HWV
WRQDQGGUDZLQJGJ

EXW
IUDPHJHW&RQWHQW3DQHDGG%RUGHU/D\RXW6287+EXWWRQ
WK SDQHOWR
IUDPHJHW&RQWHQW3DQHDGG%RUGHU/D\RXW&(17(5GUDZ3DQHO HWZRUHJLRQVRIWKH
IUDPHVHW6L]H IUDPH
IUDPHVHW9LVLEOHWUXH
`
IUDPHUHSDLQW
` NVWHOOWKHIUDPH
` :KHQWKHXVHUFOLF 7KDWPHDQV HOI
WRUHSDLQWLWV QW LVFDOOHGRQHYH
U\
SDLQ W& RP SR QH
PH
ZLGJHWLQWKHIUD
FODVV0\'UDZ3DQHOH[WHQGV-3DQHO^
7KHGUDZ
SXEOLFYRLGSDLQW&RPSRQHQW*UDSKLFVJ^ PHWKRGLVLQFDJS DQHO·VSDLQW&R
OOHGHYHU\W PSRQHQ
&RGHWR¿OOWKHRYDOZLWKDUDQGRPFRORU FOLFNV LPHWKHXVHUW
6HHSDJHIRUWKHFRGH
`
\RXDUHKHUH
PXOWLSOHOLVWHQHUV
4M\¼[\ZaQ\_Q\P<?7J]\\WV[
4HESOUTHBUTTONWILLACTASITDOESNOWSIMPLYCALLINGREPAINTONTHE
FRAME4HESECONDBUTTONWHICHWELLSTICKINTHEEASTREGION WILL
CHANGETHETEXTONALABEL!LABELISJUSTTEXTONTHESCREEN
;WVW__MVMML.7=:_QLOM\[
QRUWK
Licensed by ZHVW FHQWHU

HDVW
EXWWR
KDQJLQ
J H
DO EHOFQZLOOEHKHU
ODEHOZLOO
Eduard Simons
JRKHUH
GUDZLQJSDQHOJRHV
LQWKHFHQWHU
VRXWK
104038 FRORUFKDQJLQJ
EXWWRQZLOOJRKHUH
)VL_MVMML\WOM\
<?7M^MV\[
5H OH
)STHATEVENPOSSIBLE(OWDO
YOUGETTWOEVENTSWHENYOU
HAVEONLYONEACTION0ERFORMED
METHOD
7KLVEXWWRQFKDQJHVWKHWH[W
RQWKHRSSRVLWHVLGH
7KLVEXWWRQFKDQJHVWKHFRORU
RIWKHFLUFOH
FKDSWHU
JHWWLQJJXL
0W_LWaW]OM\IK\QWVM^MV\[NWZ\ _WLQNNMZMV\J]\\WV[
_PMVMIKPJ]\\WVVMML[\WLW[WUM\PQVOLQNNMZMV\'
RSWLRQRQH
,PSOHPHQWWZRDFWLRQ3HUIRUPHGPHWKRGV
FODVV0\*XLLPSOHPHQWV$FWLRQ/LVWHQHU^
ORWVRIFRGHKHUHDQGWKHQ
IUDPHUHSDLQW %XWWKLVLVLPSRVVLEOH
`
ODEHOVHW7H[W³7KDWKXUW´
`
`
)ODZ<RXFDQ·W9OUCANTIMPLEMENTTHESAMEMETHODTWICEINA*AVACLASS)TWONTCOMPILE
!NDEVENIFYOUCOULDHOWWOULDTHEEVENTSOURCEKNOWWHICHOFTHETWOMETHODSTOCALL
RSWLRQWZR
5HJLVWHUWKHVDPHOLVWHQHUZLWKERWKEXWWRQV
FODVV0\*XLLPSOHPHQWV$FWLRQ/LVWHQHU^
GHFODUHDEXQFKRILQVWDQFHYDULDEOHVKHUH
SXEOLFYRLGJR^
EXLOGJXL
FRORU%XWWRQ QHZ-%XWWRQ
ODEHO%XWWRQ QHZ-%XWWRQ
FRORU%XWWRQDGG$FWLRQ/LVWHQHUWKLV 5HJLVWHUWKHVDPHOLVWHQHU
ODEHO%XWWRQDGG$FWLRQ/LVWHQHUWKLV ZLWKERWKEXWWRQV
PRUHJXLFRGHKHUH
`
LIHYHQWJHW6RXUFH FRORU%XWWRQ^
REMHFW
IUDPHUHSDLQW 4XHU\WKHHYHZQW
KL FKEXWWRQ
`HOVH^ WRILQGRXWHGLWDQGXVH
ODEHOVHW7H[W³7KDWKXUW´ DFWXDOO\ILUFLGHZKDWWRGR
` WKDWWRGH
`
`
)ODZWKLVGRHVZRUNEXWLQPRVWFDVHVLW·VQRWYHU\22/NEEVENTHANDLER
DOINGMANYDIFFERENTTHINGSMEANSTHATYOUHAVEASINGLEMETHODDOINGMANYDIFFERENTTHINGS
)FYOUNEEDTOCHANGEHOWONESOURCEISHANDLEDYOUHAVETOMESSWITHEVERYBODYSEVENT
HANDLER3OMETIMESITISAGOODSOLUTIONBUTUSUALLYITHURTSMAINTAINABILITYANDEXTENSIBILITY
\RXDUHKHUH
PXOWLSOHOLVWHQHUV
0W_LWaW]OM\IK\QWVM^MV\[NWZ\ _WLQNNMZMV\J]\\WV[
_PMVMIKPJ]\\WVVMML[\WLW[WUM\PQVOLQNNMZMV\'
RSWLRQWKUHH
&UHDWHWZRVHSDUDWH$FWLRQ/LVWHQHUFODVVHV
FODVV0\*XL^
-)UDPHIUDPH
-/DEHOODEHO
YRLGJXL^
FRGHWRLQVWDQWLDWHWKHWZROLVWHQHUVDQGUHJLVWHURQH
ZLWKWKHFRORUEXWWRQDQGWKHRWKHUZLWKWKHODEHOEXWWRQ
`
`FORVHFODVV
FODVV&RORU%XWWRQ/LVWHQHULPSOHPHQWV$FWLRQ/LVWHQHU^
IUDPHUHSDLQW
` QFHWR
` :RQ·WZRUN7KLVFODVVGRHVQ·WKDYHDUHIHUH
WKH¶IUDPH·YDULDEOHRIWKH0\*XLFODVV
FODVV/DEHO%XWWRQ/LVWHQHULPSOHPHQWV$FWLRQ/LVWHQHU^
ODEHOVHW7H[W³7KDWKXUW´
`
` 3UREOHP7KLVFODVVKDVQRUHIHU HQFHWRWKHYDULDEOH¶ODEHO·
)ODZWKHVHFODVVHVZRQ·WKDYHDFFHVVWRWKHYDULDEOHVWKH\QHHG
WRDFWRQ¶IUDPH·DQG¶ODEHO·9OUCOULDlXITBUTYOUDHAVETOGIVEEACHOFTHE
LISTENERCLASSESAREFERENCETOTHEMAIN'5)CLASSSOTHATINSIDETHEACTION0ERFORMED
METHODSTHELISTENERCOULDUSETHE'5)CLASSREFERENCETOACCESSTHEVARIABLESOFTHE'5)
CLASS"UTTHATSBREAKINGENCAPSULATIONSOWEDPROBABLYNEEDTOMAKEGETTERMETHODS
FORTHEGUIWIDGETSGET&RAME GET,ABEL ETC !NDYOUDPROBABLYNEEDTOADDA
CONSTRUCTORTOTHELISTENERCLASSSOTHATYOUCANPASSTHE'5)REFERENCETOTHELISTENERAT
THETIMETHELISTENERISINSTANTIATED!NDWELLITGETSMESSIERANDMORECOMPLICATED
4HEREHASGOTTOBEABETTERWAY
FKDSWHU
JHWWLQJJXL
:RXOGQ·WLWEHZRQGHUIXOLI\RX
FRXOGKDYHWZRGLIIHUHQWOLVWHQHUFODVVHV
EXWWKHOLVWHQHUFODVVHVFRXOGDFFHVVWKH
LQVWDQFHYDULDEOHVRIWKHPDLQ*8,FODVV
DOPRVWDVLIWKHOLVWHQHUFODVVHVEHORQJHG
WRWKHRWKHUFODVV7KHQ\RX·GKDYHWKHEHVW
RIERWKZRUOGV<HDKWKDWZRXOGEHGUHDP\
%XWLW·VMXVWDIDQWDV\
\RXDUHKHUH
LQQHUFODVVHV
1VVMZKTI[[\W\PMZM[K]M
9OUCANHAVEONECLASSNESTEDINSIDEANOTHER)TSEASY
*USTMAKESURETHATTHEDElNITIONFORTHEINNERCLASSIS
INSIDETHECURLYBRACESOFTHEOUTERCLASS
6LPSOHLQQHUFODVV
An inner class can
FODVV0\2XWHU&ODVV^

use all the methods
\
FODVV0\,QQHU&ODVV^
Q H U F OD VVLVIXWOOHUFODVV and variables of the
,Q HGE\RX
YRLGJR^
`
HQFORV outer class, even the
` private ones.
` The inner class gets
to use those variables
and methods just
as if the methods
!NINNERCLASSGETSASPECIALPASSTOUSETHEOUTERCLASSSSTUFF%VEN
and variables were
THEPRIVATESTUFF!NDTHEINNERCLASSCANUSETHOSEPRIVATEVARIABLES declared within the
ANDMETHODSOFTHEOUTERCLASSASIFTHEVARIABLESANDMEMBERS
WEREDElNEDINTHEINNERCLASS4HATSWHATSSOHANDYABOUTINNER
inner class.
CLASSESTHEYHAVEMOSTOFTHEBENElTSOFANORMALCLASSBUTWITH
SPECIALACCESSRIGHTS
,QQHUFODVVXVLQJDQRXWHUFODVVYDULDEOH
FODVV0\2XWHU&ODVV^
SULYDWHLQW[

FODVV0\,QQHU&ODVV^
YRLGJR^ ULDEOH
[ XVH¶[·DVLILWZHVUHDYD
` RIWKHLQQHUFODV
`FORVHLQQHUFODVV
`FORVHRXWHUFODVV
FKDSWHU
JHWWLQJJXL
)VQVVMZKTI[[QV[\IVKMU][\JM\QML\W
IVW]\MZKTI[[QV[\IVKM $QLQQHUREMHFW
VKDUHVDVSHFLDO
2EMEMBERWHENWETALKABOUTANINNERCLASSACCESSING ERQGZLWKDQ
SOMETHINGINTHEOUTERCLASSWEREREALLYTALKINGABOUTAN RXWHUREMHFW
INSTANCEOFTHEINNERCLASSACCESSINGSOMETHINGINANINSTANCEOF
THEOUTERCLASS"UTWHICHINSTANCE
#ANANYARBITRARYINSTANCEOFTHEINNERCLASSACCESSTHEMETHODS
ANDVARIABLESOFANYINSTANCEOFTHEOUTERCLASS.O
!NINNEROBJECTMUSTBETIEDTOASPECIlCOUTEROBJECTON
0DNHDQLQVWDQFHRI
THEHEAP
WKHRXWHUFODVV
K
WPL ZZVS
JV

6]LY
FW
0\
2XWHUREMH
O QV
V
/M\\Q Q\P
] K P_ 0DNHDQLQVWDQFHRI
\W VM Z
WKHLQQHUFODVVE\
Q V XVLQJWKHLQVWDQFH
aW]Z [
RIWKHRXWHUFODVV
FW

0\
,QQHUREMH
KTI[
jh àke 7KHRXWHUDQGLQQHUREMHFWV
& Hg dqEg DUHQRZLQWLPDWHO\OLQNHG

<j
WKH LQW[
O O HU IURP &KDU"´
VH \
EHVW HGP
QHZ 0RY HDS
7KH ³: KR
MHFWVRQWKHK
RURI 7KHVHWZRFLREDOERQG7KHLQQHU 6WULQJV RXWH U
DXWK
KDYHDVSH RXWHU·VYDULDEOHV
FDQXVHWKHYHUVD
DQGYLFH LQQHU
7KHUH¶VDQH[FHSWLRQWRWKLVIRUDYHU\VSHFLDOFDVH²DQLQQHUFODVVGH¿QHG
ZLWKLQDVWDWLFPHWKRG%XWZH¶UHQRWJRLQJWKHUHDQG\RXPLJKWJR\RXUHQWLUH
-DYDOLIHZLWKRXWHYHUHQFRXQWHULQJRQHRIWKHVH
\RXDUHKHUH
LQQHUFODVVLQVWDQFHV
0W_\WUISMIVQV[\IVKMWNIVQVVMZKTI[[
)FYOUINSTANTIATEANINNERCLASSFROMCODEWITHINANOUTERCLASSTHEINSTANCE
OFTHEOUTERCLASSISTHEONETHATTHEINNEROBJECTWILL@BONDWITH&OR
EXAMPLEIFCODEWITHINAMETHODINSTANTIATESTHEINNERCLASSTHEINNER
OBJECTWILLBONDTOTHEINSTANCEWHOSEMETHODISRUNNING
#ODEINANOUTERCLASSCANINSTANTIATEONEOFITSOWNINNERCLASSESINEXACTLY
THESAMEWAYITINSTANTIATESANYOTHERCLASSQHZ0\,QQHU
[
FODVV0\2XWHU^ WH
ODVVKDVDSULYD
LQW
7KHRXWHUF EOH ¶ [·
SULYDWHLQW[ LQVWDQFHYDULD
gml]j
0DNHDQLQVW
LQQHUFODVV DQFHRIWKH
0\,QQHULQQHU QHZ0\,QQHU
SXEOLFYRLGGR6WXII^ 0\2XWHU
LQQHUJR
` FDOODPHWKRGRQWKH
LQQHUFODVV

FODVV0\,QQHU^
YRLGJR^
[
[ 7KHPHWKRGLQWKHLQQHUFODOH¶VVX VHVWKH
` RXWHUFODVVLQVWD QFH YD ULDE [· DVLI¶[· LQW
`FORVHLQQHUFODVV EHORQJHGWRWKHLQQHUFODVV VSHFLDO
ERQG
`FORVHRXWHUFODVV gml]j
0\2XWHU
aff]j
Side bar
9OUCANINSTANTIATEANINNERINSTANCEFROMCODERUNNINGOUTSIDETHEOUTERCLASSBUTYOU
HAVETOUSEASPECIALSYNTAX#HANCESAREYOULLGOTHROUGHYOURENTIRE*AVALIFEANDNEVER 0\,QQHU
NEEDTOMAKEANINNERCLASSFROMOUTSIDEBUTJUSTINCASEYOUREINTERESTED
FODVV)RR^
0\2XWHURXWHU2EM QHZ0\2XWHU
0\2XWHU0\,QQHULQQHU2EM RXWHU2EMQHZ0\,QQHU
`
`
FKDSWHU
JHWWLQJJXL
1RZZHFDQJHWWKHWZREXWWRQ
FRGHZRUNLQJ
RHVQ·W
SXEOLFFODVV7ZR%XWWRQV^ WKHPDLQ*8,FODRQVV/GLVWHQHUQRZ
LPSOHPHQW$FWL
-)UDPHIUDPH
-/DEHOODEHO
7ZR%XWWRQVJXL QHZ7ZR%XWWRQV
JXLJR
`
SXEOLFYRLGJR^
IUDPH QHZ-)UDPH
KH
-%XWWRQODEHO%XWWRQ QHZ-%XWWRQ³&KDQJH/DEHO´
HD G R I S DV VL QJWKLVWWRLRWQ
LQVW HUUHJLVWUD
EXWWRQ·VOLVWVVHQDQHZLQVWDQFHRI
ODEHO%XWWRQDGG$FWLRQ/LVWHQHUQHZ/DEHO/LVWHQHU
PHWKRGSD ULDWHOLVWHQHUFODVV
-%XWWRQFRORU%XWWRQ QHZ-%XWWRQ³&KDQJH&LUFOH´ WKHDSSURS
FRORU%XWWRQDGG$FWLRQ/LVWHQHUQHZ&RORU/LVWHQHU
ODEHO QHZ-/DEHO³,¶PDODEHO´

7ZR%XWWRQV
REMHFW

IUDPHJHW&RQWHQW3DQHDGG%RUGHU/D\RXW6287+FRORU%XWWRQ
IUDPHJHW&RQWHQW3DQHDGG%RUGHU/D\RXW&(17(5GUDZ3DQHO RXWHU
IUDPHJHW&RQWHQW3DQHDGG%RUGHU/D\RXW($67ODEHO%XWWRQ LQQHU
IUDPHJHW&RQWHQW3DQHDGG%RUGHU/D\RXW:(67ODEHO /DEHO/LVWHQHU
REMHFW LQQHU
IUDPHVHW6L]H &RORU/LVWHQHU
IUDPHVHW9LVLEOHWUXH REMHFW
`
1RZZHJHWQ/ WRKDYH

7: 2 $ FW LR LVWHQHUV
FODVV/DEHO/LVWHQHULPSOHPHQWV$FWLRQ/LVWHQHU^ LQDVLQJO H FO DV V
ODEHOVHW7H[W³2XFK´
` LQQHUFODVVNQ
`FORVHLQQHUFODVV DERXW¶ODEH RZV O·
FODVV&RORU/LVWHQHULPSOHPHQWV$FWLRQ/LVWHQHU^
IUDPHUHSDLQW
` WKHLQQHUFODVVJH
LQVWDQFHYDULDEO WVWRXVHWKH¶IUD
`FORVHLQQHUFODVV H Z PH·
H[SOLFLWUHIHUHQFH LWKRXWKDYLQJDQ

REMHFW W R WK HRXWHUFODVV
`
\RXDUHKHUH
LQQHUFODVVHV
,CXC'ZRQUGF
7KLVZHHNVLQWHUYLHZ
,QVWDQFHRI DQ,QQHU&ODVV
+HDG)LUVW?PI\UISM[QVVMZKTI[[M[QUXWZ\IV\' [MXIZI\MNZWUM^MZaJWLaMT[M1VVMZKTI[[M[IZMV¼\MÌK\Ta
ZM][IJTM1VNIK\1¼^MPMIZL\PMUKITTML¹:M][MTM[[¸
,QQHUREMHFW?PMZMLW1[\IZ\'?MOQ^MaW]IKPIVKM\W
][MTM[[W^MZIVLW^MZIOIQVº
QUXTMUMV\\PM[IUMQV\MZNIKMUWZM\PIVWVKMQVIKTI[[
:MUMUJMZaW]KIV¼\QUXTMUMV\IUM\PWLUWZM\PIV ,QQHUREMHFWAM[Q\¼[\Z]M\PI\\PMQVVMZKTI[[Q[VW\I[
WVKMQVIVWZUIT2IÎKTI[[*]\][QVOQVVMZKTI[[M[MIKP ZM][IJTMQVNIK\[WUM\QUM[VW\ZM][IJTMI\ITTJMKI][MQ\¼[
QVVMZKTI[[KIVQUXTMUMV\\PM[IUMQV\MZNIKM[WaW]KIV QV\QUI\MTa\QML\W\PMQV[\IVKMÎZQIJTM[IVLUM\PWL[WN
PI^MITT\PM[MLQNNMZMV\QUXTMUMV\I\QWV[WN \PM^MZa[IUM \PMW]\MZKTI[[*]\Q\¸
QV\MZNIKMUM\PWL[ +HDG)LUVW¸_PQKPWVTaXZW^M[UaXWQV\ 1N \PMa¼ZMVW\
+HDG)LUVW?Pa_W]TLaW]M^MZ_IV\\WQUXTMUMV\\PM ZM][IJTM_PaJW\PMZ_Q\PI[MXIZI\MKTI[['1UMIVW\PMZ
[IUMUM\PWL\_QKM' \PIV\PMQV\MZNIKMQ[[]M_PQKP[W]VL[TQSMI_WZSIZW]VL
\WUM
,QQHUREMHFW4M\¼[ZM^Q[Q\/=1M^MV\PIVLTMZ[<PQVS
IJW]\Q\QN aW]_IV\\PZMMJ]\\WV[\WMIKPPI^MI ,QQHUREMHFW)[1_I[[IaQVOaW]VMML\W\PQVSIJW]\
LQNNMZMV\M^MV\JMPI^QWZ\PMV][M\PZMMQVVMZKTI[[M[ITT 1;)IVLXWTaUWZXPQ[U
QUXTMUMV\QVO)K\QWV4Q[\MVMZ¸_PQKPUMIV[MIKPKTI[[ +HDG)LUVW73)VL1¼U\PQVSQVOIJW]\\PMUJMKI][M
OM\[\WQUXTMUMV\Q\[W_VIK\QWV8MZNWZUMLUM\PWL
,QQHUREMHFW*MKI][M\PMW]\MZIVLQVVMZKTI[[M[
+HDG)LUVW;WIZMM^MV\PIVLTMZ[\PMWVTaZMI[WV\W][M UQOP\VMML\WXI[[LQNNMZMV\1;)\M[\[ 4M\¼[[\IZ\_Q\P\PM
QVVMZKTI[[M[' XWTaUWZXPQK/=1TQ[\MVMZMÌUXTM?PI\¼[\PMLMKTIZML
,QQHUREMHFW7POW[PVW-^MV\PIVLTMZ[IZMR][\IV IZO]UMV\\aXMNWZ\PMJ]\\WV¼[TQ[\MVMZZMOQ[\ZI\QWV
WJ^QW][MÌUXTM)Va\QUMaW]VMMLI[MXIZI\MKTI[[J]\ UM\PWL'1VW\PMZ_WZL[QN aW]OW\W\PM)81IVLKPMKS
[\QTT_IV\\PI\KTI[[\WJMPI^MI[QN Q\_MZMXIZ\WN IVW\PMZ _PI\SQVLWN \PQVOKTI[[WZQV\MZNIKM\aXMLWaW]PI^M\W
KTI[[IVQVVMZKTI[[Q[\PMJM[\¸IVL[WUM\QUM[WVTa¸_Ia XI[[\W\PMILL)K\QWV4Q[\MVMZUM\PWL'
\WLWQ\ +HDG)LUVWAW]PI^M\WXI[[ITQ[\MVMZ;WUM\PQVO\PI\
+HDG)LUVW1¼U[\QTTKWVN][MLPMZM1N aW]_IV\\PMQVVMZ QUXTMUMV\[IXIZ\QK]TIZTQ[\MVMZQV\MZNIKMQV\PQ[KI[M
KTI[[\WJMPI^MTQSMQ\JMTWVO[\W\PMW]\MZKTI[[_PaPI^M )K\QWV4Q[\MVMZAMIP_MSVW_ITT\PQ[?PI\¼[aW]ZXWQV\'
I[MXIZI\MKTI[[QV\PMÅZ[\XTIKM'?Pa_W]TLV¼\\PMQVVMZ ,QQHUREMHFW5aXWQV\Q[\PI\XWTaUWZXPQKITTaaW]PI^M
KTI[[KWLMR][\JMQV\PMW]\MZKTI[[QV\PMÅZ[\XTIKM' IUM\PWL\PI\\ISM[WVTaWVMXIZ\QK]TIZ\aXM;WUM\PQVO
,QQHUREMHFW1R][\OI^MaW]WVM[KMVIZQW_PMZMaW] \PI\XI[[M[\PM1;)\M[\NWZ)K\QWV4Q[\MVMZ*]\¸IVL
VMMLUWZM\PIVWVMQUXTMUMV\I\QWVWN IVQV\MZNIKM*]\ PMZM¼[\PMJQO\PQVO¸_PI\QN aW]ZKTI[[VMML[\WJMIV1;
M^MV_PMVaW]¼ZMVW\][QVOQV\MZNIKM[aW]UQOP\VMML )WN [WUM\PQVO\PI\¼[IKTI[[\aXMZI\PMZ\PIVIVQV\MZNIKM'
\_WLQNNMZMV\KTI[[M[JMKI][M\PW[MKTI[[M[ZMXZM[MV\\_W +HDG)LUVW?W]TLV¼\aW]PI^MaW]ZKTI[[R][\M`\MVL\PM
LQNNMZMV\\PQVO[1\¼[OWWL77 KTI[[aW]VMML\WJMIXIZ\WN '1[V¼\\PI\\PM_PWTMXWQV\
+HDG)LUVW?PWI0WTLWVPMZM1\PW]OP\IJQOXIZ\WN WN PW_[]JKTI[[QVO_WZS['1N *Q[I[]JKTI[[WN )\PMV
77LM[QOVQ[IJW]\ZM][MIVLUIQV\MVIVKMAW]SVW_\PM IVa_PMZMIV)Q[M`XMK\MLI*KIVJM][ML<PM_PWTM
QLMI\PI\QN aW]PI^M\_W[MXIZI\MKTI[[M[\PMaKIVMIKP XI[[I,WO_PMZMIV)VQUITQ[\PMLMKTIZML\aXM\PQVO
JMUWLQÅMLIVL][MLQVLMXMVLMV\TaI[WXXW[ML\W[\]NÅVO ,QQHUREMHFWAM[ *QVOW ;WVW__PI\PIXXMV[QN aW]
Q\ITTQV\WWVMKTI[[aILIaILIaILI*]\_Q\PIVQVVMZKTI[[ VMML\WXI[[\PM1;)\M[\NWZ\_WLQNNMZMV\KTI[[M['+TI[[M[
aW]¼ZM[\QTTR][\_WZSQVO_Q\PWVMZMITKTI[[QV\PMMVLZQOP\' \PI\IZMV¼\QV\PM[IUMQVPMZQ\IVKMPQMZIZKPa'
<PMMVKTW[QVOKTI[[Q[\PMWVTaWVM\PI\¼[ZM][IJTMIVL
FKDSWHU
JHWWLQJJXL
+HDG)LUVW7P_MTTaW]R][\PUUU1\PQVS1¼UOM\ +HDG)LUVW?PW[MTQNM'AW]Z['<PMW]\MZWJRMK\'*W\P'
\QVOQ\AW]KIVIT_Ia[QUXTMUMV\UWZM\PIVWVMQV\MZNIKM ,QQHUREMHFW5QVM1KIV¼\JM\QML\WIVaW\PMZW]\MZ
J]\aW]KIVM`\MVLWVTaWVMKTI[[AW]KIVWVTaJMWVMSQVL WJRMK\5aWVTa_IaW]\Q[OIZJIOMKWTTMK\QWV
WN 1;)_PMVQ\KWUM[\WKTI[[\aXM[
+HDG)LUVW?PI\IJW]\\PMW]\MZWJRMK\'+IVQ\JM
,QQHUREMHFW?MTTLWVM AM[aW]KIV¼\JMJW\PI,WO I[[WKQI\ML_Q\PIVaW\PMZQVVMZWJRMK\['
IVLI*]\\WV*]\QN aW]¼ZMI,WO\PI\VMML[\W[WUM
\QUM[JMI*]\\WVQVWZLMZ\WXI[[aW]Z[MTN \WUM\PWL[ ,QQHUREMHFW;WVW__MPI^MQ\<PQ[Q[_PI\aW]ZMITTa
\PI\\ISMI*]\\WV\PM,WOKTI[[_PQKPM`\MVL[)VQUIT _IV\MLAM[aM[5a[WKITTML»UI\M¼KIVPI^MI[UIVa
[WQ\KIV¼\M`\MVL*]\\WVKIVPI^MIVQVVMZKTI[[\PI\IK\[ QVVMZWJRMK\[I[Q\_IV\[
WV\PM,WO¼[JMPITN I[I*]\\WVJaM`\MVLQVO*]\\WV +HDG)LUVW1[\PI\TQSM[MZQITUWVWOIUa'7ZKIVQ\PI^M
IVL\P][_PMZM^MZI*]\\WVQ[ZMY]QZML\PM,WOKIV \PMUITTI\\PM[IUM\QUM'
XI[[PQ[QVVMZ*]\\WVQV[\MILWN PQU[MTN1VW\PMZ_WZL[
,QQHUREMHFW)TTI\\PM[IUM\QUM<PMZM;I\Q[ÅML'
QV[\MILWN [IaQVO`\ISM*]\\WV\PQ[\PM,WOWJRMK\KITT[
`\ISM*]\\WVVM_5a1VVMZ*]\\WV +HDG)LUVW?MTTQ\LWM[UISM[MV[M)VLTM\¼[VW\
NWZOM\Q\_I[aW]M`\WTTQVO\PM^QZ\]M[WN ¹U]T\QXTM
+HDG)LUVW+IV1OM\IKTMIZMÌUXTM'
QUXTMUMV\I\QWV[WN \PM[IUMQV\MZNIKMº;WQ\UISM[[MV[M
,QQHUREMHFW:MUMUJMZ\PMLZI_QVOXIVMT_M][ML \PI\QN \PMW]\MZKTI[[PI[\PZMMJ]\\WV[Q\_W]TLVMML
_PMZM_MUILMW]ZW_V[]JKTI[[WN 28IVMT':QOP\VW_ \PZMMLQNNMZMV\QVVMZKTI[[M[IVL\P][\PZMMLQNNMZMV\QVVMZ
\PI\KTI[[Q[I[MXIZI\MVWVQVVMZKTI[[)VL\PI\¼[ÅVM KTI[[WJRMK\[\WPIVLTM\PMM^MV\[<PIVS[NWZM^MZa\PQVO
JMKI][M\PMKTI[[LWM[V¼\VMML[XMKQITIKKM[[\W\PMQV[\IVKM 0MZM¼[I\Q[[]M
ÎZQIJTM[WN \PMUIQV/=1*]\_PI\QN Q\LQL'?PI\QN
_M¼ZMLWQVOIVIVQUI\QWVWV\PI\XIVMTIVLQ\¼[OM\\QVOQ\[
KWWZLQVI\M[NZWU\PMUIQVIXXTQKI\QWV[IaJI[MLWV[WUM
\PQVO\PM][MZLWM[MT[M_PMZMQV\PM/=11V\PI\KI[MQN
_MUISM\PMLZI_QVOXIVMTIVQVVMZKTI[[\PMLZI_QVO +HWKLQNVKH·V
XIVMTKTI[[OM\[\WJMI[]JKTI[[WN 28IVMT_PQTM\PMW]\MZ JRWLWPDGHKDYLQJWZR
KTI[[Q[[\QTTNZMM\WJMI[]JKTI[[WN [WUM\PQVOMT[M LQQHUFODVVREMHFWV%XWZH
+HDG)LUVWAM[1[MM )VL\PMLZI_QVOXIVMTQ[V¼\ZM][ KDYHDFFHVVWRDOOKLVSULYDWH
IJTMMVW]OP\WJMI[MXIZI\MKTI[[IVa_Ia[QVKM_PI\Q\¼[ GDWDVRMXVWLPDJLQHWKHGDPDJH
IK\]ITTaXIQV\QVOQ[[XMKQÅK\W\PQ[WVM/=1IXXTQKI\QWV ZHFRXOGGR
,QQHUREMHFWAM[ AW]¼^MOW\Q\
+HDG)LUVW/WWL<PMV_MKIVUW^MWV\W\PMVI\]ZMWN
\PMZMTI\QWV[PQXJM\_MMVaW]IVL\PMW]\MZQV[\IVKM
,QQHUREMHFW?PI\Q[Q\_Q\PaW]XMWXTM'6W\MVW]OP
[WZLQLOW[[QXQVI[MZQW][\WXQKTQSMXWTaUWZXPQ[U'
+HDG)LUVW0MaaW]PI^MVWQLMIPW_U]KP\PMX]JTQKQ[
_QTTQVO\WXIaNWZ[WUMOWWLWTL\IJTWQLLQZ\;W[WUMWVM
KZMI\M[aW]IVLJMKWUM[QV[\IV\TaJWVLML\W\PMW]\MZ
WJRMK\Q[\PI\ZQOP\'
,QQHUREMHFWAM[\PI\¼[ZQOP\)VLaM[[WUMPI^M
KWUXIZMLQ\\WIVIZZIVOMLUIZZQIOM?MLWV¼\PI^MI[Ia
QV_PQKPWJRMK\_M¼ZMJWVLML\W
+HDG)LUVW)TZQOP\1¼TTOW_Q\P\PMUIZZQIOMIVITWOa
+IVaW]OM\ILQ^WZKMIVLZMUIZZa[WUM\PQVOMT[M'
,QQHUREMHFW6WQ\¼[NWZTQNM
\RXDUHKHUH
LQQHUFODVVHV
=[QVOIVQVVMZKTI[[NWZIVQUI\QWV
7ESAWWHYINNERCLASSESAREHANDYFOREVENTLISTENERSBECAUSE
YOUGETTOIMPLEMENTTHESAMEEVENT HANDLINGMETHODMORE
THANONCE"UTNOWWELLLOOKATHOWUSEFULANINNERCLASSISWHEN
USEDASASUBCLASSOFSOMETHINGTHEOUTERCLASSDOESNTEXTEND)N
OTHERWORDSWHENTHEOUTERCLASSANDINNERCLASSAREINDIFFERENT
INHERITANCETREES
/URGOALISTOMAKEASIMPLEANIMATIONWHERETHECIRCLEMOVES
ACROSSTHESCREENFROMTHEUPPERLEFTDOWNTOTHELOWERRIGHT
VWDUW ILQLVK
Licensed byQ:
WKHUH DUH QR
'XPE 4XHVWLRQV
7HYAREWELEARNINGABOUT
Eduard Simons
ANIMATIONHERE)DOUBTIF)M
GOINGTOBEMAKINGGAMES
A: 9OUMIGHTNOTBEMAKING
GAMESBUTYOUMIGHTBE
+RZVLPSOHDQLPDWLRQZRUNV
104038
CREATINGSIMULATIONSWHERE
THINGSCHANGEOVERTIMETOSHOW
3DLQWDQREMHFWDWDSDUWLFXODU[DQG\FRRUGLQDWH THERESULTSOFAPROCESS/RYOU
MIGHTBEBUILDINGAVISUALIZATION
J¿OO2YDO
TOOLTHATFOREXAMPLEUPDATES
AGRAPHICTOSHOWHOWMUCH
SL[HOVIURPWKHOHIW MEMORYAPROGRAMISUSING
SL[HOVIURPWKHWRS ORTOSHOWYOUHOWMUCH
TRAFFICISCOMINGTHROUGH
YOURLOAD BALANCINGSERVER
!NYTHINGTHATNEEDSTOTAKEA
5HSDLQWWKHREMHFWDWDGLIIHUHQW[DQG\FRRUGLQDWH SETOFCONTINUOUSLY CHANGING
J¿OO2YDO NUMBERSANDTRANSLATETHEMINTO
SOMETHINGUSEFULFORGETTING
INFORMATIONOUTOFTHENUMBERS
SL[HOVIURPWKHOHIW
SL[HOVIURPWKHWRS $OESNTTHATALLSOUNDBUSINESS
LIKE4HATSJUSTTHEhOFFICIAL
WKHREMHFWPRYHGDOLWWOH JUSTIFICATIONvOFCOURSE4HEREAL
GRZQDQGWRWKHULJKW REASONWERECOVERINGITHEREIS
JUSTBECAUSEITSASIMPLEWAY
TODEMONSTRATEANOTHERUSE
OFINNERCLASSES!NDBECAUSE
WEJUSTLIKEANIMATIONANDOUR
5HSHDWWKHSUHYLRXVVWHSZLWKFKDQJLQJ[DQG\YDOXHV
NEXT(EAD&IRSTBOOKISABOUT
IRUDVORQJDVWKHDQLPDWLRQLVVXSSRVHGWRFRQWLQXH *%%ANDWEKNOWWECANTGET
ANIMATIONINTHATONE
FKDSWHU
JHWWLQJJXL
:KDWZHUHDOO\ZDQWLVVRPHWKLQJOLNH
FODVV0\'UDZ3DQHOH[WHQGV-3DQHO^
JVHW&RORU&RORURUDQJH
J¿OO2YDO[\
LV
`
W&RPSRQHQW
` HDFKWLPHHSDRYLQDOJHWVSDLQWHGDWD
FDOOHGWK ORFDWLRQ
GLIIHUHQW
6KDUSHQ \RXU SHQFLO
%XWZKHUHGRZHJHWWKHQHZ[DQG\
FRRUGLQDWHV"
$QGZKRFDOOVUHSDLQW"
3EEIFYOUCANDESIGNASIMPLESOLUTIONTOGETTHEBALLTOANIMATEFROMTHETOPLEFTOFTHE
DRAWINGPANELDOWNTOTHEBOTTOMRIGHT/URANSWERISONTHENEXTPAGESODONTTURN
THISPAGEUNTILYOUREDONE
"IG(UGE(INTMAKETHEDRAWINGPANELANINNERCLASS
!NOTHER(INTDONTPUTANYKINDOFREPEATLOOPINTHEPAINT#OMPONENT METHOD
7RITEYOURIDEASORTHECODE HERE
\RXDUHKHUH
DQLPDWLRQXVLQJDQLQQHUFODVV
7KHFRPSOHWHVLPSOHDQLPDWLRQFRGH
LPSRUWMDYD[VZLQJ
LPSRUWMDYDDZW
KH
SXEOLFFODVV6LPSOH$QLPDWLRQ^
W Z R LQV W D QF HYDULDEOHVLQW
\
LQW[
PDNH
* 8 , FO D VVIRUWKH[DQG
PD LQ IWKHFLUFOH
LQW\
FRRUGLQDWHVR
6LPSOH$QLPDWLRQJXL QHZ6LPSOH$QLPDWLRQ
JXLJR
`
SXEOLFYRLGJR^

1RWKLQJQHZKHU
IUDPHJHW&RQWHQW3DQHDGGGUDZ3DQHO DQGSXWWKHPLQWH0DNHWKHZLGJHWV
KHIUDPH
IUDPHVHW6L]H
IUDPHVHW9LVLEOHWUXH
HWKH UHSHDWWKLVWLPHV
7KLVLVZKHUIRULQWL LL^
DFWLRQLV [ LQFUHPHQWWKH[DQG\
\ FRRUGLQDWHV ZH
W R UH SDLQWLWVHOIVR
WHOOW KH S DQ HO RF LRQ
DW
GUDZ3DQHOUHSDLQW
QVH H W KH F LU FOHLQWKHQHZO
FD
WU\^
7KUHDGVOHHS 6ORZLWGRZQDOLWWOHRWKHUZ
`FDWFK([FHSWLRQH[^`
TXLFNO\\RXZRQ·W6((LW LVHLWZLOOPRYHVR
` PR YH
ZHUHQ·WVXSSRVHGWRDOUHDG\N 'RQ·WZRUU\\RX

WKUHDGVLQFKDSWHU QRZWKLV:H·OOJHWWR
`FORVHJRPHWKRG
DQ
LW·VFODVV0\'UDZ3DQHOH[WHQGV-3DQHO^
R Z
1 UFO DVV
LQQH SXEOLFYRLGSDLQW&RPSRQHQW*UDSKLFVJ^
JVHW&RORU&RORUJUHHQ
J¿OO2YDO[\ 8VHWKHFRQWLQX
FRRUGLQDWHVRIWDOKHO\XSGDWHG[DQG\
` RXWHUFODVV
`FORVHLQQHUFODVV
`FORVHRXWHUFODVV
FKDSWHU
JHWWLQJJXL
8KRK,WGLGQ·WPRYHLWVPHDUHG
:KDWGLGZHGRZURQJ"
7KHUH·VRQHOLWWOHÁDZLQWKHSDLQW&RPSRQHQW
PHWKRG
:HIRUJRWWRHUDVHZKDWZDV 1RWH[DFWO\WKH
DOUHDG\WKHUH6RZHJRWWUDLOV ZHZHUHJRLQJIROURRN
7RÀ[LWDOOZHKDYHWRGRLVÀOOLQWKHHQWLUHSDQHOZLWK
WKHEDFNJURXQGFRORUEHIRUHSDLQWLQJWKHFLUFOHHDFK
WLPH7KHFRGHEHORZDGGVWZROLQHVDWWKHVWDUWRIWKH
PHWKRGRQHWRVHWWKHFRORUWRZKLWHWKHEDFNJURXQG
FRORURIWKHGUDZLQJSDQHODQGWKHRWKHUWRÀOOWKH
HQWLUHSDQHOUHFWDQJOHZLWKWKDWFRORU,Q(QJOLVKWKH
FRGHEHORZVD\V´)LOODUHFWDQJOHVWDUWLQJDW[DQG\RI
SL[HOVIURPWKHOHIWDQGSL[HOVIURPWKHWRSDQG
PDNHLWDVZLGHDQGDVKLJKDVWKHSDQHOLVFXUUHQWO\
JVHW&RORU&RORUZKLWH
J¿OO5HFWWKLVJHW:LGWKWKLVJHW+HLJKW
JVHW&RORU&RORUJUHHQ
JHW:LGWKDQG
PHWKRGVLQKHULWHJGHW+HLJKWDUH
J¿OO2YDO[\
`
IURP-3DQHO
<QJ[YNW bX^[ YNWLRU XY]RXWJU S^\] OX[ O^W

7HATCHANGESWOULDYOUMAKETOTHEXANDYCOORDINATESTOPRODUCETHEANIMATIONSBELOW
ASSUMETHElRSTONEEXAMPLEMOVESINPIXELINCREMENTS
; ;
< <
START lNISH START lNISH
; ;
< <
; ;
< <
\RXDUHKHUH
&RGH.LWFKHQ
Code Kitchen
EHDWRQH EHDWWZR EHDWWKUHH EHDWIRXU
LetÕs make a music video. WeÕll use Java-generated random

graphics that keep time with the music beats.
Along the way weÕll register (and listen for) a new kind of
non-GUI event, triggered by the music itself.
5HPHPEHUWKLVSDUWLVDOORSWLRQDO%XWZHWKLQNLW·VJRRGIRU\RX
$QG\RX·OOOLNHLW$QG\RXFDQXVHLWWRLPSUHVVSHRSOH
2NVXUHLWPLJKWZRUNRQO\RQSHRSOHZKRDUHUHDOO\HDV\WRLPSUHVV
EXWVWLOO
FKDSWHU
JHWWLQJJXL
4Q[\MVQVONWZIVWV/=1M^MV\
/+MAYBENOTAMUSICVIDEOBUTWEWILLMAKE
APROGRAMTHATDRAWSRANDOMGRAPHICSONTHE
SCREENWITHTHEBEATOFTHEMUSIC)NANUTSHELL :KDWWKHPXVLFDUWSURJUDP
THEPROGRAMLISTENSFORTHEBEATOFTHEMUSIC QHHGVWRGR
ANDDRAWSARANDOMGRAPHICRECTANGLEWITHEACH
BEAT
0DNHDVHULHVRI0,',PHVVDJHV
4HATBRINGSUPSOMENEWISSUESFORUS3OFAR
WEVELISTENEDFORONLY'5)EVENTSBUTNOW HYHQWVWRSOD\UDQGRPQRWHVRQDSLDQR
WENEEDTOLISTENFORAPARTICULARKINDOF-)$) RUZKDWHYHULQVWUXPHQW\RXFKRRVH
EVENT4URNSOUTLISTENINGFORANON '5)EVENTIS
JUSTLIKELISTENINGFOR'5)EVENTSYOUIMPLEMENT
5HJLVWHUDOLVWHQHUIRUWKHHYHQWV
ALISTENERINTERFACEREGISTERTHELISTENERWITHAN
EVENTSOURCETHENSITBACKANDWAITFORTHEEVENT
SOURCETOCALLYOUREVENT HANDLERMETHODTHE 6WDUWWKHVHTXHQFHUSOD\LQJ
METHODDElNEDINTHELISTENERINTERFACE
4HESIMPLESTWAYTOLISTENFORTHEBEATOFTHE
(DFKWLPHWKHOLVWHQHU·VHYHQW
MUSICWOULDBETOREGISTERANDLISTENFORTHE
ACTUAL-)$)EVENTSSOTHATWHENEVERTHE KDQGOHUPHWKRGLVFDOOHGGUDZD
SEQUENCERGETSTHEEVENTOURCODEWILLGETIT UDQGRPUHFWDQJOHRQWKHGUDZLQJ
TOOANDCANDRAWTHEGRAPHIC"UTTHERESA SDQHODQGFDOOUHSDLQW
PROBLEM!BUGACTUALLYTHATWONTLETUSLISTEN
FORTHE-)$)EVENTSWEREMAKINGTHEONESFOR
./4%/.
3OWEHAVETODOALITTLEWORK AROUND4HERE
ISANOTHERTYPEOF-)$)EVENTWECANLISTEN :H·OOEXLOGLWLQWKUHHLWHUDWLRQV
FORCALLEDA#ONTROLLER%VENT/URSOLUTION
ISTOREGISTERFOR#ONTROLLER%VENTSANDTHEN
MAKESURETHATFOREVERY./4%/.EVENT 9HUVLRQ2QH&RGHWKDWVLPSOLÀHVPDN
THERESAMATCHING#ONTROLLER%VENTlREDAT LQJDQGDGGLQJ0,',HYHQWVVLQFHZH·OO
THESAME@BEAT(OWDOWEMAKESURETHE EHPDNLQJDORWRIWKHP
#ONTROLLER%VENTISlREDATTHESAMETIME7E
ADDITTOTHETRACKJUSTLIKETHEOTHEREVENTS)N
OTHERWORDSOURMUSICSEQUENCEGOESLIKETHIS 9HUVLRQ7ZR5HJLVWHUDQGOLVWHQIRU
WKHHYHQWVEXWZLWKRXWJUDSKLFV
"%!4 ./4%/.#/.42/,,%2%6%.4
3ULQWVDPHVVDJHDWWKHFRPPDQGOLQH
"%!4 ./4%/&& ZLWKHDFKEHDW
"%!4 ./4%/.#/.42/,,%2%6%.4
9HUVLRQ7KUHH7KHUHDOGHDO$GGV
"%!4 ./4%/&&
JUDSKLFVWRYHUVLRQWZR
ANDSOON
"EFOREWEDIVEINTOTHEFULLPROGRAMTHOUGH
LETSMAKEITALITTLEEASIERTOMAKEANDADD-)$)
MESSAGESEVENTSSINCEINTHISPROGRAMWERE
GONNAMAKEALOTOFTHEM
\RXDUHKHUH
XWLOLW\PHWKRGIRUHYHQWV
)VMI[QMZ_Ia\WUISM
UM[[IOM[M^MV\[
7KLQJVWKDWKDYHWRKDSSHQIRU
2IGHTNOWMAKINGANDADDINGMESSAGESAND HDFKHYHQW
EVENTSTOATRACKISTEDIOUS&OREACHMESSAGE
WEHAVETOMAKETHEMESSAGEINSTANCEINTHIS 0DNHDPHVVDJHLQVWDQFH
CASE3HORT-ESSAGE CALLSET-ESSAGE MAKEA 6KRUW0HVVDJH¿UVW QHZ6KRUW0HVVDJH
-IDI%VENTFORTHEMESSAGEANDADDTHEEVENT
TOTHETRACK)NLASTCHAPTERSCODEWEWENT
THROUGHEACHSTEPFOREVERYMESSAGE4HAT
&DOOVHW0HVVDJHZLWKWKHLQVWUXFWLRQV
MEANSEIGHTLINESOFCODEJUSTTOMAKEANOTE
PLAYANDTHENSTOPPLAYING&OURLINESTOADDA ¿UVWVHW0HVVDJHLQVWUXPHQW
./4%/.EVENTANDFOURLINESTOADDA./4%
/&&EVENT
0DNHD0LGL(YHQWLQVWDQFHIRUWKHPHVVDJH
DVHW0HVVDJHQRWH 0LGL(YHQWQRWH2Q QHZ0LGL(YHQW¿UVW
0LGL(YHQWQRWH2Q QHZ0LGL(YHQWD
WUDFNDGGQRWH2Q
$GGWKHHYHQWWRWKHWUDFN
6KRUW0HVVDJHE QHZ6KRUW0HVVDJH
EVHW0HVVDJHQRWH WUDFNDGGQRWH2Q
WUDFNDGGQRWH2II
/HW·VEXLOGDVWDWLFXWLOLW\PHWKRGWKDW 7KHHYHQW¶WLFN·IRU

PDNHVDPHVVDJHDQGUHWXUQVD0LGL(YHQW DUJXPHQWV :+(1WKLVPHVVDJH
WKHIRXHUPHVVDJH VKRXOGKDSSHQ
IRUWK
SXEOLFVWDWLF0LGL(YHQWPDNH(YHQWLQWFRPGLQWFKDQLQWRQHLQWWZRLQWWLFN^
0LGL(YHQWHYHQW QXOO
WU\^
ZKRR$PHWKRGZLWKILYHSDUDPHWHUV
PDNHWK H
WKHPHWKHRP
DVHW0HVVDJHFRPGFKDQRQHWZR
VVDJHD
HYHQW QHZ0LGL(YHQWDWLFN GSDUDPHWQHGUWKHHYHQWXVLQJ
V

`FDWFK([FHSWLRQH^`
UHWXUQHYHQW QWDOO
UHWXUQWKHHYHQWD0LGL(YH
`
ORDGHGXSZLWKWKHPHVVDJH
FKDSWHU
JHWWLQJJXL
-ÌUXTM"PW_\W][M\PMVM_[\I\QK
UISM-^MV\UM\PWL
4HERESNOEVENTHANDLINGORGRAPHICSHEREJUSTASEQUENCEOF
NOTESTHATGOUPTHESCALE4HEPOINTOFTHISCODEISSIMPLYTOLEARN
HOWTOUSEOURNEWMAKE%VENT METHOD4HECODEFORTHENEXT
TWOVERSIONSISMUCHSMALLERANDSIMPLERTHANKSTOTHISMETHOD
LPSRUWMDYD[VRXQGPLGL GRQ·WIRU
JHWWKHLP
SXEOLFFODVV0LQL0XVLF3OD\HU^ UW SR

WU\^
FHU
RSHQ DVHTXHQ
VHTXHQFHURSHQ
PDNHDQG

6HTXHQFHVHT QHZ6HTXHQFH6HTXHQFH334 PDNHDVHTXHQFH
7UDFNWUDFN VHTFUHDWH7UDFN DQGDWUDFN

IRULQWL LL ^ PDNHDEXQFKRIHYHQWVWRPDNHWKHQRWHVNHHS
JRLQJXSIURPSLDQRQRWHWRSLDQRQRWH
WUDFNDGGPDNH(YHQWLL
FDOORXUQHZPD (Y
WUDFNDGGPDNH(YHQWLL
PHVVDJHDQGHYHNH
QW W
HQWPHWKRGWRPD
NHWKH
0LGL(YHQWUHWXUQHG KHQDGGWKHUHVXOWWKH
`HQGORRS IU RP
WKHWUDFN7KHVHDUH PDNH(YHQWWR

127(2)) 127(21DQ
VHTXHQFHUVHW6HTXHQFHVHT SDLUV G
VHTXHQFHUVHW7HPSR,Q%30 VWDUWLWUXQQLQJ
VHTXHQFHUVWDUW
`FORVHPDLQ
SXEOLFVWDWLF0LGL(YHQWPDNH(YHQWLQWFRPGLQWFKDQLQWRQHLQWWZRLQWWLFN^
0LGL(YHQWHYHQW QXOO
WU\^
HYHQW QHZ0LGL(YHQWDWLFN

`FDWFK([FHSWLRQH^`
UHWXUQHYHQW
`
`FORVHFODVV
\RXDUHKHUH
FRQWUROOHUHYHQWV
>MZ[QWV<_W"ZMOQ[\MZQVOIVLOM\\QVO+WV\ZWTTMZ-^MV\[
:HQHHGWROLVWHQIRU&RQWHUL UROOHU(YHQWV
VRZHLPSOHP HQW WK HOLV WHQ QWHUIDFH
SXEOLFFODVV0LQL0XVLF3OD\HULPSOHPHQWV&RQWUROOHU(YHQW/LVWHQHU^

0LQL0XVLF3OD\HUPLQL QHZ0LQL0XVLF3OD\HU
PLQLJR
` U
WKHVHTXHQFHWK
SXEOLFYRLGJR^ IRUHYHQWVZLWK H
5HJLVWHU HJLVWUDWLRQPHWKRGWDNHV
7KHH YHQWU
\UHSUHV W HQWLQJ
WU\^
QH U $ 1'DQLQWDUUD ZDQ
6HTXHQFHUVHTXHQFHU 0LGL6\VWHPJHW6HTXHQFHU &RQWUROOHU(YHQWV\RX
OLVWH
VHTXHQFHURSHQ WKHOLVWRI O\RQHHYHQW
:HZDQWRQ
LQW>@HYHQWV,:DQW ^`
VHTXHQFHUDGG&RQWUROOHU(YHQW/LVWHQHUWKLVHYHQWV,:DQW

+HUH·VKRZZHSLFNXSWKHE
IRULQWL LL ^
RXU2:1&RQWUROOHU( HDWZHLQVHUW
WUDFNDGGPDNH(YHQWLL YHQ W
W\SHLV&RQWUROOHU( WZ VD\VWKHHYHQW
HYHQWQXPEHUYHQ 7 KLV
LWKDQDUJXPHQWIRU
WUDFNDGGPDNH(YHQWL HY
,1*:HSXWLWLQ 867 HQWZLOOGR127+
DQHYHQWHDFKWLPH-D QR WH
VRWKDWZHFDQJHW
WUDFNDGGPDNH(YHQWLL
ZRUGVLWVVROHSXU LVSOD\HG,QRWKH
`HQGORRS VRWKDWVRPHWKLQJZULOO
ILUHWKDW:(FDQOSRLVWVHHQLVIR
IRU127(212))HYHQW UZHFDQ·WOLVWHQ
VHTXHQFHUVHW6HTXHQFHVHT
PDNLQJWKLVHYHQWKD V1RWHWKDWZH·UH
VHTXHQFHUVHW7HPSR,Q%30 SS HQ DW
WKH127(216RZ QW WKH6$0(WLFNDV
KDSSHQVZH·OONQRZDEKHRXW KH127(21HYHQW
VHTXHQFHUVWDUW
`FDWFK([FHSWLRQH[^H[SULQW6WDFN7UDFH` LW
ZLOOILUHDWWKHVDPHWLPH EHFDXVH285HYHQW
`FORVH
I WUROOHU
URPWKH&RQJH
GO HU P HW KR G ZH WWKH
7KHHYHQWKDQ
SXEOLFYRLGFRQWURO&KDQJH6KRUW0HVVDJHHYHQW^
L QW HU ID FH (DFKWLPHG
(YHQWOLVW SULQWÓDµWRWKHFRPPDQ OLQH
HQ HU
6\VWHPRXWSULQWOQ³OD´
HYHQWZH·OO
`
SXEOLF0LGL(YHQWPDNH(YHQWLQWFRPGLQWFKDQLQWRQHLQWWZRLQWWLFN^
0LGL(YHQWHYHQW QXOO
WU\^
&RGHWKDW·VGLIIHUHQWIURPWKHSUHYLRXV
`FDWFK([FHSWLRQH^` YHUVLRQLVKLJKOLJKWHGLQJUD\DQGZH·UH
UHWXUQHYHQW QRWUXQQLQJLWDOOZLWKLQPDLQWKLVWLPH
`
`FORVHFODVV
FKDSWHU
JHWWLQJJXL
>MZ[QWV<PZMM"LZI_QVOOZIXPQK[QV\QUM_Q\P\PMU][QK
4HISlNALVERSIONBUILDSONVERSIONTWOBYADDINGTHE'5)PARTS7EBUILDA
FRAMEADDADRAWINGPANELTOITANDEACHTIMEWEGETANEVENTWEDRAWA
NEWRECTANGLEANDREPAINTTHESCREEN4HEONLYOTHERCHANGEFROMVERSION
TWOISTHATTHENOTESPLAYRANDOMLYASOPPOSEDTOSIMPLYMOVINGUPTHE
SCALE
4HEMOSTIMPORTANTCHANGETOTHECODEBESIDESBUILDINGASIMPLE'5)
ISTHATWEMAKETHEDRAWINGPANELIMPLEMENTTHE#ONTROLLER%VENT,ISTENER
RATHERTHANTHEPROGRAMITSELF3OWHENTHEDRAWINGPANELANINNERCLASS
GETSTHEEVENTITKNOWSHOWTOTAKECAREOFITSELFBYDRAWINGTHERECTANGLE
#OMPLETECODEFORTHISVERSIONISONTHENEXTPAGE
7KHGUDZLQJSDQHOLQQHUFODVV
OLVDOLVWH QHU
7KHGUDZLQJSDQH
FODVV0\'UDZ3DQHOH[WHQGV-3DQHOLPSOHPHQWV&RQWUROOHU(YHQW/LVWHQHU^

ERROHDQPVJ IDOVH
:HVHWDIODJWRIDOVHDQGZH·OOVHWLW
WRWUXHRQO\ZKHQZHJHWDQHYHQW
PVJ WUXH
:HJRWDQHYHQWVRZHVHWWKHIODJWR
UHSDLQW
` WUXHDQGFDOOUHSDLQW
LIPVJ^
:HKDYHWRXVHDIODJEHFDXVH27+(5WKLQJ
DQG ZHZDQWWRSDLQW21/<ZKHQWKHUH·VDVPLJKWWULJJHUDUHSDLQW
&RQWUROOHU(YHQW
*UDSKLFV'J *UDSKLFV'J
LQWU LQW0DWKUDQGRP

LQWJU LQW0DWKUDQGRP
LQWE LQW0DWKUDQGRP 7KHUHVWLVFRGHWRJHQHUDWH
DUDQGRPFRORUDQGSDLQWD
JVHW&RORUQHZ&RORUUJUE VHPLUDQGRPUHFWDQJOH
LQWKW LQW0DWKUDQGRP
LQWZLGWK LQW0DWKUDQGRP
LQW[ LQW0DWKUDQGRP
LQW\ LQW0DWKUDQGRP
J¿OO5HFW[\KWZLGWK
PVJ IDOVH
`FORVHLI
`FORVHPHWKRG
`FORVHLQQHUFODVV
\RXDUHKHUH
0LQL0XVLF3OD\HUFRGH
6KDUSHQ \RXU SHQFLO

LPSRUWMDYD[VRXQGPLGL 7KLVLVWKHFRPSOHWHFRGHOLVWLQJIRU9HUVLRQ
LPSRUWMDYDLR 7KUHH,WEXLOGVGLUHFWR\RQ9HUVLRQ7ZR7U\
LPSRUWMDYD[VZLQJ WRDQQRWDWHLW\RXUVHOIZLWKRXWORRNLQJDWWKH
LPSRUWMDYDDZW
SUHYLRXVSDJHV
SXEOLFFODVV0LQL0XVLF3OD\HU^
VWDWLF-)UDPHI QHZ-)UDPH³0\)LUVW0XVLF9LGHR´

VWDWLF0\'UDZ3DQHOPO
0LQL0XVLF3OD\HUPLQL QHZ0LQL0XVLF3OD\HU
Licensed by
PLQLJR
`FORVHPHWKRG

SXEOLFYRLGVHW8S*XL^
PO QHZ0\'UDZ3DQHO
Eduard Simons
IVHW&RQWHQW3DQHPO
IVHW%RXQGV
IVHW9LVLEOHWUXH
`FORVHPHWKRG

104038
SXEOLFYRLGJR^
VHW8S*XL
WU\^

VHTXHQFHURSHQ
VHTXHQFHUDGG&RQWUROOHU(YHQW/LVWHQHUPOQHZLQW>@^`
LQWU
IRULQWL LL ^
U LQW0DWKUDQGRP

WUDFNDGGPDNH(YHQWUL
WUDFNDGGPDNH(YHQWL
WUDFNDGGPDNH(YHQWUL
`HQGORRS

VHTXHQFHUVWDUW
VHTXHQFHUVHW7HPSR,Q%30
`FORVHPHWKRG
FKDSWHU
JHWWLQJJXL
0LGL(YHQWHYHQW QXOO
WU\^

`FDWFK([FHSWLRQH^`
UHWXUQHYHQW
`FORVHPHWKRG
ERROHDQPVJ IDOVH
PVJ WUXH
UHSDLQW
`
LIPVJ^

LQWU LQW0DWKUDQGRP

LQWJU LQW0DWKUDQGRP
LQWE LQW0DWKUDQGRP
JVHW&RORUQHZ&RORUUJUE
LQWKW LQW0DWKUDQGRP

LQW[ LQW0DWKUDQGRP

LQW\ LQW0DWKUDQGRP

J¿OO5HFW[\KWZLGWK
PVJ IDOVH
`FORVHLI
`FORVHPHWKRG
`FORVHLQQHUFODVV
`FORVHFODVV
\RXDUHKHUH
H[HUFLVH:KR$P,
!BUNCHOF*AVAHOT SHOTSINFULLCOSTUMEAREPLAYINGTHEPARTYGAMEh7HO

AM)v4HEYGIVEYOUACLUEANDYOUTRYTOGUESSWHOTHEYAREBASEDON
WHATTHEYSAY!SSUMETHEYALWAYSTELLTHETRUTHABOUTTHEMSELVES)FTHEY
1dQÔU_Q HAPPENTOSAYSOMETHINGTHATCOULDBETRUEFORMORETHANONEGUYTHEN
WRITEDOWNALLFORWHOMTHATSENTENCEAPPLIES&ILLINTHEBLANKSNEXTTOTHE
SENTENCEWITHTHENAMESOFONEORMOREATTENDEES
*1#/ 4ONIGHTSATTENDEES
` !NYOFTHECHARMINGPERSONALITIESFROMTHISCHAPTERJUST
MIGHTSHOWUP
,JRWWKHZKROH*8,LQP\KDQGV
(YHU\HYHQWW\SHKDVRQHRI WKHVH
7KHOLVWHQHU·VNH\PHWKRG
7KLVPHWKRGJLYHV-)UDPHLWVVL]H
<RXDGGFRGHWRWKLVPHWKRGEXWQHYHUFDOOLW
:KHQWKHXVHUDFWXDOO\GRHVVRPHWKLQJLW·VDQBBBBB
0RVWRI WKHVHDUHHYHQWVRXUFHV
,FDUU\GDWDEDFNWRWKHOLVWHQHU
$QDGG;[[/LVWHQHUPHWKRGVD\VDQREMHFWLVDQBBBBB
+RZDOLVWHQHUVLJQVXS
7KHPHWKRGZKHUHDOOWKHJUDSKLFVFRGHJRHV
,·PW\SLFDOO\ERXQGWRDQLQVWDQFH
7KH¶J·LQ*UDSKLFVJLVUHDOO\RI FODVV
7KHPHWKRGWKDWJHWVSDLQW&RPSRQHQWUROOLQJ
7KHSDFNDJHZKHUHPRVWRI WKH6ZLQJHUVUHVLGH
FKDSWHU
JHWWLQJJXL
"%THECOMPILER
1dQÔU_Q 7KH-DYDILOHRQWKLVSDJHUHSUHVHQWVD
FRPSOHWHVRXUFHILOH<RXUMRELVWRSOD\
LPSRUWMDYD[VZLQJ
FRPSLOHUDQGGHWHUPLQHZKHWKHUWKLVILOH
LPSRUWMDYDDZWHYHQW ZLOOFRPSLOH,ILWZRQ·WFRPSLOHKRZ
LPSRUWMDYDDZW ZRXOG\RXIL[LWDQGLILWGRHV
FRPSLOHZKDWZRXOGLWGR"
FODVV,QQHU%XWWRQ^
-)UDPHIUDPH
-%XWWRQE
,QQHU%XWWRQJXL QHZ,QQHU%XWWRQ
JXLJR
`
SXEOLFYRLGJR^
IUDPH QHZ-)UDPH
IUDPHVHW'HIDXOW&ORVH2SHUDWLRQ
-)UDPH(;,7B21B&/26(
E QHZ-%XWWRQ´$µ

EDGG$FWLRQ/LVWHQHU

IUDPHJHW&RQWHQW3DQHDGG
%RUGHU/D\RXW6287+E
IUDPHVHW6L]H
IUDPHVHW9LVLEOHWUXH
`
FODVV%/LVWHQHUH[WHQGV$FWLRQ/LVWHQHU^
SXEOLFYRLGDFWLRQ3HUIRUPHG$FWLRQ(YHQWH^
LIEJHW7H[WHTXDOV´$µ^
EVHW7H[W´%µ
`HOVH^
EVHW7H[W´$µ
`
`
`
`
\RXDUHKHUH
SX]]OH3RRO3X]]OH LPSRUWMDYD[VZLQJ
LPSRUWMDYDDZW
SXEOLFFODVV$QLPDWH^
LQW[
3RRO3X]]OH LQW\
9OURJOBISTOTAKECODESNIPPETSFROM $QLPDWHJXL QHZ$QLPDWH
THEPOOLANDPLACETHEMINTOTHEBLANK JXLJR
LINESINTHECODE9OUMAYUSETHE `
SAMESNIPPETMORETHANONCE SXEOLFYRLGJR^
ANDYOUWONTNEEDTOUSEALLTHE
-)UDPHBBBBBBBBB QHZ-)UDPH
SNIPPETS9OURGOALISTOMAKEA
CLASSTHATWILLCOMPILEANDRUN
ANDPRODUCETHEOUTPUTLISTED -)UDPH(;,7B21B&/26(
BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
BBBBBBBBBJHW&RQWHQW3DQHDGGGUDZ3
/UTPUT BBBBBBBBBBBBBBBBBBBBBBBBBB
4HE!MAZING3HRINKING"LUE2ECTANGLE BBBBBBBBBVHW9LVLEOHWUXH
4HISPROGRAMWILLPRODUCEABLUE IRULQWL LBBBBBBBBBBBBBBB^
RECTANGLETHATWILLSHRINKANDSHRINKAND BBBBBBBBBBBBBBBBBBBBB
DISAPPEARINTOAlELDOFWHITE BBBBBBBBBBBBBBBBBBBBB
WU\^
7KUHDGVOHHS
`FDWFK([FHSWLRQH[^`
`
`
FODVV0\'UDZ3H[WHQGV-3DQHO^
SXEOLFYRLGSDLQW&RPSRQHQW*UDSKLF
BBBBBBBBB^
BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
.OTE%ACHSNIPPET BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
FROMTHEPOOLCANBE BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
USEDMORETHANONCE `
`
`
GFILL2ECTXYX Y

I
GFILL2ECTXY X
Y

IY
GFILL2ECT X
Y
XY
X GFILL2ECT IYX
Y GFILL2ECT !NIMATEFRAMENEW!NIMATE
G -Y$RAW0DRAW0NEW-Y$RAW0
GSET#OLORBLUE
DRAW0PAINT #ONTENT0ANEDRAW0NEW#ONTENT0ANE
GSET#OLORWHITE DRAW
DRAWREPAINT DRAW0SET3IZE
GSET#OLOR#OLORBLUE FRAME
DRAW0REPAINT FRAMESET3IZE
GSET#OLOR#OLORWHITE PANEL
PANELSET3IZE
FKDSWHU
JHWWLQJJXL
([HUFLVH6ROXWLRQV "%THECOMPILER
LPSRUWMDYD[VZLQJ 2QFHWKLVFRGH
LPSRUWMDYDDZWHYHQW LVÀ[HGLWZLOO
*1#/ ` LPSRUWMDYDDZW
FUHDWHD*8,ZLWK
DEXWWRQWKDW
WRJJOHVEHWZHHQ
)GOTTHEWHOLE'5)INMYHANDS -)UDPH FODVV,QQHU%XWWRQ^ $DQG%ZKHQ\RX
FOLFNLW
%VERYEVENTTYPEHASONEOFTHESE OLVWHQHULQWHUIDFH -)UDPHIUDPH
-%XWWRQE
4HELISTENERSKEYMETHOD DFWLRQ3HUIRUPHG
4HISMETHODGIVES*&RAMEITSSIZE VHW6L]H SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^

,QQHU%XWWRQJXL QHZ,QQHU%XWWRQ
9OUADDCODETOTHISMETHODBUT JXLJR
NEVERCALLIT SDLQW&RPSRQHQW `
7HENTHEUSERACTUALLYDOES SXEOLFYRLGJR^
SOMETHINGITSAN???? HYHQW
IUDPH QHZ-)UDPH
-OSTOFTHESEAREEVENTSOURCES VZLQJFRPSRQHQWV IUDPHVHW'HIDXOW&ORVH2SHUDWLRQ
-)UDPH(;,7B21B&/26(
)CARRYDATABACKTOTHELISTENER HYHQWREMHFW
7KHDGG$FWLRQ/LVWHQHU
!NADD8XX,ISTENER METHOD PHWKRGWDNHVDFODVVWKDW
SAYSANOBJECTISAN??? HYHQWVRXUFH LPSOHPHQWVWKH$FWLRQ/LV
WHQHULQWHUIDFH
(OWALISTENERSIGNSUP DGG$FWLRQ/LVWHQHU
4HEMETHODWHEREALLTHE E QHZ-%XWWRQ´$µ

GRAPHICSCODEGOES SDLQW&RPSRQHQW EDGG$FWLRQ/LVWHQHUVM_*4Q[\MVMZ

)MTYPICALLYBOUNDTOANINSTANCE LQQHUFODVV IUDPHJHW&RQWHQW3DQHDGG
%RUGHU/D\RXW6287+E
4HE@GIN'RAPHICSG IS
IUDPHVHW6L]H
REALLYOFTHISCLASS *UDSKLFVG
IUDPHVHW9LVLEOHWUXH
4HEMETHODTHATGETS `
PAINT#OMPONENT ROLLING UHSDLQW
FODVV%/LVWHQHUQUXTMUMV\[$FWLRQ/LVWHQHU^
4HEPACKAGEWHEREMOSTOFTHE SXEOLFYRLGDFWLRQ3HUIRUPHG$FWLRQ(YHQWH^
3WINGERSRESIDE MDYD[VZLQJ LIEJHW7H[WHTXDOV´$µ^
EVHW7H[W´%µ
`HOVH^ $FWLRQ/LVWHQHULVDQ
EVHW7H[W´$µ LQWHUIDFHLQWHUIDFHV
DUHLPSOHPHQWHGQRW
`
H[WHQGHG
`
`
`
\RXDUHKHUH
SX]]OHDQVZHUV
3RRO3X]]OH
LPSRUWMDYD[VZLQJ
LPSRUWMDYDDZW
SXEOLFFODVV$QLPDWH^
LQW[
LQW\
$QLPDWHJXL QHZ$QLPDWH
JXLJR
`
SXEOLFYRLGJR^
4HE!MAZING3HRINKING"LUE -)UDPH(;,7B21B&/26(
2ECTANGLE
0\'UDZ3GUDZ3 QHZ0\'UDZ3
IUDPHJHW&RQWHQW3DQHDGGGUDZ3
IUDPHVHW6L]H
IUDPHVHW9LVLEOHWUXH
IRULQWL LL[\^
[
GUDZ3UHSDLQW
WU\^
7KUHDGVOHHS
`FDWFK([FHSWLRQH[^`
`
`
FODVV0\'UDZ3H[WHQGV-3DQHO^
JVHW&RORU&RORUZKLWH
JÀOO5HFW
JVHW&RORU&RORUEOXH
JÀOO5HFW[\[ \
`
`
`
FKDSWHU
XVLQJVZLQJ
:RUNRQ<RXU :K\ZRQ·W
WKHEDOOJRZKHUH,ZDQW
6ZLQJ LWWRJR"OLNHVPDFNLQ6X]\
6PLWK·VIDFH,·YHJRWWDOHDUQ
WRFRQWUROLW
6ZLQJLVHDV\5NLESSYOUACTUALLYCAREWHERETHINGSENDUPONTHESCREEN3WINGCODE
LOOKSEASYBUTTHENYOUCOMPILEITRUNITLOOKATITANDTHINKhHEYTHATSNOTSUPPOSEDTOGO
THEREv4HETHINGTHATMAKESITEASYTOCODEISTHETHINGTHATMAKESITHARDTOCONTROLTHE
,AYOUT-ANAGER,AYOUT-ANAGEROBJECTSCONTROLTHESIZEANDLOCATIONOFTHEWIDGETSINA
*AVA'5)4HEYDOATONOFWORKONYOURBEHALFBUTYOUWONTALWAYSLIKETHERESULTS9OUWANT
TWOBUTTONSTOBETHESAMESIZEBUTTHEYARENT9OUWANTTHETEXTFIELDTOBETHREEINCHESLONG
BUTITSNINE/RONE!NDUNDERTHELABELINSTEADOFNEXTTOIT"UTWITHALITTLEWORKYOUCANGET
LAYOUTMANAGERSTOSUBMITTOYOURWILL)NTHISCHAPTERWELLWORKONOUR3WINGANDINADDITION
TOLAYOUTMANAGERSWELLLEARNMOREABOUTWIDGETS7ELLMAKETHEMDISPLAYTHEMWHEREWE
CHOOSE ANDUSETHEMINAPROGRAM)TSNOTLOOKINGTOOGOODFOR3UZY
WKLVLVDQHZFKDSWHU
FRPSRQHQWVDQGFRQWDLQHUV
;_QVOKWUXWVMV\[
#OMPONENTISTHEMORECORRECTTERMFORWHATWEVEBEENCALLINGAWIDGET
4HETHINGSYOUPUTINA'5)4HETHINGSAUSERSEESANDINTERACTSWITH4EXT
lELDSBUTTONSSCROLLABLELISTSRADIOBUTTONSETCAREALLCOMPONENTS)N A widget is technically
FACTTHEYALLEXTENDMDYD[VZLQJ-&RPSRQHQW
a Swing Component.
+WUXWVMV\[KIVJMVM[\ML Almost every thing
)N3WINGVIRTUALLYALLCOMPONENTSARECAPABLEOFHOLDINGOTHER you can stick in a
COMPONENTS)NOTHERWORDSYOUCANSTICKJUSTABOUTANYTHINGINTOANYTHING
ELSE"UTMOSTOFTHETIMEYOULLADDUSERINTERACTIVECOMPONENTSSUCHAS GUI extends from
BUTTONSANDLISTSINTOBACKGROUNDCOMPONENTSSUCHASFRAMESANDPANELS javax.swing.JComponent.
!LTHOUGHITSPOSSIBLETOPUTSAYAPANELINSIDEABUTTONTHATSPRETTY
WEIRDANDWONTWINYOUANYUSABILITYAWARDS
7ITHTHEEXCEPTIONOF*&RAMETHOUGHTHEDISTINCTIONBETWEENINTERACTIVE
COMPONENTSANDBACKGROUNDCOMPONENTSISARTIlCIAL!*0ANELFOR
EXAMPLEISUSUALLYUSEDASABACKGROUNDFORGROUPINGOTHERCOMPONENTS
BUTEVENA*0ANELCANBEINTERACTIVE*USTASWITHOTHERCOMPONENTSYOU
CANREGISTERFORTHE*0ANELSEVENTSINCLUDINGMOUSECLICKSANDKEYSTROKES
)RXUVWHSVWRPDNLQJD*8,UHYLHZ
0DNHDZLQGRZD-)UDPH
0DNHDFRPSRQHQWEXWWRQWH[WÀHOGHWF
$GGWKHFRPSRQHQWWRWKHIUDPH
IUDPHJHW&RQWHQW3DQHDGG%RUGHU/D\RXW($67EXWWRQ
'LVSOD\LWJLYHLWDVL]HDQGPDNHLWYLVLEOH
IUDPHVHW6L]H
IUDPHVHW9LVLEOHWUXH
3XWLQWHUDFWLYHFRPSRQHQWV ,QWREDFNJURXQGFRPSRQHQWV
-%XWWRQ
-)UDPH -3DQHO
-&KHFN%R[
-7H[W)LHOG
FKDSWHU
XVLQJVZLQJ
4IaW]\5IVIOMZ[
!LAYOUTMANAGERISA*AVAOBJECTASSOCIATED $VDOD\RXWPDQDJHU
WITHAPARTICULARCOMPONENTALMOSTALWAYSA ,·PLQFKDUJHRIWKH VL]H
BACKGROUNDCOMPONENT4HELAYOUTMANAGER DQGSODFHPHQWRI\RXUFRPSRQHQWV
CONTROLSTHECOMPONENTSCONTAINEDWITHINTHE ,QWKLV*8,,·PWKHRQHZKRGHFLGHG
COMPONENTTHELAYOUTMANAGERISASSOCIATED KRZELJWKHVHEXWWRQVVKRXOGEHDQG
WITH)NOTHERWORDSIFAFRAMEHOLDSAPANEL
ZKHUHWKH\DUHUHODWLYHWRHDFK
ANDTHEPANELHOLDSABUTTONTHEPANELSLAYOUT
MANAGERCONTROLSTHESIZEANDPLACEMENTOF RWKHUDQGWKH IUDPH
THEBUTTONWHILETHEFRAMESLAYOUTMANAGER
CONTROLSTHESIZEANDPLACEMENTOFTHE
PANEL4HEBUTTONONTHEOTHERHAND
DOESNTNEEDALAYOUTMANAGERBECAUSETHE
BUTTONISNTHOLDINGOTHERCOMPONENTS
)FAPANELHOLDSlVETHINGSEVENIFTHOSE
lVETHINGSEACHHAVETHEIROWNLAYOUT
MANAGERSTHESIZEANDLOCATIONOFTHElVE
THINGSINTHEPANELAREALLCONTROLLEDBYTHE
PANELSLAYOUTMANAGER)FTHOSElVETHINGS
INTURNHOLDOTHERTHINGSTHENTHOSEOTHER
THINGSAREPLACEDACCORDINGTOTHELAYOUT
MANAGEROFTHETHINGHOLDINGTHEM
7HENWESAYHOLDWEREALLYMEANADDASINA
PANELHOLDSABUTTONBECAUSETHEBUTTONWAS 3DQHO$·VOD\RXWP
FRQWUROVWKHVL] DQDJHU
ADDEDTOTHEPANELUSINGSOMETHINGLIKE
OD \ R X W PDQDJSHUODFHPHQW SODFHPHQWRI3DQHHODQG
·V G %
P\3DQHODGGEXWWRQ
3DQHO%ROVWKHVL]HDWQRQV
,AYOUTMANAGERSCOMEINSEVERALmAVORSAND Q W U
FR HWKUHH E X W
EACHBACKGROUNDCOMPONENTCANHAVEITSOWN RIWK EXWWRQ
LAYOUTMANAGER,AYOUTMANAGERSHAVETHEIR
OWNPOLICIESTOFOLLOWWHENBUILDINGALAYOUT EXWWRQ
&OREXAMPLEONELAYOUTMANAGERMIGHTINSIST
THATALLCOMPONENTSINAPANELMUSTBETHESAME EXWWRQ
SIZEARRANGEDINAGRIDWHILEANOTHERLAYOUT
MANAGERMIGHTLETEACHCOMPONENTCHOOSEITS
3DQHO%
OWNSIZEBUTSTACKTHEMVERTICALLY(ERESAN
EXAMPLEOFNESTEDLAYOUTS
-3DQHOSDQHO$ QHZ-3DQHO 3DQHO$
-3DQHOSDQHO% QHZ-3DQHO
3DQHO$·VOD\RXWPDQDJHU V127
SDQHO%DGGQHZ-%XWWRQ³EXWWRQ´ VD\DERXWWKHWKUHHEXWWKD +,1*WR
RIFRQWUROLVRQO\RQHOHYHRQV 7KHKLHUDUFK\
PDQDJHUFRQWUROVRQO\WKHO³3 DQHO$·VOD\RXW
SDQHO%DGGQHZ-%XWWRQ³EXWWRQ´
SDQHO%DGGQHZ-%XWWRQ³EXWWRQ´ WR3DQHO$DQGGRHVQRWF WKLQJVDGGHGGLUHFWO\
SDQHO$DGGSDQHO% QHVWHGZLWKLQWKRVHDGGHGFRQW URODQ\WKLQJ
RPSRQHQWV
\RXDUHKHUH
OD\RXWPDQDJHUV
0W_LWM[\PMTIaW]\UIVIOMZLMKQLM'
$IFFERENTLAYOUTMANAGERSHAVEDIFFERENTPOLICIESFORARRANGING
COMPONENTSLIKEARRANGEINAGRIDMAKETHEMALLTHESAMESIZE
STACKTHEMVERTICALLYETC BUTTHECOMPONENTSBEINGLAYEDOUTDO
GETATLEASTSOMESMALLSAYINTHEMATTER)NGENERALTHEPROCESSOF
LAYINGOUTABACKGROUNDCOMPONENTLOOKSSOMETHINGLIKETHIS
/HW·VVHHKHUHWKH
$OD\RXWVFHQDULR ÀUVWEXWWRQZDQWVWREH
SL[HOVZLGHDQGWKHWH[WÀHOG
0DNHDSDQHODQGDGGWKUHHEXWWRQVWRLW QHHGVDQGWKHIUDPHLVSL[HOV
ZLGHDQG,·PVXSSRVHGWRDUUDQJH
Licensed by
7KHSDQHO·VOD\RXWPDQDJHUDVNVHDFKEXWWRQKRZELJ HYHU\WKLQJYHUWLFDOO\
WKDWEXWWRQSUHIHUVWREH
7KHSDQHO·VOD\RXWPDQDJHUXVHVLWVOD\RXWSROLFLHVWRGHFLGH
Eduard Simons
ZKHWKHULWVKRXOGUHVSHFWDOOSDUWRUQRQHRIWKHEXWWRQV·
SUHIHUHQFHV
$GGWKHSDQHOWRDIUDPH

SUHIHUVWREH 104038
7KHIUDPH·VOD\RXWPDQDJHUDVNVWKHSDQHOKRZELJWKHSDQHO
7KHIUDPH·VOD\RXWPDQDJHUXVHVLWVOD\RXWSROLFLHVWRGHFLGH
ZKHWKHULWVKRXOGUHVSHFWDOOSDUWRUQRQHRIWKHSDQHO·V
SUHIHUHQFHV
DQDJHU
OD\RXWP
,QNNMZMV\TIaW]\UIVIOMZ[PI^MLQNNMZMV\XWTQKQM[
3OMELAYOUTMANAGERSRESPECTTHESIZETHECOMPONENTWANTSTO
BE)FTHEBUTTONWANTSTOBEPIXELSBYPIXELSTHATSWHATTHE
LAYOUTMANAGERALLOCATESFORTHATBUTTON/THERLAYOUTMANAGERS
RESPECTONLYPARTOFTHECOMPONENTSPREFERREDSIZE)FTHEBUTTON
WANTSTOBEPIXELSBYPIXELSITLLBEPIXELSBYHOWEVER
WIDETHEBUTTONSBACKGROUNDPANELIS3TILLOTHERLAYOUTMANAGERS
RESPECTTHEPREFERENCEOFONLYTHELARGESTOFTHECOMPONENTS
BEINGLAYEDOUTANDTHERESTOFTHECOMPONENTSINTHATPANEL
AREALLMADETHATSAMESIZE)NSOMECASESTHEWORKOFTHELAYOUT
MANAGERCANGETVERYCOMPLEXBUTMOSTOFTHETIMEYOUCAN
lGUREOUTWHATTHELAYOUTMANAGERWILLPROBABLYDOONCEYOUGET
TOKNOWTHATLAYOUTMANAGERSPOLICIES
FKDSWHU
XVLQJVZLQJ
<PM*QO<PZMMTIaW]\UIVIOMZ["
JWZLMZNTW_IVLJW`
%RUGHU/D\RXW
$%RUGHU/D\RXWPDQDJHUGLYLGHVDEDFNJURXQG
FRPSRQHQWLQWRÀYHUHJLRQV<RXFDQDGGRQO\RQH
QW
FRPSRQHQWSHUUHJLRQWRDEDFNJURXQGFRQWUROOHG RQHFRPSRQQH
SHUU H J LR
E\D%RUGHU/D\RXWPDQDJHU&RPSRQHQWVODLGRXW
E\WKLVPDQDJHUXVXDOO\GRQ·WJHWWRKDYHWKHLU
SUHIHUUHGVL]H%RUGHU/D\RXWLVWKHGHIDXOWOD\RXW
PDQDJHUIRUDIUDPH
)ORZ/D\RXW
$)ORZ/D\RXWPDQDJHUDFWVNLQGRIOLNHDZRUG
SURFHVVRUH[FHSWZLWKFRPSRQHQWVLQVWHDGRI FRPSRQHQWVDGGHGOH
ZRUGV(DFKFRPSRQHQWLVWKHVL]HLWZDQWVWREH WRULJKWZUDSS IW
LQ J WR
QHZOLQHZKHQQHHGH D
DQGWKH\·UHODLGRXWOHIWWRULJKWLQWKHRUGHUWKDW G
WKH\·UHDGGHGZLWK´ZRUGZUDSµWXUQHGRQ6R
ZKHQDFRPSRQHQWZRQ·WÀWKRUL]RQWDOO\LWGURSV
WRWKHQH[WÓLQHµLQWKHOD\RXW)ORZ/D\RXWLVWKH
GHIDXOWOD\RXWPDQDJHUIRUDSDQHO
%R[/D\RXW
$%R[/D\RXWPDQDJHULVOLNH)ORZ/D\RXWLQWKDW
HDFKFRPSRQHQWJHWVWRKDYHLWVRZQVL]HDQG
WKHFRPSRQHQWVDUHSODFHGLQWKHRUGHULQZKLFK
FRPSRQHQWVDGGHGWRS
SHU¶OLQH·
WRERWWRP RQH
WKH\·UHDGGHG%XWXQOLNH)ORZ/D\RXWD%R[/D\RXW
PDQDJHUFDQVWDFNWKHFRPSRQHQWVYHUWLFDOO\RU
KRUL]RQWDOO\EXWXVXDOO\ZH·UHMXVWFRQFHUQHGZLWK
YHUWLFDOO\,W·VOLNHD)ORZ/D\RXWEXWLQVWHDGRI
KDYLQJDXWRPDWLF¶FRPSRQHQWZUDSSLQJ·\RXFDQ
LQVHUWDVRUWRI¶FRPSRQHQWUHWXUQNH\·DQGIRUFH
WKHFRPSRQHQWVWRVWDUWDQHZOLQH
\RXDUHKHUH
ERUGHUOD\RXW
%RUGHU/D\RXWFDUHV
DERXWILYHUHJLRQV
HDVWZHVWQRUWK
VRXWKDQGFHQWHU
/HW·VDGGDEXWWRQWRWKHHDVWUHJLRQ
LPSRUWMDYD[VZLQJ
MDYDDZWSDFNDJH
LPSRUWMDYDDZW %RUGHU/D\RXWLVLQ
SXEOLFFODVV%XWWRQ^
%XWWRQJXL QHZ%XWWRQ
JXLJR
`
SXEOLFYRLGJR^ KHUHJLRQ
-)UDPHIUDPH QHZ-)UDPH VSHFLI\W
IUDPHVHW6L]H
IUDPHVHW9LVLEOHWUXH
`
`
DLQ EDUEHOO
EU%UDLQ%DUEHOO
+RZGLGWKH%RUGHU/D\RXWPDQDJHUFRPHXSZLWK
WKLVVL]HIRUWKHEXWWRQ"
:KDWDUHWKHIDFWRUVWKHOD\RXWPDQDJHUKDVWR
FRQVLGHU"
:K\LVQ·WLWZLGHURUWDOOHU"
FKDSWHU
XVLQJVZLQJ
:DWFKZKDWKDSSHQVZKHQZHJLYH
KHW H[W
WKHEXWWRQPRUHFKDUDFWHUV
H F K D Q J HGRQO\W
: EXWWRQ
SXEOLFYRLGJR^
RQWKH
-%XWWRQEXWWRQ QHZ-%XWWRQ³FOLFNOLNH\RXPHDQLW´
IUDPHVHW6L]H
IUDPHVHW9LVLEOHWUXH
`
)LUVW,DVNWKH
EXWWRQIRULWV
SUHIHUUHGVL]H ,KDYHDORWRIZRUGV
QRZVR,·GSUHIHUWREH
SL[HOVZLGHDQG
SL[HOVWDOO
FW
%X
WWRQREMH
6LQFHLW·VLQWKHHDVW
UHJLRQRIDERUGHUOD\RXW
,·OOUHVSHFWLWVSUHIHUUHGZLGWK%XW 1H[WWLPH
,GRQ·WFDUHKRZWDOOLWZDQWVWREH ,·PJRLQ·ZLWKÁRZ
LW·VJRQQDEHDVWDOODVWKHIUDPH OD\RXW7KHQ,JHW
EHFDXVHWKDW·VP\SROLF\ (9(5<7+,1*,
ZDQW
RQJHWV
7KHEXWIWHUUHGZLGWK
LWVSUH WKHLJKW
FW
EXWQR %X
WWRQREMH
\RXDUHKHUH
ERUGHUOD\RXW
/HW·VWU\DEXWWRQLQWKH1257+UHJLRQ
SXEOLFYRLGJR^
-%XWWRQEXWWRQ QHZ-%XWWRQ³7KHUHLVQRVSRRQ´
IUDPHVHW6L]H
IUDPHVHW9LVLEOHWUXH
`
DVLW
H E X W W R Q LVDVWDDVOOZLGHDV
7K WREHEXW
ZDQWV DPH
WKHIU
1RZOHW·VPDNHWKHEXWWRQDVNWREHWDOOHU
+RZGRZHGRWKDW"7KHEXWWRQLVDOUHDG\DVZLGH
DVLWFDQHYHUEH³DVZLGHDVWKHIUDPH%XWZH
FDQWU\WRPDNHLWWDOOHUE\JLYLQJLWDELJJHUIRQW
FHWKH
WZLOOIPRRUUHVSDFH
SXEOLFYRLGJR^
-)UDPHIUDPH QHZ-)UDPH J H U I R Q
-%XWWRQEXWWRQ QHZ-%XWWRQ³&OLFN7KLV´ $ELJ WRDOORFDWH KW
IUDPH HEXWWRQ·VKHLJ
IRUWK
)RQWELJ)RQW QHZ)RQW³VHULI´)RQW%2/'
EXWWRQVHW)RQWELJ)RQW
IUDPHVHW6L]H
IUDPHVHW9LVLEOHWUXH

KHVDPHEXWQRZ
`
7KHZLGWKVWD\VW WK OOHU7KHQRU H
WKHEXWWRQLVWD RDFFRPRGDW W
UHJLRQVWUHWFK ZW
HG
SUHIHUUHGKHLJK
WKHEXWWRQ·VQH
FKDSWHU
XVLQJVZLQJ
,WKLQN,·PJHWWLQJLWLI,·PLQHDVWRU
ZHVW,JHWP\SUHIHUUHGZLGWKEXWWKH
KHLJKWLVXSWRWKHOD\RXWPDQDJHU$QG
LI,·PLQQRUWKRUVRXWKLW·VMXVWWKH
RSSRVLWH³,JHWP\SUHIHUUHGKHLJKWEXW
But what happens
QRWZLGWK
FW
in the center region?
%X
WWRQREMH
7KHFHQWHUUHJLRQJHWVZKDWHYHU·VOHIW
H[FHSWLQRQHVSHFLDOFDVHZH¶OOORRNDWODWHU
SXEOLFYRLGJR^

-%XWWRQHDVW QHZ-%XWWRQ³(DVW´
-%XWWRQZHVW QHZ-%XWWRQ³:HVW´
-%XWWRQQRUWK QHZ-%XWWRQ³1RUWK´
-%XWWRQVRXWK QHZ-%XWWRQ³6RXWK´
-%XWWRQFHQWHU QHZ-%XWWRQ³&HQWHU´

IUDPHJHW&RQWHQW3DQHDGG%RUGHU/D\RXW($67HDVW
IUDPHJHW&RQWHQW3DQHDGG%RUGHU/D\RXW:(67ZHVW
IUDPHJHW&RQWHQW3DQHDGG%RUGHU/D\RXW1257+QRUWK
IUDPHJHW&RQWHQW3DQHDGG%RUGHU/D\RXW6287+VRXWK
IUDPHJHW&RQWHQW3DQHDGG%RUGHU/D\RXW&(17(5FHQWHU
IUDPHVHW6L]H
IUDPHVHW9LVLEOHWUXH
`
&RPSRQHQWV
ZKDWHYHUVSDFLQHWLVKHFHQWHUJHW :KHQ\RXSXWVRP
LQWKHQRUWKR HWKLQJ
EDVHGRQWKHIUD OHIWRYHU JRHVDOOWKHZD\UDVRXWKLW
[LQWKPHGLPHQVLRQV
SL[HOV
LVFRGH WKHIUDPHV FURVV

LQWKHHDVWDQRGWKZHWKLQJV
ZRQ·WEHDVWDOODVHVW
HDVWDQG ZRXOGEHLIWKH WKH\
&RPSRQHQWVHLLQUWSUKHHIHUUHGZLGWK VRXWKUHJLRQVZHUQRUWKDQG
ZHVWJHWWK HHPSW\
QRUWKDQG
&RPSRQHQWVLQHLWUKH SU HIHUUHG
VRXWKJHWWK
KHLJKW
SL[HOV
\RXDUHKHUH
IORZOD\RXW
)ORZ/D\RXWFDUHV
DERXWWKHÁRZRIWKH
FRPSRQHQWV
OHIWWRULJKWWRSWRERWWRPLQ
WKHRUGHUWKH\ZHUHDGGHG
/HW·VDGGDSDQHOWRWKHHDVWUHJLRQ
$-3DQHO·VOD\RXWPDQDJHULV)ORZ/D\RXWE\GHIDXOW:KHQZHDGG
DSDQHOWRDIUDPHWKHVL]HDQGSODFHPHQWRIWKHSDQHOLVVWLOO
XQGHUWKH%RUGHU/D\RXWPDQDJHU·VFRQWURO%XWDQ\WKLQJLQVLGHWKH
SDQHOLQRWKHUZRUGVFRPSRQHQWVDGGHGWRWKHSDQHOE\FDOOLQJ
SDQHODGGD&RPSRQHQWDUHXQGHUWKHSDQHO·V)ORZ/D\RXW
PDQDJHU·VFRQWURO:H·OOVWDUWE\SXWWLQJDQHPSW\SDQHOLQWKHIUDPH·V
HDVWUHJLRQDQGRQWKHQH[WSDJHVZH·OODGGWKLQJVWRWKHSDQHO
KDYHDQ\WKLQJ
7KHSDQHOGRHRHVQVQ·W·WDVNIRUPXFK
LQLWVRLWG HDVWUHJLRQ
ZLGWKLQWKH
LPSRUWMDYD[VZLQJ
LPSRUWMDYDDZW
SXEOLFFODVV3DQHO^
3DQHOJXL QHZ3DQHO
JXLJR
`
SXEOLFYRLGJR^
-)UDPHIUDPH QHZ-)UDPH 0DNHWKHSDQHOJUD\VRZHFDQVHH
-3DQHOSDQHO QHZ-3DQHO ZKHUHLWLVRQWKHIUDPH
SDQHOVHW%DFNJURXQG&RORUGDUN*UD\
IUDPHJHW&RQWHQW3DQHDGG%RUGHU/D\RXW($67SDQHO
IUDPHVHW6L]H
IUDPHVHW9LVLEOHWUXH
`
`

FKDSWHU
XVLQJVZLQJ
/HW·VDGGDEXWWRQWRWKHSDQHO
SXEOLFYRLGJR^
KH
-3DQHOSDQHO QHZ-3DQHO
E XW WR Q WR W KH SDQHODQGDGGWPDQDJHU
SDQHOVHW%DFNJURXQG&RORUGDUN*UD\ $GGWKH \RXW
PH7KHSDQHO·VODWKHIUDPH·V
SDQHOWRWKHIUDWK HEXWW RQ DQ G
IORZFRQWUROVERUGHUFRQWUROVWKHSDQHO
-%XWWRQEXWWRQ QHZ-%XWWRQ³VKRFNPH´
OD\RXWPDQ DJ HU
SDQHODGGEXWWRQ
IUDPHVHW6L]H
IUDPHVHW9LVLEOHWUXH
`
7KHSDQHOH[SDQGHG
$QGWKHEXWWRQJRWLW
SDQHO SDQHO SUHIHUUHGVL]HLQ V
GLPHQVLRQVEHFDXVHER WK
WKHSDQHO
XVHVIORZOD\RXWDQG
EXWWRQLVSDUWRIWKHWSKH
QRWWKHIUDPH DQHO
2N,QHHGWR ,QHHG
NQRZKRZELJWKH WRNQRZKRZELJWKH
SDQHOZDQWVWREH EXWWRQZDQWVWR
%DVHGRQP\IRQWVL]H
,KDYHDEXWWRQQRZ DQGWKHQXPEHURI
VRP\OD\RXWPDQDJHU·V FKDUDFWHUV,ZDQWWREH
JRQQDKDYHWRÀJXUHRXW SL[HOVZLGHDQGSL[HOVWDOO
KRZELJ,QHHGWREH FW
FRQWUROV FRQWUROV %X
3D WWRQREMH
W
QHOREMHF
7KHIUDPH·V 7KHSDQHO·V
%RUGHU/D\RXWPDQDJHU )ORZ/D\RXWPDQDJHU
\RXDUHKHUH
IORZOD\RXW
:KDWKDSSHQVLIZHDGG7:2EXWWRQV
WRWKHSDQHO"
SXEOLFYRLGJR^
V
2EXWWRQ
-%XWWRQEXWWRQ QHZ-%XWWRQ³VKRFNPH´ PDNH7:
-%XWWRQEXWWRQ7ZR QHZ-%XWWRQ³EOLVV´

SDQHODGGEXWWRQ DGG%27+WR
SDQHODGGEXWWRQ7ZR WKHSDQHO
IUDPHVHW6L]H
IUDPHVHW9LVLEOHWUXH
`

ZKDWZHZDQWHG ZKDWZHJRW

Z D Q W WK HEXWWRQHVDFK 7KHSDQHO
:H GRQWRSRI
VWDFNH ILWERWKEHXW[WSDQGHGWR
E\VLGH RQVVLGH
RWKHU
DQ
·E XWWRQ LVVPDOOHUZW K
WWKH¶EOLWVVRQWKDW·VKRZIORKDWLW
QRWLFHWFKNDPH·EXW VMXVWZ
WKH¶VKR RUNV7KHEXWWRQJHW
OD\RXWZ QGQRPRUH
QHHGVD
6KDUSHQ \RXU SHQFLO
)FTHECODEABOVEWEREMODIlEDTOTHECODEBELOW $RAWWHATYOU
WHATWOULDTHE'5)LOOKLIKE THINKTHE'5)WOULD
LOOKLIKEIFYOURAN
-%XWWRQEXWWRQ QHZ-%XWWRQ³VKRFNPH´ THECODETOTHELEFT
-%XWWRQEXWWRQ7KUHH QHZ-%XWWRQ³KXK"´ 4HENTRYIT
SDQHODGGEXWWRQ
SDQHODGGEXWWRQ7ZR
SDQHODGGEXWWRQ7KUHH
FKDSWHU
XVLQJVZLQJ
%R[/D\RXWWRWKHUHVFXH
,WNHHSVFRPSRQHQWV
VWDFNHGHYHQLIWKHUH·VURRP
WRSXWWKHPVLGHE\VLGH
8QOLNH)ORZ/D\RXW%R[/D\RXWFDQIRUFHD
¶QHZOLQH·WRPDNHWKHFRPSRQHQWVZUDSWR
WKHQH[WOLQHHYHQLIWKHUH·VURRPIRUWKHP
WRÀWKRUL]RQWDOO\
%XWQRZ\RX·OOKDYHWRFKDQJHWKHSDQHO·VOD\RXWPDQDJHUIURPWKH
GHIDXOW)ORZ/D\RXWWR%R[/D\RXW
SXEOLFYRLGJR^
QHZ
D\ R X W PD QDJHUWREHD
O
&KDQJHWKHI%R[/D\RXW
SDQHOVHW%DFNJURXQG&RORUGDUN*UD\ HR
LQVW D QF
SDQHOVHW/D\RXWQHZ%R[/D\RXWSDQHO%R[/D\RXW<B$;,6

7KH%R[/D\RXW
-%XWWRQEXWWRQ QHZ-%XWWRQ³VKRFNPH´ WKHFRPSRQHQWLWFR
V
QVWUXFWRUQHHGVWR
NQRZ
OD
DQGZKLFKD[LVWRX \LQJRXWLHWKHSDQHO
SDQHODGGEXWWRQ
SDQHODGGEXWWRQ7ZR
YHUWLFDOVWDFN VHZHXVH<B$;,6IRUD
IUDPHVHW6L]H
IUDPHVHW9LVLEOHWUXH
`
HUDJDLQ WRQV
OLVQDUURZE
W K HS D QH RWKEXW
1RWLFHKRZGRHVQ·WQHHGWRILWOGWKHIUDPH
EHFDXVHLW OO\6RWKHSDQHOWR O\WKHODUJHVW
KRUL]RQWD HQRXJKURRPIRURQ
LWQHHGHG KRFNPH·
EXWWRQ¶V
\RXDUHKHUH
OD\RXWPDQDJHUV
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: (OWCOMEYOUCANTADDDIRECTLYTOAFRAMETHEWAY
YOUCANTOAPANEL
:MDD=LHGAFLK
/D\RXWPDQDJHUVFRQWUROWKHVL]HDQGORFDWLRQRI
FRPSRQHQWVQHVWHGZLWKLQRWKHUFRPSRQHQWV
A: !*&RAMEISSPECIALBECAUSEITSWHERETHERUBBER
MEETSTHEROADINMAKINGSOMETHINGAPPEARONTHESCREEN
:KHQ\RXDGGDFRPSRQHQWWRDQRWKHUFRPSRQHQW
VRPHWLPHVUHIHUUHGWRDVDEDFNJURXQGFRPSRQHQW
EXWWKDW·VQRWDWHFKQLFDOGLVWLQFWLRQWKHDGGHG
7HILEALLYOUR3WINGCOMPONENTSAREPURE*AVAA*&RAME
HASTOCONNECTTOTHEUNDERLYING/3INORDERTOACCESSTHE FRPSRQHQWLVFRQWUROOHGE\WKHOD\RXWPDQDJHURIWKH
DISPLAY4HINKOFTHECONTENTPANEASAPURE*AVALAYER EDFNJURXQGFRPSRQHQW
THATSITSONTOPOFTHE*&RAME/RTHINKOFITASTHOUGH*&RAME $OD\RXWPDQDJHUDVNVFRPSRQHQWVIRUWKHLU
ISTHEWINDOWFRAMEANDTHECONTENTPANEISTHEGLASS9OU SUHIHUUHGVL]HEHIRUHPDNLQJDGHFLVLRQDERXW
KNOWTHEWINDOWPANE!NDYOUCANEVENSWAPTHECONTENT WKHOD\RXW'HSHQGLQJRQWKHOD\RXWPDQDJHU·V
Licensed by
PANEWITHYOUROWN*0ANELTOMAKEYOUR*0ANELTHEFRAMES SROLFLHVLWPLJKWUHVSHFWDOOVRPHRUQRQHRIWKH
CONTENTPANEUSING
FRPSRQHQW·VZLVKHV
P\)UDPHVHW&RQWHQW3DQHP\3DQHO
7KH%RUGHU/D\RXWPDQDJHUOHWV\RXDGGD
FRPSRQHQWWRRQHRIILYHUHJLRQV<RXPXVWVSHFLI\
Q:
Eduard Simons
#AN)CHANGETHELAYOUTMANAGEROFTHEFRAME WKHUHJLRQZKHQ\RXDGGWKHFRPSRQHQWXVLQJWKH
7HATIF)WANTTHEFRAMETOUSEmOWINSTEADOFBORDER IROORZLQJV\QWD[
DGG%RUGHU/D\RXW($67SDQHO
A: 4HEEASIESTWAYTODOTHISISTOMAKEAPANELBUILD
:LWK%RUGHU/D\RXWFRPSRQHQWVLQWKHQRUWKDQG
VRXWKJHWWKHLUSUHIHUUHGKHLJKWEXWQRWZLGWK
104038
THE'5)THEWAYYOUWANTINTHEPANELANDTHENMAKETHAT
&RPSRQHQWVLQWKHHDVWDQGZHVWJHWWKHLUSUHIHUUHG
PANELTHEFRAMESCONTENTPANEUSINGTHECODEINTHEPREVI
OUSANSWERRATHERTHANUSINGTHEDEFAULTCONTENTPANE
ZLGWKEXWQRWKHLJKW7KHFRPSRQHQWLQWKHFHQWHU
JHWVZKDWHYHULVOHIWRYHUXQOHVV\RXXVHSDFN
Q: 7HATIF)WANTADIFFERENTPREFERREDSIZE)STHEREA
7KHSDFNPHWKRGLVOLNHVKULQNZUDSIRUWKH
FRPSRQHQWVLWXVHVWKHIXOOSUHIHUUHGVL]HRIWKH
SET3IZE METHODFORCOMPONENTS FHQWHUFRPSRQHQWWKHQGHWHUPLQHVWKHVL]HRIWKH
IUDPHXVLQJWKHFHQWHUDVDVWDUWLQJSRLQWEXLOGLQJ
A: 9ESTHEREISASET3IZE BUTTHELAYOUTMANAGERSWILL
IGNOREIT4HERESADISTINCTIONBETWEENTHEPREFERREDSIZEOF
WKHUHVWEDVHGRQZKDW·VLQWKHRWKHUUHJLRQV
)ORZ/D\RXWSODFHVFRPSRQHQWVOHIWWRULJKWWRSWR
THECOMPONENTANDTHESIZEYOUWANTITTOBE4HEPREFERRED ERWWRPLQWKHRUGHUWKH\ZHUHDGGHGZUDSSLQJWRD
SIZEISBASEDONTHESIZETHECOMPONENTACTUALLYNEEDS QHZOLQHRIFRPSRQHQWVRQO\ZKHQWKHFRPSRQHQWV
THECOMPONENTMAKESTHATDECISIONFORITSELF 4HELAYOUT ZRQ·WILWKRUL]RQWDOO\
MANAGERCALLSTHECOMPONENTSGET0REFERRED3IZE METHOD
ANDTHATMETHODDOESNTCAREIFYOUVEPREVIOUSLYCALLED
)ORZ/D\RXWJLYHVFRPSRQHQWVWKHLUSUHIHUUHGVL]HLQ
SET3IZE ONTHECOMPONENT ERWKGLPHQVLRQV
%R[/D\RXWOHWV\RXDOLJQFRPSRQHQWVVWDFNHG
Q: #ANT)JUSTPUTTHINGSWHERE)WANTTHEM#AN)TURN
THELAYOUTMANAGERSOFF
YHUWLFDOO\HYHQLIWKH\FRXOGILWVLGHE\VLGH/LNH
)ORZ/D\RXW%R[/D\RXWXVHVWKHSUHIHUUHGVL]HRI
WKHFRPSRQHQWLQERWKGLPHQVLRQV
%RUGHU/D\RXWLVWKHGHIDXOWOD\RXWPDQDJHUIRUD
A: 9EP/NACOMPONENTBYCOMPONENTBASISYOUCANCALL IUDPH)ORZ/D\RXWLVWKHGHIDXOWIRUDSDQHO
VHW/D\RXWQXOOANDTHENITSUPTOYOUTOHARD CODE ,I\RXZDQWDSDQHOWRXVHVRPHWKLQJRWKHUWKDQIORZ
THEEXACTSCREENLOCATIONSANDDIMENSIONS)NTHELONGRUN \RXKDYHWRFDOOVHW/D\RXWRQWKHSDQHO
THOUGHITSALMOSTALWAYSEASIERTOUSELAYOUTMANAGERS
FKDSWHU
XVLQJVZLQJ
8TIaQVO_Q\P;_QVOKWUXWVMV\[
9OUVELEARNEDTHEBASICSOFLAYOUTMANAGERSSONOWLETSTRYOUTA
FEWOFTHEMOSTCOMMONCOMPONENTSATEXTlELDSCROLLINGTEXTAREA
CHECKBOXANDLIST7EWONTSHOWYOUTHEWHOLEDARN!0)FOREACHOF
THESEJUSTAFEWHIGHLIGHTSTOGETYOUSTARTED
-7H[W)LHOG
-7H[W)LHOG
O
-/DEH
L[HOV
F R OX P Q VQRWLGSWKRI
&RQVWUXFWRUV PHDQVLQHVWKHSUHIHUUHGZ
7KLVGHIWILHOG
-7H[W)LHOG¿HOG QHZ-7H[W)LHOG
WKHWH[
-7H[W)LHOG¿HOG QHZ-7H[W)LHOG³<RXUQDPH´
+RZWRXVHLW
*HWWH[WRXWRILW
6\VWHPRXWSULQWOQ¿HOGJHW7H[W
3XWWH[WLQLW
¿HOGVHW7H[W³ZKDWHYHU´
¿HOGVHW7H[W³³ LHOG
7KLVFOHDUVWKHI
<RXFDQDOVRUHJLVWHU
*HWDQ$FWLRQ(YHQWZKHQWKHXVHU
UHDOO\ZDQWWRKHDUD IRUNH\HYHQWVLI\RX

SUHVVHVUHWXUQRUHQWHU XVHUSUHVVHVDNH\ ERXWLWHYHU\WLPHWKH
¿HOGDGG$FWLRQ/LVWHQHUP\$FWLRQ/LVWHQHU
6HOHFW+LJKOLJKWWKHWH[WLQWKHÀHOG
¿HOGVHOHFW$OO
3XWWKHFXUVRUEDFNLQWKHÀHOGVRWKHXVHU
FDQMXVWVWDUWW\SLQJ
¿HOGUHTXHVW)RFXV
\RXDUHKHUH
WH[WDUHD
-7H[W$UHD
8QOLNH-7H[W)LHOG-7H[W$UHDFDQKDYHPRUHWKDQRQHOLQHRIWH[W,W
WDNHVDOLWWOHFRQÀJXUDWLRQWRPDNHRQHEHFDXVHLWGRHVQ·WFRPHRXWRI
WKHER[ZLWKVFUROOEDUVRUOLQHZUDSSLQJ7RPDNHD-7H[W$UHDVFUROO\RX
KDYHWRVWLFNLWLQD6FUROO3DQH$6FUROO3DQHLVDQREMHFWWKDWUHDOO\ORYHV
WRVFUROODQGZLOOWDNHFDUHRIWKHWH[WDUHD·VVFUROOLQJQHHGV
KHLJKW
VW K HSUHIHUUHG WK
PHDQV
OLQ H VV H W
H W VW K H S U HIHUUHGZLG
FROXPQVV
&RQVWUXFWRU PHDQV
-7H[W$UHDWH[W QHZ-7H[W$UHD
WKH U
+RZWRXVHLW
H DQGJLYHLW IR
D N H D -6FU LW·VJRLQJWR UROO
R OO 3 D Q V F
0 WKDW
WH[WDUHD
0DNHLWKDYHDYHUWLFDOVFUROOEDURQO\
-6FUROO3DQHVFUROOHU QHZ-6FUROO3DQHWH[W 7HOOWKHVFUROOSDQHWR
WH[WVHW/LQH:UDSWUXH DYHUWLFDOVFUROOEDU XVHRQO\
7XUQRQOLQHZUDSSLQJ
VFUROOHUVHW9HUWLFDO6FUROO%DU3ROLF\6FUROO3DQH&RQVWDQWV9(57,&$/B6&52//%$5B$/:$<6
VFUROOHUVHW+RUL]RQWDO6FUROO%DU3ROLF\6FUROO3DQH&RQVWDQWV+25,=217$/B6&52//%$5B1(9(5
SDQHODGGVFUROOHU ,PSRUWDQW<RXJ

VFUROOSDQHFRQ LYHWKHWH[WDUHD
WRW VFUROOSDQH
GRQ·WDGGWKHWH FWRUWKHQDGGWKHVFKH
VW UX WKURXJKWKH
UROOSDQHWRWK
[WDUHDGLUHFWO\W HSDQHO<RX
5HSODFHWKHWH[WWKDW·VLQLW
R WK H SD QHO
WH[WVHW7H[W³1RWDOOZKRDUHORVWDUHZDQGHULQJ´
$SSHQGWRWKHWH[WWKDW·VLQLW
WH[WDSSHQG³EXWWRQFOLFNHG´
6HOHFW+LJKOLJKWWKHWH[WLQWKHÀHOG
WH[WVHOHFW$OO
3XWWKHFXUVRUEDFNLQWKHÀHOGVRWKHXVHU
FDQMXVWVWDUWW\SLQJ
WH[WUHTXHVW)RFXV
FKDSWHU
XVLQJVZLQJ
-7H[W$UHDH[DPSOH
LPSRUWMDYD[VZLQJ
LPSRUWMDYDDZW
LPSRUWMDYDDZWHYHQW
SXEOLFFODVV7H[W$UHDLPSOHPHQWV$FWLRQ/LVWHQHU^
-7H[W$UHDWH[W
7H[W$UHDJXL QHZ7H[W$UHD
JXLJR
`
SXEOLFYRLGJR^
-%XWWRQEXWWRQ QHZ-%XWWRQ³-XVW&OLFN,W´
WH[W QHZ-7H[W$UHD
WH[WVHW/LQH:UDSWUXH

-6FUROO3DQHVFUROOHU QHZ-6FUROO3DQHWH[W

SDQHODGGVFUROOHU

IUDPHJHW&RQWHQW3DQHDGG%RUGHU/D\RXW&(17(5SDQHO

IUDPHVHW6L]H
IUDPHVHW9LVLEOHWUXH
`
SXEOLFYRLGDFWLRQ3HUIRUPHG$FWLRQ(YHQWHY^
WH[WDSSHQG³EXWWRQFOLFNHG?Q´
`
` ,QVHUWDQHZOLQHVRWKH
VHSDUDWHOL ZRUGVJRRQD
QHHDF WLPHWKHEXWW
FOLFNHG2WKHUZLVHKW RQLV
KH\·OOUXQWRJHWKHU
\RXDUHKHUH
FKHFNER[
WKHUH DUH QR
-&KHFN%R[ 'XPE 4XHVWLRQV
Q: !RENTTHELAYOUTMANAG
ERSJUSTMORETROUBLETHANTHEYRE
WORTH)F)HAVETOGOTOALLTHIS
TROUBLE)MIGHTASWELLJUSTHARD
CODETHESIZEANDCOORDINATESFOR
WHEREEVERYTHINGSHOULDGO
&RQVWUXFWRU
-&KHFN%R[FKHFN QHZ-&KHFN%R[³*RHVWR´ A: 'ETTINGTHEEXACTLAYOUT
YOUWANTFROMALAYOUTMAN
AGERCANBEACHALLENGE"UTTHINK
ABOUTWHATTHELAYOUTMANAGER
+RZWRXVHLW
ISREALLYDOINGFORYOU%VENTHE
SEEMINGLYSIMPLETASKOFFIGURING
/LVWHQIRUDQLWHPHYHQWZKHQLW·VVHOHFWHGRUGHVHOHFWHG OUTWHERETHINGSSHOULDGOON
FKHFNDGG,WHP/LVWHQHUWKLV THESCREENCANBECOMPLEX&OR
EXAMPLETHELAYOUTMANAGERTAKES
CAREOFKEEPINGYOURCOMPONENTS
FROMOVERLAPPINGONEANOTHER
+DQGOHWKHHYHQWDQGÀQGRXWZKHWKHURUQRWLW·VVHOHFWHG )NOTHERWORDSITKNOWSHOWTO
MANAGETHESPACINGBETWEEN
SXEOLFYRLGLWHP6WDWH&KDQJHG,WHP(YHQWHY^ COMPONENTSANDBETWEENTHE
6WULQJRQ2U2II ³RII´ EDGEOFTHEFRAME 3UREYOUCAN
LIFKHFNLV6HOHFWHGRQ2U2II ³RQ´ DOTHATYOURSELFBUTWHATHAPPENS
6\VWHPRXWSULQWOQ³&KHFNER[LV³RQ2U2II IFYOUWANTCOMPONENTSTOBE
` VERYTIGHTLYPACKED9OUMIGHTGET
THEMPLACEDJUSTRIGHTBYHAND
BUTTHATSONLYGOODFORYOUR*6-
6HOHFWRUGHVHOHFWLWLQFRGH 7HY"ECAUSETHECOMPONENTS
CANBESLIGHTLYDIFFERENTFROM
FKHFNVHW6HOHFWHGWUXH PLATFORMTOPLATFORMESPECIALLYIF
FKHFNVHW6HOHFWHGIDOVH THEYUSETHEUNDERLYINGPLATFORMS
NATIVE@LOOKANDFEEL3UBTLETHINGS
LIKETHEBEVELOFTHEBUTTONSCAN
BEDIFFERENTINSUCHAWAYTHAT
COMPONENTSTHATLINEUPNEATLY
ONONEPLATFORMSUDDENLYSQUISH
TOGETHERONANOTHER
!NDWERESTILLNOTATTHEREALLY"IG
4HINGTHATLAYOUTMANAGERSDO
4HINKABOUTWHATHAPPENSWHEN
THEUSERRESIZESTHEWINDOW/R
YOUR'5)ISDYNAMICWHERECOM
PONENTSCOMEANDGO)FYOUHAD
TOKEEPTRACKOFRE LAYINGOUTALL
THECOMPONENTSEVERYTIMETHERES
ACHANGEINTHESIZEORCONTENTSOF
ABACKGROUNDCOMPONENTYIKES
FKDSWHU
XVLQJVZLQJ
-/LVW
-/LVWFRQVWUXFWRUW
W\SH7KH\GRQ·WKD DNHVDQDUUD\RIDQ\REMHFW
6WULQJUHSUHVHQWDW YHWREH6WULQJVEXWD
LRQZLOODSSHDULQW
&RQVWUXFWRU KHOLVW
6WULQJ>@OLVW(QWULHV ^³DOSKD´³EHWD´³JDPPD´³GHOWD´
³HSVLORQ´³]HWD´³HWD´³WKHWD³`
OLVW QHZ-/LVWOLVW(QWULHV
DNHD
LWK-7H[W $ UHD\RXP WKH
+RZWRXVHLW HZ GG
7KLVLVMXVWOLN QGJLYHLWWKHOLVWWKHQD
-6FUROO3 DQ H D WRWKH SD QH O
27WKHOLVW
0DNHLWKDYHDYHUWLFDOVFUROOEDU
-6FUROO3DQHVFUROOHU QHZ-6FUROO3DQHOLVW VFUROOSDQH1
SDQHODGGVFUROOHU
6HWWKHQXPEHURIOLQHVWRVKRZEHIRUHVFUROOLQJ
OLVWVHW9LVLEOH5RZ&RXQW
5HVWULFWWKHXVHUWRVHOHFWLQJRQO\21(WKLQJDWDWLPH
OLVWVHW6HOHFWLRQ0RGH/LVW6HOHFWLRQ0RGHO6,1*/(B6(/(&7,21
5HJLVWHUIRUOLVWVHOHFWLRQHYHQWV
OLVWDGG/LVW6HOHFWLRQ/LVWHQHUWKLV
:,&(LI\RXGRQ ·W
<RX·OOJHWWKHHYHQW7
+DQGOHHYHQWVÀQGRXWZKLFKWKLQJLQWKHOLVWZDVVHOHFWHG SXWLQWKLVLIWHVW
SXEOLFYRLGYDOXH&KDQJHG/LVW6HOHFWLRQ(YHQWOVH^
LIOVHJHW9DOXH,V$GMXVWLQJ^
6WULQJVHOHFWLRQ 6WULQJOLVWJHW6HOHFWHG9DOXH JHW6HOHFWHG9DOXHDFWX
6\VWHPRXWSULQWOQVHOHFWLRQ UHWXUQVDQ2EMHFW$OLVWDOO\
`
OLPLWHGWRRQO\6WULQJREMHLVQ·W
` FWV
\RXDUHKHUH
&RGH.LWFKHQ
Code Kitchen
This partÕs optional. WeÕre making the full BeatBox, GUI

and all. In the Saving Objects chapter, weÕll learn how to
save and restore drum patterns. Finally, in the networking
chapter (Make a Connection), weÕll turn the BeatBox into a
working chat client.
FKDSWHU
XVLQJVZLQJ
5ISQVO\PM*MI\*W`
4HISISTHEFULLCODELISTINGFORTHISVERSIONOFTHE"EAT"OXWITHBUTTONSFORSTARTING
STOPPINGANDCHANGINGTHETEMPO4HECODELISTINGISCOMPLETEANDFULLY
ANNOTATEDBUTHERESTHEOVERVIEW
%XLOGD*8,WKDWKDVFKHFNER[HV-&KHFN%R[WKDWVWDUWRXW

XQFKHFNHGODEHOV-/DEHOIRUWKHLQVWUXPHQWQDPHVDQGIRXU
EXWWRQV
5HJLVWHUDQ$FWLRQ/LVWHQHUIRUHDFKRIWKHIRXUEXWWRQV:HGRQ·W
QHHGOLVWHQHUVIRUWKHLQGLYLGXDOFKHFNER[HVEHFDXVHZHDUHQ·W
WU\LQJWRFKDQJHWKHSDWWHUQVRXQGG\QDPLFDOO\LHDVVRRQDVWKH
XVHUFKHFNVDER[,QVWHDGZHZDLWXQWLOWKHXVHUKLWVWKH¶VWDUW·
EXWWRQDQGWKHQZDONWKURXJKDOOFKHFNER[HVWRJHWWKHLUVWDWH
DQGPDNHD0,',WUDFN
6HWXSWKH0,',V\VWHP\RX·YHGRQHWKLVEHIRUHLQFOXGLQJJHWWLQJ

D6HTXHQFHUPDNLQJD6HTXHQFHDQGFUHDWLQJDWUDFN:HDUHXVLQJ
DVHTXHQFHUPHWKRGWKDW·VQHZWR-DYDVHW/RRS&RXQW7KLV
PHWKRGDOORZV\RXWRVSHFLI\KRZPDQ\WLPHV\RXZDQWDVHTXHQFH
WRORRS:H·UHDOVRXVLQJWKHVHTXHQFH·VWHPSRIDFWRUWRDGMXVWWKH
WHPSRXSRUGRZQDQGPDLQWDLQWKHQHZWHPSRIURPRQHLWHUDWLRQRI
WKHORRSWRWKHQH[W
:KHQWKHXVHUKLWV¶VWDUW·WKHUHDODFWLRQEHJLQV7KHHYHQWKDQGOLQJ
PHWKRGIRUWKH¶VWDUW·EXWWRQFDOOVWKHEXLOG7UDFN$QG6WDUWPHWKRG
,QWKDWPHWKRGZHZDONWKURXJKDOOFKHFNER[HVRQHURZDW
DWLPHDVLQJOHLQVWUXPHQWDFURVVDOOEHDWVWRJHWWKHLUVWDWH
WKHQXVHWKHLQIRUPDWLRQWREXLOGD0,',WUDFNXVLQJWKHKDQG\
PDNH(YHQWPHWKRGZHXVHGLQWKHSUHYLRXVFKDSWHU2QFHWKHWUDFN
LVEXLOWZHVWDUWWKHVHTXHQFHUZKLFKNHHSVSOD\LQJEHFDXVHZH·UH
ORRSLQJLWXQWLOWKHXVHUKLWV¶VWRS·
\RXDUHKHUH
%HDW%R[FRGH
LPSRUWMDYDDZW
LPSRUWMDYD[VZLQJ
LPSRUWMDYDXWLO
LPSRUWMDYDDZWHYHQW
SXEOLFFODVV%HDW%R[^
$UUD\/LVW
-3DQHOPDLQ3DQHO
$UUD\/LVW-&KHFN%R[!FKHFNER[/LVW
:HVWRUHWKHFKHFNER[HVLQDQ
6HTXHQFHUVHTXHQFHU
6HTXHQFHVHTXHQFH
7UDFNWUDFN
-)UDPHWKH)UDPH 7KHVHDUHWKHQDPHVRIWKHLQVWUXPHQWVDVD6WULQJ
DUUD\IRUEXLOGLQJWKH*8,ODEHOVRQHDFKURZ
6WULQJ>@LQVWUXPHQW1DPHV ^³%DVV'UXP´³&ORVHG+L+DW´
³2SHQ+L+DW´´$FRXVWLF6QDUH´³&UDVK&\PEDO´³+DQG&ODS´
³+LJK7RP´³+L%RQJR´³0DUDFDV´³:KLVWOH´³/RZ&RQJD´
³&RZEHOO´³9LEUDVODS´³/RZPLG7RP´³+LJK$JRJR´
³2SHQ+L&RQJD´`
LQW>@LQVWUXPHQWV ^`

7KHVHUHSUHVHQWWKHDFWXDOGUXP¶NH
\V·
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ 7KHGUXPFKDQQHOLVOLNHDSLDQRH[FHSW
QHZ%HDW%R[EXLOG*8, HDFK¶NH\·RQWKHSLDQRLVDGLIIHUHQWGU
` 6RWKHQXPEHU¶·LVWKHNH\I XP
GUXPLV&ORVHG+L+DWHWFRUWKH%DVV
SXEOLFYRLGEXLOG*8,^
WKH)UDPH QHZ-)UDPH³&\EHU%HDW%R[´
WKH)UDPHVHW'HIDXOW&ORVH2SHUDWLRQ-)UDPH(;,7B21B&/26(
%RUGHU/D\RXWOD\RXW QHZ%RUGHU/D\RXW
-3DQHOEDFNJURXQG QHZ-3DQHOOD\RXW
EDFNJURXQGVHW%RUGHU%RUGHU)DFWRU\FUHDWH(PSW\%RUGHU
FKHFNER[/LVW QHZ$UUD\/LVW-&KHFN%R[!
$Q¶HPSW\ERUGH
%R[EXWWRQ%R[ QHZ%R[%R[/D\RXW<B$;,6
EHWZHHQWKHHGJHU·VRJLYIHV XVDPDUJLQ
ZKHUHWKHFRPSRQHQWVDWKHSDQHODQG
-%XWWRQVWDUW QHZ-%XWWRQ³6WDUW´
3XUHO\DHVWKHWLF UHSODFHG
VWDUWDGG$FWLRQ/LVWHQHUQHZ0\6WDUW/LVWHQHU
EXWWRQ%R[DGGVWDUW

-%XWWRQVWRS QHZ-%XWWRQ³6WRS´
VWRSDGG$FWLRQ/LVWHQHUQHZ0\6WRS/LVWHQHU
EXWWRQ%R[DGGVWRS UHMXVWORWVRI*8,
1RWKLQJVSHFLDOKHP LWEHIRUH
-%XWWRQXS7HPSR QHZ-%XWWRQ³7HPSR8S´ FRGH<RX·YHVHHQ RVWRI
XS7HPSRDGG$FWLRQ/LVWHQHUQHZ0\8S7HPSR/LVWHQHU
EXWWRQ%R[DGGXS7HPSR
-%XWWRQGRZQ7HPSR QHZ-%XWWRQ³7HPSR'RZQ´
FKDSWHU
XVLQJVZLQJ
GRZQ7HPSRDGG$FWLRQ/LVWHQHUQHZ0\'RZQ7HPSR/LVWHQHU
EXWWRQ%R[DGGGRZQ7HPSR
%R[QDPH%R[ QHZ%R[%R[/D\RXW<B$;,6

IRULQWL LL^
QDPH%R[DGGQHZ/DEHOLQVWUXPHQW1DPHV>L@
`

XSFRGH
EDFNJURXQGDGG%RUGHU/D\RXW($67EXWWRQ%R[ 6WLOOPRUH*8,VHW
OH
EDFNJURXQGDGG%RUGHU/D\RXW:(67QDPH%R[ 1RWKLQJUHPDUN DE
WKH)UDPHJHW&RQWHQW3DQHDGGEDFNJURXQG

*ULG/D\RXWJULG QHZ*ULG/D\RXW
JULGVHW9JDS
JULGVHW+JDS
PDLQ3DQHO QHZ-3DQHOJULG
EDFNJURXQGDGG%RUGHU/D\RXW&(17(5PDLQ3DQHO
IRULQWL LL^

-&KHFN%R[F QHZ-&KHFN%R[
FVHW6HOHFWHGIDOVH
FKHFNER[/LVWDGGF 0DNHWKHFKHFNER[HVVHWW
PDLQ3DQHODGGF ¶IDOVH·VRWKH\DUHQ·WF KHPWR
`HQGORRS DGGWKHPWR KHF NHG DQG
WKH$UUD\/LVW$1'WR
WKH*8,SDQHO
VHW8S0LGL
WKH)UDPHVHW%RXQGV
WKH)UDPHSDFN
WKH)UDPHVHW9LVLEOHWUXH
`FORVHPHWKRG
SXEOLFYRLGVHW8S0LGL^
WU\^
7KHXVXDO0,',VHWXSVWXII
VHTXHQFHU 0LGL6\VWHPJHW6HTXHQFHU
JHWWLQJWKH6HTXHQFHUWKH6 IRU
VHTXHQFHURSHQ
DQGWKH7UDFN$JDLQQRWKLQ HTXHQFH
VHTXHQFH QHZ6HTXHQFH6HTXHQFH334 JVSHFLDO
WUDFN VHTXHQFHFUHDWH7UDFN

`FDWFK([FHSWLRQH^HSULQW6WDFN7UDFH`
`FORVHPHWKRG
\RXDUHKHUH
%HDW%R[FRGH
SSHQV:KHUHZH
7KLVLVZKHUHLWDOOKDLQW
0,',HYHQWV W KHYDOXHVIHQRUWLV
WXUQFKHFNER[VWDWH 7R D \ W R K R OG
WDUU WV,IWKHLQVWUXP HQW
FN :H·OOPDNXP HDHOHPRHQ OOEHD YDOXHDWWKDWHOHP R
DQGDGGWKHPWRWKH UD W D FU VV D
RQHLQVWU RHQSOD\RQWKDWEHDWWHQKH V127VXSSRVH
GW
S S R VH G W L QVW U XP W L
SXEOLFYRLGEXLOG7UDFN$QG6WDUW^ VX NH\,IWKXW DW
LQW>@WUDFN/LVW QXOO ZLOOEHWKH D W E HD W S LQD]HUR
SOD \ R Q W K
VHTXHQFHGHOHWH7UDFNWUDFN PDNHDIUHVKRQH
WUDFN VHTXHQFHFUHDWH7UDFN JHWULGRIWKHROGWUDFN
WF
KLV I RU HD FK RI W KH 52:6LH%DVV&RQJRH
IRULQWL LL^ GR W
WUDFN/LVW QHZLQW>@
SUHVHQWVZKLFKLQVWUU UXPHQWWKLV
Licensed by

6HWWKH¶NH\·WKDWWFUH7 LQVW UX PH QWVD D\KROGVWKH
LQWNH\ LQVWUXPHQWV>L@ LV%DVV+L+DWH UVIRKH UHDFKLQVWUXPH QW
DFWXDO0,',QXPEH
IRULQWM MM^ KLVIRUHDFKRIWKH%($76IRUW
KLVURZ
'RW
Eduard Simons

-&KHFN%R[MF -&KHFN%R[FKHFNER[/LVWJHWM L
LIMFLV6HOHFWHG^
WUDFN/LVW>M@ NH\
`HOVH^ ,VWKHFKHFNER[DWWKLVEHDWVHOHFWHG",I\HVSXW
WKHNH\YDOXHLQWKLVVORWLQWKHDUUD\WKHVORWWKDW
104038
WUDFN/LVW>M@
` UHSUHVHQWVWKLVEHDW2WKHUZLVHWKHLQVWUXPHQWLV
`FORVHLQQHUORRS 127VXSSRVHGWRSOD\DWWKLVEHDWVRVHWLWWR]HUR

EHDWV
PDNH7UDFNVWUDFN/LVW )RUWKLVLQVWUXPHQWDQGIRUDOO
WUDFNDGGPDNH(YHQW PDNHHYHQWVDQGDGGWKHPWRWKHWUDFN
`FORVHRXWHU
:HDOZD\VZDQWWRPDNHVXUHWKDWWKHUH,6DQHYHQWDW
WUDFNDGGPDNH(YHQW EHDWLWJRHVWR2WKHUZLVHWKH%HDW%R[PLJKW
WU\^ QRWJRWKHIXOOEHDWVEHIRUHLWVWDUWVRYHU

VHTXHQFHUVHW6HTXHQFHVHTXHQFH
/HW·V\RXVSHFLI\WKHQXPEHU
VHTXHQFHUVHW/RRS&RXQWVHTXHQFHU/223B&217,18286/<
VHTXHQFHUVWDUW RIORRSLWHUDWLRQVRULQWKLV
VHTXHQFHUVHW7HPSR,Q%30 FDVHFRQWLQXRXVORRSLQJ
`FORVHEXLOG7UDFN$QG6WDUWPHWKRG
12:3/$<7+(7+,1*

SXEOLFFODVV0\6WDUW/LVWHQHULPSOHPHQWV$FWLRQ/LVWHQHU^
SXEOLFYRLGDFWLRQ3HUIRUPHG$FWLRQ(YHQWD^
EXLOG7UDFN$QG6WDUW )LUVWRIWKHLQQHUFOD V
` OLVWHQHUVIRUWKHEXWWVVH
RQV
`FORVHLQQHUFODVV 1RWKLQJVSHFLDOK HUH
FKDSWHU
XVLQJVZLQJ
SXEOLFFODVV0\6WRS/LVWHQHULPSOHPHQWV$FWLRQ/LVWHQHU^
VHTXHQFHUVWRS
`
`FORVHLQQHUFODVV
7KHRWKHULQQHUFODVV
SXEOLFFODVV0\8S7HPSR/LVWHQHULPSOHPHQWV$FWLRQ/LVWHQHU^ OLVWHQHUVIRUWKHEXWWRQV
ÀRDWWHPSR)DFWRU VHTXHQFHUJHW7HPSR)DFWRU
VHTXHQFHUVHW7HPSR)DFWRUÀRDWWHPSR)DFWRU
`
`FORVHLQQHUFODVV
7KH7HPSR)DFWRUVFDOHV
SXEOLFFODVV0\'RZQ7HPSR/LVWHQHULPSOHPHQWV$FWLRQ/LVWHQHU^ WKHVHTXHQFHU·VWHPSRE\
SXEOLFYRLGDFWLRQ3HUIRUPHG$FWLRQ(YHQWD^ WKHIDFWRUSURYLGHG7KH
ÀRDWWHPSR)DFWRU VHTXHQFHUJHW7HPSR)DFWRU GHIDXOWLVVRZH·UH
VHTXHQFHUVHW7HPSR)DFWRUÀRDWWHPSR)DFWRU DGMXVWLQJSHU
` FOLFN
`FORVHLQQHUFODVV
RQHLQVWUXPHQWDWDWK WLPHIRU
7KLVPDNHVHYHQWVIRUJKW

WDQLQW> @ IRU H%DVV
DOOEHDWV6RLWPL LQJH WKH DU UD\ ZL OOK ROG HL WKHU
SXEOLFYRLGPDNH7UDFNVLQW>@OLVW^
GUX P DQG HDFKLQGH[ ]H UR ,I LW ·VD]HUR

WKH NH \R IW KDWLQVWUXPHQWRUDSOD \DWWKDW DW EH
IRULQWL LL^
LQ VWU XP HQW LVQ·WVXSSRVHGWR WW
WKH DGGL RWKHWUDFN
2WKHUZLVHPDNHDQHYHQWDQG
LQWNH\ OLVW>L@
LINH\ ^
0DNHWKH127(21DQG
WUDFNDGGPDNH(YHQWNH\L
1272))HYHQWVDQG
WUDFNDGGPDNH(YHQWNH\L
DGGWKHPWRWKH7UDFN
`
`
`

0LGL(YHQWHYHQW QXOO
WU\^
7KLVLVWKHXWLOLW\
HYHQW QHZ0LGL(YHQWDWLFN PHWKRG FKDSWHU·V&RGH.LW IURPODVW
FKHQ1RWKLQJQ HZ
UHWXUQHYHQW
`
`FORVHFODVV
\RXDUHKHUH
H[HUFLVH:KLFK/D\RXW"
1dQÔU_Q :KLFKFRGHJRHVZLWK
ZKLFKOD\RXW"
)LYHRIWKHVL[VFUHHQVEHORZZHUHPDGHIURPRQH
RIWKHFRGHIUDJPHQWVRQWKHRSSRVLWHSDJH0DWFK
HDFKRIWKH¿YHFRGHIUDJPHQWVZLWKWKHOD\RXWWKDW
IUDJPHQWZRXOGSURGXFH

"
FKDSWHU
XVLQJVZLQJ
&RGH)UDJPHQWV
, -3DQHOSDQHO QHZ-3DQHO
-%XWWRQEXWWRQ QHZ-%XWWRQ³WHVXML´
-%XWWRQEXWWRQ7ZR QHZ-%XWWRQ³ZDWDUL´
IUDPHJHW&RQWHQW3DQHDGG%RUGHU/D\RXW1257+SDQHO
SDQHODGGEXWWRQ7ZR
IUDPHJHW&RQWHQW3DQHDGG%RUGHU/D\RXW&(17(5EXWWRQ

* -3DQHOSDQHO QHZ-3DQHO
SDQHODGGEXWWRQ7ZR
+ -)UDPHIUDPH QHZ-)UDPH

SDQHODGGEXWWRQ7ZR

)
SDQHODGGEXWWRQ
IUDPHJHW&RQWHQW3DQHDGG%RUGHU/D\RXW1257+EXWWRQ7ZR

- -3DQHOSDQHO QHZ-3DQHO
SDQHODGGEXWWRQ7ZR
\RXDUHKHUH
SX]]OHFURVVZRUG
*8,&URVV

9OUCANDOIT

!CROSS 3HAKEITBABY $OWN -ANAGERSRULES

!RTISTSSANDBOX ,OTSTOSAY 3WINGSDAD 3OURCESBEHAVIOR
"ORDERSCATCHALL #HOOSEMANY &RAMESPURVIEW "ORDERBYDEFAULT
*AVALOOK "UTTONSPAL (ELPSHOME 5SERSBEHAVIOR
'ENERICWAITER (OMEOF -OREFUNTHANTEXT )NNERSSQUEEZE
!HAPPENING ACTION0ERFORMED #OMPONENTSLANG "ACKSTAGEWIDGET
!PPLYAWIDGET 2OMULINCOMMAND -ACLOOK
*0ANELSDEFAULT !RRANGE "ORDERSRIGHT
0OLYMORPHICTEST "ORDERSTOP
FKDSWHU
XVLQJVZLQJ
([HUFLVH6ROXWLRQV

+ -3DQHOSDQHO QHZ-3DQHO
SDQHODGGEXWWRQ7ZR

, -3DQHOSDQHO QHZ-3DQHO
SDQHODGGEXWWRQ7ZR

- -3DQHOSDQHO QHZ-3DQHO
SDQHODGGEXWWRQ7ZR

) -3DQHOSDQHO QHZ-3DQHO
SDQHODGGEXWWRQ
IUDPHJHW&RQWHQW3DQHDGG%RUGHU/D\RXW1257+EXWWRQ7ZR

* -3DQHOSDQHO QHZ-3DQHO
SDQHODGGEXWWRQ7ZR
\RXDUHKHUH
SX]]OHDQVZHUV
3X]]OH$QVZHUV
*8,&URVV

'5$:3$1(/6

:&(17(5

0(7$/7*:

6(/,67(1(5,

(9(17$,2$''

783<=53*

9&)/2:2(7+(

,6$5/8+,7

6/$1,0$7,21&

,/0&&83

%%(<7(;7$5($$
/$,(41

(&+(&.%2;58(

.$1/$%(/
6

$&7,21/,67(1(5
FKDSWHU
VHULDOL]DWLRQDQGILOH,2
6DYLQJ2EMHFWV ,I,KDYHWRUHDG
RQHPRUHÀOHIXOORI
GDWD,WKLQN,·OOKDYHWRNLOOKLP+H
NQRZV,FDQVDYHZKROHREMHFWVEXW
GRHVKHOHWPH"12WKDWZRXOGEH
WRRHDV\:HOOZH·OOMXVWVHHKRZ
KHIHHOVDIWHU,
2EMHFWVFDQEHIODWWHQHGDQGLQIODWHG/BJECTSHAVESTATEANDBEHAVIOR
"EHAVIORLIVESINTHECLASSBUTSTATELIVESWITHINEACHINDIVIDUALOBJECT3OWHATHAPPENSWHEN
ITSTIMETOSAVETHESTATEOFANOBJECT)FYOUREWRITINGAGAMEYOUREGONNANEEDA3AVE
2ESTORE'AMEFEATURE)FYOUREWRITINGANAPPTHATCREATESCHARTSYOUREGONNANEEDA3AVE
/PEN&ILEFEATURE)FYOURPROGRAMNEEDSTOSAVESTATEYOUCANDOITTHEHARDWAYINTERROGATING
EACHOBJECTTHENPAINSTAKINGLYWRITINGTHEVALUEOFEACHINSTANCEVARIABLETOAFILEINA
FORMATYOUCREATE/RYOUCANDOITTHEEASY//WAYYOUSIMPLYFREEZE DRYFLATTENPERSIST
DEHYDRATETHEOBJECTITSELFANDRECONSTITUTEINFLATERESTOREREHYDRATEITTOGETITBACK"UTYOULL
STILLHAVETODOITTHEHARDWAYSOMETIMESESPECIALLYWHENTHEFILEYOURAPPSAVESHASTOBEREAD
BYSOMEOTHERNON *AVAAPPLICATIONSOWELLLOOKATBOTHINTHISCHAPTER
WKLVLVDQHZFKDSWHU
VDYLQJREMHFWV
+IX\]ZM\PM*MI\
9OUVEMADETHEPERFECTPATTERN9OUWANTTOSAVETHEPATTERN
9OUCOULDGRABAPIECEOFPAPERANDSTARTSCRIBBLINGITDOWNBUT
INSTEADYOUHITTHE3AVEBUTTONORCHOOSE3AVEFROMTHE&ILE
MENU 4HENYOUGIVEITANAMEPICKADIRECTORY
ANDEXHALEKNOWINGTHATYOURMASTERPIECEWONTGO
OUTTHEWINDOWWITHTHEBLUESCREENOFDEATH
9OUHAVELOTSOFOPTIONSFORHOWTOSAVETHESTATEOF
YOUR*AVAPROGRAMANDWHATYOUCHOOSEWILLPROBABLY
DEPENDONHOWYOUPLANTOUSETHESAVEDSTATE(ERE
ARETHEOPTIONSWELLBELOOKINGATINTHISCHAPTER
,I\RXUGDWDZLOOEHXVHGE\RQO\WKH-DYD
SURJUDPWKDWJHQHUDWHGLW
8VHVHULDOL]DWLRQ
:ULWHDÀOHWKDWKROGVÁDWWHQHGVHULDOL]HG
REMHFWV7KHQKDYH\RXUSURJUDPUHDGWKH
VHULDOL]HGREMHFWVIURPWKHÀOHDQGLQÁDWHWKHP
EDFNLQWROLYLQJEUHDWKLQJKHDSLQKDELWLQJREMHFWV
,I\RXUGDWDZLOOEHXVHGE\RWKHUSURJUDPV
:ULWHDSODLQWH[WÀOH
:ULWHDÀOHZLWKGHOLPLWHUVWKDWRWKHUSURJUDPVFDQSDUVH
)RUH[DPSOHDWDEGHOLPLWHGÀOHWKDWDVSUHDGVKHHWRU
GDWDEDVHDSSOLFDWLRQFDQXVH
4HESEARENTTHEONLYOPTIONSOFCOURSE9OUCANSAVEDATAINANY
FORMATYOUCHOOSE)NSTEADOFWRITINGCHARACTERSFOREXAMPLE
YOUCANWRITEYOURDATAASBYTES/RYOUCANWRITEOUTANYKIND
OF*AVAPRIMITIVEASA*AVAPRIMITIVETHEREAREMETHODSTOWRITE
INTSLONGSBOOLEANSETC"UTREGARDLESSOFTHEMETHODYOUUSE
THEFUNDAMENTAL)/TECHNIQUESAREPRETTYMUCHTHESAME
WRITESOMEDATATOSOMETHINGANDUSUALLYTHATSOMETHINGISEITHER
AlLEONDISKORASTREAMCOMINGFROMANETWORKCONNECTION
2EADINGTHEDATAISTHESAMEPROCESSINREVERSEREADSOMEDATA
FROMEITHERAlLEONDISKORANETWORKCONNECTION!NDOFCOURSE
EVERYTHINGWETALKABOUTINTHISPARTISFORTIMESWHENYOUARENT
USINGANACTUALDATABASE
FKDSWHU
;I^QVO;\I\M
)MAGINEYOUHAVEAPROGRAMSAYAFANTASY
ADVENTUREGAMETHATTAKESMORETHANONE
SESSIONTOCOMPLETE!STHEGAMEPROGRESSES
CHARACTERSINTHEGAMEBECOMESTRONGERWEAKER
SMARTERETCANDGATHERANDUSEANDLOSE Imagine you
WEAPONS9OUDONTWANTTOSTARTFROMSCRATCH have three
g
characters ame
EACHTIMEYOULAUNCHTHEGAMEITTOOKYOU
FOREVERTOGETYOURCHARACTERSINTOPSHAPEFOR
ASPECTACULARBATTLE3OYOUNEEDAWAYTOSAVE
to save...
*DPH&KDUDFWHU
THESTATEOFTHECHARACTERSANDAWAYTORESTORE
THESTATEWHENYOURESUMETHEGAME!NDSINCE LQWSRZHU
YOUREALSOTHEGAMEPROGRAMMERYOUWANTTHE 6WULQJW\SH
WHOLESAVEANDRESTORETHINGTOBEASEASYAND :HDSRQ>@ZHDSRQV
FOOLPROOF ASPOSSIBLE
JHW:HDSRQ
XVH:HDSRQ
LQFUHDVH3RZHU
SRZHU
2SWLRQRQH PRUH W\SH(OI
:ULWHWKHWKUHHVHULDOL]HG ZHDSRQVERZ
FKDUDFWHUREMHFWVWRDÀOH VZRUGGXVW
&UHDWHDÀOHDQGZULWHWKUHHVHULDOL]HG R EMHFW
FKDUDFWHUREMHFWV7KHÀOHZRQ·WPDNH SRZHU
VHQVHLI\RXWU\WRUHDGLWDVWH[W W\SH7UROO
ZHDSRQVEDUH
ñÔ[Z/IUM+PIZIK\MZ
KDQGVELJD[

ñ Ow 5Ú1XW_MZ4RIÎTIVO
;\ZQVO#C_MIXWV[\C4RIÎTIVO
R EMHFW
;\ZQVO#`X\TN]ZC4RIÎTIVO;\ZQVO#¹>Î SRZHU
Ðc/`X\JW_\[_WZL\L][\[Yf¯\<ZWTT]Yf\J W\SH0DJLFLDQ
IZMPIVL[\JQOI`[Yf`\5IOQKQIV]Yf\[XM
ZHDSRQVVSHOOV
TT[\QV^Q[QJQTQ\a
LQYLVLELOLW\
2SWLRQWZR R EMHFW
7KHVHULDOL]HGI
EXWLW·VPXFKHD LOHLVPXFKKDUGHUIRUKXPDQVWR
:ULWHDSODLQWH[WÀOH
&UHDWHDÀOHDQGZULWHWKUHHOLQHVRIWH[W UHVWRUHWKHWKUHVLHUDQGVDIHUIRU\RXUSURJUD UHDG
RQHSHUFKDUDFWHUVHSDUDWLQJWKHSLHFHV UHDGLQJLQWKHR HREMHFWVIURPVHULDOL]DWLRQWK PWR
RIVWDWHZLWKFRPPDV WRDWH[WILOH)EMHFW·VYDULDEOHYDOXHVWKDWZHU DQIURP
\RXFRXOGDFFLGH RUH[DPSOHLPDJLQHDOOWKHZD\HVDYHG
-TNJW_[_WZLL][\
RUGHU7KHW\S QWDOO\UHDGEDFNWKHYDOXHVLQW VLQZKLFK
<ZWTTJIZMPIVL[JQOI`
ZKLOHWKH(OIEHFHPLJKWEHFRPH´GXVWµLQVWHDGRKHZURQJ
5IOQKQIV[XMTT[QV^Q[QJQTQ\a RPHVDZHDSRQ I´(OIµ
\RXDUHKHUH
VDYLQJREMHFWV
?ZQ\QVOI[MZQITQbMLWJRMK\\WINQTM
(EREARETHESTEPSFORSERIALIZINGSAVING ANOBJECT$ONTBOTHER
MEMORIZINGALLTHISWELLGOINTOMOREDETAILLATERINTHISCHAPTER
,IWKHILOH´0EH\* DPHVHUµGRHVQDW·WLF DOO\

DWHGDXWRP
H[LVWLWZLOO FUH
0DNHD)LOH2XWSXW6WUHDP
)LOH2XWSXW6WUHDP¿OH6WUHDP QHZ)LOH2XWSXW6WUHDP³0\*DPHVHU´
0DNHD)
NQRZVKRZLOWH2R XWSXW6WUHDPREMHFW
FRQQHFWWR )LOH2XWSXW6
DQGFUHDWH W
DILOH UHDP

Licensed by
0DNHDQ2EMHFW2XWSXW6WUHDP
Eduard Simons
2EMHFW2XWSXW6WUHDPRV QHZ2EMHFW2XWSXW6WUHDP¿OH6WUHDP
REMHFWV
2EMHFW2XWSXW6W UHDPOHWV\RXZWRULDWHILOH,W
\FRQQHFW
EXWLWFDQ·WGLUGHFDWO¶KHOSHU·7KLVLVDFWXDOO\
IH
QHHGVWREH J·RQHVWUHDPWRDQRWKHU
104038 FDOOHG¶FKDLQLQ
:ULWHWKHREMHFW UDFWHU
DO L] HV W KHR EM HF WVUHIHUHQFHGE\7FKUKDHHDQG
RVZULWH2EMHFWFKDUDFWHU2QH VHUL 7ZRDQGFKD\* UDFWHU
2QHFKDUDFWHU W KH I LOH ´ 0 DPHVHUµ
RVZULWH2EMHFWFKDUDFWHU7ZR ZULWHVWKHPWR
RVZULWH2EMHFWFKDUDFWHU7KUHH
&ORVHWKH2EMHFW2XWSXW6WUHDP
RVFORVH
&ORVLQJWKHVWUH
XQGHUQHDWKVRWKDPHD)LWOH2
WKHWRSFORVHVWKHRQH
V
ILOHZLOOFORVHDXWRPDW XWSXW6WUHDPDQGWKH
LFDOO\
FKDSWHU
,I\IUW^M[QV[\ZMIU[NZWUWVMXTIKM\WIVW\PMZ
+WVVMK\QWV
[\ZMIU[ZMXZM[MV\
IKWVVMK\QWV
\WI[W]ZKMWZ
'HVWLQDWLRQ LM[\QVI\QWVNQTM
[WKSM\M\K_PQTM
KPIQV[\ZMIU[
KIV¼\KWVVMK\WV
\PMQZW_VIVLU][\
JMKPIQVML\WI
6RXUFH KWVVMK\QWV[\ZMIU
4HE*AVA)/!0)HASCONNECTIONSTREAMSTHATREPRESENTCONNECTIONSTODESTINATIONSAND
SOURCESSUCHASlLESORNETWORKSOCKETSANDCHAINSTREAMSTHATWORKONLYIFCHAINEDTO
OTHERSTREAMS
/FTENITTAKESATLEASTTWOSTREAMSHOOKEDTOGETHERTODOSOMETHINGUSEFULONETO
REPRESENTTHECONNECTIONANDANOTHERTOCALLMETHODSON7HYTWO"ECAUSECONNECTION
STREAMSAREUSUALLYTOOLOW LEVEL&ILE/UTPUT3TREAMACONNECTIONSTREAM FOREXAMPLE
HASMETHODSFORWRITINGBYTES"UTWEDONTWANTTOWRITEBYTES7EWANTTOWRITEOBJECTSSO
WENEEDAHIGHER LEVELCHAINSTREAM
/+THENWHYNOTHAVEJUSTASINGLESTREAMTHATDOESEXACTLYWHATYOUWANT/NETHATLETS
YOUWRITEOBJECTSBUTUNDERNEATHCONVERTSTHEMTOBYTES4HINKGOOD//%ACHCLASS
DOESONETHINGWELL&ILE/UTPUT3TREAMSWRITEBYTESTOAlLE/BJECT/UTPUT3TREAMSTURN
OBJECTSINTODATATHATCANBEWRITTENTOASTREAM3OWEMAKEA&ILE/UTPUT3TREAMTHATLETS
USWRITETOAlLEANDWEHOOKAN/BJECT/UTPUT3TREAMACHAINSTREAM ONTHEENDOFIT
7HENWECALLWRITE/BJECT ONTHE/BJECT/UTPUT3TREAMTHEOBJECTGETSPUMPEDINTOTHE
STREAMANDTHENMOVESTOTHE&ILE/UTPUT3TREAMWHEREITULTIMATELYGETSWRITTENASBYTES
TOAlLE
4HEABILITYTOMIXANDMATCHDIFFERENTCOMBINATIONSOFCONNECTIONANDCHAINSTREAMS
GHVWLQDWLRQ
GIVESYOUTREMENDOUSmEXIBILITY)FYOUWEREFORCEDTOUSEONLYASINGLESTREAMCLASSYOUD
BEATTHEMERCYOFTHE!0)DESIGNERSHOPINGTHEYDTHOUGHTOFEVERYTHINGYOUMIGHTEVER
WANTTODO"UTWITHCHAININGYOUCANPATCHTOGETHERYOUROWNCUSTOMCHAINS

REMHFWLVÁDWWHQHGVHULDOL]HG REMHFWLVZULWWHQDVE\WHVWR

LVZULWWHQWR LVFKDLQHGWR
2EMHFW 2EMHFW2XWSXW6WUHDP )LOH2XWSXW6WUHDP
)LOH
DFKDLQVWUHDP DFRQQHFWLRQVWUHDP
\RXDUHKHUH
VHULDOL]HGREMHFWV
?PI\ZMITTaPIXXMV[\WIVWJRMK\
_PMVQ\¼[[MZQITQbML'
2EMHFWRQWKHKHDS 2EMHFWVHULDOL]HG
2EMHFWVRQWKHKHDSKDYHVWDWH³WKH 6HULDOL]HGREMHFWVVDYHWKHYDOXHV
YDOXHRIWKHREMHFW·VLQVWDQFH RIWKHLQVWDQFHYDULDEOHVVRWKDW
YDULDEOHV7KHVHYDOXHVPDNHRQH DQLGHQWLFDOLQVWDQFHREMHFWFDQEH
LQVWDQFHRIDFODVVGLIIHUHQWIURP EURXJKWEDFNWROLIHRQWKHKHDS
DQRWKHULQVWDQFHRIWKHVDPHFODVV
H
LW K W Z R SULPLWLY 7KHLQVWDQFHYDULDEOHYD
2EMHFWFHZYDULDEOHV IRUZLGWKDQGKHLJKWDUOXHV
LQVWDQ VDYHGWRWKHILOHÍ H

7KHYDOXHVD UHVXFNHG RR VH
DORQJZLWKDOLWW PRUH Uµ

RXWDQGSXP SHGLQWR WKH-90QHHGVWOH LQIR
R UH VW RUH
WKHVWUH D P WKHREMHFWOLNHZ
IRRVHU FODVVW\SHLV KDWLWV
ZLGWK KHLJKW )LOH2XWSXW6WUHDPIV QHZ)LOH2XWSXW6WUHDP³IRRVHU´
2EMHFW2XWSXW6WUHDPRV QHZ2EMHFW2XWSXW6WUHDPIV
RVZULWH2EMHFWP\)RR
0DNHD)LOH2XWSXW6WUHDP DW
)RRP\)RR QHZ)RR
WRWKHILOHÍRRVHUµWKHQWK FRQQHFWV
P\)RRVHW:LGWK
2EMHFW2XWSXW6WUHDPWRLWFK DLQDQ
2EMHFW2XWSXW6WUHDPWRZUDQ GWHOOWKH
P\)RRVHW+HLJKW
LWHWKHREMHFW
FKDSWHU
*]\_PI\MÌK\Ta1;IVWJRMK\¼[[\I\M'
?PI\VMML[\WJM[I^ML'
.OWITSTARTSTOGETINTERESTING%ASYENOUGHTOSAVETHEPRIMITIVE
VALUESAND"UTWHATIFANOBJECTHASANINSTANCEVARIABLE
THATSANOBJECTREFERENCE7HATABOUTANOBJECTTHATHASlVE
INSTANCEVARIABLESTHATAREOBJECTREFERENCES7HATIFTHOSEOBJECT
INSTANCEVARIABLESTHEMSELVESHAVEINSTANCEVARIABLES
4HINKABOUTIT7HATPARTOFANOBJECTISPOTENTIALLYUNIQUE
)MAGINEWHATNEEDSTOBERESTOREDINORDERTOGETANOBJECTTHATS
IDENTICALTOTHEONETHATWASSAVED)TWILLHAVEADIFFERENTMEMORY
LOCATIONOFCOURSEBUTWEDONTCAREABOUTTHAT!LLWECAREABOUT
ISTHATOUTTHEREONTHEHEAPWELLGETANOBJECTTHATHASTHESAME
STATETHEOBJECTHADWHENITWASSAVED
DLQ EDUEHOO
EU%UDLQ%DUEHOO
7HATHASTOHAPPENFORTHE#AR 7KH&DUREMHFWKDVWZR
OBJECTTOBESAVEDINSUCHAWAY LQVWDQFHYDULDEOHVWKDW
THATITCANBERESTOREDBACKTOITS UHIHUHQFHWZRRWKHU
ORIGINALSTATE REMHFWV
(Q
W
4HINKOFWHATANDHOWYOU JLQH EMHF
R
MIGHTNEEDTOSAVETHE#AR
]f_
!NDWHATHAPPENSIFAN%NGINE laj]k
OBJECTHASAREFERENCETOA (QJLQH
W
7LUH> @
#ARBURATOR!NDWHATSINSIDETHE 7L
UH F
MH
4IRE;=ARRAYOBJECT > @DUUD\RE
& DU
REMHFW
:KDWGRHVLWWDNHWR
VDYHD&DUREMHFW"
\RXDUHKHUH
VHULDOL]HGREMHFWV
:KHQDQREMHFWLVVHULDOL]HGDOOWKHREMHFWV
LWUHIHUVWRIURPLQVWDQFHYDULDEOHVDUHDOVR
VHULDOL]HG$QGDOOWKHREMHFWVWKRVHREMHFWV Serialization saves the
UHIHUWRDUHVHULDOL]HG$QGDOOWKHREMHFWVWKRVH
REMHFWVUHIHUWRDUHVHULDOL]HGDQGWKHEHVW
entire object graph.
SDUWLVLWKDSSHQVDXWRPDWLFDOO\ All objects referenced
7KLV.HQQHOREMHFWKDVDUHIHUHQFHWRD'RJ>@DUUD\REMHFW7KH by instance variables,
'RJ>@KROGVUHIHUHQFHVWRWZR'RJREMHFWV(DFK'RJREMHFWKROGV starting with the
DUHIHUHQFHWRD6WULQJDQGD&ROODUREMHFW7KH6WULQJREMHFWV
KDYHDFROOHFWLRQRIFKDUDFWHUVDQGWKH&ROODUREMHFWVKDYHDQLQW
object being serialized.
:KHQ\RXVDYHWKH.HQQHODOORIWKLVLVVDYHG ´)LGRµ
6W

FW
ULQ EMH
J R
kar]
\g_k
LQW
fYe] &R
W
'RJ>@
OODU EMHF
R
6WULQJ [gd
.H HF W

QQHOREM &ROODU
R FW
LQJKDVW ' RJ

REMH
(YHU\WK LQRUGHUWR
EHVDYHG WKH.HQQHOEDFN ´6SLNHµ
UHVWRUH VWDWH
WRWKLV 6W
^gg^ ZYj^

FW
ULQ EMH
J R
'RJ 'RJ
kar]
W
'R F
J> @ MH
DUU D\RE LQW
fYe] &R
W
OODU EMHF
R
6WULQJ [gd
&ROODU
' RJ FW

REMH
FKDSWHU
1NaW]_IV\aW]ZKTI[[\WJM[MZQITQbIJTM
QUXTMUMV\;MZQITQbIJTM
4HE3ERIALIZABLEINTERFACEISKNOWNASAMARKERORTAGINTERFACE
BECAUSETHEINTERFACEDOESNTHAVEANYMETHODSTOIMPLEMENT)TS
SOLEPURPOSEISTOANNOUNCETHATTHECLASSIMPLEMENTINGITISWELL
SERIALIZABLE)NOTHERWORDSOBJECTSOFTHATTYPEARESAVEABLETHROUGH
THESERIALIZATIONMECHANISM)FANYSUPERCLASSOFACLASSISSERIALIZABLE
THESUBCLASSISAUTOMATICALLYSERIALIZABLEEVENIFTHESUBCLASSDOESNT
EXPLICITLYDECLAREIMPLEMENTS3ERIALIZABLE4HISISHOWINTERFACESALWAYS
WORK)FYOURSUPERCLASSh)3 !v3ERIALIZABLEYOUARETOO
H U H 0 867 LPSOHPHQW
RHVK LPH
REMHFW2XWSXW6WUHDPZULWH2EMHFWP\%R[ :KDWHYHUJ ULWZLOOIDLODWUXQW
OH R
6HULDOL]DE

KH M D Y D L R SDFNDJHVR
LVLQW
6HULDOL]DEOHKHLPSRUW XVD\
LPSRUWMDYDLR
\RXQHHGW HPHQWEXWZKHQ\R
1RPHWKRGVWRLPSO OHµLWVD\VWRWKH-90
SXEOLFFODVV%R[LPSOHPHQWV6HULDOL]DEOH^ ´LPSOHPHQWV6HULDOL]DE µ
REMHFWVRIWKLVW\SH
´LW·V2.WRVHULDOL]H

SULYDWHLQWZLGWK
WKHVHWZRYDOXHVZLOOEH
SULYDWHLQWKHLJKW VDYHG
SXEOLFYRLGVHW:LGWKLQWZ^
ZLGWK Z
`
SXEOLFYRLGVHW+HLJKWLQWK^
KHLJKW K
`
HUµ
R D I LO H Q DPHGÍRRVHD
&RQQHFWW ,ILWGRHVQ·WPDN
%R[P\%R[ QHZ%R[
P\%R[VHW:LGWK
KURZH[FHS WLRQV LILWH[LVWVPHGÍRRVHUµ
P\%R[VHW+HLJKW
,2RSHUDWLRQVFDQW QHZILOHQD
WU\^
)LOH2XWSXW6WUHDPIV QHZ)LOH2XWSXW6WUHDP³IRRVHU´
RVZULWH2EMHFWP\%R[ 0DNHDQ2EMH
RVFORVH FKDLQHGWRW FW2XWSXW6WUHDP
`FDWFK([FHSWLRQH[^ KHFRQQHFWLR
7 H QVWUHDP
H[SULQW6WDFN7UDFH OO LWWRZULWH
` W KH REMHFW
`
`
\RXDUHKHUH
VHULDOL]HGREMHFWV
6HULDOL]DWLRQLVDOORUQRWKLQJ
&DQ\RXLPDJLQHZKDWZRXOG
KDSSHQLIVRPHRIWKHREMHFW·V
VWDWHGLGQ·WVDYHFRUUHFWO\" (HHZZZ7KDW
FUHHSVPHRXWMXVWWKLQNLQJ
DERXWLW/LNHZKDWLID'RJFRPHV
EDFNZLWKQRZHLJKW2UQRHDUV2U
WKHFROODUFRPHVEDFNVL]HLQVWHDG
RI7KDWMXVWFDQ·WEHDOORZHG
(LWKHUWKHHQWLUH
REMHFWJUDSKLV
VHULDOL]HGFRUUHFWO\
RUVHULDOL]DWLRQIDLOV
<RXFDQ·WVHULDOL]H
D3RQGREMHFWLI
LPSRUWMDYDLR LWV'XFNLQVWDQFH
3RQGREMHFWVFDQEHVHULDOL]HG YDULDEOHUHIXVHVWR
SXEOLFFODVV3RQGLPSOHPHQWV6HULDOL]DEOH^
EHVHULDOL]HGE\
HLQVWDQFH
SULYDWH'XFNGXFN QHZ'XFN &ODVV3RQGKDXFVNRQ QRWLPSOHPHQWLQJ
YDULDEOHD' 6HULDOL]DEOH
3RQGP\3RQG QHZ3RQG
WU\^
)LOH2XWSXW6WUHDPIV QHZ)LOH2XWSXW6WUHDP³3RQGVHU´

:KHQ\RXVHULD
REMHFWLWV'XFOL]NHLQVP\3RQGD3RQG
RVZULWH2EMHFWP\3RQG
RVFORVH
DXWRPDWLFDOO\JHWVVHWDQFHYDULDEOH
ULDOL]HG
RQG
WKHPDLQLQFODVV3
`FDWFK([FHSWLRQH[^
H[SULQW6WDFN7UDFH
`
:KHQ\RXWU\HOSWR5UHJXQUHW
RZ+
)LOH(GLW:LQG
`
MDYD3RQ
G 'XFN
` H([FHSWLRQ
L R1R W6HULDOL]DEO MD YD
MDYD RQ G
<LNHV'XFNLVQRWVHULDOL]DEOH DW 3 RQ G PD LQ 3

,WGRHVQ·WLPSOHPHQW6HULDOL]D
SXEOLFFODVV'XFN^
GXFNFRGHKHUH
VRZKHQ\RXWU\WRVHULDOL]HDEOH
3RQGREMHFWLWIDLOVEHFDXVHWKH
`
3RQG·V'XFNLQVWDQFHYDULDEOH
FDQ·WEHVDYHG
FKDSWHU
,W·VKRSHOHVV
WKHQ",·PFRPSOHWHO\
VFUHZHGLIWKHLGLRWZKR
ZURWHWKHFODVVIRUP\LQVWDQFH
YDULDEOHIRUJRWWRPDNHLW
6HULDOL]DEOH"
0DUNDQLQVWDQFHYDULDEOHDVWUDQVLHQW
LILWFDQ·WRUVKRXOGQ·WEHVDYHG
)FYOUWANTANINSTANCEVARIABLETOBESKIPPEDBYTHE
SERIALIZATIONPROCESSMARKTHEVARIABLEWITHTHEWUDQVLHQW
KEYWORD
LPSRUWMDYDQHW

VD\V´GRQ·W FODVV&KDWLPSOHPHQWV6HULDOL]DEOH^
WUDQVLHQLVWYDULDEOHGXULQJµWUDQVLHQW6WULQJFXUUHQW,'
W K
VDYH DWLRQMXVWVNLS LW
VHULDOL] 6WULQJXVHU1DPH
XVHU1DPHYDULDEOH PRUHFRGH
ZLOOEHVDYHGDVSDUW
RIWKHREMHFW·VVW `
GXULQJVHULDOL]DWLRQDWH
)FYOUHAVEANINSTANCEVARIABLETHATCANTBESAVEDBECAUSE
ITISNTSERIALIZABLEYOUCANMARKTHATVARIABLEWITHTHE
TRANSIENTKEYWORDANDTHESERIALIZATIONPROCESSWILLSKIPRIGHT
OVERIT
3OWHYWOULDAVARIABLENOTBESERIALIZABLE)TCOULDBE
THATTHECLASSDESIGNERSIMPLYFORGOTTOMAKETHECLASS
IMPLEMENT3ERIALIZABLE/RITMIGHTBEBECAUSETHEOBJECT
RELIESONRUNTIME SPECIlCINFORMATIONTHATSIMPLYCANTBE
SAVED!LTHOUGHMOSTTHINGSINTHE*AVACLASSLIBRARIESARE
SERIALIZABLEYOUCANTSAVETHINGSLIKENETWORKCONNECTIONS
THREADSORlLEOBJECTS4HEYREALLDEPENDENTONAND
SPECIlCTO APARTICULARRUNTIME@EXPERIENCE)NOTHERWORDS
THEYREINSTANTIATEDINAWAYTHATSUNIQUETOAPARTICULARRUN
OFYOURPROGRAMONAPARTICULARPLATFORMINAPARTICULAR
*6-/NCETHEPROGRAMSHUTSDOWNTHERESNOWAYTOBRING
THOSETHINGSBACKTOLIFEINANYMEANINGFULWAYTHEYHAVETO
BECREATEDFROMSCRATCHEACHTIME
\RXDUHKHUH
VHULDOL]HGREMHFWV
there are no
Dumb Questions
Q: )FSERIALIZATIONISSOIMPORTANT A: 9ES)FTHECLASSITSELFIS
ASNULLREGARDLESSOFTHEVALUEITHAD
ATTHETIMEITWASSAVED4HATMEANS
WHYISNTITTHEDEFAULTFORALLCLASSES EXTENDABLEIENOTFINAL YOUCAN THEENTIREOBJECTGRAPHCONNECTEDTO
7HYDOESNTCLASS/BJECTIMPLEMENT MAKEASERIALIZABLESUBCLASSANDJUST THATPARTICULARINSTANCEVARIABLEWONT
3ERIALIZABLEANDTHENALLSUBCLASSES SUBSTITUTETHESUBCLASSEVERYWHERE BESAVED4HISCOULDBEBADOBVIOUSLY
WILLBEAUTOMATICALLY3ERIALIZABLE YOURCODEISEXPECTINGTHESUPERCLASS BECAUSEYOUPROBABLYNEEDANON NULL
TYPE2EMEMBERPOLYMORPHISM VALUEFORTHATVARIABLE
ALLOWSTHIS 7HICHBRINGSUPANOTHER
A: %VENTHOUGHMOSTCLASSESWILL
ANDSHOULDIMPLEMENT3ERIALIZABLE
INTERESTINGISSUEWHATDOESITMEANIF
THESUPERCLASSISNOTSERIALIZABLE
9OUHAVETWOOPTIONS
7HENTHEOBJECTISBROUGHTBACK
YOUALWAYSHAVEACHOICE!NDYOU REINITIALIZETHATNULLINSTANCEVARIABLE
MUSTMAKEACONSCIOUSDECISIONON
ACLASS BY CLASSBASISFOREACHCLASS
Q: 9OUBROUGHTITUPWHATDOESIT
BACKTOSOMEDEFAULTSTATE4HIS
WORKSIFYOURDESERIALIZEDOBJECTISNT
YOUDESIGNTO@ENABLESERIALIZATION MEANTOHAVEASERIALIZABLESUBCLASS DEPENDENTONAPARTICULARVALUEFOR
BYIMPLEMENTING3ERIALIZABLE OFANON SERIALIZABLESUPERCLASS THATTRANSIENTVARIABLE)NOTHERWORDS
&IRSTOFALLIFSERIALIZATIONWERETHE ITMIGHTBEIMPORTANTTHATTHE$OG
HAVEA#OLLARBUTPERHAPSALL#OLLAR
DEFAULTHOWWOULDYOUTURNITOFF
)NTERFACESINDICATEFUNCTIONALITYNOT A: &IRSTWEHAVETOLOOKATWHAT
HAPPENSWHENACLASSISDESERIALIZED
OBJECTSARETHESAMESOITDOESNT
MATTERIFYOUGIVETHERESURRECTED$OG
ALACKOFFUNCTIONALITYSOTHEMODEL
OFPOLYMORPHISMWOULDNTWORK WELLTALKABOUTTHATONTHENEXTFEW ABRANDNEW#OLLARNOBODYWILLKNOW
CORRECTLYIFYOUHADTOSAYhIMPLEMENTS PAGES )NANUTSHELLWHENANOBJECT THEDIFFERENCE
.ON3ERIALIZABLEvTOTELLTHEWORLDTHAT ISDESERIALIZEDANDITSSUPERCLASSISNOT )FTHEVALUEOFTHETRANSIENTVARIABLE
YOUCANNOTBESAVED SERIALIZABLETHESUPERCLASSCONSTRUCTOR DOESMATTERSAYIFTHECOLORANDDESIGN
WILLRUNJUSTASTHOUGHANEWOBJECTOF OFTHETRANSIENT#OLLARAREUNIQUEFOR
THATTYPEWEREBEINGCREATED)FTHERES EACH$OG THENYOUNEEDTOSAVETHE
Q: 7HYWOULD)EVERWRITEACLASS
NODECENTREASONFORACLASSTONOT
BESERIALIZABLEMAKINGASERIALIZABLE
KEYVALUESOFTHE#OLLARANDUSETHEM
WHENTHE$OGISBROUGHTBACKTO
THATWASNTSERIALIZABLE SUBCLASSMIGHTBEAGOODSOLUTION ESSENTIALLYRE CREATEABRANDNEW#OLLAR
THATSIDENTICALTOTHEORIGINAL
A: Q: 7HOA)JUSTREALIZED
4HEREAREVERYFEWREASONSBUT
YOUMIGHTFOREXAMPLEHAVEASECURITY
ISSUEWHEREYOUDONTWANTAPASSWORD
SOMETHINGBIGIFYOUMAKEA
VARIABLE@TRANSIENTTHISMEANSTHE
Q: 7HATHAPPENSIFTWOOBJECTSIN
THEOBJECTGRAPHARETHESAMEOBJECT
OBJECTSTORED/RYOUMIGHTHAVEAN VARIABLESVALUEISSKIPPEDOVER ,IKEIFYOUHAVETWODIFFERENT#AT
OBJECTTHATMAKESNOSENSETOSAVE DURINGSERIALIZATION4HENWHAT OBJECTSINTHE+ENNELBUTBOTH#ATS
BECAUSEITSKEYINSTANCEVARIABLESARE HAPPENSTOIT7ESOLVETHEPROBLEM HAVEAREFERENCETOTHESAME/WNER
THEMSELVESNOTSERIALIZABLESOTHERES OFHAVINGANON SERIALIZABLEINSTANCE OBJECT$OESTHE/WNERGETSAVED
NOUSEFULWAYFORYOUTOMAKEYOUR VARIABLEBYMAKINGTHEINSTANCE TWICE)MHOPINGNOT
CLASSSERIALIZABLE VARIABLETRANSIENTBUTDONTWE.%%$
THATVARIABLEWHENTHEOBJECTIS
BROUGHTBACKTOLIFE)NOTHERWORDS A: %XCELLENTQUESTION3ERIALIZATION
Q: )FACLASS)MUSINGISNT
ISNTTHEWHOLEPOINTOFSERIALIZATION
TOPRESERVEANOBJECTSSTATE
ISSMARTENOUGHTOKNOWWHENTWO
OBJECTSINTHEGRAPHARETHESAME)N
SERIALIZABLEBUTTHERESNOGOOD THATCASEONLYONEOFTHEOBJECTSIS
REASONEXCEPTTHATTHEDESIGNERJUST
FORGOTORWASSTUPID CAN)SUBCLASS
THE@BADCLASSANDMAKETHESUBCLASS
A: 9ESTHISISANISSUEBUT
FORTUNATELYTHERESASOLUTION)FYOU
SAVEDANDDURINGDESERIALIZATIONANY
REFERENCESTOTHATSINGLEOBJECTARE
RESTORED
SERIALIZABLE SERIALIZEANOBJECTATRANSIENTREFERENCE
INSTANCEVARIABLEWILLBEBROUGHTBACK
FKDSWHU
,M[MZQITQbI\QWV"ZM[\WZQVOIVWJRMK\ GHVHULDOL]HG
4HEWHOLEPOINTOFSERIALIZINGANOBJECTISSOTHATYOUCAN
VHULDOL]HG
RESTOREITBACKTOITSORIGINALSTATEATSOMELATERDATEINA
DIFFERENT@RUNOFTHE*6-WHICHMIGHTNOTEVENBETHESAME
*6-THATWASRUNNINGATTHETIMETHEOBJECTWASSERIALIZED
$ESERIALIZATIONISALOTLIKESERIALIZATIONINREVERSE
HVHUµGRHVQ·W
0DNHD)LOH,QSXW6WUHDP ,IWKHILOH´0HW\*DDPH[FHSWLRQ
H[LVW\RX·OOJ Q
)LOH,QSXW6WUHDP¿OH6WUHDP QHZ)LOH,QSXW6WUHDP³0\*DPHVHU´
0DNHD)
NQRZVKRZLOWH,RQSXW6WUHDPREMHFW7
FRQQHFWWRD K
QH[LVWLQJHI)LOLOH,QSXW6WUHDP
H
0DNHDQ2EMHFW,QSXW6WUHDP
2EMHFW,QSXW6WUHDPRV QHZ2EMHFW,QSXW6WUHDP¿OH6WUHDP
V
MHFW,Q SX W6 WU HD P OHWV\RXUHDGDREIMHLOHFW
2E \FRQQHFWWR
EXWLWFDQ·WGLUFHFKDWOLQHGWRDFRQQHFWLRQ
,WQHHGVWREHLVFDVHD)LOH,QSXW6WUHDP
VWUHDPLQWK
UHDGWKHREMHFWV
2EMHFWRQH RVUHDG2EMHFW (DFKWLPH\RXVD\UHDG2EMHFW\
REMHFWLQWKHVWUHDP6R RXJHWWKHQH[W
2EMHFWWZR RVUHDG2EMHFW
WKHVDPHRUGHULQZKLFKW\RX·OOUHDGWKHPEDFNLQ
2EMHFWWKUHH RVUHDG2EMHFW JHWDELJIDWH[FHSWLRQ KH\ZHUHZULWWHQ<RX·OO
REMHFWVWKDQ\RXZURWH LI\RXWU\WRUHDGPRUH
&DVWWKHREMHFWV
*DPH&KDUDFWHUHOI *DPH&KDUDFWHURQH RI
*DPH&KDUDFWHUWUROO *DPH&KDUDFWHUWZR 7KHUHWXUQYDLVOXH
W \SH2EMHFW
2EMH FW
*DPH&KDUDFWHUPDJLFLDQ *DPH&KDUDFWHUWKUHHUHDGWOLNHZLWK$UUD\/LVWVR
MXV EDFNWR
\RXKDYHWRFDNVWQRLW
Z LWUHDOO\LV
WKHW\SH\RX
&ORVHWKH2EMHFW,QSXW6WUHDP
RVFORVH
&ORVLQJWKHVWUH
XQGHUQHDWKVRWKDPHD)LWOH,WKHWRSFORVHVWKHRQHV
ILOHZLOOFORVHDXWRPDW QSXW6WUHDPDQGWKH
LFDOO\
\RXDUHKHUH
GHVHULDOL]LQJREMHFWV
?PI\PIXXMV[L]ZQVOLM[MZQITQbI\QWV'
7HENANOBJECTISDESERIALIZEDTHE*6-ATTEMPTSTOBRING
THEOBJECTBACKTOLIFEBYMAKINGANEWOBJECTONTHEHEAP
THATHASTHESAMESTATETHESERIALIZEDOBJECTHADATTHETIMEIT
WASSERIALIZED7ELLEXCEPTFORTHETRANSIENTVARIABLESWHICH WKH-90
COMEBACKEITHERNULLFOROBJECTREFERENCES ORASDEFAULT
WK U R Z D Q H[FHSWLRQLI
LOO
PRIMITIVEVALUES 7KLVVWHSZ RUORDGWKHFODVV
FDQ·WI LQ G
FODVVLVIRXQGDQGORDGHGVDYHG
Licensed by
REMHFWLVUHDGDVE\WHV LQVWDQFHYDULDEOHVUHDVVLJQHG

LVUHDGE\ LVFKDLQHGWR

)LOH,QSXW6WUHDP 2EMHFW,QSXW6WUHDP 2EMHFW
Eduard Simons
DFRQQHFWLRQVWUHDP DFKDLQVWUHDP
)LOH
104038
7KHREMHFWLVUHDGIURPWKHVWUHDP
7KH-90GHWHUPLQHVWKURXJKLQIRVWRUHGZLWK
WKHVHULDOL]HGREMHFWWKHREMHFW·VFODVVW\SH
7KH-90DWWHPSWVWRÀQGDQGORDGWKHRE
MHFW·VFODVV,IWKH-90FDQ·WÀQGDQGRUORDG
WKHFODVVWKH-90WKURZVDQH[FHSWLRQDQG
WKHGHVHULDOL]DWLRQIDLOV
$QHZREMHFWLVJLYHQVSDFHRQWKHKHDSEXW
WKHVHULDOL]HGREMHFW·VFRQVWUXFWRUGRHV
127UXQ2EYLRXVO\LIWKHFRQVWUXFWRUUDQLW
ZRXOGUHVWRUHWKHVWDWHRIWKHREMHFWEDFN
WRLWVRULJLQDO¶QHZ·VWDWHDQGWKDW·VQRWZKDW
ZHZDQW:HZDQWWKHREMHFWWREHUHVWRUHG
WRWKHVWDWHLWKDGZKHQLWZDVVHULDOL]HGQRW
ZKHQLWZDVÀUVWFUHDWHG
FKDSWHU
,IWKHREMHFWKDVDQRQVHULDOL]DEOHFODVV
VRPHZKHUHXSLWVLQKHULWDQFHWUHHWKH
FRQVWUXFWRUIRUWKDWQRQVHULDOL]DEOHFODVV
ZLOOUXQDORQJZLWKDQ\FRQVWUXFWRUVDERYH
WKDWHYHQLIWKH\·UHVHULDOL]DEOH2QFHWKH
FRQVWUXFWRUFKDLQLQJEHJLQV\RXFDQ·WVWRSLW
ZKLFKPHDQVDOOVXSHUFODVVHVEHJLQQLQJZLWK
WKHÀUVWQRQVHULDOL]DEOHRQHZLOOUHLQLWLDOL]H
WKHLUVWDWH
7KHREMHFW·VLQVWDQFHYDULDEOHVDUHJLYHQWKH
YDOXHVIURPWKHVHULDOL]HGVWDWH7UDQVLHQW
YDULDEOHVDUHJLYHQDYDOXHRIQXOOIRUREMHFW
UHIHUHQFHVDQGGHIDXOWVIDOVHHWFIRU
SULPLWLYHV
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: 7HYDOESNTTHECLASSGETSAVEDASPARTOFTHEOB
ARGUMENTANDIFTHE*6-RECEIVINGTHECALLDOESNTHAVE
THECLASSITCANUSETHE52,TOFETCHTHECLASSFROMTHE
JECT4HATWAYYOUDONTHAVETHEPROBLEMWITHWHETHER NETWORKANDLOADITALLAUTOMATICALLY7ELLTALKABOUT2-)
THECLASSCANBEFOUND INCHAPTER
A: 3URETHEYCOULDHAVEMADESERIALIZATIONWORKTHAT
Q: 7HATABOUTSTATICVARIABLES!RETHEYSERIALIZED
WAY"UTWHATATREMENDOUSWASTEANDOVERHEAD!ND
WHILEITMIGHTNOTBESUCHAHARDSHIPWHENYOUREUSING
SERIALIZATIONTOWRITEOBJECTSTOAFILEONALOCALHARDDRIVE A: .OPE2EMEMBERSTATICMEANShONEPERCLASSvNOT
SERIALIZATIONISALSOUSEDTOSENDOBJECTSOVERANETWORK hONEPEROBJECTv3TATICVARIABLESARENOTSAVEDANDWHENAN
CONNECTION)FACLASSWASBUNDLEDWITHEACHSERIALIZED OBJECTISDESERIALIZEDITWILLHAVEWHATEVERSTATICVARIABLE
SHIPPABLE OBJECTBANDWIDTHWOULDBECOMEAMUCHLARGER ITSCLASSCURRENTLYHAS4HEMORALDONTMAKESERIALIZABLEOB
PROBLEMTHANITALREADYIS JECTSDEPENDENTONADYNAMICALLY CHANGINGSTATICVARIABLE
)TMIGHTNOTBETHESAMEWHENTHEOBJECTCOMESBACK
&OROBJECTSSERIALIZEDTOSHIPOVERANETWORKTHOUGHTHERE
ACTUALLYISAMECHANISMWHERETHESERIALIZEDOBJECTCANBE
@STAMPEDWITHA52,FORWHEREITSCLASSCANBEFOUND4HIS
ISUSEDIN*AVAS2EMOTE-ETHOD)NVOCATION2-) SOTHAT
YOUCANSENDASERIALIZEDOBJECTASPARTOFSAYAMETHOD
\RXDUHKHUH
VHULDOL]DWLRQH[DPSOH
;I^QVOIVLZM[\WZQVO\PMOIUMKPIZIK\MZ[
LPSRUWMDYDLR
SXEOLFFODVV*DPH6DYHU7HVW^ 0DNHVRPHFKDUDFWHUV
*DPH&KDUDFWHURQH QHZ*DPH&KDUDFWHU³(OI´QHZ6WULQJ>@^³ERZ´³VZRUG´³GXVW´`
*DPH&KDUDFWHUWZR QHZ*DPH&KDUDFWHU³7UROO´QHZ6WULQJ>@^³EDUHKDQGV´³ELJD[´`
*DPH&KDUDFWHUWKUHH QHZ*DPH&KDUDFWHU³0DJLFLDQ´QHZ6WULQJ>@^³VSHOOV´³LQYLVLELOLW\´`
LPDJLQHFRGHWKDWGRHVWKLQJVZLWKWKHFKDUDFWHUVWKDWPLJKWFKDQJHWKHLUVWDWHYDOXHV

WU\^
2EMHFW2XWSXW6WUHDPRV QHZ2EMHFW2XWSXW6WUHDPQHZ)LOH2XWSXW6WUHDP³*DPHVHU´
RVZULWH2EMHFWRQH
RVZULWH2EMHFWWZR
RVZULWH2EMHFWWKUHH
RVFORVH
`FDWFK,2([FHSWLRQH[^
H[SULQW6WDFN7UDFH
`
HFDQ·W
RQH QXOO :HVHWWKHPWRQXOOVRZKHKHDS
WZR QXOO DFFHVVWKHREMHFWVRQW
WKUHH QXOO
1RZUHDGWKHPE
DFNLQIURPWKHILOH

WU\^
2EMHFW,QSXW6WUHDPLV QHZ2EMHFW,QSXW6WUHDPQHZ)LOH,QSXW6WUHDP³*DPHVHU´
*DPH&KDUDFWHURQH5HVWRUH *DPH&KDUDFWHULVUHDG2EMHFW
*DPH&KDUDFWHUWZR5HVWRUH *DPH&KDUDFWHULVUHDG2EMHFW
*DPH&KDUDFWHUWKUHH5HVWRUH *DPH&KDUDFWHULVUHDG2EMHFW
WZRUNHG
6\VWHPRXWSULQWOQ³2QH¶VW\SH³RQH5HVWRUHJHW7\SH &KHFNWRVHHLIL
6\VWHPRXWSULQWOQ³7ZR¶VW\SH³WZR5HVWRUHJHW7\SH
6\VWHPRXWSULQWOQ³7KUHH¶VW\SH³WKUHH5HVWRUHJHW7\SH
`FDWFK([FHSWLRQH[^ SRZHU
H[SULQW6WDFN7UDFH W\SH(OI
` ZHDSRQVERZ
)LOH(GLW:LQGRZ+HOS5HVXVFLWDWH
` VZRUGGXVW
MDYD*DPH6DYHU SRZHU
W\SH7UROO R EMHFW
(OI ZHDSRQVEDUH
7UROO KDQGVELJD[
SRZHU
R EMHFW W\SH0DJLFLDQ
0DJLFLDQ ZHDSRQVVSHOOV
LQYLVLELOLW\
R EMHFW
FKDSWHU
<PM/IUM+PIZIK\MZKTI[[
LPSRUWMDYDLR
SXEOLFFODVV*DPH&KDUDFWHULPSOHPHQWV6HULDOL]DEOH^
LQWSRZHU
RUWHVWLQJ
6WULQJW\SH
6WULQJ>@ZHDSRQV 7KLVLVDEDVLFFODVVMXVWRQI·WKDYHDQ
Z HG
6HULDOL]DWLRQDQG OOHDYHWKDWWR
SXEOLF*DPH&KDUDFWHULQWS6WULQJW6WULQJ>@Z^ DFWXDOJDPHEXWZH·O
SRZHU S \RXWRH[SHULPHQW
W\SH W
ZHDSRQV Z
`
SXEOLFLQWJHW3RZHU^
UHWXUQSRZHU
`
SXEOLF6WULQJJHW7\SH^
UHWXUQW\SH
`
SXEOLF6WULQJJHW:HDSRQV^
6WULQJZHDSRQ/LVW ³´
IRULQWL LZHDSRQVOHQJWKL^
ZHDSRQ/LVW ZHDSRQV>L@³³
`
UHWXUQZHDSRQ/LVW
`
`
\RXDUHKHUH
VDYLQJREMHFWV
Object Serialization
:MDD=LHGAFLK
<RXFDQVDYHDQREMHFW·VVWDWHE\VHULDOL]LQJWKHREMHFW
7RVHULDOL]HDQREMHFW\RXQHHGDQ2EMHFW2XWSXW6WUHDPIURPWKH
MDYDLRSDFNDJH
6WUHDPVDUHHLWKHUFRQQHFWLRQVWUHDPVRUFKDLQVWUHDPV
&RQQHFWLRQVWUHDPVFDQUHSUHVHQWDFRQQHFWLRQWRDVRXUFHRU
GHVWLQDWLRQW\SLFDOO\DILOHQHWZRUNVRFNHWFRQQHFWLRQRUWKH
FRQVROH
&KDLQVWUHDPVFDQQRWFRQQHFWWRDVRXUFHRUGHVWLQDWLRQDQGPXVW
EHFKDLQHGWRDFRQQHFWLRQRURWKHUVWUHDP
7RVHULDOL]HDQREMHFWWRDILOHPDNHD)LOH2XSXW6WUHDPDQGFKDLQLW
LQWRDQ2EMHFW2XWSXW6WUHDP
7RVHULDOL]HDQREMHFWFDOOZULWH2EMHFWWKH2EMHFWRQWKH
2EMHFW2XWSXW6WUHDP<RXGRQRWQHHGWRFDOOPHWKRGVRQWKH
)LOH2XWSXW6WUHDP
7REHVHULDOL]HGDQREMHFWPXVWLPSOHPHQWWKH6HULDOL]DEOHLQWHUIDFH
,IDVXSHUFODVVRIWKHFODVVLPSOHPHQWV6HULDOL]DEOHWKHVXEFODVVZLOO
DXWRPDWLFDOO\EHVHULDOL]DEOHHYHQLILWGRHVQRWVSHFLILFDOO\GHFODUH
LPSOHPHQWV6HULDOL]DEOH
:KHQDQREMHFWLVVHULDOL]HGLWVHQWLUHREMHFWJUDSKLVVHULDOL]HG7KDW
PHDQVDQ\REMHFWVUHIHUHQFHGE\WKHVHULDOL]HGREMHFW·VLQVWDQFH
YDULDEOHVDUHVHULDOL]HGDQGDQ\REMHFWVUHIHUHQFHGE\WKRVH
REMHFWVDQGVRRQ
,IDQ\REMHFWLQWKHJUDSKLVQRWVHULDOL]DEOHDQH[FHSWLRQZLOOEH
WKURZQDWUXQWLPHXQOHVVWKHLQVWDQFHYDULDEOHUHIHUULQJWRWKHREMHFW
LVVNLSSHG
0DUNDQLQVWDQFHYDULDEOHZLWKWKHWUDQVLHQWNH\ZRUGLI\RXZDQW
VHULDOL]DWLRQWRVNLSWKDWYDULDEOH7KHYDULDEOHZLOOEHUHVWRUHGDVQXOO
IRUREMHFWUHIHUHQFHVRUGHIDXOWYDOXHVIRUSULPLWLYHV
'XULQJGHVHULDOL]DWLRQWKHFODVVRIDOOREMHFWVLQWKHJUDSKPXVWEH
DYDLODEOHWRWKH-90
<RXUHDGREMHFWVLQXVLQJUHDG2EMHFWLQWKHRUGHULQZKLFKWKH\
ZHUHRULJLQDOO\ZULWWHQ
7KHUHWXUQW\SHRIUHDG2EMHFWLVW\SH2EMHFWVRGHVHULDOL]HG
REMHFWVPXVWEHFDVWWRWKHLUUHDOW\SH
6WDWLFYDULDEOHVDUHQRWVHULDOL]HG,WGRHVQ·WPDNHVHQVHWRVDYH
DVWDWLFYDULDEOHYDOXHDVSDUWRIDVSHFLILFREMHFW·VVWDWHVLQFHDOO
REMHFWVRIWKDWW\SHVKDUHRQO\DVLQJOHYDOXH³WKHRQHLQWKHFODVV
FKDSWHU
?ZQ\QVOI;\ZQVO\WI<M`\.QTM
3AVINGOBJECTSTHROUGHSERIALIZATIONISTHEE ASIESTWAYTOSAVEAND
RESTOREDATABETWEENRUNNINGSOFA*AVAPROGRAM"UTSOMETIMESYOU :KDWWKHJDPHFKDUDFWHUGDWD
NEEDTOSAVEDATATOAPLAINOLDTEXTlLE)MAGINEYOUR*AVAPROGRAM PLJKWORRNOLNHLI\RXZURWHLW
HASTOWRITEDATATOASIMPLETEXTlLETHATSOMEOTHERPERHAPSNON RXWDVDKXPDQUHDGDEOHWH[WILOH
*AVA PROGRAMNEEDSTOREAD9OUMIGHTFOREXAMPLEHAVEASERVLET
*AVACODERUNNINGWITHINYOURWEBSERVER THATTAKESFORMDATATHE
-TNJW_[_WZLL][\
USERTYPEDINTOABROWSERANDWRITESITTOATEXTlLETHATSOMEBODYELSE
LOADSINTOASPREADSHEETFORANALYSIS <ZWTTJIZMPIVL[JQOI`
5IOQKQIV[XMTT[QV^Q[QJQTQ\a
7RITINGTEXTDATAA3TRINGACTUALLY ISSIMILARTOWRITINGANOBJECT
EXCEPTYOUWRITEA3TRINGINSTEADOFANOBJECTANDYOUUSEA
&ILE7RITERINSTEADOFA&ILE/UTPUT3TREAMANDYOUDONTCHAINITTOAN
/BJECT/UTPUT3TREAM
7RZULWHDVHULDOL]HGREMHFW
REMHFW2XWSXW6WUHDPZULWH2EMHFWVRPH2EMHFW
7RZULWHD6WULQJ
¿OH:ULWHUZULWH³0\¿UVW6WULQJWRVDYH´
HU
RU)LOH:ULW
RSDFNDJHI
LPSRUWMDYDLR :HQH HGWKHMDYDL
W
FODVV:ULWH$)LOH^
H ´ ) RR W[ WµGRHVWQHRLW
,IWKHILOLOH:ULWHUZLOOFUH D
H[LVW)
WU\^
)LOH:ULWHUZULWHU QHZ)LOH:ULWHU³)RRW[W´

,2VWXIFIDWFK
$//WKHHLQ DWU\ZULWHUZULWH³KHOORIRR´
7KHZULWHPHWKRGWDNHV
PXVWE KLQJFDQWKURZDQ D6WULQJ
(YHU\W SWLRQ ZULWHUFORVH &ORVHLW
,2([FH ZKHQ\RX·UHGRQH
H[SULQW6WDFN7UDFH
`
`
`
\RXDUHKHUH
ZULWLQJDWH[WILOH
<M`\.QTM-ÌUXTM"M.TI[PKIZL[ ROGID
IURQW LQGH[IVODKVLRQHG[
2EMEMBERTHOSEmASHCARDSYOUUSEDINSCHOOL7HEREYOU KFDUGV
HADAQUESTIONONONESIDEANDTHEANSWERONTHEBACK HILUVW
4HEYARENTMUCHHELPWHENYOURETRYINGTOUNDERSTAND :KDW·VWKRXQWU\GXH
SOMETHINGBUTNOTHINGBEATS@EMFORRAWDRILL AND PRACTICE IRUHLJQF 'HWURLW EDFN
ANDROTEMEMORIZATION7HENYOUHAVETOBURNINAFACT!ND VRXWKRI
THEYREALSOGREATFORTRIVIAGAMES
0LFKLJDQ" &DQDGD2QWDULR
7EREGOINGTOMAKEANELECTRONICVERSIONTHATHASTHREE
CLASSES
1UIZ#ARD"UILDERASIMPLEAUTHORINGTOOLFORCREATINGAND
SAVINGASETOFE &LASHCARDS
1UIZ#ARD0LAYERAPLAYBACKENGINETHATCANLOADA
mASHCARDSETANDPLAYITFORTHEUSER 4XL]&DUG
1UIZ#ARDASIMPLECLASSREPRESENTINGCARDDATA7ELL 4XL]&DUGTD
WALKTHROUGHTHECODEFORTHEBUILDERANDTHEPLAYERAND
HAVEYOUMAKETHE1UIZ#ARDCLASSYOURSELFUSINGTHIS TXHVWLRQ
DQVZHU
JHW4XHVWLRQ
JHW$QVZHU
4XL]&DUG%XLOGHU 4XL]&DUG3OD\HU
+DVD)LOHPHQXZLWKD´6DYHµRSWLRQIRUVDYLQJ +DVD)LOHPHQXZLWKD´/RDGµRSWLRQIRUORDGLQJD
WKHFXUUHQWVHWRIFDUGVWRDWH[WÀOH VHWRIFDUGVIURPDWH[WÀOH
FKDSWHU
9]Qb+IZL*]QTLMZKWLMW]\TQVM
PUBLICCLASS1UIZ#ARD"UILDER[

KH*8,LQFOXGLQJ
%XLOGVDQGGLVSODLVW\VHUWLQJHYHQWOLVWHQHUV
PUBLICVOIDGO [
BUILDANDDISPLAYGUI PDNLQJDQGUHJ
]
,QQHUFODVV
WRQ
KLWV¶1H[W&DUGF·EDUXWGLQ
PRIVATECLASS.EXT#ARD,ISTENERIMPLEMENTS!CTION,ISTENER[
7 ULJ JHUH G ZKHQ X VHU DW
PUBLICVOIDACTION0ERFORMED!CTION%VENTEV [
PHDQVWKHXVHUZ DQWVWRVWRUHWK
QHZFDUG
ADDTHECURRENTCARDTOTHELISTANDCLEARTHETEXTAREAS
WKHOLVWDQGVW WD
DU
]
]
,QQHUFODVV
PRIVATECLASS3AVE-ENU,ISTENERIMPLEMENTS!CTION,ISTENER[
7ULJJHUHGZKHQXVHFK
BRINGUPAlLEDIALOGBOX )LOHPHQXPHDQV RRVHV¶6DYH·IURPWKH
LETTHEUSERNAMEANDSAVETHESET WKHFDUGVLQWKHWFXKHUUXVHUZDQWVWRVDYHDOO
4XDQWXP0HFKD V6 HQWOLVWDVD¶VHW·OLNH
]
-DYD5XOHVHWFQLF

HW+ROO\ZRRG7ULYLD
]
,QQHUFODVV
PRIVATECLASS.EW-ENU,ISTENERIMPLEMENTS!CTION,ISTENER[
WKH)LOH
PUBLICVOIDACTION0ERFORMED!CTION%VENTEV [ E \ FK R R VL QJ¶1HZ·IURRVPWDUWD
7ULJJHUHG QVWKHXVHUZDQWVWXWWKHFDUG
CLEAROUTTHECARDLISTANDCLEAROUTTHETEXTAREAS PHQXPHD VHWVRZHFOHDUR
] EUDQGQHZKHWH[WDUHDV
] OLVWDQGW

PRIVATEVOIDSAVE&ILE&ILElLE [
ITERATETHROUGHTHELISTOFCARDSANDWRITEEACHONEOUTTOATEXTlLE
INAPARSEABLEWAYINOTHERWORDSWITHCLEARSEPARATIONSBETWEENPARTS
]
] HU
&DOOHGE\WKH6DYH0HQX/LVWHQ
GRHVWKHDFWXDOILOHZULWLQJ
\RXDUHKHUH
4XL]&DUG%XLOGHUFRGH
LPSRUWMDYDXWLO
LPSRUWMDYDDZWHYHQW
LPSRUWMDYD[VZLQJ
LPSRUWMDYDDZW
LPSRUWMDYDLR
SXEOLFFODVV4XL]&DUG%XLOGHU^
SULYDWH-7H[W$UHDTXHVWLRQ
SULYDWH-7H[W$UHDDQVZHU
SULYDWH$UUD\/LVW4XL]&DUG!FDUG/LVW
SULYDWH-)UDPHIUDPH

4XL]&DUG%XLOGHUEXLOGHU QHZ4XL]&DUG%XLOGHU
EXLOGHUJR
`

SXEOLFYRLGJR^
EXLOGJXL 7KLVLVDOO*8
VSHFLDODOWKRX K ,FRGH
IUDPH QHZ-)UDPH³4XL]&DUG%XLOGHU´
WRORRND JK\RXPHLJUHKW1ZRWKLQJ
DQG0HQXW,WWHPKH0HQX%DU0HQDXQW
-3DQHOPDLQ3DQHO QHZ-3DQHO
)RQWELJ)RQW QHZ)RQW³VDQVHULI´)RQW%2/'
TXHVWLRQ QHZ-7H[W$UHD VFRGH
TXHVWLRQVHW/LQH:UDSWUXH
TXHVWLRQVHW:UDS6W\OH:RUGWUXH
TXHVWLRQVHW)RQWELJ)RQW

-6FUROO3DQHT6FUROOHU QHZ-6FUROO3DQHTXHVWLRQ
T6FUROOHUVHW9HUWLFDO6FUROO%DU3ROLF\6FUROO3DQH&RQVWDQWV9(57,&$/B6&52//%$5B$/:$<6
T6FUROOHUVHW+RUL]RQWDO6FUROO%DU3ROLF\6FUROO3DQH&RQVWDQWV+25,=217$/B6&52//%$5B1(9(5
DQVZHU QHZ-7H[W$UHD
DQVZHUVHW/LQH:UDSWUXH
DQVZHUVHW:UDS6W\OH:RUGWUXH
DQVZHUVHW)RQWELJ)RQW

-6FUROO3DQHD6FUROOHU QHZ-6FUROO3DQHDQVZHU
D6FUROOHUVHW9HUWLFDO6FUROO%DU3ROLF\6FUROO3DQH&RQVWDQWV9(57,&$/B6&52//%$5B$/:$<6
D6FUROOHUVHW+RUL]RQWDO6FUROO%DU3ROLF\6FUROO3DQH&RQVWDQWV+25,=217$/B6&52//%$5B1(9(5

-%XWWRQQH[W%XWWRQ QHZ-%XWWRQ³1H[W&DUG´

FDUG/LVW QHZ$UUD\/LVW4XL]&DUG!
-/DEHOT/DEHO QHZ-/DEHO³4XHVWLRQ´
-/DEHOD/DEHO QHZ-/DEHO³$QVZHU´

PDLQ3DQHODGGT/DEHO
PDLQ3DQHODGGT6FUROOHU
PDLQ3DQHODGGD/DEHO
PDLQ3DQHODGGD6FUROOHU
PDLQ3DQHODGGQH[W%XWWRQ
QH[W%XWWRQDGG$FWLRQ/LVWHQHUQHZ1H[W&DUG/LVWHQHU
-0HQX%DUPHQX%DU QHZ-0HQX%DU
-0HQX¿OH0HQX QHZ-0HQX³)LOH´
-0HQX,WHPQHZ0HQX,WHP QHZ-0HQX,WHP³1HZ´
FKDSWHU

-0HQX,WHPVDYH0HQX,WHP QHZ-0HQX,WHP³6DYH´ :HPDNHDPHQ
QHZ0HQX,WHPDGG$FWLRQ/LVWHQHUQHZ1HZ0HQX/LVWHQHU
P HQXWKHQSXW¶XEDUPDNHD)LOH
VDYH0HQX,WHPDGG$FWLRQ/LVWHQHUQHZ6DYH0HQX/LVWHQHU LW HPVLQWRWKH QHZ·DQG¶VDYH·PHQX
¿OH0HQXDGGQHZ0HQX,WHP PHQXWRWKH )LOHPHQX:H
DG
¿OH0HQXDGGVDYH0HQX,WHP IUDPHWRXVHPHQXEDUWKHQWHOOGWWKHKH
PHQX%DUDGG¿OH0HQX LWHPVFDQILUHW K LV P HQXE
IUDPHVHW-0HQX%DUPHQX%DU DQ$FWLRQ(DUYHQW0HQX
IUDPHJHW&RQWHQW3DQHDGG%RUGHU/D\RXW&(17(5PDLQ3DQHO
IUDPHVHW6L]H
IUDPHVHW9LVLEOHWUXH
`
SXEOLFFODVV1H[W&DUG/LVWHQHULPSOHPHQWV$FWLRQ/LVWHQHU^

4XL]&DUGFDUG QHZ4XL]&DUGTXHVWLRQJHW7H[WDQVZHUJHW7H[W
FDUG/LVWDGGFDUG
FOHDU&DUG
`
`
SXEOLFFODVV6DYH0HQX/LVWHQHULPSOHPHQWV$FWLRQ/LVWHQHU^
4XL]&DUGFDUG QHZ4XL]&DUGTXHVWLRQJHW7H[WDQVZHUJHW7H[W
KLV
ZDLWVRQW
FDUG/LVWDGGFDUG
J ER [ D QG K H
-)LOH&KRRVHU¿OH6DYH QHZ-)LOH&KRRVHU
% U LQ J VX S DILOHGLDFORKRRVHV¶6DYH·IURDPWWLR Q D QG
¿OH6DYHVKRZ6DYH'LDORJIUDPH
W LO WK U
HXVH LOHGLDORJQDYLJ \WKH
Q H X Q
VDYH)LOH¿OH6DYHJHW6HOHFWHG)LOH OL $OOWKHI RU\RXE
` GLDORJER[DILOHHWFLVGRQHKILVHDV\
` VHOHFWLQJ HDOO\LVW U
SXEOLFFODVV1HZ0HQX/LVWHQHULPSOHPHQWV$FWLRQ/LVWHQHU LO
-)^ H&KRRVHU ,W
FDUG/LVWFOHDU
FOHDU&DUG
`
J
OILOHZULWDLQQGOHU
`

W K H D F W X D
SULYDWHYRLGFOHDU&DUG^ WKDWGRHV QHU·VHYHQWK LQJ
TXHVWLRQVHW7H[W³´ 7KHPHWK\RWG KH6DYH0HQX/LVRWEHMHFWWKHXVHULVVDY
DQVZHUVHW7H[W³´ H G E LO H ·
FDOO XPHQWLVWKH¶) RQWKHQH[WS D J H
TXHVWLRQUHTXHVW)RFXV
` 7KHDUJRNDWWKH)LOHFODVV
·OOOR :H
SULYDWHYRLGVDYH)LOH)LOH¿OH^
WU\^
%XIIHUHG:ULWHUZULWHU QHZ%XIIHUHG:ULWHUQHZ)LOH:ULWHU¿OH

:HFKDLQD%XI
)LOH:ULWHUWRPDIHNHUHZG:ULWHURQWRDQHZ
IRU4XL]&DUGFDUGFDUG/LVW^
ZULWHUZULWHFDUGJHW4XHVWLRQ³´
ZULWHUZULWHFDUGJHW$QVZHU³?Q´ :H·OOWDONDERXWWKDWULWLQJPRUHHIILFLHQW
` LQDIHZSDJHV
ZULWHUFORVH
:DONWKURXJKW
6\VWHPRXWSULQWOQ³FRXOGQ¶WZULWHWKHFDUG/LVWRXW´ FDUGVDQGZULWHKHWK$HPUUD\/LVWRI
H[SULQW6WDFN7UDFH SHUOLQHZLWKW RXWRQHFDUG
` VZHUVHSDUDWHGKHE\TDXH´VWLRQDQGDQ
` DGGDQHZOLQHFKDUDFW µDQGWKHQ
` HU´?Qµ

\RXDUHKHUH

ZULWLQJILOHV
<PMRIÎQW.QTMKTI[[
4HEJAVAIO&ILECLASSREPRESENTSAlLEONDISKBUTDOESNT
ACTUALLYREPRESENTTHECONTENTSOFTHElLE7HAT4HINKOF
A&ILEOBJECTASSOMETHINGMORELIKEAPATHNAMEOFAlLE
OREVENADIRECTORY RATHERTHAN4HE!CTUAL&ILE)TSELF
4HE&ILECLASSDOESNOTFOREXAMPLEHAVEMETHODSFOR
READINGANDWRITING/NE6%29USEFULTHINGABOUTA&ILE
OBJECTISTHATITOFFERSAMUCHSAFERWAYTOREPRESENTA $)LOHREMHFWUHSUHVHQWVWKHQDPH
lLETHANJUSTUSINGA3TRINGlLENAME&OREXAMPLEMOST DQGSDWKRIDÀOHRUGLUHFWRU\RQ
CLASSESTHATTAKEA3TRINGlLENAMEINTHEIRCONSTRUCTOR GLVNIRUH[DPSOH
LIKE&ILE7RITEROR&ILE)NPUT3TREAM CANTAKEA&ILE
8VHUV.DWK\'DWD*DPH)LOHW[W
OBJECTINSTEAD9OUCANCONSTRUCTA&ILEOBJECTVERIFY
Licensed by
THATYOUVEGOTAVALIDPATHETCANDTHENGIVETHAT&ILE %XWLWGRHV127UHSUHVHQWRUJLYH
OBJECTTOTHE&ILE7RITEROR&ILE)NPUT3TREAM \RXDFFHVVWRWKHGDWDLQWKHÀOH
6RPHWKLQJV\RXFDQGRZLWKD)LOHREMHFW
Eduard Simons
7WKH
$QDGGUHVVLV12XDO
0DNHD)LOHREMHFWUHSUHVHQWLQJDQ D FW
VDPHDVWKH EMHFWLV
H[LVWLQJÀOH KRXVH$)LOHRGGUHVV
)LOHI QHZ)LOH³0\&RGHW[W´ OLNHDVWUHHWD HQDPH
LWUHSUHVHQWVWK DSDU
0DNHDQHZGLUHFWRU\ 104038
)LOHGLU QHZ)LOH³&KDSWHU´
DQGORFDWLRQRILWLVQ·W
WLFXODUILOHEXW
WKHILOHLWVHOI
GLUPNGLU
KH
UHSUHVHQWVW
$)LOHREMHFW
H)LOHW[Wµ
/LVWWKHFRQWHQWVRIDGLUHFWRU\
ILOHQDPH´*DP *DPH)LOHW[W
LIGLULV'LUHFWRU\^ -TNJW_[_WZLL][\
6WULQJ>@GLU&RQWHQWV GLUOLVW
IRULQWL LGLU&RQWHQWVOHQJWKL^ <ZWTTJIZMPIVL[JQOI`
6\VWHPRXWSULQWOQGLU&RQWHQWV>L@ 5IOQKQIV[XMTT[QV^Q[QJQTQ\a
`
`
GRHV127
$)LOHREMHFW JLYH\RX
UHSUHVHQW HVRUV WRWKH
*HWWKHDEVROXWHSDWKRIDÀOHRUGLUHFWRU\ GLUHFWDFFHWKHILOH
6\VWHPRXWSULQWOQGLUJHW$EVROXWH3DWK GDWDLQVLG
'HOHWHDÀOHRUGLUHFWRU\UHWXUQVWUXHLI
VXFFHVVIXO
ERROHDQLV'HOHWHG IGHOHWH
FKDSWHU
7KHEHDXW\RIEXIIHUV
,IWKHUHZHUHQREXIIHUVLWZRXOGEHOLNH
VKRSSLQJZLWKRXWDFDUW<RX·GKDYHWR
FDUU\HDFKWKLQJRXWWR\RXUFDURQHVRXS
FDQRUWRLOHWSDSHUUROODWDWLPH
EXIIHUVJL
SODFHWRJUYHRX\SRXDWHPSRUDU\KROGLQJ
OLNHWKHFDUW WKLQJVXQWLOWKHKROGHU
LVIXOO RXJ
IDUIHZHUW ULSVZKHQ\R<X HWWRPDNH
XVHDEXIIHU
GHVWLQDWLRQ
6WULQJLVSXWLQWRDEXIIHU :KHQWKHEXIIHULVIXOOWKH
$VSHQ
ZLWKRWKHU6WULQJV 6WULQJVDUHDOOZULWWHQWR
'HQYHU
¹*W]TLMZº ¹*W]TLMZº ¹)[XMVº ´$VSHQ'HQYHU%RXOGHUµ %RXOGHU
LVZULWWHQWR ¹,MV^MZº LVFKDLQHGWR
6WULQJ
%XIIHUHG:ULWHU )LOH:ULWHU
)LOH
DFKDLQVWUHDPWKDW DFRQQHFWLRQVWUHDP
ZRUNVZLWKFKDUDFWHUV WKDWZULWHVFKDUDFWHUV
DVRSSRVHGWRE\WHV
%XIIHUHG:ULWHUZULWHU QHZ%XIIHUHG:ULWHUQHZ)LOH:ULWHUD)LOH

1RWLFHWKD
QHHGWRNHHSWZ D
HGRQ·WHYHQ
4HECOOLTHINGABOUTBUFFERSISTHATTHEYREMUCHMOREEFlCIENTTHAN WKH)LOH:ULWHU UHIHUHQFHWR
RQO\WKLQJZ REMHFW7KH
WORKINGWITHOUTTHEM9OUCANWRITETOAlLEUSING&ILE7RITERALONEBY H FD UHDERXWLVWKH
%XIIHUHG
CALLINGWRITESOME3TRING BUT&ILE7RITERWRITESEACHANDEVERYTHINGYOU
WKHREMHFW:ZULH·WHUEHFDXVHWKDW·V
PASSTOTHElLEEACHANDEVERYTIME4HATSOVERHEADYOUDONTWANTOR
RQDQGZKHQZ OO FD OO PHW
NEEDSINCEEVERYTRIPTOTHEDISKISA"IG$EALCOMPAREDTOMANIPULATING %XIIHUHG: HFORVHWKHKR GV
DATAINMEMORY"YCHAININGA"UFFERED7RITERONTOA&ILE7RITERTHE UL
FDUHRIWKHUWHULWZLOOWDNH
"UFFERED7RITERWILLHOLDALLTHESTUFFYOUWRITETOITUNTILITSFULL/NLYWHEN HVWRIWKHFKD
LQ
THEBUFFERISFULLWILLTHE&ILE7RITERACTUALLYBETOLDTOWRITETOTHElLEONDISK
)FYOUDOWANTTOSENDDATABEFORETHEBUFFERISFULLYOUDOHAVECONTROL
*UST&LUSH)T#ALLSTOWRITERmUSH SAYhSENDWHATEVERSINTHEBUFFERNOWv
\RXDUHKHUH
UHDGLQJILOHV
:MILQVONZWUI<M`\.QTM
2EADINGTEXTFROMAlLEISSIMPLEBUTTHISTIMEWELLUSEA&ILE
OBJECTTOREPRESENTTHElLEA&ILE2EADERTODOTHEACTUALREADING $ILOHZLWKWZROLQHVRIWH[W
ANDA"UFFERED2EADERTOMAKETHEREADINGMOREEFlCIENT
4HEREADHAPPENSBYREADINGLINESINAWHILELOOPENDINGTHELOOP ?PI\¼['
WHENTHERESULTOFAREAD,INE ISNULL4
HATSTHEMOSTCOMMON ?PI\¼[
STYLEFORREADINGDATAPRETTYMUCHANYTHINGTHATSNOTA3ERIALIZED
OBJECT READSTUFFINAWHILELOOPACTUALLYAWHILELOOPTEST
TERMINATINGWHENTHERESNOTHINGLEFTTOREADWHICHWEKNOW
BECAUSETHERESULTOFWHATEVERREADMETHODWEREUSINGISNULL
WWKHLP SRUW
'RQ·WIRUJH
0\7H[WW[W
LPSRUWMDYDLR
FODVV5HDG$)LOH^
$)LOH5HDGHULVDFRQQHFWLRQ
FKDUDFWHUVWKDWFRQQHFWVW IRU VWUHDP
WU\^ RDWH[WILOH
)LOHP\)LOH QHZ)LOH³0\7H[WW[W´
)LOH5HDGHU¿OH5HDGHU QHZ)LOH5HDGHUP\)LOH
%XIIHUHG5HDGHUUHDGHU QHZ%XIIHUHG5HDGHU¿OH5HDGHU

D
WK H ) LO H 5HDGHUWPRRUH
&KDLQ HG5HDGHUIRU JREDFN
DULDEOHWRKROG %XIIHUQWUHDGLQJ,W·OO ZKHQ
0DNHD6WULWQJKHYOLQHLVUHDG
HDFKOLQHDV HIILFLH ILOHWRUHDGRQO\HFDXVHWKH
WRWKH IHULVHPSW\E WKLQJLQLW
WKHEXIPKDVUHDGHYHU\
6WULQJOLQH QXOO SURJUD
ZKLOHOLQH UHDGHUUHDG/LQH QXOO^
6\VWHPRXWSULQWOQOLQH
` 7KLVVD\V´5HDGDOL
UHDGHUFORVH 6WULQJYDULDEOH¶OL QHRIWH[WDQGDVVLJQLWWR WKH
EHFDXVHWKHUH $QH6·:KLOHWKDWYDULDEOHLVQRWQXOO
`FDWFK([FHSWLRQH[^ OLQHWKDWZDVM: VRPHWKLQJWRUHDG
XVWUHDGµ SULQWRXWWKH

H[SULQW6WDFN7UDFH 2UDQRWKHUZ
` WRUHDGUHDGD\WKRHPIVD\LQJLW´:KLOHWKHUHDUHVWLOO
` DQGSULQWWKHPµ OLQHV
`
FKDSWHU
9]Qb+IZL8TIaMZKWLMW]\TQVM
PUBLICCLASS1UIZ#ARD0LAYER[

PUBLICVOIDGO [
BUILDANDDISPLAYGUI
]
CLASS.EXT#ARD,ISTENERIMPLEMENTS!CTION,ISTENER[
IFTHISISAQUESTIONSHOWTHEANSWEROTHERWISESHOWNEXTQUESTION
SETAmAGFORWHETHERWEREVIEWINGAQUESTIONORANSWER
]
]
CLASS/PEN-ENU,ISTENERIMPLEMENTS!CTION,ISTENER[
BRINGUPAlLEDIALOGBOX
LETTHEUSERNAVIGATETOANDCHOOSEACARDSETTOOPEN
]
]

PRIVATEVOIDLOAD&ILE&ILElLE [
MUSTBUILDAN!RRAY,ISTOFCARDSBYREADINGTHEMFROMATEXTlLE
CALLEDFROMTHE/PEN-ENU,ISTENEREVENTHANDLERREADSTHElLEONELINEATATIME
ANDTELLSTHEMAKE#ARD METHODTOMAKEANEWCARDOUTOFTHELINE
ONELINEINTHElLEHOLDSBOTHTHEQUESTIONANDANSWERSEPARATEDBYAhv
]
PRIVATEVOIDMAKE#ARD3TRINGLINE4O0ARSE [
CALLEDBYTHELOAD&ILEMETHODTAKESALINEFROMTHETEXTlLE
ANDPARSESINTOTWOPIECESQUESTIONANDANSWERANDCREATESANEW1UIZ#ARD
ANDADDSITTOTHE!RRAY,ISTCALLED#ARD,IST
]
]
\RXDUHKHUH
4XL]&DUG3OD\HUFRGH
LPSRUWMDYDXWLO
LPSRUWMDYDDZWHYHQW
LPSRUWMDYD[VZLQJ
LPSRUWMDYDDZW
LPSRUWMDYDLR
SXEOLFFODVV4XL]&DUG3OD\HU^
SULYDWH-7H[W$UHDGLVSOD\
SULYDWH-7H[W$UHDDQVZHU
SULYDWH$UUD\/LVW4XL]&DUG!FDUG/LVW
SULYDWH4XL]&DUGFXUUHQW&DUG
SULYDWHLQWFXUUHQW&DUG,QGH[ -XVW*8,FRGHRQ
SULYDWH-)UDPHIUDPH QRWKLQJVSHFLDO WKLVSDJH
SULYDWH-%XWWRQQH[W%XWWRQ
SULYDWHERROHDQLV6KRZ$QVZHU
4XL]&DUG3OD\HUUHDGHU QHZ4XL]&DUG3OD\HU
UHDGHUJR
`

SXEOLFYRLGJR^

EXLOGJXL
IUDPH QHZ-)UDPH³4XL]&DUG3OD\HU´
)RQWELJ)RQW QHZ)RQW³VDQVHULI´)RQW%2/'

GLVSOD\ QHZ-7H[W$UHD
GLVSOD\VHW)RQWELJ)RQW

GLVSOD\VHW/LQH:UDSWUXH
GLVSOD\VHW(GLWDEOHIDOVH

-6FUROO3DQHT6FUROOHU QHZ-6FUROO3DQHGLVSOD\
QH[W%XWWRQ QHZ-%XWWRQ³6KRZ4XHVWLRQ´
PDLQ3DQHODGGT6FUROOHU
PDLQ3DQHODGGQH[W%XWWRQ
QH[W%XWWRQDGG$FWLRQ/LVWHQHUQHZ1H[W&DUG/LVWHQHU
-0HQX%DUPHQX%DU QHZ-0HQX%DU
-0HQX¿OH0HQX QHZ-0HQX³)LOH´
-0HQX,WHPORDG0HQX,WHP QHZ-0HQX,WHP³/RDGFDUGVHW´
ORDG0HQX,WHPDGG$FWLRQ/LVWHQHUQHZ2SHQ0HQX/LVWHQHU
¿OH0HQXDGGORDG0HQX,WHP
PHQX%DUDGG¿OH0HQX
IUDPHVHW-0HQX%DUPHQX%DU
IUDPHVHW6L]H
IUDPHVHW9LVLEOHWUXH

`FORVHJR

FKDSWHU
SXEOLFFODVV1H[W&DUG/LVWHQHULPSOHPHQWV$FWLRQ/LVWHQHU^
LILV6KRZ$QVZHU^
VKRZWKHDQVZHUEHFDXVHWKH\¶YHVHHQWKHTXHVWLRQ
GLVSOD\VHW7H[WFXUUHQW&DUGJHW$QVZHU
QH[W%XWWRQVHW7H[W³1H[W&DUG´
LV6KRZ$QVZHU IDOVH &KHFNWKHLV6KRZ
`HOVH^
VHHLIWKH\·UH $QVZHUERR DQI
VKRZWKHQH[WTXHVWLRQ
RUDQDQVZHUF XUUHQWO\YLHZLQOHJ ODJWR
LIFXUUHQW&DUG,QGH[FDUG/LVWVL]H^ DTX HVWL
WKLQJGHSHQGLQJRQ GRWKHDSSURSULDWH RQ
DQ G
VKRZ1H[W&DUG WKHDQVZHU

`HOVH^
WKHUHDUHQRPRUHFDUGV
GLVSOD\VHW7H[W³7KDWZDVODVWFDUG´
QH[W%XWWRQVHW(QDEOHGIDOVH
`
`
`
`

SXEOLFFODVV2SHQ0HQX/LVWHQHULPSOHPHQWV$FWLRQ/LVWHQHU^
-)LOH&KRRVHU¿OH2SHQ QHZ-)LOH&KRRVHU
¿OH2SHQVKRZ2SHQ'LDORJIUDPH
ORDG)LOH¿OH2SHQJHW6HOHFWHG)LOH ER KHP
[DQGOHWWHQ
I LOH G LD OR J
`
` %ULQJXSWKH
WR DQG F KR RV HWKHILOHWRRS
JDWH QDYL
SULYDWHYRLGORDG)LOH)LOH¿OH^
FDUG/LVW QHZ$UUD\/LVW4XL]&DUG!
WU\^
%XIIHUHG5HDGHUUHDGHU QHZ%XIIHUHG5HDGHUQHZ)LOH5HDGHU¿OH
6WULQJOLQH QXOO HUFKDLQHG
0 DNH D%XIIHUHG5HUHDGJLYLQJWKH
PDNH&DUGOLQH
WRDQHZ)WLOH5HDG EMHFWWKHXVHU
` )LOHR
UHDGHUFORVH )LOH5HDGHU KH RSHQILOHGLDORJ
FKRVHIURPWKH
`FDWFK([FHSWLRQH[^
D O LQHDW D WLPHSDVVLQJWGKH

6\VWHPRXWSULQWOQ³FRXOGQ¶WUHDGWKHFDUG¿OH´ 5HDG KR
DNH&DUGPLHWWLQWRD
H[SULQW6WDFN7UDFH OLQHWRWKHP D QG WXU QV
`
WKDWSDUVHVDULWGDQGDGGVLWWRWKH
QRZWLPHWRVWDUWE\VKRZLQJWKH¿UVWFDUG UHDO4XL]&
VKRZ1H[W&DUG $UUD\/LVW
`
SULYDWHYRLGPDNH&DUG6WULQJOLQH7R3DUVH^ (DFKOLQHRIWH[WFRUUHVSRQGVWRRXW DVLQJOH
6WULQJ>@UHVXOW OLQH7R3DUVHVSOLW³´ IODVKFDUGEXWZHKD YHW RSD UVH WKH
4XL]&DUGFDUG QHZ4XL]&DUGUHVXOW>@UHVXOW>@
TXHV WLRQ DQG DQV ZHU DVVH SDUD WHS LHFHV:H
FDUG/LVWDGGFDUG
XVHWKH6WULQJVSOLW PH WKRG WR EUHD NWKH
6\VWHPRXWSULQWOQ³PDGHDFDUG´ VWLR Q
` OLQH LQWR WZR WRN HQV RQH IRU WKH TXH
DQGRQHIRUWKHDQVZ HU :H·OOORR NDW WKH
SULYDWHYRLGVKRZ1H[W&DUG^
VSOLWP HWKR GRQ WKH QH[ WSD JH
FXUUHQW&DUG FDUG/LVWJHWFXUUHQW&DUG,QGH[
FXUUHQW&DUG,QGH[
GLVSOD\VHW7H[WFXUUHQW&DUGJHW4XHVWLRQ
QH[W%XWWRQVHW7H[W³6KRZ$QVZHU´
LV6KRZ$QVZHU WUXH
`
`FORVHFODVV
\RXDUHKHUH
SDUVLQJ6WULQJVZLWKVSOLW
8IZ[QVO_Q\P;\ZQVO[XTQ\
6DYHGLQDTXHVWLRQÀOHOLNHWKLV
,PDJLQH\RXKDYHDÁDVKFDUGOLNHWKLV
TXHVWLRQ ?PI\Q[JT]MaMTTW_'OZMMV
?PI\Q[ZMLJT]M'X]ZXTM
TW_'
?PI\Q[JT]MaMT
DQVZHU
OZMMV
+RZGR\RXVHSDUDWHWKHTXHVWLRQDQGDQVZHU"
:KHQ\RXUHDGWKHÀOHWKHTXHVWLRQDQGDQVZHUDUHVPRRVKHG
WRJHWKHULQRQHOLQHVHSDUDWHGE\DIRUZDUGVODVK´µEHFDXVH
WKDW·VKRZZHZURWHWKHÀOHLQWKH4XL]&DUG%XLOGHUFRGH
6WULQJVSOLWOHWV\RXEUHDND6WULQJLQWRSLHFHV
7KHVSOLWPHWKRGVD\V´JLYHPHDVHSDUDWRUDQG,·OOEUHDNRXWDOO
WKHSLHFHVRIWKLV6WULQJIRU\RXDQGSXWWKHPLQD6WULQJDUUD\µ
WRNHQ VHSDUDWRU WRNHQ

\HUDSSWKLV
,QWKH4XL]&DUHG3OLQODHORRNVOLNH
LVZKDWDVLQJO LQIURPWKHILOH
6WULQJWR7HVW ³:KDWLVEOXH\HOORZ"JUHHQ´
ZKHQLW·VUHDG
6WULQJ>@UHVXOW WR7HVWVSOLW³´ 7KHVSOLWPHWKRGWDNHVWKH´
EUHDNDSDUWWKH6WULQJLQWRLQµDQGXVHVLWWR
IRU6WULQJWRNHQUHVXOW^ SLHFHV1RWHVSOLWLV)$5PRUHWKLVFDVHWZR
ZKDWZH·UHXVLQJLWIRUK SRZHUIXOWKDQ
6\VWHPRXWSULQWOQWRNHQ HUH ,W FD
FRPSOH[SDUVLQJZLWKILOWHUVZ QGRH[WUHPHO\
/RRSWKURXJKWKH LOGFDUGVHWF
` DU UD
SLHFH,QWKLVH[ \ DQ GSULQWHDFKWRNHQ
WRNHQV´:KDWLV DPSOHWKHUHDUH
EOXH\HOORZ"µDRQO\WZR
QG´JUHHQµ
FKDSWHU
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: /+)LOOKINTHE!0)ANDTHEREAREABOUTlVE
0DNH LW 6WLFN
MILLIONCLASSESINTHEJAVAIOPACKAGE(OWTHEHECKDO
YOUKNOWWHICHONESTOUSE
IOLETSARENEXT
A: 4HE)/!0)USESTHEMODULAR@CHAININGCONCEPTSO
2OSESAREFIRSTV
2EADERSAND7
RITERSAREONLYF
ORTEXT
THATYOUCANHOOKTOGETHERCONNECTIONSTREAMSANDCHAIN
STREAMSALSOCALLED@FILTERSTREAMS INAWIDERANGEOF
COMBINATIONSTOGETJUSTABOUTANYTHINGYOUCOULDWANT
4HECHAINSDONTHAVETOSTOPATTWOLEVELSYOUCANHOOK
MULTIPLECHAINSTREAMSTOONEANOTHERTOGETJUSTTHERIGHT
AMOUNTOFPROCESSINGYOUNEED
-OSTOFTHETIMETHOUGHYOULLUSETHESAME
SMALLHANDFULOFCLASSES)FYOUREWRITINGTEXTFILES
"UFFERED2EADERAND"UFFERED7RITERCHAINEDTO&ILE2EADER :MDD=LHGAFLK
AND&ILE7RITER AREPROBABLYALLYOUNEED)FYOUREWRITING
SERIALIZEDOBJECTSYOUCANUSE/BJECT/UTPUT3TREAMAND 7RZULWHDWH[WILOHVWDUWZLWKD)LOH:ULWHU
/BJECT)NPUT3TREAMCHAINEDTO&ILE)NPUT3TREAMAND FRQQHFWLRQVWUHDP
&ILE/UTPUT3TREAM &KDLQWKH)LOH:ULWHUWRD%XIIHUHG:ULWHUIRU
)NOTHERWORDSOFWHATYOUMIGHTTYPICALLYDOWITH HIILFLHQF\
*AVA)/CANUSEWHATWEVEALREADYCOVERED $)LOHREMHFWUHSUHVHQWVDILOHDWDSDUWLFXODU
SDWKEXWGRHVQRWUHSUHVHQWWKHDFWXDO
Q: 7HATABOUTTHENEW)/NIOCLASSESADDEDIN

FRQWHQWVRIWKHILOH
:LWKD)LOHREMHFW\RXFDQFUHDWHWUDYHUVH
A: 4HEJAVANIOCLASSESBRINGABIGPERFORMANCE
DQGGHOHWHGLUHFWRULHV
0RVWVWUHDPVWKDWFDQXVHD6WULQJILOHQDPH
IMPROVEMENTANDTAKEGREATERADVANTAGEOFNATIVE FDQXVHD)LOHREMHFWDVZHOODQGD)LOHREMHFW
CAPABILITIESOFTHEMACHINEYOURPROGRAMISRUNNING
FDQEHVDIHUWRXVH
ON/NEOFTHEKEYNEWFEATURESOFNIOISTHATYOUHAVE
DIRECTCONTROLOFBUFFERS!NOTHERNEWFEATUREISNON 7RUHDGDWH[WILOHVWDUWZLWKD)LOH5HDGHU
BLOCKING)/WHICHMEANSYOUR)/CODEDOESNTJUSTSIT FRQQHFWLRQVWUHDP
THEREWAITINGIFTHERESNOTHINGTOREADORWRITE3OME &KDLQWKH)LOH5HDGHUWRD%XIIHUHG5HDGHUIRU
OFTHEEXISTINGCLASSESINCLUDING&ILE)NPUT3TREAMAND HIILFLHQF\
&ILE/UTPUT3TREAM TAKEADVANTAGEOFSOMEOFTHENEW
FEATURESUNDERTHECOVERS4HENIOCLASSESAREMORE 7RSDUVHDWH[WILOH\RXQHHGWREHVXUHWKH
COMPLICATEDTOUSEHOWEVERSOUNLESSYOUREALLYNEEDTHE ILOHLVZULWWHQZLWKVRPHZD\WRUHFRJQL]HWKH
NEWFEATURESYOUMIGHTWANTTOSTICKWITHTHESIMPLER GLIIHUHQWHOHPHQWV$FRPPRQDSSURDFKLVWR
VERSIONSWEVEUSEDHERE0LUSIFYOURENOTCAREFULNIOCAN XVHVRPHNLQGRIFKDUDFWHUWRVHSDUDWHWKH
LEADTOAPERFORMANCELOSS.ON NIO)/ISPROBABLYRIGHT LQGLYLGXDOSLHFHV
FOROFWHATYOULLNORMALLYDOESPECIALLYIFYOUREJUST
GETTINGSTARTEDIN*AVA
8VHWKH6WULQJVSOLWPHWKRGWRVSOLWD6WULQJ
XSLQWRLQGLYLGXDOWRNHQV$6WULQJZLWKRQH
"UTYOUCANEASEYOURWAYINTOTHENIOCLASSESBYUSING VHSDUDWRUZLOOKDYHWZRWRNHQVRQHRQHDFK
&ILE)NPUT3TREAMANDACCESSINGITSCHANNELTHROUGHTHE VLGHRIWKHVHSDUDWRU7KHVHSDUDWRUGRHVQ·W
GET#HANNEL METHODADDEDTO&ILE)NPUT3TREAMASOF
FRXQWDVDWRNHQ
VERSION
\RXDUHKHUH
VDYLQJREMHFWV
>MZ[QWV1,")*QO;MZQITQbI\QWV/W\KPI
.OWYOUVESEENTHAT)/IN*AVAISACTUALLYPRETTYSIMPLEESPECIALLYIF <RXZULWHD'RJFODVV
YOUSTICKTOTHEMOSTCOMMONCONNECTIONCHAINCOMBINATIONS"UT

THERESONEISSUEYOUMIGHTREALLYCAREABOUT
Q ,'
FODVVYHUVLR

9HUVLRQ&RQWUROLVFUXFLDO

)FYOUSERIALIZEANOBJECTYOUMUSTHAVETHECLASSINORDERTO 'RJFODVV
DESERIALIZEANDUSETHEOBJECT/+THATSOBVIOUS"UTWHATMIGHT
BELESSOBVIOUSISWHATHAPPENSIFYOUCHANGETHECLASSINTHE
MEANTIME9IKES)MAGINETRYINGTOBRINGBACKA$OGOBJECTWHEN <RXVHULDOL]HD'RJREMHFW
ONEOFITSINSTANCEVARIABLESNON TRANSIENT HASCHANGEDFROMA XVLQJWKDWFODVV
DOUBLETOA3TRING4HATVIOLATES*AVASTYPE SAFESENSIBILITIESINA"IG
7AY"UTTHATSNOTTHEONLYCHANGETHATMIGHTHURTCOMPATIBILITY 'RJREMHFW
4HINKABOUTTHEFOLLOWING
'RJREMHFW
2EMHFWLVZLWK
VWDPSHG
&KDQJHVWRDFODVVWKDWFDQKXUWGHVHULDOL]DWLRQ YHUVLRQ
$ELETINGANINSTANCEVARIABLE
#HANGINGTHEDECLAREDTYPEOFANINSTANCEVARIABLE <RXFKDQJHWKH'RJFODVV
#HANGINGANON TRANSIENTINSTANCEVARIABLETOTRANSIENT
FODVVYHUVLRQ,'

-OVINGACLASSUPORDOWNTHEINHERITANCEHIERARCHY

#HANGINGACLASSANYWHEREINTHEOBJECTGRAPH FROM3ERIALIZABLE
TONOT3ERIALIZABLEBYREMOVING@IMPLEMENTS3ERIALIZABLEFROMA 'RJFODVV
CLASSDECLARATION
#HANGINGANINSTANCEVARIABLETOSTATIC
<RXGHVHULDOL]HD'RJREMHFW
XVLQJWKHFKDQJHGFODVV
&KDQJHVWRDFODVVWKDWDUHXVXDOO\2.

!DDINGNEWINSTANCEVARIABLESTOTHECLASSEXISTINGOBJECTSWILL 'RJREMHFW

DESERIALIZEWITHDEFAULTVALUESFORTHEINSTANCEVARIABLESTHEYDIDNT

2EMHFWLV

HAVEWHENTHEYWERESERIALIZED
!DDINGCLASSESTOTHEINHERITANCETREE VWDPSHGZLWK 'RJFODVV
YHUVLRQ QLV
2EMOVINGCLASSESFROMTHEINHERITANCETREE FODVVYHUVLR

#HANGINGTHEACCESSLEVELOFANINSTANCEVARIABLEHASNOAFFECTON
THEABILITYOFDESERIALIZATIONTOASSIGNAVALUETOTHEVARIABLE
#HANGINGANINSTANCEVARIABLEFROMTRANSIENTTONON TRANSIENT
6HUDLOL]DWLRQIDLOV
PREVIOUSLY SERIALIZEDOBJECTSWILLSIMPLYHAVEADEFAULTVALUEFORTHE
PREVIOUSLY TRANSIENTVARIABLES 7KH-90VD\V´\RXFDQ·W
WHDFKDQROG'RJQHZFRGHµ
FKDSWHU
=[QVO\PM[MZQIT>MZ[QWV=1,
%ACHTIMEANOBJECTISSERIALIZEDTHEOBJECTINCLUDING
EVERYOBJECTINITSGRAPH IS@STAMPEDWITHAVERSION
)$NUMBERFORTHEOBJECTSCLASS4HE)$ISCALLED
THESERIAL6ERSION5)$ANDITSCOMPUTEDBASEDON
INFORMATIONABOUTTHECLASSSTRUCTURE!SANOBJECTIS :KHQ\RXWKLQN\RXUFODVV
BEINGDESERIALIZEDIFTHECLASSHASCHANGEDSINCETHE PLJKWHYROYHDIWHUVRPHRQHKDV
OBJECTWASSERIALIZEDTHECLASSCOULDHAVEADIFFERENT VHULDOL]HGREMHFWVIURPLW
SERIAL6ERSION5)$ANDDESERIALIZATIONWILLFAIL"UTYOU
CANCONTROLTHIS
8VHWKHVHULDOYHUFRPPDQGOLQHWRRO
WRJHWWKHYHUVLRQ,'IRU\RXUFODVV
,I\RXWKLQNWKHUHLV$1<SRVVLELOLW\WKDW
\RXUFODVVPLJKWHYROYHSXWDVHULDOYHUVLRQ )LOH(GLW:LQGRZ+HOSVHULDO.LOOHU
,'LQ\RXUFODVV
VHULDOYHU'RJ
7HEN*AVATRIESTODESERIALIZEANOBJECTITCOMPARES
'RJVWDWLFILQDOORQJ
THESERIALIZEDOBJECTSSERIAL6ERSION5)$WITHTHATOFTHE
VHULDO9HUVLRQ8,'
CLASSTHE*6-ISUSINGFORDESERIALIZINGTHEOBJECT&OR
/
EXAMPLEIFA$OGINSTANCEWASSERIALIZEDWITHAN)$OF
SAYINREALITYASERIAL6ERSION5)$ISMUCHLONGER
WHENTHE*6-DESERIALIZESTHE$OGOBJECTITWILLlRST
COMPARETHE$OGOBJECTSERIAL6ERSION5)$WITHTHE
$OGCLASSSERIAL6ERSION5)$)FTHETWONUMBERSDONT
MATCHTHE*6-ASSUMESTHECLASSISNOTCOMPATIBLE 3DVWHWKHRXWSXWLQWR\RXUFODVV
WITHTHEPREVIOUSLY SERIALIZEDOBJECTANDYOULLGETAN
EXCEPTIONDURINGDESERIALIZATION SXEOLFFODVV'RJ^
3OTHESOLUTIONISTOPUTASERIAL6ERSION5)$ VWDWLF¿QDOORQJVHULDO9HUVLRQ8,'
INYOURCLASSANDTHENASTHECLASSEVOLVESTHE /
SERIAL6ERSION5)$WILLREMAINTHESAMEANDTHE*6-
WILLSAYh/+COOLTHECLASSISCOMPATIBLEWITHTHIS SULYDWH6WULQJQDPH
SERIALIZEDOBJECTvEVENTHOUGHTHECLASSHASACTUALLY SULYDWHLQWVL]H
CHANGED
PHWKRGFRGHKHUH
4HISWORKSONLYIFYOURECAREFULWITHYOURCLASS `
CHANGES)NOTHERWORDSYOUARETAKINGRESPONSIBILITY
FORANYISSUESTHATCOMEUPWHENANOLDEROBJECTIS
BROUGHTBACKTOLIFEWITHANEWERCLASS
%HVXUHWKDWZKHQ\RXPDNHFKDQJHVWR
4OGETASERIAL6ERSION5)$FORACLASSUSETHESERIALVER WKHFODVV\RXWDNHUHVSRQVLELOLW\LQ\RXU
TOOLTHATSHIPSWITHYOUR*AVADEVELOPMENTKIT FRGHIRUWKHFRQVHTXHQFHVRIWKHFKDQJHV
\RXPDGHWRWKHFODVV)RUH[DPSOHEH
)LOH(GLW:LQGRZ+HOSVHULDO.LOOHU VXUHWKDW\RXUQHZ'RJFODVVFDQGHDOZLWK
DQROG'RJEHLQJGHVHULDOL]HGZLWKGHIDXOW
VHULDOYHU'RJ
YDOXHVIRULQVWDQFHYDULDEOHVDGGHGWRWKH
'RJVWDWLFILQDOORQJ FODVVDIWHUWKH'RJZDVVHULDOL]HG
VHULDO9HUVLRQ8,'
/
\RXDUHKHUH
&RGH.LWFKHQ
Code Kitchen
Licensed by
Eduard Simons
µ
FN´VHULDOL]H,W
:KHQ\RXHQFWOLSDWWHUQZLOO
WKHFXUU
EHVDYHG
104038
ÚHVWRUHµORDGVWKHV
SDWWHUQEDFNLQ DYHG
WKHFKHFNER[HV DQGUHVHWV
LetÕs make the BeatBox save and

restore our favorite pattern
FKDSWHU
;I^QVOI*MI\*W`XI\\MZV
2EMEMBERINTHE"EAT"OXADRUMPATTERNISNOTHINGMORETHANABUNCHOF
CHECKBOXES7HENITSTIMETOPLAYTHESEQUENCETHECODEWALKSTHROUGHTHE
CHECKBOXESTOlGUREOUTWHICHDRUMSSOUNDSAREPLAYINGATEACHOFTHE
BEATS3OTOSAVEAPATTERNALLWENEEDTODOISSAVETHESTATEOFTHECHECKBOXES
7ECANMAKEASIMPLEBOOLEANARRAYHOLDINGTHESTATEOFEACHOFTHE
CHECKBOXES!NARRAYOBJECTISSERIALIZABLEASLONGASTHETHINGSINTHEARRAYARE
SERIALIZABLESOWELLHAVENOTROUBLESAVINGANARRAYOFBOOLEANS
4OLOADAPATTERNBACKINWEREADTHESINGLEBOOLEANARRAYOBJECTDESERIALIZE
IT ANDRESTORETHECHECKBOXES-OSTOFTHECODEYOUVEALREADYSEENINTHE
#ODE+ITCHENWHEREWEBUILTTHE"EAT"OX'5)SOINTHISCHAPTERWELOOKAT
ONLYTHESAVEANDRESTORECODE
4HIS#ODE+ITCHENGETSUSREADYFORTHENEXTCHAPTERWHEREINSTEADOFWRITING
THEPATTERNTOAlLEWESENDITOVERTHENETWORKTOTHESERVER!NDINSTEADOF
LOADINGAPATTERNINFROMAlLEWEGETPATTERNSFROMTHESERVEREACHTIMEA
PARTICIPANTSENDSONETOTHESERVER
6HULDOL]LQJDSDWWHUQ

7KLVLVDQLQQHUFODVVLQVLGH
WKH% HDW %R [FRG H
SXEOLFFODVV0\6HQG/LVWHQHULPSOHPHQWV$FWLRQ/LVWHQHU^
,WDOOKDSSHQVZKHQWKHX VHUFOLFNVWKH
HV
SXEOLFYRLGDFWLRQ3HUIRUPHG$FWLRQ(YHQWD^ EXWWRQDQGWKH$FWLRQ(YHQWILU
ERROHDQ>@FKHFNER[6WDWH QHZERROHDQ>@ 0DNHDERROHDQ UUD\
VWDWHRIHDFKFKDHF WRKROGWKH
NER[
IRULQWL LL^
-&KHFN%R[FKHFN -&KHFN%R[FKHFNER[/LVWJHWL :DONWK

URXJK
LIFKHFNLV6HOHFWHG^ $UUD\/LVWRIWKFKHHFFKNEHFNER[/LVW
FKHFNER[6WDWH>L@ WUXH JHWWKHVWDWHRIHDF R[HVDQG
` DGGLWWRWKHER KRQHDQG
` ROHDQDUUD\
WU\^
)LOH2XWSXW6WUHDP¿OH6WUHDP QHZ)LOH2XWSXW6WUHDPQHZ)LOH³&KHFNER[VHU´
2EMHFW2XWSXW6WUHDPRV QHZ2EMHFW2XWSXW6WUHDP¿OH6WUHDP
RVZULWH2EMHFWFKHFNER[6WDWH
7KLVSDUW·VDSLHFHR
ZULWHVHULDOL]HWKHRQIFDNH-XVW
`FDWFK([FHSWLRQH[^
H[SULQW6WDFN7UDFH HERROHDQDUUD\
`
`FORVHPHWKRG
`FORVHLQQHUFODVV
\RXDUHKHUH
GHVHULDOL]LQJWKHSDWWHUQ
:M[\WZQVOI*MI\*W`XI\\MZV
4HISISPRETTYMUCHTHESAVEINREVERSEREADTHEBOOLEANARRAYANDUSEIT
TORESTORETHESTATEOFTHE'5)CHECKBOXES)TALLHAPPENSWHENTHEUSERHITS
THEhRESTOREv@BUTTON
5HVWRULQJDSDWWHUQ
HUFODVV
7KLVLVDQRWKHULQQ[F
LQVLGHWK H% HDW %R ODVV
SXEOLFFODVV0\5HDG,Q/LVWHQHULPSOHPHQWV$FWLRQ/LVWHQHU^
ERROHDQ>@FKHFNER[6WDWH QXOO
WU\^
)LOH,QSXW6WUHDP¿OH,Q QHZ)LOH,QSXW6WUHDPQHZ)LOH³&KHFNER[VHU´
2EMHFW,QSXW6WUHDPLV QHZ2EMHFW,QSXW6WUHDP¿OH,Q
FKHFNER[6WDWH ERROHDQ>@LVUHDG2EMHFW
5HDGWKHVLQJOHREMHFDVW WLQWKHILOHWKH

ER ROH DQ DUUD\DQ GF LWEDFNWRD
W
`FDWFK([FHSWLRQH[^H[SULQW6WDFN7UDFH` DUUD\UHPHPEHUUHDG2EMHFERROHDQ 2EMHFW
UHWXUQVDUHIHUHQFHRIW\SH
IRULQWL LL^
-&KHFN%R[FKHFN -&KHFN%R[FKHFNER[/LVWJHWL
LIFKHFNER[6WDWH>L@^
FKHFNVHW6HOHFWHGWUXH 1RZUHVWRUHWKHVWDW IHDFK
`HOVH^ FKHFNER[HVLQWKH$UUDHR RIWKH
FKHFNVHW6HOHFWHGIDOVH -&KHFN%R[REMHFWVFKH\/ LVWRIDFWXDO
FNER[/LVW
`
`
VHTXHQFHUVWRS
1RZVWRSZKDWHYHULVFXUUHQWO\SOD\LQ J
EXLOG7UDFN$QG6WDUW
DQGUHEX LOGW KHV HTXH QFH XVLQJ WKH QHZ
VWDWHRIWKHFKHFNER[HV LQWK H$U UD\/ LVW
`FORVHPHWKRG
`FORVHLQQHUFODVV
6KDUSHQ \RXU SHQFLO

4HISVERSIONHASAHUGELIMITATION7HENYOUHITTHEhSERIALIZE)TvBUTTONIT
SERIALIZESAUTOMATICALLYTOAFILENAMEDh#HECKBOXSERvWHICHGETSCREATEDIFIT
DOESNTEXIST "UTEACHTIMEYOUSAVEYOUOVERWRITETHEPREVIOUSLY SAVEDFILE
)MPROVETHESAVEANDRESTOREFEATUREBYINCORPORATINGA*&ILE#HOOSERSOTHAT
YOUCANNAMEANDSAVEASMANYDIFFERENTPATTERNSASYOULIKEANDLOADRESTORE
FROMANYOFYOURPREVIOUSLY SAVEDPATTERNFILES
FKDSWHU
6KDUSHQ \RXU SHQFLO &DQWKH\EHVDYHG"

7HICHOFTHESEDOYOUTHINKAREORSHOULDBE
SERIALIZABLE)FNOTWHYNOT.OTMEANINGFUL
3ECURITYRISK/NLYWORKSFORTHECURRENT
EXECUTIONOFTHE*6--AKEYOURBESTGUESS
WITHOUTLOOKINGITUPINTHE!0)
2EMHFWW\SH 6HULDOL]DEOH" ,IQRWZK\QRW"
2EMHFW <HV1R BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
6WULQJ <HV1R BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
)LOH <HV1R BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
'DWH <HV1R BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
2XWSXW6WUHDP <HV1R BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
-)UDPH <HV1R BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
,QWHJHU <HV1R BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
6\VWHP<HV1R BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
:KDW·V/HJDO" )LOH5HDGHU¿OH5HDGHU QHZ)LOH5HDGHU

%XIIHUHG5HDGHUUHDGHU QHZ%XIIHUHG5HDGHU¿OH5HDGHU
&LUFOHWKHFRGHIUDJPHQWV
WKDWZRXOGFRPSLOHDVVXPLQJ
)LOH2XWSXW6WUHDPI QHZ)LOH2XWSXW6WUHDPQHZ)LOH³)RRVHU´
WKH\·UHZLWKLQDOHJDOFODVV 2EMHFW2XWSXW6WUHDPRV QHZ2EMHFW2XWSXW6WUHDPI

6WULQJOLQH QXOO
PDNH&DUGOLQH
`

2EMHFW,QSXW6WUHDPLV QHZ2EMHFW,QSXW6WUHDPQHZ)LOH2XWSXW6WUHDP³*DPHVHU´

*DPH&KDUDFWHURQH$JDLQ *DPH&KDUDFWHULVUHDG2EMHFW
\RXDUHKHUH
H[HUFLVH7UXHRU)DOVH
4HISCHAPTEREXPLOREDTHEWONERFULWORLDOF
*AVA)/9OURJOBISTODECIDEWHETHEREACH
OFTHEFOLLOWING)/ RELATEDSTATEMENTSIS
TRUEORFALSE
1dQÔU_Q
&=[^N X[ /JU\N'
3ERIALIZATIONISAPPROPRIATEWHENSAVINGDATAFORNON *AVAPROGRAMSTOUSE
/BJECTSTATECANBESAVEDONLYBYUSINGSERIALIZATION
/BJECT/UTPUT3TREAMISACLASSUSEDTOSAVESERIALIZEDOBJECTS
#HAINSTREAMSCANBEUSEDONTHEIROWNORWITHCONNECTIONSTREAMS
!SINGLECALLTOWRITE/BJECT CANCAUSEMANYOBJECTSTOBESAVED
!LLCLASSESARESERIALIZABLEBYDEFAULT
4HETRANSIENTMODIlERALLOWSYOUTOMAKEINSTANCEVARIABLESSERIALIZABLE
)FASUPERCLASSISNOTSERIALIZABLETHENTHESUBCLASSCANTBESERIALIZABLE
7HENOBJECTSAREDESERIALIZEDTHEYAREREADBACKINLAST INlRSTOUTSEQUENCE
7HENANOBJECTISDESERIALIZEDITSCONSTRUCTORDOESNOTRUN
"OTHSERIALIZATIONANDSAVINGTOATEXTlLECANTHROWEXCEPTIONS
"UFFERED7RITERSCANBECHAINEDTO&ILE7RITERS
&ILEOBJECTSREPRESENTlLESBUTNOTDIRECTORIES
9OUCANTFORCEABUFFERTOSENDITSDATABEFOREITSFULL
"OTHlLEREADERSANDlLEWRITERSCANBEBUFFERED
4HE3TRINGSPLIT METHODINCLUDESSEPARATORSASTOKENSINTHERESULTARRAY
!NYCHANGETOACLASSBREAKSPREVIOUSLYSERIALIZEDOBJECTSOFTHATCLASS
FKDSWHU
Code Magnets
4HISONESTRICKYSOWEPROMOTEDITFROMAN%XERCISETOFULL0UZZLESTATUS
2ECONSTRUCTTHECODESNIPPETSTOMAKEAWORKING*AVAPROGRAMTHAT
PRODUCESTHEOUTPUTLISTEDBELOW9OUMIGHTNOTNEEDALLOFTHEMAGNETS
ANDYOUMAYREUSEAMAGNETMORETHANONCE
^
6HULDOL]DEOH
DPHLPSOHPHQWV
FODVV'XQJHRQ* WU\^
HZ
UHDPIRV Q
)LOH2XWSXW6W VKRUWJHW=^
VHUµ
W6WUHDP´GJ
)LOH2XWSX UHWXUQ]
HSULQW6WDFN7UDFH
RRVFORVH
Z
2EMHFW,QSXW6WUHDPRLV QH
LQWJHW;^
2EMHFW,QSXW6WUHDPÀV
UHWXUQ[
6\VWHPRXWSULQWOQGJHW;GJHW<GJHW=
)LOH,QSXW6WUHDPÀV QHZ SXEOLFLQW[

WUH DP ´GJ VH Uµ WUDQVLHQWORQJ\
)LOH,QSXW6
SULYDWHVKRUW]
ORQJJHW<^ FODVV'X
QJHRQ7HV
W^
UHWXUQ\
RLVFORVH
LPSRUWMDYDLR

IRVZULWH2EMHFWG
`FDWFK([FHSWL
RQH^
G 'XQJHRQ*DPHRLVUHDG2EMHFW
2EMHFW2XWSXW6WUHDPRRV QHZ
)LOH(GLW:LQGRZ+HOS7RUWXUH
G
MDYD'XQJHRQ7HVW 2EMHFW2XWSXW6WUHDPIRV RRVZULWH2EMHFW

JV ^
PDLQ6WULQJ>@DU
SXEOLFVWDWLFYRLG

QHZ'XQJHRQ*DPH
'XQJHRQ*DPHG
\RXDUHKHUH
H[HUFLVHVROXWLRQV
%XERCISE3OLUTIONS
3ERIALIZATIONISAPPROPRIATEWHENSAVINGDATAFORNON *AVAPROGRAMSTOUSE )DOVH
/BJECTSTATECANBESAVEDONLYBYUSINGSERIALIZATION )DOVH
/BJECT/UTPUT3TREAMISACLASSUSEDTOSAVESERIALIZEDOBJECTS 7UXH
#HAINSTREAMSCANBEUSEDONTHEIROWNORWITHCONNECTIONSTREAMS )DOVH
!SINGLECALLTOWRITE/BJECT CANCAUSEMANYOBJECTSTOBESAVED 7UXH
!LLCLASSESARESERIALIZABLEBYDEFAULT )DOVH
4HETRANSIENTMODIlERALLOWSYOUTOMAKEINSTANCEVARIABLESSERIALIZABLE )DOVH
)FASUPERCLASSISNOTSERIALIZABLETHENTHESUBCLASSCANTBESERIALIZABLE )DOVH
7HENOBJECTSAREDESERIALIZEDTHEYAREREADBACKINLAST INlRSTOUTSEQUENCE )DOVH
7HENANOBJECTISDESERIALIZEDITSCONSTRUCTORDOESNOTRUN 7UXH
"OTHSERIALIZATIONANDSAVINGTOATEXTlLECANTHROWEXCEPTIONS 7UXH
"UFFERED7RITERSCANBECHAINEDTO&ILE7RITERS 7UXH
&ILEOBJECTSREPRESENTlLESBUTNOTDIRECTORIES )DOVH
9OUCANTFORCEABUFFERTOSENDITSDATABEFOREITSFULL )DOVH
"OTHlLEREADERSANDlLEWRITERSCANOPTIONALLYBEBUFFERED 7UXH
4HE3TRINGSPLIT METHODINCLUDESSEPARATORSASTOKENSINTHERESULTARRAY )DOVH
!NYCHANGETOACLASSBREAKSPREVIOUSLYSERIALIZEDOBJECTSOFTHATCLASS )DOVH
FKDSWHU
*RRGWKLQJZH·UH
ÀQDOO\DWWKHDQVZHUV
,ZDVJHWWLQ·NLQGRI
WLUHGRIWKLVFKDSWHU
LPSRUWMDYDLR
FODVV'XQJHRQ*DPHLPSOHPHQWV6HULDOL]DEOH^
SXEOLFLQW[
WUDQVLHQWORQJ\
SULYDWHVKRUW]
LQWJHW;^
UHWXUQ[
`
ORQJJHW<^
UHWXUQ\
`
VKRUWJHW=^
UHWXUQ]
`
`
FODVV'XQJHRQ7HVW^
'XQJHRQ*DPHG QHZ'XQJHRQ*DPH
WU\^
)LOH2XWSXW6WUHDPIRV QHZ)LOH2XWSXW6WUHDP´GJVHUµ
2EMHFW2XWSXW6WUHDPRRV QHZ2EMHFW2XWSXW6WUHDPIRV
RRVZULWH2EMHFWG
RRVFORVH
)LOH,QSXW6WUHDPÀV QHZ)LOH,QSXW6WUHDP´GJVHUµ
)LOH(GLW:LQGRZ+HOS(VFDSH 2EMHFW,QSXW6WUHDPRLV QHZ2EMHFW,QSXW6WUHDPÀV
MDYD'XQJHRQ7HVW G 'XQJHRQ*DPHRLVUHDG2EMHFW
RLVFORVH
`FDWFK([FHSWLRQH^
HSULQW6WDFN7UDFH
`
`
`
\RXDUHKHUH
QHWZRUNLQJDQGWKUHDGV
0DNHD&RQQHFWLRQ
&RQQHFWZLWKWKHRXWVLGHZRUOG9OUR*AVAPROGRAMCANREACHOUTANDTOUCHA
PROGRAMONANOTHERMACHINE)TSEASY!LLTHELOW LEVELNETWORKINGDETAILSARETAKENCAREOFBY
CLASSESINTHEJAVANETLIBRARY/NEOF*AVASBIGBENEFITSISTHATSENDINGANDRECEIVINGDATAOVER
ANETWORKISJUST)/WITHASLIGHTLYDIFFERENTCONNECTIONSTREAMATTHEENDOFTHECHAIN)FYOUVE
GOTA"UFFERED2EADERYOUCANREAD!NDTHE"UFFERED2EADERCOULDCARELESSIFTHEDATACAME
OUTOFAFILEORFLEWDOWNANETHERNETCABLE)NTHISCHAPTERWELLCONNECTTOTHEOUTSIDEWORLD
WITHSOCKETS7ELLMAKECLIENTSOCKETS7ELLMAKESERVERSOCKETS7ELLMAKECLIENTSANDSERVERS
!NDWELLMAKETHEMTALKTOEACHOTHER"EFORETHECHAPTERSDONEYOULLHAVEAFULLY FUNCTIONAL
MULTITHREADEDCHATCLIENT$IDWEJUSTSAYMULTITHREADED9ESNOWYOUWILLLEARNTHESECRETOF
HOWTOTALKTO"OBWHILESIMULTANEOUSLYLISTENINGTO3UZY
WKLVLVDQHZFKDSWHU
EHDWER[FKDW
:MIT\QUM*MI\*W`+PI\
WU\WKLVRQH
LW·VEHWWHUIRU
VHTXHQFH
DJHDQG
VN\OHUIDVWD 7\SHDPHHVVVHQG,WEXWWRQ
VHTXHQFH
QGIXQN\JRRG
IRU SUHVVWK RXUPHVVDJH
WRVHQG\XUFXUUHQWEHDW
HYVWHUOLNHV
N\OHUEXWP
RUH $1'\R
SDWWHUQ
2DNHQIROGLVK

VN\OHU\RX:
,6+7RRSHUN
\
9OUREWORKINGONACOMPUTERGAME9OUANDYOURTEAM
AREDOINGTHESOUNDDESIGNFOREACHPARTOFTHEGAME FOLFNLQJRQDUHFHUQLYH GPHVVDJH
5SINGA@CHATVERSIONOFTHE"EAT"OXYOURTEAMCAN ORDGVWKHSDW WH W KDWZHQW
COLLABORATEYOUCANSENDABEATPATTERNALONGWITH ZLWKLW
YOURCHATMESSAGEANDEVERYBODYINTHE"EAT"OX#HAT
GETSIT3OYOUDONTJUSTGETTOREADTHEOTHER
PARTICIPANTSMESSAGESYOUGETTOLOADAND
PLAYABEATPATTERNSIMPLYBYCLICKINGTHE
MESSAGEINTHEINCOMINGMESSAGESAREA
)NTHISCHAPTERWEREGOINGTOLEARNWHATIT
TAKESTOMAKEACHATCLIENTLIKETHIS7ERE
EVENGOINGTOLEARNALITTLEABOUTMAKINGA
CHATSERVER7ELLSAVETHEFULL"EAT"OX#HAT
FORTHE#ODE+ITCHENBUTINTHISCHAPTERYOU
WILLWRITEA,UDICROUSLY3IMPLE#HAT#LIENTAND
6ERY3IMPLE#HAT3ERVERTHATSENDANDRECEIVE
TEXTMESSAGES
<RXFDQKDYHFRP WH
DXWKHQWLFLQWHOOHFSOH
WX DOO
O\
VWLPXODWLQJFKDW \
FRQYHUVDWLRQV(YH U\
PHVVDJHLVVHQWW
SDUWLFLSDQWV RDOO
6HQG\RXUPHVVDJHWRWKHVHUYHU
FKDSWHU
&KDW3URJUDP2YHUYLHZ :K\DP,
KHUH"'RQ¶W
H[SHFW0(WR
DQVZHUWKDW
WKHUHDUHFXUUHQWO\
7KH&OLHQWKDVWRNQRZ SDUWLFLSDQWVLQ
DERXWWKH6HUYHU WKLVFKDWVHVVLRQ
&OLHQW$&OLHQW%
&OLHQW$
DQG&OLHQW&
7KH6HUYHUKDVWRNQRZ
DERXW$//WKH&OLHQWV :K\DP,
KHUH"'RQ¶W
6HUYHU
H[SHFW0(WR
DQVZHUWKDW
:K\DP,
KHUH"'RQ¶W
Licensed by
H[SHFW0(WR
DQVZHUWKDW
&OLHQW%
&OLHQW&
+RZLW:RUNV

Eduard Simons
&OLHQWFRQQHFWVWRWKHVHUYHU
6HUYHU,·GOLNHWRFRQQHFW
WRWKHFKDWVHUYLFH
:DLWLQJIRU
FOLHQWUHTXHVWV
104038
&OLHQW$
6HUYHU
3DUWLFLSDQWV
7KHVHUYHUPDNHVD 2.\RX·UHLQ &OLHQW$
FRQQHFWLRQDQGDGGVWKHFOLHQW
&OLHQW$ 6HUYHU
WRWKHOLVWRISDUWLFLSDQWV
6HUYHU,·GOLNHWRFRQQHFW
:K\DP,KHUH"
'RQ¶WH[SHFW WRWKHFKDWVHUYLFH 3DUWLFLSDQWV
0(WRDQVZHU
$QRWKHUFOLHQWFRQQHFWV WKDW6RZK\DP &OLHQW$

2.\RX·UHLQ &OLHQW%
&OLHQW% 6HUYHU
:K\DP,KHUH"
'RQ¶WH[SHFW
0(WRDQVZHU
´:KRWRRNWKHODYDODPS 0HVVDJH
&OLHQW$VHQGVDPHVVDJHWR WKDW6RZK\DP
IURPP\GRUPURRP"µ UHFHLYHG
WKHFKDWVHUYLFH
&OLHQW$ 6HUYHU
:K\DP,KHUH" ´:KRWRRNWKHODYDODPS 0HVVDJH

IURPP\GRUPURRP"µ
'RQ¶WH[SHFW
7KHVHUYHUGLVWULEXWHVWKH
0(WRDQVZHU
WKDW6RZK\DP GLVWULEXWHGWR
:K\DP,KHUH"
DOOSDUWLFLSDQWV
PHVVDJHWR$//SDUWLFLSDQWV 'RQ¶WH[SHFW
0(WRDQVZHU
WKDW6RZK\DP
&OLHQW$
LQFOXGLQJWKHRULJLQDOVHQGHU 6HUYHU
&OLHQW%
\RXDUHKHUH
VRFNHWFRQQHFWLRQV
+WVVMK\QVO;MVLQVOIVL:MKMQ^QVO
4HETHREETHINGSWEHAVETOLEARNTOGETTHECLIENTWORKINGARE
(OWTOESTABLISHTHEINITIALCONNECTIONBETWEENTHECLIENTANDSERVER
(OWTOSENDMESSAGESTOTHESERVER
(OWTORECEIVEMESSAGESFROMTHESERVER
4HERESALOTOFLOW LEVELSTUFFTHATHASTOHAPPENFORTHESETHINGSTOWORK"UTWERE
LUCKYBECAUSETHE*AVA!0)NETWORKINGPACKAGEJAVANET MAKESITAPIECEOFCAKE
FORPROGRAMMERS9OULLSEEALOTMORE'5)CODETHANNETWORKINGAND)/CODE
!NDTHATSNOTALL
,URKINGWITHINTHESIMPLECHATCLIENTISAPROBLEMWEHAVENTFACEDSOFARINTHIS
BOOKDOINGTWOTHINGSATTHESAMETIME%STABLISHINGACONNECTIONISAONE TIME
OPERATIONTHATEITHERWORKSORFAILS "UTAFTERTHATACHATPARTICIPANTWANTSTO
SENDOUTGOINGMESSAGESANDSIMULTANEOUSLYRECEIVEINCOMINGMESSAGESFROMTHEOTHER
PARTICIPANTSVIATHESERVER (MMMMTHATONESGOINGTOTAKEALITTLETHOUGHTBUT
WELLGETTHEREINJUSTAFEWPAGES
&RQQHFW
&OLHQWFRQQHFWVWRWKHVHUYHUE\
HVWDEOLVKLQJD6RFNHWFRQQHFWLRQ
FKDWVHUYHUDW
0DNHDVRFNHWFRQQHFWLRQWR
DWSRUW SRUW
&OLHQW$ 6HUYHU
6HQG
&OLHQWVHQGVDPHVVDJHWRWKHVHUYHU
6HUYHU
ZULWHUSULQWOQD0HVVDJH PDFKLQHDW

&OLHQW$ 6HUYHU
5HFHLYH
&OLHQWJHWVDPHVVDJHIURPWKHVHUYHU
6HUYHU
6WULQJV UHDGHUUHDG/LQH PDFKLQHDW

&OLHQW$ 6HUYHU
FKDSWHU
5ISMIVM\ _WZS;WKSM\KWVVMK\QWV
7RPDNHD6RFNHW
4OCONNECTTOANOTHERMACHINEWENEEDA3OCKETCONNECTION
!3OCKETJAVANET3OCKETCLASS ISANOBJECTTHATREPRESENTS
FRQQHFWLRQ\RXQHHG
ANETWORKCONNECTIONBETWEENTWOMACHINES7HATSA WRNQRZWZRWKLQJV
CONNECTION!RELATIONSHIPBETWEENTWOMACHINESWHERETWO
PIECESOFSOFTWAREKNOWABOUTEACHOTHER-OSTIMPORTANTLY
DERXWWKHVHUYHUZKR
THOSETWOPIECESOFSOFTWAREKNOWHOWTOCOMMUNICATEWITH LWLVDQGZKLFKSRUW
EACHOTHER)NOTHERWORDSHOWTOSENDBITSTOEACHOTHER
7EDONTCAREABOUTTHELOW LEVELDETAILSTHANKFULLYBECAUSE
LW·VUXQQLQJRQ
THEYREHANDLEDATAMUCHLOWERPLACEINTHE@NETWORKING
STACK)FYOUDONTKNOWWHATTHE@NETWORKINGSTACKISDONT
,QRWKHUZRUGV
WORRYABOUTIT)TSJUSTAWAYOFLOOKINGATTHELAYERSTHAT
INFORMATIONBITS MUSTTRAVELTHROUGHTOGETFROMA*AVA ,3DGGUHVVDQG7&3
PROGRAMRUNNINGINA*6-ONSOME/3TOPHYSICALHARDWARE SRUWQXPEHU
ETHERNETCABLESFOREXAMPLE ANDBACKAGAINONSOMEOTHER
MACHINE3OMEBODYHASTOTAKECAREOFALLTHEDIRTYDETAILS
"UTNOTYOU4HATSOMEBODYISACOMBINATIONOF/3 SPECIlC
SOFTWAREANDTHE*AVANETWORKING!0)4HEPARTTHATYOUHAVE
TOWORRYABOUTISHIGH LEVELMAKETHATVERYHIGH LEVELAND
SHOCKINGLYSIMPLE2EADY 7&3SRUWQ
XPEHU
6RFNHWFKDW6RFNHW QHZ6RFNHW³´
VHUYHU
,3DGGUHVVIRUWKH
7KHFKDWVHUYHULVDW 7KLVFOLHQWLVDW
QQHFWLRQ
SRUW SRUW
:KHQ,QHHGWRWDONWRKLP 6RFNHWF
WRSRUWRQQHFWLRQ 6RFNHWRFRWKHFOLHQWDW :KHQ,QHHGWRWDONWR
WKDW·VZKHUH,·OOVHQG RQWKHVHUY EDFNW SRUW
HUDW KLPWKDW·VZKHUH,·OOVHQG

WKHPHVVDJH WKHPHVVDJH

&OLHQW 6HUYHU
$6RFNHWFRQQHFWLRQPHDQVWKHWZRPDFKLQHVKDYH
LQIRUPDWLRQDERXWHDFKRWKHULQFOXGLQJQHWZRUN
ORFDWLRQ,3DGGUHVVDQG7&3SRUW
\RXDUHKHUH
ZHOONQRZQSRUWV
)<+8XWZ\Q[R][\IV]UJMZ
)JQ\V]UJMZ\PI\QLMV\QNQM[ :HOONQRZQ7&3SRUWQXPEHUV
IRUFRPPRQVHUYHUDSSOLFDWLRQV
I[XMKQNQKXZWOZIUWV\PM[MZ ^MZ
7HOQHW 6073
)73
9OURINTERNETWEB(440 SERVERRUNSONPORT4HATSA
STANDARD)FYOUVEGOTA4ELNETSERVERITSRUNNINGONPORT
&400/0MAILSERVER3-404HE4IME 7LPH
6HUYHU
SERVERSITSAT4HINKOFPORTNUMBERSASUNIQUEIDENTIlERS
4HEYREPRESENTALOGICALCONNECTIONTOAPARTICULARPIECEOF
SOFTWARERUNNINGONTHESERVER4HATSIT9OUCANTSPINYOUR
HARDWAREBOXAROUNDANDlNDA4#0PORT&ORONETHING
+7736 +773
YOUHAVEOFTHEMONASERVER 3OTHEY 323
OBVIOUSLYDONTREPRESENTAPLACETOPLUGINPHYSICALDEVICES
4HEYREJUSTANUMBERREPRESENTINGANAPPLICATION $VHUYHUFDQKDYHXSWR
GLIIHUHQWVHUYHUDSSVUXQQLQJ
7ITHOUTPORTNUMBERSTHESERVERWOULDHAVENOWAYOF RQHSHUSRUW
KNOWINGWHICHAPPLICATIONACLIENTWANTEDTOCONNECTTO
!NDSINCEEACHAPPLICATIONMIGHTHAVEITSOWNUNIQUE
PROTOCOLTHINKOFTHETROUBLEYOUDHAVEWITHOUTTHESE
IDENTIlERS7HATIFYOURWEBBROWSERFOREXAMPLELANDED
ATTHE0/0MAILSERVERINSTEADOFTHE(440SERVER4HE 7KH7&3SRUW
MAILSERVERWONTKNOWHOWTOPARSEAN(440REQUEST!ND
EVENIFITDIDTHE0/0SERVERDOESNTKNOWANYTHINGABOUT
QXPEHUVIURPWR
SERVICINGTHE(440REQUEST DUHUHVHUYHGIRUZHOO
7HENYOUWRITEASERVERPROGRAMYOULLINCLUDECODETHAT NQRZQVHUYLFHV'RQ·W
TELLSTHEPROGRAMWHICHPORTNUMBERYOUWANTITTORUNON
YOULLSEEHOWTODOTHISIN*AVAALITTLELATERINTHISCHAPTER XVHWKHPIRU\RXURZQ
)NTHE#HATPROGRAMWEREWRITINGINTHISCHAPTERWEPICKED
*USTBECAUSEWEWANTEDTO!NDBECAUSEITMETTHE
VHUYHUSURJUDPV
CRITERIATHATITBEANUMBERBETWEENAND7HY
"ECAUSETHROUGHARERESERVEDFORTHEWELL 7KHFKDWVHUYHUZH·UH
KNOWNSERVICESLIKETHEONESWEJUSTTALKEDABOUT ZULWLQJXVHVSRUW
!NDIFYOUREWRITINGSERVICESSERVERPROGRAMS TORUNON
ACOMPANYNETWORKYOUSHOULDCHECKWITHTHESYS ADMINS
:HMXVWSLFNHGD
TOlNDOUTWHICHPORTSAREALREADYTAKEN9OURSYS ADMINS QXPEHUEHWZHHQ
MIGHTTELLYOUFOREXAMPLETHATYOUCANTUSEANYPORT
NUMBERBELOWSAY)NANYCASEIFYOUVALUEYOURLIMBS DQG
YOUWONTASSIGNPORTNUMBERSWITHABANDON5NLESSITS
YOURHOMENETWORK)NWHICHCASEYOUJUSTHAVETOCHECKWITH
YOURKIDS :HOO\RXPLJKWEHDEOHWRXVHRQHRI
WKHVHEXWWKHV\VDGPLQZKHUH\RX
ZRUNZLOOSUREDEO\NLOO\RX
FKDSWHU
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: (OWDOYOUKNOWTHEPORT 3RUWQXPEHULV
VWRUHLQWKHPDOOWKHVSHFLILF
NUMBEROFTHESERVERPROGRAMYOU ,3DGGUHVVLVWKHPDOO
WANTTOTALKTO
A: 4HATDEPENDSONWHETHERTHE
PROGRAMISONEOFTHEWELL KNOWN
SERVICES)FYOURETRYINGTOCONNECT
TOAWELL KNOWNSERVICELIKETHEONES
ONTHEOPPOSITEPAGE(4403-40
&40ETC YOUCANLOOKTHESEUPON
THEINTERNET'OOGLEh7ELL +NOWN
4#00ORTv /RASKYOURFRIENDLY ,3DGGUHVVLVOLNHVSHFLI\LQJD
NEIGHBORHOODSYS ADMIN
SDUWLFXODUVKRSSLQJPDOOVD\
"UTIFTHEPROGRAMISNTONEOFTHE
´)ODWLURQV0DUNHWSODFHµ
WELL KNOWNSERVICESYOUNEEDTO
FINDOUTFROMWHOEVERISDEPLOYING
THESERVICE!SKHIM/RHER4YPICALLY
IFSOMEONEWRITESANETWORKSERVICE 3RUWQXPEHULVOLNHQDPLQJ
ANDWANTSOTHERSTOWRITECLIENTSFOR
ITTHEYLLPUBLISHTHE)0ADDRESSPORT DVSHFLÀFVWRUHVD\
NUMBERANDPROTOCOLFORTHESERVICE ´%RE·V&'6KRSµ
&OREXAMPLEIFYOUWANTTOWRITEA
CLIENTFORA'/GAMESERVERYOUCAN
VISITONEOFTHE'/SERVERSITESAND
FINDINFORMATIONABOUTHOWTOWRITEA
CLIENTFORTHATPARTICULARSERVER
DLQ EDUEHOO
EU%UDLQ%DUEHOO
Q: #ANTHEREEVERBEMORETHAN /+YOUGOTA3OCKETCONNECTION4HECLIENTANDTHE
ONEPROGRAMRUNNINGONASINGLE SERVERKNOWTHE)0ADDRESSAND4#0PORTNUMBERFOR
PORT)NOTHERWORDSCANTWO EACHOTHER.OWWHAT(OWDOYOUCOMMUNICATE
APPLICATIONSONTHESAMESERVERHAVE
THESAMEPORTNUMBER
OVERTHATCONNECTION)NOTHERWORDSHOWDOYOU
MOVEBITSFROMONETOTHEOTHER)MAGINETHEKINDSOF
A: .O)FYOUTRYTOBINDAPROGRAM
MESSAGESYOURCHATCLIENTNEEDSTOSENDANDRECEIVE
TOAPORTTHATISALREADYINUSEYOULL
GETA"IND%XCEPTION4OBINDAPROGRAM
+RZGRWKHVHW ZR &KDWVHUYHU
TOAPORTJUSTMEANSSTARTINGUPA
DFWXDOO\W DO N WR
SERVERAPPLICATIONANDTELLINGITTORUN
WK HU " SURJUDP
ONAPARTICULARPORT!GAINYOULLLEARN HDFK R
MOREABOUTTHISWHENWEGETTOTHE 6HUYHU
&OLHQW
SERVERPARTOFTHISCHAPTER
\RXDUHKHUH
UHDGLQJIURPDVRFNHW
<WZMILLI\INZWUI;WKSM\][MI LQSXWDQGRXWSXWVWUHDPV
WRDQGIURPWKH6RFNHW
*]NNMZML:MILMZ FRQQHFWLRQV
4OCOMMUNICATEOVERA3OCKETCONNECTIONYOUUSESTREAMS
2EGULAROLD)/STREAMSJUSTLIKEWEUSEDINTHELASTCHAPTER/NE
OFTHECOOLESTFEATURESIN*AVAISTHATMOSTOFYOUR)/WORKWONT
CAREWHATYOURHIGH LEVELCHAINSTREAMISACTUALLYCONNECTEDTO)N
OTHERWORDSYOUCANUSEA"UFFERED2EADERJUSTLIKEYOUDIDWHEN
YOUWEREWRITINGTOAlLETHEDIFFERENCEISTHATTHEUNDERLYING
CONNECTIONSTREAMISCONNECTEDTOA3OCKETRATHERTHANA&ILE
HUZKLFK\RXN QRZ
7KHSRUWQXPE2/ \RX W KD W LV
EHFDXVHZH7 EHU'IRURXUFKDWVHUYHU
0DNHD6RFNHWFRQQHFWLRQWRWKHVHUYHU WKHSRUWQXP

RWKHUZRULGVV WKH,3DGGUHVVIRU´
FDQXVHWKLVZWKHRQHWKLVFRGHLV ORFDOKRVWµLQ
VHUYHURQDV KHQ\RX·UHWHVWLQJ\UXQQLQJRQ<RX
LQJOHVWDQG R
DORQHPDFKXULQFHOLHQWDQG
0DNHDQ,QSXW6WUHDP5HDGHUFKDLQHGWRWKH6RFNHW·V
ORZOHYHOFRQQHFWLRQLQSXWVWUHDP
,QSXW6WUHDP5HDGHUVWUHDP QHZ,QSXW6WUHDP5HDGHUFKDW6RFNHWJHW,QSXW6WUHDP
U LV ZHHQDORZ
D¶EULGJH·EHWQJ
,QSXW6 WU HD P5 HD GH
OLNHWKHRQHFW FRPL IURPWKNHH $OOZHKDYHWRGRLV$6.
WKHVRFNHWIRU
OHYHOE\WHVWUHDDP JK O HY
POL
HOFKDUD HUVRWUXUHDWRSRI DQLQSXWVWUHDP,W·V DO RZ
6RFNHW DQ G KL DV VWUHDPEXWZH·UHM JR OHYHOFRQQHFWLRQ
WKH%XIIHUHG5DP HDGHUZH·UHDIWHU VRPHWKLQJPRUHWH[XVW QQDFKDLQLWWR
WIULHQGO\
WKHFKDLQVWUH

&KDLQWKH%XIHD IHUHG5HDGHUWRVWFKKHDLQHGWRWKHORZ
U ZKLF K ZD
,QSXW6WUHDP5LRQGH KH6RFNHW
0DNHD%XIIHUHG5HDGHUDQGUHDG
YH OF RQQH FW VW UHDPZHJRWIURPW
OH
%XIIHUHG5HDGHUUHDGHU QHZ%XIIHUHG5HDGHUVWUHDP
6WULQJPHVVDJH UHDGHUUHDG/LQH
VRXUFH
GHVWLQDWLR
Q EXIIHUHGFKDUDFWHUV FRQYHUWHGWRFKDUDFWHUV E\WHVIURPVHUYHU
'DWDRQWKH
EXIIHUHG FKDUDFWHUV VHUYHU
FKDUDFWHUV FKDLQHGWR FKDLQHGWR
%XIIHUHG5HDGHU ,QSXW6WUHDP5HDGHU 6RFNHW·VLQSXWVWUHDP
&OLHQW ZHGRQ·WQHHGWRNQRZ
WKHDFWXDOFODVV 6HUYHU
FKDSWHU
<W_ZQ\MLI\I\WI;WKSM\][MI
8ZQV\?ZQ\MZ
7EDIDNTUSE0RINT7RITERINTHELASTCHAPTERWEUSED"UFFERED7RITER7EHAVE
ACHOICEHEREBUTWHENYOUREWRITINGONE3TRINGATATIME0RINT7RITERISTHE
STANDARDCHOICE!NDYOULLRECOGNIZETHETWOKEYMETHODSIN0RINT7RITER
PRINT ANDPRINTLN *USTLIKEGOODOL3YSTEMOUT
WKH
WKLVSDUW·VWK HVDPHDVLWZWDVRRWKQH
Z UL WH
RSSRVLWHSDJHLOOKDYWRHWRFRQQHFWWRLW
VHUY HU Z HVW
0DNHD6RFNHWFRQQHFWLRQWRWKHVHUYHU
0DNHD3ULQW:ULWHUFKDLQHGWRWKH6RFNHW·VORZOHYHO
FRQQHFWLRQRXWSXWVWUHDP
3ULQW:ULWHUZULWHU QHZ3ULQW:ULWHUFKDW6RFNHWJHW2XWSXW6WUHDP
ZHHQ
VRZQEULGJHEHWIU 7KH6RFNHWJLYHVXVDORZ
UL WH U DFWV D V LW RPWKH
3ULQW:
GD WD D QG W KHE\WHVLWJHWVFKDLQLQJD VWUHDPDQGZHFKDLQLWWR OHYHOFRQQHFWLRQ
DF WH U WKH3ULQW:ULWHUE\
FKDU XWSXWVWUHDP%\VWUHDPZH JLYLQJLWWRWKH3ULQ
6RFNHW·VORZOHYHWOR 6RFNHW·VRXWSXW
W:ULWHUFRQVWUXFWR U
3ULQW:ULWHUWR VKHWRWKH6RFNHWFRQQHFWLRQ
FDQZULWH6WULQJ
:ULWHSULQWVRPHWKLQJ

HQGRIZKDWLWVHQ
GV
QHZ OLQH D W WK H
ZULWHUSULQWOQ³PHVVDJHWRVHQG´ SULQWOQDGGVD
WKHQHZOLQH
ZULWHUSULQW³DQRWKHUPHVVDJH´ SULQWGRHVQ·WDGG
GHVWLQDWLRQ
VRXUFH
FKDUDFWHUV E\WHVWRVHUYHU
&KDWVHUYHU
´PHVVDJHµ SURJUDP
FKDLQHGWR
3ULQW:ULWHU 6RFNHW·VRXWSXW
&OLHQW VWUHDPZHGRQ·WQHHG 6HUYHU
WRNQRZWKHDFWXDOFODVV
\RXDUHKHUH
ZULWLQJDFOLHQW
<PM,IQTa)L^QKM+TQMV\
7HOO\RXUERVV
"EFOREWESTARTBUILDINGTHE#HATAPP 7UHDW\RXUVHOIWR
WKHUHSRUWZLOO
LETSSTARTWITHSOMETHINGALITTLESMALLER DFROGRQH<RX
KDYHWRZDLW7KHUH·V
4HE!DVICE'UYISASERVERPROGRAMTHAT GHVHUYHLW
SRZGHUDW$VSHQ
OFFERSUPPRACTICALINSPIRATIONALTIPS
TOGETYOUTHROUGHTHOSELONGDAYSOF
CODING
7EREBUILDINGACLIENTFOR4HE!DVICE 7KDWVKDGHRI
'UYPROGRAMWHICHPULLSAMESSAGE JUHHQLVQ·WUHDOO\
FROMTHESERVEREACHTIMEITCONNECTS ZRUNLQ·IRU\RX
7HATAREYOUWAITINGFOR7HOKNOWS
WHATOPPORTUNITIESYOUVEMISSED
WITHOUTTHISAPP
7KH$GYLFH*X\
&RQQHFW
&OLHQWFRQQHFWVWRWKHVHUYHUDQGJHWVDQ
LQSXWVWUHDPIURPLW
0DNHDVRFNHWFRQQHFWLRQWR DGYLFHVHUYHU
DWSRUW DW
SRUW
VRFNHWJHW,QSXW6WUHDP
&OLHQW 6HUYHU
5HDG
&OLHQWUHDGVDPHVVDJHIURPWKHVHUYHU
DGYLFHVHUYHU
FRPSRVHV
DGYLFH UHDGHUUHDG/LQH DGYLFHDQG
VHQGVLW
6HUYHU
&OLHQW$
FKDSWHU
,IQTa)L^QKM+TQMV\KWLM
7KLVSURJUDPPDNHVD6RFNHWPDNHVD%XIIHUHG5HDGHUZLWKWKH
KHOSRIRWKHUVWUHDPVDQGUHDGVDVLQJOHOLQHIURPWKHVHUYHU
DSSOLFDWLRQZKDWHYHULVUXQQLQJDWSRUW
MDYDQHW
FODVV6RFNHWLVLQ
LPSRUWMDYDLR
LPSRUWMDYDQHW
SXEOLFFODVV'DLO\$GYLFH&OLHQW^
FRQQHFWLRQWR ZKDWHYHULV
PDNHD6RFNHW HKRVW
SXEOLFYRLGJR^ J RQ S RU W RQ KHVFDDPOKRVW·
W
QJKHUH UXQQLQ QLQJRQ7KH¶OR
WU\^ DORWFDQJRZUR WKLVFRGHLVUXQ
6RFNHWV QHZ6RFNHW³´
,QSXW6WUHDP5HDGHUVWUHDP5HDGHU QHZ,QSXW6WUHDP5HDGHUVJHW,QSXW6WUHDP

%XIIHUHG5HDGHUUHDGHU QHZ%XIIHUHG5HDGHUVWUHDP5HDGHU FKDLQD%XIIHUHG5HDGHUWR
DQ,QSXW6WUHDP5HDGHUWR
WKHLQSXWVWUHDPIURPWKH
6RFNHW
6WULQJDGYLFH UHDGHUUHDG/LQH WKLVUHDG/LQ
W HLV(;$&
6\VWHPRXWSULQWOQ³7RGD\\RXVKRXOG³DGYLFH KHVDPHDVLI\R 7
%XIIHUHG5H XZHUHXVL/QJ<D
,QRWKHUZRUDGHUFKDLQHGWRD)
UHDGHUFORVH WKLVFORVHV$//WKHVWUHDP V F DOOD%XIIHUGVE\WKHWLPH\RX,/(
ZULWHUG HG:ULWHUPH
WK
WKHFKDUDRFHWVQ·WNQRZRUFDUHZRGKH WKH
HUVFDPHIUR UH
`FDWFK,2([FHSWLRQH[^ P
H[SULQW6WDFN7UDFH
`
`
'DLO\$GYLFH&OLHQWFOLHQW QHZ'DLO\$GYLFH&OLHQW
FOLHQWJR
`
`
\RXDUHKHUH
VRFNHWFRQQHFWLRQV
6KDUSHQ \RXU SHQFLO

4ESTYOURMEMORYOFTHESTREAMSCLASSESFORREADINGANDWRITINGFROMA
3OCKET4RYNOTTOLOOKATTHEOPPOSITEPAGE
VRXUFH
4OREADTEXTFROMA3OCKET
&OLHQW
ZULWHGUDZLQWKHFKDLQRIVWUHDPVWKHFOLHQW
XVHVWRUHDGIURPWKHVHUYHU 6HUYHU
GHVWLQDWLRQ
4OSENDTEXTTOA3OCKET
ZULWHGUDZLQWKHFKDLQRIVWUHDPVWKHFOLHQW
&OLHQW XVHVWRVHQGVRPHWKLQJWRWKHVHUYHU 6HUYHU
6KDUSHQ \RXU SHQFLO

&ILLINTHEBLANKS
7HATTWOPIECESOFINFORMATIONDOESTHECLIENTNEEDINORDERTOMAKEA
3OCKETCONNECTIONWITHASERVER
7HICH4#0PORTNUMBERSARERESERVEDFOR@WELL KNOWNSERVICESLIKE(440AND&40
425%OR&!,3%4HERANGEOFVALID4#0PORTNUMBERSCANBEREPRESENTED
BYASHORTPRIMITIVE
FKDSWHU
?ZQ\QVOI[QUXTM[MZ^MZ
3OWHATSITTAKETOWRITEASERVERAPPLICATION*USTA
COUPLEOF3OCKETS9ESACOUPLEASINTWO!3ERVER3OCKET
WHICHWAITSFORCLIENTREQUESTSWHENACLIENTMAKESA
NEW3OCKET ANDAPLAINOLD3OCKETSOCKETTOUSEFOR
COMMUNICATIONWITHTHECLIENT
+RZLW:RUNV
6HUYHUDSSOLFDWLRQPDNHVD6HUYHU6RFNHWRQDVSHFLÀFSRUW
HW
6HUYHU6RFN
Licensed by
6HUYHU6RFNHWVHUYHU6RFN QHZ6HUYHU6RFNHW
7KLVVWDUWVWKHVHUYHUDSSOLFDWLRQOLVWHQLQJ
IRUFOLHQWUHTXHVWVFRPLQJLQIRUSRUW
Eduard Simons

104038
&OLHQWPDNHVD6RFNHWFRQQHFWLRQWRWKHVHUYHUDSSOLFDWLRQ
6RFNHWVRFN QHZ6RFNHW³´
6RFNHW
6HUYHU6RFN
HW
&OLHQWNQRZVWKH,3DGGUHVVDQGSRUWQXPEHU
SXEOLVKHGRUJLYHQWRKLPE\ZKRPHYHU
FRQÀJXUHVWKHVHUYHUDSSWREHRQWKDWSRUW
6HUYHUPDNHVDQHZ6RFNHWWRFRPPXQLFDWHZLWKWKLVFOLHQW
6RFNHWVRFN VHUYHU6RFNDFFHSW

HWZDLWLQJ
7KHDFFHSWPHWKRGEORFNVMXVWVLWVWKHUHZKLOH 6HUYHU6RFQNH[WFOLHQW
LW·VZDLWLQJIRUDFOLHQW6RFNHWFRQQHFWLRQ:KHQD 6RFNHW IRUWKH
FOLHQWÀQDOO\WULHVWRFRQQHFWWKHPHWKRGUHWXUQV
DSODLQROG6RFNHWRQDGLIIHUHQWSRUWWKDWNQRZV
KRZWRFRPPXQLFDWHZLWKWKHFOLHQWLHNQRZVWKH

FOLHQW·V,3DGGUHVVDQGSRUWQXPEHU7KH6RFNHWLVRQ
DGLIIHUHQWSRUWWKDQWKH6HUYHU6RFNHWVRWKDWWKH
6RFNHW
6HUYHU6RFNHWFDQJREDFNWRZDLWLQJIRURWKHUFOLHQWV
\RXDUHKHUH
ZULWLQJDVHUYHU
,IQTa)L^QKM;MZ ^MZKWLM
4HISPROGRAMMAKESA3ERVER3OCKETANDWAITSFORCLIENTREQUESTS7HENITGETS
ACLIENTREQUESTIECLIENTSAIDNEW3OCKET FORTHISAPPLICATION THESERVER
MAKESANEW3OCKETCONNECTIONTOTHATCLIENT4HESERVERMAKESA0RINT7RITER
USINGTHE3OCKETSOUTPUTSTREAM ANDSENDSAMESSAGETOTHECLIENT
UHPHPEHUWKHDS VH6WULQJV
KHLPSRUWV ZHUHZRUG USHZU GE\
UHPHPEHUW
LPSRUWMDYDLR
1 HYHU
LPSRUWMDYDQHW WKHFRGHHGLWR WKH P LGGOH
\ KL W UHWXUQ LQ
IURPW KL V DU UD
SXEOLFFODVV'DLO\$GYLFH6HUYHU^
GDLO\DGYLFHFRPHV RID6WULQJ
6WULQJ>@DGYLFH/LVW ^³7DNHVPDOOHUELWHV´³*RIRUWKHWLJKWMHDQV1RWKH\GR127
PDNH\RXORRNIDW´³2QHZRUGLQDSSURSULDWH´³-XVWIRUWRGD\EHKRQHVW7HOO\RXU
ERVVZKDW\RX UHDOO\ WKLQN´³<RXPLJKWZDQWWRUHWKLQNWKDWKDLUFXW´`
SXEOLFYRLGJR^
6HUYHU6RFNHW
DSSOLFDWLRQ¶OLVWPHQDNHVWKLVVHUYHU
WU\^
RQSRUWR ·IRUFOLHQWUHTXHVWV
FRGHLVUXQQLQJRQQWKHPDFKLQHWKLV
HQWORRS SHUPDQ
7KHVHUYHUJRHVLQWRD UYL FLQ JFOLHQWUHTXHVWV
ZDLWLQJI RU D QG VH
ZKLOHWUXH^ WKHDFFHSWPHWKRGEORFNVMXVWVLWVWKHUHXQWLOD
UHTXHVWFRPHVLQDQGWKHQWKHPHWKRGUHWXUQVD
6RFNHWVRFN VHUYHU6RFNDFFHSW 6RFNHWRQVRPHDQRQ\PRXVSRUWIRUFRPPXQLFDWLQJ
ZLWKWKHFOLHQW
3ULQW:ULWHUZULWHU QHZ3ULQW:ULWHUVRFNJHW2XWSXW6WUHDP
6WULQJDGYLFH JHW$GYLFH
QRZZHXVHWKH6RFNHWFRQQH
ZULWHUSULQWOQDGYLFH
ZULWHUFORVH PDNHD3ULQW:ULWHUDQ FWLRQWRWKHFOLHQWWR
6\VWHPRXWSULQWOQDGYLFH GV HQG
DGYLFHPHVVDJH7KHQZHF LWSULQWOQD6WULQJ
` ZH·UH ORVHWKH6RFNHWEHFDXVH
GRQHZLWKWKLVFOLHQW
H[SULQW6WDFN7UDFH
`
`FORVHJR
SULYDWH6WULQJJHW$GYLFH^
LQWUDQGRP LQW0DWKUDQGRP DGYLFH/LVWOHQJWK
UHWXUQDGYLFH/LVW>UDQGRP@
`

'DLO\$GYLFH6HUYHUVHUYHU QHZ'DLO\$GYLFH6HUYHU
VHUYHUJR
`
`
FKDSWHU
:MDD=LHGAFLK
&OLHQWDQGVHUYHUDSSOLFDWLRQVFRPPXQLFDWHRYHUD6RFNHW
DLQ EDUEHOO
EU%UDLQ%DUEHOO FRQQHFWLRQ
$6RFNHWUHSUHVHQWVDFRQQHFWLRQEHWZHHQWZRDSSOLFDWLRQV
(OWDOESTHESERVERKNOWHOWTO
ZKLFKPD\RUPD\QRWEHUXQQLQJRQWZRGLIIHUHQWSK\VLFDO
COMMUNICATEWITHTHECLIENT PDFKLQHV
4HECLIENTKNOWSTHE)0ADDRESSANDPORT $FOLHQWPXVWNQRZWKH,3DGGUHVVRUGRPDLQQDPHDQG
NUMBEROFTHESERVERBUTHOWISTHESERVER 7&3SRUWQXPEHURIWKHVHUYHUDSSOLFDWLRQ
ABLETOMAKEA3OCKETCONNECTIONWITHTHE $7&3SRUWLVDELWXQVLJQHGQXPEHUDVVLJQHGWRD
CLIENTANDMAKEINPUTANDOUTPUTSTREAMS VSHFLILFVHUYHUDSSOLFDWLRQ7&3SRUWQXPEHUVDOORZGLIIHUHQW
FOLHQWVWRFRQQHFWWRWKHVDPHPDFKLQHEXWFRPPXQLFDWH
4HINKABOUTHOWWHENWHERETHESERVER
ZLWKGLIIHUHQWDSSOLFDWLRQVUXQQLQJRQWKDWPDFKLQH
GETSKNOWLEDGEABOUTTHECLIENT
7KHSRUWQXPEHUVIURPWKURXJKDUHUHVHUYHGIRU
¶ZHOONQRZQVHUYLFHV·LQFOXGLQJ+773)736073HWF
WKHUH DUH QR
'XPE 4XHVWLRQV $FOLHQWFRQQHFWVWRDVHUYHUE\PDNLQJD6HUYHUVRFNHW
6RFNHWV QHZ6RFNHW³´
Q: 4HEADVICESERVERCODEONTHEOPPOSITE 2QFHFRQQHFWHGDFOLHQWFDQJHWLQSXWDQGRXWSXWVWUHDPV
PAGEHASA6%29SERIOUSLIMITATIONITLOOKS
IURPWKHVRFNHW7KHVHDUHORZOHYHO¶FRQQHFWLRQ·VWUHDPV
LIKEITCANHANDLEONLYONECLIENTATATIME
VRFNJHW,QSXW6WUHDP
A: 9ESTHATSRIGHT)TCANTACCEPTAREQUEST
7RUHDGWH[WGDWDIURPWKHVHUYHUFUHDWHD%XIIHUHG5HDGHU
FKDLQHGWRDQ,QSXW6WUHDP5HDGHUZKLFKLVFKDLQHGWRWKH
+
FROMACLIENTUNTILITHASFINISHEDWITHTHE LQSXWVWUHDPIURPWKH6RFNHW
CURRENTCLIENTANDSTARTEDTHENEXTITERATIONOF I
THEINFINITELOOPWHEREITSITSATTHEACCEPT ,QSXW6WUHDP5HDGHULVD¶EULGJH·VWUHDPWKDWWDNHVLQ 6
CALLUNTILAREQUESTCOMESINATWHICHTIMEIT E\WHVDQGFRQYHUWVWKHPWRWH[WFKDUDFWHUGDWD,W·VXVHG [M
MAKESA3OCKETWITHTHENEWCLIENTANDSTARTS SULPDULO\WRDFWDVWKHPLGGOHFKDLQEHWZHHQWKHKLJKOHYHO
THEPROCESSOVERAGAIN
QV
%XIIHUHG5HDGHUDQGWKHORZOHYHO6RFNHWLQSXWVWUHDP
+
Q: ,ETMEREPHRASETHEPROBLEMHOWCAN
7RZULWHWH[WGDWDWRWKHVHUYHUFUHDWHD3ULQW:ULWHUFKDLQHG
GLUHFWO\WRWKH6RFNHW·VRXWSXWVWUHDP&DOOWKHSULQWRU
_
6
YOUMAKEASERVERTHATCANHANDLEMULTIPLE
SULQWOQPHWKRGVWRVHQG6WULQJVWRWKHVHUYHU ;
CLIENTSCONCURRENTLY4HISWOULDNEVER
WORKFORACHATSERVERFORINSTANCE 6HUYHUVXVHD6HUYHU6RFNHWWKDWZDLWVIRUFOLHQWUHTXHVWVRQ KI
DSDUWLFXODUSRUWQXPEHU KT
A: !HTHATSSIMPLEREALLY5SESEPARATE :KHQD6HUYHU6RFNHWJHWVDUHTXHVWLW¶DFFHSWV·WKHUHTXHVW +
THREADSANDGIVEEACHNEWCLIENT3OCKETTOA E\PDNLQJD6RFNHWFRQQHFWLRQZLWKWKHFOLHQW 6
NEWTHREAD7EREJUSTABOUTTOLEARNHOWTO *
DOTHAT 5

1\
\RXDUHKHUH P
[I
DVLPSOHFKDWFOLHQW
?ZQ\QVOI+PI\+TQMV\
7ELLWRITETHE#HATCLIENTAPPLICATIONINTWOSTAGES&IRSTWELL
MAKEASEND ONLYVERSIONTHATSENDSMESSAGESTOTHESERVERBUT
DOESNTGETTOREADANYOFTHEMESSAGESFROMOTHERPARTICIPANTS
ANEXCITINGANDMYSTERIOUSTWISTTOTHEWHOLECHATROOM
CONCEPT
4HENWELLGOFORTHEFULLCHATMONTYANDMAKEONETHATBOTH
SENDSANDRECEIVESCHATMESSAGES
9HUVLRQ2QHVHQGRQO\
6HQG·
JHWKHQSUHVV:¶H
7\SHDPHVVD KHVHUYHU
WRVHQGLWWRQ\WPHVVDJHV)520WKH
D
ZRQ·WJHW LVYHUVLRQVRWKHUH·V
VHUYHULQWK WH[WDUHD
QRVFUROOLQJ
&RGHRXWOLQH
SXEOLFFODVV6LPSOH&KDW&OLHQW$^

-7H[W)LHOGRXWJRLQJ
3ULQW:ULWHUZULWHU
6RFNHWVRFN
SXEOLFYRLGJR^
PDNHJXLDQGUHJLVWHUDOLVWHQHUZLWKWKHVHQGEXWWRQ
FDOOWKHVHW8S1HWZRUNLQJPHWKRG
`
SULYDWHYRLGVHW8S1HWZRUNLQJ^
PDNHD6RFNHWWKHQPDNHD3ULQW:ULWHU
DVVLJQWKH3ULQW:ULWHUWRZULWHULQVWDQFHYDULDEOH
`
SXEOLFFODVV6HQG%XWWRQ/LVWHQHULPSOHPHQWV$FWLRQ/LVWHQHU^
JHWWKHWH[WIURPWKHWH[W¿HOGDQG
VHQGLWWRWKHVHUYHUXVLQJWKHZULWHUD3ULQW:ULWHU
`
`FORVH6HQG%XWWRQ/LVWHQHULQQHUFODVV
`FORVHRXWHUFODVV
FKDSWHU
LPSRUWMDYDLR

LPSRUWMDYDQHW VWUHDPVMDYDLR
LPSRUWMDYD[VZLQJ LPSRUWVIRUWQKHHWDQGWKH*8,
LPSRUWMDYDDZW 6RFNHWMDYD
LPSRUWMDYDDZWHYHQW VWXII
SXEOLFFODVV6LPSOH&KDW&OLHQW$^

-7H[W)LHOGRXWJRLQJ
3ULQW:ULWHUZULWHU
6RFNHWVRFN
SXEOLFYRLGJR^
-)UDPHIUDPH QHZ-)UDPH³/XGLFURXVO\6LPSOH&KDW&OLHQW´
RXWJRLQJ QHZ-7H[W)LHOG
WKLQJQHZ
-%XWWRQVHQG%XWWRQ QHZ-%XWWRQ³6HQG´ EXLOGWKH*8RW,KLQR
QJ UHODWHGWR
KHUHDQGQRU,2
VHQG%XWWRQDGG$FWLRQ/LVWHQHUQHZ6HQG%XWWRQ/LVWHQHU
PDLQ3DQHODGGRXWJRLQJ QHWZRUNLQJ
PDLQ3DQHODGGVHQG%XWWRQ
VHW8S1HWZRUNLQJ
IUDPHVHW6L]H
IUDPHVHW9LVLEOHWUXH
`FORVHJR ZH·UHXVLQJORFDOKRV WVR
\RXFDQWHVWW OLH
SULYDWHYRLGVHW8S1HWZRUNLQJ^ DQGVHUYHURQRQKHHFPD QW
WU\^
FKLQH
VRFN QHZ6RFNHW³´
7KLVLVZKHUHZHPDNHWK H6RFNHW
ZULWHU QHZ3ULQW:ULWHUVRFNJHW2XWSXW6WUHDP
DQGWKH3 ULQW:U LWH U LW·V FDOOHG
6\VWHPRXWSULQWOQ³QHWZRUNLQJHVWDEOLVKHG´
IURPWKHJRPHWK RG ULJK WEHIRUH
`FDWFK,2([FHSWLRQH[^ 8,
H[SULQW6WDFN7UDFH GLVSOD\LQJWKH DS S*
`
`FORVHVHW8S1HWZRUNLQJ
WU\^
ZULWHUSULQWOQRXWJRLQJJHW7H[W 1RZZHDFWXDOO\GRWKHZULWLQJ
ZULWHUÀXVK 5HPHPEHUWKHZULWHULVFKDLQHGWR
WKHLQSXWVWUHDPIURPWKH6RFNHWVR
`FDWFK([FHSWLRQH[^ ZKHQHYHUZHGRDSULQWOQLWJRHV
H[SULQW6WDFN7UDFH RYHUWKHQHWZRUNWRWKHVHUYHU
`
RXWJRLQJVHW7H[W³´
RXWJRLQJUHTXHVW)RFXV
` ,I\RXZDQWWRWU\WKLVQRZW\SHLQ
`FORVH6HQG%XWWRQ/LVWHQHULQQHUFODVV WKH5HDG\EDNHFKDWVHUYHUFRGH
OLVWHGDWWKHHQGRIWKLVFKDSWHU
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ )LUVWVWDUWWKHVHUYHULQRQHWHUPLQDO
QHZ6LPSOH&KDW&OLHQW$JR
1H[WXVHDQRWKHUWHUPLQDOWRVWDUW
`
WKLVFOLHQW
`FORVHRXWHUFODVV
\RXDUHKHUH
LPSURYLQJWKHFKDWFOLHQW
9HUVLRQ7ZRVHQG
DQGUHFHLYH
7KH6HUYHUVHQGVDPHVVDJHWRDOO
FOLHQWSDUWLFLSDQWVDVVRRQDVWKH
PHVVDJHLVUHFHLYHGE\WKHVHUYHU
:KHQDFOLHQWVHQGVDPHVVDJHLW
GRHVQ·WDSSHDULQWKHLQFRPLQJ
PHVVDJHGLVSOD\DUHDXQWLOWKH
LQFRPLQJ VHUYHUVHQGVLWWRHYHU\RQH
PHVVDJHV
RXWJRLQJPHVVDJH
%LJ4XHVWLRQ+2:GR\RXJHWPHVVDJHVIURPWKHVHUYHU"
3HOULDBEEASYWHENYOUSETUPTHENETWORKINGMAKEANINPUTSTREAMASWELL
PROBABLYA"UFFERED2EADER 4HENREADMESSAGESUSINGREAD,INE
%LJJHU4XHVWLRQ:+(1GR\RXJHWPHVVDJHVIURPWKHVHUYHU"
4HINKABOUTTHAT7HATARETHEOPTIONS
2SWLRQ2QH3ROOWKHVHUYHUHYHU\VHFRQGV
0ROS7ELLITSDO ABLE
#ONS(OWDOESTHESERVERKNOWWHATYOUVESEENANDWHATYOUHAVENT4HESERVER
WOULDHAVETOSTORETHEMESSAGESRATHERTHANJUSTDOINGADISTRIBUTE AND FORGETEACHTIME
ITGETSONE!NDWHYSECONDS!DELAYLIKETHISAFFECTSUSABILITYBUTASYOUREDUCETHE
DELAYYOURISKHITTINGYOURSERVERNEEDLESSLY)NEFlCIENT
2SWLRQ7ZR5HDGVRPHWKLQJLQIURPWKHVHUYHUHDFKWLPHWKHXVHU
VHQGVDPHVVDJH
0ROS$O ABLEVERYEASY
#ONS3TUPID7HYCHOOSESUCHANARBITRARYTIMETOCHECKFORMESSAGES7HATIFAUSERIS
ALURKERANDDOESNTSENDANYTHING
2SWLRQ7KUHH5HDGPHVVDJHVDVVRRQDVWKH\·UHVHQWIURPWKHVHUYHU
0ROS-OSTEFlCIENTBESTUSABILITY
#ONS(OWDOYOUDOYOUDOTWOTHINGSATTHESAMETIME7HEREWOULDYOUPUTTHISCODE
9OUDNEEDALOOPSOMEWHERETHATWASALWAYSWAITINGTOREADFROMTHESERVER"UTWHERE
WOULDTHATGO/NCEYOULAUNCHTHE'5)NOTHINGHAPPENSUNTILANEVENTISlREDBYA'5)
COMPONENT
FKDSWHU
,Q-DYD\RXUHDOO\&$1
ZDONDQGFKHZJXPDW
WKHVDPHWLPH
0XOWLWKUHDGLQJLQ-DYD
*AVAHASMULTIPLETHREADINGBUILTRIGHT
INTOTHEFABRICOFTHELANGUAGE!NDITSA
SNAPTOMAKEANEWTHREADOFEXECUTION
7KUHDGW QHZ7KUHDG
<RXNQRZE\QRZWKDWZH·UH WVWDUW
JRLQJZLWKRSWLRQWKUHH 4HATSIT"YCREATINGANEW4HREADOBJECT
YOUVELAUNCHEDASEPARATETHREADOF
7EWANTSOMETHINGTORUNCONTINUOUSLY EXECUTIONWITHITSVERYOWNCALLSTACK
CHECKINGFORMESSAGESFROMTHESERVER
BUTWITHOUTINTERRUPTINGTHEUSERSABILITYTO %XCEPTFORONEPROBLEM
INTERACTWITHTHE'5)3OWHILETHEUSERIS 4HATTHREADDOESNTACTUALLYDOANYTHING
HAPPILYTYPINGNEWMESSAGESORSCROLLING SOTHETHREADhDIESvVIRTUALLYTHEINSTANT
THROUGHTHEINCOMINGMESSAGESWE ITSBORN7HENATHREADDIESITSNEW
WANTSOMETHINGBEHINDTHESCENESTOKEEP STACKDISAPPEARSAGAIN%NDOFSTORY
READINGINNEWINPUTFROMTHESERVER
3OWEREMISSINGONEKEYCOMPONENT
4HATMEANSWElNALLYNEEDANEWTHREAD THETHREADSJOB)NOTHERWORDSWENEED
!NEWSEPARATESTACK THECODETHATYOUWANTTOHAVERUNBYA
7EWANTEVERYTHINGWEDIDINTHE3END SEPARATETHREAD
/NLYVERSIONVERSIONONE TOWORKTHE -ULTIPLETHREADINGIN*AVAMEANSWE
SAMEWAYWHILEANEWPROCESSRUNSALONG HAVETOLOOKATBOTHTHETHREADANDTHEJOB
SIDETHATREADSINFORMATIONFROMTHE THATSRUNBYTHETHREAD!NDWELLALSO
SERVERANDDISPLAYSITINTHEINCOMINGTEXT HAVETOLOOKATTHE4HREADCLASSINTHE
AREA JAVALANGPACKAGE2EMEMBERJAVALANG
7ELLNOTQUITE5NLESSYOUHAVEMULTIPLE ISTHEPACKAGEYOUGETIMPORTEDFOR
PROCESSORSONYOURCOMPUTEREACHNEW FREEIMPLICITLYANDITSWHERETHECLASSES
*AVATHREADISNOTACTUALLYASEPARATE MOSTFUNDAMENTALTOTHELANGUAGELIVE
PROCESSRUNNINGONTHE/3"UTITALMOST INCLUDING3TRINGAND3YSTEM
FEELSASTHOUGHITIS
\RXDUHKHUH
WKUHDGVDQG7KUHDG
2IÎPI[U]T\QXTM\PZMIL[J]\WVTa $WKUHDGLVDVHSDUDWH
WVM<PZMILKTI[[ ¶WKUHDGRIH[HFXWLRQ·
,QRWKHUZRUGVD
7ECANTALKABOUTTHREADWITHALOWER CASE@TAND4HREAD
WITHACAPITAL@47HENYOUSEETHREADWERETALKING VHSDUDWHFDOOVWDFN
ABOUTASEPARATETHREADOFEXECUTION)NOTHERWORDS
ASEPARATECALLSTACK7HENYOUSEE4HREADTHINKOF $7KUHDGLVD-DYD
THE*AVANAMINGCONVENTION7HATIN*AVASTARTSWITHA FODVVWKDWUHSUHVHQWV
CAPITALLETTER#LASSESANDINTERFACES)NTHISCASE4HREAD
ISACLASSINTHEJAVALANGPACKAGE!4HREADOBJECT DWKUHDG
REPRESENTSATHREADOFEXECUTIONYOULLCREATEANINSTANCEOF
CLASS4HREADEACHTIMEYOUWANTTOSTARTUPANEWTHREAD 7RPDNHDWKUHDG
OFEXECUTION
PDNHD7KUHDG
WKUHDG 7KUHDG
[ED] GR0RUH 7KUHDG

\EDU JR YRLGMRLQ
YRLGVWDUW
[IRR GR6WXII
VWDWLFYRLGVOHHS
PDLQ UXQ
PDLQWKUHDG DQRWKHUWKUHDG MDYDODQJ7KUHDG

VWDUWHGE\WKHFRGH FODVV
!THREADLOWER CASE@T ISASEPARATETHREADOFEXECUTION 4HREADCAPITAL@4 ISACLASSTHAT
4HATMEANSASEPARATECALLSTACK%VERY*AVAAPPLICATION REPRESENTSATHREADOFEXECUTION
STARTSUPAMAINTHREADTHETHREADTHATPUTSTHE )THASMETHODSFORSTARTINGA
MAIN METHODONTHEBOTTOMOFTHESTACK4HE*6- THREADJOININGONETHREADWITH
ISRESPONSIBLEFORSTARTINGTHEMAINTHREADANDOTHER ANOTHERANDPUTTINGATHREADTO
THREADSASITCHOOSESINCLUDINGTHEGARBAGECOLLECTION SLEEP)THASMOREMETHODSTHESE
THREAD !SAPROGRAMMERYOUCANWRITECODETOSTART AREJUSTTHECRUCIALONESWENEED
OTHERTHREADSOFYOUROWN TOUSENOW
FKDSWHU
?PI\LWM[Q\UMIV\WPI^MUWZM\PIV
WVMKITT[\IKS'
7ITHMORETHANONECALLSTACKYOUGETTHEAPPEARANCEOFHAVING
MULTIPLETHINGSHAPPENATTHESAMETIME)NREALITYONLYATRUE
MULTIPROCESSORSYSTEMCANACTUALLYDOMORETHANONETHINGATA
TIMEBUTWITH*AVATHREADSITCANAPPEARTHATYOUREDOINGSEVERAL
THINGSSIMULTANEOUSLY)NOTHERWORDSEXECUTIONCANMOVEBACK
ANDFORTHBETWEENSTACKSSORAPIDLYTHATYOUFEELASTHOUGHALLSTACKS
AREEXECUTINGATTHESAMETIME2EMEMBER*AVAISJUSTAPROCESS
RUNNINGONYOURUNDERLYING/33OlRST*AVAITSELFHASTOBE@THE
CURRENTLYEXECUTINGPROCESSONTHE/3"UTONCE*AVAGETSITS
TURNTOEXECUTEEXACTLYWHATDOESTHE*6-RUN7HICHBYTECODES
EXECUTE7HATEVERISONTHETOPOFTHECURRENTLY RUNNINGSTACK
!NDINMILLISECONDSTHECURRENTLYEXECUTINGCODEMIGHTSWITCH
TOADIFFERENTMETHODONADIFFERENTSTACK
/NEOFTHETHINGSATHREADMUSTDOISKEEPTRACKOFWHICHSTATEMENT
OFWHICHMETHOD ISCURRENTLYEXECUTINGONTHETHREADSSTACK
)TMIGHTLOOKSOMETHINGLIKETHIS
WKHDFWLYHWKUHDG
7KH-90FDOOVWKHPDLQPHWKRG
PDLQ
PDLQWKUHDG
`
DQHZWKUHDGVWDUWV
DQGEHFRPHVWKHDFWLYH
PDLQVWDUWVDQHZWKUHDG7KHPDLQ WKUHDG
WKUHDGLVWHPSRUDULO\IUR]HQZKLOHWKHQHZ WVWDUW
WKUHDGVWDUWVUXQQLQJ
PDLQ UXQ
5XQQDEOHU QHZ0\7KUHDG-RE
PDLQWKUHDG XVHUWKUHDG$
7KUHDGW QHZ7KUHDGU \RX·OOOHDU
QZ W
WVWDUW WKLVPHDQVLQKD
'RJG QHZ'RJ DPRPHQW MXVW

HWK UHDGDJDLQ
WKHDFWLY
'RJ [JR
7KH-90VZLWFKHVEHWZHHQWKHQHZ
WKUHDGXVHUWKUHDG$DQGWKHRULJLQDO PDLQ UXQ
PDLQWKUHDGXQWLOERWKWKUHDGVFRPSOHWH
PDLQWKUHDG XVHUWKUHDG$
\RXDUHKHUH
ODXQFKLQJDWKUHDG
+RZWRODXQFKDQHZWKUHDG
0DNHD5XQQDEOHREMHFWWKHWKUHDG·VMRE
5XQQDEOHWKUHDG-RE QHZ0\5XQQDEOH
5XQQDEOHLVDQLQWHUIDFH\RX·OOOHDUQDERXWRQWKHQH[WSDJH
<RX·OOZULWHDFODVVWKDWLPSOHPHQWVWKH5XQQDEOHLQWHUIDFH
FW
XQ
5
DQGWKDWFODVVLVZKHUH\RX·OOGHÀQHWKHZRUNWKDWDWKUHDG
MH
QDEOHRE
ZLOOSHUIRUP,QRWKHUZRUGVWKHPHWKRGWKDWZLOOEHUXQ
IURPWKHWKUHDG·VQHZFDOOVWDFN
0DNHD7KUHDGREMHFWWKHZRUNHUDQG

JLYHLWD5XQQDEOHWKHMRE
7KUHDGP\7KUHDG QHZ7KUHDGWKUHDG-RE
F W
7K
3DVVWKHQHZ5XQQDEOHREMHFWWRWKH7KUHDGFRQVWUXFWRU UHDGREMH
7KLVWHOOVWKHQHZ7KUHDGREMHFWZKLFKPHWKRGWRSXWRQ
WKHERWWRPRIWKHQHZVWDFN³WKH5XQQDEOH·VUXQPHWKRG
6WDUWWKH7KUHDG
P\7KUHDGVWDUW
UXQ
1RWKLQJKDSSHQVXQWLO\RXFDOOWKH7KUHDG·V
VWDUWPHWKRG7KDW·VZKHQ\RXJRIURP
KDYLQJMXVWD7KUHDGLQVWDQFHWRKDYLQJDQHZ
W
WKUHDGRIH[HFXWLRQ:KHQWKHQHZWKUHDG 5X MHF
F W
7K Q QD
VWDUWVXSLWWDNHVWKH5XQQDEOHREMHFW·V UHDGREMH EOHRE
UXQPHWKRGDQGSXWVLWRQWKHERWWRPRI
WKHQHZWKUHDG·VVWDFN
FKDSWHU
-^MZa<PZMILVMML[IRWJ\WLW
)UM\PWL\WX]\WV\PMVM_\PZMIL[\IKS
$OO,QHHGLVDUHDOMRE
-XVWJLYHPHD5XQQDEOH 5XQQDEOHLVWRD
DQG,·OOJHWWRZRUN
7KUHDGZKDWDMRELVWR
DZRUNHU$5XQQDEOH
LVWKHMREDWKUHDGLV
Licensed by
VXSSRVHGWRUXQ
$5XQQDEOHKROGVWKH
PHWKRGWKDWJRHVRQ
Eduard Simons
WKHERWWRPRIWKHQHZ
WKUHDG·VVWDFNUXQ
104038 7KUHDG
!4HREADOBJECTNEEDSAJOB!JOBTHETHREADWILLRUNWHENTHE
THREADISSTARTED4HATJOBISACTUALLYTHElRSTMETHODTHATGOESON
H G H I LQH V RQO\RQH DQ
THENEWTHREADSSTACKANDITMUSTALWAYSBEAMETHODTHATLOOKS
5 X Q Q D E OH LQWHUIDF 5HPHPEHULW·VOHVV
LIKETHIS 7KH UXQ
XEOLFYRLG JDUG
SXEOLFUH
SXEOLFYRLGUXQ^ PHWKRGS VRWKHPHWKRGLV KDWZD\
FRGHWKDWZLOOEHUXQE\WKHQHZWKUHDG
LQWHUIDFH HU\RXW\SHLWLQW
RIZKHWK
`
(OWDOESTHETHREADKNOWWHICHMETHODTOPUTATTHEBOTTOMOF
THESTACK"ECAUSE2UNNABLEDElNESACONTRACT"ECAUSE2UNNABLE
ISANINTERFACE!THREADSJOBCANBEDElNEDINANYCLASSTHAT
IMPLEMENTSTHE2UNNABLEINTERFACE4HETHREADCARESONLYTHATYOU
PASSTHE4HREADCONSTRUCTORANOBJECTOFACLASSTHATIMPLEMENTS
2UNNABLE
7HENYOUPASSA2UNNABLETOA4HREADCONSTRUCTORYOUREREALLY
JUSTGIVINGTHE4HREADAWAYTOGETTOARUN METHOD9OUREGIVING
THE4HREADITSJOBTODO
\RXDUHKHUH
5XQQDEOHLQWHUIDFH
<WUISMIRWJNWZaW]Z\PZMIL
QUXTMUMV\\PM:]VVIJTMQV\MZNIKM SDFNDJH
LQWKHMDYDLPODSRQJUWLW
5XQQDEOHLV·W GWR
VR\RXGRQ QHH
SXEOLFFODVV0\5XQQDEOHLPSOHPHQWV5XQQDEOH^
SXEOLFYRLGUXQ^
JR 5XQQDEOHKDVRQO\RQHPHWKRGWR
` LPSOHPHQWSXEOLFYRLGUXQZ LWKQR
DUJXPHQWV7KLVLVZKHUH\RXS XWWKH
SXEOLFYRLGJR^ -2%WKHWKUHDGLVVXSSRVHGWRUXQ 7KLV
GR0RUH LVWKHPHWKRGWKDWJRHVDWWKHERWW
` RIWKHQHZVWDFN RP
SXEOLFYRLGGR0RUH^
6\VWHPRXWSULQWOQ³WRSR¶WKHVWDFN´
`
`
QHZ
FODVV7KUHDG7HVWHU^ EOHLQVWDQFHLQWRWKH
3DVVWKHQHZ5XFXQWRQDU7KLVWHOOVWKHWKUHDG Z
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ 7KUHDGFRQVWUWRSXWRQWKHERWWRPRIWKHQH
ZKDWPHWKRG ZRUGVWKHILUVWPHWKRGWKDW
5XQQDEOHWKUHDG-RE QHZ0\5XQQDEOH VWDFN,QRWKHU ZLOOUXQ
7KUHDGP\7KUHDG QHZ7KUHDGWKUHDG-RE WKHQHZWKUHDG

P\7KUHDGVWDUW
<RXZRQ·WJHWDQHZWKUHD
6\VWHPRXWSULQWOQ³EDFNLQPDLQ´ FDOOVWDUWRQWKH7KUHDGGRIH[HFXWLRQXQWLO\RX
` QRWUHDOO\DWKUHDGXQWLO\RLQVWDQFH$WKUHDGLV
XVWDUWLW% RUHWKDW
` LW·VMXVWD7KUHDGLQV WDQFHOLNHDQ\RWKHHI
EXWLWZRQ·WKDYHDQ\U HDO¶WKUHDGQHVV· UREMHFW

DLQ EDUEHOO
EU%UDLQ%DUEHOO

GR0RUH
P\7KUHDGVWDUW
JR
:KDWGR\RXWKLQNWKHRXWSXWZLOOEHLI\RXUXQWKH
PDLQ
UXQ 7KUHDG7HVWHUFODVV"ZH¶OO¿QGRXWLQDIHZSDJHV
PDLQWKUHDG QHZWKUHDG
FKDSWHU
7KHWKUHHVWDWHVRIDQHZWKUHDG KUHDG
WKLVLVZKHUHDW
ZDQWVWREH
7KUHDGW QHZ7KUHDGU
1(: 5811$%/( 5811,1*
WVWDUW 6HOHFWHGWRUXQ
´&DQ,
VXSHUVL]H
´,·PZDLWLQJWR ´,·PJRRGWRJR µ WKDWIRU
JHWVWDUWHGµ \RX"µ
7KUHDGW QHZ7KUHDGU WVWDUW 4HISISTHESTATEALLTHREADSLUST

!4HREADINSTANCEHASBEEN 7HENYOUSTARTTHETHREADIT AFTER4OBE4HE#HOSEN/NE
CREATEDBUTNOTSTARTED MOVESINTOTHERUNNABLESTATE 4HE#URRENTLY2UNNING4HREAD
)NOTHERWORDSTHEREISA 4HISMEANSTHETHREADISREADY /NLYTHE*6-THREADSCHEDULER
4HREADOBJECTBUTNOTHREAD TORUNANDJUSTWAITINGFORITS CANMAKETHATDECISION9OU
OFEXECUTION "IG#HANCETOBESELECTEDFOR CANSOMETIMESINmUENCETHAT
EXECUTION!TTHISPOINTTHEREIS DECISIONBUTYOUCANNOTFORCEA
ANEWCALLSTACKFORTHISTHREAD THREADTOMOVEFROMRUNNABLE
TORUNNING)NTHERUNNING
STATEATHREADAND/.,9THIS
THREAD HASANACTIVECALLSTACK
ANDTHEMETHODONTHETOPOF
THESTACKISEXECUTING
%XWWKHUH·VPRUH2QFHWKHWKUHDGEHFRPHV
UXQQDEOHLWFDQPRYHEDFNDQGIRUWKEHWZHHQ
UXQQDEOHUXQQLQJDQGDQDGGLWLRQDOVWDWH
WHPSRUDULO\QRWUXQQDEOHDOVRNQRZQDV¶EORFNHG·
\RXDUHKHUH
WKUHDGVWDWHV
7\SLFDOUXQQDEOHUXQQLQJORRS
5811$%/( 5811,1*
4YPICALLYATHREADMOVESBACKAND
6HOHFWHGWRUXQ
FORTHBETWEENRUNNABLEANDRUNNING
ASTHE*6-THREADSCHEDULERSELECTSA
THREADTORUNANDTHENKICKSITBACK
OUTSOANOTHERTHREADGETSACHANCE
6HQWEDFNWRUXQQDEOH
VRDQRWKHUWKUHDGFDQ
KDYHDFKDQFH
$WKUHDGFDQEHPDGH
WHPSRUDULO\QRWUXQQDEOH
4HETHREADSCHEDULERCANMOVEA 5811$%/( 5811,1*
RUNNINGTHREADINTOABLOCKEDSTATE
FORAVARIETYOFREASONS&OREXAMPLE
THETHREADMIGHTBEEXECUTINGCODE
TOREADFROMA3OCKETINPUTSTREAM
BUTTHEREISNTANYDATATOREAD4HE
SCHEDULERWILLMOVETHETHREADOUT
OFTHERUNNINGSTATEUNTILSOMETHING
BECOMESAVAILABLE/RTHEEXECUTING
CODEMIGHTHAVETOLDTHETHREADTO
PUTITSELFTOSLEEPSLEEP /RTHE
THREADMIGHTBEWAITINGBECAUSEIT \
DU
TRIEDTOCALLAMETHODONANOBJECT S RU H
%/2&.(' P DW H
WH VW
ANDTHATOBJECTWAS@LOCKED)NTHAT RD EOH FRP
W D H
CASETHETHREADCANTCONTINUEUNTIL QW QQ QE Q
6H QUX WFD JDL
THEOBJECTSLOCKISFREEDBYTHETHREAD QR WLOL OHD
THATHASIT XQ QQDE
UX
!LLOFTHOSECONDITIONSANDMORE
CAUSEATHREADTOBECOMETEMPORARILY
NOT RUNNABLE VOHHSLQJZDLWLQJIRUDQRWKHUWKUHDGWRILQLVK
ZDLWLQJIRUGDWDWREHDYDLODEOHRQWKHVWUHDP
ZDLWLQJIRUDQREMHFW·VORFN
FKDSWHU
<PM<PZMIL;KPML]TMZ
4HETHREADSCHEDULERMAKESALLTHEDECISIONSABOUT
WHOMOVESFROMRUNNABLETORUNNINGANDABOUTWHEN
ANDUNDERWHATCIRCUMSTANCES ATHREADLEAVESTHE
RUNNINGSTATE4HESCHEDULERDECIDESWHORUNSANDFOR
HOWLONGANDWHERETHETHREADSGOWHENTHESCHEDULER
DECIDESTOKICKTHEMOUTOFTHECURRENTLY RUNNINGSTATE
1XPEHUIRXU\RX·YHKDG
9OUCANTCONTROLTHESCHEDULER4HEREISNO!0)FOR
CALLINGMETHODSONTHESCHEDULER-OSTIMPORTANTLY HQRXJKWLPH%DFNWRUXQQDEOH
THEREARENOGUARANTEESABOUTSCHEDULING4HEREAREA 1XPEHUWZRORRNVOLNH\RX·UHXS
FEWALMOST GUARANTEESBUTEVENTHOSEAREALITTLEFUZZY
2KQRZLWORRNVOLNH\RX·UHJRQQDKDYH
4HEBOTTOMLINEISTHISDONOTBASEYOURPROGRAMS WRVOHHS1XPEHUÀYHFRPHWDNHKLV
CORRECTNESSONTHESCHEDULERWORKINGINAPARTICULARWAY
SODFH1XPEHUWZR\RX·UHVWLOO
4HESCHEDULERIMPLEMENTATIONSAREDIFFERENTFOR
VOHHSLQJ
DIFFERENT*6-SANDEVENRUNNINGTHESAMEPROGRAM
ONTHESAMEMACHINECANGIVEYOUDIFFERENTRESULTS
/NEOFTHEWORSTMISTAKESNEW*AVAPROGRAMMERS
MAKEISTOTESTTHEIRMULTI THREADEDPROGRAMONA
SINGLEMACHINEANDASSUMETHETHREADSCHEDULERWILL
ALWAYSWORKTHATWAYREGARDLESSOFWHERETHEPROGRAM
RUNS
3OWHATDOESTHISMEANFORWRITE ONCE RUN ANYWHERE
)TMEANSTHATTOWRITEPLATFORM INDEPENDENT*AVACODE 7KHWKUHDG
YOURMULTI THREADEDPROGRAMMUSTWORKNOMATTERHOW VFKHGXOHUPDNHVDOO
THETHREADSCHEDULERBEHAVES4HATMEANSTHATYOUCANT
BEDEPENDENTONFOREXAMPLETHESCHEDULERMAKING WKHGHFLVLRQVDERXW
SUREALLTHETHREADSTAKENICEPERFECTLYFAIRANDEQUAL
TURNSATTHERUNNINGSTATE!LTHOUGHHIGHLYUNLIKELY
ZKRUXQVDQGZKR
TODAYYOURPROGRAMMIGHTENDUPRUNNINGONA*6- GRHVQ·W+HXVXDOO\
WITHASCHEDULERTHATSAYSh/+THREADlVEYOUREUP
ANDASFARAS)MCONCERNEDYOUCANSTAYHEREUNTIL PDNHVWKHWKUHDGVWDNH
YOUREDONEWHENYOURRUN METHODCOMPLETESv WXUQVQLFHO\%XW
4HESECRETTOALMOSTEVERYTHINGISSLEEP4HATS
RIGHTSLEEP0UTTINGATHREADTOSLEEPEVENFORAFEW
WKHUH·VQRJXDUDQWHH
MILLISECONDSFORCESTHECURRENTLY RUNNINGTHREADTO DERXWWKDW+HPLJKW
LEAVETHERUNNINGSTATETHUSGIVINGANOTHERTHREADA
CHANCETORUN4HETHREADSSLEEP METHODDOESCOME OHWRQHWKUHDGUXQ
WITHONEGUARANTEEASLEEPINGTHREADWILLNOTBECOME WRLWVKHDUW·VFRQWHQW
THECURRENTLY RUNNINGTHREADBEFORETHETHELENGTHOF
ITSSLEEPTIMEHASEXPIRED&OREXAMPLEIFYOUTELLYOUR ZKLOHWKHRWKHU
THREADTOSLEEPFORTWOSECONDSMILLISECONDS
THATTHREADCANNEVERBECOMETHERUNNINGTHREADAGAIN
WKUHDGV¶VWDUYH·
UNTILSOMETIMEAFTERTHETWOSECONDSHAVEPASSED
\RXDUHKHUH
WKUHDGVFKHGXOLQJ
$QH[DPSOHRIKRZXQSUHGLFWDEOHWKH
VFKHGXOHUFDQEH
5XQQLQJWKLVFRGHRQRQHPDFKLQH 3URGXFHGWKLVRXWSXW
SXEOLFFODVV0\5XQQDEOHLPSOHPHQWV5XQQDEOH^ )LOH(GLW:LQGRZ+HOS3LFN0H
MDYD7KUHDG7HVW'ULYH
SXEOLFYRLGUXQ^
JR EDFNLQPDLQ
`
WRSR¶WKHVWDFN
SXEOLFYRLGJR^ MDYD7KUHDG7HVW'ULYH
GR0RUH
WRSR¶WKHVWDFN
`
EDFNLQPDLQ
SXEOLFYRLGGR0RUH^
MDYD7KUHDG7HVW'ULYH
` WRSR¶WKHVWDFN
`
EDFNLQPDLQ
MDYD7KUHDG7HVW'ULYH
FODVV7KUHDG7HVW'ULYH^ WRSR¶WKHVWDFN
EDFNLQPDLQ
MDYD7KUHDG7HVW'ULYH
5XQQDEOHWKUHDG-RE QHZ0\5XQQDEOH
WRSR¶WKHVWDFN
7KUHDGP\7KUHDG QHZ7KUHDGWKUHDG-RE
EDFNLQPDLQ
P\7KUHDGVWDUW
MDYD7KUHDG7HVW'ULYH
6\VWHPRXWSULQWOQ³EDFNLQPDLQ´ WRSR¶WKHVWDFN
`
EDFNLQPDLQ
`
RUGHUFKDQJ HV
1RW LF H K R Z W K H
LP QH
HVWKH WZ WKUHDG MDYD7KUHDG7HVW'ULYH
P HW DLQ
UDQGRP LUVWDQGVRPHWLPHV KHP
O\ 6 R EDFNLQPDLQ
ILQ LV KHV I
HVILUVW
WKUHDGILQLVK WRSR¶WKHVWDFN
FKDSWHU
+RZGLGZHHQGXSZLWKGLIIHUHQWUHVXOWV"
6RPHWLPHVLWUXQVOLNHWKLV
PDLQVWDUWVWKH 7KHVFKHGXOHUVHQGV 7KHVFKHGXOHUOHWV 7KHQHZWKUHDGJRHV

QHZWKUHDG WKHPDLQWKUHDGRXW WKHQHZWKUHDG DZD\EHFDXVHLWVUXQ
RIUXQQLQJDQGEDFN UXQWRFRPSOHWLRQ FRPSOHWHG7KHPDLQ
WRUXQQDEOHVRWKDW SULQWLQJRXW´WRSR· WKUHDGRQFHDJDLQ
WKHQHZWKUHDGFDQ WKHVWDFNµ EHFRPHVWKHUXQQLQJ
UXQ WKUHDGDQGSULQWVÉDFN
GR0RUH
LQPDLQµ
P\7KUHDGVWDUW P\7KUHDGVWDUW JR
PDLQ PDLQ UXQ PDLQ
PDLQWKUHDG PDLQWKUHDG QHZWKUHDG PDLQWKUHDG
WLPH
$QGVRPHWLPHVLWUXQVOLNHWKLV
PDLQVWDUWVWKH 7KHVFKHGXOHUVHQGV 7KHVFKHGXOHUOHWVWKH 7KHVFKHGXOHU 7KHVFKHGXOHU 7KHQHZWKUHDGUHWXUQV

QHZWKUHDG WKHPDLQWKUHDGRXW QHZWKUHDGUXQIRUD VHQGVWKHQHZ VHOHFWVWKHPDLQ WRWKHUXQQLQJVWDWH
RIUXQQLQJDQGEDFN OLWWOHZKLOHQRWORQJ WKUHDGEDFNWR WKUHDGWREHWKH DQGSULQWVRXW´WRSR·
WRUXQQDEOHVRWKDW HQRXJKIRUWKHUXQ UXQQDEOH UXQQLQJWKUHDG WKHVWDFNµ
WKHQHZWKUHDGFDQ PHWKRGWRFRPSOHWH DJDLQ0DLQSULQWV
UXQ RXWÉDFNLQPDLQµ GR0RUH
P\7KUHDGVWDUW
P\7KUHDGVWDUW JR JR JR
PDLQ PDLQ UXQ UXQ PDLQ UXQ
PDLQWKUHDG PDLQWKUHDG QHZWKUHDG QHZWKUHDG PDLQWKUHDG QHZWKUHDG
WLPH
\RXDUHKHUH
VRFNHWFRQQHFWLRQV
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: )VESEENEXAMPLESTHATDONTUSEASEPARATE :MDD=LHGAFLK
2UNNABLEIMPLEMENTATIONBUTINSTEADJUSTMAKEA
SUBCLASSOF4HREADANDOVERRIDETHE4HREADSRUN $WKUHDGZLWKDORZHUFDVH¶W·LVDVHSDUDWHWKUHDGRI
METHOD4HATWAYYOUCALLTHE4HREADSNO ARG H[HFXWLRQLQ-DYD
CONSTRUCTORWHENYOUMAKETHENEWTHREAD
4HREADTNEW4HREAD NO2UNNABLE (YHU\WKUHDGLQ-DYDKDVLWVRZQFDOOVWDFN
$7KUHDGZLWKDFDSLWDO¶7·LVWKHMDYDODQJ7KUHDG
A: 9ESTHATISANOTHERWAYOFMAKINGYOUROWN
FODVV$7KUHDGREMHFWUHSUHVHQWVDWKUHDGRI
H[HFXWLRQ
THREADBUTTHINKABOUTITFROMAN//PERSPECTIVE
7HATSTHEPURPOSEOFSUBCLASSING2EMEMBERTHAT $7KUHDGQHHGVDMREWRGR$7KUHDG·VMRELVDQ
WERETALKINGABOUTTWODIFFERENTTHINGSHERETHE LQVWDQFHRIVRPHWKLQJWKDWLPSOHPHQWVWKH5XQQDEOH
4HREADANDTHETHREADSJOB&ROMAN//VIEWTHOSE
LQWHUIDFH
TWOAREVERYSEPARATEACTIVITIESANDBELONGINSEPARATE
CLASSES4HEONLYTIMEYOUWANTTOSUBCLASSEXTEND 7KH5XQQDEOHLQWHUIDFHKDVMXVWDVLQJOHPHWKRGUXQ
THE4HREADCLASSISIFYOUAREMAKINGANEWANDMORE 7KLVLVWKHPHWKRGWKDWJRHVRQWKHERWWRPRIWKHQHZ
SPECIFICTYPEOF4HREAD)NOTHERWORDSIFYOUTHINKOF
FDOOVWDFN,QRWKHUZRUGVLWLVWKHILUVWPHWKRGWRUXQLQ
THE4HREADASTHEWORKERDONTEXTENDTHE4HREADCLASS
WKHQHZWKUHDG
UNLESSYOUNEEDMORESPECIFICWORKERBEHAVIORS"UTIF
ALLYOUNEEDISANEWJOBTOBERUNBYA4HREADWORKER 7RODXQFKDQHZWKUHDG\RXQHHGD5XQQDEOHWRSDVV
THENIMPLEMENT2UNNABLEINASEPARATEJOB SPECIFIC WRWKH7KUHDG·VFRQVWUXFWRU
NOTWORKER SPECIFIC CLASS
4HISISADESIGNISSUEANDNOTAPERFORMANCEOR $WKUHDGLVLQWKH1(:VWDWHZKHQ\RXKDYH
LANGUAGEISSUE)TSPERFECTLYLEGALTOSUBCLASS4HREAD LQVWDQWLDWHGD7KUHDGREMHFWEXWKDYHQRW\HWFDOOHG
ANDOVERRIDETHERUN METHODBUTITSRARELYAGOOD VWDUW
IDEA
:KHQ\RXVWDUWDWKUHDGE\FDOOLQJWKH7KUHDGREMHFW·V
Q: #ANYOUREUSEA4HREADOBJECT#ANYOUGIVEIT
VWDUWPHWKRGDQHZVWDFNLVFUHDWHGZLWKWKH
5XQQDEOH·VUXQPHWKRGRQWKHERWWRPRIWKHVWDFN
ANEWJOBTODOANDTHENRESTARTITBYCALLINGSTART 7KHWKUHDGLVQRZLQWKH5811$%/(VWDWHZDLWLQJWR
AGAIN EHFKRVHQWRUXQ
$WKUHDGLVVDLGWREH5811,1*ZKHQWKH-90·V
A: .O/NCEATHREADSRUN METHODHASCOMPLETED WKUHDGVFKHGXOHUKDVVHOHFWHGLWWREHWKHFXUUHQWO\
THETHREADCANNEVERBERESTARTED)NFACTATTHAT UXQQLQJWKUHDG2QDVLQJOHSURFHVVRUPDFKLQHWKHUH
POINTTHETHREADMOVESINTOASTATEWEHAVENTTALKED FDQEHRQO\RQHFXUUHQWO\UXQQLQJWKUHDG
ABOUTDEAD)NTHEDEADSTATETHETHREADHAS
FINISHEDITSRUN METHODANDCANNEVERBERESTARTED 6RPHWLPHVDWKUHDGFDQEHPRYHGIURPWKH5811,1*
4HE4HREADOBJECTMIGHTSTILLBEONTHEHEAPASA VWDWHWRD%/2&.('WHPSRUDULO\QRQUXQQDEOHVWDWH
LIVINGOBJECTTHATYOUCANCALLOTHERMETHODSONIF $WKUHDGPLJKWEHEORFNHGEHFDXVHLW·VZDLWLQJIRUGDWD
APPROPRIATE BUTTHE4HREADOBJECTHASPERMANENTLY IURPDVWUHDPRUEHFDXVHLWKDVJRQHWRVOHHSRU
LOSTITS@THREADNESS)NOTHERWORDSTHEREISNOLONGERA
EHFDXVHLWLVZDLWLQJIRUDQREMHFW·VORFN
SEPARATECALLSTACKANDTHE4HREADOBJECTISNOLONGER
ATHREAD)TSJUSTANOBJECTATTHATPOINTLIKEALLOTHER 7KUHDGVFKHGXOLQJLVQRWJXDUDQWHHGWRZRUNLQDQ\
OBJECTS SDUWLFXODUZD\VR\RXFDQQRWEHFHUWDLQWKDWWKUHDGV
"UTTHEREAREDESIGNPATTERNSFORMAKINGAPOOLOF ZLOOWDNHWXUQVQLFHO\<RXFDQKHOSLQIOXHQFHWXUQWDNLQJ
THREADSTHATYOUCANKEEPUSINGTOPERFORMDIFFERENT E\SXWWLQJ\RXUWKUHDGVWRVOHHSSHULRGLFDOO\
JOBS"UTYOUDONTDOITBYRESTARTING ADEADTHREAD
FKDSWHU
8]\\QVOI\PZMIL\W[TMMX
/NEOFTHEBESTWAYSTOHELPYOURTHREADSTAKETURNSIS
TOPUTTHEMTOSLEEPPERIODICALLY!LLYOUNEEDTODO
ISCALLTHESTATICSLEEP METHODPASSINGITTHESLEEP
DURATIONINMILLISECONDS
3XW\RXUWKUHDGWRVOHHS
&OREXAMPLE
7KUHDGVOHHS
LI\RXZDQWWREHVXUH
WILLKNOCKATHREADOUTOFTHERUNNINGSTATEAND WKDWRWKHUWKUHDGVJHWD
KEEPITOUTOFTHERUNNABLESTATEFORTWOSECONDS
4HETHREADCANTBECOMETHERUNNINGTHREAD
FKDQFHWRUXQ
AGAINUNTILAFTERATLEASTTWOSECONDSHAVEPASSED
:KHQWKHWKUHDGZDNHV
!BITUNFORTUNATELYTHESLEEPMETHODTHROWSAN
)NTERRUPTED%XCEPTIONACHECKEDEXCEPTIONSOALL XSLWDOZD\VJRHVEDFN
CALLSTOSLEEPMUSTBEWRAPPEDINATRYCATCHOR
DECLARED 3OASLEEPCALLREALLYLOOKSLIKETHIS
WRWKHUXQQDEOHVWDWH
WU\^ DQGZDLWVIRUWKHWKUHDG
7KUHDGVOHHS
`FDWFK,QWHUUXSWHG([FHSWLRQH[^
VFKHGXOHUWRFKRRVHLW
H[SULQW6WDFN7UDFH
`
WRUXQDJDLQ
9OURTHREADWILLPROBABLYNEVERBEINTERRUPTEDFROM
SLEEPTHEEXCEPTIONISINTHE!0)TOSUPPORTATHREAD
COMMUNICATIONMECHANISMTHATALMOSTNOBODYUSESIN
THE2EAL7ORLD"UTYOUSTILLHAVETOOBEYTHEHANDLE
ORDECLARELAWSOYOUNEEDTOGETUSEDTOWRAPPINGYOUR
SLEEP CALLSINATRYCATCH
.OWYOUKNOWTHATYOURTHREADWONTWAKEUPBEFORETHE
SPECIlEDDURATIONBUTISITPOSSIBLETHATITWILLWAKEUP
SOMETIMEAFTERTHE@TIMERHASEXPIRED9ESANDNO)T
DOESNTMATTERREALLYBECAUSEWHENTHETHREADWAKES
UPITALWAYSGOESBACKTOTHERUNNABLESTATE4HETHREAD
WONTAUTOMATICALLYWAKEUPATTHEDESIGNATEDTIMEAND
BECOMETHECURRENTLY RUNNINGTHREAD7HENATHREAD
WAKESUPTHETHREADISONCEAGAINATTHEMERCYOF
THETHREADSCHEDULER.OWFORAPPLICATIONSTHATDONT
REQUIREPERFECTTIMINGANDTHATHAVEONLYAFEWTHREADS
ITMIGHTAPPEARASTHOUGHTHETHREADWAKESUPAND
RESUMESRUNNINGRIGHTONSCHEDULESAYAFTERTHE
MILLISECONDS "UTDONTBETYOURPROGRAMONIT
\RXDUHKHUH
XVLQJ7KUHDGVOHHS
=[QVO[TMMX\WUISMW]ZXZWOZIU 7KLVLVZKDWZHZDQW³DFRQVLVWHQWRUGHU
RISULQWVWDWHPHQWV
UWZMXZMLQK\IJTM )LOH(GLW:LQGRZ+HOS6QRR]H%XWWRQ
MDYD7KUHDG7HVW'ULYH
2EMEMBEROUREARLIEREXAMPLETHATKEPTGIVINGUSDIFFERENT
RESULTSEACHTIMEWERANIT,OOKBACKANDSTUDYTHECODE EDFNLQPDLQ
ANDTHESAMPLEOUTPUT3OMETIMESMAINHADTOWAITUNTILTHE WRSR¶WKHVWDFN
NEWTHREADlNISHEDANDPRINTEDhTOPOTHESTACKv WHILE MDYD7KUHDG7HVW'ULYH
OTHERTIMESTHENEWTHREADWOULDBESENTBACKTORUNNABLE
BEFOREITWASlNISHEDALLOWINGTHEMAINTHREADTOCOMEBACK EDFNLQPDLQ
INANDPRINTOUThBACKINMAINv(OWCANWElXTHAT3TOP WRSR¶WKHVWDFN
FORAMOMENTANDANSWERTHISQUESTIONh7HERECANYOUPUT
MDYD7KUHDG7HVW'ULYH
ASLEEP CALLTOMAKESURETHAThBACKINMAINvALWAYSPRINTS
BEFOREhTOPOTHESTACKv EDFNLQPDLQ
7ELLWAITWHILEYOUWORKOUTANANSWERTHERESMORETHAN WRSR¶WKHVWDFN
ONEANSWERTHATWOULDWORK MDYD7KUHDG7HVW'ULYH
&IGUREITOUT EDFNLQPDLQ
WRSR¶WKHVWDFN
SXEOLFFODVV0\5XQQDEOHLPSOHPHQWV5XQQDEOH^ MDYD7KUHDG7HVW'ULYH
EDFNLQPDLQ
SXEOLFYRLGUXQ^
JR WRSR¶WKHVWDFN
`
K HU FHWKHQHZLQ J
HZLOOIRUHQ
S QQ
HFXUU WO\UX
SXEOLFYRLGJR^ VO HH
&D OO LQ J W K
W R OHD YH
WU\^ WKUHDG
VWDWH HWKH
DGZLOOEHFGRPDJDLQDQGSULQW
7KUHDGVOHHS
K H P D LQ W K UH
LQJWKUHD
`FDWFK,QWHUUXSWHG([FHSWLRQH[^ 7
H[SULQW6WDFN7UDFH FXUUHQWO\LUXQQQPDLQµ7KHQWKHUHZHI LOOEHD
HZH
` RXWÉDFN DERXWWZRVHFRQGVE RURU H DQG
I RU
SDXVH LVOLQHZKLFKFDOOV G R0
GR0RUH JHWWRWK ´WRSR·WKHVWDFNµ
` SULQWVRXW
SXEOLFYRLGGR0RUH^
`
`
FODVV7KUHDG7HVW'ULYH^
5XQQDEOHWKH-RE QHZ0\5XQQDEOH
7KUHDGW QHZ7KUHDGWKH-RE
WVWDUW
6\VWHPRXWSULQWOQ³EDFNLQPDLQ´
`
`
FKDSWHU
5ISQVOIVL[\IZ\QVO\ _W\PZMIL[
4HREADSHAVENAMES9OUCANGIVEYOURTHREADSANAMEOF
YOURCHOOSINGORYOUCANACCEPTTHEIRDEFAULTNAMES"UTTHE
COOLTHINGABOUTNAMESISTHATYOUCANUSETHEMTOTELLWHICH
THREADISRUNNING4HEFOLLOWINGEXAMPLESTARTSTWOTHREADS
%ACHTHREADHASTHESAMEJOBRUNINALOOPPRINTINGTHE
CURRENTLY RUNNINGTHREADSNAMEWITHEACHITERATION
SXEOLFFODVV5XQ7KUHDGVLPSOHPHQWV5XQQDEOH^
H
QQD EOHLQVWDQF
0 DNHRQH5X
5XQ7KUHDGVUXQQHU QHZ5XQ7KUHDGV
7KUHDGDOSKD QHZ7KUHDGUXQQHU
0DNHWZRWKUHDGVZLWKWKHVDPH5XQQDEOHWKH
Licensed by
7KUHDGEHWD QHZ7KUHDGUXQQHU
DOSKDVHW1DPH³$OSKDWKUHDG´
VDPHMREZH·OOWDONPRUHDERXWWKH´WZRWKUHDGV
EHWDVHW1DPH³%HWDWKUHDG´
DQG RQH5XQQDEOHµLQDIHZSDJHV
DOSKDVWDUW 1DPHWKHWKUHDG
V
EHWDVWDUW 6WDUWWKHWKUHDGV
Eduard Simons
`
RS
DF K WK UH DG Z LOO U XQWKURXJKWKLVOR
( HDFKWLPH
SULQWLQJLWVQDPH
SXEOLFYRLGUXQ^
IRULQWL LL^
6WULQJWKUHDG1DPH 7KUHDGFXUUHQW7KUHDGJHW1DPH
104038
6\VWHPRXWSULQWOQWKUHDG1DPH³LVUXQQLQJ´
`
`
` )LOH(GLW:LQGRZ+HOS&HQWDXUL
3DUWRIWKHRXWSXWZKHQ $OSKDWKUHDGLVUXQQLQJ
WKHORRSLWHUDWHV $OSKDWKUHDGLVUXQQLQJ
?PI\_QTTPIXXMV' WLPHV $OSKDWKUHDGLVUXQQLQJ
%HWDWKUHDGLVUXQQLQJ
7ILLTHETHREADSTAKETURNS7ILLYOUSEETHETHREADNAMES $OSKDWKUHDGLVUXQQLQJ
ALTERNATING(OWOFTENWILLTHEYSWITCH7ITHEACHITERATION %HWDWKUHDGLVUXQQLQJ
!FTERlVEITERATIONS %HWDWKUHDGLVUXQQLQJ
%HWDWKUHDGLVUXQQLQJ
9OUALREADYKNOWTHEANSWERWEDONTKNOW)TSUPTOTHE
%HWDWKUHDGLVUXQQLQJ
SCHEDULER!NDONYOUR/3WITHYOURPARTICULAR*6-ON
%HWDWKUHDGLVUXQQLQJ
YOUR#05YOUMIGHTGETVERYDIFFERENTRESULTS
%HWDWKUHDGLVUXQQLQJ
2UNNINGUNDER/38*AGUAR WITHlVEORFEWER %HWDWKUHDGLVUXQQLQJ
ITERATIONSTHE!LPHATHREADRUNSTOCOMPLETIONTHEN %HWDWKUHDGLVUXQQLQJ
THE"ETATHREADRUNSTOCOMPLETION6ERYCONSISTENT.OT %HWDWKUHDGLVUXQQLQJ
GUARANTEEDBUTVERYCONSISTENT %HWDWKUHDGLVUXQQLQJ
"UTWHENYOUUPTHELOOPTOORMOREITERATIONSTHINGS %HWDWKUHDGLVUXQQLQJ
STARTTOWOBBLE4HE!LPHATHREADMIGHTNOTGETTOCOMPLETE %HWDWKUHDGLVUXQQLQJ
ALLITERATIONSBEFORETHESCHEDULERSENDSITBACKTO %HWDWKUHDGLVUXQQLQJ
RUNNABLETOLETTHE"ETATHREADHAVEACHANCE %HWDWKUHDGLVUXQQLQJ
$OSKDWKUHDGLVUXQQLQJ
\RXDUHKHUH
DUHQ·WWKUHDGVZRQGHUIXO"
:RZ7KUHDGVDUH
WKHJUHDWHVWWKLQJVLQFHWKH
0,1,&RRSHU,FDQ·WWKLQN
RIDVLQJOHGRZQVLGHWRXVLQJ
WKUHDGVFDQ\RX"
=UaM[<PMZM1;ILIZS[QLM
<PZMIL[KIVTMIL\WKWVK]ZZMVKa»Q[[]M[¼
#ONCURRENCYISSUESLEADTORACECONDITIONS2ACECONDITIONS
LEADTODATACORRUPTION$ATACORRUPTIONLEADSTOFEARYOU
KNOWTHEREST
)TALLCOMESDOWNTOONEPOTENTIALLYDEADLYSCENARIOTWOOR
MORETHREADSHAVEACCESSTOASINGLEOBJECTSDATA)NOTHER
WORDSMETHODSEXECUTINGONTWODIFFERENTSTACKSAREBOTH
CALLINGSAYGETTERSORSETTERSONASINGLEOBJECTONTHEHEAP
)TSAWHOLE@LEFT HAND DOESNT KNOW WHAT THE RIGHT HAND
IS DOINGTHING4WOTHREADSWITHOUTACAREINTHEWORLD
HUMMINGALONGEXECUTINGTHEIRMETHODSEACHTHREAD
THINKINGTHATHEISTHE/NE4RUE4HREAD4HEONLYONE
THATMATTERS!FTERALLWHENATHREADISNOTRUNNINGANDIN
RUNNABLEORBLOCKED ITSESSENTIALLYKNOCKEDUNCONSCIOUS
7HENITBECOMESTHECURRENTLY RUNNINGTHREADAGAINITDOESNT
KNOWTHATITEVERSTOPPED
FKDSWHU
0DUULDJHLQ7URXEOH
&DQWKLVFRXSOHEHVDYHG"
1H[WRQDYHU\VSHFLDO'U6WHYH6KRZ
>7UDQVFULSWIURPHSLVRGH@
?MTKWUM\W\PM,Z;\M^M[PW_
?M¼^MOW\I[\WZa\WLIa\PI\¼[KMV\MZMLIZW]VL\PM\WX\_WZMI[WV[_Pa
KW]XTM[[XTQ\]X¸ÅVIVKM[IVL[TMMX
<WLIa¼[\ZW]JTMLXIQZ:aIVIVL5WVQKI[PIZMIJMLIVLI
JIVSIKKW]V\*]\VW\NWZTWVOQN_MKIV¼\ÅVLI[WT]\QWV<PM
XZWJTMU'<PMKTI[[QK¹\_WXMWXTM¸WVMJIVSIKKW]V\º\PQVO
0MZM¼[PW_5WVQKILM[KZQJMLQ\\WUM"
¹:aIVIVL1IOZMML\PI\VMQ\PMZWN][_QTTW^MZLZI_\PMKPMKSQVOIKKW]V\
;W\PMXZWKML]ZMQ[_PWM^MZ_IV\[\W_Q\PLZI_UWVMaU][\KPMKS\PM
JITIVKMQV\PMIKKW]V\JMNWZMUISQVO\PM_Q\PLZI_IT1\ITT[MMUML[W
[QUXTM*]\[]LLMVTa_M¼ZMJW]VKQVOKPMKS[IVLOM\\QVOPQ\_Q\PW^MZLZIN\ 5\DQDQG0RQLFDY
NMM[ RIWKH´WZRSHRSOH LFWLPV
1\PW]OP\Q\_I[V¼\XW[[QJTM1\PW]OP\W]ZXZWKML]ZM_I[[INM*]\\PMV
DFFRXQWµSUREOHP RQH
\PQ[PIXXMVML"
:aIVVMMLML[WPMKPMKSML\PMJITIVKMQV\PMIKKW]V\
HU
IVL[I_\PI\Q\_I[6WXZWJTMU;WPMXTIV[\W
5\DQIDOOVDVOHHSDIWH
_Q\PLZI_\PMUWVMa*]\ÅZ[\PMNITT[I[TMMX QF
KHFKHFNVWKHEDOD VWKH
)VL\PI\¼[_PMZM1KWUMQV_PQTM:aIV¼[[\QTTI[TMMXIVL EXWEHIRUHKHPDNH ZDNHV
VW_1_IV\\W_Q\PLZI_1KPMKS\PMJITIVKMIVL ZLWKGUDZDO:KHQKHPDNHV
XSKHLPPHGLDWHO\ XW
WKHZLWKGUDZOZLWKR DJDLQ
Q\¼[JMKI][M:aIV¼[[\QTTI[TMMXIVLPI[V¼\aM\UILM
FKHFNLQJWKHEDODQFH
PQ[_Q\PLZI_IT[W1\PQVSVWXZWJTMU;W1UISM\PM
_Q\PLZI_IT IVL IOIQV VW XZWJTMU *]\ \PMV :aIV _ISM[ ]X
KWUXTM\M[PQ[_Q\PLZI_ITIVL_M¼ZM[]LLMVTaW^MZLZI_V 0MLQLV¼\
M^MVSVW_\PI\PMNMTTI[TMMX[WPMR][\_MV\IPMILIVLKWUXTM\MLPQ[
\ZIV[IK\QWV_Q\PW]\KPMKSQVO\PMJITIVKMIOIQVAW]¼^MOW\\WPMTX][,Z
;\M^M º
1[\PMZMI[WT]\QWV')ZM\PMaLWWUML'?MKIV¼\[\WX:aIVNZWUNITTQVO
I[TMMXJ]\KIV_MUISM[]ZM\PI\5WVQKIKIV¼\OM\PMZPIVL[WV\PMJIVS
IKKW]V\]V\QTIN\MZPM_ISM[]X'
<ISMIUWUMV\IVL\PQVSIJW]\\PI\_PQTM_MOW\WIKWUUMZKQITJZMIS
\RXDUHKHUH
5\DQDQG0RQLFDFRGH
<PM:aIVIVL5WVQKIXZWJTMUQVKWLM
4HEFOLLOWINGEXAMPLESHOWSWHATCANHAPPENWHENTWO
5XQQDEOH
THREADS2YANAND-ONICA SHAREASINGLEOBJECTTHEBANK
ACCOUNT
4HECODEHASTWOCLASSES"ANK!CCOUNTAND
-ONICA!ND2YAN*OB4HE-ONICA!ND2YAN*OBCLASS
IMPLEMENTS2UNNABLEANDREPRESENTSTHEBEHAVIORTHAT2YAN
AND-ONICABOTHHAVECHECKINGTHEBALANCEANDMAKING
WITHDRAWALS"UTOFCOURSEEACHTHREADFALLSASLEEPINBETWEEN %DQN$FFRXQW
CHECKINGTHEBALANCEANDACTUALLYMAKINGTHEWITHDRAWAL LQWEDODQFH
4HE-ONICA!ND2YAN*OBCLASSHASANINSTANCEVARIABLEOFTYPE JHW%DODQFH 5\DQ$QG0RQLFD-RE
"ANK!CCOUNTTHATREPRESENTSTHEIRSHAREDACCOUNT ZLWKGUDZ %DQN$FFRXQWDFFRXQW
4HECODEWORKSLIKETHIS UXQ
PDNH:LWKGUDZDO
0DNHRQHLQVWDQFHRI5\DQ$QG0RQLFD-RE
7KH5\DQ$QG0RQLFD-REFODVVLVWKH5XQQDEOHWKHMREWRGR
DQGVLQFHERWK0RQLFDDQG5\DQGRWKHVDPHWKLQJFKHFN
EDODQFHDQGZLWKGUDZPRQH\ZHQHHGRQO\RQHLQVWDQFH ,QWKHUXQPHWKRGGR
5\DQ$QG0RQLFD-REWKH-RE QHZ5\DQ$QG0RQLFD-RE
H[DFWO\ZKDW5\DQDQG
0RQLFDZRXOGGR³FKHFN
WKHEDODQFHDQGLI
0DNHWZRWKUHDGVZLWKWKHVDPH5XQQDEOH WKHUH·VHQRXJKPRQH\
WKH5\DQ$QG0RQLFD-RELQVWDQFH PDNHWKHZLWKGUDZDO
7KUHDGRQH QHZ7KUHDGWKH-RE
7KUHDGWZR QHZ7KUHDGWKH-RE 7KLVVKRXOGSURWHFW
DJDLQVWRYHUGUDZLQJWKH
DFFRXQW
1DPHDQGVWDUWWKHWKUHDGV
([FHSW5\DQDQG
RQHVHW1DPH³5\DQ´
WZRVHW1DPH³0RQLFD´
0RQLFDDOZD\VIDOO
RQHVWDUW DVOHHSDIWHUWKH\
WZRVWDUW FKHFNWKHEDODQFHEXW
EHIRUHWKH\ÀQLVKWKH
ZLWKGUDZDO
:DWFKERWKWKUHDGVH[HFXWHWKHUXQPHWKRG
FKHFNWKHEDODQFHDQGPDNHDZLWKGUDZDO
2QHWKUHDGUHSUHVHQWV5\DQWKHRWKHUUHSUHVHQWV0RQLFD
%RWKWKUHDGVFRQWLQXDOO\FKHFNWKHEDODQFHDQGWKHQPDNHD
ZLWKGUDZDOEXWRQO\LILW·VVDIH
LIDFFRXQWJHW%DODQFH! DPRXQW^
WU\^
7KUHDGVOHHS
`FDWFK,QWHUUXSWHG([FHSWLRQH[^H[SULQW6WDFN7UDFH`
`
FKDSWHU
<PM:aIVIVL5WVQKIMÌUXTM
WDUWVZLWKD
FODVV%DQN$FFRXQW^
SULYDWHLQWEDODQFH 7KHDFFRXQWV

SXEOLFLQWJHW%DODQFH^
EDODQFHRI
UHWXUQEDODQFH
`
SXEOLFYRLGZLWKGUDZLQWDPRXQW^
EDODQFH EDODQFHDPRXQW
`
IWKH
`
LOOE H RQ O\ 2 1(LQVWDQFHRQO\
7KHUHZ D-RE7KDWPHD
QVR
SXEOLFFODVV5\DQ$QG0RQLFD-RELPSOHPHQWV5XQQDEOH^ 5\DQ$QG0RQLF IWKHEDQNDFFRXQW%RWK
21(LQVWDQFHRFFHVVWKLVRQHDFFRXQW
WKUHDGVZLOOD
SULYDWH%DQN$FFRXQWDFFRXQW QHZ%DQN$FFRXQW
5\DQ$QG0RQLFD-REWKH-RE QHZ5\DQ$QG0RQLFD-RE ,QVWDQWLDWHWKH
7KUHDGRQH QHZ7KUHDGWKH-RE 5XQQDEOHMRE
7KUHDGWZR QHZ7KUHDGWKH-RE 0DNHWZRWKUH
RQHVHW1DPH³5\DQ´
DG V
MRE7KDWPHDQV JLYLQJHDFKWKUHDGWKHVDP
WZRVHW1DPH³0RQLFD´ DFFRXQWLQVWDQFHERWKWKUHDGVZLOOEHDFFHVVLQ H5XQQDEOH
YDULDEOHLQWKH J
5XQQDEOHFODVV WKHRQH
RQHVWDUW
WZRVWDUW
`
KDQGWULHV
SXEOLFYRLGUXQ^ XQ PHW KR G D W KUHDGORRSVWKURXJ$IWHUWKH
,QWKHU DOZLWKHDFKLWHUDW
LRQ

WRPDNHDZLWKGUDZNVWKHEDODQFHRQFHDJDLQWRVHHLI
IRULQW[ [[^
PDNH:LWKGUDZO
LIDFFRXQWJHW%DODQFH^ ZLWKGUDZDOLWFKHF GUDZQ
6\VWHPRXWSULQWOQ³2YHUGUDZQ´ WKHDFFRXQWLVRYHU
`
HUH·VQRW
` &KHFNWKHDFFRXQWEDODQFHDQGLIWKJH,IWKHUH,6
`
HQRXJKPRQH\ZHMXVWSULQWDPHVVD DQGFRPSOHWH
HQRXJKZHJRWRVOHHSWKHQZDNHXS
WKHZLWKGUDZDOMXVWOLNH5\DQGLG
SULYDWHYRLGPDNH:LWKGUDZDOLQWDPRXQW^
6\VWHPRXWSULQWOQ7KUHDGFXUUHQW7KUHDGJHW1DPH³LVDERXWWRZLWKGUDZ´
WU\^
6\VWHPRXWSULQWOQ7KUHDGFXUUHQW7KUHDGJHW1DPH³LVJRLQJWRVOHHS´
7KUHDGVOHHS
6\VWHPRXWSULQWOQ7KUHDGFXUUHQW7KUHDGJHW1DPH³ZRNHXS´
DFFRXQWZLWKGUDZDPRXQW
6\VWHPRXWSULQWOQ7KUHDGFXUUHQW7KUHDGJHW1DPH³FRPSOHWHVWKHZLWKGUDZO´
`
HOVH^
6\VWHPRXWSULQWOQ³6RUU\QRWHQRXJKIRU³7KUHDGFXUUHQW7KUHDGJHW1DPH
`
:HSXWLQDEXQFKRISULQW
ZKDW·VKDSSHQLQJDVLWUXVWDWHPHQWVVRZHFDQ
`
` VHH
QV
\RXDUHKHUH
5\DQDQG0RQLFDRXWSXW
)LOH(GLW:LQGRZ+HOS9LVD
5\DQLVDERXWWRZLWKGUDZ
5\DQLVJRLQJWRVOHHS 7KHPDNH:LWKGUDZDOPHWKRG
0RQLFDZRNHXS DOZD\VFKHFNVWKHEDODQFH
EHIRUHPDNLQJDZLWKGUDZDO
0RQLFDFRPSOHWHVWKHZLWKGUDZO
EXWVWLOOZHRYHUGUDZWKH
0RQLFDLVDERXWWRZLWKGUDZ DFFRXQW
0RQLFDLVJRLQJWRVOHHS
5\DQZRNHXS +HUH·VRQHVFHQDULR
5\DQFRPSOHWHVWKHZLWKGUDZO 5\DQFKHFNVWKHEDODQFHVHHVWKDW
5\DQLVDERXWWRZLWKGUDZ WKHUH¶VHQRXJKPRQH\DQGWKHQIDOOV
5\DQLVJRLQJWRVOHHS DVOHHS
0RQLFDZRNHXS 0HDQZKLOH0RQLFDFRPHVLQDQGFKHFNV
0RQLFDFRPSOHWHVWKHZLWKGUDZO WKHEDODQFH6KHWRRVHHVWKDWWKHUH¶V
0RQLFDLVDERXWWRZLWKGUDZ HQRXJKPRQH\6KHKDVQRLGHDWKDW
0RQLFDLVJRLQJWRVOHHS 5\DQLVJRLQJWRZDNHXSDQGFRPSOHWHD
ZLWKGUDZDO
5\DQZRNHXS
5\DQFRPSOHWHVWKHZLWKGUDZO 0RQLFDIDOOVDVOHHS
5\DQLVDERXWWRZLWKGUDZ 5\DQZDNHVXSDQGFRPSOHWHVKLV
5\DQLVJRLQJWRVOHHS ZLWKGUDZDO
0RQLFDZRNHXS 0RQLFDZDNHVXSDQGFRPSOHWHVKHU
0RQLFDFRPSOHWHVWKHZLWKGUDZO ZLWKGUDZDO%LJ3UREOHP,QEHWZHHQWKH
6RUU\QRWHQRXJKIRU0RQLFD WLPHZKHQVKHFKHFNHGWKHEDODQFHDQG
PDGHWKHZLWKGUDZDO5\DQZRNHXSDQG
6RUU\QRWHQRXJKIRU0RQLFD SXOOHGPRQH\IURPWKHDFFRXQW
6RUU\QRWHQRXJKIRU0RQLFD
0RQLFD¶VFKHFNRIWKHDFFRXQWZDV
6RUU\QRWHQRXJKIRU0RQLFD QRWYDOLGEHFDXVH5\DQKDGDOUHDG\
6RUU\QRWHQRXJKIRU0RQLFD FKHFNHGDQGZDVVWLOOLQWKHPLGGOHRI
5\DQZRNHXS PDNLQJDZLWKGUDZDO
5\DQFRPSOHWHVWKHZLWKGUDZO 0RQLFDPXVWEHVWRSSHGIURPJHWWLQJ
+RZGLGWKLV 2YHUGUDZQ LQWRWKHDFFRXQWXQWLO5\DQZDNHVXSDQG
KDSSHQ" 6RUU\QRWHQRXJKIRU5\DQ
¿QLVKHVKLVWUDQVDFWLRQ$QGYLFHYHUVD
2YHUGUDZQ
6RUU\QRWHQRXJKIRU5\DQ
2YHUGUDZQ
6RUU\QRWHQRXJKIRU5\DQ
2YHUGUDZQ
FKDSWHU
7KH\QHHGDORFNIRUDFFRXQWDFFHVV
7KHORFNZRUNVOLNHWKLV
7KHUH·VDORFNDVVRFLDWHGZLWKWKHEDQN
DFFRXQWWUDQVDFWLRQFKHFNLQJWKHEDODQFH 7KHEDQNDFFRXQW
DQGZLWKGUDZLQJPRQH\7KHUH·VRQO\ WUDQVDFWLRQLV
RQHNH\DQGLWVWD\VZLWKWKHORFNXQWLO XQORFNHGZKHQ
VRPHERG\ZDQWVWRDFFHVVWKHDFFRXQW QRERG\LVXVLQJ
WKHDFFRXQW
:KHQ5\DQ
:KHQ5\DQZDQWVWRDFFHVVWKHEDQN
ZDQWVWRDFFHVV
DFFRXQWWRFKHFNWKHEDODQFHDQGZLWKGUDZ
WKHDFFRXQWKH
PRQH\KHORFNVWKHORFNDQGSXWVWKHNH\
VHFXUHVWKHORFN
LQKLVSRFNHW1RZQRERG\HOVHFDQDFFHVV
DQGWDNHVWKHNH\
WKHDFFRXQWVLQFHWKHNH\LVJRQH
5\DQNHHSVWKHNH\LQKLVSRFNHWXQWLOKH
:KHQ5\DQLV
ÀQLVKHVWKHWUDQVDFWLRQ+HKDVWKHRQO\
ÀQLVKHGKH
NH\VR0RQLFDFDQ·WDFFHVVWKHDFFRXQW
XQORFNVWKHORFN
RUWKHFKHFNERRNXQWLO5\DQXQORFNVWKH
DQGUHWXUQVWKH
DFFRXQWDQGUHWXUQVWKHNH\
NH\1RZWKHNH\
1RZHYHQLI5\DQIDOOVDVOHHSDIWHUKH LVDYDLODEOHIRU
FKHFNVWKHEDODQFHKHKDVDJXDUDQWHH 0RQLFDRU5\DQ
WKDWWKHEDODQFHZLOOEHWKHVDPHZKHQKH DJDLQWRDFFHVV
ZDNHVXSEHFDXVHKHNHSWWKHNH\ZKLOHKH WKHDFFRXQW
ZDVDVOHHS
\RXDUHKHUH
XVLQJV\QFKURQL]HG
?MVMML\PMUISM?Q\PLZI_IT UM\PWL
\WZ]VI[WVMI\WUQK\PQVO
7ENEEDTOMAKESURETHATONCEATHREADENTERSTHE
MAKE7ITHDRAWAL METHODITMUSTBEALLOWEDTOlNISHTHEMETHOD
BEFOREANYOTHERTHREADCANENTER
)NOTHERWORDSWENEEDTOMAKESURETHATONCEATHREADHAS
CHECKEDTHEACCOUNTBALANCETHATTHREADHASAGUARANTEETHATITCAN
7KHV\QFKURQL]HG
WAKEUPANDlNISHTHEWITHDRAWALBEFOREANYOTHERTHREADCANCHECKTHE NH\ZRUGPHDQVWKDW
ACCOUNTBALANCE DWKUHDGQHHGVDNH\
5SETHEV\QFKURQL]HGKEYWORDTOMODIFYAMETHODSOTHATONLY LQRUGHUWRDFFHVVWKH
ONETHREADATATIMECANACCESSIT V\QFKURQL]HGFRGH
4HATSHOWYOUPROTECTTHEBANKACCOUNT9OUDONTPUTALOCKON
THEBANKACCOUNTITSELFYOULOCKTHEMETHODTHATDOESTHEBANKING 7RSURWHFW\RXUGDWD
TRANSACTION4HATWAYONETHREADGETSTOCOMPLETETHEWHOLE OLNHWKHEDQNDFFRXQW
TRANSACTIONSTARTTOlNISHEVENIFTHATTHREADFALLSASLEEPINTHE V\QFKURQL]HWKH
MIDDLEOFTHEMETHOD
PHWKRGVWKDWDFWRQ
3OIFYOUDONTLOCKTHEBACKACCOUNTTHENWHATEXACTLYISLOCKED)S WKDWGDWD
ITTHEMETHOD4HE2UNNABLEOBJECT4HETHREADITSELF
7ELLLOOKATTHATONTHENEXTPAGE)NCODETHOUGHITSQUITE
SIMPLEJUSTADDTHESYNCHRONIZEDMODIlERTOYOURMETHOD
DECLARATION
SULYDWHV\QFKURQL]HGYRLGPDNH:LWKGUDZDOLQWDPRXQW^

6\VWHPRXWSULQWOQ7KUHDGFXUUHQW7KUHDGJHW1DPH³LVDERXWWRZLWKGUDZ´
WU\^
6\VWHPRXWSULQWOQ7KUHDGFXUUHQW7KUHDGJHW1DPH³LVJRLQJWRVOHHS´
7KUHDGVOHHS
6\VWHPRXWSULQWOQ7KUHDGFXUUHQW7KUHDGJHW1DPH³ZRNHXS´
DFFRXQWZLWKGUDZDPRXQW
6\VWHPRXWSULQWOQ7KUHDGFXUUHQW7KUHDGJHW1DPH³FRPSOHWHVWKHZLWKGUDZO´
`HOVH^
6\VWHPRXWSULQWOQ³6RUU\QRWHQRXJKIRU³7KUHDGFXUUHQW7KUHDGJHW1DPH
`
`
1RWHIRU\RXSK\VLFVVDYY\UHDGHUV\HVWKHFRQYHQWLRQRIXVLQJWKHZRUG¶DWRPLF·KHUHGRHVQRWUHIOHFW
WKHZKROHVXEDWRPLFSDUFWLFOHWKLQJ7KLQN1HZWRQQRW(LQVWHLQZKHQ\RXKHDUWKHZRUG¶DWRPLF·LQWKH
FRQWH[WRIWKUHDGVRUWUDQVDFWLRQV+H\LW·VQRW285FRQYHQWLRQ,I:(ZHUHLQFKDUJHZH·GDSSO\
+HLVHQEHUJ·V8QFHUWDLQW\3ULQFLSOHWRSUHWW\PXFKHYHU\WKLQJUHODWHGWRWKUHDGV
FKDSWHU
=[QVOIVWJRMK\¼[TWKS
%VERYOBJECTHASALOCK-OSTOFTHETIMETHE +H\WKLVREMHFW·V
LOCKISUNLOCKEDANDYOUCANIMAGINEAVIRTUAL WDNH0RQH\PHWKRGLV
KEYSITTINGWITHIT/BJECTLOCKSCOMEINTOPLAY V\QFKURQL]HG,QHHGWRJHW
ONLYWHENTHEREARESYNCHRONIZEDMETHODS WKLVREMHFW·VNH\EHIRUH,
7HENANOBJECTHASONEORMORESYNCHRONIZED FDQJRLQ
METHODSATHREADCANENTERASYNCHRONIZED
METHODONLYIFTHETHREADCANGETTHEKEYTOTHE
OBJECTSLOCK
4HELOCKSARENOTPERMETHODTHEY
AREPEROBJECT)FANOBJECTHASTWO
SYNCHRONIZEDMETHODSITDOESNOT
SIMPLYMEANTHATYOUCANTHAVETWO
THREADSENTERINGTHESAMEMETHOD)T
MEANSYOUCANTHAVETWOTHREADSENTERING
ANYOFTHESYNCHRONIZEDMETHODS
4HINKABOUTIT)FYOUHAVEMULTIPLE
METHODSTHATCANPOTENTIALLYACTONAN
OBJECTSINSTANCEVARIABLESALLTHOSEMETHODS
NEEDTOBEPROTECTEDWITHSYNCHRONIZED
4HEGOALOFSYNCHRONIZATIONISTOPROTECT (YHU\-DYDREMHFWKDVDORFN
CRITICALDATA"UTREMEMBERYOUDONTLOCKTHE $ORFNKDVRQO\RQHNH\
DATAITSELFYOUSYNCHRONIZETHEMETHODSTHAT
ACCESSTHATDATA 0RVWRIWKHWLPHWKHORFNLV
3OWHATHAPPENSWHENATHREADISCRANKING
THROUGHITSCALLSTACKSTARTINGWITHTHERUN XQORFNHGDQGQRERG\FDUHV
METHOD ANDITSUDDENLYHITSASYNCHRONIZED
METHOD4HETHREADRECOGNIZESTHATITNEEDS %XWLIDQREMHFWKDV
AKEYFORTHATOBJECTBEFOREITCANENTERTHE V\QFKURQL]HGPHWKRGVD
METHOD)TLOOKSFORTHEKEYTHISISALLHANDLED
BYTHE*6-THERESNO!0)IN*AVAFORACCESSING WKUHDGFDQHQWHURQHRIWKH
OBJECTLOCKS ANDIFTHEKEYISAVAILABLETHE
THREADGRABSTHEKEYANDENTERSTHEMETHOD
V\QFKURQL]HGPHWKRGV21/<
&ROMTHATPOINTFORWARDTHETHREADHANGSON LIWKHNH\IRUWKHREMHFW·VORFN
TOTHATKEYLIKETHETHREADSLIFEDEPENDSON LVDYDLODEOH,QRWKHUZRUGV
IT4HETHREADWONTGIVEUPTHEKEYUNTILIT
COMPLETESTHESYNCHRONIZEDMETHOD3OWHILE RQO\LIDQRWKHUWKUHDGKDVQ·W
THATTHREADISHOLDINGTHEKEYNOOTHERTHREADS
CANENTERANYOFTHATOBJECTSSYNCHRONIZED
DOUHDG\JUDEEHGWKHRQHNH\
METHODSBECAUSETHEONEKEYFORTHATOBJECT
WONTBEAVAILABLE
\RXDUHKHUH
V\QFKURQL]DWLRQPDWWHUV
<PMLZMILML¹4W[\=XLI\MºXZWJTMU
(ERESANOTHERCLASSICCONCURRENCYPROBLEMTHATCOMESFROMTHEDATABASEWORLD)TS
CLOSELYRELATEDTOTHE2YANAND-ONICASTORYBUTWELLUSETHISEXAMPLETOILLUSTRATEAFEW
MOREPOINTS
4HELOSTUPDATEREVOLVESAROUNDONEPROCESS
3TEP'ETTHEBALANCEINTHEACCOUNT
LQWL EDODQFH
3TEP!DDTOTHATBALANCE
EDODQFH L
4HETRICKTOSHOWINGTHISISTOFORCETHECOMPUTERTOTAKETWOSTEPSTOCOMPLETETHECHANGE
TOTHEBALANCE)NTHEREALWORLDYOUDDOTHISPARTICULARMOVEINASINGLESTATEMENT
EDODQFH
"UTBYFORCINGITINTOTWOSTEPSTHEPROBLEMWITHANON ATOMICPROCESSWILLBECOMECLEAR
3OIMAGINETHATRATHERTHANTHETRIVIALhGETTHEBALANCEANDTHENADDTOTHECURRENT
BALANCEvSTEPSTHETWOORMORE STEPSINTHISMETHODAREMUCHMORECOMPLEXAND
COULDNTBEDONEINONESTATEMENT
)NTHEh,OST5PDATEvPROBLEMWEHAVETWOTHREADSBOTHTRYINGTOINCREMENTTHEBALANCE
FODVV7HVW6\QFLPSOHPHQWV5XQQDEOH^
LPHV
XQVODWQFHRQ
SULYDWHLQWEDODQFH
W KU H D G U
SXEOLFYRLGUXQ^ HDFK HQWLQJWKHED
IRULQWL LL^ LQFUHP HUDWLRQ
LQFUHPHQW HDFKLW
6\VWHPRXWSULQWOQ³EDODQFHLV³EDODQFH
`
`
SXEOLFYRLGLQFUHPHQW^
LQWL EDODQFH
EDODQFH L +HUH·VWKHFUXFLD
` DGGLQJWRZKDWHOSDUW :HLQFUHPHQWWKHEDODQF
` 7,0(:(5($' YHUWKHYDOXHRIEDODQFHZDV$ HE\
WKH&855(17YD ,7UDWKHUWKDQDGGLQJWRZ 77+(
OXHLV KDWHYHU
SXEOLFFODVV7HVW6\QF7HVW^
7HVW6\QFMRE QHZ7HVW6\QF
7KUHDGD QHZ7KUHDGMRE
7KUHDGE QHZ7KUHDGMRE
DVWDUW
EVWDUW
`
`
FKDSWHU
4M\¼[Z]V\PQ[KWLM
7KUHDG$UXQVIRUDZKLOH
3XWWKHYDOXHRIEDODQFHLQWRYDULDEOHL
%DODQFHLVVRLLVQRZ
6HWWKHYDOXHRIEDODQFHWRWKHUHVXOWRIL
1RZEDODQFHLV
$ 3XWWKHYDOXHRIEDODQFHLQWRYDULDEOHL
%DODQFHLVVRLLVQRZ
1RZEDODQFHLV
%
7KUHDG%UXQVIRUDZKLOH
Licensed by
%DODQFHLVVRLLVQRZ
Eduard Simons
1RZEDODQFHLV
% 3XWWKHYDOXHRIEDODQFHLQWRYDULDEOHL
%DODQFHLVVRLLVQRZ
104038
>QRZWKUHDG%LVVHQWEDFNWRUXQQDEOH
EHIRUHLWVHWVWKHYDOXHRIEDODQFHWR@
7KUHDG$UXQVDJDLQSLFNLQJXSZKHUHLWOHIWRII
%DODQFHLVVRLLVQRZ
1RZEDODQFHLV
$ 3XWWKHYDOXHRIEDODQFHLQWRYDULDEOHL
%DODQFHLVVRLLVQRZ
1RZEDODQFHLV
7KUHDG%UXQVDJDLQDQGSLFNVXSH[DFWO\ZKHUHLWOHIWRII
:HORVWWKHODVWXSGDWHV
WKDW7KUHDG$PDGH
1RZEDODQFHLV
<LNHV
7KUHDG%KDGSUHYLRXVO\
GRQHD¶UHDG·RIWKHYDOXH
% 7KUHDG$XSGDWHGLWWREXW
RIEDODQFHDQGZKHQ%
QRZ%FDPHEDFNDQGVWHSSHG ZRNHXSLWMXVWNHSWJRLQJ
RQWRSRIWKHXSGDWH$PDGH DVLILWQHYHUPLVVHGDEHDW
DVLI$·VXSGDWHQHYHUKDSSHQHG
\RXDUHKHUH
V\QFKURQL]LQJPHWKRGV
5ISM\PMQVKZMUMV\UM\PWLI\WUQK
;aVKPZWVQbMQ\
3YNCHRONIZINGTHEINCREMENT METHODSOLVESTHEh,OST
5PDATEvPROBLEMBECAUSEITKEEPSTHETWOSTEPSINTHEMETHOD 2QFHDWKUHDGHQWHUV
ASONEUNBREAKABLEUNIT WKHPHWKRGZHKDYH
WRPDNHVXUHWKDWDOO
WKHVWHSVLQWKHPHWKRG
SXEOLFV\QFKURQL]HGYRLGLQFUHPHQW^
LQWL EDODQFH FRPSOHWHDVRQH
EDODQFH L DWRPLFSURFHVVEHIRUH
` DQ\RWKHUWKUHDGFDQ
HQWHUWKHPHWKRG
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: %
3OUNDSLIKEITSAGOODIDEATOSYNCHRONIZE
EVERYTHINGJUSTTOBETHREAD SAFE

GR6WXIIGRHVQ·WQHHGWR
A: .OPEITSNOTAGOODIDEA3YNCHRONIZATIONDOESNT EHV\QFKURQL]HGVRZHGRQ·W
COMEFORFREE&IRSTASYNCHRONIZEDMETHODHASACERTAIN V\QFKURQL]HWKHZKROHPHWKRG
AMOUNTOFOVERHEAD)NOTHERWORDSWHENCODEHITSA SXEOLFYRLGJR^
SYNCHRONIZEDMETHODTHERESGOINGTOBEAPERFORMANCEHIT GR6WXII
ALTHOUGHTYPICALLYYOUDNEVERNOTICEIT WHILETHEMATTEROF
hISTHEKEYAVAILABLEvISRESOLVED V\QFKURQL]HGWKLV^
FULWLFDO6WXII
3ECONDASYNCHRONIZEDMETHODCANSLOWYOURPROGRAM
PRUH&ULWLFDO6WXII
DOWNBECAUSESYNCHRONIZATIONRESTRICTSCONCURRENCY)N
`
OTHERWORDSASYNCHRONIZEDMETHODFORCESOTHERTHREADSTO
`
GETINLINEANDWAITTHEIRTURN4HISMIGHTNOTBEAPROBLEM 1RZRQO\WKHVH P
INYOURCODEBUTYOUHAVETOCONSIDERIT LQWRRQHDWRPLFWXQZR
LW :
HWKRGFDOOVDUHJURXSHG

V\QFKURQL]HGNH\ZRUG KHQ\RXXVHWKH
4HIRDANDMOSTFRIGHTENINGSYNCHRONIZEDMETHODSCANLEAD :
UDWKHUWKDQLQ WK ,7+,1DPHWKRG
KDYHWRSURYLGHDDQPH RGGHFODUDWLRQ
TODEADLOCK3EEPAGE
!GOODRULEOFTHUMBISTOSYNCHRONIZEONLYTHEBARE REMHFWZKRVHNH\WD UJXPHQWWKDWLVW\KHRX
MINIMUMTHATSHOULDBESYNCHRONIZED!NDINFACTYOU KHWKUHDGQHHGVWRJH
$OWKRXJKWKHUHDUHRWK W
CANSYNCHRONIZEATAGRANULARITYTHATSEVENSMALLERTHAN
ZLOODOPRVWDOZD\ \QFK HU Z D\ VW RGRLW RX
AMETHOD7EDONTUSEITINTHEBOOKBUTYOUCANUSETHE
SYNCHRONIZEDKEYWORDTOSYNCHRONIZEATTHEMOREFINE REMHFWWKLV7KVV URQL]HRQWKHFXU\ UHQW
GRAINEDLEVELOFONEORMORESTATEMENTSRATHERTHANATTHE ORFNLIWKHZKROHDW ·VWKHVDPHREM
PHWKRGZHUHV\QFHFKUWRQ\RX·G
WHOLE METHODLEVEL L]HG
FKDSWHU
7KUHDG$UXQVIRUDZKLOH
$WWHPSWWRHQWHUWKHLQFUHPHQWPHWKRG
7KHPHWKRGLVV\QFKURQL]HGVRJHWWKHNH\IRUWKLVREMHFW
$ %DODQFHLVVRLLVQRZ
1RZEDODQFHLV
5HWXUQWKHNH\LWFRPSOHWHGWKHLQFUHPHQWPHWKRG
5HHQWHUWKHLQFUHPHQWPHWKRGDQGJHWWKHNH\
%DODQFHLVVRLLVQRZ
>QRZWKUHDG$LVVHQWEDFNWRUXQQDEOHEXWVLQFHLWKDVQRW
FRPSOHWHGWKHV\QFKURQL]HGPHWKRG7KUHDG$NHHSVWKHNH\@
7KUHDG%LVVHOHFWHGWRUXQ
$WWHPSWWRHQWHUWKHLQFUHPHQWPHWKRG7KHPHWKRGLV
V\QFKURQL]HGVRZHQHHGWRJHWWKHNH\
% 7KHNH\LVQRWDYDLODEOH
>QRZWKUHDG%LVVHQWLQWRDµREMHFWORFNQRWDYDLODEOHORXQJH@
7KUHDG$UXQVDJDLQSLFNLQJXSZKHUHLWOHIWRII
UHPHPEHULWVWLOOKDVWKHNH\
1RZEDODQFHLV
$ 5HWXUQWKHNH\
>QRZWKUHDG$LVVHQWEDFNWRUXQQDEOHEXWVLQFHLW
KDVFRPSOHWHGWKHLQFUHPHQWPHWKRGWKHWKUHDG
GRHV127KROGRQWRWKHNH\@
7KUHDG%LVVHOHFWHGWRUXQ
$WWHPSWWRHQWHUWKHLQFUHPHQWPHWKRG7KHPHWKRGLV
V\QFKURQL]HGVRZHQHHGWRJHWWKHNH\
% 7KLVWLPHWKHNH\,6DYDLODEOHJHWWKHNH\
>FRQWLQXHVWRUXQ@
\RXDUHKHUH
WKUHDGGHDGORFN
<PMLMILTa[QLMWN[aVKPZWVQbI\QWV
"ECAREFULWHENYOUUSESYNCHRONIZEDCODEBECAUSENOTHING
WILLBRINGYOURPROGRAMTOITSKNEESLIKETHREADDEADLOCK
4HREADDEADLOCKHAPPENSWHENYOUHAVETWOTHREADSBOTHOF
WHICHAREHOLDINGAKEYTHEOTHERTHREADWANTS4HERESNOWAY
OUTOFTHISSCENARIOSOTHETWOTHREADSWILLSIMPLYSITANDWAIT
!NDWAIT!NDWAIT
)FYOUREFAMILIARWITHDATABASESOROTHERAPPLICATIONSERVERS
YOUMIGHTRECOGNIZETHEPROBLEMDATABASESOFTENHAVEA
LOCKINGMECHANISMSOMEWHATLIKESYNCHRONIZATION"UTA
REALTRANSACTIONMANAGEMENTSYSTEMCANSOMETIMESDEALWITH $OOLWWDNHVIRU
DEADLOCK)TMIGHTASSUMEFOREXAMPLETHATDEADLOCKMIGHT GHDGORFNDUHWZR
HAVEOCCURREDWHENTWOTRANSACTIONSARETAKINGTOOLONGTO REMHFWVDQGWZR
COMPLETE"UTUNLIKE*AVATHEAPPLICATIONSERVERCANDOA WKUHDGV
hTRANSACTIONROLLBACKvTHATRETURNSTHESTATEOFTHEROLLED BACK
TRANSACTIONTOWHEREITWASBEFORETHETRANSACTIONTHEATOMIC
PART BEGAN IRR
*AVAHASNOMECHANISMTOHANDLEDEADLOCK)TWONTEVENKNOW $ %
DEADLOCKOCCURRED3OITSUPTOYOUTODESIGNCAREFULLY)FYOU
EDU
lNDYOURSELFWRITINGMUCHMULTITHREADEDCODEYOUMIGHT
WANTTOSTUDYh*AVA4HREADSvBY3COTT/AKSAND(ENRY7ONG
FORDESIGNTIPSONAVOIDINGDEADLOCK/NEOFTHEMOSTCOMMON
TIPSISTOPAYATTENTIONTOTHEORDERINWHICHYOURTHREADSARE
STARTED
$VLPSOHGHDGORFNVFHQDULR
7KUHDG$HQWHUVD 7KUHDG%HQWHUVD 7KUHDG$ZDNHVXSVWLOO

V\QFKURQL]HGPHWKRG V\QFKURQL]HGPHWKRG KROGLQJWKHIRRNH\
RIREMHFWIRRDQGJHWV RIREMHFWEDUDQGJHWV DQGWULHVWRHQWHUD
$ WKHNH\
IRR
% WKHNH\
$ V\QFKURQL]HGPHWKRGRQ
REMHFWEDUEXWFDQ¶WJHW
EDU
WKDWNH\EHFDXVH%KDV
7KUHDG$JRHVWR 7KUHDG%WULHVWRHQWHU LW$JRHVWRWKHZDLWLQJ
VOHHSKROGLQJWKH DV\QFKURQL]HGPHWKRG ORXQJHXQWLOWKHEDUNH\LV
IRRNH\ RIREMHFWIRREXWFDQ¶W DYDLODEOHLWQHYHUZLOOEH
JHWWKDWNH\EHFDXVH
$ $KDVLW%JRHV
7KUHDG$FDQ¶WUXQXQWLO
LWFDQJHWWKHEDUNH\
% WRWKHZDLWLQJORXQJH $ EXW%LVKROGLQJWKHEDU
IRR
XQWLOWKHIRRNH\LV
NH\DQG%FDQ¶WUXQXQWLOLW
DYDLODEOH%NHHSVWKH IRR
EDU JHWVWKHIRRNH\WKDW$LV
EDUNH\
KROGLQJDQG
FKDSWHU
:MDD=LHGAFLK
7KHVWDWLF7KUHDGVOHHSPHWKRGIRUFHVDWKUHDGWROHDYHWKH
UXQQLQJVWDWHIRUDWOHDVWWKHGXUDWLRQSDVVHGWRWKHVOHHSPHWKRG
7KUHDGVOHHSSXWVDWKUHDGWRVOHHSIRUPLOOLVHFRQGV
7KHVOHHSPHWKRGWKURZVDFKHFNHGH[FHSWLRQ,QWHUUXSWHG([FHSWLRQ
VRDOOFDOOVWRVOHHSPXVWEHZUDSSHGLQDWU\FDWFKRUGHFODUHG
<RXFDQXVHVOHHSWRKHOSPDNHVXUHDOOWKUHDGVJHWDFKDQFHWRUXQ
DOWKRXJKWKHUH·VQRJXDUDQWHHWKDWZKHQDWKUHDGZDNHVXSLW·OOJRWRWKH
HQGRIWKHUXQQDEOHOLQH,WPLJKWIRUH[DPSOHJRULJKWEDFNWRWKHIURQW
,QPRVWFDVHVDSSURSULDWHO\WLPHGVOHHSFDOOVDUHDOO\RXQHHGWRNHHS
\RXUWKUHDGVVZLWFKLQJQLFHO\
<RXFDQQDPHDWKUHDGXVLQJWKH\HWDQRWKHUVXUSULVHVHW1DPH
PHWKRG$OOWKUHDGVJHWDGHIDXOWQDPHEXWJLYLQJWKHPDQH[SOLFLWQDPH
FDQKHOS\RXNHHSWUDFNRIWKUHDGVHVSHFLDOO\LI\RX·UHGHEXJJLQJZLWK
SULQWVWDWHPHQWV
<RXFDQKDYHVHULRXVSUREOHPVZLWKWKUHDGVLIWZRRUPRUHWKUHDGVKDYH
DFFHVVWRWKHVDPHREMHFWRQWKHKHDS
7ZRRUPRUHWKUHDGVDFFHVVLQJWKHVDPHREMHFWFDQOHDGWRGDWD
FRUUXSWLRQLIRQHWKUHDGIRUH[DPSOHOHDYHVWKHUXQQLQJVWDWHZKLOHVWLOO
LQWKHPLGGOHRIPDQLSXODWLQJDQREMHFW·VFULWLFDOVWDWH
7RPDNH\RXUREMHFWVWKUHDGVDIHGHFLGHZKLFKVWDWHPHQWVVKRXOGEH
WUHDWHGDVRQHDWRPLFSURFHVV,QRWKHUZRUGVGHFLGHZKLFKPHWKRGV
PXVWUXQWRFRPSOHWLRQEHIRUHDQRWKHUWKUHDGHQWHUVWKHVDPHPHWKRG
RQWKHVDPHREMHFW
8VHWKHNH\ZRUGV\QFKURQL]HGWRPRGLI\DPHWKRGGHFODUDWLRQ
ZKHQ\RXZDQWWRSUHYHQWWZRWKUHDGVIURPHQWHULQJWKDWPHWKRG
(YHU\REMHFWKDVDVLQJOHORFNZLWKDVLQJOHNH\IRUWKDWORFN0RVWRIWKH
WLPHZHGRQ·WFDUHDERXWWKDWORFNORFNVFRPHLQWRSOD\RQO\ZKHQDQ
REMHFWKDVV\QFKURQL]HGPHWKRGV
:KHQDWKUHDGDWWHPSWVWRHQWHUDV\QFKURQL]HGPHWKRGWKHWKUHDG
PXVWJHWWKHNH\IRUWKHREMHFWWKHREMHFWZKRVHPHWKRGWKHWKUHDG
LVWU\LQJWRUXQ,IWKHNH\LVQRWDYDLODEOHEHFDXVHDQRWKHUWKUHDG
DOUHDG\KDVLWWKHWKUHDGJRHVLQWRDNLQGRIZDLWLQJORXQJHXQWLOWKHNH\
EHFRPHVDYDLODEOH
(YHQLIDQREMHFWKDVPRUHWKDQRQHV\QFKURQL]HGPHWKRGWKHUHLVVWLOO
RQO\RQHNH\2QFHDQ\WKUHDGKDVHQWHUHGDV\QFKURQL]HGPHWKRGRQ
WKDWREMHFWQRWKUHDGFDQHQWHUDQ\RWKHUV\QFKURQL]HGPHWKRGRQWKH
VDPHREMHFW7KLVUHVWULFWLRQOHWV\RXSURWHFW\RXUGDWDE\V\QFKURQL]LQJ
DQ\PHWKRGWKDWPDQLSXODWHVWKHGDWD
\RXDUHKHUH
ILQDOFKDWFOLHQW
6M_IVLQUXZW^ML;QUXTM+PI\+TQMV\
7AYBACKNEARTHEBEGINNINGOFTHISCHAPTERWEBUILTTHE3IMPLE#HAT#LIENTTHATCOULDSEND
OUTGOINGMESSAGESTOTHESERVERBUTCOULDNTRECEIVEANYTHING2EMEMBER4HATSHOWWE
GOTONTOTHISWHOLETHREADTOPICINTHElRSTPLACEBECAUSEWENEEDEDAWAYTODOTWOTHINGS
ATONCESENDMESSAGESTOTHESERVERINTERACTINGWITHTHE'5) WHILESIMULTANEOUSLYREADING
INCOMINGMESSAGESFROMTHESERVERDISPLAYINGTHEMINTHESCROLLINGTEXTAREA
LPSRUWMDYDLR
<HVWKHUHUHDOO\,6DQ
HQGWRWKLVFKDSW
LPSRUWMDYDQHW
LPSRUWMDYDXWLO %XWQRW\HW HU
LPSRUWMDYD[VZLQJ
LPSRUWMDYDDZW
LPSRUWMDYDDZWHYHQW
SXEOLFFODVV6LPSOH&KDW&OLHQW^
-7H[W$UHDLQFRPLQJ
-7H[W)LHOGRXWJRLQJ
%XIIHUHG5HDGHUUHDGHU
3ULQW:ULWHUZULWHU
6RFNHWVRFN
HHQ
6LPSOH&KDW&OLHQWFOLHQW QHZ6LPSOH&KDW&OLHQW
FOLHQWJR KL V LV P RV WO\ * 8,FRGH\RX·HSYHWVWKH
7 VSHFLDOH[F
` EHIRUH1RWSKLDUQJWZKHUHZHVWDUWWKH
KLJKOLJKWHG ·WKUHDG
SXEOLFYRLGJR^
QHZ¶UHDGHU
-)UDPHIUDPH QHZ-)UDPH³/XGLFURXVO\6LPSOH&KDW&OLHQW´
LQFRPLQJ QHZ-7H[W$UHD
LQFRPLQJVHW/LQH:UDSWUXH
LQFRPLQJVHW:UDS6W\OH:RUGWUXH
LQFRPLQJVHW(GLWDEOHIDOVH
-6FUROO3DQHT6FUROOHU QHZ-6FUROO3DQHLQFRPLQJ
RXWJRLQJ QHZ-7H[W)LHOG
-%XWWRQVHQG%XWWRQ QHZ-%XWWRQ³6HQG´
VHQG%XWWRQDGG$FWLRQ/LVWHQHUQHZ6HQG%XWWRQ/LVWHQHU
PDLQ3DQHODGGT6FUROOHU :H·UHVWDUWLQJDQHZWK
PDLQ3DQHODGGRXWJRLQJ XVLQJDQHZLQQHU UHDG
PDLQ3DQHODGGVHQG%XWWRQ WKH5XQQDEOHMREFOD VVDV
IRUWKH
VHW8S1HWZRUNLQJ WKUH DG7KHWKU G·VMRELV
WRUHDGIURPWKHHDVH
7KUHDGUHDGHU7KUHDG QHZ7KUHDGQHZ,QFRPLQJ5HDGHU
VRFNHWVWUHDPGLVSOD\UYLQJ
HU·V
UHDGHU7KUHDGVWDUW
DQ\LQFRPLQJPHVVDJHVLQ
IUDPHJHW&RQWHQW3DQHDGG%RUGHU/D\RXW&(17(5PDLQ3DQHO VFUROOLQJWH[WDUHD WKH
IUDPHVHW6L]H
IUDPHVHW9LVLEOHWUXH

`FORVHJR
FKDSWHU
SULYDWHYRLGVHW8S1HWZRUNLQJ^

WU\^
VRFN QHZ6RFNHW³´
,QSXW6WUHDP5HDGHUVWUHDP5HDGHU QHZ,QSXW6WUHDP5HDGHUVRFNJHW,QSXW6WUHDP
UHDGHU QHZ%XIIHUHG5HDGHUVWUHDP5HDGHU
ZULWHU QHZ3ULQW:ULWHUVRFNJHW2XWSXW6WUHDP
KHLQSXW
6\VWHPRXWSULQWOQ³QHWZRUNLQJHVWDEOLVKHG´
H· UH X VL QJ W KHVRFNHWWRJHUHWHWDOUHDG\XVLQJ
`FDWFK,2([FHSWLRQH[^ : DPV:HZ
H[SULQW6WDFN7UDFH DQGRXWSXWVVWWUUHHDPWRVHQGWRWKHVHUYVHU R
H RX WS XW V WUHD P
WK VLQJWKHLQSXW
`
`FORVHVHW8S1HWZRUNLQJ EXWQRZZH·UHX UHDGFDQJHW
HZ¶UHDGHU·YHWK
WKDWWKHQUR KHV HU U
PHVVDJHVI PW
WU\^
ZULWHUSULQWOQRXWJRLQJJHW7H[W
ZULWHUÀXVK 1RWKLQJQHZKHUH:KHQWKHXVHU

WKHVHQGEXWWRQWKLVPHW FOLFNV
`FDWFK([FHSWLRQH[^ KRGVH QGV
FRQWHQWVRIWKHWH[WILHOGWR WKH
H[SULQW6WDFN7UDFH WKHVHUYHU
`
RXWJRLQJVHW7H[W³´
RXWJRLQJUHTXHVW)RFXV
`
`FORVHLQQHUFODVV
SXEOLFFODVV,QFRPLQJ5HDGHULPSOHPHQWV5XQQDEOH^
WKUHDGGRHV
SXEOLFYRLGUXQ^
7KLVLVZKDWWKH
6WULQJPHVVDJH
GLWVWD\VLQD
WU\^ ,QWKHUXQPDVHWZKRKDWLWJHWVIURP
ORRSDVORQJVQRWQXOOUHDGLQJD
WKHVHUYHUL HDQGDGGLQJHDFKOLQH
ZKLOHPHVVDJH UHDGHUUHDG/LQH QXOO^
6\VWHPRXWSULQWOQ³UHDG³PHVVDJH
OLQHDWDWLPOLQJWH[WDUHDDORQJ
LQFRPLQJDSSHQGPHVVDJH³?Q´
WRWKHVFURO LQHFKDUDFWHU
`FORVHZKLOH ZLWKDQHZO
`FORVHUXQ
`FORVHLQQHUFODVV

`FORVHRXWHUFODVV
\RXDUHKHUH
FKDWVHUYHUFRGH
4GCF[DCMG
%QFG
<PMZMITTaZMITTa[QUXTM+PI\;MZ^MZ
9OUCANUSETHISSERVERCODEFORBOTHVERSIONSOFTHE#HAT#LIENT%VERYPOSSIBLE
DISCLAIMEREVERDISCLAIMEDISINEFFECTHERE4OKEEPTHECODESTRIPPEDDOWNTOTHE
BAREESSENTIALSWETOOKOUTALOTOFPARTSTHATYOUDNEEDTOMAKETHISAREALSERVER
)NOTHERWORDSITWORKSBUTTHEREAREATLEASTAHUNDREDWAYSTOBREAKIT)FYOU
WANTA2EALLY'OOD3HARPEN9OUR0ENCILFORAFTERYOUVElNISHEDTHISBOOKCOME
BACKANDMAKETHISSERVERCODEMOREROBUST
!NOTHERPOSSIBLE3HARPEN9OUR0ENCILTHATYOUCOULDDORIGHTNOWISTOANNOTATE
THISCODEYOURSELF9OULLUNDERSTANDITMUCHBETTERIFYOUWORKOUTWHATS
HAPPENINGTHANIFWEEXPLAINEDITTOYOU4HENAGAINTHISIS2EADY BAKECODE
SOYOUREALLYDONTHAVETOUNDERSTANDITATALL)TSHEREJUSTTOSUPPORTTHETWO
VERSIONSOFTHE#HAT#LIENT
7RUXQWKHFKDWFOLHQW\RXQHHGWZR
WHUPLQDOV)LUVWODXQFKWKLVVHUYHU
LPSRUWMDYDLR IURPRQHWHUPLQDOWKHQODXQFKWKH
LPSRUWMDYDQHW FOLHQWIURPDQRWKHUWHUPLQDO
LPSRUWMDYDXWLO
SXEOLFFODVV9HU\6LPSOH&KDW6HUYHU^
$UUD\/LVWFOLHQW2XWSXW6WUHDPV
SXEOLFFODVV&OLHQW+DQGOHULPSOHPHQWV5XQQDEOH^
%XIIHUHG5HDGHUUHDGHU
6RFNHWVRFN

SXEOLF&OLHQW+DQGOHU6RFNHWFOLHQW6RFNHW^
WU\^
VRFN FOLHQW6RFNHW
,QSXW6WUHDP5HDGHULV5HDGHU QHZ,QSXW6WUHDP5HDGHUVRFNJHW,QSXW6WUHDP
UHDGHU QHZ%XIIHUHG5HDGHULV5HDGHU

`FORVHFRQVWUXFWRU
SXEOLFYRLGUXQ^
6WULQJPHVVDJH
WU\^
ZKLOHPHVVDJH UHDGHUUHDG/LQH QXOO^
6\VWHPRXWSULQWOQ³UHDG³PHVVDJH
WHOO(YHU\RQHPHVVDJH

`FORVHZKLOH
`FORVHUXQ
`FORVHLQQHUFODVV
FKDSWHU

QHZ9HU\6LPSOH&KDW6HUYHUJR
`
SXEOLFYRLGJR^
FOLHQW2XWSXW6WUHDPV QHZ$UUD\/LVW
WU\^
ZKLOHWUXH^
6RFNHWFOLHQW6RFNHW VHUYHU6RFNDFFHSW
3ULQW:ULWHUZULWHU QHZ3ULQW:ULWHUFOLHQW6RFNHWJHW2XWSXW6WUHDP
FOLHQW2XWSXW6WUHDPVDGGZULWHU
7KUHDGW QHZ7KUHDGQHZ&OLHQW+DQGOHUFOLHQW6RFNHW

WVWDUW
6\VWHPRXWSULQWOQ³JRWDFRQQHFWLRQ´
`

`FDWFK([FHSWLRQH[^
H[SULQW6WDFN7UDFH
`
`FORVHJR
SXEOLFYRLGWHOO(YHU\RQH6WULQJPHVVDJH^
,WHUDWRULW FOLHQW2XWSXW6WUHDPVLWHUDWRU
ZKLOHLWKDV1H[W^
WU\^
3ULQW:ULWHUZULWHU 3ULQW:ULWHULWQH[W
ZULWHUSULQWOQPHVVDJH
ZULWHUÀXVK
`FDWFK([FHSWLRQH[^
H[SULQW6WDFN7UDFH
`

`HQGZKLOH

`FORVHWHOO(YHU\RQH
`FORVHFODVV

\RXDUHKHUH
V\QFKURQL]DWLRQTXHVWLRQV
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: 7HATABOUTPROTECTINGSTATIC Q: 7HYDONTYOUJUSTSYNCHRONIZE
VARIABLESTATE)FYOUHAVESTATIC ALLTHEGETTERSANDSETTERSFROMTHE
METHODSTHATCHANGETHESTATICVARIABLE CLASSWITHTHEDATAYOURETRYINGTO
STATECANYOUSTILLUSESYNCHRONIZATION PROTECT,IKEWHYCOULDNTWEHAVE
SYNCHRONIZEDJUSTTHECHECK"ALANCE
A: 9ES2EMEMBERTHATSTATIC
ANDWITHDRAW METHODSFROMCLASS
"ANK!CCOUNTINSTEADOFSYNCHRONIZING
METHODSRUNAGAINSTTHECLASSANDNOT THEMAKE7ITHDRAWAL METHODFROM
AGAINSTANINDIVIDUALINSTANCEOFTHECLASS THE2UNNABLESCLASS
3OYOUMIGHTWONDERWHOSEOBJECTSLOCK
WOULDBEUSEDONASTATICMETHOD!FTER
ALLTHEREMIGHTNOTEVENBEANYINSTANCES
OFTHATCLASS&ORTUNATELYJUSTASEACH
A: !CTUALLYWESHOULDHAVE
SYNCHRONIZEDTHOSEMETHODSTOPREVENT
OBJECTHASITSOWNLOCKEACHLOADEDCLASS OTHERTHREADSFROMACCESSINGTHOSE
HASALOCK4HATMEANSTHATIFYOUHAVE METHODSINOTHERWAYS7EDIDNTBOTHER
THREE$OGOBJECTSONYOURHEAPYOUHAVE BECAUSEOUREXAMPLEDIDNTHAVEANY
ATOTALOFFOUR$OG RELATEDLOCKS4HREE OTHERCODEACCESSINGTHEACCOUNT
BELONGINGTOTHETHREE$OGINSTANCES
"UTSYNCHRONIZINGTHEGETTERS
ANDONEBELONGINGTOTHE$OGCLASSITSELF
ANDSETTERSORINTHISCASETHE
7HENYOUSYNCHRONIZEASTATICMETHOD
CHECK"ALANCE ANDWITHDRAW ISNT
*AVAUSESTHELOCKOFTHECLASSITSELF3OIF
ENOUGH2EMEMBERTHEPOINTOF
YOUSYNCHRONIZETWOSTATICMETHODSINA
SYNCHRONIZATIONISTOMAKEASPECIFIC
SINGLECLASSATHREADWILLNEEDTHECLASS
SECTIONOFCODEWORK!4/-)#!,,9)N
LOCKTOENTEREITHEROFTHEMETHODS
OTHERWORDSITSNOTJUSTTHEINDIVIDUAL
METHODSWECAREABOUTITSMETHODS
Q: 7HATARETHREADPRIORITIES)VE THATREQUIREMORETHANONESTEPTO
COMPLETE4HINKABOUTIT)FWEHADNOT
HEARDTHATSAWAYYOUCANCONTROL
SCHEDULING SYNCHRONIZEDTHEMAKE7ITHDRAWAL
METHOD2YANWOULDHAVECHECKEDTHE
BALANCEBYCALLINGTHESYNCHRONIZED
A: 4HREADPRIORITIESMIGHTHELP
CHECK"ALANCE ANDTHENIMMEDIATELY
EXITEDTHEMETHODANDRETURNEDTHEKEY
YOUINFLUENCETHESCHEDULERBUTTHEY
STILLDONTOFFERANYGUARANTEE4HREAD /FCOURSEHEWOULDGRABTHEKEYAGAIN
PRIORITIESARENUMERICALVALUESTHATTELL AFTERHEWAKESUPSOTHATHECANCALL
THESCHEDULERIFITCARES HOWIMPORTANTA THESYNCHRONIZEDWITHDRAW METHOD
THREADISTOYOU)NGENERALTHESCHEDULER BUTTHISSTILLLEAVESUSWITHTHESAME
WILLKICKALOWERPRIORITYTHREADOUTOFTHE PROBLEMWEHADBEFORESYNCHRONIZATION
RUNNINGSTATEIFAHIGHERPRIORITYTHREAD 2YANCANCHECKTHEBALANCEGOTOSLEEP
SUDDENLYBECOMESRUNNABLE"UTONE AND-ONICACANCOMEINANDALSOCHECK
MORETIMESAYITWITHMENOWhTHERE THEBALANCEBEFORE2YANHASACHANCETO
ISNOGUARANTEEv7ERECOMMENDTHAT WAKESUPANDCOMPLETESHISWITHDRAWAL
YOUUSEPRIORITIESONLYIFYOUWANTTO 3OSYNCHRONIZINGALLTHEACCESSMETHODS
INFLUENCEPERFORMANCEBUTNEVEREVER ISPROBABLYAGOODIDEATOPREVENT
RELYONTHEMFORPROGRAMCORRECTNESS OTHERTHREADSFROMGETTINGINBUTYOU
STILLNEEDTOSYNCHRONIZETHEMETHODS
THATHAVESTATEMENTSTHATMUSTEXECUTE
ASONEATOMICUNIT
FKDSWHU
Code Kitchen
Licensed by
Eduard Simons \RX U P H VV D J H JHWVVHQWW
OD\HUVDORQJ

R
GDQFHEHDW WKHRWKHUS XUUHQWEHDW
104038
ZLWK\RXUF HQ\RXKLW
SDWWHUQZK
´VHQG,Wµ
$QG\JURRYH
&KULVJURRYHUHYLVHG
LQFRPLQJPH
SOD\HUV&OLFVVDJHVIURP
1LJHOGDQFHEHDW
WKHSDWWHUQ NRQHWRORDG
ZLWKLWDQG WKDWJRHV
¶6WDUW·WRS WKHQFOLFN
OD\LW
This is the last version of the BeatBox!
It connects to a simple MusicServer so that you can
send and receive beat patterns with other clients.
The code is really long, so the complete listing is
actually in Appendix A.
\RXDUHKHUH
H[HUFLVH&RGH0DJQHWV
Code Magnets
!WORKING*AVAPROGRAMISSCRAMBLEDUPONTHEFRIDGE#AN
YOUADDTHECODESNIPPETSONTHENEXTPAGETOTHEEMPTY
1dQÔU_Q CLASSESBELOWTOMAKEAWORKING*AVAPROGRAMTHATPRO
DUCESTHEOUTPUTLISTED3OMEOFTHECURLYBRACESFELLONTHE
FLOORANDTHEYWERETOOSMALLTOPICKUPSOFEELFREETOADDAS
MANYOFTHOSEASYOUNEED
SXEOLFFODVV7HVW7KUHDGV^ FODVV7KUHDG2QH
FODVV$FFXP^
FODVV7KUHDG7ZR
)LOH(GLW:LQGRZ+HOS6HZLQJ
MDYD7HVW7KUHDGV
RQH
WZR
"ONUS1UESTION7HYDOYOUTHINKWEUSEDTHE
MODIFIERSWEDIDINTHE!CCUMCLASS
FKDSWHU
Code Magnets, continued..

$FFXPD $FFXPJHW$FFXP

´WZR´DJHW&RXQW
7KUHDGRQH QHZ7
KUHDGW 6\VWHPRXWSULQWOQ
Z7KUHDG7ZR
WU\^
G([FHSWLRQH[^` 7KUHDG7ZRW QH
`FDWFK,QWHUUXSWH
FRXQWHU DGG
UHWXUQFRXQWHU
7KUHDGW
Z R QHZ
7KU HDGW LPSOHPHQWV5XQQDEOH^ RQHVWDUW
7KUHDGVOHHS
G([FHSWLRQH[^`
`FDWFK,QWHUUXSWH
SXEOLFVWDWLF$FFXPJHW$FFXP^

XPD QHZ$FFXP
SULYDWHVWDWLF$FF
SULYDWHLQWFRXQ
WHU
Q ^
SXEOLFYRLGUX
DXSGDWH&RXQWHU 7KUHDGV
OHHS

IRULQW[ [

[ ^ LPSOHPHQWV5XQQDEOH^

DXSGDWH&RXQWHU
SXEOLFL UHWXUQD
QWJHW&R
XQW^
6\VWHPRXWSULQW
OQ´RQH´DJHW&
RXQW
SXEOLFYRLGXSGD
WH&RXQ WHULQWDGG^
IRULQW[ [
[ WZRVWDUW
^
WU\^
Q^
SXEOLFYRLGUX SULYDWH$FFXP^` Z7KUHDG2QH
7KUHDG2QHW QH
\RXDUHKHUH
H[HUFLVHVROXWLRQV
SXEOLFFODVV7HVW7KUHDGV^ %XERCISE3OLUTIONS
7KUHDG2QHW QHZ7KUHDG2QH
7KUHDG7ZRW QHZ7KUHDG7ZR
7KUHDGRQH QHZ7KUHDGW
7KUHDGWZR QHZ7KUHDGW
RQHVWDUW
WZRVWDUW
7KUHDGVIURPWZRGLIIHUHQWFODVVHVDUHXSGDWLQJ
QFH
DWLFLQVWD
` WKHVDPHREMHFWLQDWKLUGFODVVEHFDXVHERWK
` FUHDWHDVWFFXP WKUHDGVDUHDFFHVVLQJDVLQJOHLQVWDQFHRI$FFXP
RIFODVV$ 7KHOLQHRIFRGH
FODVV$FFXP^ PRIVATESTATIC!CCUMANEW!CCUM FUHDWHVD

SULYDWHVWDWLF$FFXPD QHZ$FFXP VWDWLFLQVWDQFHRI$FFXPUHPHPEHUVWDWLFPHDQV
SULYDWHLQWFRXQWHU RQHSHUFODVVDQGWKHSULYDWHFRQVWUXFWRULQ
$FFXPPHDQVWKDWQRRQHHOVHFDQPDNHDQ$FFXP
QVWUXFW RU
SULYDWH$FFXP^` $SULYDWHFR REMHFW7KHVHWZRWHFKQLTXHVSULYDWHFRQVWUXFWRU
DQGVWDWLFJHWWHUPHWKRGXVHGWRJHWKHUFUHDWH
SXEOLFVWDWLF$FFXPJHW$FFXP^ ZKDW·VNQRZQDVD¶6LQJOHWRQ·DQ22SDWWHUQWR
UHWXUQD UHVWULFWWKHQXPEHURILQVWDQFHVRIDQREMHFW
` WKDWFDQH[LVWLQDQDSSOLFDWLRQ8VXDOO\WKHUH·V
MXVWDVLQJOHLQVWDQFHRID6LQJOHWRQ³KHQFHWKH
SXEOLFYRLGXSGDWH&RXQWHULQWDGG^ QDPHEXW\RXFDQXVHWKHSDWWHUQWRUHVWULFWWKH
FRXQWHU DGG LQVWDQFHFUHDWLRQLQZKDWHYHUZD\\RXFKRRVH
`
SXEOLFLQWJHW&RXQW^
UHWXUQFRXQWHU
` FODVV7KUHDG7ZRLPSOHPHQWV5XQQDEOH^
` $FFXPD $FFXPJHW$FFXP
SXEOLFYRLGUXQ^
FODVV7KUHDG2QHLPSOHPHQWV5XQQDEOH^
IRULQW[ [[^
DXSGDWH&RXQWHU
SXEOLFYRLGUXQ^ WU\^
IRULQW[ [[^ 7KUHDGVOHHS
DXSGDWH&RXQWHU `FDWFK,QWHUUXSWHG([FHSWLRQH[^`
WU\^ `
7KUHDGVOHHS 6\VWHPRXWSULQWOQ´WZR´DJHW&RXQW
`FDWFK,QWHUUXSWHG([FHSWLRQH[^` `

`
`
6\VWHPRXWSULQWOQ´RQH´DJHW&RXQW
`
`
FKDSWHU
1HDUPLVVDWWKH$LUORFN
$V6DUDKMRLQHGWKHRQERDUGGHYHORSPHQWWHDP¶VGHVLJQUHYLHZPHHWLQJVKHJD]HGRXW
WKHSRUWDODWVXQULVHRYHUWKH,QGLDQ2FHDQ(YHQWKRXJKWKHVKLS¶VFRQIHUHQFHURRPZDV
LQFUHGLEO\FODXVWURSKRELFWKHVLJKWRIWKHJURZLQJEOXHDQGZKLWHFUHVFHQWRYHUWDNLQJQLJKWRQ
WKHSODQHWEHORZ¿OOHG6DUDKZLWKDZHDQGDSSUHFLDWLRQ
)LYH0LQXWH 7KLVPRUQLQJ¶VPHHWLQJZDVIRFXVHGRQWKHFRQWUROV\VWHPVIRUWKHRUELWHU¶VDLUORFNV
0\VWHU\ $VWKH¿QDOFRQVWUXFWLRQSKDVHVZHUHQHDULQJWKHLUHQGWKHQXPEHURIVSDFHZDONVZDV
VFKHGXOHGWRLQFUHDVHGUDPDWLFDOO\DQGWUDI¿FZDVKLJKERWKLQDQGRXWRIWKHVKLS¶V
DLUORFNV³*RRGPRUQLQJ6DUDK´VDLG7RP³<RXUWLPLQJLVSHUIHFWZH¶UHMXVWVWDUWLQJ
WKHGHWDLOHGGHVLJQUHYLHZ´
³$V\RXDOONQRZ´VDLG7RP³(DFKDLUORFNLVRXW¿WWHGZLWKVSDFHKDUGHQHG*8,
WHUPLQDOVERWKLQVLGHDQGRXW:KHQHYHUVSDFHZDONHUVDUHHQWHULQJRUH[LWLQJWKHRUELWHU
WKH\ZLOOXVHWKHVHWHUPLQDOVWRLQLWLDWHWKHDLUORFNVHTXHQFHV´6DUDKQRGGHG³7RPFDQ
\RXWHOOXVZKDWWKHPHWKRGVHTXHQFHVDUHIRUHQWU\DQGH[LW"´7RPURVHDQGÀRDWHGWRWKH
ZKLWHERDUG³)LUVWKHUH¶VWKHH[LWVHTXHQFHPHWKRG¶VSVHXGRFRGH´7RPTXLFNO\ZURWHRQWKH
ERDUG
RUELWHU$LUORFN([LW6HTXHQFH
YHULI\3RUWDO6WDWXV
SUHVVXUL]H$LUORFN
RSHQ,QQHU+DWFK
FRQ¿UP$LUORFN2FFXSLHG
FORVH,QQHU+DWFK
GHFRPSUHVV$LUORFN
RSHQ2XWHU+DWFK
FRQ¿UP$LUORFN9DFDWHG
FORVH2XWHU+DWFK
³7RHQVXUHWKDWWKHVHTXHQFHLVQRWLQWHUUXSWHGZHKDYHV\QFKURQL]HGDOORIWKH
PHWKRGVFDOOHGE\WKHRUELWHU$LUORFN([LW6HTXHQFHPHWKRG´7RPH[SODLQHG³:H¶GKDWHWR
VHHDUHWXUQLQJVSDFHZDONHULQDGYHUWHQWO\FDWFKDEXGG\ZLWKKLVVSDFHSDQWVGRZQ´
(YHU\RQHFKXFNOHGDV7RPHUDVHGWKHZKLWHERDUGEXWVRPHWKLQJGLGQ¶WIHHOULJKW
WR6DUDKDQGLW¿QDOO\FOLFNHGDV7RPEHJDQWRZULWHWKHHQWU\VHTXHQFHSVHXGRFRGHRQWKH
ZKLWHERDUG³:DLWDPLQXWH7RP´FULHG6DUDK³,WKLQNZH¶YHJRWDELJÀDZLQWKHH[LW
VHTXHQFHGHVLJQOHW¶VJREDFNDQGUHYLVLWLWLWFRXOGEHFULWLFDO´
:K\GLG6DUDKVWRSWKHPHHWLQJ":KDWGLGVKHVXVSHFW"
\RXDUHKHUH
SX]]OHDQVZHUV
?PI\LQL;IZIPSVW_'
3ARAHREALIZEDTHATINORDERTOENSURETHATTHEENTIREEXIT
SEQUENCEWOULDRUNWITHOUTINTERRUPTIONTHE
RUELWHU$LUORFN([LW6HTXHQFH METHODNEEDEDTO
BESYNCHRONIZED!STHEDESIGNSTOODITWOULDBEPOSSIBLE
FORARETURNINGSPACEWALKERTOINTERRUPTTHE%XIT3EQUENCE
4HE%XIT3EQUENCETHREADCOULDNTBEINTERRUPTEDINTHE
MIDDLEOFANYOFTHELOWERLEVELMETHODCALLSBUTITCOULDBE
INTERRUPTEDINBETWEENTHOSECALLS3ARAHKNEWTHATTHEENTIRE
SEQUENCESHOULDBERUNASONEATOMICUNITANDIFTHERUELW
HU$LUORFN([LW6HTXHQFHMETHODWASSYNCHRONIZEDIT
COULDNOTBEINTERRUPTEDATANYPOINT
FKDSWHU
FROOHFWLRQVDQGJHQHULFV
'DWD 6KHHVKDQGDOO
VWUXFWXUHV WKLVWLPH,FRXOGKDYHMXVWOHW
-DYDSXWWKLQJVLQDOSKDEHWLFDO
RUGHU"7KLUGJUDGHUHDOO\
VXFNV:HQHYHUOHDUQ
DQ\WKLQJXVHIXO
6RUWLQJLVDVQDSLQ-DYD9OUHAVEALLTHETOOLSFORCOLLECTINGANDMANIPULATING
YOURDATAWITHOUTHAVINGTOWRITEYOUROWNSORTALGORITHMSUNLESSYOUREREADINGTHISRIGHT
NOWSITTINGINYOUR#OMPUTER3CIENCECLASSINWHICHCASETRUSTUSYOUARE3/GOINGTOBE
WRITINGSORTCODEWHILETHERESTOFUSJUSTCALLAMETHODINTHE*AVA!0) 4HE*AVA#OLLECTIONS
&RAMEWORKHASADATASTRUCTURETHATSHOULDWORKFORVIRTUALLYANYTHINGYOULLEVERNEEDTODO
7ANTTOKEEPALISTTHATYOUCANEASILYKEEPADDINGTO7ANTTOFINDSOMETHINGBYNAME7ANT
TOCREATEALISTTHATAUTOMATICALLYTAKESOUTALLTHEDUPLICATES3ORTYOURCO WORKERSBYTHE
NUMBEROFTIMESTHEYVESTABBEDYOUINTHEBACK3ORTYOURPETSBYNUMBEROFTRICKSLEARNED
)TSALLHERE
WKLVLVDQHZFKDSWHU
VRUWLQJDOLVW
<ZIKSQVO[WVOXWX]TIZQ\aWVaW]ZR]SMJW`
#ONGRATULATIONSONYOURNEWJOBMANAGINGTHEAUTOMATED
JUKEBOXSYSTEMAT,OUS$INER4HERESNO*AVAINSIDETHE
JUKEBOXITSELFBUTEACHTIMESOMEONEPLAYSASONGTHE
SONGDATAISAPPENDEDTOASIMPLETEXTlLE
9OURJOBISTOMANAGETHEDATATOTRACKSONGPOPULARITY
GENERATEREPORTSANDMANIPULATETHEPLAYLISTS9OURENOT
WRITINGTHEENTIREAPPSOMEOFTHEOTHERSOFTWAREDEVELOPER
WAITERSAREINVOLVEDASWELLBUTYOURERESPONSIBLEFORMANAGING
ANDSORTINGTHEDATAINSIDETHE*AVAAPP!NDSINCE,OUHASATHING
AGAINSTDATABASESTHISISSTRICTLYANIN MEMORYDATACOLLECTION!LL
YOUGETISTHElLETHEJUKEBOXKEEPSADDINGTO9OURJOBISTOTAKEIT
FROMTHERE
9OUVEALREADYlGUREDOUTHOWTOREADANDPARSETHElLEANDSOFAR
YOUVEBEENSTORINGTHEDATAINAN!RRAY,IST
6RQJ/LVWW[W
&KDOOHQJH
3LQN0RRQ1LFN'UDNH 6RUWWKHVRQJVLQDOSKDEHWLFDORUGHU
6RPHUVDXOW=HUR
9OUHAVEALISTOFSONGSINAlLEWHEREEACHLINE
6KLYD0RRQ3UHP-RVKXD
REPRESENTSONESONGANDTHETITLEANDARTISTARE
&LUFOHV%7
SEPARATEDWITHAFORWARDSLASH3OITSHOULDBESIMPLE
'HHS&KDQQHO$IUR&HOWV
TOPARSETHELINEANDPUTALLTHESONGSINAN!RRAY,IST
3DVVHQJHU+HDGPL[
/LVWHQ7DKLWL 9OURBOSSCARESONLYABOUTTHESONGTITLESSOFORNOW
YOUCANSIMPLYMAKEALISTTHATJUSTHASTHESONGTITLES
"UTYOUCANSEETHATTHELISTISNOTINALPHABETICAL
ORDERWHATCANYOUDO
9OUKNOWTHATWITHAN!RRAY,ISTTHEELEMENTSARE
KEPTINTHEORDERINWHICHTHEYWEREINSERTEDINTOTHE
LISTSOPUTTINGTHEMINAN!RRAY,ISTWONTTAKECAREOF
ALPHABETIZINGTHEMUNLESSMAYBETHERESASORT
METHODINTHE!RRAY,ISTCLASS
H
KHMXNHER[GHYLF
7KLVLVWKHIULOHFRWGHPXVWUHDGWKHILOH
ZULWHV<RX DWHWKHVRQJGDWD
WKHQPDQLSXO
FKDSWHU
FROOHFWLRQVZLWKJHQHULFV
0MZM¼[_PI\aW]PI^M[WNIZ_Q\PW]\\PM[WZ\"
LPSRUWMDYDXWLO
LPSRUWMDYDLR QJWLWOHVLQ
:H·OOVWRUHWKWHRIVR6WULQJV
SXEOLFFODVV-XNHER[^ DQ$UUD\/LV

$UUD\/LVW6WULQJ!VRQJ/LVW QHZ$UUD\/LVW6WULQJ!

QHZ-XNHER[JR
` JWKH
VWDUWVORDGLQQW
7 KH P HW KR GWK DW WH VRI
QSULQWVWKHFRQ

SXEOLFYRLGJR^ ILOHDQGWKHW D\/LV W
JHW6RQJV WKHVRQJ/LV $UU
6\VWHPRXWSULQWOQVRQJ/LVW
`
QG
UHDGWKHILOHD
FLDOKHUHMXKRVWGIRUHDFKOLQH
1RWKLQJVSHG6 PHW
YRLGJHW6RQJV^ FDOOWKHDG RQJ
WU\^
)LOH¿OH QHZ)LOH³6RQJ/LVWW[W´
6WULQJOLQH QXOO
DGG6RQJOLQH
`
`FDWFK([FHSWLRQH[^
H[SULQW6WDFN7UDFH
7KHDGG
`
&DUGLQW6KRHQJPHWKRGZRUNVMXVW
`
WKDWKD ,2FKDSWHU RXEOLNHWKH4XL]

SLHFHVWRVNEHRWKWKHWLWOHDQG\D UHDNW OLQH
UWLVWLQWKRHW
YRLGDGG6RQJ6WULQJOLQH7R3DUVH^ QVXVLQJWKH
6WULQJ>@WRNHQV OLQH7R3DUVHVSOLW³´ VSOLWPHWK ZR
RG
VRQJ/LVWDGGWRNHQV>@
` :HRQO\ZDQWWK
DGGR HVRQJWLWOHVR
QO\WKHILUVWWRN
` 6RQJ/LVWWKH HQWRWKH
$UUD\/LVW
WVRXWZLWKWKH
MDYD-XNHER[ 7KHVRQJ/LVWSULQ WKH\

>3LQN0RRQ6RPHUVDXOW VRQJVLQWKHRUGHWKUHLQ$UZKUDLFK
\/ LVWZKLFK
6KLYD0RRQ&LUFOHV ZHUHDGGHGWR HUWKHVRQJVDUHLQ
'HHS&KDQQHO3DVVHQJHU LVWKHVDPHRUG QDOWH[WILOH
ZLWKLQWKHRULJL
/LVWHQ@
OSKDEHWLFDO
7KLVLVGHILQLWHO\127D
\RXDUHKHUH

$UUD\/LVW$3,
*]\\PM)ZZIa4Q[\KTI[[LWM[67<PI^MI[WZ\UM\PWL
7HENYOULOOKIN!RRAY,ISTTHEREDOESNTSEEMTOBEANYMETHODRELATEDTOSORTING
7ALKINGUPTHEINHERITANCEHIERARCHYDIDNTHELPEITHERITSCLEARTHATYOUCANTCALLASORT
METHODONTHE!RRAY,IST
$UUD\/LVWKDVDORW
RIPHWKRGV
EXWWKHUH·VQRWKLQJ
KHUHWKDW
ORRNVOLNHLWZRXOGVRU
W
FKDSWHU
,GRVHHDFROOHFWLRQFODVV
FDOOHG7UHH6HWDQGWKHGRFV
VD\WKDWLWNHHSV\RXUGDWD
VRUWHG,ZRQGHULI,VKRXOGEH
XVLQJD7UHH6HWLQVWHDGRIDQ
$UUD\/LVW
)ZZIa4Q[\Q[VW\\PMWVTaKWTTMK\QWV
!LTHOUGH!RRAY,ISTISTHEONEYOULLUSEMOSTOFTEN
Licensed by
THEREAREOTHERSFORSPECIALOCCASIONS3OMEOFTHEKEY
U\LQJ
COLLECTIONCLASSESINCLUDE ·WZRUU\DERXWW
'RQ WKHURQHV
WROHDUQWKH:VHH·ROOJRLQWR
ULJKWQRZ DOLWWOHODWHU
7UHH6HW
PRUHGHWDLOV
Eduard Simons
.HHSVWKHHOHPHQWVVRUWHGDQGSUHYHQWVGXSOLFDWHV
+DVK0DS
104038
/HW·V\RXVWRUHDQGDFFHVVHOHPHQWVDVQDPHYDOXHSDLUV
/LQNHG/LVW
'HVLJQHGWRJLYHEHWWHUSHUIRUPDQFHZKHQ\RXLQVHUWRUGHOHWH
HOHPHQWVIURPWKHPLGGOHRIWKHFROOHFWLRQ,QSUDFWLFHDQ
$UUD\/LVWLVVWLOOXVXDOO\ZKDW\RXZDQW
+DVK6HW
3UHYHQWVGXSOLFDWHVLQWKHFROOHFWLRQDQGJLYHQDQHOHPHQWFDQ
ILQGWKDWHOHPHQWLQWKHFROOHFWLRQTXLFNO\
/LQNHG+DVK0DS
/LNHDUHJXODU+DVK0DSH[FHSWLWFDQUHPHPEHUWKHRUGHULQ
ZKLFKHOHPHQWVQDPHYDOXHSDLUVZHUHLQVHUWHGRULWFDQEH
FRQILJXUHGWRUHPHPEHUWKHRUGHULQZKLFKHOHPHQWVZHUHODVW
DFFHVVHG
\RXDUHKHUH
&ROOHFWLRQVVRUW
AW]KW]TL][MI<ZMM;M\
7ZaW]KW]TL][M\PM+ WTTMK\QWV[[WZ\UM\PWL
)FYOUPUTALLTHE3TRINGSTHESONGTITLES INTOA4REE3ETINSTEADOF
AN!RRAY,ISTTHE3TRINGSWOULDAUTOMATICALLYLANDINTHERIGHTPLACE
ALPHABETICALLYSORTED7HENEVERYOUPRINTEDTHELISTTHEELEMENTSWOULD
ALWAYSCOMEOUTINALPHABETICALORDER
!NDTHATSGREATWHENYOUNEEDASETWELL MDYDXWLO&ROOHFWLRQV
TALKABOUTSETSINAFEWMINUTES ORWHEN VWLQDWLRQ/LVWVRXUFH
YOUKNOWTHATTHELISTMUSTALWAYSSTAY SXEOLFVWDWLFYRLGFRS\/LVWGH
SXEOLFVWDWLF/LVWHPSW\/LVW
SORTEDALPHABETICALLY
LOO2EMHFWREM7R)LOO,W:LWK
/NTHEOTHERHANDIFYOUDONTNEEDTHE SXEOLFVWDWLFYRLGILOO/LVWOLVW7R)
LISTTOSTAYSORTED4REE3ETMIGHTBEMORE OOHFWLRQF2EMHFWR
EXPENSIVETHANYOUNEEDEVERYTIMEYOU SXEOLFVWDWLFLQWIUHTXHQF\&R
WOLVW
INSERTINTOA4REE3ETTHE4REE3ETHASTOTAKE SXEOLFVWDWLFYRLGUHYHUVH/LV
THETIMETOlGUREOUTWHEREINTHETREETHENEW WLQWGLVWDQFH
SXEOLFVWDWLFYRLGURWDWH/LVWOLV
ELEMENTMUSTGO7ITH!RRAY,ISTINSERTSCAN
/LVWOLVW
BEBLINDINGLYFASTBECAUSETHENEWELEMENT SXEOLFVWDWLFYRLGVKXIIOH
W
JUSTGOESINATTHEEND SXEOLFVWDWLFYRLGVRUW/LVWOLV
MHFWQHZ9DO
SXEOLFVWDWLFERROHDQUHSODF
H$OO/LVWOLVW2EMHFWROG9DO2E
Q: "UTYOU#!.ADDSOMETHINGTOAN PDQ\PRUHPHWKRGV +PPPWKHUH,6DVR

UWPHWKRG
!RRAY,ISTATASPECIlCINDEXINSTEADOFJUSTAT LQWKH&ROOHFWLRQVFOD
THEENDTHERESANOVERLOADEDADD METHOD VV,WWDNHV
THATTAKESANINTALONGWITHTHEELEMENTTOADD D/LVWDQGVLQFH$UU
3OWOULDNTITBESLOWERTHANINSERTINGATTHEEND D\/LVW
LPSOHPHQWVWKH/LVWLQ
WHUIDFH
$UUD\/LVW,6$/LVW
A: 9ESITSSLOWERTOINSERTSOMETHINGINAN!RRAY,IST
WRSRO\PRUSKLVP\RX
7KDQNV
SOMEWHEREOTHERTHANATTHEEND3OUSINGTHEOVERLOADED FDQSDVVDQ
ADDINDEXELEMENT METHODDOESNTWORKASQUICKLYASCALLING $UUD\/LVWWRDPHWK
THEADDELEMENT WHICHPUTSTHEADDEDELEMENTATTHEEND RGGHFODUHG
"UTMOSTOFTHETIMEYOUUSE!RRAY,ISTSYOUWONTNEEDTOPUT
WRWDNH/LVW
SOMETHINGATASPECIFICINDEX
Q: )SEETHERESA,INKED,ISTCLASSSOWOULDNTTHATBEBETTERFOR
DOINGINSERTSSOMEWHEREINTHEMIDDLE!TLEASTIF)REMEMBERMY$ATA
3TRUCTURESCLASSFROMCOLLEGE
A: 9ESGOODSPOT4HE,INKED,ISTCANBEQUICKERWHENYOUINSERTOR
KHUHDO&ROOHFWLRQV
1RWHWKLVLV127W LHGLWKHUHE\OHDYLQJ
REMOVESOMETHINGFROMTHEMIDDLEBUTFORMOSTAPPLICATIONSTHEDIFFERENCE
FODVV$3,ZHVLPSOLI LQIRUPDWLRQZKLFK
BETWEENMIDDLEINSERTSINTOA,INKED,ISTAND!RRAY,ISTISUSUALLYNOTENOUGH
RXWWKHJHQHULFW\SH JHV
TOCAREABOUTUNLESSYOUREDEALINGWITHAHUGENUMBEROFELEMENTS7ELL
\RX·OOVHHLQDIHZSD
LOOKMOREAT,INKED,ISTINAFEWMINUTES
FKDSWHU
)LLQVO+WTTMK\QWV[[WZ\\W\PM2]SMJW`KWLM
LPSRUWMDYDXWLO
LPSRUWMDYDLR
SXEOLFFODVV-XNHER[^ 7KH&ROOHFWLRQVVRUW

$UUD\/LVW6WULQJ!VRQJ/LVW QHZ$UUD\/LVW6WULQJ!
PHWKRGVRUWVDOLVWRI
6WULQJVDOSKDEHWLFDOO\
QHZ-XNHER[JR
`

SXEOLFYRLGJR^
JHW6RQJV
&DOOWKHVWDW LF&ROOHFWLRQVW WKH
6\VWHPRXWSULQWOQVRQJ/LVW KRGWKHQSULQ VRUWPHW KHVHFRQGSULQWRXW
&ROOHFWLRQVVRUWVRQJ/LVW
6\VWHPRXWSULQWOQVRQJ/LVW OLVWDJDLQ7HWLFDORUGHU
` LVLQDOSKDE

YRLGJHW6RQJV^
WU\^
6WULQJOLQH QXOO
DGG6RQJOLQH
`
`FDWFK([FHSWLRQH[^
H[SULQW6WDFN7UDFH
`
`

YRLGDGG6RQJ6WULQJOLQH7R3DUVH^
6WULQJ>@WRNHQV OLQH7R3DUVHVSOLW³´
VRQJ/LVWDGGWRNHQV>@
`
`
)LOH(GLW:LQGRZ+HOS&KLOO
MDYD-XNHER[
W
>3LQN0RRQ6RPHUVDXOW6KLYD0RRQ&LUFOHV'HHS %HIRUHFDOOLQJVRU
&KDQQHO3DVVHQJHU/LVWHQ@

>&LUFOHV'HHS&KDQQHO/LVWHQ3DVVHQJHU3LQN $IWHUFDOOLQJVRUW
0RRQ6KLYD0RRQ6RPHUVDXOW@
\RXDUHKHUH
VRUWLQJ\RXURZQREMHFWV
*]\VW_aW]VMML;WVOWJRMK\[
VW\R][\[QUXTM;\ZQVO[
.OWYOURBOSSWANTSACTUAL3ONGCLASSINSTANCESINTHELISTNOTJUST 6RQJ/LVW0RUHW[W
3TRINGSSOTHATEACH3ONGCANHAVEMOREDATA4HENEWJUKEBOX
DEVICEOUTPUTSMOREINFORMATIONSOTHISTIMETHElLEWILLHAVEFOUR
PIECESTOKENS INSTEADOFJUSTTWO 3LQN0RRQ1LFN'UDNH
6RPHUVDXOW=HUR
4HE3ONGCLASSISREALLYSIMPLEWITHONLYONEINTERESTINGFEATURE 6KLYD0RRQ3UHP-RVKXD
THEOVERRIDDENTO3TRING METHOD2EMEMBERTHETO3TRING &LUFOHV%7
METHODISDElNEDINCLASS/BJECTSOEVERYCLASSIN*AVAINHERITSTHE 'HHS&KDQQHO$IUR&HOWV
METHOD!NDSINCETHETO3TRING METHODISCALLEDONANOBJECT 3DVVHQJHU+HDGPL[
WHENITSPRINTED3YSTEMOUTPRINTLNAN/BJECT YOUSHOULD /LVWHQ7DKLWL
OVERRIDEITTOPRINTSOMETHINGMOREREADABLETHANTHEDEFAULT
UNIQUEIDENTIlERCODE7HENYOUPRINTALISTTHETO3TRING
7KHQHZVRQJILOHKROGVIRXU
METHODWILLBECALLEDONEACHOBJECT DWWULEXWHVLQVWHDGRIMXVWWZ
$QGZHZDQW$//RIWKHPLQR RXU
FODVV6RQJ^ OLVWVRZHQHHGWRPDNHD6RQJ
LDEOHVIRUWKH
)RXULQVWDQFHWUYLEDUXWHVLQWKHILOH FODVVZLWKLQVWDQFHYDULDEOHVIRUDOO
6WULQJWLWOH
6WULQJDUWLVW
IRXUVRQJDW IRXUVRQJDWWULEXWHV
6WULQJUDWLQJ
6WULQJESP

6RQJ6WULQJW6WULQJD6WULQJU6WULQJE^
WLWOH W
DUWLVW D 7KHYDULDEOHVDUHDOOVHWLQ
UDWLQJ U WKHFRQVWUXFWRUZKHQWKH
ESP E QHZ6RQJLVFUHDWHG
`

SXEOLF6WULQJJHW7LWOH^
UHWXUQWLWOH
`

SXEOLF6WULQJJHW$UWLVW^
UHWXUQDUWLVW
` 7KHJHWWHUPHWKRGVIRU
WKHIRXUDWWULEXWHV
SXEOLF6WULQJJHW5DWLQJ^
UHWXUQUDWLQJ
`

SXEOLF6WULQJJHW%SP^
UHWXUQESP
`
:HRYHUULGHWR6WULQJEHFD
SXEOLF6WULQJWR6WULQJ^ RXWSULQWOQD6RQJ2EMHF XVHZKHQ\RXGRD6\VWHP
UHWXUQWLWOH
W Z HZ
:KHQ\RXGRD6\VWHPRXWSU DQWWRVHHWKHWLWOH
LQWOQD/LVW2I QJVLWFDO

`
` WKHWR6WULQJPHWKRG RI($&+HOHPHQWLQ6RWK OV
HOLVW
FKDSWHU
+PIVOQVO\PM2]SMJW`KWLM\W][M;WVO[
QV[\MILWN;\ZQVO[
9OURCODECHANGESONLYALITTLETHElLE)/CODEISTHESAME
ANDTHEPARSINGISTHESAME3TRINGSPLIT EXCEPTTHISTIME
THEREWILLBEFOURTOKENSFOREACHSONGLINEANDALLFOURWILLBE
USEDTOCREATEANEW3ONGOBJECT!NDOFCOURSETHE!RRAY,IST
WILLBEOFTYPE3ONGINSTEADOF3TRING
RQJ
Q$UUD\/LVWJRI6
LPSRUWMDYDXWLO
LPSRUWMDYDLR &KDQJHWRDHD RI 6 WU LQ
REMHFWVLQVW G
SXEOLFFODVV-XNHER[^
$UUD\/LVW6RQJ!VRQJ/LVW QHZ$UUD\/LVW6RQJ!
QHZ-XNHER[JR
`
SXEOLFYRLGJR^
JHW6RQJV
`
YRLGJHW6RQJV^
WU\^
6WULQJOLQH QXOO
DGG6RQJOLQH
`
`FDWFK([FHSWLRQH[^
H[SULQW6WDFN7UDFH
`
`
6RQJQH[W6RQJ QHZ6RQJWRNHQV>@WRNHQV>@WRNHQV>@WRNHQV>@

VRQJ/LVWDGGQH[W6RQJ
` &UHDWHDQHZ6RQ
` ZKLFKPHDQVWKHIJREMHFWXVLQJWKHIRXUWRNHQV
IRUWKLVOLQHWKHQRXUSLHFHVRILQIRLQWKHVRQJILOH
DGGWKH6RQJWRWK
HOLVW
\RXDUHKHUH
&ROOHFWLRQVVRUW
1\_WV¼\KWUXQTM
3OMETHINGSWRONGTHE#OLLECTIONSCLASSCLEARLYSHOWSTHERESA
SORT METHODTHATTAKESA,IST
!RRAY,ISTIS A,ISTBECAUSE!RRAY,ISTIMPLEMENTSTHE,ISTINTERFACE
SOITSHOULDWORK
"UTITDOESNT
4HECOMPILERSAYSITCANTlNDASORTMETHODTHATTAKESAN
!RRAY,IST3ONGSOMAYBEITDOESNTLIKEAN!RRAY,ISTOF3ONG
OBJECTS)TDIDNTMINDAN!RRAY,IST3TRINGSOWHATSTHE
IMPORTANTDIFFERENCEBETWEEN3ONGAND3TRING7HATSTHE
DIFFERENCETHATSMAKINGTHECOMPILERFAIL
)LOH(GLW:LQGRZ+HOS%XPPHU
MDYDF-XNHER[MDYD
-XNHER[MDYDFDQQRW¿QGV\PERO
V\PEROPHWKRGVRUWMDYDXWLO$UUD\/LVW6RQJ!
ORFDWLRQFODVVMDYDXWLO&ROOHFWLRQV
A
HUURU
!NDOFCOURSEYOUPROBABLYALREADYASKEDYOURSELFh7HATWOULDIT
BESORTINGONv(OWWOULDTHESORTMETHODEVENKNOWWHATMADE
ONE3ONGGREATERORLESSTHANANOTHER3ONG/BVIOUSLYIFYOUWANT
THESONGSTITLETOBETHEVALUETHATDETERMINESHOWTHESONGSARE
SORTEDYOULLNEEDSOMEWAYTOTELLTHESORTMETHODTHATITNEEDS
TOUSETHETITLEANDNOTSAYTHEBEATSPERMINUTE
7ELLGETINTOALLTHATAFEWPAGESFROMNOWBUTlRSTLETSlNDOUT
WHYTHECOMPILERWONTEVENLETUSPASSA3ONG!RRAY,ISTTOTHE
SORT METHOD
FKDSWHU
:7)",KDYHQRLGHDKRZWR
UHDGWKHPHWKRGGHFODUDWLRQ
RQWKLV,WVD\VWKDWVRUW
WDNHVD/LVW7!EXWZKDWLV
7"$QGZKDWLVWKDWELJWKLQJ
EHIRUHWKHUHWXUQW\SH"
<PM[WZ\UM\PWLLMKTIZI\QWV
&ROMTHE!0)DOCSLOOKINGUPTHEJAVAUTIL#OLLECTIONSCLASSANDSCROLLINGTOTHESORT
METHOD ITLOOKSLIKETHESORT METHODISDECLAREDSTRANGELY/RATLEASTDIFFERENTFROM
ANYTHINGWEVESEENSOFAR
4HATSBECAUSETHESORT METHODALONGWITHOTHERTHINGSINTHEWHOLECOLLECTIONFRAMEWORKIN
*AVA MAKESHEAVYUSEOFGENERICS!NYTIMEYOUSEESOMETHINGWITHANGLEBRACKETSIN*AVASOURCE
CODEORDOCUMENTATIONITMEANSGENERICSAFEATUREADDEDTO*AVA3OITLOOKSLIKEWELL
HAVETOLEARNHOWTOINTERPRETTHEDOCUMENTATIONBEFOREWECANlGUREOUTWHYWEWEREABLETO
SORT3TRINGOBJECTSINAN!RRAY,ISTBUTNOTAN!RRAY,ISTOF3ONGOBJECTS
\RXDUHKHUH
JHQHULFW\SHV
/ MVMZQK[UMIV[UWZM\ aXM[INM\a
7ELLJUSTSAYITRIGHTHEREVIRTUALLYALLOFTHECODEYOUWRITETHATDEALS
WITHGENERICSWILLBECOLLECTION RELATEDCODE!LTHOUGHGENERICSCANBEUSED
INOTHERWAYSTHEMAINPOINTOFGENERICSISTOLETYOUWRITETYPE SAFE
COLLECTIONS)NOTHERWORDSCODETHATMAKESTHECOMPILERSTOPYOU
FROMPUTTINGA$OGINTOALISTOF$UCKS
"EFOREGENERICSWHICHMEANSBEFORE*AVA THECOMPILERCOULD
NOTCARELESSWHATYOUPUTINTOACOLLECTIONBECAUSEALLCOLLECTION
IMPLEMENTATIONSWEREDECLAREDTOHOLDTYPE/BJECT9OUCOULDPUT
ANYTHINGINANY!RRAY,ISTITWASLIKEALL!RRAY,ISTSWEREDECLAREDAS
!RRAY,IST/BJECT R
ULFVWKHUHZR DVQ
%HIRUHJHQHDU HW\ SH IDQ :LWKJHQHULFV\RXFDQ
:,7+287JHQHULFV ZD\WRGHFO RHLWWKVDGGPHWKRG
D\/LVWV FUHDWHW\SHVDIHFROOHFWLRQV
2EMHFWVJR,1DVDUHIHUHQFHWR $UURNW\SH2EMHFW
WR ZKHUHPRUHSUREOHPVDUH
6RFFHU%DOO)LVK*XLWDUDQG
&DUREMHFWV
FDXJKWDWFRPSLOHWLPH
LQVWHDGRIUXQWLPH
:LWKRXWJHQHULFVWKH
$UUD\/LVW
FRPSLOHUZRXOGKDSSLO\OHW
\RXSXWD3XPSNLQLQWRDQ
2EMHFW 2EMHFW 2EMHFW 2EMHFW
$UUD\/LVWWKDWZDVVXSSRVHG
$QGFRPH287DVDUHIHUHQFHRIW\SH2EMHFW WRKROGRQO\&DWREMHFWV
:,7+JHQHULFV
2EMHFWVJR,1DVDUHIHUHQFHWR
RQO\)LVKREMHFWV
1RZZLW JH
REMHFWVLQKW QHULFV\RXF
DQS
$UUD\/LVW)LVK! REMHFWVFRP H$UUD\/LVW)LVXKW!RQO\)LVK
K
H
<RXGRQ·WK WDV)LVKUHIHU VRWKH
R X
VWLFNLQJD DYHWRZRUU\DE HQFHV
ZKDW\RXJ9H RONVZDJHQLQWKHURHXWVRPHRQH
DEOHWRD)LVWRXWZRQ·WUHDOO\ERUWKDW
KUHIHUHQFH HFDVW

$QGFRPHRXWDVDUHIHUHQFHRIW\SH)LVK
FKDSWHU
4MIZVQVOOMVMZQK[
/FTHEDOZENSOFTHINGSYOUCOULDLEARNABOUTGENERICSTHEREARE
REALLYONLYTHREETHATMATTERTOMOSTPROGRAMMERS
&UHDWLQJLQVWDQFHVRIJHQHULILHGFODVVHVOLNH$UUD\/LVW
QHZ$UUD\/LVW6RQJ!
7HENYOUMAKEAN!RRAY,ISTYOUHAVETOTELLITTHETYPE
OFOBJECTSYOULLALLOWINTHELISTJUSTASYOUDOWITHPLAIN
OLDARRAYS
'HFODULQJDQGDVVLJQLQJYDULDEOHVRIJHQHULFW\SHV
/LVW6RQJ!VRQJ/LVW
(OWDOESPOLYMORPHISMREALLYWORKWITHGENERIC QHZ$UUD\/LVW6RQJ!
TYPES)FYOUHAVEAN!RRAY,IST!NIMALREFERENCE
VARIABLECANYOUASSIGNAN!RRAY,IST$OGTOIT7HAT
ABOUTA,IST!NIMALREFERENCE#ANYOUASSIGNAN
!RRAY,IST!NIMALTOIT9OULLSEE
'HFODULQJDQGLQYRNLQJPHWKRGVWKDWWDNHJHQHULFW\SHV

)FYOUHAVEAMETHODTHATTAKESASAPARAMETERSAYAN YRLGIRR/LVW6RQJ!OLVW
!RRAY,ISTOF!NIMALOBJECTSWHATDOESTHATREALLYMEAN
#ANYOUALSOPASSITAN!RRAY,ISTOF$OGOBJECTS7ELL [IRRVRQJ/LVW
LOOKATSOMESUBTLEANDTRICKYPOLYMORPHISMISSUESTHAT
AREVERYDIFFERENTFROMTHEWAYYOUWRITEMETHODSTHAT
TAKEPLAINOLDARRAYS
4HISISACTUALLYTHESAMEPOINTASBUTTHATSHOWSYOU
HOWIMPORTANTWETHINKITIS
Q: "UTDONT)ALSONEEDTOLEARNHOWTOCREATEMY/7.GENERIC
CLASSES7HATIF)WANTTOMAKEACLASSTYPETHATLETSPEOPLE
INSTANTIATINGTHECLASSDECIDETHETYPEOFTHINGSTHATCLASSWILLUSE
A: 9OUPROBABLYWONTDOMUCHOFTHAT4HINKABOUTITTHE!0)
DESIGNERSMADEANENTIRELIBRARYOFCOLLECTIONSCLASSESCOVERINGMOSTOF
THEDATASTRUCTURESYOUDNEEDANDVIRTUALLYTHEONLYTYPEOFCLASSESTHAT
REALLYNEEDTOBEGENERICARECOLLECTIONCLASSES)NOTHERWORDSCLASSES
DESIGNEDTOHOLDOTHERELEMENTSANDYOUWANTPROGRAMMERSUSINGITTO
SPECIFYWHATTYPETHOSEELEMENTSAREWHENTHEYDECLAREANDINSTANTIATE
THECOLLECTIONCLASS
9ESITISPOSSIBLETHATYOUMIGHTWANTTOCREATEGENERICCLASSESBUTTHATS
THEEXCEPTIONSOWEWONTCOVERITHERE"UTYOULLFIGUREITOUTFROMTHE
THINGSWEDOCOVERANYWAY
\RXDUHKHUH
JHQHULFFODVVHV
=[QVOOMVMZQK+4);;-;
3INCE!RRAY,ISTISOURMOST USEDGENERIlEDTYPEWELL
STARTBYLOOKINGATITSDOCUMENTATION4HEYTWOKEYAREAS 7KLQNRI´(µDVDVWDQGLQIRU
TOLOOKATINAGENERIlEDCLASSARE
4HECLASSDECLARATION
´WKHW\SHRIHOHPHQW\RXZDQW
4HEMETHODDECLARATIONSTHATLETYOUADDELEMENTS WKLVFROOHFWLRQWRKROGDQG
UHWXUQµ(LVIRU(OHPHQW
8QGHUVWDQGLQJ$UUD\/LVWGRFXPHQWDWLRQ
2UZKDW·VWKHWUXHPHDQLQJRI´(µ"
FHKROGHUI RUWKH $UUD\/LVW V

( µ LVD S OD
7KH´ \SH\RXXVHZKH R\X/LVWQ \ VRZKDWHYHULWDVXEFODVVRI$
EVW
5($/W QGFUHDWHDQ$UUD $UUD\/LVWLV \SH\RXVSHFLI\IRUUDWFW/LVW
W\SHRIWKH$ DX W RPDWLFDO KH
GHFODUHD EVWUDFW/LVWO\XVHGIRUWKH
SXEOLFFODVV$UUD\/LVW(!H[WHQGV$EVWUDFW/LVW(!LPSOHPHQWV/LVW(!^

SXEOLFERROHDQDGG(R
7KHW\SHWKHYDOXHRI(!
+HUH·VWKHLPSRUWDQWSDUW:KDWHYHUHDOOR ´(µLV EHFRPHVWKHW\SHRIWKH/LVW
GHWH UPLQ HVZK DWN LQGR IWK LQJV \RX·U ZHG LQWHUIDFHDVZHOO
WRDGGWRWKH$UUD\/ LVW
PRUHFRGH
`

4HEh%vREPRESENTSTHETYPEUSEDTOCREATEANINSTANCE
OF!RRAY,IST7HENYOUSEEANh%vINTHE!RRAY,IST
DOCUMENTATIONYOUCANDOAMENTALlNDREPLACETO
EXCHANGEITFORWHATEVERTYPEYOUUSETOINSTANTIATE
!RRAY,IST
3ONEW!RRAY,IST3ONGMEANSTHATh%vBECOMESh3ONGv
INANYMETHODORVARIABLEDECLARATIONTHATUSESh%v
FKDSWHU
=[QVO\aXMXIZIUM\MZ[_Q\P)ZZIa4Q[\
7+,6FRGH
$UUD\/LVW6WULQJ!WKLV/LVW QHZ$UUD\/LVW6WULQJ!
0HDQV$UUD\/LVW
SXEOLFFODVV$UUD\/LVW(!H[WHQGV$EVWUDFW/LVW
H[WH (!^

SXEOLFERROHDQDGG(R
Licensed by
PRUHFRGH
`

,VWUHDWHGE\WKHFRPSLOHUDV

Eduard Simons
SXEOLFFODVV$UUD\/LVW6WULQJ!H[WHQGV$EVWUDFW/LVW6WULQJ!^
SXEOLFERROHDQDGG6WULQJR
PRUHFRGH
104038
`

)NOTHERWORDSTHEh%vISREPLACEDBYTHEREALTYPEALSOCALLEDTHETYPEPARAMETER
THATYOUUSEWHENYOUCREATETHE!RRAY,IST!NDTHATSWHYTHEADD METHOD
FOR!RRAY,ISTWONTLETYOUADDANYTHINGEXCEPTOBJECTSOFAREFERENCETYPETHATS
COMPATIBLEWITHTHETYPEOFh%v3OIFYOUMAKEAN!RRAY,IST3TRINGTHEADD
METHODSUDDENLYBECOMESADD3TRINGO )FYOUMAKETHE!RRAY,ISTOFTYPE$OG
SUDDENLYTHEADD METHODBECOMESADD$OGO
Q: )Sh%vTHEONLYTHINGYOUCANPUTTHERE"ECAUSETHEDOCSFORSORTUSEDh4v
A: 9OUCANUSEANYTHINGTHATSALEGAL*AVAIDENTIFIER4HATMEANSANYTHINGTHATYOU
COULDUSEFORAMETHODORVARIABLENAMEWILLWORKASATYPEPARAMETER"UTTHECONVEN
TIONISTOUSEASINGLELETTERSOTHATSWHATYOUSHOULDUSE ANDAFURTHERCONVENTIONISTO
USEh4vUNLESSYOURESPECIFICALLYWRITINGACOLLECTIONCLASSWHEREYOUDUSEh%vTOREPRE
SENTTHEhTYPEOFTHE%LEMENTTHECOLLECTIONWILLHOLDv
\RXDUHKHUH
JHQHULFPHWKRGV
=[QVOOMVMZQK5-<07,;
!GENERICCLASSMEANSTHATTHECLASSDECLARATIONINCLUDESATYPE
PARAMETER!GENERICMETHODMEANSTHATTHEMETHODDECLARATION
USESATYPEPARAMETERINITSSIGNATURE
9OUCANUSETYPEPARAMETERSINAMETHODINSEVERALDIFFERENTWAYS
8VLQJDW\SHSDUDPHWHUGHILQHGLQWKHFODVVGHFODUDWLRQ
SXEOLFFODVV$UUD\/LVW(!H[WHQGV$EVWUDFW/LVW(!^
SXEOLFERROHDQDGG(R <RXFDQX
DOUHDG\EHHVHQWKH´(µKHUH21/<EHF
GHILQHGDVSD
UWRIWKHDXFOVH LW·V
DVV
7HENYOUDECLAREATYPEPARAMETERFORTHECLASSYOU
CANSIMPLYUSETHATTYPEANYPLACETHATYOUDUSEA
REALCLASSORINTERFACETYPE4HETYPEDECLAREDINTHE
METHODARGUMENTISESSENTIALLYREPLACEDWITHTHETYPE
YOUUSEWHENYOUINSTANTIATETHECLASS
8VLQJDW\SHSDUDPHWHUWKDWZDV127GHILQHGLQWKHFODVVGHFODUDWLRQ
SXEOLF7H[WHQGV$QLPDO!YRLGWDNH7KLQJ$UUD\/LVW7!OLVW
)FTHECLASSITSELFDOESNTUSEATYPEPARAMETERYOUCANSTILL +HUHZH QXV

SPECIFYONEFORAMETHODBYDECLARINGITINAREALLYUNUSUAL ´7µHDUOLHFD H7
ULQWKHPHW!EK HFDXVHZHGHFODUHG
BUTAVAILABLE SPACEBEFORETHERETURNTYPE4HISMETHODSAYS RGGHFODUDWLR
Q
THAT4CANBEhANYTYPEOF!NIMALv
FKDSWHU
:DLWWKDWFDQ·WEHULJKW,I\RXFDQ
WDNHDOLVWRI$QLPDOZK\GRQ·W\RX
MXVW6$<WKDW":KDW·VZURQJZLWKMXVW
WDNH7KLQJ$UUD\/LVW$QLPDO!OLVW "
0MZM¼[_PMZMQ\OM\[_MQZL
4HIS
)S./4THESAMEASTHIS
SXEOLFYRLGWDNH7KLQJ$UUD\/LVW$QLPDO!OLVW
"OTHARELEGALBUTTHEYREDIFFERENT
4HElRSTONEWHERE4EXTENDS!NIMALISPARTOFTHEMETHOD
DECLARATIONMEANSTHATANY!RRAY,ISTDECLAREDOFATYPETHATIS
!NIMALORONEOF!NIMALSSUBTYPESLIKE$OGOR#AT ISLEGAL
3OYOUCOULDINVOKETHETOPMETHODUSINGAN!RRAY,IST$OG
!RRAY,IST#ATOR!RRAY,IST!NIMAL
"UTTHEONEONTHEBOTTOMWHERETHEMETHODARGUMENTIS
!RRAY,IST!NIMALLIST MEANSTHATONLYAN!RRAY,IST!NIMAL
ISLEGAL)NOTHERWORDSWHILETHElRSTVERSIONTAKESAN!RRAY,IST
OFANYTYPETHATISATYPEOF!NIMAL!NIMAL$OG#ATETC
THESECONDVERSIONTAKESONLYAN!RRAY,ISTOFTYPE!NIMAL.OT
!RRAY,IST$OGOR!RRAY,IST#ATBUTONLY!RRAY,IST!NIMAL
!NDYESITDOESAPPEARTOVIOLATETHEPOINTOFPOLYMORPHISM
BUTITWILLBECOMECLEARWHENWEREVISITTHISINDETAILATTHEEND
OFTHECHAPTER&ORNOWREMEMBERTHATWEREONLYLOOKINGAT
THISBECAUSEWERESTILLTRYINGTOlGUREOUTHOWTOSORT THAT
3ONG,ISTANDTHATLEDUSINTOLOOKINGATTHE!0)FORTHESORT
METHODWHICHHADTHISSTRANGEGENERICTYPEDECLARATION
&ORNOWALLYOUNEEDTOKNOWISTHATTHESYNTAXOFTHETOPVERSION
ISLEGALANDTHATITMEANSYOUCANPASSINA!RRAY,ISTOBJECT
INSTANTIATEDAS!NIMALORANY!NIMALSUBTYPE
!NDNOWBACKTOOURSORT METHOD
\RXDUHKHUH
VRUWLQJD6RQJ
7KLVVWLOOGRHVQ·W
H[SODLQZK\WKHVRUWPHWKRG
IDLOHGRQDQ$UUD\/LVWRI6RQJV
EXWZRUNHGIRUDQ$UUD\/LVWRI
6WULQJV
5HPHPEHUZKHUHZHZHUH
)LOH(GLW:LQGRZ+HOS%XPPHU
MDYDF-XNHER[MDYD
-XNHER[MDYDFDQQRW¿QGV\PERO
V\PEROPHWKRGVRUWMDYDXWLO$UUD\/LVW6RQJ!
ORFDWLRQFODVVMDYDXWLO&ROOHFWLRQV
A
HUURU
LPSRUWMDYDXWLO
LPSRUWMDYDLR
SXEOLFFODVV-XNHER[^
QHZ-XNHER[JR
`
SXEOLFYRLGJR^
JHW6RQJV
HDNV,WZRUNHGILQ HZKHQ
7KLVLVZKHUHLWEU /LVW 6 WU LQJ !EX W DV VRRQDVZH
&ROOHFWLRQVVRUWVRQJ/LVW SDVVHGLQDQ$UUD\ VW6 RQ J! LW IDLO HG
6\VWHPRXWSULQWOQVRQJ/LVW WULHGWRVRUWDQ$UUD\/L

`
YRLGJHW6RQJV^
WU\^
6WULQJOLQH QXOO
DGG6RQJOLQH
`
`FDWFK([FHSWLRQH[^
H[SULQW6WDFN7UDFH
`
`
VRQJ/LVWDGGQH[W6RQJ
`
`
FKDSWHU
:M^Q[Q\QVO\PM[WZ\ UM\PWL
3OHEREWEARETRYINGTOREADTHESORT METHODDOCSTOlND
OUTWHYITWAS/+TOSORTALISTOF3TRINGSBUTNOTA
LISTOF3ONGOBJECTS!NDITLOOKSLIKETHEANSWERIS
7KHVRUWPHWKRGFDQWDNHRQO\OLVWV
RI&
RPSDUDEOHREMHFWV
6RQJLV127DVXEW\SHRI
&RPSDUDEOHVR\RXFDQQRWVRUW
WKHOLVWRI6RQJV
$WOHDVWQRW\HW
SXEOLFVWDWLF7H[WHQGV&RPSDUDEOH"VXSHU7!!YRLGVRUW/LVW7!OLVW
,JQRUHWKLVSDUWIRUQRZ%XW <RXFDQSDVVLQRQO\D/LVWRU

7KLVVD\V´:KDWHYHU¶7·LVPXVW LI\RXFDQ·WLWMXVWPHDQV VXEW\SHRIOLVWOLNH$UUD\/LVW
EHRIW\SH&RPSDUDEOHµ WKDWWKHW\SHSDUDPHWHUIRU WKDWXVHVDSDUDPHWHUL]HGW\SH
&RPSDUDEOHPXVWEHRIW\SH7 WKDW´H[WHQGV&RPSDUDEOHµ
RURQHRI7·VVXSHUW\SHV
8P,MXVWFKHFNHGWKHGRFVIRU
6WULQJDQG6WULQJGRHVQ·W(;7(1'
&RPSDUDEOHLW,03/(0(176LW
&RPSDUDEOHLVDQLQWHUIDFH6RLW·VQRQVHQVH
WRVD\7H[WHQGV&RPSDUDEOH!
SXEOLF¿QDOFODVV6WULQJH[WHQGV2EMHFWLPSOHPHQWV6HULDOL]DEOH
&RPSDUDEOH6WULQJ!&KDU6HTXHQFH
\RXDUHKHUH
WKHVRUWPHWKRG
1VOMVMZQK[¹M`\MVL[ºUMIV[
¹M`\MVL[WZQUXTMUMV\[º
4HE*AVAENGINEERSHADTOGIVEYOUAWAYTOPUTACONSTRAINT
ONAPARAMETERIZEDTYPESOTHATYOUCANRESTRICTITTOSAYONLY
SUBCLASSESOF!NIMAL"UTYOUALSONEEDTOCONSTRAINATYPETO ,QJHQHULFVWKHNH\ZRUG
ALLOWONLYCLASSESTHATIMPLEMENTAPARTICULARINTERFACE3O
HERESASITUATIONWHEREWENEEDONEKINDOFSYNTAXTOWORK
´H[WHQGVµUHDOO\PHDQV´LVDµ
FORBOTHSITUATIONSINHERITANCEANDIMPLEMENTATION)NOTHER DQGZRUNVIRU%27+FODVVHV
WORDSTHATWORKSFORBOTHEXTENDSANDIMPLEMENTS
!NDTHEWINNINGWORDWASEXTENDS"UTITREALLYMEANShIS Av
DQGLQWHUIDFHV
ANDWORKSREGARDLESSOFWHETHERTHETYPEONTHERIGHTISAN
INTERFACEORACLASS
&RPSDUDEOHLVDQLQWHUIDFHVRWKLV WKDW
5($//<UHDGV´7PXVWEHDW\SH µ
LPSOHPHQWVWKH&RPSDUDEOHLQWHUIDFH
SXEOLFVWDWLF7H[WHQGV&RPSDUDEOH"VXSHU7!!YRLGVRUW/LVW7!OLVW
,WGRHVQ·WPDWWHUZKHWKHUWKHWKLQJRQWKHULJKWLV
DFODVVRULQWHUIDFH\RXVWLOOVD\´H[WHQGVµ
Q: 7HYDIDNTTHEYJUSTMAKEANEWKEYWORDhISv
A: !DDINGANEWKEYWORDTOTHELANGUAGEISA2%!,,9BIGDEALBECAUSE
ITRISKSBREAKING*AVACODEYOUWROTEINANEARLIERVERSION4HINKABOUT
ITYOUMIGHTBEUSINGAVARIABLEhISvWHICHWEDOUSEINTHISBOOKTOREPRE
SENTINPUTSTREAMS !NDSINCEYOURENOTALLOWEDTOUSEKEYWORDSASIDENTI
FIERSINYOURCODETHATMEANSANYEARLIERCODETHATUSEDTHEKEYWORDBEFORE
ITWASARESERVEDWORDWOULDBREAK3OWHENEVERTHERESACHANCEFORTHE
3UNENGINEERSTOREUSEANEXISTINGKEYWORDASTHEYDIDHEREWITHhEXTENDSv
THEYLLUSUALLYCHOOSETHAT"UTSOMETIMESTHEYDONTHAVEACHOICE
!FEWVERYFEW NEWKEYWORDSHAVEBEENADDEDTOTHELANGUAGESUCH
ASASSERTIN*AVAANDENUMIN*AVAWELOOKATENUMINTHEAPPEN
DIX !NDTHISDOESBREAKPEOPLESCODEHOWEVERYOUSOMETIMESHAVETHE
OPTIONOFCOMPILINGANDRUNNINGANEWERVERSIONOF*AVASOTHATITBEHAVES
ASTHOUGHITWEREANOLDERONE9OUDOTHISBYPASSINGASPECIALFLAGTOTHE
COMPILEROR*6-ATTHECOMMAND LINETHATSAYSh9EAHYEAH)+./7THISIS
*AVABUTPLEASEPRETENDITSREALLYBECAUSE)MUSINGAVARIABLEINMY
CODENAMEDASSERTTHAT)WROTEBACKWHENYOUGUYSSAIDITWOULD/+v
4OSEEIFYOUHAVEAFLAGAVAILABLETYPEJAVACFORTHECOMPILER ORJAVAFOR
THE*6- ATTHECOMMAND LINEWITHOUTANYTHINGELSEAFTERITANDYOUSHOULD
SEEALISTOFAVAILABLEOPTIONS9OULLLEARNMOREABOUTTHESEFLAGSINTHECHAP
TERONDEPLOYMENT
FKDSWHU
.QVITTa_MSVW__PI\¼[_ZWVO
<PM;WVOKTI[[VMML[\WQUXTMUMV\+WUXIZIJTM
7ECANPASSTHE!RRAY,IST3ONGTOTHESORT METHODONLYIFTHE 7KHELJTXHVWLRQLVZKDW
3ONGCLASSIMPLEMENTS#OMPARABLESINCETHATSTHEWAYTHESORT PDNHVRQHVRQJOHVVWKDQ
METHODWASDECLARED!QUICKCHECKOFTHE!0)DOCSSHOWSTHE HTXDOWRRUJUHDWHUWKDQ
#OMPARABLEINTERFACEISREALLYSIMPLEWITHONLYONEMETHODTO DQRWKHUVRQJ"
IMPLEMENT
<RXFDQ·WLPSOHPHQWWKH
MDYDODQJ&RPSDUDEOH &RPSDUDEOHLQWHUIDFHXQWLO\RX
PDNHWKDWGHFLVLRQ
SXEOLFLQWHUIDFH&RPSDUDEOH7!^
LQW
FRPSDUH7R7R

`
6KDUSHQ \RXU SHQFLO

!NDTHEMETHODDOCUMENTATIONFORCOMPARE4O SAYS
7RITEINYOURIDEAANDPSEUDOCODEOR
BETTER2%!,CODE FORIMPLEMENTINGTHE
COMPARE4O METHODINAWAYTHATWILL
5HWXUQV SORT THE3ONGOBJECTSBYTITLE
DQHJDWLYHLQWHJHU]HURRUD
SRVLWLYHLQWHJHUDVWKLVREMHFW (INTIFYOUREONTHERIGHTTRACKITSHOULD
LVOHVVWKDQHTXDOWRRUJUHDWHU TAKELESSTHANLINESOFCODE
WKDQWKHVSHFL¿HGREMHFW
)TLOOKSLIKETHECOMPARE4O METHODWILLBECALLEDONONE
3ONGOBJECTPASSINGTHAT3ONGAREFERENCETOADIFFERENT
3ONG4HE3ONGRUNNINGTHECOMPARE4O METHODHASTO
lGUREOUTIFTHE3ONGITWASPASSEDSHOULDBESORTEDHIGHER
LOWERORTHESAMEINTHELIST
9OURBIGJOBNOWISTODECIDEWHATMAKESONESONGGREATER
THANANOTHERANDTHENIMPLEMENTTHECOMPARE4O METHOD
TOREmECTTHAT!NEGATIVENUMBERANYNEGATIVENUMBER
MEANSTHE3ONGYOUWEREPASSEDISGREATERTHANTHE3ONG
RUNNINGTHEMETHOD2ETURNINGAPOSITIVENUMBERSAYS
THATTHE3ONGRUNNINGTHEMETHODISGREATERTHANTHE3ONG
PASSEDTOTHECOMPARE4O METHOD2ETURNINGZEROMEANS
THE3ONGSAREEQUALATLEASTFORTHEPURPOSEOFSORTINGIT
DOESNTNECESSARILYMEANTHEYRETHESAMEOBJECT 9OUMIGHT
FOREXAMPLEHAVETWO3ONGSWITHTHESAMETITLE
7HICHBRINGSUPAWHOLEDIFFERENTCANOFWORMSWELLLOOK
ATLATER
\RXDUHKHUH
WKH&RPSDUDEOHLQWHUIDFH
<PMVM_QUXZW^MLKWUXIZIJTM;WVOKTI[[
7EDECIDEDWEWANTTOSORTBYTITLESOWEIMPLEMENTTHECOMPARE4O
METHODTOCOMPARETHETITLEOFTHE3ONGPASSEDTOTHEMETHODAGAINST
THETITLEOFTHESONGONWHICHTHECOMPARE4O METHODWASINVOKED
)NOTHERWORDSTHESONGRUNNINGTHEMETHODHASTODECIDEHOWITS
TITLECOMPARESTOTHETITLEOFTHEMETHODPARAMETER
(MMMWEKNOWTHATTHE3TRINGCLASSMUSTKNOWABOUTALPHABETICAL
ORDERBECAUSETHESORT METHODWORKEDONALISTOF3TRINGS7EKNOW
3TRINGHASACOMPARE4O METHODSOWHYNOTJUSTCALLIT4HATWAYWE
CANSIMPLYLETONETITLE3TRINGCOMPAREITSELFTOANOTHERANDWEDONT
HAVETOWRITETHECOMPARINGALPHABETIZINGALGORITHM
8VXDOO\WKHVHPDWFKZH·UHVSHFLI\LQJGDJWKHW\SHWKDW
WKHLPSOHPHQW LQJF ODVVF DQEH FRP SDUH DLQVW
FODVV6RQJLPSOHPHQWV&RPSDUDEOH6RQJ!^ 7KLVPHDQVWKDW6RQJREMHFWVFDQEHFIVRU RPSDUHGWR
6WULQJWLWOH RWKHU6RQJREMHFWVIRUWKH SXUS RVHR WLQJ
6WULQJDUWLVW
6WULQJUDWLQJ
7KHVRUWPHWKRGVHQGVD6RQJWRFRP6RQ SDUH7R
6WULQJESP
WRVHHKRZWKDW6RQJFR PSDU HVWR WKH JRQ

ZKLFK WKH PHW KRG ZDVLQYRN HG
SXEOLFLQWFRPSDUH7R6RQJV^
UHWXUQWLWOHFRPSDUH7RVJHW7LWOH 6LPSOH:HMXVWSDVVWKHZRUN
` RQWRWKHWLWOH6WULQJREMHFWV
VLQFHZHNQRZ6WULQJVKDYHD
6RQJ6WULQJW6WULQJD6WULQJU6WULQJE^ FRPSDUH7RPHWKRG
WLWOH W
DUWLVW D
UDWLQJ U
ESP E
`
UHWXUQWLWOH
` 7KLVWLPHLWZRUNHG,WSULQWVWKHOLVWUGHUWKHQFDOOVVRUW
ZKLFKSXWV WKH6RQJVLQ DOSK DEHW LFDOR E\WLWOH
)LOH(GLW:LQGRZ+HOS$PELHQW
UHWXUQDUWLVW
` MDYD-XNHER[
SXEOLF6WULQJJHW5DWLQJ^
UHWXUQUDWLQJ >3LQN0RRQ6RPHUVDXOW6KLYD0RRQ&LUFOHV'HHS
` &KDQQHO3DVVHQJHU/LVWHQ@
SXEOLF6WULQJJHW%SP^
UHWXUQESP >&LUFOHV'HHS&KDQQHO/LVWHQ3DVVHQJHU3LQN
` 0RRQ6KLYD0RRQ6RPHUVDXOW@

SXEOLF6WULQJWR6WULQJ^
UHWXUQWLWOH
`
`
FKDSWHU
?MKIV[WZ\\PMTQ[\J]\
7KDW·VQRWJRRGHQRXJK
4HERESANEWPROBLEM,OUWANTSTWODIFFERENTVIEWSOFTHESONGLIST 6RPHWLPHV,ZDQWLWWRVRUW
ONEBYSONGTITLEANDONEBYARTIST E\DUWLVWLQVWHDGRIWLWOH
"UTWHENYOUMAKEACOLLECTIONELEMENTCOMPARABLEBYHAVINGIT
IMPLEMENT#OMPARABLE YOUGETONLYONECHANCETOIMPLEMENTTHE
COMPARE4O METHOD3OWHATCANYOUDO
4HEHORRIBLEWAYWOULDBETOUSEAmAGVARIABLEINTHE3ONGCLASS
ANDTHENDOANIFTESTINCOMPARE4O ANDGIVEADIFFERENTRESULT
DEPENDINGONWHETHERTHEmAGISSETTOUSETITLEORARTISTFORTHE
COMPARISON
"UTTHATSANAWFULANDBRITTLESOLUTIONANDTHERESSOMETHINGMUCH
BETTER3OMETHINGBUILTINTOTHE!0)FORJUSTTHISPURPOSEWHENYOU
WANTTOSORTTHESAMETHINGINMORETHANONEWAY
/RRNDWWKH&ROOHFWLRQVFODVV$3,DJDLQ7KHUH·VD
VHFRQGVRUWPHWKRG³DQGLWWDNHVD&RPSDUDWRU
R
U WP HW KR G LVRYHUORDGHGW
7KHVR DWRU
VRP HW KLQJ FD OOHGD&RPSDU
WDNH
WR
RWH W RVHO IILJXUHRXWKRZ Q
1 WFD
RPSDUDWRUWKD
JHW PDNHD& E\
UGHUWKHVRQJV
FRPSDUHDQGR
RIWLWOH
DUWLVWLQVWHDG
\RXDUHKHUH
WKH&RPSDUDWRULQWHUIDFH
=[QVOIK][\WU+WUXIZI\WZ
MDYDXWLO&RPSDUDWRU
!NELEMENTINALISTCANCOMPAREITSELFTOANOTHEROF
ITSOWNTYPEINONLYONEWAYUSINGITSCOMPARE4O SXEOLFLQWHUIDFH&RPSDUDWRU7!^
METHOD"UTA#OMPARATORISEXTERNALTOTHEELEMENT LQWFRPSDUH7R7R
TYPEYOURECOMPARINGITSASEPARATECLASS3OYOUCAN `
MAKEASMANYOFTHESEASYOULIKE7ANTTOCOMPARE
SONGSBYARTIST-AKEAN!RTIST#OMPARATOR3ORTBYBEATS
PERMINUTE-AKEA"0-#OMPARATOR
4HENALLYOUNEEDTODOISCALLTHEOVERLOADEDSORT
METHODTHATTAKESTHE,ISTANDTHE#OMPARATORTHATWILL
HELPTHESORT METHODPUTTHINGSINORDER
4HESORT METHODTHATTAKESA#OMPARATORWILLUSETHE ,I\RXSDVVD&RPSDUDWRUWRWKH
#OMPARATORINSTEADOFTHEELEMENTSOWNCOMPARE4O
METHODWHENITPUTSTHEELEMENTSINORDER)NOTHER
VRUWPHWKRGWKHVRUWRUGHULV
WORDSIFYOURSORT METHODGETSA#OMPARATORITWONT GHWHUPLQHGE\WKH&RPSDUDWRU
EVENCALLTHECOMPARE4O METHODOFTHEELEMENTS
INTHELIST4HESORT METHODWILLINSTEADINVOKETHE UDWKHUWKDQWKHHOHPHQW·VRZQ
COMPARE METHODONTHE#OMPARATOR
FRPSDUH7RPHWKRG
3OTHERULESARE
,QYRNLQJWKHRQHDUJXPHQWVRUW/LVWRPHWKRG

PHDQVWKHOLVWHOHPHQW·VFRPSDUH7RPHWKRG
GHWHUPLQHVWKHRUGHU6RWKHHOHPHQWVLQWKHOLVW
0867LPSOHPHQWWKH&RPSDUDEOHLQWHUIDFH
,QYRNLQJVRUW/LVWR&RPSDUDWRUFPHDQVWKH

OLVWHOHPHQW·VFRPSDUH7RPHWKRGZLOO127EH
FDOOHGDQGWKH&RPSDUDWRU·VFRPSDUHPHWKRG
ZLOOEHXVHGLQVWHDG7KDWPHDQVWKHHOHPHQWV
LQWKHOLVWGR127QHHGWRLPSOHPHQWWKH
&RPSDUDEOHLQWHUIDFH
Q: 3ODOESTHISMEANTHATIFYOUHAVEACLASSTHAT Q: "UTWHYDOESNTEVERYCLASSIMPLEMENT#OMPARABLE
DOESNTIMPLEMENT#OMPARABLEANDYOUDONTHAVETHE
SOURCECODEYOUCOULDSTILLPUTTHETHINGSINORDERBY
CREATINGA#OMPARATOR A:$OYOUREALLYBELIEVETHATEVERYTHINGCANBEORDERED
)FYOUHAVEELEMENTTYPESTHATJUSTDONTLENDTHEMSELVESTO
A: ANYKINDOFNATURALORDERINGTHENYOUDBEMISLEADINGOTHER
4HATSRIGHT4HEOTHEROPTIONIFITSPOSSIBLE WOULDBE PROGRAMMERSIFYOUIMPLEMENT#OMPARABLE!NDYOUARENT
TOSUBCLASSTHEELEMENTANDMAKETHESUBCLASSIMPLEMENT TAKINGAHUGERISKBYNOTIMPLEMENTING#OMPARABLESINCE
#OMPARABLE APROGRAMMERCANCOMPAREANYTHINGINANYWAYTHATHE
CHOOSESUSINGHISOWNCUSTOM#OMPARATOR
FKDSWHU
=XLI\QVO\PM2]SMJW`\W][MI+WUXIZI\WZ
7EDIDTHREENEWTHINGSINTHISCODE
#REATEDANINNERCLASSTHATIMPLEMENTS#OMPARATORANDTHUSTHECOMPARE
METHODTHATDOESTHEWORKPREVIOUSLYDONEBYCOMPARE4O
-ADEANINSTANCEOFTHE#OMPARATORINNERCLASS
#ALLEDTHEOVERLOADEDSORT METHODGIVINGITBOTHTHESONGLISTANDTHE
INSTANCEOFTHE#OMPARATORINNERCLASS
.OTEWEALSOUPDATEDTHE3ONGCLASSTO3TRING METHODTOPRINTBOTHTHESONG
TITLEANDTHEARTIST)TPRINTSTITLEARTISTREGARDLESSOFHOWTHELISTISSORTED
Licensed by
LPSRUWMDYDXWLO
LPSRUWMDYDLR
SXEOLFFODVV-XNHER[^
&UHDWHDQHZLQQHUFODVVWKDWLPSOHPHQWV
Eduard Simons
&RPSDUDWRUQRWHWKDWLWVW\SH RLQJ
SDUDPHWHUPDWFKHVWKHW\SHZH·UHJ
QHZ-XNHER[JR
WRFRPSDUH³LQWKLVFDVH6RQJREMHFWV
`
FODVV$UWLVW&RPSDUHLPSOHPHQWV&RPSDUDWRU6RQJ!^
104038
SXEOLFLQWFRPSDUH6RQJRQH6RQJWZR^
UHWXUQRQHJHW$UWLVWFRPSDUH7RWZRJHW$UWLVW
`
` 7KLVEHFRPHVD6WULQJWKHDUWLVW :H·UHOHWWLQJWKH6WULQJ
GRWKHDFWXDOFRPSDULVRQYDULDEOHVIRUDUWLVW
SXEOLFYRLGJR^ NQRZKRZWRDOSKDEHWL]HWVLQFH6WULQJVDOUHDG\
JHW6RQJV
KHPVHOYHV
0DNHDQLQVWDQFHRIWKH
$UWLVW&RPSDUHDUWLVW&RPSDUH QHZ$UWLVW&RPSDUH&RPSDUDWRULQQHUFODVV
&ROOHFWLRQVVRUWVRQJ/LVWDUWLVW&RPSDUH
,QYRNHVRUWS VLQJLW
6\VWHPRXWSULQWOQVRQJ/LVW DQGDUHIHUHQFHDVWR WKHOLVW
` FXVWRP&RPSDUDWRUWREKHQHZ

MHFW
YRLGJHW6RQJV^
,2FRGHKHUH
.OTEWEVEMADESORT BY TITLETHEDEFAULTSORTBY
`
KEEPINGTHECOMPARE4O METHODIN3ONGUSETHE

TITLES"UTANOTHERWAYTODESIGNTHISWOULDBETO
IMPLEMENTBOTHTHETITLESORTINGANDARTISTSORTINGAS
SDUVHOLQHDQGDGGWRVRQJOLVW
INNER#OMPARATORCLASSESANDNOTHAVE3ONGIMPLEMENT
`
#OMPARABLEATALL4HATMEANSWEDALWAYSUSETHETWO
`
ARGVERSIONOF#OLLECTIONSSORT
\RXDUHKHUH
FROOHFWLRQVH[HUFLVH
LPSRUWBBBBBBBBBBBBBBBBBB 6KDUSHQ \RXU SHQFLO

SXEOLFFODVV6RUW0RXQWDLQV^
/LQNHG/LVWBBBBBBBBBBBBBBPWQ QHZ/LQNHG/LVWBBBBBBBBBBBB
FODVV1DPH&RPSDUHBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB^
SXEOLFLQWFRPSDUH0RXQWDLQRQH0RXQWDLQWZR^
2EVERSE%NGINEER
UHWXUQBBBBBBBBBBBBBBBBBBBBBBBBBBB $VVXPHWKLVFRGHH[LVWVLQ
`
DVLQJOHILOH<RXUMRELV
`
FODVV+HLJKW&RPSDUHBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB^
WRILOOLQWKHEODQNVVRWKH
SXEOLFLQWFRPSDUH0RXQWDLQRQH0RXQWDLQWZR^ WKHSURJUDPZLOOFUHDWHWKH
UHWXUQBBBBBBBBBBBBBBBBBBBBBBBBBB
RXWSXWVKRZQ
`
` .OTEANSWERSAREATTHEENDOF
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ THECHAPTER
QHZ6RUW0RXQWDLQJR
`
SXEOLFYRLGJR^
PWQDGGQHZ0RXQWDLQ´/RQJVµ
PWQDGGQHZ0RXQWDLQ´(OEHUWµ
PWQDGGQHZ0RXQWDLQ´0DURRQµ
PWQDGGQHZ0RXQWDLQ´&DVWOHµ
6\VWHPRXWSULQWOQ´DVHQWHUHG?QµPWQ
1DPH&RPSDUHQF QHZ1DPH&RPSDUH
BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
6\VWHPRXWSULQWOQÉ\QDPH?QµPWQ
+HLJKW&RPSDUHKF QHZ+HLJKW&RPSDUH
BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
6\VWHPRXWSULQWOQÉ\KHLJKW?QµPWQ
`
`
FODVV0RXQWDLQ^
BBBBBBBBBBBBBBBBBB /UTPUT
BBBBBBBBBBBBBBBBB
)LOH(GLW:LQGRZ+HOS7KLV2QH¶V)RU%RE
MDYD6RUW0RXQWDLQV
BBBBBBBBBBBBBBBBBBBBBB^
DVHQWHUHG
BBBBBBBBBBBBBBBBB
>/RQJV(OEHUW0DURRQ&DVWOH@
BBBBBBBBBBBBBBBBB
E\QDPH
`
BBBBBBBBBBBBBBBBBBBBBBBBB^ >&DVWOH(OEHUW/RQJV0DURRQ@
BBBBBBBBBBBBBBBBBBBBBBBBBBBBBB E\KHLJKW
` >(OEHUW&DVWOH/RQJV0DURRQ@
`
FKDSWHU
6KDUSHQ \RXU SHQFLO &ILL IN THE BLANKS

&OREACHOFTHEQUESTIONSBELOWFILLINTHEBLANK
WITHONEOFTHEWORDSFROMTHEhPOSSIBLEANSWERSv
LISTTOCORRECTLYANSWERTHEQUESTION!NSWERSARE
ATTHEENDOFTHECHAPTER
3RVVLEOH$QVZHUV
&RPSDUDWRU
&RPSDUDEOH
FRPSDUH7R
FRPSDUH
\HV
QR
'IVENTHEFOLLOWINGCOMPILABLESTATEMENT
&ROOHFWLRQVVRUWP\$UUD\/LVW
7HATMUSTTHECLASSOFTHEOBJECTSSTOREDINP\$UUD\/LVWIMPLEMENT????????????????
7HATMETHODMUSTTHECLASSOFTHEOBJECTSSTOREDINP\$UUD\/LVWIMPLEMENT????????????????
#ANTHECLASSOFTHEOBJECTSSTOREDINP\$UUD\/LVWIMPLEMENTBOTH
&RPSDUDWRU!.$&RPSDUDEOH????????????????
&ROOHFWLRQVVRUWP\$UUD\/LVWP\&RPSDUH
#ANTHECLASSOFTHEOBJECTSSTOREDINP\$UUD\/LVWIMPLEMENT&RPSDUDEOH????????????????
#ANTHECLASSOFTHEOBJECTSSTOREDINP\$UUD\/LVWIMPLEMENT&RPSDUDWRU????????????????
-USTTHECLASSOFTHEOBJECTSSTOREDINP\$UUD\/LVWIMPLEMENT&RPSDUDEOH????????????????
-USTTHECLASSOFTHEOBJECTSSTOREDINP\$UUD\/LVWIMPLEMENT&RPSDUDWRU????????????????
7HATMUSTTHECLASSOFTHEP\&RPSDUHOBJECTIMPLEMENT????????????????
7HATMETHODMUSTTHECLASSOFTHEP\&RPSDUHOBJECTIMPLEMENT??????????????????
\RXDUHKHUH
GHDOLQJZLWKGXSOLFDWHV
=PWP<PM[WZ\QVOITT_WZS[J]\VW__MPI^ML]XTQKI\M[
4HESORTINGWORKSGREATNOWWEKNOWHOWTOSORTONBOTHTITLEUSINGTHE3ONGOBJECTS
COMPARE4O METHOD ANDARTISTUSINGTHE#OMPARATORSCOMPARE METHOD "UTTHERES
ANEWPROBLEMWEDIDNTNOTICEWITHATESTSAMPLEOFTHEJUKEBOXTEXTlLETHESORTEDLIST
CONTAINSDUPLICATES
)TAPPEARSTHATTHEDINERJUKEBOXJUSTKEEPSWRITINGTOTHElLEREGARDLESSOFWHETHERTHE
SAMESONGHASALREADYBEENPLAYEDANDTHUSWRITTEN TOTHETEXTlLE4HE3ONG,IST-ORETXT
JUKEBOXTEXTlLEISACOMPLETERECORDOFEVERYSONGTHATWASPLAYEDANDMIGHTCONTAINTHE
SAMESONGMULTIPLETIMES
)LOH(GLW:LQGRZ+HOS7RR0DQ\1RWHV
MDYD-XNHER[
>3LQN0RRQ1LFN'UDNH6RPHUVDXOW=HUR6KLYD0RRQ3UHP
%HIRUHVRUWLQJ
-RVKXD&LUFOHV%7'HHS&KDQQHO$IUR&HOWV3DVVHQJHU
+HDGPL[/LVWHQ7DKLWL/LVWHQ7DKLWL/LVWHQ7DKLWL
&LUFOHV%7@
>&LUFOHV%7&LUFOHV%7'HHS&KDQQHO$IUR&HOWV/LVWHQ $IWHUVRUWLQJXVLQJ
7DKLWL/LVWHQ7DKLWL/LVWHQ7DKLWL3DVVHQJHU WKH6RQJ·VRZQ KRG
+HDGPL[3LQN0RRQ1LFN'UDNH6KLYD0RRQ3UHP-RVKXD FRPSDUH7RPHW
6RPHUVDXOW=HUR@ VRUWE\WLWOH
>'HHS&KDQQHO$IUR&HOWV&LUFOHV%7&LUFOHV%73DVVHQJHU
JXVLQJ
+HDGPL[3LQN0RRQ1LFN'UDNH6KLYD0RRQ3UHP-RVKXD/LVWHQ $IWHUVRUWLQ PSDUH
WKH$ UW LVW&R
&RPSDUDWRUVRUWE\
7DKLWL/LVWHQ7DKLWL/LVWHQ7DKLWL6RPHUVDXOW
=HUR@ DUWLVWQDPH
6RQJ/LVW0RUHW[W
3LQN0RRQ1LFN'UDNH 7KH6RQJ/LVW0RU
6RPHUVDXOW=HUR LWEHFDXVHWKHMX HWH[WILOHQRZKDVGXSOLFDW
NHER[PDFKLQHLV HV Q
SOD\HGLQR ZULWL YHU\VLRQ
WKUHHWLPHVLUGQHUD6RPHERG\GHFLGHGWRSQJODH
6KLYD0RRQ3UHP-RVKXD
&LUFOHV%7 J
'HHS&KDQQHO$IUR&HOWV WKDWKDGEHHQSO URZIROORZHGE\´&LUFOHVµ\D´/LVWHQµ
3DVVHQJHU+HDGPL[
D\HGHDUOLHU VRQJ
:HFDQ·WFKDQJHW
/LVWHQ7DKLWL
EHFDXVHVRPHWLPHV KHZD\WKHWH[WILOHLVZUL
/LVWHQ7DKLWL
LQIRUPDWLRQ:H ZH·UHJRLQJWRQHHGDOOWK WWHQ
KDYHWRFKDQJHW DW
KHMDYDFRGH
/LVWHQ7DKLWL
&LUFOHV%7
FKDSWHU
?MVMMLI;M\QV[\MILWNI4Q[\
&ROMTHE#OLLECTION!0)WElNDTHREEMAININTERFACES,IST3ETAND
-AP!RRAY,ISTISA,ISTBUTITLOOKSLIKE3ETISEXACTLYWHATWENEED
'XSOLFDWHV2.
/,67ZKHQVHTXHQFHPDWWHUV
&ROOHFWLRQVWKDWNQRZDERXWLQGH[SRVLWLRQ
/LVWVNQRZZKHUHVRPHWKLQJLVLQWKHOLVW<RX
FDQKDYHPRUHWKDQRQHHOHPHQWUHIHUHQFLQJ /LVW
WKHVDPHREMHFW
6(7ZKHQXQLTXHQHVVPDWWHUV 12GXSOLFDWHV
&ROOHFWLRQVWKDWGRQRWDOORZGXSOLFDWHV
6HWVNQRZZKHWKHUVRPHWKLQJLVDOUHDG\LQWKHFROOHFWLRQ
<RXFDQQHYHUKDYHPRUHWKDQRQHHOHPHQWUHIHUHQFLQJ
WKHVDPHREMHFWRUPRUHWKDQRQHHOHPHQWUHIHUHQFLQJ
WZRREMHFWVWKDWDUHFRQVLGHUHGHTXDO³ZH·OOORRNDWZKDW
REMHFWHTXDOLW\PHDQVLQDPRPHQW
6HW
XSOLFDWHNH\V
'XSOLFDWHYDOXHV2.EXW12G
0$3ZKHQILQGLQJVRPHWKLQJE\NH\PDWWHUV
&ROOHFWLRQVWKDWXVHNH\YDOXHSDLUV
0DSVNQRZWKHYDOXHDVVRFLDWHGZLWKDJLYHQNH\<RX
FDQKDYHWZRNH\VWKDWUHIHUHQFHWKHVDPHYDOXHEXW\RX
FDQQRWKDYHGXSOLFDWHNH\V$OWKRXJKNH\VDUHW\SLFDOO\ ´%DOOµ ´)LVKµ´&DUµ
´%DOOµ´%DOOµ´)LVKµ´&DUµ
6WULQJQDPHVVRWKDW\RXFDQPDNHQDPHYDOXHSURSHUW\
OLVWVIRUH[DPSOHDNH\FDQEHDQ\REMHFW 0DS
\RXDUHKHUH
WKHFROOHFWLRQV$3,
<PM+WTTMK\QWV)81XIZ\WNQ\
.OTICETHATTHE-APINTERFACEDOESNT
ACTUALLYEXTENDTHE#OLLECTIONINTERFACE
BUT-APISSTILLCONSIDEREDPARTOFTHE
h#OLLECTION&RAMEWORKvALSOKNOWN
ASTHEh#OLLECTION!0)v 3O-APSARE
&ROOHFWLRQ
STILLCOLLECTIONSEVENTHOUGHTHEYDONT
LQWHUIDFH
INCLUDEJAVAUTIL#OLLECTIONINTHEIR
INHERITANCETREE
.OTETHISISNOTTHECOMPLETE
COLLECTION!0)THEREAREOTHER 6HW /LVW
CLASSESANDINTERFACESBUT LQWHUIDFH LQWHUIDFH
THESEARETHEONESWECARE
MOSTABOUT
6RUWHG6HW
LQWHUIDFH
7UHH6HW /LQNHG+DVK6HW +DVK6HW $UUD\/LVW /LQNHG/LVW 9HFWRU
.(<
EXTENDS
0DSVGRQ·WH[WHQGIURP
IMPLEMENTS MDYDXWLO&ROOHFWLRQEXW
WKH\·UHVWLOOFRQVLGHUHG
+DVK6HW IMPLEMENTATIONCLASS 0DS WREHSDUWRIWKH
LQWHUIDFH ´FROOHFWLRQVIUDPHZRUNµ
6HW INTERFACE LQ-DYD6RD0DSLV
VWLOOUHIHUUHGWRDVD
FROOHFWLRQ
6RUWHG0DS
LQWHUIDFH
7UHH0DS +DVK0DS /LQNHG+DVK0DS +DVKWDEOH
FKDSWHU
=[QVOI0I[P;M\QV[\MILWN)ZZIa4Q[\
7EADDEDONTOTHE*UKEBOXTOPUTTHESONGSINA(ASH3ET.OTEWELEFTOUTSOME
OFTHE*UKEBOXCODEBUTYOUCANCOPYITFROMEARLIERVERSIONS!NDTOMAKEITEASIER
TOREADTHEOUTPUTWEWENTBACKTOTHEEARLIERVERSIONOFTHE3ONGSTO3TRING
METHODSOTHATITPRINTSONLYTHETITLEINSTEADOFTITLEANDARTIST
LPSRUWMDYDXWLO
LPSRUWMDYDLR
SXEOLFFODVV-XNHER[^
PDLQPHWKRGHWF

SXEOLFYRLGJR^ UD\/LVW
JHW6RQJV
:HGLGQ·WFKDQJHJHW6RQJVVRLWVWLOOSXWVWKHVRQJVLQDQ$U
&ROOHFWLRQVVRUWVRQJ/LVW +HUHZHFUHDWHDQHZ+DVK6HW
SDUDPHWHUL]HGWRKROG6RQJV
+DVK6HW6RQJ!VRQJ6HW QHZ+DVK6HW6RQJ!
VRQJ6HWDGG$OOVRQJ/LVW +DVK6HWKDVDVLPSOHDGG$OOPH
6\VWHPRXWSULQWOQVRQJ6HW WDNHDQRWKHUFROOHF WKRGWKDWFDQ
WLRQDQGXVHLWWRSRSXODWH
` WKH+DVK6HW,W·VWKHVDP HDVLIZHDGGHGHDFK
VRQJRQHDWDWLPHH[FHSW PXFKVLPSOHU
JHW6RQJVDQGDGG6RQJPHWKRGV
`
)LOH(GLW:LQGRZ+HOS*HW%HWWHU0XVLF
MDYD-XNHER[
%HIRUHVRUWLQJ
WKH$UUD\/LVW
>3LQN0RRQ6RPHUVDXOW6KLYD0RRQ&LUFOHV'HHS&KDQQHO
3DVVHQJHU/LVWHQ/LVWHQ/LVWHQ&LUFOHV@
$IWHUVRUWLQJ
>&LUFOHV&LUFOHV'HHS&KDQQHO/LVWHQ/LVWHQ/LVWHQ WKH$UUD\/LVW
3DVVHQJHU3LQN0RRQ6KLYD0RRQ6RPHUVDXOW@ E\WLWOH
>3LQN0RRQ/LVWHQ6KLYD0RRQ&LUFOHV/LVWHQ'HHS&KDQQHO
3DVVHQJHU&LUFOHV/LVWHQ6RPHUVDXOW@ $IWHUSXWWLQJLW
LQWRD+DVK6HW
DQGSULQWLQJWKH
7KH6HWGLGQ·WKHOS +DVK6HWZHGLGQ·W
$QGLWORVWLWVVRUWRUGHU FDOOVRUWDJDLQ
:HVWLOOKDYHDOOWKHGXSOLFDWHV ZKHQZHSXWWKHOLVWLQWRDERXW
+DVK6HWEXWZH·OOZRUU\D
WKDWRQHODWHU
\RXDUHKHUH
REMHFWHTXDOLW\
?PI\UISM[\ _WWJRMK\[MY]IT ' ,IWZRREMHFWVIRRDQGEDUDUH

HTXDOIRRHTXDOVEDUPXVWEH
&IRSTWEHAVETOASKWHATMAKESTWO3ONGREFERENCES WUXHDQGERWKIRRDQGEDUPXVW
DUPLICATES4HEYMUSTBECONSIDEREDEQUAL)SITSIMPLYTWO UHWXUQWKHVDPHYDOXHIURP
REFERENCESTOTHEVERYSAMEOBJECTORISITTWOSEPARATEOBJECTS KDVK&RGH)RUD6HWWRWUHDW
WZRREMHFWVDVGXSOLFDWHV\RX
THATBOTHHAVETHESAMETITLE
PXVWRYHUULGHWKHKDVK&RGH
4HISBRINGSUPAKEYISSUEREFERENCEEQUALITYVSOBJECTEQUALITY DQGHTXDOVPHWKRGVLQKHULWHG
IURPFODVV2EMHFWVRWKDW\RX
FDQPDNHWZRGLIIHUHQWREMHFWV
7ZRUHIHUHQFHVRQHREMHFWRQWKHKHDS
5HIHUHQFHHTXDOLW\ EHYLHZHGDVHTXDO
7ZRUHIHUHQFHVWKDWUHIHUWRWKHVDPHREMHFWRQ
WKHKHDSDUHHTXDO3HULRG,I\RXFDOOWKHKDVK&RGHPHWKRGRQ
ERWKUHIHUHQFHV\RX·OOJHWWKHVDPHUHVXOW,I\RXGRQ·WRYHUULGHWKH WLWOH&LUFOHV
KDVK&RGHPHWKRGWKHGHIDXOWEHKDYLRUUHPHPEHU\RXLQKHULWHG KDVK&RGH
WKLVIURPFODVV2EMHFWLVWKDWHDFKREMHFWZLOOJHWDXQLTXHQXPEHU ^gg
PRVWYHUVLRQVRI-DYDDVVLJQDKDVKFRGHEDVHGRQWKHREMHFW·V
PHPRU\DGGUHVVRQWKHKHDSVRQRWZRREMHFWVZLOOKDYHWKHVDPH 6RQJ
KDVKFRGH ZYj
,I\RXZDQWWRNQRZLIWZRUHIHUHQFHVDUHUHDOO\UHIHUULQJWRWKHVDPH
REMHFWXVHWKH RSHUDWRUZKLFKUHPHPEHUFRPSDUHVWKHELWVLQ 6RQJ
WKHYDULDEOHV,IERWKUHIHUHQFHVSRLQWWRWKHVDPHREMHFWWKHELWVZLOO LIIRR EDU^
EHLGHQWLFDO ERWKUHIHUHQFHVDUHUHIHUULQJ
WRWKHVDPHREMHFWRQWKHKHDS
`
7ZRUHIHUHQFHVWZRREMHFWVRQWKHKHDSEXW
2EMHFWHTXDOLW\
WLWOH&LUFOHV
KDVK&RGH
WKHREMHFWVDUHFRQVLGHUHGPHDQLQJIXOO\HTXLYDOHQW
,I\RXZDQWWRWUHDWWZRGLIIHUHQW6RQJREMHFWVDVHTXDOIRU WLWOH&LUFOHV
H[DPSOHLI\RXGHFLGHGWKDWWZR6RQJVDUHWKHVDPHLIWKH\KDYH KDVK&RGH
PDWFKLQJWLWOHYDULDEOHV\RXPXVWRYHUULGHERWKWKHKDVK&RGH ^gg
DQGHTXDOVPHWKRGVLQKHULWHGIURPFODVV2EMHFW
$VZHVDLGDERYHLI\RXGRQ·WRYHUULGHKDVK&RGHWKHGHIDXOW 6RQJ
EHKDYLRUIURP2EMHFWLVWRJLYHHDFKREMHFWDXQLTXHKDVKFRGH ZYj
YDOXH6R\RXPXVWRYHUULGHKDVK&RGHWREHVXUHWKDWWZR
HTXLYDOHQWREMHFWVUHWXUQWKHVDPHKDVKFRGH%XW\RXPXVWDOVR 6RQJ
RYHUULGHHTXDOVVRWKDWLI\RXFDOOLWRQHLWKHUREMHFWSDVVLQJLQ
WKHRWKHUREMHFWDOZD\VUHWXUQVWUXH
LIIRRHTXDOVEDU IRRKDVK&RGH EDUKDVK&RGH^
ERWKUHIHUHQFHVDUHUHIHUULQJWRHLWKHUD
DVLQJOHREMHFWRUWRWZRREMHFWVWKDWDUHHTXDO
`
FKDSWHU
0W_I0I[P;M\KPMKS[NWZL]XTQKI\M["PI[P+WLMIVLMY]IT[
7HENYOUPUTANOBJECTINTOA(ASHSETITUSESTHE (ASH3ETlNDSAMATCHINGHASHCODEFORTWOOBJECTS
OBJECTSHASHCODEVALUETODETERMINEWHERETOPUT ONEYOUREINSERTINGANDONEALREADYINTHESETTHE
THEOBJECTINTHE3ET"UTITALSOCOMPARESTHEOBJECTS (ASH3ETWILLTHENCALLONEOFTHEOBJECTSEQUALS
HASHCODETOTHEHASHCODEOFALLTHEOTHEROBJECTSIN METHODSTOSEEIFTHESEHASHCODE MATCHEDOBJECTS
THE(ASH3ETANDIFTHERESNOMATCHINGHASHCODE REALLYAREEQUAL
THE(ASH3ETASSUMESTHATTHISNEWOBJECTISNOTA !NDIFTHEYREEQUALTHE(ASH3ETKNOWSTHATTHE
DUPLICATE OBJECTYOUREATTEMPTINGTOADDISADUPLICATEOF
)NOTHERWORDSIFTHEHASHCODESAREDIFFERENTTHE SOMETHINGINTHE3ETSOTHEADDDOESNTHAPPEN
(ASH3ETASSUMESTHERESNOWAYTHEOBJECTSCANBE 9OUDONTGETANEXCEPTIONBUTTHE(ASH3ETSADD
EQUAL METHODRETURNSABOOLEANTOTELLYOUIFYOUCARE
3OYOUMUSTOVERRIDEHASH#ODE TOMAKESURETHE WHETHERTHENEWOBJECTWASADDED3OIFTHEADD
OBJECTSHAVETHESAMEVALUE METHODRETURNSFALSEYOUKNOWTHENEWOBJECTWASA
"UTTWOOBJECTSWITHTHESAMEHASH#ODE MIGHTNOT DUPLICATEOFSOMETHINGALREADYINTHESET
BEEQUALMOREONTHISONTHENEXTPAGE SOIFTHE
,QHHGWRNQRZ
KDVK&RGH
2EMHFW\RX·UHWU\LQJWR
LI\RXUKDVKFRGH DGGWRWKH+DVK6HW
YDOXHVDUHWKHVDPH WLWOH&LUFOHV
KDVK&RGH
^gg

6RQJ
+DVK6HW KDVK&R
GH
ZYj 2EMHFWDOUHDG\,1
WLWOH&LUFOHV WKH+DVK6HW
6RQJ KDVK&RGH
<RXUKDVKFRGHV
DUHWKHVDPHEXWDUH
\RX5($//<HTXDO" HTXDOVED 2EMHFW\RX·UHWU\LQJ
U WRDGGUXQVLWVHTXDOV
WLWOH&LUFOHV PHWKRGFRPSDULQJLWVHOI
KDVK&RGH WREDUDQGUHWXUQVWUXH
^gg WUXH
6RQJ
+DVK6HW
ZYj 2EMHFWDOUHDG\,1
WLWOH&LUFOHV WKH+DVK6HW
6RQJ KDVK&RGH
\RXDUHKHUH
RYHUULGLQJKDVK&RGHDQGHTXDOV
<PM;WVOKTI[[_Q\PW^MZZQLLMV
PI[P+WLMIVLMY]IT[
FODVV6RQJLPSOHPHQWV&RPSDUDEOH6RQJ!^
OOLQJWKLV
6WULQJWLWOH
6WULQJDUWLVW
HW R U D Q\RQHHOVHRFD
6WULQJUDWLQJ 7KH+ VHQGVLWDQRWKHU6
D VK 6 QJ
6WULQJESP PHWKRG

SXEOLFERROHDQHTXDOV2EMHFWD6RQJ^ 5( $ 7 Q HZ V LV WK DWWLWOHLVD6VWULQJ
7KH* TX DO
6RQJV 6RQJD6RQJ DQG6WULQJVKDOZYHDQRYHUULGGHQLVHDVNRQH
KD YH WR GR
UHWXUQJHW7LWOHHTXDOVVJHW7LWOH PHWKRG6RDO XDH RWKHRWKHUVRQJ·V
WLWOH
` WLWOHLILW·VHT OW
SXEOLFLQWKDVK&RGH^ 6DPHGHDOKHUH H6WU
UHWXUQWLWOHKDVK&RGH KDVK&RGHPHWKRWK G VR \R
LQJFODVVKDVDQRYHUULGGH
Q
` FDOOLQJKDVK&RGHRQWKHWXFDQMXVWUHWXUQWKHUHVXOWRI

LWO
DQGHTXDOVDUHXVLQJWKH H1RWLFHKRZKDVK&RGH
SXEOLFLQWFRPSDUH7R6RQJV^
6$0(LQVWDQFHYDULDEOH
UHWXUQWLWOHFRPSDUH7RVJHW7LWOH
`
6RQJ6WULQJW6WULQJD6WULQJU6WULQJE^
WLWOH W
DUWLVW D 1RZLWZRUNV1RGXSOLFDWHVZKHQZH
UDWLQJ U SULQWRXWWKH+DVK6HW%XWZHGLGQ·W
ESP E FDOOVRUWDJDLQDQGZKHQZHSXW
` WKH$UUD\/LVWLQWRWKH+DVK6HWWKH
+DVK6HWGLGQ·WSUHVHUYHWKHVRUWRUGHU
UHWXUQWLWOH )LOH(GLW:LQGRZ+HOS5HERRW:LQGRZV
`
MDYD-XNHER[
UHWXUQDUWLVW >3LQN0RRQ6RPHUVDXOW6KLYD0RRQ&LUFOHV
`
'HHS&KDQQHO3DVVHQJHU/LVWHQ/LVWHQ
SXEOLF6WULQJJHW5DWLQJ^ /LVWHQ&LUFOHV@
UHWXUQUDWLQJ
` >&LUFOHV&LUFOHV'HHS&KDQQHO/LVWHQ
/LVWHQ/LVWHQ3DVVHQJHU3LQN0RRQ6KLYD
SXEOLF6WULQJJHW%SP^
UHWXUQESP 0RRQ6RPHUVDXOW@
`
>3LQN0RRQ/LVWHQ6KLYD0RRQ&LUFOHV
SXEOLF6WULQJWR6WULQJ^ 'HHS&KDQQHO3DVVHQJHU6RPHUVDXOW@
UHWXUQWLWOH
`
`
FKDSWHU
WKHUH DUH QR
-DYD2EMHFW/DZ)RU+DVK&RGH
'XPE 4XHVWLRQV
DQGHTXDOV Q: (OWCOMEHASHCODESCANBETHESAME
EVENIFOBJECTSARENTEQUAL
7KH$3,GRFVIRUFODVV2EMHFWVWDWHWKH
UXOHV\RX0867IROORZ
A: (ASH3ETSUSEHASHCODESTOSTORETHEELE
,IWZRREMHFWVDUHHTXDOWKH\0867
KDYHPDWFKLQJKDVKFRGHV
MENTSINAWAYTHATMAKESITMUCHFASTERTOACCESS
)FYOUTRYTOFINDANOBJECTINAN!RRAY,ISTBYGIVING
THE!RRAY,ISTACOPYOFTHEOBJECTASOPPOSEDTO
ANINDEXVALUE THE!RRAY,ISTHASTOSTARTSEARCHING
,IWZRREMHFWVDUHHTXDOFDOOLQJ
HTXDOVRQHLWKHUREMHFW0867UHWXUQ
FROMTHEBEGINNINGLOOKINGATEACHELEMENTIN
THELISTTOSEEIFITMATCHES"UTA(ASH3ETCANFIND
ANOBJECTMUCHMOREQUICKLYBECAUSEITUSESTHE
Licensed by
WUXH,QRWKHUZRUGVLIDHTXDOVEWKHQ HASHCODEASAKINDOFLABELONTHEhBUCKETvWHERE
EHTXDOVD ITSTOREDTHEELEMENT3OIFYOUSAYh)WANTYOU
TOFINDANOBJECTINTHESETTHATSEXACTLYLIKETHIS
ONEvTHE(ASH3ETGETSTHEHASHCODEVALUEFROM
,IWZRREMHFWVKDYHWKHVDPHKDVKFRGH THECOPYOFTHE3ONGYOUGIVEITSAY AND
Eduard Simons
YDOXHWKH\DUH127UHTXLUHGWREHHTXDO THENTHE(ASH3ETSAYSh/H)KNOWEXACTLYWHERE
%XWLIWKH\·UHHTXDOWKH\0867KDYHWKH THEOBJECTWITHHASHCODEISSTOREDvANDIT
VDPHKDVKFRGHYDOXH GOESRIGHTTOTHEBUCKET
4HISISNTTHEWHOLESTORYYOUGETINACOMPUTER
SCIENCECLASSBUTITSENOUGHFORYOUTOUSE(ASH
104038
6RLI\RXRYHUULGHHTXDOV\RX0867 3ETSEFFECTIVELY)NREALITYDEVELOPINGAGOODHASH
RYHUULGHKDVK&RGH CODEALGORITHMISTHESUBJECTOFMANYA0H$THESIS
ANDMORETHANWEWANTTOCOVERINTHISBOOK
7KHGHIDXOWEHKDYLRURIKDVK&RGH
LVWRJHQHUDWHDXQLTXHLQWHJHUIRUHDFK
4HEPOINTISTHATHASHCODESCANBETHESAME
WITHOUTNECESSARILYGUARANTEEINGTHATTHEOBJECTS
AREEQUALBECAUSETHEhHASHINGALGORITHMvUSEDIN
REMHFWRQWKHKHDS6RLI\RXGRQ·WRYHUULGH
KDVK&RGHLQDFODVVQRWZRREMHFWVRI THEHASH#ODE METHODMIGHTHAPPENTORETURN
WKDWW\SHFDQ(9(5EHFRQVLGHUHGHTXDO THESAMEVALUEFORMULTIPLEOBJECTS!NDYESTHAT
MEANSTHATMULTIPLEOBJECTSWOULDALLLANDINTHE
SAMEBUCKETINTHE(ASH3ETBECAUSEEACHBUCKET
7KHGHIDXOWEHKDYLRURIHTXDOVLVWR
GRDQ FRPSDULVRQ,QRWKHUZRUGVWR
REPRESENTSASINGLEHASHCODEVALUE BUTTHATSNOT
THEENDOFTHEWORLD)TMIGHTMEANTHATTHE(ASH
3ETISJUSTALITTLELESSEFFICIENTORTHATITSFILLED
WHVWZKHWKHUWKHWZRUHIHUHQFHVUHIHUWRD
WITHANEXTREMELYLARGENUMBEROFELEMENTS BUT
VLQJOHREMHFWRQWKHKHDS6RLI\RXGRQ·W
IFTHE(ASH3ETFINDSMORETHANONEOBJECTINTHE
RYHUULGHHTXDOVLQDFODVVQRWZRREMHFWV
SAMEHASHCODEBUCKETTHE(ASH3ETWILLSIMPLY
FDQ(9(5EHFRQVLGHUHGHTXDOVLQFH
USETHEEQUALS METHODTOSEEIFTHERESAPERFECT
UHIHUHQFHVWRWZRGLIIHUHQWREMHFWVZLOO
MATCH)NOTHERWORDSHASHCODEVALUESARESOME
DOZD\VFRQWDLQDGLIIHUHQWELWSDWWHUQ
TIMESUSEDTONARROWDOWNTHESEARCHBUTTOFIND
THEONEEXACTMATCHTHE(ASH3ETSTILLHASTOTAKE
DHTXDOVEPXVWDOVRPHDQWKDW
ALLTHEOBJECTSINTHATONEBUCKETTHEBUCKETFOR
DKDVK&RGH EKDVK&RGH
ALLOBJECTSWITHTHESAMEHASHCODE ANDTHENCALL
EQUALS ONTHEMTOSEEIFTHEOBJECTITSLOOKINGFOR
%XWDKDVK&RGH EKDVK&RGH
ISINTHATBUCKET
GRHV127KDYHWRPHDQDHTXDOVE
\RXDUHKHUH
7UHH6HWVDQGVRUWLQJ
)VLQN_M_IV\\PM[M\\W[\Ia
[WZ\ML_M¼^MOW\<ZMM;M\
4REE3ETISSIMILARTO(ASH3ETINTHATITPREVENTSDUPLICATES"UTITALSOKEEPSTHELISTSORTED)TWORKS
JUSTLIKETHESORT METHODINTHATIFYOUMAKEA4REE3ETUSINGTHESETSNO ARGCONSTRUCTORTHE
4REE3ETUSESEACHOBJECTSCOMPARE4O METHODFORTHESORT"UTYOUHAVETHEOPTIONOFPASSING
A#OMPARATORTOTHE4REE3ETCONSTRUCTORTOHAVETHE4REE3ETUSETHATINSTEAD4HEDOWNSIDETO
4REE3ETISTHATIFYOUDONTNEEDSORTINGYOURESTILLPAYINGFORITWITHASMALLPERFORMANCEHIT"UT
YOULLPROBABLYlNDTHATTHEHITISALMOSTIMPOSSIBLETONOTICEFORMOSTAPPS
LPSRUWMDYDXWLO
LPSRUWMDYDLR
SXEOLFFODVV-XNHER[^
LQWYDO

QHZ-XNHER[JR
`

UH H6HWLQVWHDGRQ RI+DVK6HW
H D 7 RU
SXEOLFYRLGJR^ ,Q VW DQ WL DW
QR DU J 7 UH H6HW VWUXMHFW
F
JHW6RQJV &DOOLQJ HWZLOOXVHWKH6RQJRE ·V
WK H FW
6\VWHPRXWSULQWOQVRQJ/LVW PHDQVWKHV PHWKRGIRUWKHVRUW
&ROOHFWLRQVVRUWVRQJ/LVW FRPSDUH7R
XO G KD YH S DV VH G LQD&RPSDUDWRU
7UHH6HW6RQJ!VRQJ6HW QHZ7UHH6HW6RQJ! :HFR
VRQJ6HWDGG$OOVRQJ/LVW
:HFDQDGGDOOWKHVRQJVI WKH+
XVLQJDGG$OO2UZHFRXOGURP
6\VWHPRXWSULQWOQVRQJ6HW DVK6HW
`
VRQ JVL KDYHDGGHGWKH
QGL YLGX DOO\XVLQJVRQ WDGGMXVW
WKHZD\ZHDGGHGVRQJVWJ6H

YRLGJHW6RQJV^ RWKH$UUD\/LVW
WU\^
)LOH¿OH QHZ)LOH³6RQJ/LVW0RUHW[W´
6WULQJOLQH QXOO
DGG6RQJOLQH
`
`FDWFK([FHSWLRQH[^
H[SULQW6WDFN7UDFH
`
`
VRQJ/LVWDGGQH[W6RQJ
`
`
FKDSWHU
?PI\aW]5=;<SVW_IJW]\<ZMM;M\
4REE3ETLOOKSEASYBUTMAKESUREYOUREALLYUNDERSTANDWHATYOUNEEDTO
DOTOUSEIT7ETHOUGHTITWASSOIMPORTANTTHATWEMADEITANEXERCISESO
YOUDHAVETOTHINKABOUTIT$O./4TURNTHEPAGEUNTILYOUVEDONETHIS
7EMEANIT
6KDUSHQ \RXU SHQFLO LPSRUWMDYDXWLO
SXEOLFFODVV7HVW7UHH^
,OOKATTHISCODE SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^
2EADITCAREFULLYTHEN QHZ7HVW7UHHJR
ANSWERTHEQUESTIONS `
BELOW.OTETHERE
ARENOSYNTAXERRORS SXEOLFYRLGJR^
INTHISCODE %RRNE QHZ%RRN³+RZ&DWV:RUN´
%RRNE QHZ%RRN³5HPL[\RXU%RG\´
%RRNE QHZ%RRN³)LQGLQJ(PR´

7UHH6HW%RRN!WUHH QHZ7UHH6HW%RRN!
WUHHDGGE
WUHHDGGE
WUHHDGGE
6\VWHPRXWSULQWOQWUHH
`
`
FODVV%RRN^
6WULQJWLWOH
SXEOLF%RRN6WULQJW^
WLWOH W
`
`
7HATISTHERESULTWHENYOUCOMPILETHISCODE
)FITCOMPILESWHATISTHERESULTWHENYOURUNTHE4EST4REECLASS
)FTHEREISAPROBLEMEITHERCOMPILE TIMEORRUNTIME WITHTHISCODEHOWWOULDYOUFIXIT
\RXDUHKHUH
KRZ7UHH6HWVVRUW
<ZMM;M\MTMUMV\[5=;<JMKWUXIZIJTM
4REE3ETCANTREADTHEPROGRAMMERSMINDTOlGUREOUTHOWTHE
OBJECTSSHOULDBESORTED9OUHAVETOTELLTHE4REE3ETHOW
7RXVHD7UHH6HWRQHRIWKHVH
WKLQJVPXVWEHWUXH
7KHHOHPHQWVLQ
WKHOLVWPXVWEHRIDW\SHWKDW
LPSOHPHQWV&RPSDUDEOH
7KH%RRNFODVVRQWKHSUHYLRXV FODVV%RRNLPSOHPHQWV&RPSDUDEOH^
SDJHGLGQ·WLPSOHPHQW&RPSDUDEOHVRLW 6WULQJWLWOH
ZRXOGQ·WZRUNDWUXQWLPH7KLQNDERXWLWWKH SXEOLF%RRN6WULQJW^
SRRU7UHH6HW·VVROHSXUSRVHLQOLIHLVWRNHHS WLWOH W
\RXUHOHPHQWVVRUWHGDQGRQFHDJDLQ³LWKDG `
QRLGHDKRZWRVRUW%RRNREMHFWV,WGRHVQ·WIDLO SXEOLFLQWFRPSDUH7R2EMHFWE^
DWFRPSLOHWLPHEHFDXVHWKH7UHH6HWDGG %RRNERRN %RRNE
UHWXUQWLWOHFRPSDUH7RERRNWLWOH
PHWKRGGRHVQ·WWDNHD&RPSDUDEOHW\SH7KH
`
7UHH6HWDGGPHWKRGWDNHVZKDWHYHUW\SH `
\RXXVHGZKHQ\RXFUHDWHGWKH7UHH6HW,Q
RWKHUZRUGVLI\RXVD\QHZ7UHH6HW%RRN!
WKHDGGPHWKRGLVHVVHQWLDOO\DGG%RRN$QG
WKHUH·VQRUHTXLUHPHQWWKDWWKH%RRNFODVV
LPSOHPHQW&RPSDUDEOH%XWLWIDLOVDWUXQWLPH
ZKHQ\RXDGGWKHVHFRQGHOHPHQWWRWKHVHW
7KDW·VWKHILUVWWLPHWKHVHWWULHVWRFDOORQHRI
WKHREMHFW·VFRPSDUH7RPHWKRGVDQGFDQ·W
25 SXEOLFFODVV%RRN&RPSDUHLPSOHPHQWV&RPSDUDWRU%RRN! ^
<RXXVHWKH7UHH6HW·V
RYHUORDGHGFRQVWUXFWRU
SXEOLFLQWFRPSDUH%RRNRQH%RRNWZR^
UHWXUQRQHWLWOHFRPSDUH7RWZRWLWOH
WKDWWDNHVD&RPSDUDWRU `
`
7UHH6HWZRUNVDORWOLNHWKHVRUW FODVV7HVW^
PHWKRG³\RXKDYHDFKRLFHRIXVLQJWKH SXEOLFYRLGJR^
HOHPHQW·VFRPSDUH7RPHWKRGDVVXPLQJ %RRNE QHZ%RRN³+RZ&DWV:RUN´
%RRNE QHZ%RRN³5HPL[\RXU%RG\´
WKHHOHPHQWW\SHLPSOHPHQWHGWKH
%RRNE QHZ%RRN³)LQGLQJ(PR´
&RPSDUDEOHLQWHUIDFH25\RXFDQXVH %RRN&RPSDUHE&RPSDUH QHZ%RRN&RPSDUH
DFXVWRP&RPSDUDWRUWKDWNQRZVKRZ 7UHH6HW%RRN!WUHH QHZ7UHH6HW%RRN!E&RPSDUH
WRVRUWWKHHOHPHQWVLQWKHVHW7RXVHD WUHHDGGQHZ%RRN³+RZ&DWV:RUN´
FXVWRP&RPSDUDWRU\RXFDOOWKH7UHH6HW WUHHDGGQHZ%RRN³)LQGLQJ(PR´
FRQVWUXFWRUWKDWWDNHVD&RPSDUDWRU WUHHDGGQHZ%RRN³5HPL[\RXU%RG\´
6\VWHPRXWSULQWOQWUHH
`
`
FKDSWHU
?M¼^M[MMV4Q[\[IVL;M\[VW__M¼TT][MI5 IX
,ISTSAND3ETSAREGREATBUTSOMETIMESA-APISTHEBESTCOLLECTIONNOT#OLLECTION
WITHACAPITALh#vREMEMBERTHAT-APSAREPARTOF*AVACOLLECTIONSBUTTHEYDONT
IMPLEMENTTHE#OLLECTIONINTERFACE
)MAGINEYOUWANTACOLLECTIONTHATACTSLIKEAPROPERTYLISTWHEREYOUGIVEITANAME
ANDITGIVESYOUBACKTHEVALUEASSOCIATEDWITHTHATNAME!LTHOUGHKEYSWILLOFTENBE
3TRINGSTHEYCANBEANY*AVAOBJECTORTHROUGHAUTOBOXINGAPRIMITIVE
YDOXH (DFKHOHPHQWLQD0DSLVDFWXDOO\
7:2REMHFWV³DNH\DQGDYDOXH
´%DOOµ ´)LVKµ´&DUµ
´%DOOµ´%DOOµ´%DOOµ´%DOOµ <RXFDQKDYHGXSOLFDWHYDOXHVEXW
NH\ 127GXSOLFDWHNH\V
0DS
0DSH[DPSOH
LPSRUWMDYDXWLO
+DVK0DSQHHGV7:2W\SHSDUDPHWH
RQHIRUWKHNH\DQGRQHIRU UV³
SXEOLFFODVV7HVW0DS^ WKHYDOXH
+DVK0DS6WULQJ,QWHJHU!VFRUHV QHZ+DVK0DS6WULQJ,QWHJHU!
VFRUHVSXW³.DWK\´ 8VHSXWLQVWHDGRIDGG QGQRZ

VFRUHVSXW³%HUW´ LWWDNHVWZRDUJXPHQWVNHD
\YDOXH
RIFRXUVH
VFRUHVSXW³6N\OHU´
6\VWHPRXWSULQWOQVFRUHV
6\VWHPRXWSULQWOQVFRUHVJHW³%HUW´
7KHJHWPHWKRGWDNHVDNH\DQG
` UHWXUQVWKHYDOXHLQWKLVFDVHDQ,Q
` WHJHU
)LOH(GLW:LQGRZ+HOS:KHUH$P,
MDYD7HVW0DS :KHQ\RXSULQWD0DSLWJLYHV\RXW
LQEUDFHV^`LQVWHDGRIWKHEUDF KHNH\ YDOXH
^6N\OHU %HUW .DWK\ ` ZKHQ\RXSULQWOLVWVDQGVHWV NHWV>@\RXVHH

\RXDUHKHUH
JHQHULFW\SHV
.QVITTaJIKS\WOMVMZQK[
,IDPHWKRGDUJXPHQWLVDQDUUD\
2EMEMBEREARLIERINTHECHAPTERWETALKEDABOUTHOWMETHODS RI$QLPDOVLWZLOODOVRWDNHDQ
THATTAKEARGUMENTSWITHGENERICTYPESCANBEWEIRD!NDWE DUUD\RIDQ\$QLPDOVXEW\SH
MEANWEIRDINTHEPOLYMORPHICSENSE)FTHINGSSTARTTOFEEL
STRANGEHEREJUSTKEEPGOINGITTAKESAFEWPAGESTOREALLYTELL ,QRWKHUZRUGVLIDPHWKRGLV
THEWHOLESTORY GHFODUHGDV
7ELLSTARTWITHAREMINDERONHOWARRAYARGUMENTSWORK YRLGIRR$QLPDO>@D^`

POLYMORPHICALLYANDTHENLOOKATDOINGTHESAMETHINGWITH
GENERICLISTS4HECODEBELOWCOMPILESANDRUNSWITHOUTERRORS $VVXPLQJ'RJH[WHQGV$QLPDO
\RXDUHIUHHWRFDOOERWK
+HUH·VKRZLWZRUNVZLWKUHJXODUDUUD\V
IRRDQ$QLPDO$UUD\
IRRD'RJ$UUD\
LPSRUWMDYDXWLO
SXEOLFFODVV7HVW*HQHULFV^
QHZ7HVW*HQHULFVJR
` 'HFODUHDQGFUHDWHDQ$QLPD UD\
WKDWKROGVERWKGRJVDQGFDWODU
V

SXEOLFYRLGJR^
$QLPDO>@DQLPDOV ^QHZ'RJQHZ&DWQHZ'RJ`
'RJ>@GRJV ^QHZ'RJQHZ'RJQHZ'RJ`
WDNH$QLPDOVDQLPDOV 'HFODUHDQGFUHDWHD'RJDUUD\
WDNH$QLPDOVGRJV &DOOWDNH$QLPDOVXVLQJERWK WKDWKROGVRQO\'RJVWKHFRPSLOHU
` DUUD\W\SHVDVDUJXPHQWV ZRQ·WOHW\RXSXWD&DWLQ
SXEOLFYRLGWDNH$QLPDOV$QLPDO>@DQLPDOV^ 7KHFUXFLDOSRLQWLVWKDWWKHWDNH$
IRU$QLPDODDQLPDOV^ PHWKRGFDQWDNHDQ$QLPDO>@RUD'QLPDOV
DHDW 'RJ,6$$QLPDO3RO\PRUSKLVPLQ RJ>@VLQFH
` 5HP HPEHUZHFDQFDOO21/<WKHPHW DFWLRQ
` DQLPDOVLQFHWKHDQLPDOVSDUDPH KRG VG HFOD UHGLQW\SH
`
WHULVRIW\SH$QLPDODUUD\
DQGZHGLGQ·WGRDQ\FDVWLQJ:K
7KDWDUUD\PLJKWKROGERWK'RJVDDWZRXOGZHFDVWLWWR"
QG&DWV
DEVWUDFWFODVV$QLPDO^
YRLGHDW^
6\VWHPRXWSULQWOQ³DQLPDOHDWLQJ´
`
`
FODVV'RJH[WHQGV$QLPDO^
YRLGEDUN^` 7KHVLPSOLILHG$QLPDO
`
FODVVKLHUDUFK\
FODVV&DWH[WHQGV$QLPDO^
YRLGPHRZ^`
`

FKDSWHU
=[QVOXWTaUWZXPQKIZO]UMV\[IVLOMVMZQK[
3OWESAWHOWTHEWHOLETHINGWORKEDWITHARRAYSBUTWILLITWORK
THESAMEWAYWHENWESWITCHFROMANARRAYTOAN!RRAY,IST3OUNDS
REASONABLEDOESNTIT
&IRSTLETSTRYITWITHONLYTHE!NIMAL!RRAY,IST7EMADEJUSTAFEW
CHANGESTOTHEGO METHOD
3DVVLQJLQMXVW$UUD\/LVW$QLPDO!
$VLPSOHFKDQJHIURP$QLPDO>@WR
$UUD\/LVW$QLPDO!
SXEOLFYRLGJR^
$UUD\/LVW$QLPDO!DQLPDOV QHZ$UUD\/LVW$QLPDO!
DQLPDOVDGGQHZ'RJ
DQLPDOVDGGQHZ&DW :HKDYHWRDGGRQHDWDWLPHVLQFH
DQLPDOVDGGQHZ'RJ VKRUWFXWV\QWD[OLN WKHUH·VQR
HWKHUHLVIRUDUUD\FUHDWLRQ
WDNH$QLPDOVDQLPDOV 7KLVLVWKHVDPHFRGHH[FHSWQRZ
` WKH´DQLPDOVµ
YDULDEOHUHIHUVWRDQ$UUD\/LVWLQVW
HDGRIDUUD\
SXEOLFYRLGWDNH$QLPDOV$UUD\/LVW$QLPDO!DQLPDOV^
IRU$QLPDODDQLPDOV^
DHDW 7KHPHWKRGQRZWDNHVDQ$UUD\/LV
` LQVWHDGRIDQDUUD\EXWHYHU\WKLQJW
` WKHVDPH5 HOVHLV
HPHPEHUWKDWIR RSV\QWD[
ZRUNVIRUERWKDUUD\VDQGFROOUOR
HFWLRQV
&RPSLOHVDQGUXQVMXVWÀQH
)LOH(GLW:LQGRZ+HOS&DW)RRG,V%HWWHU
MDYD7HVW*HQHULFV
DQLPDOHDWLQJ
DQLPDOHDWLQJ
DQLPDOHDWLQJ
DQLPDOHDWLQJ
DQLPDOHDWLQJ
DQLPDOHDWLQJ
\RXDUHKHUH
SRO\PRUSKLVPDQGJHQHULFV
*]\_QTTQ\_WZS_Q\P)ZZIa4Q[\$,WO&'
"ECAUSEOFPOLYMORPHISMTHECOMPILERLETUSPASSA$OGARRAY
TOAMETHODWITHAN!NIMALARRAYARGUMENT.OPROBLEM!ND
AN!RRAY,IST!NIMALCANBEPASSEDTOAMETHODWITHAN
!RRAY,IST!NIMALARGUMENT3OTHEBIGQUESTIONISWILLTHE
!RRAY,IST!NIMALARGUMENTACCEPTAN!RRAY,IST$OG)FITWORKS
WITHARRAYSSHOULDNTITWORKHERETOO
3DVVLQJLQMXVW$UUD\/LVW'RJ!
SXEOLFYRLGJR^
$UUD\/LVW$QLPDO!DQLPDOV QHZ$UUD\/LVW$QLPDO!
DQLPDOVDGGQHZ'RJ
DQLPDOVDGGQHZ&DW
DQLPDOVDGGQHZ'RJ
WDNH$QLPDOVDQLPDOV :HNQRZWKLVOLQ HZRUNHGILQH
$UUD\/LVW'RJ!GRJV QHZ$UUD\/LVW'RJ!
GRJVDGGQHZ'RJ 0DNHD'RJ$UUD\/LVWDQGSXWDFR
GRJVDGGQHZ'RJ XSOHGRJVLQ
WDNH$QLPDOVGRJV :LOOWKLVZRUNQRZWKDWZHFKDQJHG
` IURPDQDUUD\WRDQ$UUD\/LVW"
IRU$QLPDODDQLPDOV^
DHDW
`
`
:KHQZHFRPSLOHLW
)LOH(GLW:LQGRZ+HOS&DWV$UH6PDUWHU
MDYD7HVW*HQHULFV
7HVW*HQHULFVMDYDWDNH$QLPDOVMDYDXWLO
$UUD\/LVW$QLPDO!LQ7HVW*HQHULFVFDQQRWEHDSSOLHGWR
,WORRNHGVRULJKW
MDYDXWLO$UUD\/LVW'RJ! EXWZHQWVRZURQJ
WDNH$QLPDOVGRJV
A
HUURU
FKDSWHU
$QG,·PVXSSRVHGWREH2.ZLWKWKLV"7KDW
WRWDOO\VFUHZVP\DQLPDOVLPXODWLRQZKHUHWKH
YHWHULQDU\SURJUDPWDNHVDOLVWRIDQ\W\SHRI
DQLPDOVRWKDWDGRJNHQQHOFDQVHQGDOLVWRIGRJV
DQGDFDWNHQQHOFDQVHQGDOLVWRIFDWVQRZ
\RX·UHVD\LQJ,FDQ·WGRWKDWLI,XVHFROOHFWLRQV
LQVWHDGRIDUUD\V"
?PI\KW]TLPIXXMVQNQ\_MZMITTW_ML
)MAGINETHECOMPILERLETYOUGETAWAYWITHTHAT)TLETYOUPASSAN
!RRAY,IST$OGTOAMETHODDECLAREDAS
IRU$QLPDODDQLPDOV^
DHDW
`
`
4HERESNOTHINGINTHATMETHODTHATLOOKSHARMFULRIGHT!FTERALL
THEWHOLEPOINTOFPOLYMORPHISMISTHATANYTHINGAN!NIMALCAN
DOINTHISCASETHEEAT METHOD A$OGCANDOASWELL3OWHATS
THEPROBLEMWITHHAVINGTHEMETHODCALLEAT ONEACHOFTHE$OG
REFERENCES
.OTHING.OTHINGATALL
4HERESNOTHINGWRONGWITHTHATCODE"UTIMAGINETHISCODEINSTEAD
DQLPDOVDGGQHZ&DW
` <LNHV:HMXVWVWXFND&DWLQZKDW
PLJKWEHD'RJVRQO\$UUD\/LVW
3OTHATSTHEPROBLEM4HERESCERTAINLYNOTHINGWRONGWITHADDINGA
#ATTOAN!RRAY,IST!NIMALANDTHATSTHEWHOLEPOINTOFHAVINGAN
!RRAY,ISTOFASUPERTYPELIKE!NIMALSOTHATYOUCANPUTALLTYPESOF
ANIMALSINASINGLE!NIMAL!RRAY,IST
"UTIFYOUPASSEDA$OG!RRAY,ISTONEMEANTTOHOLD/.,9$OGS
TOTHISMETHODTHATTAKESAN!NIMAL!RRAY,ISTTHENSUDDENLYYOUD
ENDUPWITHA#ATINTHE$OGLIST4HECOMPILERKNOWSTHATIFITLETS
YOUPASSA$OG!RRAY,ISTINTOTHEMETHODLIKETHATSOMEONECOULD
ATRUNTIMEADDA#ATTOYOUR$OGLIST3OINSTEADTHECOMPILERJUST
WONTLETYOUTAKETHERISK
)FYOUDECLAREAMETHODTOTAKE!RRAY,IST!NIMALITCANTAKE/.,9AN
!RRAY,IST!NIMALNOT!RRAY,IST$OGOR!RRAY,IST#AT
\RXDUHKHUH
DUUD\VYV$UUD\/LVWV
:DLWDPLQXWHLIWKLVLVZK\WKH\ZRQ·WOHW
\RXSDVVD'RJ$UUD\/LVWLQWRDPHWKRGWKDW
WDNHVDQ$QLPDO$UUD\/LVW³WRVWRS\RXIURP
SRVVLEO\SXWWLQJD&DWLQZKDWZDVDFWXDOO\D'RJOLVW
WKHQZK\GRHVLWZRUNZLWKDUUD\V"'RQ·W\RXKDYH
WKHVDPHSUREOHPZLWKDUUD\V"&DQ·W\RXVWLOODGG
D&DWREMHFWWRD'RJ>@"
$UUD\W\SHVDUHFKHFNHGDJDLQDW
UXQWLPHEXWFROOHFWLRQW\SHFKHFNV
KDSSHQRQO\ZKHQ\RXFRPSLOH
,ETSSAYYOUDOADDA#ATTOANARRAYDECLAREDAS$OG;=ANARRAYTHAT
WASPASSEDINTOAMETHODARGUMENTDECLAREDAS!NIMAL;=WHICHISA
PERFECTLYLEGALASSIGNMENTFORARRAYS
SXEOLFYRLGJR^
'RJ>@GRJV ^QHZ'RJQHZ'RJQHZ'RJ`
WDNH$QLPDOVGRJV
`
SXEOLFYRLGWDNH$QLPDOV$QLPDO>@DQLPDOV^
DQLPDOV>@ QHZ&DW
` :HSXWDQHZ&DWLQWRD'RJDUUD\7KH
FRPSLOHUDOORZHGLWEHFDXVHLWNQRZVWKDW
\RXPLJKWKDYHSDVVHGD&DWDUUD\RU$QLPDO
DUUD\WRWKHPHWKRGVRWRWKHFRPSLOHULW
ZDVSRVVLEOHWKDWWKLVZDV2.
,WFRPSLOHVEXWZKHQZHUXQLW
)LOH(GLW:LQGRZ+HOS&DWV$UH6PDUWHU
MDYD7HVW*HQHULFV
([FHSWLRQLQWKUHDG³PDLQ´MDYDODQJ$UUD\6WRUH([FHSWLRQ
:KHZ $WOHDVWWKH &DW
-90VWRSSHGLW DW7HVW*HQHULFVWDNH$QLPDOV7HVW*HQHULFVMDYD
DW7HVW*HQHULFVJR7HVW*HQHULFVMDYD
DW7HVW*HQHULFVPDLQ7HVW*HQHULFVMDYD
FKDSWHU
:RXOGQ·WLWEHGUHDP\LIWKHUHZHUH
DZD\WRVWLOOXVHSRO\PRUSKLFFROOHFWLRQ
W\SHVDVPHWKRGDUJXPHQWVVRWKDWP\
YHWHULQDU\SURJUDPFRXOGWDNH'RJOLVWV
DQG&DWOLVWV"7KDWZD\,FRXOGORRSWKURXJK
WKHOLVWVDQGFDOOWKHLULPPXQL]HPHWKRG
EXWLWZRXOGVWLOOKDYHWREHVDIHVRWKDW\RX
Licensed by
FRXOGQ·WDGGD&DWLQWRWKH'RJOLVW%XW,
JXHVVWKDW·VMXVWDIDQWDV\
Eduard Simons
104038
\RXDUHKHUH
JHQHULFZLOGFDUGV
?QTLKIZL[\W\PMZM[K]M
)TLOOKSUNUSUALBUTTHEREISAWAYTOCREATEAMETHODARGUMENTTHAT
CANACCEPTAN!RRAY,ISTOFANY!NIMALSUBTYPE4HESIMPLESTWAYISTO
USEAWILDCARDADDEDTOTHE*AVALANGUAGEEXPLICITLYFORTHISREASON
SXEOLFYRLGWDNH$QLPDOV$UUD\/LVW"H[WHQGV$QLPDO!DQLPDOV^
IRU$QLPDODDQLPDOV^
DHDW 5HPHPEHUWKHNH\ZRUG´H[WHQGVµ
`
` KHUHPHDQVHLWKHUH[WHQGV25
LPSOHPHQWVGHSHQGLQJRQWKH
3ONOWYOUREWONDERINGh7HATSTHEDIFFERENCE$ONTYOUHAVE W\SH6RLI\RXZDQWWRWDNH
THESAMEPROBLEMASBEFORE4HEMETHODABOVEISNTDOING
ANYTHINGDANGEROUSCALLINGAMETHODANY!NIMALSUBTYPEIS
DQ$UUD\/LVWRIW\SHVWKDW
GUARANTEEDTOHAVEBUTCANTSOMEONESTILLCHANGETHISTOADDA LPSOHPHQWWKH3HWLQWHUIDFH
#ATTOTHEANIMALSLISTEVENTHOUGHITSREALLYAN!RRAY,IST$OG \RX·GGHFODUHLWDV
!NDSINCEITSNOTCHECKEDAGAINATRUNTIMEHOWISTHISANY
DIFFERENTFROMDECLARINGITWITHOUTTHEWILDCARDv $UUD\/LVW"H[WHQGV3HW!
!NDYOUDBERIGHTFORWONDERING4HEANSWERIS./7HENYOU
USETHEWILDCARDINYOURDECLARATIONTHECOMPILERWONTLET
YOUDOANYTHINGTHATADDSTOTHELIST
:KHQ\RXXVHDZLOGFDUGLQ\RXUPHWKRG
DUJXPHQWWKHFRPSLOHUZLOO6723\RXIURPGRLQJ
DQ\WKLQJWKDWFRXOGKXUWWKHOLVWUHIHUHQFHGE\WKH
PHWKRGSDUDPHWHU
<RXFDQVWLOOLQYRNHPHWKRGVRQWKHHOHPHQWVLQ
WKHOLVWEXW\RXFDQQRWDGGHOHPHQWVWRWKHOLVW
,QRWKHUZRUGV\RXFDQGRWKLQJVZLWKWKHOLVW
HOHPHQWVEXW\RXFDQ·WSXWQHZWKLQJVLQWKHOLVW
6R\RX·UHVDIHDWUXQWLPHEHFDXVHWKHFRPSLOHU
ZRQ·WOHW\RXGRDQ\WKLQJWKDWPLJKWEHKRUULEOHDW
UXQWLPH
6RWKLVLV2.LQVLGHWDNH$QLPDOV
IRU$QLPDODDQLPDOV^
DHDW
`
%XW7+,6ZRXOGQRWFRPSLOH
DQLPDOVDGGQHZ&DW
FKDSWHU
)T\MZVI\M[aV\I`NWZLWQVO\PM[IUM\PQVO
9OUPROBABLYREMEMBERTHATWHENWELOOKEDATTHESORT METHOD
ITUSEDAGENERICTYPEBUTWITHANUNUSUALFORMATWHERETHETYPE
PARAMETERWASDECLAREDBEFORETHERETURNTYPE)TSJUSTADIFFERENTWAY
OFDECLARINGTHETYPEPARAMETERBUTTHERESULTSARETHESAME
7KLV
'RHVWKHVDPHWKLQJDVWKLV
SXEOLFYRLGWDNH7KLQJ$UUD\/LVW"H[WHQGV$QLPDO!OLVW
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: )FTHEYBOTHDOTHESAMETHINGWHYWOULDYOUUSE
ONEOVERTHEOTHER
A: )TALLDEPENDSONWHETHERYOUWANTTOUSEh4vSOME
WHEREELSE&OREXAMPLEWHATIFYOUWANTTHEMETHODTO
HAVETWOARGUMENTSBOTHOFWHICHARELISTSOFATYPETHAT
EXTEND!NIMAL)NTHATCASEITSMOREEFFICIENTTOJUSTDECLARE
THETYPEPARAMETERONCE
SXEOLF7H[WHQGV$QLPDO!YRLGWDNH7KLQJ$UUD\/LVW7!RQH$UUD\/LVW7!WZR
)NSTEADOFTYPING
SXEOLFYRLGWDNH7KLQJ$UUD\/LVW"H[WHQGV$QLPDO!RQH
$UUD\/LVW"H[WHQGV$QLPDO!WZR

\RXDUHKHUH
EHWKHFRPSLOHUH[HUFLVH
1dQÔU_Q
"%THECOMPILERADVANCED
9OURJOBISTOPLAYCOMPILERANDDETERMINEWHICHOF
THESESTATEMENTSWOULDCOMPILE"UTSOMEOFTHIS
CODEWASNTCOVEREDINTHECHAPTERSOYOUNEEDTO
WORKOUTTHEANSWERSBASEDONWHATYOU$)$LEARN
APPLYINGTHEhRULESvTOTHESENEWSITUATIONS)N
SOMECASESYOUMIGHTHAVETOGUESSBUTTHE
POINTISTOCOMEUPWITHAREASONABLEANSWER
BASEDONWHATYOUKNOWSOFAR
.OTEASSUMETHATTHISCODEISWITHINALEGALCLASSAND
METHOD
#OMPILES
Q $UUD\/LVW'RJ!GRJV QHZ$UUD\/LVW$QLPDO!

Q

$UUD\/LVW$QLPDO!DQLPDOV QHZ$UUD\/LVW'RJ!
Q /LVW$QLPDO!OLVW QHZ$UUD\/LVW$QLPDO!
Q $UUD\/LVW'RJ!GRJV QHZ$UUD\/LVW'RJ!
Q $UUD\/LVW$QLPDO!DQLPDOV GRJV
Q /LVW'RJ!GRJ/LVW GRJV
Q $UUD\/LVW2EMHFW!REMHFWV QHZ$UUD\/LVW2EMHFW!
Q /LVW2EMHFW!REM/LVW REMHFWV
Q

$UUD\/LVW2EMHFW!REMV QHZ$UUD\/LVW'RJ!
FKDSWHU
LPSRUWMDYDXWLO 3OLUTIONTOTHE±2EVERSE
SXEOLFFODVV6RUW0RXQWDLQV^ %NGINEER²SHARPENEXERCISE
/LQNHG/LVW0RXQWDLQ!PWQ QHZ/LQNHG/LVW0RXQWDLQ!
FODVV1DPH&RPSDUHLPSOHPHQWV&RPSDUDWRU0RXQWDLQ!^
UHWXUQRQHQDPHFRPSDUH7RWZRQDPH
`
`
FODVV+HLJKW&RPSDUHLPSOHPHQWV&RPSDUDWRU0RXQWDLQ!^
UHWXUQWZRKHLJKWRQHKHLJKW
`
`
HKHLJKWOLVWLV
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ 'LG\RXQRWLFHWKDVHWTXWKHQFH"
QHZ6RUW0RXQWDLQJR LQ'(6&(1',1*
`
SXEOLFYRLGJR^
PWQDGGQHZ0RXQWDLQ´/RQJVµ
PWQDGGQHZ0RXQWDLQ´(OEHUWµ
PWQDGGQHZ0RXQWDLQ´0DURRQµ
PWQDGGQHZ0RXQWDLQ´&DVWOHµ
6\VWHPRXWSULQWOQ´DVHQWHUHG?QµPWQ
1DPH&RPSDUHQF QHZ1DPH&RPSDUH
&ROOHFWLRQVVRUWPWQQF
6\VWHPRXWSULQWOQÉ\QDPH?QµPWQ
+HLJKW&RPSDUHKF QHZ+HLJKW&RPSDUH
&ROOHFWLRQVVRUWPWQKF
6\VWHPRXWSULQWOQÉ\KHLJKW?QµPWQ
`
`
FODVV0RXQWDLQ^
6WULQJQDPH /UTPUT
LQWKHLJKW
)LOH(GLW:LQGRZ+HOS7KLV2QH¶V)RU%RE
MDYD6RUW0RXQWDLQV
0RXQWDLQ6WULQJQLQWK^
DVHQWHUHG
QDPH Q >/RQJV(OEHUW0DURRQ&DVWOH@
KHLJKW K E\QDPH
`
>&DVWOH(OEHUW/RQJV0DURRQ@
SXEOLF6WULQJWR6WULQJ^
E\KHLJKW
UHWXUQQDPH´´KHLJKW >(OEHUW&DVWOH/RQJV0DURRQ@
`
\RXDUHKHUH
ILOOLQWKHEODQNVROXWLRQ
%XERCISE3OLUTION
3RVVLEOH$QVZHUV
&RPSDUDWRU
&RPSDUDEOH
FRPSDUH7R
FRPSDUH
\HV
QR
&ROOHFWLRQVVRUWP\$UUD\/LVW
7HATMUSTTHECLASSOFTHEOBJECTSSTOREDINP\$UUD\/LVWIMPLEMENT&RPSDUDEOH
7HATMETHODMUSTTHECLASSOFTHEOBJECTSSTOREDINP\$UUD\/LVWIMPLEMENTFRPSDUH7R
#ANTHECLASSOFTHEOBJECTSSTOREDINP\$UUD\/LVWIMPLEMENTBOTH
&RPSDUDWRU!.$&RPSDUDEOH\HV
&ROOHFWLRQVVRUWP\$UUD\/LVWP\&RPSDUH
#ANTHECLASSOFTHEOBJECTSSTOREDINP\$UUD\/LVWIMPLEMENT&RPSDUDEOH\HV
#ANTHECLASSOFTHEOBJECTSSTOREDINP\$UUD\/LVWIMPLEMENT&RPSDUDWRU\HV
-USTTHECLASSOFTHEOBJECTSSTOREDINP\$UUD\/LVWIMPLEMENT&RPSDUDEOHQR
-USTTHECLASSOFTHEOBJECTSSTOREDINP\$UUD\/LVWIMPLEMENT&RPSDUDWRUQR
7HATMUSTTHECLASSOFTHEP\&RPSDUHOBJECTIMPLEMENT&RPSDUDWRU
7HATMETHODMUSTTHECLASSOFTHEP\&RPSDUHOBJECTIMPLEMENTFRPSDUH
FKDSWHU
"%THECOMPILERSOLUTION
#OMPILES
Q $UUD\/LVW'RJ!GRJV QHZ$UUD\/LVW$QLPDO!

Q

$UUD\/LVW$QLPDO!DQLPDOV QHZ$UUD\/LVW'RJ!
Q /LVW$QLPDO!OLVW QHZ$UUD\/LVW$QLPDO!
Q $UUD\/LVW'RJ!GRJV QHZ$UUD\/LVW'RJ!
Q $UUD\/LVW$QLPDO!DQLPDOV GRJV
Q /LVW'RJ!GRJ/LVW GRJV
Q $UUD\/LVW2EMHFW!REMHFWV QHZ$UUD\/LVW2EMHFW!
Q /LVW2EMHFW!REM/LVW REMHFWV
Q

$UUD\/LVW2EMHFW!REMV QHZ$UUD\/LVW'RJ!
\RXDUHKHUH
SDFNDJHMDUVDQGGHSOR\PHQW
5HOHDVH<RXU&RGH
,W·VWLPHWROHWJR9OUWROTEYOURCODE9OUTESTEDYOURCODE9OUREFINEDYOURCODE
9OUTOLDEVERYONEYOUKNOWTHATIFYOUNEVERSAWALINEOFCODEAGAINTHATDBEFINE"UTINTHE
ENDYOUVECREATEDAWORKOFART4HETHINGACTUALLYRUNS"UTNOWWHAT(OWDOYOUGIVEITTO
ENDUSERS7HATEXACTLYDOYOUGIVETOENDUSERS7HATIFYOUDONTEVENKNOWWHOYOUREND
USERSARE)NTHESEFINALTWOCHAPTERSWELLEXPLOREHOWTOORGANIZEPACKAGEANDDEPLOYYOUR
*AVACODE7ELLLOOKATLOCALSEMI LOCALANDREMOTEDEPLOYMENTOPTIONSINCLUDINGEXECUTABLE
JARS*AVA7EB3TART2-)AND3ERVLETS)NTHISCHAPTERWELLSPENDMOSTOFOURTIMEONORGANIZING
ANDPACKAGINGYOURCODETHINGSYOULLNEEDTOKNOWREGARDLESSOFYOURULTIMATEDEPLOYMENT
CHOICE)NTHEFINALCHAPTERWELLFINISHWITHONEOFTHECOOLESTTHINGSYOUCANDOIN*AVA2ELAX
2ELEASINGYOURCODEISNOTSAYINGGOODBYE4HERESALWAYSMAINTENANCE
WKLVLVDQHZFKDSWHU
-DYDGHSOR\PHQW
,MXTWaQVOaW]ZIXXTQKI\QWV
7HATEXACTLYISA*AVAAPPLICATION)NOTHERWORDS
ONCEYOUREDONEWITHDEVELOPMENTWHATISITTHATYOU
DELIVER#HANCESAREYOUREND USERSDONTHAVEASYSTEM
IDENTICALTOYOURS-OREIMPORTANTLYTHEYDONTHAVEYOUR $-DYDSURJUDPLVDEXQFK
APPLICATION3ONOWITSTIMETOGETYOURPROGRAMINSHAPE
FORDEPLOYMENTINTO4HE/UTSIDE7ORLD)NTHISCHAPTER RIFODVVHV7KDW·VWKH
WELLLOOKATLOCALDEPLOYMENTSINCLUDING%XECUTABLE*ARS
ANDTHEPART LOCALPART REMOTETECHNOLOGYCALLED*AVA7EB RXWSXWRI\RXUGHYHORSPHQW
3TART)NTHENEXTCHAPTERWELLLOOKATTHEMOREREMOTE
DEPLOYMENTOPTIONSINCLUDING2-)AND3ERVLETS 7KHUHDOTXHVWLRQLVZKDW
'HSOR\PHQWRSWLRQV WRGRZLWKWKRVHFODVVHV
)LOH(GLW9LHZ
)LOH(GLW9LHZ
+773
)LOH(GLW9LHZ
+773 ZKHQ\RX·UHGRQH
50,
6HUYOHWV
([HFXWDEOH
-DU :HE6WDUW 50,DSS
/RFDO &RPELQDWLRQ5HPRWH
/RFDO
7KHHQWLUHDSSOLFDWLRQUXQVRQWKH
HQGXVHU·VFRPSXWHUDVDVWDQGDORQH
SUREDEO\*8,SURJUDPGHSOR\HGDV
DQH[HFXWDEOH-$5ZH·OOORRNDW-$5
LQDIHZSDJHV
DLQ EDUEHOO
EU%UDLQ%DUEHOO
7HATARETHEADVANTAGESAND
&RPELQDWLRQRIORFDODQGUHPRWH DISADVANTAGESOFDELIVERINGYOUR
7KHDSSOLFDWLRQLVGLVWULEXWHGZLWKD *AVAPROGRAMASALOCALSTAND
FOLHQWSRUWLRQUXQQLQJRQWKHXVHU·V ALONEAPPLICATIONRUNNINGON
ORFDOV\VWHPFRQQHFWHGWRDVHUYHU THEEND USERSCOMPUTER
ZKHUHRWKHUSDUWVRIWKHDSSOLFDWLRQ
DUHUXQQLQJ 7HATARETHEADVANTAGESAND
DISADVANTAGESOFDELIVERINGYOUR
*AVAPROGRAMASWEB BASED
5HPRWH SYSTEMWHERETHEUSERINTERACTS
7KHHQWLUH-DYDDSSOLFDWLRQUXQVRQD WITHAWEBBROWSERANDTHE
VHUYHUV\VWHPZLWKWKHFOLHQWDFFHVVLQJ *AVACODERUNSASSERVLETSONTHE
WKHV\VWHPWKURXJKVRPHQRQ-DYD SERVER
PHDQVSUREDEO\DZHEEURZVHU
"UTBEFOREWEREALLYGETINTOTHEWHOLEDEPLOYMENTTHING
LETSTAKEASTEPBACKANDLOOKATWHATHAPPENSWHENYOUVE
lNISHEDPROGRAMMINGYOURAPPANDYOUSIMPLYWANTTOPULL
OUTTHECLASSlLESTOGIVETHEMTOANEND USER7HATSREALLY
INTHATWORKINGDIRECTORY
FKDSWHU
,W·V
ÀQDOO\GRQH
1UIOQVM\PQ[[KMVIZQW
"OBSHAPPILYATWORKONTHElNALPIECESOFHISCOOLNEW
*AVAPROGRAM!FTERWEEKSOFBEINGINTHEh)M JUST
ONE COMPILE AWAYvMODETHISTIMEHESREALLY
DONE4HEPROGRAMISAFAIRLYSOPHISTICATED
'5)APPBUTSINCETHEBULKOFITIS3WING
CODEHESMADEONLYNINECLASSESOFHIS
OWN
Licensed by
!TLASTITSTIMETODELIVERTHEPROGRAMTOTHE
CLIENT(ElGURESALLHEHASTODOISCOPYTHE
NINECLASSlLESSINCETHECLIENTALREADYHAS
THE*AVA!0)INSTALLED(ESTARTSBYDOINGAN
OVONTHEDIRECTORYWHEREALLHISlLESARE
Eduard Simons
104038
:KDWWKH" 7HOA3OMETHINGSTRANGEHASHAPPENED)NSTEADOF
lLESNINESOURCECODElLESANDNINECOMPILEDCLASS
lLES HESEESlLESMANYOFWHICHHAVEVERYSTRANGE
NAMESLIKE
!CCOUNT&ILE,ISTENERCLASS
#HART3AVE,ISTENERCLASS
ANDONITGOES(EHADCOMPLETELYFORGOTTEN
THATTHECOMPILERHASTOGENERATECLASSlLES
FORALLTHOSEINNERCLASS'5)EVENTLISTENERS
HEMADEANDTHATSWHATALLTHESTRANGELY
NAMEDCLASSESARE
.OWHEHASTOCAREFULLYEXTRACTALLTHECLASS
lLESHENEEDS)FHELEAVESEVENONEOFTHEMOUT
HISPROGRAMWONTWORK"UTITSTRICKYSINCEHE
DOESNTWANTTOACCIDENTALLYSENDTHECLIENT
ONEOFHISSOURCECODElLESYETEVERYTHINGIS
INTHESAMEDIRECTORYINONEBIGMESS
\RXDUHKHUH
RUJDQL]LQJ\RXUFODVVHV
;MXIZI\M[W]ZKMKWLMIVLKTI[[NQTM[
!SINGLEDIRECTORYWITHAPILEOFSOURCECODEANDCLASSlLESISA
MESS)TTURNSOUT"OBSHOULDHAVEBEENORGANIZINGHISlLES %XW,WKRXJKW,GLGQ·WKDYH
FROMTHEBEGINNINGKEEPINGTHESOURCECODEANDCOMPILED DFKRLFHDERXWSXWWLQJWKHFODVV
ÀOHVLQZLWKWKHVRXUFHÀOHV
CODESEPARATE)NOTHERWORDSMAKINGSUREHISCOMPILEDCLASS
:KHQ\RXFRPSLOHWKH\MXVWJR
lLESDIDNTLANDINTHESAMEDIRECTORYASHISSOURCECODE WKHUHVRZKDWGR,GR"
4HEKEYISACOMBINATIONOFDIRECTORYSTRUCTUREORGANIZATIONANDTHE
GCOMPILEROPTION
4HEREAREDOZENSOFWAYSYOUCANORGANIZEYOURlLESANDYOUR
COMPANYMIGHTHAVEASPECIlCWAYTHEYWANTYOUTODOIT7E
RECOMMENDANORGANIZATIONALSCHEMETHATSBECOMEALMOST
STANDARDTHOUGH
7ITHTHISSCHEMEYOUCREATEAPROJECTDIRECTORYANDINSIDE
THATYOUCREATEADIRECTORYCALLEDSOURCEANDADIRECTORYCALLED
CLASSES9OUSTARTBYSAVINGYOURSOURCECODEJAVAlLES INTO
THESOURCEDIRECTORY4HENTHETRICKISTOCOMPILEYOURCODE
INSUCHAWAYTHATTHEOUTPUTTHECLASSlLES ENDSUPINTHE
CLASSESDIRECTORY
!NDTHERESANICECOMPILERmAGGTHATLETSYOUDOTHAT
&RPSLOLQJZLWKWKHGGLUHFWRU\ÁDJ
FG0\3URMHFWVRXUFH
MDYDFGFODVVHV0\$SSMDYD
0\3URMHFW
WHOOVWKHFRPSLO RSX VWLOO
FRPSLOHGFRGHFHUODVWVI WWKH WKHODVWWKLQJWLKHVMDYD FRPSLOHGFRGH FRPSLOHIURPU\
LOHV HRI
WKHQDP SLOH
LQWRWKH´FODVVHVGLUHFW
RU\ ODQGVKHUH 7+,6GLUHFWR
WKDW·VRQHGLUHFW ILOHWRFRP
EDFNGRZQDJDLQIRUUR\PXSDQG
FXUUHQWZRUNLQJGLUHFWWKH
RU\
"YUSINGTHEGmAGYOUGETTODECIDEWHICHDIRECTORYTHE FODVVHV VRXUFH
COMPILEDCODELANDSINRATHERTHANACCEPTINGTHEDEFAULTOF
CLASSlLESLANDINGINTHESAMEDIRECTORYASTHESOURCECODE
4OCOMPILEALLTHEJAVAlLESINTHESOURCEDIRECTORYUSE
UXQ\RXUPDLQ
I URPKHUH /RUSHU
LXUHHXJXH
MDYDFGFODVVHV MDYD
WDWYHUR
FRQVH

MDYDFRPSLOHV$//
HXJXHUR/RUH
GRHOLTXLV
GRGHOGLS
VRXUFHILOHVLQWKH

5XQQLQJ\RXUFRGH
FXUUHQWGLUHFWRU\ 0\$SSFODVV 0\$SSMDYD

FG0\3URMHFWFODVVHV WURXEOHVKRRWLQJQRWHHYHU\WKLQJLQWKLVFKDSWHUDVVXPHVWKDWWKH
MDYD0LQL UXQ\RXUSURJUDPI FXUUHQWZRUNLQJGLUHFWRU\LHWKH´µLVLQ\RXUFODVVSDWK,I\RX
WKH¶FODVVHV·GLUHFWRURP KDYHH[SOLFLWO\VHWDFODVVSDWKHQYLURQPHQWYDULDEOHEHFHUWDLQ
U\ WKDWLWFRQWDLQVWKH´µ
FKDSWHU
8]\aW]Z2IÎQVI2):
!*!2lLEISA*AVA!2CHIVE)TSBASEDONTHEPKZIPlLEFORMATANDITLETSYOUBUNDLE
ALLYOURCLASSESSOTHATINSTEADOFPRESENTINGYOURCLIENTWITHCLASSlLESYOUHAND
OVERJUSTASINGLE*!2lLE)FYOUREFAMILIARWITHTHETARCOMMANDON5.)8YOULL
RECOGNIZETHEJARTOOLCOMMANDS.OTEWHENWESAY*!2INALLCAPSWEREREFERRING
-$5
TOTHEARCHIVElLE7HENWEUSELOWERCASEWEREREFERRINGTOTHEJARTOOLYOUUSETO
CREATE*!2lLES
4HEQUESTIONISWHATDOESTHECLIENTDOWITHTHE*!2(OWDOYOUGETITTORUN
9OUMAKETHE*!2EXECUTABLE
!NEXECUTABLE*!2MEANSTHEEND USERDOESNTHAVETOPULLTHECLASSlLESOUTBEFORE
RUNNINGTHEPROGRAM4HEUSERCANRUNTHEAPPWHILETHECLASSlLESARES TILLINTHE
*!24HETRICKISTOCREATEAMANIFESTlLETHATGOESINTHE*!2ANDHOLDSINFORMATION
ABOUTTHElLESINTHE*!24OMAKEA*!2EXECUTABLETHEMANIFESTMUSTTELLTHE*6-
WHICHCLASSHASTHEMAIN METHOD
0DNLQJDQH[HFXWDEOH-$5 0\3URMHFW
0DNHVXUHDOORI\RXUFODVVÀOHVDUHLQ

WKHFODVVHVGLUHFWRU\

:H·UHJRLQJWRUHÀQHWKLVLQDIHZSDJHVEXW

IRUQRZNHHSDOO\RXUFODVVÀOHVVLWWLQJLQWKH FODVVHV

GLUHFWRU\QDPHG¶FODVVHV·

0\$SSFODVV
&UHDWHDPDQLIHVWW[WÀOHWKDWVWDWHV
ZKLFKFODVVKDVWKHPDLQPHWKRG
0DNHDWH[WÀOHQDPHGPDQLIHVWW[WWKDWKDVD 0DLQ&ODVV0\L$SS 0\3URMHFW
RQHOLQH
0DLQ&ODVV0\$SS
GRQ·WSXWWKHFODVV
RQWKHHQG

3UHVVWKHUHWXUQNH\DIWHUW\SLQJWKH0DLQ FODVVHV
&ODVVOLQHRU\RXUPDQLIHVWPD\QRWZRUN
FRUUHFWO\3XWWKHPDQLIHVWÀOHLQWRWKH´FODVVHVµ PDQLIHVWW[W 0DLQ&ODVV0LQL$SS
GLUHFWRU\
PDQLIHVWW[W
5XQWKHMDUWRROWRFUHDWHD-$5ÀOH
WKDWFRQWDLQVHYHU\WKLQJLQWKHFODVVHV FODVVHV
GLUHFWRU\SOXVWKHPDQLIHVW

FG0LQL3URMHFWFODVVHV
MDUFYPIPDQLIHVWW[WDSSMDU FODVV QRVRXUFH

25
0DLQ&ODVV0LQL$SS
FRGHMDYD
MDUFYPIPDQLIHVWW[WDSSMDU0\$SSFODVV LQWKH-$5
DSSMDU
\RXDUHKHUH
H[HFXWDEOH-$5
)LOH(GLW9LHZ
)LOH(GLW9LHZ
)LOH(GLW9LHZ
)LOH(GLW9LHZ
+773 +773
50, 0RVWORFDO-DYD
([HFXWDEOH
6HUYOHWV
*8,FOLHQW
-DU :HE6WDUW 50,DSS DSSVDUHGHSOR\HGDV
/RFDO &RPELQDWLRQ5HPRWH H[HFXWDEOH-$5ILOHV
:]VVQVOM`MK]\QVO\PM2):
*AVATHE*6- ISCAPABLEOFLOADINGACLASSFROMA*!2ANDCALLING
THEMAIN METHODOFTHATCLASS)NFACTTHEENTIREAPPLICATIONCAN
STAYINTHE*!2/NCETHEBALLISROLLINGIETHEMAIN METHOD
STARTSRUNNING THE*6-DOESNTCAREWHEREYOURCLASSESCOME
FROMASLONGASITCANlNDTHEM!NDONEOFTHEPLACESTHE*6-
LOOKSISWITHINANY*!2lLESINTHECLASSPATH)FITCANS EEA*!2THE
*6-WILLLOOKINTHAT*!2WHENITNEEDSTOlNDANDLOADACLASS 7KH-90KDVWR¶VHH·WK H-$5VR
LWPXVWEHLQ \R XU FOD VVSDWK 7KH
H-
HDVLHVWZD\WRPDNHWKJGLUHFWR $5 YLVLEOH
XU ZRU NLQ U\
LVWRPDNH\R $5 LV
WKHSODFHZKHUHWKH-
FODVVHV
FG0\3URMHFWFODVVHV

MDYDMDUDSSMDU
-$5IDRLQU

LQ VLG H W K LV
ORRNV IRU0
0DLQ&ODVV0LQL$SS
7KHMDU 7KH-90HVWZLWKDQHQWU\R QH\RXJHW

DSSMDU -90\RX·UIHODJLJWHOOVWKH LI
DPDQ LWGRHVQ·WILQ G
-$5LQVWHDGR YLQJLWD &ODVV,I HH[FHSWLRQ
IDFODVV DUXQWLP
$EPENDINGONHOWYOUROPERATINGSYSTEMISCONlGUREDYOU
MIGHTEVENBEABLETOSIMPLYDOUBLE CLICKTHE*!2lLETOLAUNCH
IT4HISWORKSONMOSTmAVORSOF7INDOWSAND-AC/389OU
CANUSUALLYMAKETHISHAPPENBYSELECTINGTHE*!2ANDTELLING
THE/3TOh/PENWITHvORWHATEVERTHEEQUIVALENTISONYOUR
OPERATINGSYSTEM
WKHUH DUH QR
'XPE 4XHVWLRQV
Q: 7HYCANT)JUST*!2UPANENTIREDIRECTORY Q: 7HATDIDYOUJUSTSAY
A: 4HE*6-LOOKSINSIDETHE*!2ANDEXPECTSTOFIND A: 9OUCANTPUTYOURCLASSFILESINTOSOMEARBITRARY
WHATITNEEDSRIGHTTHERE)TWONTGODIGGINGINTOOTHER DIRECTORYAND*!2THEMUPTHATWAY"UTIFYOURCLASSES
DIRECTORIESUNLESSTHECLASSISPARTOFAPACKAGEANDEVEN BELONGTOPACKAGESYOUCAN*!2UPTHEENTIREPACKAGE
THENTHE*6-LOOKSONLYINTHEDIRECTORIESTHATMATCHTHE DIRECTORYSTRUCTURE)NFACTYOUMUST7ELLEXPLAINALLTHISON
PACKAGESTATEMENT THENEXTPAGESOYOUCANRELAX
FKDSWHU
8]\aW]ZKTI[[M[QVXIKSIOM[
3OYOUVEWRITTENSOMENICELYREUSABLECLASSlLESANDYOUVE
POSTEDTHEMINYOURINTERNALDEVELOPMENTLIBRARYFOROTHER
PROGRAMMERSTOUSE7HILEBASKINGINTHEGLOWOFHAVING
JUSTDELIVEREDSOMEOFTHEINYOURHUMBLEOPINION BEST
EXAMPLESOF//EVERCONCEIVEDYOUGETAPHONECALL!
FRANTICONE4WOOFYOURCLASSESHAVETHESAMENAMEAS
THECLASSES&REDJUSTDELIVEREDTOTHELIBRARY!NDALLHELLIS
BREAKINGLOOSEOUTTHEREASNAMINGCOLLISIONSANDAMBIGUITIES
BRINGDEVELOPMENTTOITSKNEES
!NDALLBECAUSEYOUDIDNTUSEPACKAGES7ELLYOUDIDUSE
PACKAGESINTHESENSEOFUSINGCLASSESINTHE*AVA!0)THATARE
OFCOURSEINPACKAGES"UTYOUDIDNTPUTYOUROWNCLASSES
INTOPACKAGESANDINTHE2EAL7ORLDTHATS2EALLY"AD 3DFNDJHVWUXFWXUHRIWKH-DYD$3,IRU
7EREGOINGTOMODIFYTHEORGANIZATIONALSTRUCTUREFROMTHE MDYDWH[W1XPEHU)RUPDW
PREVIOUSPAGESJUSTALITTLETOPUTCLASSESINTOAPACKAGEAND
TO*!2THEENTIREPACKAGE0AYVERYCLOSEATTENTIONTOTHE MDYDXWLO$UUD\/LVW
SUBTLEANDPICKYDETAILS%VENTHETINIESTDEVIATIONCANS TOP
MDYDDZW)ORZ/D\RXW
YOURCODEFROMCOMPILINGANDORRUNNING
MDYDDZWHYHQW$FWLRQ(YHQW
8IKSIOM[XZM^MV\KTI[[VIUMKWVNTQK\[ MDYDQHW6RFNHW
!LTHOUGHPACKAGESARENTJUSTFORPREVENTINGNAMECOLLISIONS
MDYD
THATSAKEYFEATURE9OUMIGHTWRITEACLASSNAMED#USTOMER
ANDACLASSNAMED!CCOUNTANDACLASSNAMED3HOPPING#ART
!NDWHATDOYOUKNOWHALFOFALLDEVELOPERSWORKINGIN

WH[W QHW

ENTERPRISEE COMMERCEHAVEPROBABLYWRITTENCLASSESWITH
DZW

THOSENAMES)NAN//WORLDTHATSJUSTDANGEROUS)FPARTOF 1XPEHU)RUPDW
XWLO
THEPOINTOF//ISTOWRITEREUSABLECOMPONENTSDEVELOPERS 6RFNHW
NEEDTOBEABLETOPIECETOGETHERCOMPONENTSFROMA
HYHQW

VARIETYOFSOURCESANDBUILDSOMETHINGNEWOUTOFTHEM

9OURCOMPONENTSHAVETOBEABLETO@PLAYWELLWITHOTHERS )ORZ/D\RXW
$UUD\/LVW
INCLUDINGTHOSEYOUDIDNTWRITEOREVENKNOWABOUT

2EMEMBERWAYBACKINCHAPTERWHENWEDISCUSSEDHOW
APACKAGENAMEISLIKETHEFULLNAMEOFACLASSTECHNICALLY $FWLRQ(YHQW
KNOWNASTHEFULLY QUALIlEDNAME#LASS!RRAY,ISTISREALLY
JAVAUTIL!RRAY,IST*"UTTONISREALLYJAVAXSWING*"UTTONAND :KDWGRHVWKLVSLFWXUHORRNOLNHWR
3OCKETISREALLYJAVANET3OCKET.OTICETHATTWOOFTHOSECLASSES \RX"'RHVQ·WLWORRNDZKROHORWOLNH
!RRAY,ISTAND3OCKETBOTHHAVEJAVAASTHEIRhlRSTNAMEv DGLUHFWRU\KLHUDUFK\"
)NOTHERWORDSTHElRSTPARTOFTHEIRFULLY QUALIlEDNAMES
IShJAVAv4HINKOFAHIERARCHYWHENYOUTHINKOFPACKAGE
STRUCTURESANDORGANIZEYOURCLASSESACCORDINGLY
\RXDUHKHUH
SDFNDJHQDPLQJ
VR,ÀQDOO\VHWWOHGRQ
IRREDU+HLVHQEHUJIRUP\ :K\WKDW·VWKHVDPHQDPH
TXDQWXPEDNLQJFODVV ,ZDVWKLQNLQJRIIRUP\
VXEDWRPLFLURQLQJFODVV
*XHVV,·OOMXVWKDYHWRFRPH
XSZLWKVRPHWKLQJHOVH
3DFNDJHVFDQSUHYHQWQDPH
FRQIOLFWVEXWRQO\LI\RX
FKRRVHDSDFNDJHQDPH
WKDW·VJXDUDQWHHGWREH
XQLTXH7KHEHVWZD\WR
8ZM^MV\QVOXIKSIOMVIUMKWVNTQK\[ GRWKDWLVWRSUHIDFH\RXU
0UTTINGYOURCLASSINAPACKAGEREDUCESTHECHANCESOFNAMING SDFNDJHVZLWK\RXUUHYHUVH
CONmICTSWITHOTHERCLASSESBUTWHATSTOSTOPTWOPROGRAMMERS
FROMCOMINGUPWITHIDENTICALPACKAGENAMES)NOTHERWORDS GRPDLQQDPH
WHATSTOSTOPTWOPROGRAMMERSEACHWITHACLASSNAMED!CCOUNT
FROMPUTTINGTHECLASSINAPACKAGENAMEDSHOPPINGCUSTOMERS FRPKHDGÀUVWERRNV%RRN
"OTHCLASSESINTHATCASEWOULDSTILLHAVETHESAMENAME SDFNDJHQDPH DPH
SHOPPINGCUSTOMERS!CCOUNT
FODVVQ
3UNSTRONGLYSUGGESTSAPACKAGENAMINGCONVENTIONTHATGREATLY
REDUCESTHATRISKPREPENDEVERYCLASSWITHYOURREVERSEDOMAIN
NAME2EMEMBERDOMAINNAMESAREGUARANTEEDTOBEUNIQUE
4WODIFFERENTGUYSCANBENAMED"ARTHOLOMEW3IMPSONBUTTWO
DIFFERENTDOMAINSCANNOTBENAMEDDOHCOM

5HYHUVHGRPDLQSDFNDJHQDPHV
F O D V V QDPHL]LVHG
WKH \VFDSLWDO
FRPKHDGÀUVWMDYDSURMHFWV&KDUW DOZD
RXUUHYHUVH SURMHFWV&KDUWPLJKWEHDFRPPRQ
VWDUWWKHSDFNDJHZLWK\ GR W QDPHEXWDGGLQJFRPKHD
GRPDLQVHSDU DWH GE \D PHDQVZHKDYHWRZRUU\DGIL UVWMDYD
RU JDQ L]D WLRQDO ERX
WKH QD GG \R XU
WHU
RZQ
WK DW RXURZQLQKRXVHGHYHORSHUV WRQO\
VWUXFWXUHDI
FKDSWHU
7RSXW\RXUFODVVLQDSDFNDJH
<RXPXVWSXWDFODVV
&KRRVHDSDFNDJHQDPH LQWRDGLUHFWRU\
:H·UHXVLQJFRPKHDGÀUVWMDYDDVRXU
H[DPSOH7KHFODVVQDPHLV3DFNDJH([HUFLVH VWUXFWXUHWKDWPDWFKHV
VRWKHIXOO\TXDOLÀHGQDPHRIWKHFODVVLVQRZ
FRPKHDGÀUVWMDYD3DFNDJH([HUFLVH WKHSDFNDJHKLHUDUFK\
3XWDSDFNDJHVWDWHPHQWLQ\RXUFODVV
,WPXVWEHWKHÀUVWVWDWHPHQWLQWKHVRXUFH
FRGHÀOHDERYHDQ\LPSRUWVWDWHPHQWV7KHUH
FDQEHRQO\RQHSDFNDJHVWDWHPHQWSHUVRXUFH
FRGHÀOHVRDOOFODVVHVLQDVRXUFHÀOHPXVW 0\3URMHFW
EHLQWKHVDPHSDFNDJH7KDWLQFOXGHVLQQHU
FODVVHVRIFRXUVH
SDFNDJHFRPKHDG¿UVWMDYD
LPSRUWMDYD[VZLQJ
FODVVHV VRXUFH
SXEOLFFODVV3DFNDJH([HUFLVH^
OLIHDOWHULQJFRGHKHUH
`
FRP
SDFNDJHVWUXFWXUH
FRP
6HWXSDPDWFKLQJGLUHFWRU\VWUXFWXUH
,W·VQRWHQRXJKWRVD\\RXUFODVVLVLQDSDFNDJH
E\PHUHO\SXWWLQJDSDFNDJHVWDWHPHQWLQ
WKHFRGH<RXUFODVVLVQ·WWUXO\LQDSDFNDJH
XQWLO\RXSXWWKHFODVVLQDPDWFKLQJGLUHFWRU\
VWUXFWXUH6RLIWKHIXOO\TXDOLÀHGFODVVQDPH KHDGILUVWMDYD KHDGILUVWMDYD
LVFRPKHDGÀUVWMDYD3DFNDJH([HUFLVH\RX
PXVWSXWWKH3DFNDJH([HUFLVHVRXUFHFRGHLQD
GLUHFWRU\QDPHGKHDGÀUVWMDYDZKLFKPXVWEHLQ
DGLUHFWRU\QDPHGFRP
/RUSHU
,WLVSRVVLEOHWRFRPSLOHZLWKRXWGRLQJWKDWEXW

LXUHHXJXH
WDWYHUR
WUXVWXV³LW·VQRWZRUWKWKHRWKHUSUREOHPV

FRQVH
HXJXHUR/RUH

\RX·OOKDYH.HHS\RXUVRXUFHFRGHLQDGLUHFWRU\
GRHOLTXLV
GRGHOGLS

VWUXFWXUHWKDWPDWFKHVWKHSDFNDJHVWUXFWXUH
DQG\RX·OODYRLGDWRQRISDLQIXOKHDGDFKHVGRZQ 3DFNDJH([HUFLVHFODVV 3DFNDJH([HUFLVHMDYD

WKHURDG
6HWXSDPDWFKLQJGLUHFWRU\VWUXFWXUHIRU
ERWKWKHVRXUFHDQGFODVVHVWUHHV
\RXDUHKHUH
FRPSLOHDQGUXQZLWKSDFNDJHV
+WUXQTQVOIVLZ]VVQVO_Q\PXIKSIOM[
7HENYOURCLASSISINAPACKAGEITSALITTLETRICKIERTOCOMPILEAND
RUN4HEMAINISSUEISTHATBOTHTHECOMPILERAND*6-HAVETOBE
CAPABLEOFlNDINGYOURCLASSANDALLOFTHEOTHERCLASSESITUSES
&ORTHECLASSESINTHECORE!0)THATSNEVERAPROBLEM*AVAALWAYS
KNOWSWHEREITSOWNSTUFFIS"UTFORYOURCLASSESTHESOLUTION
OFCOMPILINGFROMTHESAMEDIRECTORYWHERETHESOURCElLESARE
SIMPLYWONTWORKORATLEASTNOTRELIABLY 7EGUARANTEETHOUGH
THATIFYOUFOLLOWTHESTRUCTUREWEDESCRIBEONTHISPAGEYOULLBE
SUCCESSFUL4HEREAREOTHERWAYSTODOITBUTTHISISTHEONEWEVE
FOUNDTHEMOSTRELIABLEANDTHEEASIESTTOSTICKTO
&RPSLOLQJZLWKWKHGGLUHFWRU\ÁDJ
VWD\LQWKHVRXUFHGLUHFW RU\ 'R127FGGRZQ

DYDILOHLV
FG0\3URMHFWVRXUFH LQWRWKHGLUHFWRU\ZKHUHWKHM
MDYDFGFODVVHVFRPKHDG¿UVWMDYD3DFNDJH([HUFLVHMDYD
WHOOVWKHFRPSLO RSX VSHFLI\

FRPSLOHGFRGHFHUODVWVI WWKH 1RZ\RXKDYHRWR WWRWKH
LQWRWKHFODVVHVGLUHFW VLOH WKH3$7+WHILJHOH
ZLWKLQWKHULJKWSDF RU\ DFWXDOVRXUF
VWUXFWXUH<HVLWNQND JH

0\3URMHFW
\RX·OOVWLOOFRPSLOH
RZV WLOOUXQ IURPKHUH
\RX·OOVKHUH
4OCOMPILEALLTHEJAVAlLESINTHECOMHEADlRSTJAVA IURP
PACKAGEUSE
MDYDFGFODVVHVFRPKHDG¿UVWMDYD MDYD
FODVVHV VRXUFH
FRPSLOHVHYHU VRXU
ILOHLQWKLVGL\ FHMDYD
UHFWRU\
5XQQLQJ\RXUFRGH FRP FRP
UXQ\RXUSUR I
FG0\3URMHFWFODVVHV WKH¶FODVVHV·GJULUDP URP
HFWRU\
MDYDFRPKHDG¿UVWMDYD3DFNDJH([HUFLVH
KHDGILUVWMDYD KHDGILUVWMDYD
<RX0867J
VHHWKDWDQGLYLPHPWKHIXOO\TXDOLILHGFODVVQDPH7
HGLDWHO\ORRNLQVLG
FODVVHVDQG HLWVFX HQWGLKHUH-90ZLOO /RUSHU
LWH[SHFWVWRH[ILSHQGFWWRILQGDGLUHFWRU\QDPUUHG

FWRU\

LXUH
HXJXH
WKHUHLWH[SHFWVW DGLUHFWRU\QDPHGKHDGILUVWFRPZKHUH
WDWYHUR
FRQVH
GLUHFWRU\RUHYHQ RILQGWKHFODVV,IWKHFODVV MDYDDQGLQ

HXJXHUR
LQ´FODVVHVµLWZR LVLQWKH´FRPµ 3DFNDJH([HUFLVHFODVV 3DFNDJH([HUFLVHMDYD

Q·WZRUN
FKDSWHU
<PMLNTIOQ[M^MVKWWTMZ\PIV_M[IQL WKHUH DUH QR

'XPE 4XHVWLRQV
#OMPILINGWITHTHEGmAGISWONDERFULBECAUSENOTONLYDOESIT
LETYOUSENDYOURCOMPILEDCLASSlLESINTOADIRECTORYOTHERTHAN Q: )TRIEDTOCDINTOTHE
THEONEWHERETHESOURCElLEISBUTITALSOKNOWSTOPUTTHECLASS DIRECTORYWHEREMYMAINCLASS
INTOTHECORRECTDIRECTORYSTRUCTUREFORTHEPACKAGETHECLASSISIN WASBUTNOWTHE*6-SAYSITCANT
lNDMYCLASS"UTITSRIGHT4(%2%
"UTITGETSEVENBETTER INTHECURRENTDIRECTORY
,ETSSAYTHATYOUHAVEANICE
DIRECTORYSTRUCTUREALLSETUPFORYOUR
SOURCECODE"UTYOUHAVENTSET 0\3URMHFW A: /NCEYOURCLASSISINA
PACKAGEYOUCANTCALLITBYITS
UPAMATCHINGDIRECTORYSTRUCTURE
@SHORTNAME9OU-534SPECIFY
FORYOURCLASSESDIRECTORY.OTA ATTHECOMMAND LINETHEFULLY
PROBLEM#OMPILINGWITH QUALIFIEDNAMEOFTHECLASSWHOSE
DTELLSTHECOMPILERTONOT MAIN METHODYOUWANTTORUN
JUST PUT YOUR CLASSES INTO FODVVHV VRXUFH THE "UTSINCETHEFULLY QUALIFIEDNAME
CORRECT DIRECTORY TREE BUT TO BUILD INCLUDESTHEPACKAGESTRUCTURE
THE DIRECTORIES IF THEY DONT EXIST *AVAINSISTSTHATTHECLASSBEINA
MATCHINGDIRECTORYSTRUCTURE3OIF
ATTHECOMMAND LINEYOUSAY
FRP MDYDFRPIRR%RRN
,IWKHSDFNDJHGLUHFWRU\ VWUXFWXUH
GRHVQ·W H[ LVW XQ GHU WK H¶F ODVVHV· THE*6-WILLLOOKINITSCURRENT
GLUHFWRU\WKH FRP SLOH UZ LOO EXLOGWKH DIRECTORYANDTHERESTOFITS

DJ
GLUHFWRULHVLI\RXXVHWKH IO G CLASSPATH FORADIRECTORYNAMED
hCOMv)TWILLNOTLOOKFORACLASS
6R\RXGRQ·WDFWXDOO\KDY HWR KHDGILUVWMDYD NAMED"OOKUNTILITHASFOUND
SK\VLFDOO\FUHDWH WK HG LUH FWRULHVXQGHU ADIRECTORYNAMEDhCOMvWITHA
WKH¶FODVVHV·URRWGLUHFWR U\$QGLQ DIRECTORYINSIDENAMEDhFOOv/NLY
IDFWLI\RXOHW WK HF RP SLOH UGRLW /RUSHU THENWILLTHE*6-ACCEPTTHATITS
WKHUH· VQ RF KDQ FH RI DW \SR LXUH
HXJXH
WDWYHUR
FOUNDTHECORRECT"OOKCLASS)FIT
FRQVH
HXJXHUR
FINDSA"OOKCLASSANYWHEREELSE
ITASSUMESTHECLASSISNTINTHE
3DFNDJH([HUFLVHMDYD
RIGHTSTRUCTUREEVENIFITIS4HE
*6-WONTFOREXAMPLELOOKBACK
UPTHEDIRECTORYTREETOSAYh/H)
CANSEETHATABOVEUSISADIRECTORY
7KHGÁDJWHOOVWKHFRPSLOHU NAMEDCOMSOTHISMUSTBETHE
RIGHTPACKAGEv
´3XWWKHFODVVLQWRLWVSDFNDJH
GLUHFWRU\VWUXFWXUHXVLQJWKH
FODVVVSHFLÀHGDIWHUWKHGDV
WKHURRWGLUHFWRU\%XWLIWKH
GLUHFWRULHVDUHQ·WWKHUHFUHDWH
WKHPÀUVWDQGWKHQSXWWKHFODVV
LQWKHULJKWSODFHµ
\RXDUHKHUH
-$5VDQGSDFNDJHV
5ISQVOIVM`MK]\IJTM2):_Q\PXIKSIOM[
7HENYOURCLASSISINAPACKAGETHEPACKAGEDIRECTORYSTRUCTURE
MUSTBEINSIDETHE*!29OUCANTJUSTPOPYOURCLASSESINTHE
*!2THEWAYWEDIDPRE PACKAGES!NDYOUMUSTBESURETHATYOU
-$5 DONTINCLUDEANYOTHERDIRECTORIESABOVEYOURPACKAGE4HE
lRSTDIRECTORYOFYOURPACKAGEUSUALLYCOM MUSTBETHElRST
DIRECTORYWITHINTHE*!2)FYOUWERETOACCIDENTALLYINCLUDETHE
DIRECTORYABOVETHEPACKAGEEGTHEhCLASSESvD
IRECTORY THE*!2
WOULDNTWORKCORRECTLY
0DNLQJDQH[HFXWDEOH-$5 FODVVHV
0DNHVXUHDOORI\RXUFODVVÀOHVDUH
ZLWKLQWKHFRUUHFWSDFNDJHVWUXFWXUH FRP
XQGHUWKHFODVVHVGLUHFWRU\

KHDGILUVWMDYD

3DFNDJH([HUFLVHFODVV
&UHDWHDPDQLIHVWW[WÀOHWKDWVWDWHV
ZKLFKFODVVKDVWKHPDLQPHWKRG 0DLQ&ODVV0LQL$SS
FODVVHV
DQGEHVXUHWRXVHWKHIXOO\TXDOLÀHG
FODVVQDPH
PDQLIHVWW[W
0DNHDWH[WÀOHQDPHGPDQLIHVWW[WWKDWKDVD
VLQJOHOLQH FRP
0DLQ&ODVVFRPKHDG¿UVWMDYD3DFNDJH([HUFLVH

3XWWKHPDQLIHVWÀOHLQWRWKHFODVVHVGLUHFWRU\ KHDGILUVWMDYD

5XQWKHMDUWRROWRFUHDWHD-$5ÀOH
FODVVHV
WKDWFRQWDLQVWKHSDFNDJHGLUHFWRULHV
SOXVWKHPDQLIHVW
FRP
7KHRQO\WKLQJ\RXQHHGWRLQFOXGHLVWKH¶FRP·
GLUHFWRU\DQGWKHHQWLUHSDFNDJHDQGDOOFODVVHV \LVWKH
ZLOOJRLQWRWKH-$5 $OO\RXVSFHWFRLIU\$QG\RX·OO
FRPGLUH \WKLQJLQLW

JHWHYHU

FG0\3URMHFWFODVVHV KHDGILUVWMDYD
SDFN([MDU

MDUFYPIPDQLIHVWW[WSDFN([MDUFRP 3DFNDJH([HUFLVHFODVV
FKDSWHU
;W_PMZMLQL\PMUIVQNM[\NQTMOW'
7HYDONTWELOOKINSIDETHE*!2ANDlNDOUT&ROMTHE
LQWRD
H-$5I6LONH\OHU
COMMAND LINETHEJARTOOLCANDOMORETHANJUSTCREATEANDRUNA
*!29OUCANEXTRACTTHECONTENTSOFA*!2JUSTLIKE@UNZIPPINGOR Z H S X W W K
QDPHG
@UNTARRING GLUHFWRU\
)MAGINEYOUVEPUTTHEPACK%XJARINTOADIRECTORYNAMED3KYLER
6N\OHU
MDUFRPPDQGVIRUOLVWLQJDQGH[WUDFWLQJ
/LVWWKHFRQWHQWVRID-$5
Licensed by
MDUWISDFN([MDU
SDFN([MDU
WIVWDQG
´VKRZPHDVWIDRU¶7DEOH)LOH·DVLQ
EOHRIWKH-$ \
5ILOHµ U W R R O DX WRPDWLFDOO
WKHMD 0(7$,1)
Eduard Simons EXLOGVD U\DQGSXWVWKH

)LOH(GLW:LQGRZ+HOS3LFNOH
FG6N\OHU GLUHFWRVWLQVLGH
MDUWISDFN([MDU PDQLIH
0(7$,1) 0(7$,1) FRP
104038
0(7$,1)0$1,)(670)
FRP
FRPKHDGILUVWMDYD 0DLQ&ODVV0LQL$SS
FRPKHDGILUVWMDYD
3DFNDJH([HUFLVHFODVV KHDGILUVWMDYD
0$1,)(670)

([WUDFWWKHFRQWHQWVRID-$5LHXQMDU
FG6N\OHU 3DFNDJH([HUFLVHFODVV
MDU[ISDFN([MDU
6N\OHU 0(7$,1)VWDQGVIRU¶PHWD
LQIRUPDWLRQ·7KHMDUWRROFUHDWHV
[IVWDQGVIRU¶([WUDQJ FW)LOH·DQGLW WKH0(7$,1)GLUHFWRU\DV
ZRUNVMXVWOLNHX Q]L SSL RUXQWDUULQJ 0(7$,1) ZHOODVWKH0$1,)(670)ÀOH
[MDU\RX·OO
FRP
,I\RXH[WUDFWWKHSDFN(HFW RU\DQGWKH
,WDOVRWDNHVWKHFRQWHQWVRI
VHHWKH0(7$ ,1) GLU \RXUPDQLIHVWÀOHDQGSXWVLW
XUUHQW
FRPGLUHFWRU\GLUHFWRU\LQ\RXUF 0DLQ&ODVV0LQL$SS
LQWRWKH0$1,)(670)ÀOH6R
GLUHFWRU\ KHDGILUVWMDYD
\RXUPDQLIHVWÀOHGRHVQ·WJRLQWR
0$1,)(670) WKH-$5EXWWKHFRQWHQWVRILW

DUHSXWLQWRWKH¶UHDO·PDQLIHVW

0$1,)(670)
\RXDUHKHUH
RUJDQL]LQJ\RXUFODVVHV
6KDUSHQ \RXU SHQFLO
'IVENTHEPACKAGEDIRECTORYSTRUCTUREINTHIS
PICTURElGUREOUTWHATYOUSHOULDTYPEATTHE
0\3URMHFW COMMAND LINETOCOMPILERUNCREATEA*!2AND
EXECUTEA*!2!SSUMEWEREUSINGTHESTANDARD
WHERETHEPACKAGEDIRECTORYSTRUCTURESTARTSJUST
0DLQ&ODVV0LQL$SS
BELOWSOURCEANDCLASSES)NOTHERWORDSTHESOURCE
FODVVHV VRXUFH ANDCLASSESDIRECTORIESARENOTPARTOFTHEPACKAGE
PDQLIHVWW[W
MDYDUDQFK MDYDUDQFK &RPSLOH
FGVRXUFH
MDYDFBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
FRZV FRZV
5XQ
/RUSHU

LXUH
HXJXH FGBBBBBBBBBBB
WDWYHUR
FRQVH
HXJXHUR
MDYDBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
)RRIFODVV )RRIMDYD
&UHDWHD-$5
FGBBBBBBBBBBB
BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
([HFXWHD-$5
FGBBBBBBBBBBB
BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
"ONUSQUESTION7HATSWRONGWITHTHEPACKAGENAME
FKDSWHU
WKHUH DUH QR
'XPE 4XHVWLRQV
:MDD=LHGAFLK
Q: 7HATHAPPENSIFYOUTRY 2UJDQL]H\RXUSURMHFWVRWKDW\RXUVRXUFHFRGHDQGFODVVILOHVDUHQRWLQ
TORUNANEXECUTABLE*!2AND WKHVDPHGLUHFWRU\
THEEND USERDOESNTHAVEJAVA
INSTALLED $VWDQGDUGRUJDQL]DWLRQVWUXFWXUHLVWRFUHDWHDSURMHFWGLUHFWRU\DQGWKHQ
SXWDVRXUFHGLUHFWRU\DQGDFODVVHVGLUHFWRU\LQVLGHWKHSURMHFWGLUHFWRU\
A: .OTHINGWILLRUNSINCE
WITHOUTA*6-*AVACODECANT
2UJDQL]LQJ\RXUFODVVHVLQWRSDFNDJHVSUHYHQWVQDPLQJFROOLVLRQVZLWK
RWKHUFODVVHVLI\RXSUHSHQG\RXUUHYHUVHGRPDLQQDPHRQWRWKHIURQWRI
RUN4HEEND USERMUSTHAVE*AVA
DFODVVQDPH
INSTALLED 7RSXWDFODVVLQDSDFNDJHSXWDSDFNDJHVWDWHPHQWDWWKHWRSRIWKH
VRXUFHFRGHILOHEHIRUHDQ\LPSRUWVWDWHPHQWV
Q: (OWCAN)GET*AVA SDFNDJHFRPZLFNHGO\VPDUW
INSTALLEDONTHEEND USERS 7REHLQDSDFNDJHDFODVVPXVWEHLQDGLUHFWRU\VWUXFWXUHWKDWH[DFWO\
MACHINE PDWFKHVWKHSDFNDJHVWUXFWXUH)RUDFODVVFRPZLFNHGO\VPDUW)RR
)DEALLYYOUCANCREATEACUSTOM WKH)RRFODVVPXVWEHLQDGLUHFWRU\QDPHGZLFNHGO\VPDUWZKLFKLVLQD
INSTALLERANDDISTRIBUTEITALONG GLUHFWRU\QDPHGFRP
WITHYOURAPPLICATION3EVERAL
COMPANIESOFFERINSTALLERPRO 7RPDNH\RXUFRPSLOHGFODVVODQGLQWKHFRUUHFWSDFNDJHGLUHFWRU\
GRAMSRANGINGFROMSIMPLETO VWUXFWXUHXQGHUWKHFODVVHVGLUHFWRU\XVHWKHGFRPSLOHUIODJ
EXTREMELYPOWERFUL!NINSTALLER FGVRXUFH
PROGRAMCOULDFOREXAMPLEDE MDYDFGFODVVHVFRPZLFNHGO\VPDUW)RRMDYD
TECTWHETHERORNOTTHEEND USER
HASANAPPROPROPRIATEVERSION 7RUXQ\RXUFRGHFGWRWKHFODVVHVGLUHFWRU\DQGJLYHWKHIXOO\TXDOLILHG
OF*AVAINSTALLEDANDIFNOT QDPHRI\RXUFODVV
INSTALLANDCONFIGURE*AVABEFORE FGFODVVHV
INSTALLINGYOURAPPLICATION MDYDFRPZLFNHGO\VPDUW)RR
)NSTALLSHIELD)NSTALL!NYWHERE
AND$EPLOY$IRECTORALLOFFER*AVA <RXFDQEXQGOH\RXUFODVVHVLQWR-$5-DYD$5FKLYHILOHV-$5LVEDVHG
INSTALLERSOLUTIONS RQWKHSN]LSIRUPDW
!NOTHERCOOLTHINGABOUTSOME <RXFDQPDNHDQH[HFXWDEOH-$5ILOHE\SXWWLQJDPDQLIHVWLQWRWKH-$5
OFTHEINSTALLERPROGRAMSISTHAT WKDWVWDWHVZKLFKFODVVKDVWKHPDLQPHWKRG7RFUHDWHDPDQLIHVWILOH
YOUCANEVENMAKEADEPLOY PDNHDWH[WILOHZLWKDQHQWU\OLNHWKHIROORZLQJIRUH[DPSOH
MENT#$ 2/-THATINCLUDES 0DLQ&ODVVFRPZLFNHGO\VPDUW)RR
INSTALLERSFORALLMAJOR*AVA
PLATFORMSSOONE#$TORULE %HVXUH\RXKLWWKHUHWXUQNH\DIWHUW\SLQJWKH0DLQ&ODVVOLQHRU\RXU
THEMALL)FTHEUSERSRUNNINGON PDQLIHVWILOHPD\QRWZRUN
3OLARISFOREXAMPLETHE3OLARIS
VERSIONOF*AVAISINSTALLED/N 7RFUHDWHD-$5ILOHW\SH
7INDOWSTHE7INDOWSVER MDUFYIPPDQLIHVWW[W0\-DUMDUFRP
SIONETC)FYOUHAVETHEBUDGET
THISISBYFARTHEEASIESTWAYFOR 7KHHQWLUHSDFNDJHGLUHFWRU\VWUXFWXUHDQGRQO\WKHGLUHFWRULHVPDWFKLQJ
YOUREND USERSTOGETTHERIGHT WKHSDFNDJHPXVWEHLPPHGLDWHO\LQVLGHWKH-$5ILOH
VERSIONOF*AVAINSTALLEDAND
CONFIGURED
7RUXQDQH[HFXWDEOH-$5ILOHW\SH
MDYDMDU0\-DUMDU
\RXDUHKHUH
ZRXOGQ·WLWEHGUHDP\
([HFXWDEOH-$5ÀOHV
DUHQLFHEXWZRXOGQ·WLWEHGUHDP\
LIWKHUHZHUHDZD\WRPDNHDULFKVWDQG
DORQHFOLHQW*8,WKDWFRXOGEHGLVWULEXWHG
RYHUWKH:HE"6RWKDW\RXZRXOGQ·WKDYHWR
SUHVVDQGGLVWULEXWHDOOWKRVH&'520V$QG
ZRXOGQ·WLWEHMXVWZRQGHUIXOLIWKHSURJUDP
FRXOGDXWRPDWLFDOO\XSGDWHLWVHOIUHSODFLQJ
MXVWWKHSLHFHVWKDWFKDQJHG"7KHFOLHQWV
ZRXOGDOZD\VEHXSWRGDWHDQG\RX·GQHYHU
KDYHWRZRUU\DERXWGHOLYHULQJQHZ
FKDSWHU
)LOH(GLW9LHZ )LOH(GLW9LHZ
)LOH(GLW9LHZ
+773
+773
)LOH(GLW9LHZ
+773
50,
([HFXWDEOH :HE6WDUW
-DU :HE6WDUW 50,DSS 6HUYOHWV
(QGXVHUVODXQFKD-DYD
:HE6WDUWDSSE\FOLFNLQJ
2IÎ?MJ;\IZ\
RQDOLQNLQD:HE
7ITH*AVA7EB3TART*73 YOURAPPLICATIONISLAUNCHEDFORTHE
lRSTTIMEFROMA7EBBROWSERGETIT7EB3TART BUTITRUNSASA SDJH%XWRQFHWKHDSS
STAND ALONEAPPLICATIONWELLALMOST WITHOUTTHECONSTRAINTSOFTHE
BROWSER!NDONCEITSDOWNLOADEDTOTHEEND USERSMACHINEWHICH GRZQORDGVLWUXQVRXWVLGH
HAPPENSTHElRSTTIMETHEUSERACCESSESTHEBROWSERLINKTHATSTARTS
THEDOWNLOAD ITSTAYSTHERE
WKHEURZVHUMXVWOLNHDQ\
*AVA7EB3TARTISAMONGOTHERTHINGSASMALL*AVAPROGRAMTHATLIVES RWKHUVWDQGDORQH-DYD
ONTHECLIENTMACHINEANDWORKSMUCHLIKEABROWSERPLUG INTHE
WAYSAY!DOBE!CROBAT2EADEROPENSWHENYOURBROWSERGETSAPDF
DSSOLFDWLRQ,QIDFWD
lLE 4HIS*AVAPROGRAMISCALLEDTHE*AVA7EB3TART@HELPERAPP -DYD:HE6WDUWDSSLVMXVW
ANDITSKEYPURPOSEISTOMANAGETHEDOWNLOADINGUPDATINGAND
LAUNCHINGEXECUTING OFYOUR*73APPS DQH[HFXWDEOH-$5WKDW·V
7HEN*73DOWNLOADSYOURAPPLICATIONANEXECUTABLE*!2 IT GLVWULEXWHGRYHUWKH:HE
INVOKESTHEMAIN METHODFORYOURAPP!FTERTHATTHEEND USERCAN
LAUNCHYOURAPPLICATIONDIRECTORYFROMTHE*73HELPERAPPWITHOUT
HAVINGTOGOBACKTHROUGHTHE7EBPAGELINK
"UTTHATSNOTTHEBESTPART4HEAMAZINGTHINGABOUT*73ISITS
ABILITYTODETECTWHENEVENASMALLPARTOFAPPLICATIONSAYASINGLE
CLASSlLE HASCHANGEDONTHESERVERANDWITHOUTANYEND USER
INTERVENTIONDOWNLOADANDINTEGRATETHEUPDATEDCODE
4HERESSTILLANISSUEOFCOURSELIKEHOWDOESTHEEND USERGET*AVA
AND*AVA7EB3TART4HEYNEEDBOTH*AVATORUNTHEAPPAND*AVA
7EB3TARTASMALL*AVAAPPLICATIONITSELF TOHANDLERETRIEVINGAND
LAUNCHINGTHEAPP"UTEVENTHATHASBEENSOLVED9OUCANSETTHINGS
UPSOTHATIFYOUREND USERSDONTHAVE*73THEYCANDOWNLOAD
ITFROM3UN!NDIFTHEYDOHAVE*73BUTTHEIRVERSIONOF*AVAIS
OUT OF DATEBECAUSEYOUVESPECIlEDINYOUR*73APPTHATYOU
NEEDASPECIlCVERSIONOF*AVA THE*AVA3TANDARD%DITIONCANBE
DOWNLOADEDTOTHEEND USERMACHINE
"ESTOFALLITSSIMPLETOUSE9OUCANSERVEUPA*73APPMUCHLIKE
ANYOTHERTYPEOF7EBRESOURCESUCHASAPLAINOLD(4-,PAGEORA
*0%'IMAGE9OUSETUPA7EB(4-, PAGEWITHALINKTOYOUR*73
APPLICATIONANDYOUREINBUSINESS
)NTHEENDYOUR*73APPLICATIONISNTMUCHMORETHANAN
EXECUTABLE*!2THATEND USERSCANDOWNLOADFROMTHE7EB
\RXDUHKHUH
-DYD:HE6WDUW
+RZ-DYD:HE6WDUWZRUNV
:HEEURZVHU
:HE6HUYHU
7KHFOLHQWFOLFNVRQD:HESDJHOLQN
WR\RXU-:6DSSOLFDWLRQDMQOSÀOH ´JLYHPH0\$SSMQOSµ /RUSHU
FOLFN LXUH
HXJXH
WDWYHUR
7KH:HESDJHOLQN FRQVH
HXJXHUR
DKUHI ´0\$SSMQOS´!&OLFND! 0\$SSMQOS 0\$SSMDU

7KH:HEVHUYHU+773JHWVWKH

:HE6HUYHU
UHTXHVWDQGVHQGVEDFNDMQOSÀOH /RUSHU
/RUSHU
FOLFN LXUH
WKLVLV127WKH-$5 HXJXH
WDWYHUR
LXUH
HXJXH
FRQVH WDWYHUR
HXJXHUR FRQVH
7KHMQOSÀOHLVDQ;0/GRFXPHQWWKDW HXJXHUR
VWDWHVWKHQDPHRIWKHDSSOLFDWLRQ·V 0\$SSMQOS 0\$SSMQOS 0\$SSMDU

H[HFXWDEOH-$5ÀOH
-DYD:HE6WDUW
-DYD:HE6WDUWDVPDOO¶KHOSHUDSS·
:HE6HUYHU
RQWKHFOLHQWLVVWDUWHGXSE\WKH ´JLYHPH0\$SSMDUµ
EURZVHU7KH-:6KHOSHUDSSUHDGV -:6 /RUSHU
LXUH
HXJXH
WKHMQOSÀOHDQGDVNVWKHVHUYHUIRU WDWYHUR
FRQVH
WKH0\$SSMDUÀOH HXJXHUR
0\$SSMQOS 0\$SSMDU
7KH:HEVHUYHU¶VHUYHV·XSWKH
:HE6HUYHU
UHTXHVWHGMDUÀOH
-:6
/RUSHU
LXUH
HXJXH
WDWYHUR
FRQVH
HXJXHUR
0\$SSMDU
0\$SSMQOS 0\$SSMDU
+HOOR:HE6WDUWWKHDSSLQWKH-$5

-DYD:HE6WDUWJHWVWKH-$5DQG
VWDUWVWKHDSSOLFDWLRQE\FDOOLQJWKH :HE6HUYHU
VSHFLÀHGPDLQPHWKRGMXVWOLNHDQ +HOOR
/RUSHU
H[HFXWDEOH-$5 LXUH
HXJXH
WDWYHUR
FRQVH
1H[WWLPHWKHXVHUZDQWVWRUXQWKLVDSSKHFDQ HXJXHUR
RSHQWKH-DYD:HE6WDUWDSSOLFDWLRQDQGIURP 0\$SSMQOS 0\$SSMDU

WKHUHODXQFK\RXUDSSZLWKRXWHYHQEHLQJRQOLQH
FKDSWHU
<PMRVTXNQTM
4OMAKEA*AVA7EB3TARTAPPYOUNEEDTOJNLP*AVA.ETWORK
,AUNCH0ROTOCOL lLETHATDESCRIBESYOURAPPLICATION4HISISTHE
lLETHE*73APPREADSANDUSESTOlNDYOUR*!2ANDLAUNCHTHE
APPBYCALLINGTHE*!2SMAIN METHOD !JNLPlLEISASIMPLE
¶URRW·
LI\WKHVHUYHU
8-,DOCUMENTTHATHASSEVERALDIFFERENTTHINGSYOUCANPUTIN
BUTASAMINIMUMITSHOULDLOOKLIKETHIS R X V S H F
KHUH\ WKH
G H E D V H · WDJLVWZDUWVWXIILVWRQVRZH·UHXVLQHEJ
"[POYHUVLRQ ´´HQFRGLQJ ´XWI´"! 7KH¶FRHUH\RXUZHEVRQRXUORFDOKR V Z
µ)RU OG
RIZK WHVWLQJWKLV DGGUHVV´ VHUYHUWKLVZRX
:H·UH FDOORRSEDFN WHUQHWZHE FRPµ
WKHOR DSSVRQRXULQLFNHGO\VPDUW
MQOSVSHF ´´ VWDUW KWWSZZZZ
VD\´
FRGHEDVH ´KWWSaNDWK\´
WKHMQOSILOHUHODWLYHWR WKH
KUHI ´0\$SSMQOS´! 7KLVLVWKHORFDWLRQRIVK RZVWKDW 0\ $S SMQ OS LV
FRGHEDVH7KLVH[DPSOHLUHFWR U\RIWKHZHEVHUYHUQRW
DYDLODE OHL QW KH URRWG
QHVWHGLQVRPHRWKHUGLUHFWRU\
LQIRUPDWLRQ!
IWKHVHWDJVRU\RXUDUH DSSPLJKW
WLWOH!NDWK\$SSWLWOH! %HVXUHWRLQFOXGHDOORKH RUPDWL RQ· WD JV XVHGE\
YHQGRU!:LFNHGO\6PDUWYHQGRU! QRWZRUNFRUUHFWO\7RVW¶LQIO\I RUGLV SOD \LQ JZ KHQ WK HXVHU
WKH-:6KHOSHUDSSP YLRXVO\GRZQORDGHGDSSOLFDWLRQ
KRPHSDJHKUHI ´LQGH[KWPO´! ZDQWVWRUHODXQFKDSUH
GHVFULSWLRQ!+HDG)LUVW:HE6WDUWGHPRGHVFULSWLRQ!
LFRQKUHI ŃDWK\VJLI´!
UXQ\RXUSURJUDPZLWKRXW
RIÀLQHDOORZHG!
7KLVPHDQVWKHXVHUFDQ WHU QHW ,I WK HXVHU LV RII OLQH
LQIRUPDWLRQ! EHLQJFRQQHFWHGWRWKHLQ LQJIH DWX UH ZRQ ·W ZRU N
LWPHDQVWKHDXWRPDWLFXSGDW
UHVRXUFHV! YHUVLRQ
7KLVVD\VWKDW\RXUDSSQHHGV
MVHYHUVLRQ ´´! RI-DYDRUJUHDWHU
MDUKUHI ´0\$SSMDU´! 7KHQDPH \
RWKHU-$5RII
RXUH[HFXWDEOH-
$5
UHVRXUFHV!
HYHQVRXQGVDQGVDVZHOOWKDWKROGR<WKRXHUPLJKWKDYH
LOH
LPDJHVXVHGE\ F
\RXUDSS ODVVHVRU
DSSOLFDWLRQGHVFPDLQFODVV ´+HOOR:HE6WDUW´!
MQOS! 7KLVLVOLNHWKHPDLQIHVW0DLQ&ODVVHQWU\LWVD\V
ZKLFKFODVVLQWKH-$5KDVWKHPDLQPHWKRG
\RXDUHKHUH
GHSOR\LQJZLWK-:6
6WHSVIRUPDNLQJDQGGHSOR\LQJ
D-DYD:HE6WDUWDSS
0DNHDQH[HFXWDEOH-$5
IRU\RXUDSSOLFDWLRQ
0\$SSMDU
/RUSHU
:ULWHDMQOSÀOH LXUH
HXJXH
WDWYHUR
FRQVH
HXJXHUR
0\$SSMQOS
3ODFH\RXU-$5DQGMQOS :HE6HUYHU
ÀOHVRQ\RXU:HEVHUYHU /RUSHU
LXUH
HXJXH
/RUSHU WDWYHUR
LXUH FRQVH
HXJXH HXJXHUR
WDWYHUR
URRKWPO
FRQVH
0\$SSMQOS 0\$SSMDU
$GGDQHZPLPHW\SHWR\RXU:HEVHUYHU
:HE6HUYHU
DSSOLFDWLRQ[MDYDMQOS¿OH
FRQÀJXUH
7KLVFDXVHVWKHVHUYHUWRVHQGWKHMQOSÀOHZLWKWKH PLPHW\SH
FRUUHFWKHDGHUVRWKDWZKHQWKHEURZVHUUHFHLYHV
WKHMQOSÀOHLWNQRZVZKDWLWLVDQGNQRZVWRVWDUW
WKH-:6KHOSHUDSS
/RUSHU
LXUH
&UHDWHD:HESDJHZLWKDOLQN HXJXH
WDWYHUR
WR\RXUMQOSÀOH FRQVH
HXJXHUR
+70/! 0\-:6$SSKWPO
%2'<!
DKUHI ´0\$SSMQOS´!/DXQFK0\$SSOLFDWLRQD!
%2'<!
+70/!
FKDSWHU
7HAT´S
1dQÔU_Q
&IRST
,OOKATTHESEQUENCEOFEVENTSBELOWAND
PLACETHEMINTHEORDERINWHICHTHEY
OCCURINA*73APPLICATION

WKH:HEVHUYHUVHQGV
D-$5
VWDUWVXS ILOHWRWKH-:6KHOSH
UDSS
WKH:HEEURZVHU
KHOSHUD SS
WKH-:6 UDSSUHTXHVWV
WKH-:6KHOSH
WKH-$5 ILOH
WKH:HEVHUYHUVHQGVD WKH-:6KHOSHUDSSLQYRNHV
MQOS
ILOHWRWKHEURZVHU WKH-$5·VPDLQPHWKRG

XVHUFOLFNVD:HESDJHOLQN EURZVHUUHTXHVWVDMQOSILOH
IURPWKH:HEVHUYHU

WKHUH DUH QR
'XPE 4XHVWLRQV
:MDD=LHGAFLK
Q: (OWIS*AVA7EB3TARTDIFFERENTFROMANAPPLET -DYD:HE6WDUWWHFKQRORJ\OHWV\RXGHSOR\D
VWDQGDORQHFOLHQWDSSOLFDWLRQIURPWKH:HE
A: !PPLETSCANTLIVEOUTSIDEOFA7EBBROWSER!NAPPLETIS -DYD:HE6WDUWLQFOXGHVD¶KHOSHUDSS·WKDWPXVW
EHLQVWDOOHGRQWKHFOLHQWDORQJZLWK-DYD
DOWNLOADEDFROMTHE7EBASPARTOFA7EBPAGERATHERTHAN
SIMPLYFROMA7EBPAGE)NOTHERWORDSTOTHEBROWSERTHEAPPLET
ISJUSTLIKEA*0%'ORANYOTHERRESOURCE4HEBROWSERUSESEITHERA
$-DYD:HE6WDUW-:6DSSKDVWZRSLHFHV
*AVAPLUG INORTHEBROWSERSOWNBUILT IN*AVAFARLESSCOMMON DQH[HFXWDEOH-$5DQGDMQOSILOH
TODAY TORUNTHEAPPLET!PPLETSDONTHAVETHESAMELEVELOF
$MQOSILOHLVDVLPSOH;0/GRFXPHQWWKDW
FUNCTIONALITYFORTHINGSSUCHASAUTOMATICUPDATINGANDTHEYMUST
GHVFULEHV\RXU-:6DSSOLFDWLRQ,WLQFOXGHV
ALWAYSBELAUNCHEDFROMTHEBROWSER7ITH*73APPLICATIONSONCE
THEYREDOWNLOADEDFROMTHE7EBTHEUSERDOESNTEVENHAVETO WDJVIRUVSHFLI\LQJWKHQDPHDQGORFDWLRQRIWKH
BEUSINGABROWSERTORELAUNCHTHEAPPLICATIONLOCALLY)NSTEAD -$5DQGWKHQDPHRIWKHFODVVZLWKWKHPDLQ
THEUSERCANSTARTUPTHE*73HELPERAPPANDUSEITTOLAUNCHTHE PHWKRG
ALREADY DOWNLOADEDAPPLICATIONAGAIN
:KHQDEURZVHUJHWVDMQOSILOHIURPWKHVHUYHU
EHFDXVHWKHXVHUFOLFNHGRQDOLQNWRWKHMQOS
Q: 7HATARETHESECURITYRESTRICTIONSOF*73 ILOHWKHEURZVHUVWDUWVXSWKH-:6KHOSHUDSS
7KH-:6KHOSHUDSSUHDGVWKHMQOSILOHDQG
A: *73APPSHAVESEVERALLIMITATIONSINCLUDINGBEING UHTXHVWVWKHH[HFXWDEOH-$5IURPWKH:HE
VHUYHU
RESTRICTEDFROMREADINGANDWRITINGTOTHEUSERSHARDDRIVE"UT
*73HASITSOWN!0)WITHASPECIALOPENANDSAVEDIALOGBOXSO
THATWITHTHEUSERSPERMISSIONYOURAPPCANSAVEANDREADITS :KHQWKH-:6JHWVWKH-$5LWLQYRNHVWKH
OWNFILESINASPECIALRESTRICTEDAREAOFTHEUSERSDRIVE PDLQPHWKRGVSHFLILHGLQWKHMQOSILOH
\RXDUHKHUH
H[HUFLVH7UXHRU)DOVH
7EEXPLOREDPACKAGINGDEPLOYMENTAND*73

INTHISCHAPTER9OURJOBISTODECIDEWHETHER
EACHOFTHEFOLLOWINGSTATEMENTSISTRUEORFALSE
1dQÔU_Q
&=[^N X[ /JU\N'
4HE*AVACOMPILERHASAmAG DTHATLETSYOUDECIDEWHEREYOURCLASSlLESSHOULDGO
!*!2ISASTANDARDDIRECTORYWHEREYOURCLASSlLESSHOULDRESIDE
7HENCREATINGA*AVA!RCHIVEYOUMUSTCREATEAlLECALLEDJARMF
4HESUPPORTINGlLEINA*AVA!RCHIVEDECLARESWHICHCLASSHASTHEMAIN METHOD
*!2lLESMUSTBEUNZIPPEDBEFORETHE*6-CANUSETHECLASSESINSIDE
!TTHECOMMANDLINE*AVA!RCHIVESAREINVOKEDUSINGTHE ARCHmAG
0ACKAGESTRUCTURESAREMEANINGFULLYREPRESENTEDUSINGHIERARCHIES
5SINGYOURCOMPANYSDOMAINNAMEISNOTRECOMMENDEDWHENNAMINGPACKAGES
$IFFERENTCLASSESWITHINASOURCElLECANBELONGTODIFFERENTPACKAGES
7HENCOMPILINGCLASSESINAPACKAGETHE PmAGISHIGHLYRECOMMENDED
7HENCOMPILINGCLASSESINAPACKAGETHEFULLNAMEMUSTMIRRORTHEDIRECTORYTREE
*UDICIOUSUSEOFTHE DmAGCANHELPTOASSURETHATTHEREARENOTYPOSINYOURCLASSTREE
%XTRACTINGA*!2WITHPACKAGESWILLCREATEADIRECTORYCALLEDMETA INF
%XTRACTINGA*!2WITHPACKAGESWILLCREATEAlLECALLEDMANIFESTMF
4HE*73HELPERAPPALWAYSRUNSINCONJUNCTIONWITHABROWSER
*73APPLICATIONSREQUIREANLP.ETWORK,AUNCH0ROTOCOL lLETOWORKPROPERLY
!*73SMAINMETHODISSPECIlEDINITS*!2lLE
FKDSWHU
1dQÔU_Q
6XPPDU\&URVV

!NYTHINGINTHEBOOK
ISFAIRGAMEFORTHIS
Licensed by
ONE

Eduard Simons

104038

!CROSS $OWN
7ONTTRAVEL -INEISUNIQUE 0USHYWIDGETS 7HOSALLOWED )/CLEANUP
$ONTSPLITME '5)STARGET ????OFMYDESIRE %FlCIENCYEXPERT -ILLI NAP
2ELEASE ABLE *AVATEAM @!BANDONEDMONIKER %ARLYEXIT 4RIGMETHOD
'OTTHEKEY &ACTORY !CHUNK #OMMONWRAPPER %NCAPSMETHOD
)/GANG &ORAWHILE -ATHNOTTRIG 9ESORNO *.,0FORMAT
&LATTEN !TOMIC
"EBRAVE *AVAJACKETS 6"SlNAL
%NCAPSULATEDRETURNER 'OODASNEW !RRANGEWELL .OTBEHAVIOR *AVABRANCH
3HIPTHISONE 0AIRSEVENT 3WINGSLANG 3OCKETSSUITE
-AKEITSO 7HEREDO)START )/CANALS
)/SIEVE !LITTLElREWALL /RGANIZEDRELEASE
$ISKLEAF .OTFORANINSTANCE
\RXDUHKHUH
H[HUFLVHVROXWLRQV
XVHUFOLFNVD:HESDJHOLQN
EURZVHUUHTXHVWVDMQOSILOH
IURPWKH:HEVHUYHU
%XERCISE
WKH:HEVHUYHUVHQGVDMQOS
3OLUTIONS ILOHWRWKHEURZVHU
WKH:HEEURZVHUVWDUWVXS
WKH-:6KHOSHUDSS
UDSSUHTXHVWV
WKH-:6KHOSH
WKH-$5ILOH
WKH:HEVHUYHUVHQGV
D-$5
ILOHWRWKH-:6KHOSH
UDSS
WKH-:6KHOSHUDSSLQYRNHV
WKH-$5·VPDLQPHWKRG
7UXH 4HE*AVACOMPILERHASAmAG DTHATLETSYOUDECIDEWHEREYOURCLASSlLESSHOULDGO

)DOVH !*!2ISASTANDARDDIRECTORYWHEREYOURCLASSlLESSHOULDRESIDE
)DOVH 7HENCREATINGA*AVA!RCHIVEYOUMUSTCREATEAlLECALLEDJARMF
7UXH 4HESUPPORTINGlLEINA*AVA!RCHIVEDECLARESWHICHCLASSHASTHEMAIN METHOD
)DOVH *!2lLESMUSTBEUNZIPPEDBEFORETHE*6-CANUSETHECLASSESINSIDE
)DOVH !TTHECOMMANDLINE*AVA!RCHIVESAREINVOKEDUSINGTHE ARCHmAG
7UXH 0ACKAGESTRUCTURESAREMEANINGFULLYREPRESENTEDUSINGHIERARCHIES
)DOVH 5SINGYOURCOMPANYSDOMAINNAMEISNOTRECOMMENDEDWHENNAMINGPACKAGES
)DOVH $IFFERENTCLASSESWITHINASOURCElLECANBELONGTODIFFERENTPACKAGES
)DOVH 7HENCOMPILINGCLASSESINAPACKAGETHE PmAGISHIGHLYRECOMMENDED
7UXH 7HENCOMPILINGCLASSESINAPACKAGETHEFULLNAMEMUSTMIRRORTHEDIRECTORYTREE
7UXH *UDICIOUSUSEOFTHE DmAGCANHELPTOASSURETHATTHEREARENOTYPOSINYOURTREE
7UXH %XTRACTINGA*!2WITHPACKAGESWILLCREATEADIRECTORYCALLEDMETA INF
7UXH %XTRACTINGA*!2WITHPACKAGESWILLCREATEAlLECALLEDMANIFESTMF
)DOVH 4HE*73HELPERAPPALWAYSRUNSINCONJUNCTIONWITHABROWSER
)DOVH *73APPLICATIONSREQUIREANLP.ETWORK,AUNCH0ROTOCOL lLETOWORKPROPERLY
)DOVH !*73SMAINMETHODISSPECIlEDINITS*!2lLE
FKDSWHU
6XPPDU\&URVV

'2*7075$16,(17:

,%$720,&52,

$-$5.16<1&+521,=('
/(%(77*

2&+$,1('566$9(

*(7*(;(&87$%/(&7
6(3$$8&6

%,03/(0(17),/7(5

%512,)6:

',5(&725<62&.(786(5

1$(753$

3$&.$*(&/$66/2233
5(/7/53

%<7(5(6725(((;75(0(

$,(6(0;5

0$1,)(67(1&$368/$7(6
\RXDUHKHUH
UHPRWHGHSOR\PHQWZLWK50,
'LVWULEXWHG (YHU\RQHVD\VORQJ
&RPSXWLQJ GLVWDQFHUHODWLRQVKLSVDUHKDUG
EXWZLWK50,LW·VHDV\1R
PDWWHUKRZIDUDSDUWZHUHDOO\
DUH50,PDNHVLWVHHPOLNH
ZH·UHWRJHWKHU
%HLQJUHPRWHGRHVQ·WKDYHWREHDEDGWKLQJ3URETHINGSAREEASIERWHEN
ALLTHEPARTSOFYOURAPPLICATIONAREINONEPLACEINONEHEAPWITHONE*6-TORULETHEMALL"UT
THATSNOTALWAYSPOSSIBLE/RDESIRABLE7HATIFYOURAPPLICATIONHANDLESPOWERFULCOMPUTATIONS
BUTTHEEND USERSAREONAWIMPYLITTLE*AVA ENABLEDDEVICE7HATIFYOURAPPNEEDSDATA
FROMADATABASEBUTFORSECURITYREASONSONLYCODEONYOURSERVERCANACCESSTHEDATABASE
)MAGINEABIGE COMMERCEBACK ENDTHATHASTORUNWITHINATRANSACTION MANAGEMENTSYSTEM
3OMETIMESPARTOFYOURAPPMUSTRUNONASERVERWHILEANOTHERPARTUSUALLYACLIENT MUST
RUNONADIFFERENTMACHINE)NTHISCHAPTERWELLLEARNTOUSE*AVASAMAZINGLYSIMPLE2EMOTE
-ETHOD)NVOCATION2-) TECHNOLOGY7ELLALSOTAKEAQUICKPEEKAT3ERVLETS%NTERPRISE*AVA
"EANS%*" AND*INIANDLOOKATTHEWAYSINWHICH%*"AND*INIDEPENDON2-)7ELLENDTHE
BOOKBYWRITINGONEOFTHECOOLESTTHINGSYOUCANMAKEIN*AVAAUNIVERSALSERVICEBROWSER
WKLVLVDQHZFKDSWHU
KRZPDQ\KHDSV"
)LOH(GLW9LHZ
)LOH(GLW9LHZ
)LOH(GLW9LHZ
)LOH(GLW9LHZ
+773 50,
50, +773
([HFXWDEOH
-DU :HE6WDUW 50,DSS
50,DSS 6HUYOHWV
RQHKHD
SWZRR
5M\PWLKITT[IZMIT_Ia[JM\ _MMV EMHFWV
\ _WWJRMK\[WV\PM[IUMPMIX
3OFARINTHISBOOKEVERYMETHODWEVEINVOKEDHASBEENON
ANOBJECTRUNNINGINTHESAMEVIRTUALMACHINEASTHECALLER
)NOTHERWORDSTHECALLINGOBJECTANDTHECALLEETHEOBJECT I
WEREINVOKINGTHEMETHODON LIVEONTHESAMEHEAP 6WXI
GR
FODVV)RR^ %DU MHFW

RE
YRLGJR^
%DUE QHZ%DU )RR MHFW
RE
EGR6WXII
`
)RRI QHZ)RR ,QPRVWDSSOLFDWLRQVZKHQRQHREMHFW
FDOOVDPHWKRGRQDQRWKHUERWKREMHFWV
IJR
DUHRQWKHVDPHKHDS,QRWKHUZRUGV
` ERWKDUHUXQQLQJZLWKLQWKHVDPH-90
`
)NTHECODEABOVEWEKNOWTHATTHE&OOINSTANCE
REFERENCEDBYFANDTHE"AROBJECTREFERENCEDBYBARE
BOTHONTHESAMEHEAPRUNBYTHESAME*6-2EMEMBER
THE*6-ISRESPONSIBLEFORSTUFlNGBITSINTOTHEREFERENCE
VARIABLETHATREPRESENTHOWTOGETTOANOBJECTONTHEHEAP
4HE*6-ALWAYSKNOWSWHEREEACHOBJECTISANDHOWTO
GETTOIT"UTTHE*6-CANKNOWABOUTREFERENCESONONLY
ITSOWNHEAP9OUCANTFOREXAMPLEHAVEA*6-RUNNING
ONONEMACHINEKNOWINGABOUTTHEHEAPSPACEOFA*6-
RUNNINGONADIFFERENTMACHINE)NFACTA*6-RUNNINGON
ONEMACHINECANTKNOWANYTHINGABOUTADIFFERENT*6-
RUNNINGONTHESAMEMACHINE)TMAKESNODIFFERENCEIF
THE*6-SAREONTHESAMEORDIFFERENTPHYSICALMACHINES
ITMATTERSONLYTHATTHETWO*6-SAREWELLTWODIFFERENT
INVOCATIONSOFTHE*6-
FKDSWHU
?PI\QNaW]_IV\\WQV^WSMIUM\PWLWV
IVWJRMK\Z]VVQVOWVIVW\PMZUIKPQVM'
7EKNOWHOWTOGETINFORMATIONFROMONEMACHINETOANOTHER
WITH3OCKETSAND)/7EOPENA3OCKETCONNECTIONTOANOTHER
MACHINEANDGETAN/UTPUT3TREAMANDWRITESOMEDATATOIT
"UTWHATIFWEACTUALLYWANTTOCALLAMETHODONSOMETHINGRUNNING
INANOTHERMACHINEANOTHER*6-/FCOURSEWECOULDALWAYSBUILD
OUROWNPROTOCOLANDWHENYOUSENDDATATOA3ERVER3OCKETTHE
SERVERCOULDPARSEITlGUREOUTWHATYOUMEANTDOTHEWORKAND
SENDBACKTHERESULTONANOTHERSTREAM7HATAPAINTHOUGH4HINK
HOWMUCHNICERITWOULDBETOJUSTGETAREFERENCETOTHEOBJECTON
DVWORYHV
THEOTHERMACHINEANDCALLAMETHOD SRZHUIXOI XJKELJ WKUR
WRFUXQFLRKQV
FDOF XOD W
Imagine two computers...
-90
WLQ\ZLPS\
VORZDWFDOFXOSDDWLQIXOO\ -90
LRQV
/LWWOH %LJ
Big has something Little wants.

Compute power.
Little wants to send some data to Big, so that Big can do the
heavy computing.
Little wants simply to call a method...
GRXEOHGR&DOF8VLQJ'DWDEDVH&DOF1XPEHUVQXPEHUV
and get back the result.

But how can Little get a reference to an object on Big?
\RXDUHKHUH

WZRREMHFWVWZRKHDSV
7JRMK\)Z]VVQVOWV4Q\\TM_IV\[\WKITT
IUM\PWLWV7JRMK\*Z]VVQVOWV*QO
4HEQUESTIONISHOWDOWEGETANOBJECTONONEMACHINE
WHICHMEANSADIFFERENTHEAP*6- TOCALLAMETHODON
ANOTHERMACHINE
DEDVH
GR&DOF8VLQJ'DW

%
$
UHWXUQYDOXH
*]\aW]KIV¼\LW\PI\
7ELLNOTDIRECTLYANYWAY9OUCANTGETAREFERENCETO
SOMETHINGONANOTHERHEAP)FYOUSAY
$OGD
7HATEVERDISREFERENCINGMUSTBEINTHESAMEHEAPSPACEAS
THECODERUNNINGTHESTATEMENT
"UTIMAGINEYOUWANTTODESIGNSOMETHINGTHATWILLUSE
3OCKETSAND)/TOCOMMUNICATEYOURINTENTIONAMETHOD
INVOCATIONONANOBJECTRUNNINGONANOTHERMACHINE YET
STILLFEELASTHOUGHYOUWEREMAKINGALOCALMETHODCALL
)NOTHERWORDSYOUWANTTOCAUSEAMETHODINVOCATIONONA
REMOTEOBJECTIEANOBJECTINAHEAPSOMEWHEREELSE BUT
WITHCODETHATLETSYOUPRETENDTHATYOUREINVOKINGAMETHOD
ONALOCALOBJECT4HEEASEOFAPLAINOLDEVERYDAYMETHOD
CALLBUTTHEPOWEROFREMOTEMETHODINVOCATION4HATSOUR
GOAL
4HATSWHAT2-)2EMOTE-ETHOD)NVOCATION GIVESYOU
"UTLETSSTEPBACKANDIMAGINEHOWYOUWOULDDESIGN2-)IF
YOUWEREDOINGITYOURSELF5NDERSTANDINGWHATYOUDHAVETO
BUILDYOURSELFWILLHELPYOULEARNHOW2-)WORKS
FKDSWHU
$GHVLJQIRUUHPRWHPHWKRGFDOOV
&UHDWHIRXUWKLQJVVHUYHUFOLHQW
VHUYHUKHOSHUFOLHQWKHOSHU
&UHDWHFOLHQWDQGVHUYHUDSSV7KHVHUYHUDSSLVWKH
UHPRWHVHUYLFHWKDWKDVDQREMHFWZLWKWKHPHWKRG
WKDWWKHFOLHQWZDQWVWRLQYRNH
&OLHQWKHDS 6HUYHUKHDS
6H
W
UYLFHREMHF
& OL
HQWREMHFW
&UHDWHFOLHQWDQGVHUYHU¶KHOSHUV·7KH\·OOKDQGOHDOO
WKHORZOHYHOQHWZRUNLQJDQG,2GHWDLOVVR\RXUFOLHQW
DQGVHUYLFHFDQSUHWHQGOLNHWKH\·UHLQWKHVDPHKHDS
6H H
U
& OL
HQWKHOSHU UYLFHKHOS 6H
W
UYLFHREMHF
& OL
HQWREMHFW
\RXDUHKHUH
FOLHQWDQGVHUYHUKHOSHUV
<PMZWTMWN\PM»PMTXMZ[¼
4HE@HELPERSARETHEOBJECTSTHATACTUALLYDOTHECOMMUNICATING
4HEYMAKEITPOSSIBLEFORTHECLIENTTOACTASTHOUGHITSCALLINGA
METHODONALOCALOBJECT)NFACTITIS4HECLIENTCALLSAMETHODON <RXUFOLHQWREMHFWJHWVWR
THECLIENTHELPERASIFTHECLIENTHELPERWERETHEACTUALSERVICE4HECLIENT
HELPERISAPROXYFORTHE2EAL4HING DFWOLNHLW·VPDNLQJUHPRWH
)NOTHERWORDSTHECLIENTOBJECTTHINKSITSCALLINGAMETHODON PHWKRGFDOOV%XWZKDW
THEREMOTESERVICEBECAUSETHECLIENTHELPERISPRETENDINGTOBE
THESERVICEOBJECT0RETENDINGTOBETHETHINGWITHTHEMETHODTHECLIENT LW·VUHDOO\GRLQJLVFDOOLQJ
WANTSTOCALL
"UTTHECLIENTHELPERISNTREALLYTHEREMOTESERVICE!LTHOUGHTHE
PHWKRGVRQDKHDSORFDO
CLIENTHELPERACTSLIKEITBECAUSEITHASTHESAMEMETHODTHATTHE ¶SUR[\·REMHFWWKDWKDQGOHV
SERVICEISADVERTISING THECLIENTHELPERDOESNTHAVEANYOFTHE
ACTUALMETHODLOGICTHECLIENTISEXPECTING)NSTEADTHECLIENT DOOWKHORZOHYHOGHWDLOVRI
HELPERCONTACTSTHESERVERTRANSFERSINFORMATIONABOUTTHEMETHOD
CALLEGNAMEOFTHEMETHODARGUMENTSETC ANDWAITSFORA 6RFNHWVDQGVWUHDPV
RETURNFROMTHESERVER
/NTHESERVERSIDETHESERVICEHELPERRECEIVESTHEREQUESTFROM
THECLIENTHELPERTHROUGHA3OCKETCONNECTION UNPACKSTHE
INFORMATIONABOUTTHECALLANDTHENINVOKESTHEREALMETHODON
THEREALSERVICEOBJECT3OTOTHESERVICEOBJECTTHECALLISLOCAL)TS
COMINGFROMTHESERVICEHELPERNOTAREMOTECLIENT
4HESERVICEHELPERGETSTHERETURNVALUEFROMTHESERVICEPACKSIT
UPANDSHIPSITBACKOVERA3OCKETSOUTPUTSTREAM TOTHECLIENT
HELPER4HECLIENTHELPERUNPACKSTHEINFORMATIONANDRETURNSTHE
VALUETOTHECLIENTOBJECT
HQGV
&OLHQWKHOSHUUYSULFHW
H E XW
VH
WREHWKH R[\IRUWKH
LW·VMXVWDSU 6HUYHUKHDS
&OLHQWKHDS
5HDO7KLQJ
LQNV
&OLHQWREMHFWRWKWKH 6H H
U
& OL
W
W UYLFHREMHF
LW·VWDONLQJ H,W & OL
5HDO6HUYLF OLHQW HQWREMHFW

WKLQNVWKHFHWKLQJ 6 H U Y LF H REMHFW,6·VWKH
KHOSHULVWK XDOO\ 6HUYLFHKHOSHUJHWVWKH 7KH HDO6HUYLFH,W KRG
WKDWFDQDFWZRUN UHTXHVWIURPWKHFOLHQW WKH5 ZLWKWKHPHW KH
GRWKHUHDO KHOSHUXQSDFNVLWDQG REMHFW FWXDOO\GRHVW
FDOOVWKHPHWKRGRQWKH WKDWD HWKRGZRUN
5HDO6HUYLFH UHDOP
FKDSWHU
+RZWKHPHWKRGFDOOKDSSHQV
&OLHQWREMHFWFDOOVGR%LJ7KLQJRQWKHFOLHQWKHOSHUREMHFW
GR%LJ7KLQJ
6H H
U
& OL
W
UYLFHREMHF
& OL
HQWREMHFW

Licensed by
&OLHQWKHOSHUSDFNDJHVXSLQIRUPDWLRQDERXWWKHFDOO
Eduard Simons
DUJXPHQWVPHWKRGQDPHHWFDQGVKLSVLWRYHUWKH
QHWZRUNWRWKHVHUYLFHKHOSHU
´FOLHQWZDQWVWRFDOODPHWKRGµ
104038
GR%LJ7KLQJ
6H H
U
&OL
HQWKHOSHU UYLFHKHOS 6H W
UYLFHREMHF
& OL
HQWREMHFW
6HUYLFHKHOSHUXQSDFNVWKHLQIRUPDWLRQIURPWKHFOLHQWKHOSHU
ÀQGVRXWZKLFKPHWKRGWRFDOODQGRQZKLFKREMHFWDQG
LQYRNHVWKHUHDOPHWKRGRQWKHUHDOVHUYLFHREMHFW
´FOLHQWZDQWVWRFDOODPHWKRGµ
GR%LJ7KLQJ
GR%LJ7KLQJ
WKH
5HPHPEHUWKLWKVHLV5($/
REMHFWZLWKF7KHJX\
H PHWKRGORJL HUHDOZRUN
6H
WKDWGRHVWK
U
& OL
W
UYLFHREMHF
& OL FW

HQWREMH
\RXDUHKHUH
50,KHOSHUREMHFWV
2IÎ:51OQ^M[aW]\PMKTQMV\IVL
[MZ ^QKMPMTXMZWJRMK\[
)N*AVA2-)BUILDSTHECLIENTANDSERVICEHELPER 4HEYTHROWEXCEPTIONSALLOVERTHEPLACE
OBJECTSFORYOUANDITEVENKNOWSHOWTOMAKETHE 3OTHECLIENTDOESHAVETOACKNOWLEDGETHERISK4HE
CLIENTHELPERLOOKLIKETHE2EAL3ERVICE)NOTHER CLIENTHASTOACKNOWLEDGETHATWHENITCALLSAREMOTE
WORDS2-)KNOWSHOWTOGIVETHECLIENTHELPER METHODEVENTHOUGHTOTHECLIENTITSJUSTALOCALCALL
OBJECTTHESAMEMETHODSYOUWANTTOCALLONTHE TOTHEPROXYHELPEROBJECTTHECALLULTIMATELYINVOLVES
REMOTESERVICE 3OCKETSANDSTREAMS4HECLIENTSORIGINALCALLISLOCAL
0LUS2-)PROVIDESALLTHERUNTIMEINFRASTRUCTURETO BUTTHEPROXYTURNSITINTOAREMOTECALL!REMOTECALL
MAKEITWORKINCLUDINGALOOKUPSERVICESOTHATTHE JUSTMEANSAMETHODTHATSINVOKEDONANOBJECTON
CLIENTCANlNDANDGETTHECLIENTHELPERTHEPROXY ANOTHER*6-(OWTHEINFORMATIONABOUTTHATCALL
FORTHE2EAL3ERVICE GETSTRANSFERREDFROMONE*6-TOANOTHERDEPENDS
7ITH2-)YOUDONTWRITEANYOFTHENETWORKING ONTHEPROTOCOLUSEDBYTHEHELPEROBJECTS
OR)/CODEYOURSELF4HECLIENTGETSTOCALLREMOTE 7ITH2-)YOUHAVEACHOICEOFPROTOCOLS*2-0OR
METHODSIETHEONESTHE2EAL3ERVICEHAS JUST ))/0*2-0IS2-)S@NATIVEPROTOCOLTHEONEMADE
LIKENORMALMETHODCALLSONOBJECTSRUNNINGINTHE JUSTFOR*AVA TO *AVAREMOTECALLS))/0ONTHEOTHER
CLIENTSOWNLOCAL*6- HANDISTHEPROTOCOLFOR#/2"!#OMMON/BJECT
!LMOST 2EQUEST"ROKER!RCHITECTURE ANDLETSYOUMAKE
REMOTECALLSONTHINGSWHICHARENTNECESSARILY*AVA
4HEREISONEDIFFERENCEBETWEEN2-)CALLSANDLOCAL OBJECTS#/2"!ISUSUALLYMUCHMOREPAINFULTHAN
NORMAL METHODCALLS2EMEMBERTHATEVENTHOUGH 2-)BECAUSEIFYOUDONTHAVE*AVAONBOTHENDS
TOTHECLIENTITLOOKSLIKETHEMETHODCALLISLOCAL THERESANAWFULLOTOFTRANSLATIONANDCONVERSIONTHAT
THECLIENTHELPERSENDSTHEMETHODCALLACROSSTHE HASTOHAPPEN
NETWORK3OTHEREISNETWORKINGAND)/!NDWHAT
DOWEKNOWABOUTNETWORKINGAND)/METHODS "UTTHANKFULLYALLWECAREABOUTIS*AVA TO *AVASO
WERESTICKINGWITHPLAINOLDREMARKABLYEASY2-)
4HEYRERISKY
,Q50,WKHFOLHQWKHOSHULVD¶VWXE·
DQGWKHVHUYHUKHOSHULVD¶VNHOHWRQ·
50,678% 50,6.(/(721
6H H
U
& OL
W
UYLFHREMHF
& OL
HQWREMHFW
FKDSWHU
0DNLQJWKH5HPRWH6HUYLFH
4HISISANOVERVIEWOFTHElVESTEPSFORMAKINGTHEREMOTE 6HUYHU
SERVICETHATRUNSONTHESERVER $ONTWORRYEACHSTEPIS
EXPLAINEDINDETAILOVERTHENEXTFEWPAGES
WKH
6WHSRQH
LQ W H U I D FHGHILQDHWV\RX
0DNHD5HPRWH,QWHUIDFH SXEOLFLQWHUIDFH
0\5HPRWHH[WHQGV
7KLV HPHWKRGVWK
UHPRW OLHQWVWRFDOO
5HPRWH^`
4HEREMOTEINTERFACEDElNESTHEMETHODS
THATACLIENTCANCALLREMOTELY)TSWHAT
ZDQWF
0\5HPRWHMDYD
THECLIENTWILLUSEASTHEPOLYMORPHICCLASS
TYPEFORYOURSERVICE"OTHTHE3TUBA ND
ACTUALSERVICEWILLIMPLEMENTTHIS
6WHSWZR
7KH5HDO6HUYLFHW 7KHFODVV
0DNHD5HPRWH,PSOHPHQWDWLRQ
SXEOLFLQWHUIDFH
ZLWKWKHPHWKR LPKD
GV WGR
PHQWV
0\5HPRWHH[WHQGV
5HPRWH^`
WKHUHDOZ RU N ,W SOH

4HISISTHECLASSTHATDOESTHE2EAL7ORK ID FH
)THASTHEREALIMPLEMENTATIONOFTHE WKHUHPRWHLQWHU
0\5HPRWH,PSOMDYD
REMOTEMETHODSDElNEDINTHEREMOTE
INTERFACE)TSTHEOBJECTTHATTHECLIENT
WANTSTOCALLMETHODSON
VSLWVRXWWZ QH
WKHDFWXDO FODVVHVIRUWR Z
6WHSWKUHH 5XQQLQJUPLFDJDLQVW ODVV KHOSHUREMHFWVKH
VHUYLFHLPSOHPHQWDWLRQF
*HQHUDWHWKHVWXEVDQGVNHOHWRQVXVLQJUPLF
)LOH(GLW:LQGRZ+HOS(DW
4HESEARETHECLIENTANDSERVER@HELPERS
9OUDONTHAVETOCREATETHESECLASSESOREVER UPLF0\5HPRWH,PSO

LOOKATTHESOURCECODETHATGENERATESTHEM 0\5HPRWH,PSOB6WXEFODVV
)TSALLHANDLEDAUTOMATICALLYWHENYOU

RUNTHERMICTOOLTHATSHIPSWITHYOUR*AVA

DEVELOPMENTKIT

0\5HPRWH,PSOB6NHOFODVV
6WHSIRXU )LOH(GLW:LQGRZ+HOS'ULQN
6WDUWWKH50,UHJLVWU\UPLUHJLVWU\ UPLUHJLVWU\ D

4HERMIREGISTRYISLIKETHEWHITEPAGESOFA UXQWKLVHLQWHUPLQDO
PHONEBOOK)TSWHERETHEUSERGOESTOGET VHSDUDW
THEPROXYTHECLIENTSTUBHELPEROBJECT
6WHSÀYH
)LOH(GLW:LQGRZ+HOS%H0HUU\
6WDUWWKHUHPRWHVHUYLFH
9OUHAVETOGETTHESERVICEOBJECTUPANDRUNNING MDYD0\5HPRWH,PSO
9OURSERVICEIMPLEMENTATIONCLASSINSTANTIATESAN
INSTANCEOFTHESERVICEANDREGISTERSITWITHTHE2-)
REGISTRY2EGISTERINGITMAKESTHESERVICEAVAILABLEFOR
CLIENTS
\RXDUHKHUH
DUHPRWHLQWHUIDFH
6WHSRQH0DNHD5HPRWH,QWHUIDFH SXEOLFLQWHUIDFH
0\5HPRWHH[WHQGV
5HPRWH^`
0\5HPRWHMDYD
([WHQGMDYDUPL5HPRWH
2EMOTEISA@MARKERINTERFACEWHICHMEANSITHASNOMETHODS)THAS
SPECIALMEANINGFOR2-)THOUGHSOYOUMUSTFOLLOWTHISRULE.OTICE
THATWESAY@EXTENDSHERE/NEINTERFACEISALLOWEDTOEXTENDANOTHER
KDVWR
INTERFACE <RXULQWHUIDFWHLW·VIRU
DQQRXQFHWKDKRGFDOOV$Q
SXEOLFLQWHUIDFH0\5HPRWHH[WHQGV5HPRWH^ UHPRWHPHW Q·WLPSOHPHQW
LQWHUIDFHFDWLWFDQH[WHQG
DQ\WKLQJEX DFHV
'HFODUHWKDWDOOPHWKRGVWKURZD5HPRWH([FHSWLRQ RWKHULQWHUI
4HEREMOTEINTERFACEISTHEONETHECLIENTUSESASTHEPOLYMORPHICTYPE
FORTHESERVICE)NOTHERWORDSTHECLIENTINVOKESMETHODSONSOMETHING
THATIMPLEMENTSTHEREMOTEINTERFACE4HATSOMETHINGISTHESTUBOF
COURSEANDSINCETHESTUBISDOINGNETWORKINGAND)/ALLKINDSOF"AD
4HINGSCANHAPPEN4HECLIENTHASTOACKNOWLEDGETHERISKSBYHANDLING
ORDECLARINGTHEREMOTEEXCEPTIONS)FTHEMETHODSINANINTERFACE
DECLAREEXCEPTIONSANYCODECALLINGMETHODSONAREFERENCEOFTHATTYPE
THEINTERFACETYPE MUSTHANDLEORDECLARETHEEXCEPTIONS
LVLQMDYDUPL
LPSRUWMDYDUPL WKH5HPRWHLQWHUIDFH
(YHU\UHPRWHPHWKRGF LV
FRQVLGHUHG¶ULVN\·'HFODDOO
SXEOLFLQWHUIDFH0\5HPRWHH[WHQGV5HPRWH^
SXEOLF6WULQJVD\+HOORWKURZV5HPRWH([FHSWLRQ 5HPRWH([FHSWLRQRQHYHUULQJ\

` PHWKRGIRUFHVWKHFOLH
WRSD\DWWHQWLRQDQG QW
DFNQRZOHGJHWKDWWKLQJV
PLJKWQRWZRUN
%HVXUHDUJXPHQWVDQGUHWXUQYDOXHVDUHSULPLWLYHVRU6HULDOL]DEOH
!RGUMENTSANDRETURNVALUESOFAREMOTEMETHODMUSTBEEITHERPRIMITIVE
OR3ERIALIZABLE4HINKABOUTIT!NYARGUMENTTOAREMOTEMETHODHASTO
BEPACKAGEDUPANDSHIPPEDACROSSTHENETWORKANDTHATSDONETHROUGH
3ERIALIZATION3AMETHINGWITHRETURNVALUES)FYOUUSEPRIMITIVES3TRINGS
ANDTHEMAJORITYOFTYPESINTHE!0)INCLUDINGARRAYSANDCOLLECTIONS
YOULLBElNE)FYOUAREPASSINGAROUNDYOUROWNTYPESJUSTBESURETHAT
YOUMAKEYOURCLASSESIMPLEMENT3ERIALIZABLE
SXEOLF6WULQJVD\+HOORWKURZV5HPRWH([FHSWLRQ
7KLVUHWXUQYDOXHLVJRQQDEHVKLSSH
RYHUWKHZLUHIURPWKHVHUYHUEDFNG
WKHFOLHQWVRLWPXVWEH6HULD WR
7KDW·VKRZDUJVDQGUHWXUQYDOL]D EOH
OXHVJHW
SDFNDJHGXSDQGVHQW
FKDSWHU
6WHSWZR0DNHD5HPRWH,PSOHPHQWDWLRQ SXEOLFLQWHUIDFH
0\5HPRWHH[WHQGV
5HPRWH^`
,PSOHPHQWWKH5HPRWHLQWHUIDFH 0\5HPRWH,PSOMDYD
9OURSERVICEHASTOIMPLEMENTTHEREMOTEINTERFACETHEONE
WITHTHEMETHODSYOURCLIENTISGOINGTOCALL
SXEOLFFODVV0\5HPRWH,PSOH[WHQGV8QLFDVW5HPRWH2EMHFWLPSOHPHQWV0\5HPRWH^
SXEOLF6WULQJVD\+HOOR^
UHWXUQ³6HUYHUVD\Vµ+H\¶´ 7KHFRPSLOHUZLOOPDNHVXUHWKDW
` \RX·YHLPSOHPHQWHGDOOWKHPHWKR
PRUHFRGHLQFODVV
IUR PWKHLQWHUIDFH\RXLPSOHPHQWGV
,Q
`
WKLVFDVHWKHUH·VRQO\RQH
([WHQG8QLFDVW5HPRWH2EMHFW
)NORDERTOWORKASAREMOTESERVICEOBJECTYOUROBJECTNEEDSSOME
FUNCTIONALITYRELATEDTO@BEINGREMOTE4HESIMPLESTWAYISTOEXTEND
5NICAST2EMOTE/BJECTFROMTHEJAVARMISERVERPACKAGE ANDLETTHAT
CLASSYOURSUPERCLASS DOTHEWORKFORYOU
:ULWHDQRDUJFRQVWUXFWRUWKDWGHFODUHVD5HPRWH([FHSWLRQ
9OURNEWSUPERCLASS5NICAST2EMOTE/BJECTHASONELITTLEPROBLEMITS
CONSTRUCTORTHROWSA2EMOTE%XCEPTION4HEONLYWAYTODEALWITHTHISIS
TODECLAREACONSTRUCTORFORYOURREMOTEIMPLEMENTATIONJUSTSOTHATYOU
HAVEAPLACETODECLARETHE2EMOTE%XCEPTION2EMEMBERWHENACLASSIS
INSTANTIATEDITSSUPERCLASSCONSTRUCTORISALWAYSCALLED)FYOURSUPERCLASS
CONSTRUCTORTHROWSANEXCEPTIONYOUHAVENOCHOICEBUTTODECLARETHAT
XWDQ\WKLQJLQ
YOURCONSTRUCTORALSOTHROWSANEXCEPTION <RXGRQ·WKDYHWRS HHGD XMXVWQ
SXEOLF0\5HPRWH,PSOWKURZV5HPRWH([FHSWLRQ^` WKHFRQVWUXFWRHUWK<R
DW\RXUVXSHUFODVV
ZD\WRGHFODU URZVDQH[FHSWLRQ
FRQVWUXFWRUWK
5HJLVWHUWKHVHUYLFHZLWKWKH50,UHJLVWU\
.OWTHATYOUVEGOTAREMOTESERVICEYOUHAVETOMAKEITAVAILABLETO
REMOTECLIENTS9OUDOTHISBYINSTANTIATINGITANDPUTTINGITINTOTHE2-)
REGISTRYWHICHMUSTBERUNNINGORTHISLINEOFCODEFAILS 7HENYOU
REGISTERTHEIMPLEMENTATIONOBJECTTHE2-)SYSTEMACTUALLYPUTSTHESTUBIN
THEREGISTRYSINCETHATSWHATTHECLIENTREALLYNEEDS2EGISTERYOURSERVICE
USINGTHESTATICREBIND METHODOFTHEJAVARMI.AMINGCLASS
Q DP HWKDWFOLHQWVLVW FDQXVH
*LYH \ RX U VH UY LFHD HULW
WU\^
WRORRNLWXSLQHJ WKHUHJLVWU\D\RQGXUELHJQGWKH
0\5HPRWHVHUYLFH QHZ0\5HPRWH,PSO U\:KHQ
1DPLQJUHELQG³5HPRWH+HOOR´VHUYLFH ZLWKWKH50,U50LVW,VZDSVWKHVHUYLFHIRUWKH
HF W
VHUYLFHREM WKHVWXELQWKHUHJLVWU\
`FDWFK([FHSWLRQH[^` SXWV
VWXEDQG
\RXDUHKHUH
VWXEVDQGVNHOHWRQV
6WHSWKUHHJHQHUDWHVWXEVDQGVNHOHWRQV
5XQUPLFRQWKHUHPRWHLPSOHPHQWDWLRQFODVV
VSLWVRXWWZ QH
QRWWKHUHPRWHLQWHUIDFH
FODVVHVIRUWR Z
4HERMICTOOLTHATCOMESWITHTHE*AVASOFTWARE 1RWLFHWKDW\RXGWRQKH·W VD\ ´FODVVµ KHOSHUREMHFWVKH
DEVELOPMENTKITTAKESASERVICEIMPLEMENTATIONAND RQWKH HQ G -X VW FO DVVQDPH

CREATESTWONEWCLASSESTHESTUBANDTHESKELETON )LOH(GLW:LQGRZ+HOS:KXI¿H

)TUSESANAMINGCONVENTIONTHATISTHENAMEOF
YOURREMOTEIMPLEMENTATIONWITHEITHER?3TUBOR UPLF0\5HPRWH,PSO

0\5HPRWH,PSOB6WXEFODVV
?3KELETONADDEDTOTHEEND4HEREAREOTHEROPTIONS
WITHRMICINCLUDINGNOTGENERATINGSKELETONS

SEEINGWHATTHESOURCECODEFORTHESECLASSESLOOKED

LIKEANDEVENUSING))/0ASTHEPROTOCOL4HEWAY
WEREDOINGITHEREISTHEWAYYOULLUSUALLYDOIT 0\5HPRWH,PSOB6NHOFODVV
4HECLASSESWILLLANDINTHECURRENTDIRECTORYIE
WHATEVERYOUDIDACDTO 2EMEMBERRMICMUST
BEABLETOSEEYOURIMPLEMENTATIONCLASSSOYOULL
PROBABLYRUNRMICFROMTHEDIRECTORYWHEREYOUR
REMOTEIMPLEMENTATIONIS7EREDELIBERATELYNOT
USINGPACKAGESHERETOMAKEITSIMPLER)NTHE2EAL
7ORLDYOULLNEEDTOACCOUNTFORPACKAGEDIRECTORY
STRUCTURESANDFULLY QUALIlEDNAMES
6WHSIRXUUXQUPLUHJLVWU\
%ULQJXSDWHUPLQDODQGVWDUWWKHUPLUHJLVWU\ )LOH(GLW:LQGRZ+HOS+XK"
"ESUREYOUSTARTITFROMAD
IRECTORYTHATHASACCESS UPLUHJLVWU\
TOYOURCLASSES4HESIMPLESTWAYISTOSTARTITFROM
YOUR@CLASSESDIRECTORY
6WHSÀYHVWDUWWKHVHUYLFH
%ULQJXSDQRWKHUWHUPLQDODQGVWDUW\RXUVHUYLFH )LOH(GLW:LQGRZ+HOS+XK"
4HISMIGHTBEFROMAMAIN METHODINYOURREMOTE MDYD0\5HPRWH,PSO

IMPLEMENTATIONCLASSORFROMASEPARATELAUNCHERCLASS
)NTHISSIMPLEEXAMPLEWEPUTTHESTARTERCODEINTHE
IMPLEMENTATIONCLASSINAMAINMETHODTHATINSTANTIATES
THEOBJECTANDREGISTERSITWITH2-)REGISTRY
FKDSWHU
&RPSOHWHFRGHIRUWKHVHUYHUVLGH
6HUYHU
7KH5HPRWHLQWHUIDFH
5HPRWH([FHSWLRQDYD QG5HPRWH
LQWHUIDFHDUHLQ MD UPLSDFNDJH
LPSRUWMDYDUPL
<RXULQWHUIDFH0867H[WHQG
SXEOLFLQWHUIDFH0\5HPRWHH[WHQGV5HPRWH^ MDYDUPL5HPRWH
$OORI\RXUUHPRWHPHWKRGVPXVW
SXEOLF6WULQJVD\+HOORWKURZV5HPRWH([FHSWLRQ GHFODUHD5HPRWH([FHSWLRQ
`
7KH5HPRWHVHUYLFHWKHLPSOHPHQWDWLRQ

RW H 2 EMHF WLVLQWKH
P
8QLFDVWL5VHHUYHUSDFNDJH FD VW 5HPRWH2EMHFWLV WKH
LPSRUWMDYDUPL Y DU P QG LQ J 8 QL MHFW
MD H[WH HDUHPRWHRE
LPSRUWMDYDUPLVHUYHU
HDVLHVWZD\WRPDN

<RXKDYHWRLPSOHPHQWDOOWKH \RX0867LPSOHP
SXEOLF6WULQJVD\+HOOR^
LQWHUIDFHPHWKRGVRIFRXUVH%XW UHPRWHLQWHUI HQW\RXU
UHWXUQ³6HUYHUVD\Vµ+H\¶´
QRWLFHWKDW\RXGR127KDYHWR DFH
`
GHFODUHWKH5HPRWH([FHSWLRQ
SXEOLF0\5HPRWH,PSOWKURZV5HPRWH([FHSWLRQ^` \RXUVXSHUFODVVFRQVWUXFWRUIRUDQH[FHSWLRQVR

8QLFDVW5HPRWH2EMHFWGHFODUHV UEHFDXVHLWPHDQV
<28PXVWZULWHDFRQVWUXFWRQJU LVN\FRGHLWV
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ WKDW\RXUFRQVWUXFWR ULVFDOOL
VXSHUFRQVWU XFWR U
WU\^
0\5HPRWHVHUYLFH QHZ0\5HPRWH,PSO
1DPLQJUHELQG³5HPRWH+HOOR´VHUYLFH
`FDWFK([FHSWLRQH[^ 0DNHWKHUHPRW EMHF
H[SULQW6WDFN7UDFH UPLUHJLVWU\XVLQJHR
W KHVW
WWKHQ¶ELQG·LWWRWKH

` QDPH\RXUHJLVWHULWXQ DWLF1DPLQJUHELQG7KH
GH
QHHGWRORRNLWXSLQWKH U LV WKHQDPHF
UPLUHJLVWU\ OLHQWVZLOO
`
`
\RXDUHKHUH
JHWWLQJWKHVWXE
0W_LWM[\PMKTQMV\OM\\PM[\]JWJRMK\'
4HECLIENTHASTOGETTHESTUBOBJECTSINCETHATSTHETHINGTHE
CLIENTWILLCALLMETHODSON!NDTHATSWHERETHE2-)REGISTRY
COMESIN4HECLIENTDOESA@LOOKUPLIKEGOINGTOTHEWHITEPAGES
OFAPHONEBOOKANDESSENTIALLYSAYSh(ERESANAMEAND)DLIKE
7KLVPXVWEH
THESTUBTHATGOESWITHTHATNAMEv
WKDWWKHVHUYLWFHKHQDPH
ORRNXSLVDVWDWLFPHWKRGRI UHJLVWHUHGXQGHUZDV
WKH1DPLQJFODVV
0\5HPRWHVHUYLFH 0\5HPRWH1DPLQJORRNXS³UPL5HPRWH+HOOR´
7KHFOLHQWDOZD\VXVHVWKH <RXKDYHWRFDVWLWWRWKH \RXUKRVWQDPHRU,3

UHPRWHLPSOHPHQWDWLRQDVWKH LQWHUIDFHVLQFHWKHORRNXS DGGUHVVJRHVKHUH
W\SHRIWKHVHUYLFH,QID FW PHWKRGUHWXUQVW\SH2EMHFW
WKHFOLHQWQHYHUQHHGVWRNQ
WKHDFWXDOFODVVQDPHRI\RXRZ
U
UHPRWHVHUYLFH
&OLHQW 6HUYHU

HOOR
VD\+

6 NH O 6H
W
6 WX E
VWX
EU
HWRQ UYLFHREMHF
& OL FW
HW
HQWREMH XU
QH
G

OR 50,UHJLVWU\RQVHUYHU
RNX
S
5HPRWH
+HOOR
&OLHQWGRHVDORRNXSRQWKH50,UHJLVWU\
1DPLQJORRNXS³UPL5HPRWH+HOOR´
6WXE
50,UHJLVWU\UHWXUQVWKHVWXEREMHFW
ASTHERETURNVALUEOFTHELOOKUPMETHOD AND2-)
DESERIALIZESTHESTUBAUTOMATICALLY9OU-534HAVE
THESTUBCLASSTHATRMICGENERATEDFORYOU ONTHE
CLIENTORTHESTUBWONTBEDESERIALIZED
&OLHQWLQYRNHVDPHWKRGRQWKHVWXEDV
WKRXJKWKHVWXE,6WKHUHDOVHUYLFH
FKDSWHU
0W_LWM[\PMKTQMV\OM\\PM[\]JKTI[['
.OWWEGETTOTHEINTERESTINGQUESTION3OMEHOWSOMEWAYTHE
CLIENTMUSTHAVETHESTUBCLASSTHATYOUGENERATEDEARLIERUSING
RMIC ATTHETIMETHECLIENTDOESTHELOOKUPORELSETHESTUBWONT
BEDESERIALIZEDONTHECLIENTANDTHEWHOLETHINGBLOWSUP)NA
SIMPLESYSTEMYOUCANSIMPLYHAND DELIVERTHESTUBCLASSTOTHE
CLIENT
4HERESAMUCHCOOLERWAYTHOUGHALTHOUGHITSBEYONDTHE
SCOPEOFTHISBOOK"UTJUSTINCASEYOUREINTERESTEDTHECOOLER
WAYISCALLEDhDYNAMICCLASSDOWNLOADINGv7ITHDYNAMICCLASS
DOWNLOADINGASTUBOBJECTORREALLYANY3ERIALIZEDOBJECT IS
@STAMPEDWITHA52,THATTELLSTHE2-)SYSTEMONTHECLIENT
WHERETOlNDTHECLASSlLEFORTHATOBJECT4HENINTHEPROCESSOF
DESERIALIZINGANOBJECTIF2-)CANTlNDTHECLASSLOCALLYITUSES
THAT52,TODOAN(440'ETTORETRIEVETHECLASSlLE3OYOUD
NEEDASIMPLE7EBSERVERTOSERVEUPCLASSlLESANDYOUDALSO
NEEDTOCHANGESOMESECURITYPARAMETERSONTHECLIENT4HEREARE
AFEWOTHERTRICKYISSUESWITHDYNAMICCLASSDOWNLOADINGBUTTHATS
THEOVERVIEW
&RPSOHWHFOLHQWFRGH
7KH1DPLQJFODV
UHPLUHJLVWU\ORRNVIRUGRLQJWKH
LPSRUWMDYDUPL MDYDUPLSDFNDJH XSLVLQWKH
SXEOLFFODVV0\5HPRWH&OLHQW^
QHZ0\5HPRWH&OLHQWJR
`
\SH
IW K H U H JLVWU\DVVWW
WR FD
SXEOLFYRLGJR^
,WFRPHVVRRXGRQ·WIRUJHWWKH
2EMH F W
WU\^
0\5HPRWHVHUYLFH 0\5HPRWH1DPLQJORRNXS³UPL5HPRWH+HOOR´
6WULQJV VHUYLFHVD\+HOOR \RXQHHGWKH,3 GWR

RUKRVWQDPH DGGUHVV DQGWKHQDPHWXKHVHVHUYLFH
6\VWHPRXWSULQWOQV
,WORRNVMXVWOLNHDUHJX ELQGUHELQG
`FDWFK([FHSWLRQH[^
FDOO([FHSWLW VWD ODU R OGPHWKRG
5HPRWH([FHSWLRQPX
H[SULQW6WDFN7UDFH
`
FNQRZOHGJHWKH

`
`
\RXDUHKHUH
50,FODVVILOHV
*M[]ZMMIKPUIKPQVMPI[\PMKTI[[
NQTM[Q\VMML[
4HETOPTHREETHINGSPROGRAMMERSDOWRONGWITH2-)ARE
&ORGETTOSTARTRMIREGISTRYBEFORESTARTINGREMOTESERVICE
WHENYOUREGISTERTHESERVICEUSING.AMINGREBIND THE
RMIREGISTRYMUSTBERUNNING
&ORGETTOMAKEARGUMENTSANDRETURNTYPESSERIALIZABLE
YOUWONTKNOWUNTILRUNTIMETHISISNOTSOMETHINGTHE
COMPILERWILLDETECT
&ORGETTOGIVETHESTUBCLASSTOTHECLIENT
&OLHQW 6HUYHU
6 NH O
HWRQ 6H
W
UYLFHREMHF
6 WX E
& OL
HQWREMHFW
6 WX E
'RQ·WIRUJHWWKHFOLHQW

XVHVWKHLQWHUIDFHWRFDOO

PHWKRGVRQWKHVWXE7KH

FOLHQW-90QHHGVWKHVWXE 0\5HPRWH,PSOFODVV 0\5HPRWH,PSOB6WXEFODVV

FODVVEXWWKHFOLHQWQHYHU &OLHQWFODVV 0\5HPRWH,PSOB6WXEFODVV
UHIHUVWRWKHVWXEFODVV

LQFRGH7KHFOLHQWDOZD\V

XVHVWKHUHPRWHLQWHUIDFH

DVWKRXJKWKHUHPRWH
0\5HPRWH,PSOB6NHOFODVV
LQWHUIDFH:(5(WKH 0\5HPRWHFODVV
0\5HPRWHFODVV
DFWXDOUHPRWHREMHFW
6HUYHUQHHGVERWKWKH6WXEDQG6NHOHWRQ
IDFH
RWHLQWHU FODVVHVDVZHOODVWKHVHUYLFHDQGWKH
7KHUHP UHPRWHLQWHUIDFH,WQHHGVWKHVWXEFODVV
EHFDXVHUHPHPEHUWKHVWXELVVXEVWLWXWHG
IRUWKHUHDOVHUYLFHZKHQWKHUHDOVHUYLFH
LVERXQGWRWKH50,UHJLVWU\
FKDSWHU
6KDUSHQ \RXU SHQFLO 7HAT´S

&IRST
,OOKATTHESEQUENCEOFEVENTSBELOWAND
PLACETHEMINTHEORDERINWHICHTHEY
OCCURINA*AVA2-)APPLICATION

7KHFOLHQWJHWVWKHV
WXEIURP
PHWKRG WKH50,UHJLVWU\
VWKH
7KHVWXEVHQG
FDOOWRWKHVHUYHU
Licensed by
NHVDPHWKRG
7KHFOLHQWLQYR
RQWKHVWXE
7KHFOLHQWGRHVDORRNX 7KHUHPRWHVHUYLFHLVUHJLV
SRQ
WKH50,5HJLVWU\ WHUHGZLWKWKH50,UHJLVWU\

7KH50,UHJLVWU\LVVWDUWHG 7KHUHPRWHVHUYLFHUHPRWH
Eduard Simons
LPSOHPHQWDWLRQLVLQVWDQWLDWHG

104038
:MDD=LHGAFLK
$QREMHFWRQRQHKHDSFDQQRWJHWDQRUPDO-DYD <RXUUHPRWHVHUYLFHVKRXOGH[WHQG8QLFDVW5HPRWH2EMHFW
UHIHUHQFHWRDQREMHFWRQDGLIIHUHQWKHDSZKLFKPHDQV 7HFKQLFDOO\WKHUHDUHRWKHUZD\VWRFUHDWHDUHPRWHRE
UXQQLQJRQDGLIIHUHQW-90 MHFWEXWH[WHQGLQJ8QLFDVW5HPRWH2EMHFWLVWKHVLPSOHVW
-DYD5HPRWH0HWKRG,QYRFDWLRQ50,PDNHVLWVHHPOLNH <RXUUHPRWHVHUYLFHFODVVPXVWKDYHDFRQVWUXFWRU
\RX·UHFDOOLQJDPHWKRGRQDUHPRWHREMHFWLHDQREMHFW DQGWKHFRQVWUXFWRUPXVWGHFODUHD5HPRWH([FHSWLRQ
LQDGLIIHUHQW-90EXW\RXDUHQ·W EHFDXVHWKHVXSHUFODVVFRQVWUXFWRUGHFODUHVRQH
:KHQDFOLHQWFDOOVDPHWKRGRQDUHPRWHREMHFWWKH <RXUUHPRWHVHUYLFHPXVWEHLQVWDQWLDWHGDQGWKHREMHFW
FOLHQWLVUHDOO\FDOOLQJDPHWKRGRQDSUR[\RIWKHUHPRWH UHJLVWHUHGZLWKWKH50,UHJLVWU\
REMHFW7KHSUR[\LVFDOOHGD¶VWXE· 7RUHJLVWHUDUHPRWHVHUYLFHXVHWKHVWDWLF
$VWXELVDFOLHQWKHOSHUREMHFWWKDWWDNHVFDUHRIWKHORZ 1DPLQJUHELQG´6HUYLFH1DPHµVHUYLFH,QVWDQFH
OHYHOQHWZRUNLQJGHWDLOVVRFNHWVVWUHDPVVHULDOL]DWLRQ 7KH50,UHJLVWU\PXVWEHUXQQLQJRQWKHVDPHPDFKLQH
HWFE\SDFNDJLQJDQGVHQGLQJPHWKRGFDOOVWRWKH DVWKHUHPRWHVHUYLFHEHIRUH\RXWU\WRUHJLVWHUDUHPRWH
VHUYHU REMHFWZLWKWKH50,UHJLVWU\
7REXLOGDUHPRWHVHUYLFHLQRWKHUZRUGVDQREMHFWWKDW 7KHFOLHQWORRNVXS\RXUUHPRWHVHUYLFHXVLQJWKHVWDWLF
DUHPRWHFOLHQWFDQXOWLPDWHO\FDOOPHWKRGVRQ\RXPXVW 1DPLQJORRNXSÚPL0\+RVW1DPH6HUYLFH1DPHµ
VWDUWZLWKDUHPRWHLQWHUIDFH
$OPRVWHYHU\WKLQJUHODWHGWR50,FDQWKURZD
$UHPRWHLQWHUIDFHPXVWH[WHQGWKHMDYDUPL5HPRWH 5HPRWH([FHSWLRQFKHFNHGE\WKHFRPSLOHU7KLV
LQWHUIDFHDQGDOOPHWKRGVPXVWGHFODUH LQFOXGHVUHJLVWHULQJRUORRNLQJXSDVHUYLFHLQWKHUHLJVWU\
5HPRWH([FHSWLRQ DQGDOOUHPRWHPHWKRGFDOOVIURPWKHFOLHQWWRWKHVWXE
<RXUUHPRWHVHUYLFHLPSOHPHQWV\RXUUHPRWHLQWHUIDFH
\RXDUHKHUH
XVHVIRU50,
AMIPJ]\_PWZMITTa][M[:51'
:HXVHLW
IRURXUFRRO ,KHDUG\RXUH[
QHZGHFLVLRQVXSSRUW ZLIHVWLOOXVHV
V\VWHP SODLQVRFNHWV
,XVHLW
IRUVHULRXV%WR%
HFRPPHUFHEDFN
HQGVUXQQLQJRQ-((
WHFKQRORJ\
:H·YH JRWDQ
(-%EDVHGKRWHO
UHVHUYDWLRQV\VWHP
$QG(-%XVHV50,
,MXVWFDQ·WLPDJLQH 0H WRR+RZ
OLIHZLWKRXWRXU-LQL GLGDQ\RQHJHW
HQDEOHGKRPHQHWZRUN E\",MXVWORYH50,
DQGDSSOLFDQFHV IRUJLYLQJXV-LQL
WHFKQRORJ\
FKDSWHU
)LOH(GLW9LHZ UHPRWHGHSOR\PHQWZLWK50,
)LOH(GLW9LHZ
)LOH(GLW9LHZ +773
+773 50, +773
([HFXWDEOH 6HUYOHWV
6HUYOHWV
-DU :HE6WDUW 50,DSS 6HUYOHWV
?PI\IJW]\;MZ^TM\['
3ERVLETSARE*AVAPROGRAMSTHATRUNONANDWITH AN(440WEBSERVER7HENACLIENTUSESA
WEBBROWSERTOINTERACTWITHAWEBPAGEAREQUESTISSENTBACKTOTHEWEBSERVER)FTHEREQUEST
NEEDSTHEHELPOFA*AVASERVLETTHEWEBSERVERRUNSORCALLSIFTHESERVLETISALREADYRUNNING
THESERVLETCODE3ERVLETCODEISSIMPLYCODETHATRUNSONTHESERVERTODOWORKASARESULTOF
WHATEVERTHECLIENTREQUESTSFOREXAMPLESAVEINFORMATIONTOATEXTlLEORDATABASEONTHE
SERVER )FYOUREFAMILIARWITH#')SCRIPTSWRITTENIN0ERLYOUKNOWEXACTLYWHATWERETALKING
ABOUT7EBDEVELOPERSUSE#')SCRIPTSORSERVLETSTODOEVERYTHINGFROMSENDINGUSER SUBMITTED
INFOTOADATABASETORUNNINGAWEB SITESDISCUSSIONBOARD
!NDEVENSERVLETSCANUSE2-)
"YFARTHEMOSTCOMMONUSEOF*%%TECHNOLOGYISTOMIXSERVLETSAND%*"STOGETHERWHERE
SERVLETSARETHECLIENTOFTHE%*"!NDINTHATCASETHESERVLETISUSING2-)TOTALKTOTHE%*"S
!LTHOUGHTHEWAYYOUUSE2-)WITH%*"ISALITTLEDIFFERENTFROMTHEPROCESSWEJUSTLOOKEDAT
&OLHQWÀOOVRXWDUHJLVWUDWLRQIRUPDQGFOLFNV¶VXEPLW·
7KH+773VHUYHULHZHEVHUYHUJHWVWKHUHTXHVWVHHVWKDW
LW·VIRUDVHUYOHWDQGVHQGVWKHUHTXHVWWRWKHVHUYOHW
:HE6HUYHU
:HE%URZVHU
FOLHQW ´FOLHQWUHTXHVWV5HJLVWHU6HUYOHWµ

;h[l

I^ml
.DWK\
6LHUUD
0\6HUYOHWFODVV
6HUYOHW-DYDFRGHUXQVDGGVGDWDWRWKHGDWDEDVH

FRPSRVHVDZHESDJHZLWKFXVWRPLQIRDQGVHQGVLWEDFNWR
WKHFOLHQWZKHUHLWGLVSOD\VLQWKHEURZVHU
:HE6HUYHU
:HE%URZVHU
FOLHQW ´FOLHQWUHTXHVWV5HJLVWHU6HUYOHWµ

MaZgdl
DZmar
Lb^kkZ
0\6HUYOHWFODVV
+70/!
´KHUH·VDFRQÀUPDWLRQSDJHµ %2'<!
-DYD
UXOHV
%2'<!
+70/!
FRQILUPKWPO
\RXDUHKHUH
YHU\VLPSOHVHUYOHW
6WHSIRUPDNLQJDQGUXQQLQJDVHUYOHW
:HE6HUYHU
)LQGRXWZKHUH\RXUVHUYOHWVQHHGWREHSODFHG
&ORTHESEEXAMPLESWELLASSUMETHATYOUALREADYHAVEAWEBSERVER
UPANDRUNNINGANDTHATITSALREADYCONlGUREDTOSUPPORTSERVLETS 6HUYOHWV

4HEMOSTIMPORTANTTHINGISTOlNDOUTEXACTLYWHEREYOURSERVLET

CLASSlLESHAVETOBEPLACEDINORDERFORYOURSERVERTO@SEETHEM)F
YOUHAVEAWEBSITEHOSTEDBYAN)30THEHOSTINGSERVICECANTELLYOU 0\6HUYOHW$FODVV

WHERETOPUTYOURSERVLETSJUSTASTHEYLLTELLYOUWHERETOPLACEYOUR
#')SCRIPTS
*HWWKHVHUYOHWVMDUDQGDGGLWWR\RXUFODVVSDWK
3ERVLETSARENTPARTOFTHESTANDARD*AVALIBRARIESYOUNEED
THESERVLETSCLASSESPACKAGEDINTOTHESERVLETSJARlLE9OUCAN
DOWNLOADTHESERVLETSCLASSESFROMJAVASUNCOMORYOUCANGET
THEMFROMYOUR*AVA ENABLEDWEBSERVERLIKE!PACHE4OMCATAT
VHUYOHWVMDU
THEAPACHEORGSITE 7ITHOUTTHESECLASSESYOUWONTBEABLETO
COMPILEYOURSERVLETS
:ULWHDVHUYOHWFODVVE\H[WHQGLQJ+WWS6HUYOHW

!SERVLETISJUSTA*AVACLASSTHATEXTENDS(TTP3ERVLETFROMTHE

JAVAXSERVLETHTTPPACKAGE 4HEREAREOTHERTYPESOFSERVLETSYOU
CANMAKEBUTMOSTOFTHETIMEWECAREONLYABOUT(TTP3ERVLET 0\6HUYOHW$FODVV
SXEOLFFODVV0\6HUYOHW$H[WHQGV+WWS6HUYOHW^`
+70/!
:ULWHDQ+70/SDJHWKDWLQYRNHV\RXUVHUYOHW %2'<!
-DYD
UXOHV
7HENTHEUSERCLICKSALINKTHATREFERENCESYOURSERVLETTHEWEB %2'<!

+70/!
SERVERWILLlNDTHESERVLETANDINVOKETHEAPPROPRIATEMETHOD 0\3DJHKWPO
DEPENDINGONTHE(440COMMAND'%40/34ETC
DKUHI ´VHUYOHWV0\6HUYOHW$´!7KLVLVWKHPRVWDPD]LQJVHUYOHWD!
:HE6HUYHU
0DNH\RXUVHUYOHWDQG+70/SDJHDYDLODEOHWR\RXUVHUYHU
4HISISCOMPLETELYDEPENDENTONYOURWEBSERVERANDMORESPECIl 6HUYOHWV
CALLYONWHICHVERSIONOF*AVA3ERVLETSTHATYOUREUSING 9OUR)30

MAYSIMPLYTELLYOUTODROPITINTOAh3ERVLETSvDIRECTORYONYOUR +70/!
%2'<!

-DYD
WEBSITE"UTIFYOUREUSINGSAYTHELATESTVERSIONOF4OMCATYOULL UXOHV
%2'<!
+70/! 0\6HUYOHW$FODVV
HAVEALOTMOREWORKTODOTOGETTHESERVLETANDWEBPAGE INTO
THERIGHTLOCATION7EJUSTHAPPENTOHAVEABOOKONTHISTOO 0\3DJHKWPO
FKDSWHU
)^MZa[QUXTM;MZ ^TM\
R HWSDFNDJHVD
RIWKHVHUYORI
UWW Z -DY
LPSRUWMDYDLR %HVLGHVLRZ HQHHGW FNDJHVDUH127SDUW WVKHHSDUDWHO\
R LP SR
KHVH W Z R SD RD G WKH P
5HPHPEHUW WRGRZQO
HV\RXKDYH
LPSRUWMDYD[VHUYOHW
LPSRUWMDYD[VHUYOHWKWWS VWDQGDUGOLEUDUL
0RVW¶QRUPDO·VHUYOHWVZLOOH[WHQG
SXEOLFFODVV0\6HUYOHW$H[WHQGV+WWS6HUYOHW^ +WWS6HUYOHWWKHQRYHUULGHRQHRU
PRUHPHWKRGV
WIRUVLPSOH PHWKRGKDQGLQJ\ RXWKHFOLHQW·V
2YHUULGHWKHGR*H VH UY HUF DOO VW KLV HVSRQVH·
+773*(7PHVVDJHV
7KHZH E DWDRXWRILWD ¶U
QG D
UHTXHVW\RXFDQX·OJOXHWVHGWRVHQGEDFNDUHVSRQVHDSDJH
REMHFWWKDW\R
SXEOLFYRLGGR*HW+WWS6HUYOHW5HTXHVWUHTXHVW+WWS6HUYOHW5HVSRQVHUHVSRQVH
WKURZV6HUYOHW([FHSWLRQ,2([FHSWLRQ^

7KLVWHOOVWKHVHUYHUDQGEURZVHUZKDWNLQGRI
UHVSRQVHVHW&RQWHQW7\SH³WH[WKWPO´ ¶WKLQJ·LVFRPLQJEDFNIURPWKHVHUYHUD VDUHXVOWRI
WKLVVHUYOHWUXQQLQJ
R
XVDQRXWSXWVWHUUHDPW

UH VSRQ VH R EMHF W JLYHV
7KH FNRXWWRWKHVHUY
3ULQW:ULWHURXW UHVSRQVHJHW:ULWHU
¶ZULWH·LQIRUPDWLRQED
6WULQJPHVVDJH ³,I\RX¶UHUHDGLQJWKLVLWZRUNHG´
LVDQ+70/SDHU JH7KHSDJH
RXWSULQWOQ³+70/!%2'<!´ :KDWZH¶ZULWH· URXJK WK HVH UY EDFNWR
RXWSULQWOQ³+!´PHVVDJH³+!´ JHWVGHOLYHUHGWK VW OL NH D Q\RWKHU 70/
+ SDJH
RXWSULQWOQ³%2'<!+70/!´ HEU RZ VH UMX H[ LVWHG
RXWFORVH
WK
HYHQWKRXJKWKLV LVDSDJHWKDWQHQYHRUKWPOILOH
UZRUGVWKHU H·V
`
XQWLOQRZ,QRWKH W KLVVWXIILQLW
`
VRPHZKHU H ZL WK
RNVOLNH
:KDWWKHZHESDJHOR
0<54XIOM_Q\PITQVS\W\PQ[[MZ ^TM\ FOLFNWKHOLQN 7KLVDQDPD]LQJVHUYOHW

WRWULJJHUWKH
VHUYOHW
+70/!
%2'<!
DKUHI ´VHUYOHWV0\6HUYOHW$´!7KLVLVDQDPD]LQJVHUYOHWD!
%2'<!
+70/!
\RXDUHKHUH
VHUYOHWVDQG-63
WKHUH DUH QR
'XPE 4XHVWLRQV
:MDD=LHGAFLK
Q: 7HATSA*30ANDHOWDOESITRELATETOSERVLETS
6HUYOHWVDUH-DYDFODVVHVWKDWUXQHQWLUHO\RQ
DQGRUZLWKLQDQ+773ZHEVHUYHU
6HUYOHWVDUHXVHIXOIRUUXQQLQJFRGHRQWKH
A: *30STANDSFOR*AVA3ERVER0AGES)NTHEENDTHEWEBSERVER
TURNSA*30INTOASERVLETBUTTHEDIFFERENCEBETWEENASERVLETAND
VHUYHUDVDUHVXOWRIFOLHQWLQWHUDFWLRQZLWKD A*30ISWHAT9/5THEDEVELOPER ACTUALLYCREATE7ITHASERVLET
ZHESDJH)RUH[DPSOHLIDFOLHQWVXEPLWV YOUWRITEA*AVACLASSTHATCONTAINS(4-,INTHEOUTPUTSTATEMENTS
LQIRUPDWLRQLQDZHESDJHIRUPWKHVHUYOHWFDQ IFYOURESENDINGBACKAN(4-,PAGETOTHECLIENT "UTWITHA
SURFHVVWKHLQIRUPDWLRQDGGLWWRDGDWDEDVH *30ITSTHEOPPOSITEYOUWRITEAN(4-,PAGETHATCONTAINS*AVA
DQGVHQGEDFNDFXVWRPL]HGFRQILUPDWLRQ CODE
UHVSRQVHSDJH 4HISGIVESYOUTHEABILITYTOHAVEDYNAMICWEBPAGESWHEREYOU
WRITETHEPAGEASANORMAL(4-,PAGEEXCEPTYOUEMBED*AVA
7RFRPSLOHDVHUYOHW\RXQHHGWKHVHUYOHW CODEANDOTHERTAGSTHAThTRIGGERv*AVACODEATRUNTIME THAT
SDFNDJHVZKLFKDUHLQWKHVHUYOHWVMDUILOH7KH GETSPROCESSEDATRUNTIME)NOTHERWORDSPARTOFTHEPAGEIS
VHUYOHWFODVVHVDUHQRWSDUWRIWKH-DYDVWDQGDUG CUSTOMIZEDATRUNTIMEWHENTHE*AVACODERUNS
OLEUDULHVVR\RXQHHGWRGRZQORDGWKHVHUYOHWV 4HEMAINBENEFITOF*30OVERREGULARSERVLETSISTHATITSJUSTALOT
MDUIURPMDYDVXQFRPRUJHWWKHPIURPDVHUYOHW EASIERTOWRITETHE(4-,PARTOFASERVLETASA*30PAGETHANTO
FDSDEOHZHEVHUYHU1RWHWKH6HUYOHWOLEUDU\ WRITE(4-,INTHETORTUROUSPRINTOUTSTATEMENTSINTHESERVLETS
LVLQFOXGHGZLWKWKH-DYD(QWHUSULVH(GLWLRQ RESPONSE)MAGINEAREASONABLYCOMPLEX(4-,PAGEANDNOW
-(( IMAGINEFORMATTINGITWITHINPRINTLNSTATEMENTS9IKES
7RUXQDVHUYOHW\RXPXVWKDYHDZHEVHUYHU "UTFORMANYAPPLICATIONSITISNTNECESSARYTOUSE*30SBECAUSE

THESERVLETDOESNTNEEDTOSENDADYNAMICRESPONSEORTHE
FDSDEOHRIUXQQLQJVHUYOHWVVXFKDVWKH7RPFDW
(4-,ISSIMPLEENOUGHNOTTOBESUCHABIGPAIN!NDTHEREARE
VHUYHUIURPDSDFKHRUJ STILLMANYWEBSERVERSOUTTHERETHATSUPPORTSERVLETSBUTDONOT
<RXUVHUYOHWPXVWEHSODFHGLQDORFDWLRQWKDW·V SUPPORT*30SSOYOURESTUCK
VSHFLILFWR\RXUSDUWLFXODUZHEVHUYHUVR\RX·OO !NOTHERBENEFITOF*30SISTHATYOUCANSEPARATETHEWORKBY
QHHGWRILQGWKDWRXWEHIRUH\RXWU\WRUXQ\RXU HAVINGTHE*AVADEVELOPERSWRITETHESERVLETSANDTHEWEBPAGE
VHUYOHWV,I\RXKDYHDZHEVLWHKRVWHGE\DQ,63 DEVELOPERSWRITETHE*30S4HATSTHEPROMISEDBENEFITANYWAY
WKDWVXSSRUWVVHUYOHWVWKH,63ZLOOWHOO\RXZKLFK )NREALITYTHERESSTILLA*AVALEARNINGCURVEANDATAGLEARNING
CURVE FORANYONEWRITINGA*30SOTOTHINKTHATAN(4-,WEBPAGE
GLUHFWRU\WRSODFH\RXUVHUYOHWVLQ
DESIGNERCANBANGOUT*30SISNOTREALISTIC7ELLNOTWITHOUTTOOLS
$W\SLFDOVHUYOHWH[WHQGV+WWS6HUYOHWDQG "UTTHATSTHEGOODNEWSAUTHORINGTOOLSARESTARTINGTOAPPEAR
RYHUULGHVRQHRUPRUHVHUYOHWPHWKRGVVXFKDV THATHELPWEBPAGEDESIGNERSCREATE*30SWITHOUTWRITINGTHE
CODEFROMSCRATCH
GR*HWRUGR3RVW
7KHZHEVHUYHUVWDUWVWKHVHUYOHWDQGFDOOVWKH
DSSURSULDWHPHWKRGGR*HWHWFEDVHGRQWKH
Q: )STHISALLYOUREGONNASAYABOUTSERVLETS!FTERSUCHA
HUGETHINGON2-)
FOLHQW·VUHTXHVW
7KHVHUYOHWFDQVHQGEDFNDUHVSRQVHE\JHWWLQJ
D3ULQW:ULWHURXWSXWVWUHDPIURPWKHUHVSRQVH
A: 9ES2-)ISPARTOFTHE*AVALANGUAGEANDALLTHECLASSESFOR
2-)AREINTHESTANDARDLIBRARIES3ERVLETSAND*30SARENOTPARTOF
SDUDPHWHURIWKHGR*HWPHWKRG
THE*AVALANGUAGETHEYRECONSIDEREDSTANDARDEXTENSIONS9OU
7KHVHUYOHW¶ZULWHV·RXWDQ+70/SDJHFRPSOHWH CANRUN2-)ONANYMODERN*6-BUT3ERVLETSAND*30SREQUIREA
ZLWKWDJV PROPERLYCONFIGUREDWEBSERVERWITHASERVLEThCONTAINERv4HISIS
OURWAYOFSAYINGhITSBEYONDTHESCOPEOFTHISBOOKv"UTYOUCAN
READMUCHMOREINTHELOVELY(EAD&IRST3ERVLETS*30
FKDSWHU
2][\NWZN]VTM\¼[UISM\PM8PZI[M75I\QK
_WZSI[I[MZ ^TM\ 7U\P\
QHZZHEHQDEOHG
.OWTHATWETOLDYOUTHATWEWONT SKUDVHRPDWLFDQG\RX·OO
SAYANYMOREABOUTSERVLETSWECANT EHDVOLFNWDONHUMXVWOLNH
RESISTSERVLETIZINGYESWECANVERBIFY WKHERVVRUWKRVHJX\VLQ
IT THE0HRASE / -ATICFROMCHAPTER PDUNHWLQJ
!SERVLETISSTILLJUST*AVA!ND*AVACODE
CANCALL*AVACODEFROMOTHERCLASSES
3OASERVLETISFREETOCALLAMETHODON
THE0HRASE / -ATIC!LLYOUHAVETODO
ISDROPTHE0HRASE / -ATICCLASSINTO
THESAMEDIRECTORYASYOURSERVLETAND
YOUREINBUSINESS4HE0HRASE /
-ATICCODEISONTHENEXTPAGE
LPSRUWMDYDLR
LPSRUWMDYD[VHUYOHW
LPSRUWMDYD[VHUYOHWKWWS
SXEOLFFODVV.DWK\6HUYOHWH[WHQGV+WWS6HUYOHW^
SXEOLFYRLGGR*HW+WWS6HUYOHW5HTXHVWUHTXHVW+WWS6HUYOHW5HVSRQVHUHVSRQVH
WKURZV6HUYOHW([FHSWLRQ,2([FHSWLRQ^

6WULQJWLWOH ³3KUDVH20DWLFKDVJHQHUDWHGWKHIROORZLQJSKUDVH´
UHVSRQVHVHW&RQWHQW7\SH³WH[WKWPO´
3ULQW:ULWHURXW UHVSRQVHJHW:ULWHU
F DOOPHWKRGVRQ
RXWSULQWOQ³+70/!+($'!7,7/(!´ 6HH"<RXUVHUYOHWWFKLVDQFDVHZH·UHFDOOLQJ
DQRWKH U FOD VV ,Q H
3KUDVHPHWKRG[WRSIDJWKH
RXWSULQWOQ³3KUDVH2PDWLF´
RXWSULQWOQ³7,7/(!+($'!%2'<!´ WKHVWDWLFPDNHFOD R QWK H QH
RXWSULQWOQ³+!´WLWOH³+!´ 3KUDVH20DWLF VV
RXWSULQWOQ³3!´3KUDVH20DWLFPDNH3KUDVH
RXWSULQWOQ³3!DKUHI ?´.DWK\6HUYOHW?´!PDNHDQRWKHUSKUDVHD!S!´
RXWSULQWOQ³%2'<!+70/!´

RXWFORVH
`
`
\RXDUHKHUH
3KUDVH20DWLFFRGH
8PZI[M75I\QKKWLM[MZ^TM\NZQMVLTa
4HISISASLIGHTLYDIFFERENTVERSIONFROMTHECODEINCHAPTERONE)NTHE
ORIGINALWERANTHEENTIRETHINGINAMAIN METHODANDWEHADTORERUN
THEPROGRAMEACHTIMETOGENERATEANEWPHRASEATTHECOMMAND LINE)NTHIS
VERSIONTHECODESIMPLYRETURNSA3TRINGWITHTHEPHRASE WHENYOUINVOKE
THESTATICMAKE0HRASE METHOD4HATWAYYOUCANCALLTHEMETHODFROMANY
OTHERCODEANDGETBACKA3TRINGWITHTHERANDOMLY COMPOSEDPHRASE
0LEASENOTETHATTHESELONG3TRING;=ARRAYASSIGNMENTSAREAVICTIMOFWORD
PROCESSINGHEREDONTTYPEINTHEHYPHENS*USTKEEPONTYPINGANDLETYOUR
CODEEDITORDOTHEWRAPPING!NDWHATEVERYOUDODONTHITTHERETURNKEYIN
THEMIDDLEOFA3TRINGIESOMETHINGBETWEENDOUBLEQUOTES
SXEOLFFODVV3KUDVH20DWLF^
SXEOLFVWDWLF6WULQJPDNH3KUDVH^
PDNHWKUHHVHWVRIZRUGVWRFKRRVHIURP
6WULQJ>@ZRUG/LVW2QH ^³´´PXOWL7LHU´ÍRRW´´%WR%´´ZLQZLQ´ÍURQW
HQG´³ZHEEDVHG´´SHUYDVLYH´³VPDUW´³VL[VLJPD´´FULWLFDOSDWK´³G\QDPLF´`
6WULQJ>@ZRUG/LVW7ZR ^³HPSRZHUHG´³VWLFN\´³YDOXHGDGGHG´³RULHQWHG´³FHQWULF´
³GLVWULEXWHG´³FOXVWHUHG´³EUDQGHG´´RXWVLGHWKHER[´³SRVLWLRQHG´³QHWZRUNHG´³IR
FXVHG´³OHYHUDJHG´³DOLJQHG´³WDUJHWHG´³VKDUHG´³FRRSHUDWLYH´³DFFHOHUDWHG´`
6WULQJ>@ZRUG/LVW7KUHH ^³SURFHVV´³WLSSLQJSRLQW´³VROXWLRQ´³DUFKLWHFWXUH´
³FRUHFRPSHWHQF\´³VWUDWHJ\´³PLQGVKDUH´³SRUWDO´³VSDFH´³YLVLRQ´³SDUDGLJP´³PLV
VLRQ´`
¿QGRXWKRZPDQ\ZRUGVDUHLQHDFKOLVW
LQWRQH/HQJWK ZRUG/LVW2QHOHQJWK
LQWWZR/HQJWK ZRUG/LVW7ZROHQJWK
LQWWKUHH/HQJWK ZRUG/LVW7KUHHOHQJWK
JHQHUDWHWKUHHUDQGRPQXPEHUVWRSXOOUDQGRPZRUGVIURPHDFKOLVW
LQWUDQG LQW0DWKUDQGRP RQH/HQJWK
LQWUDQG LQW0DWKUDQGRP WZR/HQJWK
LQWUDQG LQW0DWKUDQGRP WKUHH/HQJWK
QRZEXLOGDSKUDVH
6WULQJSKUDVH ZRUG/LVW2QH>UDQG@³³ZRUG/LVW7ZR>UDQG@³³
ZRUG/LVW7KUHH>UDQG@
QRZUHWXUQLW
UHWXUQ³:KDWZHQHHGLVD³SKUDVH
`
`
FKDSWHU
-V\MZXZQ[M2IÎ*MIV[":51WV[\MZWQL[
2-)ISGREATFORWRITINGANDRUNNINGREMOTESERVICES"UT
YOUWOULDNTRUNSOMETHINGLIKEAN!MAZONORE"AYON2-)
$Q(-%VHUYHUDGGVDEXQFK
ALONE&ORALARGEDEADLYSERIOUSENTERPRISEAPPLICATIONYOU RIVHUYLFHVWKDW\RXGRQ·WJHW
NEEDSOMETHINGMORE9OUNEEDSOMETHINGTHATCANHANDLE
TRANSACTIONSHEAVYCONCURRENCYISSUESLIKEAGAZILLION ZLWKVWUDLJKW50,7KLQJV
PEOPLEAREHITTINGYOURSERVERATONCETOBUYTHOSEORGANIC
DOGKIBBLES SECURITYNOTJUSTANYONESHOULDHITYOUR OLNHWUDQVDFWLRQVVHFXULW\
PAYROLLDATABASE ANDDATAMANAGEMENT&ORTHATYOUNEED
ANENTERPRISEAPPLICATIONSERVER
FRQFXUUHQF\GDWDEDVH
)N*AVATHATMEANSA*AVA%NTERPRISE%DITION*%% SERVER PDQDJHPHQWDQGQHWZRUNLQJ
!*%%SERVERINCLUDESBOTHAWEBSERVERANDAN%NTERPRISE
*AVA"EANS%*" SERVERSOTHATYOUCANDEPLOYANAPPLICATION $Q(-%VHUYHUVWHSVLQWRWKH
THATINCLUDESBOTHSERVLETSAND%*"S,IKESERVLETS%*"IS
WAYBEYONDTHESCOPEOFTHISBOOKANDTHERESNOWAYTO PLGGOHRIDQ50,FDOODQG
SHOWhJUSTALITTLEv%*"EXAMPLEWITHCODEBUTWEWILLTAKE
AQUICKLOOKATHOWITWORKS&ORAMUCHMOREDETAILED OD\HUVLQDOORIWKHVHUYLFHV
TREATMENTOF%*"WECANRECOMMENDTHELIVELY(EAD&IRST
%*"CERTIlCATIONSTUDYGUIDE
HFWHGIURP
7KHEHDQREMHFWFHLVVVSU2RWQO\WKHVHUYHU
GLUHFWFOLHQWDF WRWKHEHDQ7KLV
FDQDFWXDOO\WDONRWKLQJVOLNHVD\
+HUH·VZKHUHWKH(-%VHUYHU OHWVWKHVHUYHUGWGRHVQ·WKDYH
LQYROYHG7KH(-%REMHFWL JHWV ´:KRD7KLVFOLHQ UDQFHWRFDOOWKLV
WKHFDOOVWRWKHEHDQWKHE HSWV WKHV
QW HUF HFXULW\FOHD J\RXSD\
W FR XOGE H $1 <7 +, 1* E XW
WK HU HDQ KR OGV PH WK RGµ$OPRVWHYHUK\WDSKLQ
SH QV ULJKW
7K LV FOL HQ LVD VH UY OHW HDOEX VLQHVVORJLFDQGOD\HUVLQ IR U LQ DQ (-%VH UY HU
W\SLFDOO\DQ ( -% F OLHQW DOO WKHVHUYLFHVSURYLGHGE\W VW HSVL Q
LQJ LQ W KHVD PH - ( (VHUYHU VHU YHUV HFX KH(-% +(5(ZKHUHWKHVHUYHU
UXQQ ULW\WUDQVDFWLRQVHWF
(-%VHUYHU
&OLHQW
50,6.(/(721
50,678%
6H H
U
UYLFHKHOS

DQ
& OL HQ
HQWKHOSHU (-% W WHUS HEH
& OL REMHF UL V
HQWREMHFW
'%
7KLVLVRQO\DVPDOOSDUWRIWKH(-%SLFWXUH
\RXDUHKHUH
DOLWWOH-LQL
.WZW]ZNQVIT\ZQKSITQ\\TM2QVQ
7ELOVE*INI7ETHINK*INIISPRETTYMUCHTHEBESTTHINGIN*AVA)F%*"IS2-)
ONSTEROIDSWITHABUNCHOFMANAGERS *INIIS2-)WITHWINGS0URE*AVABLISS
,IKETHE%*"MATERIALWECANTGETINTOANYOFTHE*INIDETAILSHEREBUTIFYOU
KNOW2-)YOURETHREE QUARTERSOFTHEWAYTHERE)NTERMSOFTECHNOLOGY
ANYWAY)NTERMSOFMINDSETITSTIMETOMAKEABIGLEAP.OITSTIMETOmY
*INIUSES2-)ALTHOUGHOTHERPROTOCOLSCANBEINVOLVED BUTGIVESYOUAFEW
KEYFEATURESINCLUDING
!DAPTIVEDISCOVERY
3ELF HEALINGNETWORKS
7ITH2-)REMEMBERTHECLIENTHASTOKNOWTHE
NAMEANDLOCATIONOFTHEREMOTESERVICE4HE
CLIENTCODEFORTHELOOKUPINCLUDESTHE)0ADDRESSOR
HOSTNAMEOFTHEREMOTESERVICEBECAUSETHATSWHERE
THE2-)REGISTRYISRUNNING ANDTHELOGICALNAMETHE
SERVICEWASREGISTEREDUNDER
"UTWITH*INITHECLIENTHASTOKNOWONLYONETHINGTHE
INTERFACEIMPLEMENTEDBYTHESERVICE4HATSIT
3OHOWDOYOUlNDTHINGS4HETRICKREVOLVESAROUND*INILOOKUP
SERVICES*INILOOKUPSERVICESAREFARMOREPOWERFULANDmEXIBLETHAN
THE2-)REGISTRY&ORONETHING*INILOOKUPSERVICESANNOUNCETHEMSELVESTOTHE
NETWORKAUTOMATICALLY7HENALOOKUPSERVICECOMESONLINEITSENDSAMESSAGEUSING)0
MULTICAST OUTTOTHENETWORKSAYINGh)MHEREIFANYONESINTERESTEDv
"UTTHATSNOTALL,ETSSAYYOUACLIENT COMEONLINEAFTERTHELOOKUPSERVICEHASALREADY
ANNOUNCEDITSELFYOUCANSENDAMESSAGETOTHEENTIRENETWORKSAYINGh!RETHEREANY
LOOKUPSERVICESOUTTHEREv
%XCEPTTHATYOURENOTREALLYINTERESTEDINTHELOOKUPSERVICEITSELFYOUREINTERESTEDIN
THESERVICESTHATAREREGISTEREDWITHTHELOOKUPSERVICE4HINGSLIKE2-)REMOTESERVICES
OTHERSERIALIZABLE*AVAOBJECTSANDEVENDEVICESSUCHASPRINTERSCAMERASANDCOFFEE
MAKERS
!NDHERESWHEREITGETSEVENMOREFUNWHENASERVICECOMESONLINEITWILLDYNAMICALLY
DISCOVERANDREGISTERITSELFWITH ANY*INILOOKUPSERVICESONTHENETWORK7HENTHE
SERVICEREGISTERSWITHTHELOOKUPSERVICETHESERVICESENDSASERIALIZEDOBJECTTOBEPLACED
INTHELOOKUPSERVICE4HATSERIALIZEDOBJECTCANBEASTUBTOAN2-)REMOTESERVICEA
DRIVERFORANETWORKEDDEVICEOREVENTHEWHOLESERVICEITSELFTHATONCEYOUGETITFROM
THELOOKUPSERVICE RUNSLOCALLYONYOURMACHINE!NDINSTEADOFREGISTERINGBYNAMETHE
SERVICEREGISTERSBYTHEINTERFACEITIMPLEMENTS
/NCEYOUTHECLIENT HAVEAREFERENCETOALOOKUPSERVICEYOUCANSAYTOTHATLOOKUP
SERVICEh(EYDOYOUHAVEANYTHINGTHATIMPLEMENTS3CIENTIlC#ALCULATORv!TTHATPOINT
THELOOKUPSERVICEWILLCHECKITSLISTOFREGISTEREDINTERFACESANDASSUMINGITlNDSA
MATCHSAYSBACKTOYOUh9ES)DOHAVESOMETHINGTHATIMPLEMENTSTHATINTERFACE(ERES
THESERIALIZEDOBJECTTHE3CIENTIlC#ALCULATORSERVICEREGISTEREDWITHMEv
FKDSWHU
)LIX\Q^MLQ[KW^MZaQVIK\QWV
-LQLORRNXSVHUYLFHLVODXQFKHGVRPHZKHUHRQWKHQHWZRUNDQG
DQQRXQFHVLWVHOIXVLQJ,3PXOWLFDVW
+H\HYHU\ERG\
,·PKHUH
DQRWKHUPDFKLQHRQWKHQHWZRUN
Licensed by
-LQL/RRNXS6HUYLFH
Eduard Simons
PDFKLQHRQWKHQHWZRUN
VRPHZKHUH

104038
$QDOUHDG\UXQQLQJ-LQLVHUYLFHRQ
5HJLVWHU
PHDVVRPHWKLQJ
WKDWLPSOHPHQWV
6FLHQWLÀF&DOFXODWRU+HUH·VD
DQRWKHUPDFKLQHDVNVWREHUHJLVWHUHG VHULDOL]HGREMHFWWKDWUHSUHVHQWV
ZLWKWKLVQHZO\DQQRXQFHGORRNXS P\VHUYLFH6HQGLWWR
VHUYLFH,WUHJLVWHUVE\FDSDELOLW\ DQ\ERG\ZKRDVNV
UDWKHUWKDQE\QDPH,QRWKHUZRUGV
LWUHJLVWHUVDVWKHVHUYLFHLQWHUIDFHLW
LPSOHPHQWV,WVHQGVDVHULDOL]HGREMHFW
WREHSODFHGLQWKHORRNXSVHUYLFH -LQL6HUYLFH
-LQL/RRNXS6HUYLFH
PDFKLQHRQWKHQHWZRUN
VRPHZKHUH
\RXDUHKHUH
DGDSWLYHGLVFRYHU\LQ-LQL
)LIX\Q^MLQ[KW^MZaQVIK\QWVKWV\QV]ML
$FOLHQWRQWKHQHWZRUNZDQWV
VRPHWKLQJWKDWLPSOHPHQWVWKH
6FLHQWLÀF&DOFXODWRULQWHUIDFH,WKDV
QRLGHDZKHUHRULIWKDWWKLQJH[LVWV
VRLWDVNVWKHORRNXSVHUYLFH
DQRWKHUPDFKLQH
-LQL6HUYLFH
RQWKHQHWZRUN
'R\RX
-LQL/RRNXS6HUYLFH KDYHDQ\WKLQJ
WKDWLPSOHPHQWV
6FLHQWLÀF&DOFXODWRU"
-DYDDSS
PDFKLQHRQWKHQHWZRUN
VRPHZKHUH
7KHORRNXSVHUYLFHUHVSRQGVVLQFHLWGRHVKDYHVRPHWKLQJ
UHJLVWHUHGDVD6FLHQWLÀF&DOFXODWRULQWHUIDFH
<HV,GR
KDYHVRPHWKLQJ
,·PVHQGLQJ\RXWKH
VHULDOL]HGREMHFW -LQL6HUYLFH
QRZ
-LQL/RRNXS6HUYLFH
-DYDDSS
PDFKLQHRQWKHQHWZRUN
VRPHZKHUH
FKDSWHU
;MTNPMITQVOVM\ _WZSQVIK\QWV
$-LQL6HUYLFHKDVDVNHGWRUHJLVWHUZLWKWKHORRNXSVHUYLFH7KHORRNXS
VHUYLFHUHVSRQGVZLWKDÓHDVHµ7KHQHZO\UHJLVWHUHGVHUYLFHPXVWNHHS
UHQHZLQJWKHOHDVHRUWKHORRNXSVHUYLFHDVVXPHVWKHVHUYLFHKDVJRQH
RIÁLQH7KHORRNXSVHUYLFHZDQWVDOZD\VWRSUHVHQWDQDFFXUDWHSLFWXUH
WRWKHUHVWRIWKHQHWZRUNDERXWZKLFKVHUYLFHVDUHDYDLODEOH
,·OO
UHJLVWHU\RX
DQGKHUH·V\RXU DQRWKHUPDFKLQH
OHDVH,I\RXGRQ·W -LQL6HUYLFH
RQWKHQHWZRUN
UHQHZLW,·OOGURS\RX
OHDVH
-LQL/RRNXS6HUYLFH
PDFKLQHRQWKHQHWZRUN
VRPHZKHUH
7KHVHUYLFHJRHVRIIOLQHVRPHERG\VKXWVLWGRZQVRLWIDLOVWR

UHQHZLWVOHDVHZLWKWKHORRNXSVHUYLFH7KHORRNXSVHUYLFHGURSVLW
+PPPP,
GLGQ·WJHWDOHDVH
UHQHZDOIURPWKDWRQHLW
PXVWEHGRZQ,·OOGURSLW,ILW
FRPHVEDFNLWZLOODXWRPDWLFDOO\
UHGLVFRYHUPH
-LQL/RRNXS6HUYLFH
PDFKLQHRQWKHQHWZRUN
VRPHZKHUH
\RXDUHKHUH
XQLYHUVDOVHUYLFHSURMHFW
.QVIT8ZWRMK\"\PM=VQ^MZ[IT;MZ^QKMJZW_[MZ
7EREGOINGTOMAKESOMETHINGTHATISNT*INI ENABLEDBUTQUITEEASILYCOULDBE
)TWILLGIVEYOUTHEmAVORANDFEELINGOF*INIBUTUSINGSTRAIGHT2-))NFACTTHE
MAINDIFFERENCEBETWEENOURAPPLICATIONANDA*INIAPPLICATIONISHOWTHESERVICEIS
DISCOVERED)NSTEADOFTHE*INILOOKUPSERVICEWHICHAUTOMATICALLYANNOUNCESITSELFAND
LIVESANYWHEREONTHENETWORKWEREUSINGTHE2-)REGISTRYWHICHMUSTBEONTHESAME
MACHINEASTHEREMOTESERVICEANDWHICHDOESNOTANNOUNCEITSELFAUTOMATICALLY
!NDINSTEADOFOURSERVICEREGISTERINGITSELFAUTOMATICALLYWITHTHELOOKUPSERVICEWE
HAVETOREGISTERITINTHE2-)REGISTRYUSING.AMINGREBIND
"UTONCETHECLIENTHASFOUNDTHESERVICEINTHE2-)REGISTRYTHERESTOFTHEAPPLICATION
ISALMOSTIDENTICALTOTHEWAYWEDDOITIN*INI4HEMAINTHINGMISSINGISTHELEASETHAT
WOULDLETUSHAVEASELF HEALINGNETWORKIFANYOFTHESERVICESGODOWN
4HEUNIVERSALSERVICEBROWSERISLIKEASPECIALIZEDWEBBROWSEREXCEPTINSTEADOF(4-,
PAGESTHESERVICEBROWSERDOWNLOADSANDDISPLAYSINTERACTIVE*AVA'5)STHATWERE
CALLINGUNIVERSALSERVICES
&KRRVHDVHUYLFHIURPWKH
OLVW7KH50,UHPRWHVHUYLFH
KDVDJHW6HUYLFH/LVW
PHWKRGWKDWVHQGVEDFNWKLV
OLVWRIVHUYLFHV
:KHQWKHXVHUVHOHFWVRQH
WKHFOLHQWDVNVIRUWKH
DFWXDOVHUYLFH'LFH5ROOLQJ
'D\2I7KH:HHNHWFWR
EHVHQWEDFNIURPWKH50,
UHPRWHVHUYLFH
VHUYLFH
:KHQ\VKRXVHOHFWKHDUH
XS
LWZLOO RZ
FKDSWHU
+RZLWZRUNV
&OLHQWVWDUWVXSDQG 6HUYHU
6HUYLFH%URZVHU
GRHVDORRNXSRQWKH FOLHQW
50,UHJLVWU\IRU
U
WKHVHUYLFHFDOOHG
UYH
´3O
´6HUYLFH6HUYHUµDQG ´6 HDVH
6H
HUY JLY H
JHWVEDFNWKHVWXE LFH HP
6H 6HUYLF
UYH HWKH
Uµ WK
LQJ
QD
PH
G
50,UHJLVWU\RQVHUYHU
´2 6HUYLFH
. 6HUYHU
KH
UH·
VW
KH
VW
XE
µ
6WXE
&OLHQWFDOOVJHW6HUYLFH/LVWRQWKHVWXE7KH6HUYLFH6HUYHU
UHWXUQVDQDUUD\RIVHUYLFHV
6HUYHU
6HUYLFH%URZVHU
FOLHQW ´JHW6HUYLFH/LVWµ
U
UYH
6H
H
6HUYLF
´2.KHUH·VDQDUUD\RIVHUYLFHVµ
&OLHQWGLVSOD\VWKHOLVWRIVHUYLFHVLQD*8,
6HUYHU
6HUYLFH%URZVHU
FOLHQW
U
UYH
6H
H
6HUYLF
\RXDUHKHUH
XQLYHUVDOVHUYLFHEURZVHU
+RZLWZRUNVFRQWLQXHG
8VHUVHOHFWVIURPWKHOLVWVRFOLHQWFDOOVWKHJHW6HUYLFH
PHWKRGRQWKHUHPRWHVHUYLFH7KHUHPRWHVHUYLFHUHWXUQVD
VHULDOL]HGREMHFWWKDWLVDQDFWXDOVHUYLFHWKDWZLOOUXQLQVLGH
WKHFOLHQWEURZVHU
6HUYHU
6HUYLFH%URZVHU ´JHW6HUYLFHVHOHFWHG6YFµ
FOLHQW
U
UYH
6H
H
6HUYLF
´2.KHUH·VWKHVHUYLFHµ
&OLHQWFDOOVWKHJHW*XL3DQHORQWKHVHULDOL]HGVHUYLFHREMHFWLW
MXVWJRWIURPWKHUHPRWHVHUYLFH7KH*8,IRUWKDWVHUYLFHLV
GLVSOD\HGLQVLGHWKHEURZVHUDQGWKHXVHUFDQLQWHUDFWZLWKLW
ORFDOO\$WWKLVSRLQWZHGRQ·WQHHGWKHUHPRWHVHUYLFHXQOHVVXQWLO
WKHXVHUGHFLGHVWRVHOHFWDQRWKHUVHUYLFH
6HUYLFH%URZVHU
FOLHQW
FKDSWHU
7KHFODVVHVDQGLQWHUIDFHV
LQWHUIDFH6HUYLFH6HUYHULPSOHPHQWV5HPRWH 6HUYLFH6HUYHU
$UHJXODUROG50,UHPRWHLQWHUIDFHIRUWKHUHPRWHVHUYLFHWKH JHW6HUYLFHV/LVW
UHPRWHVHUYLFHKDVWKHPHWKRGIRUJHWWLQJWKHVHUYLFHOLVWDQG JHW6HUYLFH
UHWXUQLQJDVHOHFWHGVHUYLFH
FODVV6HUYLFH6HUYHU,PSOLPSOHPHQWV6HUYLFH6HUYHU
7KHDFWXDO50,UHPRWHVHUYLFHH[WHQGV8QLFDVW5HPRWH2EMHFW 6HUYLFH6HUYHU,PSO
,WVMRELVWRLQVWDQWLDWHDQGVWRUHDOOWKHVHUYLFHVWKHWKLQJV JHW6HUYLFHV/LVW
WKDWZLOOEHVKLSSHGWRWKHFOLHQWDQGUHJLVWHUWKHVHUYHULWVHOI JHW6HUYLFH
6HUYLFH6HUYHU,PSOZLWKWKH50,UHJLVWU\
FODVV6HUYLFH%URZVHU
7KHFOLHQW,WEXLOGVDYHU\VLPSOH*8,GRHVDORRNXSLQWKH50, 6HUYLFH%URZVHU
UHJLVWU\WRJHWWKH6HUYLFH6HUYHUVWXEWKHQFDOOVDUHPRWHPHWKRGRQ PDLQ
LWWRJHWWKHOLVWRIVHUYLFHVWRGLVSOD\LQWKH*8,OLVW
LQWHUIDFH6HUYLFH
7KLVLVWKHNH\WRHYHU\WKLQJ7KLVYHU\VLPSOHLQWHUIDFHKDVMXVWRQH
PHWKRGJHW*XL3DQHO(YHU\VHUYLFHWKDWJHWVVKLSSHGRYHUWRWKH
FOLHQWPXVWLPSOHPHQWWKLVLQWHUIDFH7KLVLVZKDWPDNHVWKHZKROHWKLQJ
81,9(56$/%\LPSOHPHQWLQJWKLVLQWHUIDFHDVHUYLFHFDQFRPHRYHU
HYHQWKRXJKWKHFOLHQWKDVQRLGHDZKDWWKHDFWXDOFODVVRUFODVVHV 6HUYLFH
DUHWKDWPDNHXSWKDWVHUYLFH$OOWKHFOLHQWNQRZVLVWKDWZKDWHYHU
FRPHVRYHULWLPSOHPHQWVWKH6HUYLFHLQWHUIDFHVRLW0867KDYHD JHW*XL3DQHO
JHW*XL3DQHOPHWKRG
7KHFOLHQWJHWVDVHULDOL]HGREMHFWDVDUHVXOWRIFDOOLQJ
JHW6HUYLFHVHOHFWHG6YFRQWKH6HUYLFH6HUYHUVWXEDQGDOOWKHFOLHQW
VD\VWRWKDWREMHFWLV´,GRQ·WNQRZZKRRUZKDW\RXDUHEXW,'2
NQRZWKDW\RXLPSOHPHQWWKH6HUYLFHLQWHUIDFHVR,NQRZ,FDQFDOO
JHW*XL3DQHORQ\RX$QGVLQFHJHW*XL3DQHOUHWXUQVD-3DQHO,·OOMXVW
VODSLWLQWRWKHEURZVHU*8,DQGVWDUWLQWHUDFWLQJZLWKLW
'LFH6HUYLFH
FODVV'LFH6HUYLFHLPSOHPHQWV6HUYLFH
*RWGLFH",IQRWEXW\RXQHHGVRPHXVHWKLVVHUYLFHWRUROODQ\ZKHUH JHW*XL3DQHO
IURPWRYLUWXDOGLFHIRU\RX
FODVV0LQL0XVLF6HUYLFHLPSOHPHQWV6HUYLFH
5HPHPEHUWKDWIDEXORXVOLWWOH¶PXVLFYLGHR·SURJUDPIURPWKHÀUVW 0LQL0XVLF6HUYLFH
*8,&RGH.LWFKHQ":H·YHWXUQHGLWLQWRDVHUYLFHDQG\RXFDQSOD\LW JHW*XL3DQHO
RYHUDQGRYHUDQGRYHUXQWLO\RXUURRPPDWHVÀQDOO\OHDYH 'D\2I7KH:HHN6HUYLFH
JHW*XL3DQHO
FODVV'D\2I7KH:HHN6HUYLFHLPSOHPHQWV6HUYLFH
:HUH\RXERUQRQD)ULGD\"7\SHLQ\RXUELUWKGD\DQGÀQGRXW
\RXDUHKHUH
XQLYHUVDOVHUYLFHFRGH
LQWHUIDFH6HUYLFH6HUYHUWKHUHPRWHLQWHUIDFH
IDFH
LPSRUWMDYDUPL
P D O 5 0, U HPRWHLQWVHWUKH
$QRU WKHWZRPHWKRG
SXEOLFLQWHUIDFH6HUYLFH6HUYHUH[WHQGV5HPRWH^
GHILQHV HUYLFHZLOOKDYH
2EMHFW>@JHW6HUYLFH/LVWWKURZV5HPRWH([FHSWLRQ UHPRWHV
6HUYLFHJHW6HUYLFH2EMHFWVHUYLFH.H\WKURZV5HPRWH([FHSWLRQ
`
LQWHUIDFH6HUYLFHZKDWWKH*8,VHUYLFHVLPSOHPHQW
$SODLQROGLHQRQ
LPSRUWMDYD[VZLQJ GHILQHVWKHRQ UHPRWHLQWHUIDF
HW
LPSRUWMDYDLR VHUYLFHPXVWKDYH³ KRGWKDWDQ\XQLYHUVDOKD W
H PHW
JH
LQWHUIDFHH[ V W*XL3DQHO7KH
SXEOLFLQWHUIDFH6HUYLFHH[WHQGV6HULDOL]DEOH^ FODVVLPSOHPHQWHWLQG 6HULDOL]DEOHVRWK
DWD
SXEOLF-3DQHOJHW*XL3DQHO DXWRPDWLFDOO\EHQJ6HWKH6HUYLFHLQWHUIDFHZLQ\OO
` ULDOL]DEOH
7KDW·VDPXVWEHF
VKLSSHGRYHUWKHZDXVHWKHVHUYLFHVJHW
UHVXOWRIWKH LUHIURPWKHVHUYH
UDV
WKHUHPRWH6HUYLF FDOOLQJJHW6HUYLFHRQD
FO LHQW
H6HUYHU
FKDSWHU
FODVV6HUYLFH6HUYHU,PSOWKHUHPRWHLPSOHPHQWDWLRQ
LPSRUWMDYDUPL
LPSRUWMDYDXWLO
LRQ
LPSRUWMDYDUPLVHUYHU
0, LPSOHPHQWDW
$QRUPDO5
SXEOLFFODVV6HUYLFH6HUYHU,PSOH[WHQGV8QLFDVW5HPRWH2EMHFWLPSOHPHQWV6HUYLFH6HUYHU^
+DVK0DSVHUYLFH/LVW 7KHVHUYLFHVZLOOEHVW
REMHFWLQWKHFROOHFWLRRUHGLQD+DVK0DSFROOHFWLRQ,QVWHDG
YDOXHREMHFWZKDWHYH Q\RXSXW7:2DNH\REMHFWOL RISXWWLQJ21(
U\RXZDQWVHHDSSH NH
QGL[%IRUPRUHDRQ6+WULQJDQGD
DVK0DS
SXEOLF6HUYLFH6HUYHU,PSOWKURZV5HPRWH([FHSWLRQ^
VHW8S6HUYLFHV
` KHDFWXDO
LQLWLDOL]HWHU
OO HG F
WUXFW RU L V FD XVLF YLFHHW
6
SULYDWHYRLGVHW8S6HUYLFHV^ :KHQWKHVHFRUYQVLFHV'LFH6HUYLFH0LQL0
VHUYLFH/LVW QHZ+DVK0DS XQLYHUVDO
VHUYLFH/LVWSXW³'LFH5ROOLQJ6HUYLFH´QHZ'LFH6HUYLFH
VHUYLFH/LVWSXW³'D\RIWKH:HHN6HUYLFH´QHZ'D\2I7KH:HHN6HUYLFH
VHUYLFH/LVWSXW³9LVXDO0XVLF6HUYLFH´QHZ0LQL0XVLF6HUYLFH
OVHUYLFH
` HVWKHDFWXD UYLF
0DNHWKHVH QG S XWWKHPLQW RWKH

RE MH FW V D
ZLW K D 6 W ULQJQ HIRU
DP
+DVK0DS
WKH¶NH\·
SXEOLF2EMHFW>@JHW6HUYLFH/LVW^ &OLHQWFDOOVWKLVLQ
6\VWHPRXWSULQWOQ³LQUHPRWH´ GLVSOD\LQWKHEURZVRHUUGHUWRJHWDOLVWRIVHUYLFHVWR
UHWXUQVHUYLFH/LVWNH\6HWWR$UUD\ VHQGDQDUUD\RIW\SHVRWKHXVHUFDQVHOHFWRQH:H

LQVLGHE\PDNLQJDQD 2EMHFWHYHQWKRXJKLWKDV6WULQJV
LQWKH+DVK0DS:HZRUUD\RIMXVWWKH.(<6WKDWDUH
`
XQOHVVWKHFOLHQWDVNVI Q·WVHQGDQDFWXDO6HUYLFHREMHFW
RULWE\FDOOLQJJHW6HU
YLFH

SXEOLF6HUYLFHJHW6HUYLFH2EMHFWVHUYLFH.H\WKURZV5HPRWH([FHSWLRQ^
6HUYLFHWKH6HUYLFH 6HUYLFHVHUYLFH/LVWJHWVHUYLFH.H\
UHWXUQWKH6HUYLFH H VDVHUYLFHKH
XVHUVHOHFWRW
RG D I W HU WK J IURPW
` KLVPHWK VWKDWLW
&OLHQWFDOOVGWLVSOD\HGOLVWRIVHUYLFHKHNH\WKHVDPHNH\
IURPWKHERYH7KLVFRGHXVHVW JHWWKHFRUUHVSRQGLQJ
PHWKRGD HQWWRWKHFOLHQWWR
RULJLQDOO\VWRIWKH+DVK0DS
VHUYLFHRX
WU\^
1DPLQJUHELQG³6HUYLFH6HUYHU´QHZ6HUYLFH6HUYHU,PSO
`FDWFK([FHSWLRQH[^
H[SULQW6WDFN7UDFH
`
6\VWHPRXWSULQWOQ³5HPRWHVHUYLFHLVUXQQLQJ´
`
`
\RXDUHKHUH
6HUYLFH%URZVHUFRGH
FODVV6HUYLFH%URZVHUWKHFOLHQW
LPSRUWMDYDDZW
LPSRUWMDYD[VZLQJ
LPSRUWMDYDUPL
LPSRUWMDYDDZWHYHQW
SXEOLFFODVV6HUYLFH%URZVHU^
-3DQHOPDLQ3DQHO
-&RPER%R[VHUYLFH/LVW
6HUYLFH6HUYHUVHUYHU
SXEOLFYRLGEXLOG*8,^
-)UDPHIUDPH QHZ-)UDPH³50,%URZVHU´
PDLQ3DQHO QHZ-3DQHO
NXS

G G RH V WK H 5 0,UHJLVWU\/ORR
LV W
2EMHFW>@VHUYLFHV JHW6HUYLFHV/LVW WKLVPHWKRWXEDQGFDOOVJHW6HUYLFH SDJH
W KH V Q H[ W
JHWV KRGLVRQWKH
7KHDFWXDOPHW
RWKH
DUUD\RI2EMHFWV[ W
$GGWKHVHUYLFHVOLDVWQ 7K H -& RP ER %R NQRZVKRZWR
VHUYLFH/LVW QHZ-&RPER%R[VHUYLFHV [ W KH HDUUD\
-&RP ER %R RXWRIHDFKWKLQJLQWK
PDNHGLVSOD\DEOH6WULQJV
IUDPHJHW&RQWHQW3DQHDGG%RUGHU/D\RXW1257+VHUYLFH/LVW
VHUYLFH/LVWDGG$FWLRQ/LVWHQHUQHZ0\/LVW/LVWHQHU
IUDPHVHW6L]H
IUDPHVHW9LVLEOHWUXH
`
YRLGORDG6HUYLFH2EMHFWVHUYLFH6HOHFWLRQ^
WU\^
6HUYLFHVYF VHUYHUJHW6HUYLFHVHUYLFH6HOHFWLRQ

+HUH·VZKHUHZHDGGWKH
UKDVVHOHFWHGRQH7DF WXDOVHUYLFHWRWKH*8,D
PDLQ3DQHOUHPRYH$OO
XVH
PDLQ3DQHODGGVYFJHW*XL3DQHO
OLVWHQHURQWKH-&RPER% KLV P HWKRGLVFDOOHGE\WKHHYIWHUWKH
HQW
UHPRWHVHUYHUWKHVWXEIR[:HFDOOJHW6HUYLFHRQWKH
PDLQ3DQHOYDOLGDWH
PDLQ3DQHOUHSDLQW RU
6WULQJWKDWZDVGLVS 6HUYLFH6HUYHUDQGSDVV
`FDWFK([FHSWLRQH[^ LWWKH
H[SULQW6WDFN7UDFH 6WULQJZHRULJLQDOO\JROD\WHGLQWKHOLVWZKLFKLVWKH6$0(
` JHW6HUYLFH/LVW7KHVHIURPWKHVHUYHUZKHQZHFDOOHG
` VHULDOL]HG UYHUUHWXUQVWKHDFWXDO
VHUYLF
ZKLFKLVDXWRPDWLFDOO\G H
DQGZHVLPSO\FDOOWKHJH HVHULDOL]HGWKDQNVWR50
,
WKHUHVXOWD-3DQHOWRWW*XL3DQHORQWKHVHUYLFHDQGDGG
KHEURZVHU·VPDLQ3DQHO
FKDSWHU
2EMHFW>@JHW6HUYLFHV/LVW^
2EMHFWREM QXOO
2EMHFW>@VHUYLFHV QXOO
KHV WXE
RNXSDQGJHWW
WU\^ 'RWKH50,OR

REM 1DPLQJORRNXS³UPL6HUYLFH6HUYHU´
Licensed by

`
FDWFK([FHSWLRQH[^
H[SULQW6WDFN7UDFH
`
&DVWWKHVWXE
Eduard Simons
VHUYHU 6HUYLFH6HUYHUREM
VRWKDWZHFDQWFRDOWKHUHPRWHLQWHUIDFHW\SH
OJHW6HUYLFH/LVW
RQLW
WU\^

VHUYLFHV VHUYHUJHW6HUYLFH/LVW
104038

`FDWFK([FHSWLRQH[^
H[SULQW6WDFN7UDFH JHW6HUYLFH/LVWJLYHVXVWKHDUUD\RI2EMHFWV
` WKDWZHGLVSOD\LQWKH-&RPER%R[IRUWKHXVHUWR
UHWXUQVHUYLFHV VHOHFWIURP

`
FODVV0\/LVW/LVWHQHULPSOHPHQWV$FWLRQ/LVWHQHU^

2EMHFWVHOHFWLRQ VHUYLFH/LVWJHW6HOHFWHG,WHP
ORDG6HUYLFHVHOHFWLRQ KHXVHUPDG HD
H L W P HD QVW W 6R
` ,IZH·UHKIHUURPWKH-&RPER%R[OLVGORDGWKH
VHOHFWLR Q H\PDGH DQ
YLFHPHWKRG
`
LRQWK
WDNHWKHVHHOHVHFWUYLFHVHHWKHORDGW6KHU
HVHUYHUIWRULRQ
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ DSSURSULDWHYLRXVSDJHWKDWDVNV KW KLVVHOHF
QHZ6HUYLFH%URZVHUEXLOG*8, RQWKHSU HWKDWFRUUHVSRQGVZLW
` WKHVHUY LF
`

\RXDUHKHUH
'LFH6HUYLFHFRGH
FODVV'LFH6HUYLFHDXQLYHUVDOVHUYLFHLPSOHPHQWV6HUYLFH
LPSRUWMDYD[VZLQJ
LPSRUWMDYDDZWHYHQW
LPSRUWMDYDLR
SXEOLFFODVV'LFH6HUYLFHLPSOHPHQWV6HUYLFH^
-/DEHOODEHO
-&RPER%R[QXP2I'LFH
SXEOLF-3DQHOJHW*XL3DQHO^
-%XWWRQEXWWRQ QHZ-%XWWRQ³5ROOµHP´
6WULQJ>@FKRLFHV ^³´³´³´³´³´`
QXP2I'LFH QHZ-&RPER%R[FKRLFHV
ODEHO QHZ-/DEHO³GLFHYDOXHVKHUH´
EXWWRQDGG$FWLRQ/LVWHQHUQHZ5ROO(P/LVWHQHU
SDQHODGGQXP2I'LFH +HUH·VWKHRQHLPSRUW PHWK
SDQHODGGEXWWRQ 6HUYLFHLQWHUIDFHWDQW RG7KHPHWKR IWKH
RQHWKHFOLHQW·VJRQQDGR
SDQHODGGODEHO WKLVVHUYLFHLVVHOHFWHGKH
DQGORDGHG<RXFDQGRZK FDOOZKHQ
UHWXUQSDQHO ZD
`
QW LQ WKH JH W*XL3DQHOPHWKRGDVORQJD DWHYHU\RX
V\RX
-3DQHOVRLWEXLOGVWKHDFWXDO
GLFHUROOLQJ*8, UHWXUQD
SXEOLFFODVV5ROO(P/LVWHQHULPSOHPHQWV$FWLRQ/LVWHQHU^
UROOWKHGLFH
6WULQJGLFH2XWSXW ³´
6WULQJVHOHFWLRQ 6WULQJQXP2I'LFHJHW6HOHFWHG,WHP
LQWQXP2I'LFH7R5ROO ,QWHJHUSDUVH,QWVHOHFWLRQ
IRULQWL LQXP2I'LFH7R5ROOL^
LQWU LQW0DWKUDQGRP
GLFH2XWSXW ³³U
`
ODEHOVHW7H[WGLFH2XWSXW

`
`
6KDUSHQ \RXU SHQFLO

4HINKABOUTWAYSTOIMPROVETHE$ICE3ERVICE/NE
SUGGESTIONUSINGWHATYOULEARNEDINTHE'5)CHAPTERS
MAKETHEDICEGRAPHICAL5SEARECTANGLEANDDRAWTHE
APPROPRIATENUMBEROFCIRCLESONEACHONECORRESPONDING
TOTHEROLLFORTHATPARTICULARDIE
FKDSWHU
FODVV0LQL0XVLF6HUYLFHDXQLYHUVDOVHUYLFHLPSOHPHQWV6HUYLFH
LPSRUWMDYDLR
LPSRUWMDYD[VZLQJ
LPSRUWMDYDDZW
LPSRUWMDYDDZWHYHQW
SXEOLFFODVV0LQL0XVLF6HUYLFHLPSOHPHQWV6HUYLFH^
LW

7 K HVHUY LF HPHWKRGW$RQOO DQG
0\'UDZ3DQHOP\3DQHO SOD\DEXW GRHVLVGLVLQJVHUYLFHZKHUH
SXEOLF-3DQHOJHW*XL3DQHO^ WKHGUDZ QJOHVZLOOHYHQWXDOO\
-3DQHOPDLQ3DQHO QHZ-3DQHO WKHUHFWD
P\3DQHO QHZ0\'UDZ3DQHO EHSDLQWHG
-%XWWRQSOD\,W%XWWRQ QHZ-%XWWRQ³3OD\LW´
SOD\,W%XWWRQDGG$FWLRQ/LVWHQHUQHZ3OD\,W/LVWHQHU
PDLQ3DQHODGGP\3DQHO
PDLQ3DQHODGGSOD\,W%XWWRQ
UHWXUQPDLQ3DQHO
`
SXEOLFFODVV3OD\,W/LVWHQHULPSOHPHQWV$FWLRQ/LVWHQHU^ 7KLVLVDOOWKHPXVLFVWXIIIURPWKH
SXEOLFYRLGDFWLRQ3HUIRUPHG$FWLRQ(YHQWHY^ &RGH.LWFKHQLQFKDSWHUVRZ
ZRQ·WDQQRWDWHLWDJDLQKHUH H
WU\^

VHTXHQFHURSHQ

VHTXHQFHUDGG&RQWUROOHU(YHQW/LVWHQHUP\3DQHOQHZLQW>@^`
IRULQWL LL ^
LQWU1XP LQW0DWKUDQGRP

LIU1XP^VRQRZRQO\GRLWLIQXPRIWKHWLPH
WUDFNDGGPDNH(YHQWU1XPL
WUDFNDGGPDNH(YHQWL
WUDFNDGGPDNH(YHQWU1XPL
`
`HQGORRS

VHTXHQFHUVWDUW
`FORVHDFWLRQSHUIRUPHG
`FORVHLQQHUFODVV
\RXDUHKHUH
0LQL0XVLF6HUYLFHFRGH
FODVV0LQL0XVLF6HUYLFHFRQWLQXHG
0LGL(YHQWHYHQW QXOO
WU\^

`FDWFK([FHSWLRQH^`
UHWXUQHYHQW
`

RQO\LIZHJRWDQHYHQWGRZHZDQWWRSDLQW
ERROHDQPVJ IDOVH
PVJ WUXH
LUHSDJH<LWRX ·YH
R QW KLV H QW FK HQ
1RWKLQJQHLZQWKHJUDSKLFV&RGH.
UHSDLQW
` OO
VHHQLWD QWDQRWKHUH[HUFLVH WKHQ W U\
SXEOLF'LPHQVLRQJHW3UHIHUUHG6L]H^ ,I\RXZD JWKLVFRGH\RXUVHOI HQLQ
UHWXUQQHZ'LPHQVLRQ DQQRWDWLQ WZLWKWKH&RGH.LWFKSWHU
` FRPSDUHL \JUDSKLFVWRU\µFKD
WKH´$YHU
LIPVJ^

LQWU LQW0DWKUDQGRP

LQWJU LQW0DWKUDQGRP
LQWE LQW0DWKUDQGRP
JVHW&RORUQHZ&RORUUJUE
LQWKW LQW0DWKUDQGRP

LQW[ LQW0DWKUDQGRP

LQW\ LQW0DWKUDQGRP

J¿OO5HFW[\KWZLGWK
PVJ IDOVH
`FORVHLI
`FORVHPHWKRG
`FORVHLQQHUFODVV
`FORVHFODVV
FKDSWHU
FODVV'D\2I7KH:HHN6HUYLFHDXQLYHUVDOVHUYLFHLPSOHPHQWV6HUYLFH
LPSRUWMDYD[VZLQJ
LPSRUWMDYDDZWHYHQW
LPSRUWMDYDDZW
LPSRUWMDYDLR
LPSRUWMDYDXWLO
LPSRUWMDYDWH[W
SXEOLFFODVV'D\2I7KH:HHN6HUYLFHLPSOHPHQWV6HUYLFH^
-/DEHORXWSXW/DEHO
-&RPER%R[PRQWK KRG
QWHUIDFHPHW
-7H[W)LHOGGD\
7KH6HUYLFHVLWKH*8,
-7H[W)LHOG\HDU
WKDWEXLOG
SXEOLF-3DQHOJHW*XL3DQHO^
-%XWWRQEXWWRQ QHZ-%XWWRQ³'RLW´
EXWWRQDGG$FWLRQ/LVWHQHUQHZ'R,W/LVWHQHU
RXWSXW/DEHO QHZ-/DEHO³GDWHDSSHDUVKHUH´
'DWH)RUPDW6\PEROVGDWH6WXII QHZ'DWH)RUPDW6\PEROV
PRQWK QHZ-&RPER%R[GDWH6WXIIJHW0RQWKV
GD\ QHZ-7H[W)LHOG
\HDU QHZ-7H[W)LHOG
-3DQHOLQSXW3DQHO QHZ-3DQHOQHZ*ULG/D\RXW
LQSXW3DQHODGGQHZ-/DEHO³0RQWK´
LQSXW3DQHODGGPRQWK
LQSXW3DQHODGGQHZ-/DEHO³'D\´
LQSXW3DQHODGGGD\
LQSXW3DQHODGGQHZ-/DEHO³<HDU´
LQSXW3DQHODGG\HDU
SDQHODGGLQSXW3DQHO
SDQHODGGEXWWRQ
SDQHODGGRXWSXW/DEHO
UHWXUQSDQHO
`
GHU
SXEOLFFODVV'R,W/LVWHQHULPSOHPHQWV$FWLRQ/LVWHQHU^
HU L I \ RX QHHGDUHPZLQRUNV
SXEOLFYRLGDFWLRQ3HUIRUPHG$FWLRQ(YHQWHY^ FKDS W IRUPDWWLQJ
LQWPRQWK1XP PRQWKJHW6HOHFWHG,QGH[ 5HIHUWRXP E HU DQGGDWHIHU KRZHYHU
LQWGD\1XP ,QWHJHUSDUVH,QWGD\JHW7H[W RI K RZ Q
RG HLV V OL JK W O\GLI HQUWFODVV$OVRWKH
LQW\HDU1XP ,QWHJHUSDUVH,QW\HDUJHW7H[W 7KLV
F VWKH&DOHQGD SDWWHUQ
&DOHQGDUF &DOHQGDUJHW,QVWDQFH EHFDXVHLWWXH)VHRUPDWOHWVXVVSHFLI\XWD
FVHW&DOHQGDU0217+PRQWK1XP 6LPSOH'D KHGDWHVKRXOGSULQWR
FVHW&DOHQGDU'$<B2)B0217+GD\1XP IRUKRZW
FVHW&DOHQGDU<($5\HDU1XP
'DWHGDWH FJHW7LPH
6WULQJGD\2I:HHN QHZ6LPSOH'DWH)RUPDW³((((ÍRUPDWGDWH
RXWSXW/DEHOVHW7H[WGD\2I:HHN
`
`
`
\RXDUHKHUH

WKHHQGVRUWRI
:RXOGQ·WLWEH
GUHDP\LIWKLVZHUHWKHHQG
RIWKHERRN",IWKHUHZHUHQR
PRUHEXOOHWSRLQWVRUSX]]OHV
RUFRGHOLVWLQJVRUDQ\WKLQJHOVH"
%XWWKDW·VSUREDEO\MXVWD
IDQWDV\
Congratulations!
You made it to the end.
2IFRXUVHWKHUH·VVWLOOWKHWZRDSSHQGLFHV
$QGWKHLQGH[
$QGWKHQWKHUH·VWKHZHEVLWH
7KHUH·VQRHVFDSHUHDOO\
FKDSWHU
Appendix A:
Final Code Kitchen
WR
R X U P HVV D J HJHWVVHQW
< OD\HUVDORQJ
GDQFHEHDW WKHRWKHUS XUUHQWEHDW
ZLWK\RXUF HQ\RXKLW
SDWWHUQZK
´VHQG,Wµ
$QG\JURRYH
&KULVJURRYHUHYLVHG
1LJHOGDQFHEHDW ,QFRPLQJPH
SOD\HUV&OLF VVDJHVIURP
WKHSDWWHUQ NRQHWRORDG
ZLWKLWDQG WKDWJRHV
¶6WDUW·WRS WKHQFOLFN
OD\LW
Finally, the complete version of the BeatBox!
It connects to a simple MusicServer so that you can
send and receive beat patterns with other clients.
WKLVLVDQHZDSSHQGL[
ILQDO%HDW%R[FRGH
)LQDO%HDW%R[FOLHQWSURJUDP
0RVWRIWKLVFRGHLVWKHVDPHDVWKHFRGHIURPWKH&RGH.LWFKHQVLQWKHSUHYLRXV
FKDSWHUVVRZHGRQ¶WDQQRWDWHWKHZKROHWKLQJDJDLQ7KHQHZSDUWVLQFOXGH
*8,WZRQHZFRPSRQHQWVDUHDGGHGIRUWKHWH[WDUHDWKDWGLVSOD\VLQFRPLQJ
PHVVDJHVDFWXDOO\DVFUROOLQJOLVWDQGWKHWH[W¿HOG
1(7:25.,1*MXVWOLNHWKH6LPSOH&KDW&OLHQWLQWKLVFKDSWHUWKH%HDW%R[QRZ
FRQQHFWVWRWKHVHUYHUDQGJHWVDQLQSXWDQGRXWSXWVWUHDP
7+5($'6DJDLQMXVWOLNHWKH6LPSOH&KDW&OLHQWZHVWDUWDµUHDGHU¶FODVVWKDW
NHHSVORRNLQJIRULQFRPLQJPHVVDJHVIURPWKHVHUYHU%XWLQVWHDGRIMXVWWH[WWKH
PHVVDJHVFRPLQJLQLQFOXGH7:2REMHFWVWKH6WULQJPHVVDJHDQGWKHVHULDOL]HG
$UUD\/LVWWKHWKLQJWKDWKROGVWKHVWDWHRIDOOWKHFKHFNER[HV
LPSRUWMDYDDZW
LPSRUWMDYD[VZLQJ
LPSRUWMDYDLR
LPSRUWMDYDXWLO
LPSRUWMDYDDZWHYHQW
LPSRUWMDYDQHW
LPSRUWMDYD[VZLQJHYHQW
SXEOLFFODVV%HDW%R[)LQDO^
-)UDPHWKH)UDPH
-3DQHOPDLQ3DQHO
-/LVWLQFRPLQJ/LVW
-7H[W)LHOGXVHU0HVVDJH
$UUD\/LVW-&KHFN%R[!FKHFNER[/LVW
LQWQH[W1XP
9HFWRU6WULQJ!OLVW9HFWRU QHZ9HFWRU6WULQJ!
6WULQJXVHU1DPH
2EMHFW2XWSXW6WUHDPRXW
2EMHFW,QSXW6WUHDPLQ
+DVK0DS6WULQJERROHDQ>@!RWKHU6HTV0DS QHZ+DVK0DS6WULQJERROHDQ>@!
6HTXHQFHUVHTXHQFHU
6HTXHQFHVHTXHQFH
6HTXHQFHP\6HTXHQFH QXOO
7UDFNWUDFN

6WULQJ>@LQVWUXPHQW1DPHV ^³%DVV'UXP´³&ORVHG+L+DW´³2SHQ+L+DW´´$FRXVWLF
6QDUH´³&UDVK&\PEDO´³+DQG&ODS´³+LJK7RP´³+L%RQJR´³0DUDFDV´³:KLVWOH´
³/RZ&RQJD´³&RZEHOO´³9LEUDVODS´³/RZPLG7RP´³+LJK$JRJR´³2SHQ+L&RQJD´`
LQW>@LQVWUXPHQWV ^`

DSSHQGL[$
DSSHQGL[$)LQDO&RGH.LWFKHQ
QHZ%HDW%R[)LQDOVWDUW8SDUJV>@DUJV>@LV\RXUXVHU,'VFUHHQQDPH
` U\RXUVFUHHQQDPH IR
$GGDFRPPDQGOLQHDUJXPHQW
LQDOWKH)ODVK
([DPSOHMDYD%HDW%R[)
SXEOLFYRLGVWDUW8S6WULQJQDPH^
XVHU1DPH QDPH
RSHQFRQQHFWLRQWRWKHVHUYHU
WU\^
6RFNHWVRFN QHZ6RFNHW³´
1RWKLQJQHZVHWXSW KH
RXW QHZ2EMHFW2XWSXW6WUHDPVRFNJHW2XWSXW6WUHDP
QHWZRUNL QJ , 2 DQG P DNHDQG
LQ QHZ2EMHFW,QSXW6WUHDPVRFNJHW,QSXW6WUHDP
VWDUWWKHUHDGH UWKUH DG
7KUHDGUHPRWH QHZ7KUHDGQHZ5HPRWH5HDGHU
UHPRWHVWDUW
`FDWFK([FHSWLRQH[^
6\VWHPRXWSULQWOQ³FRXOGQ¶WFRQQHFW\RX¶OOKDYHWRSOD\DORQH´
`
VHW8S0LGL
EXLOG*8,
`FORVHVWDUW8S
SXEOLFYRLGEXLOG*8,^ *8,FRGHQRWKLQJQHZKHUH
WKH)UDPH QHZ-)UDPH³&\EHU%HDW%R[´
%RUGHU/D\RXWOD\RXW QHZ%RUGHU/D\RXW
-3DQHOEDFNJURXQG QHZ-3DQHOOD\RXW
EDFNJURXQGVHW%RUGHU%RUGHU)DFWRU\FUHDWH(PSW\%RUGHU
FKHFNER[/LVW QHZ$UUD\/LVW-&KHFN%R[!
%R[EXWWRQ%R[ QHZ%R[%R[/D\RXW<B$;,6

-%XWWRQVWDUW QHZ-%XWWRQ³6WDUW´
VWDUWDGG$FWLRQ/LVWHQHUQHZ0\6WDUW/LVWHQHU
EXWWRQ%R[DGGVWDUW
-%XWWRQVWRS QHZ-%XWWRQ³6WRS´

VWRSDGG$FWLRQ/LVWHQHUQHZ0\6WRS/LVWHQHU
EXWWRQ%R[DGGVWRS
-%XWWRQXS7HPSR QHZ-%XWWRQ³7HPSR8S´

XS7HPSRDGG$FWLRQ/LVWHQHUQHZ0\8S7HPSR/LVWHQHU
EXWWRQ%R[DGGXS7HPSR
-%XWWRQGRZQ7HPSR QHZ-%XWWRQ³7HPSR'RZQ´

GRZQ7HPSRDGG$FWLRQ/LVWHQHUQHZ0\'RZQ7HPSR/LVWHQHU
EXWWRQ%R[DGGGRZQ7HPSR
-%XWWRQVHQG,W QHZ-%XWWRQ³VHQG,W´

VHQG,WDGG$FWLRQ/LVWHQHUQHZ0\6HQG/LVWHQHU
EXWWRQ%R[DGGVHQG,W
XVHU0HVVDJH QHZ-7H[W)LHOG
\RXDUHKHUH
ILQDO%HDW%R[FRGH
EXWWRQ%R[DGGXVHU0HVVDJH
LQFRPLQJ/LVW QHZ-/LVW
LQFRPLQJ/LVWDGG/LVW6HOHFWLRQ/LVWHQHUQHZ0\/LVW6HOHFWLRQ/LVWHQHU
LQFRPLQJ/LVWVHW6HOHFWLRQ0RGH/LVW6HOHFWLRQ0RGHO6,1*/(B6(/(&7,21
-6FUROO3DQHWKH/LVW QHZ-6FUROO3DQHLQFRPLQJ/LVW
EXWWRQ%R[DGGWKH/LVW
LQFRPLQJ/LVWVHW/LVW'DWDOLVW9HFWRUQRGDWDWRVWDUWZLWK
%R[QDPH%R[ QHZ%R[%R[/D\RXW<B$;,6 -/LVWLVDFRPSRQHQWZK ZHKDYHQ·W

IRULQWL LL^ XVHGEHIRUH 7KLV LV HUHWKH
\HG
QDPH%R[DGGQHZ/DEHOLQVWUXPHQW1DPHV>L@ LQFRPLQJPHVVDJHVDUHUPDOSOD
GLV
FKD W
` 2QO\LQVWHD GR ID QR
. DW WK H
ZKHUH\RXMXVW/22 \RXFDQ
EDFNJURXQGDGG%RUGHU/D\RXW($67EXWWRQ%R[ PHVVDJHVLQWKLVDSSIURPWKHOLVW
EDFNJURXQGDGG%RUGHU/D\RXW:(67QDPH%R[ 6(/(&7DPHVVDJHHDWWDFKHG
WRORDGDQGSOD\WK
WKH)UDPHJHW&RQWHQW3DQHDGGEDFNJURXQG EHDWSDWWHUQ
*ULG/D\RXWJULG QHZ*ULG/D\RXW
JULGVHW9JDS
JULGVHW+JDS
PDLQ3DQHO QHZ-3DQHOJULG
EDFNJURXQGDGG%RUGHU/D\RXW&(17(5PDLQ3DQHO
IRULQWL LL^

-&KHFN%R[F QHZ-&KHFN%R[
FVHW6HOHFWHGIDOVH
1RWKLQJHOVHRQWKLVSDJHLVQHZ
FKHFNER[/LVWDGGF
PDLQ3DQHODGGF
`HQGORRS
WKH)UDPHVHW%RXQGV
WKH)UDPHSDFN
WKH)UDPHVHW9LVLEOHWUXH
`FORVHEXLOG*8,
SXEOLFYRLGVHW8S0LGL^
WU\^
VHTXHQFHU 0LGL6\VWHPJHW6HTXHQFHU
VHTXHQFHURSHQ
VHTXHQFH QHZ6HTXHQFH6HTXHQFH334
DNHD
XHQFHUP7
WUDFN VHTXHQFHFUHDWH7UDFN
*HWWKH6HT PDNHD UDFN
6HTXHQFH DQG
`FORVHVHW8S0LGL
DSSHQGL[$
SXEOLFYRLGEXLOG7UDFN$QG6WDUW^
$UUD\/LVW,QWHJHU!WUDFN/LVW QXOOWKLVZLOOKROGWKHLQVWUXPHQWVIRUHDFK
ER[HV
XJKWKHFKRHFDNQ
VHTXHQFHGHOHWH7UDFNWUDFN
WUDFN VHTXHQFHFUHDWH7UDFN \Z DON LQ J WK UR W
%XLOGDWUDHLFN
E SLQJWKDW
HW W K U VW DWHDQGPWKDHS 0LGL(YHQWIRULWVLW
IRULQWL LL^ WRJ QGPDNLQJ ;$&7/<D
LQVWUXPHQWWWD\FRPSOH[EXWLWLRVU(HIHUWRSUHYLRXV
WUDFN/LVW QHZ$UUD\/LVW,QWHJHU! 7KLVLVSUHHSUHYLRXVFKDSWHUVV H[SODQDWLRQDJDLQ
ZDVLQWK HQVWRJHWWKHIXOO
IRULQWM MM^ &RGH.LWFK
-&KHFN%R[MF -&KHFN%R[FKHFNER[/LVWJHWM L
LIMFLV6HOHFWHG^
Licensed by
LQWNH\ LQVWUXPHQWV>L@
WUDFN/LVWDGGQHZ,QWHJHUNH\
`HOVH^
WUDFN/LVWDGGQXOOEHFDXVHWKLVVORWVKRXOGEHHPSW\LQWKHWUDFN
`
`FORVHLQQHUORRS
Eduard Simons
PDNH7UDFNVWUDFN/LVW
`FORVHRXWHUORRS
WUDFNDGGPDNH(YHQWVRZHDOZD\VJRWRIXOOEHDWV
WU\^
VHTXHQFHUVHW6HTXHQFHVHTXHQFH
104038
VHTXHQFHUVHW/RRS&RXQWVHTXHQFHU/223B&217,18286/<
VHTXHQFHUVWDUW
`FORVHPHWKRG
SXEOLFFODVV0\6WDUW/LVWHQHULPSOHPHQWV$FWLRQ/LVWHQHU^
EXLOG7UDFN$QG6WDUW
HUV
7KH*8,OLKVWHHQVDPHDVWKH
`FORVHDFWLRQ3HUIRUPHG
`FORVHLQQHUFODVV W
([DFWO\ KDSWHU·VYHUVLRQ
SXEOLFFODVV0\6WRS/LVWHQHULPSOHPHQWV$FWLRQ/LVWHQHU^ SUHYLRXVF
VHTXHQFHUVWRS
`FORVHLQQHUFODVV
SXEOLFFODVV0\8S7HPSR/LVWHQHULPSOHPHQWV$FWLRQ/LVWHQHU^
`FORVHLQQHUFODVV
\RXDUHKHUH
ILQDO%HDW%R[FRGH
SXEOLFFODVV0\'RZQ7HPSR/LVWHQHULPSOHPHQWV$FWLRQ/LVWHQHU^
`
`
SXEOLFFODVV0\6HQG/LVWHQHULPSOHPHQWV$FWLRQ/LVWHQHU^
PDNHDQDUUD\OLVWRIMXVWWKH67$7(RIWKHFKHFNER[HV
ERROHDQ>@FKHFNER[6WDWH QHZERROHDQ>@
IRULQWL LL^
FHSW
&KDW&OLHQWHWH[ZRREMHFWV
LIFKHFNLV6HOHFWHG^ H W K H 6LP S OH
ORWOLN HVHULDOL]
FKHFNER[6WDWH>L@ WUXH
7 K LV LVQHZLWG·VLQDJD6WULQJPHVVDJHDZWWHUQDQGZULWHWKRVH
`
LQVWHDGRIQVJHQPHVVDJHDQGWKHEHDSXW WS KHVHUYHU
`FORVHORRS
W K H 6WUL FN HW R XW VWUHDPWRW
RWKHVR
6WULQJPHVVDJH7R6HQG QXOO
WU\^
WZRREMHFWVW
RXWZULWH2EMHFWXVHU1DPHQH[W1XP³³XVHU0HVVDJHJHW7H[W
RXWZULWH2EMHFWFKHFNER[6WDWH
`FDWFK([FHSWLRQH[^
6\VWHPRXWSULQWOQ³6RUU\GXGH&RXOGQRWVHQGLWWRWKHVHUYHU´
`
XVHU0HVVDJHVHW7H[W³´
`FORVHLQQHUFODVV
SXEOLFFODVV0\/LVW6HOHFWLRQ/LVWHQHULPSOHPHQWV/LVW6HOHFWLRQ/LVWHQHU^
SXEOLFYRLGYDOXH&KDQJHG/LVW6HOHFWLRQ(YHQWOH^
LIOHJHW9DOXH,V$GMXVWLQJ^
6WULQJVHOHFWHG 6WULQJLQFRPLQJ/LVWJHW6HOHFWHG9DOXH
LIVHOHFWHG QXOO^
QRZJRWRWKHPDSDQGFKDQJHWKHVHTXHQFH
ERROHDQ>@VHOHFWHG6WDWH ERROHDQ>@RWKHU6HTV0DSJHWVHOHFWHG
FKDQJH6HTXHQFHVHOHFWHG6WDWH
VHTXHQFHUVWRS
EXLOG7UDFN$QG6WDUW
`
` 7KLVLVDOVRQ
ZKHQWKHX HZD/LV
`FORVHYDOXH&KDQJHG W6H
`FORVHLQQHUFODVV : KHQWKHXVH PDGHDVHOHFWLROHQFWLRQ/LVWHQHUWKDWW
VH U
ORDGWKH VV UVHOHFWVDPHVVDJ RQWKHOLVWRIPHVV HOOVXV
FDOOHGRWD
K H U
RFLDWHGEHD H
WSDWWHUQZH,00(',$7(/D<JHV
LIWHVWV 6 H T V0 DSDQGV LW·VLQWKH+
/LVW6HOHFEWHLRFDXVHRIOLWWOHTXWLUDNUWSOD\LQJLW7KHUDHVK0DS
Q(YHQWV \WKLQJVDER ·V
XWJHWWLQVJRPH

DSSHQGL[$
SXEOLFFODVV5HPRWH5HDGHULPSOHPHQWV5XQQDEOH^
D
UHDGLQWGD·DWZLOO
ERROHDQ>@FKHFNER[6WDWH QXOO
6WULQJQDPH7R6KRZ QXOO
W K UHD G MR E D
2EMHFWREM QXOO 7KLVLVWKHVHUYHU,QWKLVFRGH¶GVWKH
SXEOLFYRLGUXQ^ IURPWKH WZRVHULDOL]HGREMHFWDWWHUQDQ
WU\^ DOZD\VEHHVVDJHDQGWKHEHDWS YDOXHV
ZKLOHREM LQUHDG2EMHFW QXOO^ 6WULQJP WRIFKHFNER[VWDWH
$UUD\/LV
6\VWHPRXWSULQWOQ³JRWDQREMHFWIURPVHUYHU´
6\VWHPRXWSULQWOQREMJHW&ODVV
6WULQJQDPH7R6KRZ 6WULQJREM :KHQD
FKHFNER[6WDWH ERROHDQ>@LQUHDG2EMHFW GHVHULDOLP]HVVDJHFRPHVLQ
RWKHU6HTV0DSSXWQDPH7R6KRZFKHFNER[6WDWH PHVVDJ HWKHWZRR ZHUHDG
OLVW9HFWRUDGGQDPH7R6KRZ FKHFNERH[D QGWKH$UUD\/ELVMHFWVWKH
LQFRPLQJ/LVWVHW/LVW'DWDOLVW9HFWRU WKH-/ VWDWHYDOXHV WRI%RROHDQ
`FORVHZKLOH LVDWZRLVWV FRPSRQHQW$DGQGGDGGLWWR
`FDWFK([FHSWLRQH[^H[SULQW6WDFN7UDFH` RIWKH WHSWKLQJ\R LQJWRD-/
`FORVHUXQ IDVKLRQHOLGVWVGDWD9HFWXRUNHHSD9HFWRULV W
`FORVHLQQHUFODVV -/LV $UUD\/LVW LVDQROG
W
IRUZKDWWRXVHWKDW9HFWDRQUGWKHQWHOOWKH
WRGLVSOD\
SXEOLFFODVV0\3OD\0LQH/LVWHQHULPSOHPHQWV$FWLRQ/LVWHQHU^
LQWKHDOLVVLW·VVRXUFH
SXEOLFYRLGDFWLRQ3HUIRUPHG$FWLRQ(YHQWD^ W
LIP\6HTXHQFH QXOO^
VHTXHQFH P\6HTXHQFHUHVWRUHWRP\RULJLQDO
`
`FORVHLQQHUFODVV 7KLVPHWKRGLVFDOOHGZ
KH
VRPHWKLQJIURPWKHOLVW QWKHXVHUVHOHFWV
FK :H,00(',$7(/<
DQJHWKHSDWWHUQWRWK
SXEOLFYRLGFKDQJH6HTXHQFHERROHDQ>@FKHFNER[6WDWH^
IRULQWL LL^
HRQHWKH\VHOHFWHG
LIFKHFNER[6WDWH>L@^
FKHFNVHW6HOHFWHGWUXH
`HOVH^
FKHFNVHW6HOHFWHGIDOVH
H[DFWO\WKHVDPHDVLW
`
`FORVHORRS $OOWKH0,',VWXIILV
`FORVHFKDQJH6HTXHQFH ZDVLQWKHSUHYLRXVYHUVLRQ
SXEOLFYRLGPDNH7UDFNV$UUD\/LVWOLVW^
,WHUDWRULW OLVWLWHUDWRU
IRULQWL LL^
,QWHJHUQXP ,QWHJHULWQH[W
LIQXP QXOO^
LQWQXP.H\ QXPLQW9DOXH
WUDFNDGGPDNH(YHQWQXP.H\L
WUDFNDGGPDNH(YHQWQXP.H\L
`
`FORVHORRS
`FORVHPDNH7UDFNV
\RXDUHKHUH
ILQDO%HDW%R[FRGH
0LGL(YHQWHYHQW QXOO
WU\^
RQ
`FDWFK([FHSWLRQH^`
- XV W O LN H WKHODVWYHUVL
1RWKLQJQHZ
UHWXUQHYHQW
`FORVHPDNH(YHQW
`FORVHFODVV

6KDUSHQ \RXU SHQFLO
7HATARESOMEOFTHEWAYSYOUCANIMPROVETHISPROGRAM
(EREAREAFEWIDEASTOGETYOUSTARTED
/NCEYOUSELECTAPATTERNWHATEVERCURRENTPATTERNWASPLAYINGISBLOWN
AWAY)FTHATWASANEWPATTERNYOUWEREWORKINGONORAMODIFICATIONOF
ANOTHERONE YOUREOUTOFLUCK9OUMIGHTWANTTOPOPUPADIALOGBOXTHAT
ASKSTHEUSERIFHEDLIKETOSAVETHECURRENTPATTERN
)FYOUFAILTOTYPEINACOMMAND LINEARGUMENTYOUJUSTGETANEXCEPTION

WHENYOURUNIT0UTSOMETHINGINTHEMAINMETHODTHATCHECKSTOSEEIF
YOUVEPASSEDINACOMMAND LINEARGUMENT)FTHEUSERDOESNTSUPPLYONE
EITHERPICKADEFAULTORPRINTOUTAMESSAGETHATSAYSTHEYNEEDTORUNIT
AGAINBUTTHISTIMEWITHANARGUMENTFORTHEIRSCREENNAME
)TMIGHTBENICETOHAVEAFEATUREWHEREYOUCANCLICKABUTTONANDIT
WILLGENERATEARANDOMPATTERNFORYOU9OUMIGHTHITONONEYOUREALLYLIKE
"ETTERYETHAVEANOTHERFEATURETHATLETSYOULOADINEXISTING@FOUNDATION
PATTERNSLIKEONEFORJAZZROCKREGGAEETCTHATTHEUSERCANADDTO
9OUCANFINDEXISTINGPATTERNSONTHE(EAD&IRST*AVAWEBSTART
DSSHQGL[$
)LQDO%HDW%R[VHUYHUSURJUDP
0RVWRIWKLVFRGHLVLGHQWLFDOWRWKH6LPSOH&KDW6HUYHUZHPDGHLQWKH
1HWZRUNLQJDQG7KUHDGVFKDSWHU7KHRQO\GLIIHUHQFHLQIDFWLVWKDWWKLVVHUYHU
UHFHLYHVDQGWKHQUHVHQGVWZRVHULDOL]HGREMHFWVLQVWHDGRIDSODLQ6WULQJ
DOWKRXJKRQHRIWKHVHULDOL]HGREMHFWVKDSSHQVWREHD6WULQJ
LPSRUWMDYDLR
LPSRUWMDYDQHW
LPSRUWMDYDXWLO
SXEOLFFODVV0XVLF6HUYHU^
$UUD\/LVW2EMHFW2XWSXW6WUHDP!FOLHQW2XWSXW6WUHDPV
QHZ0XVLF6HUYHUJR
`
SXEOLFFODVV&OLHQW+DQGOHULPSOHPHQWV5XQQDEOH^
2EMHFW,QSXW6WUHDPLQ
6RFNHWFOLHQW6RFNHW

SXEOLF&OLHQW+DQGOHU6RFNHWVRFNHW^
WU\^
FOLHQW6RFNHW VRFNHW
LQ QHZ2EMHFW,QSXW6WUHDPFOLHQW6RFNHWJHW,QSXW6WUHDP

`FORVHFRQVWUXFWRU
SXEOLFYRLGUXQ^
2EMHFWR QXOO
2EMHFWR QXOO
WU\^
ZKLOHR LQUHDG2EMHFW QXOO^

R LQUHDG2EMHFW

6\VWHPRXWSULQWOQ³UHDGWZRREMHFWV´
WHOO(YHU\RQHRR
`FORVHZKLOH

`FORVHUXQ
`FORVHLQQHUFODVV
\RXDUHKHUH
ILQDO%HDW%R[FRGH
SXEOLFYRLGJR^
FOLHQW2XWSXW6WUHDPV QHZ$UUD\/LVW2EMHFW2XWSXW6WUHDP!
WU\^
ZKLOHWUXH^
6RFNHWFOLHQW6RFNHW VHUYHU6RFNDFFHSW
2EMHFW2XWSXW6WUHDPRXW QHZ2EMHFW2XWSXW6WUHDPFOLHQW6RFNHWJHW2XWSXW6WUHDP
FOLHQW2XWSXW6WUHDPVDGGRXW
7KUHDGW QHZ7KUHDGQHZ&OLHQW+DQGOHUFOLHQW6RFNHW

WVWDUW
6\VWHPRXWSULQWOQ³JRWDFRQQHFWLRQ´
`
`FDWFK([FHSWLRQH[^
H[SULQW6WDFN7UDFH
`
`FORVHJR
SXEOLFYRLGWHOO(YHU\RQH2EMHFWRQH2EMHFWWZR^
,WHUDWRULW FOLHQW2XWSXW6WUHDPVLWHUDWRU
ZKLOHLWKDV1H[W^
WU\^
2EMHFW2XWSXW6WUHDPRXW 2EMHFW2XWSXW6WUHDPLWQH[W
RXWZULWH2EMHFWRQH
RXWZULWH2EMHFWWZR
`
`FORVHWHOO(YHU\RQH
`FORVHFODVV
DSSHQGL[$
$SSHQGL[%
7KH7RS7HQ7RSLFVWKDWDOPRVWPDGHLWLQWRWKH5HDO%RRN
<RXPHDQWKHUH·VVWLOO
025("'RHVQ·WWKLV
ERRN(9(5HQG"
7ECOVEREDALOTOFGROUNDANDYOUREALMOSTFINISHEDWITHTHISBOOK7ELLMISSYOUBUTBEFORE

WELETYOUGOWEWOULDNTFEELRIGHTABOUTSENDINGYOUOUTINTO*AVA,ANDWITHOUTALITTLEMORE
PREPARATION7ECANTPOSSIBLYFITEVERYTHINGYOULLNEEDTOKNOWINTOTHISRELATIVELYSMALLAPPENDIX
!CTUALLYWEDIDORIGINALLYINCLUDEEVERYTHINGYOUNEEDTOKNOWABOUT*AVANOTALREADYCOVEREDBY
THEOTHERCHAPTERS BYREDUCINGTHETYPEPOINTSIZETO)TALLFITBUTNOBODYCOULDREADIT3O
WETHREWMOSTOFITAWAYBUTKEPTTHEBESTBITSFORTHIS4OP4ENAPPENDIX
4HISREALLYISTHEENDOFTHEBOOK%XCEPTFORTHEINDEXAMUST READ
WKLVLVDQHZDSSHQGL[
ELWPDQLSXODWLRQ
%LW0DQLSXODWLRQ
?PaLWaW]KIZM' 7KH6KLIW2SHUDWRUV
4HESEOPERATORSTAKEASINGLEINTEGERPRIMITIVEANDSHIFTOR
7EVETALKEDABOUTTHEFACTTHATTHEREAREBITSINABYTE SLIDE ALLOFITSBITSINONEDIRECTIONORANOTHER)FYOUWANT
BITSINASHORTANDSOON9OUMIGHTHAVEOCCASIONTO TODUSTOFFYOURBINARYMATHSKILLSYOUMIGHTREALIZETHAT
TURNINDIVIDUALBITSONOROFF&ORINSTANCEYOUMIGHTlND SHIFTINGBITSLEFTEFFECTIVELYMULTIPLIESANUMBERBYAPOWEROF
YOURSELFWRITINGCODEFORYOURNEW*AVAENABLEDTOASTER TWOANDSHIFTINGBITSRIGHTEFFECTIVELYDIVIDESANUMBERBYA
ANDREALIZETHATDUETOSEVEREMEMORYLIMITATIONSCERTAIN POWEROFTWO
TOASTERSETTINGSARECONTROLLEDATTHEBITLEVEL&OREASIER
READINGWERESHOWINGONLYTHELASTBITSINTHECOMMENTS 7ELLUSETHEFOLLOWINGEXAMPLEFORTHENEXTTHREEOPERATORS
RATHERTHANTHEFULLFORANINT
INTX BITSARE
%LWZLVH1272SHUDWRUa /KOKWEVEBEENPUTTINGITOFFHEREISTHEWORLDS
4HISOPERATOR@mIPSALLTHEBITSOFAPRIMITIVE SHORTESTEXPLANATIONOFSTORINGNEGATIVENUMBERSAND
TWOSCOMPLEMENT2EMEMBERTHELEFTMOSTBITOFANINTEGER
INTXBITSARE NUMBERISCALLEDTHESIGNBIT!NEGATIVEINTEGERNUMBERIN
*AVAALWAYSHASITSSIGNBITTURNEDONIESETTO !POSITIVE
X^XBITSARENOW
INTEGERNUMBERALWAYSHASITSSIGNBITTURNEDOFF *AVA
USESTHETWOSCOMPLEMENTFORMULATOSTORENEGATIVENUMBERS
4HENEXTTHREEOPERATORSCOMPARETWOPRIMITIVESONABIT 4OCHANGEANUMBERSSIGNUSINGTWOSCOMPLEMENTmIPALL
BYBITBASISANDRETURNARESULTBASEDONCOMPARINGTHESE THEBITSTHENADDWITHABYTEFOREXAMPLETHATWOULD
BITS7ELLUSETHEFOLLOWINGEXAMPLEFORTHENEXTTHREE MEANADDINGTOTHEmIPPEDVALUE
OPERATORS
INTXBITSARE
5LJKW6KLIW2SHUDWRU!!
4HISOPERATORSHIFTSALLOFANUMBERSBITSRIGHTBYACERTAIN
INTYBITSARE NUMBERANDlLLSALLOFTHEBITSONTHELEFTSIDEWITHWHATEVER
THEORIGINALLEFTMOSTBITWAS4HESIGNBITDOESNOTCHANGE

%LWZLVH$1'2SHUDWRU INTYXBITSARE
4HISOPERATORRETURNSAVALUEWHOSEBITSARETURNEDONONLY
IFBOTHORIGINALBITSARETURNEDON
8QVLJQHG5LJKW6KLIW2SHUDWRU!!!
INTAXYBITSARE *USTLIKETHERIGHTSHIFTOPERATOR"54IT!,7!93lLLSTHE
LEFTMOSTBITSWITHZEROS4HESIGNBITMIGHTCHANGE
%LWZLVH252SHUDWRU_
4HISOPERATORRETURNSAVALUEWHOSEBITSARETURNEDONONLY INTYXBITSARE
IFEITHEROFTHEORIGINALBITSARETURNEDON
INTAX\YBITSARE /HIW6KLIW2SHUDWRU
*USTLIKETHEUNSIGNEDRIGHTSHIFTOPERATORBUTINTHEOTHER
DIRECTIONTHERIGHTMOSTBITSARElLLEDWITHZEROS4HESIGNBIT
%LWZLVH;25H[FOXVLYH252SHUDWRUA MIGHTCHANGE
4HISOPERATORRETURNSAVALUEWHOSEBITSARETURNEDONONLY
IFEXACTLYONEOFTHEORIGINALBITSARETURNEDON INTYXBITSARE
INTAX>YBITSARE
DSSHQGL[%
DSSHQGL[%7RS7HQ5HIHUHQFH
,PPXWDELOLW\

?PaLWaW]KIZM\PI\;\ZQVO[IZM1UU]\IJTM' ?PaLWaW]KIZM\PI\?ZIXXMZ[IZM
7HENYOUR*AVAPROGRAMSSTARTTOGETBIGYOULL 1UU]\IJTM'
INEVITABLYENDUPWITHLOTSANDLOTSOF3TRINGOBJECTS )NTHE-ATHCHAPTERWETALKEDABOUTTHETWOMAIN
&ORSECURITYPURPOSESANDFORTHESAKEOFCONSERVING USESOFTHEWRAPPERCLASSES
MEMORYREMEMBERYOUR*AVAPROGRAMSCANRUNON
TEENY*AVA ENABLEDCELLPHONES 3TRINGSIN*AVAARE s7RAPPINGAPRIMITIVESOITCANPRETENDTOBEAN
IMMUTABLE7HATTHISM
EANSISTHATWHENYOUSAY OBJECT
s5SINGTHESTATICUTILITYMETHODSFOREXAMPLE
3TRINGShv )NTEGERPARSE)NT
FORINTXXX [ )TSIMPORTANTTOREMEMBERTHATWHENYOUCREATEA
SSX WRAPPEROBJECTLIKE
]
7HATSACTUALLYHAPPENINGISTHATYOURECREATINGTEN )NTEGERI7RAPNEW)NTEGER
3TRINGOBJECTSWITHVALUEShvhvhvTHROUGH
hv )NTHEENDSISREFERRINGTOTHE3TRING
4HATSITFORTHATWRAPPEROBJECT)TSVALUEWILLALWAYS
WITHTHEVALUEhvBUTATTHISPOINTTHERE
BE4HEREISNOSETTERMETHODFORAWRAPPEROBJECT
ARETEN3TRINGSINEXISTENCE
9OUCANOFCOURSEREFERI7RAPTOADIFFERENTWRAPPER
7HENEVERYOUMAKEANEW3TRINGTHE*6-PUTSIT OBJECTBUTTHENYOULLHAVETWOOBJECTS/NCEYOU
INTOASPECIALPARTOFMEMORYCALLEDTHE@3TRING0OOL CREATEAWRAPPEROBJECTTHERESNOWAYTOCHANGE
SOUNDSREFRESHINGDOESNTIT )FTHEREISALREADY THEVALUEOFTHATOBJECT
A3TRINGINTHE3TRING0OOLWITHTHESAMEVALUETHE
*6-DOESNTCREATEADUPLICATEITSIMPLYREFERSYOUR
REFERENCEVARIABLETOTHEEXISTINGENTRY4HE*6-CAN
GETAWAYWITHTHISBECAUSE3TRINGSAREIMMUTABLEONE
REFERENCEVARIABLECANTCHANGEA3TRINGSVALUEOUT
FROMUNDERANOTHERREFERENCEVARIABLEREFERRINGTO
THESAME3TRING
0DNH LW 6WLF
4HEOTHERISSUEWITHTHE3TRINGPOOLISTHATTHE N
'ARBAGE#OLLECTORDOESNTGOTHERE3OINOUREXAMPLE
UNLESSBYCOINCIDENCEYOULATERHAPPENTOMAKEA 2OSESARER
EDVIOLETSA
3TRINGCALLEDhvFORINSTANCETHElRSTNINE 3TRINGSARE REBLUE
IMMUTAB
3TRINGSCREATEDINOURFORLOOPWILLJUSTSITAROUND LEWRAPPE
RSARET OO
WASTINGMEMORY
2KORRN$ERQ
XV0DNHLW6W
+RZGRHVWKLVVDYHPHPRU\" 5LJKWKHUHLQW LFN
KHDSSHQGL[
7ELLIFYOURENOTCAREFULITDOESNT"UTIFYOUUN
DERSTANDHOW3TRINGIMMUTABILITYWORKSTHANYOU
CANSOMETIMESTAKEADVANTAGEOFITTOSAVEMEMORY
)FYOUHAVETODOALOTOF3TRINGMANIPULATIONSLIKE
CONCATENATIONSETC HOWEVERTHEREISANOTHERCLASS
3TRING"UILDERBETTERSUITEDFORTHATPURPOSE7ELL
TALKMOREABOUT3TRING"UILDERINAFEWPAGES
\RXDUHKHUH
DVVHUWLRQV
$VVHUWLRQV
7EHAVENTTALKEDMUCHABOUTHOWTODEBUGYOUR*AVA +RZWRPDNH$VVHUWLRQVZRUN
PROGRAMWHILEYOUREDEVELOPINGIT7EBELIEVETHAT
YOUSHOULDLEARN*AVAATTHECOMMANDLINEASWEVE !DDASSERTIONSTATEMENTSTOYOURCODEWHEREVERYOU
BEENDOINGTHROUGHOUTTHEBOOK/NCEYOUREA*AVA BELIEVETHATSOMETHINGMUSTBETRUE&ORINSTANCE
PROIFYOUDECIDETOUSEAN)$%
YOUMIGHTHAVE
DVVHUWKHLJKW!
OTHERDEBUGGINGTOOLSTOUSE)NTHEOLDDAYSWHEN
A*AVAPROGRAMMERWANTEDTODEBUGHERCODESHED LIWUXHSURJUDPFRQWLQXHVQRUPDOO\
STICKABUNCHOF3YSTEMOUTPRINTLN STATEMENTS
LIIDOVHWKURZDQ$VVHUWLRQ(UURU
THROUGHOUTTHEPROGRAMPRINTINGCURRENTVARIABLE
VALUESANDh)GOTHEREvMESSAGESTOSEEIFTHEmOW 9OUCANADDALITTLEMOREINFORMATIONTOTHESTACK
CONTROLWASWORKINGPROPERLY4HEREADY BAKECODE TRACEBYSAYING
INCHAPTERLEFTSOMEDEBUGGING@PRINTSTATEMENTS
INTHECODE 4HENONCETHEPROGRAMWASWORKING DVVHUWKHLJKW!³KHLJKW ³
CORRECTLYSHEDGOTHROUGHANDTAKEALLTHOSE3YSTEM KHLJKW³ZHLJKW ³ZHLJKW
OUTPRINTLN STATEMENTSBACKOUTAGAIN)TWAS
4HEEXPRESSIONAFTERTHECOLONCANBEANYLEGAL
TEDIOUSANDERRORPRONE"UTASOF*AVAAND
*AVAEXPRESSIONTHATRESOLVESTOANON NULLVALUE"UT
DEBUGGINGGOTAWHOLELOTEASIER4HEANSWER
WHATEVERYOUDODONTCREATEASSERTIONSTHATCHANGEAN
$VVHUWLRQV OBJECTSSTATE)FYOUDOENABLINGASSERTIONSATRUNTIME
MIGHTCHANGEHOWYOURPROGRAMPERFORMS
!SSERTIONSARELIKE3YSTEMOUTPRINTLN STATEMENTS
ONSTEROIDS!DDTHEMTOYOURCODEASYOUWOULD
ADDPRINTLNSTATEMENTS4HE*AVACOMPILER &RPSLOLQJDQGUXQQLQJZLWK
ASSUMESYOULLBECOMPILINGSOURCElLESTHATARE $VVHUWLRQV
COMPATIBLESOASOF*AVACOMPILINGWITHASSERTIONS
4OCOMPILEWITHASSERTIONS
ISENABLEDBYDEFAULT
!TRUNTIMEIFYOUDONOTHINGTHEASSERTSTATEMENTS MDYDF7HVW'ULYH*DPHMDYD
YOUADDEDTOYOURCODEWILLBEIGNOREDBYTHE*6-
.OTICETHATNOCOMMANDLINEOPTIONSWERE
ANDWONTSLOWDOWNYOURPROGRAM"UTIFYOUTELLTHE
*6-TOENABLEYOURASSERTIONSTHEYWILLHELPYOUDO NECESSARY
YOURDEBUGGINGWITHOUTCHANGINGALINEOFCODE 4ORUNWITHASSERTIONS
3OMEFOLKSHAVECOMPLAINEDABOUTHAVINGTOLEAVE
ASSERTSTATEMENTSINTHEIRPRODUCTIONCODEBUT MDYDHD7HVW'ULYH*DPH
LEAVINGTHEMINCANBEREALLYVALUABLEWHENYOUR
CODEISALREADYDEPLOYEDINTHElELD)FYOURCLIENT
ISHAVINGTROUBLEYOUCANINSTRUCTTHECLIENTTORUN
THEPROGRAMWITHASSERTIONSENABLEDANDHAVETHE
CLIENTSENDYOUTHEOUTPUT)FTHEASSERTIONSWERE
STRIPPEDOUTOFYOURDEPLOYEDCODEYOUDNEVER
HAVETHATOPTION!NDTHEREISALMOSTNODOWNSIDE
WHENASSERTIONSARENOTENABLEDTHEYARECOMPLETELY
IGNOREDBYTHE*6-SOTHERESNOPERFORMANCEHITTO
)$%STANDSFOR)NTEGRATED$EVELOPMENT%NVIRONMENT
WORRYABOUT ANDINCLUDESTOOLSSUCHAS%CLIPSE"ORLANDS*"UILDEROR
THEOPENSOURCE.ET"EANSNETBEANSORG
DSSHQGL[%
%ORFN6FRSH
)NCHAPTERWETALKEDABOUTHOWLOCALVARIABLES
LIVEONLYASLONGASTHEMETHODINWHICHTHEYRE
DECLAREDSTAYSONTHESTACK"UTSOMEVARIABLESCAN
HAVEEVENSHORTERLIFESPANS)NSIDEOFMETHODSWE
OFTENCREATEBLOCKSOFCODE7EVEBEENDOINGTHIS
ALLALONGBUTWEHAVENTEXPLICITLYTALKEDINTERMSOF
BLOCKS4YPICALLYBLOCKSOFCODEOCCURWITHINMETHODS
ANDAREBOUNDEDBYCURLYBRACES[]3OMECOMMON
EXAMPLESOFCODEBLOCKSTHATYOULLRECOGNIZEINCLUDE
LOOPSFORWHILE ANDCONDITIONALEXPRESSIONSLIKEIF
Licensed by
STATEMENTS
EORFN
KHPHWKRG
VWDUWRIW
,ETSLOOKATANEXAMPLE
YRLGGR6WXII^ HQWLUHPHWKRG
WKH
ORFDOYDULDEOHVFRSHGWR
Eduard Simons
LQW[
EORFNDQG\LV
IRULQW\ \\^ EHJLQQLQJRIDIRUHORIRRSUORRS
VFRSHGWRRQO\WK
[ [\ ERWKLQVFRSH
1RSUREOHP[DQG\DUH
104038
`
HQGRIWKHIRUORRSEORFN

[ [ \
$D FN:RQ·WFRPSLOH\ XWRIVFR
` WKHZD\LWZRUNVLQVRPLVR SHKHUH VLVQRW
HRWKHUODQJXDJHVVREWKL
HZDUH
HQGRIWKHPHWKRGEORFNQRZ[
LVDOVRRXWRIVFRSH

)NTHEPREVIOUSEXAMPLEYWASABLOCKVARIABLE
DECLAREDINSIDEABLOCKANDYWENTOUTOFSCOPEAS
SOONASTHEFORLOOPENDED9OUR*AVAPROGRAMSWILL
BEMOREDEBUGGABLEANDEXPANDABLEIFYOUUSELOCAL
VARIABLESINSTEADOFINSTANCEVARIABLESANDBLOCK
VARIABLESINSTEADOFLOCALVARIABLESWHENEVERPOSSIBLE
4HECOMPILERWILLMAKESURETHATYOUDONTTRYTOUSE
AVARIABLETHATSGONEOUTOFSCOPESOYOUDONTHAVE
TOWORRYABOUTRUNTIMEMELTDOWNS
\RXDUHKHUH
OLQNHGLQYRFDWLRQV
/LQNHG,QYRFDWLRQV
7HILEYOUDIDSEEALITTLEOFTHISINTHISBOOKWETRIEDTOKEEPOURSYNTAXASCLEANAND
READABLEASPOSSIBLE4HEREAREHOWEVERMANYLEGALSHORTCUTSIN*AVATHATYOULLNODOUBT
BEEXPOSEDTOESPECIALLYIFYOUHAVETOREADALOTCODEYOUDIDNTWRITE/NEOFTHEMORE
COMMONCONSTRUCTSYOUWILLENCOUNTERISKNOWNASLINKEDINVOCATIONS&OREXAMPLE
6WULQJ%XIIHUVE QHZ6WULQJ%XIIHU³VSULQJ´
VE VEGHOHWHLQVHUW´XPPH´GHOHWH&KDU$W
6\VWHPRXWSULQWOQ³VE ³VE
UHVXOWLVVE VXPPHU
7HATINTHEWORLDISHAPPENINGINTHESECONDLINEOFCODE!DMITTEDLYTHISISACONTRIVED
EXAMPLEBUTYOUNEEDTOLEARNHOWTODECIPHERTHESE
7ORKFROMLEFTTORIGHT
&INDTHERESULTOFTHELEFTMOSTMETHODCALLINTHISCASEVEGHOHWH)FYOU
LOOKUP3TRING"UFFERINTHE!0)DOCSYOULLSEETHATTHEGHOHWHMETHODRETURNSA
3TRING"UFFEROBJECT4HERESULTOFRUNNINGTHEGHOHWHMETHODISA3TRING"UFFEROBJECT
WITHTHEVALUEhSPRv
4HENEXTLEFTMOSTMETHODLQVHUW ISCALLEDONTHENEWLYCREATED3TRING"UFFER
OBJECThSPRv4HERESULTOFTHATMETHODCALLTHELQVHUWMETHOD ISALSOA3TRING"UFFER
OBJECTALTHOUGHITDOESNTHAVETOBETHESAMETYPEASTHEPREVIOUSMETHODRETURN ANDSO
ITGOESTHERETURNEDOBJECTISUSEDTOCALLTHENEXTMETHODTOTHERIGHT)NTHEORYYOUCAN
LINKASMANYMETHODSASYOUWANTINASINGLESTATEMENTALTHOUGHITSRARETOSEEMORETHAN
THREELINKEDMETHODSINASINGLESTATEMENT 7ITHOUTLINKINGTHESECONDLINEOFCODEFROM
ABOVEWOULDBEMOREREADABLEANDLOOKSOMETHINGLIKETHIS
VE VEGHOHWH

VE VELQVHUW´XPPH´
VE VEGHOHWH&KDU$W
"UTHERESAMORECOMMONANDUSEFULEXAMPLETHATYOUSAWUSUSINGBUTWETHOUGHT
WEDPOINTITOUTAGAINHERE4HISISFORWHENYOURMAIN METHODNEEDSTOINVOKEAN
INSTANCEMETHODOFTHEMAINCLASSBUTYOUDONTNEEDTOKEEPAREFERENCETOTHEINSTANCEOF
THECLASS)NOTHERWORDSTHEMAIN NEEDSTOCREATETHEINSTANCEONLYSOTHATMAIN CAN
INVOKEONEOFTHEINSTANCESMETHODS
FODVV)RR^
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV>
EX DERXW
WZHGRQ·WFDUDVHVLJ
QHZ)RRJR
ZHZ DQ W WR F DOO J R U QLQJ
` WKH)RRLQVWDQFMH HVRZHGRQ·WEUHRWQFKHH
RDUHIH
YRLGJR^ WKHQHZ)RRRE FWW
KHUH¶VZKDWZH5($//<ZDQW
`
`
DSSHQGL[%
$QRQ\PRXVDQG6WDWLF1HVWHG&ODVVHV
1HVWHGFODVVHVFRPHLQPDQ\ÁDYRUV
)NTHE'5)EVENT HANDLINGSECTIONOFTHEBOOKWESTARTEDUSINGINNERNESTED CLASSESASA
SOLUTIONFORIMPLEMENTINGLISTENERINTERFACES4HATSTHEMOSTCOMMONPRACTICALANDREAD
ABLEFORMOFANINNERCLASSWHERETHECLASSISSIMPLYNESTEDWITHINTHECURLYBRACESOFANOTHER
ENCLOSINGCLASS!NDREMEMBERITMEANSYOUNEEDANINSTANCEOFTHEOUTERCLASSINORDERTOGET
ANINSTANCEOFTHEINNERCLASSBECAUSETHEINNERCLASSISAMEMBEROFTHEOUTERENCLOSINGCLASS
"UTTHEREAREOTHERKINDSOFINNERCLASSESINCLUDINGSTATICANDANONYMOUS7ERENOTGOING
INTOTHEDETAILSHEREBUTWEDONTWANTYOUTOBETHROWNBYSTRANGESYNTAXWHENYOUSEEITIN
SOMEONESCODE"ECAUSEOUTOFVIRTUALLYANYTHINGYOUCANDOWITHTHE*AVALANGUAGEPERHAPS
NOTHINGPRODUCESMOREBIZARRE LOOKINGCODETHANANONYMOUSINNERCLASSES"UTWELLSTARTWITH
SOMETHINGSIMPLERSTATICNESTEDCLASSES
6WDWLFQHVWHGFODVVHV
9OUALREADYKNOWWHATSTATICMEANSSOMETHINGTIEDTOTHECLASSNOTAPARTICULARINSTANCE!
STATICNESTEDCLASSLOOKSJUSTLIKETHENON STATICCLASSESWEUSEDFOREVENTLISTENERSEXCEPTTHEYRE
MARKEDWITHTHEKEYWORDVWDWLF
VLVMXVWWKDW³D
SXEOLFFODVV)RR2XWHU^ $VWDWLFQHVWHGZLFWKODVLQDQRWKHUDQG
FODVVHQFORVHG HVWDWLFPRGLILHU
VWDWLFFODVV%DU,QQHU^ PDUNHGZLWKWK
YRLGVD\,W^
6\VWHPRXWSULQWOQ³PHWKRGRIDVWDWLFLQQHUFODVV´
`
`
%HFDXVHDVWDW
` XVHDQLQVWDQFHRLFIQHWKVWHGFODVVLVVWDWLF\RXGRQ·W
QDPHRIWKHFODVVW HRXWHUFODVV<RXMXVWXVHWKH
PHWKRGVRUDFFHVVVWKHVDPHZD\\RXLQYRNHVWDWLF
FODVV7HVW^ DWLFYDULDEOHV
)RR2XWHU%DU,QQHUIRR QHZ)RR2XWHU%DU,QQHU
IRRVD\,W
`
`
3TATICNESTEDCLASSESAREMORELIKEREGULARNON NESTEDCLASSESINTHATTHEYDONTENJOYASPECIALRELATION

SHIPWITHANENCLOSINGOUTEROBJECT"UTBECAUSESTATICNESTEDCLASSESARESTILLCONSIDEREDAMEMBEROF
THEENCLOSINGOUTERCLASSTHEYSTILLGETACCESSTOANYPRIVATEMEMBERSOFTHEOUTERCLASSBUTONLYTHE
ONESTHATAREALSOSTATIC3INCETHESTATICNESTEDCLASSISNTCONNECTEDTOANINSTANCEOFTHEOUTERCLASSIT
DOESNTHAVEANYSPECIALWAYTOACCESSTHENON STATICINSTANCE VARIABLESANDMETHODS
\RXDUHKHUH
$QRQ\PRXVDQG6WDWLF1HVWHG&ODVVHVFRQWLQXHG
7KHGLIIHUHQFHEHWZHHQQHVWHGDQGLQQHU
!NY*AVACLASSTHATSDElNEDWITHINTHESCOPEOFANOTHERCLASSISKNOWNASANESTEDCLASS)T
DOESNTMATTERIFITSANONYMOUSSTATICNORMALWHATEVER)FITSINSIDEANOTHERCLASSITS
TECHNICALLYCONSIDEREDANESTEDCLASS"UTNON STATICNESTEDCLASSESAREOFTENREFERREDTOASINNER
CLASSESWHICHISWHATWECALLEDTHEMEARLIERINTHEBOOK4HEBOTTOMLINEALLINNERCLASSESARE
NESTEDCLASSESBUTNOTALLNESTEDCLASSESAREINNERCLASSES
$QRQ\PRXVLQQHUFODVVHV
)MAGINEYOUREWRITINGSOME'5)CODEANDSUDDENLYREALIZETHATYOUNEEDANINSTANCE
OFACLASSTHATIMPLEMENTS!CTION,ISTENER"UTYOUREALIZEYOUDONTHAVEANINSTANCEOFAN
!CTION,ISTENER4HENYOUREALIZETHATYOUALSONEVERWROTEACLASSFORTHATLISTENER9OUHAVETWO
CHOICESATTHATPOINT
7RITEANINNERCLASSINYOURCODETHEWAYWEDIDINOUR'5)CODEANDTHENINSTANTIATEIT
ANDPASSTHATINSTANCEINTOTHEBUTTONSEVENTREGISTRATIONADD!CTION,ISTENER METHOD
/2
#REATEANANONYMOUSINNERCLASSANDINSTANTIATEITRIGHTTHEREJUST IN TIME,ITERALLYRIGHT
WHEREYOUAREATTHEPOINTYOUNEEDTHELISTENEROBJECT4HATSRIGHTYOUCREATETHECLASSANDTHE
INSTANCEINTHEPLACEWHEREYOUDNORMALLYBESUPPLYINGJUSTTHEINSTANCE4HINKABOUTTHATFOR
AMOMENTITMEANSYOUPASSTHEENTIRECLASSWHEREYOUDNORMALLYPASSONLYANINSTANCEINTOA
METHODARGUMENT
QRZZH
DEXWWRQKDQWGKHEXWWRQ
LPSRUWMDYDDZWHYHQW
LPSRUWMDYD[VZLQJ P H DQ G D G G HG
:HPDGHDJLIVW UD WHQHUZLW HPHQWVWKH
SXEOLFFODVV7HVW$QRQ^ HUDQDFWLRQOLV SO
SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ QHHGWRUH QHYHUPDGHDFODVVWKDWLP
([FH SW Z H
LQWHUIDFH
-)UDPHIUDPH QHZ-)UDPH $FWLRQ/LVWHQHU HW KL QJ O LN
LQ
HWKLV³SDVVDVLQVJDQ
R VR P DQLQQHUFOHUDQG
-%XWWRQEXWWRQ QHZ-%XWWRQ³FOLFN´ 1RUPDOO\ZFHH·WGGR DQ LQVWDQFHR$IFW LVWHQ
DUH I HU HQ
DVV W KD W L P SOHPHQW GLRQ/
V
EXWWRQDGG$FWLRQ/LVWHQHUTXLW/LVWHQHU
LQQHUFO HUIRUPHGPHWKR
WKHDFWLRQ3 W
7KLVVWDWHP HQ W
QV W HD G R I S DV VLQJLQDQREMHZHF
EXWWRQDGG$FWLRQ/LVWHQHUQHZ$FWLRQ/LVWHQHU^ %XWQRZL ZHSDVVLQWKHZKROH H Q
PHG UHIHUHQFH LWLRQ,QRWKHUZRUGVZF
6\VWHPH[LW FODVVGHILQFODVVWKDWLPSOHPHQWV$(:(
` ZULWHWKH HU5,*+7+(5(:+(5HVDQ
WLRQ/LVWHQ7KHV\QWD[DOVRFUHDWO\
` 1((',7 IWKHFODVVDXWRPDWLFDO
QHZ $ FWL RQ/LVWHQHU µH YHQ
1R WLF HW KDWZH VD \´ VR\RX LQVWDQFHR
WKRXJK$FWLRQ/LVWHQHQFH ULVDQLQWHUIDFHDQG\QW D[
FDQ·W0$.(DQLQVWD RI LW%XWWKLVV
HQGVGRZQKHUH UHD OO\PHDQV´F UHD WH DQ HZ FODVVZLWKQRQDPH
WLR Q/ LVWHQHULQWHUIDFH

WKDWLPSOHPHQWVWKH$F LPSOHPHQWDWLRQRIWKH
DQG E\WKHZD\KHUH·VWKH Q3 HUI RUPHG
`
`
LQWHUIDFHPHWKRGVDFWLR
DSSHQGL[%
DFFHVVOHYHOV DSSHQGL[%7RS7HQ5HIHUHQFH
$FFHVV/HYHOVDQG$FFHVV0RGLÀHUV:KR6HHV:KDW
*AVAHASFOURACCESSLEVELSANDTHREEACCESSMODIlERS4HEREAREONLYTHREEMODIlERSBECAUSE
THEDEFAULTWHATYOUGETWHENYOUDONTUSEANYACCESSMODIlER ISONEOFTHEFOUR
ACCESSLEVELS
$FFHVV/HYHOVINORDEROFHOWRESTRICTIVETHEYAREFROMLEASTTOMOSTRESTRICTIVE
PUBLIC SXEOLFPHDQVDQ\FRGHDQ\ZKHUHFDQDFFHVVWKHSXEOLFWKLQJE\

¶WKLQJ·ZHPHDQFODVVYDULDEOHPHWKRGFRQVWUXFWRUHWF
PROTECTED SURWHFWHGZRUNVMXVWOLNHGHIDXOWFRGHLQWKHVDPHSDFNDJHKDVDFFHVV(;&(37LW
DOVRDOORZVVXEFODVVHVRXWVLGHWKHSDFNDJHWRLQKHULWWKHSURWHFWHGWKLQJ
DEFAULT
GHIDXOWDFFHVVPHDQVWKDWRQO\FRGHZLWKLQWKHVDPHSDFNDJHDV
WKHFODVVZLWKWKHGHIDXOWWKLQJFDQDFFHVVWKHGHIDXOWWKLQJ
PRIVATE
SULYDWHPHDQVWKDWRQO\FRGHZLWKLQWKHVDPHFODVVFDQDFFHVVWKHSULYDWHWKLQJ
.HHSLQPLQGLWPHDQVSULYDWHWRWKHFODVVQRWSULYDWHWRWKHREMHFW2QH'RJ
FDQVHHDQRWKHU'RJREMHFW·VSULYDWHVWXIIEXWD&DWFDQ·WVHHD'RJ·VSULYDWHV
$FFHVVPRGLÀHUV
SXEOLF
SURWHFWHG
SULYDWH
-OSTOFTHETIMEYOULLUSEONLYPUBLICANDPRIVATEACCESSLEVELS
SXEOLF
5SEPUBLICFORCLASSESCONSTANTSSTATIClNALVARIABLES ANDMETHODSTHATYOURE
EXPOSINGTOOTHERCODEFOREXAMPLEGETTERSANDSETTERS ANDMOSTCONSTRUCTORS
SULYDWH
5SEPRIVATEFORVIRTUALLYALLINSTANCEVARIABLESANDFORMETHODSTHATYOUDONTWANT
OUTSIDECODETOCALLINOTHERWORDSMETHODSUSEDBYTHEPUBLICMETHODSOFYOURCLASS
"UTALTHOUGHYOUMIGHTNOTUSETHEOTHERTWOPROTECTEDANDDEFAULT YOUSTILLNEEDTO
KNOWWHATTHEYDOBECAUSEYOULLSEETHEMINOTHERCODE
\RXDUHKHUH
$FFHVV/HYHOVDQG$FFHVV0RGLÀHUVFRQW
GHIDXOWDQGSURWHFWHG
GHIDXOW
"OTHPROTECTEDANDDEFAULTACCESSLEVELSARETIEDTOPACKAGES$EFAULTACCESSISSIMPLEIT
MEANSTHATONLYCODEWITHINTHESAMEPACKAGECANACCESSCODEWITHDEFAULTACCESS3OA
DEFAULTCLASSFOREXAMPLEWHICHMEANSACLASSTHATISNTEXPLICITLYDECLAREDASPUBLIC CAN
BEACCESSEDBYONLYCLASSESWITHINTHESAMEPACKAGEASTHEDEFAULTCLASS
"UTWHATDOESITREALLYMEANTOACCESSACLASS#ODETHATDOESNOTHAVEACCESSTOACLASSIS
NOTALLOWEDTOEVENTHINKABOUTTHECLASS!NDBYTHINKWEMEANUSETHECLASSINCODE
&OREXAMPLEIFYOUDONTHAVEACCESSTOACLASSBECAUSEOFACCESSRESTRICTIONYOUARENT
ALLOWEDTOINSTANTIATETHECLASSOREVENDECLAREITASATYPEFORAVARIABLEARGUMENTOR
RETURNVALUE9OUSIMPLYCANTTYPEITINTOYOURCODEATALL)FYOUDOTHECOMPILERWILL
COMPLAIN
4HINKABOUTTHEIMPLICATIONSADEFAULTCLASSWITHPUBLICMETHODSMEANSTHEPUBLIC
METHODSARENTREALLYPUBLICATALL9OUCANTACCESSAMETHODIFYOUCANTSEETHECLASS
7HYWOULDANYONEWANTTORESTRICTACCESSTOCODEWITHINTHESAMEPACKAGE4YPICALLY
PACKAGESAREDESIGNEDASAGROUPOFCLASSESTHATWORKTOGETHERASARELATEDSET3OITMIGHT
MAKESENSETHATCLASSESWITHINTHESAMEPACKAGENEEDTOACCESSONEANOTHERSCODEWHILE
ASAPACKAGEONLYASMALLNUMBEROFCLASSESANDMETHODSAREEXPOSEDTOTHEOUTSIDE
WORLDIECODEOUTSIDETHATPACKAGE
/+THATSDEFAULT)TSSIMPLEIFSOMETHINGHASDEFAULTACCESSWHICHREMEMBERMEANS

NOEXPLICITACCESSMODIlER ONLYCODEWITHINTHESAMEPACKAGEASTHEDEFAULTTHING
CLASSVARIABLEMETHODINNERCLASS CANACCESSTHATTHING
4HENWHATSPROTECTEDFOR
SURWHFWHG
0ROTECTEDACCESSISALMOSTIDENTICALTODEFAULTACCESSWITHONEEXCEPTIONITALLOWSSUB
CLASSESTOINHERITTHEPROTECTEDTHINGEVENIFTHOSESUBCLASSESAREOUTSIDETHEPACKAGEOFTHESUPER
CLASSTHEYEXTEND4HATSIT4HATSALLPROTECTEDBUYSYOUTHEABILITYTOLETYOURSUBCLASSES
BEOUTSIDEYOURSUPERCLASSPACKAGEYETSTILLINHERITPIECESOFTHECLASSINCLUDINGMETHODS
ANDCONSTRUCTORS
-ANYDEVELOPERSlNDVERYLITTLEREASONTOUSEPROTECTEDBUTITISUSEDINSOMEDESIGNS
ANDSOMEDAYYOUMIGHTlNDITTOBEEXACTLYWHATYOUNEED/NEOFTHEINTERESTINGTHINGS
ABOUTPROTECTEDISTHATUNLIKETHEOTHERACCESSLEVELSPROTECTEDACCESSAPPLIESONLYTO
INHERITANCE)FASUBCLASS OUTSIDE THE PACKAGEHASAREFERENCETOANINSTANCEOFTHESUPERCLASS
THESUPERCLASSTHATHASSAYAPROTECTEDMETHOD THESUBCLASSCANTACCESSTHEPRO
TECTEDMETHODUSINGTHATSUPERCLASSREFERENCE4HEONLYWAYTHESUBCLASSCANACCESSTHAT
METHODISBYINHERITINGIT)NOTHERWORDSTHESUBCLASS OUTSIDE THE PACKAGEDOESNTHAVE
ACCESSTOTHEPROTECTEDMETHODITJUSTHASTHEMETHODTHROUGHINHERITANCE
DSSHQGL[%
6WULQJDQG6WULQJ%XIIHU DSSHQGL[%7RS7HQ5HIHUHQFH
6WULQJDQG6WULQJ%XIIHU6WULQJ%XLOGHU0HWKRGV
4WOOFTHEMOSTCOMMONLYUSEDCLASSESINTHE*AVA!0)ARE3TRINGAND3TRING"UFFERREMEMBERFROM
AFEWPAGESBACK3TRINGSAREIMMUTABLESOA3TRING"UFFER3TRING"UILDERCANBEALOTMOREFlCIENT
IFYOUREMANIPULATINGA3TRING !SOF*AVAYOUSHOULDUSETHE3TRING"UILDERCLASSINSTEADOF
3TRING"UFFERUNLESSYOUR3TRINGMANIPULATIONSNEEDTOBETHREAD SAFEWHICHISNOTCOMMON(ERESA
BRIEFOVERVIEWOFTHEKEYMETHODSINTHESECLASSES
"OTH3TRINGAND3TRING"UFFER3TRING"UILDERCLASSESHAVE
CHARCHAR!TINTINDEX WHATCHARISATACERTAINPOSITION
INTLENGTH HOWLONGISTHIS
3TRINGSUBSTRINGINTSTARTINTEND GETAPARTOFTHIS
3TRINGTO3TRING WHATSTHE3TRINGVALUEOFTHIS
4OCONCATENATE3TRINGS
3TRINGCONCATSTRING FORTHE3TRINGCLASS
3TRINGAPPEND3TRING FOR3TRING"UFFER3TRING"UILDER
4HE3TRINGCLASSHAS
3TRINGREPLACECHAROLDCHARNEW REPLACEALLOCCURENCESOFACHAR
3TRINGSUBSTRINGINTBEGININTEND GETAPORTIONOFA3TRING
CHAR;=TO#HAR!RRAY CONVERTTOANARRAYOFCHARS
3TRINGTO,OWER#ASE CONVERTALLCHARACTERSTOLOWERCASE
3TRINGTO5PPER#ASE CONVERTALLCHARACTERSTOUPPERCASE
3TRINGTRIM REMOVEWHITESPACEFROMTHEENDS
3TRINGVALUE/FCHAR;= MAKEA3TRINGOUTOFACHARARRAY
3TRINGVALUE/FINTI MAKEA3TRINGOUTOFAPRIMITIVE
OTHERPRIMITIVESARESUPPORTEDASWELL
4HE3TRING"UFFER3TRING"UILDERCLASSESHAVE
3TRING"XXXXDELETEINTSTARTINTEND DELETEAPORTION
3TRING"XXXXINSERTINTOFFSETANYPRIMITIVEORACHAR;= INSERTSOMETHING
3TRING"XXXXREPLACEINTSTARTINTEND3TRINGS REPLACETHISPARTWITHTHIS3TRING
3TRING"XXXXREVERSE REVERSETHE3"FROMFRONTTOBACK
VOIDSET#HAR!TINTINDEXCHARCH REPLACEAGIVENCHARACTER
.OTE3TRING"XXXXREFERSTOEITHER3TRING"UFFEROR3TRING"UILDERASAPPROPRIATE
\RXDUHKHUH
0XOWLGLPHQVLRQDO$UUD\V
)NMOSTLANGUAGESIFYOUCREATESAYAXTWO DIMENSIONALARRAYYOUWOULDVISUALIZEA
RECTANGLEELEMENTSBYELEMENTSWITHATOTALOFELEMENTS"UTIN*AVASUCHANARRAY
WOULDACTUALLYBEARRAYSLINKEDTOGETHER)N*AVAATWODIMENSIONALARRAYISSIMPLYANARRAY
OFARRAYS!THREEDIMENSIONALARRAYISANARRAYOFARRAYSOFARRAYSBUTWELLLEAVETHATFOR
YOUTOPLAYWITH (ERESHOWITWORKS
LQW>@>@DG QHZLQW>@>@
4HE*6-CREATESANARRAYWITHELEMENTS%ACHOFTHESEFOURELEMENTSISACTUALLYAREFERENCE
VARIABLEREFERRINGTOANEWLYCREATED INTARRAYWITHELEMENTS

HDFK
DG>@ UHJXODULQWVJRLQVPHLGQWHV
@ RIWKHHLJKW HOH DG>@>@
DG>@> >@>@
DG
DG>@>
@
LQWLQW LQWLQW

LQW
LQW
LQWDUUD\LQW>@ LQWDUUD\LQW>@
QW>@
LQWDUUD\L LQW
LQW

LQWDUU
D\LQW
>@
OHV
HIHUH QFHYDULDE
LQW>@U
LQW>@LQW>@LQW>@LQW>@
DG
5HPHPEHUWKDWWKHDU
LQWDUUD\REMHFWLQW>@>@ DQDUUD\KROGLQJUHI UD\LWVHOILVDQREMHFW
LQW>@>@ HUHQFHVWRLQWDUUD\V
:RUNLQJZLWKPXOWLGLPHQVLRQDODUUD\V
4OACCESSTHESECONDELEMENTINTHETHIRDARRAYLQW[ DG>@>@UHPHPEHUEDVHG
4OMAKEAONE DIMENSIONALREFERENCETOONEOFTHESUB ARRAYSLQW>@FRS\ DG>@
3HORT CUTINITIALIZATIONOFAXARRAYLQW>@>@[ ^^`^``
4OMAKEADARRAYWITHIRREGULARDIMENSIONS
LQW>@>@\ QHZLQW>@>@PDNHVRQO\WKH¿UVWDUUD\ZLWKDOHQJWKRI
\>@ QHZLQW>@PDNHVWKH¿UVWVXEDUUD\HOHPHQWVLQOHQJWK
\>@ QHZLQW>@PDNHVWKHVHFRQGVXEDUUD\HOHPHQWVLQOHQJWK
DSSHQGL[%
HQXPHUDWLRQV DSSHQGL[%7RS7HQ5HIHUHQFH
$QGWKHQXPEHURQHWRSLFWKDWGLGQ·WTXLWHPDNHLWLQ
(QXPHUDWLRQVDOVRFDOOHG(QXPHUDWHG7\SHVRU(QXPV
7EVETALKEDABOUTCONSTANTSTHATAREDElNEDINTHE!0)FORINSTANCE
-)UDPH(;,7B21B&/26(9OUCANALSOCREATEYOUROWNCONSTANTSBY
MARKINGAVARIABLEVWDWLF¿QDO"UTSOMETIMESYOULLWANTTOCREATEASET
OFCONSTANTVALUESTOREPRESENTTHEONLYVALIDVALUESFORAVARIABLE4HISSETOF
VALIDVALUESISCOMMONLYREFERREDTOASANENUMERATION"EFORE*AVAYOU
COULDONLYDOAHALF BAKEDJOBOFCREATINGANENUMERATIONIN*AVA!SOF*AVA
YOUCANCREATEFULLmEDGEDENUMERATIONSTHATWILLBETHEENVYOFALLYOUR
PRE *AVA USINGFRIENDS
7HOSINTHEBAND
,ETSSAYTHATYOURECREATINGAWEBSITEFORYOURFAVORITEBANDANDYOUWANTTO
MAKESURETHATALLOFTHECOMMENTSAREDIRECTEDTOAPARTICULARBANDMEMBER
4HEOLDWAYTOFAKEANhENUMv
SXEOLFVWDWLF¿QDOLQW-(55<
SXEOLFVWDWLF¿QDOLQW%2%%<
SXEOLFVWDWLF¿QDOLQW3+,/
ODWHULQWKHFRGH :H·UHKRSLQJWKDWE\WKHWLPHZHJRWKHUH
LIVHOHFWHG%DQG0HPEHU -(55<^
´VHOHFWHG%DQG0HPEHUµKDVDYDOLGYDOXH
GR-(55<UHODWHGVWXII
`
4HEGOODNEWSABOUTTHISTECHNIQUEISTHATIT$/%3MAKETHECODEEASIERTO
READ4HEOTHERGOODNEWSISTHATYOUCANTEVERCHANGETHEVALUEOFTHEFAKE
ENUMSYOUVECREATED-(55<WILLALWAYSBE4HEBADNEWSISTHATTHERES
NOEASYORGOODWAYTOMAKESURETHATTHEVALUEOFVHOHFWHG%DQG0HPEHU
WILLALWAYSBEOR)FSOMEHARDTOlNDPIECEOFCODESETS
VHOHFWHG%DQG0HPEHUEQUALTOITSPRETTYLIKELYYOURCODEWILLBREAK
\RXDUHKHUH
(QXPHUDWLRQVFRQW
4HESAMESITUATIONUSINGAGENUINE*AVAENUM7HILETHISISAVERYBASIC
Q
ENUMERATIONMOSTENUMERATIONSUSUALLYARETHISSIMPLE
V LP S OH F OD VVGHILQLWLR
NHD D
!NEWOFlCIALhENUMv RIORRNVOL HQXPV$5(
7KLVNLQG ,WWXUQVRXWWKDW FUHDWHGDQHZ
" H
SXEOLFHQXP0HPEHUV^-(55<%2%%<3+,/` GRHVQ·WLW RIFODVV+HUHZH·Y UVµ
N LQG H P E H
SXEOLF0HPEHUVVHOHFWHG%DQG0HPEHU VSHFLDO W\SHFDOOHG´0
W H G
HQXPHUD
ODWHULQWKHFRGH
7KH´VHOHFWHG%DQG0HPEHUµYDULDEOHLVRIW\SH
LIVHOHFWHG%DQG0HPEHU 0HPEHUV-(55<^ ´0HPEHUVµDQGFDQ21/<KDYHDYDOXHRI
GR-(55<UHODWHGVWXII ´-(55<µ´%2%%<µRU´3+,/µ
`
1RQHHGWRZRUU\DERXWWKLVYDULDEOH·VYDOXH 7KHV\QWD[WRUHIHUWRDQHQXP´LQVWDQFHµ
<RXUHQXPH[WHQGVMDYDODQJ(QXP
7HENYOUCREATEANENUMYOURECREATINGANEWCLASSANDYOUREIMPLICITLYEXTENDING
MDYDODQJ(QXP9OUCANDECLAREANENUMASITSOWNSTANDALONECLASSINITSOWN
SOURCElLEORASAMEMBEROFANOTHERCLASS
8VLQJ´LIµDQG´VZLWFKµZLWK(QXPV
5SINGTHEENUMWEJUSTCREATEDWECANPERFORMBRANCHESINOURCODEUSINGEITHER
THELIORVZLWFKSTATEMENT!LSONOTICETHATWECANCOMPAREENUMINSTANCESUSING
EITHER ORTHEHTXDOVMETHOD5SUALLY ISCONSIDEREDBETTERSTYLE
$VVLJQLQJDQHQXPYDOXHWRDYDULDEOH
0HPEHUVQ 0HPEHUV%2%%<
LIQHTXDOV0HPEHUV-(55<6\VWHPRXWSULQWOQ³-HUUUU\´
LIQ 0HPEHUV%2%%<6\VWHPRXWSULQWOQ³5DW'RJ´ R I W K H V H ZRUNILQH
%RWK
G
µLVSULQWH
0HPEHUVLI1DPH 0HPEHUV3+,/ ´5DW'RJ
VZLWFKLI1DPH^
FDVH-(55<6\VWHPRXWSULQW³PDNHLWVLQJ³
FDVH3+,/6\VWHPRXWSULQW³JRGHHS³ 3RS4XL]:KDW·VWKHRXWSXW"
FDVH%2%%<6\VWHPRXWSULQWOQ³&DVVLG\´
`
JRGHHS&DVVLG\
$QVZHU
DSSHQGL[%
HQXPHUDWLRQV DSSHQGL[%7RS7HQ5HIHUHQFH
(QXPHUDWLRQVFRPSOHWHG
$UHDOO\WULFNHGRXWYHUVLRQRIDVLPLODUHQXP
9OUCANADDABUNCHOFTHINGSTOYOURENUMLIKEACONSTRUCTORMETHODS
VARIABLESANDSOMETHINGCALLEDACONSTANT SPECIlCCLASSBODY4HEYRE
NOTCOMMONBUTYOUMIGHTRUNINTOTHEM
WR
SXEOLFFODVV+IM(QXP^
D Q D U J X PH QWSDVVHGLQORZ
7KLVLV HGEH
K H FR Q VW U X FWRUGHFODU
HQXP1DPHV^ W G
-(55<³OHDGJXLWDU´^SXEOLF6WULQJVLQJV^ 7KHVHDUHWKHVRFDOOHVVERGLHVµ
UHWXUQ³SODLQWLYHO\´` ´FRQVWDQWVSHFLILFFOD ULGLQJWKH
` 7KLQNRIWKHPDVRYHU WKLVFDVH
Licensed by EDVLFHQXPPHWKRGLQLIVLQJLV

%2%%<³UK\WKPJXLWDU´^SXEOLF6WULQJVLQJV^
UHWXUQ³KRDUVHO\´`
WKH´VLQJµPHWKRG WKDQHQXP
`
FDOOHGRQDYDULDEOHZL %%<
YDOXHRI-(55<RU%2
3+,/³EDVV´
Eduard Simons
SULYDWH6WULQJLQVWUXPHQW
1DPHV6WULQJLQVWUXPHQW^ 7KLVLVWKHHQXP·VFRQVWUXFWRU,WUXQV

WKLVLQVWUXPHQW LQVWUXPHQW RQFHIRUHDFKGHFODUHGHQXPYDOXHLQ
104038
`
WKLVFDVHLWUXQVWKUHHWLPHV
SXEOLF6WULQJJHW,QVWUXPHQW^
UHWXUQWKLVLQVWUXPHQW
`
SXEOLF6WULQJVLQJV^ <RX·OOVHHWKHVHPHWKRGVEHLQJFDOOHGIURP´PDLQµ
UHWXUQ³RFFDVLRQDOO\´
`
`
KD
(YHU\HQXPFRPHVZLW KRG
IRU1DPHVQ1DPHVYDOXHV^ HW
EXLOWLQÝDOXHVµP LQD
6\VWHPRXWSULQWQ
6\VWHPRXWSULQW³LQVWUXPHQW³QJHW,QVWUXPHQW ZKLFK
LVW\SLFDOO\XVHG
6\VWHPRXWSULQWOQ³VLQJV³QVLQJV ÍRUµORRSDVVKRZQ
`
`
` )LOH(GLW:LQGRZ+HOS%RRWOHJ
MDYD+IM(QXP
-(55<LQVWUXPHQWOHDGJXLWDUVLQJVSODLQWLYHO\
1RWLFHWKDWWKHEDVLF´VLQJµ
%2%%<LQVWUXPHQWUK\WKPJXLWDUVLQJVKRDUVHO\ PHWKRGLVRQO\FDOOHGZKHQWKH
3+,/LQVWUXPHQWEDVVVLQJVRFFDVLRQDOO\ HQXPYDOXHKDVQRFRQVWDQW
VSHFLILFFODVVERG\
\RXDUHKHUH
)LYH0LQXWH $/RQJ7ULS+RPH
0\VWHU\ &DSWDLQ%\WHRIWKH)ODWODQGVWDUVKLS³7UDYHUVHU´KDGUHFHLYHGDQXUJHQW7RS6HFUHWWUDQVPLVVLRQ
IURPKHDGTXDUWHUV7KHPHVVDJHFRQWDLQHGKHDYLO\HQFU\SWHGQDYLJDWLRQDOFRGHVWKDWWKH
7UDYHUVHUZRXOGQHHGWRVXFFHVVIXOO\SORWDFRXUVHKRPHWKURXJKHQHP\VHFWRUV7KHHQHP\
+DFNDULDQVIURPDQHLJKERULQJJDOD[\KDGGHYLVHGDGHYLOLVKFRGHVFUDPEOLQJUD\WKDWZDVFDSDEOH
RIFUHDWLQJERJXVREMHFWVRQWKHKHDSRIWKH7UDYHUVHU¶VRQO\QDYLJDWLRQDOFRPSXWHU,Q
DGGLWLRQWKHDOLHQUD\FRXOGDOWHUYDOLGUHIHUHQFHYDULDEOHVVRWKDWWKH\UHIHUUHGWRWKHVH
ERJXVREMHFWV7KHRQO\GHIHQVHWKH7UDYHUVHUFUHZKDGDJDLQVWWKLVHYLO+DFNDULDQUD\ZDV
WRUXQDQLQOLQHYLUXVFKHFNHUZKLFKFRXOGEHLPEHGGHGLQWRWKH7UDYHUVHU¶VVWDWHRIWKHDUW
-DYDFRGH
&DSWDLQ%\WHJDYH(QVLJQ6PLWKWKHIROORZLQJSURJUDPPLQJLQVWUXFWLRQVWRSURFHVVWKHFULWLFDO
QDYLJDWLRQDOFRGHV
³3XWWKH¿UVW¿YHFRGHVLQDQDUUD\RIW\SH3DUVHF.H\3XWWKHODVWFRGHVLQD¿YHE\¿YHWZR
GLPHQVLRQDODUUD\RIW\SH4XDGUDQW.H\3DVVWKHVHWZRDUUD\VLQWRWKHSORW&RXUVHPHWKRGRIWKH
SXEOLF¿QDOFODVV6KLS1DYLJDWLRQ2QFHWKHFRXUVHREMHFWLVUHWXUQHGUXQWKHLQOLQHYLUXVFKHFNHU
DJDLQVWDOOWKHSURJUDPVUHIHUHQFHYDULDEOHVDQGWKHQUXQWKH1DY6LPSURJUDPDQGEULQJPHWKH
UHVXOWV´
$IHZPLQXWHVODWHU(QVLJQ6PLWKUHWXUQHGZLWKWKH1DY6LPRXWSXW³1DY6LPRXWSXWUHDG\IRU
UHYLHZVLU´GHFODUHG(QVLJQ6PLWK³)LQHÚHSOLHGWKH&DSWDLQ³3OHDVHUHYLHZ\RXUZRUN´³<HV
VLUÚHVSRQGHGWKH(QVLJQ³)LUVW,GHFODUHGDQGFRQVWUXFWHGDQDUUD\RIW\SH3DUVHF.H\ZLWKWKH
IROORZLQJFRGH3DUVHF.H\>@S QHZ3DUVHF.H\>@QH[W,GHFODUHGDQGFRQVWUXFWHGDQDUUD\
RIW\SH4XDGUDQW.H\ZLWKWKHIROORZLQJFRGH4XDGUDQW.H\>@>@T QHZ4XDGUDQW.H\>@>@
1H[W,ORDGHGWKH¿UVWFRGHVLQWRWKH3DUVHF.H\DUUD\XVLQJDµIRU¶ORRSDQGWKHQ,ORDGHGWKHODVW
FRGHVLQWRWKH4XDGUDQW.H\DUUD\XVLQJQHVWHGµIRU¶ORRSV1H[W,UDQWKHYLUXVFKHFNHUDJDLQVW
DOOUHIHUHQFHYDULDEOHVIRUWKH3DUVHF.H\DUUD\DQGIRULWVHOHPHQWVIRUWKH4XDGUDQW.H\
DUUD\DQGIRULWVHOHPHQWV2QFHWKHYLUXVFKHFNUHWXUQHGZLWKQRYLUXVHVGHWHFWHG,UDQWKH
1DY6LPSURJUDPDQGUHUDQWKHYLUXVFKHFNHUMXVWWREHVDIH«6LU³
&DSWDLQ%\WHJDYHWKH(QVLJQDFRROORQJVWDUHDQGVDLGFDOPO\³(QVLJQ\RXDUHFRQ¿QHGWR
TXDUWHUVIRUHQGDQJHULQJWKHVDIHW\RIWKLVVKLS,GRQ¶WZDQWWRVHH\RXUIDFHRQWKLVEULGJHDJDLQ
XQWLO\RXKDYHSURSHUO\OHDUQHG\RXU-DYD/LHXWHQDQW%RROHDQWDNHRYHUIRUWKH(QVLJQDQGGRWKLV
MREFRUUHFWO\´
:K\GLGWKHFDSWDLQFRQ¿QHWKH(QVLJQWRKLVTXDUWHUV"
DSSHQGL[%
SX]]OHDQVZHUV DSSHQGL[%7RS7HQ5HIHUHQFH
)LYH0LQXWH0\VWHU\6ROXWLRQ
!,ONG4RIP(OME
#APTAIN"YTEKNEWTHATIN*AVAMULTIDIMENSIONALARRAYSAREACTU
ALLYARRAYSOFARRAYS4HElVEBYlVE1UADRANT+EYARRAY@QWOULD
ACTUALLYNEEDATOTALOFREFERENCEVARIABLESTOBEABLETOACCESS
ALLOFITSCOMPONENTS
REFERENCEVARIABLEFOR@Q
REFERENCEVARIABLESFORQ;= Q;=
REFERENCEVARIABLESFORQ;=;= Q;=;=
4HEENSIGNHADFORGOTTENTHEREFERENCEVARIABLESFORTHElVEONE
DIMENSIONALARRAYSEMBEDDEDINTHE@QARRAY!NYOFTHOSElVE
REFERENCEVARIABLESCOULDHAVEBEENCORRUPTEDBYTHE(ACKARIAN
RAYANDTHEENSIGNSTESTWOULDNEVERREVEALTHEPROBLEM
\RXDUHKHUH

Headfirst Java 2 ND Edition PDF

Încărcat de

Informații document

Titlu original

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

Headfirst Java 2 ND Edition PDF

Încărcat de

Drepturi de autor:

Formate disponibile

Table of Contents

#OPYRIGHT¥ BY/2EILLY-EDIA )NC!LLRIGHTSRESERVED

0UBLISHEDBY/2EILLY-EDIA )NC 'RAVENSTEIN(IGHWAY.ORTH 3EBASTOPOL #!

4HE/2EILLYLOGOISAREGISTEREDTRADEMARKOF/2EILLY-EDIA )NC*AVAANDALL*AVA BASED

h)TSFAST IRREVERENT FUN ANDENGAGING"ECAREFULYOUMIGHTACTUALLYLEARNSOMETHINGv

h)FYOUWANTTOLEARN*AVA LOOKNOFURTHERWELCOMETOTHElRST'5) BASEDTECHNICALBOOK4HIS

h)WAS!$$)#4%$TOTHEBOOKSSHORTSTORIES ANNOTATEDCODE MOCKINTERVIEWS ANDBRAINEXERCISESv

h)LAUGHED )CRIED ITMOVEDMEv

h*USTTHERIGHTTONEFORTHEGEEKED OUT CASUAL COOLGURUCODERINALLOFUS4HERIGHTREFERENCEFORPRAC

Other books in O’Reilly’s Head First series

2IÎ 2IÎ 2IÎ 2IÎ

3LOW !LITTLEFASTER CLASSES CLASSES

6KDUSHQ \RXU SHQFLO

LQWVL]H  GHFODUHDQLQWHJHUYDULDEOHQDPHG¶VL]H·DQGJLYHLWWKHYDOXH

6KDUSHQ \RXU SHQFLO JW\`N[\

LQWVL]H  GHFODUHDQLQWHJHUYDULDEOHQDPHG¶VL]H·DQGJLYHLWWKHYDOXH

ZKLOH [! ^ NHHSORRSLQJDVORQJDV[LVJUHDWHUWKDQ

LQW>@QXP/LVW ^` GHFODUHDOLVWRILQWHJHUVYDULDEOH¶QXP/LVW·DQGSXWLQWRWKHOLVW

3XWDFODVVLQDVRXUFHÀOH :KDWJRHVLQD SXEOLFFODVV'RJ^

WKLVLVD WKHQDPHRI RSHQLQJFXUO\EUDFH

6\VWHPRXWSULQW ³,5XOH´  HQW0867

ZKLOH PRUH%DOOV WUXH ^

ERROHDQLV+RW WUXH  3XWDERROHDQWHVWLQVLGHSDUHQWKHVHV

"UTWECANADDANELSETOTHECONDITION SOTHATWECAN PUBLICCLASS$OO"EE[

2. &OREACHOFTHETHREELISTSARRAYS THEGOALISTOPICKARANDOMWORD SOWEHAVE

3.7ENEEDTHREERANDOMNUMBERS*AVASHIPSOUT OF THE BOX OFF THE SHELF SHRINK

5.&INALLY WEPRINTTHEPHRASETOTHECOMMAND LINEANDVOILA7EREINMARKETING

1dQ^OU_Q Code Magnets

"%THECOMPILER LI [ ^

1UITEACREWOFCHARACTERS #OMEBACKEMPTY HANDED

6\VWHPRXWSULQW [³³\³³ 

3RRO3X]]OH ZKLOH BBBBBBBBBB ^

LI [  ^ 6\VWHPRXWSULQW [³³\³³ 

6KRSSLQJ&DUW %XWWRQ $ODUP

NLQVWDQFHYDULDEOHV QV[\IVKM WLWOH SVW_[

4HINGSANOBJECTKNOWSABOUTITSELFARECALLEDINSTANCE 6KDUSHQ \RXU SHQFLO

4HE-OVIE4EST$RIVECLASSCREATESOBJECTSINSTANCES OF REMHFW  JHQUH

 4HE'UESS'AMEOBJECTSSTART'AME METHODISWHERETHEENTIREGAMEPLAYSOUT JXHVV D

A: A: 9ES ITWOULDBEABIG RIDQREMHFW

LI WFDQ5HFRUG WUXH ^ LI GFDQ5HFRUG WUXH ^

!BUNCHOF*AVACOMPONENTS INFULLCOSTUME AREPLAYINGAPARTY

YRLGSOD\7RS+DW ^ LI WFDQ5HFRUG WUXH ^

)THASASIZE ANDATYPE)NTHISCHAPTER WEREGOINGTOLOOKlRSTATTHE QXPHULF DOODUHVLJQHG

AW]ZMITTaLWV¼\_IV\\W[XQTT\PI\ 6KDUSHQ \RXU SHQFLO

LQWVL]H  GHFODUHDQLQWQDPHGVL]HDVVLJQLWWKHYDOXH V \

3OMETHINGTHATGOESINACUP 'RJP\'RJ QHZ'RJ 

'RJP\'RJ QHZ'RJ  'RJR

6KDUSHQ \RXU SHQFLO

1dQ^OU_Q Code Magnets

` %K>]@QDPH ´ELOERµ

+ITTQVOI\ _WXIZIUM \MZUM \PWLIVL[MVLQVO

[GRHVQ DUHQ·W  &KDQJHWKHYDOXHRI]LQVLGH

4HISWOULDBEA"AD4HING7ENEEDTO SXEOLFYRLGVHW+HLJKW LQWKW ^

MDYD3RRU'RJ7HVW'ULYH SULPLWLYHV LQ HUHQFHYDULDEOHVJHWQXOO

4HEOPERATORCANBEUSEDTOCOMPARETWOVARIABLESOFANYKIND ANDIT WKHELW

LQWD FDOF$UHD  

LQW\ [JR RULJ  YRLGJHW7LPH ^

1dQ^OU_Q !BUNCHOF*AVACOMPONENTS INFULLCOSTUME AREPLAYINGAPARTY

D P ," INSTANCEVARIABLE ARGUMENT RETURN GETTER SETTER

:K R ENCAPSULATION PUBLIC PRIVATE PASSBYVALUE METHOD

LQGH[ LI ^

GRID7HENTHATSCOMPLETE THEGAMEASKSFORYOURlRST MDYD'RW&RP%XVW

()'0%6)EGLIGO=SYVWIPJ QIXLSHXLEXXEOIWE7XVMRKJSVXLIYWIV´WKYIWW ±²±²IXG 

#OPYRIGHT¥BY/2EILLY-EDIA)NC!LLRIGHTSRESERVED

0UBLISHEDBY/2EILLY-EDIA)NC'RAVENSTEIN(IGHWAY.ORTH3EBASTOPOL#!

4HE/2EILLYLOGOISAREGISTEREDTRADEMARKOF/2EILLY-EDIA)NCAVAANDALLAVA BASED

h)TSFASTIRREVERENTFUNANDENGAGING"ECAREFULYOUMIGHTACTUALLYLEARNSOMETHINGv

h)FYOUWANTTOLEARN*AVALOOKNOFURTHERWELCOMETOTHElRST'5) BASEDTECHNICALBOOK4HIS

h)WAS!$$)#4%$TOTHEBOOKSSHORTSTORIESANNOTATEDCODEMOCKINTERVIEWSANDBRAINEXERCISESv

h)LAUGHED)CRIEDITMOVEDMEv

h*USTTHERIGHTTONEFORTHEGEEKED OUTCASUAL COOLGURUCODERINALLOFUS4HERIGHTREFERENCEFORPRAC

2IÎ 2IÎ 2IÎ 2IÎ

3LOW !LITTLEFASTER CLASSES CLASSES

LQWVL]H GHFODUHDQLQWHJHUYDULDEOHQDPHG¶VL]H·DQGJLYHLWWKHYDOXH

LQWVL]H GHFODUHDQLQWHJHUYDULDEOHQDPHG¶VL]H·DQGJLYHLWWKHYDOXH

ZKLOH[!^ NHHSORRSLQJDVORQJDV[LVJUHDWHUWKDQ

LQW>@QXP/LVW ^` GHFODUHDOLVWRILQWHJHUVYDULDEOH¶QXP/LVW·DQGSXWLQWRWKHOLVW

3XWDFODVVLQDVRXUFHÀOH :KDWJRHVLQD SXEOLFFODVV'RJ^

6\VWHPRXWSULQW³,5XOH´ HQW0867

ZKLOHPRUH%DOOV WUXH^

ERROHDQLV+RW WUXH 3XWDERROHDQWHVWLQVLGHSDUHQWKHVHV

"UTWECANADDANELSETOTHECONDITIONSOTHATWECAN PUBLICCLASS$OO"EE[

2. &OREACHOFTHETHREELISTSARRAYS THEGOALISTOPICKARANDOMWORDSOWEHAVE

3.7ENEEDTHREERANDOMNUMBERS*AVASHIPSOUT OF THE BOXOFF THE SHELFSHRINK

5.&INALLYWEPRINTTHEPHRASETOTHECOMMAND LINEANDVOILA7EREINMARKETING

"%THECOMPILER LI[^

1UITEACREWOFCHARACTERS #OMEBACKEMPTY HANDED

6\VWHPRXWSULQW[³³\³³

3RRO3X]]OH ZKLOHBBBBBBBBBB^

LI[ ^ 6\VWHPRXWSULQW[³³\³³

4HE-OVIE4EST$RIVECLASSCREATESOBJECTSINSTANCES OF REMHFW JHQUH

4HE'UESS'AMEOBJECTSSTART'AME METHODISWHERETHEENTIREGAMEPLAYSOUT JXHVV D

A: A: 9ESITWOULDBEABIG RIDQREMHFW

LIWFDQ5HFRUG WUXH^ LIGFDQ5HFRUG WUXH^

!BUNCHOF*AVACOMPONENTSINFULLCOSTUMEAREPLAYINGAPARTY

YRLGSOD\7RS+DW^ LIWFDQ5HFRUG WUXH^

)THASASIZEANDATYPE)NTHISCHAPTERWEREGOINGTOLOOKlRSTATTHE QXPHULFDOODUHVLJQHG

AW]ZMITTaLWV¼\_IV\\W[XQTT\PI\ 6KDUSHQ \RXU SHQFLO

LQWVL]H GHFODUHDQLQWQDPHGVL]HDVVLJQLWWKHYDOXH V \

3OMETHINGTHATGOESINACUP 'RJP\'RJ QHZ'RJ

'RJP\'RJ QHZ'RJ 'RJR

` %K>]@QDPH ´ELOERµ

+ITTQVOI\ _WXIZIUM \MZUM \PWLIVL[MVLQVO

[GRHVQ DUHQ·W &KDQJHWKHYDOXHRI]LQVLGH

4HISWOULDBEA"AD4HING7ENEEDTO SXEOLFYRLGVHW+HLJKWLQWKW^

MDYD3RRU'RJ7HVW'ULYH SULPLWLYHVLQ HUHQFHYDULDEOHVJHWQXOO

4HEOPERATORCANBEUSEDTOCOMPARETWOVARIABLESOFANYKINDANDIT WKHELW

LQWD FDOF$UHD

LQW\ [JRRULJ YRLGJHW7LPH^

1dQ^OU_Q !BUNCHOF*AVACOMPONENTSINFULLCOSTUMEAREPLAYINGAPARTY

D P ," INSTANCEVARIABLEARGUMENTRETURNGETTERSETTER

:K R ENCAPSULATIONPUBLICPRIVATEPASSBYVALUEMETHOD

LQGH[ LI^

GRID7HENTHATSCOMPLETETHEGAMEASKSFORYOURlRST MDYD'RW&RP%XVW

()'0%6)EGLIGO=SYVWIPJ QIXLSHXLEXXEOIWE7XVMRKJSVXLIYWIV´WKYIWW±²±²IXG

6)4)%8[MXLIEGLSJXLIPSGEXMSRGIPPWMRXLIMRXEVVE] &UHDWHD6WULQJWRUHSUHVHQWDXVHUJXHVV

IRULQWL LL^ MDYD7HVW

IRULQW[ [[^

[ [ PDWFKHDFKLWK

[ [ SRVVLEOHRXW

SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^ SXEOLFVWDWLFYRLGPDLQ6WULQJ>@DUJV^

LQWJXHVV ,QWHJHUSDUVH,QWVWULQJ*XHVV

IRULQWFHOOORFDWLRQ&HOOV^ 5HSHDWZ

6WULQJD QHZ6WULQJ³ZKRRKRR´

6WULQJE QHZ6WULQJ³)URJ´

6WULQJD QHZ6WULQJ³ZKRRKRR´ 6WULQJD QHZ6WULQJ³ZKRRKRR´

6WULQJE QHZ6WULQJ³)URJ´ 6WULQJE QHZ6WULQJ³)URJ´

LQWWKH6L]H P\/LVWVL]H LQWWKH6L]H P\/LVWOHQJWK

ERROHDQLV,Q P\/LVWFRQWDLQVE ERROHDQLV,Q IDOVH

LIEHTXDOVLWHP^

.OTICEHOWWITH!RRAY,ISTYOUREWORKING 7ITHANARRAYYOUUSESPECIALARRAYSYNTAXLIKE

LIQXP2I+LWV ORFDWLRQ&HOOVOHQJWK^

7KHJDPHFODVV 7KHDFWXDO 7KHKHOSHUFODVV

'RW&RP%XVW 7KHPDLQPHWKRG

SXEOLFYRLGVHW/RFDWLRQ&HOOV$UUD\/LVW6WULQJ!ORF^ $VHWWHUPHWKRGWKDWXSGDWHV

@)FTHEPRICERANGEISBETWEENANDTHENCHOOSE8 6KRUW&LUFXLW2SHUDWRUV __

LIUHI9DU QXOO

ZKLOHVXFFHVV DWWHPSWV^PDLQVHDUFKORRS

LIDLQGH[2I³IRXU´ ^

LIDFRQWDLQV³WKUHH´^

LIDLQGH[2I³IRXU´ ^

LIDFRQWDLQV³WZR´^

.ZQML-OO5IV LWM[V¼\ VMML IVa JMPI^QWZ \PI\¼[ ]VQY]M