liquibase.changelog.visitor

Class DefaultChangeExecListener

java.lang.Object

liquibase.changelog.visitor.DefaultChangeExecListener

All Implemented Interfaces:

ChangeExecListener

public class DefaultChangeExecListener
extends Object
implements ChangeExecListener

A wrapper ChangeExecListener who keeps track of deployed and failed ChangeSets, while also delegating listener actions to any other ChangeExecListener included when the object is constructed.

Constructor Summary

Constructors

Constructor and Description
DefaultChangeExecListener(ChangeExecListener... listeners)

Method Summary

Modifier and Type	Method and Description
void	addListener(ChangeExecListener listener)
List<Change>	getDeployedChanges(ChangeSet changeSet) Gets list of Changes deployed during the current ChangeSet execution.
List<ChangeSet>	getDeployedChangeSets() Get the list of ChangeSets that have been deployed during a given Liquibase command.
List<ChangeSet>	getFailedChangeSets() Gets list of failed ChangeSets encountered during a given Liquibase command.
void	preconditionErrored(PreconditionErrorException error, PreconditionContainer.ErrorOption onError)
void	preconditionFailed(PreconditionFailedException error, PreconditionContainer.FailOption onFail)
void	ran(Change change, ChangeSet changeSet, DatabaseChangeLog changeLog, Database database)
void	ran(ChangeSet changeSet, DatabaseChangeLog databaseChangeLog, Database database, ChangeSet.ExecType execType) Called after the given changeset is run.
void	rollbackFailed(ChangeSet changeSet, DatabaseChangeLog databaseChangeLog, Database database, Exception exception)
void	rolledBack(ChangeSet changeSet, DatabaseChangeLog databaseChangeLog, Database database) Called after a change is rolled back.
void	runFailed(ChangeSet changeSet, DatabaseChangeLog databaseChangeLog, Database database, Exception exception)
void	willRollback(ChangeSet changeSet, DatabaseChangeLog databaseChangeLog, Database database) Called before a change is rolled back.
void	willRun(Change change, ChangeSet changeSet, DatabaseChangeLog changeLog, Database database)
void	willRun(ChangeSet changeSet, DatabaseChangeLog databaseChangeLog, Database database, ChangeSet.RunStatus runStatus) Called just before a given changeset is run.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultChangeExecListener

public DefaultChangeExecListener(ChangeExecListener... listeners)

Method Detail

willRun

public void willRun(ChangeSet changeSet,
                    DatabaseChangeLog databaseChangeLog,
                    Database database,
                    ChangeSet.RunStatus runStatus)

Description copied from interface: ChangeExecListener

Called just before a given changeset is run.

Specified by:

willRun in interface ChangeExecListener

Parameters:

changeSet - that will be run

databaseChangeLog - parent changelog

database - the database the change will be run against

runStatus - of the current change from the database

ran

public void ran(ChangeSet changeSet,
                DatabaseChangeLog databaseChangeLog,
                Database database,
                ChangeSet.ExecType execType)

Description copied from interface: ChangeExecListener

Called after the given changeset is run.

Specified by:

ran in interface ChangeExecListener

Parameters:

changeSet - changeSet that was run

databaseChangeLog - the parent changelog

database - the database the change was run against

execType - is the result

willRollback

public void willRollback(ChangeSet changeSet,
                         DatabaseChangeLog databaseChangeLog,
                         Database database)

Description copied from interface: ChangeExecListener

Called before a change is rolled back.

Specified by:

willRollback in interface ChangeExecListener

Parameters:

changeSet - changeSet that was rolled back

databaseChangeLog - parent change log

database - the database the rollback was executed on.

rolledBack

public void rolledBack(ChangeSet changeSet,
                       DatabaseChangeLog databaseChangeLog,
                       Database database)

Description copied from interface: ChangeExecListener

Called after a change is rolled back.

Specified by:

rolledBack in interface ChangeExecListener

Parameters:

changeSet - changeSet that was rolled back

databaseChangeLog - parent change log

database - the database the rollback was executed on.

preconditionFailed

public void preconditionFailed(PreconditionFailedException error,
                               PreconditionContainer.FailOption onFail)

Specified by:

preconditionFailed in interface ChangeExecListener

preconditionErrored

public void preconditionErrored(PreconditionErrorException error,
                                PreconditionContainer.ErrorOption onError)

Specified by:

preconditionErrored in interface ChangeExecListener

willRun

public void willRun(Change change,
                    ChangeSet changeSet,
                    DatabaseChangeLog changeLog,
                    Database database)

Specified by:

willRun in interface ChangeExecListener

ran

public void ran(Change change,
                ChangeSet changeSet,
                DatabaseChangeLog changeLog,
                Database database)

Specified by:

ran in interface ChangeExecListener

runFailed

public void runFailed(ChangeSet changeSet,
                      DatabaseChangeLog databaseChangeLog,
                      Database database,
                      Exception exception)

Specified by:

runFailed in interface ChangeExecListener

rollbackFailed

public void rollbackFailed(ChangeSet changeSet,
                           DatabaseChangeLog databaseChangeLog,
                           Database database,
                           Exception exception)

Specified by:

rollbackFailed in interface ChangeExecListener

getDeployedChangeSets

public List<ChangeSet> getDeployedChangeSets()

Get the list of ChangeSets that have been deployed during a given Liquibase command. For example: if you ran update with three ChangeSets in total and the third ChangeSet failed, this list will contain the first two ChangeSets that were executed without exception.

Returns:

the list of ChangeSets deployed during a command.

getFailedChangeSets

public List<ChangeSet> getFailedChangeSets()

Gets list of failed ChangeSets encountered during a given Liquibase command.

Returns:

the list of ChangeSets which have failed to deploy.

getDeployedChanges

public List<Change> getDeployedChanges(ChangeSet changeSet)

Gets list of Changes deployed during the current ChangeSet execution. This list is dynamic and will update depending on where in the lifecycle this is being called.

Parameters:

changeSet - the ChangeSet to find deployed changes from.

Returns:

the list of Changes which have deployed from the given ChangeSet. List will be empty if changes have not deployed from requested ChangeSet.

addListener

public void addListener(ChangeExecListener listener)