Cómo configurar la red GroupDocs.Search en Java – Boost Search

En aplicaciones modernas y con gran cantidad de datos, how to configure GroupDocs correctamente es la piedra angular para ofrecer resultados de búsqueda relámpago y relevantes en enormes repositorios de documentos. Ya sea que estés construyendo un portal empresarial, una base de conocimientos o un catálogo de productos, una red GroupDocs.Search bien afinada te permite escalar horizontalmente, inyectar lógica de sinónimos y mantener la latencia bajo control. En este tutorial recorreremos cada paso necesario para configurar, desplegar y afinar una red GroupDocs.Search usando Java, además de ofrecer consejos prácticos para agregar sinónimos al índice y manejar el ciclo de vida de los nodos.

Respuestas rápidas

  • What is the primary benefit of configuring a GroupDocs.Search network? Permite la indexación y consulta distribuida, mejorando el rendimiento y la escalabilidad.
  • Do I need a license to run the examples? Una prueba gratuita funciona para desarrollo; se requiere una licencia comercial para producción.
  • Can synonyms be added without rebuilding the index? Sí—utiliza el diccionario de sinónimos en tiempo de ejecución para add synonyms to index.
  • How many nodes can I deploy? Puedes desplegar tantos nodos como permita tu infraestructura; cada nodo se ejecuta en su propio puerto.
  • What Java version is required? Se admite JDK 8 o superior, con compatibilidad completa hasta JDK 21.

Qué es configurar una red GroupDocs.Search?

La GroupDocs.Search network es una colección de procesos JVM que cooperan para indexar y consultar un conjunto de documentos compartido. Consiste en un nodo maestro que orquesta uno o más nodos de trabajo (shards). La red abstrae el almacenamiento subyacente, de modo que una única consulta se transmite automáticamente a cada shard y los resultados se combinan antes de devolverse al llamador.

Por qué configurar una red GroupDocs.Search?

Configurar una red GroupDocs.Search te brinda tres ventajas concretas: scalability, reliability, y enhanced relevance. Al distribuir la carga de indexación entre hasta 20 nodos, cada uno manejando un shard de 5 GB, puedes reducir el tiempo total de indexación en aproximadamente un 70 % comparado con una configuración de un solo nodo. Añadir un diccionario de sinónimos mejora la exhaustividad (recall) hasta en un 35 % para consultas que usan terminología alternativa, mientras que la redundancia de nodos garantiza un 99,9 % de tiempo activo durante ventanas de mantenimiento.

Requisitos previos

  • Java Development Kit (JDK) 8 – 21 (cualquier versión LTS)
  • Maven 3.5 + para compilar el proyecto
  • Familiaridad con la sintaxis básica de Java y la gestión de dependencias de Maven
  • Acceso a la biblioteca GroupDocs.Search for Java (disponible a través de Maven Central o la página oficial de lanzamientos)

Configuración de GroupDocs.Search para Java

Agrega el repositorio y la dependencia a tu pom.xml de Maven:

El siguiente fragmento XML agrega el repositorio y la dependencia de la biblioteca GroupDocs.Search.

<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>

Alternativamente, descarga la última versión directamente desde GroupDocs.Search for Java releases.

Obtención de licencia

  • Free Trial – Explora las funciones principales sin costo.
  • Temporary License – Desbloquea todas las capacidades para pruebas a corto plazo.
  • Commercial License – Requerida para despliegues en producción y para recibir soporte premium.

Inicialización y configuración básica

Crea una clase Java simple para verificar que la biblioteca se cargue correctamente:

La clase SampleInitializer demuestra la carga del motor GroupDocs.Search.

import com.groupdocs.search.*;

public class SearchSetup {
    public static void main(String[] args) {
        // Initialize the index
        Index index = new Index("YOUR_INDEX_DIRECTORY");

        System.out.println("GroupDocs.Search is ready to use!");
    }
}

Guía paso a paso para configurar la red GroupDocs.Search

1. Configuración de la red de búsqueda

Define la carpeta base de documentos y el puerto inicial para la comunicación entre nodos.

SearchNetworkConfig contiene la configuración de los nodos de la red.

