eclipse.readme

   Licensed to the Apache Software Foundation (ASF) under one or more
   contributor license agreements.  See the NOTICE file distributed with
   this work for additional information regarding copyright ownership.
   The ASF licenses this file to You under the Apache License, Version 2.0
   (the "License"); you may not use this file except in compliance with
   the License.  You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.



Eclipse settings
----------------
The following files should be excluded from build output:
*.metaprops
See Preferences/Java/Building/Output Folder/Filtered Resources


Eclipse.classpath
-----------------
[This has been tested with Eclipse 3.2. It may not work with other versions.]

The file eclipse.classpath is intended as a starter .classpath file 
for building JMeter using Eclipse version 3.  Make sure to execute
the ant download_jars task to download and install the jars referred
to in the classpath before creating the Eclipse project.  

Note that Eclipse does not handle RMI compilations, 
nor is it easy to use for creating jar files.

However, it is easy to use Eclipse to run Ant.

The following targets may prove useful:

  compile-rmi - compiles the RMI files that Eclipse ignores
  package-only - creates the jars
  package - compiles everything and then packages it
  run_gui - compiles, packages, and then start the JMeter GUI from the jars

Invoking Ant targets inside Eclipse
----------------------------------
You can use the "Run As --> Ant Build" and select target, or you can use
the "Windows->Show View->Ant View". Then select the "build.xml" file and
drag and drop to the "Ant View".
Now you can invoke targets by clicking on them.
Note that if you invoke for example the "compile" target, and get error
messages about 
"
Unable to find a javac compiler;
com.sun.tools.javac.Main is not on the classpath.
Perhaps JAVA_HOME does not point to the JDK
"
it just means that your Eclipse project is set up with JRE libraries instead of JDK libraries.
The suggested fix is to add a JDK in "Window->Preferences->Java->Installed JREs".
Then do a "Project->Properties" and select "Java Build Path" in the left pane, and then
select the "Libraries" tab in the right pane. Scroll to the bottom, select the "JRE System Library",
and click "Remove". Then click "Add library..." , select "JRE System Library", and then select
the JDK. Now it should work when you invoke the "compile" target.


Finishing the build using Ant
-----------------------------

Find the build.xml file in the project, 
right click on it, and click "Run As --> Ant Build".

Make sure you select the "package" target.

This will compile any remaining classes (e.g. the RMI ones),
and then create all the jars.

Now refresh the project (you should add this to the Ant build properties)

Launching from Eclipse
----------------------

You can use the Ant target run_gui to run the JMeter GUI, or you can follow the instructions
below to add a Java Application launch, which will for example, allow you to use the debugger to
run JMeter.

These instructions assume you have configured Eclipse to use the classpath
as suggested in eclipse.classpath, and have run "ant package" to compile
the RMI classes and build the jars.

Create a new Java Application launch configuration.

On the Main tab, enter the following as the main class:

  org.apache.jmeter.NewDriver
  
On the Arguments tab, in the Working Directory area, pick the radio
button next to "Other" and enter the following in the text box:

  ${workspace_loc}/jmeterproject/bin
  
 where "jmeterproject" is the name of the JMeter project.
 
 [It would be nicer to use ${project_loc}/bin 
 but unfortunately the Eclipse Debug view does not seem to preserve any of the project variables]