要计算Java集合（例如List或Set中的Integer、Double或其他数值类型的对象）的组内平均值，我们需要遍历这个集合，累加所有的元素值，然后除以集合的大小（即元素的数量）。以下是一个详细的步骤说明和完整的代码示例。

1.步骤说明

（1）创建集合：首先，我们需要一个包含数值的集合。在这个例子中，我们将使用List<Integer>。

（2）初始化累加器和计数器：累加器用于存储所有元素的总和，计数器用于跟踪元素的数量。

（3）遍历集合：使用for-each循环或其他遍历方式遍历集合中的每个元素。

（4）累加元素值：将每个元素的值加到累加器上。

（5）计算平均值：将累加器的值除以计数器的值，得到平均值。

（6）处理特殊情况：如果集合为空（即元素数量为0），则平均值未定义。在这种情况下，我们可能需要抛出一个异常或返回一个特殊的值（如null或Double.NaN）。

2.代码示例

2.1代码示例一

import java.util.ArrayList;  
import java.util.List;  
  
public class AverageCalculator {  
  
    public static double calculateAverage(List<Integer> numbers) {  
        if (numbers == null || numbers.isEmpty()) {  
            throw new IllegalArgumentException("List of numbers must not be null or empty");  
        }  
  
        int sum = 0;  
        for (int number : numbers) {  
            sum += number;  
        }  
  
        return (double) sum / numbers.size();  
    }  
  
    public static void main(String[] args) {  
        List<Integer> numbers = new ArrayList<>();  
        numbers.add(10);  
        numbers.add(20);  
        numbers.add(30);  
          
        try {  
            double average = calculateAverage(numbers);  
            System.out.println("The average is: " + average);  
        } catch (IllegalArgumentException e) {  
            System.out.println(e.getMessage());  
        }  
    }  
}

在这个示例中，calculateAverage方法接受一个List<Integer>作为参数，并返回该列表中数字的平均值。如果列表为空或null，则抛出一个IllegalArgumentException。在main方法中，我们创建了一个包含三个数字的列表，并调用了calculateAverage方法来计算平均值。

2.2代码示例二

除了之前提到的直接遍历集合并累加元素值的方法，我们还可以使用Java引入的流（Stream）API来计算集合的组内平均值。这是一个更现代且简洁的写法。

以下是一个使用Java Stream API计算List<Integer>中数值平均值的代码示例：

import java.util.Arrays;  
import java.util.List;  
import java.util.OptionalDouble;  
  
public class AverageCalculator {  
  
    public static double calculateAverage(List<Integer> numbers) {  
        // 确保列表不为空  
        if (numbers == null || numbers.isEmpty()) {  
            throw new IllegalArgumentException("List of numbers must not be null or empty");  
        }  
  
        // 使用Java Stream API计算平均值  
        OptionalDouble average = numbers.stream()  
                .mapToDouble(Integer::doubleValue) // 将Integer转换为double  
                .average(); // 计算平均值  
  
        // 因为average()方法返回一个OptionalDouble，所以我们需要调用getAsDouble()来获取值  
        // 或者我们可以使用ifPresent()来处理平均值可能不存在的情况（但在这里我们已知列表不为空）  
        return average.getAsDouble();  
    }  
  
    public static void main(String[] args) {  
        List<Integer> numbers = Arrays.asList(10, 20, 30);  
          
        try {  
            double average = calculateAverage(numbers);  
            System.out.println("The average is: " + average);  
        } catch (IllegalArgumentException e) {  
            System.out.println(e.getMessage());  
        }  
    }  
}

在这个示例中，我们使用了stream()方法将List<Integer>转换为流（Stream），然后调用mapToDouble()方法将流中的Integer元素转换为double类型，接着使用average()方法计算平均值。由于average()方法返回一个OptionalDouble对象（它表示一个可能不存在的double值），我们需要调用getAsDouble()方法来获取平均值。如果列表为空，average()方法将返回一个空的OptionalDouble，但在这个示例中，我们已经在方法开始时检查了列表是否为空。