org.apache.solr.search.SortSpec Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of solr-core Show documentation
Apache Solr (module: core)
There is a newer version: 9.6.1
/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.apache.solr.search;

import java.util.Arrays;
import java.util.Collections;
import java.util.List;
import org.apache.lucene.search.Sort;
import org.apache.lucene.search.SortField;
import org.apache.solr.schema.SchemaField;

/** SortSpec encapsulates a Lucene Sort and a count of the number of documents to return. */
public class SortSpec {
  private Sort sort;
  private List fields;
  private int num = 10;
  private int offset = 0;

  public SortSpec(Sort sort, List fields, int num, int offset) {
    setSortAndFields(sort, fields);
    this.num = num;
    this.offset = offset;
  }

  public SortSpec(Sort sort, List fields) {
    setSortAndFields(sort, fields);
  }

  public SortSpec(Sort sort, SchemaField[] fields, int num, int offset) {
    setSortAndFields(sort, Arrays.asList(fields));
    this.num = num;
    this.offset = offset;
  }

  public SortSpec(Sort sort, SchemaField[] fields) {
    setSortAndFields(sort, Arrays.asList(fields));
  }

  /**
   * the specified SchemaFields must correspond one to one with the Sort's SortFields, using null
   * where appropriate.
   */
  public void setSortAndFields(Sort s, List fields) {

    assert null == s || s.getSort().length == fields.size()
        : "SortFields and SchemaFields do not have equal lengths";
    this.sort = s;
    this.fields = Collections.unmodifiableList(fields);
  }

  public static boolean includesScore(Sort sort) {
    if (sort == null) return true;
    for (SortField sf : sort.getSort()) {
      if (sf.getType() == SortField.Type.SCORE) return true;
    }
    return false;
  }

  public boolean includesScore() {
    return includesScore(sort);
  }

  /**
   * Returns whether SortFields for the Sort includes a field besides SortField.Type.SCORE or
   * SortField.Type.DOC
   *
   * @return true if SortFields contains a field besides score or the Lucene doc
   */
  public boolean includesNonScoreOrDocField() {
    return includesNonScoreOrDocField(sort);
  }

  /**
   * Returns whether SortFields for the Sort includes a field besides SortField.Type.SCORE or
   * SortField.Type.DOC
   *
   * @param sort org.apache.lucene.search.Sort
   * @return true if SortFields contains a field besides score or the Lucene doc
   */
  public static boolean includesNonScoreOrDocField(Sort sort) {
    if (sort == null) return false;
    for (SortField sf : sort.getSort()) {
      if (sf.getType() != SortField.Type.SCORE && sf.getType() != SortField.Type.DOC) return true;
    }
    return false;
  }

  /** Gets the Lucene Sort object, or null for the default sort by score descending. */
  public Sort getSort() {
    return sort;
  }

  /**
   * Gets the Solr SchemaFields that correspond to each of the SortFields used in this sort. The
   * array may contain null if a SortField doesn't correspond directly to a SchemaField (ie: score,
   * lucene docid, custom function sorting, etc...)
   *
   * @return an immutable list, may be empty if getSort is null
   */
  public List getSchemaFields() {
    return fields;
  }

  /** Offset into the list of results. */
  public int getOffset() {
    return offset;
  }

  public void setOffset(int offset) {
    this.offset = offset;
  }

  /**
   * Gets the number of documents to return after sorting.
   *
   * @return number of docs to return, or -1 for no cut off (just sort)
   */
  public int getCount() {
    return num;
  }

  public void setCount(int count) {
    this.num = count;
  }

  @Override
  public String toString() {
    return "start=" + offset + "&rows=" + num + (sort == null ? "" : "&sort=" + sort);
  }
}