MassIndexer (Hibernate Search ORM Integration 6.0.0.Beta4 API)

```
public interface MassIndexer
```
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

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`MassIndexer`	`batchSizeToLoadObjects(int batchSize)` Sets the batch size used to load the root entities.
`MassIndexer`	`cacheMode(CacheMode cacheMode)` Sets the cache interaction mode for the data loading tasks.
`MassIndexer`	`failureHandler(MassIndexingFailureHandler failureHandler)` Set the `MassIndexingFailureHandler`.
`MassIndexer`	`idFetchSize(int idFetchSize)` Specifies the fetch size to be used when loading primary keys if objects to be indexed.
`MassIndexer`	`limitIndexedObjectsTo(long maximum)` EXPERIMENTAL method: will probably change Will stop indexing after having indexed a set amount of objects.
`MassIndexer`	`mergeSegmentsAfterPurge(boolean enable)` Merge each index into a single segment after the initial index purge, just before indexing.
`MassIndexer`	`mergeSegmentsOnFinish(boolean enable)` Merge each index into a single segment after indexing.
`MassIndexer`	`monitor(MassIndexingMonitor monitor)` Set the `MassIndexingMonitor`.
`MassIndexer`	`purgeAllOnStart(boolean purgeAll)` If all entities should be removed from the index before starting using purgeAll.
`CompletableFuture<?>`	`start()` Starts the indexing process in background (asynchronous).
`void`	`startAndWait()` Starts the indexing process, and then block until it's finished.
`MassIndexer`	`threadsToLoadObjects(int numberOfThreads)` Set the number of threads to be used to load the root entities.
`MassIndexer`	`transactionTimeout(int timeoutInSeconds)` Timeout of transactions for loading ids and entities to be re-indexed.
`MassIndexer`	`typesToIndexInParallel(int threadsToIndexObjects)` Sets the number of entity types to be indexed in parallel.

- Method Detail
  - typesToIndexInParallel
```
MassIndexer 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
```
MassIndexer threadsToLoadObjects(int numberOfThreads)
```
    Set the number of threads to be used to load the root entities.
    
    Parameters:
    
    numberOfThreads - the number of threads
    
    Returns:
    
    this for method chaining
  - batchSizeToLoadObjects
```
MassIndexer batchSizeToLoadObjects(int batchSize)
```
    Sets the batch size used to load the root entities.
    
    Parameters:
    
    batchSize - the batch size
    
    Returns:
    
    this for method chaining
  - cacheMode
```
MassIndexer cacheMode(CacheMode cacheMode)
```
    Sets the cache interaction mode for the data loading tasks. Defaults to CacheMode.IGNORE.
    
    Parameters:
    
    cacheMode - the cache interaction mode
    
    Returns:
    
    this for method chaining
  - mergeSegmentsOnFinish
```
MassIndexer mergeSegmentsOnFinish(boolean enable)
```
    Merge 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
```
MassIndexer mergeSegmentsAfterPurge(boolean enable)
```
    Merge 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
  - purgeAllOnStart
```
MassIndexer purgeAllOnStart(boolean purgeAll)
```
    If all entities should be removed from the index before starting using purgeAll. Set it to false only if you know there are no entities in the index: otherwise search results may be duplicated. Defaults to true.
    
    Parameters:
    
    purgeAll - if true all entities will be removed from the index before starting the indexing
    
    Returns:
    
    this for method chaining
  - limitIndexedObjectsTo
```
MassIndexer limitIndexedObjectsTo(long maximum)
```
    EXPERIMENTAL method: will probably change Will stop indexing after having indexed a set amount of objects. As a results the index will not be consistent with the database: use only for testing on an (undefined) subset of database data.
    
    Parameters:
    
    maximum - the maximum number of objects to index
    
    Returns:
    
    this for method chaining
  - start
```
CompletableFuture<?> start()
```
    Starts the indexing process in background (asynchronous). Can be called only once.
    
    Returns:
    
    a Future to control the indexing task.
  - startAndWait
```
void startAndWait()
           throws InterruptedException
```
    Starts the indexing process, and then block until it's finished. Can be called only once.
    
    Throws:
    
    InterruptedException - if the current thread is interrupted while waiting.
  - idFetchSize
```
MassIndexer idFetchSize(int idFetchSize)
```
    Specifies the fetch size to be used when loading primary keys if objects to be indexed. Some databases accept special values, for example MySQL might benefit from using Integer.MIN_VALUE otherwise it will attempt to preload everything in memory.
    
    Parameters:
    
    idFetchSize - the fetch size to be used when loading primary keys
    
    Returns:
    
    this for method chaining
  - transactionTimeout
```
MassIndexer transactionTimeout(int timeoutInSeconds)
```
    Timeout of transactions for loading ids and entities to be re-indexed. Specify a timeout which is long enough to load and index all entities of the type with the most instances, taking into account the configured batch size and number of threads to load objects.
    Only supported in JTA-compatible environments.
    
    Parameters:
    
    timeoutInSeconds - the transaction timeout in seconds; If no value is given, the global default timeout of the JTA environment applies.
    
    Returns:
    
    this for method chaining
  - monitor
```
MassIndexer monitor(MassIndexingMonitor monitor)
```
    Set 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
```
MassIndexer failureHandler(MassIndexingFailureHandler failureHandler)
```
    Set 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

Interface MassIndexer

Method Summary

Method Detail

typesToIndexInParallel

threadsToLoadObjects

batchSizeToLoadObjects

cacheMode

mergeSegmentsOnFinish

mergeSegmentsAfterPurge

purgeAllOnStart

limitIndexedObjectsTo

start

startAndWait

idFetchSize

transactionTimeout

monitor

failureHandler