База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

Objects.requireNonNull: проверка на референции

В Java SE 21 методът `Objects.requireNonNull` връща същата референция, ако тя не е `null`, а в противен случай хвърля изключение. Не проверява съдържанието на обекта.

Версия: Java SE 21

Синтаксис

import java.util.Objects;
import java.util.function.Supplier;

// Method signatures in java.util.Objects (Java SE 21):
public static <T> T requireNonNull(T obj)
public static <T> T requireNonNull(T obj, String message)
public static <T> T requireNonNull(T obj, Supplier<String> messageSupplier)

Objects.requireNonNull е статичен обобщен метод в java.util.Objects. Ако obj не е null, методът връща същата референция като T, така че резултатът може да се използва директно при присвояване. Ако obj е null, методът не връща заместваща стойност. Той хвърля NullPointerException, освен ако във варианта с доставчик get() хвърли изключение. В такъв случай се разпространява изключението от get().

Вариантът с един аргумент не приема съобщение. При претоварения вариант със String Java изчислява израза за съобщението преди извикването, дори когато obj не е null. При Supplier<String> изразът, който подава доставчика, също се изчислява предварително, но методът извиква get() за създаване на съобщението само ако obj е null, а доставчикът не е null. Първите два варианта са налични от Java 7, а този с доставчик — от Java 8. Литералът null като втори аргумент е двусмислен без явно преобразуване на типа.

Конструкторът на Contact отхвърля null поотделно за всеки от трите текстови аргумента: firstName, lastName и email. Празните низове преминават тази проверка, а форматът на имейл адреса трябва да се проверява отделно.

В tryAdvance провери action, преди да провериш дали диапазонът е изчерпан. При валидно действие методът връща false, ако няма останали елементи. Ако има елемент, методът го подава на действието и връща true след нормалното му приключване. Действие със стойност null предизвиква NullPointerException дори след изчерпване на диапазона.

Примери

import java.util.Objects;
import java.util.Spliterator;
import java.util.function.IntConsumer;

public class Main {
    record Contact(String firstName, String lastName, String email) {
        Contact {
            Objects.requireNonNull(firstName, "firstName");
            Objects.requireNonNull(lastName, "lastName");
            Objects.requireNonNull(email, "email");
        }
    }

    static final class Range implements Spliterator.OfInt {
        private int next = 7;
        private final int end = 8;

        @Override
        public boolean tryAdvance(IntConsumer action) {
            Objects.requireNonNull(action, "action");
            if (next >= end) {
                return false;
            }
            action.accept(next++);
            return true;
        }

        @Override public Spliterator.OfInt trySplit() { return null; }
        @Override public long estimateSize() { return end - next; }
        @Override public int characteristics() { return ORDERED | SIZED; }
    }

    public static void main(String[] args) {
        System.out.println(new Contact("Ada", "Lee", "not-an-email").email());
        try {
            new Contact("Ada", "Lee", null);
        } catch (NullPointerException ex) {
            System.out.println(ex.getClass().getSimpleName() + ": " + ex.getMessage());
        }

        Range range = new Range();
        IntConsumer print = System.out::println;
        System.out.println(range.tryAdvance(print));
        System.out.println(range.tryAdvance(print));
        try {
            range.tryAdvance((IntConsumer) null);
        } catch (NullPointerException ex) {
            System.out.println(ex.getClass().getSimpleName() + ": " + ex.getMessage());
        }
    }
}

Резултат

not-an-email
NullPointerException: email
7
true
false
NullPointerException: action

`not-an-email` преминава проверката, но `null` за `email` предизвиква изключение. Диапазонът подава `7` на действието, после връща `false` при валидно действие, а при последното извикване отново отхвърля `null`. Преобразуването `(IntConsumer) null` избира претоварения вариант за примитивния тип.

Свързани уроци

  • Java · Урок 8 · Напреднало · Версия: 2
  • Java · Урок 23 · Напреднало · Версия: 2

Източници