Reusing code is usual in software development, but this practice makes the code less maintainable, besides introducing defects. That’s why we have the Kiuwan Clone detector.
As we write an application and this development extends over time, very similar or identical code fragments begin to appear. These fragments are known as ‘clones’.
The existence of these clones makes the evolution and maintenance of the application more difficult since a single change should be done in different places.
Kiuwan’s clone detector searches for fragments of tokens that are very similar.
The term ‘token’ refers to each of the atomic elements identified by the analyzer. There are three types of tokens:
- Operators and reserved words (specific for each language)
- Identifiers: variable names, function names, etc.
- Literals: numbers and string constants used in the code.
Kiuwan also generates defects of ‘duplicated code’ according to the size of the fragments found:
You can configure the minimum tokens that Kiuwan uses to detect a clone. This is done at two levels:
a) In Kiuwan’s Local Analyzer go to ‘advanced’ options, then configure the number of tokens to detect a clone. This is configured independently for each language , so you can configure a different number for different languages:
b) In your model, configure the minimum tokens to generate a ‘Duplicated code’ defect.
Depending on this configuration, Kiuwan gets different results in the clone detection. Let see these in detail.
The most conservative way
In this case, we configure Kiuwan to look for an exact match between the differents fragments:
Taking this source code as example:
Kiuwan detects duplicate code:
IMPORTANT: The ‘clone’ begins at the close parenthesis of line 5, but Kiuwan prints the complete line. This may be a little messy sometimes.
The detected tokens are:
Set the clone detector to be smarter
Now we are going to configure Kiuwan to ignore the numbers and string constants in our code:
As you can see in the picture above, now the fragment is bigger because the literals (‘3′ and ‘8’) are not taken into account.
And a bit more
As the third option, we can ignore literals and identifiers:
With this last option, the most efficient one, it was clear that class DupCodeTestCopy is really a copy-paste where the class was only renamed, so Kiuwan detects the whole class as a clone.
But this configuration is also the one most prone to false positives. For example:
Both files have a similar structure, but functionally they are very different. Ignoring literals and identifiers, Kiuwan considers both a clone:
Kiuwan Code Analysis allows you to configure the duplicated code detection from a strict way to a more relaxed one. Depending on the maturity level of your application you can choose one or another.
In applications where you initially get a high level of duplicated code, you can configure the analyzer to be stricter and thus focus on those clones easier to detect.
Applications with similar code structures, for example those with graphic interfaces and forms, will generate false positives with an easy-going configuration.