Java에서 검색 인덱스를 생성하고 맞춤법 교정을 활성화하는 방법

현대 Java 애플리케이션에서 정확한 검색 결과를 제공하는 것은 필수 기능입니다. 이 튜토리얼에서는 GroupDocs.Search를 사용하여 Java에서 검색 인덱스를 생성하는 방법과 맞춤법 교정을 활성화하는 방법을 보여줍니다. 이를 통해 사용자는 쿼리를 오타가 있더라도 관련 결과를 받을 수 있습니다. 라이브러리 설정, 문서 추가, 최대 실수 수 구성, 그리고 오타 허용 검색 실행 방법을 한 줄의 추가 설정 코드 없이 확인할 수 있습니다.

빠른 답변

• 맞춤법 교정을 활성화하면 무엇을 하나요? 검색 중에 오타가 난 용어를 가장 가까운 올바른 형태로 다시 쓰는 내장 맞춤법 검사기를 활성화합니다.
• 이 기능을 제공하는 라이브러리는 무엇인가요? GroupDocs.Search for Java.
• 라이선스가 필요합니까? 평가용으로는 무료 체험판을 사용할 수 있지만, 실제 운영에서는 정식 라이선스가 필요합니다.
• 허용 범위를 제어할 수 있나요? 예 – setMaxMistakeCount를 사용하여 쿼리당 허용되는 오타 수를 정의할 수 있습니다.
• 대규모 인덱스에도 적합한가요? 물론입니다 – 엔진은 수백만 개 레코드의 인덱스를 처리하면서 일반 서버 하드웨어에서 쿼리 지연 시간을 100 ms 이하로 유지합니다.

GroupDocs.Search란 무엇인가요?

GroupDocs.Search는 빠른 전체 텍스트 인덱싱 및 고급 검색 기능(내장 맞춤법 교정 포함)을 제공하는 Java 라이브러리입니다. 50개 이상의 입력 형식을 지원하며 전체 파일을 메모리에 로드하지 않고 수백 페이지 문서를 처리할 수 있습니다.

Java 애플리케이션에서 맞춤법 교정을 활성화하는 이유는?

• 사용자 만족도 향상 – 방문자는 입력이 완벽하지 않아도 정확한 결과를 얻을 수 있습니다.
• 이탈률 감소 – 정확한 결과가 사용자를 더 오래 머무르게 합니다.
• 다양한 도메인에서 작동 – 도서관 카탈로그부터 전자상거래 제품 검색까지, 맞춤법 교정은 모든 곳에서 관련성을 향상시킵니다.

필수 조건

• Java Development Kit (JDK)이 설치되어 있어야 합니다.
• 기본적인 Java 및 Maven 지식.
• 인덱싱 개념에 대한 이해.
• GroupDocs.Search 체험판 또는 라이선스 키.

Java용 GroupDocs.Search 설정

라이브러리를 Maven 프로젝트에 통합합니다.

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에서 다운로드합니다.

라이선스 획득

평가용으로 무료 체험 라이선스를 획득합니다. 실제 운영에서는 정식 라이선스를 구매하거나 공식 사이트에서 임시 키를 요청하십시오.

Java에서 검색 인덱스를 어떻게 생성하나요?

SearchIndex는 디스크에 저장된 검색 가능한 인덱스를 나타내는 주요 클래스입니다.
디스크의 폴더를 가리키는 SearchIndex 인스턴스를 생성한 다음, 소스 디렉터리에서 문서를 추가합니다. 엔진은 빠른 조회를 가능하게 하는 역 인덱스를 구축합니다. 각 파일에 대해 index.add()를 호출할 수 있으며, 라이브러리는 파일 유형에 따라 텍스트를 자동으로 추출합니다.

맞춤법 교정을 어떻게 활성화하나요?

getSpellingOptions()는 인덱스의 맞춤법 구성 객체를 반환하며, 맞춤법 검사 기능을 활성화하거나 조정할 수 있습니다.
index.getSpellingOptions().setEnabled(true)를 호출하여 맞춤법을 활성화합니다. 이는 엔진에게 쿼리 용어를 분석하고 불일치가 감지될 경우 교정된 대안을 제시하도록 지시합니다. 이 기능은 라이브러리가 지원하는 모든 인덱스 언어에 대해 바로 사용할 수 있습니다.

max mistake count 설정이란?

setMaxMistakeCount는 맞춤법 검사기가 용어당 허용할 최대 문자 편집 수를 설정합니다.
setMaxMistakeCount(int)는 맞춤법 검사기가 용어당 허용할 최대 문자 편집(삽입, 삭제, 대체) 수를 정의합니다. 2로 설정하면 엔진이 일반적인 두 문자 오타를 수정하면서 관련 없는 결과를 반환할 가능성이 높은 과도한 교정을 방지합니다.

맞춤법 교정 검색을 수행하는 방법

