Getting Started With Designite

Code smell is a symptom in the source code that indicates a deeper problem. Martin Fowler defined it as follows:

“a code smell is a surface indication that usually corresponds to a deeper problem in the system”.

Design smells are the logical extension of the code smell concept and defined as follows –

“design smells are certain structures in the design that indicate the violation of fundamental design principles and negatively impact design quality”.

For example, “Insufficient Modularization” (also known as “God Class”) is a frequently occurring design smell that arises either due to a large number of methods in the class or high cumulative complexity (also referred as Weighted Methods per Class (WMC)) of the methods in the class. The presence of this smell indicates that the development team has not applied modularization principle sufficiently and hence the class can be further decomposed.

There are many side-effects when such a smell present in our code; for instance, it is difficult to understand and change a big class. If a change has been introduced without properly understanding the class, then the probability of introducing bugs is increased significantly. At the same time, more time and effort required to make a change in a large and complex class that clearly establishes how poor maintainability leads to poor productivity. It has been documented that the presence of design smells impacts understandability, flexibility, expandability, reusability, testability, and reliability of the software system.

Detecting design smells

Let us understand step by step, how we can identify design smells using Designite for C# projects:

  • Download the trial version of Designite from the tools website and install it on your Windows machine.
  • Now, you don’t require to take any special action to acquire a trial license, since by default Designite comes with a trial license.
  • Start the tool and select a solution file containing the projects that you would like to analyze. The tool will list all the C# projects in the solution; you can include/exclude individual projects for the analysis.
  • Once you click “Analyze”, the tool will analyze the selected projects and present a summary of the analysis. The summary includes a few important metrics such as total lines of code in the selected projects, total classes, namespaces, and methods, total metric violations, detected design smells, density of smells per thousand lines of code, and code duplication percentage.
  • The summary page also shows two graphs viz. metric violations and design smells (classified according to the principle they violate). Additionally, the project specific key metrics could be found on the summary page.

Summary

 

  • In the detailed view on the left-hand side pane, you can see the detected design smells and computed metrics in detail. A sunburst diagram appears when you double click design smells under any of the analyzed projects. The sunburst allows you to navigate and filter the smells based on their violated principle, name, or originating namespace or class.

Smells_smaller

  • You can click on any design smell to see the cause of the smell (in the bottom pane) and corresponding participating entities.
  • If you wish, you can export the list of identified design smells and computed metrics along with code duplication instances to an MS-Excel file. Although, this feature is not enabled in the trial version of the tool.
  • Once you know the existing design smells in your code, you can analyze the reported instances and refactor them to improve the maintainability of your software system.

Additionally, there are many more features that you may try to understand and improve the design quality of your C# application.