]> SALOME platform Git repositories - modules/shaper.git/commitdiff
Salome HOME
Initial validators mechanism
authormpv <mikhail.ponikarov@opencascade.com>
Thu, 3 Jul 2014 08:43:17 +0000 (12:43 +0400)
committermpv <mikhail.ponikarov@opencascade.com>
Thu, 3 Jul 2014 08:43:17 +0000 (12:43 +0400)
src/Model/CMakeLists.txt
src/Model/Model_PluginManager.cpp
src/Model/Model_PluginManager.h
src/Model/Model_Validator.cpp [new file with mode: 0644]
src/Model/Model_Validator.h [new file with mode: 0644]
src/ModelAPI/CMakeLists.txt
src/ModelAPI/ModelAPI.i
src/ModelAPI/ModelAPI_PluginManager.cpp
src/ModelAPI/ModelAPI_PluginManager.h
src/ModelAPI/ModelAPI_Validator.h [new file with mode: 0644]

index d6ce96bdf08ce2c7a4cdade265939f25aaa3807a..9dea7108a082955bc17f6373fa203789abccf5bd 100644 (file)
@@ -15,6 +15,7 @@ SET(PROJECT_HEADERS
     Model_AttributeBoolean.h
     Model_Events.h
     Model_Update.h
+    Model_Validator.h
 )
 
 SET(PROJECT_SOURCES
@@ -31,6 +32,7 @@ SET(PROJECT_SOURCES
     Model_AttributeBoolean.cpp
     Model_Events.cpp
     Model_Update.cpp
+    Model_Validator.cpp
 )
 
 SET(PROJECT_LIBRARIES
index c95ab12426ef7dd5c06e1ffb1399d2a12c54d027..00ffa6678d935937f5e678e4d4f0669b0bcae11e 100644 (file)
@@ -9,6 +9,7 @@
 #include <Model_Document.h>
 #include <Model_Application.h>
 #include <Model_Events.h>
+#include <Model_Validator.h>
 #include <Events_Loop.h>
 #include <Events_Error.h>
 #include <Config_FeatureMessage.h>
@@ -99,7 +100,7 @@ Model_PluginManager::Model_PluginManager()
 {
   myPluginsInfoLoaded = false;
   myCheckTransactions = true;
-  ModelAPI_PluginManager::SetPluginManager(boost::shared_ptr<ModelAPI_PluginManager>(this));
+  ModelAPI_PluginManager::setPluginManager(boost::shared_ptr<ModelAPI_PluginManager>(this));
   // register the configuration reading listener
   Events_Loop* aLoop = Events_Loop::loop();
   static Events_ID FeatureEvent = Events_Loop::eventByName("FeatureRegisterEvent");
@@ -143,3 +144,9 @@ void Model_PluginManager::registerPlugin(ModelAPI_Plugin* thePlugin)
 {
   myPluginObjs[myCurrentPluginName] = thePlugin;
 }
+
+ModelAPI_ValidatorsFactory* Model_PluginManager::validators()
+{
+  static Model_ValidatorsFactory* aFactory = new Model_ValidatorsFactory;
+  return aFactory;
+}
index bed54c08b496dc4629c46cdbffe2544a69a60d6c..1819c56d5ac9902d2c20082a00bc72f5758aea05 100644 (file)
@@ -54,6 +54,9 @@ public:
   MODEL_EXPORT virtual boost::shared_ptr<ModelAPI_Document> copy(
     boost::shared_ptr<ModelAPI_Document> theSource, std::string theID);
 
+  /// Returns the validators factory: the only one instance per application
+  MODEL_EXPORT virtual ModelAPI_ValidatorsFactory* validators();
+
   void setCheckTransactions(const bool theCheck) {myCheckTransactions = theCheck;}
 
   /// Is called only once, on startup of the application
diff --git a/src/Model/Model_Validator.cpp b/src/Model/Model_Validator.cpp
new file mode 100644 (file)
index 0000000..fe71109
--- /dev/null
@@ -0,0 +1,94 @@
+// File:        Model_Validator.cpp
+// Created:     2 Jul 2014
+// Author:      Mikhail PONIKAROV
+
+#include <Model_Validator.h>
+#include <ModelAPI_Feature.h>
+#include <Events_Error.h>
+
+using namespace std;
+
+void Model_ValidatorsFactory::registerValidator(
+  const string& theID, ModelAPI_Validator* theValidator)
+{
+  if (myIDs.find(theID) != myIDs.end()) {
+    Events_Error::send(string("Validator ") + theID + " is already registered");
+  } else {
+    myIDs[theID] = theValidator;
+  }
+}
+
+void Model_ValidatorsFactory::assignValidator(const string& theID, const string& theFeatureID)
+{
+  bool isError = false;
+  map<string, ModelAPI_Validator*>::iterator aVal = myIDs.find(theID);
+  if (aVal == myIDs.end()) {
+    Events_Error::send(
+      string("Validator ") + theID + " for feature " + theFeatureID + " was not registered");
+    isError = true;
+  }
+  if (myFeatures.find(theFeatureID) != myFeatures.end()) {
+      Events_Error::send(
+        string("Validator for feature ") + theFeatureID + " is already registered");
+    isError = true;
+  }
+  if (!isError)
+    myFeatures[theFeatureID] = aVal->second;
+}
+
+void Model_ValidatorsFactory::assignValidator(const string& theID, 
+  const string& theFeatureID, const string& theAttrID, const list<string>& theArguments)
+{
+  bool isError = false;
+  map<string, ModelAPI_Validator*>::iterator aVal = myIDs.find(theID);
+  if (aVal == myIDs.end()) {
+    Events_Error::send(
+      string("Validator ") + theID + " for feature " + theFeatureID + " was not registered");
+    isError = true;
+  }
+  // create feature-structures if not exist
+  map<string, map<string, pair<ModelAPI_Validator*, list<string> > > >::iterator
+    aFeature = myAttrs.find(theFeatureID);
+  if (aFeature == myAttrs.end()) {
+    myAttrs[theFeatureID] = map<string, pair<ModelAPI_Validator*, list<string> > >();
+    aFeature = myAttrs.find(theFeatureID);
+  }
+  // add attr-structure if not exist, or generate error if already exist
+  map<string, pair<ModelAPI_Validator*, list<string> > >::iterator 
+    anAttr = aFeature->second.find(theAttrID);
+  if (anAttr == aFeature->second.end()) {
+    if (!isError) {
+      aFeature->second[theAttrID] = 
+        pair<ModelAPI_Validator*, list<string> >(aVal->second, theArguments);
+    }
+  } else {
+    Events_Error::send(
+      string("Validator ") + theID + " for feature " + theFeatureID +
+              "attribute " + theAttrID + " is already registered");
+    isError = true;
+  }
+}
+
+const ModelAPI_Validator* Model_ValidatorsFactory::validator(const string& theFeatureID) const
+{
+  map<string, ModelAPI_Validator*>::const_iterator aFeature = myFeatures.find(theFeatureID);
+  if (aFeature != myFeatures.cend())
+    return aFeature->second;
+  return NULL; // not found
+}
+
+bool Model_ValidatorsFactory::validate(
+  const boost::shared_ptr<ModelAPI_Feature>& theFeature, const string& theAttrID ) const
+{
+  map<string, map<string, pair<ModelAPI_Validator*, list<string> > > >::const_iterator
+    aFeature = myAttrs.find(theFeature->getKind());
+  if (aFeature == myAttrs.cend()) return true; // feature is not found
+  map<string, pair<ModelAPI_Validator*, list<string> > >::const_iterator 
+    anAttr = aFeature->second.find(theAttrID);
+  if (anAttr == aFeature->second.cend()) return true; // attribute is not found
+  return anAttr->second.first->validate(theFeature, theAttrID, anAttr->second.second);
+}
+
+Model_ValidatorsFactory::Model_ValidatorsFactory() : ModelAPI_ValidatorsFactory()
+{
+}
diff --git a/src/Model/Model_Validator.h b/src/Model/Model_Validator.h
new file mode 100644 (file)
index 0000000..9d04e29
--- /dev/null
@@ -0,0 +1,59 @@
+// File:        Model_Validator.hxx
+// Created:     2 Jul 2014
+// Author:      Mikhail PONIKAROV
+
+#ifndef Model_Validator_HeaderFile
+#define Model_Validator_HeaderFile
+
+#include <Model.h>
+#include <ModelAPI_Validator.h>
+#include <map>
+
+/**\class Model_ValidatorsFactory
+ * \ingroup DataModel
+ * \breif Manages the registered validators
+ *
+ * Allows to get a validator by the feature identifier and 
+ * the attribute identifier (if attribute is validated).
+ * All accessible validators mustbe registered by the ID string first.
+ * The instance of this factory can be get in the PluginManager.
+ * Keeps the validator objects alive and just returns one of it by request.
+ * All the needed information is provided to the validator as an argument,
+ * this allows to work with them independently from the feature specific object.
+ */
+class Model_ValidatorsFactory: public ModelAPI_ValidatorsFactory
+{
+  std::map<std::string, ModelAPI_Validator*> myIDs; ///< map from ID to registered validator
+  std::map<std::string, ModelAPI_Validator*> myFeatures; ///< validators by feature ID
+  std::map<std::string, std::map<std::string, std::pair<ModelAPI_Validator*, 
+    std::list<std::string> > > > myAttrs; ///< validators and arguments by feature and attribute IDs
+public:
+  /// Registers the instance of the validator by the ID
+  MODEL_EXPORT virtual void registerValidator(
+    const std::string& theID, ModelAPI_Validator* theValidator);
+
+  /// Assigns validator to the feature
+  MODEL_EXPORT virtual void assignValidator(
+    const std::string& theID, const std::string& theFeatureID);
+
+  /// Assigns validator to the attribute of the feature
+  MODEL_EXPORT virtual void assignValidator(const std::string& theID, 
+    const std::string& theFeatureID, const std::string& theAttrID,
+    const std::list<std::string>& theArguments);
+
+  /// Provides a validator for the feature, returns NULL if no validator
+  MODEL_EXPORT virtual const ModelAPI_Validator* validator(const std::string& theFeatureID) const;
+
+  /// Returns the result of "validate" method for attribute of validator.
+  /// If validator is not exists, returns true: everything is valid by default.
+  MODEL_EXPORT virtual bool validate(
+    const boost::shared_ptr<ModelAPI_Feature>& theFeature, const std::string& theAttrID) const;
+
+protected:
+  /// Get instance from PluginManager
+  Model_ValidatorsFactory();
+
+  friend class Model_PluginManager;
+};
+
+#endif
index 3fd7da3a04a52cefe747998c39d369d932fc37f7..5a13d37a656f9463992df4272f652b15d046ad69 100644 (file)
@@ -18,6 +18,7 @@ SET(PROJECT_HEADERS
     ModelAPI_AttributeRefList.h
     ModelAPI_AttributeBoolean.h
     ModelAPI_Events.h
+    ModelAPI_Validator.h
 )
 
 SET(PROJECT_SOURCES
index 589ac4026502f73df3b9f3ae0bfd9bea3a5d75a9..8fd391b2613e5d855528028001d09674cdd14d72 100644 (file)
@@ -12,6 +12,7 @@
   #include "ModelAPI_AttributeDouble.h"
   #include "ModelAPI_AttributeReference.h"
   #include "ModelAPI_AttributeRefAttr.h"
+  #include "ModelAPI_Validator.h"
 %}
 
 // to avoid error on this
@@ -46,3 +47,4 @@
 %include "ModelAPI_AttributeDouble.h"
 %include "ModelAPI_AttributeReference.h"
 %include "ModelAPI_AttributeRefAttr.h"
+%include "ModelAPI_Validator.h"
\ No newline at end of file
index 766590a2eea048ab2136313ef981444c26277a86..72deaba2c695a78614a197126d513a1762cfbb12 100644 (file)
@@ -20,6 +20,7 @@
 #include <ModelAPI_AttributeRefAttr.h>
 #include <ModelAPI_AttributeRefList.h>
 #include <ModelAPI_Events.h>
+#include <ModelAPI_Validator.h>
 
 #include <Config_ModuleReader.h>
 
@@ -42,7 +43,7 @@ ModelAPI_PluginManager::ModelAPI_PluginManager()
 {
 }
 
-void ModelAPI_PluginManager::SetPluginManager(
+void ModelAPI_PluginManager::setPluginManager(
   boost::shared_ptr<ModelAPI_PluginManager> theManager)
 {
   MY_MANAGER = theManager;
index 6b25bf4a378dfc68758dc6f500b33ee692219054..f23cf95815ecaaec462eea915dcf6f86f4b69098 100644 (file)
@@ -12,6 +12,7 @@
 class ModelAPI_Feature;
 class ModelAPI_Plugin;
 class ModelAPI_Document;
+class ModelAPI_ValidatorsFactory;
 
 /**\class ModelAPI_PluginManager
  * \ingroup DataModel
@@ -47,6 +48,9 @@ public:
   virtual boost::shared_ptr<ModelAPI_Document> copy(
     boost::shared_ptr<ModelAPI_Document> theSource, std::string theID) = 0;
 
+  /// Returns the validators factory: the only one instance per application
+  virtual ModelAPI_ValidatorsFactory* validators() = 0;
+
   /// Is needed for python wrapping by swig, call Get to get an instance
   ModelAPI_PluginManager();
 
@@ -57,12 +61,11 @@ protected:
   /// Creates the feature object using plugins functionality
   virtual boost::shared_ptr<ModelAPI_Feature> createFeature(std::string theFeatureID) = 0;
 
-  static void SetPluginManager(boost::shared_ptr<ModelAPI_PluginManager> theManager);
+  static void setPluginManager(boost::shared_ptr<ModelAPI_PluginManager> theManager);
 
   friend class Model_Document;
 };
 
 typedef boost::shared_ptr<ModelAPI_PluginManager> PluginManagerPtr;
 
-
 #endif
diff --git a/src/ModelAPI/ModelAPI_Validator.h b/src/ModelAPI/ModelAPI_Validator.h
new file mode 100644 (file)
index 0000000..4a0243c
--- /dev/null
@@ -0,0 +1,77 @@
+// File:        ModelAPI_Validator.hxx
+// Created:     2 Jul 2014
+// Author:      Mikhail PONIKAROV
+
+#ifndef ModelAPI_Validator_HeaderFile
+#define ModelAPI_Validator_HeaderFile
+
+#include <ModelAPI.h>
+#include <boost/shared_ptr.hpp>
+#include <list>
+
+class ModelAPI_Feature;
+
+/**\class ModelAPI_Validator
+ * \ingroup DataModel
+ * \brief Allows to validate the attribute value of a feature or the whole feature.
+ *
+ * This object is assigned by the name
+ * in the XML file to the specific attribute or to the whole feature.
+ * If validator returns "false", it is signalized in user interface
+ * and feature is not executed.
+ * Validators must be registered in the validators factory to be
+ * correctly identified by the XML string-ID.
+ */
+class MODELAPI_EXPORT ModelAPI_Validator
+{
+public:
+  /// Returns true if feature and/or attributes are valid
+  /// \param theFeature the validated feature
+  /// \param theAttr the validated attribute ID, empty string of feature is validated
+  /// \param theArguments list of string, feature attribute names: dependent attributes
+  virtual bool validate(const boost::shared_ptr<ModelAPI_Feature>& theFeature,
+    const std::string theAttr, std::list<std::string> theArguments) const = 0;
+};
+
+typedef boost::shared_ptr<ModelAPI_Validator> ValidatorPtr;
+
+/**\class ModelAPI_ValidatorsFactory
+ * \ingroup DataModel
+ * \breif Manages the registered validators
+ *
+ * Allows to get a validator by the feature identifier and 
+ * the attribute identifier (if attribute is validated).
+ * All accessible validators mustbe registered by the ID string first.
+ * The instance of this factory can be get in the PluginManager.
+ * Keeps the validator objects alive and just returns one of it by request.
+ * All the needed information is provided to the validator as an argument,
+ * this allows to work with them independently from the feature specific object.
+ */
+class MODELAPI_EXPORT ModelAPI_ValidatorsFactory
+{
+public:
+  /// Registers the instance of the validator by the ID
+  virtual void registerValidator(const std::string& theID, ModelAPI_Validator* theValidator) = 0;
+
+  /// Assigns validator to the feature
+  virtual void assignValidator(const std::string& theID, const std::string& theFeatureID) = 0;
+
+  /// Assigns validator to the attribute of the feature
+  virtual void assignValidator(const std::string& theID, 
+    const std::string& theFeatureID, const std::string& theAttrID,
+    const std::list<std::string>& theArguments) = 0;
+
+  /// Provides a validator for the feature, returns NULL if no validator
+  virtual const ModelAPI_Validator* validator(const std::string& theFeatureID) const = 0;
+
+  /// Returns the result of "validate" method for attribute of validator.
+  /// If validator is not exists, returns true: everything is valid by default.
+  virtual bool validate(
+    const boost::shared_ptr<ModelAPI_Feature>& theFeature, const std::string& theAttrID) const = 0;
+
+protected:
+  /// Get instance from PluginManager
+  ModelAPI_ValidatorsFactory() {}
+};
+
+#endif