Stop Words 비활성화 Java – GroupDocs로 인덱스에 문서 추가

이 튜토리얼에서는 GroupDocs.Search for Java를 사용하여 파일을 검색 가능한 인덱스에 추가하면서 disable stop words java를 수행하는 방법을 알아봅니다. 내장된 stop‑word 필터를 끄면 “on”, “by”, “the”와 같은 일반 단어를 포함한 모든 토큰을 검색할 수 있게 되어, 법률 계약서, 전자상거래 카탈로그, 기술 매뉴얼과 같은 특수 도메인에서 결과 관련성이 크게 향상됩니다.

빠른 답변

  • “add documents to index”가 무엇을 의미하나요? 소스 파일을 검색 가능한 인덱스로 로드하여 효율적으로 쿼리할 수 있게 합니다.
  • 왜 stop words를 비활성화해야 하나요? 도메인에서 의미가 있는 경우 검색에 일반 단어(예: “on”, “the”)를 포함하기 위해서입니다.
  • 필요한 라이브러리 버전은 무엇인가요? GroupDocs.Search for Java 25.4 이상.
  • 라이선스가 필요합니까? 평가용으로는 무료 체험을 사용할 수 있으며, 프로덕션에서는 영구 라이선스가 필요합니다.
  • Maven 프로젝트에서 사용할 수 있나요? 예 – 아래에 표시된 저장소와 종속성을 추가하면 됩니다.

검색에서 stop words란 무엇이며 왜 비활성화하고 싶을까요?

Stop words는 많은 검색 엔진이 쿼리 처리 속도를 높이기 위해 자동으로 필터링하는 고빈도 용어입니다. 이를 비활성화하면 전통적으로 무시되던 every word를 포함한 모든 단어가 검색 인덱스에 기여하게 되며, 이러한 단어가 도메인별 의미를 가질 때 필수적입니다. 예를 들어, 법률 계약서에서 “by”는 당사자를 구분할 수 있고, 제품 카탈로그에서는 “on”이 모델명에 포함될 수 있습니다.

GroupDocs.Search에서 문서를 인덱스에 추가하는 방식은 어떻게 작동하나요?

문서를 추가하면 GroupDocs.Search가 각 파일을 읽고, 내용을 토큰화한 뒤 최적화된 역인덱스에 토큰을 저장합니다. 이 구조는 hundreds of thousands of files와 같은 대규모 컬렉션에서도 서브초 단위 검색을 가능하게 합니다. 라이브러리는 증분 업데이트도 지원하므로 인덱스를 처음부터 다시 구축하지 않고도 최신 상태를 유지할 수 있습니다.

전제 조건

  • 필수 라이브러리: GroupDocs.Search for Java 25.4 (또는 최신 버전).
  • 개발 환경: IntelliJ IDEA, Eclipse, 또는 선호하는 Java IDE.
  • 기본 지식: Java 구문 및 인덱싱 개념에 대한 이해.

GroupDocs.Search for Java 설정

Maven 설치

If you’re using Maven, include the following in your 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 – 프로덕션 사용을 위한 영구 라이선스를 확보하세요.

기본 초기화 및 설정

IndexSettings는 인덱스가 어떻게 구축되고 검색되며 어떤 기능이 활성화되는지를 정의하는 구성 클래스입니다.

Create an instance of IndexSettings to control how the index behaves:

import com.groupdocs.search.IndexSettings;

// Create an instance of IndexSettings
IndexSettings settings = new IndexSettings();

검색에서 stop words를 비활성화하는 방법 (Java)?

IndexSettings는 검색 인덱스의 동작을 제어하는 구성 객체입니다. 기본적으로 내장된 stop‑word 필터가 활성화됩니다. 이 필터를 끄려면 IndexSettings 인스턴스에서 setUseStopWords(false) 메서드를 호출하십시오. 이 한 번의 호출로 stop‑word 제거가 비활성화되어 “on”이나 “the”와 같은 일반 단어를 포함한 모든 토큰이 인덱싱되고 쿼리될 수 있습니다.

문서를 인덱스에 추가하는 방법

문서를 인덱스에 추가하려면 원하는 IndexSettings를 사용해 Index 객체를 생성한 뒤 각 파일 또는 폴더에 대해 add 메서드를 호출합니다. 라이브러리는 각 문서를 읽고 내용을 토큰화하여 역인덱스에 저장하므로 즉시 검색이 가능합니다. 인덱스를 특정 출력 디렉터리로 지정하고 인덱싱할 파일이 들어 있는 소스 폴더를 지정할 수 있습니다.