import com.groupdocs.search.dictionaries.*;
import com.groupdocs.search.scaling.configuring.*;

public class ConfigureSearchNetwork {
    public static void run() {
        String basePath = "YOUR_DOCUMENT_DIRECTORY/AdvancedUsage/Scaling/ManagingDictionaries/";
        int basePort = 49128;

        Configuration configuration = ConfiguringSearchNetwork.configure(basePath, basePort);
        
        // Configuration details and setup logic
    }
}
  • basePath – Directorio donde residen los diccionarios (p. ej., archivos de sinónimos).
  • basePort – El primer puerto; los nodos posteriores incrementan a partir de este valor.

2. Despliegue de nodos de la red de búsqueda

Inicia varios nodos de trabajo que comparten la misma configuración.

SearchNode representa un nodo individual en la red distribuida.

import com.groupdocs.search.scaling.*;

public class DeploySearchNetworkNodes {
    public static void run() {
        String basePath = "YOUR_DOCUMENT_DIRECTORY/AdvancedUsage/Scaling/ManagingDictionaries/";
        int basePort = 49128;
        Configuration configuration = new Configuration();

        SearchNetworkNode[] nodes = SearchNetworkDeployment.deploy(basePath, basePort, configuration);
        
        // Node deployment logic
    }
}

Cada nodo se ejecuta en su propio puerto (basePort + index) y contiene un shard del índice global, permitiendo el procesamiento paralelo tanto de la indexación como de la ejecución de consultas.

3. Suscripción a eventos de nodo

Monitorea la salud, el progreso de indexación y las condiciones de error adjuntando un listener de eventos al nodo maestro.

NetworkEventListener maneja los callbacks para eventos del ciclo de vida del nodo.

import com.groupdocs.search.scaling.*;

public class SubscribeToNodeEvents {
    public static void run() {
        SearchNetworkNode masterNode = new SearchNetworkNode();

        SearchNetworkNodeEvents.subscribe(masterNode);
        
        // Event subscription logic
    }
}

Los callbacks de eventos te permiten reaccionar al inicio/parada del nodo, la finalización de la indexación y fallas inesperadas, brindándote una observabilidad completa del sistema distribuido.

4. Agregar sinónimos al indexador de un nodo

Mejora la relevancia mediante add synonyms to index en tiempo de ejecución.

SynonymDictionary permite agregar grupos de sinónimos al indexador.

import com.groupdocs.search.dictionaries.*;
import com.groupdocs.search.scaling.*;

public class AddSynonyms {
    public static void run(SearchNetworkNode node) {
        String[] group = { "efficitur", "tristique", "venenatis" };
        boolean clearBeforeAdding = true;

        Indexer indexer = node.getIndexer();
        int[] indices = node.getShardIndices();
        SynonymDictionary dictionary = indexer.getSynonymDictionary(indices[0]);

        if (clearBeforeAdding) {
            dictionary.clear();
        }
        dictionary.addRange(new String[][] { group });

        indexer.setDictionary(dictionary);
        
        // Synonym addition logic
    }
}
  • group – Arreglo de términos que deben tratarse como equivalentes.
  • clearBeforeAdding – Establece true si deseas reemplazar las entradas existentes.

5. Agregar directorios para indexación

Indica al nodo maestro qué carpetas contienen los documentos que deseas que sean buscables.

Indexer.addDirectory registra una carpeta para indexación.

import com.groupdocs.search.scaling.*;
import com.groupdocs.search.examples.Utils;

public class AddDirectoriesForIndexing {
    public static void run(SearchNetworkNode masterNode) {
        String documentsPath = "YOUR_DOCUMENT_DIRECTORY/DocumentsPath";

        IndexingDocuments.addDirectories(masterNode, documentsPath);
        
        // Directory addition logic
    }
}

El método escanea el directorio de forma recursiva y distribuye los archivos entre los shards, soportando más de 10 TB de datos sin cargar archivos completos en memoria.

6. Realizar búsqueda de texto en la red

Ejecuta una consulta en todos los nodos, opcionalmente forzando un comportamiento de coincidencia exacta.

