Package org.apache.lucene.search

Class FieldComparator.RelevanceComparator

    • Method Detail

      • compare

        public int compare​(int slot1,
                   int slot2)
        Description copied from class: FieldComparator
        Compare hit at slot1 with hit at slot2.
        Specified by:
        compare in class FieldComparator<java.lang.Float>
        Parameters:
        slot1 - first slot to compare
        slot2 - second slot to compare
        Returns:
        any N < 0 if slot2's value is sorted after slot1, any N > 0 if the slot2's value is sorted before slot1 and 0 if they are equal

      • compareBottom

        public int compareBottom​(int doc)
                  throws java.io.IOException
        Description copied from class: FieldComparator
        Compare the bottom of the queue with this doc. This will only invoked after setBottom has been called. This should return the same result as FieldComparator.compare(int,int)} as if bottom were slot1 and the new document were slot 2.

        For a search that hits many results, this method will be the hotspot (invoked by far the most frequently).

        Specified by:
        compareBottom in class FieldComparator<java.lang.Float>
        Parameters:
        doc - that was hit
        Returns:
        any N < 0 if the doc's value is sorted after the bottom entry (not competitive), any N > 0 if the doc's value is sorted before the bottom entry and 0 if they are equal.
        Throws:
        java.io.IOException

      • copy

        public void copy​(int slot,
                 int doc)
          throws java.io.IOException
        Description copied from class: FieldComparator
        This method is called when a new hit is competitive. You should copy any state associated with this document that will be required for future comparisons, into the specified slot.
        Specified by:
        copy in class FieldComparator<java.lang.Float>
        Parameters:
        slot - which slot to copy the hit to
        doc - docID relative to current reader
        Throws:
        java.io.IOException

      • setNextReader

        public FieldComparator<java.lang.Float> setNextReader​(AtomicReaderContext context)
        Description copied from class: FieldComparator
        Set a new AtomicReaderContext. All subsequent docIDs are relative to the current reader (you must add docBase if you need to map it to a top-level docID).
        Specified by:
        setNextReader in class FieldComparator<java.lang.Float>
        Parameters:
        context - current reader context
        Returns:
        the comparator to use for this segment; most comparators can just return "this" to reuse the same comparator across segments

      • setScorer

        public void setScorer​(Scorer scorer)
        Description copied from class: FieldComparator
        Sets the Scorer to use in case a document's score is needed.
        Overrides:
        setScorer in class FieldComparator<java.lang.Float>
        Parameters:
        scorer - Scorer instance that you should use to obtain the current hit's score, if necessary.

      • value

        public java.lang.Float value​(int slot)
        Description copied from class: FieldComparator
        Return the actual value in the slot.
        Specified by:
        value in class FieldComparator<java.lang.Float>
        Parameters:
        slot - the value
        Returns:
        value in this slot

      • compareValues

        public int compareValues​(java.lang.Float first,
                         java.lang.Float second)
        Description copied from class: FieldComparator
        Returns -1 if first is less than second. Default impl to assume the type implements Comparable and invoke .compareTo; be sure to override this method if your FieldComparator's type isn't a Comparable or if your values may sometimes be null
        Overrides:
        compareValues in class FieldComparator<java.lang.Float>

      • compareTop

        public int compareTop​(int doc)
               throws java.io.IOException
        Description copied from class: FieldComparator
        Compare the top value with this doc. This will only invoked after setTopValue has been called. This should return the same result as FieldComparator.compare(int,int)} as if topValue were slot1 and the new document were slot 2. This is only called for searches that use searchAfter (deep paging).
        Specified by:
        compareTop in class FieldComparator<java.lang.Float>
        Parameters:
        doc - that was hit
        Returns:
        any N < 0 if the doc's value is sorted after the bottom entry (not competitive), any N > 0 if the doc's value is sorted before the bottom entry and 0 if they are equal.
        Throws:
        java.io.IOException