<div dir="ltr" style="text-align: justify;">
<div dir="ltr" style="text-align: justify;">
<div dir="ltr" style="text-align: justify;">
<div dir="ltr" style="text-align: justify;">
<div dir="ltr" style="text-align: justify;">
<div dir="ltr" style="text-align: justify;">
<div dir="ltr" style="text-align: justify;">
<div dir="ltr" style="text-align: justify;">
<div dir="ltr" style="text-align: justify;">
<div class="separator" style="clear: both; text-align: center;"><img src="https://dineshonjava.com/wp-content/uploads/2013/07/hibernate-search-banner-1180px.png" border="0" /></div>
<p>Welcome to Hibernate Search Tutorial. In this hibernate search tutorial we will discuss about Hibernate 4 (<b>Hibernate Search API</b>). Actually Hibernate 4 provide some extra features related to searching than Hibernate 3. The following chapter will guide you through the initial steps required to integrate Hibernate Search into an existing Hibernate enabled application. In case you are new to Hibernate so we recommend you <b><a href="https://dineshonjava.com/2012/03/hibernate-3-on-baby-steps.html" target="_blank" rel="noopener">start here</a></b>.</p>
<p><i><b>Hibernate 4 = Hibernate 3 + Hibernate Search API(or Lucene API)</b></i></p>
<p>As see above in this tutorial we will discuss only about the Hibernate Search API. All hibernate functionality we already discuss in the <b><a href="https://dineshonjava.com/2012/03/hibernate-3-on-baby-steps.html" target="_blank" rel="noopener">Hibernate 3 on Baby Step tutorial</a></b>.</p>
<p><b>System Requirement for <i>Hibernate Search API</i>&#8211;</b></p>
</div>
<div id="ads-id" align="center"></div>
<p><b>1. Java Runtime:</b> A JDK or JRE version 6 or greater.<br />
You can download a Java Runtime for Windows/Linux/Solaris <b><a href="http://www.oracle.com/technetwork/java/%20javase/downloads/index.html">download here</a></b>.</p>
<p><b>2. Hibernate Search: <i>hibernate-search-4.2.0.Final.jar</i></b> and all runtime dependencies. You can get the jar artifacts either from the dist/lib directory of the <b><a href="http://sourceforge.net/projects/hibernate/files/hibernate-search/">Hibernate Search distribution</a></b>.</p>
<p><b>3. Hibernate Core:</b> These instructions have been tested against Hibernate 4.1. You will need <i><b>hibernate-core-4.1.9.Final.jar</b></i> and its <b>download here</b>.</p>
<p><b>4. JPA 2:</b> Even though Hibernate Search can be used without JPA annotations the following instructions will use them for basic entity configuration <i><b>(@Entity, @Id, @OneToMany,&#8230;</b></i>). This part of the configuration could also be expressed in xml or code. Hibernate Search, however, has also its own set of annotations (<i><b>@Indexed, @DocumentId, @Field,&#8230;)</b></i> for which there exists so far no XML based alternative.</p>
<p><b>Configuration for <i>Hibernate Search API</i>: </b>Once you have downloaded and added all required libs to your application you have to add a couple of properties to your hibernate configuration file (<i><b>hibernate.cfg.xml or hibernate.properties</b></i>)</p>
</div>
<pre class="highlight">... 
<;property name="hibernate.search.default.directory_provider" 
value="filesystem"/>; 
<;property name="hibernate.search.default.indexBase" 
value="D:dojuploadindex>; 
... 
</pre>
<p>First you have to tell Hibernate Search which <i><b>DirectoryProvider </b></i>to use. This can be achieved by setting the <i><b>hibernate.search.default.directory_provider</b></i> property. <b>Apache Lucene</b> has the notion of a Directory to store the index files. Hibernate Search handles the initialization and configuration of a Lucene Directory instance via a <i><b>DirectoryProvider</b></i>. In this tutorial we will use a a directory provider storing the index in the file system. This will give us the ability to physically inspect the Lucene indexes created by Hibernate Search.</p>
<pre class="highlight"><;?xml version='1.0' encoding='UTF-8'?>; 
<;!DOCTYPE hibernate-configuration PUBLIC 
 "-//Hibernate/Hibernate Configuration DTD 3.0//EN" 
 "http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd">; 
<;!-- Generated by MyEclipse Hibernate Tools. -->; 
<;hibernate-configuration>; 
 
 <;session-factory>; 
 <;!-- Database connection settings -->; 
 <;property name="connection.driver_class">;com.mysql.jdbc.Driver<;/property>; 
 <;property name="connection.url">;jdbc:mysql://localhost:3306/test<;/property>; 
 <;property name="connection.username">;root<;/property>; 
 <;property name="connection.password">;root<;/property>; 
 
 <;!-- JDBC connection pool (use the built-in) -->; 
 <;property name="connection.pool_size">;1<;/property>; 
 
 <;!-- SQL dialect -->; 
 <;property name="dialect">;org.hibernate.dialect.MySQLDialect<;/property>; 
 
 <;!-- Echo all executed SQL to stdout -->; 
 <;property name="show_sql">;true<;/property>; 
 <;property name="hbm2ddl.auto">;update<;/property>; 
 <;property name="hibernate.search.default.directory_provider">;filesystem<;/property>; 
 <;property name="hibernate.search.default.indexBase">;D:dojuploadindex<;/property>; 
 <;!-- Mapping files -->; 
 <;mapping class="com.dineshonjava.h4java.Book"/>; 
 
 <;/session-factory>; 
 
<;/hibernate-configuration>; 
</pre>
<p>Now next to the directory provider you also have to specify the default base directory for all indexes via <i><b>hibernate.search.default.indexBase</b></i>. Lets assume that your application contains the Hibernate managed classes <i><b>com.dineshonjava.h4java.Book</b></i> and you want to add free text search capabilities to your application in order to search the books contained in your database.</p>
<p><b>Example entities Book before adding Hibernate Search specific annotations:</b></p>
</div>
<pre class="highlight">package com.dineshonjava.h4java; 
... 
@Entity 
public class Book { 
@Id 
@GeneratedValue 
private Integer id; 
 
@Column 
private String title; 
@Column 
private String subtitle; 
@Column 
private Date publicationDate; 
 
public Book() {} 
public Integer getId() { 
 return id; 
 } 
 
 public void setId(Integer id) { 
 this.id = id; 
 } 
 
 public String getTitle() { 
 return title; 
 } 
 
 public void setTitle(String title) { 
 this.title = title; 
 } 
 
 public String getSubtitle() { 
 return subtitle; 
 } 
 
 public void setSubtitle(String subtitle) { 
 this.subtitle = subtitle; 
 } 
 
 public Date getPublicationDate() { 
 return publicationDate; 
 } 
 
 public void setPublicationDate(Date publicationDate) { 
 this.publicationDate = publicationDate; 
 } 
} 
</pre>
<p><i><b>@Indexed-</b></i><br />
To achieve this you have to add a few annotations to the <i><b>Book </b></i>class. The first annotation <i><b>@Indexed</b></i> marks <b>Book as indexable</b>. By design Hibernate Search needs to store an untokenized id in the index to ensure index unicity for a given entity.</p>
<p><i><b><i><b>@DocumentId-</b></i> </b></i><br />
<i><b>@DocumentId </b></i>marks the property to use for this purpose and is in most cases the same as the database primary key. The <i><b>@DocumentId</b></i> annotation is optional in the case where an <i><b>@Id </b></i>annotation exists.</p>
<p><i><b>@Field-</b></i><br />
<i><b> </b></i>Next you have to mark the fields you want to make searchable. Let&#8217;s start with title and subtitle and annotate both with <i><b>@Field</b></i>. The parameter <i><b>index=Index.YES</b></i> will ensure that the text will be indexed, while <i><b>analyze=Analyze.YES</b></i> ensures that the text will be analyzed using the default Lucene analyzer. Usually, analyzing means chunking a sentence into individual words and potentially excluding common words like &#8216;a&#8217; or &#8216;the&#8217;. The third parameter we specify within <i><b>@Field</b></i>, <i><b>store=Store.NO</b></i>, ensures that the actual<br />
data will not be stored in the index. Whether this data is stored in the index or not has nothing to do with the ability to search for it. From Lucene&#8217;s perspective it is not necessary to keep the data once the index is created.</p>
<p><b>Note that<i> index=Index.YES</i>, <i>analyze=Analyze.YES</i> and<i> store=Store.NO</i> are the default values for these parameters and could be omitted.</b></p>
<p><b>@DateBridge- </b><br />
Another annotation we have not yet discussed is <b>@DateBridge</b>. This annotation is one of the built-in field bridges in Hibernate Search. The Lucene index is purely string based. For this reason Hibernate Search must convert the data types of the indexed fields to strings and vice versa. A range of predefined bridges are provided, including the <i><b>DateBridge </b></i>which will convert a<b> java.util.Date into a String</b> with the specified resolution.</p>
<p><b>Example Book entities after adding Hibernate Search annotations:</b></p>
</div>
<pre class="highlight">package com.dineshonjava.h4java; 
 
import java.util.Date; 
 
import javax.persistence.Entity; 
import javax.persistence.GeneratedValue; 
import javax.persistence.Id; 
 
import org.apache.solr.analysis.LowerCaseFilterFactory; 
import org.apache.solr.analysis.SnowballPorterFilterFactory; 
import org.apache.solr.analysis.StandardTokenizerFactory; 
import org.hibernate.search.annotations.Analyze; 
import org.hibernate.search.annotations.AnalyzerDef; 
import org.hibernate.search.annotations.DateBridge; 
import org.hibernate.search.annotations.Field; 
import org.hibernate.search.annotations.Index; 
import org.hibernate.search.annotations.Indexed; 
import org.hibernate.search.annotations.Parameter; 
import org.hibernate.search.annotations.Resolution; 
import org.hibernate.search.annotations.Store; 
import org.hibernate.search.annotations.TokenFilterDef; 
import org.hibernate.search.annotations.TokenizerDef; 
 
 
@Entity 
@Indexed 
public class Book { 
 @Id 
 @GeneratedValue 
 private Integer id; 
 @Field(index = Index.YES, analyze = Analyze.YES, store = Store.NO) 
 private String title; 
 @Field(index = Index.YES, analyze = Analyze.YES, store = Store.NO) 
 private String subtitle; 
 @Field(index = Index.YES, analyze = Analyze.NO, store = Store.YES) 
 @DateBridge(resolution = Resolution.DAY) 
 private Date publicationDate; 
 
 public Book() { 
 } 
 
 public Integer getId() { 
 return id; 
 } 
 
 public void setId(Integer id) { 
 this.id = id; 
 } 
 
 public String getTitle() { 
 return title; 
 } 
 
 public void setTitle(String title) { 
 this.title = title; 
 } 
 
 public String getSubtitle() { 
 return subtitle; 
 } 
 
 public void setSubtitle(String subtitle) { 
 this.subtitle = subtitle; 
 } 
 
 public Date getPublicationDate() { 
 return publicationDate; 
 } 
 
 public void setPublicationDate(Date publicationDate) { 
 this.publicationDate = publicationDate; 
 } 
 
 @Override 
 public String toString() { 
 return "Book [id=" + id + ", title=" + title + ", subtitle=" + subtitle 
 + ", publicationDate=" + publicationDate + "]"; 
 } 
 
} 
</pre>
<p><b>Indexing-</b><br />
Hibernate Search will transparently index every entity persisted, updated or removed through Hibernate Core. However, you have to create an initial Lucene index for the data already present in your database. Once you have added the above properties and annotations it is time to trigger an initial batch index of your books.</p>
<pre class="highlight">FullTextSession fullTextSession = Search.getFullTextSession(session); 
fullTextSession.createIndexer().startAndWait(); 
</pre>
<p>After executing the above code, you should be able to see a Lucene index under &#8220;<i><b>D:dojuploadindexcom.dineshonjava.h4java.Book&#8221;</b></i></p>
<p><b>Searching-</b><br />
Now it is time to execute a first search. The general approach is to create a Lucene query and then wrap this query into a <i><b>org.hibernate.Query</b></i> in order to get all the functionality one is used to from the Hibernate API. The following code will prepare a query against the indexed fields, execute it and return a list of Books.</p>
</div>
<pre class="highlight">package com.dineshonjava.h4java; 
 
import java.util.Date; 
import java.util.Iterator; 
import java.util.List; 
 
import org.hibernate.Transaction; 
import org.hibernate.search.FullTextSession; 
import org.hibernate.search.query.dsl.QueryBuilder; 
 
 
public class App { 
public static void main(String[] args) { 
 org.hibernate.Session session=HibernateSessionFactory.getSession(); 
 try{ 
 Book book=new Book(); 
 book.setPublicationDate(new Date()); 
 book.setSubtitle("jsp"); 
 book.setTitle("tech"); 
 //session.saveOrUpdate(book); 
 FullTextSession fullTextSession = org.hibernate.search.Search.getFullTextSession(session); 
 Transaction tx = fullTextSession.beginTransaction(); 
 QueryBuilder qb = fullTextSession.getSearchFactory().buildQueryBuilder().forEntity( Book.class ).get(); 
 org.apache.lucene.search.Query query = qb.keyword().onFields("title", "subtitle").matching("jsp").createQuery(); 
 // wrap Lucene query in a org.hibernate.Query 
 org.hibernate.Query hibQuery = fullTextSession.createFullTextQuery(query, Book.class); 
 // execute search 
 List result = hibQuery.list(); 
 Iterator<;Book>; it = result.iterator(); 
 while (it.hasNext()) { 
 Book book1 = (Book) it.next(); 
 System.out.println(book1); 
 } 
 tx.commit(); 
 
 } 
 catch (Exception e) { 
 // TODO: handle exception 
 }finally{ 
 session.close(); 
 } 
 
 } 
} 
</pre>
</div>
<p><b>HibernateSessionFactory.java</b></p>
<pre class="highlight">package com.dineshonjava.h4java; 
 
import org.hibernate.HibernateException; 
import org.hibernate.Session; 
import org.hibernate.cfg.Configuration; 
 
/** 
 * Configures and provides access to Hibernate sessions, tied to the 
 * current thread of execution. Follows the Thread Local Session 
 * pattern, see {@link http://hibernate.org/42.html }. 
 */ 
public class HibernateSessionFactory { 
 
 /** 
 * Location of hibernate.cfg.xml file. 
 * Location should be on the classpath as Hibernate uses 
 * #resourceAsStream style lookup for its configuration file. 
 * The default classpath location of the hibernate config file is 
 * in the default package. Use #setConfigFile() to update 
 * the location of the configuration file for the current session. 
 */ 
 private static String CONFIG_FILE_LOCATION = "/hibernate.cfg.xml"; 
 private static final ThreadLocal<;Session>; threadLocal = new ThreadLocal<;Session>;(); 
 private static Configuration configuration = new Configuration(); 
 private static org.hibernate.SessionFactory sessionFactory; 
 private static String configFile = CONFIG_FILE_LOCATION; 
 
 static { 
 try { 
 configuration.configure(configFile); 
 sessionFactory = configuration.buildSessionFactory(); 
 } catch (Exception e) { 
 System.err 
 .println("%%%% Error Creating SessionFactory %%%%"); 
 e.printStackTrace(); 
 } 
 } 
 private HibernateSessionFactory() { 
 } 
 
 /** 
 * Returns the ThreadLocal Session instance. Lazy initialize 
 * the <;code>;SessionFactory<;/code>; if needed. 
 * 
 * @return Session 
 * @throws HibernateException 
 */ 
 public static Session getSession() throws HibernateException { 
 Session session = (Session) threadLocal.get(); 
 
 if (session == null || !session.isOpen()) { 
 if (sessionFactory == null) { 
 rebuildSessionFactory(); 
 } 
 session = (sessionFactory != null) ? sessionFactory.openSession() 
 : null; 
 threadLocal.set(session); 
 } 
 
 return session; 
 } 
 
 /** 
 * Rebuild hibernate session factory 
 * 
 */ 
 public static void rebuildSessionFactory() { 
 try { 
 configuration.configure(configFile); 
 sessionFactory = configuration.buildSessionFactory(); 
 } catch (Exception e) { 
 System.err 
 .println("%%%% Error Creating SessionFactory %%%%"); 
 e.printStackTrace(); 
 } 
 } 
 
 /** 
 * Close the single hibernate session instance. 
 * 
 * @throws HibernateException 
 */ 
 public static void closeSession() throws HibernateException { 
 Session session = (Session) threadLocal.get(); 
 threadLocal.set(null); 
 
 if (session != null) { 
 session.close(); 
 } 
 } 
 
 /** 
 * return session factory 
 * 
 */ 
 public static org.hibernate.SessionFactory getSessionFactory() { 
 return sessionFactory; 
 } 
 
 /** 
 * return session factory 
 * 
 * session factory will be rebuilded in the next call 
 */ 
 public static void setConfigFile(String configFile) { 
 HibernateSessionFactory.configFile = configFile; 
 sessionFactory = null; 
 } 
 
 /** 
 * return hibernate configuration 
 * 
 */ 
 public static Configuration getConfiguration() { 
 return configuration; 
 } 
 
} 
</pre>
</div>
<p>After running the above class file <i><b>App.java</b></i> we get data on the database <b>test </b>and table name <b>book</b>.</p>
<div class="separator" style="clear: both; text-align: center;"><img src="https://dineshonjava.com/wp-content/uploads/2013/07/h4.png" border="0" /></div>
<p>And now checking the indexing file in the <i><b>&#8220;D:dojuploadindexcom.dineshonjava.h4java.Book&#8221;.</b></i></p>
<div class="separator" style="clear: both; text-align: center;"><img src="https://dineshonjava.com/wp-content/uploads/2013/07/h41.png" border="0" /></div>
<p><b>Application Directory Structure and Jars files.</b></p>
<div class="separator" style="clear: both; text-align: center;"><img src="https://dineshonjava.com/wp-content/uploads/2013/07/h42.png" border="0" /></div>
<p><b>Output on Console&#8211;</b></p>
<div style="background-color: #ff99cc;">INFO: HHH000037: Columns: [id, title, subtitle, publicationdate]<br />
Jul 10, 2013 11:51:30 PM org.hibernate.tool.hbm2ddl.TableMetadata<br />
INFO: HHH000108: Foreign keys: []<br />
Jul 10, 2013 11:51:30 PM org.hibernate.tool.hbm2ddl.TableMetadata<br />
INFO: HHH000126: Indexes: [primary]<br />
Jul 10, 2013 11:51:30 PM org.hibernate.tool.hbm2ddl.SchemaUpdate execute<br />
INFO: HHH000232: Schema update complete<br />
Hibernate: select this_.id as id0_0_, this_.publicationDate as publicat2_0_0_, this_.subtitle as subtitle0_0_, this_.title as title0_0_ from Book this_ where (this_.id in (?))<br />
Book [id=1, title=tech, subtitle=jsp, publicationDate=2013-07-10 21:35:33.0]</div>
</div>
<p><i><b>Contents for Hibernate Search-</b></i></p>
<ul style="text-align: left;">
<li><b><a href="https://dineshonjava.com/architecture-of-hibernate-search/" target="_blank" rel="noopener">Architecture of Hibernate Search </a></b></li>
<li><b><a href="https://dineshonjava.com/configuration-for-hibernate-search/" target="_blank" rel="noopener">Configuration for Hibernate Search </a> </b></li>
<li><b><a href="https://dineshonjava.com/mapping-entities-to-index-structure/" target="_blank" rel="noopener">Mapping entities to the index structure</a></b></li>
</ul>
<p><b>Download Source Code + Libs</b><br />
<b><a href="https://sites.google.com/a/dineshonjava.com/dineshonjava/dineshonjava/Hibernate4Demo.zip?attredirects=0&;d=1" target="_blank" rel="nofollow noopener">Hibernate4Demo.zip</a></b></p>
<p><b></b><br />
<b></b><br />
<b></b><br />
<b><br />
</b> <b>References</b></p>
<ul class="unordered" style="-webkit-text-stroke-width: 0px; background-color: white; color: #232323; font-family: Arial, Helvetica, sans-serif; font-size: 13px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: 20px; list-style: inside url('http://cdn.srccodes.com/res/images/colors/sky-blue/bull.gif'); margin: 0px; orphans: auto; padding: 0px 0px 20px; text-align: left; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px;">
<li style="border-bottom-color: #d5d5d5; border-bottom-style: dashed; border-bottom-width: 1px; color: #232323; margin: 0px 0px 0px 20px; padding: 7px 0px;"><a style="color: #047fc8; margin: 0px; padding: 0px; text-align: left; text-decoration: none;" href="http://www.srccodes.com/p/article/7/Hibernate-Hello-World-example-using-Maven-build-tool-and-SQLite-database" target="_blank" rel="noopener">Hibernate Hello World example using Maven build tool and SQLite database</a></li>
<li style="border-bottom-color: #d5d5d5; border-bottom-style: dashed; border-bottom-width: 1px; color: #232323; margin: 0px 0px 0px 20px; padding: 7px 0px;"><a style="color: #047fc8; margin: 0px; padding: 0px; text-align: left; text-decoration: none;" href="http://docs.jboss.org/hibernate/orm/4.1/devguide/en-US/html/" target="_blank" rel="noopener">Hibernate Developer Guide</a></li>
<li style="border-bottom-color: #d5d5d5; border-bottom-style: dashed; border-bottom-width: 1px; color: #232323; margin: 0px 0px 0px 20px; padding: 7px 0px;"><a style="color: #047fc8; margin: 0px; padding: 0px; text-align: left; text-decoration: none;" href="http://docs.jboss.org/hibernate/search/4.1/reference/en-US/html_single/" target="_blank" rel="noopener">Hibernate Search</a></li>
</ul>
<p> ;</p>
</div>
<div class="wp-post-navigation"> 
									 <div class="wp-post-navigation-pre"> 
									 <a href="https://dineshonjava.com/how-to-solve-querysyntaxexception-table/">Previous</a> 
									 </div> 
									 <div class="wp-post-navigation-next"> 
									 <a href="https://dineshonjava.com/architecture-of-hibernate-search/">Next</a> 
									 </div> 
									</div>
<script type="text/javascript">
jQuery(document).ready(function($) {
 $.post('https://dineshonjava.com/wp-admin/admin-ajax.php', {action: 'mts_view_count', id: '398'});
});
</script>
Strategy Design Patterns We can easily create a strategy design pattern using lambda. To implement…
Decorator Pattern A decorator pattern allows a user to add new functionality to an existing…
Delegating pattern In software engineering, the delegation pattern is an object-oriented design pattern that allows…
Technology has emerged a lot in the last decade, and now we have artificial intelligence;…
Managing a database is becoming increasingly complex now due to the vast amount of data…
Overview In this article, we will explore Spring Scheduler how we could use it by…