Java에서 GroupDocs.Search를 사용하여 검색 결과 강조하기

애플리케이션에서 Java로 검색 결과를 강조해야 한다면, 올바른 곳에 오셨습니다. 이 가이드는 GroupDocs.Search for Java를 사용하여 원본 문서와 HTML 미리보기 내에서 일치하는 용어를 시각적으로 강조하는 과정을 안내합니다. 문서 검색 포털, 엔터프라이즈 지식 베이스, 혹은 간단한 파일 탐색기를 구축하든, 여기서 다루는 기술은 보다 명확하고 직관적인 사용자 경험을 제공하는 데 도움이 됩니다.

빠른 답변

  • “highlight search results java”가 무엇을 하나요?
    문서나 미리보기 내에서 쿼리 용어가 나타나는 모든 위치를 시각적으로 표시하여 일치를 쉽게 찾을 수 있게 합니다.
  • 지원되는 파일 형식은 무엇인가요?
    Word, PDF, Excel, PowerPoint, 일반 텍스트 등 GroupDocs.Search를 통해 지원되는 다양한 형식.
  • 라이선스가 필요합니까?
    개발 단계에서는 임시 라이선스로 충분하지만, 운영 환경에서는 정식 라이선스가 필요합니다.
  • 하이라이트 스타일을 사용자 정의할 수 있나요?
    예—색상, 글꼴, 투명도 등을 프로그래밍 방식으로 설정할 수 있습니다.
  • 추가 설정이 필요합니까?
    프로젝트에 GroupDocs.Search for Java 라이브러리를 추가하고 API를 참조하기만 하면 됩니다.

Java 검색 결과 강조란 무엇인가요?

Search result highlighting Java는 GroupDocs.Search가 문서 내에서 찾은 검색어의 모든 인스턴스에 시각적 표시(보통 배경 색상)를 프로그래밍 방식으로 적용하는 기술입니다. 이를 통해 최종 사용자는 전체 파일을 수동으로 스캔하지 않고도 관련 정보를 쉽게 찾을 수 있습니다.

Java용 GroupDocs.Search 강조 기능을 사용하는 이유는 무엇인가요?

GroupDocs.Search는 DOCX, PDF, XLSX, PPTX, TXT, HTML 등을 포함한 30개 이상의 파일 형식에서 강조 기능을 지원합니다. 표준 서버 하드웨어에서 서브 초 수준의 쿼리 지연 시간을 유지하면서 최대 1천만 개 문서를 인덱싱할 수 있습니다. API를 사용하면 색상, 투명도 및 용어별로 다른 스타일을 적용할 수 있어 브랜드 UI 가이드라인에 완벽히 맞출 수 있습니다.

전제 조건

  • Java 8 이상이 설치되어 있어야 합니다.
  • 프로젝트에 GroupDocs.Search for Java 라이브러리를 추가했습니다 (Maven/Gradle 의존성).
  • 임시 또는 정식 GroupDocs.Search 라이선스 파일.

단계별 가이드

Step 1: 검색 엔진 초기화

SearchEngine은 문서 컬렉션을 인덱싱하고 쿼리하는 핵심 클래스입니다. SearchEngine 인스턴스를 생성하고 검색하려는 문서를 포함하는 인덱스를 로드합니다.

Note: 이 단계의 코드는 아래 링크된 종합 가이드에 제공됩니다.

Step 2: 검색 쿼리 수행

SearchResult는 사용자의 쿼리와 일치하는 결과를 포함하는 단일 문서를 나타냅니다. search 메서드를 쿼리 문자열과 함께 호출하면 SearchResult 객체 컬렉션을 반환합니다.

Step 3: 원본 문서에서 일치 항목 강조

HighlightOptions를 사용하면 시각적 스타일(색상, 투명도 및 전체 조각을 강조할지 정확한 용어만 강조할지)을 지정할 수 있습니다. 각 SearchResult에 대해 강조 API를 호출하여 시각적 표시를 소스 파일에 직접 삽입합니다.

