com.sshtools.nio

Class SshEngine

java.lang.Object

com.sshtools.nio.SshEngine

Direct Known Subclasses:

ExampleForwardingClient, ExampleSftpClient, ExecuteCommandExample, VanillaSSHD

public class SshEngine
extends Object

This class provides an abstract daemon for servicing any number of protocol contexts.

Author:

Lee David Painter

Field Summary

Fields

Modifier and Type	Field and Description
protected static char[]	hexArray

Constructor Summary

Constructors

Constructor and Description
SshEngine() Constructs the Daemon.

Method Summary

Modifier and Type	Method and Description
void	addShutdownHook(Runnable r)
<K extends ProtocolContext> void	connect(String hostToConnect, int portToConnect, ProtocolContextFactory<K> contextFactory)
SshEngineContext	getContext() Get the context for this Daemon.
static Date	getReleaseDate() Returns the release date of the current version.
static String	getVersion() Returns the current version of the API.
boolean	isStarted() Get whether the daemon is currently started
boolean	isStarting()
protected SocketChannel	processOpenSocket(SocketChannel socketChannel)
void	registerAcceptor(ClientAcceptor acceptor, ServerSocketChannel socketChannel) Register a client acceptor with the daemon.
void	registerConnector(ClientConnector connector, SocketChannel socketChannel) Register a client connector with the daemon.
void	registerHandler(SocketHandler handler, SelectableChannel channel) Register a socket handler with the daemon.
void	registerHandler(SocketHandler handler, SelectableChannel channel, SelectorThread thread) Register a socket handler with the daemon.
void	removeAcceptor(ListeningInterface li)
void	restart()
void	restart(boolean graceful, long forceAfterMs)
void	shutdownAsync(boolean graceful, long forceAfterMs) Shutdown the server.
void	shutdownNow(boolean graceful, long forceAfterMs) This method should be used to shutdown the server from your main thread.
protected boolean	startListeningInterface(ListeningInterface li)
boolean	startup() Starts the daemon, first calling the #configure(ConfigurationContext) method to allow your server to configure itself.

Methods inherited from class java.lang.Object

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

Field Detail

hexArray

protected static final char[] hexArray

Constructor Detail

SshEngine

public SshEngine()

Constructs the Daemon.

Method Detail

getContext

public SshEngineContext getContext()

Get the context for this Daemon.

Returns:

DaemonContext

getVersion

public static String getVersion()

Returns the current version of the API.

getReleaseDate

public static Date getReleaseDate()

Returns the release date of the current version.

isStarting

public boolean isStarting()

addShutdownHook

public void addShutdownHook(Runnable r)

startup

public boolean startup()
                throws IOException

Starts the daemon, first calling the #configure(ConfigurationContext) method to allow your server to configure itself.

Returns:

true if at least one interface started, otherwise false.

Throws:

IOException

startListeningInterface

protected boolean startListeningInterface(ListeningInterface li)
                                   throws IOException

Throws:

IOException

removeAcceptor

public void removeAcceptor(ListeningInterface li)

isStarted

public boolean isStarted()

Get whether the daemon is currently started

Returns:

started

shutdownAsync

public void shutdownAsync(boolean graceful,
                          long forceAfterMs)

Shutdown the server. This does not exit the JVM

shutdownNow

public void shutdownNow(boolean graceful,
                        long forceAfterMs)

This method should be used to shutdown the server from your main thread. If you need to shutdown the server from within a session that is running on a transfer thread use shutdownAsync().

restart

public void restart()
             throws IOException

Throws:

IOException

restart

public void restart(boolean graceful,
                    long forceAfterMs)
             throws IOException

Throws:

IOException

connect

public <K extends ProtocolContext> void connect(String hostToConnect,
                                                int portToConnect,
                                                ProtocolContextFactory<K> contextFactory)
                                         throws SshException,
                                                IOException

Throws:

SshException

IOException

processOpenSocket

protected SocketChannel processOpenSocket(SocketChannel socketChannel)

registerConnector

public void registerConnector(ClientConnector connector,
                              SocketChannel socketChannel)
                       throws IOException

Register a client connector with the daemon.

Parameters:

connector - ClientConnector

socketChannel - SocketChannel

Throws:

IOException

registerAcceptor

public void registerAcceptor(ClientAcceptor acceptor,
                             ServerSocketChannel socketChannel)
                      throws IOException

Register a client acceptor with the daemon.

Parameters:

acceptor - ClientAcceptor

socketChannel - ServerSocketChannel

Throws:

IOException

registerHandler

public void registerHandler(SocketHandler handler,
                            SelectableChannel channel)
                     throws IOException

Register a socket handler with the daemon.

Parameters:

handler - SocketHandler

channel - SelectableChannel

Throws:

IOException

registerHandler

public void registerHandler(SocketHandler handler,
                            SelectableChannel channel,
                            SelectorThread thread)
                     throws IOException

Register a socket handler with the daemon.

Parameters:

handler - SocketHandler

channel - SelectableChannel

thread - SelectorThread

Throws:

IOException