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:
- Legal document management – recuperação instantânea de arquivos de casos.
- Academic research libraries – busca rápida de artigos e teses.
- Enterprise knowledge bases – acesso rápido a manuais e FAQs.
- Content management systems – descoberta eficiente de conteúdo para sites grandes.
- 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 periodicamenteindex.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: Executeindex.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 paraCompression.Highem ambientes de produção para reduzir custos de armazenamento.Armadiça: Não tratar
IOExceptionao adicionar arquivos de um compartilhamento de rede.
Dica profissional: Envolvaindex.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
- Guia de uso detalhado: GroupDocs Search Documentation
- Referência completa da API: API Reference Guide
- Mantenha-se atualizado com novos recursos: Latest Releases
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());