org.apache.sshd.client.session

Class ClientSessionImpl

java.lang.Object

org.apache.sshd.common.util.CloseableUtils.AbstractCloseable

org.apache.sshd.common.util.CloseableUtils.AbstractInnerCloseable

org.apache.sshd.common.session.AbstractSession

org.apache.sshd.client.session.ClientSessionImpl

All Implemented Interfaces:

ClientSession, Closeable, Session

public class ClientSessionImpl
extends AbstractSession
implements ClientSession

TODO Add javadoc

Author:

Apache MINA SSHD Project

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.sshd.common.session.AbstractSession

AbstractSession.PendingWriteFuture

Nested classes/interfaces inherited from interface org.apache.sshd.common.Session

Session.AttributeKey<T>

Field Summary

Fields

Modifier and Type	Field and Description
protected AuthFuture	authFuture

Fields inherited from class org.apache.sshd.common.session.AbstractSession

attributes, authed, clientProposal, clientVersion, currentService, decodeLock, decoderBuffer, decoderLength, decoderState, encodeLock, factoryManager, I_C, I_S, inBytes, inCipher, inCipherSize, inCompression, inMac, inMacResult, inPackets, ioSession, isServer, kex, KEX_STATE_DONE, KEX_STATE_INIT, KEX_STATE_KEYS, KEX_STATE_RUN, kexState, lastKeyTime, listeners, negotiated, outBytes, outCipher, outCipherSize, outCompression, outMac, outPackets, pendingPackets, random, reexchangeFuture, requestLock, requestResult, seqi, seqo, serverProposal, serverVersion, SESSION, sessionId, uncompressBuffer, username

Fields inherited from class org.apache.sshd.common.util.CloseableUtils.AbstractCloseable

CLOSED, closeFuture, GRACEFUL, IMMEDIATE, lock, log, OPENED, state

Fields inherited from interface org.apache.sshd.ClientSession

AUTHED, CLOSED, TIMEOUT, WAIT_AUTH

Constructor Summary

Constructors

Constructor and Description
ClientSessionImpl(ClientFactoryManager client, IoSession session)

Method Summary

Methods

Modifier and Type	Method and Description
void	addPasswordIdentity(java.lang.String password)
void	addPublicKeyIdentity(java.security.KeyPair key)
AuthFuture	auth()
AuthFuture	authAgent(java.lang.String user) Authenticate the session with the given username using an ssh agent.
AuthFuture	authInteractive(java.lang.String user, java.lang.String password) Authenticate the session with the given username and password.
AuthFuture	authPassword(java.lang.String user, java.lang.String password) Authenticate the session with the given username and password.
AuthFuture	authPublicKey(java.lang.String user, java.security.KeyPair key) Authenticate the session with the given username and public key.
protected void	checkKeys()
ClientChannel	createChannel(java.lang.String type) Create a channel of the given type.
ClientChannel	createChannel(java.lang.String type, java.lang.String subType) Create a channel of the given type and subtype.
ChannelDirectTcpip	createDirectTcpipChannel(SshdSocketAddress local, SshdSocketAddress remote) Create a direct tcp-ip channel which can be used to stream data to a remote port from the server.
ChannelExec	createExecChannel(java.lang.String command) Create a channel to execute a command.
ScpClient	createScpClient() Create an SCP client from this session.
SftpClient	createSftpClient() Create an SFTP client from this session.
ChannelShell	createShellChannel() Create a channel to start a shell.
ChannelSubsystem	createSubsystemChannel(java.lang.String subsystem) Create a subsystem channel.
ClientFactoryManager	getFactoryManager() Retrieve the factory manager
java.util.Map<java.lang.Object,java.lang.Object>	getMetadataMap() Access to the metadata.
protected Service[]	getServices()
protected void	handleMessage(Buffer buffer) Abstract method for processing incoming decoded packets.
protected boolean	readIdentification(Buffer buffer) Read the other side identification.
protected void	receiveKexInit(Buffer buffer)
void	resetIdleTimeout()
protected void	sendEvent(SessionListener.Event event)
protected void	sendInitialServiceRequest()
protected void	sendKexInit()
SshdSocketAddress	startLocalPortForwarding(SshdSocketAddress local, SshdSocketAddress remote) Start forwarding the given local address on the client to the given address on the server.
SshdSocketAddress	startRemotePortForwarding(SshdSocketAddress remote, SshdSocketAddress local) Start forwarding tcpip from the given address on the server to the given address on the client.
void	startService(java.lang.String name)
void	stopLocalPortForwarding(SshdSocketAddress local) Stop forwarding the given local address.
void	stopRemotePortForwarding(SshdSocketAddress remote) Stop forwarding of the given remote address.
protected void	switchToNextService()
int	waitFor(int mask, long timeout) Wait for a specific state.

Methods inherited from class org.apache.sshd.common.session.AbstractSession

