com.squareup.okhttp.internal

Class Util

java.lang.Object

com.squareup.okhttp.internal.Util

public final class Util
extends Object

Junk drawer of utility methods.

Field Summary

Fields

Modifier and Type	Field and Description
static byte[]	EMPTY_BYTE_ARRAY
static String[]	EMPTY_STRING_ARRAY
static Charset	UTF_8 A cheap and type-safe constant for the UTF-8 Charset.

Method Summary

Modifier and Type	Method and Description
static void	checkOffsetAndCount(long arrayLength, long offset, long count)
static void	closeAll(Closeable a, Closeable b) Closes a and b.
static void	closeQuietly(Closeable closeable) Closes closeable, ignoring any checked exceptions.
static void	closeQuietly(ServerSocket serverSocket) Closes serverSocket, ignoring any checked exceptions.
static void	closeQuietly(Socket socket) Closes socket, ignoring any checked exceptions.
static boolean	discard(Source source, int timeout, TimeUnit timeUnit) Attempts to exhaust source, returning true if successful.
static boolean	equal(Object a, Object b) Returns true if two possibly-null objects are equal.
static String	hostHeader(HttpUrl url)
static <T> List<T>	immutableList(List<T> list) Returns an immutable copy of list.
static <T> List<T>	immutableList(T... elements) Returns an immutable list containing elements.
static <K,V> Map<K,V>	immutableMap(Map<K,V> map) Returns an immutable copy of map.
static <T> T[]	intersect(Class<T> arrayType, T[] first, T[] second) Returns an array containing containing only elements found in first and also in second.
static boolean	isAndroidGetsocknameError(AssertionError e) Returns true if e is due to a firmware bug fixed after Android 4.2.2.
static String	md5Hex(String s) Returns a 32 character string containing an MD5 hash of s.
static ByteString	sha1(ByteString s) Returns a SHA-1 hash of s.
static String	shaBase64(String s) Returns a Base 64-encoded string containing a SHA-1 hash of s.
static boolean	skipAll(Source source, int duration, TimeUnit timeUnit) Reads until in is exhausted or the deadline has been reached.
static ThreadFactory	threadFactory(String name, boolean daemon)
static String	toHumanReadableAscii(String s) Returns s with control characters and non-ASCII characters replaced with '?'.

Methods inherited from class java.lang.Object

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

Field Detail

EMPTY_BYTE_ARRAY

public static final byte[] EMPTY_BYTE_ARRAY

EMPTY_STRING_ARRAY

public static final String[] EMPTY_STRING_ARRAY

UTF_8

public static final Charset UTF_8

A cheap and type-safe constant for the UTF-8 Charset.

Method Detail

checkOffsetAndCount

public static void checkOffsetAndCount(long arrayLength,
                                       long offset,
                                       long count)

equal

public static boolean equal(Object a,
                            Object b)

Returns true if two possibly-null objects are equal.

closeQuietly

public static void closeQuietly(Closeable closeable)

Closes closeable, ignoring any checked exceptions. Does nothing if closeable is null.

closeQuietly

public static void closeQuietly(Socket socket)

Closes socket, ignoring any checked exceptions. Does nothing if socket is null.

closeQuietly

public static void closeQuietly(ServerSocket serverSocket)

Closes serverSocket, ignoring any checked exceptions. Does nothing if serverSocket is null.

closeAll

public static void closeAll(Closeable a,
                            Closeable b)
                     throws IOException

Closes a and b. If either close fails, this completes the other close and rethrows the first encountered exception.

Throws:

IOException

discard

public static boolean discard(Source source,
                              int timeout,
                              TimeUnit timeUnit)

Attempts to exhaust source, returning true if successful. This is useful when reading a complete source is helpful, such as when doing so completes a cache body or frees a socket connection for reuse.

skipAll

public static boolean skipAll(Source source,
                              int duration,
                              TimeUnit timeUnit)
                       throws IOException

Reads until in is exhausted or the deadline has been reached. This is careful to not extend the deadline if one exists already.

Throws:

IOException

md5Hex

public static String md5Hex(String s)

Returns a 32 character string containing an MD5 hash of s.

shaBase64

public static String shaBase64(String s)

Returns a Base 64-encoded string containing a SHA-1 hash of s.

sha1

public static ByteString sha1(ByteString s)

Returns a SHA-1 hash of s.

immutableList

public static <T> List<T> immutableList(List<T> list)

Returns an immutable copy of list.

immutableList

public static <T> List<T> immutableList(T... elements)

Returns an immutable list containing elements.

immutableMap

public static <K,V> Map<K,V> immutableMap(Map<K,V> map)

Returns an immutable copy of map.

threadFactory

public static ThreadFactory threadFactory(String name,
                                          boolean daemon)

intersect

public static <T> T[] intersect(Class<T> arrayType,
                                T[] first,
                                T[] second)

Returns an array containing containing only elements found in first and also in second. The returned elements are in the same order as in first.

hostHeader

public static String hostHeader(HttpUrl url)

toHumanReadableAscii

public static String toHumanReadableAscii(String s)

Returns s with control characters and non-ASCII characters replaced with '?'.

isAndroidGetsocknameError

public static boolean isAndroidGetsocknameError(AssertionError e)

Returns true if e is due to a firmware bug fixed after Android 4.2.2. https://code.google.com/p/android/issues/detail?id=54072