JavaJava 7 Feature: Asserting Non-Null Objects

Java 7 Feature: Asserting Non-Null Objects content and product recommendations are editorially independent. We may make money when you click on links to our partners. Learn More.

Starting with JDK 7, you can assert non-null objects with two java.util.Objects methods. Check out these quick method check examples below.

Asserting non-null objects with Java 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);

//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(
        at jdk7_nonnull.Main.main(
Java Result: 1

Get the Free Newsletter!

Subscribe to Developer Insider for top news, trends & analysis

Latest Posts

Related Stories