okhttp3

枚举 Protocol

java.lang.Object

java.lang.Enum<Protocol>

okhttp3.Protocol

所有已实现的接口:

java.io.Serializable, java.lang.Comparable<Protocol>

public enum Protocol
extends java.lang.Enum<Protocol>

Protocols that OkHttp implements for ALPN selection.

Protocol vs Scheme

Despite its name, URL.getProtocol() returns the scheme (http, https, etc.) of the URL, not the protocol (http/1.1, spdy/3.1, etc.). OkHttp uses the word protocol to identify how HTTP messages are framed.

枚举常量概要

枚举常量

枚举常量和说明
HTTP_1_0 An obsolete plaintext framing that does not use persistent sockets by default.
HTTP_1_1 A plaintext framing that includes persistent connections.
HTTP_2 The IETF's binary-framed protocol that includes header compression, multiplexing multiple requests on the same socket, and server-push.
QUIC QUIC (Quick UDP Internet Connection) is a new multiplexed and secure transport atop UDP, designed from the ground up and optimized for HTTP/2 semantics.
SPDY_3 已过时。 OkHttp has dropped support for SPDY. Prefer HTTP_2.

方法概要

限定符和类型	方法和说明
static Protocol	get(java.lang.String protocol) Returns the protocol identified by protocol.
java.lang.String	toString() Returns the string used to identify this protocol for ALPN, like "http/1.1", "spdy/3.1" or "h2".
static Protocol	valueOf(java.lang.String name) 返回带有指定名称的该类型的枚举常量。
static Protocol[]	values() 按照声明该枚举类型的常量的顺序, 返回 包含这些常量的数组。

从类继承的方法 java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, valueOf

从类继承的方法 java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

枚举常量详细资料

HTTP_1_0

public static final Protocol HTTP_1_0

An obsolete plaintext framing that does not use persistent sockets by default.

HTTP_1_1

public static final Protocol HTTP_1_1

A plaintext framing that includes persistent connections.

This version of OkHttp implements RFC 7230, and tracks revisions to that spec.

SPDY_3

public static final Protocol SPDY_3

已过时。 OkHttp has dropped support for SPDY. Prefer HTTP_2.

Chromium's binary-framed protocol that includes header compression, multiplexing multiple requests on the same socket, and server-push. HTTP/1.1 semantics are layered on SPDY/3.

Current versions of OkHttp do not support this protocol.

HTTP_2

public static final Protocol HTTP_2

The IETF's binary-framed protocol that includes header compression, multiplexing multiple requests on the same socket, and server-push. HTTP/1.1 semantics are layered on HTTP/2.

HTTP/2 requires deployments of HTTP/2 that use TLS 1.2 support CipherSuite.TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 , present in Java 8+ and Android 5+. Servers that enforce this may send an exception message including the string INADEQUATE_SECURITY.

QUIC

public static final Protocol QUIC

QUIC (Quick UDP Internet Connection) is a new multiplexed and secure transport atop UDP, designed from the ground up and optimized for HTTP/2 semantics. HTTP/1.1 semantics are layered on HTTP/2.

QUIC is not natively supported by OkHttp, but provided to allow a theoretical interceptor that provides support.

方法详细资料

values

public static Protocol[] values()

按照声明该枚举类型的常量的顺序, 返回 包含这些常量的数组。该方法可用于迭代 常量, 如下所示:

for (Protocol c : Protocol.values())
    System.out.println(c);

返回:

按照声明该枚举类型的常量的顺序返回的包含这些常量的数组

valueOf

public static Protocol valueOf(java.lang.String name)

返回带有指定名称的该类型的枚举常量。 字符串必须与用于声明该类型的枚举常量的 标识符完全匹配。(不允许有多余 的空格字符。)

参数:

name - 要返回的枚举常量的名称。

返回:

返回带有指定名称的枚举常量

抛出:

java.lang.IllegalArgumentException - 如果该枚举类型没有带有指定名称的常量

java.lang.NullPointerException - 如果参数为空值

get

public static Protocol get(java.lang.String protocol)
                    throws java.io.IOException

Returns the protocol identified by protocol.

抛出:

java.io.IOException - if protocol is unknown.

toString

public java.lang.String toString()

Returns the string used to identify this protocol for ALPN, like "http/1.1", "spdy/3.1" or "h2".

覆盖:

toString 在类中 java.lang.Enum<Protocol>

另请参阅:

IANA tls-extensiontype-values