Java中的List contains方法详解

1. 介绍

在Java的集合类中，List接口是最常用的一种数据结构，其实现类包括ArrayList、LinkedList等。List代表了有序的元素集合，其中可以存储重复元素。List提供了许多方便的方法来操作元素，其中包括contains()方法。

contains()方法用于判断List集合中是否包含某个特定的元素，它返回一个布尔值，如果包含该元素，则返回true；如果不包含，则返回false。这个方法非常实用，可以帮助我们在编码过程中快速判断元素是否存在于List中。

在本文中，我们将详细介绍contains()方法的使用方法和注意事项，希望能对你在使用List集合时有所帮助。

2. contains()方法的语法

contains()方法的语法如下：

boolean contains(Object o)

contains()方法接受一个参数o，用于判断List集合中是否包含参数o代表的元素。如果List中存在该元素，则返回true；否则返回false。需要注意的是，该方法会调用List集合中元素的equals()方法来进行比较。

3. 示例代码

下面是一个使用contains()方法的示例代码：

import java.util.ArrayList;
import java.util.List;

public class ListContainsExample {
    public static void main(String[] args) {
        List<String> fruits = new ArrayList<>();
        fruits.add("apple");
        fruits.add("banana");
        fruits.add("orange");

        String targetFruit = "banana";
        if (fruits.contains(targetFruit)) {
            System.out.println("The list contains " + targetFruit);
        } else {
            System.out.println("The list does not contain " + targetFruit);
        }
    }
}

上述代码中，我们创建了一个String类型的List集合fruits，并向其中添加了几种水果。然后我们使用contains()方法判断List集合中是否包含某个特定的水果”banana”，并输出。

运行上述代码，得到的输出为：

The list contains banana

根据运行结果可以看出，List集合中包含目标水果”banana”，因此contains()方法返回true。

4. 注意事项

在使用contains()方法时，有几个需要注意的地方：

4.1 equals()方法的重写

contains()方法会使用List中元素的equals()方法进行比较。因此，如果存储在List中的元素是自定义的对象，而不是基本类型或标准类库提供的类，那么就需要重写equals()方法，以便正确比较对象的内容。否则，contains()方法无法准确判断是否包含目标对象。

下面是一个示例代码，演示如何重写equals()方法：

import java.util.ArrayList;
import java.util.List;

class Book {
    private String title;
    private int pageCount;

    public Book(String title, int pageCount) {
        this.title = title;
        this.pageCount = pageCount;
    }

    @Override
    public boolean equals(Object obj) {
        if (this == obj) {
            return true;
        }
        if (obj == null || getClass() != obj.getClass()) {
            return false;
        }
        Book book = (Book) obj;
        return pageCount == book.pageCount && title.equals(book.title);
    }

    @Override
    public int hashCode() {
        return Objects.hash(title, pageCount);
    }
}

public class ListContainsCustomObjectExample {
    public static void main(String[] args) {
        List<Book> books = new ArrayList<>();
        books.add(new Book("Java in Action", 500));
        books.add(new Book("Python Deep Dive", 600));
        books.add(new Book("C++ Primer", 800));

        Book targetBook = new Book("Java in Action", 500);
        if (books.contains(targetBook)) {
            System.out.println("The list contains the target book");
        } else {
            System.out.println("The list does not contain the target book");
        }
    }
}

在上述代码中，我们定义了一个Book类，重写了equals()方法和hashCode()方法，以便正确比较Book对象的内容。然后我们创建了一个Book类型的List集合books，并向其中添加了几本书。最后，我们使用contains()方法判断List中是否包含某本特定的书籍”Java in Action”，并输出。

运行上述代码，得到的输出为：