org.apache.sshd

Class SshClient

java.lang.Object

org.apache.sshd.common.AbstractFactoryManager

org.apache.sshd.SshClient

All Implemented Interfaces:

ClientFactoryManager, FactoryManager

public class SshClient
extends AbstractFactoryManager
implements ClientFactoryManager

Entry point for the client side of the SSH protocol. The default configured client can be created using the setUpDefaultClient(). The next step is to start the client using the start() method. Sessions can then be created using on of the connect(String, int) or connect(java.net.SocketAddress) methods. The client can be stopped at anytime using the stop() method. Following is an example of using the SshClient:

    SshClient client = SshClient.setUpDefaultClient();
    client.start();
    try {
        ClientSession session = client.connect(host, port);

        int ret = ClientSession.WAIT_AUTH;
        while ((ret & ClientSession.WAIT_AUTH) != 0) {
            System.out.print("Password:");
            BufferedReader r = new BufferedReader(new InputStreamReader(System.in));
            String password = r.readLine();
            session.authPassword(login, password);
            ret = session.waitFor(ClientSession.WAIT_AUTH | ClientSession.CLOSED | ClientSession.AUTHED, 0);
        }
        if ((ret & ClientSession.CLOSED) != 0) {
            System.err.println("error");
            System.exit(-1);
        }
        ClientChannel channel = session.createChannel("shell");
        channel.setIn(new NoCloseInputStream(System.in));
        channel.setOut(new NoCloseOutputStream(System.out));
        channel.setErr(new NoCloseOutputStream(System.err));
        channel.open();
        channel.waitFor(ClientChannel.CLOSED, 0);
        session.close();
    } finally {
        client.stop();
    }
 

Author:

Apache MINA SSHD Project

Field Summary

Fields

Modifier and Type	Field and Description
protected IoConnector	connector
protected Factory<IoConnector>	connectorFactory
protected SessionFactory	sessionFactory
protected UserInteraction	userInteraction

Fields inherited from class org.apache.sshd.common.AbstractFactoryManager

agentFactory, channelFactories, cipherFactories, compressionFactories, executor, fileSystemFactory, ioServiceFactory, keyExchangeFactories, keyPairProvider, macFactories, properties, randomFactory, shutdownExecutor, signatureFactories, tcpipForwarderFactory, tcpipForwardingFilter, version

Fields inherited from interface org.apache.sshd.client.ClientFactoryManager

HEARTBEAT_INTERVAL, HEARTBEAT_REQUEST

Fields inherited from interface org.apache.sshd.common.FactoryManager

DEFAULT_NIO_WORKERS, MAX_PACKET_SIZE, NIO_WORKERS, WINDOW_SIZE

Constructor Summary

Constructors

Constructor and Description
SshClient()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	checkConfig()
ConnectFuture	connect(SocketAddress address)
ConnectFuture	connect(String host, int port)
protected IoConnector	createConnector()
protected SessionFactory	createSessionFactory()
ServerKeyVerifier	getServerKeyVerifier() Retrieve the server key verifier to be used to check the key when connecting to an ssh server.
SessionFactory	getSessionFactory()
UserInteraction	getUserInteraction() Retrieve the UserInteraction object to communicate with the user.
static void	main(String[] args)
void	setServerKeyVerifier(ServerKeyVerifier serverKeyVerifier)
void	setSessionFactory(SessionFactory sessionFactory)
static SshClient	setUpDefaultClient() Setup a default client.
void	setUserInteraction(UserInteraction userInteraction)
void	start()
void	stop()

Methods inherited from class org.apache.sshd.common.AbstractFactoryManager

getAgentFactory, getChannelFactories, getCipherFactories, getCompressionFactories, getFileSystemFactory, getIoServiceFactory, getKeyExchangeFactories, getKeyPairProvider, getMacFactories, getNioWorkers, getProperties, getRandomFactory, getScheduledExecutorService, getSignatureFactories, getTcpipForwarderFactory, getTcpipForwardingFilter, getVersion, loadVersion, setAgentFactory, setChannelFactories, setCipherFactories, setCompressionFactories, setFileSystemFactory, setIoServiceFactory, setKeyExchangeFactories, setKeyPairProvider, setMacFactories, setNioWorkers, setProperties, setRandomFactory, setScheduledExecutorService, setScheduledExecutorService, setSignatureFactories, setTcpipForwarderFactory, setTcpipForwardingFilter

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.client.ClientFactoryManager

getTcpipForwarderFactory

Methods inherited from interface org.apache.sshd.common.FactoryManager

getAgentFactory, getChannelFactories, getCipherFactories, getCompressionFactories, getFileSystemFactory, getIoServiceFactory, getKeyExchangeFactories, getKeyPairProvider, getMacFactories, getProperties, getRandomFactory, getScheduledExecutorService, getSignatureFactories, getTcpipForwardingFilter, getVersion

Field Detail

connector

protected IoConnector connector

sessionFactory

protected SessionFactory sessionFactory

userInteraction

protected UserInteraction userInteraction

connectorFactory

protected Factory<IoConnector> connectorFactory

Constructor Detail

SshClient

public SshClient()

Method Detail

getSessionFactory

public SessionFactory getSessionFactory()

setSessionFactory

public void setSessionFactory(SessionFactory sessionFactory)

getServerKeyVerifier

public ServerKeyVerifier getServerKeyVerifier()

Description copied from interface: ClientFactoryManager

Retrieve the server key verifier to be used to check the key when connecting to an ssh server.

Specified by:

getServerKeyVerifier in interface ClientFactoryManager

Returns:

the server key verifier to use

setServerKeyVerifier

public void setServerKeyVerifier(ServerKeyVerifier serverKeyVerifier)

getUserInteraction

public UserInteraction getUserInteraction()

Description copied from interface: ClientFactoryManager

Retrieve the UserInteraction object to communicate with the user.

Specified by:

getUserInteraction in interface ClientFactoryManager

Returns:

A UserInteraction or null

setUserInteraction

public void setUserInteraction(UserInteraction userInteraction)

checkConfig

protected void checkConfig()

start

public void start()

stop

public void stop()

connect

public ConnectFuture connect(String host,
                    int port)
                      throws IOException

Throws:

IOException

connect

public ConnectFuture connect(SocketAddress address)

createConnector

protected IoConnector createConnector()

createSessionFactory

protected SessionFactory createSessionFactory()

setUpDefaultClient

public static SshClient setUpDefaultClient()

Setup a default client. The client does not require any additional setup.

Returns:

a newly create SSH client

main

public static void main(String[] args)
                 throws Exception

Throws:

Exception