GroupDocs.Search를 사용하여 Java에서 폴더를 인덱스에 추가하는 방법

수백만 개의 문서까지 확장할 수 있는 java full text search가 필요하다면, 올바른 곳에 오셨습니다. 이 튜토리얼에서는 GroupDocs.Search를 사용하여 add folder to index를 수행하고, 고압축 스토리지를 구성하며, 번개처럼 빠른 쿼리를 실행하는 방법을 배웁니다. 끝까지 진행하면 모든 Java 프로젝트에 적용할 수 있는 프로덕션 준비된 솔루션을 얻게 됩니다.

빠른 답변

  • 주요 라이브러리는 무엇인가요? GroupDocs.Search for Java
  • 폴더를 인덱스에 추가하려면 어떻게 하나요? Use index.add(folderPath)
  • 텍스트 압축을 구성할 수 있나요? Yes, via TextStorageSettings(Compression.High)
  • 필요한 Java 버전은 무엇인가요? JDK 8 or higher
  • 체험 라이선스는 어디서 얻을 수 있나요? From the GroupDocs website or the repository page

java full text search란 무엇이며 왜 중요한가요?

Java full text search는 원시 문서를 역인덱스로 변환하여 수천 개 파일에서 어떤 용어든 서브초 단위로 검색할 수 있게 합니다. 이 기능은 사용자가 즉시 결과를 기대하는 법률 저장소, 연구 도서관 및 기업 지식 베이스에 필수적입니다. 또한 최신 애플리케이션의 생산성을 향상시킵니다.

java full text search에 groupdocs.search를 사용하는 이유는?

GroupDocs.Search는 고처리량 인덱싱 및 쿼리 실행을 제공하면서 내장 고압축을 지원합니다. PDF, DOCX, EML, HTML 등을 포함한 50개 이상의 입력 및 출력 포맷을 지원하며, 전체 파일을 메모리에 로드하지 않고 수백 페이지 문서를 처리하여 일반 워크로드에서 메모리 사용량을 200 MB 이하로 유지합니다.

필수 조건

  • GroupDocs.Search for Java (version 25.4 or later) – 인덱싱 및 검색을 담당하는 핵심 라이브러리입니다.
  • JDK 8+ 설치 및 구성 – SDK에 필요한 최소 런타임입니다.
  • Maven 의존성 관리용 – 프로젝트에 라이브러리를 추가하는 작업을 간소화합니다.
  • IntelliJ IDEA 또는 Eclipse와 같은 IDE – 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에서 다운로드합니다.

라이선스 획득

  • Free trial – 약정 없이 모든 기능을 탐색할 수 있습니다.
  • Temporary license – 테스트 기간을 연장합니다.
  • Purchase – 전체 프로덕션 기능을 활성화합니다.

기본 초기화 및 설정

Index는 검색 인덱스를 생성, 열기 및 관리하는 핵심 클래스입니다.

import com.groupdocs.search.Index;

public class InitializeSearch {
    public static void main(String[] args) {
        // Path to store index data
        String indexPath = "path/to/index";
        
        // Creating an index at specified location
        Index index = new Index(indexPath);
        
        System.out.println("GroupDocs.Search initialized successfully!");
    }
}

맞춤 압축으로 텍스트 인덱싱

1단계: 인덱스 폴더 정의

인덱스 파일이 저장될 디렉터리를 선택합니다:

String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output\\AdvancedUsage\\Indexing\\StoringTextOfIndexedDocuments";

2단계: 인덱스 설정 구성

TextStorageSettings는 압축 수준을 포함하여 텍스트가 인덱스에 저장되는 방식을 구성합니다. Compression은 원하는 압축 알고리즘을 지정하는 열거형(enum)입니다.

import com.groupdocs.search.Index;
import com.groupdocs.search.IndexSettings;
import com.groupdocs.search.options.TextStorageSettings;
import com.groupdocs.search.compression.Compression;

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

3단계: 맞춤 설정으로 인덱스 생성

위에서 정의한 구성으로 인덱스를 인스턴스화합니다:

Index index = new Index(indexFolder, settings);
System.out.println("Index created with high compression.");

폴더를 인덱스에 추가하는 방법

Index는 검색 가능한 인덱스를 나타내는 주요 클래스입니다.

기존 인덱스를 로드(또는 새로 생성)한 후 Index 객체의 add 메서드를 호출합니다. add 작업은 지정된 디렉터리를 스캔하고, 지원되는 각 파일에서 텍스트를 추출하여 압축된 인덱스에 저장함으로써 즉시 검색할 수 있게 합니다.

