org.apache.sshd.common.channel

Interface Channel

All Superinterfaces:

AttributeStore, AutoCloseable, Channel, ChannelListenerManager, Closeable, PropertyResolver

All Known Subinterfaces:

ClientChannel, ServerChannel

All Known Implementing Classes:

AbstractClientChannel, AbstractServerChannel, AgentForwardedChannel, AgentForwardedChannel, ChannelAgentForwarding, ChannelAgentForwarding, ChannelDirectTcpip, ChannelExec, ChannelForwardedX11, ChannelSession, ChannelSession, ChannelShell, ChannelSubsystem, PtyCapableChannelSession, TcpipClientChannel, TcpipServerChannel

public interface Channel
extends ChannelListenerManager, PropertyResolver, AttributeStore, Closeable

Represents a channel opened over an SSH session - holds information that is common both to server and client channels.

Author:

Apache MINA SSHD Project

Nested Class Summary

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

AttributeStore.AttributeKey<T>

Field Summary

Fields

Modifier and Type	Field and Description
static String	CHANNEL_EXEC
static String	CHANNEL_SHELL
static String	CHANNEL_SUBSYSTEM

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

EMPTY

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

CLOSE_WAIT_TIMEOUT, DEFAULT_CLOSE_WAIT_TIMEOUT

Method Summary

Modifier and Type	Method and Description
void	addRequestHandler(RequestHandler<Channel> handler)
default void	addRequestHandlers(Collection<? extends RequestHandler<Channel>> handlers)
int	getId()
Window	getLocalWindow()
int	getRecipient()
Window	getRemoteWindow()
List<RequestHandler<Channel>>	getRequestHandlers()
Session	getSession()
void	handleClose() Invoked when SSH_MSG_CHANNEL_CLOSE received
void	handleData(Buffer buffer) Invoked when SSH_MSG_CHANNEL_DATA received
void	handleEof() Invoked when SSH_MSG_CHANNEL_EOF received
void	handleExtendedData(Buffer buffer) Invoked when SSH_MSG_CHANNEL_EXTENDED_DATA received
void	handleFailure() Invoked when SSH_MSG_CHANNEL_FAILURE received
void	handleOpenFailure(Buffer buffer) For a client channel, this method will be called internally by the session when the server has rejected this channel opening.
void	handleOpenSuccess(int recipient, long rwSize, long packetSize, Buffer buffer) For a client channel, this method will be called internally by the session when the confirmation has been received.
void	handleRequest(Buffer buffer) Invoked when SSH_MSG_CHANNEL_REQUEST received
void	handleSuccess() Invoked when SSH_MSG_CHANNEL_SUCCESS received
void	handleWindowAdjust(Buffer buffer) Invoked when SSH_MSG_CHANNEL_WINDOW_ADJUST received
void	init(ConnectionService service, Session session, int id) Invoked when the local channel is initial created
boolean	isEofSignalled()
boolean	isInitialized()
OpenFuture	open(int recipient, long rwSize, long packetSize, Buffer buffer) For a server channel, this method will actually open the channel
void	removeRequestHandler(RequestHandler<Channel> handler)
default void	removeRequestHandlers(Collection<? extends RequestHandler<Channel>> handlers)

Methods inherited from interface org.apache.sshd.common.channel.ChannelListenerManager

addChannelListener, getChannelListenerProxy, removeChannelListener

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

getBoolean, getBooleanProperty, getInteger, getIntProperty, getLong, getLongProperty, getObject, getParentPropertyResolver, getProperties, getString, getStringProperty

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

getAttribute, removeAttribute, resolveAttribute, resolveAttribute, resolveAttribute, resolveAttribute, setAttribute

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

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

Field Detail

CHANNEL_EXEC

static final String CHANNEL_EXEC

See Also:

Constant Field Values

CHANNEL_SHELL

static final String CHANNEL_SHELL

See Also:

Constant Field Values

CHANNEL_SUBSYSTEM

static final String CHANNEL_SUBSYSTEM

See Also:

Constant Field Values

Method Detail

getId

int getId()

Returns:

Local channel identifier

getRecipient

int getRecipient()

Returns:

Remote channel identifier

getSession

Session getSession()

Returns:

The channel's underlying Session

getLocalWindow

Window getLocalWindow()

