Cómo usar sinónimos en Java con GroupDocs.Search
Si deseas que tus usuarios encuentren el contenido correcto aunque escriban palabras diferentes, la búsqueda con sinónimos es la solución. En esta guía aprenderás a crear un diccionario de sinónimos, importarlo o exportarlo, gestionar grupos de sinónimos y ejecutar una búsqueda que expanda automáticamente las consultas usando esos sinónimos. Ya sea que estés construyendo un CMS, un catálogo de comercio electrónico o un repositorio de documentos legales, añadir soporte de sinónimos puede aumentar drásticamente la relevancia y las tasas de conversión.
Respuestas rápidas
- ¿Cuál es el primer paso para añadir sinónimos? Crear una instancia de
Indexy trabajar con la APISynonymDictionary. - ¿Puedo importar un diccionario de sinónimos ya preparado? Sí – llama a
importDictionary(path)con la ubicación del archivo. - ¿Cómo activo la búsqueda con reconocimiento de sinónimos? Habilita
SearchOptions.setUseSynonymSearch(true). - ¿Es posible editar los grupos de sinónimos en tiempo de ejecución? Absolutamente – puedes limpiar, añadir o recuperar grupos a través de la API del diccionario.
- ¿Qué debo monitorizar al escalar el índice? Depura regularmente las entradas no usadas y ajusta el heap de la JVM para archivos de sinónimos grandes.
¿Qué es la búsqueda con sinónimos?
La búsqueda con sinónimos significa que el motor trata un conjunto de palabras o frases como intercambiables. Cuando un usuario escribe “better”, el motor también busca “improve”, “enhance” o cualquier otro término que hayas definido en el mismo grupo de sinónimos, ofreciendo resultados más ricos sin cambiar la consulta del usuario.
¿Por qué habilitar el soporte de sinónimos en GroupDocs.Search?
Habilitar el soporte de sinónimos permite que el motor amplíe automáticamente las consultas para incluir términos equivalentes, lo que mejora la relevancia de los resultados, incrementa la satisfacción del usuario y puede elevar las tasas de conversión en sitios de comercio electrónico o de contenido. Además, centraliza la gestión de la terminología, reduciendo el esfuerzo de mantenimiento en múltiples aplicaciones.
Requisitos previos
- GroupDocs.Search para Java versión 25.4 o posterior.
- Un IDE de Java (IntelliJ IDEA, Eclipse, etc.) con soporte Maven.
- Conocimientos básicos de Java y familiaridad con la estructura de proyectos Maven.
Bibliotecas y versiones requeridas
- GroupDocs.Search para Java 25.4 o superior.
Configuración del entorno
- IDE de tu elección (IntelliJ IDEA, Eclipse, etc.).
- Maven para la gestión de dependencias.
Conocimientos necesarios
- Programación orientada a objetos en Java.
- Operaciones básicas de E/S de archivos.
Configuración de GroupDocs.Search para Java
Información de instalación
Añade el repositorio y la dependencia a tu 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>
Descarga directa – también puedes descargar el último JAR desde lanzamientos de GroupDocs.Search para Java.
Obtención de licencia
- Prueba gratuita: Prueba las funciones principales sin licencia.
- Licencia temporal: Amplía las capacidades de la prueba durante la evaluación.
- Compra: Requerida para uso en producción y el conjunto completo de funciones.
Inicialización básica y configuración
Crea una instancia de Index, luego añade los documentos que serán buscables:
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);
Cómo añadir sinónimos a tu índice de búsqueda
Función 1: crear e indexar un índice
La clase Index representa una colección buscable de documentos almacenados en disco o en memoria.
// Create an index in the specified folder
Index index = new Index(indexFolder);
// Add documents from the given folder to the index
index.add(documentsFolder);
Función 2: obtener sinónimos para una palabra
SynonymDictionary gestiona los grupos de sinónimos y proporciona métodos para consultar sinónimos de un término.
String[] synonyms = index.getDictionaries().getSynonymDictionary().getSynonyms("make");
Función 3: obtener grupos de sinónimos
SynonymDictionary.getGroups() devuelve una lista de todos los grupos de sinónimos definidos con sus identificadores.
String[][] synonymGroups = index.getDictionaries().getSynonymDictionary().getSynonymGroups("make");
Función 4: gestionar entradas del diccionario de sinónimos
add(word, synonym) inserta una nueva relación de sinónimos en el diccionario. clear() elimina todas las entradas, y remove(word) borra un término específico del diccionario.
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);
Función 5: exportar sinónimos a un archivo
exportDictionary(path) escribe el diccionario de sinónimos actual en un archivo binario .dat en la ubicación especificada.
String exportFilePath = "YOUR_OUTPUT_DIRECTORY/AdvancedUsage/ManagingDictionaries/SynonymDictionary/Synonyms.dat";
index.getDictionaries().getSynonymDictionary().exportDictionary(exportFilePath);
Función 6: importar sinónimos desde un archivo
importDictionary(path) carga un archivo .dat previamente exportado en el diccionario de sinónimos.
index.getDictionaries().getSynonymDictionary().importDictionary(exportFilePath);
Función 7: realizar búsquedas con soporte de sinónimos
SearchOptions configura el comportamiento de la consulta, incluida la habilitación de la expansión de sinónimos. setUseSynonymSearch(true) activa la búsqueda con reconocimiento de sinónimos para la próxima consulta.
String query = "better";
SearchOptions options = new SearchOptions();
options.setUseSynonymSearch(true);
SearchResult result = index.search(query, options);
Cómo buscar con sinónimos
Carga tu Index, habilita la búsqueda con sinónimos y ejecuta una consulta. El motor expande automáticamente la consulta usando el diccionario de sinónimos que creaste o importaste, devolviendo coincidencias para todos los términos relacionados.
Cómo importar un diccionario de sinónimos
Si ya dispones de un archivo .dat preparado por otro entorno, simplemente llama a importDictionary(path). Esto es ideal para sincronizar diccionarios entre servidores de desarrollo, pruebas y producción.
Cómo gestionar grupos de sinónimos
Los grupos de sinónimos te permiten tratar un conjunto de términos como una única entidad lógica. Añadir, limpiar o recuperar grupos se realiza a través de la API SynonymDictionary, como se muestra en los fragmentos de código anteriores.
Cómo optimizar el índice de búsqueda
- Depura regularmente entradas no usadas: Usa
clear()antes de actualizaciones masivas. - Ajusta el heap de la JVM: Los diccionarios grandes pueden requerir más memoria; aumenta el parámetro
-Xmxsegún corresponda. - Mantén la biblioteca actualizada: Las nuevas versiones contienen mejoras de rendimiento y correcciones de errores.
Aplicaciones prácticas
- Sistemas de gestión de contenidos (CMS): Los usuarios encuentran artículos aunque usen terminología alternativa.
- Plataformas de comercio electrónico: Las búsquedas de productos toleran sinónimos como “laptop” vs. “notebook”.
- Repositorios de documentos: Archivos legales o médicos se benefician de grupos de sinónimos específicos del dominio, mejorando la descubribilidad para profesionales.
Consideraciones de rendimiento
- Optimiza el almacenamiento del índice: Reconstruye periódicamente el índice para eliminar datos obsoletos.
- Gestiona el uso de memoria: Monitorea el consumo de heap al cargar archivos de sinónimos grandes; un diccionario de 500 MB típicamente requiere un heap de 2 GB en una JVM de 64 bits.
- Actualizaciones regulares: Mantente en la última versión de GroupDocs.Search para obtener correcciones y mejoras de velocidad.
Problemas comunes y soluciones
| Problema | Causa probable | Solución |
|---|---|---|
| No aparecen coincidencias de sinónimos | setUseSynonymSearch(true) no está configurado o el diccionario no se importó | Verifica que la opción esté habilitada y que el archivo del diccionario exista. |
| Errores de falta de memoria durante la importación | Archivo .dat muy grande supera el heap de la JVM | Incrementa el tamaño del heap -Xmx o importa en lotes más pequeños. |
| Entradas duplicadas en los resultados | El mismo término aparece en varios grupos de sinónimos | Consolida los grupos superpuestos usando clear() y luego addRange(). |
Preguntas frecuentes
P: ¿Cuál es el requisito mínimo del sistema para usar GroupDocs.Search?
R: Cualquier sistema operativo moderno con un JDK compatible (Java 8 o superior) es suficiente.
P: ¿Con qué frecuencia debo actualizar mi diccionario de sinónimos?
R: Actualízalo siempre que aparezca nueva terminología; usa clear() seguido de addRange() para una actualización limpia.
P: ¿Puedo ejecutar GroupDocs.Search sin comprar una licencia?
R: La prueba gratuita sirve para evaluación, pero se requiere una licencia para despliegues en producción.
P: ¿Cuáles son las mejores prácticas para indexar grandes conjuntos de datos?
R: Divide los datos en lotes lógicos, monitorea el uso de heap y programa mantenimientos regulares del índice.
P: No veo coincidencias de sinónimos esperadas—¿qué debo comprobar?
R: Verifica que el diccionario esté importado correctamente, que setUseSynonymSearch(true) esté activo y que los términos estén presentes en los grupos de sinónimos.
Recursos
- Documentación
- Referencia de API
- Descargar GroupDocs.Search para Java
- Repositorio en GitHub
- Foro de soporte gratuito
- Obtención de licencia temporal
Última actualización: 2026-10-17
Probado con: GroupDocs.Search 25.4 para Java
Autor: GroupDocs