eROSE
Reengineering of Software Evolution in Eclipse

eRose is a plugin for Eclipse that guides programmers along related changes. If you change f() and other people have changed f() together with g() in the past, eRose will detect this and suggest "Programmers who changed function f() also changed function g()." All eRose needs is a CVS repository; we designed eRose to be as efficient and unobstrusive as possible.

Install eROSE

1. Start ECLIPSE.
2. Select Help→ Software Updates→ Find and Install...
3. Choose Search for new features to install and select Finish.
4. Select New Remote Site... and enter:
   • Name: Saarland University
   • URL: http://www.st.cs.uni-saarland.de/softevo/erose/update-site/
   Then select OK to add the new update site.
5. Include the update site "Saarland University" in your search and select Next.
6. Choose the feature "eROSE: Reengineering of Software Evolution" and select Next.
7. Read the license and accept the terms (if you agree) and select Next.
8. Choose your ECLIPSE installation and select Finish.
9. The feature is not signed (yet), so likely you will get a warning. Select Install.
10. Restart your ECLIPSE workbench to complete the installation.
11. You should now have two views Changed Entities and Rose (see below) in your Resource or Java perspective. If not, add both views with Window→ Show Views→ Other...→ Rose Views

1. Download eROSE and unpack the zip-file into your ECLIPSE directory.
2. Start ECLIPSE. You should now have two views Changed Entities and Rose in your Resource or Java perspective. If not, add both views with Window→ Show Views→ Other...→ Rose Views.

   

Setup eROSE for a project

1. eROSE needs a database to perform fast mining. This database is created in this step.
   Note that the creation of the database takes a while and cannot be interrupted. We recommend that you use eROSE only for small projects until we have implemented an incremental preprocessing.
2. Select eROSE→ Preprocess project... from the context menu of a project (that is shared with CVS). This opens the preprocessing wizard:

   

3. Choose the "Internal Database" and click on "Finish".
4. Now eROSE analyzes the CVS repository of this project. Click on "Details" for more information about the progress or select "Run in Background".

   

   The preprocessing consists of four steps:

   • Mirror CVS repository into database.
   • Group revisions to transactions.
   • Parse revisions for fine-grained changes (takes most of the time; see screenshot).
   • Setup Rose tables.
5. After the preprocessing has been completed you will be informed with a message box.

   

   In case you have selected "Run in Background", check the progress of eROSE in the Progress view. The "OK" means successful completion.

   

Using eROSE

1. Check that eROSE is enabled. The context menu of a resource should look like this (note that "Turn Rose on" is disabled):

   

2. eROSE mines whenever you change something. You can find its recommendations in the Rose view:

   

   eROSE gives three kinds of recommendations (see the Action column):

   • CHG: Change the Symbol, e.g., the method usage().
   • ADD_IN: Add something in the Symbol, e.g., the file BirdieProcessor.java. For JAVA "add" refers to fields, methods, or import statements.
   • DEL_IN: Delete something in the Symbol, e.g., the file URLUtils.java. For JAVA "delete" refers to fields, methods, or import statements.
   The Support and Confidence columns represent the strength of a single recommendation.
3. To reset the recommendations of eROSE, use the "Clear" button in the Changed Entities view.

   

See also

• Project Software Evolution
• eROSE: Reengineering of Software Evolution in Eclipse
• APFEL: A Preprocessing Framework for Eclipse

Impressum ● Datenschutzerklärung