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

Java 애플리케이션 내에서 java 전체 텍스트 검색 기능을 만들고 싶다면, 올바른 곳에 오셨습니다. 이 튜토리얼은 GroupDocs.Search 설치, 인덱스 구성, 문서 추가 및 인덱스 쿼리 과정을 단계별 코드 스니펫과 함께 안내합니다. 끝까지 읽으면 java 스타일로 문서를 인덱싱하는 방법을 이해하고, 빠르고 확장 가능한 검색을 모든 엔터프라이즈 솔루션에 삽입할 준비가 됩니다.

빠른 답변

  • GroupDocs.Search의 주요 목적은 무엇인가요?
    Java에서 다양한 문서 형식에 대해 빠른 전체 텍스트 인덱싱 및 검색을 제공하는 것입니다.
  • 추천되는 라이브러리 버전은 무엇인가요?
    최신 안정 버전(예: 작성 시점 25.4)입니다.
  • 예제 실행에 라이선스가 필요합니까?
    평가용 임시 라이선스를 제공하며, 운영 환경에서는 상용 라이선스가 필요합니다.
  • 검색 인덱스를 만들기 위한 주요 단계는 무엇인가요?
    라이브러리 설치, 인덱스 설정 구성, 문서 추가, 인덱스 쿼리입니다.
  • 인덱싱된 텍스트를 압축 형태로 저장할 수 있나요?
    예 – Compression.High와 함께 TextStorageSettings를 사용합니다.

java 전체 텍스트 검색이란?

Java 전체 텍스트 검색은 문서 컬렉션의 모든 검색 가능한 토큰을 해당 위치와 매핑하는 인덱스를 구축하는 과정을 의미합니다. 이를 통해 원본 파일을 매번 스캔하지 않고도 즉시 키워드와 구문을 조회할 수 있습니다. 인덱스는 토큰 위치, 빈도 및 메타데이터를 저장하여 검색 엔진이 관련성에 따라 결과를 순위 매기고 와일드카드, 퍼지 매칭, 근접 검색과 같은 고급 쿼리를 지원하도록 합니다.

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

GroupDocs.Search는 50개 이상의 입력 및 출력 형식을 지원합니다—PDF, Word, Excel, PowerPoint, HTML 및 다양한 이미지 형식을 포함—그리고 전체 파일을 메모리에 로드하지 않고도 수백 페이지 문서를 처리할 수 있습니다. 인덱싱 엔진은 수백만 레코드를 처리하더라도 서브초 수준의 쿼리 지연 시간을 제공하여 엔터프라이즈 급 검색에 신뢰할 수 있는 선택이 됩니다.

전제 조건

  • Java Development Kit (JDK) 8 이상.
  • Maven을 통한 의존성 관리.
  • Java I/O 및 인덱싱 개념에 대한 기본적인 이해.

Java용 GroupDocs.Search 설정

Maven 구성

pom.xml 파일에 GroupDocs 저장소와 Search 의존성을 추가합니다:

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

라이선스 획득

구매 전 전체 기능을 탐색할 수 있는 임시 라이선스를 Temporary License page에서 얻을 수 있습니다. 이 평가 기간을 통해 라이브러리를 환경에서 평가할 수 있습니다.

기본 초기화 및 설정

Index 클래스는 디스크에 검색 가능한 데이터 저장소를 나타내는 핵심 구성 요소입니다. 인스턴스를 생성하면 인덱스 파일이 지속될 폴더를 지정하게 됩니다.

String indexFolder = "YOUR_INDEX_DIRECTORY";
Index index = new Index(indexFolder);

GroupDocs.Search for Java로 검색 인덱스 생성하기

검색 가능한 인덱스를 만드는 것은 빠른 조회 솔루션의 기반입니다. 인덱스를 로드하고, 문서를 추가한 뒤, 몇 단계만으로 쿼리를 수행합니다.

“create search index groupdocs”란?

GroupDocs로 검색 인덱스를 만든다는 것은 문서의 모든 단어를 해당 위치와 매핑하는 검색 가능한 데이터 구조를 구축하는 것을 의미합니다. 이를 통해 원본 파일을 매번 스캔하지 않고도 즉시 키워드 조회, 구문 검색 및 고급 필터링이 가능해집니다. 또한 용어 빈도를 저장하여 쿼리 시 관련성 점수를 향상시킵니다.

GroupDocs.Search for Java로 검색 인덱스 생성 방법?

인덱스 폴더를 지정하여 Index 객체를 로드한 뒤, add 메서드로 소스 디렉터리의 모든 파일을 삽입합니다. 인덱싱이 완료되면 간단한 텍스트 쿼리나 복잡한 Boolean 식으로 인덱스를 조회할 수 있습니다. 이 접근 방식은 일반적인 문서 집합에 대해 1분 이내에 전체 텍스트 검색 파이프라인을 완료합니다. 인덱스가 구축된 후에는 디스크에 지속하고, 애플리케이션 재시작 시 재사용하며, 전체 인덱스를 재구축하지 않고도 문서를 추가하거나 삭제하여 증분 업데이트를 수행할 수 있습니다.

구현 가이드

GroupDocs.Search를 사용한 Java 문서 인덱싱

개요

인덱스를 만드는 것은 빠른 검색 기능을 활성화하는 첫 단계입니다. 아래에서 필요한 각 작업을 단계별로 살펴봅니다.

단계 1: 디렉터리 지정

