Методы класса Preconditions в библиотеке Guava.

Это первый пост из серии постов описывающих функционал библиотеки google guava.

Guava предоставляет методы служащие для проверки условий и генерации исключения в случае если это условие не выполняется.

Каждый метод имеет три варианта:

• Без дополнительных  аргументов. Метод просто выбрасывает исключение, без сообщения об ошибке.
• Дополнительный аргумент  типа String  который будет использоваться как сообщение об ошибке в выбрасываемом исключении.
• Дополнительный  аргумент который будет подставлен в шаблон сообщени;

 checkArgument(i >= 0, "Argument was %s but expected nonnegative", i); 

  Методы  класса  Preconditions

• checkArgument(boolean) - проверяет  boolean на true. В случае отрицательного результата выбрасывает IllegalArgumentException.
• checkNotNull(T) - проверяет T на null. Выбрасывает NullPointerException.
• checkState(boolean) -  eсли boolean равно false выбрасывает IllegalStateException.
• checkElementIndex(int index, int size) Проверка, что index является индексом элемента в списке, массиве и т.п. с заданым размером size. Index может находится в диапазоне от 0 до  size. Выбрасывает IndexOutOfBoundsException.
• checkPositionIndex(int index, int size)  Проверка, что index  валидная позиция в списке, массиве и т.п. с заданым размером size. Index может находится в диапазоне от 0 до  size включительно.  Выбрасывает IndexOutOfBoundsException.
• checkPositionIndexes(int start, int end, int size) Проверяет, что диапазон от start до end находится в списке, массиве и т.п.  Выбрасывает IndexOutOfBoundsException.