HOWTO · Java
Java에서 목록을 청크로 분할
이 튜토리얼은 Java에서 목록을 동일한 크기의 여러 청크로 분할하는 방법을 보여줍니다.
이 페이지의 내용
의존성을 추가하지 않고 Java 목록을 고정 크기 청크로 나누려면 청크 크기만큼 인덱스를 이동하며 List.subList()로 각 범위를 가져오면 됩니다. 결과 형태가 작업에 맞거나 프로젝트에 이미 해당 의존성이 있다면 스트림 수집기, Apache Commons Collections, Guava를 대안으로 사용할 수 있습니다.
Java에서 List.subList()로 목록을 청크로 나누기
List.subList(fromIndex, toIndex)는 목록 범위의 뷰를 반환합니다. 시작 인덱스는 포함하고 끝 인덱스는 포함하지 않습니다. 시작 인덱스를 청크 크기만큼 이동하고 끝 인덱스는 목록 길이를 넘지 않도록 제한하면 마지막 청크가 더 짧을 수 있습니다. 아래의 완전한 예제는 값 8개를 크기 3인 청크로 나눕니다. 인덱스를 따라가면 반복문이 다루는 범위를 직접 확인할 수 있습니다.
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;
public class ChunkExample {
public static void main(String[] args) {
List<Integer> items = Arrays.asList(10, 20, 30, 40, 50, 60, 70, 80);
int chunkSize = 3;
List<List<Integer>> chunks = new ArrayList<>();
for (int start = 0; start < items.size(); start += chunkSize) {
int end = Math.min(start + chunkSize, items.size());
chunks.add(items.subList(start, end));
}
System.out.println(chunks);
}
}
시작 인덱스는 0, 3, 6이며 마지막 끝 인덱스는 목록 길이로 제한됩니다. 따라서 마지막 범위가 더 짧더라도 모든 값이 포함됩니다. 입력 요소가 없으면 반복문은 청크를 추가하지 않습니다. 반복문이 목록을 계속 순회하려면 청크 크기는 양수여야 합니다.
subList()가 반환하는 각 결과는 독립된 복사본이 아니라 원본 목록을 기반으로 하는 뷰입니다. 변경 사항이 원본 목록에 반영되어야 한다면 청크를 뷰로 다루세요. 뷰 바깥에서 원본 목록의 구조를 변경하면 이후에 해당 하위 목록을 사용하는 동작이 신뢰할 수 없게 될 수 있습니다. 독립된 청크 목록을 만들려면 범위를 추가할 때 복사하면 됩니다. 예를 들면 new ArrayList<>(items.subList(start, end))를 사용할 수 있습니다.
Java에서 스트림으로 목록을 청크로 나누기
스트림으로 시작 인덱스를 생성한 뒤 각 범위를 하위 목록으로 매핑할 수 있습니다. 제공된 한 가지 방식은 IntStream.iterate(0, i -> i < items.size(), i -> i + chunkSize)를 사용해 인덱스를 만듭니다. 다른 방식은 목록 길이와 청크 크기에서 범위 개수를 계산한 다음, 각 인덱스 i를 i * chunkSize에서 시작하는 범위로 매핑합니다. 두 방식은 앞의 반복문과 같은 범위를 만듭니다. 스트림 기반 접근을 선택할 때는 이 코드를 이 섹션에 두세요.
두 방식 모두 입력 요소가 없으면 범위 개수는 0입니다. 마지막 인덱스를 계산하기 전에 청크 크기가 양수인지 확인해야 합니다. 여기에는 이 스트림 방식의 Java 런타임 실행 증거가 제공되지 않았으므로, 인덱스 동작은 테스트 결과가 아니라 API와 산술에 근거해 설명합니다. 경계를 한곳에서 명확히 확인하며 조정하고 싶다면 직접 작성한 반복문이 더 간단합니다.
Java에서 Collectors.groupingBy()로 목록을 청크로 나누기
Collectors.groupingBy()는 분류 키를 기준으로 스트림 요소를 그룹화합니다. 청크를 만들려면 각 요소의 값이 아니라 위치를 청크 크기로 나눈 결과를 기준으로 분류합니다. 0부터 시작하는 인덱스를 사용하면 0부터 chunkSize - 1까지의 인덱스가 같은 키를 공유하고, 다음 범위는 그다음 키를 사용합니다.
예를 들어 인덱스를 스트림으로 만든 뒤 Collectors.groupingBy(i -> i / chunkSize)로 그룹화하고, 각 그룹의 인덱스를 items.get(i)로 다시 값에 매핑할 수 있습니다. 결과는 청크 번호를 키로, 값 목록을 값으로 갖는 맵입니다. 호출 측에서 목록의 목록이 필요하면 맵의 값들을 목록으로 모으세요. 선택한 맵 유형과 그 순서가 구현의 일부인 경우가 아니라면 맵의 순회 순서에 의존하지 마세요. 다른 방식과 마찬가지로 청크 크기는 양수여야 하며, 범위 개수를 계산하기 전에 입력 요소가 없는 경우도 고려해야 합니다.
Java에서 Apache Commons Collections로 목록을 청크로 나누기
Apache Commons Collections가 이미 프로젝트 의존성에 포함되어 있다면 목록과 청크 크기를 인자로 전달하는 ListUtils.partition() 메서드로 목록을 분할할 수 있습니다. 호출 형태는 ListUtils.partition(items, chunkSize)입니다. 이 API를 사용하기 전에 빌드 설정에 라이브러리를 추가하세요. 이 라이브러리는 JDK에 포함되어 있지 않습니다. 의존성 좌표와 API 세부 사항은 프로젝트에서 선택한 버전의 문서를 확인하세요.
여기에는 라이브러리 버전, 의존성을 포함한 실행 환경 또는 실행 증거가 제공되지 않았습니다. 따라서 이 글은 메서드를 소개하되, 반환된 분할 결과가 뷰인지 복사본인지, 변경 가능한지 또는 특정 버전에서 어떻게 동작하는지 단정하지 않습니다. 이런 세부 사항이 중요하다면 빌드에서 사용하는 정확한 Commons Collections 버전의 문서를 확인하세요.
Java에서 Google Guava로 목록을 청크로 나누기
Guava는 목록과 청크 크기를 전달하는 Lists.partition() 메서드를 제공합니다. 호출 형태는 Lists.partition(items, chunkSize)입니다. 애플리케이션에 Guava가 이미 포함되어 있을 때 선택할 수 있는 의존성 기반 방법입니다. 그렇지 않다면 컬렉션 API를 가져오기 전에 프로젝트의 의존성 관리 도구를 통해 라이브러리를 추가하세요.
여기에는 Guava 버전이나 실행 가능한 의존성 환경이 제공되지 않았으므로 이 메서드를 테스트된 예제로 제시하지 않습니다. API와 애플리케이션에서 필요한 동작을 프로젝트가 선택한 Guava 버전의 문서에서 확인하세요. 메서드 이름만으로는 특정 버전의 복사 여부, 뷰 여부, 변경 가능성 또는 순서 보장이 확정되지 않습니다.
결론
JDK만 사용하는 방법과 범위를 명시적으로 다루는 방식이 적합하다면 List.subList()를 이용한 인덱스 반복문을 사용하세요. 주변 처리 흐름에서 인덱스 기반 매핑이 어울리면 스트림 방식을 선택하고, 청크 번호를 키로 하는 맵이 유용하면 Collectors.groupingBy()를 사용하세요. Apache Commons Collections와 Guava는 해당 의존성이 이미 프로젝트에 포함되어 있을 때 간결한 라이브러리 대안을 제공합니다. 어떤 방식을 선택하든 청크 크기를 양수로 지정하고 마지막의 불완전한 청크를 고려하며, 사용하는 API와 의존성 버전에 맞춰 뷰 또는 컬렉션의 동작을 확인하세요.