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:
- Legal document management – 사건 파일을 즉시 검색합니다.
- Academic research libraries – 논문 및 학위 논문을 빠르게 조회합니다.
- Enterprise knowledge bases – 매뉴얼 및 FAQ에 빠르게 접근합니다.
- Content management systems – 대규모 사이트의 효율적인 콘텐츠 탐색을 지원합니다.
- 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 커뮤니티 포럼을 방문하세요.
추가 자료
- 상세 사용 가이드: GroupDocs Search Documentation
- 전체 API 레퍼런스: API Reference Guide
- 새로운 기능을 최신 상태로 유지: Latest Releases
마지막 업데이트: 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());