Package org.miaixz.bus.extra.ssh.provider.sshj

Class SshjSession

java.lang.Object

org.miaixz.bus.extra.ssh.provider.sshj.SshjSession

All Implemented Interfaces:

Closeable, AutoCloseable, org.miaixz.bus.core.lang.Wrapper<Object>, org.miaixz.bus.core.Provider, Session

public class SshjSession
extends Object
implements Session

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

Since:

Java 17+

Author:

Kimi Liu

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	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.miaixz.bus.extra.ssh.Session

bindLocalPort, unBindLocalPort

Methods inherited from interface org.miaixz.bus.core.lang.Wrapper

type

Constructor Details

SshjSession

public SshjSession(Connector connector)

构造

Parameters:

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

SshjSession

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

构造

Parameters:

ssh - SSHClient

Method Details

getRaw

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

Specified by:

getRaw in interface org.miaixz.bus.core.lang.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 AutoCloseable

Specified by:

close in interface Closeable

Throws:

IOException

openSftp

public SshjSftp openSftp(Charset charset)

打开SFTP会话

Parameters:

charset - 编码

Returns:

SshjSftp

bindLocalPort

public void bindLocalPort(InetSocketAddress localAddress,
 InetSocketAddress remoteAddress)
                   throws org.miaixz.bus.core.lang.exception.InternalException

Description copied from interface: Session

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

Specified by:

bindLocalPort in interface Session

Parameters:

localAddress - 本地主机和端口

remoteAddress - 远程主机和端口

Throws:

org.miaixz.bus.core.lang.exception.InternalException

unBindLocalPort

public void unBindLocalPort(InetSocketAddress localAddress)
                     throws org.miaixz.bus.core.lang.exception.InternalException

Description copied from interface: Session

解除本地端口映射

Specified by:

unBindLocalPort in interface Session

Parameters:

localAddress - 需要解除的本地地址

Throws:

org.miaixz.bus.core.lang.exception.InternalException

bindRemotePort

public void bindRemotePort(InetSocketAddress remoteAddress,
 InetSocketAddress localAddress)
                    throws org.miaixz.bus.core.lang.exception.InternalException

Description copied from interface: Session

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

Specified by:

bindRemotePort in interface Session

Parameters:

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

localAddress - 转发到的本地地址

Throws:

org.miaixz.bus.core.lang.exception.InternalException - 端口绑定失败异常

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:

执行返回结果