stax.java

Software Testing Automation Framework (STAF)的开发代码

            fVersionParser.addOption("VERSION", 1,
                                     STAFCommandParser.VALUENOTALLOWED);
            fVersionParser.addOption("JYTHON", 1,
                                     STAFCommandParser.VALUENOTALLOWED);
            fVersionParser.addOptionGroup("VERSION", 1, 1);
            fVersionParser.addOptionNeed("JYTHON", "VERSION");

            // Help parser

            fHelpParser.addOption("HELP", 1,
                                  STAFCommandParser.VALUENOTALLOWED);
            fHelpParser.addOptionGroup("HELP", 1, 1);

            // Construct map-class for job result information

            fJobResultMapClass = new STAFMapClassDefinition(
                sJobResultMapClassName);

            fJobResultMapClass.addKey("jobID",  "Job ID");
            fJobResultMapClass.addKey("result", "Result");

            // Construct map-class for job details information

            fJobDetailsMapClass = new STAFMapClassDefinition(
                sJobDetailsMapClassName);

            fJobDetailsMapClass.addKey("defaultCall",  "Default Call");
            fJobDetailsMapClass.addKey("functionList", "Functions");

            // Construct map-class for function information

            fFunctionInfoMapClass = new STAFMapClassDefinition(
                sFunctionInfoMapClassName);

            fFunctionInfoMapClass.addKey("functionName",  "Function Name");
            fFunctionInfoMapClass.addKey("prolog",        "Prolog");
            fFunctionInfoMapClass.addKey("epilog",        "Epilog");
            fFunctionInfoMapClass.addKey("argDefinition", "Argument Definition");
            fFunctionInfoMapClass.addKey("argList",       "Arguments");

            // Construct map-class for function information

            fArgInfoMapClass = new STAFMapClassDefinition(sArgInfoMapClassName);

            fArgInfoMapClass.addKey("argName",      "Argument Name");
            fArgInfoMapClass.addKey("description",  "Description");
            fArgInfoMapClass.addKey("type",         "Type");
            fArgInfoMapClass.addKey("defaultValue", "Default Value");
            fArgInfoMapClass.addKey("private",      "Private");
            fArgInfoMapClass.addKey("properties",   "Properties");

            // Construct map-class for function arg property information

            fArgPropertyInfoMapClass = new 
                STAFMapClassDefinition(sArgPropertyInfoMapClassName);

            fArgPropertyInfoMapClass.addKey("propertyName",
                                            "Name");
            fArgPropertyInfoMapClass.addKey("propertyDescription",
                                            "Description");

            fArgPropertyInfoMapClass.addKey("propertyValue",
                                            "Value");

            fArgPropertyInfoMapClass.addKey("propertyData",
                                            "Data");

            // Construct map-class for function arg property information

            fArgPropertyDataInfoMapClass = new 
                STAFMapClassDefinition(sArgPropertyDataInfoMapClassName);

            fArgPropertyDataInfoMapClass.addKey("dataType",
                                                "Type");

            fArgPropertyDataInfoMapClass.addKey("dataValue",
                                                "Value");

            fArgPropertyDataInfoMapClass.addKey("dataData",
                                                "Data");

            // Construct map-class for list jobs information

            fJobInfoMapClass = new STAFMapClassDefinition(
                sJobInfoMapClassName);

            fJobInfoMapClass.addKey("jobID",          "Job ID");
            fJobInfoMapClass.addKey("jobName",        "Job Name");
            fJobInfoMapClass.addKey("startTimestamp", "Start Date-Time");
            fJobInfoMapClass.addKey("function",       "Function");

            // Construct map-class for list job <Job ID> threads information

            fThreadInfoMapClass = new STAFMapClassDefinition(
                sThreadInfoMapClassName);

            fThreadInfoMapClass.addKey("threadID",  "Thread ID");
            fThreadInfoMapClass.addKey("parentTID", "Parent TID");
            fThreadInfoMapClass.addKey("state",     "State");

            // Construct map-class for list settings information

            fSettingsMapClass = new STAFMapClassDefinition(
                sSettingsMapClassName);

            fSettingsMapClass.addKey("eventMachine",   "Event Machine");
            fSettingsMapClass.addKey("eventService",   "Event Service Name");
            fSettingsMapClass.addKey("numThreads",     "Number of Threads");
            fSettingsMapClass.addKey("processTimeout", "Process Timeout");
            fSettingsMapClass.addKey("clearLogs",      "Clear Logs");
            fSettingsMapClass.addKey("logTCElapsedTime",
                                      "Log TC Elapsed Time");
            fSettingsMapClass.addKey("logTCNumStarts", "Log TC Num Starts");
            fSettingsMapClass.addKey("logTCStartStop", "Log TC Start/Stop");
            fSettingsMapClass.addKey("extensions", "Extensions");
            fSettingsMapClass.addKey("extensionFile", "Extension File");

            // Construct map-class for extension element information

            fExtensionElementMapClass = new STAFMapClassDefinition(
                sExtensionElementMapClassName);

            fExtensionElementMapClass.addKey("extensionElement",
                                             "Extension Element");
            fExtensionElementMapClass.addKey("extensionJarFile",
                                             "Extension Jar File");

            // Construct map-class for extension jar file information

            fExtensionJarFileMapClass = new STAFMapClassDefinition(
                sExtensionJarFileMapClassName);

            fExtensionJarFileMapClass.addKey("extensionJarFile",
                                             "Extension Jar File");
            fExtensionJarFileMapClass.addKey("version", "Version");
            fExtensionJarFileMapClass.addKey("description", "Description");

            // Construct map-class for extension information

            fExtensionInfoMapClass = new STAFMapClassDefinition(
                sExtensionInfoMapClassName);

            fExtensionInfoMapClass.addKey("extensionJarFile",
                                          "Extension Jar File");
            fExtensionInfoMapClass.addKey("version", "Version");
            fExtensionInfoMapClass.addKey("description", "Description");
            fExtensionInfoMapClass.addKey("parameterList", "Parameters");
            fExtensionInfoMapClass.addKey("serviceExtensions",
                                          "Service Extensions");
            fExtensionInfoMapClass.addKey("monitorExtensions",
                                          "Monitor Extensions" );

            // Construct map-class for service extension information

            fServiceExtensionMapClass = new STAFMapClassDefinition(
                sServiceExtensionMapClassName);

            fServiceExtensionMapClass.addKey("requiredServiceVersion",
                                             "Service Version Prereq");
            fServiceExtensionMapClass.addKey("includedElementList",
                                             "Included Elements");
            fServiceExtensionMapClass.addKey("excludedElementList",
                                             "Excluded Elements");

            // Construct map-class for monitor extension information

            fMonitorExtensionMapClass = new STAFMapClassDefinition(
                sMonitorExtensionMapClassName);

            fMonitorExtensionMapClass.addKey("requiredMonitorVersion",
                                             "Monitor Version Prereq");
            fMonitorExtensionMapClass.addKey("extensionNameList",
                                             "Extension Names");

            // Construct map-class for query job information

            fQueryJobMapClass = new STAFMapClassDefinition(
                sQueryJobMapClassName);

            fQueryJobMapClass.addKey("jobID", "Job ID");
            fQueryJobMapClass.addKey("jobName", "Job Name");
            fQueryJobMapClass.addKey("startTimestamp", "Start Date-Time");
            fQueryJobMapClass.addKey("xmlFileName", "XML File Name");
            fQueryJobMapClass.addKey("fileMachine", "File Machine");
            fQueryJobMapClass.addKey("function", "Function");
            fQueryJobMapClass.addKey("arguments", "Arguments");
            fQueryJobMapClass.addKey("scriptList", "Scripts");
            fQueryJobMapClass.addKey("scriptFileList", "Script Files");
            fQueryJobMapClass.addKey("scriptMachine", "Script Machine");
            fQueryJobMapClass.addKey("sourceMachine", "Source Machine");
            fQueryJobMapClass.addKey("notifyOnEnd", "Notify OnEnd");
            fQueryJobMapClass.addKey("clearLogs", "Clear Logs");
            fQueryJobMapClass.addKey("logTCElapsedTime",
                                     "Log TC Elapsed Time");
            fQueryJobMapClass.addKey("logTCNumStarts", "Log TC Num Starts");
            fQueryJobMapClass.addKey("logTCStartStop", "Log TC Start/Stop");
            fQueryJobMapClass.addKey("numBlocksRunning", "Blocks Running");
            fQueryJobMapClass.addKey("numBlocksHeld", "Blocks Held");
            fQueryJobMapClass.addKey("numBlocksUnknown", "Blocks Unknown");

            // Construct map-class for query thread information for a job

            fQueryThreadMapClass = new STAFMapClassDefinition(
                sQueryThreadMapClassName);

            fQueryThreadMapClass.addKey("threadID", "Thread ID");
            fQueryThreadMapClass.addKey("parentTID", "Parent TID");
            fQueryThreadMapClass.addKey("startTimestamp", "Start Date-Time");
            fQueryThreadMapClass.addKey("callStack", "Call Stack");
            fQueryThreadMapClass.addKey("conditionStack", "Condition Stack");

            // Construct map-class for listing registered notifiees for
            // job completion for a specified job

            fNotifieeMapClass = new STAFMapClassDefinition(
                sNotifieeMapClassName);

            fNotifieeMapClass.addKey("machine", "Machine");
            fNotifieeMapClass.addKey("handle", "Handle");
            fNotifieeMapClass.setKeyProperty(
                "handle", "display-short-name", "H");
            fNotifieeMapClass.addKey("handleName", "Handle Name");
            fNotifieeMapClass.addKey("notifyBy", "Notify By");
            fNotifieeMapClass.setKeyProperty(
                "notifyBy", "display-short-name", "Notify");
            fNotifieeMapClass.addKey("priority", "Priority");
            fNotifieeMapClass.setKeyProperty(
                "priority", "display-short-name", "P");
            
            // Construct map-class for listing registered notifiees for
            // job completion for all jobs

            fAllNotifieeMapClass = new STAFMapClassDefinition(
                sAllNotifieeMapClassName);

            fAllNotifieeMapClass.addKey("jobID", "Job ID");
            fAllNotifieeMapClass.setKeyProperty(
                "jobID", "display-short-name", "ID");
            fAllNotifieeMapClass.addKey("machine", "Machine");
            fAllNotifieeMapClass.addKey("handle", "Handle");
            fAllNotifieeMapClass.setKeyProperty(
                "handle", "display-short-name", "H");
            fAllNotifieeMapClass.addKey("handleName", "Handle Name");
            fAllNotifieeMapClass.addKey("notifyBy", "Notify By");
            fAllNotifieeMapClass.setKeyProperty(
                "notifyBy", "display-short-name", "Notify");
            fAllNotifieeMapClass.addKey("priority", "Priority");
            fAllNotifieeMapClass.setKeyProperty(
                "priority", "display-short-name", "P");

            // Log the registered extensions in the STAX Service Log

            synchronized (fExtensionsJarList)
            {
                Iterator iter = fExtensionsJarList.iterator();

                StringBuffer result = new StringBuffer(
                    lineSep + "Registered Extensions for " + fServiceName +
                    " Version " + fVersion + ":" + lineSep);

                while (iter.hasNext())
                {
                    STAXExtension ext = (STAXExtension)iter.next();

                    result.append(lineSep + getFormattedExtensionInfo(ext));
                }

                logToServiceLog("info", result.toString());
                System.out.println(result.toString());
            }

            // Create the DTD

            // Get the current date and time
            STAXTimestamp currTimestamp = new STAXTimestamp();

