Why should one use Objects.requireNonNull()?

by

Because you can make things explicit by doing so. Like:

public class Foo {
  private final Bar bar;

  public Foo(Bar bar) {
    Objects.requireNonNull(bar, "bar must not be null");
    this.bar = bar;
  }

Or shorter:

  this.bar = Objects.requireNonNull(bar, "bar must not be null");

Now you know:

  • when a Foo object was successfully created using new()
  • then its bar field is guaranteed be non-null.

Compare that to: you create a Foo object today, and tomorrow you invoke a method that uses that field and throws. Most likely, you will not know tomorrow why that reference was null yesterday when it got passed to the constructor!

In other words: by explicitly using this method to check incoming references you can control the point in time when the exception will be thrown. And most of the time, you want to fail as fast as possible!

The major advantages are:

  • as said, controlled behavior
  • easier debugging – because you throw up in the context of the object creation. At a point in time where you have a certain chance that your logs/traces tell you what went wrong!
  • and as shown above: the true power of this idea unfolds in conjunction with final fields. Because now any other code in your class can safely assume that bar isn’t null – and thus you do not need any if (bar == null) checks in other places!

More Related Contents:

  1. java.lang.NullPointerException is thrown using a method-reference but not a lambda expression
  2. Filter values only if not null using lambda in Java8
  3. Why use Optional.of over Optional.ofNullable?
  4. How will Java lambda functions be compiled?
  5. NullPointerException in Collectors.toMap with null entry values
  6. Why is String.chars() a stream of ints in Java 8?
  7. Using Java 8’s Optional with Stream::flatMap
  8. Java 8’s streams: why parallel stream is slower?
  9. Null check chain vs catching NullPointerException
  10. Difference between year-of-era and week-based-year?
  11. Unit testing a class with a Java 8 Clock
  12. Optional orElse Optional in Java
  13. Modifying local variable from inside lambda
  14. Transform Java Future into a CompletableFuture
  15. What does “an Arbitrary Object of a Particular Type” mean in java 8?
  16. JavaFX on Linux is showing a “Graphics Device initialization failed for : es2, sw”
  17. How do I create a Stream of regex matches?
  18. How to extract epoch from LocalDate and LocalDateTime?
  19. Java 8 Lambda Expression Within REST Service not working
  20. Java 8 timezone conversions
  21. Can a java lambda have more than 1 parameter?
  22. Get original pattern String given a JDK 8 DateTimeFormatter?
  23. Are defaults in JDK 8 a form of multiple inheritance in Java?
  24. What’s the purpose of partitioningBy
  25. How to implement a Java stream?
  26. Why didn’t Stream have a toList() method?
  27. Using method reference instead of multi argument lambda
  28. Consumer mapped Class in HashMap
  29. Get last element of Stream/List in a one-liner
  30. Java 8 Supplier Exception handling with CompletableFuture

Leave a Comment