org.jomc.cli.commands

Class AbstractCommand

java.lang.Object

org.jomc.cli.commands.AbstractCommand

All Implemented Interfaces:

Command

Direct Known Subclasses:

AbstractModletCommand

public abstract class AbstractCommand
extends Object
implements Command

Base Command implementation.

Author:

Christian Schulte

Nested Class Summary

Nested classes/interfaces inherited from interface org.jomc.cli.Command

Command.Listener

Field Summary

Fields inherited from interface org.jomc.cli.Command

STATUS_FAILURE, STATUS_SUCCESS

Constructor Summary

Constructors

Constructor and Description
AbstractCommand() Creates a new AbstractCommand instance.

Method Summary

Methods

Modifier and Type	Method and Description
int	execute(CommandLine commandLine) Executes the command.
protected abstract void	executeCommand(CommandLine commandLine) Called by the execute method prior to the postExecuteCommand method.
static Level	getDefaultLogLevel() Gets the default log level events are logged at.
protected ExecutorService	getExecutorService(CommandLine commandLine) Gets the ExecutorService used to run tasks in parallel.
List<Command.Listener>	getListeners() Gets the list of registered listeners.
Level	getLogLevel() Gets the log level of the instance.
Options	getOptions() Gets the options of the command.
protected boolean	isLoggable(Level level) Checks if a message at a given level is provided to the listeners of the instance.
protected void	log(Level level, String message, Throwable throwable) Notifies registered listeners.
protected void	postExecuteCommand(CommandLine commandLine) Called by the execute method after the preExecuteCommand/executeCommand methods even if those methods threw an exception.
protected void	preExecuteCommand(CommandLine commandLine) Called by the execute method prior to the executeCommand method.
static void	setDefaultLogLevel(Level value) Sets the default log level events are logged at.
void	setLogLevel(Level value) Sets the log level of the instance.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.jomc.cli.Command

getAbbreviatedName, getLongDescription, getName, getShortDescription

Constructor Detail

AbstractCommand

public AbstractCommand()

Creates a new AbstractCommand instance.

Method Detail

getDefaultLogLevel

public static Level getDefaultLogLevel()

Gets the default log level events are logged at.

The default log level is controlled by system property org.jomc.cli.commands.AbstractCommand.defaultLogLevel holding the log level to log events at by default. If that property is not set, the WARNING default is returned.

Returns:

The log level events are logged at by default.

See Also:

getLogLevel(), Level.parse(java.lang.String)

setDefaultLogLevel

public static void setDefaultLogLevel(Level value)

Sets the default log level events are logged at.

Parameters:

value - The new default level events are logged at or null.

See Also:

getDefaultLogLevel()

getLogLevel

public final Level getLogLevel()

Gets the log level of the instance.

Specified by:

getLogLevel in interface Command

Returns:

The log level of the instance.

See Also:

getDefaultLogLevel(), setLogLevel(java.util.logging.Level), isLoggable(java.util.logging.Level)

setLogLevel

public final void setLogLevel(Level value)

Sets the log level of the instance.

Specified by:

setLogLevel in interface Command

Parameters:

value - The new log level of the instance or null.

See Also:

getLogLevel(), isLoggable(java.util.logging.Level)

getListeners

public final List<Command.Listener> getListeners()

Gets the list of registered listeners.

This accessor method returns a reference to the live list, not a snapshot. Therefore any modification you make to the returned list will be present inside the object. This is why there is no set method for the listeners property.

Specified by:

getListeners in interface Command

Returns:

The list of registered listeners.

See Also:

log(java.util.logging.Level, java.lang.String, java.lang.Throwable)

isLoggable

protected boolean isLoggable(Level level)

Checks if a message at a given level is provided to the listeners of the instance.

Parameters:

level - The level to test.

Returns:

true, if messages at level are provided to the listeners of the instance; false, if messages at level are not provided to the listeners of the instance.

Throws:

NullPointerException - if level is null.

See Also:

getLogLevel(), setLogLevel(java.util.logging.Level)

log

protected void log(Level level,
       String message,
       Throwable throwable)

Notifies registered listeners.

Parameters:

level - The level of the event.

message - The message of the event or null.

throwable - The throwable of the event null.

Throws:

NullPointerException - if level is null.

See Also:

getListeners(), isLoggable(java.util.logging.Level)

getOptions

public Options getOptions()

Description copied from interface: Command

Gets the options of the command.

Specified by:

getOptions in interface Command

Returns:

The options of the command.

getExecutorService

protected final ExecutorService getExecutorService(CommandLine commandLine)

Gets the ExecutorService used to run tasks in parallel.

Parameters:

commandLine - The CommandLine to use for setting up an executor service when not already created.

Returns:

The ExecutorService used to run tasks in parallel or null.

Since:

1.10

execute

public final int execute(CommandLine commandLine)

Description copied from interface: Command

Executes the command.

Specified by:

execute in interface Command

Parameters:

commandLine - Command line to execute.

Returns:

The status code to report.

See Also:

Command.STATUS_SUCCESS, Command.STATUS_FAILURE

preExecuteCommand

protected void preExecuteCommand(CommandLine commandLine)
                          throws CommandExecutionException

Called by the execute method prior to the executeCommand method.

Parameters:

commandLine - The command line to execute.

Throws:

NullPointerException - if commandLine is null.

CommandExecutionException - if executing the command fails.

See Also:

execute(org.apache.commons.cli.CommandLine)

executeCommand

protected abstract void executeCommand(CommandLine commandLine)
                                throws CommandExecutionException

Called by the execute method prior to the postExecuteCommand method.

Parameters:

commandLine - The command line to execute.

Throws:

CommandExecutionException - if executing the command fails.

See Also:

execute(org.apache.commons.cli.CommandLine)

postExecuteCommand

protected void postExecuteCommand(CommandLine commandLine)
                           throws CommandExecutionException

Called by the execute method after the preExecuteCommand/executeCommand methods even if those methods threw an exception.

Parameters:

commandLine - The command line to execute.

Throws:

NullPointerException - if commandLine is null.

CommandExecutionException - if executing the command fails.

See Also:

execute(org.apache.commons.cli.CommandLine)