lucene/test-framework/src/java/org/apache/lucene/search/similarities/AssertingSimilarity.java

/*
 * 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.lucene.search.similarities;

import org.apache.lucene.index.FieldInvertState;
import org.apache.lucene.search.CollectionStatistics;
import org.apache.lucene.search.Explanation;
import org.apache.lucene.search.TermStatistics;

/** wraps a similarity with checks for testing */
public class AssertingSimilarity extends Similarity {
  private final Similarity delegate;

  public AssertingSimilarity(Similarity delegate) {
    this.delegate = delegate;
  }

  @Override
  public long computeNorm(FieldInvertState state) {
    assert state != null;
    assert state.getLength() > 0;
    assert state.getPosition() >= 0;
    assert state.getOffset() >= 0;
    assert state.getMaxTermFrequency() >= 0; // TODO: seems to be 0 for omitTFAP? 
    assert state.getMaxTermFrequency() <= state.getLength();
    assert state.getNumOverlap() >= 0;
    assert state.getNumOverlap() < state.getLength();
    assert state.getUniqueTermCount() > 0;
    assert state.getUniqueTermCount() <= state.getLength();
    long norm = delegate.computeNorm(state);
    assert norm != 0;
    return norm;
  }

  @Override
  public SimScorer scorer(float boost, CollectionStatistics collectionStats, TermStatistics... termStats) {
    assert boost >= 0;
    assert collectionStats != null;
    assert termStats.length > 0;
    for (TermStatistics term : termStats) {
      assert term != null;
    }
    // TODO: check that TermStats is in bounds with respect to collection? e.g. docFreq <= maxDoc
    SimScorer scorer = delegate.scorer(boost, collectionStats, termStats);
    assert scorer != null;
    return new AssertingSimScorer(scorer, boost);
  }
  
  static class AssertingSimScorer extends SimScorer {
    final SimScorer delegate;
    final float boost;
    
    AssertingSimScorer(SimScorer delegate, float boost) {
      super();
      this.delegate = delegate;
      this.boost = boost;
    }

    @Override
    public float score(float freq, long norm) {
      // freq in bounds
      assert Float.isFinite(freq);
      assert freq > 0;
      // result in bounds
      float score = delegate.score(freq, norm);
      assert Float.isFinite(score);
      assert score <= delegate.score(freq, 1);
      assert score >= 0;
      return score;
    }

    @Override
    public Explanation explain(Explanation freq, long norm) {
      // freq in bounds 
      assert freq != null;
      assert Float.isFinite(freq.getValue().floatValue());
      // result in bounds
      Explanation explanation = delegate.explain(freq, norm);
      assert explanation != null;
      assert Float.isFinite(explanation.getValue().floatValue());
      // result matches score exactly
      assert explanation.getValue().floatValue() == delegate.score(freq.getValue().floatValue(), norm);
      return explanation;
    }
  }

  @Override
  public String toString() {
    return "Asserting(" + delegate + ")";
  }

}