Java – equalsメソッドの使い方 – 文字列/オブジェクトの比較処理

2025-04-15更新日: 2025-04-15

Javaのequalsメソッドは、オブジェクトの内容を比較するために使用されます。

特に文字列比較では、==演算子が参照の一致を確認するのに対し、equalsは文字列の値そのものを比較します。

例えば、"abc".equals("abc")はtrueを返します。

オブジェクトの場合、equalsメソッドはデフォルトで参照の一致を確認しますが、クラスでオーバーライドすることで内容比較が可能です。

オーバーライド時はhashCodeメソッドも一貫性を保つよう実装する必要があります。

目次から探す

equalsメソッドとは
文字列の比較におけるequalsメソッドの使い方
オブジェクトの比較におけるequalsメソッドの使い方
equalsメソッドの実装例
equalsメソッドを使った実践的なユースケース
まとめ

Javaを使った求人

読み込み中…

equalsメソッドとは

Javaにおけるequalsメソッドは、オブジェクトの等価性を比較するために使用されるメソッドです。

デフォルトでは、Objectクラスに定義されており、オブジェクトの参照が同じかどうかを判断します。

しかし、クラスによってはこのメソッドをオーバーライドすることで、オブジェクトの内容に基づいた比較を行うことができます。

equalsメソッドは、以下のような特徴を持っています。

特徴	説明
デフォルトの動作	参照の比較を行う
オーバーライドの必要性	内容の比較を行うためにはオーバーライドが必要
nullの扱い	引数がnullの場合はfalseを返す

このメソッドを正しく実装することで、コレクションやデータ構造におけるオブジェクトの管理が容易になります。

特に、HashMapやHashSetなどのコレクションフレームワークでは、equalsメソッドが重要な役割を果たします。

文字列の比較におけるequalsメソッドの使い方

Javaでは、文字列を比較する際にequalsメソッドを使用することが推奨されます。

StringクラスはObjectクラスから継承されたequalsメソッドをオーバーライドしており、文字列の内容を比較するように実装されています。

これにより、文字列の内容が同じであればtrueを返し、異なればfalseを返します。

以下は、equalsメソッドを使用した文字列の比較の例です。

public class App {
    public static void main(String[] args) {
        String str1 = "こんにちは";
        String str2 = new String("こんにちは");
        
        // equalsメソッドを使用して文字列を比較
        boolean isEqual = str1.equals(str2); // 内容が同じか比較
        
        // 結果を出力
        System.out.println("文字列は等しいか: " + isEqual);
    }
}

このコードでは、str1とstr2という2つの文字列を比較しています。

str2はnewキーワードを使って生成されていますが、equalsメソッドを使用することで、内容が同じであるためtrueが返されます。

文字列は等しいか: true

このように、equalsメソッドを使用することで、文字列の内容を正確に比較することができます。

==演算子を使用すると、参照の比較になってしまうため、文字列の内容を比較する際にはequalsメソッドを使用することが重要です。

オブジェクトの比較におけるequalsメソッドの使い方

Javaでは、オブジェクトの比較を行う際にequalsメソッドをオーバーライドすることが一般的です。

デフォルトのequalsメソッドは、オブジェクトの参照が同じかどうかを比較しますが、実際のアプリケーションではオブジェクトの内容を比較する必要がある場合が多いです。

以下は、カスタムクラスにおけるequalsメソッドのオーバーライドの例です。

class Person {
    private String name;
    private int age;
    public Person(String name, int age) {
        this.name = name;
        this.age = age;
    }
    @Override
    public boolean equals(Object obj) {
        // 同じオブジェクトかどうかを確認
        if (this == obj) return true;
        // nullチェックと型チェック
        if (obj == null || getClass() != obj.getClass()) return false;
        
        Person person = (Person) obj; // キャスト
        // フィールドの内容を比較
        return age == person.age && name.equals(person.name);
    }
}
public class App {
    public static void main(String[] args) {
        Person person1 = new Person("太郎", 25);
        Person person2 = new Person("太郎", 25);
        
        // equalsメソッドを使用してオブジェクトを比較
        boolean isEqual = person1.equals(person2); // 内容が同じか比較
        
        // 結果を出力
        System.out.println("オブジェクトは等しいか: " + isEqual);
    }
}

このコードでは、Personクラスを定義し、nameとageというフィールドを持っています。

equalsメソッドをオーバーライドして、オブジェクトの内容(名前と年齢)が同じかどうかを比較しています。

オブジェクトは等しいか: true

このように、equalsメソッドを適切にオーバーライドすることで、オブジェクトの内容に基づいた比較が可能になります。

