//-------------------------------------------------------------------------------------------------//
/// <summary>
/// Parse the XML specification string to check its validity. No exceptions are thrown back to the
/// calling method. If an error occurs, 'accepted' is set to false and the error message is placed
/// in 'errorMessage' where it can be examined by the calling method. Return 'accepted'.
/// </summary>
/// <param name="xmlSpecification"></param>
public virtual ValidationReport Parse(string xmlSpecification)
{
const string STRLOG_MethodName = "Parse";
Logfile.WriteCalled(STRLOG_ClassName, STRLOG_MethodName);
//
// Create a new validation report ready to fill in
//
ValidationReport validationReport = new ValidationReport();
//
// Process the XML specification string
//
try
{
// Load XML specification string
XmlDocument xmlDocument = XmlUtilities.GetXmlDocument(xmlSpecification);
//
// Get a copy of the specification XML node
//
XmlNode xmlNode = XmlUtilities.GetXmlRootNode(xmlDocument, Consts.STRXML_experimentSpecification);
this.xmlNodeSpecification = xmlNode.Clone();
//
// Get the setup id and check that it exists - search is case-sensitive
//
this.setupId = XmlUtilities.GetXmlValue(this.xmlNodeSpecification, Consts.STRXML_setupId, false);
int setupIndex = Array.IndexOf(this.labConfiguration.SetupIds, this.setupId);
if (setupIndex < 0)
{
throw new ArgumentException(STRERR_SetupIdInvalid, this.setupId);
}
//
// Get the specified setup XML node
//
XmlNodeList xmlNodeList = XmlUtilities.GetXmlNodeList(this.xmlNodeConfiguration, Consts.STRXML_setup, true);
this.xmlNodeSetup = xmlNodeList.Item(setupIndex);
//
// Create an instance of the driver for the specified setup and then
// get the driver's execution time for this specification
//
int executionTime = -1;
if (this.SetupId.Equals(Consts.STRXML_SetupId_EquipmentGeneric))
{
if (this.equipmentServiceProxy == null)
{
throw new ArgumentException(STRERR_EquipmentServiceNotAvailable, this.setupId);
}
DriverEquipmentGeneric driver = new DriverEquipmentGeneric(this.equipmentServiceProxy, this.labConfiguration);
executionTime = driver.GetExecutionTime(this);
}
else if (this.SetupId.Equals(Consts.STRXML_SetupId_ModuleGeneric))
{
DriverModuleGeneric driver = new DriverModuleGeneric(this.labConfiguration);
executionTime = driver.GetExecutionTime(this);
}
//
// Specification is valid
//
validationReport.estRuntime = executionTime;
validationReport.accepted = true;
}
catch (Exception ex)
{
validationReport.errorMessage = ex.Message;
}
Logfile.WriteCompleted(STRLOG_ClassName, STRLOG_MethodName);
return validationReport;
}
