liquibase.integration.spring

Class SpringLiquibase

java.lang.Object

liquibase.integration.spring.SpringLiquibase

All Implemented Interfaces:

org.springframework.beans.factory.Aware, org.springframework.beans.factory.BeanNameAware, org.springframework.beans.factory.InitializingBean, org.springframework.context.ResourceLoaderAware

public class SpringLiquibase
extends Object
implements org.springframework.beans.factory.InitializingBean, org.springframework.beans.factory.BeanNameAware, org.springframework.context.ResourceLoaderAware

A Spring-ified wrapper for Liquibase.

Example Configuration:

This Spring configuration example will cause liquibase to run automatically when the Spring context is initialized. It will load db-changelog.xml from the classpath and apply it against myDataSource.

 <bean id="myLiquibase"
          class="liquibase.spring.SpringLiquibase"
          >

      <property name="dataSource" ref="myDataSource" />

      <property name="changeLog" value="classpath:db-changelog.xml" />

 </bean>

 

Field Summary

Fields

Modifier and Type	Field and Description
protected String	beanName
protected String	changeLog
protected boolean	clearCheckSums
protected String	contexts
protected String	databaseChangeLogLockTable
protected String	databaseChangeLogTable
protected DataSource	dataSource
protected String	defaultSchema
protected boolean	dropFirst
protected String	labelFilter
protected String	liquibaseSchema
protected String	liquibaseTablespace
protected Logger	log
protected Map<String,String>	parameters
protected org.springframework.core.io.ResourceLoader	resourceLoader
protected File	rollbackFile
protected boolean	shouldRun
protected String	tag
protected boolean	testRollbackOnUpdate

Constructor Summary

Constructors

Constructor and Description
SpringLiquibase()

Method Summary

Modifier and Type	Method and Description
void	afterPropertiesSet() Executed automatically when the bean is initialized.
protected Database	createDatabase(Connection c, ResourceAccessor resourceAccessor) Subclasses may override this method add change some database settings such as default schema before returning the database object.
protected Liquibase	createLiquibase(Connection c)
protected SpringResourceAccessor	createResourceOpener() Create a new resourceOpener.
String	getBeanName() Gets the Spring-name of this instance.
String	getChangeLog() Returns a Resource that is able to resolve to a file or classpath resource.
String	getContexts()
String	getDatabaseChangeLogLockTable()
String	getDatabaseChangeLogTable()
String	getDatabaseProductName()
DataSource	getDataSource() The DataSource that liquibase will use to perform the migration.
String	getDefaultSchema()
String	getLabelFilter()
String	getLabels() Deprecated. use getLabelFilter()
String	getLiquibaseSchema()
String	getLiquibaseTablespace()
org.springframework.core.io.ResourceLoader	getResourceLoader()
String	getTag()
boolean	isClearCheckSums()
boolean	isDropFirst()
boolean	isIgnoreClasspathPrefix()
boolean	isTestRollbackOnUpdate() Returns whether a rollback should be tested at update time or not.
protected void	performUpdate(Liquibase liquibase)
void	setBeanName(String name) Spring sets this automatically to the instance's configured bean name.
void	setChangeLog(String dataModel) Sets a Spring Resource that is able to resolve to a file or classpath resource.
void	setChangeLogParameters(Map<String,String> parameters)
void	setClearCheckSums(boolean clearCheckSums)
void	setContexts(String contexts)
void	setDatabaseChangeLogLockTable(String databaseChangeLogLockTable)
void	setDatabaseChangeLogTable(String databaseChangeLogTable)
void	setDataSource(DataSource dataSource) The DataSource that liquibase will use to perform the migration.
void	setDefaultSchema(String defaultSchema)
void	setDropFirst(boolean dropFirst)
void	setIgnoreClasspathPrefix(boolean ignoreClasspathPrefix) Deprecated. Always ignoring classpath prefix
void	setLabelFilter(String labelFilter)
void	setLabels(String labels) Deprecated. use setLabelFilter(String)
void	setLiquibaseSchema(String liquibaseSchema)
void	setLiquibaseTablespace(String liquibaseTablespace)
void	setResourceLoader(org.springframework.core.io.ResourceLoader resourceLoader)
void	setRollbackFile(File rollbackFile)
void	setShouldRun(boolean shouldRun)
void	setTag(String tag)
void	setTestRollbackOnUpdate(boolean testRollbackOnUpdate) If testRollbackOnUpdate is set to true a rollback will be tested at update time.
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

log

protected final Logger log

beanName

protected String beanName

resourceLoader

protected org.springframework.core.io.ResourceLoader resourceLoader

dataSource

protected DataSource dataSource

changeLog

protected String changeLog

contexts

protected String contexts

labelFilter

protected String labelFilter

tag

protected String tag

parameters

protected Map<String,String> parameters

defaultSchema

protected String defaultSchema

liquibaseSchema

protected String liquibaseSchema

databaseChangeLogTable

protected String databaseChangeLogTable

