Package org.hibernate.search.mapper.orm.mapping.impl

Class HibernateOrmMapping

java.lang.Object

org.hibernate.search.mapper.pojo.mapping.spi.AbstractPojoMappingImplementor<HibernateOrmMapping>

org.hibernate.search.mapper.orm.mapping.impl.HibernateOrmMapping

All Implemented Interfaces:

AutoCloseable, BackendMappingContext, MappingImplementor<HibernateOrmMapping>, AutomaticIndexingMappingContext, HibernateOrmListenerContextProvider, LoadingMappingContext, HibernateOrmMappingContext, SearchMapping, CoordinationStrategyContext, HibernateOrmMassIndexingMappingContext, HibernateOrmScopeMappingContext, HibernateOrmSearchSessionMappingContext, BatchMappingContext, BridgeMappingContext, PojoMassIndexingMappingContext, PojoScopeMappingContext, PojoSearchSessionMappingContext, PojoWorkMappingContext

public class HibernateOrmMapping
extends AbstractPojoMappingImplementor<HibernateOrmMapping>
implements SearchMapping, AutoCloseable, HibernateOrmMappingContext, HibernateOrmListenerContextProvider, BatchMappingContext, HibernateOrmScopeMappingContext, HibernateOrmSearchSessionMappingContext, AutomaticIndexingMappingContext, CoordinationStrategyContext

Method Summary

