GroupDocs.Search for Java를 사용한 Java 검색 인덱스 만들기

이 포괄적인 가이드에서는 GroupDocs.Search for Java를 사용하여 create search index java 애플리케이션을 만드는 방법과 highlight search results java를 통해 사용자가 PDF, Office 파일, HTML 페이지 등에서 일치 항목을 즉시 확인할 수 있는 방법을 배웁니다. 가벼운 데스크톱 유틸리티를 만들든 고처리량 엔터프라이즈 검색 서비스를 구축하든, 아래 단계에서는 다양한 형식 인덱싱부터 성능 미세 조정 및 Java 부울 쿼리 예제 실행까지 모두 다룹니다.

빠른 개요

  • Index diverse document types – PDF, DOCX, PPTX, XLSX, HTML 및 150개 이상의 기타 형식.
  • Run advanced queries – Boolean, fuzzy, wildcard, phrase, regex 및 faceted 검색.
  • Leverage language processing – 동의어, 맞춤법 검사, 동음이의어 감지 및 사용자 정의 사전.
  • Integrate OCR – 스캔된 이미지에서 텍스트를 추출하고 검색 가능한 인덱스에 추가합니다.
  • Optimize performance – 메모리 사용량, 인덱스 크기 및 쿼리 응답 시간을 제어하여 멀티 기가바이트 규모의 인덱스를 관리합니다.
  • Highlight results – 원본 문서 또는 HTML 미리보기에서 일치 항목을 직접 표시하며, 색상 및 CSS 클래스를 사용자 정의할 수 있습니다.

아래는 각 기능을 단계별로 안내하는 전용 튜토리얼 목록입니다.

빠른 답변

  • What does “highlight search results java” do? 원본 문서 또는 생성된 HTML 미리보기에서 일치하는 용어를 시각적으로 표시하여 사용자가 관련 스니펫을 즉시 찾을 수 있게 합니다.
  • Which library provides faceted search java? GroupDocs.Search for Java는 메타데이터 필드별로 결과를 그룹화하는 내장된 faceted search 지원을 포함합니다.
  • Can I implement OCR java with the same API? 예—단일 OcrOptions 설정으로 OCR 엔진을 활성화하면 동일한 인덱싱 워크플로우가 이미지에서 텍스트를 추출합니다.
  • Do I need a license for production use? 체험 기간이 끝나면 상용 라이선스가 필요합니다.
  • Is the API compatible with Java 17 and later? Java 8+를 완전히 지원하며, Java 17에서 테스트되었고 모든 JVM 호환 플랫폼에서 실행됩니다.

“highlight search results java”란 무엇인가요?

Highlighting search results in Java means programmatically applying visual cues—such as background colors or bold styling—to the exact words or phrases that matched a user’s query. 이 기술은 사용자가 긴 문서를 스캔하는 시간을 단축하고 전체 검색 사용성을 향상시킵니다.

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

GroupDocs.Search for Java indexes and queries thousands of documents in under two seconds on a standard 8‑core server. 150개 이상의 파일 형식을 지원하고, 전체 컬렉션을 메모리에 로드하지 않고도 멀티 기가바이트 인덱스를 처리하며, 즉시 사용할 수 있는 OCR, faceted search 및 동의어 처리를 제공합니다—모두 유창하고 잘 문서화된 API를 통해 제공합니다.

전제 조건

  • Java 8 이상 (Java 17 권장)
  • Maven 또는 Gradle을 사용한 종속성 관리
  • 유효한 GroupDocs.Search for Java 라이선스 (체험판 제공)

단계별 가이드

1단계: 프로젝트 설정

Maven 또는 Gradle 프로젝트를 생성하고 GroupDocs.Search 의존성을 추가합니다. 라이선스 파일(GroupDocs.Search.lic)을 src/main/resources 폴더에 배치하면 SDK가 자동으로 로드합니다.

2단계: 인덱스 생성

Index는 디스크에 검색 가능한 저장소를 나타내는 핵심 클래스입니다.

Index index = new Index("path/to/index/folder");

Index를 인스턴스화한 후, 검색 가능하도록 만들 문서마다 add를 호출합니다. SDK가 파일 유형을 자동으로 감지하고 텍스트를 추출합니다.

3단계: OCR 활성화 (implement OCR java)

OcrOptions는 내장 OCR 엔진을 구성합니다.

OcrOptions ocr = new OcrOptions();
ocr.setLanguage("eng");
ocr.setDpi(300);

