Realçar Texto Java com GroupDocs.Search

No ambiente digital acelerado de hoje, ser capaz de realçar texto java em grandes coleções de arquivos é um recurso indispensável. Seja construindo uma plataforma de revisão jurídica, um motor de pesquisa acadêmica ou um console de suporte ao cliente, identificar instantaneamente os termos que os usuários procuram torna a experiência muito mais eficiente. Este tutorial orienta você a usar GroupDocs.Search for Java para pesquisar documentos java, indexar documentos java e aplicar realce avançado — tanto para documentos completos quanto para fragmentos focados.

Respostas Rápidas

O que significa “search and highlight text”? Refere‑se a localizar termos de consulta em um documento e enfatizá‑los visualmente (por exemplo, com cor de fundo).
Qual biblioteca fornece essa capacidade? GroupDocs.Search for Java.
Preciso de uma licença? Um teste gratuito serve para avaliação; uma licença completa é necessária para produção.
Posso personalizar as cores de realce? Sim—qualquer cor RGB pode ser definida via HighlightOptions.
O realce de fragmentos é suportado? Absolutamente; você pode definir termos antes/depois da correspondência para criar trechos concisos.

Como Realçar Texto Java em Documentos

Realçar texto Java envolve três etapas principais:

Indexar os arquivos de origem para que possam ser pesquisados rapidamente.
Executar uma consulta contra o índice para encontrar documentos correspondentes.
Renderizar os resultados com indicadores visuais usando a API de realce.

A seguir, exploramos cada etapa em detalhes, primeiro para saída de documento completo e depois para trechos de nível fragmento.

O que é Search and Highlight Text?

Search and highlight text é o processo de varrer um índice de documentos para uma consulta dada, recuperar os documentos correspondentes e então marcar cada ocorrência do termo de consulta dentro da saída do documento (HTML, PDF, etc.). Esse indicativo visual ajuda os usuários finais a localizar informações relevantes instantaneamente.

Por que usar GroupDocs.Search for Java?

Indexação de alto desempenho com compressão configurável (index documents java).
API de realce avançada que funciona em documentos completos e em fragmentos personalizados (highlight search terms java).
Suporte a múltiplos formatos (DOCX, PDF, PPTX, TXT e mais).
Integração simples com Maven e um design limpo centrado em Java.

Pré‑requisitos

Java Development Kit (JDK) 8 ou superior.
Maven para gerenciamento de dependências.
Uma IDE como IntelliJ IDEA ou Eclipse.
Familiaridade básica com a sintaxe Java.

Configurando GroupDocs.Search for Java

Adicione o repositório GroupDocs e a dependência ao seu 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>

Você também pode baixar o JAR mais recente diretamente do site oficial: lançamentos do GroupDocs.Search para Java.

Aquisição de Licença

Comece com um teste gratuito ou obtenha uma licença temporária para avaliação. Para implantações em produção, adquira uma licença completa para desbloquear todos os recursos.

Guia de Implementação

A implementação está dividida em duas seções práticas: realce em documentos inteiros e realce em fragmentos. Ambas incluem as etapas essenciais para como realçar documentos Java usando GroupDocs.Search.

Configurando as Definições do Índice

Antes de indexar, configure o armazenamento para usar compressão alta — isso reduz o uso de disco enquanto preserva a velocidade de pesquisa.

IndexSettings settings = new IndexSettings();
settings.setTextStorageSettings(new TextStorageSettings(Compression.High));

Realce em Documentos Inteiros

Etapa 1: Criar e Popular o Índice

Crie uma pasta de índice e adicione todos os arquivos de origem que deseja pesquisar.

String indexFolder = "/path/to/your/document/directory/HighlightingInEntireDocument";
Index index = new Index(indexFolder, settings);
index.add("/path/to/your/documents");

Etapa 2: Executar a Busca e Aplicar o Realce

Pesquise o termo (por exemplo, ipsum) e gere um arquivo HTML com as correspondências realçadas.

SearchResult result = index.search("ipsum");

if (result.getDocumentCount() > 0) {
    FoundDocument document = result.getFoundDocument(0);
    OutputAdapter outputAdapter = new FileOutputAdapter(OutputFormat.Html, "/path/to/your/output/directory/Highlighted.html");
    
    Highlighter highlighter = new DocumentHighlighter(outputAdapter);
    HighlightOptions options = new HighlightOptions();
    options.setHighlightColor(new Color(150, 255, 150)); // Custom green shade
    options.setUseInlineStyles(false); // Prefer CSS for styling
    
    index.highlight(document, highlighter, options);
}

