com.stratio.cassandra.lucene.search.condition.WildcardCondition Maven / Gradle / Ivy
/*
* Licensed to STRATIO (C) under one or more contributor license agreements.
* See the NOTICE file distributed with this work for additional information
* regarding copyright ownership. The STRATIO (C) 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 com.stratio.cassandra.lucene.search.condition;
import com.stratio.cassandra.lucene.IndexException;
import com.stratio.cassandra.lucene.schema.mapping.SingleColumnMapper;
import org.apache.lucene.analysis.Analyzer;
import org.apache.lucene.index.Term;
import org.apache.lucene.search.Query;
import org.apache.lucene.search.WildcardQuery;
/**
* Implements the wildcard search query. Supported wildcards are {@code *}, which matches any character sequence
* (including the empty one), and {@code ?}, which matches any single character. '\' is the escape character.
*
* Note this query can be slow, as it needs to iterate over many terms. In order to prevent extremely slow
* WildcardQueries, a Wildcard term should not start with the wildcard {@code *}.
*
* @author Andres de la Pena {@literal }
*/
public class WildcardCondition extends SingleColumnCondition {
/** The wildcard expression to be matched. */
public final String value;
/**
* Constructor using the field name and the value to be matched.
*
* @param boost The boost for this query clause. Documents matching this clause will (in addition to the normal
* weightings) have their score multiplied by {@code boost}. If {@code null}, then {@link
* #DEFAULT_BOOST} is used as default.
* @param field The name of the field to be matched.
* @param value The wildcard expression to be matched.
*/
public WildcardCondition(Float boost, String field, String value) {
super(boost, field);
if (value == null) {
throw new IndexException("Field value required");
}
this.value = value;
}
/** {@inheritDoc} */
@Override
public Query query(SingleColumnMapper mapper, Analyzer analyzer) {
if (mapper.base == String.class) {
Term term = new Term(field, value);
Query query = new WildcardQuery(term);
query.setBoost(boost);
return query;
} else {
throw new IndexException("Wildcard queries are not supported by mapper '%s'", mapper);
}
}
/** {@inheritDoc} */
@Override
public String toString() {
return toStringHelper(this).add("value", value).toString();
}
}