Exemple de recherche en texte intégral en Java avec GroupDocs.Search
Si vous avez besoin d’un full text search example qui fonctionne sur les PDF, les fichiers Word, les feuilles de calcul et bien plus, vous êtes au bon endroit. Analyser manuellement des milliers de documents constitue un goulet d’étranglement majeur, mais GroupDocs.Search for Java automatise l’indexation et les requêtes avec une vitesse fulgurante. Dans ce tutoriel, nous passerons en revue tout ce dont vous avez besoin pour démarrer — de l’ajout de documents à l’index, à la création d’instructions de requête booléenne en Java, jusqu’à l’optimisation des performances de recherche pour des charges de travail en production.
Réponses rapides
- What is full text search example? Il indexe le texte brut de chaque document afin que vous puissiez interroger n’importe quel mot ou phrase instantanément.
- Which library supports multiple formats? GroupDocs.Search for Java gère PDF, DOCX, XLSX, PPTX, HTML, TXT et plus de 50 autres types de fichiers.
- How do I add documents to index? Appelez la méthode
index.add()avec un chemin de dossier ou unDocumentFilterpersonnalisé. - Can I run Boolean queries? Oui — combinez les termes avec AND, OR, NOT pour des résultats précis.
- How do I improve performance? Utilisez l’indexation incrémentielle, activez le cache des résultats et désactivez la recherche phonétique sauf si nécessaire.
Qu’est-ce qu’un exemple de recherche en texte intégral ?
Un full text search example vous permet de parcourir l’ensemble du contenu textuel des documents, de le stocker dans un index efficace et de récupérer les enregistrements correspondants instantanément. Contrairement aux recherches basées uniquement sur le nom de fichier, il examine l’intérieur des PDF, des documents Word, des feuilles de calcul et d’autres formats pris en charge, ce qui le rend idéal pour les systèmes de gestion de documents, les portails d’assistance et toute application où les utilisateurs doivent localiser rapidement l’information.
Pourquoi utiliser GroupDocs.Search pour Java ?
GroupDocs.Search for Java offre une prise en charge multi‑format pour plus de 50 types de fichiers, dont PDF, DOCX, XLSX, PPTX, HTML et texte brut. Il passe à l’échelle de millions de fichiers tout en maintenant une faible consommation de mémoire en stockant l’index sur disque. La bibliothèque comprend un langage de requête avancé avec des recherches booléennes, floues et phonétiques intégrées, et s’intègre via une seule dépendance Maven, vous permettant de commencer l’indexation en quelques minutes.
Prérequis
Avant de commencer, assurez‑vous d’avoir :
- Java 11+ (Java 8 fonctionne, mais Java 11 ou supérieur est recommandé pour de meilleures performances).
- Maven pour la gestion des dépendances.
- Une licence GroupDocs.Search (une clé d’essai gratuite suffit pour le développement).
Bibliothèques et dépendances requises
Ajoutez le dépôt et la dépendance à votre 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>
Pour un usage détaillé, consultez la documentation.
Configuration de l’environnement
- Installez le JDK (8 ou plus récent) et configurez
JAVA_HOME. - Utilisez un IDE tel qu’IntelliJ IDEA ou Eclipse pour faciliter le débogage.
Prérequis de connaissances
- Concepts de base de la programmation Java.
- Familiarité avec la structure
pom.xmlde Maven.
Configuration de GroupDocs.Search pour Java
Vous pouvez intégrer la bibliothèque via Maven (voir ci‑dessus) ou télécharger le JAR manuellement.
Téléchargement direct (si vous préférez une configuration manuelle)
Récupérez le dernier package depuis les GroupDocs.Search for Java releases.
Étapes d’obtention de licence
- Free trial – Inscrivez‑vous et recevez une clé temporaire.
- Temporary license – Demandez une clé à plus long terme pour des tests étendus.
- Purchase – Passez à une licence commerciale complète lorsque vous êtes prêt pour la production.
Initialisation et configuration de base
Créez un dossier d’index sur disque et vérifiez que la bibliothèque se charge correctement :
import com.groupdocs.search.Index;
public class SearchSetup {
public static void main(String[] args) {
// Initialize an index in the specified directory
Index index = new Index("C:\\MyIndex");
System.out.println("GroupDocs.Search initialized!");
}
}
Pro tip : Conservez le répertoire d’index sur un SSD rapide afin de minimiser la latence des requêtes.
Ajout de documents à l’index
Why this matters : Aucun résultat de recherche n’est possible sans contenu indexé. Vous trouverez ci‑dessous comment ajouter des dossiers entiers ou filtrer des types de fichiers spécifiques.
Étape 1 : créer un index
La classe Index est le conteneur recherchable qui stocke les documents indexés sur disque.
Index index = new Index("C:\\MyIndex");
Étape 2 : ajouter des documents (add documents to index)
Vous pouvez indexer tout le contenu d’un dossier ou limiter aux extensions souhaitées à l’aide d’un DocumentFilter.
index.add("C:\\Documents\\*.*"); // Adds all documents from the specified directory
// For specific file types, use:
index.add("C:\\Reports", new DocumentFilter() {
@Override
public boolean accept(String fileName) {
return fileName.endsWith(".pdf") || fileName.endsWith(".docx");
}
});
Explanation :
Indexreprésente la base de données recherchable.add()ingère les fichiers ; le joker*.*récupère tous les fichiers, tandis queDocumentFiltervous permet d’ajuster finement l’étape add documents to index.
Effectuer une recherche (search documents java)
Maintenant que l’index contient des données, vous pouvez l’interroger.
Étape 1 : créer une requête
String query = "GroupDocs";
Étape 2 : exécuter la recherche
SearchResult result = index.search(query);
System.out.println("Documents found: " + result.getDocumentCount());
Explanation :
search()exécute la requête sur l’index.getDocumentCount()indique le nombre de documents correspondants — utile pour des vérifications rapides.
Techniques de requête avancées (boolean query java)
Pour un contrôle précis, combinez les termes avec la logique booléenne.
Requêtes booléennes
La classe BooleanQuery vous permet de construire des expressions complexes en utilisant les opérateurs AND, OR, NOT.
String booleanQuery = "GroupDocs AND Java";
SearchResult booleanResult = index.search(booleanQuery);
Recherches phonétiques (optionnel pour correspondance floue)
La fonctionnalité PhoneticSearch active la correspondance phonétique pour les termes mal orthographiés, mais elle ajoute une surcharge.
index.getSettings().setPhoneticSearch(true);
When to use : Activez la recherche phonétique uniquement si les utilisateurs se trompent fréquemment dans l’orthographe ; sinon, désactivez‑la pour optimize search performance.
Problèmes courants et solutions
| Problème | Pourquoi cela se produit | Solution |
|---|---|---|
| Missing documents | Chemin de fichier incorrect ou permissions insuffisantes | Vérifiez le chemin et accordez les droits de lecture |
| Slow queries | Index volumineux sans cache ou recherche phonétique inutile | Activez le cache, désactivez la recherche phonétique, et envisagez de scinder l’index |
| Out‑of‑Memory errors | Taille de l’index dépasse le heap JVM | Augmentez -Xmx ou utilisez l’indexation incrémentielle |
Applications pratiques
GroupDocs.Search brille dans des scénarios réels :
- Systèmes de gestion de contenu – Fournissez une recherche en texte intégral instantanée sur les articles, PDF et actifs multimédias.
- Portails d’assistance client – Les agents peuvent localiser les manuels ou politiques pertinents en quelques secondes.
- Répertoires d’entreprise – Recherchez parmi les contrats, rapports et documents de conformité sans déplacer les données vers une base de données distincte.
Considérations de performance
Optimisation des performances de recherche
- Indexation incrémentielle : Ajoutez ou mettez à jour uniquement les fichiers modifiés au lieu de reconstruire l’ensemble de l’index.
- Caching : Conservez les résultats de requêtes fréquemment utilisées en mémoire.
- Surveillance des ressources : Ajustez le heap JVM (
-Xmx2gou plus) en fonction de la taille de l’index.
Directives d’utilisation des ressources
- Stockez le dossier d’index sur un SSD ou un disque NVMe rapide.
- Surveillez le CPU et la mémoire pendant l’indexation massive ; limitez les opérations par lots pour éviter les pics.
Bonnes pratiques pour la gestion de la mémoire Java
- Utilisez
try‑with‑resourceslors de la manipulation de flux. - Nullifiez les gros objets après usage pour faciliter le ramassage des ordures.
Conclusion
Vous disposez désormais d’un full text search example complet et prêt pour la production en Java avec GroupDocs.Search. De la configuration de la bibliothèque, adding documents to index, à la rédaction d’instructions boolean query java, en passant par optimizing search performance, chaque étape est couverte.
Prochaines étapes
Explorez des fonctionnalités plus avancées telles que les analyseurs personnalisés, les dictionnaires de synonymes et l’intégration au stockage cloud en consultant la documentation officielle GroupDocs.Search Documentation.
Questions fréquemment posées
Q : Quels formats de fichiers GroupDocs.Search prend‑il en charge ?
R : Plus de 50 formats, dont PDF, DOCX, XLSX, PPTX, HTML, TXT et de nombreux types d’images.
Q : Comment gérer de grands ensembles de données ?
R : Divisez‑les en plusieurs index, mettez‑les à jour de façon incrémentielle et activez le cache des résultats pour maintenir une faible latence.
Q : GroupDocs.Search peut‑il fonctionner dans des environnements cloud ?
R : Oui—vous pouvez pointer le dossier d’index vers un stockage cloud monté (par ex., Azure Blob, AWS S3 via un pilote système de fichiers).
Q : Quels sont les avantages de GroupDocs.Search par rapport à d’autres bibliothèques ?
R : Prise en charge multi‑format, requêtes booléennes/phonétiques intégrées, et une API Java légère qui traite des millions de documents avec un faible empreinte mémoire.
Q : Comment dépanner les problèmes de performance ?
R : Examinez les paramètres d’index, désactivez la recherche phonétique si elle n’est pas nécessaire, et surveillez l’utilisation de la mémoire/CPU JVM pendant l’indexation et les requêtes.
Last Updated: 2026-08-15
Tested With: GroupDocs.Search 25.4
Author: GroupDocs
Ressources
- Documentation : GroupDocs.Search Documentation
- API reference : API Reference Guide
- Download : Latest Releases
- GitHub : Source Code on GitHub
- Support : Forum and Community Support
- License : Request a Temporary License