jFamix Eclipse Plugin

About

jFamix Eclipse Plugin is a Eclipse plugin which exports the meta information of a Java Project to the FAMIX meta model.
As file format is XMI, a xml based format used.

The files can then be loaded by Moose. And be analyzed with CodeCrawler.

Binary Download

Download page

Prerequisites

• Eclipse 3.0

Installation instructions

1. Shutdown Eclipse
2. Unzip the downloaded zip-file one level higher then the eclipse plugins directory
3. Start Eclipse

Manual

To export a project:

1. Select a java project in the package explorer
2. Click on the Icon
3. A file dialogs opens to ask you where to save your xml file
4. Define your filename and wait until everything is exported. This may take some minutes.

Features

So far (Version 0.7) implemented is:

• Package export
• Class export
• Method export (including parameters, local variables)
• Attribute export
• Inheritance
• Access information (Which method accesses which attribute)
• Invocation information (Which method invokes which other method)
• Metrics:
• WLOC of classes
• LOC of methods
• CYCLO metrics
• NOS of mehtods
• NOP of mehtods
• Note: all the other metrics are computed by Moose (e.g. Number of methods in a class)

Missing features

• CVS information
• Information about source location of the project
• Detecting correct encoding for xml export
• GUI: Setting filters: Possiblity to not export all the information.

Related

• jFamix Library
• FAMIX
• Other tools to export Java to FAMIX

Known problems

• If you are exporting a big project (> 500 classes), it may cause a "Out of memory exception".
  In version 0.6.0 you are only notified "Target Invocation exception".
  Solution
  Give Eclipse more memory. E.g.:
  

            eclipse.exe -vmargs -Xmx256m
            

• If your project contains some non standard characters like Umlaute (ä,ö, ...) it may cause problems load it into Moose.
  Solution
  Adapted the exported xmi file. Change the xml encoding to your encoding. E.g.:
  <?xml version="1.0" encoding="ISO-8859-1"?> insteand of <?xml version="1.0" encoding="UTF-8"?>

Source, JavaDoc, etc

Examples

Here you find some example exports.

• Log4j (exported with version 0.7.0): log4j_xmi_v7.xml.gz
  More info about Log4j: http://logging.apache.org/log4j/docs/
• jEdit (exported with version 0.6.0): jEdit_xmi.xml.gz
• jEdit (exported with version 0.7.0): jEdit_xmi_v7.xml.gz
  More info about jEdit http://www.jedit.org

More stuff ...

You will find more stuff on the Sourceforge Project Site.

Licencse

   
Copyright (c) by 2004 Frank Buchli. All rights reserved.
 
 Licenced under CPL 1.0 (Common Public License Version 1.0).
 The licence is available at http://www.eclipse.org/legal/cpl-v10.html.
 
 
 DISCLAIMER OF WARRANTIES AND LIABILITY:
 
 THE SOFTWARE IS PROVIDED "AS IS".  THE AUTHOR MAKES  NO REPRESENTATIONS OR WARRANTIES,
 EITHER EXPRESS OR IMPLIED.  TO THE EXTENT NOT PROHIBITED BY LAW, IN NO EVENT WILL THE
 AUTHOR  BE LIABLE FOR ANY DAMAGES, INCLUDING WITHOUT LIMITATION, LOST REVENUE,  PROFITS
 OR DATA, OR FOR SPECIAL, INDIRECT, CONSEQUENTIAL, INCIDENTAL  OR PUNITIVE DAMAGES,
 HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF  LIABILITY, ARISING OUT OF OR RELATED TO
 ANY FURNISHING, PRACTICING, MODIFYING OR ANY USE OF THE SOFTWARE, EVEN IF THE AUTHOR
 HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
 

Frank Buchli 22. November 2004