跳到主要内容
版本:7.0.2

Apache Mina SFTP 服务器事件

DeepSeek V3 中英对照 Apache Mina SFTP Server Events

ApacheMinaSftpEventListener 自 5.2 版本起引入,用于监听特定的 Apache Mina SFTP 服务器事件,并将这些事件发布为 ApplicationEvent。这些事件可以被任何 ApplicationListener Bean、@EventListener Bean 方法或事件入站通道适配器接收。

目前支持的事件有:

  • SessionOpenedEvent - 客户端会话已开启

  • DirectoryCreatedEvent - 目录已创建

  • FileWrittenEvent - 文件已被写入

  • PathMovedEvent - 文件或目录已被重命名

  • PathRemovedEvent - 文件或目录已被移除

  • SessionClosedEvent - 客户端已断开连接

这些事件类型都是 ApacheMinaSftpEvent 的子类;你可以配置一个监听器来接收所有事件类型。每个事件的 source 属性是一个 ServerSession,你可以从中获取客户端地址等信息;抽象事件上提供了一个便捷的 getSession() 方法。

要配置服务器以使用监听器(必须是一个Spring Bean),只需将其添加到 SftpSubsystemFactory 中:

server = SshServer.setUpDefaultServer();
...
SftpSubsystemFactory sftpFactory = new SftpSubsystemFactory();
sftpFactory.addSftpEventListener(apacheMinaSftpEventListenerBean);
...

要使用 Spring Integration 事件适配器来消费这些事件:

@Bean
public ApplicationEventListeningMessageProducer eventsAdapter() {
ApplicationEventListeningMessageProducer producer =
new ApplicationEventListeningMessageProducer();
producer.setEventTypes(ApacheMinaSftpEvent.class);
producer.setOutputChannel(eventChannel());
return producer;
}