org.tarantool.SocketChannelProvider Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of connector Show documentation

Tarantool client for java

The newest version!

package org.tarantool;

import java.net.SocketAddress;
import java.nio.channels.SocketChannel;

public interface SocketChannelProvider {

    /**
     * Provides socket channel to init restore connection.
     * You could change hosts between retries in this method.
     *
     * @param retryNumber number of current retry.
     * @param lastError   the last error occurs when reconnecting
     *
     * @return the result of {@link SocketChannel#open(SocketAddress)} call
     *
     * @throws SocketProviderTransientException if recoverable error occurred
     * @throws RuntimeException                 if any other reasons occurred
     */
    SocketChannel get(int retryNumber, Throwable lastError);

    /**
     * Gets an address that will be used when
     * {@link #get(int, Throwable)} is invoked.
     *
     * @return effective address or {@literal null}
     *     if it cannot be calculated in advance.
     */
    default SocketAddress getAddress() {
        return null;
    }

}