Come generare forme in Java con GroupDocs.Search

In questa guida imparerai come generare forme in Java usando l’API GroupDocs.Search. Creando un provider personalizzato di forme di parole, consenti al tuo motore di ricerca o di analisi del testo di riconoscere ogni variazione di un termine—che sia “cat”, “cats”, “city” o “citis”. Questo migliora notevolmente il richiamo mantenendo alta la precisione.

Risposte rapide

  • Che cosa fa un provider di forme di parole? Genera forme alternative (singolare, plurale, ecc.) di una parola data in modo che le ricerche possano corrispondere a tutte le varianti.
  • Quale libreria è necessaria? GroupDocs.Search for Java (version 25.4 or newer).
  • Ho bisogno di una licenza? Una prova gratuita funziona per la valutazione; è necessaria una licenza permanente per la produzione.
  • Quale versione di Java è supportata? JDK 8 or higher.
  • Quante righe di codice sono necessarie? Circa 30 righe per una semplice implementazione del provider.

Cos’è la funzionalità “create word forms provider”?

Un create word forms provider è una classe personalizzata che implementa IWordFormsProvider. IWordFormsProvider è un’interfaccia che definisce come i provider forniscono forme alternative di parole al motore di ricerca. Riceve una parola e restituisce un array di possibili forme—singolare, plurale o altre variazioni linguistiche—basate su regole che definisci. Questo consente all’indice di ricerca di trattare “cat” e “cats” come equivalenti, migliorando il richiamo senza sacrificare la precisione.

Perché usare GroupDocs.Search per la generazione di forme di parole?

GroupDocs.Search offre estensibilità integrata, consentendo di collegare il proprio provider direttamente nella pipeline di indicizzazione. Elabora indici con fino a 10 milioni di documenti mantenendo l’uso della memoria sotto 500 MB grazie all’architettura di streaming, e puoi memorizzare nella cache i risultati per ottenere tempi di ricerca inferiori al millisecondo.

Prerequisiti

  • Maven installato e un JDK 8 o più recente configurato sulla tua macchina.
  • Familiarità di base con lo sviluppo Java e la configurazione pom.xml di Maven.
  • Accesso alla libreria GroupDocs.Search per Java (version 25.4 or later).

Configurazione di GroupDocs.Search per Java

Configurazione Maven

Aggiungi il repository e la dipendenza al tuo file pom.xml esattamente come mostrato di seguito:

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

In alternativa, scarica l’ultimo JAR dalla pagina ufficiale dei rilasci: GroupDocs.Search for Java releases.

Passaggi per l’acquisizione della licenza

  1. Free trial: Registrati per una prova per esplorare le funzionalità principali.
  2. Temporary license: Richiedi una chiave temporanea per test estesi.
  3. Purchase: Ottieni una licenza commerciale per uso in produzione senza restrizioni.

Inizializzazione e configurazione di base

Il seguente frammento dimostra come creare un indice—il tuo punto di partenza per aggiungere documenti e logica di forme di parole:

import com.groupdocs.search.*;

public class SearchSetup {
    public static void main(String[] args) {
        // Initialize an index
        Index index = new Index("path/to/index");
        
        System.out.println("GroupDocs.Search initialized successfully.");
    }
}

Guida all’implementazione

Di seguito percorriamo i passaggi per creare un provider di forme di parole che gestisce semplici trasformazioni da singolare a plurale e da plurale a singolare.

Implementazione di SimpleWordFormsProvider

Panoramica

La classe SimpleWordFormsProvider implementa IWordFormsProvider. L’ancora della definizione chiarisce il suo scopo:

SimpleWordFormsProvider è un’implementazione personalizzata di IWordFormsProvider che fornisce variazioni singolare‑plurale per il motore di indicizzazione.

Passo 1 – crea lo scheletro della classe

Inizia definendo una classe che implementa IWordFormsProvider. Mantieni inalterate le istruzioni di importazione:

import com.groupdocs.search.dictionaries.IWordFormsProvider;
import java.util.ArrayList;

public class SimpleWordFormsProvider implements IWordFormsProvider {

Passo 2 – implementa getWordForms

Aggiungi il metodo che costruisce l’elenco delle possibili forme. Questo blocco contiene la logica principale; puoi estenderlo in seguito per coprire regole più complesse.

getWordForms riceve un termine e restituisce un String[] contenente tutte le variazioni generate.

