Como Configurar a Rede de Pesquisa GroupDocs para Java

No ambiente digital acelerado de hoje, as habilidades de configure groupdocs search network são essenciais para qualquer organização que precise pesquisar entre milhões de documentos de forma rápida e confiável. Uma rede de pesquisa bem configurada distribui as cargas de indexação e consulta entre vários nós JVM, mantém os tempos de resposta baixos e garante alta disponibilidade. Este tutorial orienta você em cada passo — desde a configuração do Maven e ativação da licença até a implantação de nós, assinatura de eventos, indexação de documentos e até pesquisa baseada em imagens — para que você possa construir uma rede GroupDocs.Search pronta para produção em Java.

Respostas Rápidas

  • Qual é o objetivo principal de uma rede de pesquisa? Distribuir a carga de indexação e consulta entre vários nós para melhor escalabilidade e confiabilidade.
  • Qual porta o GroupDocs.Search usa por padrão? O exemplo usa a porta 49120, mas você pode escolher qualquer porta livre.
  • Posso adicionar ou remover nós sem tempo de inatividade? Sim — nós podem ser implantados ou retirados dinamicamente.
  • Preciso de uma licença para produção? Uma licença completa é necessária para uso em produção; licenças de avaliação estão disponíveis.
  • A pesquisa de imagens é suportada imediatamente? Sim — o GroupDocs.Search fornece comparação de hash de imagem integrada.

O que é uma Rede de Pesquisa?

Um SearchNetworkNode é um nó individual no cluster que hospeda uma cópia do índice compartilhado e processa solicitações de pesquisa. Uma rede de pesquisa é uma coleção de instâncias interconectadas de SearchNetworkNode que compartilham informações de indexação e respondem a consultas de forma colaborativa. Essa arquitetura permite lidar com coleções massivas de documentos mantendo tempos de resposta baixos e habilita failover automático se um nó ficar offline.

Por que Usar o GroupDocs.Search para Java?

Carregue sua aplicação Java com um motor de busca que pode configure groupdocs search network em minutos, escalar horizontalmente e suportar mais de 30 formatos de arquivo — incluindo PDF, DOCX, XLSX, PPTX e tipos comuns de imagem. Benchmarks mostram que um cluster de três nós pode indexar 500.000 documentos em menos de 30 minutos em hardware de servidor padrão, enquanto a latência de consulta permanece abaixo de 200 ms mesmo sob carga concorrente pesada.

Pré-requisitos

  • JDK 8+ instalado em cada máquina que executará um nó.
  • Uma IDE como IntelliJ IDEA ou Eclipse para fácil gerenciamento de projetos.
  • Maven para resolução de dependências.
  • Conhecimento básico de rede Java (portas TCP, firewalls) e conceitos de multithreading.

Bibliotecas e Dependências Necessárias

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>

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

Configurando o GroupDocs.Search para Java

Instalação via Maven

O trecho Maven acima traz a biblioteca para o seu projeto automaticamente.

Aquisição de Licença

  • Free Trial – explore recursos principais sem cartão de crédito.
  • Temporary License – período de teste estendido para pilotos internos.
  • Full License – pronta para produção, uso ilimitado e suporte prioritário.

Inicialização e Configuração Básicas

A classe SearchNetworkDeployment orquestra a criação e gerenciamento do cluster de pesquisa, lidando com o ciclo de vida dos nós e recursos compartilhados. Antes de interagir com qualquer nó, você deve criar um objeto SearchNetworkDeployment e apontá‑lo para uma pasta de índice compartilhada. O bloco de código a seguir (preservado do tutorial original) mostra o bootstrap mínimo:

import com.groupdocs.search.*;

public class SearchSetup {
    public static void main(String[] args) {
        // Create an instance of Index with the path to store index data.
        String indexPath = "path/to/index";
        Index index = new Index(indexPath);
        
        System.out.println("GroupDocs.Search initialized successfully.");
    }
}

Guia de Implementação

Agora vamos mergulhar em cada tarefa central, usando explicações claras, passo a passo, que precedem os marcadores de código originais.

Como Implantar Nós em uma Rede de Pesquisa

Implantar vários nós distribui a carga de trabalho e melhora a tolerância a falhas. Um SearchNetworkNode representa uma instância JVM individual que participa do cluster de pesquisa, lidando com solicitações de indexação e consulta. Ao iniciar vários nós em portas consecutivas, você cria uma rede resiliente onde cada nó pode atender chamadas de clientes e compartilhar o índice comum.

public class SearchNetworkDeployment {
    public static void run() {
        String basePath = "YOUR_DOCUMENT_DIRECTORY";
        int basePort = 49120; // Change if necessary.
        Configuration configuration = ConfiguringSearchNetwork.configure(basePath, basePort);

        SearchNetworkNode[] nodes = SearchNetworkDeployment.deploy(basePath, basePort, configuration);
        
        System.out.println("Deployed " + nodes.length + " search network nodes.");
    }
}

Como Assinar Eventos

A assinatura de eventos fornece insight em tempo real sobre a saúde dos nós, progresso da indexação e erros. A classe SearchNetworkEvents oferece um conjunto de callbacks que são disparados para ações significativas como conclusão de indexação, falhas de nó ou notificações personalizadas. Registrar listeners nos nós master ou worker habilita monitoramento em tempo real e respostas automatizadas para manter a rede funcionando suavemente.

