com.jcabi.ssh

Class SSH

java.lang.Object

com.jcabi.ssh.SSH

All Implemented Interfaces:

Shell

public final class SSH
extends Object
implements Shell

Single SSH Channel.

This class implements Shell interface. In order to use it, just make an instance and call exec(String,InputStream,OutputStream,OutputStream) exec()}:

 String hello = new Shell.Plain(
   new SSH(
     "ssh.example.com", 22,
     "yegor", "-----BEGIN RSA PRIVATE KEY-----..."
   )
 ).exec("echo 'Hello, world!'");

It is highly recommended to use classes from Shell interface, they will simplify operations.

Since:

1.0

Version:

$Id: bf0f61dea63ceabebaa325fe49a2362dab510baa $

Author:

Yegor Bugayenko (yegor@teamed.io)

See Also:

article by Yegor Bugayenko

To do:

#21:30min This class has common data, implementation of exec() and constructor validations with SSHByPassword class. Common functionality should be extracted into a separate module.

Nested Class Summary

Nested classes/interfaces inherited from interface com.jcabi.ssh.Shell

Shell.Empty, Shell.Plain, Shell.Safe, Shell.Verbose

Field Summary

Fields

Modifier and Type	Field and Description
static int	PORT Default SSH port.

Constructor Summary

Constructors

Constructor and Description
SSH(InetAddress adr, int prt, String user, URL priv) Constructor.
SSH(InetAddress adr, String user, String priv) Constructor.
SSH(InetAddress adr, String user, URL priv) Constructor.
SSH(String adr, int prt, String user, String priv) Constructor.
SSH(String adr, int prt, String user, URL priv) Constructor.
SSH(String adr, String user, String priv) Constructor.
SSH(String adr, String user, URL priv) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
static String	escape(String arg) Escape SSH argument.
int	exec(String command, InputStream stdin, OutputStream stdout, OutputStream stderr) Execute and return exit code.

Methods inherited from class java.lang.Object

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

Field Detail

PORT

public static final int PORT

Default SSH port.

See Also:

Constant Field Values

Constructor Detail

SSH

public SSH(String adr,
   String user,
   URL priv)
    throws IOException

Constructor.

Parameters:

adr - IP address

user - Login

priv - Private SSH key

Throws:

IOException - If fails

Since:

1.4

SSH

public SSH(InetAddress adr,
   String user,
   URL priv)
    throws IOException

Constructor.

Parameters:

adr - IP address

user - Login

priv - Private SSH key

Throws:

IOException - If fails

Since:

1.4

SSH

public SSH(String adr,
   String user,
   String priv)
    throws UnknownHostException

Constructor.

Parameters:

adr - IP address

user - Login

priv - Private SSH key

Throws:

UnknownHostException - If fails

Since:

1.4

SSH

public SSH(InetAddress adr,
   String user,
   String priv)
    throws UnknownHostException

Constructor.

Parameters:

adr - IP address

user - Login

priv - Private SSH key

Throws:

UnknownHostException - If fails

Since:

1.4

SSH

public SSH(String adr,
   int prt,
   String user,
   URL priv)
    throws IOException

Constructor.

Parameters:

adr - IP address

prt - Port of server

user - Login

priv - Private SSH key

Throws:

IOException - If fails

Since:

1.4

Suppressed Checkstyle violations:

ParameterNumberCheck (6 lines)

SSH

public SSH(InetAddress adr,
   int prt,
   String user,
   URL priv)
    throws IOException

Constructor.

Parameters:

adr - IP address

prt - Port of server

user - Login

priv - Private SSH key

Throws:

IOException - If fails

Since:

1.4

Suppressed Checkstyle violations:

ParameterNumberCheck (6 lines)

SSH

public SSH(String adr,
   int prt,
   String user,
   String priv)
    throws UnknownHostException

Constructor.

Parameters:

adr - IP address

prt - Port of server

user - Login

priv - Private SSH key

Throws:

UnknownHostException - If fails

Suppressed Checkstyle violations:

ParameterNumberCheck (6 lines)

Method Detail

exec

public int exec(String command,
       InputStream stdin,
       OutputStream stdout,
       OutputStream stderr)
         throws IOException

Description copied from interface: Shell

Execute and return exit code.

Specified by:

exec in interface Shell

Parameters:

command - Command

stdin - Stdin (will be closed)

stdout - Stdout (will be closed)

stderr - Stderr (will be closed)

Returns:

Exit code

Throws:

IOException - If fails

escape

public static String escape(String arg)

Escape SSH argument.

Parameters:

arg - Argument to escape

Returns:

Escaped