Java에서 GroupDocs.Search를 사용하여 문서를 인덱스에 추가하고 병합하기

오늘날 빠르게 변화하는 디지털 환경에서는 문서를 인덱스에 효율적으로 추가하는 방법을 배우는 것이 모든 document management java 솔루션에 필수적입니다. 계약서, 청구서, 내부 보고서 등을 다루든, 잘 구조화된 인덱스는 정보를 밀리초 단위로 검색할 수 있게 해줍니다. 이 튜토리얼에서는 인덱스 생성, 문서 추가, 병합 옵션 구성, 필요 시 병합 작업 취소까지를 GroupDocs.Search for Java와 함께 단계별로 안내합니다.

빠른 답변

“문서를 인덱스에 추가한다”는 의미가 무엇인가요? GroupDocs.Search에 폴더를 스캔하도록 지시하고 각 파일의 검색 가능한 메타데이터를 저장합니다.
긴 병합 작업을 중단할 수 있나요? 예 — Cancellation 객체를 사용해 병합 작업 취소를 타임아웃 후 수행할 수 있습니다.
라이선스가 필요한가요? 테스트용으로는 무료 체험 또는 임시 라이선스로 충분하며, 상용 라이선스는 전체 기능을 해제합니다.
필요한 Java 버전은? JDK 8 이상.
대용량 데이터셋에도 적합한가요? 물론입니다—메모리를 모니터링하고 증분 인덱싱을 활용하면 됩니다.

GroupDocs.Search에서 “문서를 인덱스에 추가한다”는 의미

문서를 인덱스에 추가한다는 것은 파일 컬렉션을 GroupDocs.Search에 전달하여 라이브러리가 내용을 분석하고 토큰을 추출해 검색 가능한 데이터 구조를 구축하도록 하는 것입니다. 인덱싱이 완료되면 모든 문서에 대해 빠른 전체 텍스트 검색을 수행할 수 있습니다.

왜 Java용 document management에 GroupDocs.Search를 사용해야 할까요?

확장 가능한 인덱싱 – 수천 개 파일을 처리해도 성능 저하가 없습니다.
풍부한 API – 인덱싱, 병합, 취소 등에 대한 세밀한 제어를 제공합니다.
다양한 포맷 지원 – PDF, Word, Excel 등 여러 형식을 바로 사용할 수 있습니다.

사전 요구 사항

GroupDocs.Search for Java 버전 25.4 이상.
Maven(또는 수동 JAR 다운로드).
기본 Java 지식 및 JDK 8+ 환경.

GroupDocs.Search for Java 설정

Maven 설치

Maven으로 의존성을 관리한다면 pom.xml에 저장소와 의존성을 추가하세요:

<repositories>
    <repository>
        <id>repository.groupdocs.com</id>
        <name>GroupDocs Repository</name>
        <url>https://releases.groupdocs.com/search/java/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-search</artifactId>
        <version>25.4</version>
    </dependency>
</dependencies>

직접 다운로드

또는 공식 사이트에서 최신 JAR를 다운로드합니다: GroupDocs.Search for Java releases.

라이선스 획득

무료 체험: GroupDocs 웹사이트에서 체험 라이선스를 신청하세요.
임시 라이선스: 장기 평가가 필요하면 임시 키를 신청하세요.
상용 라이선스: 프로덕션 사용을 위해 구매하세요.

라이선스 파일을 프로젝트에 배치한 뒤 아래 예시와 같이 라이브러리를 초기화합니다.

구현 가이드

문서를 인덱스에 추가하기 – 첫 번째 인덱스 생성

먼저 검색 데이터를 보관할 빈 인덱스를 생성합니다.

import com.groupdocs.search.Index;

// Create an instance of the index at the specified path
Index index1 = new Index("YOUR_DOCUMENT_DIRECTORY\\\\Index1");

이유: 인덱스된 토큰이 저장될 저장소 컨테이너를 설정하는 단계입니다.

인덱스에 문서 추가

이제 GroupDocs.Search에 폴더를 스캔하도록 지시하고 문서를 인덱스에 추가합니다.

index1.add("YOUR_DOCUMENT_DIRECTORY"); // Add documents from this directory

이유: 라이브러리가 각 파일을 읽고 텍스트를 추출해 index1에 저장합니다.

유연한 워크플로를 위한 두 번째 인덱스 생성

때때로 클라이언트별 데이터를 분리해야 할 경우가 있습니다.

Index index2 = new Index("YOUR_DOCUMENT_DIRECTORY\\\\Index2");

