/* * Licensed to Elasticsearch under one or more contributor * license agreements. See the NOTICE file distributed with * this work for additional information regarding copyright * ownership. Elasticsearch 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.queries; import org.apache.lucene.index.IndexReader; import org.apache.lucene.index.Term; import org.apache.lucene.index.TermContext; import org.apache.lucene.search.BooleanClause; import org.apache.lucene.search.BooleanClause.Occur; import org.apache.lucene.search.BooleanQuery; import org.apache.lucene.search.Query; import org.apache.lucene.search.TermQuery; import org.elasticsearch.common.lucene.search.Queries; import org.elasticsearch.index.mapper.FieldMapper; import java.io.IOException; /** * Extended version of {@link CommonTermsQuery} that allows to pass in a * minimumNumberShouldMatch specification that uses the actual num of high frequent terms * to calculate the minimum matching terms. */ public class ExtendedCommonTermsQuery extends CommonTermsQuery { private final FieldMapper mapper; public ExtendedCommonTermsQuery(Occur highFreqOccur, Occur lowFreqOccur, float maxTermFrequency, boolean disableCoord, FieldMapper mapper) { super(highFreqOccur, lowFreqOccur, maxTermFrequency, disableCoord); this.mapper = mapper; } private String lowFreqMinNumShouldMatchSpec; private String highFreqMinNumShouldMatchSpec; @Override protected int calcLowFreqMinimumNumberShouldMatch(int numOptional) { return calcMinimumNumberShouldMatch(lowFreqMinNumShouldMatchSpec, numOptional); } protected int calcMinimumNumberShouldMatch(String spec, int numOptional) { if (spec == null) { return 0; } return Queries.calculateMinShouldMatch(numOptional, spec); } @Override protected int calcHighFreqMinimumNumberShouldMatch(int numOptional) { return calcMinimumNumberShouldMatch(highFreqMinNumShouldMatchSpec, numOptional); } public void setHighFreqMinimumNumberShouldMatch(String spec) { this.highFreqMinNumShouldMatchSpec = spec; } public String getHighFreqMinimumNumberShouldMatchSpec() { return highFreqMinNumShouldMatchSpec; } public void setLowFreqMinimumNumberShouldMatch(String spec) { this.lowFreqMinNumShouldMatchSpec = spec; } public String getLowFreqMinimumNumberShouldMatchSpec() { return lowFreqMinNumShouldMatchSpec; } // LUCENE-UPGRADE: remove this method if on 4.8 @Override public Query rewrite(IndexReader reader) throws IOException { if (this.terms.isEmpty()) { return new BooleanQuery(); } else if (this.terms.size() == 1) { final Query tq = newTermQuery(this.terms.get(0), null); tq.setBoost(getBoost()); return tq; } return super.rewrite(reader); } // LUCENE-UPGRADE: remove this method if on 4.8 @Override protected Query buildQuery(final int maxDoc, final TermContext[] contextArray, final Term[] queryTerms) { BooleanQuery lowFreq = new BooleanQuery(disableCoord); BooleanQuery highFreq = new BooleanQuery(disableCoord); highFreq.setBoost(highFreqBoost); lowFreq.setBoost(lowFreqBoost); BooleanQuery query = new BooleanQuery(true); for (int i = 0; i < queryTerms.length; i++) { TermContext termContext = contextArray[i]; if (termContext == null) { lowFreq.add(newTermQuery(queryTerms[i], null), lowFreqOccur); } else { if ((maxTermFrequency >= 1f && termContext.docFreq() > maxTermFrequency) || (termContext.docFreq() > (int) Math.ceil(maxTermFrequency * (float) maxDoc))) { highFreq.add(newTermQuery(queryTerms[i], termContext), highFreqOccur); } else { lowFreq.add(newTermQuery(queryTerms[i], termContext), lowFreqOccur); } } } final int numLowFreqClauses = lowFreq.clauses().size(); final int numHighFreqClauses = highFreq.clauses().size(); if (lowFreqOccur == Occur.SHOULD && numLowFreqClauses > 0) { int minMustMatch = calcLowFreqMinimumNumberShouldMatch(numLowFreqClauses); lowFreq.setMinimumNumberShouldMatch(minMustMatch); } if (highFreqOccur == Occur.SHOULD && numHighFreqClauses > 0) { int minMustMatch = calcHighFreqMinimumNumberShouldMatch(numHighFreqClauses); highFreq.setMinimumNumberShouldMatch(minMustMatch); } if (lowFreq.clauses().isEmpty()) { /* * if lowFreq is empty we rewrite the high freq terms in a conjunction to * prevent slow queries. */ if (highFreq.getMinimumNumberShouldMatch() == 0 && highFreqOccur != Occur.MUST) { for (BooleanClause booleanClause : highFreq) { booleanClause.setOccur(Occur.MUST); } } highFreq.setBoost(getBoost()); return highFreq; } else if (highFreq.clauses().isEmpty()) { // only do low freq terms - we don't have high freq terms lowFreq.setBoost(getBoost()); return lowFreq; } else { query.add(highFreq, Occur.SHOULD); query.add(lowFreq, Occur.MUST); query.setBoost(getBoost()); return query; } } //@Override // LUCENE-UPGRADE: remove this method if on 4.8 protected Query newTermQuery(Term term, TermContext context) { if (mapper == null) { // this should be super.newTermQuery(term, context) once it's available in the super class return context == null ? new TermQuery(term) : new TermQuery(term, context); } final Query query = mapper.queryStringTermQuery(term); if (query == null) { // this should be super.newTermQuery(term, context) once it's available in the super class return context == null ? new TermQuery(term) : new TermQuery(term, context); } else { return query; } } }