GroupDocs.Search for Java를 사용하여 문서 인덱스 만들기 및 문서 추가 방법

수천 개의 PDF, DOCX, TXT 및 기타 형식을 즉시 검색할 수 있는 문서 인덱스 파일이 필요하다면, GroupDocs.Search for Java는 이를 수행할 수 있는 간결한 API를 제공합니다. 이 튜토리얼에서는 인덱스 폴더를 구성하고, 문서를 인덱스에 추가하며, 실제 Java 전체 텍스트 검색 시나리오에 맞게 검색 성능을 최적화하는 방법을 배웁니다.

빠른 답변

첫 번째 단계는 무엇인가요? Maven을 통해 GroupDocs.Search를 설치하거나 라이브러리를 다운로드합니다.
문서를 인덱스에 어떻게 추가하나요? 인덱스를 초기화한 후 index.add(yourDocumentsFolder)를 호출합니다.
인덱스를 저장할 폴더는 어디인가요? output과 같은 전용 폴더를 사용하고 new Index(indexFolder)로 구성합니다.
검색 속도를 향상시킬 수 있나요? 예—인덱스를 정기적으로 유지 관리하고 백그라운드 스레드에서 인덱싱을 실행합니다.
라이선스가 필요합니까? 테스트용으로는 체험판 또는 임시 라이선스로 충분하지만, 프로덕션에서는 정식 라이선스가 필요합니다.

문서 인덱스란 무엇인가요?

문서 인덱스는 소스 파일에서 추출한 검색 가능한 토큰을 포함하는 구조화된 데이터 저장소입니다. 문서 인덱스를 생성함으로써 런타임에 각 파일을 스캔하지 않고도 모든 인덱스된 콘텐츠에 대해 빠른 전체 텍스트 쿼리를 수행할 수 있습니다.

왜 GroupDocs.Search for Java를 사용하나요?

고성능 – 내장 최적화 덕분에 수백만 파일에서도 지연 시간이 낮게 유지됩니다.
쉬운 통합 – 인덱스 생성, 문서 추가, 쿼리 실행을 위한 간단한 API를 제공합니다.
확장 가능한 아키텍처 – 온프레미스 또는 클라우드에서 동작하며, 동의어 또는 랭킹 기능으로 맞춤 설정이 가능합니다.
Java 전체 텍스트 검색 – 기본적으로 다양한 형식을 지원합니다.

전제 조건

Java Development Kit (JDK) 8 이상.
IDE (예: IntelliJ IDEA 또는 Eclipse).
Maven (의존성 관리용).
Java 프로그래밍에 대한 기본적인 이해.

GroupDocs.Search for Java 설정

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>

직접 다운로드

또는 최신 버전을 직접 GroupDocs.Search for Java releases에서 다운로드합니다.

라이선스 획득

무료 체험 – 약정 없이 모든 기능을 탐색합니다.
임시 라이선스 – 체험 기간 이후에도 테스트를 지속할 수 있습니다.
구매 – 프로덕션 사용을 위한 정식 라이선스를 획득합니다.

기본 초기화

import com.groupdocs.search.Index;

public class InitializeGroupDocs {
    public static void main(String[] args) {
        // Create an index in the specified folder
        String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output";
        Index index = new Index(indexFolder);
        
        System.out.println("GroupDocs.Search initialized successfully.");
    }
}

문서를 인덱스에 추가하는 방법

단계 1: 인덱스 폴더와 소스 폴더 구성

String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output\\AdvancedUsage\\Searching\\SynonymSearch";
String documentsFolder = "YOUR_DOCUMENT_DIRECTORY"; // Replace with your actual document path

설명: indexFolder는 검색 가능한 인덱스가 저장될 위치이며, documentsFolder는 문서를 인덱스에 추가하려는 파일들을 가리킵니다.

단계 2: 인덱스 생성 (인덱스 폴더 구성)

Index index = new Index(indexFolder);

설명: 이 코드는 구성한 폴더에 데이터를 기록하는 새 인덱스 인스턴스를 생성합니다.

단계 3: 인덱싱을 위한 문서 추가

index.add(documentsFolder);

