Moose in action

Moose 9

In this wiki page, we will present couple of analysis examples around a case study. In our case, we take ArgoUML, an open-source Java project.

Load Java Code

The system contains some deprecated classes. A typical question is which of these classes we can remove. Essentially, this boils down to finding the classes annotated with @Deprecated and then selecting those that are not used anywhere (we ignore reflection for this exercise). This is an analysis.

We first need to build a model of our system, and for this we will use VerveineJ:

  • Download and unzip version 2.0.2.
  • Create an ArgoUML-0-34 folder.
  • Download the ArgoUML version 0.34 sources and place them in ArgoUML-0-34/src folder (the name of the src folder can be arbitrary)
  • Download the ArgoUML version 0.34 libraries and place them in ArgoUML-0-34/libs folder (the name of the libs folder can be arbitrary)
  • Go to the ArgoUML-0-34 folder
  • From the command line execute path/to/VerveineJ/verveinej.bat -format json -o ArgoUML-0-34.json -autocp ./libs ./src

You can also download the json file.

The result is that you will get an ArgoUML-0-34/ArgoUML-0-34.json file with the serialized model that can be loaded in Moose. Make sure you have Moose 9.0 or later.

Starting Moose you see a menu with various tools. Open the ‘Models browser’ tool.

Models browser

Click on the JSON button on the top right and load the ArgoUML-0-34.json file. You need to tell Moose what Famix Meta-Model to use for this file. Here you want the Java Meta-Model, hence the FamixJavaModel.

Import famix java model

An extra step is to point the model to the sources folder. To this end, right-click on the ArgoUML-0-34 model, choose Utilities/Set root folder, and point to the ArgoUML-0-34 folder.

Now we are ready to query our system.

Find deprecated classes

We will first look at deprecated classes. Inspect the model with a right-click on the model and Inspect.

Opening query browser

To retrieve the deprecated classes, select the All model classes entry. Then, open the script area and type the following script:

self select: [ :each | each isAnnotatedWith: 'Deprecated' ]

Select the script, and execute it with Ctrl + g

Show deprecated classes

In the right pane, you get the list of the deprecated classes in ArgoUML

Show source code

Just to make sure that we indeed got deprecated classes, let’s investigate one of them and select it to view its source code. Select one entity and open the ‘Source code’ browser (‘Specialized Browsers’ » ‘Famix’ » ‘Source code’).

Opening source code browser

Then, by clicking on the Propagate button of the inspector, you’ll get the source code of the selected class in the ‘Source code’ browser. Note that this depends on Moose knowing where the files reside on your disk, see the above how to point the model to the sources folder.

Propagate to source code browser

Analyze the result

We have 28 classes that are deprecated in the system. Next, we need to check which of those are not used. Or if we think in terms of clients and providers, which of the deprecated classes do not have client classes. Go back to the inspector with the pane listing the 28 classes, open the script area again, and execute the following expression:

self select: [ :each | each clientTypes isEmpty]

We get 14 classes that can be removed immediately.

Requiest empty clientTypes list

To retrive the other classes, execute the following expression:

self select: [ :each | each clientTypes isNotEmpty ]

This gives 14 classes that cannot be removed because they are still being used.

Contributors

This wiki page was first created for the moosebook.