GroupDocs.Search와 함께 Java에서 퍼지 검색을 활성화하는 방법 – 시작 가이드
이 포괄적인 가이드에서는 GroupDocs.Search 라이브러리를 사용하여 Java에서 퍼지 검색을 활성화하는 방법을 배웁니다. SDK 설치, 라이선스 적용, 퍼지 매칭 구성 및 다양한 문서 유형을 인덱싱하는 과정을 단계별로 안내하여 사용자가 철자 오류나 다른 용어를 사용하더라도 관련 콘텐츠를 찾을 수 있도록 합니다. 튜토리얼이 끝날 때쯤에는 15분 이내에 완전한 검색 솔루션을 사용할 수 있게 됩니다.
빠른 답변
- 첫 번째 단계는 무엇인가요? Maven
pom.xml또는 Gradlebuild.gradle에 GroupDocs.Search 의존성을 추가합니다. - 라이선스가 필요합니까? 예—임시 개발 라이선스는 테스트에 사용할 수 있으며, 프로덕션 배포에는 영구 라이선스가 필요합니다.
- 어떤 IDE가 가장 적합합니까? Maven 또는 Gradle을 지원하는 모든 Java IDE(IntelliJ IDEA, Eclipse, VS Code)입니다.
- PDF, Word, Excel 파일을 인덱싱할 수 있나요? 물론입니다—GroupDocs.Search는 PDF, DOCX, XLSX, PPTX 및 다양한 이미지 형식을 포함해 50개 이상의 파일 형식을 기본적으로 지원합니다.
- 퍼지 검색을 어떻게 활성화하나요? 쿼리를 실행하기 전에
SearchOptions인스턴스의fuzzySearch속성을true로 설정합니다. - 전체 설정에 얼마나 걸리나요? 새 프로젝트의 경우 일반적으로 15분 미만이 소요됩니다.
GroupDocs.Search에서 “퍼지 검색 활성화”란 무엇인가요?
퍼지 검색을 활성화하면 엔진이 쿼리 용어를 매칭할 때 사소한 철자 변형, 누락된 문자 또는 문자 순서가 바뀐 경우를 허용하도록 합니다. 이 기능은 사용자 오타, OCR 생성 텍스트, 다국어 콘텐츠와 같은 상황에서 검색 가능성을 크게 향상시킵니다. 정확한 키워드가 없더라도 검색 알고리즘이 관련 문서를 반환하기 때문입니다.
Java용 GroupDocs.Search를 구성하고 퍼지 검색을 활성화하는 이유는 무엇인가요?
최소한의 코드로 즉시 프로덕션 수준의 검색 기능을 얻을 수 있으며, 사용자 경험도 향상됩니다. GroupDocs.Search는 문서를 메모리에 완전히 로드하지 않고 인덱싱하며, 50개 이상의 입력 및 출력 형식을 지원하고, 일반 하드웨어에서 수백만 개 파일까지 확장할 수 있습니다. 퍼지 검색을 활성화하면 허용 레이어가 추가되어 실패한 쿼리를 최대 **80 %**까지 감소시켜, 오타가 있는 사용자 입력을 추가 개발 없이도 정확한 결과로 변환합니다.
사전 요구 사항
- Java Development Kit (JDK) 8 이상.
- Maven 3 또는 Gradle 5 (의존성 관리용).
- 임시 또는 영구 GroupDocs.Search 라이선스 키.
단계별 가이드
단계 1: 프로젝트에 GroupDocs.Search 추가
pom.xml(Maven) 또는 build.gradle(Gradle)에 GroupDocs.Search 의존성을 추가합니다. 이렇게 하면 컴파일 및 런타임 시 클래스패스에 라이브러리가 포함됩니다.
단계 2: 라이선스 적용
License는 GroupDocs.Search 라이선스 파일을 로드하고 검증하여 퍼지 매칭과 같은 모든 프리미엄 기능을 활성화합니다. License 인스턴스를 생성하고 GroupDocs에서 받은 .lic 파일을 지정합니다.
단계 3: 인덱스 설정 초기화
인덱스 파일이 저장될 디스크상의 폴더를 정의합니다. 이 단계에서 대소문자 구분, 불용어 및 기타 인덱싱 옵션을 구성할 수도 있습니다.
단계 4: 문서 인덱싱
Indexer 클래스는 파일을 읽고 검색 가능한 텍스트를 추출하여 인덱스 폴더에 데이터를 기록합니다. 파일 유형을 자동으로 감지하므로 추가 코드 없이 PDF, DOCX, XLSX 및 이미지 혼합을 인덱싱할 수 있습니다.
단계 5: 쿼리에서 퍼지 검색 활성화
SearchOptions는 퍼지 매칭 및 필터와 같은 검색 작업의 매개변수를 구성합니다.SearchOptions 객체를 생성할 때 fuzzySearch 플래그를 true로 설정합니다. 엔진의 허용 정도를 제어하려면 fuzzinessLevel(예: 2)을 조정할 수도 있습니다.
단계 6: 검색 쿼리 수행
search 메서드는 인덱스에 대해 쿼리를 실행하고 일치하는 결과를 반환합니다.
쿼리 문자열과 구성된 SearchOptions를 사용하여 search 메서드를 호출합니다. 이 메서드는 각 문서 경로와 퍼지 매치를 반영한 관련 점수를 포함하는 SearchResult 객체 리스트를 반환합니다. SearchResult는 경로와 관련 점수를 포함한 단일 문서 매치를 나타냅니다.
단계 7: 결과 검토
SearchResult는 경로와 관련 점수를 포함한 단일 문서 매치를 나타냅니다.SearchResult 컬렉션을 반복하면서 파일 이름을 표시하고, 필요에 따라 UI에서 매치된 용어를 강조 표시합니다. 퍼지 매치는 일반적으로 정확한 매치보다 약간 낮은 관련 점수를 가지며, 이를 결과 순위에 활용할 수 있습니다.
일반적인 문제 및 해결책
- 라이선스가 인식되지 않음 – 라이선스 파일 경로가 올바른지, 파일이 사용 중인 GroupDocs.Search 버전과 일치하는지 확인합니다.
- 문서 형식 누락 – 덜 일반적인 파일 형식을 지원하려면 선택적
groupdocs-conversion애드온을 설치합니다. - 퍼지 검색이 결과를 반환하지 않음 –
fuzzySearch플래그가true인지, 쿼리 길이가 최소 문자 요구사항(보통 세 문자)을 충족하는지 확인합니다. - 성능 병목 – 증분 인덱싱을 사용하고 인덱스 폴더를 SSD에 저장하여 읽기/쓰기 속도를 향상시킵니다.
자주 묻는 질문
Q: Linux 서버에서 GroupDocs.Search를 실행할 수 있나요?
A: 예, 이 라이브러리는 플랫폼에 독립적이며 Java를 지원하는 모든 운영 체제에서 작동합니다.
Q: 기존 인덱스에 새 파일을 추가하려면 어떻게 해야 하나요?
A: 새 파일을 사용하여 Indexer를 다시 호출하면 SDK가 자동으로 현재 인덱스에 병합합니다.
Q: 검색 결과를 특정 폴더로 제한할 수 있나요?
A: 예, 쿼리를 실행하기 전에 SearchOptions에 폴더 필터를 설정합니다.
Q: 임시 라이선스가 만료되면 어떻게 되나요?
A: API가 제한된 기능의 평가 모드로 전환됩니다; 전체 기능을 복구하려면 임시 키를 영구 라이선스로 교체하십시오.
Q: GroupDocs.Search가 퍼지 검색을 지원하나요?
A: 물론입니다—SearchOptions에서 fuzzySearch 플래그를 활성화하면 사소한 철자 변형을 포함한 결과를 검색할 수 있습니다.
Q: 퍼지 검색을 날짜 범위와 같은 다른 필터와 결합할 수 있나요?
A: 예, 퍼지 매칭을 유지하면서 SearchOptions에 추가 필터를 추가할 수 있습니다.
추가 리소스
사용 가능한 튜토리얼
Java용 GroupDocs.Search 배포: 종합 설정 가이드
이 단계별 가이드를 통해 Java용 GroupDocs.Search를 배포하고 구성하는 방법을 배웁니다. 프로젝트에서 문서 인덱싱 및 검색 기능을 향상시킵니다.
유용한 링크
- Java용 GroupDocs.Search 문서
- Java용 GroupDocs.Search API 레퍼런스
- Java용 GroupDocs.Search 다운로드
- GroupDocs.Search 포럼
- 무료 지원
- 임시 라이선스
마지막 업데이트: 2026-10-17
테스트 환경: Java용 GroupDocs.Search 23.12
작성자: GroupDocs