org.hibernate.search.mapper.pojo.mapping.definition.annotation

Annotation Type IndexingDependency

@Documented
 @Target(value={METHOD,FIELD})
 @Retention(value=RUNTIME)
 @PropertyMapping(processor=@PropertyMappingAnnotationProcessorRef(type=org.hibernate.search.mapper.pojo.mapping.definition.annotation.processing.impl.IndexingDependencyProcessor.class))
public @interface IndexingDependency

Given a property, defines how a dependency of the indexing process to this property should affect automatic indexing.

This annotation is generally not needed, as the default behavior is to consider all properties that are actually used in the indexing process as dependencies that trigger reindexing when they are updated.

However, some tuning may be required for some properties:

• Some properties may be updated very frequently and/or trigger reindexing to other entities that are very expensive to load in memory. In that case, it may be a good idea to tell Hibernate Search to ignore updates to those properties using reindexOnUpdate(). The index will be slightly out-of-sync whenever the property is modified, but this can be solved by triggering reindexing manually, for example every night.
• Some properties may be computed dynamically based on other properties, instead of being stored. In that case, the mapper may not be able to detect changes to the computed property directly. Thus Hibernate Search needs to know which other properties are used when generating the value of this property, which can be configured using derivedFrom().

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
ObjectPath[]	derivedFrom
ContainerExtraction	extraction
ReindexOnUpdate	reindexOnUpdate

Element Detail

reindexOnUpdate

public abstract ReindexOnUpdate reindexOnUpdate

Returns:

How indexed entities using the annotated property should be reindexed when the value, or any nested value, is updated. This setting is only effective for values that are actually used when indexing (values used in field definitions, in bridges, ...).

Default:

org.hibernate.search.mapper.pojo.automaticindexing.ReindexOnUpdate.DEFAULT

derivedFrom

public abstract ObjectPath[] derivedFrom

Returns:

Paths to other values that are used to generate the value of this property. Paths are relative to the parent type of the annotated property. This is useful mainly for getters that are not simply bound to class field, but rather compute a value based on other properties: it allows Hibernate Search to know that whenever these other properties are changed, this property may change too and thus should be reindexed.

Default:

{}

extraction

public abstract ContainerExtraction extraction

Returns:

A definition of container extractors to be applied to the property, allowing the definition of the indexing dependencies for container elements. This is useful when the property is of container type, for example a Map<TypeA, TypeB>: defining the extraction as @ContainerExtraction(BuiltinContainerExtractors.MAP_KEY) allows referencing map keys instead of map values. By default, Hibernate Search will try to apply a set of extractors for common container types.

See Also:

ContainerExtraction

Default:

@org.hibernate.search.mapper.pojo.extractor.mapping.annotation.ContainerExtraction