addListener, attachSession, checkRekey, createBuffer, createBuffer, createProposal, decode, disconnect, doHandleMessage, doReadIdentification, doWritePacket, exceptionCaught, getAttribute, getClientVersion, getInnerCloseable, getIntProperty, getIoSession, getKex, getLock, getLongProperty, getServerVersion, getSession, getSession, getSessionId, getUsername, isAuthenticated, messageReceived, negotiate, notImplemented, postClose, receiveKexInit, receiveNewKeys, reExchangeKeys, removeListener, request, requestFailure, requestSuccess, sendIdentification, sendKexInit, sendNewKeys, serviceAccept, setAttribute, setAuthenticated, setUsername, toString, writePacket

Methods inherited from class org.apache.sshd.common.util.CloseableUtils.AbstractInnerCloseable

doCloseGracefully, doCloseImmediately

Methods inherited from class org.apache.sshd.common.util.CloseableUtils.AbstractCloseable

close

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.sshd.ClientSession

close

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

addListener, createBuffer, createBuffer, exceptionCaught, getAttribute, getClientVersion, getIntProperty, getServerVersion, getUsername, reExchangeKeys, removeListener, request, setAttribute, writePacket

Field Detail

authFuture

protected AuthFuture authFuture

Constructor Detail

ClientSessionImpl

public ClientSessionImpl(ClientFactoryManager client,
                 IoSession session)
                  throws java.lang.Exception

Throws:

java.lang.Exception

Method Detail

getServices

protected Service[] getServices()

Overrides:

getServices in class AbstractSession

getFactoryManager

public ClientFactoryManager getFactoryManager()

Description copied from class: AbstractSession

Retrieve the factory manager

Specified by:

getFactoryManager in interface ClientSession

Specified by:

getFactoryManager in interface Session

Overrides:

getFactoryManager in class AbstractSession

Returns:

the factory manager for this session

addPasswordIdentity

public void addPasswordIdentity(java.lang.String password)

Specified by:

addPasswordIdentity in interface ClientSession

addPublicKeyIdentity

public void addPublicKeyIdentity(java.security.KeyPair key)

Specified by:

addPublicKeyIdentity in interface ClientSession

auth

public AuthFuture auth()
                throws java.io.IOException

Specified by:

auth in interface ClientSession

Throws:

java.io.IOException

authAgent

public AuthFuture authAgent(java.lang.String user)
                     throws java.io.IOException

Description copied from interface: ClientSession

Authenticate the session with the given username using an ssh agent.

Specified by:

authAgent in interface ClientSession

Throws:

java.io.IOException

authPassword

public AuthFuture authPassword(java.lang.String user,
                      java.lang.String password)
                        throws java.io.IOException

Description copied from interface: ClientSession

Authenticate the session with the given username and password.

Specified by:

authPassword in interface ClientSession

Throws:

java.io.IOException

authInteractive

public AuthFuture authInteractive(java.lang.String user,
                         java.lang.String password)
                           throws java.io.IOException

Description copied from interface: ClientSession

Authenticate the session with the given username and password.

Specified by:

authInteractive in interface ClientSession

Throws:

java.io.IOException

authPublicKey

public AuthFuture authPublicKey(java.lang.String user,
                       java.security.KeyPair key)
                         throws java.io.IOException

Description copied from interface: ClientSession

Authenticate the session with the given username and public key.

Specified by:

authPublicKey in interface ClientSession

Throws:

java.io.IOException

switchToNextService

protected void switchToNextService()
                            throws java.io.IOException

Throws:

java.io.IOException

createChannel

public ClientChannel createChannel(java.lang.String type)
                            throws java.io.IOException

Description copied from interface: ClientSession

Create a channel of the given type. Same as calling createChannel(type, null).

Specified by:

createChannel in interface ClientSession

Throws:

java.io.IOException

createChannel

public ClientChannel createChannel(java.lang.String type,
                          java.lang.String subType)
                            throws java.io.IOException

Description copied from interface: ClientSession

Create a channel of the given type and subtype.

Specified by:

createChannel in interface ClientSession

Throws:

java.io.IOException

createShellChannel

public ChannelShell createShellChannel()
                                throws java.io.IOException

Description copied from interface: ClientSession

Create a channel to start a shell.

Specified by:

createShellChannel in interface ClientSession

Throws:

java.io.IOException

createExecChannel

public ChannelExec createExecChannel(java.lang.String command)
                              throws java.io.IOException

Description copied from interface: ClientSession

Create a channel to execute a command.

Specified by:

createExecChannel in interface ClientSession

Throws:

java.io.IOException

createSubsystemChannel

public ChannelSubsystem createSubsystemChannel(java.lang.String subsystem)
                                        throws java.io.IOException

Description copied from interface: ClientSession

Create a subsystem channel.

Specified by:

createSubsystemChannel in interface ClientSession

Throws:

java.io.IOException

createDirectTcpipChannel

public ChannelDirectTcpip createDirectTcpipChannel(SshdSocketAddress local,
                                          SshdSocketAddress remote)
                                            throws java.io.IOException

