org.hibernate.search.engine.spi

Class DocumentBuilderIndexedEntity<T>

java.lang.Object

org.hibernate.search.engine.spi.AbstractDocumentBuilder<T>

org.hibernate.search.engine.spi.DocumentBuilderIndexedEntity<T>

public class DocumentBuilderIndexedEntity<T>
extends AbstractDocumentBuilder<T>

Set up and provide a manager for classes which are directly annotated with @Indexed.

Author:

Gavin King, Emmanuel Bernard, Sylvain Vieujot, Richard Hallier, Hardy Ferentschik

Field Summary

Fields inherited from class org.hibernate.search.engine.spi.AbstractDocumentBuilder

entityState

Constructor Summary

Constructors

Constructor and Description

DocumentBuilderIndexedEntity(org.hibernate.annotations.common.reflection.XClass clazz, TypeMetadata typeMetadata, ConfigContext context, org.hibernate.annotations.common.reflection.ReflectionManager reflectionManager, Set<org.hibernate.annotations.common.reflection.XClass> optimizationBlackList, InstanceInitializer instanceInitializer) Creates a document builder for entities annotated with @Indexed.

Method Summary

Methods

Modifier and Type	Method and Description
void	addWorkToQueue(Class<T> entityClass, T entity, Serializable id, boolean delete, boolean add, List<LuceneWork> queue, ConversionContext contextualBridge)
boolean	allowFieldSelectionInProjection()
AddLuceneWork	createAddWork(Class<T> entityClass, T entity, Serializable id, String idInString, InstanceInitializer sessionInitializer, ConversionContext conversionContext)
UpdateLuceneWork	createUpdateWork(Class<T> entityClass, T entity, Serializable id, String idInString, InstanceInitializer sessionInitializer, ConversionContext contextualBridge)
FieldBridge	getBridge(String fieldName)
org.apache.lucene.document.Document	getDocument(T instance, Serializable id, Map<String,String> fieldToAnalyzerMap, InstanceInitializer objectInitializer, ConversionContext conversionContext) Builds the Lucene Document for a given entity instance and its id.
Set<FieldCacheType>	getFieldCacheOption()
Serializable	getId(Object entity) Return the id used for indexing if possible An IllegalStateException otherwise If the id is provided, we can't extract it from the entity
TwoWayFieldBridge	getIdBridge()
String	getIdentifierName()
FieldCacheCollectorFactory	getIdFieldCacheCollectionFactory()
org.hibernate.annotations.common.reflection.XMember	getIdGetter()
String	getIdKeywordName()
boolean	isIdMatchingJpaId() FIXME remove the need for such a method, we should always be able to rely on Work.id, but to respect @DocumentId which is being processed in the DocumentBuilder currently finding out which id we need is tricky, and requires helpers method like this one.
String	objectToString(String fieldName, FieldBridge bridge, Object value, ConversionContext conversionContext)
String	objectToString(String fieldName, Object value, ConversionContext conversionContext)
boolean	requiresProvidedId() To be removed, see org.hibernate.search.engine.DocumentBuilderIndexedEntity.isIdMatchingJpaId()

Methods inherited from class org.hibernate.search.engine.spi.AbstractDocumentBuilder

appendContainedInWorkForInstance, close, collectionChangeRequiresIndexUpdate, forceStateInspectionOptimizationsDisabled, getAnalyzer, getBeanClass, getBeanXClass, getEntityState, getInstanceInitializer, getMappedSubclasses, getMetadata, getTypeMetadata, isCollectionRoleExcluded, isDirty, isRoot, postInitialize, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

DocumentBuilderIndexedEntity

public DocumentBuilderIndexedEntity(org.hibernate.annotations.common.reflection.XClass clazz,
                            TypeMetadata typeMetadata,
                            ConfigContext context,
                            org.hibernate.annotations.common.reflection.ReflectionManager reflectionManager,
                            Set<org.hibernate.annotations.common.reflection.XClass> optimizationBlackList,
                            InstanceInitializer instanceInitializer)