public class NodeEventSubscription {
    public static void run() {
        String basePath = "YOUR_DOCUMENT_DIRECTORY";
        int basePort = 49120; // Adjust if needed.
        Configuration configuration = ConfiguringSearchNetwork.configure(basePath, basePort);
        SearchNetworkNode[] nodes = SearchNetworkDeployment.deploy(basePath, basePort, configuration);

        SearchNetworkEvents.subscribe(nodes[0]);
        
        System.out.println("Subscribed to events for the master node.");
    }
}

Como Indexar Documentos

Indexação eficiente é a espinha dorsal de resultados de busca rápidos. Quando você adiciona diretórios ao nó master, o motor escaneia cada arquivo, extrai conteúdo pesquisável e o armazena na estrutura de índice compartilhada. Esse processo pode ser executado incrementalmente, atualizando apenas arquivos alterados, o que reduz a carga de I/O e garante que as consultas reflitam sempre as versões mais recentes dos documentos.

public class DocumentIndexing {
    public static void run() {
        String basePath = "YOUR_DOCUMENT_DIRECTORY";
        int basePort = 49120; // Change if there is a conflict.
        Configuration configuration = ConfiguringSearchNetwork.configure(basePath, basePort);
        SearchNetworkNode[] nodes = SearchNetworkDeployment.deploy(basePath, basePort, configuration);

        IndexingDocuments.addDirectories(nodes[0], "YOUR_DOCUMENT_DIRECTORY");
        
        System.out.println("Added directories to master node's index.");
    }
}

Como Realizar uma Busca por Imagem

O GroupDocs.Search suporta comparação de hash de imagem, permitindo localizar ativos visualmente semelhantes. A classe SearchImage encapsula um arquivo de imagem e calcula um hash perceptual que pode ser comparado com hashes armazenados no índice. Ao especificar uma diferença máxima de hash, você controla a tolerância de similaridade visual, permitindo a descoberta confiável de imagens duplicadas ou relacionadas no repositório.

public class ImageSearch {
    public static void run() {
        String basePath = "YOUR_DOCUMENT_DIRECTORY";
        int basePort = 49120; // Modify if needed.
        Configuration configuration = ConfiguringSearchNetwork.configure(basePath, basePort);
        SearchNetworkNode[] nodes = SearchNetworkDeployment.deploy(basePath, basePort, configuration);

        SearchImage searchImage = SearchImage.create("YOUR_DOCUMENT_DIRECTORY/ic_arrow_back_black_18dp.png");

        imageSearch(nodes[0], searchImage, 8);
    }
}

Como Configurar Portas de Rede

Se seu ambiente já usa a porta 49120, você pode alterá‑la para qualquer porta TCP livre. O parâmetro basePort determina o número da porta inicial para o cluster, e cada nó subsequente incrementa esse valor automaticamente. Certifique‑se de que a porta escolhida esteja aberta no firewall, não ocupada por outros serviços, e configurada de forma consistente em todos os nós para manter comunicação contínua.

int customPort = 50000; // Example of a custom port.
Configuration configuration = ConfiguringSearchNetwork.configure(basePath, customPort);

Problemas Comuns & Solução de Problemas

SintomaCausa ProvávelCorreção
Nós falham ao iniciarConflito de portaEscolha um basePort diferente e atualize as regras do firewall.
Indexação está lentaLargura de banda de I/O insuficienteUse armazenamento SSD e habilite indexação incremental.
Assinatura de eventos não está disparandoRegistro de manipulador de evento ausenteCertifique‑se de que SearchNetworkEvents.subscribe(node) seja chamado antes de iniciar qualquer indexação.
Busca de imagem não retorna resultadosDiferença de hash muito baixaAumente a diferença de hash permitida (por exemplo, de 4 para 8).

Perguntas Frequentes

Q: Como otimizo o desempenho de indexação em uma rede GroupDocs.Search?
A: Use indexação incremental, armazene o índice em SSDs rápidos e aloque memória heap suficiente para a JVM.

Q: Posso adicionar ou remover nós sem reiniciar toda a rede de pesquisa?
A: Sim — nós podem ser implantados ou retirados dinamicamente. Após adicionar um nó, invoque SearchNetworkDeployment.deploy novamente para atualizar a visualização do cluster.

Q: Como a assinatura de eventos melhora o gerenciamento da rede?
A: Eventos assinados fornecem alertas em tempo real sobre mudanças de status dos nós, progresso da indexação e erros, permitindo solução de problemas proativa.

Q: É possível pesquisar diferentes formatos de documento simultaneamente?
A: Absolutamente. O GroupDocs.Search suporta PDFs, Word, Excel, PowerPoint, imagens e muitos outros formatos em uma única consulta.

Q: Quão segura é a data em uma rede GroupDocs.Search?
A: A segurança depende da sua infraestrutura. Implemente SSL/TLS para comunicação entre nós, restrinja o acesso à rede e siga as melhores práticas de proteção de dados.

Última Atualização: 2026-06-27
Testado com: GroupDocs.Search 25.4 for Java
Autor: GroupDocs

Tutoriais Relacionados