org.apache.sshd.common.session.helpers

Class AbstractConnectionService<S extends AbstractSession>

java.lang.Object

org.apache.sshd.common.util.logging.AbstractLoggingBean

org.apache.sshd.common.util.closeable.IoBaseCloseable

org.apache.sshd.common.util.closeable.AbstractCloseable

org.apache.sshd.common.util.closeable.AbstractInnerCloseable

org.apache.sshd.common.session.helpers.AbstractConnectionService<S>

Type Parameters:

S - Type of AbstractSession being used

All Implemented Interfaces:

Closeable, AutoCloseable, Channel, PortForwardingEventListenerManager, PortForwardingEventListenerManagerHolder, Service, ConnectionService

Direct Known Subclasses:

ClientConnectionService, ServerConnectionService

public abstract class AbstractConnectionService<S extends AbstractSession>
extends AbstractInnerCloseable
implements ConnectionService

Base implementation of ConnectionService.

Author:

Apache MINA SSHD Project

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.sshd.common.util.closeable.AbstractCloseable

AbstractCloseable.State

Field Summary

Fields

Modifier and Type	Field and Description
protected Map<Integer,Channel>	channels Map of channels keyed by the identifier
static int	DEFAULT_MAX_CHANNELS Default value for MAX_CONCURRENT_CHANNELS_PROP is none specified
static String	MAX_CONCURRENT_CHANNELS_PROP Property that can be used to configure max. allowed concurrent active channels
protected AtomicInteger	nextChannelId Next channel identifier
static IntUnaryOperator	RESPONSE_BUFFER_GROWTH_FACTOR Default growth factor function used to resize response buffers

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

closeFuture, lock, state

Fields inherited from class org.apache.sshd.common.util.logging.AbstractLoggingBean

log

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

CLOSE_WAIT_TIMEOUT, DEFAULT_CLOSE_WAIT_TIMEOUT

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractConnectionService(S session)

Method Summary

Modifier and Type	Method and Description
void	addPortForwardingEventListener(PortForwardingEventListener listener) Add a port forwarding listener
boolean	addPortForwardingEventListenerManager(PortForwardingEventListenerManager manager)
void	channelClose(Buffer buffer) Close a channel due to a close packet received
void	channelData(Buffer buffer) Process incoming data on a channel
void	channelEof(Buffer buffer) Process end of file on a channel
void	channelExtendedData(Buffer buffer) Process incoming extended data on a channel
void	channelFailure(Buffer buffer) Process a failure on a channel
protected void	channelOpen(Buffer buffer)
void	channelOpenConfirmation(Buffer buffer)
void	channelOpenFailure(Buffer buffer)
void	channelRequest(Buffer buffer) Service a request on a channel
void	channelSuccess(Buffer buffer) Process a success on a channel
void	channelWindowAdjust(Buffer buffer) Process a window adjust packet on a channel
protected AgentForwardSupport	createAgentForwardSupport(S session)
protected TcpipForwarder	createTcpipForwarder(S session)
protected X11ForwardSupport	createX11ForwardSupport(S session)
AgentForwardSupport	getAgentForwardSupport()
protected Channel	getChannel(Buffer buffer) Retrieve the channel designated by the given packet
protected Channel	getChannel(int recipient, Buffer buffer)
Collection<Channel>	getChannels()
protected Closeable	getInnerCloseable()
protected int	getNextChannelId()
PortForwardingEventListener	getPortForwardingEventListenerProxy()
Collection<PortForwardingEventListenerManager>	getRegisteredManagers()
S	getSession()
TcpipForwarder	getTcpipForwarder() Retrieve the tcpip forwarder
X11ForwardSupport	getX11ForwardSupport()
protected void	globalRequest(Buffer buffer) Process global requests
protected void	handleChannelRegistrationFailure(Channel channel, int channelId)
protected void	handleUnknownRequest(Buffer buffer, String req, boolean wantReply)
boolean	isAllowMoreSessions()
protected void	preClose() preClose is guaranteed to be called before doCloseGracefully or doCloseImmediately.
void	process(int cmd, Buffer buffer) Service the request.
int	registerChannel(Channel channel) Register a newly created channel with a new unique identifier
void	removePortForwardingEventListener(PortForwardingEventListener listener) Remove a port forwarding listener
boolean	removePortForwardingEventListenerManager(PortForwardingEventListenerManager manager)
protected void	requestFailure(Buffer buffer)
protected void	requestSuccess(Buffer buffer)
protected IoWriteFuture	sendChannelOpenFailure(Buffer buffer, int sender, int reasonCode, String message, String lang)
protected IoWriteFuture	sendGlobalResponse(Buffer buffer, String req, RequestHandler.Result result, boolean wantReply)
void	setAllowMoreSessions(boolean allow)
void	start()
String	toString()
void	unregisterChannel(Channel channel) Remove this channel from the list of managed channels

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

