Wednesday, August 29, 2012

How to integrate Liquibase with Spring and Hibernate ?

A sample tutorial on how to integrate Liquibase with Spring and Hibernate.

While writing this tutorial, I have added javadoc in the code for better understanding and I believe You already have good knowledge on Spring and Hibernate. The main motto of this tutorial is to give an idea on how you can integrate Liquibase with Spring and Hibernate.

If you are new to Liquibase : Click Here

To integrate liquibase into your project, you need liquibase jars, So download it before starting the project.

I have created an application named "SHLIntegration". The Structure of the project is as follows :

The dependencies are also listed here:

Lets start with Employee class :

1. Create Employee class having getter/setter and add proper JPA annotation to each variable as below.

  public class Employee {

    private long id;

    private String name;
    private String gender;
    private String country;
    private String aboutYou;

.... // getter setter of each object


2. Create liquibase file i,e db-changelog.xml file

<?xml version="1.0" encoding="UTF-8"?>
<databaseChangeLog xmlns=""
    <changeSet author="waheed" id="123456789-1">
        <createTable tableName="EMPLOYEE">
            <column autoIncrement="true" name="EMPLOYEE_ID" type="BIGINT">
                <constraints nullable="false" primaryKey="true" />
            <column name="NAME" type="VARCHAR(255)" />
            <column name="GENDER" type="VARCHAR(2)" />
            <column name="COUNTRY" type="VARCHAR(255)" />
            <column name="ABOUT_YOU" type="VARCHAR(255)" />

3. Add liquibase bean in your bean :

    <bean id="LiquibaseUpdater" class="liquibase.integration.spring.SpringLiquibase">
        <property name="dataSource" ref="dataSource" />
        <property name="changeLog" value="classpath:db-changelog.xml" />

 and others beans which are required for Spring/Hibernate.  Check bean file

The complete tutorial :

Please feel free to do comment or drop me a mail regarding any suggestion/Feedback.
Email :



  1. Why is hbm2ddl set to create? How does creating liquibase bean is sufficient for integration?

  2. hbm2ddl can be create or update. I guess u have missed "dataSource" property in bean. dataSource is another bean where you are configuring your database details. Adding database mapping file i,e db-changelog.xml.

    Check source code for better understanding.

  3. Hi.

    I have the same question : Why is hbm2ddl set to create?

    In create mode, it's hibernate that create tables and update database structure, isn't it ? So if I declare a create table in my changelog, liquibase will fail because this table already exists...

    But at same time, if i try to set the property to validate, hibernate fails before liquibase run, because it misses tables...

    Can you explain to me ?

  4. This site is so amazing, This sites gives good knowledge of spring-hibernate ,This is very helpful for me. Here all content so useful and helpful for beginner and experience both.


How TOPT Works: Generating OTPs Without Internet Connection

Introduction Have you ever wondered how authentication apps like RSA Authenticator generate One-Time Passwords (OTPs) without requiring an i...