Как работает assert asserttrue java
assert и assertTrue в Java используются для проверки утверждений ( assertions ) в коде.
assert позволяет утверждать, что определенное условие истинно в точке кода, где это утверждение находится. Если условие ложно, генерируется исключение типа AssertionError , которое указывает на ошибку в коде.
Пример использования assert :
Если значение переменной x не равно 5, будет сгенерировано исключение AssertionError
assertTrue проверяет, что переданное ему условие истинно. Если условие ложно, генерируется исключение типа AssertionError
Пример использования assertTrue :
Этот код эквивалентен предыдущему примеру с assert
Оба эти метода полезны для написания тестовых сценариев ( unit-тестирование ), чтобы автоматически проверять корректность работы кода.
Примеры утверждений JUnit 5
Это продолжение туториала по JUnit 5. Введение опубликовано здесь.
Утверждения (Assertions) JUnit 5 помогают сравнить ожидаемый результат с фактическим результатом теста. Для простоты все утверждения JUnit Jupiter являются статическими методами в классе org.junit.jupiter.Assertions.
Не успешные утверждения будет генерировать исключение AssertionFailedError или его подкласс.
Оглавление
assertEquals() и assertNotEquals()
assertNotNull() и assertNull()
assertNotSame() и assertSame()
assertTimeout() и assertTimeoutPreemptively()
assertTrue() и assertFalse)
1. assertEquals() и assertNotEquals()
Метод Assertions.assertEquals() используется для подтверждения того, что ожидаемое и фактическое значения равны. Метод assertEquals() ммеет много перегруженных методов для разных типов данных, например, int, short, float, char и т. д. Он также выдает сообщения об ошибках, которые будут напечатаны в случае если тест будет неуспешным. например
Перегруженные методы
Примеры
Точно так же метод Assertions.assertNotEquals() используется для утверждения, что ожидаемое и фактическое значения НЕ равны. В отличие от метода assertEquals() , assertNotEquals() не содержит перегруженных методов для разных типов данных, а только параметр типа Object принимается.
Перегруженные методы
Примеры
2. assertArrayEquals()
Метод assertArrayEquals() утверждает, что ожидаемый и фактический массивы равны.
Он также имеет перегруженные методы для различных типов данных, например, boolean[], char[], int[] и т. д. Он также выдает сообщения об ошибках, которые будут напечатаны в случае сбоя теста. например
Перегруженные методы
Примеры
3. assertIterableEquals()
Метод assertIterableEquals() утверждает,, что ожидаемые и фактические итерации полностью равны. «Глубокое равенство» означает, что количество и порядок элементов в коллекции должны быть одинаковыми, а повторяющиеся элементы должны быть одинаковыми.
У него также есть три перегруженных метода.
Перегруженные методы
Примеры
4. assertLinesMatch()
Он утверждает, что ожидаемый список строк соответствует фактическому списку. Логика сопоставления строки с другой строкой:
проверьте, если expected.equals(actual) — если да, переходите к следующей паре
в противном случае рассматривать expected как регулярное выражение и проверять переход String.matches(String) — если да, переходить к следующей паре
в противном случае проверьте, является ли expected строка маркером быстрой перемотки вперед, если да, примените соответствующие строки быстрой перемотки вперед и перейдите к 1.
Допустимый маркер быстрой перемотки вперед — это строка, которая начинается и заканчивается >> и содержит не менее четырех символов. Любой символ между литералами быстрой перемотки вперед отбрасывается.
5. assertNotNull() и assertNull()
AssertNotNull() утверждает, что фактическое значение НЕ равно нулю. Точно так же метод assertNull() утверждает, что это действительно так null . У обоих есть три перегруженных метода.
Перегруженные методы
Примеры
6. assertNotSame() и assertSame()
assertNotSame() утверждает, что ожидаемый и фактический не относятся к одному объекту. Точно так же метод assertSame() утверждает, что ожидаемый и фактический относятся к одному и тому же объекту.
У обоих есть три перегруженных метода.
Перегруженные методы
Примеры
7. assertTimeout() и assertTimeoutPreemptively()
Методы assertTimeout() и assertTimeoutPreemptively() используются для тестирования долго выполняющихся задач. Если заданная задача в тесте занимает больше указанной продолжительности, тест завершится неудачно.
Единственная разница между обоими методами заключается в том, что в assertTimeoutPreemptively() выполнение Executable или ThrowingSupplier будет прервано с упреждением при превышении тайм-аута. В случае assertTimeout() , Executable или ThrowingSupplier не будет прервана.
Перегруженные методы
Примеры
8. assertTrue() и assertFalse()
Метод assertTrue() утверждает, что предоставленное условие истинно или предоставленное логическое условие BooleanSupplier истинно.
Точно так же assertFalse() утверждает, что предоставленное условие ложно.
У обоих есть следующие перегруженные методы:
Перегруженные методы
Примеры
9. assertThrows()
assetThrows() утверждает, что исполнение подаваемы Executable генерирует исключение из expectedType и возвращает исключение.
Перегруженные методы
Примеры
10. Пример fail()
Метод fail() делает тест неуспешным. Он имеет следующие перегруженные методы:
How to use assertTrue?
package with org.junit is set and working but in line with assertTrue i have error:
The method assertTrue(int, int) is undefined for the type Test
Why? I use Eclipse.
5 Answers 5
assertTrue is based on a single boolean condition. For example
You need to import the statement statically to use
Typically, however assertEquals is used when comparing 2 parameters, e.g.
You have to specify the class that defines that method:
Furthermore you’re calling the method with 2 parameters which makes no sense. assertTrue expects a single boolean expression.
Although you can also do this by using a static import:
which will allow you to call it as assertTrue(condition); instead.
From the doc : assertTrue(boolean) or assertTrue(String, boolean) if you want to add a message.
AssertTrue assert that a condition is true, you still have to code such condition for it to be evaluated at runtime.
JUnit Assertions
Ассерты (asserts) — это специальные проверки , которые можно вставить в разные места кода. Их задача определять, что что-то пошло не так. Вернее, проверять, что все идет как нужно. Вот это “как нужно” они и позволяют задать различными способами.
С некоторыми ассертами ты уже сталкивался в коде выше. Первый из них – проверка объектов на равенство. Если объекты не равны — кинется исключение и тест будет провален.
Тут важен порядок сравнения , ведь JUnit в итоговом отчете напишет что-то типа “получено значение 1, а ожидалось 3”. Общий формат такой проверки имеет вид:
6.2 Методы assertEquals, assertTrue, assertFalse
Ниже я приведу список самых популярных методов — ассертов. По их названиям вполне можно догадаться как они работают. Но все же напишу краткое пояснение:
| assertEquals | Проверяет, что два объекта равны |
|---|---|
| assertArrayEquals | Проверяет, что два массива содержат равные значения |
| assertNotNull | Проверяет, что аргумент не равен null |
| assertNull | Проверяет, что аргумент равен null |
| assertNotSame | Проверят, что два аргумента — это не один и тот же объект |
| assertSame | Проверят, что два аргумента — это один и тот же объект |
| assertTrue | Проверяет, что аргумент равен true |
| assertFalse | Проверяет, что аргумент равен false |
Некоторые из этих методов кажутся излишними. Зачем использовать assertSame(a, b) , если можно просто написать assertTrue(a == b) ?
Все дело в том, что assert — это очень умный метод. Он делает много чего полезного и, в том числе, пишет в лог информацию об ошибке . В первом случае он напишет, что ожидался объект А, а получен объект Б. Во втором случае просто напишет, что ожидалось true .
Когда у тебя сотни тестов, особенно выполняемые на специальном тестовом сервере, то наличие детальных логов может быть суперполезным. Думаю,ты понимаешь, о чем я.
Пример сравнения массивов:
6.3 Метод assertAll
Как уже говорилось выше, метод assert не просто выполняет проверку, но и пишет в лог много информации о сравнимых объектах.
Допустим выполняется сравнение:
Но если один из параметров не совпадет, то проверки остальных не произойдет. А хотелось бы чтобы они все-таки произошли и их результаты записались в лог. Но при этом, если хотя бы одна проверка не прошла, то тест все-таки был провален.
Для этого есть специальный метод — assertAll() . В качестве первого аргумента он принимает комментарий, который нужно записать в лог, а дальше — любое количество функций-ассертов.
Вот как будет переписан наш пример с его помощью:
Тогда если адрес будет неправильный, в лог будет написано что-то типа:
6.4 Метод assertTimeout
Помнишь аннотацию @Timeout ? Она позволяла контролировать время выполнения всего метода. Но иногда бывает полезно задать ограничения на выполнения некоторой части кода внутри метода. Для этого можно использовать assertTimeout() .
В качестве первого параметра в него передается время, а в качестве второго — код (функция), который должен выполниться за указанное время. Пример:
У класса Assert есть 12 вариантов метода assertTimeout() . Если хочешь ознакомиться с ними подробнее, добро пожаловать в официальную документацию.
6.5 Метод assertThrows
Очень часто бывают ситуации, когда тебе нужно убедиться, что в определенной ситуации код кидает нужное исключение: определил ошибку и кинул нужное исключение. Это очень распространенная ситуация.
На этот случай есть еще один полезный метод assert — это assertThrows() . Общий формат его вызова имеет вид:
По сути, он очень похож на метод assertTimeout() , только он проверяет, чтобы указанный код выкинул нужное исключение. Пример: