org.apache.sshd.client.channel

Class AbstractClientChannel

java.lang.Object

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

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

org.apache.sshd.common.channel.AbstractChannel

org.apache.sshd.client.channel.AbstractClientChannel

All Implemented Interfaces:

ClientChannel, Channel, Closeable

Direct Known Subclasses:

AgentForwardedChannel, AgentForwardedChannel, ChannelDirectTcpip, ChannelSession, TcpipClientChannel, X11ForwardSupport.ChannelForwardedX11

public abstract class AbstractClientChannel
extends AbstractChannel
implements ClientChannel

TODO Add javadoc

Author:

Apache MINA SSHD Project

Field Summary

Fields

Modifier and Type	Field and Description
protected java.io.OutputStream	err
protected java.lang.String	exitSignal
protected java.lang.Integer	exitStatus
protected java.io.InputStream	in
protected java.io.InputStream	invertedErr
protected java.io.OutputStream	invertedIn
protected java.io.InputStream	invertedOut
protected boolean	opened
protected java.lang.String	openFailureMsg
protected int	openFailureReason
protected OpenFuture	openFuture
protected java.io.OutputStream	out
protected java.lang.String	type

Fields inherited from class org.apache.sshd.common.channel.AbstractChannel

CLOSE_RECV, CLOSE_SENT, DEFAULT_PACKET_SIZE, DEFAULT_WINDOW_SIZE, eof, gracefulState, handlers, id, localWindow, recipient, remoteWindow, service, session

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.ClientChannel

CHANNEL_EXEC, CHANNEL_SHELL, CHANNEL_SUBSYSTEM, CLOSED, EOF, EXIT_SIGNAL, EXIT_STATUS, OPENED, STDERR_DATA, STDOUT_DATA, TIMEOUT

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractClientChannel(java.lang.String type)

Method Summary

Methods

Modifier and Type	Method and Description
CloseFuture	close(boolean immediately) Close this resource asynchronously and return a future.
protected abstract void	doOpen()
protected void	doWriteData(byte[] data, int off, int len)
protected void	doWriteExtendedData(byte[] data, int off, int len)
java.io.OutputStream	getErr()
java.lang.Integer	getExitStatus()
java.io.InputStream	getIn()
java.io.InputStream	getInvertedErr()
java.io.OutputStream	getInvertedIn() Access to an output stream to send data directly to the remote channel.
java.io.InputStream	getInvertedOut()
java.io.OutputStream	getOut()
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, int rwsize, int rmpsize, Buffer buffer) For a client channel, this method will be called internally by the session when the confirmation has been received.
protected OpenFuture	internalOpen()
OpenFuture	open(int recipient, int rwsize, int rmpsize, Buffer buffer) For a server channel, this method will actually open the channel
protected void	postClose()
void	setErr(java.io.OutputStream err)
void	setIn(java.io.InputStream in) Set an input stream that will be read by this channel and forwarded to the remote channel.
void	setOut(java.io.OutputStream out)
int	waitFor(int mask, long timeout)

Methods inherited from class org.apache.sshd.common.channel.AbstractChannel

addRequestHandler, configureWindow, getGracefulCloseable, getId, getInnerCloseable, getLocalWindow, getRecipient, getRemoteWindow, getSession, handleClose, handleData, handleEof, handleExtendedData, handleFailure, handleRequest, handleWindowAdjust, init, notifyStateChanged, sendEof, sendWindowAdjust, toString, writePacket

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

doCloseGracefully, doCloseImmediately

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.sshd.ClientChannel

open

Field Detail

opened

protected volatile boolean opened

type

protected final java.lang.String type

in

protected java.io.InputStream in

invertedIn

protected java.io.OutputStream invertedIn

out

protected java.io.OutputStream out

invertedOut

protected java.io.InputStream invertedOut

err

protected java.io.OutputStream err

invertedErr

protected java.io.InputStream invertedErr

exitStatus

protected java.lang.Integer exitStatus

exitSignal

protected java.lang.String exitSignal

openFailureReason

protected int openFailureReason

openFailureMsg

protected java.lang.String openFailureMsg

openFuture

protected OpenFuture openFuture

Constructor Detail

AbstractClientChannel

protected AbstractClientChannel(java.lang.String type)

Method Detail

getInvertedIn

public java.io.OutputStream getInvertedIn()

Description copied from interface: ClientChannel

Access to an output stream to send data directly to the remote channel. This can be used instead of using ClientChannel.setIn(java.io.InputStream) method and having the channel polling for data in that stream.

Specified by:

getInvertedIn in interface ClientChannel

Returns:

an OutputStream to be used to send data

getIn

public java.io.InputStream getIn()

setIn

public void setIn(java.io.InputStream in)

Description copied from interface: ClientChannel

Set an input stream that will be read by this channel and forwarded to the remote channel. Note that using such a stream will create an additional thread for pumping the stream which will only be able to end when that stream is actually closed or some data is read. It is recommended to use the ClientChannel.getInvertedIn() method instead and write data directly.

Specified by:

setIn in interface ClientChannel

Parameters:

in - an InputStream to be polled and forwarded

getInvertedOut

public java.io.InputStream getInvertedOut()

Specified by:

getInvertedOut in interface ClientChannel

getOut

public java.io.OutputStream getOut()

setOut

public void setOut(java.io.OutputStream out)

Specified by:

setOut in interface ClientChannel

getInvertedErr

public java.io.InputStream getInvertedErr()

Specified by:

getInvertedErr in interface ClientChannel

getErr

public java.io.OutputStream getErr()

setErr

public void setErr(java.io.OutputStream err)

Specified by:

setErr in interface ClientChannel

close

public CloseFuture close(boolean immediately)

Description copied from interface: Closeable

Close this resource asynchronously and return a future. Resources support two closing modes: a graceful mode which will cleanly close the resource and an immediate mode which will close the resources abruptly.

Specified by:

close in interface ClientChannel

Specified by:

close in interface Channel

Specified by:

close in interface Closeable

Overrides:

close in class CloseableUtils.AbstractCloseable

Parameters:

immediately - true if the resource should be shut down abruptly, false for a graceful close

Returns:

a future

postClose

protected void postClose()

Overrides:

postClose in class AbstractChannel

waitFor

public int waitFor(int mask,
          long timeout)

Specified by:

waitFor in interface ClientChannel

internalOpen

protected OpenFuture internalOpen()
                           throws java.io.IOException

Throws:

java.io.IOException

open

public OpenFuture open(int recipient,
              int rwsize,
              int rmpsize,
              Buffer buffer)

Description copied from interface: Channel

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

Specified by:

open in interface Channel

handleOpenSuccess

public void handleOpenSuccess(int recipient,
                     int rwsize,
                     int rmpsize,
                     Buffer buffer)

Description copied from interface: Channel

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

Specified by:

handleOpenSuccess in interface Channel

doOpen

protected abstract void doOpen()
                        throws java.io.IOException

Throws:

java.io.IOException

handleOpenFailure

public void handleOpenFailure(Buffer buffer)

Description copied from interface: Channel

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

Specified by:

handleOpenFailure in interface Channel

doWriteData

protected void doWriteData(byte[] data,
               int off,
               int len)
                    throws java.io.IOException

Specified by:

doWriteData in class AbstractChannel

Throws:

java.io.IOException

doWriteExtendedData

protected void doWriteExtendedData(byte[] data,
                       int off,
                       int len)
                            throws java.io.IOException

Specified by:

doWriteExtendedData in class AbstractChannel

Throws:

java.io.IOException

getExitStatus

public java.lang.Integer getExitStatus()

Specified by:

getExitStatus in interface ClientChannel