org.hibernate.search.engine.backend.types.converter.spi

Class DslConverter<V,F>

java.lang.Object

org.hibernate.search.engine.backend.types.converter.spi.DslConverter<V,F>

Type Parameters:

V - The type of values passed to the DSL.

F - The type of converted values passed to the backend.

public final class DslConverter<V,F>
extends Object

A converter for values passed to the DSL.

Constructor Summary

Constructors

Constructor and Description
DslConverter(Class<V> valueType, ToDocumentFieldValueConverter<V,F> delegate)

Method Summary

Modifier and Type	Method and Description
F	convert(V value, ToDocumentFieldValueConvertContext context)
F	convertUnknown(Object value, ToDocumentFieldValueConvertContext context) Convert an input value of unknown type that may not have the required type V.
Class<V>	getValueType()
boolean	isCompatibleWith(DslConverter<?,?> other)
boolean	isValidInputType(Class<?> inputTypeCandidate) Check whether the given type is a valid type for values passed to convert(Object, ToDocumentFieldValueConvertContext), which generally means the given type is a subtype of V.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

DslConverter

public DslConverter(Class<V> valueType,
                    ToDocumentFieldValueConverter<V,F> delegate)

Method Detail

toString

public String toString()

Overrides:

toString in class Object

getValueType

public Class<V> getValueType()

isValidInputType

public boolean isValidInputType(Class<?> inputTypeCandidate)

Check whether the given type is a valid type for values passed to convert(Object, ToDocumentFieldValueConvertContext), which generally means the given type is a subtype of V.

Parameters:

inputTypeCandidate - A candidate type for the input of convertUnknown(Object, ToDocumentFieldValueConvertContext).

Returns:

true if values of type inputTypeCandidate may be accepted by convertUnknown(Object, ToDocumentFieldValueConvertContext), false otherwise.

convert

public F convert(V value,
                 ToDocumentFieldValueConvertContext context)

Parameters:

value - The source value to convert.

context - A context that can be extended to a more useful type, giving access to such things as a Hibernate ORM SessionFactory (if using the Hibernate ORM mapper).

Returns:

The converted index field value.

convertUnknown

public F convertUnknown(Object value,
                        ToDocumentFieldValueConvertContext context)

Convert an input value of unknown type that may not have the required type V.

Called when passing values to the predicate DSL in particular.

Parameters:

value - The value to convert.

context - A context that can be extended to a more useful type, giving access to such things as a Hibernate ORM SessionFactory (if using the Hibernate ORM mapper).

Returns:

The converted index field value.

Throws:

RuntimeException - If the value does not match the expected type.

isCompatibleWith

public boolean isCompatibleWith(DslConverter<?,?> other)

Parameters:

other - Another DslConverter, never null.

Returns:

true if the given object behaves exactly the same as this object, i.e. its convert(Object, ToDocumentFieldValueConvertContext) and convertUnknown(Object, ToDocumentFieldValueConvertContext) methods are guaranteed to always return the same value as this object's when given the same input. false otherwise, or when in doubt.