QueryPlanner.java

/*
* Copyright 2010 The Apache Software Foundation
*
* 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 com.bizosys.hsearch.query;

import java.util.ArrayList;
import java.util.List;

/**
 * Best on term preciousness, optional and must conditions
 * the execution is sequenced. In each step one or more words
 * gets matched. Precious must words executed first. In all 
 * downlevel processing, proper filteration is applied to eliminate
 * unnecessary volume.
 * @author karan
 *
 */
public class QueryPlanner {

	public StringBuilder sb = new StringBuilder();
	public String phrases = null;

	public List<QueryTerm> mustTerms = null;
	public List<QueryTerm> optionalTerms = null;
	public List<List<QueryTerm>> sequences = null;
	
	public QueryPlanner() {
		
	}
	
	public void addMustTerm(QueryTerm aTerm) {
		aTerm.isOptional = false;
		if ( null != aTerm.wordOrig) sb.append(aTerm.wordOrig).append(' ');
		if ( null == mustTerms) mustTerms = new ArrayList<QueryTerm>();
		mustTerms.add(aTerm);
	}
	
	public void addOptionalTerm(QueryTerm aTerm) {
		aTerm.isOptional = true;
		if ( null != aTerm.wordOrig) sb.append(aTerm.wordOrig).append(' ');
		if ( null == optionalTerms) optionalTerms = new ArrayList<QueryTerm>();
		optionalTerms.add(aTerm);
	}
	
	public String getQueryString() {
		if ( null == phrases) {
			if ( null == sb) return null;
			else {
				phrases = sb.toString().toLowerCase().trim();
				sb.delete(0, sb.capacity());
				sb = null;
				return phrases;
			}
		} else {
			return phrases;
		}
	}

	@Override
	public String toString() {
		StringBuilder sb = new StringBuilder();
		if ( null != mustTerms  ) {
			for (QueryTerm term : mustTerms) {
				sb.append("Must Term = ").append(term).append('\n');
			}
		}
		if ( null != optionalTerms ) {
			for (QueryTerm term : optionalTerms) {
				sb.append("Optional Term = ").append(term).append('\n');
			}
		}
		return sb.toString();
	}
	
}