Créer un index de recherche GroupDocs avec GroupDocs.Search pour Java - Guide complet

Si vous devez créer un index de recherche groupdocs dans une application Java, vous êtes au bon endroit. Dans ce tutoriel, nous parcourrons l’ensemble du processus d’installation de GroupDocs.Search, de création d’un index, d’ajout de fichiers et de récupération du texte des documents — le tout avec du code clair, étape par étape, que vous pouvez copier directement dans votre projet. À la fin, vous saurez exactement comment indexer des documents en Java et serez prêt à intégrer des capacités de recherche puissantes dans toute solution d’entreprise.

Réponses rapides

  • Quel est le but principal de GroupDocs.Search ?
    Fournir un indexage et une récupération en texte intégral rapides pour un large éventail de formats de documents en Java.
  • Quelle version de la bibliothèque est recommandée ?
    La dernière version stable (par ex., 25.4 au moment de la rédaction).
  • Ai‑je besoin d’une licence pour exécuter les exemples ?
    Une licence temporaire est disponible pour l’évaluation ; une licence commerciale est requise pour la production.
  • Quelles sont les étapes principales pour créer un index de recherche ?
    Installer la bibliothèque, configurer les paramètres de l’index, ajouter des documents et interroger l’index.
  • Puis‑je stocker le texte indexé sous forme compressée ?
    Oui – utilisez TextStorageSettings avec Compression.High.

Comment créer un index de recherche groupdocs avec GroupDocs.Search pour Java

Créer un index interrogeable est la base de toute solution de recherche rapide. Ci-dessous, nous décomposons le processus en étapes simples, expliquons le « pourquoi » de chaque action et présentons le code exact dont vous avez besoin.

Qu’est‑ce que « créer un index de recherche groupdocs » ?

Créer un index de recherche avec GroupDocs consiste à construire une structure de données interrogeable qui associe chaque mot de vos documents à son emplacement. Cela permet des recherches instantanées de mots‑clés, des recherches de phrases et un filtrage avancé sans analyser les fichiers originaux à chaque fois.

Pourquoi utiliser GroupDocs.Search pour Java ?

  • Large prise en charge des formats – PDFs, Word, Excel, PowerPoint, et bien d’autres.
  • Haute performance – Des algorithmes d’indexation optimisés maintiennent une latence de recherche faible même avec des millions de fichiers.
  • Intégration facile – API Java simple, gestion des dépendances basée sur Maven et documentation claire.

Prérequis

Bibliothèques et dépendances requises

  • Java Development Kit (JDK) 8 ou supérieur.
  • Maven pour la gestion des dépendances.

Exigences de configuration de l’environnement

Assurez‑vous que Maven est correctement configuré pour télécharger les artefacts depuis le dépôt GroupDocs.

Prérequis de connaissances

Une programmation Java de base, la familiarité avec les entrées/sorties de fichiers et une compréhension des concepts d’indexation vous aideront à suivre facilement.

Configuration de GroupDocs.Search pour Java

Configuration Maven

Ajoutez le dépôt et la dépendance à votre fichier 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>

Téléchargement direct

Sinon, téléchargez la dernière version depuis GroupDocs.Search for Java releases.

Acquisition de licence

Vous pouvez obtenir une licence temporaire pour explorer pleinement les fonctionnalités de GroupDocs avant l’achat en visitant leur Temporary License page. Cette période d’essai vous permet d’évaluer la bibliothèque dans votre environnement.

Initialisation et configuration de base

Commencez par créer un objet Index qui pointe vers le dossier où les fichiers d’index seront stockés :

String indexFolder = "YOUR_INDEX_DIRECTORY";
Index index = new Index(indexFolder);

Guide d’implémentation

Comment indexer des documents Java avec GroupDocs.Search

Vue d’ensemble

Créer un index est la première étape pour activer des capacités de recherche rapides. Ci-dessous, nous parcourons chaque action requise.

Étape 1 : Spécifier les répertoires

Définissez où l’index sera stocké et où se trouvent les documents source.

String indexFolder = "YOUR_INDEX_DIRECTORY";
String documentsFolder = "YOUR_DOCUMENTS_DIRECTORY";

Étape 2 : Créer un index

Instanciez l’objet Index pour commencer à construire la structure interrogeable.

Index index = new Index(indexFolder);

Étape 3 : Ajouter des documents à l’index

Alimentez tous les fichiers du dossier source dans l’index avec un appel unique.

index.add(documentsFolder);

Étape 4 : Récupérer les documents indexés

Une fois l’indexation terminée, vous pouvez énumérer les entrées indexées :

