Queries in text and object form
There are two ways to create a search query: in text or object form.
A search query in text form is simpler but less flexible. The flexibility of queries in object form lies in the fact that it is possible for each subquery to set separate search options. In object form, you can also use, for example, regular expression query as a part of more complex one. All combinations of nesting search queries in object form can be found on the page Nesting search queries in object form.
The correlation of two forms of search queries is that each text query before search is transformed to query in object form. Therefore, processor handles queries in object form faster.
The full specification of the query language in text form is presented on the page Query language specification. Syntax with examples of all elements allowed in text search queries is presented on the page Search operation table.
Each example in this documentation is usually given with the search query in text and object form.
The example of complex query in object form is given below.
String indexFolder = "c:\\MyIndex\\"; String documentsFolder = "c:\\MyDocuments\\"; // Creating index Index index = new Index(indexFolder); // Indexing index.add(documentsFolder); // Creating subquery 1 - simple word query SearchQuery subquery1 = SearchQuery.createWordQuery("future"); subquery1.setSearchOptions(new SearchOptions()); // Setting search options only for subquery 1 subquery1.getSearchOptions().getFuzzySearch().setEnabled(true); subquery1.getSearchOptions().getFuzzySearch().setFuzzyAlgorithm(new TableDiscreteFunction(3)); // The maximum number of differences is 3 // Creating subquery 2 - numeric range query SearchQuery subquery2 = SearchQuery.createNumericRangeQuery(1, 1000000); // Creating subquery 3 - regular expression query SearchQuery subquery3 = SearchQuery.createRegexQuery("(.)\\1"); // Combining subqueries into one query - phrase search query SearchQuery query = SearchQuery.createPhraseSearchQuery(subquery1, subquery2, subquery3); // Creating overall search options with increased capacity of occurrences SearchOptions options = new SearchOptions(); options.setMaxOccurrenceCountPerTerm(1000000); options.setMaxTotalOccurrenceCount(10000000); // Searching SearchResult result = index.search(query, options); // The result may contain the following word sequences: // futile 12 blessed // father 7 excellent // tyre 8 assyria // return 147 229
You may easily run the code from documentation articles and see the features in action in our GitHub examples:
Free online document search App
Along with full featured .NET library we provide simple, but powerful free Apps.
You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online Free Online Document Search App.