Modifier and Type	Method	Description
Collection<SearchIndexedEntity<?>>	allIndexedEntities()
ConfiguredSearchIndexingPlanFilter	applicationIndexingPlanFilter()
Backend	backend()
Backend	backend(String backendName)
CompletableFuture<?>	backgroundIndexingCompletion()
EntityLoadingCacheLookupStrategy	cacheLookupStrategy()
void	close()
ConfiguredSearchIndexingPlanFilter	configuredSearchIndexingPlanFilter(SearchIndexingPlanFilter filter)
CoordinationStrategy	coordinationStrategy()
static MappingImplementor<HibernateOrmMapping>	create(PojoMappingDelegate mappingDelegate, org.hibernate.search.mapper.orm.mapping.impl.HibernateOrmTypeContextContainer typeContextContainer, BeanHolder<? extends CoordinationStrategy> coordinationStrategyHolder, ConfiguredAutomaticIndexingStrategy configuredAutomaticIndexingStrategy, org.hibernate.engine.spi.SessionFactoryImplementor sessionFactory, ConfigurationPropertySource propertySource)
AutomaticIndexingQueueEventProcessingPlan	createIndexingQueueEventProcessingPlan(org.hibernate.Session session)
PojoMassIndexerAgent	createMassIndexerAgent(PojoMassIndexerAgentCreateContext context)	Creates a PojoMassIndexerAgent, able to exert control over other agents that could perform indexing concurrently (e.g.
<T> SearchScopeImpl<T>	createScope(Class<T> expectedSuperType, Collection<String> entityNames)
<T> SearchScopeImpl<T>	createScope(Collection<? extends Class<? extends T>> classes)
HibernateOrmSearchSession.Builder	createSessionBuilder(org.hibernate.engine.spi.SessionImplementor sessionImplementor)
ConfiguredIndexingPlanSynchronizationStrategy	currentAutomaticIndexingSynchronizationStrategy(org.hibernate.engine.spi.SessionImplementor session)
PojoIndexingPlan	currentIndexingPlanIfExisting(org.hibernate.engine.spi.SessionImplementor session)
PojoTypeIndexingPlan	currentIndexingPlanIfTypeIncluded(org.hibernate.engine.spi.SessionImplementor session, PojoRawTypeIdentifier<?> typeIdentifier)
protected void	doStop()
int	fetchSize()
BackendMappingHints	hints()
<E> SearchIndexedEntity<E>	indexedEntity(Class<E> entityType)
SearchIndexedEntity<?>	indexedEntity(String entityName)
void	indexingPlanFilter(SearchIndexingPlanFilter filter)	Set a filter defining which types must be included/excluded when indexed within indexing plans (either automatically or manually).
IndexManager	indexManager(String indexName)
boolean	listenerEnabled()
void	listenerEnabled(boolean enabled)
ProjectionMappedTypeContext	mappedTypeContext(String mappedTypeName)
CompletableFuture<?>	preStop(MappingPreStopContext context)	Prepare for MappingImplementor.stop(), executing any operations that needs to be executed before shutdown.
<T> SearchScope<T>	scope(Class<T> expectedSuperType, Collection<String> entityNames)	Create a SearchScope limited to entity types referenced by their name.
<T> SearchScope<T>	scope(Collection<? extends Class<? extends T>> types)	Create a SearchScope limited to the given types.
HibernateOrmScopeSessionContext	sessionContext(EntityManager entityManager)
org.hibernate.engine.spi.SessionFactoryImplementor	sessionFactory()
CompletableFuture<?>	start(MappingStartContext context)	Start any resource necessary to operate the mapping at runtime.
HibernateOrmMapping	toConcreteType()
EntityManagerFactory	toEntityManagerFactory()
org.hibernate.SessionFactory	toOrmSessionFactory()
org.hibernate.search.mapper.orm.mapping.impl.HibernateOrmTypeContextContainer	typeContextProvider()

Methods inherited from class org.hibernate.search.mapper.pojo.mapping.spi.AbstractPojoMappingImplementor

createIndexer, createIndexingPlan, createIndexingPlan, createIndexingQueueEventProcessingPlan, delegate, entityReferenceFactory, entityReferenceFactoryDelegate, failureHandler, identifierBridgeToDocumentIdentifierContext, projectionRegistry, stop, threadPoolProvider, toDocumentValueConvertContext, valueBridgeToIndexedValueContext

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.hibernate.search.mapper.orm.automaticindexing.spi.AutomaticIndexingMappingContext

entityReferenceFactory, failureHandler

Methods inherited from interface org.hibernate.search.engine.backend.mapping.spi.BackendMappingContext

entityReferenceFactory, projectionRegistry, toDocumentValueConvertContext

Methods inherited from interface org.hibernate.search.mapper.pojo.bridge.runtime.spi.BridgeMappingContext

identifierBridgeToDocumentIdentifierContext, valueBridgeToIndexedValueContext

Methods inherited from interface org.hibernate.search.mapper.orm.session.impl.HibernateOrmSearchSessionMappingContext

failureHandler

Methods inherited from interface org.hibernate.search.mapper.pojo.massindexing.spi.PojoMassIndexingMappingContext

entityReferenceFactoryDelegate, threadPoolProvider

Methods inherited from interface org.hibernate.search.mapper.pojo.scope.spi.PojoScopeMappingContext

entityReferenceFactoryDelegate

Methods inherited from interface org.hibernate.search.mapper.pojo.session.spi.PojoSearchSessionMappingContext

createIndexer, createIndexingPlan, createIndexingPlan, createIndexingQueueEventProcessingPlan

Methods inherited from interface org.hibernate.search.mapper.orm.mapping.SearchMapping

extension, scope, scope

Method Detail

create

public static MappingImplementor<HibernateOrmMapping> create(PojoMappingDelegate mappingDelegate,
                                                             org.hibernate.search.mapper.orm.mapping.impl.HibernateOrmTypeContextContainer typeContextContainer,
                                                             BeanHolder<? extends CoordinationStrategy> coordinationStrategyHolder,
                                                             ConfiguredAutomaticIndexingStrategy configuredAutomaticIndexingStrategy,
                                                             org.hibernate.engine.spi.SessionFactoryImplementor sessionFactory,
                                                             ConfigurationPropertySource propertySource)

close

public void close()

Specified by:

close in interface AutoCloseable

start

public CompletableFuture<?> start(MappingStartContext context)

Description copied from interface: MappingImplementor

Start any resource necessary to operate the mapping at runtime.

Called by the engine once during bootstrap, after backends and index managers were started.

Specified by:

start in interface MappingImplementor<HibernateOrmMapping>

Overrides:

start in class AbstractPojoMappingImplementor<HibernateOrmMapping>

Parameters:

context - The start context.

Returns:

A future that completes when the mapper is completely started.

preStop

public CompletableFuture<?> preStop(MappingPreStopContext context)

Description copied from interface: MappingImplementor

Prepare for MappingImplementor.stop(), executing any operations that needs to be executed before shutdown.

Specified by:

preStop in interface MappingImplementor<HibernateOrmMapping>

Overrides:

preStop in class AbstractPojoMappingImplementor<HibernateOrmMapping>

Parameters:

context - The pre-stop context.

Returns:

A future that completes when pre-stop operations complete.

doStop

protected void doStop()

Overrides:

doStop in class AbstractPojoMappingImplementor<HibernateOrmMapping>

hints

public BackendMappingHints hints()

Specified by:

hints in interface BackendMappingContext

Overrides:

hints in class AbstractPojoMappingImplementor<HibernateOrmMapping>

mappedTypeContext

public ProjectionMappedTypeContext mappedTypeContext(String mappedTypeName)

Specified by:

mappedTypeContext in interface BackendMappingContext

scope

public <T> SearchScope<T> scope(Collection<? extends Class<? extends T>> types)

Description copied from interface: SearchMapping

Create a SearchScope limited to the given types.

Specified by:

scope in interface SearchMapping

Type Parameters:

T - A supertype of all types to include in the scope.

Parameters:

types - A collection of types to include in the scope.

Returns:

The created scope.

See Also:

SearchScope

scope

public <T> SearchScope<T> scope(Class<T> expectedSuperType,
                                Collection<String> entityNames)

Description copied from interface: SearchMapping

Create a SearchScope limited to entity types referenced by their name.

Specified by:

scope in interface SearchMapping

Type Parameters:

T - A supertype of all entity types to include in the scope.

Parameters:

expectedSuperType - A supertype of all entity types to include in the scope.

entityNames - A collection of entity names. See Entity.name().

Returns:

The created scope.

See Also:

SearchScope

toEntityManagerFactory

public EntityManagerFactory toEntityManagerFactory()

Specified by:

toEntityManagerFactory in interface SearchMapping

Returns:

The underlying EntityManagerFactory used by this SearchMapping.

toOrmSessionFactory

public org.hibernate.SessionFactory toOrmSessionFactory()

Specified by:

toOrmSessionFactory in interface SearchMapping

Returns:

The underlying SessionFactory used by this SearchMapping.

indexedEntity

public <E> SearchIndexedEntity<E> indexedEntity(Class<E> entityType)

Specified by:

indexedEntity in interface SearchMapping

Type Parameters:

E - The type of an indexed entity.

Parameters:

entityType - The type of an indexed entity. This must be the exact type; passing the type of a mapped-superclass for example will not work.

Returns:

A SearchIndexedEntity for the indexed entity with the exact given type.

indexedEntity

public SearchIndexedEntity<?> indexedEntity(String entityName)

Specified by:

indexedEntity in interface SearchMapping

Parameters:

entityName - The name of an indexed entity. See Entity.name().

Returns:

A SearchIndexedEntity for the indexed entity with the given name.

allIndexedEntities

public Collection<SearchIndexedEntity<?>> allIndexedEntities()

Specified by:

allIndexedEntities in interface SearchMapping

Returns:

A collection containing one SearchIndexedEntity for each indexed entity

indexManager

public IndexManager indexManager(String indexName)

Specified by:

indexManager in interface SearchMapping

Parameters:

indexName - The name of an index. See Indexed.index().

Returns:

The index manager for the index having indexName as name.

backend

public Backend backend()

Specified by:

backend in interface SearchMapping

Returns:

The default backend, if any.

backend

public Backend backend(String backendName)

Specified by:

backend in interface SearchMapping

Parameters:

backendName - The name of a backend. See Indexed.backend().

Returns:

The backend having backendName as name.

indexingPlanFilter

public void indexingPlanFilter(SearchIndexingPlanFilter filter)

Description copied from interface: SearchMapping

Set a filter defining which types must be included/excluded when indexed within indexing plans (either automatically or manually).

This does not affect indexing that does not rely on indexing plans, like the mass indexer.

By default, all indexed and contained types are included.

Specified by:

indexingPlanFilter in interface SearchMapping

Parameters:

filter - The filter that includes/excludes types when indexed.

applicationIndexingPlanFilter

public ConfiguredSearchIndexingPlanFilter applicationIndexingPlanFilter()

Specified by:

applicationIndexingPlanFilter in interface HibernateOrmSearchSessionMappingContext

configuredSearchIndexingPlanFilter

public ConfiguredSearchIndexingPlanFilter configuredSearchIndexingPlanFilter(SearchIndexingPlanFilter filter)

Specified by:

configuredSearchIndexingPlanFilter in interface HibernateOrmSearchSessionMappingContext

toConcreteType

public HibernateOrmMapping toConcreteType()

Specified by:

toConcreteType in interface MappingImplementor<HibernateOrmMapping>

cacheLookupStrategy

public EntityLoadingCacheLookupStrategy cacheLookupStrategy()

Specified by:

cacheLookupStrategy in interface LoadingMappingContext

fetchSize

public int fetchSize()

Specified by:

fetchSize in interface LoadingMappingContext

sessionFactory

public org.hibernate.engine.spi.SessionFactoryImplementor sessionFactory()

Specified by:

sessionFactory in interface AutomaticIndexingMappingContext

Specified by:

sessionFactory in interface HibernateOrmMappingContext

Specified by:

sessionFactory in interface HibernateOrmMassIndexingMappingContext

Specified by:

sessionFactory in interface HibernateOrmSearchSessionMappingContext

Returns:

The Hibernate ORM SessionFactory.

sessionContext

public HibernateOrmScopeSessionContext sessionContext(EntityManager entityManager)

Specified by:

sessionContext in interface BatchMappingContext

Specified by:

sessionContext in interface HibernateOrmMassIndexingMappingContext

Specified by:

sessionContext in interface HibernateOrmScopeMappingContext

Specified by:

sessionContext in interface LoadingMappingContext

listenerEnabled

public boolean listenerEnabled()

Specified by:

listenerEnabled in interface HibernateOrmListenerContextProvider

listenerEnabled

public void listenerEnabled(boolean enabled)

backgroundIndexingCompletion

public CompletableFuture<?> backgroundIndexingCompletion()

createMassIndexerAgent

public PojoMassIndexerAgent createMassIndexerAgent(PojoMassIndexerAgentCreateContext context)

Description copied from interface: PojoMassIndexingMappingContext

Creates a PojoMassIndexerAgent, able to exert control over other agents that could perform indexing concurrently (e.g. indexing plans).

Specified by:

createMassIndexerAgent in interface PojoMassIndexingMappingContext

Parameters:

context - A context with information about the mass indexing that is about to start.

Returns:

An agent.

currentIndexingPlanIfExisting

public PojoIndexingPlan currentIndexingPlanIfExisting(org.hibernate.engine.spi.SessionImplementor session)

Specified by:

currentIndexingPlanIfExisting in interface HibernateOrmListenerContextProvider

currentIndexingPlanIfTypeIncluded

public PojoTypeIndexingPlan currentIndexingPlanIfTypeIncluded(org.hibernate.engine.spi.SessionImplementor session,
                                                              PojoRawTypeIdentifier<?> typeIdentifier)

Specified by:

currentIndexingPlanIfTypeIncluded in interface HibernateOrmListenerContextProvider

createIndexingQueueEventProcessingPlan

public AutomaticIndexingQueueEventProcessingPlan createIndexingQueueEventProcessingPlan(org.hibernate.Session session)

Specified by:

createIndexingQueueEventProcessingPlan in interface AutomaticIndexingMappingContext

Parameters:

session - A Hibernate ORM Session created from the same AutomaticIndexingMappingContext.sessionFactory() as this mapping.

Returns:

An event processing plan for the given session. It will not get executed automatically: you need to call AutomaticIndexingQueueEventProcessingPlan.executeAndReport(OperationSubmitter), which is asynchronous and returns a future.

currentAutomaticIndexingSynchronizationStrategy

public ConfiguredIndexingPlanSynchronizationStrategy currentAutomaticIndexingSynchronizationStrategy(org.hibernate.engine.spi.SessionImplementor session)

Specified by:

currentAutomaticIndexingSynchronizationStrategy in interface HibernateOrmListenerContextProvider

typeContextProvider

public org.hibernate.search.mapper.orm.mapping.impl.HibernateOrmTypeContextContainer typeContextProvider()

Specified by:

typeContextProvider in interface BatchMappingContext

Specified by:

typeContextProvider in interface HibernateOrmListenerContextProvider

Specified by:

typeContextProvider in interface HibernateOrmMassIndexingMappingContext

createScope

public <T> SearchScopeImpl<T> createScope(Collection<? extends Class<? extends T>> classes)

Specified by:

createScope in interface HibernateOrmSearchSessionMappingContext

createScope

public <T> SearchScopeImpl<T> createScope(Class<T> expectedSuperType,
                                          Collection<String> entityNames)

Specified by:

createScope in interface HibernateOrmSearchSessionMappingContext

createSessionBuilder

public HibernateOrmSearchSession.Builder createSessionBuilder(org.hibernate.engine.spi.SessionImplementor sessionImplementor)

Specified by:

createSessionBuilder in interface HibernateOrmSearchSessionMappingContext

coordinationStrategy

public CoordinationStrategy coordinationStrategy()

Specified by:

coordinationStrategy in interface CoordinationStrategyContext