// $Header: /home/cvs/jakarta-jmeter/src/core/org/apache/jmeter/junit/JMeterTest.java,v 1.63.2.1 2005/08/17 22:35:35 sebb Exp $
/*
* Copyright 2002-2004 The Apache Software Foundation.
*
* Licensed 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.
*
*/
package org.apache.jmeter.junit;
import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.ObjectInputStream;
import java.io.ObjectOutputStream;
import java.io.Serializable;
import java.io.StringReader;
import java.io.StringWriter;
import java.rmi.RemoteException;
import java.util.Collection;
import java.util.HashMap;
import java.util.Iterator;
import java.util.LinkedList;
import java.util.List;
import java.util.Map;
import java.util.Set;
import javax.swing.JComponent;
import junit.framework.Test;
import junit.framework.TestSuite;
import org.apache.jmeter.engine.util.CompoundVariable;
import org.apache.jmeter.functions.Function;
import org.apache.jmeter.gui.GuiPackage;
import org.apache.jmeter.gui.JMeterGUIComponent;
import org.apache.jmeter.gui.UnsharedComponent;
import org.apache.jmeter.gui.action.ActionRouter;
import org.apache.jmeter.gui.tree.JMeterTreeListener;
import org.apache.jmeter.gui.tree.JMeterTreeModel;
import org.apache.jmeter.gui.tree.JMeterTreeNode;
import org.apache.jmeter.save.SaveService;
import org.apache.jmeter.testbeans.TestBean;
import org.apache.jmeter.testbeans.gui.TestBeanGUI;
import org.apache.jmeter.testelement.TestElement;
import org.apache.jmeter.testelement.property.JMeterProperty;
import org.apache.jmeter.testelement.property.PropertyIterator;
import org.apache.jmeter.util.JMeterUtils;
import org.apache.jorphan.logging.LoggingManager;
import org.apache.jorphan.reflect.ClassFinder;
import org.apache.jorphan.util.JOrphanUtils;
import org.apache.log.Logger;
import org.jdom.Document;
import org.jdom.Element;
import org.jdom.input.SAXBuilder;
/**
* @version $Revision: 1.63.2.1 $ Last update $Date: 2005/08/17 22:35:35 $
*/
public class JMeterTest extends JMeterTestCase {
private static Logger log = LoggingManager.getLoggerForClass();
private static Map guiTitles;
private static Map guiTags;
private static Map funcTitles;
public JMeterTest(String name) {
super(name);
}
/*
* The suite() method creates separate test suites for each of the types of
* test. The suitexxx() methods create a list of items to be tested, and
* create a new test instance for each.
*
* Each test type has its own constructor, which saves the item to be tested
*
* Note that the suite() method must be static, and the methods to run the
* tests must be instance methods so that they can pick up the item value
* which was saved by the constructor.
*
*/
// Constructor for TestElement tests
private TestElement testItem;
public JMeterTest(String testName, TestElement te) {
super(testName);// Save the method name
testItem = te;
}
// Constructor for Serializable tests
private Serializable serObj;
public JMeterTest(String testName, Serializable ser) {
super(testName);// Save the method name
serObj = ser;
}
// Constructor for GUI tests
private JMeterGUIComponent guiItem;
public JMeterTest(String testName, JMeterGUIComponent gc) {
super(testName);// Save the method name
guiItem = gc;
}
// Constructor for Function tests
private Function funcItem;
private static boolean classPathShown = false;// Only show classpath once
public JMeterTest(String testName, Function fi) {
super(testName);// Save the method name
funcItem = fi;
}
/*
* Use a suite to allow the tests to be generated at run-time
*/
public static Test suite() throws Exception {
// ensure the GuiPackage is initialized.
JMeterTreeModel treeModel = new JMeterTreeModel();
JMeterTreeListener treeLis = new JMeterTreeListener(treeModel);
treeLis.setActionHandler(ActionRouter.getInstance());
GuiPackage.getInstance(treeLis, treeModel);
try {
// The GuiPackage needs a MainFrame to work:
org.apache.jmeter.gui.MainFrame main = new org.apache.jmeter.gui.MainFrame(ActionRouter.getInstance(),
treeModel, treeLis);
} catch (RuntimeException e) {
System.out.println("Cannot create MainFrame: " + e);
}
TestSuite suite = new TestSuite();
suite.addTest(new JMeterTest("createTitleSet"));
suite.addTest(new JMeterTest("createTagSet"));
suite.addTest(suiteGUIComponents());
suite.addTest(suiteSerializableElements());
suite.addTest(suiteTestElements());
suite.addTest(suiteBeanComponents());
suite.addTest(new JMeterTest("createFunctionSet"));
suite.addTest(suiteFunctions());
suite.addTest(new JMeterTest("checkGuiSet"));
suite.addTest(new JMeterTest("checkFunctionSet"));
return suite;
}
/*
* Extract titles from component_reference.xml
*/
public void createTitleSet() throws Exception {
guiTitles = new HashMap(90);
String compref = "../xdocs/usermanual/component_reference.xml";
SAXBuilder bldr = new SAXBuilder();
Document doc;
doc = bldr.build(compref);
Element root = doc.getRootElement();
Element body = root.getChild("body");
List sections = body.getChildren("section");
for (int i = 0; i < sections.size(); i++) {
List components = ((Element) sections.get(i)).getChildren("component");
for (int j = 0; j < components.size(); j++) {
Element comp = (Element) components.get(j);
String nm=comp.getAttributeValue("name");
if (!nm.equals("SSL Manager")){// Not a true GUI component
guiTitles.put(nm.replace(' ','_'), Boolean.FALSE);
}
}
}
// Add titles that don't need to be documented
//guiTitles.put("Root", Boolean.FALSE);
guiTitles.put("Example Sampler", Boolean.FALSE);
}
/*
* Extract titles from component_reference.xml
*/
public void createTagSet() throws Exception {
guiTags = new HashMap(90);
String compref = "../xdocs/usermanual/component_reference.xml";
SAXBuilder bldr = new SAXBuilder();
Document doc;
doc = bldr.build(compref);
Element root = doc.getRootElement();
Element body = root.getChild("body");
List sections = body.getChildren("section");
for (int i = 0; i < sections.size(); i++) {
List components = ((Element) sections.get(i)).getChildren("component");
for (int j = 0; j < components.size(); j++) {
Element comp = (Element) components.get(j);
guiTags.put(comp.getAttributeValue("tag"), Boolean.FALSE);
}
}
}
/*
* Extract titles from functions.xml
*/
public void createFunctionSet() throws Exception {
funcTitles = new HashMap(20);
String compref = "../xdocs/usermanual/functions.xml";
SAXBuilder bldr = new SAXBuilder();
Document doc;
doc = bldr.build(compref);
Element root = doc.getRootElement();
Element body = root.getChild("body");
Element section = body.getChild("section");
List sections = section.getChildren("subsection");
for (int i = 0; i < sections.size(); i++) {
List components = ((Element) sections.get(i)).getChildren("component");
for (int j = 0; j < components.size(); j++) {
Element comp = (Element) components.get(j);
funcTitles.put(comp.getAttributeValue("name"), Boolean.FALSE);
}
}
}
private int scanprintMap(Map m, String t) {
Set s = m.keySet();
int unseen = 0;
if (s.size() == 0)
return 0;
Iterator i = s.iterator();
while (i.hasNext()) {
Object key = i.next();
if (!m.get(key).equals(Boolean.TRUE)) {
if (unseen == 0)// first time
{
System.out.println("\nNames remaining in " + t + " Map:");
}
unseen++;
System.out.println(key);
}
}
return unseen;
}
public void checkGuiSet() throws Exception {
guiTitles.remove("Example Sampler");// We don't mind if this is left
// over
assertEquals("Should not have any names left over", 0, scanprintMap(guiTitles, "GUI"));
}
public void checkFunctionSet() throws Exception {
assertEquals("Should not have any names left over", 0, scanprintMap(funcTitles, "Function"));
}
/*
* Test GUI elements - create the suite of tests
*/
private static Test suiteGUIComponents() throws Exception {
TestSuite suite = new TestSuite("GuiComponents");
Iterator iter = getObjects(JMeterGUIComponent.class).iterator();
while (iter.hasNext()) {
JMeterGUIComponent item = (JMeterGUIComponent) iter.next();
if (item instanceof JMeterTreeNode) {
System.out.println("INFO: JMeterGUIComponent: skipping all tests " + item.getClass().getName());
continue;
}
TestSuite ts = new TestSuite(item.getClass().getName());
ts.addTest(new JMeterTest("GUIComponents1", item));
if (item instanceof TestBeanGUI) {
System.out.println("INFO: JMeterGUIComponent: skipping some tests " + item.getClass().getName());
} else {
ts.addTest(new JMeterTest("GUIComponents2", item));
ts.addTest(new JMeterTest("runGUITitle", item));
}
suite.addTest(ts);
}
return suite;
}
/*
* Test Functions - create the suite of tests
*/
private static Test suiteFunctions() throws Exception {
TestSuite suite = new TestSuite("Functions");
Iterator iter = getObjects(Function.class).iterator();
while (iter.hasNext()) {
Object item = iter.next();
if (item.getClass().equals(CompoundVariable.class)) {
continue;
}
TestSuite ts = new TestSuite(item.getClass().getName());
ts.addTest(new JMeterTest("runFunction", (Function) item));
ts.addTest(new JMeterTest("runFunction2", (Function) item));
suite.addTest(ts);
}
return suite;
}
/*
* Test GUI elements - create the suite of tests
*/
private static Test suiteBeanComponents() throws Exception {
TestSuite suite = new TestSuite("BeanComponents");
Iterator iter = getObjects(TestBean.class).iterator();
while (iter.hasNext()) {
Class c = iter.next().getClass();
try {
JMeterGUIComponent item = new TestBeanGUI(c);
// JMeterGUIComponent item = (JMeterGUIComponent) iter.next();
TestSuite ts = new TestSuite(item.getClass().getName());
ts.addTest(new JMeterTest("GUIComponents2", item));
ts.addTest(new JMeterTest("runGUITitle", item));
suite.addTest(ts);
} catch (IllegalArgumentException e) {
System.out.println("Cannot create test for " + c.getName() + " " + e);
e.printStackTrace(System.out);
}
}
return suite;
}
/*
* Test GUI elements - run the test
*/
public void runGUITitle() throws Exception {
if (guiTitles.size() > 0) {
String title = guiItem.getDocAnchor();
boolean ct = guiTitles.containsKey(title);
if (ct)
guiTitles.put(title, Boolean.TRUE);// So we can detect extra
// entries
if (// Is this a work in progress or an internal GUI component?
(title != null && title.length() > 0) // Will be "" for internal components
&& (title.toUpperCase().indexOf("(ALPHA") == -1) && (title.toUpperCase().indexOf("(BETA") == -1)
&& (!title.equals("Example1")) // Skip the example samplers
// ...
&& (!title.equals("Example2"))) {// No, not a work in
// progress ...
String s = "component_reference.xml needs '" + title + "' anchor for " + guiItem.getClass().getName();
if (!ct)
log.warn(s); // Record in log as well
assertTrue(s, ct);
}
}
}
/*
* run the function test
*/
public void runFunction() throws Exception {
if (funcTitles.size() > 0) {
String title = funcItem.getReferenceKey();
boolean ct = funcTitles.containsKey(title);
if (ct)
funcTitles.put(title, Boolean.TRUE);// For detecting extra
// entries
if (// Is this a work in progress ?
title.indexOf("(ALPHA") == -1 && title.indexOf("(EXPERIMENTAL") == -1) {// No,
// not
// a
// work
// in
// progress
// ...
String s = "function.xml needs '" + title + "' entry for " + funcItem.getClass().getName();
if (!ct)
log.warn(s); // Record in log as well
assertTrue(s, ct);
}
}
}
/*
* Check that function descriptions are OK
*/
public void runFunction2() throws Exception {
Iterator i = funcItem.getArgumentDesc().iterator();
while (i.hasNext()) {
Object o = i.next();
assertTrue("Description must be a String", o instanceof String);
assertFalse("Description must not start with [refkey", ((String) o).startsWith("[refkey"));
}
}
/*
* Test GUI elements - run the test
*/
public void GUIComponents1() throws Exception {
String name = guiItem.getClass().getName();
assertEquals("Name should be same as static label for " + name, guiItem.getStaticLabel(), guiItem.getName());
if (!name.endsWith("TestBeanGUI")) {
try {
String label = guiItem.getLabelResource();
assertTrue(label.length() > 0);
if (!label.equals("unused")) { // TODO use constant
assertFalse("'" + label + "' should be in resource file for " + name, JMeterUtils.getResString(
label).startsWith(JMeterUtils.RES_KEY_PFX));
}
} catch (UnsupportedOperationException uoe) {
log.warn("Class has not yet implemented getLabelResource " + name);
}
}
}
/*
* Test GUI elements - run the test
*/
public void GUIComponents2() throws Exception {
String name = guiItem.getClass().getName();
// TODO these assertions should be separate tests
TestElement el = guiItem.createTestElement();
assertNotNull(name + ".createTestElement should be non-null ", el);
assertEquals("GUI-CLASS: Failed on " + name, name, el.getPropertyAsString(TestElement.GUI_CLASS));
assertEquals("NAME: Failed on " + name, guiItem.getName(), el.getPropertyAsString(TestElement.NAME));
assertEquals("TEST-CLASS: Failed on " + name, el.getClass().getName(), el
.getPropertyAsString(TestElement.TEST_CLASS));
TestElement el2 = guiItem.createTestElement();
el.setProperty(TestElement.NAME, "hey, new name!:");
el.setProperty("NOT", "Shouldn't be here");
if (!(guiItem instanceof UnsharedComponent)) {
assertEquals("SHARED: Failed on " + name, "", el2.getPropertyAsString("NOT"));
}
log.debug("Saving element: " + el.getClass());
StringWriter writer = new StringWriter();
SaveService.saveElement(el, writer);
el = (TestElement) SaveService.loadElement(new StringReader(writer.toString()));
log.debug("Successfully saved");
guiItem.configure(el);
assertEquals("CONFIGURE-TEST: Failed on " + name, el.getPropertyAsString(TestElement.NAME), guiItem.getName());
guiItem.modifyTestElement(el2);
assertEquals("Modify Test: Failed on " + name, "hey, new name!:", el2.getPropertyAsString(TestElement.NAME));
}
/*
* Test serializable elements - create the suite of tests
*/
private static Test suiteSerializableElements() throws Exception {
TestSuite suite = new TestSuite("SerializableElements");
Iterator iter = getObjects(Serializable.class).iterator();
while (iter.hasNext()) {
Serializable serObj = (Serializable) iter.next();
if (serObj.getClass().getName().endsWith("_Stub")) {
continue;
}
TestSuite ts = new TestSuite(serObj.getClass().getName());
ts.addTest(new JMeterTest("runSerialTest", serObj));
suite.addTest(ts);
}
return suite;
}
/*
* Test serializable elements - test the object
*/
public void runSerialTest() throws Exception {
if (!(serObj instanceof JComponent)) {
try {
ByteArrayOutputStream bytes = new ByteArrayOutputStream();
ObjectOutputStream out = new ObjectOutputStream(bytes);
out.writeObject(serObj);
out.close();
ObjectInputStream in = new ObjectInputStream(new ByteArrayInputStream(bytes.toByteArray()));
Object readObject = in.readObject();
in.close();
assertEquals("deserializing class: " + serObj.getClass().getName(), serObj.getClass(), readObject
.getClass());
} catch (Throwable e) {
fail("serialization of " + serObj.getClass().getName() + " failed: " + e);
}
}
}
/*
* Test TestElements - create the suite
*/
private static Test suiteTestElements() throws Exception {
TestSuite suite = new TestSuite("TestElements");
Iterator iter = getObjects(TestElement.class).iterator();
while (iter.hasNext()) {
TestElement item = (TestElement) iter.next();
TestSuite ts = new TestSuite(item.getClass().getName());
ts.addTest(new JMeterTest("runTestElement", item));
suite.addTest(ts);
}
return suite;
}
/*
* Test TestElements - implement the test case
*/
public void runTestElement() throws Exception {
checkElementCloning(testItem);
assertTrue(testItem.getClass().getName() + " must implement Serializable", testItem instanceof Serializable);
}
private static Collection getObjects(Class extendsClass) throws Exception {
String exName = extendsClass.getName();
Object myThis = "";
Iterator classes = ClassFinder
.findClassesThatExtend(JMeterUtils.getSearchPaths(), new Class[] { extendsClass }).iterator();
List objects = new LinkedList();
String n = "";
boolean caughtError = true;
Throwable caught = null;
try {
while (classes.hasNext()) {
n = (String) classes.next();
// TODO - improve this check
if (n.endsWith("RemoteJMeterEngineImpl")) {
continue; // Don't try to instantiate remote server
}
Class c = null;
try {
c = Class.forName(n);
try {
// Try with a parameter-less constructor first
objects.add(c.newInstance());
} catch (InstantiationException e) {
caught = e;
// System.out.println(e.toString());
try {
// Events often have this constructor
objects.add(c.getConstructor(new Class[] { Object.class }).newInstance(
new Object[] { myThis }));
} catch (NoSuchMethodException f) {
// no luck. Ignore this class
System.out.println("WARN: " + exName + ": NoSuchMethodException " + n);
}
}
} catch (NoClassDefFoundError e) {
// no luck. Ignore this class
System.out.println("WARN: " + exName + ": NoClassDefFoundError " + n);
} catch (IllegalAccessException e) {
caught = e;
System.out.println("WARN: " + exName + ": IllegalAccessException " + n);
// We won't test restricted-access classes.
}
// JDK1.4: catch (java.awt.HeadlessException e)
// JDK1.4: {
// JDK1.4: System.out.println("Error creating "+n+"
// "+e.toString());
// JDK1.4: }
catch (Exception e) {
caught = e;
if ((e instanceof RemoteException) || e.getClass().getName().equals("java.awt.HeadlessException")// for
// JDK1.3
) {
System.out.println("WARN: " + "Error creating " + n + " " + e.toString());
} else {
throw new Exception("Error creating " + n + " " + e.toString());
}
}
}
caughtError = false;
} finally {
if (caughtError) {
System.out.println("Last class=" + n);
System.out.println("objects.size=" + objects.size());
System.out.println("Last error=" + caught);
}
}
if (objects.size() == 0) {
System.out.println("No classes found that extend " + exName + ". Check the following:");
System.out.println("Search paths are:");
String ss[] = JMeterUtils.getSearchPaths();
for (int i = 0; i < ss.length; i++) {
System.out.println(ss[i]);
}
if (!classPathShown) {// Only dump it once
System.out.println("Class path is:");
String cp = System.getProperty("java.class.path");
String cpe[] = JOrphanUtils.split(cp, java.io.File.pathSeparator);
for (int i = 0; i < cpe.length; i++) {
System.out.println(cpe[i]);
}
classPathShown = true;
}
}
return objects;
}
private static void cloneTesting(TestElement item, TestElement clonedItem) {
assertTrue(item != clonedItem);
assertEquals("CLONE-SAME-CLASS: testing " + item.getClass().getName(), item.getClass().getName(), clonedItem
.getClass().getName());
}
private static void checkElementCloning(TestElement item) {
TestElement clonedItem = (TestElement) item.clone();
cloneTesting(item, clonedItem);
PropertyIterator iter2 = item.propertyIterator();
while (iter2.hasNext()) {
JMeterProperty item2 = iter2.next();
// [sebb] assertEquals(item2,
// clonedItem.getProperty(item2.getName()));
assertEquals(item2.getStringValue(), clonedItem.getProperty(item2.getName()).getStringValue());
assertTrue(item2 != clonedItem.getProperty(item2.getName()));
}
}
}