databaseChangeLogLockTable

protected String databaseChangeLogLockTable

liquibaseTablespace

protected String liquibaseTablespace

dropFirst

protected boolean dropFirst

clearCheckSums

protected boolean clearCheckSums

shouldRun

protected boolean shouldRun

rollbackFile

protected File rollbackFile

testRollbackOnUpdate

protected boolean testRollbackOnUpdate

Constructor Detail

SpringLiquibase

public SpringLiquibase()

Method Detail

isDropFirst

public boolean isDropFirst()

setDropFirst

public void setDropFirst(boolean dropFirst)

isClearCheckSums

public boolean isClearCheckSums()

setClearCheckSums

public void setClearCheckSums(boolean clearCheckSums)

setShouldRun

public void setShouldRun(boolean shouldRun)

getDatabaseProductName

public String getDatabaseProductName()
                              throws DatabaseException

Throws:

DatabaseException

getDataSource

public DataSource getDataSource()

The DataSource that liquibase will use to perform the migration.

setDataSource

public void setDataSource(DataSource dataSource)

The DataSource that liquibase will use to perform the migration.

getChangeLog

public String getChangeLog()

Returns a Resource that is able to resolve to a file or classpath resource.

setChangeLog

public void setChangeLog(String dataModel)

Sets a Spring Resource that is able to resolve to a file or classpath resource. An example might be classpath:db-changelog.xml.

getContexts

public String getContexts()

setContexts

public void setContexts(String contexts)

getLabels

public String getLabels()

Deprecated. use getLabelFilter()

setLabels

public void setLabels(String labels)

Deprecated. use setLabelFilter(String)

getLabelFilter

public String getLabelFilter()

setLabelFilter

public void setLabelFilter(String labelFilter)

getTag

public String getTag()

setTag

public void setTag(String tag)

getDefaultSchema

public String getDefaultSchema()

setDefaultSchema

public void setDefaultSchema(String defaultSchema)

getLiquibaseTablespace

public String getLiquibaseTablespace()

setLiquibaseTablespace

public void setLiquibaseTablespace(String liquibaseTablespace)

getLiquibaseSchema

public String getLiquibaseSchema()

setLiquibaseSchema

public void setLiquibaseSchema(String liquibaseSchema)

getDatabaseChangeLogTable

public String getDatabaseChangeLogTable()

setDatabaseChangeLogTable

public void setDatabaseChangeLogTable(String databaseChangeLogTable)

getDatabaseChangeLogLockTable

public String getDatabaseChangeLogLockTable()

setDatabaseChangeLogLockTable

public void setDatabaseChangeLogLockTable(String databaseChangeLogLockTable)

isTestRollbackOnUpdate

public boolean isTestRollbackOnUpdate()

Returns whether a rollback should be tested at update time or not.

setTestRollbackOnUpdate

public void setTestRollbackOnUpdate(boolean testRollbackOnUpdate)

If testRollbackOnUpdate is set to true a rollback will be tested at update time. For doing so when the update is performed

Parameters:

testRollbackOnUpdate -

afterPropertiesSet

public void afterPropertiesSet()
                        throws LiquibaseException

Executed automatically when the bean is initialized.

Specified by:

afterPropertiesSet in interface org.springframework.beans.factory.InitializingBean

Throws:

LiquibaseException

performUpdate

protected void performUpdate(Liquibase liquibase)
                      throws LiquibaseException

Throws:

LiquibaseException

createLiquibase

protected Liquibase createLiquibase(Connection c)
                             throws LiquibaseException

Throws:

LiquibaseException

createDatabase

protected Database createDatabase(Connection c,
                                  ResourceAccessor resourceAccessor)
                           throws DatabaseException

Subclasses may override this method add change some database settings such as default schema before returning the database object.

Parameters:

c -

Returns:

a Database implementation retrieved from the DatabaseFactory.

Throws:

DatabaseException

setChangeLogParameters

public void setChangeLogParameters(Map<String,String> parameters)

createResourceOpener

protected SpringResourceAccessor createResourceOpener()

Create a new resourceOpener.

getBeanName

public String getBeanName()

Gets the Spring-name of this instance.

Returns:

setBeanName

public void setBeanName(String name)

Spring sets this automatically to the instance's configured bean name.

Specified by:

setBeanName in interface org.springframework.beans.factory.BeanNameAware

getResourceLoader

public org.springframework.core.io.ResourceLoader getResourceLoader()

setResourceLoader

public void setResourceLoader(org.springframework.core.io.ResourceLoader resourceLoader)

Specified by:

setResourceLoader in interface org.springframework.context.ResourceLoaderAware

setRollbackFile

public void setRollbackFile(File rollbackFile)

isIgnoreClasspathPrefix

public boolean isIgnoreClasspathPrefix()

setIgnoreClasspathPrefix

public void setIgnoreClasspathPrefix(boolean ignoreClasspathPrefix)

Deprecated. Always ignoring classpath prefix

toString

public String toString()

Overrides:

toString in class Object