Opções principais explicadas

Compression – compressão alta economiza armazenamento.
HighlightColor – defina qualquer valor RGB para combinar com a paleta da sua UI.
UseInlineStyles – false gera HTML limpo que pode ser estilizado globalmente com CSS.

Realce em Fragmentos

Etapa 1: Indexar e Buscar (mesmo que acima)

String indexFolder = "/path/to/your/document/directory/HighlightingInFragments";
Index index = new Index(indexFolder, settings);
index.add("/path/to/your/documents");

SearchResult result = index.search("ipsum");

Etapa 2: Definir o Contexto do Fragmento e Realçar

Especifique quantos termos antes e depois da correspondência devem aparecer em cada fragmento.

HighlightOptions options = new HighlightOptions();
options.setTermsBefore(5); // Include 5 terms before the match
options.setTermsAfter(5);   // Include 5 terms after the match
options.setHighlightColor(new Color(127, 200, 255)); // Custom blue shade
options.setUseInlineStyles(true); // Use inline styles for emphasis

FoundDocument document = result.getFoundDocument(0);
FragmentHighlighter highlighter = new FragmentHighlighter(OutputFormat.Html);

index.highlight(document, highlighter, options);

Etapa 3: Recuperar e Gravar os Fragmentos Realçados

Colete os fragmentos gerados e grave‑os em um arquivo HTML.

StringBuilder stringBuilder = new StringBuilder();
FragmentContainer[] fragmentContainers = highlighter.getResult();

for (FragmentContainer container : fragmentContainers) {
    String[] fragments = container.getFragments();
    
    if (fragments.length > 0) {
        stringBuilder.append("\n<br>").append(container.getFieldName()).append("<br>\n");
        
        for (String fragment : fragments) {
            stringBuilder.append(fragment).append("\n");
        }
    }
}

try {
    Files.write(Paths.get("/path/to/your/output/directory/Fragments.html"), stringBuilder.toString().getBytes());
} catch (IOException ex) {
    // Handle exceptions
}

Aplicações Práticas

Revisão de Documentos Legais – realce instantaneamente estatutos, cláusulas ou referências de casos.
Pesquisa Acadêmica – destaque terminologia chave em dezenas de PDFs e arquivos Word.
Suporte ao Cliente – identifique números de pedido ou códigos de erro dentro do histórico de tickets.

Considerações de Desempenho

Tamanho do Índice – compressão alta (Compression.High) reduz o uso de disco.
Contexto do Fragmento – valores maiores de termsBefore/After aumentam a precisão, mas podem afetar a velocidade.
Gerenciamento de Memória – monitore o heap da JVM ao indexar grandes corpora; considere indexação incremental para conjuntos muito grandes.

Problemas Comuns e Soluções

Erros de Indexação – verifique os caminhos dos arquivos e assegure que a aplicação tem permissões de leitura/escrita.
Nenhum Realce Aparece – confirme que UseInlineStyles corresponde ao seu formato de saída (HTML vs. PDF).
Cor Não Aplicada – certifique‑se de que os valores RGB estejam entre 0‑255 e que o visualizador HTML suporte o estilo.

Perguntas Frequentes

Q: Quais são os benefícios de usar GroupDocs.Search for Java?
A: Ele oferece indexação rápida e escalável, realce personalizável e suporte a muitos formatos de documento.

Q: Como posso integrar GroupDocs.Search com uma API REST?
A: Exponha os métodos de busca e realce via controladores Spring Boot, retornando payloads HTML ou JSON.

Q: A biblioteca lida com arquivos protegidos por senha?
A: Sim—forneça a senha ao adicionar o documento ao índice.

Q: Posso personalizar a marcação de realce além da cor?
A: Absolutamente; você pode injetar classes CSS via HighlightOptions ou modificar o HTML após a geração.

Q: Qual versão foi testada para este guia?
A: O código foi validado contra GroupDocs.Search 25.4.

Q: Como eu defino highlight options java para usar uma classe CSS em vez de estilos inline?
A: Defina options.setUseInlineStyles(false) e adicione uma regra CSS para a classe que você atribuir via options.setCssClass("myHighlight").

Q: Existe uma forma de realçar termos pdf java diretamente quando a origem é um PDF?
A: Sim—GroupDocs.Search funciona com entrada PDF, e o realçador gera HTML que pode ser incorporado em um visualizador PDF ou convertido de volta para PDF usando GroupDocs.Conversion.

Última atualização: 2026-02-27
Testado com: GroupDocs.Search 25.4
Autor: GroupDocs