Description copied from interface: ClientSession

Create a direct tcp-ip channel which can be used to stream data to a remote port from the server.

Specified by:

createDirectTcpipChannel in interface ClientSession

Throws:

java.io.IOException

createScpClient

public ScpClient createScpClient()

Description copied from interface: ClientSession

Create an SCP client from this session.

Specified by:

createScpClient in interface ClientSession

createSftpClient

public SftpClient createSftpClient()
                            throws java.io.IOException

Description copied from interface: ClientSession

Create an SFTP client from this session.

Specified by:

createSftpClient in interface ClientSession

Throws:

java.io.IOException

startLocalPortForwarding

public SshdSocketAddress startLocalPortForwarding(SshdSocketAddress local,
                                         SshdSocketAddress remote)
                                           throws java.io.IOException

Description copied from interface: ClientSession

Start forwarding the given local address on the client to the given address on the server.

Specified by:

startLocalPortForwarding in interface ClientSession

Throws:

java.io.IOException

stopLocalPortForwarding

public void stopLocalPortForwarding(SshdSocketAddress local)
                             throws java.io.IOException

Description copied from interface: ClientSession

Stop forwarding the given local address.

Specified by:

stopLocalPortForwarding in interface ClientSession

Throws:

java.io.IOException

startRemotePortForwarding

public SshdSocketAddress startRemotePortForwarding(SshdSocketAddress remote,
                                          SshdSocketAddress local)
                                            throws java.io.IOException

Description copied from interface: ClientSession

Start forwarding tcpip from the given address on the server to the given address on the client. The remote host name is the address to bind to on the server:

• "" means that connections are to be accepted on all protocol families supported by the SSH implementation
• "0.0.0.0" means to listen on all IPv4 addresses
• "::" means to listen on all IPv6 addresses
• "localhost" means to listen on all protocol families supported by the SSH implementation on loopback addresses only, [RFC3330] and RFC3513]
• "127.0.0.1" and "::1" indicate listening on the loopback interfaces for IPv4 and IPv6 respectively

Specified by:

startRemotePortForwarding in interface ClientSession

Throws:

java.io.IOException

stopRemotePortForwarding

public void stopRemotePortForwarding(SshdSocketAddress remote)
                              throws java.io.IOException

Description copied from interface: ClientSession

Stop forwarding of the given remote address.

Specified by:

stopRemotePortForwarding in interface ClientSession

Throws:

java.io.IOException

handleMessage

protected void handleMessage(Buffer buffer)
                      throws java.lang.Exception

Description copied from class: AbstractSession

Abstract method for processing incoming decoded packets. The given buffer will hold the decoded packet, starting from the command byte at the read position. Packets must be processed within this call or be copied because the given buffer is meant to be changed and updated when this method returns.

Overrides:

handleMessage in class AbstractSession

Parameters:

buffer - the buffer containing the packet

Throws:

java.lang.Exception - if an exeption occurs while handling this packet.

waitFor

public int waitFor(int mask,
          long timeout)

Description copied from interface: ClientSession

Wait for a specific state.

Specified by:

waitFor in interface ClientSession

readIdentification

protected boolean readIdentification(Buffer buffer)
                              throws java.io.IOException

Description copied from class: AbstractSession

Read the other side identification. This method is specific to the client or server side, but both should call AbstractSession.doReadIdentification(org.apache.sshd.common.util.Buffer) and store the result in the needed property.

Specified by:

readIdentification in class AbstractSession

Parameters:

buffer - the buffer containing the remote identification

Returns:

true if the identification has been fully read or false if more data is needed

Throws:

java.io.IOException - if an error occurs such as a bad protocol version

sendKexInit

protected void sendKexInit()
                    throws java.io.IOException

Specified by:

sendKexInit in class AbstractSession

Throws:

java.io.IOException

receiveKexInit

protected void receiveKexInit(Buffer buffer)
                       throws java.io.IOException

Specified by:

receiveKexInit in class AbstractSession

Throws:

java.io.IOException

checkKeys

protected void checkKeys()
                  throws SshException

Specified by:

checkKeys in class AbstractSession

Throws:

SshException

sendEvent

protected void sendEvent(SessionListener.Event event)
                  throws java.io.IOException

Overrides:

sendEvent in class AbstractSession

Throws:

java.io.IOException

sendInitialServiceRequest

protected void sendInitialServiceRequest()
                                  throws java.io.IOException

Throws:

java.io.IOException

startService

public void startService(java.lang.String name)
                  throws java.lang.Exception

Specified by:

startService in class AbstractSession

Throws:

java.lang.Exception

resetIdleTimeout

public void resetIdleTimeout()

Specified by:

resetIdleTimeout in class AbstractSession

getMetadataMap

public java.util.Map<java.lang.Object,java.lang.Object> getMetadataMap()

Description copied from interface: ClientSession

Access to the metadata.

Specified by:

getMetadataMap in interface ClientSession