Package org.hibernate.search.mapper.pojo.massindexing.spi

Interface PojoMassIndexer

public interface PojoMassIndexer

A MassIndexer is useful to rebuild the indexes from the data contained in the database. This process is expensive: all indexed entities and their indexedEmbedded properties are scrolled from database.

Author:

Sanne Grinovero

Method Summary

Modifier and Type	Method	Description
PojoMassIndexer	dropAndCreateSchemaOnStart(boolean dropAndCreateSchema)	Drops the indexes and their schema (if they exist) and re-creates them before indexing.
PojoMassIndexer	failureHandler(MassIndexingFailureHandler failureHandler)	Sets the MassIndexingFailureHandler.
PojoMassIndexer	mergeSegmentsAfterPurge(boolean enable)	Merges each index into a single segment after the initial index purge, just before indexing.
PojoMassIndexer	mergeSegmentsOnFinish(boolean enable)	Merges each index into a single segment after indexing.
PojoMassIndexer	monitor(MassIndexingMonitor monitor)	Sets the MassIndexingMonitor.
PojoMassIndexer	purgeAllOnStart(boolean purgeAll)	Removes all entities from the indexes before indexing.
CompletionStage<?>	start()	Starts the indexing process in background (asynchronous).
void	startAndWait()	Starts the indexing process, and then block until it's finished.
PojoMassIndexer	threadsToLoadObjects(int numberOfThreads)	Sets the number of threads to be used to load the root entities.
PojoMassIndexer	typesToIndexInParallel(int threadsToIndexObjects)	Sets the number of entity types to be indexed in parallel.

Method Detail

typesToIndexInParallel

PojoMassIndexer typesToIndexInParallel(int threadsToIndexObjects)

Sets the number of entity types to be indexed in parallel.

Defaults to 1.

Parameters:

threadsToIndexObjects - number of entity types to be indexed in parallel

Returns:

this for method chaining

threadsToLoadObjects

PojoMassIndexer threadsToLoadObjects(int numberOfThreads)

Sets the number of threads to be used to load the root entities.

Parameters:

numberOfThreads - the number of threads

Returns:

this for method chaining

mergeSegmentsOnFinish

PojoMassIndexer mergeSegmentsOnFinish(boolean enable)

Merges each index into a single segment after indexing.

Defaults to false.

Parameters:

enable - true to enable this operation, false to disable it.

Returns:

this for method chaining

mergeSegmentsAfterPurge

PojoMassIndexer mergeSegmentsAfterPurge(boolean enable)

Merges each index into a single segment after the initial index purge, just before indexing.

Defaults to true.

This setting has no effect if purgeAllOnStart is set to false.

Parameters:

enable - true to enable this operation, false to disable it.

Returns:

this for method chaining

dropAndCreateSchemaOnStart

PojoMassIndexer dropAndCreateSchemaOnStart(boolean dropAndCreateSchema)

Drops the indexes and their schema (if they exist) and re-creates them before indexing.

Indexes will be unavailable for a short time during the dropping and re-creation, so this should only be used when failures of concurrent operations on the indexes (automatic indexing, ...) are acceptable.

This should be used when the existing schema is known to be obsolete, for example when the Hibernate Search mapping changed and some fields now have a different type, a different analyzer, new capabilities (projectable, ...), etc.

This may also be used when the schema is up-to-date, since it can be faster than a purge on large indexes.

Defaults to false.

Parameters:

dropAndCreateSchema - if true the indexes and their schema will be dropped then re-created before starting the indexing

Returns:

this for method chaining

purgeAllOnStart

PojoMassIndexer purgeAllOnStart(boolean purgeAll)

Removes all entities from the indexes before indexing.

Set this to false only if you know there are no entities in the indexes: otherwise search results may be duplicated.

Defaults to true.

Parameters:

purgeAll - if true all entities will be removed from the indexes before starting the indexing

Returns:

this for method chaining

start

CompletionStage<?> start()

Starts the indexing process in background (asynchronous).

May only be called once.

Returns:

a CompletionStage to react to the completion of the indexing task. Call CompletionStage.toCompletableFuture() on the returned object to convert it to a CompletableFuture (which implements Future).

startAndWait

void startAndWait()
           throws InterruptedException

Starts the indexing process, and then block until it's finished.

May only be called once.

Throws:

InterruptedException - if the current thread is interrupted while waiting.

monitor

PojoMassIndexer monitor(MassIndexingMonitor monitor)

Sets the MassIndexingMonitor.

The default monitor just logs the progress.

Parameters:

monitor - The monitor that will track mass indexing progress.

Returns:

this for method chaining

failureHandler

PojoMassIndexer failureHandler(MassIndexingFailureHandler failureHandler)

Sets the MassIndexingFailureHandler.

The default handler just forwards failures to the background failure handler.

Parameters:

failureHandler - The handler for failures occurring during mass indexing.

Returns:

this for method chaining