prmr / designbook

Companion repository for the book "Introduction to Software Design with Java"

Introduction to Software Design with Java

Companion web site for the book "Introduction to Software Design with Java" by Martin P. Robillard, Springer 2019 and its second edition, 2022.

Errata

Check the Errata for clarifications and corrections. If you spot a problem that is not listed, please check the issues and open a new one if the problem has not yet been reported.

• Errata for the First Edition;
• Errata for the Second Edition;

Source Code

There are three source folders on this site:

• chapter-code The complete and commented version of the code samples for the first edition of the book;
• chapter-code-2ndEdition The complete and commented version of the code samples for the second edition of the book.
• solutions-code The complete version of the code file for selected exercises. The code files are referenced from the appropriate solutions pages.

Although you can browse the code on GitHub, the recommended way to peruse the code samples is to clone the repository. The repository includes the configurations files necessary to build the code automatically in Eclipse. However, because some code relies on the JavaFX library, you also need to:

1. Download the JavaFX SDK and unzip it to a desired location;
2. Create a new User Library under Eclipse -> Window -> Preferences -> Java -> Build Path -> User Libraries -> New
3. Name it JavaFX and include the jars under the lib folder from your unzipped JavaFX download location.

Web Version of the Code with Additional Documentation

NEW! You can now view all the chapter code samples with additional on-demand documentation accessible directly from the code. Check out our Cascading Documentation (CasDoc) demo.

Practice Exercises

The exercises are meant to be completed in order, after studying each chapter. Exercises tagged with a star (:star:) are challenging and those tagged with a magnifying glass (:mag:) are based on the exploration of the sample applications.

Chapter	Exercises	Solutions
1	Exercises	Solutions
2	Exercises	Solutions
3	Exercises	Solutions
4	Exercises	Solutions
5	Exercises	Solutions
6	Exercises	Solutions
7	Exercises	Solutions
8	Exercises	Solutions
9	Exercises	Solutions

Acknowledgements

Thanks to Samuel Beaubien, Neil Ernst, Benjamin Lee, Christian Joudrey, and joshuamanascu for flagging errors via this site.

A special thanks to the software design educators who have adopted the book to support their teaching. To be included in the list, please fill in this form.

Name	Institution	Course
Jin Guo	McGill University	Software Design
Neil Ernst	University of Victoria	Object-Oriented Design
Kostadin Damevski	Virginia Commonwealth University	Software Engineering: Design and Implementation
Mattia Monga	Università Degli Studi Di Milano	Computer Programming II
Carlo Nicola Maria Bellettini	Università Degli Studi Di Milano	Computer Programming II
Alberto Bacchelli	University of Zurich	Software Construction
Gerardo Canfora	University of Sannio	Software Engineering

License

Unless otherwise noted, the content of this repository is licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License.

Copyright Martin P. Robillard 2019-2022

designbook's Issues

Chapter 4, page 77 small typo

Hi prof @prmr ,

Just wanted to let you know on page 77, at the end of the Special values of an enumerated type bullet point, that:

although we have four ranks and 13 suits

Should probably be reversed, like so:

although we have 13 ranks and four suits

Cheers!

Typo ch. 1, p. 3

"At this point the only thing left it to put the poem together by assembling the
twelve verses."

Should be:

"At this point the only thing left is to put the poem together by assembling the
twelve verses."

Deprecated libraries in Chapter 8

The following Java libraries are deprecated because of a lack of event richness:

• java.util.Observable
• java.util.Observer

Other libraries such as java.beans.PropertyChangeListener, java.beans.PropertyChangeSupport, java.util.concurrent.Flow are more versatile (and might be worth expanding on in class!).

Chapter 7 Exercise 5: typos

Missing ")" for

   return String.format("%s: %s (%d minutes", title(), extra(), time());

and missing : in problem description to be consistent with solution:

$TITLE$ [...] ($TIME$ minutes)

Chapter 8, Page 200 typo: Wrong section number referenced for ISP

Current version:

Fortunately, we saw how to deal with this situation with the Interface Segregation Principle (ISP, see Section 3.2).

Correction:

Fortunately, we saw how to deal with this situation with the Interface Segregation Principle (ISP, see Section 3.8).

Chapter 8, Page 270 - Minor typo

Just noticed a small typo on page 270 that I thought you might want to be made aware of:

It some cases, however, we want to be able to operate ...

Should probably read:

In some cases, however, we want to be able to operate ...

Chapter 8, Page 234 - Missing line break in code sample

Hello @prmr,

I wanted to let you know that there is missing a line break on line 7 of the code sample on page 234.

The code is still readable, but could be a quick fix in the next version. 😄

Typo fig 7.5

MemorizingDeck should have field named aDrawnCards not aCards

Typo 9.4, Page 255 `comparator` should be `Comparator`

Currently, the book calls comparator.comparing, but comparator is the name of an instance that has not been constructed yet.

Comparator<Card> comparator =
comparator.comparing(Card::getSuit());

The correct code should be capitalized Comparator.comparing because comparing is a static method in the Comparator class.

Comparator<Card> comparator =
Comparator.comparing(Card::getSuit());