.# Como Habilitar Ortografia em Java Usando GroupDocs.Search

Resultados de busca precisos são essenciais para qualquer aplicação moderna. Neste tutorial você aprenderá como habilitar a correção ortográfica em Java com GroupDocs.Search, para que os usuários obtenham os resultados corretos mesmo quando digitam consultas com erros. Vamos percorrer a criação de um índice, adicionar documentos ao índice, configurar opções de ortografia e executar uma busca que corrige automaticamente os erros.

Respostas Rápidas

O que significa “how to enable spelling”? Ele ativa o verificador ortográfico embutido que corrige erros de digitação do usuário durante uma busca.
Qual biblioteca fornece esse recurso? GroupDocs.Search for Java.
Preciso de uma licença? Uma licença de avaliação gratuita funciona para avaliação; uma licença completa é necessária para produção.
Posso controlar a tolerância? Sim – use setMaxMistakeCount para definir quantos erros de digitação são permitidos.
É adequado para índices grandes? Absolutamente – o mecanismo é otimizado para indexação e busca de alto desempenho.

O que é “how to enable spelling” no GroupDocs.Search?

Habilitar a ortografia indica ao motor de busca para procurar os termos corretos mais próximos quando uma consulta contém erros. Esse recurso melhora drasticamente a experiência do usuário ao retornar resultados relevantes mesmo com entrada digitada incorretamente.

Por que habilitar a correção ortográfica em aplicações Java?

Aumenta a satisfação do usuário – os usuários não precisam digitar perfeitamente.
Reduz as taxas de rejeição – resultados mais precisos mantêm os visitantes engajados.
Funciona em diversos domínios – de catálogos de bibliotecas a buscas de produtos em e‑commerce.

Pré-requisitos

Java Development Kit (JDK) instalado.
Conhecimento básico de Java e Maven.
Compreensão dos conceitos de indexação.
Uma licença de avaliação ou chave licenciada do GroupDocs.Search.

Configurando o GroupDocs.Search para Java

Integre a biblioteca ao seu projeto Maven.

Configuração 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

Obtenha uma licença de avaliação gratuita para testes. Para uso em produção, adquira uma licença completa ou solicite uma chave temporária no site oficial.

Como Adicionar Documentos ao Índice

Criar um índice é a base para qualquer aplicação com busca. Abaixo está um exemplo mínimo que adiciona documentos ao índice a partir de uma pasta.

import com.groupdocs.search.*;

public class FeatureIndexAndAddDocuments {
    public static void main(String[] args) {
        // Define where the index will be stored
        String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output\\AdvancedUsage\\Searching\\SpellChecking";
        
        // Create an Index instance pointing to the specified folder
        Index index = new Index(indexFolder);
        
        // Specify the documents directory for indexing
        String documentsFolder = "YOUR_DOCUMENT_DIRECTORY";  
        
        // Add documents from this directory to the index
        index.add(documentsFolder);
    }
}

Dica: Verifique se os caminhos estão corretos e se a aplicação tem permissões de gravação na pasta do índice.

Como Configurar a Correção Ortográfica (definir contagem máxima de erros)

Você pode ajustar finamente o verificador ortográfico habilitando‑o e definindo a tolerância para erros.

import com.groupdocs.search.*;
import com.groupdocs.search.options.*;

public class FeatureSpellingCorrectionOptions {
    public static void main(String[] args) {
        // Instantiate SearchOptions
        SearchOptions options = new SearchOptions();
        
        // Enable spelling correction
        options.getSpellingCorrector().setEnabled(true);
        
        // Allow up to one mistake during search
        options.getSpellingCorrector().setMaxMistakeCount(1);
        
        // Return only the best results after correction
        options.getSpellingCorrector().setOnlyBestResults(true);
    }
}

Por que setMaxMistakeCount importa: Ele define quantos erros de digitação o motor tolerará. Ajuste esse valor com base nos padrões típicos de erro do seu domínio.

Como Realizar uma Busca com Correção Ortográfica

Com o índice pronto e as opções de ortografia configuradas, execute uma consulta que pode conter erros.

import com.groupdocs.search.*;
import com.groupdocs.search.options.*;
import com.groupdocs.search.results.*;

public class FeatureSpellingCorrectionSearch {
    public static void main(String[] args) {
        // Create an index in the specified directory
        String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output\\AdvancedUsage\\Searching\\SpellChecking";
        Index index = new Index(indexFolder);
        
        // Define search options with spelling correction enabled
        SearchOptions options = new SearchOptions();
        options.getSpellingCorrector().setEnabled(true);
        options.getSpellingCorrector().setMaxMistakeCount(1);
        options.getSpellingCorrector().setOnlyBestResults(true);
        
        // Specify a misspelled search query
        String query = "houseohld";
        
        // Execute the spelling‑corrected search
        SearchResult result = index.search(query, options);
    }
}

A chamada search() retorna um SearchResult que contém termos corrigidos e os documentos mais relevantes.

Aplicações Práticas

Sistemas de Bibliotecas: Corrigir títulos de livros ou nomes de autores digitados incorretamente.
Plataformas de E‑commerce: Corrigir erros de digitação dos usuários nas buscas de produtos para aumentar as conversões.
Sistemas de Gerenciamento de Conteúdo: Melhorar a recuperação de artigos para a equipe editorial.

Considerações de Desempenho

Mantenha o índice atualizado – reindexe arquivos novos ou alterados regularmente.
Ajuste as configurações de memória da JVM – aloque heap suficiente para índices grandes.
Monitore o uso de recursos – ajuste as flags do coletor de lixo se necessário.

Problemas Comuns & Solução de Problemas

Sintoma	Causa Provável	Solução
Nenhum resultado retornado após habilitar a ortografia	Caminho da pasta do índice está errado ou vazio	Verifique se `indexFolder` aponta para um índice válido e se `index.add()` foi bem-sucedido
Verificador ortográfico não corrige erros óbvios	`setMaxMistakeCount` está definido muito baixo	Aumente a contagem para 2 ou 3 para uma correção mais tolerante
Aplicação trava com grandes conjuntos de documentos	Heap da JVM insuficiente	Aumente a opção `-Xmx` (ex.: `-Xmx4g`)

Perguntas Frequentes

Q: O que é GroupDocs.Search?
A: É uma biblioteca Java que fornece indexação rápida, recursos avançados de busca e correção ortográfica incorporada.

Q: Como obtenho uma licença para GroupDocs.Search?
A: Visite o site oficial para baixar uma avaliação gratuita ou adquirir uma licença completa.

Q: Posso integrar o GroupDocs.Search com outros frameworks Java?
A: Sim, funciona com Spring, Jakarta EE e qualquer aplicação Java padrão.

Q: Quais são os problemas comuns ao configurar um índice?
A: Caminhos de pasta incorretos, permissões de arquivo insuficientes ou dependências ausentes no pom.xml.

Q: Como a correção ortográfica melhora os resultados de busca?
A: Ela reescreve automaticamente consultas digitadas incorretamente para os termos corretos mais próximos, retornando resultados mais relevantes.

Recursos Adicionais

Última Atualização: 2026-02-21
Testado com: GroupDocs.Search 25.4
Autor: GroupDocs