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

CKTIS / Java

Objects.equals: сравняване на заглавия, които може да са null

Сравнявай заглавия дори когато някое липсва. При създаване на етикет провери отделно дали необходимото заглавие е налично.

Версия: Java SE 21

Синтаксис

import java.util.Objects;

// Declaration in java.util.Objects (Java SE 21):
public static boolean equals(Object a, Object b)

// Use in an expression or statement:
boolean equal = Objects.equals(a, b);

Objects.equals(a, b) е статичен метод на класа java.util.Objects, който приема два аргумента от тип Object и връща boolean. Ако и двата аргумента са null, резултатът е true. Ако само единият е null, резултатът е false, стига equals да спазва договора си. Ако и двете референции сочат към един и същ обект, резултатът е true; реализацията в JDK 21 го връща, без да извиква a.equals(b). При две различни референции, които не са null, резултатът се определя от a.equals(b).

При обекти от тип String равенство означава една и съща последователност от символи. За разлика от това == при референции проверява дали сочат към един и същ обект, или и двете са null. Objects.equals не сравнява елементите на масиви; за дълбоко сравнение на масиви използвай Objects.deepEquals. Методът не поправя неправилна реализация на equals и не прихваща изключенията, които тя хвърля.

Две липсващи заглавия може да се приемат за равни, но резултатът true не доказва, че има заглавие. Ако за етикета е необходимо заглавие, използвай Objects.requireNonNull(title, "title is required") преди извикването на strip(). При липсващо заглавие проверката хвърля NullPointerException с това съобщение. Тя не отхвърля празни низове или низове, съставени само от празни знаци.

Примери

import java.util.Objects;

public class Main {
    private static String label(String title) {
        return "Title: " + Objects.requireNonNull(title, "title is required").strip();
    }

    public static void main(String[] args) {
        String title = "Atlas";
        String sameText = new String(title); // Deliberately distinct reference.
        String missing = null;

        System.out.println(Objects.equals(missing, null));
        System.out.println(Objects.equals(title, missing));
        System.out.println(Objects.equals(title, sameText));
        System.out.println(title == sameText);
        System.out.println(label(title));
        try {
            System.out.println(label(missing));
        } catch (NullPointerException e) {
            System.out.println(e.getMessage());
        }
    }
}

Резултат

true
false
true
false
Title: Atlas
title is required

Два различни обекта `String` с текст `Atlas` са равни според `Objects.equals`, но не и според `==`. Две липсващи заглавия се приемат за равни, но `label` отхвърля липсващо заглавие; примерът прихваща изключението и отпечатва съобщението му.

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

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

Източници