BooleanQuery 用於搜尋的是使用 AND,OR或NOT運算子多個查詢結果的檔案。
以下是org.apache.lucene.search.BooleanQuery類的宣告:
public class BooleanQuery extends Query implements Iterable<BooleanClause>
protected int minNrShouldMatch
S.N. | 建構函式和說明 |
---|---|
1 |
BooleanQuery() 構造一個空的布林查詢。 |
1 |
BooleanQuery(boolean disableCoord) 構造一個空的布林查詢。 |
S.N. | 方法及說明 |
---|---|
1 |
void add(BooleanClause clause) Adds a clause to a boolean query. |
2 |
void add(Query query, BooleanClause.Occur occur) Adds a clause to a boolean query. |
3 |
List<BooleanClause> clauses() Returns the list of clauses in this query. |
4 |
Object clone() Returns a clone of this query. |
5 |
Weight createWeight(Searcher searcher) Expert: Constructs an appropriate Weight implementation for this query. |
6 |
boolean equals(Object o) Returns true iff o is equal to this. |
7 |
void extractTerms(Set<Term> terms) Expert: adds all terms occurring in this query to the terms set. |
8 |
BooleanClause[] getClauses() Returns the set of clauses in this query. |
9 |
static int getMaxClauseCount() Return the maximum number of clauses permitted, 1024 by default. |
10 |
int getMinimumNumberShouldMatch() Gets the minimum number of the optional BooleanClauses which must be satisfied. |
11 |
int hashCode() Returns a hash code value for this object. |
12 |
boolean isCoordDisabled() Returns true iff Similarity.coord(int,int) is disabled in scoring for this query instance. |
13 |
Iterator<BooleanClause> iterator() Returns an iterator on the clauses in this query. |
14 |
Query rewrite(IndexReader reader) Expert: called to re-write queries into primitive queries. |
15 |
static void setMaxClauseCount(int maxClauseCount) Set the maximum number of clauses permitted per BooleanQuery. |
16 |
void setMinimumNumberShouldMatch(int min) Specifies a minimum number of the optional BooleanClauses which must be satisfied. |
17 |
String toString(String field) Prints a user-readable version of this query. |
這個類繼承了以下類方法:
org.apache.lucene.search.Query
java.lang.Object
private void searchUsingBooleanQuery(String searchQuery1, String searchQuery2)throws IOException, ParseException{ searcher = new Searcher(indexDir); long startTime = System.currentTimeMillis(); //create a term to search file name Term term1 = new Term(LuceneConstants.FILE_NAME, searchQuery1); //create the term query object Query query1 = new TermQuery(term1); Term term2 = new Term(LuceneConstants.FILE_NAME, searchQuery2); //create the term query object Query query2 = new PrefixQuery(term2); BooleanQuery query = new BooleanQuery(); query.add(query1,BooleanClause.Occur.MUST_NOT); query.add(query2,BooleanClause.Occur.MUST); //do the search TopDocs hits = searcher.search(query); long endTime = System.currentTimeMillis(); System.out.println(hits.totalHits + " documents found. Time :" + (endTime - startTime) + "ms"); for(ScoreDoc scoreDoc : hits.scoreDocs) { Document doc = searcher.getDocument(scoreDoc); System.out.println("File: "+ doc.get(LuceneConstants.FILE_PATH)); } searcher.close(); }
讓我們建立一個測試Lucene的應用程式中使用BooleanQuery測試搜尋。
步驟 | 描述 |
---|---|
1 | Create a project with a name LuceneFirstApplication under a packagecom.yiibai.lucene as explained in the Lucene - First Application chapter. You can also use the project created in Lucene - First Application chapter as such for this chapter to understand searching process. |
2 | Create LuceneConstants.java and Searcher.java as explained in the Lucene - First Applicationchapter. Keep rest of the files unchanged. |
3 | Create LuceneTester.java as mentioned below. |
4 | Clean and Build the application to make sure business logic is working as per the requirements. |
LuceneConstants.java
這個類是用來提供可應用於範例應用程式中使用的各種常數。
package com.yiibai.lucene; public class LuceneConstants { public static final String CONTENTS="contents"; public static final String FILE_NAME="filename"; public static final String FILE_PATH="filepath"; public static final int MAX_SEARCH = 10; }
Searcher.java
這個類用來讀取就使用Lucene庫的原始資料,並搜尋資料的索引。
package com.yiibai.lucene; import java.io.File; import java.io.IOException; import org.apache.lucene.analysis.standard.StandardAnalyzer; import org.apache.lucene.document.Document; import org.apache.lucene.index.CorruptIndexException; import org.apache.lucene.queryParser.ParseException; import org.apache.lucene.queryParser.QueryParser; import org.apache.lucene.search.IndexSearcher; import org.apache.lucene.search.Query; import org.apache.lucene.search.ScoreDoc; import org.apache.lucene.search.TopDocs; import org.apache.lucene.store.Directory; import org.apache.lucene.store.FSDirectory; import org.apache.lucene.util.Version; public class Searcher { IndexSearcher indexSearcher; QueryParser queryParser; Query query; public Searcher(String indexDirectoryPath) throws IOException{ Directory indexDirectory = FSDirectory.open(new File(indexDirectoryPath)); indexSearcher = new IndexSearcher(indexDirectory); queryParser = new QueryParser(Version.LUCENE_36, LuceneConstants.CONTENTS, new StandardAnalyzer(Version.LUCENE_36)); } public TopDocs search( String searchQuery) throws IOException, ParseException{ query = queryParser.parse(searchQuery); return indexSearcher.search(query, LuceneConstants.MAX_SEARCH); } public TopDocs search(Query query) throws IOException, ParseException{ return indexSearcher.search(query, LuceneConstants.MAX_SEARCH); } public Document getDocument(ScoreDoc scoreDoc) throws CorruptIndexException, IOException{ return indexSearcher.doc(scoreDoc.doc); } public void close() throws IOException{ indexSearcher.close(); } }
LuceneTester.java
這個類是用來測試 Lucene 庫的搜尋能力。
package com.yiibai.lucene; import java.io.IOException; import org.apache.lucene.document.Document; import org.apache.lucene.index.Term; import org.apache.lucene.queryParser.ParseException; import org.apache.lucene.search.BooleanClause; import org.apache.lucene.search.PrefixQuery; import org.apache.lucene.search.Query; import org.apache.lucene.search.ScoreDoc; import org.apache.lucene.search.TermQuery; import org.apache.lucene.search.BooleanQuery; import org.apache.lucene.search.TopDocs; public class LuceneTester { String indexDir = "E:\Lucene\Index"; String dataDir = "E:\Lucene\Data"; Searcher searcher; public static void main(String[] args) { LuceneTester tester; try { tester = new LuceneTester(); tester.searchUsingBooleanQuery("record1.txt","record1"); } catch (IOException e) { e.printStackTrace(); } catch (ParseException e) { e.printStackTrace(); } } private void searchUsingBooleanQuery(String searchQuery1, String searchQuery2)throws IOException, ParseException{ searcher = new Searcher(indexDir); long startTime = System.currentTimeMillis(); //create a term to search file name Term term1 = new Term(LuceneConstants.FILE_NAME, searchQuery1); //create the term query object Query query1 = new TermQuery(term1); Term term2 = new Term(LuceneConstants.FILE_NAME, searchQuery2); //create the term query object Query query2 = new PrefixQuery(term2); BooleanQuery query = new BooleanQuery(); query.add(query1,BooleanClause.Occur.MUST_NOT); query.add(query2,BooleanClause.Occur.MUST); //do the search TopDocs hits = searcher.search(query); long endTime = System.currentTimeMillis(); System.out.println(hits.totalHits + " documents found. Time :" + (endTime - startTime) + "ms"); for(ScoreDoc scoreDoc : hits.scoreDocs) { Document doc = searcher.getDocument(scoreDoc); System.out.println("File: "+ doc.get(LuceneConstants.FILE_PATH)); } searcher.close(); } }
從record1.txt到record10.txt的檔案中包含簡單的名稱以及學生的其他細節,並把它們放在目錄E:LuceneData。這是測試資料。索引目錄路徑應建立為E:LuceneIndex。期間,執行 Lucene索引程式後- 索引過程中,可以看到該檔案夾中建立的索引檔案的列表。測試資料請下載:data.zip
一旦建立源,創造了原始資料,資料目錄,索引目錄和索引完成後,已經準備好這一步是編譯和執行程式。要做到這一點,請LuceneTester.Java檔案索引標籤中使用Eclipse IDE可使用Run選項,或使用Ctrl+ F11來編譯和執行應用程式LuceneTester。如果您的應用程式一切正常,這將在Eclipse IDE的控制台列印以下訊息:
1 documents found. Time :26ms File: E:LuceneDataecord10.txt