doCloseGracefully, doCloseImmediately

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

addCloseFutureListener, builder, close, isClosed, isClosing, removeCloseFutureListener

Methods inherited from class org.apache.sshd.common.util.logging.AbstractLoggingBean

getSimplifiedLogger

Methods inherited from class java.lang.Object

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

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

addCloseFutureListener, close, close, close, getMaxCloseWaitTime, isClosed, isClosing, isOpen, removeCloseFutureListener

Field Detail

MAX_CONCURRENT_CHANNELS_PROP

public static final String MAX_CONCURRENT_CHANNELS_PROP

Property that can be used to configure max. allowed concurrent active channels

See Also:

registerChannel(Channel), Constant Field Values

DEFAULT_MAX_CHANNELS

public static final int DEFAULT_MAX_CHANNELS

Default value for MAX_CONCURRENT_CHANNELS_PROP is none specified

See Also:

Constant Field Values

RESPONSE_BUFFER_GROWTH_FACTOR

public static final IntUnaryOperator RESPONSE_BUFFER_GROWTH_FACTOR

Default growth factor function used to resize response buffers

channels

protected final Map<Integer,Channel> channels

Map of channels keyed by the identifier

nextChannelId

protected final AtomicInteger nextChannelId

Next channel identifier

Constructor Detail

AbstractConnectionService

protected AbstractConnectionService(S session)

Method Detail

getPortForwardingEventListenerProxy

public PortForwardingEventListener getPortForwardingEventListenerProxy()

Specified by:

getPortForwardingEventListenerProxy in interface PortForwardingEventListenerManager

Returns:

A proxy listener representing all the currently registered listener through this manager

addPortForwardingEventListener

public void addPortForwardingEventListener(PortForwardingEventListener listener)

Description copied from interface: PortForwardingEventListenerManager

Add a port forwarding listener

Specified by:

addPortForwardingEventListener in interface PortForwardingEventListenerManager

Parameters:

listener - The PortForwardingEventListener to add - never null

removePortForwardingEventListener

public void removePortForwardingEventListener(PortForwardingEventListener listener)

Description copied from interface: PortForwardingEventListenerManager

Remove a port forwarding listener

Specified by:

removePortForwardingEventListener in interface PortForwardingEventListenerManager

Parameters:

listener - The PortForwardingEventListener to remove - ignored if null

getRegisteredManagers

public Collection<PortForwardingEventListenerManager> getRegisteredManagers()

Specified by:

getRegisteredManagers in interface PortForwardingEventListenerManagerHolder

Returns:

The currently registered managers. Note: it is highly recommended that implementors return either an un-modifiable collection or a copy of the current one. Callers, should avoid modifying the retrieved value.

addPortForwardingEventListenerManager

public boolean addPortForwardingEventListenerManager(PortForwardingEventListenerManager manager)

Specified by:

addPortForwardingEventListenerManager in interface PortForwardingEventListenerManagerHolder

removePortForwardingEventListenerManager

public boolean removePortForwardingEventListenerManager(PortForwardingEventListenerManager manager)

Specified by:

removePortForwardingEventListenerManager in interface PortForwardingEventListenerManagerHolder

getChannels

public Collection<Channel> getChannels()

getSession

public S getSession()

Specified by:

getSession in interface Service

start

public void start()

Specified by:

start in interface Service

getTcpipForwarder

public TcpipForwarder getTcpipForwarder()

Description copied from interface: ConnectionService

Retrieve the tcpip forwarder

Specified by:

getTcpipForwarder in interface ConnectionService

Returns:

The TcpipForwarder

preClose

protected void preClose()

Description copied from class: AbstractCloseable

preClose is guaranteed to be called before doCloseGracefully or doCloseImmediately. When preClose() is called, isClosing() == true

Overrides:

preClose in class AbstractCloseable

createTcpipForwarder

protected TcpipForwarder createTcpipForwarder(S session)

getX11ForwardSupport

public X11ForwardSupport getX11ForwardSupport()

Specified by:

getX11ForwardSupport in interface ConnectionService

createX11ForwardSupport

protected X11ForwardSupport createX11ForwardSupport(S session)

getAgentForwardSupport

public AgentForwardSupport getAgentForwardSupport()

Specified by:

getAgentForwardSupport in interface ConnectionService

createAgentForwardSupport

protected AgentForwardSupport createAgentForwardSupport(S session)

getInnerCloseable

protected Closeable getInnerCloseable()

Specified by:

getInnerCloseable in class AbstractInnerCloseable

