Java 中 String 的 contains 方法详解

简介

在 Java 编程里，字符串操作是极为常见的任务。String 类作为 Java 中使用频率极高的类之一，提供了诸多实用的方法，contains 方法便是其中之一。该方法能够帮助我们快速判断一个字符串是否包含另一个特定的子字符串，在处理文本匹配、数据筛选等场景时非常有用。本文将全面介绍 String contains 方法的基础概念、使用方法、常见实践以及最佳实践。

1. 基础概念

在 Java 中，String 类代表字符串。contains 方法是 String 类的一个实例方法，用于检查当前字符串是否包含指定的字符序列。其定义如下：

public boolean contains(CharSequence s)

参数：s 为要搜索的字符序列，可以是 String、StringBuilder、StringBuffer 等实现了 CharSequence 接口的类的对象。
返回值：如果当前字符串包含指定的字符序列，则返回 true；否则返回 false。

2. 使用方法

下面是一个简单的示例，展示了如何使用 contains 方法：

public class StringContainsExample {
    public static void main(String[] args) {
        String str = "Hello, World!";
        boolean result = str.contains("World");
        System.out.println("字符串是否包含 'World': " + result);
    }
}

在上述代码中，我们创建了一个字符串 str，然后使用 contains 方法检查该字符串是否包含子字符串 "World"。最后将结果打印输出。

3. 常见实践

3.1 文本匹配

在处理文本时，我们常常需要检查某个关键词是否存在于文本中。例如：

public class TextMatchingExample {
    public static void main(String[] args) {
        String text = "Java is a popular programming language.";
        String keyword = "Java";
        if (text.contains(keyword)) {
            System.out.println("文本中包含关键词: " + keyword);
        } else {
            System.out.println("文本中不包含关键词: " + keyword);
        }
    }
}

3.2 数据筛选

在处理列表数据时，我们可以使用 contains 方法筛选出包含特定子字符串的元素。例如：

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

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

        String target = "an";
        List<String> filteredFruits = new ArrayList<>();
        for (String fruit : fruits) {
            if (fruit.contains(target)) {
                filteredFruits.add(fruit);
            }
        }
        System.out.println("包含 'an' 的水果: " + filteredFruits);
    }
}

4. 最佳实践

4.1 空值检查

在调用 contains 方法之前，建议先检查字符串是否为 null，以避免 NullPointerException。例如：

public class NullCheckExample {
    public static void main(String[] args) {
        String str = null;
        String target = "test";
        if (str != null && str.contains(target)) {
            System.out.println("字符串包含 'test'");
        } else {
            System.out.println("字符串不包含 'test' 或字符串为 null");
        }
    }
}

4.2 忽略大小写匹配

如果需要进行忽略大小写的匹配，可以先将字符串转换为统一的大小写，再调用 contains 方法。例如：

public class CaseInsensitiveExample {
    public static void main(String[] args) {
        String str = "Hello, World!";
        String target = "world";
        boolean result = str.toLowerCase().contains(target.toLowerCase());
        System.out.println("忽略大小写匹配结果: " + result);
    }
}

5. 小结

String 类的 contains 方法是 Java 中一个非常实用的方法，它可以帮助我们快速判断一个字符串是否包含指定的子字符串。在使用时，我们需要注意空值检查，避免出现 NullPointerException。同时，对于需要忽略大小写的匹配场景，可以先将字符串转换为统一的大小写再进行判断。通过掌握 contains 方法的使用，我们可以更加高效地处理字符串相关的任务。

6. 参考资料

Java 官方文档 - String 类
《Effective Java》（第三版）

希望本文能帮助你深入理解并高效使用 Java 中的 String contains 方法。