com.squareup.okhttp.mockwebserver

Enum SocketPolicy

java.lang.Object

java.lang.Enum<SocketPolicy>

com.squareup.okhttp.mockwebserver.SocketPolicy

All Implemented Interfaces:

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

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

What should be done with the incoming socket.

Enum Constant Summary

Enum Constants

Enum Constant and Description
DISCONNECT_AFTER_REQUEST Close connection after reading the request but before writing the response.
DISCONNECT_AT_END Close the socket after the response.
DISCONNECT_AT_START Request immediate close of connection without even reading the request.
FAIL_HANDSHAKE Don't trust the client during the SSL handshake.
KEEP_OPEN Keep the socket open after the response.
NO_RESPONSE Don't response to the request but keep the socket open.
SHUTDOWN_INPUT_AT_END Shutdown the socket input after sending the response.
SHUTDOWN_OUTPUT_AT_END Shutdown the socket output after sending the response.
UPGRADE_TO_SSL_AT_END Wrap the socket with SSL at the completion of this request/response pair.

Method Summary

Methods

Modifier and Type	Method and Description
static SocketPolicy	valueOf(java.lang.String name) Returns the enum constant of this type with the specified name.
static SocketPolicy[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

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

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

KEEP_OPEN

public static final SocketPolicy KEEP_OPEN

Keep the socket open after the response. This is the default HTTP/1.1 behavior.

DISCONNECT_AT_END

public static final SocketPolicy DISCONNECT_AT_END

Close the socket after the response. This is the default HTTP/1.0 behavior.

UPGRADE_TO_SSL_AT_END

public static final SocketPolicy UPGRADE_TO_SSL_AT_END

Wrap the socket with SSL at the completion of this request/response pair. Used for CONNECT messages to tunnel SSL over an HTTP proxy.

DISCONNECT_AT_START

public static final SocketPolicy DISCONNECT_AT_START

Request immediate close of connection without even reading the request. Use to simulate buggy SSL servers closing connections in response to unrecognized TLS extensions.

DISCONNECT_AFTER_REQUEST

public static final SocketPolicy DISCONNECT_AFTER_REQUEST

Close connection after reading the request but before writing the response. Use this to simulate late connection pool failures.

FAIL_HANDSHAKE

public static final SocketPolicy FAIL_HANDSHAKE

Don't trust the client during the SSL handshake.

SHUTDOWN_INPUT_AT_END

public static final SocketPolicy SHUTDOWN_INPUT_AT_END

Shutdown the socket input after sending the response. For testing bad behavior.

SHUTDOWN_OUTPUT_AT_END

public static final SocketPolicy SHUTDOWN_OUTPUT_AT_END

Shutdown the socket output after sending the response. For testing bad behavior.

NO_RESPONSE

public static final SocketPolicy NO_RESPONSE

Don't response to the request but keep the socket open. For testing read response header timeout issue.

Method Detail

values

public static SocketPolicy[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

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

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

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

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

java.lang.IllegalArgumentException - if this enum type has no constant with the specified name

java.lang.NullPointerException - if the argument is null