    @Override
    public final String[] getWordForms(String word) {
        // Initialize a list to store generated word forms
        ArrayList<String> result = new ArrayList<>();

        // Singular form for words ending in 'es'
        if (word.length() > 2 && word.toLowerCase().endsWith("es")) {
            result.add(word.substring(0, word.length() - 2));
        }

        // Singular form for words ending in 's'
        if (word.length() > 1 && word.toLowerCase().endsWith("s")) {
            result.add(word.substring(0, word.length() - 1));
        }

        // Plural form by replacing 'y' with 'is'
        if (word.length() > 1 && word.toLowerCase().endsWith("y")) {
            result.add(word.substring(0, word.length() - 1).concat("is"));
        }

        // Basic plural forms
        result.add(word.concat("s"));
        result.add(word.concat("es"));

        // Convert list to array and return
        return result.toArray(new String[0]);
    }
}

Spiegazione della logica

  • Singularization: Rileva i suffissi plurali comuni (es, s) e li rimuove per approssimare la parola base.
  • Pluralization: Gestisce i sostantivi che terminano in y sostituendolo con is, una regola semplice che funziona per molte parole inglesi.
  • Suffix appending: Aggiunge s e es per coprire le forme plurali regolari che potrebbero non essere catturate dai controlli precedenti.

Suggerimenti per la risoluzione dei problemi

  • Case sensitivity: Il metodo utilizza toLowerCase() per il confronto, garantendo che “Cats” e “cats” si comportino allo stesso modo.
  • Edge cases: Le parole più corte della lunghezza del suffisso vengono ignorate per evitare di restituire stringhe vuote.
  • Performance: Per vocabolari grandi, considera di memorizzare nella cache i risultati in un ConcurrentHashMap.

Applicazioni pratiche

Implementare un create word forms provider può potenziare diversi scenari reali:

  1. Search engines: Gli utenti che digitano “mouse” dovrebbero trovare anche i documenti contenenti “mice”. Un provider può generare tali forme irregolari.
  2. Text analysis tools: L’analisi del sentiment o l’estrazione di entità diventano più affidabili quando tutte le varianti delle parole sono riconosciute.
  3. Content management systems: La generazione automatica di tag può includere sinonimi plurali, migliorando SEO e collegamenti interni.

Considerazioni sulle prestazioni

Quando integri il provider in un sistema di produzione, tieni presenti questi consigli:

  • Cache frequently used forms: Memorizza i risultati in memoria per evitare di ricalcolare la stessa parola più volte.
  • Monitor JVM heap: Indici di grandi dimensioni possono aumentare la pressione sulla memoria; regola -Xmx di conseguenza.
  • Use efficient collections: ArrayList funziona per piccoli insiemi, ma per migliaia di forme considera HashSet per eliminare rapidamente i duplicati.

Best practice

  • Mantieni la libreria aggiornata per beneficiare delle correzioni di prestazioni.
  • Esegui il profiling del provider con carichi di query realistici per individuare i colli di bottiglia in anticipo.

Conclusione

Ora hai imparato come generare forme in Java usando un SimpleWordFormsProvider personalizzato con GroupDocs.Search. Questo componente leggero può migliorare notevolmente la pertinenza dei risultati di ricerca e l’accuratezza dell’analisi linguistica in molte applicazioni.

Passaggi successivi

  • Sperimenta regole linguistiche più sofisticate (plurali irregolari, stemming).
  • Integra il provider in una pipeline di indicizzazione e misura i miglioramenti del richiamo.
  • Esplora altre funzionalità di GroupDocs.Search come dizionari di sinonimi e analizzatori personalizzati.

Invito all’azione: Prova ad aggiungere il SimpleWordFormsProvider al tuo progetto oggi e scopri come arricchisce la tua esperienza di ricerca!

Sezione FAQ

Q: Cos’è GroupDocs.Search per Java?
A: È una libreria potente che offre ricerca full‑text, indicizzazione e funzionalità linguistiche—including la possibilità di collegare provider personalizzati di forme di parole.

Q: Come funziona SimpleWordFormsProvider?
A: Genera forme alternative applicando semplici regole basate su suffissi (rimuovendo “s/es”, convertendo “y” in “is”, e aggiungendo “s/es”).

Q: Posso personalizzare le regole di generazione delle forme di parole?
A: Assolutamente. Modifica il metodo getWordForms per includere forme irregolari, regole specifiche per locale, o integrazione con dizionari esterni.

Q: Quali sono alcune applicazioni comuni per questa funzionalità?
A: I motori di ricerca, le pipeline di analisi del testo e le piattaforme CMS beneficiano del riconoscimento delle varianti singolari/plurali.

Q: È necessaria una licenza commerciale per l’uso in produzione?
A: Sì—mentre una prova ti permette di esplorare l’API, una licenza acquistata rimuove i limiti di utilizzo e garantisce supporto.

Ultimo aggiornamento: 2026-09-02
Testato con: GroupDocs.Search 25.4 (Java)
Autore: GroupDocs

Tutorial correlati