Java에서 GroupDocs.Search를 사용한 동의어 활용 방법
사용자가 다른 단어를 입력하더라도 올바른 콘텐츠를 찾을 수 있도록 하려면 동의어 검색이 해답입니다. 이 가이드에서는 동의어 사전을 생성하고, 가져오거나 내보내며, 동의어 그룹을 관리하고, 해당 동의어를 사용해 자동으로 쿼리를 확장하는 검색을 수행하는 방법을 배웁니다. CMS, 전자상거래 카탈로그, 법률 문서 저장소 등 어떤 시스템을 구축하든 동의어 지원을 추가하면 관련성 및 전환율을 크게 높일 수 있습니다.
빠른 답변
- 동의어를 추가하기 위한 첫 번째 단계는?
Index인스턴스를 생성하고SynonymDictionaryAPI를 사용합니다. - 이미 준비된 동의어 사전을 가져올 수 있나요? 예 – 파일 위치를 지정해
importDictionary(path)를 호출하면 됩니다. - 동의어 인식 검색을 어떻게 활성화하나요?
SearchOptions.setUseSynonymSearch(true)를 설정합니다. - 런타임에 동의어 그룹을 편집할 수 있나요? 물론입니다 – 사전 API를 통해 그룹을 삭제, 추가 또는 조회할 수 있습니다.
- 인덱스를 확장할 때 무엇을 모니터링해야 하나요? 사용되지 않는 항목을 정기적으로 정리하고, 대용량 동의어 파일에 맞게 JVM 힙을 조정합니다.
동의어 검색이란?
동의어 검색은 엔진이 일련의 단어나 구문을 서로 교환 가능한 것으로 취급한다는 의미입니다. 사용자가 **“better”**를 입력하면 엔진은 “improve”, “enhance” 등 동일 동의어 그룹에 정의된 다른 용어도 함께 검색하여, 사용자의 쿼리를 변경하지 않고도 더 풍부한 결과를 제공합니다.
GroupDocs.Search에서 동의어 지원을 활성화해야 하는 이유
동의어 지원을 활성화하면 엔진이 자동으로 동등한 용어를 포함하도록 쿼리를 확장하므로 결과 관련성이 향상되고 사용자 만족도가 높아지며 전자상거래나 콘텐츠 중심 사이트의 전환율을 높일 수 있습니다. 또한 용어 관리가 중앙화되어 여러 애플리케이션에 걸친 유지 보수 부담이 감소합니다.
사전 요구 사항
- GroupDocs.Search for Java 버전 25.4 이상.
- Maven을 지원하는 Java IDE (IntelliJ IDEA, Eclipse 등).
- 기본적인 Java 지식 및 Maven 프로젝트 구조에 대한 이해.
필요 라이브러리 및 버전
- GroupDocs.Search for Java 25.4 이상.
환경 설정
- 선택한 IDE (IntelliJ IDEA, Eclipse 등).
- 의존성 관리를 위한 Maven.
지식 요구 사항
- Java 객체지향 프로그래밍.
- 기본 파일 I/O 작업.
GroupDocs.Search for Java 설정
설치 정보
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>
직접 다운로드 – 최신 JAR 파일은 GroupDocs.Search for Java releases에서 받을 수 있습니다.
라이선스 획득
- 무료 체험: 라이선스 없이 핵심 기능을 테스트합니다.
- 임시 라이선스: 평가 기간 동안 기능을 확장합니다.
- 구매: 프로덕션 사용 및 전체 기능 세트를 위해 필요합니다.
기본 초기화 및 설정
Index 인스턴스를 생성한 뒤 검색 가능한 문서를 추가합니다:
import com.groupdocs.search.*;
String indexFolder = "YOUR_DOCUMENT_DIRECTORY/AdvancedUsage/ManagingDictionaries/SynonymDictionary/Index";
String documentsFolder = "YOUR_DOCUMENT_DIRECTORY/DocumentsPath2";
// Creating an index in the specified folder
Index index = new Index(indexFolder);
// Adding documents from a specific folder to the index
index.add(documentsFolder);
검색 인덱스에 동의어 추가하기
기능 1: 인덱스 생성 및 색인
Index 클래스는 디스크 또는 메모리에 저장된 검색 가능한 문서 컬렉션을 나타냅니다.
// Create an index in the specified folder
Index index = new Index(indexFolder);
// Add documents from the given folder to the index
index.add(documentsFolder);
기능 2: 단어에 대한 동의어 조회
SynonymDictionary는 동의어 그룹을 관리하고 특정 용어에 대한 동의어를 조회하는 메서드를 제공합니다.
String[] synonyms = index.getDictionaries().getSynonymDictionary().getSynonyms("make");
기능 3: 동의어 그룹 조회
SynonymDictionary.getGroups()는 정의된 모든 동의어 그룹과 해당 식별자를 리스트 형태로 반환합니다.
String[][] synonymGroups = index.getDictionaries().getSynonymDictionary().getSynonymGroups("make");
기능 4: 동의어 사전 항목 관리
add(word, synonym)은 사전에 새로운 동의어 관계를 삽입합니다. clear()는 모든 항목을 삭제하고, remove(word)는 특정 용어를 사전에서 제거합니다.
if (index.getDictionaries().getSynonymDictionary().getCount() > 0) {
index.getDictionaries().getSynonymDictionary().clear();
}
String[][] newSynonymGroups = new String[][]{
new String[] { "achieve", "accomplish", "attain", "reach" },
new String[] { "accept", "take", "have" },
new String[] { "improve", "better" }
};
index.getDictionaries().getSynonymDictionary().addRange(newSynonymGroups);
기능 5: 동의어를 파일로 내보내기
exportDictionary(path)는 현재 동의어 사전을 지정된 위치의 바이너리 .dat 파일로 기록합니다.
String exportFilePath = "YOUR_OUTPUT_DIRECTORY/AdvancedUsage/ManagingDictionaries/SynonymDictionary/Synonyms.dat";
index.getDictionaries().getSynonymDictionary().exportDictionary(exportFilePath);
기능 6: 파일에서 동의어 가져오기
importDictionary(path)는 이전에 내보낸 .dat 파일을 동의어 사전에 로드합니다.
index.getDictionaries().getSynonymDictionary().importDictionary(exportFilePath);
기능 7: 동의어 지원 검색 수행
SearchOptions는 쿼리 동작을 구성하며, 동의어 확장이 활성화되었는지 여부를 설정합니다. setUseSynonymSearch(true)를 호출하면 다음 쿼리부터 동의어 인식 검색이 활성화됩니다.
String query = "better";
SearchOptions options = new SearchOptions();
options.setUseSynonymSearch(true);
SearchResult result = index.search(query, options);
동의어를 사용한 검색 방법
Index를 로드하고 동의어 검색을 활성화한 뒤 쿼리를 실행합니다. 엔진은 구축하거나 가져온 동의어 사전을 사용해 자동으로 쿼리를 확장하고, 관련된 모든 용어에 대한 매치를 반환합니다.
동의어 사전 가져오기
다른 환경에서 준비한 .dat 파일이 있다면 importDictionary(path)를 호출하면 됩니다. 이는 개발, 스테이징, 프로덕션 서버 간 사전을 동기화할 때 이상적입니다.
동의어 그룹 관리 방법
동의어 그룹은 여러 용어를 하나의 논리적 엔터티로 취급하게 해줍니다. 그룹을 추가, 삭제 또는 조회하는 작업은 앞서 보여준 SynonymDictionary API를 통해 수행합니다.
검색 인덱스 최적화 방법
- 사용되지 않는 항목 정기적으로 정리: 대량 업데이트 전
clear()를 사용합니다. - JVM 힙 조정: 대용량 사전은 더 많은 메모리가 필요하므로
-Xmx파라미터를 늘립니다. - 라이브러리 최신 상태 유지: 최신 릴리스에는 성능 개선 및 버그 수정이 포함됩니다.
실용적인 적용 사례
- 콘텐츠 관리 시스템(CMS): 사용자가 대체 용어를 사용해도 기사 검색이 가능합니다.
- 전자상거래 플랫폼: “laptop”과 “notebook” 같은 동의어에 대해 관용적인 검색이 가능합니다.
- 문서 저장소: 법률 또는 의료 아카이브에서 도메인 특화 동의어 그룹을 활용하면 전문가들의 검색 가능성이 향상됩니다.
성능 고려 사항
- 인덱스 저장소 최적화: 오래된 데이터를 제거하기 위해 주기적으로 인덱스를 재구성합니다.
- 메모리 사용 관리: 대용량 동의어 파일을 로드할 때 힙 사용량을 모니터링합니다. 500 MB 사전은 64‑bit JVM에서 약 2 GB 힙이 필요합니다.
- 정기 업데이트: 버그 수정 및 속도 향상을 위해 최신 GroupDocs.Search 버전을 사용합니다.
일반적인 문제와 해결책
| Issue | Likely cause | Fix |
|---|---|---|
| No synonym matches appear | setUseSynonymSearch(true)가 설정되지 않았거나 사전이 가져와지지 않음 | 옵션이 활성화되어 있는지, 사전 파일이 존재하는지 확인합니다. |
| Out‑of‑memory errors during import | 매우 큰 .dat 파일이 JVM 힙을 초과 | -Xmx 힙 크기를 늘리거나 작은 배치로 나누어 가져옵니다. |
| Duplicate entries in results | 동일 용어가 여러 동의어 그룹에 포함 | clear() 후 addRange()를 사용해 겹치는 그룹을 통합합니다. |
자주 묻는 질문
Q: GroupDocs.Search를 사용하기 위한 최소 시스템 요구 사항은?
A: Java 8 이상이 설치된 최신 운영체제면 충분합니다.
Q: 동의어 사전은 얼마나 자주 갱신해야 하나요?
A: 새로운 용어가 등장할 때마다 업데이트합니다. 깨끗한 갱신을 위해 clear() 후 addRange()를 사용하세요.
Q: 라이선스를 구매하지 않고 GroupDocs.Search를 실행할 수 있나요?
A: 무료 체험은 평가용으로 사용할 수 있지만, 프로덕션 배포에는 라이선스가 필요합니다.
Q: 대용량 데이터 세트를 색인할 때 권장 방법은?
A: 데이터를 논리적 배치로 나누고, 힙 사용량을 모니터링하며, 정기적인 인덱스 유지보수를 계획합니다.
Q: 기대한 동의어 매치가 나오지 않는데, 무엇을 확인해야 하나요?
A: 사전이 올바르게 가져와졌는지, setUseSynonymSearch(true)가 활성화되었는지, 용어가 동의어 그룹에 포함되어 있는지 확인합니다.
Resources
- Documentation
- API Reference
- Download GroupDocs.Search for Java
- GitHub Repository
- Free Support Forum
- Temporary License Acquisition
Last Updated: 2026-10-17
Tested With: GroupDocs.Search 25.4 for Java
Author: GroupDocs