svn commit: r515868 - /jakarta/jmeter/branches/rel-2-2/eclipse.readme

[se...@apache.org]

Author: sebb
Date: Wed Mar  7 16:48:47 2007
New Revision: 515868

URL: http://svn.apache.org/viewvc?view=rev&rev=515868
Log:
Bug 41781

Modified:
    jakarta/jmeter/branches/rel-2-2/eclipse.readme

Modified: jakarta/jmeter/branches/rel-2-2/eclipse.readme
URL: http://svn.apache.org/viewvc/jakarta/jmeter/branches/rel-2-2/eclipse.readme?view=diff&rev=515868&r1=515867&r2=515868
==============================================================================
--- jakarta/jmeter/branches/rel-2-2/eclipse.readme (original)
+++ jakarta/jmeter/branches/rel-2-2/eclipse.readme Wed Mar  7 16:48:47 2007
@@ -1,8 +1,11 @@
+Warning: The Eclipse.classpath file has been tested with Eclipse 3.2.
+It may not work with other versions.
+
 Eclipse.classpath
 -----------------
 
 The file eclipse.classpath is intended as a starter .classpath file 
-for building JMeter using Eclipse
+for building JMeter using Eclipse version 3.  
 
 It has exclusion filters for all the source files that depend on optional jars.
 
@@ -13,11 +16,47 @@
 activation.jar - http://java.sun.com/products/javabeans/glasgow/jaf.html
 
 beanshell - see http://www.beansehll.org/
-bsf - see http://jakarta.apache.org/bsf/index.html
 
 jms* - needed for the JMS samplers
+one implementation is http://activemq.apache.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
 
-You may need to update the exclusion filters depending on which optional jars are available.
+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.
 
@@ -28,7 +67,47 @@
 
 The following targets may prove useful:
 
-compile-rmi - compiles the RMI files that Eclipse ignores
-package-only - creates the jars
+  compile-rmi - compiles the RMI files that Eclipse ignores
+  package-only - creates the jars
+  package - compiles everything and then packages it
+
+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".
+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.  
+
+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: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.
 
-package - compiles everything and then packages it
\ No newline at end of file



---------------------------------------------------------------------
To unsubscribe, e-mail: jmeter-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: jmeter-dev-help@jakarta.apache.org