13.4.3. Reconstruction de l'index

Cette stratégie consiste à retirer l'index existant puis à y ajouter à nouveau toutes les entités à l'aide de FullTextSession.purgeAll() et FullTextSession.index(). Il existe cependant quelques contraintes de mémoire et d'efficacité. Pour garantir une plus grande efficacité, Hibernate Search regroupe les opérations d'index et les exécute au moment de la validation. Si un grand nombre de données doit être indexé, veuiller faire attention à la consommation de la mémoire puisque tous les documents seront placés dans une file d'attente jusqu'à la validation de la transaction. Une erreur intitulée OutOfMemoryException peut apparaître si vous ne videz pas la file d'attente régulièrement, ce que vous pouvez faire à l'aide de fullTextSession.flushToIndexes(). À chaque application de la méthode fullTextSession.flushToIndexes() (ou lorsque la transaction est validée), la file d'attente est traitée et les modifications d'index sont appliquées. Veuillez noter qu'une fois le vidage effectué, les modifications sont irréversibles.

fullTextSession.setFlushMode(FlushMode.MANUAL);
fullTextSession.setCacheMode(CacheMode.IGNORE);
transaction = fullTextSession.beginTransaction();
//Scrollable results will avoid loading too many objects in memory
ScrollableResults results = fullTextSession.createCriteria( Email.class )
    .setFetchSize(BATCH_SIZE)
    .scroll( ScrollMode.FORWARD_ONLY );
int index = 0;
while( results.next() ) {
    index++;
    fullTextSession.index( results.get(0) ); //index each element
    if (index % BATCH_SIZE == 0) {
        fullTextSession.flushToIndexes(); //apply changes to indexes
        fullTextSession.clear(); //free memory since the queue is processed
    }
}
transaction.commit();

Utilisez si possible une taille de lot qui garantit que votre application ait suffisamment de mémoire : une taille de lot plus importante permet aux objets d'être récupérés plus rapidement depuis la base de données mais elle utilise aussi plus de mémoire.