liquibase.command

Class CommandScope

java.lang.Object

liquibase.command.CommandScope

public class CommandScope
extends Object

The primary facade used for executing commands. This object gets configured with the command to run and the input arguments associated with it, then is populated with the result output after execute() is called.

Named similarly to Scope because they both define a self-contained unit of values, but this scope is specific to a command rather than being a global scope.

Constructor Summary

Constructors

Constructor and Description
CommandScope(String... commandName) Creates a new scope for the given command.

Method Summary

Modifier and Type	Method and Description
<T> CommandScope	addArgumentValue(CommandArgumentDefinition<T> argument, T value) Adds the given key/value pair to the stored argument data.
CommandScope	addArgumentValue(String argument, Object value) Adds the given key/value pair to the stored argument data.
CommandResults	execute() Executes the command in this scope, and returns the results.
<T> T	getArgumentValue(CommandArgumentDefinition<T> argument) Convenience method for getConfiguredValue(CommandArgumentDefinition), returning ConfiguredValue.getValue() along with any CommandArgumentDefinition.getValueConverter() applied
CommandDefinition	getCommand() Returns the CommandDefinition for the command in this scope.
<T> ConfiguredValue<T>	getConfiguredValue(CommandArgumentDefinition<T> argument) Returns the detailed information about how an argument is set.
CommandScope	setOutput(OutputStream outputStream) Sets the output stream for this command.

Methods inherited from class java.lang.Object

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

Constructor Detail

CommandScope

public CommandScope(String... commandName)
             throws CommandExecutionException

Creates a new scope for the given command.

Throws:

CommandExecutionException

Method Detail

getCommand

public CommandDefinition getCommand()

Returns the CommandDefinition for the command in this scope.

addArgumentValue

public CommandScope addArgumentValue(String argument,
                                     Object value)

Adds the given key/value pair to the stored argument data.

See Also:

for a type-safe version

addArgumentValue

public <T> CommandScope addArgumentValue(CommandArgumentDefinition<T> argument,
                                         T value)

Adds the given key/value pair to the stored argument data.

getConfiguredValue

public <T> ConfiguredValue<T> getConfiguredValue(CommandArgumentDefinition<T> argument)

Returns the detailed information about how an argument is set.

Prefers values set with addArgumentValue(String, Object), but will also check LiquibaseConfiguration for settings of liquibase.command.${commandName(s)}.${argumentName} or liquibase.command.${argumentName}

getArgumentValue

public <T> T getArgumentValue(CommandArgumentDefinition<T> argument)

Convenience method for getConfiguredValue(CommandArgumentDefinition), returning ConfiguredValue.getValue() along with any CommandArgumentDefinition.getValueConverter() applied

setOutput

public CommandScope setOutput(OutputStream outputStream)

Sets the output stream for this command. The command output sent to this stream should not include status/progress type output, only the actual output itself. Think "what would be piped out", not "what the user is told about what is happening".

execute

public CommandResults execute()
                       throws CommandExecutionException

Executes the command in this scope, and returns the results.

Throws:

CommandExecutionException