Skip to content
Eric Bodden edited this page Mar 15, 2015 · 1 revision

This page describes how to install and use the TamiFlex plug-in for Eclipse.

Features

The plugi-n allows you to:

  • Start the Play-out Agent and Play-in Agent from within Eclipse
  • Inspect the reflection logs

Installation

To install the plugin, point your eclipse installation to one of the following update sites:

Latest stable release

  • TODO

Current version from Mercurial

Using the Play-out Agent

Let us assume that we have a little Java project with the following setup:

http://wiki.tamiflex.googlecode.com/hg/images/eclipse/1-project.png

Now select Run As - Run Configurations...:

http://wiki.tamiflex.googlecode.com/hg/images/eclipse/2-run-as.png

Next, select Java Application with Play-out Agent. You will find all setting related to the agent in the respective tab:

http://wiki.tamiflex.googlecode.com/hg/images/eclipse/3-run-config.png

For now, we leave the settings unchanged and just hit Run. The Reflection View opens and shows all reflective calls:

http://wiki.tamiflex.googlecode.com/hg/images/eclipse/4-refl-log.png

Clicking on a call item will open the respective code location:

http://wiki.tamiflex.googlecode.com/hg/images/eclipse/5-jump.png

Next, we will show you how to actually dump a reflection log to disk, along with the class files that the program under test loads. First let us create a new folder out:

http://wiki.tamiflex.googlecode.com/hg/images/eclipse/6-new-folder.png

Next we set this folder as output folder in the run configuration:

http://wiki.tamiflex.googlecode.com/hg/images/eclipse/7-out-to-folder.png

After we hit Run again and refresh the out folder, we get the following:

http://wiki.tamiflex.googlecode.com/hg/images/eclipse/8-out-folder.png

Double-clicking the file refl.log will open the log file in the view:

http://wiki.tamiflex.googlecode.com/hg/images/eclipse/9-refl-view.png

To remove the previous log entry from the view, simply right-click the entry and select Remove log from view:

http://wiki.tamiflex.googlecode.com/hg/images/eclipse/10-refl-view.png

Using the Play-in Agent

Using the Play-in Agent is just as simple. Just create a new run configuration and set the class folder out as input folder:

http://wiki.tamiflex.googlecode.com/hg/images/eclipse/12-pia.png

When you hit Run, the agent will show you that it replaced the files:

http://wiki.tamiflex.googlecode.com/hg/images/eclipse/13-pia-console.png