ishangsf/rspec
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Modify rule S1871: LaYC format

Browse Source
This commit is contained in:
Fred Tingaud 2023-09-21 14:53:16 +02:00 committed by GitHub
parent 85fd6c60dc
commit 32fcbebbd7
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 52 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

63
rules/S1871/rule.adoc
View File

@ -1,10 +1,8 @@
== Why is this an issue? == Why is this an issue?
include::description.adoc[] Having two `cases` in a `switch` statement or two branches in an `if` chain with the same implementation is at best duplicate code, and at worst a coding error.
=== Noncompliant code example [source,java,diff-id=1,diff-type=noncompliant]
[source,text]
---- ----
switch (i) { switch (i) {
case 1: case 1:
@ -21,7 +19,10 @@ switch (i) {
default: default:
doTheRest(); doTheRest();
} }
----
[source,java,diff-id=2,diff-type=noncompliant]
----
if (a >= 0 && a < 10) { if (a >= 0 && a < 10) {
doFirstThing(); doFirstThing();
doTheThing(); doTheThing();
@ -38,13 +39,49 @@ else {
} }
---- ----
If the same logic is truly needed for both instances, then:
* in an `if` chain they should be combined
[source,java,diff-id=2,diff-type=compliant]
----
if ((a >= 0 && a < 10) || (a >= 20 && a < 50)) { // Compliant
doFirstThing();
doTheThing();
}
else if (a >= 10 && a < 20) {
doTheOtherThing();
}
else {
doTheRest();
}
----
* for a `switch`, one should fall through to the other.
[source,java,diff-id=1,diff-type=compliant]
----
switch (i) {
case 1:
case 3: // Compliant
doFirstThing();
doSomething();
break;
case 2:
doSomethingDifferent();
break;
default:
doTheRest();
}
----
When all blocks are identical, either this rule will trigger if there is no default clause or rule S3923 will raise if there is a default clause.
=== Exceptions === Exceptions
Blocks in an ``++if++`` chain that contain a single line of code are ignored, as are blocks in a ``++switch++`` statement that contain a single line of code with or without a following ``++break++``. Unless all blocks are identical, blocks in an `if` chain that contain a single line of code are ignored. The same applies to blocks in a `switch` statement that contains a single line of code with or without a following `break`.
[source,java]
[source,text]
---- ----
if (a == 1) { if (a == 1) {
doSomething(); //no issue, usually this is done on purpose to increase the readability doSomething(); //no issue, usually this is done on purpose to increase the readability
@ -55,14 +92,8 @@ if (a == 1) {
} }
---- ----
But this exception does not apply to ``++if++`` chains without ``++else++``-s, or to ``++switch++``-es without default clauses when all branches have the same single line of code. In case of ``++if++`` chains with ``++else++``-s, or of ``++switch++``-es with default clauses, rule S3923 raises a bug. == Resources
[source,text] === Related rules
----
if (a == 1) {
doSomething(); //Noncompliant, this might have been done on purpose but probably not
} else if (a == 2) {
doSomething();
}
----
* S3923 - All branches in a conditional structure should not have exactly the same implementation