Step 4: HTML 미리보기 생성 (옵션)

원본 파일 대신 웹 기반 미리보기를 표시하고 싶다면, HighlightResult 클래스를 사용하여 강조된 용어가 포함된 HTML 스니펫을 생성합니다. 이는 브라우저 기반 뷰어 또는 경량 모바일 앱에 유용합니다.

Step 5: 강조된 출력 저장 또는 스트리밍

강조 작업 후 원본 문서를 덮어쓰거나, 새로운 강조 복사본을 저장하거나, 결과를 클라이언트 브라우저에 직접 스트리밍할 수 있습니다.

PDF에서 용어 강조하는 방법

SearchEngine으로 PDF를 로드하고 30 % 투명도의 밝은 노란색을 사용하는 HighlightOptions를 적용합니다—이 조합은 일반적인 PDF 배경에서 명확히 보이며 원본 레이아웃을 유지합니다. API는 각 일치 항목에 대한 정확한 좌표를 자동으로 계산하여 텍스트 흐름과 이미지를 보존합니다. 강조 후 수정된 PDF를 디스크에 저장하거나 클라이언트에 직접 스트리밍할 수 있습니다. 이 방법은 원본 파일 구조를 변경하지 않고 단일 페이지 및 다중 페이지 PDF 모두에 적용됩니다.

Word 문서에서 일치 항목 강조

HighlightResult는 Word 파일에서도 동일하게 작동하지만, Word 고유 스타일을 유지하는 HighlightColor를 선택해야 합니다(예: Microsoft Word에서 열어도 제거되지 않는 연한 청록색). 이를 통해 강조가 다양한 Word 버전에서 지속됩니다.

일반적인 문제 및 해결책

  • 하이라이트가 표시되지 않음: 문서 형식이 지원되는지, 검색 쿼리가 파일 내용과 실제로 일치하는지 확인하십시오.
  • 대용량 파일에서 성능 저하: 비동기 인덱싱을 활성화하거나 배치로 문서를 처리하십시오.
  • 잘못된 색상: HighlightColor 열거형 값을 올바르게 사용했는지, UI의 CSS에 의해 스타일이 덮어쓰여지지 않았는지 확인하십시오.

사용 가능한 튜토리얼

GroupDocs.Search for Java: 문서에서 검색어 강조 | 종합 가이드

GroupDocs.Search for Java를 사용하여 문서에서 검색어를 강조하는 방법을 배웁니다. 전체 문서와 특정 조각에 대한 강조 기술을 알아봅니다.

추가 리소스

자주 묻는 질문

Q: 암호로 보호된 PDF에서 검색 결과를 강조할 수 있나요?
A: 예. 문서를 로드할 때 비밀번호를 제공하면 동일한 강조 방법을 적용할 수 있습니다.

Q: 강조가 원본 파일을 영구적으로 수정합니까?
A: 기본적으로 새 복사본을 생성하지만, 원한다면 원본을 덮어쓸 수 있습니다.

Q: 여러 검색어를 한 번에 강조할 수 있나요?
A: 물론입니다. 검색 엔진에 용어 목록을 전달하면 각 용어가 구성된 스타일로 강조됩니다.

Q: 서로 다른 용어에 대해 강조 색상을 어떻게 변경하나요?
A: 강조 메서드를 호출하기 전에 HighlightOptions 클래스를 사용하여 용어별로 서로 다른 HighlightColor 값을 지정합니다.

Q: 문서에 수백만 페이지가 포함된 경우는 어떻게 해야 하나요?
A: 문서를 청크 단위로 처리하고 스트리밍 API를 사용하여 전체 파일을 메모리에 로드하지 않도록 합니다.

마지막 업데이트: 2026-09-27
테스트 환경: GroupDocs.Search for Java 23.11
작성자: GroupDocs

관련 튜토리얼