org.dromara.hutool.extra.ssh.engine.sshj

Class SshjSession

java.lang.Object

org.dromara.hutool.extra.ssh.engine.sshj.SshjSession

All Implemented Interfaces:

Closeable, AutoCloseable, Wrapper<Object>, Session

public class SshjSession
extends Object
implements Session

基于SSHJ（https://github.com/hierynomus/sshj）的Session封装

Author:

looly

Constructor Summary

Constructors

Constructor and Description
SshjSession(Connector connector) 构造
SshjSession(net.schmizz.sshj.SSHClient ssh) 构造

Method Summary

Modifier and Type	Method and Description
void	bindLocalPort(InetSocketAddress localAddress, InetSocketAddress remoteAddress) 绑定端口到本地。
void	bindRemotePort(InetSocketAddress remoteAddress, InetSocketAddress localAddress) 绑定ssh服务端的serverPort端口, 到本地主机的port端口上.
void	close()
String	exec(String cmd, Charset charset, OutputStream errStream) 执行Shell命令（使用EXEC方式） 此方法单次发送一个命令到服务端，不读取环境变量，不会产生阻塞。
String	execByShell(String cmd, Charset charset, OutputStream errStream) 执行Shell命令 此方法单次发送一个命令到服务端，自动读取环境变量，可能产生阻塞。
net.schmizz.sshj.connection.channel.direct.Session	getRaw() 获取原始对象
boolean	isConnected() 是否连接状态
SshjSftp	openSftp(Charset charset) 打开SFTP会话
void	unBindLocalPort(InetSocketAddress localAddress) 解除本地端口映射
void	unBindRemotePort(InetSocketAddress remoteAddress) 解除远程端口映射

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.dromara.hutool.extra.ssh.Session

bindLocalPort, unBindLocalPort

Constructor Detail

SshjSession

public SshjSession(Connector connector)

构造

Parameters:

connector - Connector，保存连接和验证信息等

SshjSession

public SshjSession(net.schmizz.sshj.SSHClient ssh)

构造

Parameters:

ssh - SSHClient

Method Detail

getRaw

public net.schmizz.sshj.connection.channel.direct.Session getRaw()

Description copied from interface: Wrapper

获取原始对象

Specified by:

getRaw in interface Wrapper<Object>

Returns:

原始对象

isConnected

public boolean isConnected()

Description copied from interface: Session

是否连接状态

Specified by:

isConnected in interface Session

Returns:

是否连接状态

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException

openSftp

public SshjSftp openSftp(Charset charset)

打开SFTP会话

Parameters:

charset - 编码

Returns:

SshjSftp

bindLocalPort

public void bindLocalPort(InetSocketAddress localAddress,
                          InetSocketAddress remoteAddress)
                   throws IORuntimeException

Description copied from interface: Session

绑定端口到本地。 一个会话可绑定多个端口
当请求localHost:localPort时，通过SSH到服务器，转发请求到remoteHost:remotePort
此方法用于访问本地无法访问但是服务器可以访问的地址，如只有服务器能访问的内网数据库等

Specified by:

bindLocalPort in interface Session

Parameters:

localAddress - 本地主机和端口

remoteAddress - 远程主机和端口

Throws:

IORuntimeException

unBindLocalPort

public void unBindLocalPort(InetSocketAddress localAddress)
                     throws IORuntimeException

Description copied from interface: Session

解除本地端口映射

Specified by:

unBindLocalPort in interface Session

Parameters:

localAddress - 需要解除的本地地址

Throws:

IORuntimeException

bindRemotePort

public void bindRemotePort(InetSocketAddress remoteAddress,
                           InetSocketAddress localAddress)
                    throws IORuntimeException

Description copied from interface: Session

绑定ssh服务端的serverPort端口, 到本地主机的port端口上.
即数据从ssh服务端的serverPort端口, 流经ssh客户端, 达到host:port上.
此方法用于在服务端访问本地资源，如服务器访问本机所在的数据库等。

Specified by:

bindRemotePort in interface Session

Parameters:

remoteAddress - ssh服务端上要被绑定的地址

localAddress - 转发到的本地地址

Throws:

IORuntimeException

unBindRemotePort

public void unBindRemotePort(InetSocketAddress remoteAddress)

Description copied from interface: Session

解除远程端口映射

Specified by:

unBindRemotePort in interface Session

Parameters:

remoteAddress - 需要解除的远程地址和端口

exec

public String exec(String cmd,
                   Charset charset,
                   OutputStream errStream)

执行Shell命令（使用EXEC方式）

此方法单次发送一个命令到服务端，不读取环境变量，不会产生阻塞。

Parameters:

cmd - 命令

charset - 发送和读取内容的编码

errStream - 错误信息输出到的位置

Returns:

执行返回结果

execByShell

public String execByShell(String cmd,
                          Charset charset,
                          OutputStream errStream)

执行Shell命令

此方法单次发送一个命令到服务端，自动读取环境变量，可能产生阻塞。

Parameters:

cmd - 命令

charset - 发送和读取内容的编码

errStream - 错误信息输出到的位置

Returns:

执行返回结果