一步一步跟我学习lucene（18）---lucene索引时join和查询时join使用演示样例

了解sql的朋友都知道，我们在查询的时候能够採用join查询，即对有一定关联关系的对象进行联合查询来对多维的数据进行整理。这个联合查询的方式挺方便的。跟我们现实生活中的托人找关系类似，我们想要完毕一件事。先找自己的熟人，然后通过熟人在一次找到其它，终于通过这样的手段找到想要联系到的人。

有点类似于”世间万物皆有联系“的感觉。

lucene的join包提供了索引时join和查询时join的功能。

Index-time join

大意是索引时join提供了查询时join的支持，且IndexWriter.addDocuments()方法调用时被join的documents以单个document块存储索引。索引时join对普通文本内容（如xml文档或数据库表）是方便可用的。特别是对类似于数据库的那种多表关联的情况，我们须要对提供关联关系的列提供join支持；

在索引时join的时候，索引中的documents被切割成parent documents（每一个索引块的最后一个document）和child documents (除了parent documents外的全部documents). 因为lucene并不记录doc块的信息，我们须要提供一个Filter来标示parent documents。

在搜索结果的时候。我们利用ToParentBlockJoinQuery来从child query到parent document space来remap/join相应的结果。

假设我们仅仅关注匹配查询条件的parent documents，我们能够用随意的collector来採集匹配到的parent documents；假设我们还想採集匹配parent document查询条件的child documents，我们就须要利用ToParentBlockJoinCollector来进行查询。一旦查询完毕，我们能够利用ToParentBlockJoinCollector.getTopGroups()来获取匹配条件的TopGroups.

Query-time joins

查询时join是基于索引词，事实上现有两步：

第一步先从匹配fromQuery的fromField中採集全部的数据。
从第一步得到的数据中筛选出全部符合条件的documents

查询时join接收一下输入參数：

fromField：fromField的名称，即要join的documents中的字段；
formQuery: 用户的查询条件
multipleValuesPerDocument： fromField在document是否是多个值
scoreMode：定义other join side中score是怎样被使用的。假设不关注scoring，我们仅仅须要设置成ScoreMode.None，此种方式会忽略评分因此会更高效和节约内存。
toField：toField的名称。即要join的toField的在相应的document中的字段

通常查询时join的实现类似于例如以下：

   String fromField = "from"; // Name of the from field

   boolean multipleValuesPerDocument = false; // Set only yo true in the case when your fromField has multiple values per document in your index

   String toField = "to"; // Name of the to field

   ScoreMode scoreMode = ScoreMode.Max // Defines how the scores are translated into the other side of the join.

   Query fromQuery = new TermQuery(new Term("content", searchTerm)); // Query executed to collect from values to join to the to values

   Query joinQuery = JoinUtil.createJoinQuery(fromField, multipleValuesPerDocument, toField, fromQuery, fromSearcher, scoreMode);

   TopDocs topDocs = toSearcher.search(joinQuery, 10); // Note: toSearcher can be the same as the fromSearcher

   // Render topDocs...

查询演示样例

这里我们模拟6组数据。演示样例代码例如以下

package com.lucene.index.test;

import static org.junit.Assert.assertEquals;

import java.nio.file.Paths;

import org.apache.lucene.analysis.Analyzer;

import org.apache.lucene.analysis.standard.StandardAnalyzer;

import org.apache.lucene.document.Document;

import org.apache.lucene.document.Field;

import org.apache.lucene.document.SortedDocValuesField;

import org.apache.lucene.document.TextField;

import org.apache.lucene.index.DirectoryReader;

import org.apache.lucene.index.IndexReader;

import org.apache.lucene.index.IndexWriter;

import org.apache.lucene.index.IndexWriterConfig;

import org.apache.lucene.index.IndexWriterConfig.OpenMode;

import org.apache.lucene.index.Term;

import org.apache.lucene.search.IndexSearcher;

import org.apache.lucene.search.Query;

import org.apache.lucene.search.TermQuery;

import org.apache.lucene.search.TopDocs;

import org.apache.lucene.search.join.JoinUtil;

import org.apache.lucene.search.join.ScoreMode;

import org.apache.lucene.store.Directory;

import org.apache.lucene.store.FSDirectory;

import org.apache.lucene.util.BytesRef;

import org.junit.Test;

public class TestJoin {

	@Test