설명: add 메서드는 documentsFolder를 스캔하고 문서를 인덱스에 추가하여 해당 내용이 검색 가능하도록 합니다.

문제 해결 팁

누락된 의존성 – pom.xml의 Maven 항목을 다시 확인합니다.
잘못된 폴더 경로 – indexFolder와 documentsFolder가 존재하고 JVM이 접근할 수 있는지 확인합니다.

대용량 문서 처리

기가바이트 규모의 PDF 또는 방대한 DOCX 컬렉션을 다룰 때는 다음을 고려하세요:

배치 처리 – 소스 폴더를 작은 하위 폴더로 나누고 각 배치마다 index.add()를 호출합니다.
백그라운드 인덱싱 – 인덱싱 코드를 별도 스레드에서 실행하여 메인 애플리케이션이 응답성을 유지하도록 합니다.
힙 튜닝 – JVM -Xmx 설정을 늘려 대용량 파일을 처리할 충분한 메모리를 제공합니다.

검색 성능 최적화

검색 성능을 최적화하고 검색 지연 시간을 개선하려면 다음 모범 사례를 따르세요:

인덱스 세그먼트를 정기적으로 병합 – 쿼리 시 디스크 읽기 횟수를 줄입니다.
index.update() 사용 (가능한 경우) – 대량 추가 후 인덱스를 처음부터 다시 만들지 않고 업데이트합니다.
힙 사용량 모니터링 – 큰 인덱스는 상당한 메모리를 소모할 수 있으므로 JVM 옵션을 적절히 조정합니다.
캐시 활성화 – 애플리케이션 패턴이 허용한다면 자주 실행되는 쿼리에 대해 캐시를 사용합니다.

실용적인 적용 사례

기업 문서 관리 – 계약서, 정책, 인사 파일 등을 빠르게 검색합니다.
법률 조사 – 최소한의 지연 시간으로 사건 파일 및 판례를 찾습니다.
학술 도서관 – 연구자들이 수천 개의 논문을 검색할 수 있도록 합니다.

일반적인 문제와 해결책

문제	해결책
대량 인덱싱 중 메모리 부족 오류	소스 폴더를 더 작은 배치로 나누고 각 배치를 별도로 인덱싱합니다.
검색 결과가 오래된 상태로 반환	대규모 업데이트 후 `Index` 객체를 다시 열거나, 가능한 경우 `index.update()`를 호출합니다.
라이선스가 인식되지 않음	라이선스 파일 경로가 올바른지, 라이선스 버전이 라이브러리 버전과 일치하는지 확인합니다.

자주 묻는 질문

Q: 최소 Java 버전은 무엇인가요?
A: 완전한 호환성을 위해 Java 8 이상을 권장합니다.

Q: 매우 큰 문서 세트를 효율적으로 처리하려면 어떻게 해야 하나요?
A: 배치 처리를 사용하고, 백그라운드 스레드에서 인덱싱을 실행하며, JVM 메모리 설정을 튜닝합니다.

Q: GroupDocs.Search를 클라우드 환경에 배포할 수 있나요?
A: 예, 하지만 인덱스 폴더의 저장 위치가 모든 인스턴스에서 접근 가능하도록 해야 합니다.

Q: 동의어 검색의 장점은 무엇인가요?
A: 관련 단어로 쿼리 용어를 확장하여 정밀도를 유지하면서 재현율을 향상시킵니다.

Q: 더 고급 문서는 어디서 찾을 수 있나요?
A: 공식 API 레퍼런스인 GroupDocs.Search API Reference를 방문하세요.

리소스

문서: GroupDocs Search for Java
API 레퍼런스: GroupDocs Search API
다운로드: Latest Releases
GitHub: GroupDocs.Search on GitHub
무료 지원: GroupDocs Forum
임시 라이선스: Acquire a License

이 단계들을 따라 하면 이제 문서 인덱스 생성, 인덱스에 문서 추가, 인덱스 폴더 구성, 그리고 GroupDocs.Search for Java를 사용한 검색 성능 최적화 방법을 알게 됩니다. 즐거운 코딩 되세요!

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