Comment ajouter un dossier à l’index avec GroupDocs.Search en Java
Si vous avez besoin d’java full text search capable de s’adapter à des millions de documents, vous êtes au bon endroit. Dans ce tutoriel, vous apprendrez comment add folder to index en utilisant GroupDocs.Search, configurer un stockage à haute compression et exécuter des requêtes ultra‑rapides. À la fin, vous disposerez d’une solution prête pour la production que vous pourrez intégrer à n’importe quel projet Java.
Réponses rapides
- Quelle est la bibliothèque principale ? GroupDocs.Search for Java
- Comment ajouter un dossier à l’index ? Use
index.add(folderPath) - Puis-je configurer la compression du texte ? Yes, via
TextStorageSettings(Compression.High) - Quelle version de Java est requise ? JDK 8 or higher
- Où obtenir une licence d’essai ? From the GroupDocs website or the repository page
Qu’est-ce que le java full text search et pourquoi est‑il important ?
Le java full text search convertit les documents bruts en un index inversé, permettant une récupération en moins d’une seconde de n’importe quel terme parmi des milliers de fichiers. Cette capacité est essentielle pour les dépôts juridiques, les bibliothèques de recherche et les bases de connaissances d’entreprise où les utilisateurs attendent des résultats instantanés. Elle améliore également la productivité des applications modernes.
Pourquoi utiliser groupdocs.search pour le java full text search ?
GroupDocs.Search offre un indexage à haut débit et une exécution de requêtes rapide tout en proposant une compression élevée intégrée. Il prend en charge plus de 50 formats d’entrée et de sortie — y compris PDF, DOCX, EML et HTML — et peut traiter des documents de plusieurs centaines de pages sans charger le fichier complet en mémoire, maintenant l’empreinte mémoire sous 200 Mo pour des charges de travail typiques.
Prérequis
- GroupDocs.Search for Java (version 25.4 ou ultérieure) – la bibliothèque principale qui alimente l’indexation et la recherche.
- JDK 8+ installé et configuré – le runtime minimum requis pour le SDK.
- Maven pour la gestion des dépendances – simplifie l’ajout de la bibliothèque à votre projet.
- Un IDE tel que IntelliJ IDEA ou Eclipse – pour écrire et déboguer du code Java.
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
Alternatively, download the latest version from GroupDocs.Search for Java releases.
Acquisition de licence
- Essai gratuit – explorez toutes les fonctionnalités sans engagement.
- Licence temporaire – période de test prolongée.
- Achat – débloquez toutes les capacités de production.
Initialisation et configuration de base
Index est la classe principale utilisée pour créer, ouvrir et gérer un index de recherche.
import com.groupdocs.search.Index;
public class InitializeSearch {
public static void main(String[] args) {
// Path to store index data
String indexPath = "path/to/index";
// Creating an index at specified location
Index index = new Index(indexPath);
System.out.println("GroupDocs.Search initialized successfully!");
}
}
Indexer le texte avec compression personnalisée
Étape 1 : définir le dossier d’index
Choisissez un répertoire où les fichiers d’index seront stockés :
String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output\\AdvancedUsage\\Indexing\\StoringTextOfIndexedDocuments";
Étape 2 : configurer les paramètres de l’index
TextStorageSettings configure la façon dont le texte est stocké dans l’index, y compris le niveau de compression. Compression est une énumération qui spécifie l’algorithme de compression souhaité.
import com.groupdocs.search.Index;
import com.groupdocs.search.IndexSettings;
import com.groupdocs.search.options.TextStorageSettings;
import com.groupdocs.search.compression.Compression;
IndexSettings settings = new IndexSettings();
settings.setTextStorageSettings(new TextStorageSettings(Compression.High));
Étape 3 : créer l’index avec des paramètres personnalisés
Instanciez l’index en utilisant la configuration définie ci‑dessus :
Index index = new Index(indexFolder, settings);
System.out.println("Index created with high compression.");
Comment ajouter un dossier à l’index
Index est la classe principale représentant l’index searchable.
Chargez l’index existant (ou créez‑en un nouveau) puis appelez la méthode add sur l’objet Index. L’opération add parcourt le répertoire fourni, extrait le texte de chaque fichier pris en charge et le stocke dans l’index compressé, prêt pour une recherche instantanée.
String documentsFolder = "YOUR_DOCUMENT_DIRECTORY"; // Replace with actual document path.
Index index = new Index(indexFolder);
Comment rechercher des documents indexés
SearchResult représente une correspondance unique avec le chemin du document et la pertinence.
Définissez une chaîne de requête de recherche qui représente le terme ou la phrase que vous souhaitez localiser, puis invoquez la méthode search sur l’instance Index. La méthode renvoie une collection d’objets SearchResult, chacun contenant le chemin du document, le score de pertinence et un extrait mettant en évidence la correspondance.
index.add(documentsFolder);
System.out.println("Documents added successfully.");
Applications pratiques
Scénarios réels où le java full text search excelle :
- Gestion de documents juridiques – récupération instantanée des dossiers de cas.
- Bibliothèques de recherche académique – recherche rapide d’articles et de thèses.
- Bases de connaissances d’entreprise – accès rapide aux manuels et FAQ.
- Systèmes de gestion de contenu – découverte efficace de contenu pour les grands sites.
- Archives du service client – recherche rapide des tickets et chats passés.
Considérations de performance
- Compression vs. vitesse : une compression élevée économise jusqu’à 70 % d’espace disque mais ajoute un léger surcoût d’indexation ; effectuez des tests de performance pour votre volume de données.
- Gestion de la mémoire : allouez au moins 2 Go de heap pour les index supérieurs à 10 Go afin d’éviter
OutOfMemoryError. - Mises à jour de l’index : ajoutez de nouveaux documents de façon incrémentielle avec
index.add()et appelez périodiquementindex.optimize()pour garder l’index compact. - Optimisation des requêtes : utilisez la syntaxe de requête avancée (joker, proximité, recherche floue) pour affiner les résultats et réduire le temps de réponse.
Pièges courants & astuces professionnelles
Piège : Oublier d’appeler
index.optimize()après des ajouts massifs.
Astuce : Exécutezindex.optimize()chaque nuit pour garder l’index compact.Piège : Utiliser la compression par défaut (faible) sur des ensembles de données massifs.
Astuce : Passez àCompression.Highpour les environnements de production afin de réduire les coûts de stockage.Piège : Ne pas gérer
IOExceptionlors de l’ajout de fichiers depuis un partage réseau.
Astuce : Enveloppezindex.add()dans un bloc try‑catch et consignez les échecs pour une révision ultérieure.
Questions fréquemment posées
Q : Qu’est‑ce que GroupDocs.Search ?
R : C’est une bibliothèque Java robuste qui offre des capacités avancées de recherche en texte intégral, incluant l’indexation, la compression et le support de requêtes complexes.
Q : Comment gérer de grands ensembles de données avec GroupDocs.Search ?
R : Activez la haute compression (Compression.High) et validez périodiquement les modifications pour garder l’index léger. De plus, allouez suffisamment de mémoire heap (par ex., 4 Go pour les index supérieurs à 20 Go).
Q : Puis‑je intégrer GroupDocs.Search aux systèmes d’entreprise existants ?
R : Oui, la bibliothèque peut être intégrée à tout backend Java, services REST ou architecture de micro‑services.
Q : Que faire si mon index devient obsolète ?
R : Utilisez la méthode index.add() pour ajouter de nouveaux fichiers et index.delete() pour supprimer les anciens, puis relancez index.optimize() si nécessaire.
Q : Où puis‑je obtenir de l’aide ou du support ?
R : Consultez le forum communautaire sur GroupDocs forums pour le dépannage et les meilleures pratiques.
Ressources supplémentaires
- Guide d’utilisation détaillé : GroupDocs Search Documentation
- Référence complète de l’API : API Reference Guide
- Restez à jour avec les nouvelles fonctionnalités : Latest Releases
Last Updated: 2026-11-02
Tested With: GroupDocs.Search 25.4
Author: GroupDocs
String query = "sample";
import com.groupdocs.search.results.SearchResult;
SearchResult result = index.search(query);
System.out.println("Search completed. Results found: " + result.getDocumentCount());