DocumentInfo[] documents = index.getIndexedDocuments();
for (DocumentInfo document : documents) {
    String filePath = document.getFilePath();
    // Process each file path or perform further actions here
}

Paramètres & objectifs des méthodes

  • indexFolder : Chemin où les données d’index sont stockées.
  • documentsFolder : Répertoire contenant les fichiers à indexer.

Conseils de dépannage

  • Vérifiez que les chemins des dossiers sont corrects et accessibles.
  • Vérifiez les permissions du système de fichiers si vous rencontrez des erreurs « access denied » lors de l’indexation.

Création d’un index avec les paramètres de stockage du texte

Vue d’ensemble

Vous pouvez affiner la façon dont le texte brut de chaque document est stocké, par exemple en activant une compression élevée pour réduire l’utilisation du disque.

Étape 1 : Configurer les paramètres de l’index

Créez une instance IndexSettings et configurez le stockage du texte.

IndexSettings settings = new IndexSettings();
settings.setTextStorageSettings(new TextStorageSettings(Compression.High));

Étape 2 : Initialiser l’index avec les paramètres

Passez les paramètres personnalisés lors de la construction de l’index.

Index index = new Index(indexFolder, settings);

Étape 3 : Récupérer et stocker les textes des documents

Extrayez le texte complet d’un document et enregistrez‑le au format HTML (ou tout autre format pris en charge).

DocumentInfo[] documents = index.getIndexedDocuments();
if (documents.length > 0) {
    String outputPath = "YOUR_OUTPUT_DIRECTORY/Text.html";
    FileOutputAdapter outputAdapter = new FileOutputAdapter(OutputFormat.Html, outputPath);
    index.getDocumentText(documents[0], outputAdapter);
}

Options de configuration clés

  • Compression.High – Optimise le stockage en compressant le texte extrait.

Applications pratiques

  1. Gestion documentaire d’entreprise – Localisez rapidement contrats, politiques ou rapports dans d’immenses dépôts.
  2. Systèmes de gestion de contenu (CMS) – Alimentez la recherche sur l’ensemble du site avec des résultats instantanés.
  3. Gestion de documents juridiques – Permettez la découverte basée sur des mots‑clés à travers les dossiers de cas et les archives de preuves.

Considérations de performance

  • Optimisation de la taille de l’index – Élaguer périodiquement les entrées obsolètes pour garder l’index léger.
  • Gestion de la mémoire – Ajustez le ramasse‑miettes de la JVM pour les travaux d’indexation à grande échelle.
  • Bonnes pratiques – Indexez par lots, réutilisez les instances Index et privilégiez les opérations asynchrones pour les charges lourdes.

Problèmes courants et solutions

SymptômeCause probableSolution
“Accès refusé” lors de l’appel à index.add()Permissions de dossier incorrectesAccorder les droits de lecture/écriture à l’utilisateur du processus
Aucun résultat retourné pour un terme connuStockage du texte non activéActiver TextStorageSettings ou ré‑indexer avec les paramètres appropriés
Erreurs de mémoire insuffisante sur de gros lotsTaille du tas JVM trop petiteAugmenter le drapeau -Xmx ou traiter les documents par morceaux plus petits

Questions fréquemment posées

  1. Qu’est‑ce que GroupDocs.Search pour Java ?
    Une bibliothèque puissante qui permet aux développeurs d’ajouter des fonctionnalités de recherche en texte intégral à leurs applications Java de manière efficace.
  2. Comment gérer de grands ensembles de données avec GroupDocs.Search ?
    Utilisez le traitement par lots et optimisez les paramètres de votre index pour gérer les ressources efficacement.
  3. Puis‑je personnaliser le niveau de compression dans les paramètres de stockage du texte ?
    Oui, vous pouvez définir différents niveaux de compression comme Compression.High ou Compression.Low.
  4. Quels types de documents GroupDocs.Search prend‑il en charge ?
    Il prend en charge un large éventail de formats, y compris les PDFs, fichiers Word, feuilles de calcul Excel, présentations PowerPoint et bien d’autres.
  5. Existe‑t‑il un support communautaire pour GroupDocs.Search ?
    Oui, vous pouvez accéder à un support gratuit via leur forum à GroupDocs Forum.

Ressources

En utilisant les ressources fournies et en expérimentant différentes configurations, vous pouvez approfondir votre compréhension et votre utilisation de GroupDocs.Search pour Java. Bon codage !

Dernière mise à jour : 2026-03-09
Testé avec : GroupDocs.Search 25.4
Auteur : GroupDocs