Resaltar resultados de búsqueda Java – Indexación sincrónica y asíncrona

Impulsa tus aplicaciones Java resaltando los resultados de búsqueda con la potente biblioteca GroupDocs.Search. Ya sea que trabajes con unos pocos archivos o con un repositorio masivo, dominar tanto la indexación sincrónica como la asíncrona te permite ofrecer resultados rápidos y precisos sin bloquear los hilos de tu aplicación.

Respuestas rápidas

  • ¿Qué significa “highlight search results Java”? Se refiere a renderizar los términos coincidentes en los resultados de búsqueda con indicadores visuales (p. ej., etiquetas HTML <mark>) para que los usuarios vean dónde aparece la consulta en cada documento.
  • ¿Cuándo debo usar la indexación sincrónica? Para conjuntos de datos pequeños a medianos donde se requiere disponibilidad inmediata de los documentos recién agregados.
  • ¿Cuándo es preferible la indexación asíncrona? Al procesar colecciones grandes de documentos o ejecutar en un hilo de UI donde debes mantener la aplicación receptiva.
  • ¿Necesito una licencia? Una prueba gratuita funciona para desarrollo; una licencia completa desbloquea funciones avanzadas y elimina los límites de uso.
  • ¿Qué versión de Java es compatible? Java 8 o posterior.

¿Qué es “highlight search results Java”?

Resaltar los resultados de búsqueda en Java significa tomar las coincidencias crudas devueltas por GroupDocs.Search y envolver los términos coincidentes en HTML (u otro marcado) para que destaquen cuando se muestren en una interfaz o página web. Esto mejora la experiencia del usuario al mostrar instantáneamente el contexto de cada hallazgo.

¿Por qué usar GroupDocs.Search para Java?

GroupDocs.Search ofrece un motor de alto rendimiento, independiente del lenguaje, que soporta:

  • Indexación y búsqueda en tiempo real
  • Procesamiento asíncrono para cargas de trabajo grandes
  • Resaltado de resultados incorporado
  • Soporte multilingüe y de analizadores personalizados

Estas capacidades lo hacen ideal para sistemas de gestión de contenido, catálogos de comercio electrónico y repositorios empresariales de documentos.

Requisitos previos

Antes de comenzar, asegúrate de tener:

  • Java Development Kit (JDK 8 o más reciente) instalado.
  • Un IDE como IntelliJ IDEA o Eclipse.
  • Una carpeta que contenga los documentos que deseas indexar.
  • Maven para la gestión de dependencias (o puedes descargar el JAR manualmente).

Bibliotecas y dependencias requeridas

Agrega GroupDocs.Search a tu proyecto Maven:

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

Para descargas directas, obtén la última versión en GroupDocs.Search for Java releases.

Configuración del entorno

  • Verifica que tu JAVA_HOME apunte a un JDK compatible.
  • Crea un proyecto en tu IDE y añade la configuración Maven anterior.
  • Prepara un directorio (p. ej., documents/) con archivos de texto, PDF o Word de ejemplo.

Cómo configurar GroupDocs.Search para Java

  1. Instalar la biblioteca – Usa el fragmento Maven anterior o descarga el JAR desde GroupDocs.
  2. Obtener una licencia – Comienza con una licencia de prueba y luego actualiza cuando pases a producción.
  3. Inicializar el índice – El siguiente fragmento muestra cómo crear (o abrir) una carpeta de índice:
import com.groupdocs.search.Index;

// Create an index in the specified folder
Index index = new Index("path/to/index/folder");

Cómo resaltar resultados de búsqueda Java – Indexación sincrónica

La indexación sincrónica procesa los documentos de inmediato, haciendo que los archivos recién agregados sean buscables al instante.

Paso 1: Crear el índice y adjuntar el manejo de errores

import com.groupdocs.search.*;
import com.groupdocs.search.events.*;
import java.nio.file.Paths;

public class SynchronousIndexingFeature {
    public static void main(String[] args) {
        String indexFolder = "YOUR_DOCUMENT_DIRECTORY/SynchronousIndexing";
        String documentsFolder = YOUR_DOCUMENT_DIRECTORY; // Replace with actual directory path

        Index index = new Index(indexFolder);

        // Handle errors
        index.getEvents().ErrorOccurred.add(new EventHandler<IndexErrorEventArgs>() {
            @Override
            public void invoke(Object sender, IndexErrorEventArgs args) {
                System.out.println(args.getMessage());
            }
        });

Paso 2: Añadir documentos y ejecutar una búsqueda

        // Add documents
        index.add(documentsFolder);

        // Perform a search
        String query = "tincidunt";
        SearchResult result = index.search(query);

Paso 3: Procesar los resultados y highlight search results Java

        for (int i = 0; i < result.getDocumentCount(); i++) {
            FoundDocument document = result.getFoundDocument(i);
            System.out.println(": Document: " + document.getDocumentInfo().getFilePath());
            System.out.println(": Occurrences: " + document.getOccurrenceCount());
        }

        // Highlight results
        if (result.getDocumentCount() > 0) {
            FoundDocument document = result.getFoundDocument(0);
            String path = YOUR_OUTPUT_DIRECTORY + "/Highlighted.html";
            OutputAdapter outputAdapter = new FileOutputAdapter(OutputFormat.Html, path);
            DocumentHighlighter highlighter = new DocumentHighlighter(outputAdapter);
            index.highlight(document, highlighter);
        }
    }
}

