Package org.minijax.liquibase

Class LiquibaseHelper

java.lang.Object

org.minijax.liquibase.LiquibaseHelper

public class LiquibaseHelper
extends java.lang.Object

The LiquibaseHelper class provides helpers to migrate a database and generate new migrations. It is a thin layer that wraps JPA and Liquibase. By default, migrations are added to src/main/resources/changelog.xml. The recommended workflow is to (1) generate a migration, (2) manually inspect the migration, and (3) run the migration if everything looks ok.

Constructor Summary

Constructors

Constructor	Description
LiquibaseHelper(java.util.Map<java.lang.String,java.lang.String> props)	Creates a new helper.

Method Summary

Modifier and Type	Method	Description
void	generateMigrations()
static java.lang.String	getAuthor(java.lang.String userName)	Returns the migration author name.
java.lang.String	getChangeLogResourceName()
java.io.File	getResourcesDir()
static boolean	isIgnoredChangeSet(liquibase.changelog.ChangeSet changeSet)	Returns true if the change set should be ignored.
void	migrate()	Helper utility to perform a Liquibase database migration.

Methods inherited from class java.lang.Object

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

Constructor Detail

LiquibaseHelper

public LiquibaseHelper(java.util.Map<java.lang.String,java.lang.String> props)

Creates a new helper.

Parameters:

props -

Method Detail

getResourcesDir

public java.io.File getResourcesDir()

getChangeLogResourceName

public java.lang.String getChangeLogResourceName()

migrate

public void migrate()
             throws liquibase.exception.LiquibaseException,
                    java.sql.SQLException

Helper utility to perform a Liquibase database migration.

Throws:

liquibase.exception.LiquibaseException

java.sql.SQLException

See Also:

Liquibase.update(String)

generateMigrations

public void generateMigrations()
                        throws java.io.IOException,
                               liquibase.exception.LiquibaseException,
                               java.sql.SQLException

Throws:

java.io.IOException

liquibase.exception.LiquibaseException

java.sql.SQLException

getAuthor

public static java.lang.String getAuthor(java.lang.String userName)

Returns the migration author name. Tries to generate it from the system user name.

Parameters:

userName - The current user name.

Returns:

The author name.

isIgnoredChangeSet

public static boolean isIgnoredChangeSet(liquibase.changelog.ChangeSet changeSet)

Returns true if the change set should be ignored. Most tables are managed by JPA. When we create the temporary "goal" database, JPA creates all of the tables for a normal happy path diff. If using JGroups, there is an extra table created called "JGROUPSPING" which tracks all of the members of the JGroups cluster. Because this table is not managed by JPA, it is absent from the "goal" database. Therefore liquibase always tries to drop the table. We need to ignore that.

Parameters:

changeSet - The candidate change set.

Returns:

True if the change set should be ignored.