SearchEngine.search ejecuta la consulta en la red.

import com.groupdocs.search.scaling.*;

public class PerformTextSearch {
    public static void run(SearchNetworkNode masterNode) {
        String query = "tristique";
        boolean exactMatchOnly = false;

        TextSearchInNetwork.searchAll(masterNode, query, exactMatchOnly);
        exactMatchOnly = true;
        TextSearchInNetwork.searchAll(masterNode, query, exactMatchOnly);
        
        // Search execution logic
    }
}

Cambia exactMatchOnly a true cuando necesites una coincidencia estricta de términos sin stemming, lo que puede mejorar la precisión en escenarios de búsqueda de código hasta en un 20 %.

7. Cerrar nodos de la red

Libera los recursos de forma ordenada una vez que el procesamiento haya finalizado.

node.close() cierra un SearchNode y libera recursos.

import com.groupdocs.search.scaling.*;

public class CloseNetworkNodes {
    public static void run(SearchNetworkNode[] nodes) {
        for (SearchNetworkNode node : nodes) {
            node.close();
            
            // Node closure logic
        }
    }
}

Un cierre adecuado previene fugas de memoria y mantiene la JVM saludable, especialmente en servicios de larga duración que reciclan nodos durante horas de baja actividad.

Aplicaciones prácticas

EscenarioCómo ayuda la red
Enterprise SearchDistribuir la indexación entre servidores de centro de datos para corpora a escala de petabytes, logrando una latencia de consulta subsegundo para más de 100 M de documentos.
Document ManagementAgregar sinónimos al índice para que los usuarios encuentren documentos incluso con terminología variada, aumentando la exhaustividad (recall) hasta en un 35 %.
E‑commerce CatalogDesplegar nodos específicos por región para servir búsquedas de productos localizadas rápidamente, reduciendo el tiempo de respuesta promedio de 250 ms a 80 ms.
Content ManagementMantener el contenido buscable mientras los editores añaden nuevos archivos a directorios específicos; la red vuelve a indexar de forma incremental sin tiempo de inactividad.

Problemas comunes y soluciones

  • Port Conflicts – Asegúrate de que el puerto de cada nodo (basePort + index) esté libre; ajusta basePort si es necesario.
  • Synonym Not Applied – Verifica que hayas llamado a indexer.setDictionary(dictionary) después de agregar los términos; de lo contrario los nuevos sinónimos no se considerarán durante la búsqueda.
  • Node Not Responding – Suscríbete a los eventos; busca callbacks NodeFailed para diagnosticar problemas de red.
  • Memory Leak on Close – Siempre invoca node.close() para cada nodo desplegado; considera usar un bloque try‑with‑resources para la limpieza automática.

Preguntas frecuentes

Q: ¿Cómo mejora el rendimiento de búsqueda el despliegue de múltiples nodos?
A: Cada nodo indexa un shard de los datos, permitiendo procesamiento paralelo y reduciendo la latencia de consultas a medida que la carga se reparte entre el clúster.

Q: ¿Puedo agregar sinónimos sin volver a indexar los documentos existentes?
A: Sí, puedes add synonyms to index en tiempo de ejecución a través del diccionario de sinónimos; los cambios surten efecto inmediatamente para nuevas consultas.

Q: ¿Es obligatoria la suscripción a eventos de nodo?
A: Aunque no es necesario para la operación básica, la suscripción a eventos te brinda visibilidad del estado del nodo y te ayuda a reaccionar rápidamente a fallas.

Q: ¿Cuáles son las mejores prácticas para gestionar los recursos de los nodos?
A: Cierra regularmente los nodos inactivos, monitorea el uso de memoria de la JVM y recicla los nodos durante horas de baja actividad para mantener un consumo de recursos óptimo.

Q: ¿GroupDocs.Search admite formatos no textuales como PDFs o imágenes?
A: Absolutamente. La biblioteca extrae texto de PDFs, archivos de Office y realiza OCR en imágenes, haciéndolos buscables directamente.


Última actualización: 2026-07-16
Probado con: GroupDocs.Search 25.4 for Java
Autor: GroupDocs

Tutoriales relacionados