com.sun.enterprise.admin.cli.remote

Class RemoteCommand

java.lang.Object

com.sun.enterprise.admin.cli.CLICommand

com.sun.enterprise.admin.cli.remote.RemoteCommand

All Implemented Interfaces:

org.glassfish.hk2.api.PostConstruct

public class RemoteCommand
extends CLICommand

A remote command handled by the asadmin CLI.

Field Summary

Fields inherited from class com.sun.enterprise.admin.cli.CLICommand

argv, ASADMIN, commandModel, CONNECTION_ERROR, env, ERROR, INVALID_COMMAND_ERROR, lineReader, logger, metadataErrors, name, operands, options, passwords, programOpts, SUCCESS, terminal, WARNING

Constructor Summary

Constructors

Constructor and Description
RemoteCommand() Construct a new remote command object.
RemoteCommand(String name, ProgramOptions po, Environment env) Construct a new remote command object.
RemoteCommand(String name, ProgramOptions po, Environment env, String responseFormatType, OutputStream userOut) Construct a new remote command object.

Method Summary

Modifier and Type	Method and Description
protected boolean	checkHelp() We do all our help processing in executeCommand.
int	execute(String... argv) Execute this command with the given arguemnts.
Map<String,String>	executeAndReturnAttributes(String... args) Execute the command and return the main attributes from the manifest instead of writing out the output.
String	executeAndReturnOutput(String... args) Execute the command and return the output as a string instead of writing it out.
protected int	executeCommand() Execute the command using the options in options and the operands in operands.
BufferedReader	getManPage() Get the man page from the server.
String	getUsage() Get the usage text.
protected void	inject() Inject this instance with the final values of all the command parameters.
protected void	prepare() The prepare method must ensure that the commandModel field is set.
protected void	prevalidate() The prevalidate method supplies missing options from the environment.
void	setFileOutputDirectory(File dir) Set the directory in which any returned files will be stored.
protected void	validate() The validate method can be used by a subclass to validate that the type and quantity of parameters and operands matches the requirements for this command.

Methods inherited from class com.sun.enterprise.admin.cli.CLICommand

buildLineReader, buildTerminal, closeTerminal, execute, expandManPage, getBooleanOption, getBriefCommandUsage, getCommand, getCommand, getCommandScope, getCommandUsage, getName, getOperandModel, getOption, getOptions, getPassword, getPassword, getProgramOptions, getSystemProperties, getSystemProperty, initializeLogger, initializePasswords, ok, parse, postConstruct, printExceptionStackTrace, processProgramOptions, quote, readPassword, setCommandScope, toString, usageOptions

Methods inherited from class java.lang.Object

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

Constructor Detail

RemoteCommand

public RemoteCommand()
              throws CommandException

Construct a new remote command object. The command and arguments are supplied later using the execute method in the superclass.

Throws:

CommandException

RemoteCommand

public RemoteCommand(String name,
                     ProgramOptions po,
                     Environment env)
              throws CommandException

Construct a new remote command object. The command and arguments are supplied later using the execute method in the superclass.

Parameters:

name -

po -

env -

Throws:

CommandException

See Also:

RemoteCLICommand.RemoteCLICommand(String, ProgramOptions, Environment)

RemoteCommand

public RemoteCommand(String name,
                     ProgramOptions po,
                     Environment env,
                     String responseFormatType,
                     OutputStream userOut)
              throws CommandException

Construct a new remote command object. The command and arguments are supplied later using the execute method in the superclass. This variant is used by the RemoteDeploymentFacility class to control and capture the output.

Parameters:

name -

po -

env -

responseFormatType -

userOut -

Throws:

CommandException

See Also:

RemoteCLICommand.RemoteCLICommand(String, ProgramOptions, Environment, String, OutputStream)

Method Detail

execute

public int execute(String... argv)
            throws CommandException

Description copied from class: CLICommand

Execute this command with the given arguemnts. The implementation in this class saves the passed arguments in the argv field and calls the initializePasswords method. Then it calls the prepare, parse, and validate methods, finally returning the result of calling the executeCommand method. Note that argv[0] is the command name.

Overrides:

execute in class CLICommand

Parameters:

argv - Arguments to execute command with

Returns:

exit code of the command

Throws:

CommandException - if execution of the command fails

CommandValidationException - if there's something wrong with the options or arguments

setFileOutputDirectory

public void setFileOutputDirectory(File dir)

Set the directory in which any returned files will be stored. The default is the user's home directory.

Parameters:

dir -

prepare

protected void prepare()
                throws CommandException,
                       CommandValidationException

Description copied from class: CLICommand

The prepare method must ensure that the commandModel field is set.

Overrides:

prepare in class CLICommand

Throws:

CommandException

CommandValidationException

prevalidate

protected void prevalidate()
                    throws CommandException

Description copied from class: CLICommand

The prevalidate method supplies missing options from the environment. It also supplies passwords from the password file or prompts for them if interactive.

Overrides:

prevalidate in class CLICommand

Throws:

CommandException - if execution of the command fails

CommandValidationException - if there's something wrong with the options or arguments

validate

protected void validate()
                 throws CommandException,
                        CommandValidationException

Description copied from class: CLICommand

The validate method can be used by a subclass to validate that the type and quantity of parameters and operands matches the requirements for this command.

Overrides:

validate in class CLICommand

Throws:

CommandException - if execution of the command fails

CommandValidationException - if there's something wrong with the options or arguments

inject

protected void inject()
               throws CommandException

Description copied from class: CLICommand

Inject this instance with the final values of all the command parameters.

Overrides:

inject in class CLICommand

Throws:

CommandException - if execution of the command fails

CommandValidationException - if there's something wrong with the options or arguments

checkHelp

protected boolean checkHelp()
                     throws CommandException,
                            CommandValidationException

We do all our help processing in executeCommand.

Overrides:

checkHelp in class CLICommand

Returns:

Throws:

CommandException

CommandValidationException

executeCommand

protected int executeCommand()
                      throws CommandException,
                             CommandValidationException

Description copied from class: CLICommand

Execute the command using the options in options and the operands in operands.

Specified by:

executeCommand in class CLICommand

Returns:

the exit code

Throws:

CommandException - if execution of the command fails

CommandValidationException - if there's something wrong with the options or arguments

executeAndReturnOutput

public String executeAndReturnOutput(String... args)
                              throws CommandException,
                                     CommandValidationException

Execute the command and return the output as a string instead of writing it out.

Parameters:

args -

Returns:

Throws:

CommandValidationException

CommandException

executeAndReturnAttributes

public Map<String,String> executeAndReturnAttributes(String... args)
                                              throws CommandException,
                                                     CommandValidationException

Execute the command and return the main attributes from the manifest instead of writing out the output.

Parameters:

args -

Returns:

Throws:

CommandException

CommandValidationException

getUsage

public String getUsage()

Get the usage text. If we got usage information from the server, use it.

Overrides:

getUsage in class CLICommand

Returns:

usage text

getManPage

public BufferedReader getManPage()

Get the man page from the server. If the man page isn't available, e.g., because the server is down, try to find it locally by looking in the modules directory.

Overrides:

getManPage in class CLICommand

Returns: