src/Config/Config_FeatureReader.cpp

   1 // Copyright (C) 2014-2017  CEA/DEN, EDF R&D
   2 //
   3 // This library is free software; you can redistribute it and/or
   4 // modify it under the terms of the GNU Lesser General Public
   5 // License as published by the Free Software Foundation; either
   6 // version 2.1 of the License, or (at your option) any later version.
   7 //
   8 // This library is distributed in the hope that it will be useful,
   9 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  10 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  11 // Lesser General Public License for more details.
  12 //
  13 // You should have received a copy of the GNU Lesser General Public
  14 // License along with this library; if not, write to the Free Software
  15 // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  16 //
  17 // See http://www.salome-platform.org/ or
  18 // email : webmaster.salome@opencascade.com<mailto:webmaster.salome@opencascade.com>
  19 //
  20
  21 #include <Config_Keywords.h>
  22 #include <Config_Common.h>
  23 #include <Config_FeatureMessage.h>
  24 #include <Config_AttributeMessage.h>
  25 #include <Config_FeatureReader.h>
  26 #include <Config_Translator.h>
  27 #include <Events_Message.h>
  28 #include <Events_Loop.h>
  29
  30 #include <libxml/parser.h>
  31 #include <libxml/tree.h>
  32 #include <libxml/xmlstring.h>
  33
  34 #include <string>
  35 #include <algorithm>
  36 #include <list>
  37
  38 #ifdef _DEBUG
  39 #include <iostream>
  40 #endif
  41
  42 Config_FeatureReader::Config_FeatureReader(const std::string& theXmlFile,
  43                                            const std::string& theLibraryName,
  44                                            const char* theEventGenerated)
  45     : Config_XMLReader(theXmlFile),
  46       myLibraryName(theLibraryName),
  47       myEventGenerated(theEventGenerated ? theEventGenerated : Config_FeatureMessage::GUI_EVENT()),
  48       myIsProcessWidgets(theEventGenerated != NULL)
  49 {
  50 }
  51
  52 Config_FeatureReader::~Config_FeatureReader()
  53 {
  54 }
  55
  56 std::list<std::string> Config_FeatureReader::features() const
  57 {
  58   return myFeatures;
  59 }
  60
  61 void Config_FeatureReader::processNode(xmlNodePtr theNode)
  62 {
  63   Events_ID aMenuItemEvent = Events_Loop::eventByName(myEventGenerated);
  64   if (isNode(theNode, NODE_FEATURE, NULL)) {
  65     storeAttribute(theNode, _ID);
  66     std::shared_ptr<Config_FeatureMessage>
  67       aMessage(new Config_FeatureMessage(aMenuItemEvent, this));
  68     fillFeature(theNode, aMessage);
  69     myFeatures.push_back(getProperty(theNode, _ID));
  70     //If a feature has xml definition for it's widget:
  71     aMessage->setUseInput(hasChild(theNode));
  72     Events_Loop::loop()->send(aMessage);
  73     //The m_last* variables always defined before fillFeature() call. XML is a tree.
  74   } else if (isNode(theNode, NODE_WORKBENCH, NODE_GROUP, NULL)) {
  75     storeAttribute(theNode, _ID);
  76     storeAttribute(theNode, WORKBENCH_DOC, true);
  77   } else if (myIsProcessWidgets) {
  78     // widgets, like shape_selector or containers, like toolbox
  79     if (isAttributeNode(theNode)) {
  80       std::shared_ptr<Config_AttributeMessage>
  81         aMessage(new Config_AttributeMessage(aMenuItemEvent, this));
  82       aMessage->setFeatureId(restoreAttribute(NODE_FEATURE, _ID));
  83       std::string anAttributeID = getProperty(theNode, _ID);
  84       if (!anAttributeID.empty()) {
  85         aMessage->setAttributeId(anAttributeID);
  86         aMessage->setObligatory(getBooleanAttribute(theNode, ATTR_OBLIGATORY, true));
  87         bool isConcealment = getBooleanAttribute(theNode, ATTR_CONCEALMENT, false);
  88         aMessage->setConcealment(isConcealment);
  89         bool isMainArg = isConcealment && getBooleanAttribute(theNode, ATTR_MAIN_ARG, false);
  90         aMessage->setMainArgument(isMainArg);
  91
  92         std::list<std::pair<std::string, std::string> > aCases;
  93         xmlNodePtr aCaseNode =
  94           hasParentRecursive(theNode, WDG_SWITCH_CASE, WDG_TOOLBOX_BOX, WDG_OPTIONALBOX, NULL);
  95         while(aCaseNode) {
  96           std::string aCaseNodeID = getProperty(aCaseNode, _ID);
  97           std::string aSwitchNodeID = "";
  98           const xmlChar* aName = aCaseNode->name;
  99           xmlNodePtr aSwitchNode;
 100           if (!xmlStrcmp(aName, (const xmlChar *) WDG_SWITCH_CASE)) {
 101             aSwitchNode = hasParentRecursive(aCaseNode, WDG_SWITCH, NULL);
 102           }
 103           else if (!xmlStrcmp(aName, (const xmlChar *) WDG_TOOLBOX_BOX)) {
 104             aSwitchNode = hasParentRecursive(aCaseNode, WDG_TOOLBOX, NULL);
 105           }
 106           if (!xmlStrcmp(aName, (const xmlChar *) WDG_OPTIONALBOX)) {
 107             /// the box is optional, attribute is in case
 108             /// if the optional attribute value is not empty
 109             aSwitchNode = aCaseNode;
 110           }
 111           if (aSwitchNode)
 112             aSwitchNodeID = getProperty(aSwitchNode, _ID);
 113
 114           aCases.push_back(std::make_pair(aSwitchNodeID, aCaseNodeID));
 115           aCaseNode = hasParentRecursive(aSwitchNode, WDG_SWITCH_CASE,
 116                                          WDG_TOOLBOX_BOX, WDG_OPTIONALBOX, NULL);
 117         }
 118         aMessage->setCases(aCases);
 119         Events_Loop::loop()->send(aMessage);
 120       }
 121     // container pages, like "case" or "box"
 122     } else if (isNode(theNode, WDG_OPTIONALBOX, WDG_SWITCH, WDG_SWITCH_CASE,
 123                       WDG_TOOLBOX, WDG_TOOLBOX_BOX, NULL)) {
 124       storeAttribute(theNode, _ID); // save case:caseId (or box:boxId)
 125     }
 126   }
 127   //Process SOURCE nodes.
 128   Config_XMLReader::processNode(theNode);
 129 }
 130
 131 void Config_FeatureReader::cleanup(xmlNodePtr theNode)
 132 {
 133   if (isNode(theNode, WDG_OPTIONALBOX, WDG_SWITCH, WDG_SWITCH_CASE,
 134              WDG_TOOLBOX, WDG_TOOLBOX_BOX, NULL)) {
 135     // cleanup id of cases when leave case node
 136     cleanupAttribute(theNode, _ID);
 137   }
 138 }
 139
 140 bool Config_FeatureReader::processChildren(xmlNodePtr theNode)
 141 {
 142   bool result = isNode(theNode, NODE_WORKBENCH, NODE_GROUP, NULL);
 143   if(!result && myIsProcessWidgets) {
 144     result = isNode(theNode, NODE_FEATURE,
 145                              WDG_GROUP, WDG_OPTIONALBOX,
 146                              WDG_TOOLBOX, WDG_TOOLBOX_BOX,
 147                              WDG_SWITCH, WDG_SWITCH_CASE, NULL);
 148   }
 149   return result;
 150 }
 151
 152 void Config_FeatureReader::fillFeature(xmlNodePtr theFeatureNode,
 153   const std::shared_ptr<Config_FeatureMessage>& outFeatureMessage)
 154 {
 155   std::string anId = getProperty(theFeatureNode, _ID);
 156   outFeatureMessage->setId(anId);
 157   outFeatureMessage->setPluginLibrary(myLibraryName);
 158   outFeatureMessage->setNestedFeatures(getProperty(theFeatureNode, FEATURE_NESTED));
 159   outFeatureMessage->setActionsWhenNested(getNormalizedProperty(theFeatureNode,
 160                                           FEATURE_WHEN_NESTED));
 161   outFeatureMessage->setModal(getBooleanAttribute(theFeatureNode, FEATURE_MODAL, false));
 162   bool isAutoPreview = getBooleanAttribute(theFeatureNode, FEATURE_AUTO_PREVIEW, true);
 163   outFeatureMessage->setAutoPreview(isAutoPreview);
 164
 165   bool isInternal = getBooleanAttribute(theFeatureNode, ATTR_INTERNAL, false);
 166   outFeatureMessage->setInternal(isInternal);
 167   if (isInternal) {
 168     //Internal feature has no visual representation.
 169     return;
 170   }
 171
 172   std::string aText = Config_Translator::translate(anId, getProperty(theFeatureNode, FEATURE_TEXT));
 173   outFeatureMessage->setText(aText);
 174   std::string aToolTip = Config_Translator::translate(anId,
 175                                                       getProperty(theFeatureNode, FEATURE_TOOLTIP));
 176   outFeatureMessage->setTooltip(aToolTip);
 177   outFeatureMessage->setIcon(getProperty(theFeatureNode, FEATURE_ICON));
 178   outFeatureMessage->setKeysequence(getProperty(theFeatureNode, FEATURE_KEYSEQUENCE));
 179   outFeatureMessage->setGroupId(restoreAttribute(NODE_GROUP, _ID));
 180   outFeatureMessage->setWorkbenchId(restoreAttribute(NODE_WORKBENCH, _ID));
 181   // Get document kind of a feature, if empty set workbench's kind (might be empty too)
 182   std::string aDocKind = getProperty(theFeatureNode, FEATURE_DOC);
 183   if(aDocKind.empty()) {
 184     aDocKind = restoreAttribute(NODE_WORKBENCH, WORKBENCH_DOC);
 185   }
 186   outFeatureMessage->setDocumentKind(aDocKind);
 187 }