커서에서 데이터 액세스

First

first() 메서드를 사용하여 쿼리 결과에서 첫 번째 문서를 조회합니다.

FindIterable<Document> iterable = collection.find();
System.out.println(iterable.first());

이 방법은 고유 인덱스로 필터링할 때와 같이 쿼리 필터가 하나의 문서와 일치할 때 자주 사용됩니다.

결과 수

available() 메서드를 사용하여 차단하지 않고 로컬에 존재하는 결과 수를 검색합니다.

MongoCursor<Document> cursor = collection.find().cursor();
System.out.println(cursor.available());

애플리케이션이 커서의 모든 문서를 이미 반복했거나 커서가 닫힌 경우 이 메서드는 0 를 반환합니다.

into

into() 메서드를 사용하여 쿼리 결과를 List 에 저장합니다.

List<Document> results = new ArrayList<>();
FindIterable<Document> iterable = collection.find();
iterable.into(results);
System.out.println(results);

이 메서드는 쿼리 필터가 사용 가능한 메모리에 들어갈 수 있는 적은 수의 문서를 반환할 때 자주 사용됩니다.

커서

cursor() 메서드를 사용하여 가져온 문서를 반복하고 조기 종료가 있는 경우 커서가 닫히도록 합니다.

MongoCursor<Document> cursor = collection.find().cursor();

커서가 닫히도록 하는 방법에 대한 자세한 내용은 커서 정리 섹션을 참조하세요.

설명합니다.

explain() 메서드를 사용하여 MongoDB가 작업을 실행하는 방법에 대한 정보를 볼 수 있습니다.

explain() 메서드는 실행 계획 및 성능 통계를 반환합니다. 실행 계획은 MongoDB가 작업을 완료할 수 있는 잠재적인 방법입니다. explain() 메서드는 성공적인 계획(MongoDB가 실행한 계획)과 거부된 계획을 모두 제공합니다.

explain() 메소드에 상세 수준을 전달하여 설명의 세부 정보 수준을 지정할 수 있습니다.

다음 표에는 설명 및 해당 사용 사례에 대한 모든 상세 수준이 나와 있습니다.

다음 예제에서는 실행 계획을 생성하는 애그리게이션 단계에 대한 성공적인 계획의 JSON 표현을 출력합니다.

Document explanation = collection.find().explain(ExplainVerbosity.EXECUTION_STATS);
List<String> keys = Arrays.asList("queryPlanner", "winningPlan");
System.out.println(explanation.getEmbedded(keys, Document.class).toJson());

앞의 코드 스니펫은 다음과 같은 출력을 생성합니다.

{ "stage": "COLLSCAN", "direction": "forward" }

설명 작업에 대한 자세한 내용은 다음 서버 매뉴얼 항목을 참조하세요.

• 설명 출력

• 쿼리 계획

이 섹션에 언급된 메서드 및 클래스에 대한 자세한 내용은 다음 API 문서를 참조하세요.

• first()

• available()

• into()

• cursor()

• explain()

• ExplainVerbosity

함수 반복

FindIterable 의 forEach() 메서드에 함수를 전달하여 기능적 스타일로 결과를 반복합니다.

FindIterable<Document> iterable = collection.find();
iterable.forEach(doc -> System.out.println(doc.toJson()));

for (Document cursor : collection.find()) {
   ...
}

조건부 반복

hasNext() 메서드를 사용하여 커서에서 사용 가능한 문서가 있는지 확인한 다음 next() 메서드를 사용하여 커서에서 사용 가능한 다음 문서를 검색합니다.

MongoCursor<Document> cursor = collection.find().cursor();
while (cursor.hasNext()){
    System.out.println(cursor.next().toJson());
}

이 섹션에 언급된 메서드 및 클래스에 대한 자세한 내용은 다음 API 문서를 참조하세요.

• forEach()

• hasNext()

• Next()

닫기

finally 블록에서 close() 메서드를 사용하여 클라이언트 애플리케이션과 MongoDB deployment 모두에서 커서의 리소스 소비를 확보합니다.

MongoCursor<Document> cursor = collection.find().cursor();
try {
    while (cursor.hasNext()){
        System.out.println(cursor.next().toJson());
    }
} finally {
    cursor.close();
}

리소스 문으로 시도

try-with-resources 문을 사용하여 클라이언트 애플리케이션과 MongoDB deployment 모두에서 커서의 리소스 소비를 자동으로 확보할 수 있습니다.

try(MongoCursor<Document> cursor = collection.find().cursor()) {
    while (cursor.hasNext()){
        System.out.println(cursor.next().toJson());
    }
}

이 섹션에 언급된 메서드 및 클래스에 대한 자세한 내용은 다음 API 문서를 참조하세요.

• close()

• 리소스로 시도(try-with-resources) 문