인덱스가 저장될 위치와 소스 문서가 위치한 디렉터리를 정의합니다.

String indexFolder = "YOUR_INDEX_DIRECTORY";
String documentsFolder = "YOUR_DOCUMENTS_DIRECTORY"; 

단계 2: 인덱스 생성

검색 가능한 구조를 구축하기 위해 Index 객체를 인스턴스화합니다.

Index index = new Index(indexFolder);

단계 3: 인덱스에 문서 추가

단일 호출로 소스 폴더의 모든 파일을 인덱스로 전달합니다.

index.add(documentsFolder);

단계 4: 인덱싱된 문서 검색

인덱싱이 완료되면 인덱스된 항목을 열거할 수 있습니다:

DocumentInfo[] documents = index.getIndexedDocuments();
for (DocumentInfo document : documents) {
    String filePath = document.getFilePath();
    // Process each file path or perform further actions here
}

매개변수 및 메서드 목적

  • indexFolder: 인덱스 데이터가 저장되는 경로.
  • documentsFolder: 인덱싱할 파일이 들어 있는 디렉터리.

문제 해결 팁

  • 폴더 경로가 올바르고 접근 가능한지 확인하십시오.
  • 인덱싱 중 “access denied” 오류가 발생하면 파일 시스템 권한을 확인하십시오.

텍스트 저장 설정으로 인덱스 만들기

텍스트 저장 설정이란?

TextStorageSettings를 사용하면 각 문서에서 추출된 원시 텍스트가 어떻게 지속되는지(압축 수준 및 형식 포함)를 제어할 수 있습니다.

단계 1: 인덱스 설정 구성

IndexSettings 인스턴스를 생성하고 텍스트 저장을 구성합니다.

IndexSettings settings = new IndexSettings();
settings.setTextStorageSettings(new TextStorageSettings(Compression.High));

단계 2: 설정으로 인덱스 초기화

인덱스를 생성할 때 사용자 정의 설정을 전달합니다.

Index index = new Index(indexFolder, settings);

단계 3: 문서 텍스트 가져오기 및 저장

문서의 전체 텍스트를 추출하고 HTML(또는 지원되는 형식)로 저장합니다.

DocumentInfo[] documents = index.getIndexedDocuments();
if (documents.length > 0) {
    String outputPath = "YOUR_OUTPUT_DIRECTORY/Text.html";
    FileOutputAdapter outputAdapter = new FileOutputAdapter(OutputFormat.Html, outputPath);
    index.getDocumentText(documents[0], outputAdapter);
}

핵심 설정 옵션

  • Compression.High – 추출된 텍스트를 압축하여 저장 효율을 높입니다.

실용적인 적용 사례

  1. 엔터프라이즈 문서 관리 – 방대한 저장소에서 계약서, 정책, 보고서를 신속하게 찾을 수 있습니다.
  2. 콘텐츠 관리 시스템(CMS) – 사이트 전체 검색을 즉시 결과와 함께 제공합니다.
  3. 법률 문서 처리 – 사건 파일 및 증거 아카이브에서 키워드 기반 탐색을 가능하게 합니다.

성능 고려 사항

  • 인덱스 크기 최적화 – 주기적으로 오래된 항목을 정리하여 인덱스를 가볍게 유지합니다.
  • 메모리 관리 – 대규모 인덱싱 작업을 위해 JVM 가비지 컬렉터를 조정합니다.
  • 모범 사례 – 배치로 인덱싱하고, Index 인스턴스를 재사용하며, 무거운 작업에는 비동기 작업을 선호합니다.

일반적인 문제와 해결책

증상가능한 원인해결 방법
index.add() 호출 시 “Access denied”폴더 권한이 올바르지 않음프로세스 사용자에게 읽기/쓰기 권한 부여
알려진 용어에 대해 결과가 반환되지 않음텍스트 저장이 비활성화됨TextStorageSettings를 활성화하거나 적절한 설정으로 다시 인덱싱
대용량 배치에서 메모리 부족 오류JVM 힙이 너무 작음-Xmx 플래그를 늘리거나 문서를 더 작은 청크로 처리

자주 묻는 질문

Q: GroupDocs.Search for Java란?
A: Java 애플리케이션에 전체 텍스트 검색 기능을 추가하는 강력한 라이브러리이며, 50개 이상의 문서 형식을 지원합니다.

Q: GroupDocs.Search로 대용량 데이터셋을 어떻게 처리하나요?
A: 배치 처리 사용, 메모리 효율을 위한 IndexSettings 튜닝, 비동기 스레드에서 인덱싱 실행을 권장합니다.

Q: 텍스트 저장 설정에서 압축 수준을 맞춤 설정할 수 있나요?
A: 예, Compression.High, Compression.Medium, Compression.Low 중 선택하여 크기와 속도 사이의 균형을 맞출 수 있습니다.

Q: GroupDocs.Search가 지원하는 문서 유형은 무엇인가요?
A: PDF, Word, Excel, PowerPoint, HTML, 일반 텍스트 및 다수의 이미지 형식을 기본적으로 지원합니다.

Q: GroupDocs.Search에 커뮤니티 지원이 있나요?
A: 예, GroupDocs Forum에서 무료 지원을 받을 수 있습니다.

리소스

설정을 실험하고 API를 탐색함으로써 성능을 미세 조정하고 검색 경험을 정확히 원하는 대로 맞출 수 있습니다. 즐거운 코딩 되세요!

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

관련 튜토리얼