okhttp3.internal.platform

Class Platform

java.lang.Object

okhttp3.internal.platform.Platform

public class Platform
extends Object

Access to platform-specific features.

Server name indication (SNI)

Supported on Android 2.3+. Supported on OpenJDK 7+

Session Tickets

Supported on Android 2.3+.

Android Traffic Stats (Socket Tagging)

Supported on Android 4.0+.

ALPN (Application Layer Protocol Negotiation)

Supported on Android 5.0+. The APIs were present in Android 4.4, but that implementation was unstable. Supported on OpenJDK 7 and 8 (via the JettyALPN-boot library). Supported on OpenJDK 9 via SSLParameters and SSLSocket features.

Trust Manager Extraction

Supported on Android 2.3+ and OpenJDK 7+. There are no public APIs to recover the trust manager that was used to create an SSLSocketFactory.

Android Cleartext Permit Detection

Supported on Android 6.0+ via NetworkSecurityPolicy.

Field Summary

Fields

Modifier and Type	Field and Description
static int	INFO
static int	WARN

Constructor Summary

Constructors

Constructor and Description
Platform()

Method Summary

Modifier and Type	Method and Description
void	afterHandshake(SSLSocket sslSocket) Called after the TLS handshake to release resources allocated by configureTlsExtensions(javax.net.ssl.SSLSocket, java.lang.String, java.util.List<okhttp3.Protocol>).
static List<String>	alpnProtocolNames(List<Protocol> protocols)
CertificateChainCleaner	buildCertificateChainCleaner(X509TrustManager trustManager)
void	configureTlsExtensions(SSLSocket sslSocket, String hostname, List<Protocol> protocols) Configure TLS extensions on sslSocket for route.
void	connectSocket(Socket socket, InetSocketAddress address, int connectTimeout)
static Platform	get()
String	getPrefix() Prefix used on custom headers.
String	getSelectedProtocol(SSLSocket socket) Returns the negotiated protocol, or null if no protocol was negotiated.
Object	getStackTraceForCloseable(String closer) Returns an object that holds a stack trace created at the moment this method is executed.
boolean	isCleartextTrafficPermitted(String hostname)
void	log(int level, String message, Throwable t)
void	logCloseableLeak(String message, Object stackTrace)
X509TrustManager	trustManager(SSLSocketFactory sslSocketFactory)

Methods inherited from class java.lang.Object

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

Field Detail

INFO

public static final int INFO

See Also:

Constant Field Values

WARN

public static final int WARN

See Also:

Constant Field Values

Constructor Detail

Platform

public Platform()

Method Detail

get

public static Platform get()

getPrefix

public String getPrefix()

Prefix used on custom headers.

trustManager

public X509TrustManager trustManager(SSLSocketFactory sslSocketFactory)

configureTlsExtensions

public void configureTlsExtensions(SSLSocket sslSocket,
                                   String hostname,
                                   List<Protocol> protocols)

Configure TLS extensions on sslSocket for route.

Parameters:

hostname - non-null for client-side handshakes; null for server-side handshakes.

afterHandshake

public void afterHandshake(SSLSocket sslSocket)

Called after the TLS handshake to release resources allocated by configureTlsExtensions(javax.net.ssl.SSLSocket, java.lang.String, java.util.List<okhttp3.Protocol>).

getSelectedProtocol

public String getSelectedProtocol(SSLSocket socket)

Returns the negotiated protocol, or null if no protocol was negotiated.

connectSocket

public void connectSocket(Socket socket,
                          InetSocketAddress address,
                          int connectTimeout)
                   throws IOException

Throws:

IOException

log

public void log(int level,
                String message,
                Throwable t)

isCleartextTrafficPermitted

public boolean isCleartextTrafficPermitted(String hostname)

getStackTraceForCloseable

public Object getStackTraceForCloseable(String closer)

Returns an object that holds a stack trace created at the moment this method is executed. This should be used specifically for Closeable objects and in conjunction with logCloseableLeak(String, Object).

logCloseableLeak

public void logCloseableLeak(String message,
                             Object stackTrace)

alpnProtocolNames

public static List<String> alpnProtocolNames(List<Protocol> protocols)

buildCertificateChainCleaner

public CertificateChainCleaner buildCertificateChainCleaner(X509TrustManager trustManager)