Como fazer pesquisa de metadados com GroupDocs em Java

Adicionar documentos a um índice de forma rápida e confiável é a espinha dorsal de qualquer aplicação moderna orientada por pesquisa. Seja construindo um repositório jurídico, uma base de conhecimento de suporte ao cliente ou um portal interno de documentos, pesquisa de metadados com GroupDocs permite localizar arquivos por autor, título ou qualquer etiqueta personalizada sem analisar o conteúdo completo. Neste tutorial você aprenderá como configurar as definições do índice, criar um índice focado em metadados, adicionar seus arquivos e executar buscas precisas — tudo com GroupDocs.Search para Java.

Respostas rápidas

  • Qual é o objetivo principal da indexação de metadados? Ela permite buscas rápidas baseadas nas propriedades do documento em vez do conteúdo completo.
  • Qual método adiciona arquivos ao índice? index.add(YOUR_DOCUMENTS_FOLDER);
  • Posso pesquisar por campos de metadados personalizados? Sim, uma vez que os campos estejam indexados você pode consultá‑los diretamente.
  • Preciso de uma licença para desenvolvimento? Uma licença de avaliação temporária é suficiente para testes; uma licença completa é necessária para produção.
  • Qual versão do Java é necessária? JDK 8 ou superior é recomendado.

O que é indexação de metadados no GroupDocs.Search?

A indexação de metadados extrai e armazena atributos do documento (por exemplo, autor, data de criação, etiquetas personalizadas) em uma estrutura pesquisável. Quando você adiciona documentos ao índice, o mecanismo registra esses atributos, permitindo executar consultas precisas como “encontrar todos os PDFs autoria de John Doe” ou “pesquisar PDF por autor”.

Por que usar o GroupDocs.Search para indexação de metadados?

A pesquisa de metadados com o GroupDocs oferece um tempo de resposta leve, inferior a um segundo, mesmo quando o índice contém milhões de registros. Ele suporta mais de 30 formatos de entrada e saída — incluindo PDF, DOCX, PPTX, HTML e arquivos de imagem — e consome menos de 200 MB de memória heap para um índice de 100 000 documentos em um servidor típico.

Pré‑requisitos

  • GroupDocs.Search para Java ≥ 25.4.
  • JDK 8 ou mais recente instalado e configurado.
  • Familiaridade básica com Java e Maven.

Configurando o GroupDocs.Search para Java

Instruções de instalação

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 os binários mais recentes diretamente dos lançamentos do GroupDocs.Search para Java.

Aquisição de licença

Para obter uma licença temporária para teste:

  1. Visite o site da GroupDocs e vá para a seção Purchase.
  2. Escolha um plano de temporary license que corresponda às suas necessidades de avaliação.

Como configurar as definições de índice para metadados?

Configurar as definições do índice informa ao mecanismo quais informações extrair e armazenar. Ao definir o tipo de índice como MetadataIndex, você instrui o GroupDocs.Search a focar nos campos de metadados em vez do conteúdo completo, o que reduz o tamanho do índice e acelera as consultas. Essa configuração é aplicada através do objeto IndexSettings, onde você também pode especificar campos de metadados personalizados a serem indexados.

IndexSettings settings = new IndexSettings();
settings.setIndexType(IndexType.MetadataIndex);

Recurso 1: configuração das definições de índice

A chamada setIndexType(IndexType.MetadataIndex) indica ao mecanismo que ele deve focar em metadados em vez do conteúdo completo. IndexType.MetadataIndex é um valor de enumeração que seleciona o modo de indexação apenas de metadados.

import com.groupdocs.search.IndexSettings;
import com.groupdocs.search.IndexType;

// Initialize index settings
IndexSettings settings = new IndexSettings();
settings.setIndexType(IndexType.MetadataIndex);  // Focus on metadata indexing

Recurso 2: criando um índice em uma pasta especificada

Crie um diretório de índice físico onde todos os metadados serão armazenados:

import com.groupdocs.search.Index;

String YOUR_INDEX_DIRECTORY = "YOUR_DOCUMENT_DIRECTORY\\\\output\\\\AdvancedUsage\\\\Indexing\\\\IndexingMetadataOfDocuments";

