From 1a806eed87b71a92f79750dda7dff6ded32079ba Mon Sep 17 00:00:00 2001 From: Sebastian Bazley Date: Fri, 9 Mar 2007 19:55:18 +0000 Subject: [PATCH] Update Eclipse instructions git-svn-id: https://svn.apache.org/repos/asf/jakarta/jmeter/branches/rel-2-2@516529 13f79535-47bb-0310-9956-ffa450edef68 --- eclipse.readme | 88 ++++++++++------------------------------ extras/eclipse.readme | 17 -------- extras/eclipselaunch.txt | 20 --------- 3 files changed, 22 insertions(+), 103 deletions(-) delete mode 100644 extras/eclipse.readme delete mode 100644 extras/eclipselaunch.txt diff --git a/eclipse.readme b/eclipse.readme index c591c4a0d7..c5a46f6449 100644 --- a/eclipse.readme +++ b/eclipse.readme @@ -10,58 +10,21 @@ for building JMeter using Eclipse version 3. It has exclusion filters for all the source files that depend on optional jars. The optional jars are: -javamail (available from java.sun.com) -Two jars are required for javamail: -mail.jar - http://java.sun.com/products/javamail/downloads/index.html -activation.jar - http://java.sun.com/products/javabeans/glasgow/jaf.html - -beanshell - see http://www.beansehll.org/ - -jms* - needed for the JMS samplers -one implementation is http://activemq.apache.org/ +* beanshell - see http://www.beansehll.org/ The usage of the jars is as follows: -core ----- -org/apache/jmeter/util/keystore/PKCS12KeyStore.java - requires iaik - -components ------------- - -org/apache/jmeter/visualizers/MailerVisualizer.java - requires javamail -org/apache/jmeter/reporters/MailerModel.java - requires javamail -org/apache/jmeter/reporters/MailerResultCollector.java - requires javamail -org/apache/jmeter/assertions/**/BeanShell*.java - requires beanshell - -http ----- -org/apache/jmeter/protocol/http/sampler/WebServiceSampler.java - requires javamail -org/apache/jmeter/protocol/http/control/gui/WebServiceSamplerGui.java - requires javamail - java ---- org/apache/jmeter/protocol/java/**/BeanShell*.java - requires beanshell -org/apache/jmeter/protocol/java/**/BSF*.java - requires bsf -jms ---- -org/apache/jmeter/protocol/jms/** - requires jms - -jndi ----- -org/apache/jmeter/protocol/jndi/** - requires jndi - -mail ----- -org/apache/jmeter/protocol/mail/** - requires javamail Before use, delete or disable the exclusion filters that are not required. Unlike Ant, Eclipse does not support conditional excludes. -Note that Eclipse does not handle RMI compilations, nor is it easy to use for creating -jar files. +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. @@ -71,20 +34,26 @@ The following targets may prove useful: package-only - creates the jars package - compiles everything and then packages it +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 ---------------------- -This launch setup does not read the class files built by Eclipse, but -instead needs the jar file built by Ant. These instructions assume -you checked out the JMeter code as an Eclipse project named "jmeter". +These instructions assume you checked out the JMeter code as an Eclipse project named "jmeter". If you used something else, adjust accordingly. -1. Build the JMeter jar file using ant. Find the build.xml file in -the project, right click on it, and click "Run As --> Ant Build". -When that is done, right click on the bin folder and pick "Refresh". -You should now see the file "ApacheJMeter.jar". - -2. Create a new Java Application launch configuration. +Create a new Java Application launch configuration. On the Main tab, enter the following as the main class: @@ -93,21 +62,8 @@ On the Main tab, enter the following as the main class: 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:jmeter}\bin - -Note: a back slash is appropriate for Windows; Linux needs a forward slash. - -On the Classpath tab, under User Entries, remove the only entry -"jmeter (default classpath)". Click on User Entries, click on the Add -Jars button, then navigate to the file bin/ApacheJMeter.jar you built -in step 1. Pick it, click Ok. - -On the Source tab, click the Add button. In the dialog "Add Source" -that appears, pick the item in the list "Java Project", click OK. In -the dialog "Project Selection" that appears next, put a check next to -the JMeter project, click OK. - -Even though this configuration doesn't allow the instant change-run-test -cycles that are possible in Eclipse, at least this configuration allows -you to set breakpoints on code in the Eclipse java editor etc. + ${workspace_loc:jmeter/bin} +On the Classpath tab,click on User Entries, click on the Add +Jars button, then navigate to the file lib/ext/ApacheJMeter_core.jar +Pick it, click Ok. \ No newline at end of file diff --git a/extras/eclipse.readme b/extras/eclipse.readme deleted file mode 100644 index 4f3dc42e9b..0000000000 --- a/extras/eclipse.readme +++ /dev/null @@ -1,17 +0,0 @@ -Warning: -the sample files described below have only been tested with Eclipse 2.1.2 -They may not work with other versions. - -Eclipsejmeter.launch --------------------- - -This file is a sample launch file for running JMeter under Eclipse - -Copy it to the following directory under the workspace: - -.metadata\.plugins\org.eclipse.debug.core\.launches - -It should then appear in the Run menu. - -You will need to set the JMeter project name before use - -Just use the browse button. \ No newline at end of file diff --git a/extras/eclipselaunch.txt b/extras/eclipselaunch.txt deleted file mode 100644 index 0f33d10399..0000000000 --- a/extras/eclipselaunch.txt +++ /dev/null @@ -1,20 +0,0 @@ - - - - - - - - - - - - - - - - - - -