Interface CommandRunner


@Contract public interface CommandRunner
CommandRunner is a service that allows you to run administrative commands.
Author:
Jerome Dochez
  • Method Details

    • getActionReport

      ActionReport getActionReport(String name)
      Returns an initialized ActionReport instance for the passed type or null if it cannot be found.
      Parameters:
      name - actiopn report type name
      Returns:
      uninitialized action report or null
    • getModel

      CommandModel getModel(String name, Logger logger)
      Returns the command model for a command name for the null scope
      Parameters:
      name - command name
      logger - logger to log any error messages
      Returns:
      model for this command (list of parameters,etc...), null if command is not found
    • getModel

      CommandModel getModel(String scope, String name, Logger logger)
      Returns the command model for a command name
      Parameters:
      scope - the scope (or namespace) for the command
      name - command name
      logger - logger to log any error messages
      Returns:
      model for this command (list of parameters,etc...), null if command is not found
    • getHelp

      BufferedReader getHelp(CommandModel model)
      Returns manpage for the command.
      Parameters:
      model - of command
      Returns:
      Formated manpage
    • validateCommandModelETag

      boolean validateCommandModelETag(AdminCommand command, String eTag)
      Checks if given command model eTag is equal to current command model eTag
      Parameters:
      command - Command to be checked
      eTag - ETag to validate
    • validateCommandModelETag

      boolean validateCommandModelETag(CommandModel model, String eTag)
      Checks if given command model eTag is equal to current command model eTag
      Parameters:
      model - of command to be checked
      eTag - ETag to validate
    • getCommand

      AdminCommand getCommand(String commandName, ActionReport report, Logger logger)
      Obtain and return the command implementation defined by the passed commandName for the null scope
      Parameters:
      commandName - command name as typed by users
      report - report used to communicate command status back to the user
      logger - logger to log
      Returns:
      command registered under commandName or null if not found.
    • getCommand

      AdminCommand getCommand(String scope, String commandName, ActionReport report, Logger logger)
      Obtain and return the command implementation defined by the passed commandName
      Parameters:
      scope - the scope (or namespace) for the command
      commandName - command name as typed by users
      report - report used to communicate command status back to the user
      logger - logger to log
      Returns:
      command registered under commandName or null if not found.
    • getCommandInvocation

      CommandRunner.CommandInvocation getCommandInvocation(String name, ActionReport report, Subject subject)
      Obtain a new command invocation object for the null scope. Command invocations can be configured and used to trigger a command execution.
      Parameters:
      name - name of the requested command to invoke
      report - where to place the status of the command execution
      subject - the Subject under which to execute the command
      Returns:
      a new command invocation for that command name.
    • getCommandInvocation

      CommandRunner.CommandInvocation getCommandInvocation(String scope, String name, ActionReport report, Subject subject)
      Obtain a new command invocation object. Command invocations can be configured and used to trigger a command execution.
      Parameters:
      scope - the scope (or namespace) for the command
      name - name of the requested command to invoke
      report - where to place the status of the command execution
      subject - the Subject under which to execute the command
      Returns:
      a new command invocation for that command name.
    • getCommandInvocation

      CommandRunner.CommandInvocation getCommandInvocation(String name, ActionReport report, Subject subject, boolean isNotify)
      Obtain a new command invocation object for the null scope. Command invocations can be configured and used to trigger a command execution.
      Parameters:
      name - name of the requested command to invoke
      report - where to place the status of the command execution
      subject - the Subject under which to execute the command
      isNotify - should notification be enabled
      Returns:
      a new command invocation for that command name.
    • getCommandInvocation

      CommandRunner.CommandInvocation getCommandInvocation(String scope, String name, ActionReport report, Subject subject, boolean isNotify)
      Obtain a new command invocation object. Command invocations can be configured and used to trigger a command execution.
      Parameters:
      scope - the scope (or namespace) for the command
      name - name of the requested command to invoke
      report - where to place the status of the command execution
      subject - the Subject under which to execute the command
      isNotify - should notification be enabled
      Returns:
      a new command invocation for that command name.