Hiberate Search 介绍与入门实例

转载于：http://hi.baidu.com/lewutian/blog/item/87a646cabae2654af21fe7e8.html

 

Hibernate Search项目的主要特性包含以下几个方面：

Lucene集成——作为强大高效的检索引擎，Lucene的美名早已久经考验了；
数据的自动插入和更新——当一个对象通过Hibernate添加或更新时，索引也会相应进行透明的更新；
支持众多复杂的搜索方式——可快速的使用通配符进行搜索，以及多关键词全文检索（multi-word text searches）和近似或同义词搜索（approximation/synonym searches），或根据相关性排列搜索结果；
搜索集群（Search Clustering）——Hibernate Search提供了内建搜索集群解决方案，其中包括一个基于JMS的异步查询和索引系统；
对Lucene API接口的直接调用——如果用户打算处理某些特别复杂的问题，可以在查询中直接使用Lucene提供的API接口；
对Lucene的自动管理——Hibernate Search可以管理并优化Lucene的索引，并且非常高效地使用Lucene的API接口。

Hibernate Search相关的Annotation主要有三个：

@Indexed 标识需要进行索引的对象， 属性 : index 指定索引文件的路径
@DocumentId 用于标示实体类中的唯一的属性保存在索引文件中，是当进行全文检索时可以这个唯一的属性来区分索引中其他实体对象，一般使用实体类中的主键属性
@Field 标注在类的get属性上，标识一个索引的Field 属性 : index 指定是否索引，与Lucene相同
store 指定是否索引，与Lucene相同
name 指定Field的name，默认为类属性的名称
analyzer 指定分析器

另外@IndexedEmbedded 与 @ContainedIn 用于关联类之间的索引
@IndexedEmbedded有两个属性，一个prefix指定关联的前缀，一个depth指定关联的深度

 

step-by-step实例:

 

1.在maven的pom.xml文件中加入以下三个依赖包:
Xml代码
.......   
  
<dependency>  
   <groupId>org.hibernate</groupId>  
   <artifactId>hibernate-search</artifactId>  
   <version>3.0.1.GA</version>  
</dependency>  
<dependency>  
   <groupId>org.hibernate</groupId>  
   <artifactId>hibernate-annotations</artifactId>  
   <version>3.3.0.ga</version>  
</dependency>  
<dependency>  
   <groupId>org.hibernate</groupId>  
   <artifactId>hibernate-entitymanager</artifactId>  
   <version>3.3.1.ga</version>  
</dependency>  
....... 

.......<dependency>   <groupId>org.hibernate</groupId>   <artifactId>hibernate-search</artifactId>   <version>3.0.1.GA</version></dependency><dependency>   <groupId>org.hibernate</groupId>   <artifactId>hibernate-annotations</artifactId>   <version>3.3.0.ga</version></dependency><dependency>   <groupId>org.hibernate</groupId>   <artifactId>hibernate-entitymanager</artifactId>   <version>3.3.1.ga</version></dependency>.......

2.hiberante配置文件

 

主要就是添加两个属性，hibernate.search.default.directory_provider指定Directory的代理，即把索引的文件保存在硬盘中（org.hibernate.search.store.FSDirectoryProvider）还是内存里（org.hibernate.search.store.RAMDirectoryProvider），保存在硬盘的话hibernate.search.default.indexBase属性指定索引保存的路径.

Xml代码
......   
  
    <!-- use a file system based index -->  
    <prop  
     key="hibernate.search.default.directory_provider">  
      org.hibernate.search.store.FSDirectoryProvider   
    </prop>  
    <!-- directory where the indexes will be stored -->  
    <prop key="hibernate.search.default.indexBase">  
      D:/index   
    </prop>  
  
......... 

......    <!-- use a file system based index -->    <prop     key="hibernate.search.default.directory_provider">     org.hibernate.search.store.FSDirectoryProvider    </prop>    <!-- directory where the indexes will be stored -->    <prop key="hibernate.search.default.indexBase">     D:/index    </prop> .........

 

如果计划使用Hibernate Annotations或者EntityManager 3.2.x（已经嵌入到JBoss AS 4.2.GA中），那也需要配置相应的事件监听器。

Xml代码
<!-- use a file system based index -->  
         <property name="hibernate.search.default.directory_provider"   
                   value="org.hibernate.search.store.FSDirectoryProvider"/>  
         <!-- directory where the indexes will be stored -->  
         <property name="hibernate.search.default.indexBase"   
                   value="D:/index"/>  
  
  
<!--事件监听器-->  
         <property name="hibernate.ejb.event.post-insert"   
                   value="org.hibernate.search.event.FullTextIndexEventListener"/>  
         <property name="hibernate.ejb.event.post-update"   
                   value="org.hibernate.search.event.FullTextIndexEventListener"/>  
         <property name="hibernate.ejb.event.post-delete"   
                   value="org.hibernate.search.event.FullTextIndexEventListener"/>