--- /dev/null
+package org.apache.lucene.search.function;
+
+/**
+ * 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.
+ */
+
+import org.apache.lucene.index.IndexReader;
+import org.apache.lucene.index.Term;
+import org.apache.lucene.index.TermDocs;
+import org.apache.lucene.search.*;
+import org.apache.lucene.util.ToStringUtils;
+
+import java.io.IOException;
+import java.util.Set;
+
+/**
+ * Expert: A Query that sets the scores of document to the
+ * values obtained from a {@link org.apache.lucene.search.function.ValueSource ValueSource}.
+ * <p>
+ * This query provides a score for <em>each and every</em> undeleted document in the index.
+ * <p>
+ * The value source can be based on a (cached) value of an indexed field, but it
+ * can also be based on an external source, e.g. values read from an external database.
+ * <p>
+ * Score is set as: Score(doc,query) = query.getBoost()<sup>2</sup> * valueSource(doc).
+ *
+ * @lucene.experimental
+ */
+public class ValueSourceQuery extends Query {
+ ValueSource valSrc;
+
+ /**
+ * Create a value source query
+ * @param valSrc provides the values defines the function to be used for scoring
+ */
+ public ValueSourceQuery(ValueSource valSrc) {
+ this.valSrc=valSrc;
+ }
+
+ /*(non-Javadoc) @see org.apache.lucene.search.Query#rewrite(org.apache.lucene.index.IndexReader) */
+ @Override
+ public Query rewrite(IndexReader reader) throws IOException {
+ return this;
+ }
+
+ /*(non-Javadoc) @see org.apache.lucene.search.Query#extractTerms(java.util.Set) */
+ @Override
+ public void extractTerms(Set<Term> terms) {
+ // no terms involved here
+ }
+
+ class ValueSourceWeight extends Weight {
+ Similarity similarity;
+ float queryNorm;
+ float queryWeight;
+
+ public ValueSourceWeight(Searcher searcher) {
+ this.similarity = getSimilarity(searcher);
+ }
+
+ /*(non-Javadoc) @see org.apache.lucene.search.Weight#getQuery() */
+ @Override
+ public Query getQuery() {
+ return ValueSourceQuery.this;
+ }
+
+ /*(non-Javadoc) @see org.apache.lucene.search.Weight#getValue() */
+ @Override
+ public float getValue() {
+ return queryWeight;
+ }
+
+ /*(non-Javadoc) @see org.apache.lucene.search.Weight#sumOfSquaredWeights() */
+ @Override
+ public float sumOfSquaredWeights() throws IOException {
+ queryWeight = getBoost();
+ return queryWeight * queryWeight;
+ }
+
+ /*(non-Javadoc) @see org.apache.lucene.search.Weight#normalize(float) */
+ @Override
+ public void normalize(float norm) {
+ this.queryNorm = norm;
+ queryWeight *= this.queryNorm;
+ }
+
+ @Override
+ public Scorer scorer(IndexReader reader, boolean scoreDocsInOrder, boolean topScorer) throws IOException {
+ return new ValueSourceScorer(similarity, reader, this);
+ }
+
+ /*(non-Javadoc) @see org.apache.lucene.search.Weight#explain(org.apache.lucene.index.IndexReader, int) */
+ @Override
+ public Explanation explain(IndexReader reader, int doc) throws IOException {
+ DocValues vals = valSrc.getValues(reader);
+ float sc = queryWeight * vals.floatVal(doc);
+
+ Explanation result = new ComplexExplanation(
+ true, sc, ValueSourceQuery.this.toString() + ", product of:");
+
+ result.addDetail(vals.explain(doc));
+ result.addDetail(new Explanation(getBoost(), "boost"));
+ result.addDetail(new Explanation(queryNorm,"queryNorm"));
+ return result;
+ }
+ }
+
+ /**
+ * A scorer that (simply) matches all documents, and scores each document with
+ * the value of the value source in effect. As an example, if the value source
+ * is a (cached) field source, then value of that field in that document will
+ * be used. (assuming field is indexed for this doc, with a single token.)
+ */
+ private class ValueSourceScorer extends Scorer {
+ private final float qWeight;
+ private final DocValues vals;
+ private final TermDocs termDocs;
+ private int doc = -1;
+
+ // constructor
+ private ValueSourceScorer(Similarity similarity, IndexReader reader, ValueSourceWeight w) throws IOException {
+ super(similarity,w);
+ qWeight = w.getValue();
+ // this is when/where the values are first created.
+ vals = valSrc.getValues(reader);
+ termDocs = reader.termDocs(null);
+ }
+
+ @Override
+ public int nextDoc() throws IOException {
+ return doc = termDocs.next() ? termDocs.doc() : NO_MORE_DOCS;
+ }
+
+ @Override
+ public int docID() {
+ return doc;
+ }
+
+ @Override
+ public int advance(int target) throws IOException {
+ return doc = termDocs.skipTo(target) ? termDocs.doc() : NO_MORE_DOCS;
+ }
+
+ /*(non-Javadoc) @see org.apache.lucene.search.Scorer#score() */
+ @Override
+ public float score() throws IOException {
+ return qWeight * vals.floatVal(termDocs.doc());
+ }
+ }
+
+ @Override
+ public Weight createWeight(Searcher searcher) {
+ return new ValueSourceQuery.ValueSourceWeight(searcher);
+ }
+
+ @Override
+ public String toString(String field) {
+ return valSrc.toString() + ToStringUtils.boost(getBoost());
+ }
+
+ /** Returns true if <code>o</code> is equal to this. */
+ @Override
+ public boolean equals(Object o) {
+ if (this == o)
+ return true;
+ if (!super.equals(o))
+ return false;
+ if (getClass() != o.getClass()) {
+ return false;
+ }
+ ValueSourceQuery other = (ValueSourceQuery)o;
+ return this.getBoost() == other.getBoost()
+ && this.valSrc.equals(other.valSrc);
+ }
+
+ /** Returns a hash code value for this object. */
+ @Override
+ public int hashCode() {
+ return (getClass().hashCode() + valSrc.hashCode()) ^ Float.floatToIntBits(getBoost());
+ }
+
+}