QueryBuilder.java revision 1190
0N/A * The contents of this file are subject to the terms of the 0N/A * Common Development and Distribution License (the "License"). 0N/A * You may not use this file except in compliance with the License. 2362N/A * language governing permissions and limitations under the License. 0N/A * When distributing Covered Code, include this CDDL HEADER in each 0N/A * If applicable, add the following below this CDDL HEADER, with the 0N/A * fields enclosed by brackets "[]" replaced with your own identifying 0N/A * information: Portions Copyright [yyyy] [name of copyright owner] 0N/A * Copyright 2010 Sun Micosystems. All rights reserved. 2362N/A * Use is subject to license terms. 2362N/A * Portions Copyright 2011 Jens Elkner. 0N/A * Helper class that builds a Lucene query based on provided search terms for 0N/A * the different fields. 0N/A * A map containing the query text for each field. (We use a sorted map here 0N/A * only because we have tests that check the generated query string. If we 0N/A * had used a hash map, the order of the terms could have varied between 0N/A * platforms and it would be harder to test.) 0N/A * Set search string for the "full" field. 3514N/A * @param freetext query string to set 0N/A * @return this instance 0N/A * Get search string for the "full" field. 0N/A * @return {@code null} if not set, the query string otherwise. 0N/A * Set search string for the "defs" field. 0N/A * @param defs query string to set 0N/A * @return this instance 0N/A * Get search string for the "full" field. 0N/A * @return {@code null} if not set, the query string otherwise. 0N/A * Set search string for the "refs" field. 0N/A * @param refs query string to set 0N/A * @return this instance 0N/A * Get search string for the "refs" field. 0N/A * @return {@code null} if not set, the query string otherwise. 1220N/A /** Set search string for the "path" field. 1220N/A * @param path query string to set 1220N/A * Get search string for the "path" field. 1220N/A * @return {@code null} if not set, the query string otherwise. 0N/A * Set search string for the "hist" field. 0N/A * @param hist query string to set 0N/A * @return this instance 0N/A * Get search string for the "hist" field. 0N/A * @return {@code null} if not set, the query string otherwise. 914N/A * Get a map containing the query text for each of the fields that have 914N/A * @return a possible empty map. 2664N/A * Get the number of query fields set. 0N/A * @return the current number of fields with a none-empty query string. 0N/A * Build a new query based on the query text that has been passed in to this 0N/A * @return a query, or {@code null} if no query text is available. 0N/A * @throws ParseException if the query text cannot be parsed 0N/A // We don't have any text to parse 914N/A // Parse each of the query texts separately 914N/A // If we only have one sub-query, return it directly 914N/A // We have multiple subqueries, so let's combine them into a 0N/A // If the subquery is a BooleanQuery, we pull out each clause and 0N/A // add it to the outer BooleanQuery so that any negations work on 0N/A // the query as a whole. One exception to this rule: If the query 0N/A // contains one or more Occur.SHOULD clauses and no Occur.MUST 0N/A // clauses, we keep it in a subquery so that the requirement that 0N/A // at least one of the Occur.SHOULD clauses must match (pulling them 0N/A // out would make all of them optional). 0N/A // All other types of subqueries are added directly to the outer 0N/A // query with Occur.MUST. 0N/A * Add query text for the specified field. 0N/A * @param field the field to add query text for 0N/A * @param query the query text to set 0N/A * @return this object 0N/A * Escape special characters in a query string. 0N/A * @param field the field for which the query string is provided 0N/A * @param query the query string to escape 0N/A * @return the escaped query string 0N/A // The free text field may contain terms qualified with other 0N/A // field names, so we don't escape single colons. 0N/A // Other fields shouldn't use qualified terms, so escape colons 0N/A // so that we can search for them. 0N/A * Build a subquery against one of the fields. 0N/A * @param field the field to build the query against 0N/A * @param queryText the query text 0N/A * @return a parsed query 0N/A * @throws ParseException if the query text cannot be parsed 0N/A * Check if a BooleanQuery contains a clause of a given occur type. 0N/A * @param query the query to check 0N/A * @param occur the occur type to check for 0N/A * @return whether or not the query contains a clause of the specified type