getRemoteWindow

Window getRemoteWindow()

getRequestHandlers

List<RequestHandler<Channel>> getRequestHandlers()

addRequestHandler

void addRequestHandler(RequestHandler<Channel> handler)

addRequestHandlers

default void addRequestHandlers(Collection<? extends RequestHandler<Channel>> handlers)

removeRequestHandler

void removeRequestHandler(RequestHandler<Channel> handler)

removeRequestHandlers

default void removeRequestHandlers(Collection<? extends RequestHandler<Channel>> handlers)

handleClose

void handleClose()
          throws IOException

Invoked when SSH_MSG_CHANNEL_CLOSE received

Throws:

IOException - If failed to handle the message

handleWindowAdjust

void handleWindowAdjust(Buffer buffer)
                 throws IOException

Invoked when SSH_MSG_CHANNEL_WINDOW_ADJUST received

Parameters:

buffer - The rest of the message data Buffer after decoding the channel identifiers

Throws:

IOException - If failed to handle the message

handleRequest

void handleRequest(Buffer buffer)
            throws IOException

Invoked when SSH_MSG_CHANNEL_REQUEST received

Parameters:

buffer - The rest of the message data Buffer after decoding the channel identifiers

Throws:

IOException - If failed to handle the message

handleData

void handleData(Buffer buffer)
         throws IOException

Invoked when SSH_MSG_CHANNEL_DATA received

Parameters:

buffer - The rest of the message data Buffer after decoding the channel identifiers

Throws:

IOException - If failed to handle the message

handleExtendedData

void handleExtendedData(Buffer buffer)
                 throws IOException

Invoked when SSH_MSG_CHANNEL_EXTENDED_DATA received

Parameters:

buffer - The rest of the message data Buffer after decoding the channel identifiers

Throws:

IOException - If failed to handle the message

handleEof

void handleEof()
        throws IOException

Invoked when SSH_MSG_CHANNEL_EOF received

Throws:

IOException - If failed to handle the message

handleSuccess

void handleSuccess()
            throws IOException

Invoked when SSH_MSG_CHANNEL_SUCCESS received

Throws:

IOException - If failed to handle the message

handleFailure

void handleFailure()
            throws IOException

Invoked when SSH_MSG_CHANNEL_FAILURE received

Throws:

IOException - If failed to handle the message

init

void init(ConnectionService service,
          Session session,
          int id)
   throws IOException

Invoked when the local channel is initial created

Parameters:

service - The ConnectionService through which the channel is initialized

session - The Session associated with the channel

id - The locally assigned channel identifier

Throws:

IOException - If failed to process the initialization

isInitialized

boolean isInitialized()

Returns:

true if call to init(ConnectionService, Session, int) was successfully completed

isEofSignalled

boolean isEofSignalled()

Returns:

true if the peer signaled that it will not send any more data

See Also:

RFC 4254 - section 5.3 - SSH_MSG_CHANNEL_EOE

open

OpenFuture open(int recipient,
                long rwSize,
                long packetSize,
                Buffer buffer)

For a server channel, this method will actually open the channel

Parameters:

recipient - Recipient identifier

rwSize - Read/Write window size (uint32)

packetSize - Preferred maximum packet size (uint32)

buffer - Incoming Buffer that triggered the call. Note: the buffer's read position is exactly after the information that read to this call was decoded

Returns:

An OpenFuture for the channel open request

handleOpenSuccess

void handleOpenSuccess(int recipient,
                       long rwSize,
                       long packetSize,
                       Buffer buffer)
                throws IOException

For a client channel, this method will be called internally by the session when the confirmation has been received.

Parameters:

recipient - Recipient identifier

rwSize - Read/Write window size (uint32)

packetSize - Preferred maximum packet size (uint32)

buffer - Incoming Buffer that triggered the call. Note: the buffer's read position is exactly after the information that read to this call was decoded

Throws:

IOException - If failed to handle the success

handleOpenFailure

void handleOpenFailure(Buffer buffer)
                throws IOException

For a client channel, this method will be called internally by the session when the server has rejected this channel opening.

Parameters:

buffer - Incoming Buffer that triggered the call. Note: the buffer's read position is exactly after the information that read to this call was decoded

Throws:

IOException - If failed to handle the success