El DocumentHighlighter envuelve automáticamente los términos coincidentes con etiquetas <mark> (o cualquier formato que configures), proporcionando resultados de búsqueda resaltados listos para mostrarse.

Cómo resaltar resultados de búsqueda Java – Indexación asíncrona

Al trabajar con miles de archivos, bloquear el hilo principal es indeseable. La indexación asíncrona permite que el motor trabaje en segundo plano.

Paso 1: Configurar el índice con escuchas de eventos

import com.groupdocs.search.*;
import com.groupdocs.search.events.*;

public class AsynchronousIndexingFeature {
    public static void main(String[] args) {
        String indexFolder = "YOUR_DOCUMENT_DIRECTORY/AsynchronousIndexing";
        String documentsFolder = YOUR_DOCUMENT_DIRECTORY; // Replace with actual directory path

        Index index = new Index(indexFolder);

        // Handle errors and status changes
        index.getEvents().ErrorOccurred.add(new EventHandler<IndexErrorEventArgs>() {
            @Override
            public void invoke(Object sender, IndexErrorEventArgs args) {
                System.out.println(args.getMessage());
            }
        });

        index.getEvents().StatusChanged.add(new EventHandler<BaseIndexEventArgs>() {
            @Override
            public void invoke(Object sender, BaseIndexEventArgs args) {
                if (args.getStatus() != IndexStatus.Ready || args.getStatus() == IndexStatus.Failed) {
                    System.out.println("Indexing completed.");
                }
            }
        });

Paso 2: Habilitar el modo asíncrono e iniciar la indexación

        // Set up async indexing options
        IndexingOptions options = new IndexingOptions();
        options.setAsync(true);

        // Add documents asynchronously
        index.add(documentsFolder, options);
    }
}

Mientras se construye el índice, tu aplicación puede seguir atendiendo otras solicitudes. Una vez que el evento StatusChanged informe Ready, puedes ejecutar búsquedas de forma segura y obtener highlighted search results Java.

Cómo index documents java – Consejos prácticos

  • Tamaño de lote: Para colecciones enormes, divide la carpeta en lotes más pequeños para evitar picos de memoria.
  • Filtros de archivo: Usa IndexingOptions.setFileExtensions para incluir solo los formatos que necesites (p. ej., .pdf, .docx).
  • Re‑indexado: Cuando los documentos cambien, llama a index.update(documentPath) en lugar de reconstruir todo el índice.

Consideraciones de rendimiento

  • Memoria: Vigila el uso del heap; aumenta -Xmx si procesas muchos archivos grandes.
  • CPU: La indexación asíncrona distribuye la carga, pero sigue consumiendo CPU—monitorea con JVisualVM.
  • Resaltado de resultados: El resaltado añade una pequeña sobrecarga de procesamiento; almacena en caché el HTML generado si necesitas mostrar los resultados repetidamente.

Preguntas frecuentes

P: ¿Puedo combinar indexación sincrónica y asíncrona en la misma aplicación?
R: Sí. Usa la indexación sincrónica para conjuntos pequeños y actualizados frecuentemente y la asíncrona para importaciones masivas o trabajos en segundo plano.

P: ¿Cómo personalizo el estilo del resaltado?
R: Proporciona una implementación personalizada de DocumentHighlighter que escriba las etiquetas HTML, CSS o XML deseadas alrededor de los términos coincidentes.

P: ¿Qué tipos de archivo admite GroupDocs.Search de forma nativa?
R: Texto, PDF, DOC/DOCX, XLS/XLSX, PPT/PPTX, HTML y muchos más mediante sus analizadores integrados.

P: ¿Es posible buscar en varios idiomas simultáneamente?
R: Absolutamente. GroupDocs.Search incluye analizadores multilingües; solo configura el Analyzer apropiado al crear el índice.

P: ¿Cómo protejo la carpeta del índice?
R: Almacena el índice en un directorio protegido, establece los permisos adecuados del sistema de archivos y considera cifrar el índice con las funciones de seguridad de la biblioteca.

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