Friends of OpenJDK Today

Book Review: “Java by Comparison”

June 02, 2021

Author(s)

The book “Java by Comparison” by Simon Harrer, Jörg Lenhard, and Linus Dietz, promises the reader to become a “Java Craftsman” through the study of 70 examples. The book is published by The Pragmatic Bookshelf.

Each “example” is structured as a before-and-after comparison. It's best to illustrate that with, well, an example:

Return Boolean Expressions Directly

Before:

boolean isValid() {
   if (missions < 0 || name == null || name.trim().isEmpty()) {
      return false;
   } else {
      return true;
   }
}

After:

boolean isValid() {
   return missions >= 0 && name != null && !name.trim().isEmpty();
}

If you, dear reader, are wondering why and how to transform the former into the latter, then this book is for you. The authors imagine their audience as someone who knows the basics of the Java language, perhaps from a university curriculum, and who can pass Fizz Buzz.

Or you may have people on your team who should be doing this kind of transformation but aren't. Then give them a copy.

As an aside, I had the nagging question why the authors use name.trim().isEmpty() and not name.isBlank(). Then I realized that the book was written before Java 11. There is a section Favor Java API over DIY that exhorts readers to be on top of the ever-evolving Java API.

Here is another nice piece of advice, Favor format over Concatenation, which shows how to rewrite:

String entry = author.toUpperCase() + ": [" + formattedMonth + "-" +
   today.getDayOfMonth() + "-" + today.getYear() + "](Day " +
   (ChronoUnit.DAYS.between(start, today) + 1) + ")> " +
   message + System.lineSeparator();

...using String.format, or, as of Java 15, the formatted method of the String class.

I liked the fact that each of the 70 “examples” was short and easily digestible in one sitting. The items are also carefully cross-linked.

The items are grouped into nine chapters:

  1. Simple clean-up
  2. Code style
  3. Comments
  4. Naming
  5. Exceptions
  6. Unit testing
  7. Class design
  8. Streams
  9. Tools

My favorite was the “unit testing” chapter. I hadn't seen this advice in a single place before.

One problem that every book author faces is how to pick code examples. If an example is too long, readers can easily get overwhelmed. If the example is too simplistic, it can be hard for readers to match it up with realistic situations.

I generally try to pick examples that revolve around tasks that most programmers have seen before, such as processing of invoices or web pages. But that can be difficult when the intended audience hasn't done much programming yet. The authors of this book chose an “astronaut” theme for the sample code so that readers have some intuition. That is better than animals that bark and quack, but it's not perfect. Consider this example:

Before:

class Hull {
   int holes;
}
class HullRepairUnit {
   void repairHole(Hull hull) {
      if (isIntact(hull)) {
         return;
      }
   hull.holes--;
}

   boolean isIntact(Hull hull) {
      return hull.holes == 0;
   }
}

When I first saw this code snippet, it didn't remind me of anything I had seen before. In my experience, students don't commonly write code that puts the data in one class and the methods into another. Maybe some enterprise pattern???

The suggested refactoring is:

After:

class Hull {
   int holes;
   void repairHole() {
      if (isIntact()) {
         return;
      }
      holes--;
   }
   boolean isIntact() {
       return holes == 0;
   }
}

Sure, that's better. The authors must have seen this in the wild, since they write with passion to Combine State and Behavior.

The book has all the right guidance about Optional: Favor Optional over null. Avoid Optional fields. Use filter and map/flatMap with Optional. But I was baffled by the title of the last item. It's called Use Optionals as Streams. Of length 0 or 1, that is. I am not sure that title works well for beginners. Optionals aren't streams. There are only three common methods. I'd just name the methods, as in fact I just did.

Finally, is it really necessary to Avoid Single-Letter Names at all cost? What about loop indexes? Type parameters?

Those are just quibbles of the kind that every book review must have. I thought the book was fun and easy to read. Many intermediate level developers would benefit from it.

I learned something new myself. In the item Document Using Examples, the authors point out that one can embed comments inside regular expressions. It looks even better with text blocks:

var regex = """
(?x:(([1-9]|1[0-2]) #hours
:([0-5][0-9])) #minutes
[ap]m)""";

It had never occurred to me to do that, but it seems like a good idea. And of course, as the authors point out, with a complex regular expressions, a few examples do wonders: 11:59am, 1:05pm. Here is one more thing I like. It's a book! Carefully edited, cross-referenced, reviewed, and typeset. Not a bunch of blog articles.

In conclusion, I can warmly recommend this book to Java programmers who have learned to code and strive to code well. Don't take every item as gospel, but think about each of them. And, as I said, if you have people on your team who would benefit from this kind of advice, get them a copy. You'll be glad you did.

Related Articles

View All
  • Book Review: “Help Your Boss Help You”

    Some books were written to be read once and put aside, others to be read thoroughly several times and then to be placed behind glass to be broken in case of emergency.

    This book is of the latter kind—once you’ve read through it a few times, and dipped into the areas that speak to you most, you want to have it nearby both as a PDF and in hard copy format—as a backup just in case you can’t find that PDF at the crucial moment when you really need to have a response at hand in times of crisis.

    Read More
    Avatar photo
    August 13, 2021
  • Book Review: “Seriously Good Software”

    Marco Faella’s book “Seriously Good Software” teaches intermediate Java programmers to write better software, using an entirely different approach.

    I can warmly recommend this book to Java programmers who have learned to code and strive to code well.

    I think it is a particularly rewarding read for computer science students who had several semesters of disjointed knowledge of programming, algorithms, computing systems, and software engineering.

    Read More
    July 22, 2021
  • OpenJDK vs. OpenJFX Release Cycles

    Confused about the release cycles of OpenJDK and OpenJFX and the relationship between them? Read on to have all your questions answered.

    At this moment, there are no planned features or changes in OpenJFX which require new JDK features (text blocks, records, etc), so the next releases of OpenJFX will most probably still be compatible with JDK 11.

    Read More
    Avatar photo
    October 29, 2020

Author(s)

Comments (0)

Your email address will not be published. Required fields are marked *

Highlight your code snippets using [code lang="language name"] shortcode. Just insert your code between opening and closing tag: [code lang="java"] code [/code]. Or specify another language.

Save my name, email, and website in this browser for the next time I comment.

Subscribe to foojay updates:

https://foojay.io/feed/
Copied to the clipboard