private static PluginCollection loadPlugins(RunTimeData anRtData) {
Trace.println(Trace.UTIL, "loadPlugins( runTimeData )", true);
File tmpPluginDirectory = anRtData.getValueAsFile(Testium.PLUGINSDIR);
File pluginDir;
if (tmpPluginDirectory == null) {
File baseDir = anRtData.getValueAsFile(Testium.BASEDIR);
if (baseDir == null) {
throw new Error(Testium.BASEDIR + " is not set in RunTimeData");
}
pluginDir = new File(baseDir, "plugins");
} else {
String tmpPluginDirPath = anRtData.substituteVars(tmpPluginDirectory.getPath());
pluginDir = new File(tmpPluginDirPath);
}
RunTimeVariable pluginDirVar = new RunTimeVariable(Testium.PLUGINSDIR, pluginDir);
anRtData.add(pluginDirVar);
if (!pluginDir.isDirectory()) {
throw new Error("Plugin Directory is not found: " + pluginDir.getAbsolutePath());
}
PluginCollection plugins;
try {
plugins = PluginClassLoader.loadPlugins(pluginDir, anRtData);
} catch (ConfigurationException e) {
Trace.print(Trace.UTIL, e);
throw new Error("Failed to load plugins: " + e.getMessage(), e);
}
return plugins;
}
/** @param args */
public static void main(String[] args) {
Trace.getInstance().addBaseClass("org.testium");
Trace.getInstance().addBaseClass("org.testtoolinterfaces");
RunTimeData rtData = new RunTimeData();
defineBaseDir(rtData);
defineUserHome(rtData);
defineStartTime(rtData);
parseCommandLine(rtData, args);
readGlobalConfigFile(rtData);
readPersonalConfigFile(rtData);
PluginCollection plugins = loadPlugins(rtData);
Testium testium = createTestium(rtData, plugins);
String command = rtData.getValueAsString(Testium.COMMAND);
if (command.equalsIgnoreCase(CmdLineParser.VALIDATE)) {
doValidation(testium, rtData);
} else if (command.equalsIgnoreCase(CmdLineParser.EXECUTE)) {
doExecution(testium, rtData);
} else if (command.equalsIgnoreCase(CmdLineParser.PREPARE)) {
doPreparations(testium, rtData);
} else if (command.equalsIgnoreCase(CmdLineParser.INTERFACES)) {
showInterfaces(plugins);
} else if (command.equalsIgnoreCase(CmdLineParser.KEYWORDS)) {
showKeywords(plugins);
} else {
throw new Error("Unknown Command: " + command);
}
System.out.flush();
System.err.flush();
// Find the root thread group
ThreadGroup root = Thread.currentThread().getThreadGroup().getParent();
System.out.println("We start with threadgroup: " + root.getName());
while (root.getParent() != null) {
root = root.getParent();
System.out.println("Up one to: " + root.getName());
}
visit(root, 0);
System.runFinalization();
try {
Thread.sleep(30000);
} catch (InterruptedException e) {
// none, just exit;
}
System.exit(0); // Some plugins can have hanging threads. This will stop them.
}
/** @param rtData */
private static void defineUserHome(RunTimeData anRtData) {
Trace.println(Trace.UTIL, "defineUserHome( runTimeData )", true);
File userHome = new File(System.getProperty("user.home"));
RunTimeVariable userHomeVar = new RunTimeVariable(Testium.USERHOME, userHome);
anRtData.add(userHomeVar);
}
/** @param rtData */
private static void defineStartTime(RunTimeData anRtData) {
Trace.println(Trace.UTIL, "defineStartTime( runTimeData )", true);
Date now = new Date();
RunTimeVariable startTimeVar = new RunTimeVariable(Testium.START, now);
anRtData.add(startTimeVar);
SimpleDateFormat dateFormatter = new SimpleDateFormat("yyyyMMdd");
RunTimeVariable startDateFormattedVar =
new RunTimeVariable(Testium.STARTDATE, dateFormatter.format(now));
anRtData.add(startDateFormattedVar);
SimpleDateFormat timeFormatter = new SimpleDateFormat("HHmmss");
RunTimeVariable startTimeFormattedVar =
new RunTimeVariable(Testium.STARTTIME, timeFormatter.format(now));
anRtData.add(startTimeFormattedVar);
}
private static void readGlobalConfigFile(RunTimeData anRtData) {
Trace.println(Trace.UTIL, "readConfigFile( runTimeData )", true);
File globalConfigFile = anRtData.getValueAsFile(Testium.GLOBALCONFIGFILE);
if (globalConfigFile == null) {
File configDir = anRtData.getValueAsFile(Testium.CONFIGDIR);
if (configDir == null) {
throw new Error(Testium.CONFIGDIR + " is not defined in RunTimeData");
}
globalConfigFile = new File(configDir, "global.xml");
RunTimeVariable globalConfigDirVar =
new RunTimeVariable(Testium.GLOBALCONFIGFILE, globalConfigFile);
anRtData.add(globalConfigDirVar);
}
// Default projectdir is {basedir}/suite
File baseDir = anRtData.getValueAsFile(Testium.BASEDIR);
File projectDir = new File(baseDir, "suite");
RunTimeVariable rtVarProjectDir = new RunTimeVariable(Testium.PROJECTDIR, projectDir);
anRtData.add(rtVarProjectDir);
// create a parser
SAXParserFactory spf = SAXParserFactory.newInstance();
spf.setNamespaceAware(false);
try {
SAXParser saxParser = spf.newSAXParser();
XMLReader xmlReader = saxParser.getXMLReader();
// create a handler
GlobalConfigurationXmlHandler handler =
new GlobalConfigurationXmlHandler(xmlReader, anRtData);
// assign the handler to the parser
xmlReader.setContentHandler(handler);
// parse the document
xmlReader.parse(globalConfigFile.getAbsolutePath());
} catch (Exception e) {
Trace.print(Trace.UTIL, e);
throw new Error(APPLICATIONNAME + " is not correctly setup.", e);
}
}
/**
* @param rtData
* @param testium
* @param tgFile
* @param testGroup
* @throws Error
*/
private static void doPreparations(Testium aTestium, RunTimeData anRtData) throws Error {
Trace.println(Trace.EXEC, "doPreparations( Testium, runTimeData )", true);
TestGroup testGroup = readTestGroup(aTestium, anRtData);
File testSuiteDir = anRtData.getValueAs(File.class, Testium.PROJECTDIR);
String groupId = anRtData.getValueAs(String.class, Testium.TESTGROUP);
String caseId = anRtData.getValueAs(String.class, Testium.TESTCASE);
if (groupId == null && caseId == null) {
throw new Error("Preparation failed: Must specify a testgroup or testcase to prepare for.");
}
try {
aTestium.prepare(testGroup, testSuiteDir, anRtData);
} catch (TestExecutionException e) {
Trace.print(Trace.EXEC, e);
throw new Error("Preparation failed.", e);
}
}
/**
* @param testium
* @param tgFile
* @return
* @throws Error
*/
private static TestGroup readTestGroup(Testium testium, RunTimeData anRtData) throws Error {
Trace.println(Trace.UTIL, "readTestGroup( Testium, runTimeData )", true);
File tgFile = anRtData.getValueAsFile(Testium.TESTFILE);
TestGroup testGroup;
try {
testGroup = testium.readTestGroup(tgFile);
} catch (IOError e) {
Trace.print(Trace.UTIL, e);
throw new Error("TestGroup could not be read: " + tgFile.getPath(), e);
}
return testGroup;
}
/**
* @param args
* @return
*/
private static void parseCommandLine(RunTimeData anRtData, String[] args) {
Trace.println(Trace.UTIL, "parseCommandLine( runTimeData, args )", true);
CmdLineParser cmdLine = new CmdLineExecutionParser(APPLICATIONNAME);
cmdLine.setDefaultCommand("execute");
cmdLine.acceptFlag(Testium.VERSION, "Displays the versions of Testium and the plugins");
try {
cmdLine.parse(anRtData, args);
} catch (ParameterException pe) {
Trace.print(Trace.UTIL, pe);
cmdLine.printHelpOn(System.out);
throw new Error("Error on command line.", pe);
}
if (anRtData.getValueAsBoolean(Testium.HELP)) {
cmdLine.printHelpOn(System.out);
System.exit(0);
}
if (anRtData.getValueAsBoolean(Testium.VERSION)) {
System.out.println("The version of Testium");
Package[] packages = Package.getPackages();
for (Package pkg : packages) {
String pkgName = pkg.getName();
if (!pkgName.startsWith("java")
&& !pkgName.startsWith("sun")
&& !pkgName.startsWith("joptsimple")
&& !pkgName.startsWith("org.xml")) {
System.out.println(pkgName + ":\t" + pkg.getImplementationVersion());
}
}
System.exit(0);
}
}
@Override
protected void doExecute(
RunTimeData aVariables, ParameterArrayList parameters, TestStepCommandResult result)
throws Exception {
@SuppressWarnings("unchecked")
List<Object> list = (List<Object>) obtainValue(aVariables, parameters, PARSPEC_LIST);
String varName = (String) obtainValue(aVariables, parameters, PARSPEC_VARIABLE);
int size = list.size();
RunTimeVariable rtVariable = new RunTimeVariable(varName, size);
aVariables.add(rtVariable);
result.setDisplayName(this.toString() + " " + varName + " = " + size);
}
/**
* @param testium
* @param rtData
* @throws Error
*/
private static void doExecution(Testium aTestium, RunTimeData anRtData) throws Error {
Trace.println(Trace.EXEC, "doExecution( Testium, runTimeData )", true);
TestGroup testGroup = readTestGroup(aTestium, anRtData);
File testSuiteDir = anRtData.getValueAsFile(Testium.PROJECTDIR);
if (testSuiteDir == null) {
throw new Error("Test Suite Directory is not defined");
}
if (!testSuiteDir.isDirectory()) {
throw new Error("Test Suite Directory is not found: " + testSuiteDir.getPath());
}
try {
aTestium.execute(testGroup, testSuiteDir, anRtData);
} catch (TestExecutionException e) {
Trace.print(Trace.EXEC, e);
throw new Error("Execution failed.", e);
}
}
/** @param rtData */
private static void defineBaseDir(RunTimeData anRtData) {
Trace.println(Trace.UTIL, "defineBaseDir( runTimeData )", true);
File applicationBaseDir = new File("");
try {
File jarFile =
new File(
org.testium.Main.class.getProtectionDomain().getCodeSource().getLocation().toURI());
applicationBaseDir =
jarFile
.getParentFile()
.getParentFile(); // Assuming testium is in {basedir}/src/Testium.jar
} catch (URISyntaxException exc) {
Trace.print(Trace.UTIL, exc);
throw new Error("Cannot determine " + APPLICATIONNAME + "'s basedir: ", exc);
}
RunTimeVariable applBaseDirVar = new RunTimeVariable(Testium.BASEDIR, applicationBaseDir);
anRtData.add(applBaseDirVar);
}
private static void readPersonalConfigFile(RunTimeData anRtData) {
Trace.println(Trace.UTIL, "readPersonalConfigFile( runTimeData )", true);
File configFile = anRtData.getValueAsFile(Testium.CONFIGFILE);
if (configFile == null) {
File userHome = anRtData.getValueAsFile(Testium.USERHOME);
if (userHome == null) {
throw new Error(Testium.USERHOME + " is not defined in RunTimeData");
}
File userConfigDir = anRtData.getValueAsFile(Testium.USERCONFIGDIR);
if (userConfigDir == null) {
userConfigDir = new File(userHome, "." + APPLICATIONNAME.toLowerCase(Locale.ENGLISH));
}
RunTimeVariable userConfigDirVar = new RunTimeVariable(Testium.USERCONFIGDIR, userConfigDir);
anRtData.add(userConfigDirVar);
File defaultConfigFile = anRtData.getValueAsFile(Testium.DEFAULTCONFIGFILE);
if (defaultConfigFile == null) {
configFile = new File(userConfigDir, "general.xml");
} else {
if (!defaultConfigFile.isAbsolute()) {
configFile = new File(userConfigDir, defaultConfigFile.getPath());
if (!configFile.exists()) {
configFile = new File(userHome, defaultConfigFile.getPath());
}
} else {
configFile = defaultConfigFile;
}
}
RunTimeVariable configFileVar = new RunTimeVariable(Testium.CONFIGFILE, configFile);
anRtData.add(configFileVar);
} else {
File userConfigDir = configFile.getParentFile();
RunTimeVariable userConfigDirVar = new RunTimeVariable(Testium.USERCONFIGDIR, userConfigDir);
anRtData.add(userConfigDirVar);
}
// create a parser
SAXParserFactory spf = SAXParserFactory.newInstance();
spf.setNamespaceAware(false);
try {
SAXParser saxParser = spf.newSAXParser();
XMLReader xmlReader = saxParser.getXMLReader();
// create a handler
PersonalConfigurationXmlHandler handler =
new PersonalConfigurationXmlHandler(xmlReader, anRtData);
// assign the handler to the parser
xmlReader.setContentHandler(handler);
// parse the document
xmlReader.parse(configFile.getAbsolutePath());
} catch (FileNotFoundException fnfe) {
Trace.print(Trace.UTIL, fnfe);
} catch (Exception e) {
Trace.print(Trace.UTIL, e);
throw new Error(APPLICATIONNAME + " could not be configured.", e);
}
}