	public void testSimple() throws Exception {

	    final String idField = "id";

	    final String toField = "productId";

	    Directory dir = FSDirectory.open(Paths.get("index"));

	    Analyzer analyzer = new StandardAnalyzer();

	    IndexWriterConfig config = new IndexWriterConfig(analyzer);

	    config.setOpenMode(OpenMode.CREATE);

	    IndexWriter w = new IndexWriter(dir, config);

	    // 0

	    Document doc = new Document();

	    doc.add(new TextField("description", "random text", Field.Store.YES));

	    doc.add(new TextField("name", "name1", Field.Store.YES));

	    doc.add(new TextField(idField, "1", Field.Store.YES));

	    doc.add(new SortedDocValuesField(idField, new BytesRef("1")));

	    w.addDocument(doc);

	    // 1

	    Document doc1 = new Document();

	    doc1.add(new TextField("price", "10.0", Field.Store.YES));

	    doc1.add(new TextField(idField, "2", Field.Store.YES));

	    doc1.add(new SortedDocValuesField(idField, new BytesRef("2")));

	    doc1.add(new TextField(toField, "1", Field.Store.YES));

	    doc1.add(new SortedDocValuesField(toField, new BytesRef("1")));

	    w.addDocument(doc1);

	    // 2

	    Document doc2 = new Document();

	    doc2.add(new TextField("price", "20.0", Field.Store.YES));

	    doc2.add(new TextField(idField, "3", Field.Store.YES));

	    doc2.add(new SortedDocValuesField(idField, new BytesRef("3")));

	    doc2.add(new TextField(toField, "1", Field.Store.YES));

	    doc2.add(new SortedDocValuesField(toField, new BytesRef("1")));

	    w.addDocument(doc2);

	    // 3

	    Document doc3 = new Document();

	    doc3.add(new TextField("description", "more random text", Field.Store.YES));

	    doc3.add(new TextField("name", "name2", Field.Store.YES));

	    doc3.add(new TextField(idField, "4", Field.Store.YES));

	    doc3.add(new SortedDocValuesField(idField, new BytesRef("4")));

	    w.addDocument(doc3);

	    // 4

	    Document doc4 = new Document();

	    doc4.add(new TextField("price", "10.0", Field.Store.YES));

	    doc4.add(new TextField(idField, "5", Field.Store.YES));

	    doc4.add(new SortedDocValuesField(idField, new BytesRef("5")));

	    doc4.add(new TextField(toField, "4", Field.Store.YES));

	    doc4.add(new SortedDocValuesField(toField, new BytesRef("4")));

	    w.addDocument(doc4);

	    // 5

	    Document doc5 = new Document();

	    doc5.add(new TextField("price", "20.0", Field.Store.YES));

	    doc5.add(new TextField(idField, "6", Field.Store.YES));

	    doc5.add(new SortedDocValuesField(idField, new BytesRef("6")));

	    doc5.add(new TextField(toField, "4", Field.Store.YES));

	    doc5.add(new SortedDocValuesField(toField, new BytesRef("4")));

	    w.addDocument(doc5);

	    //6

	    Document doc6 = new Document();

	    doc6.add(new TextField(toField, "4", Field.Store.YES));

	    doc6.add(new SortedDocValuesField(toField, new BytesRef("4")));

	    w.addDocument(doc6);

	    w.commit();

	    w.close();

	    IndexReader reader = DirectoryReader.open(dir);

	    IndexSearcher indexSearcher = new IndexSearcher(reader);

	    // Search for product

	    Query joinQuery = JoinUtil.createJoinQuery(idField, false, toField, new TermQuery(new Term("name", "name2")), indexSearcher, ScoreMode.None);

	    System.out.println(joinQuery);

	    TopDocs result = indexSearcher.search(joinQuery, 10);

	    System.out.println("查询到的匹配数据："+result.totalHits);

	    joinQuery = JoinUtil.createJoinQuery(idField, false, toField, new TermQuery(new Term("name", "name1")), indexSearcher, ScoreMode.None);

	    result = indexSearcher.search(joinQuery, 10);

	    System.out.println("查询到的匹配数据："+result.totalHits);

	    // Search for offer

	    joinQuery = JoinUtil.createJoinQuery(toField, false, idField, new TermQuery(new Term("id", "5")), indexSearcher, ScoreMode.None);

	    result = indexSearcher.search(joinQuery, 10);

	    System.out.println("查询到的匹配数据："+result.totalHits);

	    indexSearcher.getIndexReader().close();

	    dir.close();

	  }

}

程序的执行结果例如以下：

查询到的匹配数据：3

查询到的匹配数据：2

查询到的匹配数据：1

以第一个查询为例：

我们在查询的时候先依据name=name2这个查询条件找到记录为doc3的document,因为查询的是toField匹配的，我们在依据doc3找到其toField的值为4，然后查询条件变为productId:4，找出除本条记录外的其它数据。结果正好为3。符合条件。

一步一步跟我学习lucene是对最近做lucene索引的总结，大家有问题的话联系本人的Q-Q: 891922381，同一时候本人新建Q-Q群：106570134（lucene,solr,netty,hadoop）。大家共同探讨,本人争取每日一博。希望大家持续关注，会带给大家惊喜的