Creates a document builder for entities annotated with @Indexed.

Parameters:

clazz - The class for which to build a DocumentBuilderContainedEntity

context - Handle to default configuration settings

reflectionManager - Reflection manager to use for processing the annotations

optimizationBlackList - mutable register, keeps track of types on which we need to disable collection events optimizations

instanceInitializer - helper class for class object graph navigation

Method Detail

getIdGetter

public org.hibernate.annotations.common.reflection.XMember getIdGetter()

getIdFieldCacheCollectionFactory

public FieldCacheCollectorFactory getIdFieldCacheCollectionFactory()

addWorkToQueue

public void addWorkToQueue(Class<T> entityClass,
                  T entity,
                  Serializable id,
                  boolean delete,
                  boolean add,
                  List<LuceneWork> queue,
                  ConversionContext contextualBridge)

Specified by:

addWorkToQueue in class AbstractDocumentBuilder<T>

createAddWork

public AddLuceneWork createAddWork(Class<T> entityClass,
                          T entity,
                          Serializable id,
                          String idInString,
                          InstanceInitializer sessionInitializer,
                          ConversionContext conversionContext)

createUpdateWork

public UpdateLuceneWork createUpdateWork(Class<T> entityClass,
                                T entity,
                                Serializable id,
                                String idInString,
                                InstanceInitializer sessionInitializer,
                                ConversionContext contextualBridge)

getDocument

public org.apache.lucene.document.Document getDocument(T instance,
                                              Serializable id,
                                              Map<String,String> fieldToAnalyzerMap,
                                              InstanceInitializer objectInitializer,
                                              ConversionContext conversionContext)

Builds the Lucene Document for a given entity instance and its id.

Parameters:

instance - The entity for which to build the matching Lucene Document

id - the entity id.

fieldToAnalyzerMap - this maps gets populated while generating the Document. It allows to specify for any document field a named analyzer to use. This parameter cannot be null.

objectInitializer - used to ensure that all objects are initalized

conversionContext - a ConversionContext object.

Returns:

The Lucene Document for the specified entity.

getIdentifierName

public String getIdentifierName()

allowFieldSelectionInProjection

public boolean allowFieldSelectionInProjection()

getFieldCacheOption

public Set<FieldCacheType> getFieldCacheOption()

getIdBridge

public TwoWayFieldBridge getIdBridge()

getIdKeywordName

public String getIdKeywordName()

getId

public Serializable getId(Object entity)

Return the id used for indexing if possible An IllegalStateException otherwise

If the id is provided, we can't extract it from the entity

Specified by:

getId in class AbstractDocumentBuilder<T>

Parameters:

entity - the instance for which to retrieve the id

Returns:

the value, or null if it's not an indexed entity

objectToString

public String objectToString(String fieldName,
                    Object value,
                    ConversionContext conversionContext)

objectToString

public String objectToString(String fieldName,
                    FieldBridge bridge,
                    Object value,
                    ConversionContext conversionContext)

getBridge

public FieldBridge getBridge(String fieldName)

requiresProvidedId

public boolean requiresProvidedId()

To be removed, see org.hibernate.search.engine.DocumentBuilderIndexedEntity.isIdMatchingJpaId()

Overrides:

requiresProvidedId in class AbstractDocumentBuilder<T>

Returns:

true if a providedId needs to be provided for indexing

isIdMatchingJpaId

public boolean isIdMatchingJpaId()

FIXME remove the need for such a method, we should always be able to rely on Work.id, but to respect @DocumentId which is being processed in the DocumentBuilder currently finding out which id we need is tricky, and requires helpers method like this one.

Overrides:

isIdMatchingJpaId in class AbstractDocumentBuilder<T>

Returns:

true if @DocumentId and @Id are found on the same property