search()는 인덱스에 대해 쿼리를 실행하고 일치 항목 및 교정된 용어를 포함하는 SearchResult 객체를 반환합니다.
search() 메서드를 사용하여 검색 쿼리를 실행합니다. 쿼리에 오타가 포함된 경우, 엔진은 교정된 용어와 가장 관련성 높은 문서 목록을 포함하는 SearchResult를 반환합니다. 투명성을 위해 원본 쿼리와 교정된 버전을 모두 사용자에게 표시할 수 있습니다.
SearchResult는 일치하는 문서 목록과 쿼리 교정에 대한 정보를 보유합니다.

실제 적용 사례

1. 도서관 시스템 – 오타가 난 도서 제목이나 저자 이름을 자동으로 수정합니다.
2. 전자상거래 플랫폼 – 제품명 오타를 교정하여 전환율을 높입니다.
3. 콘텐츠 관리 – 불완전한 키워드에도 편집자가 기사를 찾을 수 있도록 돕습니다.

성능 고려 사항

• 인덱스를 최신 상태로 유지 – 새 파일이나 변경된 파일을 정기적으로 다시 인덱싱합니다.
• JVM 메모리 설정 조정 – 대규모 인덱스를 위해 충분한 힙을 할당합니다(예: -Xmx4g).
• 리소스 사용량 모니터링 – 대량 인덱싱 중 일시 정지가 발생하면 가비지 컬렉터 플래그를 조정합니다.

일반적인 문제 및 해결 방법

자주 묻는 질문

Q: GroupDocs.Search란 무엇인가요?
A: GroupDocs.Search는 빠른 인덱싱, 고급 쿼리 기능 및 모든 Java 애플리케이션을 위한 내장 맞춤법 교정을 제공하는 Java 라이브러리입니다.

Q: GroupDocs.Search 라이선스를 어떻게 얻나요?
A: 공식 사이트를 방문하여 무료 체험판을 다운로드하거나 정식 라이선스를 구매하십시오; 단기 테스트용 임시 키도 제공됩니다.

Q: GroupDocs.Search를 다른 Java 프레임워크와 통합할 수 있나요?
A: 예, Spring, Jakarta EE 및 모든 표준 Java 애플리케이션과 원활하게 작동합니다.

Q: 인덱스를 설정할 때 흔히 발생하는 문제는 무엇인가요?
A: 잘못된 폴더 경로, 파일 권한 누락, Maven 의존성 부재가 일반적인 원인입니다.

Q: 맞춤법 교정이 검색 결과를 어떻게 개선하나요?
A: 오타가 난 쿼리를 가장 가까운 올바른 용어로 자동으로 재작성하여 더 관련성 높은 결과를 반환하고 사용자 불만을 줄입니다.

추가 자료

• 문서
• API 레퍼런스
• 다운로드
• GitHub 저장소
• 무료 지원 포럼
• 임시 라이선스

마지막 업데이트: 2026-09-02
테스트 환경: GroupDocs.Search 25.4
작성자: GroupDocs

import com.groupdocs.search.*;

public class FeatureIndexAndAddDocuments {
    public static void main(String[] args) {
        // Define where the index will be stored
        String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output\\AdvancedUsage\\Searching\\SpellChecking";
        
        // Create an Index instance pointing to the specified folder
        Index index = new Index(indexFolder);
        
        // Specify the documents directory for indexing
        String documentsFolder = "YOUR_DOCUMENT_DIRECTORY";  
        
        // Add documents from this directory to the index
        index.add(documentsFolder);
    }
}

import com.groupdocs.search.*;
import com.groupdocs.search.options.*;

public class FeatureSpellingCorrectionOptions {
    public static void main(String[] args) {
        // Instantiate SearchOptions
        SearchOptions options = new SearchOptions();
        
        // Enable spelling correction
        options.getSpellingCorrector().setEnabled(true);
        
        // Allow up to one mistake during search
        options.getSpellingCorrector().setMaxMistakeCount(1);
        
        // Return only the best results after correction
        options.getSpellingCorrector().setOnlyBestResults(true);
    }
}

import com.groupdocs.search.*;
import com.groupdocs.search.options.*;
import com.groupdocs.search.results.*;

public class FeatureSpellingCorrectionSearch {
    public static void main(String[] args) {
        // Create an index in the specified directory
        String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output\\AdvancedUsage\\Searching\\SpellChecking";
        Index index = new Index(indexFolder);
        
        // Define search options with spelling correction enabled
        SearchOptions options = new SearchOptions();
        options.getSpellingCorrector().setEnabled(true);
        options.getSpellingCorrector().setMaxMistakeCount(1);
        options.getSpellingCorrector().setOnlyBestResults(true);
        
        // Specify a misspelled search query
        String query = "houseohld";
        
        // Execute the spelling‑corrected search
        SearchResult result = index.search(query, options);
    }
}

관련 튜토리얼

• Java용 GroupDocs.Search API를 사용하여 문서 인덱스를 생성하고 문서를 추가하는 방법
• Java 언어 처리 – GroupDocs.Search로 동의어 사전 만들기
• 검색에서 불용어: GroupDocs.Search Java로 인덱스에 문서 추가