Lucene教程：如何构建不匹配任何文档的空查询

if (isValid()) {
    return build.parseQuery(queryString); // 构建实际的查询
} else {
    return null; // 返回null表示不匹配任何文档
}

import org.apache.lucene.search.Query;
import org.apache.lucene.search.MatchNoDocsQuery;
import org.apache.lucene.search.MatchAllDocsQuery; // 用于演示“有效”查询
import org.apache.lucene.index.DirectoryReader;
import org.apache.lucene.index.IndexReader;
import org.apache.lucene.search.IndexSearcher;
import org.apache.lucene.store.RAMDirectory;
import org.apache.lucene.index.IndexWriter;
import org.apache.lucene.index.IndexWriterConfig;
import org.apache.lucene.analysis.standard.StandardAnalyzer;
import org.apache.lucene.document.Document;
import org.apache.lucene.document.Field;
import org.apache.lucene.document.TextField;
import org.apache.lucene.search.TopDocs;

import java.io.IOException;

public class EmptyQueryTutorial {

    /**
     * 根据安全校验结果构建查询。
     * 如果isValid为true，则返回一个实际的业务查询（此处用MatchAllDocsQuery模拟）；
     * 否则，返回一个不匹配任何文档的空查询。
     *
     * @param isValid 安全校验结果
     * @return 构建的Lucene查询
     */
    public static Query buildSecurityQuery(boolean isValid) {
        if (isValid) {
            // 假设这里根据业务逻辑构建一个实际的查询，例如解析用户输入的查询字符串
            // 为了演示，我们简单返回一个匹配所有文档的查询。
            // 实际应用中，这里可能是 new QueryParser(...).parse(queryString);
            return new MatchAllDocsQuery();
        } else {
            // 安全校验失败，返回一个不匹配任何文档的空查询
            return new MatchNoDocsQuery();
        }
    }

    public static void main(String[] args) throws IOException {
        // 1. 创建内存索引
        RAMDirectory directory = new RAMDirectory();
        StandardAnalyzer analyzer = new StandardAnalyzer();
        IndexWriterConfig config = new IndexWriterConfig(analyzer);
        IndexWriter writer = new IndexWriter(directory, config);

        // 2. 添加一些示例文档
        Document doc1 = new Document();
        doc1.add(new TextField("content", "Lucene is a powerful search engine library.", Field.Store.YES));
        writer.addDocument(doc1);

        Document doc2 = new Document();
        doc2.add(new TextField("content", "Java programming is widely used in enterprise applications.", Field.Store.YES));
        writer.addDocument(doc2);
        writer.close(); // 关闭Writer，提交更改

        // 3. 创建IndexReader和IndexSearcher
        IndexReader reader = DirectoryReader.open(directory);
        IndexSearcher searcher = new IndexSearcher(reader);

        System.out.println("--- 场景1：安全校验通过 (isValid = true) ---");
        Query query1 = buildSecurityQuery(true); // 此时返回 MatchAllDocsQuery
        System.out.println("构建的查询: " + query1.toString());
        TopDocs hits1 = searcher.search(query1, 10);
        System.out.println("匹配文档数: " + hits1.totalHits.value); // 预期匹配所有文档 (2个)

        System.out.println("\n--- 场景2：安全校验失败 (isValid = false) ---");
        Query query2 = buildSecurityQuery(false); // 此时返回 MatchNoDocsQuery
        System.out.println("构建的查询: " + query2.toString());
        TopDocs hits2 = searcher.search(query2, 10);
        System.out.println("匹配文档数: " + hits2.totalHits.value); // 预期匹配0个文档

        // 4. 关闭资源
        reader.close();
        directory.close();
        analyzer.close();
    }
}

--- 场景1：安全校验通过 (isValid = true) ---
构建的查询: MatchAllDocsQuery
匹配文档数: 2

--- 场景2：安全校验失败 (isValid = false) ---
构建的查询: MatchNoDocsQuery
匹配文档数: 0