rspec/rules/S5826/java/rule.adoc

78 lines
1.5 KiB
Plaintext
Raw Permalink Normal View History

== Why is this an issue?
2021-04-28 16:49:39 +02:00
The ``++setUp()++`` and ``++tearDown()++`` methods (initially introduced with JUnit3 to execute a block of code before and after each test) need to be correctly annotated with the equivalent annotation in order to preserve the same behavior when migrating from JUnit3 to JUnit4 or JUnit5.
This rule consequently raise issues on ``++setUp()++`` and ``++tearDown()++`` methods which are not annotated in test classes.
=== Noncompliant code example
2021-04-28 16:49:39 +02:00
* JUnit4:
2022-02-04 17:28:24 +01:00
[source,java]
2021-04-28 16:49:39 +02:00
----
public void setUp() { ... } // Noncompliant; should be annotated with @Before
public void tearDown() { ... } // Noncompliant; should be annotated with @After
----
* JUnit5:
2022-02-04 17:28:24 +01:00
[source,java]
2021-04-28 16:49:39 +02:00
----
public void setUp() { ... } // Noncompliant; should be annotated with @BeforeEach
public void tearDown() { ... } // Noncompliant; should be annotated with @AfterEach
----
=== Compliant solution
2021-04-28 16:49:39 +02:00
* JUnit4:
2022-02-04 17:28:24 +01:00
[source,java]
2021-04-28 16:49:39 +02:00
----
@Before
public void setUp() { ... }
@After
public void tearDown() { ... }
----
* JUnit5:
2022-02-04 17:28:24 +01:00
[source,java]
2021-04-28 16:49:39 +02:00
----
@BeforeEach
void setUp() { ... }
@AfterEach
void tearDown() { ... }
----
ifdef::env-github,rspecator-view[]
'''
== Implementation Specification
(visible only on this page)
=== Message
setUp: Annotate this method with @Before/@BeforeEach (JUnit4/JUnit5)
tearDown: Annotated this method with @After/@AfterEach (JUnit4/JUnit5)
=== Highlighting
method name
'''
== Comments And Links
(visible only on this page)
=== relates to: S2391
endif::env-github,rspecator-view[]