http://www.developer.com/java/java-7-feature-asserting-non-null-objects.html

Back to article

Java 7 Feature: Asserting Non-Null Objects


March 30, 2011

Starting with JDK 7, you can assert non-null objects with two java.util.Objects methods:

  • <T> T nonNull(T obj): This method checks that the specified object reference is not null. It returns obj if the reference is not null, or NullPointerException otherwise.
  • <T> T nonNull(T obj, String message): This method checks that the specified object reference is not null and throws a customized NullPointerException if it is. It returns obj, the object reference to check for nullity, or message, a detailed message to be used in the event that a NullPointerException is thrown.

Here is an example of the two java.util.Objects methods:

package jdk7_nonnull;

import java.util.Objects;

public class Main {

public static void main(String[] args) {

//create a null String object
String nullString = null;
//create a non-null String object
String nonNullString = "Java 7 Rocks!";

//returns nonNullString
String c_nonNullString = Objects.nonNull(nonNullString);
System.out.println(c_nonNullString);

//throw a NullPointerException
String c_nullString_1 = Objects.nonNull(nullString);

//throw a customize NullPointerException
String c_nullString_2 = Objects.nonNull(nullString, "This String is null!");
}
}

Here's the output:

Java 7 Rocks!
Exception in thread "main" java.lang.NullPointerException
at java.util.Objects.nonNull(Objects.java:201)
at jdk7_nonnull.Main.main(Main.java:30)
Java Result: 1

Sitemap | Contact Us