入站通道适配器：轮询多个服务器和目录

从 5.0.7 版本开始，提供了 RotatingServerAdvice；当将其配置为轮询器建议时，入站适配器可以轮询多个服务器和目录。配置建议并将其添加到轮询器的建议链中，这与正常操作无异。一个 DelegatingSessionFactory 用于选择服务器，更多信息请参阅委托会话工厂。该建议的配置由 RotationPolicy.KeyDirectory 对象的列表组成。

示例

@Bean
public RotatingServerAdvice advice() {
    List<RotationPolicy.KeyDirectory> keyDirectories = new ArrayList<>();
    keyDirectories.add(new RotationPolicy.KeyDirectory("one", "foo"));
    keyDirectories.add(new RotationPolicy.KeyDirectory("one", "bar"));
    keyDirectories.add(new RotationPolicy.KeyDirectory("two", "baz"));
    keyDirectories.add(new RotationPolicy.KeyDirectory("two", "qux"));
    keyDirectories.add(new RotationPolicy.KeyDirectory("three", "fiz"));
    keyDirectories.add(new RotationPolicy.KeyDirectory("three", "buz"));
    return new RotatingServerAdvice(delegatingSf(), keyDirectories);
}

此建议将轮询服务器 one 上的目录 foo，直到没有新文件存在，然后移至服务器 two 上的目录 bar，接着是目录 baz，依此类推。

此默认行为可通过 fair 构造函数参数进行修改

公平

@Bean
public RotatingServerAdvice advice() {
    ...
    return new RotatingServerAdvice(delegatingSf(), keyDirectories, true);
}

在这种情况下，无论前一次轮询是否返回文件，建议都将移至下一个服务器/目录。

或者，您可以提供自己的 RotationPolicy 以根据需要重新配置消息源

policy

public interface RotationPolicy {

    void beforeReceive(MessageSource<?> source);

    void afterReceive(boolean messageReceived, MessageSource<?> source);

}

和

custom

@Bean
public RotatingServerAdvice advice() {
    return new RotatingServerAdvice(myRotationPolicy());
}

local-filename-generator-expression 属性（同步器上的 localFilenameGeneratorExpression）现在可以包含 #remoteDirectory 变量。这使得从不同目录检索的文件可以下载到本地相似的目录中

@Bean
public IntegrationFlow flow() {
    return IntegrationFlow.from(Sftp.inboundAdapter(sf())
                    .filter(new SftpPersistentAcceptOnceFileListFilter(new SimpleMetadataStore(), "rotate"))
                    .localDirectory(new File(tmpDir))
                    .localFilenameExpression("#remoteDirectory + T(java.io.File).separator + #root")
                    .remoteDirectory("."),
                e -> e.poller(Pollers.fixedDelay(1).advice(advice())))
            .channel(MessageChannels.queue("files"))
            .get();
}

使用此建议时，请勿在轮询器上配置 TaskExecutor；更多信息请参阅消息源的条件轮询器。

此外，当并非所有获取的文件都在单个轮询周期内处理，但 SessionFactory 可能会轮换到不同的会话时，还可以使用便捷的 AbstractRemoteFileStreamingMessageSource.clearFetchedCache() API。