// Create index in specified directory using settings
Index index = new Index(YOUR_INDEX_DIRECTORY, settings);

Substitua YOUR_DOCUMENT_DIRECTORY pelo caminho que corresponde ao layout do seu projeto.

Recurso 3: Como adicionar documentos ao índice

O método index.add adiciona arquivos de uma pasta ao índice e extrai seus metadados. index.add analisa cada documento, lê os campos de metadados suportados e os armazena no índice para recuperação rápida.

String YOUR_DOCUMENTS_FOLDER = "YOUR_DOCUMENT_DIRECTORY";

// Add all documents in directory to the index
index.add(YOUR_DOCUMENTS_FOLDER);

Dicas:

  • Verifique se o caminho da pasta está correto e se a aplicação tem permissões de leitura.
  • O GroupDocs.Search extrai automaticamente os metadados suportados de cada arquivo.

Recurso 4: Pesquisando documentos por metadados

Execute uma consulta que vise campos de metadados, por exemplo pesquisando documentos onde o idioma é inglês:

import com.groupdocs.search.results.SearchResult;

String query = "English";  // Define search query
SearchResult result = index.search(query);  // Perform the search

// Process results (example)
for (int i = 0; i < result.getDocumentCount(); i++) {
    System.out.println("Found document: " + result.getFoundDocument(i).getFilePath());
}

O método search(query) procura nos metadados indexados e retorna os documentos correspondentes. Você também pode search pdf by author usando o nome do autor como string de consulta.

Aplicações práticas

  1. Gerenciamento corporativo de documentos: Recuperar contratos por data de contrato ou nome do signatário.
  2. Catálogos de bibliotecas digitais: Permitir que os usuários naveguem livros por gênero, ano de publicação ou autor.
  3. Sistemas CRM: Localizar rapidamente arquivos de clientes usando metadados personalizados como ID do cliente ou região.

Dicas e boas práticas

  • Atualizações incrementais: Use index.addOrUpdate() para arquivos novos ou alterados em vez de reconstruir todo o índice.
  • Processamento em lote: Ao lidar com milhares de arquivos, adicione-os em lotes menores para manter o uso de memória baixo.
  • Validação de metadados: Garanta que os documentos de origem realmente contenham os metadados que você pretende consultar (por exemplo, campos de autor em PDFs).

Considerações de desempenho

  • Ajuste de memória: Ajuste o tamanho do heap da JVM (-Xmx) com base no volume de metadados indexados.
  • Armazenamento otimizado: Chame periodicamente index.optimize() para compactar o índice e melhorar a velocidade das consultas.

Problemas comuns e soluções

ProblemaSolução
Nenhum resultado retornadoConfirme se os campos de metadados que você espera estão realmente presentes nos arquivos de origem.
Erros de permissãoGaranta que o processo Java tenha acesso de leitura tanto à pasta de documentos quanto ao diretório do índice.
Erros de falta de memóriaAumente o tamanho do heap da JVM ou processe a operação add em lotes menores.

Perguntas frequentes

Q: O que é indexação de metadados?
A: A indexação de metadados armazena atributos do documento (autor, título, etiquetas personalizadas) em uma estrutura pesquisável, permitindo buscas rápidas sem analisar o texto completo.

Q: Como obtenho uma licença temporária?
A: Visite a página de compra da GroupDocs e siga os passos para adquirir uma licença de avaliação.

Q: Posso indexar PDFs com esta configuração?
A: Sim, o GroupDocs.Search suporta PDF, DOCX, PPT e muitos outros formatos.

Q: Quais são os problemas comuns ao adicionar documentos?
A: Verifique se os caminhos dos arquivos estão corretos e se a aplicação tem permissões de leitura para os diretórios.

Q: Como otimizo o desempenho da pesquisa?
A: Atualize regularmente seu índice, use adições incrementais e ajuste as configurações de memória da JVM.

Recursos


Última atualização: 2026-10-22
Testado com: GroupDocs.Search Java 25.4
Autor: GroupDocs

Tutoriais relacionados