Como adicionar pasta ao índice com GroupDocs.Search em Java

Respostas rápidas

  • Qual é a biblioteca principal? GroupDocs.Search for Java
  • Como adicionar uma pasta ao índice? Use index.add(folderPath)
  • Posso configurar compressão de texto? Sim, via TextStorageSettings(Compression.High)
  • Qual versão do Java é necessária? JDK 8 ou superior
  • Onde obter uma licença de avaliação? No site da GroupDocs ou na página do repositório

O que é pesquisa de texto completo em Java e por que isso importa?

A pesquisa de texto completo em Java converte documentos brutos em um índice invertido, permitindo a recuperação em subsegundos de qualquer termo em milhares de arquivos. Essa capacidade é essencial para repositórios jurídicos, bibliotecas de pesquisa e bases de conhecimento corporativas onde os usuários esperam resultados instantâneos. Também melhora a produtividade em aplicações modernas.

Por que usar groupdocs.search para pesquisa de texto completo em Java?

GroupDocs.Search oferece indexação de alta taxa de transferência e execução de consultas, além de compressão avançada integrada. Suporta mais de 50 formatos de entrada e saída—incluindo PDF, DOCX, EML e HTML—e pode processar documentos com centenas de páginas sem carregar o arquivo inteiro na memória, mantendo a pegada de memória abaixo de 200 MB para cargas de trabalho típicas.

Pré-requisitos

  • GroupDocs.Search for Java (versão 25.4 ou posterior) – a biblioteca central que alimenta a indexação e a pesquisa.
  • JDK 8+ instalado e configurado – o runtime mínimo exigido para o SDK.
  • Maven para gerenciamento de dependências – simplifica a adição da biblioteca ao seu projeto.
  • Uma IDE como IntelliJ IDEA ou Eclipse – para escrever e depurar código Java.

Configurando o GroupDocs.Search para Java

Configuração do Maven

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

Download direto

Alternativamente, faça o download da versão mais recente em GroupDocs.Search for Java releases.

Aquisição de licença

  • Free trial – explore todos os recursos sem compromisso.
  • Temporary license – período de teste estendido.
  • Purchase – desbloqueie todas as capacidades de produção.

Inicialização e configuração básicas

Index é a classe central usada para criar, abrir e gerenciar um índice de pesquisa.

import com.groupdocs.search.Index;

public class InitializeSearch {
    public static void main(String[] args) {
        // Path to store index data
        String indexPath = "path/to/index";
        
        // Creating an index at specified location
        Index index = new Index(indexPath);
        
        System.out.println("GroupDocs.Search initialized successfully!");
    }
}

Indexar texto com compressão personalizada

Etapa 1: definir a pasta do índice

Escolha um diretório onde os arquivos de índice serão armazenados:

String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output\\AdvancedUsage\\Indexing\\StoringTextOfIndexedDocuments";

Etapa 2: configurar as definições do índice

TextStorageSettings configura como o texto é armazenado no índice, incluindo o nível de compressão. Compression é um enum que especifica o algoritmo de compressão desejado.

import com.groupdocs.search.Index;
import com.groupdocs.search.IndexSettings;
import com.groupdocs.search.options.TextStorageSettings;
import com.groupdocs.search.compression.Compression;

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

Etapa 3: criar o índice com configurações personalizadas

Instancie o índice usando a configuração definida acima:

Index index = new Index(indexFolder, settings);
System.out.println("Index created with high compression.");

Como adicionar uma pasta ao índice

Index é a classe principal que representa o índice pesquisável.

Carregue o índice existente (ou crie um novo) e então chame o método add no objeto Index. A operação add varre o diretório fornecido, extrai texto de cada arquivo suportado e o armazena no índice comprimido, pronto para busca instantânea.

String documentsFolder = "YOUR_DOCUMENT_DIRECTORY"; // Replace with actual document path.
Index index = new Index(indexFolder);

Como pesquisar documentos indexados

SearchResult representa uma correspondência única com caminho do documento e relevância.

Defina uma string de consulta que represente o termo ou frase que você deseja localizar, então invoque o método search na instância Index. O método retorna uma coleção de objetos SearchResult, cada um contendo o caminho do documento, pontuação de relevância e um trecho destacando a correspondência.

index.add(documentsFolder);
System.out.println("Documents added successfully.");

Aplicações práticas

Cenários reais onde java full text search se destaca:

  1. Legal document management – recuperação instantânea de arquivos de casos.
  2. Academic research libraries – busca rápida de artigos e teses.
  3. Enterprise knowledge bases – acesso rápido a manuais e FAQs.
  4. Content management systems – descoberta eficiente de conteúdo para sites grandes.
  5. Customer service archives – busca rápida de tickets e chats anteriores.

Considerações de desempenho

  • Compressão vs. velocidade: compressão alta economiza até 70 % de espaço em disco, mas adiciona uma leve sobrecarga de indexação; execute testes de benchmark para seu volume de dados.
  • Gerenciamento de memória: aloque pelo menos 2 GB de heap para índices maiores que 10 GB para evitar OutOfMemoryError.
  • Atualizações de índice: adicione documentos incrementalmente com index.add() e chame periodicamente index.optimize() para manter o índice compacto.
  • Otimização de consultas: use a sintaxe avançada de consultas (coringas, proximidade, busca difusa) para refinar resultados e reduzir o tempo de resposta.

Armadilhas comuns e dicas profissionais

  • Armadiça: Esquecer de chamar index.optimize() após adições em massa.
    Dica profissional: Execute index.optimize() todas as noites para manter o índice compacto.

  • Armadiça: Usar a compressão padrão (baixa) em conjuntos de dados massivos.
    Dica profissional: Troque para Compression.High em ambientes de produção para reduzir custos de armazenamento.

  • Armadiça: Não tratar IOException ao adicionar arquivos de um compartilhamento de rede.
    Dica profissional: Envolva index.add() em um bloco try‑catch e registre quaisquer falhas para revisão posterior.

Perguntas frequentes

Q: O que é GroupDocs.Search?
A: É uma biblioteca Java robusta que fornece recursos avançados de pesquisa de texto completo, incluindo indexação, compressão e suporte a consultas complexas.

Q: Como lidar com grandes volumes de dados usando GroupDocs.Search?
A: Ative compressão alta (Compression.High) e faça commit das alterações periodicamente para manter o índice enxuto. Também aloque memória heap suficiente (por exemplo, 4 GB para índices acima de 20 GB).

Q: Posso integrar GroupDocs.Search a sistemas corporativos existentes?
A: Sim, a biblioteca pode ser incorporada a qualquer backend Java, serviços REST ou arquitetura de microsserviços.

Q: E se meu índice ficar desatualizado?
A: Use o método index.add() para acrescentar novos arquivos e index.delete() para remover os obsoletos, então execute index.optimize() novamente, se necessário.

Q: Onde posso obter ajuda ou suporte?
A: Visite o fórum da comunidade em GroupDocs forums para solução de problemas e dicas de boas práticas.

Recursos adicionais


Last Updated: 2026-11-02
Tested With: GroupDocs.Search 25.4
Author: GroupDocs


String query = "sample";  
import com.groupdocs.search.results.SearchResult;

SearchResult result = index.search(query);
System.out.println("Search completed. Results found: " + result.getDocumentCount());

Tutoriais Relacionados