在Java的集合操作体系中，Collections工具类提供了大量实用的静态方法，其中frequency方法专门用于统计指定元素在集合中出现的次数，无需开发者手动编写循环遍历逻辑，能大幅简化频率统计相关的代码实现。
Collections.frequency方法基本说明
Collections.frequency是java.util.Collections类的静态方法，其方法签名如下：
public static int frequency(Collection<?> c, Object o)
该方法接收两个参数，第一个参数是待统计的目标集合，第二个参数是需要统计出现次数的目标元素。返回值为int类型，代表目标元素在集合中出现的次数，如果集合为空或者不存在目标元素，返回0。
需要注意该方法统计的是元素的equals方法匹配的次数，所以元素的相等性判断依赖于对应类的equals方法实现。
基础使用示例
统计List中字符串的出现次数
以下代码演示统计字符串列表中某个字符串的出现频率：
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
public class FrequencyDemo {
public static void main(String[] args) {
// 创建包含重复元素的字符串列表
List<String> strList = new ArrayList<>();
strList.add("apple");
strList.add("banana");
strList.add("apple");
strList.add("orange");
strList.add("apple");
strList.add("banana");
// 统计apple出现的次数
int appleCount = Collections.frequency(strList, "apple");
// 统计banana出现的次数
int bananaCount = Collections.frequency(strList, "banana");
// 统计不存在的grape出现的次数
int grapeCount = Collections.frequency(strList, "grape");
System.out.println("apple出现次数：" + appleCount);
System.out.println("banana出现次数：" + bananaCount);
System.out.println("grape出现次数：" + grapeCount);
}
}
上述代码运行后输出结果为：
apple出现次数：3 banana出现次数：2 grape出现次数：0
统计数组中元素的出现次数
如果需要对数组进行频率统计，需要先将数组转换为集合再调用该方法：
import java.util.Arrays;
import java.util.Collections;
import java.util.List;
public class ArrayFrequencyDemo {
public static void main(String[] args) {
Integer[] numArray = {1, 2, 3, 2, 4, 2, 5};
// 将数组转换为List集合
List<Integer> numList = Arrays.asList(numArray);
// 统计数字2的出现次数
int count = Collections.frequency(numList, 2);
System.out.println("数字2出现次数：" + count);
}
}
运行后输出结果为：数字2出现次数：3。
自定义对象的频率统计
当统计自定义对象集合时，需要确保自定义类正确重写了equals方法和hashCode方法，否则frequency方法会按照Object类的默认equals逻辑（判断引用是否相同）进行统计，导致结果不符合预期。
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
import java.util.Objects;
class Student {
private String name;
private int age;
public Student(String name, int age) {
this.name = name;
this.age = age;
}
// 重写equals方法，根据name和age判断两个对象是否相等
@Override
public boolean equals(Object o) {
if (this == o) return true;
if (o == null || getClass() != o.getClass()) return false;
Student student = (Student) o;
return age == student.age && Objects.equals(name, student.name);
}
// 重写hashCode方法，配合equals使用
@Override
public int hashCode() {
return Objects.hash(name, age);
}
@Override
public String toString() {
return "Student{name='" + name + "', age=" + age + "}";
}
}
public class CustomObjectFrequencyDemo {
public static void main(String[] args) {
List<Student> studentList = new ArrayList<>();
studentList.add(new Student("张三", 18));
studentList.add(new Student("李四", 20));
studentList.add(new Student("张三", 18));
studentList.add(new Student("王五", 19));
studentList.add(new Student("张三", 18));
Student target = new Student("张三", 18);
int count = Collections.frequency(studentList, target);
System.out.println("张三18岁的学生出现次数：" + count);
}
}
上述代码中Student类重写了equals和hashCode方法，因此frequency方法可以正确统计到相同属性的学生对象出现次数，运行后输出结果为：张三18岁的学生出现次数：3。
方法原理与注意事项
查看Collections.frequency的源码可以发现，其内部实现是通过遍历集合，逐个调用元素的equals方法和目标元素比较，匹配则计数加1：
public static int frequency(Collection<?> c, Object o) {
int result = 0;
if (o == null) {
for (Object e : c)
if (e == null)
result++;
} else {
for (Object e : c)
if (o.equals(e))
result++;
}
return result;
}
使用时需要注意以下几点：
- 该方法的时间复杂度为O(n)，n为集合的元素数量，不适合超大规模集合的高频统计场景。
- 如果集合中的元素为null，也可以统计null的出现次数，此时方法会单独判断元素是否为null。
- 目标元素不需要和集合的泛型类型完全一致，只要满足equals匹配规则即可，比如集合中存的是子类对象，目标元素传父类对象，只要equals匹配就会计数。
适用场景总结
Collections.frequency适合以下场景：
- 快速统计小到中等规模集合中单个元素的出现次数。
- 临时性的频率统计需求，不需要保留所有元素的频率数据。
- 不需要自定义复杂匹配规则，仅依赖equals方法判断相等的场景。
如果需要统计集合中所有元素的频率，或者需要更复杂的匹配规则，建议使用Map手动遍历统计，或者使用Java8的Stream API的groupingBy方法实现，能获得更灵活的功能和更好的性能表现。
JavaCollections.frequency元素频率统计集合操作修改时间：2026-06-24 21:54:44