String documentsFolder = "YOUR_DOCUMENT_DIRECTORY"; // Replace with actual document path.
Index index = new Index(indexFolder);

인덱싱된 문서를 검색하는 방법

SearchResult는 문서 경로와 관련성을 가진 단일 매치를 나타냅니다.

찾고자 하는 용어나 구문을 나타내는 검색 쿼리 문자열을 정의한 뒤 Index 인스턴스의 search 메서드를 호출합니다. 이 메서드는 SearchResult 객체 컬렉션을 반환하며, 각 객체는 문서 경로, 관련성 점수, 매치를 강조한 스니펫을 포함합니다.

index.add(documentsFolder);
System.out.println("Documents added successfully.");

실제 적용 사례

Real‑world scenarios where java full text search shines:

  1. Legal document management – 사건 파일을 즉시 검색합니다.
  2. Academic research libraries – 논문 및 학위 논문을 빠르게 조회합니다.
  3. Enterprise knowledge bases – 매뉴얼 및 FAQ에 빠르게 접근합니다.
  4. Content management systems – 대규모 사이트의 효율적인 콘텐츠 탐색을 지원합니다.
  5. Customer service archives – 과거 티켓 및 채팅을 신속하게 검색합니다.

성능 고려 사항

  • Compression vs. speed: 고압축은 디스크 공간을 최대 70 % 절감하지만 약간의 인덱싱 오버헤드를 추가합니다; 데이터 양에 대해 벤치마크 테스트를 수행하세요.
  • Memory management: 10 GB를 초과하는 인덱스의 경우 최소 2 GB 힙을 할당하여 OutOfMemoryError를 방지합니다.
  • Index updates: index.add()로 새 문서를 점진적으로 추가하고, 인덱스를 압축 상태로 유지하기 위해 주기적으로 index.optimize()를 호출합니다.
  • Query optimization: 고급 쿼리 구문(와일드카드, 근접, 퍼지 검색)을 사용하여 결과를 좁히고 응답 시간을 줄입니다.

일반적인 함정 및 전문가 팁

  • Pitfall: 대량 추가 후 index.optimize() 호출을 잊음.
    Pro tip: 인덱스를 압축 상태로 유지하기 위해 매일 index.optimize()를 실행합니다.

  • Pitfall: 대규모 데이터셋에 기본(낮은) 압축을 사용함.
    Pro tip: 저장 비용을 절감하기 위해 프로덕션 환경에서는 Compression.High로 전환합니다.

  • Pitfall: 네트워크 공유에서 파일을 추가할 때 IOException을 처리하지 않음.
    Pro tip: index.add()를 try‑catch 블록으로 감싸고, 실패를 로그에 기록하여 나중에 검토합니다.

자주 묻는 질문

Q: GroupDocs.Search란 무엇인가요?
A: 인덱싱, 압축 및 복잡한 쿼리 지원을 포함한 고급 전체 텍스트 검색 기능을 제공하는 강력한 Java 라이브러리입니다.

Q: GroupDocs.Search로 대규모 데이터셋을 어떻게 처리하나요?
A: 고압축(Compression.High)을 활성화하고 정기적으로 변경 사항을 커밋하여 인덱스를 가볍게 유지합니다. 또한 충분한 힙 메모리를 할당하세요(예: 20 GB 이상 인덱스의 경우 4 GB).

Q: 기존 엔터프라이즈 시스템에 GroupDocs.Search를 통합할 수 있나요?
A: 네, 이 라이브러리는 Java 기반 백엔드, REST 서비스 또는 마이크로서비스 아키텍처에 임베드할 수 있습니다.

Q: 인덱스가 오래되면 어떻게 해야 하나요?
A: index.add() 메서드로 새 파일을 추가하고 index.delete()로 오래된 파일을 제거한 뒤, 필요하면 index.optimize()를 다시 실행합니다.

Q: 도움이나 지원을 어디서 받을 수 있나요?
A: 문제 해결 및 모범 사례 팁을 위해 GroupDocs forums 커뮤니티 포럼을 방문하세요.

추가 자료

마지막 업데이트: 2026-11-02
테스트 대상: GroupDocs.Search 25.4
작성자: GroupDocs

String query = "sample";  
import com.groupdocs.search.results.SearchResult;

SearchResult result = index.search(query);
System.out.println("Search completed. Results found: " + result.getDocumentCount());

관련 튜토리얼