Chapter 6. Manual index changes

最新推荐文章于 2024-09-24 21:07:33 发布

某先生xxxx

最新推荐文章于 2024-09-24 21:07:33 发布

阅读量1.7k

点赞数

分类专栏： Hibernate Search 文章标签： hibernate search 中文文档 lucene

Hibernate Search 专栏收录该内容

4 篇文章 0 订阅

订阅专栏

Chapter 6. Manual index changes

hibernate search会检测hibernate core对数据库的操作，并且自动更新索引（除非EventListeners设置为disabled)。当然hibernate search也支持手动更新索引，来满足我们的需求。比如从备份数据中导入数据到数据库。则需手动建立索引

6.1. Adding instances to the index

使用FullTextSession.index(T entity)可以直接添加或者更新一个特定实体对象到索引。如果实体已经被索引了，

那么索引就会被更新，只有当请求被commit之后，索引才会改变。

Example 6.1. Indexing an entity via FullTextSession.index(T entity)

FullTextSession fullTextSession = Search.getFullTextSession(session);                     Transaction tx = fullTextSession.beginTransaction();                                      Object customer = fullTextSession.load( Customer.class, 8 );
fullTextSession.index(customer);
tx.commit(); //index only updated at commit time

如果要添加一个类索引的所有实例，或者所有类索引，推荐的方法是MassIndexer.see Section 6.3.2, “Using a MassIndexer” for more details.

6.2. Deleting instances from the index

我们可以通过api删除索引，这个操作叫做purging,清除。也是通过FullTextSession。

Example 6.2. Purging a specific instance of an entity from the index

FullTextSession fullTextSession = Search.getFullTextSession(session);                     Transaction tx = fullTextSession.beginTransaction();                                      for (Customer customer : customers) {                                                     fullTextSession.purge( Customer.class, customer.getId() );
}                                                                                         tx.commit(); //index is updated at commit time

purging通过id删除索引中的实体，不会影响到数据库

如果要删除一个索引的所有实例，可以使用purgeAll方法.

Example 6.3. Purging all instances of an entity from the index

FullTextSession fullTextSession = Search.getFullTextSession(session);                     Transaction tx = fullTextSession.beginTransaction();
fullTextSession.purgeAll( Customer.class );
//optionally optimize the index                                                           //fullTextSession.getSearchFactory().optimize( Customer.class );                          tx.commit(); //index changes are applied at commit time

和 FullTextSession.index(T entity)一样，配置了 EntityIndexingInterceptor的实体将无法进行操作。详见 Section 4.5, “Conditional indexing: to index or not based on entity state” .

Note

FullTextEntityManager也有index, purge and purgeAll 等方法

Note

所有手动索引方法 (index, purge and purgeAll) 只影响索引, 然而它们任然有事务性，只有committed或者flushToindexes才能完成操作请求。

6.3. Rebuilding the whole index

如果实体和所以之间的映射被改变，那么就需要重建索引。比如新增了一个查询域。当数据库中导入新数据的时候，也需要重建索引。重建索引的方法有两种：

定期使用 FullTextSession.flushToIndexes()进行索引更新，或者使用 FullTextSession.index()更新实体。
使用MassIndexer.

6.3.1. Using flushToIndexes()

利用flushToIndexes可以刷新FullTextSession.puregeAll()已经删除的索引，和FullTextSession.index()添加索引实例到索引中。但是有一些内存和效率方面的问题。索引大量数据时，如果不周期性的利用flushToIndexes()清理队列请小心内存溢出。flushToIndexes()或者commit()之后，索引即被更新，并且无法rolled back.

Example 6.4. Index rebuilding using index() and flushToIndexes()

fullTextSession.setFlushMode(FlushMode.MANUAL);                                           fullTextSession.setCacheMode(CacheMode.IGNORE);                                           transaction = fullTextSession.beginTransaction();                                         //Scrollable results will avoid loading too many objects in memory                        ScrollableResults results = fullTextSession.createCriteria( Email.class )                    .setFetchSize(BATCH_SIZE)                                                                 .scroll( ScrollMode.FORWARD_ONLY );                                                    int index = 0 ;                                                                            while( results.next() ) {                                                                     index++;                                                                                  fullTextSession.index( results.get(0) ); //index each element                             if (index % BATCH_SIZE == 0) {                                                            fullTextSession.flushToIndexes(); //apply changes to indexes                              fullTextSession.clear(); //free memory since the queue is processed                       }                                                                                     }                                                                                        transaction.commit();

为了防止内存溢出，请使用setFetchSize(BATCH_SIZE)，来限制。但是BATCH_SIZE越大，从数据库fetch的速度也越快。

6.3.2. Using a MassIndexer

hibernate search的MassIndexer方法利用多线程重建索引；你可以自由选择重载或者重建索引。这个方法的效率最高但是需要程序进入维护模式，不建议在进行MassIndexer的时候请求索引等操作。

Example 6.5. Index rebuilding using a MassIndexer

fullTextSession.createIndexer().startAndWait();

上面的操作将重建索引，删除原来的索引，重新从数据库中加载转化索引。虽然api使用很方便，但是建议添加一些额外配置来使进程加快。

Warning

MassIndexer期间索引将无法被请求，请求结果可能会丢失。

Example 6.6. Using a tuned MassIndexer

fullTextSession                                                                             .createIndexer( User.class )                                                               .batchSizeToLoadObjects( 25 )                                                                          .cacheMode( CacheMode.NORMAL )                                                                         .threadsToLoadObjects( 5 )                                                                             .idFetchSize( 150 )                                                                                    .threadsForSubsequentFetching( 20 )                                                                    .progressMonitor( monitor ) //a MassIndexerProgressMonitor implementation                              .startAndWait();