これにより、コレクションフレームワークでのオブジェクトの管理が容易になり、意図した通りの動作を実現できます。

equalsメソッドの実装例

equalsメソッドの実装は、オブジェクトの内容に基づいて等価性を判断するために非常に重要です。

以下に、equalsメソッドをオーバーライドした具体的な実装例を示します。

この例では、Bookクラスを作成し、書籍のタイトルと著者を比較します。

class Book {
    private String title;
    private String author;
    public Book(String title, String author) {
        this.title = title;
        this.author = author;
    }
    @Override
    public boolean equals(Object obj) {
        // 同じオブジェクトかどうかを確認
        if (this == obj) return true;
        // nullチェックと型チェック
        if (obj == null || getClass() != obj.getClass()) return false;
        
        Book book = (Book) obj; // キャスト
        // フィールドの内容を比較
        return title.equals(book.title) && author.equals(book.author);
    }
    @Override
    public int hashCode() {
        // hashCodeもオーバーライドすることが推奨される
        int result = title.hashCode();
        result = 31 * result + author.hashCode();
        return result;
    }
}
public class App {
    public static void main(String[] args) {
        Book book1 = new Book("Java入門", "山田太郎");
        Book book2 = new Book("Java入門", "山田太郎");
        
        // equalsメソッドを使用してオブジェクトを比較
        boolean isEqual = book1.equals(book2); // 内容が同じか比較
        
        // 結果を出力
        System.out.println("書籍は等しいか: " + isEqual);
    }
}

このコードでは、Bookクラスにtitleとauthorというフィールドがあります。

equalsメソッドをオーバーライドして、書籍のタイトルと著者が同じかどうかを比較しています。

また、hashCodeメソッドもオーバーライドしています。

これは、equalsメソッドをオーバーライドした場合、hashCodeメソッドも一貫性を保つためにオーバーライドすることが推奨されるためです。

書籍は等しいか: true

このように、equalsメソッドを適切に実装することで、オブジェクトの内容に基づいた比較が可能になり、コレクションフレームワークでの利用がスムーズになります。

equalsメソッドを使った実践的なユースケース

equalsメソッドは、さまざまな場面で実用的に利用されます。

特に、コレクションフレームワークやデータベースのエンティティ管理において、オブジェクトの等価性を判断するために重要です。

以下に、いくつかの実践的なユースケースを紹介します。

1. コレクションでの重複排除

HashSetやArrayListなどのコレクションを使用する際、equalsメソッドをオーバーライドすることで、オブジェクトの重複を排除できます。

以下は、HashSetを使用した例です。

import java.util.HashSet;
import java.util.Set;
class Product {
    private String name;
    private double price;
    public Product(String name, double price) {
        this.name = name;
        this.price = price;
    }
    @Override
    public boolean equals(Object obj) {
        if (this == obj) return true;
        if (obj == null || getClass() != obj.getClass()) return false;
        Product product = (Product) obj;
        return Double.compare(product.price, price) == 0 && name.equals(product.name);
    }
    @Override
    public int hashCode() {
        return 31 * name.hashCode() + Double.hashCode(price);
    }
}
public class App {
    public static void main(String[] args) {
        Set<Product> productSet = new HashSet<>();
        productSet.add(new Product("ノートパソコン", 100000));
        productSet.add(new Product("ノートパソコン", 100000)); // 重複
        // 重複を排除した結果を出力
        System.out.println("商品数: " + productSet.size()); // 1が出力される
    }
}

商品数: 1

2. データベースのエンティティ管理

データベースのエンティティを表すクラスにおいて、equalsメソッドをオーバーライドすることで、同一のエンティティを簡単に比較できます。

例えば、ユーザー情報を管理する場合、ユーザーIDを基に等価性を判断することができます。

class User {
    private String userId;
    private String name;
    public User(String userId, String name) {
        this.userId = userId;
        this.name = name;
    }
    @Override
    public boolean equals(Object obj) {
        if (this == obj) return true;
        if (obj == null || getClass() != obj.getClass()) return false;
        User user = (User) obj;
        return userId.equals(user.userId);
    }
    @Override
    public int hashCode() {
        return userId.hashCode();
    }
}
public class App {
    public static void main(String[] args) {
        User user1 = new User("user123", "佐藤");
        User user2 = new User("user123", "鈴木");
        // equalsメソッドを使用してユーザーを比較
        boolean isEqual = user1.equals(user2); // 同じユーザーIDか比較
        // 結果を出力
        System.out.println("ユーザーは等しいか: " + isEqual); // trueが出力される
    }
}