okhttp3.internal.connection

Class ConnectionSpecSelector

java.lang.Object

okhttp3.internal.connection.ConnectionSpecSelector

public final class ConnectionSpecSelector
extends java.lang.Object

Handles the connection spec fallback strategy: When a secure socket connection fails due to a handshake / protocol problem the connection may be retried with different protocols. Instances are stateful and should be created and used for a single connection attempt.

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.List<ConnectionSpec>	connectionSpecs
private boolean	isFallback
private boolean	isFallbackPossible
private int	nextModeIndex

Constructor Summary

Constructors

Constructor and Description
ConnectionSpecSelector(java.util.List<ConnectionSpec> connectionSpecs)

Method Summary

Modifier and Type	Method and Description
ConnectionSpec	configureSecureSocket(javax.net.ssl.SSLSocket sslSocket) Configures the supplied SSLSocket to connect to the specified host using an appropriate ConnectionSpec.
boolean	connectionFailed(java.io.IOException e) Reports a failure to complete a connection.
private boolean	isFallbackPossible(javax.net.ssl.SSLSocket socket) Returns true if any later ConnectionSpec in the fallback strategy looks possible based on the supplied SSLSocket.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

connectionSpecs

private final java.util.List<ConnectionSpec> connectionSpecs

nextModeIndex

private int nextModeIndex

isFallbackPossible

private boolean isFallbackPossible

isFallback

private boolean isFallback

Constructor Detail

ConnectionSpecSelector

public ConnectionSpecSelector(java.util.List<ConnectionSpec> connectionSpecs)

Method Detail

configureSecureSocket

public ConnectionSpec configureSecureSocket(javax.net.ssl.SSLSocket sslSocket)
                                     throws java.io.IOException

Configures the supplied SSLSocket to connect to the specified host using an appropriate ConnectionSpec. Returns the chosen ConnectionSpec, never null.

Throws:

java.io.IOException - if the socket does not support any of the TLS modes available

connectionFailed

public boolean connectionFailed(java.io.IOException e)

Reports a failure to complete a connection. Determines the next ConnectionSpec to try, if any.

Returns:

true if the connection should be retried using configureSecureSocket(SSLSocket) or false if not

isFallbackPossible

private boolean isFallbackPossible(javax.net.ssl.SSLSocket socket)

Returns true if any later ConnectionSpec in the fallback strategy looks possible based on the supplied SSLSocket. It assumes that a future socket will have the same capabilities as the supplied socket.