jMeter + Eclipse HOWTO

NOTE: As I see, I broke this wiki page :( It refers to images on my updated home page - this images no longer exist. Please refer to the original document (\[http://www.apache.org/~mkostrze/jmeter-eclipse/jmeter-eclipse.html jMeter + Eclipse HOWTO\]

 Michal Kostrzewa (m.kostrzewa@pentacomp.com.pl) 

Special thanks to Janka Kostrzewa for correcting this text.

TODO: Add image URLs, do wiki formatting

Link to original: \[http://home.elka.pw.edu.pl/~mkostrze/jmeter-eclipse/jmeter-eclipse.html jMeter + Eclipse HOWTO\]

Abstract

This document describes briefly how to develop the jMeter project with Eclipse IDE. Eclipse is a very powerful development environment with following features:

• It's fast! Although it's written in JAVA like many other development platforms, it doesn't use SWING, which is big and slow; it uses an especially created SWT widget toolkit instead. This tookit doesn't emulate widgets in java, but it uses native system widgets (GTK on linux), which improves performance substantially.
• Very functional editor/package browser with syntax highlighting and syntax hints.
• Compiles java classes on the fly (when waiting for user input or saving a file), so one doesn't have to wait when launching an application. Furthermore, one sees errors immediately.
• Very nice debugger.
• Powerful code refactoring: when you want to change the name of a method or change parameters, don't hesitate to do it. *Eclipse intelligently changes appropriate things regarding to java syntax (you won't get this result using simple search/replace).
• JavaDoc integration.
• CVS integration.
• Can automatically create getter and setter methods.
• CPL licence (OSI approved).
• Last but not least: search with regard to java syntax. You can just mark an identificator and click "open super implementation" or "find any reference to.." or "find declaration of...". It helps very much when exploring the internals of an unknown application.
• Many (many) more...
  

Eclipse is available for download for different platforms at http://www.eclipse.org

Setting up jMeter + Eclipse

I assume you downloaded Eclipse IDE and have it working.

Accessing CVS

• 1. Open the CVS perspective with http://home.elka.pw.edu.pl/~mkostrze/jmeter-eclipse/images/icons/perspective.png and http://home.elka.pw.edu.pl/~mkostrze/jmeter-eclipse/images/icons/cvs.png buttons
• 2. Invoke the popup menu and select "New"/"repository location"
• 3. Fill appropriate entries as pictured below, entering "anoncvs" as a password:
  

http://home.elka.pw.edu.pl/~mkostrze/jmeter-eclipse/images/screen/newcvs.png

• 4. You should see the Apache CVS tree as pictured below. Unfold HEAD, select jakarta-jmeter and then select "Check Out as ..." from the pop-up menu
• 5. Select "JAVA project", and give a name for the project in next dialogs.
• 6. Wait for the CVS checkout to complete.
  

Setting up paths

Open "Java browser perspective" with and buttons Find your project and create a folder named lib/ext (lib already exists) Find your project root element, invoke the pop-up menu and select project properties Select "JAVA build path" side tree element Select "Source" tab Click "Add Existing Folders" and select as follows

  }}}
Enter "Build output folder" as project-name/lib/ext 
NOTE: this path is important, don't change it to any other directory 
The source tab should look like this:
{{{  

Select "Libraries" tab Select "Add jars" Select following jars:

  }}}
Click "OK" and wait for the entire source tree to compile

=== Running and debugging jMeter ===

Find the NewDrive class on "Java browser perspective"
{{{  

Select "Run"/"Run ..." from the menu Select "Java application" from the side tree and click "New". JMeter running configuration will be added Important: Select "Arguments" tab, uncheck "Use default working directory" and correct working directory field to project-name/bin Click "Run" From this time you can run and debug jMeter simply by pressing and buttons

Comments

Please send your comments concerning eclipse+jMeter as well as grammar/spelling issues either to jmeter mailing list or to me (m.kostrzewa@pentacomp.com.pl).