java 전체 텍스트 검색을 GroupDocs.Search와 함께 사용하는 방법

이 튜토리얼에서는 GroupDocs.Search for Java를 사용하여 java 전체 텍스트 검색을 구현하는 방법을 알아봅니다. 인덱스 폴더 구성, 문서를 인덱스에 추가, 수천 개의 PDF, DOCX, TXT 및 기타 형식에 대해 검색 성능을 최적화하는 모범 사례 기술을 적용하는 과정을 안내합니다. 마지막까지 빠르게 실행되고 확장성이 뛰어난 프로덕션 준비된 검색 컴포넌트를 얻게 됩니다.

빠른 답변

  • 첫 번째 단계는 무엇인가요? Maven 프로젝트에 GroupDocs.Search를 추가하거나 공식 릴리스 페이지에서 JAR를 다운로드하십시오.
  • 인덱스에 문서를 어떻게 추가하나요? Index 객체를 인스턴스화한 후 index.add(yourDocumentsFolder)를 호출합니다.
  • 인덱스를 저장할 폴더는 어디인가요? output과 같은 전용 폴더를 사용하고 new Index(indexFolder)에 전달합니다.
  • 검색 속도를 향상시킬 수 있나요? 예—인덱스 세그먼트를 정기적으로 병합하고, 백그라운드 스레드에서 인덱싱을 실행하며, JVM 힙 크기를 조정합니다.
  • 라이선스가 필요합니까? 테스트용으로는 체험판 또는 임시 라이선스로 충분하지만, 프로덕션 배포에는 정식 라이선스가 필요합니다.

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

문서 인덱스는 소스 파일에서 추출된 검색 가능한 토큰을 포함하는 구조화된 데이터 저장소입니다. 문서 인덱스를 생성하면 런타임에 각 파일을 스캔하지 않고도 모든 인덱스된 콘텐츠에 대해 빠른 전체 텍스트 쿼리를 수행할 수 있습니다. 용어 빈도, 위치 및 메타데이터를 저장하여 검색 엔진이 결과를 효율적으로 순위 매길 수 있게 합니다.

Java용 GroupDocs.Search를 사용하는 이유

GroupDocs.Search는 Java 애플리케이션에서 전체 텍스트 검색을 위한 고성능, 손쉬운 통합 솔루션을 제공합니다. 다양한 문서 형식을 지원하며 대규모 컬렉션에서도 지연 시간을 낮게 유지하는 내장 최적화를 제공합니다.

  • 고성능 – 수백만 개의 파일에서도 지연 시간을 낮게 유지하는 내장 최적화.
  • 쉬운 통합 – 인덱스 생성, 문서 추가 및 쿼리 실행을 위한 간단한 API.
  • 확장 가능한 아키텍처 – 온프레미스 또는 클라우드에서 작동하며, 동의어 또는 순위 기능으로 맞춤 설정 가능.
  • Java 전체 텍스트 검색 – PDF, DOCX, TXT, HTML 등을 포함한 다양한 형식을 즉시 지원하며 50개 이상의 추가 유형을 지원합니다.

전제 조건

  • Java Development Kit (JDK) 8 이상.
  • IntelliJ IDEA 또는 Eclipse와 같은 IDE.
  • 의존성 관리를 위한 Maven.
  • Java 프로그래밍 개념에 대한 기본적인 이해.

Java용 GroupDocs.Search 설정

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에서 직접 다운로드하십시오.

라이선스 획득

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

기본 초기화

Index 클래스는 디스크에 저장된 검색 가능한 인덱스를 나타내는 핵심 객체입니다. 문서를 추가, 업데이트 및 쿼리하는 메서드를 제공합니다.

import com.groupdocs.search.Index;

public class InitializeGroupDocs {
    public static 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.");
    }
}

인덱스에 문서 추가 방법

문서를 로드하고, 인덱스 폴더를 구성한 뒤 add 메서드를 호출합니다—세 단계로 간결하게 수행합니다.

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

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

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

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

indexFolder 경로와 함께 Index 객체를 인스턴스화하면 지정된 위치에 데이터를 기록하는 새로운 인덱스 인스턴스가 생성됩니다.

Index index = new Index(indexFolder);

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

add 메서드는 지정된 폴더를 스캔하고 지원되는 각 문서를 인덱스에 추가하여 호출이 반환된 직후에 해당 콘텐츠를 검색 가능하게 합니다.
add 메서드는 지정된 폴더를 스캔하고 지원되는 각 문서를 인덱스에 추가합니다.

index.add(documentsFolder);

문제 해결 팁

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

인덱스 폴더 구성 방법

인덱스 폴더를 빠른 SSD, 네트워크 공유 또는 Java 프로세스가 접근할 수 있는任意 위치에 배치할 수 있습니다. 클라우드 배포의 경우 영구 볼륨(예: Azure Files 또는 Amazon EFS)을 매핑하고 해당 마운트 지점을 Index 생성자에 전달하십시오. 이 방법은 인덱스가 애플리케이션 재시작 후에도 유지되고 인프라와 함께 확장됨을 보장합니다.

대용량 문서 처리

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

  1. 배치 처리 – 소스 폴더를 더 작은 하위 폴더로 나누고 각 배치에 대해 index.add()를 호출합니다.
  2. 백그라운드 인덱싱 – 인덱싱 코드를 별도 스레드에서 실행하여 메인 애플리케이션이 응답성을 유지하도록 합니다.
  3. 힙 튜닝 – 대용량 파일을 처리할 수 있도록 JVM -Xmx 설정을 증가시킵니다.

검색 성능 최적화

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

update 메서드는 인덱스를 처음부터 재구성하지 않고 보류 중인 변경 사항을 적용합니다.

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

실용적인 적용 사례

  1. 엔터프라이즈 문서 관리 – 계약서, 정책, HR 파일을 밀리초 단위로 검색합니다.
  2. 법률 연구 – 사례 파일 및 판례를 최소 지연 시간으로 찾습니다.
  3. 학술 도서관 – 수천 개의 연구 논문을 빠르게 검색할 수 있게 합니다.

일반적인 문제와 해결책

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

자주 묻는 질문

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

Q: 매우 큰 문서 세트를 효율적으로 처리하려면 어떻게 해야 하나요?
A: “대용량 문서 처리” 섹션에 설명된 대로 배치 처리, 백그라운드 스레드에서 인덱싱 실행, JVM 메모리 설정 튜닝을 사용하십시오.

Q: GroupDocs.Search를 클라우드 환경에 배포할 수 있나요?
A: 예, 모든 인스턴스가 읽고 쓸 수 있는 한 클라우드 접근 가능한 스토리지(예: Azure Files, Amazon EFS)에 인덱스 폴더를 저장할 수 있습니다.

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

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

리소스

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


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

관련 튜토리얼