Pesquisa por Atributo Java com Guia GroupDocs.Search

Você está procurando melhorar seu sistema de gerenciamento de documentos modificando e indexando dinamicamente atributos de documentos usando Java? Você está no lugar certo! Este tutorial aprofunda o uso da poderosa biblioteca GroupDocs.Search for Java para search by attribute java, alterar atributos de documentos indexados e adicioná-los durante o processo de indexação. Seja construindo uma solução de busca ou otimizando fluxos de trabalho de documentos, dominar essas técnicas é essencial.

Quick Answers

  • What is “search by attribute java”? É a capacidade de filtrar resultados de busca usando metadados personalizados anexados a cada documento.
  • Can I modify attributes after indexing? Sim—use AttributeChangeBatch para atualizar em lote os atributos do documento.
  • How do I add attributes while indexing? Inscreva‑se no evento FileIndexing e defina os atributos programaticamente.
  • Do I need a license? Um teste gratuito funciona para avaliação; uma licença permanente é necessária para produção.
  • Which Java version is required? Java 8 ou superior é recomendado.

What is “search by attribute java”?

Search by attribute java permite consultar documentos com base em seus metadados (atributos) ao invés de apenas seu conteúdo. Ao anexar pares chave‑valor como public, main ou key a cada arquivo, você pode rapidamente reduzir os resultados ao subconjunto mais relevante.

Why modify or add attributes?

  • Dynamic categorization – mantenha os metadados sincronizados com as regras de negócios.
  • Faster filtering – filtros de atributos são avaliados antes da busca full‑text, melhorando o desempenho.
  • Compliance tracking – marque documentos para políticas de retenção ou requisitos de auditoria.

Prerequisites

  • Java 8+ (JDK 8 ou mais recente)
  • GroupDocs.Search for Java library (veja a configuração Maven abaixo)
  • Compreensão básica de Java e conceitos de indexação

Setting Up GroupDocs.Search for Java

Maven Setup

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

Direct Download

Alternatively, download the latest version from GroupDocs.Search for Java releases.
If you prefer not using a build tool like Maven, download the JAR from the GroupDocs website.

License Acquisition

  • Comece com um teste gratuito para explorar os recursos.
  • Para uso prolongado, obtenha uma licença temporária ou completa através da license page.

Basic Initialization

import com.groupdocs.search.Index;

// Initialize an index in a specified directory
Index index = new Index("YOUR_OUTPUT_DIRECTORY/ChangeAttributes");

Implementation Guide

Search by Attribute Java – Changing Document Attributes

Overview

Você pode adicionar, remover ou substituir atributos em documentos já indexados, permitindo batch update document attributes sem re‑indexar toda a coleção.

Step‑by‑Step

Step 1: Add Documents to Index

index.add("YOUR_DOCUMENT_DIRECTORY");

Step 2: Retrieve Indexed Document Information

import com.groupdocs.search.results.DocumentInfo;

DocumentInfo[] documents = index.getIndexedDocuments();

Step 3: Batch Update Document Attributes

import com.groupdocs.search.common.AttributeChangeBatch;
import com.groupdocs.search.SearchOptions;

AttributeChangeBatch batch = new AttributeChangeBatch();
batch.addToAll("public"); // Add 'public' to all documents
batch.remove(documents[0].getFilePath(), "public"); // Remove 'public' from a specific document
batch.add(documents[0].getFilePath(), "main", "key"); // Add 'main' and 'key' attributes

// Apply changes
index.changeAttributes(batch);

Step 4: Search with Attribute Filters

import com.groupdocs.search.results.SearchResult;

SearchOptions options = new SearchOptions();
options.setSearchDocumentFilter(SearchDocumentFilter.createAttribute("main"));
String query = "length";
SearchResult result = index.search(query, options); // Perform the search

Batch Update Document Attributes with AttributeChangeBatch

A classe AttributeChangeBatch é a ferramenta principal para batch update document attributes. Ao agrupar alterações em um único lote, você reduz a sobrecarga de I/O e mantém o índice consistente.

Search by Attribute Java – Adding Attributes During Indexing

Overview

Engate no evento FileIndexing para atribuir atributos personalizados à medida que cada arquivo é adicionado ao índice.

Step‑by‑Step

Step 1: Subscribe to the FileIndexing Event

import com.groupdocs.search.events.EventHandler;
import com.groupdocs.search.events.FileIndexingEventArgs;

index.getEvents().FileIndexing.add(new EventHandler<FileIndexingEventArgs>() {
    @Override
    public void invoke(Object sender, FileIndexingEventArgs args) {
        if (args.getDocumentFullPath().endsWith("Lorem ipsum.pdf")) {
            args.setAttributes(new String[] { "main", "key" });
        }
    }
});

Step 2: Index Documents

index.add("YOUR_DOCUMENT_DIRECTORY");

Practical Applications

  1. Document Management Systems – Automatize a categorização adicionando metadados durante a ingestão.
  2. Large Content Archives – Use filtros de atributos para restringir buscas, reduzindo drasticamente o tempo de resposta.
  3. Compliance & Reporting – Marque documentos dinamicamente para cronogramas de retenção ou trilhas de auditoria.

Performance Considerations

  • Memory Management – Monitore o heap da JVM e ajuste -Xmx conforme necessário.
  • Batch Processing – Agrupe alterações de atributos com AttributeChangeBatch para minimizar gravações no índice.
  • Library Updates – Mantenha o GroupDocs.Search atualizado para aproveitar correções de desempenho.

Frequently Asked Questions

Q: What are the prerequisites for using GroupDocs.Search in Java?
A: Você precisa de Java 8+, a biblioteca GroupDocs.Search e conhecimento básico de conceitos de indexação.

Q: How do I install GroupDocs.Search via Maven?
A: Adicione o repositório e a dependência mostrados na seção Maven Setup ao seu pom.xml.

Q: Can I modify attributes after documents are indexed?
A: Sim, use AttributeChangeBatch para atualizar em lote os atributos do documento sem re‑indexar.

Q: What if my indexing process is slow?
A: Otimize as configurações de memória da JVM, use atualizações em lote e garanta que você esteja na versão mais recente da biblioteca.

Q: Where can I find more resources on GroupDocs.Search for Java?
A: Visite a official documentation ou explore os fóruns da comunidade.

Resources

Last Updated: 2025-12-24
Tested With: GroupDocs.Search 25.4 for Java
Author: GroupDocs