index2.add("YOUR_DOCUMENT_DIRECTORY");

이유: 여러 인덱스를 사용하면 서로 다른 문서 집합을 관리하고 나중에 병합할 수 있습니다.

병합 옵션 구성 및 병합 작업 취소

병합하기 전에 프로세스를 미세 조정하고, 실행 시간이 길어지면 중단할 수 있습니다.

import com.groupdocs.search.options.MergeOptions;
import com.groupdocs.search.options.Cancellation;

MergeOptions options = new MergeOptions();
options.setCancellation(new Cancellation()); // Initialize cancellation object
options.getCancellation().cancelAfter(5000); // Cancel merge operation after 5 seconds

이유: Cancellation을 통해 병합 작업 취소를 자동으로 제어하여 과도한 작업을 방지합니다.

인덱스 병합

마지막으로 보조 인덱스를 기본 인덱스로 병합합니다.

index1.merge(index2, options);

이유: 이 호출 이후 index1은 두 소스의 모든 문서를 포함하게 되어 통합 검색 환경을 제공합니다.

Java용 Document Management 실무 적용 사례

법률 사무소: 여러 사무소의 사건 파일을 통합.
금융 기관: 분기 보고서를 하나의 검색 가능한 저장소로 병합.
기업: HR, 컴플라이언스, 정책 문서를 결합해 전사 검색을 구현.

성능 고려 사항

증분 인덱싱: 전체 인덱스를 재구성하는 대신 새 파일을 주기적으로 추가합니다.
메모리 모니터링: 대용량 배치는 RAM을 많이 차지하므로 작은 청크로 처리하는 것이 좋습니다.
가비지 컬렉션: 사용되지 않는 Index 객체를 즉시 해제해 리소스를 회수합니다.

일반적인 문제 및 해결책

문제	해결책
잘못된 폴더 경로	절대 경로를 확인하고 애플리케이션에 읽기 권한이 있는지 확인하세요.
메모리 부족	JVM 힙(`-Xmx`)을 늘리거나을 배치로 인덱싱하세요.
취소가 트리거되지 않음	`merge` 호출 전에 `cancelAfter`가 설정됐는지 확인하세요.
지원되지 않는 파일 형식	필요 시 GroupDocs에서 제공하는 추가 포맷 플러그인을 설치하세요.

자주 묻는 질문

Q: 왜 하나의 인덱스가 아니라 여러 인덱스를 만들까요?
A: 별도 인덱스를 사용하면 데이터 도메인을 분리하고, 서로 다른 보안 정책을 적용하며, 필요할 때만 병합할 수 있어 성능과 관리 효율이 향상됩니다.

Q: 인덱싱 작업도 병합과 동일하게 취소할 수 있나요?
A: 예 — Cancellation 객체와 add 메서드를 사용해 장시간 실행되는 인덱싱 작업을 중단할 수 있습니다.

Q: 매우 큰 문서 컬렉션에서 최적 성능을 보장하려면 어떻게 해야 하나요?
A: 증분 인덱싱을 수행하고 JVM 메모리를 모니터링하며, 인덱스 디렉터리용 SSD 스토리지를 고려하세요.

Q: “Access denied” 오류가 발생하면 어떻게 해야 하나요?
A: Java 프로세스를 실행하는 사용자의 폴더 권한을 확인하고, 라이선스 파일이 읽기 가능한지 점검하세요.

Q: GroupDocs.Search가 다른 GroupDocs 라이브러리와 호환되나요?
A: 물론입니다—GroupDocs.Viewer, GroupDocs.Conversion 등과 통합해 전체 스택 문서 솔루션을 구축할 수 있습니다.

결론

이 가이드를 통해 문서를 인덱스에 추가하고, 병합 동작을 구성하며, 필요 시 병합 작업 취소를 안전하게 수행하는 방법을 익혔습니다. 이제 견고한 document management java 워크플로 안에서 이를 활용할 수 있습니다. 더 큰 데이터셋을 실험하고, 커스텀 토크나이저를 탐색하거나 GroupDocs.Search를 다른 GroupDocs 제품과 결합해 진정한 엔터프라이즈급 솔루션을 구축해 보세요.

리소스

문서: GroupDocs.Search Java Docs
API 레퍼런스: GroupDocs API Reference
다운로드: Latest Releases
GitHub 저장소: GroupDocs Search for Java
무료 지원 포럼: GroupDocs Forum
임시 라이선스 신청: GroupDocs Temporary License

마지막 업데이트: 2026-01-03
테스트 환경: GroupDocs.Search 25.4 for Java
작성자: GroupDocs