SearchEngine.java revision 1327
715N/A * The contents of this file are subject to the terms of the 715N/A * Common Development and Distribution License (the "License"). 715N/A * You may not use this file except in compliance with the License. 715N/A * language governing permissions and limitations under the License. 715N/A * When distributing Covered Code, include this CDDL HEADER in each 715N/A * If applicable, add the following below this CDDL HEADER, with the 715N/A * fields enclosed by brackets "[]" replaced with your own identifying 715N/A * information: Portions Copyright [yyyy] [name of copyright owner] 1374N/A * Copyright 2010 Sun Micosystems. All rights reserved. 715N/A * Use is subject to license terms. 747N/A * This is an encapsulation of the details on how to seach in the index 747N/A * @author Trond Norbye 2005 747N/A * @author Lubos Kosco 2010 - upgrade to lucene 3.0.0 788N/A * @author Lubos Kosco 2011 - upgrade to lucene 3.5.0 788N/A /** Message text used when logging exceptions thrown when searching. */ 856N/A //NOTE below will need to be changed after new lucene upgrade, if they 856N/A //increase the version - every change of below makes us incompatible with the 856N/A //old index and we need to ask for reindex 856N/A /** version of lucene index common for whole app*/ 760N/A * Holds value of property definition. 851N/A * Holds value of property file. 851N/A * Holds value of property freetext. 864N/A * Holds value of property history. 803N/A * Holds value of property symbol. 857N/A * Holds value of property indexDatabase. 803N/A // internal structure to hold the results from lucene 760N/A * Creates a new instance of SearchEngine 887N/A * Create a QueryBuilder using the fields that have been set on this 887N/A * @return a query builder 793N/A * @param paging whether to use paging (if yes, first X pages will load faster) 788N/A * @param root which db to search 715N/A * @param paging whether to use paging (if yes, first X pages will load faster) 717N/A * @param root list of projects to search 844N/A * Execute a search. Before calling this function, you must set the 844N/A * appropriate seach critera with the set-functions. 844N/A * Note that this search will return the first cachePages of hitsPerPage, for more you need to call more 717N/A * @return The number of hits 864N/A //TODO optimize if only one project by falling back to SingleDatabase ? 864N/A // search the index database 715N/A * get results , if no search was started before, no results are returned 715N/A * this method will requery if end end is more than first query from search, 1459N/A * hence performance hit applies, if you want results in later pages than number of cachePages 1459N/A * also end has to be bigger than start ! 1459N/A * @param start start of the hit list 1459N/A * @param end end of the hit list 1459N/A * @param ret list of results from start to end or null/empty if no search was started 1459N/A //return if no start search() was done 851N/A //TODO check if below fits for if end=old hits.length, or it should include it 851N/A //do the requery, we want more than 5 pages 851N/A }
catch (
Exception e) {
// this exception should never be hit, since search() will hit this before 760N/A //TODO generation of ret(results) could be cashed and consumers of engine would just print them in whatever form they need, this way we could get rid of docs 760N/A // the only problem is that count of docs is usually smaller than number of results 1474N/A //TODO FIX below fragmenter according to either summarizer or context (to get line numbers, might be hard, since xref writers will need to be fixed too, they generate just one line of html code now :( ) 1470N/A * Getter for property definition. 1470N/A * @return Value of property definition. 844N/A * Setter for property definition. 844N/A * @param definition New value of property definition. 844N/A * Getter for property file. 844N/A * @return Value of property file. 844N/A * Setter for property file. 844N/A * @param file New value of property file. 844N/A * Getter for property freetext. 844N/A * @return Value of property freetext. 844N/A * Setter for property freetext. 844N/A * @param freetext New value of property freetext. 844N/A * Getter for property history. 844N/A * @return Value of property history. 856N/A * Setter for property history. 856N/A * @param history New value of property history. 856N/A * Getter for property symbol. 856N/A * @return Value of property symbol. 761N/A * Setter for property symbol. 761N/A * @param symbol New value of property symbol.