测试连接

在某些场景下，当连接首次打开时发送某种健康检查请求可能会很有用。一种这样的场景是在使用 TCP 故障转移客户端连接工厂时，以便在选定的服务器允许连接打开但报告不健康时能够进行故障转移。

为了支持此功能，请向客户端连接工厂添加 connectionTest。

/**
 * Set a {@link Predicate} that will be invoked to test a new connection; return true
 * to accept the connection, false the reject.
 * @param connectionTest the predicate.
 * @since 5.3
 */
public void setConnectionTest(@Nullable Predicate<TcpConnectionSupport> connectionTest) {
    this.connectionTest = connectionTest;
}

为了测试连接，在测试期间向连接附加一个临时监听器。如果测试失败，连接将被关闭并抛出异常。与 TCP 故障转移客户端连接工厂一起使用时，这会触发尝试下一个服务器。

服务器的第一个回复将只发送给测试监听器。

在以下示例中，如果服务器在我们发送 PING 时回复 PONG，则认为服务器是健康的。

Message<String> ping = new GenericMessage<>("PING");
byte[] pong = "PONG".getBytes();
clientFactory.setConnectionTest(conn -> {
    CountDownLatch latch = new CountDownLatch(1);
    AtomicBoolean result = new AtomicBoolean();
    conn.registerTestListener(msg -> {
        if (Arrays.equals(pong, (byte[]) msg.getPayload())) {
            result.set(true);
        }
        latch.countDown();
        return false;
    });
    conn.send(ping);
    try {
        latch.await(10, TimeUnit.SECONDS);
    }
    catch (InterruptedException e) {
        Thread.currentThread().interrupt();
    }
    return result.get();
});