getNextChannelId

protected int getNextChannelId()

registerChannel

public int registerChannel(Channel channel)
                    throws IOException

Description copied from interface: ConnectionService

Register a newly created channel with a new unique identifier

Specified by:

registerChannel in interface ConnectionService

Parameters:

channel - The Channel to register

Returns:

The assigned id of this channel

Throws:

IOException - If failed to initialize and register the channel

handleChannelRegistrationFailure

protected void handleChannelRegistrationFailure(Channel channel,
                                                int channelId)
                                         throws IOException

Throws:

IOException

unregisterChannel

public void unregisterChannel(Channel channel)

Remove this channel from the list of managed channels

Specified by:

unregisterChannel in interface ConnectionService

Parameters:

channel - the channel

process

public void process(int cmd,
                    Buffer buffer)
             throws Exception

Description copied from interface: Service

Service the request.

Specified by:

process in interface Service

Parameters:

cmd - The incoming command type

buffer - The Buffer containing optional command parameters

Throws:

Exception - If failed to process the command

isAllowMoreSessions

public boolean isAllowMoreSessions()

Specified by:

isAllowMoreSessions in interface ConnectionService

setAllowMoreSessions

public void setAllowMoreSessions(boolean allow)

Specified by:

setAllowMoreSessions in interface ConnectionService

channelOpenConfirmation

public void channelOpenConfirmation(Buffer buffer)
                             throws IOException

Throws:

IOException

channelOpenFailure

public void channelOpenFailure(Buffer buffer)
                        throws IOException

Throws:

IOException

channelData

public void channelData(Buffer buffer)
                 throws IOException

Process incoming data on a channel

Parameters:

buffer - the buffer containing the data

Throws:

IOException - if an error occurs

channelExtendedData

public void channelExtendedData(Buffer buffer)
                         throws IOException

Process incoming extended data on a channel

Parameters:

buffer - the buffer containing the data

Throws:

IOException - if an error occurs

channelWindowAdjust

public void channelWindowAdjust(Buffer buffer)
                         throws IOException

Process a window adjust packet on a channel

Parameters:

buffer - the buffer containing the window adjustment parameters

Throws:

IOException - if an error occurs

channelEof

public void channelEof(Buffer buffer)
                throws IOException

Process end of file on a channel

Parameters:

buffer - the buffer containing the packet

Throws:

IOException - if an error occurs

channelClose

public void channelClose(Buffer buffer)
                  throws IOException

Close a channel due to a close packet received

Parameters:

buffer - the buffer containing the packet

Throws:

IOException - if an error occurs

channelRequest

public void channelRequest(Buffer buffer)
                    throws IOException

Service a request on a channel

Parameters:

buffer - the buffer containing the request

Throws:

IOException - if an error occurs

channelFailure

public void channelFailure(Buffer buffer)
                    throws IOException

Process a failure on a channel

Parameters:

buffer - the buffer containing the packet

Throws:

IOException - if an error occurs

channelSuccess

public void channelSuccess(Buffer buffer)
                    throws IOException

Process a success on a channel

Parameters:

buffer - the buffer containing the packet

Throws:

IOException - if an error occurs

getChannel

protected Channel getChannel(Buffer buffer)
                      throws IOException

Retrieve the channel designated by the given packet

Parameters:

buffer - the incoming packet

Returns:

the target channel

Throws:

IOException - if the channel does not exists

getChannel

protected Channel getChannel(int recipient,
                             Buffer buffer)
                      throws IOException

Throws:

IOException

channelOpen

protected void channelOpen(Buffer buffer)
                    throws Exception

Throws:

Exception

sendChannelOpenFailure

protected IoWriteFuture sendChannelOpenFailure(Buffer buffer,
                                               int sender,
                                               int reasonCode,
                                               String message,
                                               String lang)
                                        throws IOException

Throws:

IOException

globalRequest

protected void globalRequest(Buffer buffer)
                      throws Exception

Process global requests

Parameters:

buffer - The request Buffer

Throws:

Exception - If failed to process the request

handleUnknownRequest

protected void handleUnknownRequest(Buffer buffer,
                                    String req,
                                    boolean wantReply)
                             throws IOException

Throws:

IOException

sendGlobalResponse

protected IoWriteFuture sendGlobalResponse(Buffer buffer,
                                           String req,
                                           RequestHandler.Result result,
                                           boolean wantReply)
                                    throws IOException

Throws:

IOException

requestSuccess

protected void requestSuccess(Buffer buffer)
                       throws Exception

Throws:

Exception

requestFailure

protected void requestFailure(Buffer buffer)
                       throws Exception

Throws:

Exception

toString

public String toString()

Overrides:

toString in class Object