liquibase.command

Interface CommandStep

All Known Implementing Classes:

AbstractCliWrapperCommandStep, AbstractCommandStep, CalculateChecksumCommandStep, ChangelogSyncCommandStep, ChangelogSyncSqlCommandStep, ChangelogSyncToTagCommandStep, ChangelogSyncToTagSqlCommandStep, ClearChecksumsCommandStep, ConvertCommandStep, DbDocCommandStep, DeactivateChangelogCommandStep, DiffChangelogCommandStep, DiffCommandStep, DropAllCommandStep, ExecuteSqlCommandStep, FutureRollbackCountSqlCommandStep, FutureRollbackFromTagSqlCommandStep, FutureRollbackSqlCommandStep, GenerateChangelogCommandStep, HistoryCommandStep, InternalDiffChangelogCommandStep, InternalDiffCommandStep, InternalDropAllCommandStep, InternalExecuteSqlCommandStep, InternalGenerateChangelogCommandStep, InternalHistoryCommandStep, InternalSnapshotCommandStep, InternalSyncHubCommandStep, ListLocksCommandStep, MarkNextChangesetRanCommandStep, MarkNextChangesetRanSqlCommandStep, RegisterChangelogCommandStep, ReleaseLocksCommandStep, RollbackCommandStep, RollbackCountCommandStep, RollbackCountSqlCommandStep, RollbackSqlCommandStep, RollbackToDateCommandStep, RollbackToDateSqlCommandStep, SnapshotCommandStep, SnapshotReferenceCommandStep, StartH2CommandStep, StatusCommandStep, SyncHubCommandStep, TagCommandStep, TagExistsCommandStep, TestSystemDownCommand, TestSystemUpCommand, UnexpectedChangesetsCommandStep, UpdateCommandStep, UpdateCountCommandStep, UpdateCountSqlCommandStep, UpdateSqlCommandStep, UpdateTestingRollbackCommandStep, UpdateToTagCommandStep, UpdateToTagSqlCommandStep, ValidateCommandStep

public interface CommandStep

Defines a particular step in a command pipeline. When a command is executed, Liquibase will find all the steps whose defineCommandNames() matches the command and run them in getOrder(CommandDefinition) order.

See Also:

CommandScope.execute()

Field Summary

Fields

Modifier and Type	Field and Description
static int	ORDER_DEFAULT Returned by getOrder(CommandDefinition) if you are unsure where in the pipeline your step should go, use this value.
static int	ORDER_NOT_APPLICABLE Returned by getOrder(CommandDefinition) if this step should not be a part of the pipeline.

Method Summary

Modifier and Type	Method and Description
void	adjustCommandDefinition(CommandDefinition commandDefinition) Called by the command pipeline setup to adjust the CommandDefinition metadata about the overall command.
String[][]	defineCommandNames() Defines new command names For example, if it is part of `liquibase update`, this should return new String[][]{ new String[] {"update"}}.
int	getOrder(CommandDefinition commandDefinition) The order in the pipeline that this step should be executed in.
void	run(CommandResultsBuilder resultsBuilder) Performs the business logic.
void	validate(CommandScope commandScope) Validates that the CommandScope is correctly set up for this step to run.

Field Detail

ORDER_DEFAULT

static final int ORDER_DEFAULT

Returned by getOrder(CommandDefinition) if you are unsure where in the pipeline your step should go, use this value.

See Also:

Constant Field Values

ORDER_NOT_APPLICABLE

static final int ORDER_NOT_APPLICABLE

Returned by getOrder(CommandDefinition) if this step should not be a part of the pipeline.

See Also:

Constant Field Values

Method Detail

defineCommandNames

String[][] defineCommandNames()

Defines new command names For example, if it is part of `liquibase update`, this should return new String[][]{ new String[] {"update"}}. If it is a part of `liquibase example init`, this should return {"example", "init"}.

This is used to determine the available command names.

This can return null if this step is not defining a new command but "cross-cutting" existing commands.

getOrder

int getOrder(CommandDefinition commandDefinition)

The order in the pipeline that this step should be executed in. Logic is generally based off CommandDefinition.getName() but it can check other things in the definition such as arguments.

Returns:

-1 if this step does not apply to the given command

adjustCommandDefinition

void adjustCommandDefinition(CommandDefinition commandDefinition)

Called by the command pipeline setup to adjust the CommandDefinition metadata about the overall command. This method should not be called directly. It is called by the overall pipeline logic in the getOrder(CommandDefinition) order.

validate

void validate(CommandScope commandScope)
       throws CommandValidationException

Validates that the CommandScope is correctly set up for this step to run. Any validation in CommandArgumentDefinition.validate(CommandScope) will be checked previous to this method being called. This method should not be called directly. It is called by the overall pipeline logic in the getOrder(CommandDefinition) order.

Throws:

CommandValidationException

run

void run(CommandResultsBuilder resultsBuilder)
  throws Exception

Performs the business logic. This method should not be called directly. It is called by the overall pipeline logic in the getOrder(CommandDefinition) order.

Throws:

Exception