/* * Copyright (c) 2011-2015, Intel Corporation * All rights reserved. * * Redistribution and use in source and binary forms, with or without modification, * are permitted provided that the following conditions are met: * * 1. Redistributions of source code must retain the above copyright notice, this * list of conditions and the following disclaimer. * * 2. Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation and/or * other materials provided with the distribution. * * 3. Neither the name of the copyright holder nor the names of its contributors * may be used to endorse or promote products derived from this software without * specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ #include "DomainConfiguration.h" #include "ConfigurableElement.h" #include "CompoundRule.h" #include "Subsystem.h" #include "XmlDomainSerializingContext.h" #include "XmlDomainImportContext.h" #include "XmlDomainExportContext.h" #include "ConfigurationAccessContext.h" #include "AlwaysAssert.hpp" #include #include #include #include #include "RuleParser.h" #define base CElement using std::string; CDomainConfiguration::CDomainConfiguration(const string &strName) : base(strName) { } // Class kind string CDomainConfiguration::getKind() const { return "Configuration"; } // Child dynamic creation bool CDomainConfiguration::childrenAreDynamic() const { return true; } // XML configuration settings parsing bool CDomainConfiguration::parseSettings(CXmlElement &xmlConfigurationSettingsElement, CXmlDomainImportContext &context) { // Parse configurable element's configuration settings CXmlElement::CChildIterator it(xmlConfigurationSettingsElement); CXmlElement xmlConfigurableElementSettingsElement; auto insertLocation = begin(mAreaConfigurationList); while (it.next(xmlConfigurableElementSettingsElement)) { // Retrieve area configuration string configurableElementPath; xmlConfigurableElementSettingsElement.getAttribute("Path", configurableElementPath); auto areaConfiguration = findAreaConfigurationByPath(configurableElementPath); if (areaConfiguration == end(mAreaConfigurationList)) { context.setError("Configurable Element " + configurableElementPath + " referred to by Configuration " + getPath() + " not associated to Domain"); return false; } // Parse if (!importOneConfigurableElementSettings(areaConfiguration->get(), xmlConfigurableElementSettingsElement, context)) { return false; } // Take into account the new configuration order by moving the configuration associated to // the element to the n-th position of the configuration list. // It will result in prepending to the configuration list wit the configuration of all // elements found in XML, keeping the order of the processing of the XML file. mAreaConfigurationList.splice(insertLocation, mAreaConfigurationList, areaConfiguration); // areaConfiguration is still valid, but now refer to the reorderer list insertLocation = std::next(areaConfiguration); } return true; } // XML configuration settings composing void CDomainConfiguration::composeSettings(CXmlElement &xmlConfigurationSettingsElement, CXmlDomainExportContext &context) const { // Go through all are configurations for (auto &areaConfiguration : mAreaConfigurationList) { // Retrieve configurable element const CConfigurableElement *pConfigurableElement = areaConfiguration->getConfigurableElement(); // Create configurable element child element CXmlElement xmlConfigurableElementSettingsElement; xmlConfigurationSettingsElement.createChild(xmlConfigurableElementSettingsElement, "ConfigurableElement"); // Set Path attribute xmlConfigurableElementSettingsElement.setAttribute("Path", pConfigurableElement->getPath()); // Delegate composing to area configuration exportOneConfigurableElementSettings(areaConfiguration.get(), xmlConfigurableElementSettingsElement, context); } } // Serialize one configuration for one configurable element bool CDomainConfiguration::importOneConfigurableElementSettings( CAreaConfiguration *areaConfiguration, CXmlElement &xmlConfigurableElementSettingsElement, CXmlDomainImportContext &context) { const CConfigurableElement *destination = areaConfiguration->getConfigurableElement(); // Check structure if (xmlConfigurableElementSettingsElement.getNbChildElements() != 1) { // Structure error context.setError("Struture error encountered while parsing settings of " + destination->getKind() + " " + destination->getName() + " in Configuration " + getPath()); return false; } // Element content CXmlElement xmlConfigurableElementSettingsElementContent; // Check name and kind if (!xmlConfigurableElementSettingsElement.getChildElement( destination->getXmlElementName(), destination->getName(), xmlConfigurableElementSettingsElementContent)) { // "Component" tag has been renamed to "ParameterBlock", but retro-compatibility shall // be ensured. // // So checking if this case occurs, i.e. element name is "ParameterBlock" // but found xml setting name is "Component". bool compatibilityCase = (destination->getXmlElementName() == "ParameterBlock") && xmlConfigurableElementSettingsElement.getChildElement( "Component", destination->getName(), xmlConfigurableElementSettingsElementContent); // Error if the compatibility case does not occur. if (!compatibilityCase) { context.setError("Couldn't find settings for " + destination->getXmlElementName() + " " + destination->getName() + " for Configuration " + getPath()); return false; } } // Create configuration access context string error; CConfigurationAccessContext configurationAccessContext(error, false); // Have domain configuration parse settings for configurable element bool success = areaConfiguration->serializeXmlSettings( xmlConfigurableElementSettingsElementContent, configurationAccessContext); context.appendToError(error); return success; } bool CDomainConfiguration::exportOneConfigurableElementSettings( CAreaConfiguration *areaConfiguration, CXmlElement &xmlConfigurableElementSettingsElement, CXmlDomainExportContext &context) const { const CConfigurableElement *source = areaConfiguration->getConfigurableElement(); // Create child XML element CXmlElement xmlConfigurableElementSettingsElementContent; xmlConfigurableElementSettingsElement.createChild(xmlConfigurableElementSettingsElementContent, source->getXmlElementName()); // Create configuration access context string error; CConfigurationAccessContext configurationAccessContext(error, true); configurationAccessContext.setValueSpaceRaw(context.valueSpaceIsRaw()); configurationAccessContext.setOutputRawFormat(context.outputRawFormatIsHex()); // Have domain configuration parse settings for configurable element bool success = areaConfiguration->serializeXmlSettings( xmlConfigurableElementSettingsElementContent, configurationAccessContext); context.appendToError(error); return success; } void CDomainConfiguration::addConfigurableElement(const CConfigurableElement *configurableElement, const CSyncerSet *syncerSet) { mAreaConfigurationList.emplace_back(configurableElement->createAreaConfiguration(syncerSet)); } void CDomainConfiguration::removeConfigurableElement( const CConfigurableElement *pConfigurableElement) { auto &areaConfigurationToRemove = getAreaConfiguration(pConfigurableElement); mAreaConfigurationList.remove(areaConfigurationToRemove); } bool CDomainConfiguration::setElementSequence(const std::vector &newElementSequence, string &error) { std::vector elementSequenceSet; auto insertLocation = begin(mAreaConfigurationList); for (const std::string &elementPath : newElementSequence) { auto areaConfiguration = findAreaConfigurationByPath(elementPath); if (areaConfiguration == end(mAreaConfigurationList)) { error = "Element " + elementPath + " not found in domain"; return false; } auto it = find(begin(elementSequenceSet), end(elementSequenceSet), elementPath); if (it != end(elementSequenceSet)) { error = "Element " + elementPath + " provided more than once"; return false; } elementSequenceSet.push_back(elementPath); // Take into account the new configuration order by moving the configuration associated to // the element to the n-th position of the configuration list. // It will result in prepending to the configuration list wit the configuration of all // elements found in XML, keeping the order of the processing of the XML file. mAreaConfigurationList.splice(insertLocation, mAreaConfigurationList, areaConfiguration); // areaConfiguration is still valid, but now refer to the reorderer list insertLocation = std::next(areaConfiguration); } return true; } void CDomainConfiguration::getElementSequence(string &strResult) const { // List configurable element paths out of ordered area configuration list strResult = accumulate(begin(mAreaConfigurationList), end(mAreaConfigurationList), string("\n"), [](const string &a, const AreaConfiguration &conf) { return a + conf->getConfigurableElement()->getPath() + "\n"; }); } // Application rule bool CDomainConfiguration::setApplicationRule( const string &strApplicationRule, const CSelectionCriteriaDefinition *pSelectionCriteriaDefinition, string &strError) { // Parser CRuleParser ruleParser(strApplicationRule, pSelectionCriteriaDefinition); // Attempt to parse it if (!ruleParser.parse(nullptr, strError)) { return false; } // Replace compound rule setRule(ruleParser.grabRootRule()); return true; } void CDomainConfiguration::clearApplicationRule() { // Replace compound rule setRule(nullptr); } string CDomainConfiguration::getApplicationRule() const { const CCompoundRule *pRule = getRule(); return pRule ? pRule->dump() : ""; } /** * Get the Configuration Blackboard. * * Fetch the Configuration Blackboard related to the ConfigurableElement given in parameter. This * Element is used to retrieve the correct AreaConfiguration where the Blackboard is stored. * * @param[in] pConfigurableElement A pointer to a ConfigurableElement that is part of the * Domain. This must have been checked previously, as an * assertion is performed. * * return Pointer to the Blackboard of the Configuration. */ CParameterBlackboard *CDomainConfiguration::getBlackboard( const CConfigurableElement *pConfigurableElement) const { const auto &it = find_if(begin(mAreaConfigurationList), end(mAreaConfigurationList), [&](const AreaConfiguration &conf) { return conf != nullptr && conf->getConfigurableElement() == pConfigurableElement; }); ALWAYS_ASSERT(it != end(mAreaConfigurationList), "Configurable Element " << pConfigurableElement->getName() << " not found in any area Configuration"); return &(*it)->getBlackboard(); } // Save data from current void CDomainConfiguration::save(const CParameterBlackboard *pMainBlackboard) { // Just propagate to areas for (auto &areaConfiguration : mAreaConfigurationList) { areaConfiguration->save(pMainBlackboard); } } // Apply data to current bool CDomainConfiguration::restore(CParameterBlackboard *pMainBlackboard, bool bSync, core::Results *errors) const { return std::accumulate(begin(mAreaConfigurationList), end(mAreaConfigurationList), true, [&](bool accumulator, const AreaConfiguration &conf) { return conf->restore(pMainBlackboard, bSync, errors) && accumulator; }); } // Ensure validity for configurable element area configuration void CDomainConfiguration::validate(const CConfigurableElement *pConfigurableElement, const CParameterBlackboard *pMainBlackboard) { auto &areaConfigurationToValidate = getAreaConfiguration(pConfigurableElement); // Delegate areaConfigurationToValidate->validate(pMainBlackboard); } // Ensure validity of all area configurations void CDomainConfiguration::validate(const CParameterBlackboard *pMainBlackboard) { for (auto &areaConfiguration : mAreaConfigurationList) { areaConfiguration->validate(pMainBlackboard); } } // Return configuration validity for given configurable element bool CDomainConfiguration::isValid(const CConfigurableElement *pConfigurableElement) const { // Get child configurable elemnt's area configuration auto &areaConfiguration = getAreaConfiguration(pConfigurableElement); ALWAYS_ASSERT(areaConfiguration != nullptr, "Configurable Element " << pConfigurableElement->getName() << " not found in any area Configuration"); return areaConfiguration->isValid(); } // Ensure validity of configurable element's area configuration by copying in from a valid one void CDomainConfiguration::validateAgainst(const CDomainConfiguration *pValidDomainConfiguration, const CConfigurableElement *pConfigurableElement) { // Retrieve related area configurations auto &areaConfigurationToValidate = getAreaConfiguration(pConfigurableElement); const auto &areaConfigurationToValidateAgainst = pValidDomainConfiguration->getAreaConfiguration(pConfigurableElement); // Delegate to area areaConfigurationToValidate->validateAgainst(areaConfigurationToValidateAgainst.get()); } void CDomainConfiguration::validateAgainst(const CDomainConfiguration *validDomainConfiguration) { ALWAYS_ASSERT(mAreaConfigurationList.size() == validDomainConfiguration->mAreaConfigurationList.size(), "Cannot validate domain configuration " << getPath() << " since area configuration list does not have the same size" "than the configuration list to check against"); for (const auto &configurationToValidateAgainst : validDomainConfiguration->mAreaConfigurationList) { // Get the area configuration associated to the configurable element of the // valid area configuration, it will assert if none found. auto configurableElement = configurationToValidateAgainst->getConfigurableElement(); auto &configurationToValidate = getAreaConfiguration(configurableElement); // Delegate to area configurationToValidate->validateAgainst(configurationToValidateAgainst.get()); } } // Dynamic data application bool CDomainConfiguration::isApplicable() const { const CCompoundRule *pRule = getRule(); return pRule && pRule->matches(); } // Merge existing configurations to given configurable element ones void CDomainConfiguration::merge(CConfigurableElement *pToConfigurableElement, CConfigurableElement *pFromConfigurableElement) { // Retrieve related area configurations auto &areaConfigurationToMergeTo = getAreaConfiguration(pToConfigurableElement); const auto &areaConfigurationToMergeFrom = getAreaConfiguration(pFromConfigurableElement); // Do the merge areaConfigurationToMergeFrom->copyToOuter(areaConfigurationToMergeTo.get()); } // Domain splitting void CDomainConfiguration::split(CConfigurableElement *pFromConfigurableElement) { // Retrieve related area configuration const auto &areaConfigurationToSplitFrom = getAreaConfiguration(pFromConfigurableElement); // Go through children areas to copy configuration data to them size_t uiNbConfigurableElementChildren = pFromConfigurableElement->getNbChildren(); size_t uiChild; for (uiChild = 0; uiChild < uiNbConfigurableElementChildren; uiChild++) { CConfigurableElement *pToChildConfigurableElement = static_cast(pFromConfigurableElement->getChild(uiChild)); // Get child configurable elemnt's area configuration auto &childAreaConfiguration = getAreaConfiguration(pToChildConfigurableElement); // Do the copy childAreaConfiguration->copyFromOuter(areaConfigurationToSplitFrom.get()); } } const CDomainConfiguration::AreaConfiguration &CDomainConfiguration::getAreaConfiguration( const CConfigurableElement *pConfigurableElement) const { const auto &it = find_if(begin(mAreaConfigurationList), end(mAreaConfigurationList), [&](const AreaConfiguration &conf) { return conf->getConfigurableElement() == pConfigurableElement; }); ALWAYS_ASSERT(it != end(mAreaConfigurationList), "Configurable Element " << pConfigurableElement->getName() << " not found in Domain Configuration list"); return *it; } CDomainConfiguration::AreaConfigurations::iterator CDomainConfiguration:: findAreaConfigurationByPath(const std::string &configurableElementPath) { auto areaConfiguration = find_if(begin(mAreaConfigurationList), end(mAreaConfigurationList), [&](const AreaConfiguration &conf) { return conf->getConfigurableElement()->getPath() == configurableElementPath; }); return areaConfiguration; } // Rule const CCompoundRule *CDomainConfiguration::getRule() const { if (getNbChildren()) { // Rule created return static_cast(getChild(ECompoundRule)); } return nullptr; } CCompoundRule *CDomainConfiguration::getRule() { if (getNbChildren()) { // Rule created return static_cast(getChild(ECompoundRule)); } return nullptr; } void CDomainConfiguration::setRule(CCompoundRule *pRule) { CCompoundRule *pOldRule = getRule(); if (pOldRule) { // Remove previous rule removeChild(pOldRule); delete pOldRule; } // Set new one if (pRule) { // Chain addChild(pRule); } }