Calder Mobile
February 13, 2014 Code Quality 0 Comments

How to know when code is complex

“Any darn fool can make something complex; it takes a genius to make something simple.” This quote has been attributed to different people, from Albert Einstein to Pete Seeger. Whatever the origin, I think it really applies to code. When given a task to accomplish developers should all be able to code something that will work. But how will it be understood and maintained in the future?  How can you objectively measure something as complex… as complexity?

In my past posts I discussed better ways to assess a program’s complexity than counting lines of code.  There are good metrics like the Halstead Metrics that help you in comparing programs on a high level, but they really don’t get to the inside the program. In other words, you can’t see that one part of the program is more complex than another. For that we have to go down a level into the program — to the paragraphs, Procedures or Perform Groups.

Two programs could have the exact same number of lines, operators, and operands, yet be totally different to maintain. Why? It has to do with how they are coded, what they are doing and how the developer chose to implement the logic.  The core of complexity is made up of decisions. Think about your own life. Decisions can be difficult, but if they’re made one at a time then they aren’t so bad. But what if they are linked — if a decision leads down one path, which calls for other decisions, which lead to other decisions, and so on and so forth? The overall complexity of the situation grows, and so does the importance of making the right decision at each point. This is the problem we face in code and therefore we need ways to manage the resulting complexity.

One way to manage this would be to just code all of these decisions into one area, be it paragraph, Procedure or module. Grouping them together is easy and it’s the way things are often done. But if you group decisions together, understanding the logic becomes very difficult because you will have to comb through a large section of code to get to the area in question.

[fusion_builder_container hundred_percent=”yes” overflow=”visible”][fusion_builder_row][fusion_builder_column type=”1_1″ background_position=”left top” background_color=”” border_size=”” border_color=”” border_style=”solid” spacing=”yes” background_image=”” background_repeat=”no-repeat” padding=”” margin_top=”0px” margin_bottom=”0px” class=”” id=”” animation_type=”” animation_speed=”0.3″ animation_direction=”left” hide_on_mobile=”no” center_content=”no” min_height=”none”] prof_showman: Approach decisions with balance in mind. This of a Calder Mobile.

It would be easier if you instead attempted to isolate important pieces of logic into separate areas. So, for example, after a main decision, you would branch to different areas and continue this process. Each section should be similar in size and provide balance. Think of it like a Calder Mobile.  At each point there is a split with others balancing below it. But if any part gets too large, the balance is gone. This process should make it easier — assuming you have good naming and comments — to quickly locate areas you need to examine. You will have far fewer decisions to understand within those areas.

So, it’s better to break down the decisions into the smallest blocks possible and isolate them. In the end you still have the same number of decisions, but maintenance is far easier. But how to judge the size of these blocks? I’ll introduce a helpful Metric in my next post.[/fusion_builder_column][/fusion_builder_row][/fusion_builder_container]

The following two tabs change content below.

Mark Schettenhelm

Mark Schettenhelm, Product Manager for Compuware’s ISPW product, has more than 30 years of experience in the IT industry. Mark’s background is in Testing and Application Portfolio Analysis with his current focus being in Source Code Management. Mark has received the Certification of Information Privacy Professional (CIPP/US) from the International Association of Privacy Professionals, (IAPP). He has been interviewed in numerous publications including ZDNet UK, Application Development Trends and Storage Magazine, and has a regular column in Enterprise Tech Journal. In his 25 years with Compuware, Mark has been instrumental in helping to bring the Compuware mainframe solutions to the forefront of the industry. Mark’s efforts on matching customer needs and expectations with the functionality of various software and solutions have been extremely successful in helping the Company chart a path for the enterprise segment of the IT industry. Before joining Compuware Mark was a software developer in the health care industry. Mark is a native of Michigan and graduated from Northern Michigan University with a B.S. in History.
Share: