com.squareup.okhttp

Class ConnectionSpec

java.lang.Object

com.squareup.okhttp.ConnectionSpec

public final class ConnectionSpec
extends Object

Specifies configuration for the socket connection that HTTP traffic travels through. For https: URLs, this includes the TLS version and cipher suites to use when negotiating a secure connection.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ConnectionSpec.Builder

Field Summary

Fields

Modifier and Type	Field and Description
static ConnectionSpec	CLEARTEXT Unencrypted, unauthenticated connections for http: URLs.
static ConnectionSpec	COMPATIBLE_TLS A backwards-compatible fallback connection for interop with obsolete servers.
static ConnectionSpec	MODERN_TLS A modern TLS connection with extensions like SNI and ALPN available.

Method Summary

Modifier and Type	Method and Description
List<CipherSuite>	cipherSuites() Returns the cipher suites to use for a connection.
boolean	equals(Object other)
int	hashCode()
boolean	isCompatible(SSLSocket socket) Returns true if the socket, as currently configured, supports this ConnectionSpec.
boolean	isTls()
boolean	supportsTlsExtensions()
List<TlsVersion>	tlsVersions()
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

MODERN_TLS

public static final ConnectionSpec MODERN_TLS

A modern TLS connection with extensions like SNI and ALPN available.

COMPATIBLE_TLS

public static final ConnectionSpec COMPATIBLE_TLS

A backwards-compatible fallback connection for interop with obsolete servers.

CLEARTEXT

public static final ConnectionSpec CLEARTEXT

Unencrypted, unauthenticated connections for http: URLs.

Method Detail

isTls

public boolean isTls()

cipherSuites

public List<CipherSuite> cipherSuites()

Returns the cipher suites to use for a connection. This method can return null if the cipher suites enabled by default should be used.

tlsVersions

public List<TlsVersion> tlsVersions()

supportsTlsExtensions

public boolean supportsTlsExtensions()

isCompatible

public boolean isCompatible(SSLSocket socket)

Returns true if the socket, as currently configured, supports this ConnectionSpec. In order for a socket to be compatible the enabled cipher suites and protocols must intersect.

For cipher suites, at least one of the required cipher suites must match the socket's enabled cipher suites. If there are no required cipher suites the socket must have at least one cipher suite enabled.

For protocols, at least one of the required protocols must match the socket's enabled protocols.

equals

public boolean equals(Object other)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object