com.google.android.exoplayer2.util

Class Assertions

java.lang.Object

com.google.android.exoplayer2.util.Assertions

public final class Assertions
extends java.lang.Object

Provides methods for asserting the truth of expressions and properties.

Method Summary

Modifier and Type	Method and Description
static void	checkArgument(boolean expression) Throws IllegalArgumentException if expression evaluates to false.
static void	checkArgument(boolean expression, java.lang.Object errorMessage) Throws IllegalArgumentException if expression evaluates to false.
static int	checkIndex(int index, int start, int limit) Throws IndexOutOfBoundsException if index falls outside the specified bounds.
static void	checkMainThread() Throws IllegalStateException if the calling thread is not the application's main thread.
static java.lang.String	checkNotEmpty(java.lang.String string) Throws IllegalArgumentException if string is null or zero length.
static java.lang.String	checkNotEmpty(java.lang.String string, java.lang.Object errorMessage) Throws IllegalArgumentException if string is null or zero length.
static <T> T	checkNotNull(T reference) Throws NullPointerException if reference is null.
static <T> T	checkNotNull(T reference, java.lang.Object errorMessage) Throws NullPointerException if reference is null.
static void	checkState(boolean expression) Throws IllegalStateException if expression evaluates to false.
static void	checkState(boolean expression, java.lang.Object errorMessage) Throws IllegalStateException if expression evaluates to false.

Methods inherited from class java.lang.Object

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

Method Detail

checkArgument

public static void checkArgument(boolean expression)

Throws IllegalArgumentException if expression evaluates to false.

Parameters:

expression - The expression to evaluate.

Throws:

java.lang.IllegalArgumentException - If expression is false.

checkArgument

public static void checkArgument(boolean expression,
                                 java.lang.Object errorMessage)

Throws IllegalArgumentException if expression evaluates to false.

Parameters:

expression - The expression to evaluate.

errorMessage - The exception message if an exception is thrown. The message is converted to a String using String.valueOf(Object).

Throws:

java.lang.IllegalArgumentException - If expression is false.

checkIndex

public static int checkIndex(int index,
                             int start,
                             int limit)

Throws IndexOutOfBoundsException if index falls outside the specified bounds.

Parameters:

index - The index to test.

start - The start of the allowed range (inclusive).

limit - The end of the allowed range (exclusive).

Returns:

The index that was validated.

Throws:

java.lang.IndexOutOfBoundsException - If index falls outside the specified bounds.

checkState

public static void checkState(boolean expression)

Throws IllegalStateException if expression evaluates to false.

Parameters:

expression - The expression to evaluate.

Throws:

java.lang.IllegalStateException - If expression is false.

checkState

public static void checkState(boolean expression,
                              java.lang.Object errorMessage)

Throws IllegalStateException if expression evaluates to false.

Parameters:

expression - The expression to evaluate.

errorMessage - The exception message if an exception is thrown. The message is converted to a String using String.valueOf(Object).

Throws:

java.lang.IllegalStateException - If expression is false.

checkNotNull

@EnsuresNonNull(value="#1")
public static <T> T checkNotNull(@Nullable
                                                             T reference)

Throws NullPointerException if reference is null.

Type Parameters:

T - The type of the reference.

Parameters:

reference - The reference.

Returns:

The non-null reference that was validated.

Throws:

java.lang.NullPointerException - If reference is null.

checkNotNull

@EnsuresNonNull(value="#1")
public static <T> T checkNotNull(@Nullable
                                                             T reference,
                                                             java.lang.Object errorMessage)

Throws NullPointerException if reference is null.

Type Parameters:

T - The type of the reference.

Parameters:

reference - The reference.

errorMessage - The exception message to use if the check fails. The message is converted to a string using String.valueOf(Object).

Returns:

The non-null reference that was validated.

Throws:

java.lang.NullPointerException - If reference is null.

checkNotEmpty

@EnsuresNonNull(value="#1")
public static java.lang.String checkNotEmpty(@Nullable
                                                                         java.lang.String string)

Throws IllegalArgumentException if string is null or zero length.

Parameters:

string - The string to check.

Returns:

The non-null, non-empty string that was validated.

Throws:

java.lang.IllegalArgumentException - If string is null or 0-length.

checkNotEmpty

@EnsuresNonNull(value="#1")
public static java.lang.String checkNotEmpty(@Nullable
                                                                         java.lang.String string,
                                                                         java.lang.Object errorMessage)

Throws IllegalArgumentException if string is null or zero length.

Parameters:

string - The string to check.

errorMessage - The exception message to use if the check fails. The message is converted to a string using String.valueOf(Object).

Returns:

The non-null, non-empty string that was validated.

Throws:

java.lang.IllegalArgumentException - If string is null or 0-length.

checkMainThread

public static void checkMainThread()

Throws IllegalStateException if the calling thread is not the application's main thread.

Throws:

java.lang.IllegalStateException - If the calling thread is not the application's main thread.