Class Spans

    • Constructor Summary

      Constructors 
      Constructor Description
      Spans()  
    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      abstract int doc()
      Returns the document number of the current match.
      abstract int end()
      Returns the end position of the current match.
      abstract Collection<byte[]> getPayload()
      Returns the payload data for the current span.
      abstract boolean isPayloadAvailable()
      Checks if a payload can be loaded at this position.
      abstract boolean next()
      Move to the next match, returning true iff any such exists.
      abstract boolean skipTo​(int target)
      Skips to the first match beyond the current, whose document number is greater than or equal to target.
      abstract int start()
      Returns the start position of the current match.
    • Constructor Detail

      • Spans

        public Spans()
    • Method Detail

      • next

        public abstract boolean next()
                              throws IOException
        Move to the next match, returning true iff any such exists.
        Throws:
        IOException
      • skipTo

        public abstract boolean skipTo​(int target)
                                throws IOException
        Skips to the first match beyond the current, whose document number is greater than or equal to target.

        Returns true iff there is such a match.

        Behaves as if written:

           boolean skipTo(int target) {
             do {
               if (!next())
                     return false;
             } while (target > doc());
             return true;
           }
         
        Most implementations are considerably more efficient than that.
        Throws:
        IOException
      • doc

        public abstract int doc()
        Returns the document number of the current match. Initially invalid.
      • start

        public abstract int start()
        Returns the start position of the current match. Initially invalid.
      • end

        public abstract int end()
        Returns the end position of the current match. Initially invalid.
      • getPayload

        public abstract Collection<byte[]> getPayload()
                                               throws IOException
        Returns the payload data for the current span. This is invalid until next() is called for the first time. This method must not be called more than once after each call of next(). However, most payloads are loaded lazily, so if the payload data for the current position is not needed, this method may not be called at all for performance reasons. An ordered SpanQuery does not lazy load, so if you have payloads in your index and you do not want ordered SpanNearQuerys to collect payloads, you can disable collection with a constructor option.

        Note that the return type is a collection, thus the ordering should not be relied upon.
        Returns:
        a List of byte arrays containing the data of this payload, otherwise null if isPayloadAvailable is false
        Throws:
        IOException
        WARNING: This API is experimental and might change in incompatible ways in the next release.
      • isPayloadAvailable

        public abstract boolean isPayloadAvailable()
        Checks if a payload can be loaded at this position.

        Payloads can only be loaded once per call to next().

        Returns:
        true if there is a payload available at this position that can be loaded