Source Code Refactoring

From OpenPetra Wiki
Jump to navigation Jump to search

Motivation

A set of cyclic reference errors enforced to run a specific type of source code refactoring. In order to understand this we have a small diagram like this:

Reference-structure.JPG

Here the assembly dependencies are shown i.e. which assemblie use which other assembly. The details of this diagram are not so important at this point. Actually it is more important to understand that there exists a dependecy structure and how to handle it.

Tools to investigate the dependencies

Actually I've used some additional tools

  1. the red gate reflector and
  2. a .NET Reflector Add-Ins named Graph
  3. this addin need the programm Microsoft Glee which now has become a commercial tool named "Microsoft Automatic Graph Layout (MSAGL)". The cost free version is availiable by refering the link and will work well.

Install this tools check out the sources, run "nant generateSolution" and you can load the dlls to investigate the reference structure. On the other side I have the Enterprise Architect and for this program exists an plug in too RizoSuite. But it seems that it needs a higher level of EA.


Detailed Problems

Le us have a look onto the special dependency:

Reference-structure-partner-ui.JPG

Here the Assembly Ict.Petra.Server.lib.MPartner uses the assmbly Ict.Petra.Server.lib.MPartner.ui. You can easily find the reason for this, if you delete the ui-reference in Ict.Petra.Server.lib.MPartner and recompile. Then you are asked to remove a set of "using Ict.Petra.Server.MPartner.Extracts.UIConnectors;" lines and you can recompile again. Then you get a list of errors like "Missing TPartnerEditUIConnector" and then you have to realize that you have to move the code from Ict.Petra.Server.lib.MPartner to Ict.Petra.Server.lib.MPartner.ui. The final goal is to move the connector to the top.

Reference-structure-partner-ui.JPG