OcrOptions 인스턴스를 인덱싱 호출에 연결하면 스캔된 이미지가 검색 가능한 텍스트로 변환됩니다.

4단계: 검색 쿼리 수행

SearchOptions는 인덱스에 보낼 쿼리를 구성합니다.

SearchOptions options = new SearchOptions()
    .setQuery("invoice")
    .setBooleanOperator(BooleanOperator.AND)
    .setFuzzy(true);

Java boolean query example를 faceted 필터, 와일드카드 또는 정규식 패턴과 결합하여 결과를 더욱 좁힐 수 있습니다.

5단계: highlight search results java

Highlight는 일치하는 문서의 하이라이트 버전을 생성하는 유틸리티 클래스입니다.

HighlightOptions highlight = new HighlightOptions()
    .setColor(Color.YELLOW)
    .setCssClass("search-highlight");
HighlightResult result = Highlight.apply(searchResult, highlight);

API는 수정된 PDF 파일 또는 모든 일치 용어가 선택된 스타일로 감싸진 HTML 스니펫을 반환합니다.

6단계: 검토 및 최적화

내장된 통계 API를 사용하여 인덱스 크기, 메모리 사용량 및 쿼리 지연 시간을 모니터링합니다. maxMemoryUsage를 조정하거나 압축(setCompression(true))을 활성화하여 수백만 레코드를 처리할 때 인덱스를 가볍게 유지합니다.

일반적인 문제 및 해결책

  • No highlights appear: 지원되는 출력 형식(HTML 또는 PDF)으로 HighlightOptions 객체를 전달했는지 확인하십시오.
  • OCR misses text: 언어 팩이 설치되어 있고 원본 이미지가 최소 300 dpi 권장 사항을 충족하는지 확인하십시오.
  • Faceted search returns empty buckets: 2단계에서 Facet 유형으로 인덱싱한 필드가 faceted 대상인지 확인하십시오.

자주 묻는 질문

Q: Can I use faceted search java together with fuzzy matching?
A: 예—동일한 SearchOptions 빌더에서 facet 필터와 fuzzy 쿼리를 연결할 수 있어, 오타를 허용하면서 결과를 좁힐 수 있습니다.

Q: Does highlighting work on encrypted PDFs?
A: 문서를 인덱스에 추가할 때 올바른 비밀번호를 제공한 경우에만 작동합니다. SDK가 이를 복호화하고, 하이라이트를 적용한 뒤, 출력물을 다시 암호화합니다.

Q: How large can an index become before performance degrades?
A: 이 라이브러리는 멀티 기가바이트 인덱스를 안정적으로 처리합니다. 압축을 활성화하고 maxMemoryUsage를 조정하면 1천만 문서에서도 쿼리 시간을 200 ms 이하로 유지할 수 있습니다.

Q: Is there a way to customize the highlight color?
A: 물론입니다. HighlightOptions.setColor(Color.YELLOW)를 사용하거나 setCssClass를 통해 HTML 출력에 대한 사용자 정의 CSS 클래스를 제공하면 됩니다.

Q: What version of GroupDocs.Search is tested with this guide?
A: 예제는 GroupDocs.Search for Java 23.9 버전으로 검증되었습니다.

관련 주제

Java 문서 검색 기능 개요

  • Multi‑format support – PDF, DOCX, PPT, XLS, HTML 및 이미지 파일을 포함한 150개 이상의 입력 및 출력 형식.
  • Advanced search types – Boolean, fuzzy, wildcard, phrase, regex 및 faceted search java 옵션.
  • Intelligent indexing – 선택적 압축을 지원하는 빠르고 구성 가능한 문서 인덱싱.
  • Language processing – 동의어 감지, 맞춤법 검사 및 동음이의어 인식.
  • OCR support – 이미지 및 스캔 문서에서 텍스트를 추출하고 검색 (implement OCR java).
  • Performance optimization – 멀티 기가바이트 인덱스를 위한 메모리 사용량 및 쿼리 속도 조정 가능.
  • Result highlighting – 원본 문서에서 검색 일치를 시각적으로 강조 (highlight search results java).
  • Dictionary support – 특수 용어 및 도메인을 위한 사용자 정의 사전.
  • Distributed search – 네트워크 기능을 활용한 확장 가능하고 샤드된 검색 솔루션 구축.
  • Blazing speed – 일반 서버에서 10 000 문서를 2초 미만에 처리 및 검색.

학습 자료

마지막 업데이트: 2026-08-26
테스트 대상: GroupDocs.Search for Java 23.9
작성자: GroupDocs