// Begin DTD chunk............................................................
            fDTD =
"<!--\n" +
"   STAf eXecution (STAX) Document Type Definition (DTD)\n" +
"\n" +
"   Generated Date: " + currTimestamp.getTimestampString() + "\n" +
"\n" +
"   This DTD module is identified by the SYSTEM identifier:\n" +
"\n" +
"     SYSTEM 'stax.dtd'\n" +
"\n" +
"-->\n" +
"\n" +
"<!-- Parameter entities referenced in Element declarations -->\n" +
"\n" +
"<!ENTITY % stax-elems 'function | script | signalhandler'>\n" +
"\n";
// End DTD chunk..............................................................

// Begin DTD chunk............................................................
String staxDTDsection =
"\n" +
"<!--================= STAX Job Definition ========================== -->\n" +
"<!--\n" +
"     The root element STAX contains all other elements.  It consists\n" +
"     of an optional defaultcall element and any number of function,\n" +
"     script, and/or signalhandler elements.\n" +
"-->\n" +
"<!ELEMENT stax         ((%stax-elems;)*, defaultcall?, (%stax-elems;)*)>\n" +
"\n" +
"<!--================= The Default Call Function Element ============ -->\n" +
"<!--\n" +
"     The defaultcall element defines the function to call by default\n" +
"     to start the job.  This can be overridden by the 'FUNCTION'\n" +
"     parameter when submitting the job to be executed.\n" +
"     The function attribute's value is a literal.\n" +
"-->\n" +
"<!ELEMENT defaultcall  (#PCDATA)>\n" +
"<!ATTLIST defaultcall\n" +
"          function     IDREF    #REQUIRED\n" +
">\n";
// End DTD chunk..............................................................