org.hibernate.search.spi

Interface SearchIntegrator

All Superinterfaces:

AutoCloseable

All Known Subinterfaces:

SearchFactoryImplementor, SearchFactoryImplementorWithShareableState, SearchFactoryIntegrator

All Known Implementing Classes:

ImmutableSearchFactory, MutableSearchFactory

public interface SearchIntegrator
extends AutoCloseable

This contract is considered experimental. This contract gives access to lower level APIs of Hibernate Search for frameworks integrating with it. Frameworks should not expose this as public API though, but expose a simplified view; for example the Hibernate Search ORM module expose the org.hibernate.search.SearchFactory contract to its clients.

Author:

Emmanuel Bernard

Method Summary

Methods

Modifier and Type	Method and Description
void	addClasses(Class<?>... classes) Add the following classes to the SearchFactory.
QueryContextBuilder	buildQueryBuilder()
void	close() Shuts down all workers and releases all resources.
HSQuery	createHSQuery() Return an Hibernate Search query object.
org.apache.lucene.analysis.Analyzer	getAnalyzer(Class<?> clazz) Retrieves the scoped analyzer for a given class.
org.apache.lucene.analysis.Analyzer	getAnalyzer(String name) Retrieve an analyzer instance by its definition name
TimeoutExceptionFactory	getDefaultTimeoutExceptionFactory() Useful if you need to create custom exception types to represent query timeouts.
ErrorHandler	getErrorHandler() Used to catch exceptions in all synchronous operations; but default they are logged, the user can configure alternative error management means.
EntityIndexBinding	getIndexBinding(Class<?> entityType) Returns the entity to index binding for the given type.
IndexedTypeDescriptor	getIndexedTypeDescriptor(Class<?> entityType) Returns a descriptor for the specified entity type describing its indexed state.
Set<Class<?>>	getIndexedTypes() Returns the set of currently indexed types.
IndexManager	getIndexManager(String indexName)
IndexReaderAccessor	getIndexReaderAccessor() Provides access to the IndexReader API
ServiceManager	getServiceManager() Returns the service manager.
Statistics	getStatistics() Retrieve the statistics instance for this factory.
Worker	getWorker() The Worker is the entry point to apply writes and updates to the indexes.
boolean	isStopped()
void	optimize() Optimize all indexes
void	optimize(Class entityType) Optimize the index holding entityType
<T> T	unwrap(Class<T> cls) Unwraps some internal Hibernate Search types.

Method Detail

getIndexBinding

EntityIndexBinding getIndexBinding(Class<?> entityType)

Returns the entity to index binding for the given type.

Parameters:

entityType - the type for which to retrieve the binding

Returns:

the entity to index binding for the given type. null is returned for types which are unindexed or unknown.

addClasses

void addClasses(Class<?>... classes)

Add the following classes to the SearchFactory. If these classes are new to the SearchFactory this will trigger a reconfiguration.

createHSQuery

HSQuery createHSQuery()

Return an Hibernate Search query object. This object uses fluent APIs to define the query executed. Offers a few execution approaches: - return the list of results eagerly - return the list of results lazily - get the number of results

isStopped

boolean isStopped()

Returns:

true if the SearchFactory was stopped

getErrorHandler

ErrorHandler getErrorHandler()

Used to catch exceptions in all synchronous operations; but default they are logged, the user can configure alternative error management means.

Returns:

the configured ErrorHandler, global to the SearchFactory

getDefaultTimeoutExceptionFactory

TimeoutExceptionFactory getDefaultTimeoutExceptionFactory()

Useful if you need to create custom exception types to represent query timeouts.

Returns:

the configured TimeoutExceptionFactory

optimize

void optimize()

Optimize all indexes

optimize

void optimize(Class entityType)

Optimize the index holding entityType

Parameters:

entityType - the entity type (index) to optimize

getAnalyzer

org.apache.lucene.analysis.Analyzer getAnalyzer(String name)

Retrieve an analyzer instance by its definition name

Parameters:

name - the name of the analyzer

Returns:

analyzer with the specified name

Throws:

SearchException - if the definition name is unknown

getAnalyzer

org.apache.lucene.analysis.Analyzer getAnalyzer(Class<?> clazz)

Retrieves the scoped analyzer for a given class.

Parameters:

clazz - The class for which to retrieve the analyzer.

Returns:

The scoped analyzer for the specified class.

Throws:

IllegalArgumentException - in case clazz == null or the specified class is not an indexed entity.

buildQueryBuilder

QueryContextBuilder buildQueryBuilder()

Returns:

return a query builder providing a fluent API to create Lucene queries

getStatistics

Statistics getStatistics()

Retrieve the statistics instance for this factory.

Returns:

The statistics.

getIndexReaderAccessor

IndexReaderAccessor getIndexReaderAccessor()

Provides access to the IndexReader API

Returns:

the IndexReaderAccessor for this SearchFactory

getIndexedTypeDescriptor

IndexedTypeDescriptor getIndexedTypeDescriptor(Class<?> entityType)

Returns a descriptor for the specified entity type describing its indexed state.

Parameters:

entityType - the entity for which to retrieve the descriptor

Returns:

a non null IndexedEntityDescriptor. This method can also be called for non indexed types. To determine whether the entity is actually indexed IndexedTypeDescriptor.isIndexed() can be used.

Throws:

IllegalArgumentException - in case entityType is null

getIndexedTypes

Set<Class<?>> getIndexedTypes()

Returns the set of currently indexed types.

Returns:

the set of currently indexed types. If no types are indexed the empty set is returned.

unwrap

<T> T unwrap(Class<T> cls)

Unwraps some internal Hibernate Search types. Currently, no public type is accessible. This method should not be used by users.

getServiceManager

ServiceManager getServiceManager()

Returns the service manager.

Returns:

Returns the service manager.

getWorker

Worker getWorker()

The Worker is the entry point to apply writes and updates to the indexes.

close

void close()

Shuts down all workers and releases all resources.

Specified by:

close in interface AutoCloseable

getIndexManager

IndexManager getIndexManager(String indexName)