com.google.gerrit.sshd

Class BaseCommand

java.lang.Object

com.google.gerrit.sshd.BaseCommand

All Implemented Interfaces:

org.apache.sshd.server.Command, org.apache.sshd.server.CommandLifecycle

Direct Known Subclasses:

AbstractGitCommand, AliasCommand, SshCommand, SuExec

public abstract class BaseCommand
extends java.lang.Object
implements org.apache.sshd.server.Command

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	BaseCommand.CommandRunnable Runnable function which can throw an exception.
static class	BaseCommand.Failure Thrown from BaseCommand.CommandRunnable.run() with client message and code.
static interface	BaseCommand.ProjectCommandRunnable Runnable function which can retrieve a project name related to the task
static class	BaseCommand.UnloggedFailure Thrown from BaseCommand.CommandRunnable.run() with client message and code.

Field Summary

Fields

Modifier and Type	Field and Description
static java.nio.charset.Charset	ENC
protected java.io.OutputStream	err
protected java.io.InputStream	in
protected java.io.OutputStream	out
static int	STATUS_NOT_ADMIN

Constructor Summary

Constructors

Constructor and Description
BaseCommand()

Method Summary

Modifier and Type	Method and Description
void	destroy()
protected BaseCommand.UnloggedFailure	die(java.lang.String msg)
protected BaseCommand.UnloggedFailure	die(java.lang.Throwable why)
java.lang.String[]	getArguments()
protected java.lang.String	getName()
protected java.lang.String	getPluginName()
protected java.lang.String	getTaskDescription()
protected java.lang.String[]	getTrimmedArguments() Trim the argument if it is spanning multiple lines.
protected com.google.gerrit.util.cli.CmdLineParser	newCmdLineParser(java.lang.Object options) Construct a new parser for this command's received command line.
protected void	onExit(int rc) Terminate this command and return a result code to the remote client.
protected void	parseCommandLine() Parses the command line argument, injecting parsed values into fields.
protected void	parseCommandLine(java.lang.Object options) Parses the command line argument, injecting parsed values into fields.
protected void	provideStateTo(org.apache.sshd.server.Command cmd) Pass all state into the command, then run its start method.
void	setArguments(java.lang.String[] argv)
void	setErrorStream(java.io.OutputStream err)
void	setExitCallback(org.apache.sshd.server.ExitCallback callback)
void	setInputStream(java.io.InputStream in)
void	setOutputStream(java.io.OutputStream out)
protected void	startThread(BaseCommand.CommandRunnable thunk) Spawn a function into its own thread.
protected void	startThread(java.lang.Runnable thunk) Spawn a function into its own thread.
protected static java.io.PrintWriter	toPrintWriter(java.io.OutputStream o) Wrap the supplied output stream in a UTF-8 encoded PrintWriter.
protected java.lang.String	usage()
protected void	writeError(java.lang.String type, java.lang.String msg)

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.sshd.server.CommandLifecycle

start

Field Detail

ENC

public static final java.nio.charset.Charset ENC

STATUS_NOT_ADMIN

public static final int STATUS_NOT_ADMIN

See Also:

Constant Field Values

in

protected java.io.InputStream in

out

protected java.io.OutputStream out

err

protected java.io.OutputStream err

Constructor Detail

BaseCommand

public BaseCommand()

Method Detail

setInputStream

public void setInputStream(java.io.InputStream in)

Specified by:

setInputStream in interface org.apache.sshd.server.Command

setOutputStream

public void setOutputStream(java.io.OutputStream out)

Specified by:

setOutputStream in interface org.apache.sshd.server.Command

setErrorStream

public void setErrorStream(java.io.OutputStream err)

Specified by:

setErrorStream in interface org.apache.sshd.server.Command

setExitCallback

public void setExitCallback(org.apache.sshd.server.ExitCallback callback)

Specified by:

setExitCallback in interface org.apache.sshd.server.Command

getPluginName

protected java.lang.String getPluginName()

getName

protected java.lang.String getName()

getArguments

public java.lang.String[] getArguments()

setArguments

public void setArguments(java.lang.String[] argv)

getTrimmedArguments

protected java.lang.String[] getTrimmedArguments()

Trim the argument if it is spanning multiple lines.

Returns:

the arguments where all the multiple-line fields are trimmed.

destroy

public void destroy()

Specified by:

destroy in interface org.apache.sshd.server.CommandLifecycle

provideStateTo

protected void provideStateTo(org.apache.sshd.server.Command cmd)

Pass all state into the command, then run its start method.

This method copies all critical state, like the input and output streams, into the supplied command. The caller must still invoke cmd.start() if wants to pass control to the command.

Parameters:

cmd - the command that will receive the current state.

parseCommandLine

protected void parseCommandLine()
                         throws BaseCommand.UnloggedFailure

Parses the command line argument, injecting parsed values into fields.

This method must be explicitly invoked to cause a parse.

Throws:

BaseCommand.UnloggedFailure - if the command line arguments were invalid.

See Also:

Option, Argument

parseCommandLine

protected void parseCommandLine(java.lang.Object options)
                         throws BaseCommand.UnloggedFailure

Parses the command line argument, injecting parsed values into fields.

This method must be explicitly invoked to cause a parse.

Parameters:

options - object whose fields declare Option and Argument annotations to describe the parameters of the command. Usually this.

Throws:

BaseCommand.UnloggedFailure - if the command line arguments were invalid.

See Also:

Option, Argument

usage

protected java.lang.String usage()

newCmdLineParser

protected com.google.gerrit.util.cli.CmdLineParser newCmdLineParser(java.lang.Object options)

Construct a new parser for this command's received command line.

startThread

protected void startThread(java.lang.Runnable thunk)

Spawn a function into its own thread.

Typically this should be invoked within CommandLifecycle.start(Environment), such as:

 startThread(new Runnable() {
   public void run() {
     runImp();
   }
 });
 

Parameters:

thunk - the runnable to execute on the thread, performing the command's logic.

startThread

protected void startThread(BaseCommand.CommandRunnable thunk)

Spawn a function into its own thread.

Typically this should be invoked within CommandLifecycle.start(Environment), such as:

 startThread(new CommandRunnable() {
   public void run() throws Exception {
     runImp();
   }
 });
 

If the function throws an exception, it is translated to a simple message for the client, a non-zero exit code, and the stack trace is logged.

Parameters:

thunk - the runnable to execute on the thread, performing the command's logic.

onExit

protected void onExit(int rc)

Terminate this command and return a result code to the remote client.

Commands should invoke this at most once. Once invoked, the command may lose access to request based resources as any callbacks previously registered with RequestCleanup will fire.

Parameters:

rc - exit code for the remote client.

toPrintWriter

protected static java.io.PrintWriter toPrintWriter(java.io.OutputStream o)

Wrap the supplied output stream in a UTF-8 encoded PrintWriter.

die

protected BaseCommand.UnloggedFailure die(java.lang.String msg)

die

protected BaseCommand.UnloggedFailure die(java.lang.Throwable why)

writeError

protected void writeError(java.lang.String type,
                          java.lang.String msg)

getTaskDescription

protected java.lang.String getTaskDescription()