org.dromara.hutool.extra.ssh.engine.mina

Class MinaSession

java.lang.Object

org.dromara.hutool.extra.ssh.engine.mina.MinaSession

All Implemented Interfaces:

Closeable, AutoCloseable, Wrapper<Object>, Session

public class MinaSession
extends Object
implements Session

Apache MINA SSHD（https://mina.apache.org/sshd-project/）会话封装

Author:

looly

Constructor Summary

Constructors

Constructor and Description
MinaSession(Connector connector) 构造

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) 执行Shell命令
String	exec(String cmd, Charset charset, OutputStream errStream) 执行Shell命令（使用EXEC方式） 此方法单次发送一个命令到服务端，不读取环境变量，执行结束后自动关闭channel，不会产生阻塞。
String	execByShell(String cmd, Charset charset, OutputStream errStream) 执行Shell命令 此方法单次发送一个命令到服务端，自动读取环境变量，执行结束后自动关闭channel，不会产生阻塞。
Object	getRaw()
boolean	isConnected() 是否连接状态
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

MinaSession

public MinaSession(Connector connector)

构造

Parameters:

connector - 连接信息

Method Detail

getRaw

public Object getRaw()

Specified by:

getRaw in interface Wrapper<Object>

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

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)
                      throws IORuntimeException

Description copied from interface: Session

解除远程端口映射

Specified by:

unBindRemotePort in interface Session

Parameters:

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

Throws:

IORuntimeException

exec

public String exec(String cmd,
                   Charset charset)

执行Shell命令

Parameters:

cmd - 命令

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

Returns:

结果

exec

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

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

此方法单次发送一个命令到服务端，不读取环境变量，执行结束后自动关闭channel，不会产生阻塞。

参考：https://github.com/apache/mina-sshd/blob/master/docs/client-setup.md#running-a-command-or-opening-a-shell

Parameters:

cmd - 命令

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

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

Returns:

执行结果内容

execByShell

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

执行Shell命令

此方法单次发送一个命令到服务端，自动读取环境变量，执行结束后自动关闭channel，不会产生阻塞。

Parameters:

cmd - 命令

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

errStream - 异常输出位置

Returns:

结果