출력 디렉터리 정의

// Disable the use of stop words
tsettings.setUseStopWords(false);

문서 디렉터리 지정

import com.groupdocs.search.Index;

// Define the path to the output directory for indexing
String indexFolder = "YOUR_OUTPUT_DIRECTORY\\IndexingWithStopWords";

// Create an index at the specified location with the configured settings
Index index = new Index(indexFolder, settings);

검색 쿼리 수행

// Define the path to your document directory
String documentsFolder = "YOUR_DOCUMENT_DIRECTORY";

// Add all documents in the specified folder to the index
index.add(documentsFolder);

disable stop words java가 활성화되어 있기 때문에, "on"이라는 용어를 포함한 쿼리가 평가되어 기본 필터에 의해 무시될 수 있는 일치 항목도 반환됩니다.

실용적인 적용 사례

  1. Enterprise Document Search – 기본 stop‑word 목록에서 제거될 수 있는 핵심 용어를 보존합니다.
  2. E‑commerce Platforms – 설명, 모델 번호, 사양 등 모든 단어를 인덱싱하여 제품 발견 가능성을 높입니다.
  3. Legal Research Tools – 일반적으로 stop words로 처리되는 경우에도 모든 법률 용어를 포착하여 중요한 조항을 놓치지 않게 합니다.

성능 고려 사항

  • Optimization Tips: 정기적으로 인덱스를 업데이트하고 정리하여 검색 속도를 높게 유지하십시오. GroupDocs.Search는 up to 1 million documents를 처리하면서 서브초 쿼리 시간을 유지할 수 있습니다.
  • Resource Usage: JVM 힙 크기를 모니터링하십시오; 대규모 인덱스는 최대 힙(-Xmx) 4 GB 이상이 필요할 수 있습니다.
  • Java Memory Management: 매우 큰 코퍼스를 위해 오프‑힙 저장 옵션을 사용하여 온‑힙 사용량을 2 GB 이하로 유지하십시오.

일반적인 문제 및 해결책

증상가능한 원인해결 방법
일반 단어에 대한 결과 없음setUseStopWords(true) (default)setUseStopWords(false)를 위와 같이 호출하십시오.
인덱싱 중 메모리 부족 오류한 번에 너무 많은 대용량 파일을 인덱싱파일을 배치로 인덱싱하고 -Xmx JVM 옵션을 늘리십시오.
검색이 오래된 데이터를 반환새 파일 추가 후 인덱스가 새로 고쳐지지 않음index.update()를 호출하거나 변경된 문서를 다시 추가하십시오.

자주 묻는 질문

Q: Stop words란 무엇인가요?
A: Stop words는 많은 검색 엔진이 쿼리 속도를 높이기 위해 무시하는 일반 용어(예: “the”, “is”, “on”)입니다. 이를 비활성화하면 모든 토큰을 검색 가능하게 할 수 있습니다.

Q: 검색 인덱스에서 왜 stop words를 비활성화하나요?
A: 법률 문서나 기술 문서처럼 정확한 구문 매칭이 필요할 때, 모든 단어가 의미를 가지므로 stop words를 포함해야 합니다.

Q: GroupDocs.Search는 대용량 데이터셋을 어떻게 처리하나요?
A: 라이브러리는 최적화된 데이터 구조와 증분 인덱싱을 사용하여 millions of documents에서도 메모리 사용량을 낮게 유지합니다.

Q: GroupDocs.Search를 다른 Java 애플리케이션에 통합할 수 있나요?
A: 예, API는 웹 서비스부터 데스크톱 앱까지 모든 Java 기반 시스템에 쉽게 삽입하도록 설계되었습니다.

Q: 검색 결과가 정확하지 않다면 어떻게 해야 하나요?
A: 인덱스에 모든 필요한 파일(add documents to index)이 포함되어 있는지 확인하고, 필요할 때 stop‑word 필터링이 비활성화되었는지 확인한 뒤, 큰 변경 후에는 인덱스를 재구축하는 것을 고려하십시오.

추가 자료

이 가이드를 따라 하면 이제 add documents to index와 disable stop words java를 수행하여 Java 애플리케이션에서 보다 정확한 검색 결과를 제공하는 방법을 알게 됩니다.

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

import com.groupdocs.search.results.SearchResult;

// Define your search query
tString query = "on";

// Perform the search operation using the index and the specified query
SearchResult result = index.search(query);

관련 튜토리얼