Interface FieldSortMissingValueBehaviorStep<N>

Type Parameters:
N - The type of the next step (returned by first(), for example).

public interface FieldSortMissingValueBehaviorStep<N>
The step in a sort definition where the behavior on missing values can be set.
Author:
Emmanuel Bernard emmanuel@hibernate.org
  • Method Summary

    Modifier and Type
    Method
    Description
    Put documents with missing values first in the sorting.
    Put documents with missing values last in the sorting.
    default N
    use(Object value)
    When documents are missing a value on the sort field, use the given value instead.
    use(Object value, ValueConvert convert)
    When documents are missing a value on the sort field, use the given value instead.
  • Method Details

    • last

      N last()
      Put documents with missing values last in the sorting.

      This instruction is independent of whether the sort is being ascending or descending.

      Returns:
      The next step.
    • first

      N first()
      Put documents with missing values first in the sorting.

      This instruction is independent of whether the sort is being ascending or descending.

      Returns:
      The next step.
    • use

      default N use(Object value)
      When documents are missing a value on the sort field, use the given value instead.

      This method will apply DSL converters to value before Hibernate Search attempts to interpret it as a field value. See ValueConvert.YES.

      Parameters:
      value - The value to use as a default when a document is missing a value on the sort field.
      Returns:
      The next step.
      Throws:
      SearchException - If the field is not numeric.
    • use

      N use(Object value, ValueConvert convert)
      When documents are missing a value on the sort field, use the given value instead.
      Parameters:
      value - The value to use as a default when a document is missing a value on the sort field.
      convert - Controls how the value should be converted before Hibernate Search attempts to interpret it as a field value. See ValueConvert.
      Returns:
      The next step.
      Throws:
      SearchException - If the field is not numeric.