Fixes and improvs. Basic DRA feature.

[anna.git] / include / anna / diameter / codec / EngineImpl.hpp

diff --git a/include/anna/diameter/codec/EngineImpl.hpp b/include/anna/diameter/codec/EngineImpl.hpp
index e282724..b973e8d 100644 (file)
--- a/include/anna/diameter/codec/EngineImpl.hpp
+++ b/include/anna/diameter/codec/EngineImpl.hpp
@@ -114,8 +114,7 @@ class Avp;
  *
  *     class MyEngine : public EngineImpl {
  *     public:
  *
  *     class MyEngine : public EngineImpl {
  *     public:

- *        Engine (getClassName()) {;}
- *        static const char* getClassName() throw() { return "<full-naming path>::MyEngine"; }
+ *        MyEngine (const char *className = "MyEngine") : Engine(className) {;}

  *
  *     private:
  *        anna::Recycler<MyAvp> a_avps;
  *
  *     private:
  *        anna::Recycler<MyAvp> a_avps;


@@ -179,6 +178,7 @@ private:
   anna::xml::DTDMemory a_dtd;
   ValidationDepth::_v a_validationDepth;
   ValidationMode::_v a_validationMode;
   anna::xml::DTDMemory a_dtd;
   ValidationDepth::_v a_validationDepth;
   ValidationMode::_v a_validationMode;

+  bool a_singleFailedAVP;

   bool a_ignoreFlags;
   FixMode::_v a_fixMode;
   bool a_selectStackWithApplicationId; // default behaviour: let the user switch the stack (false for this boolean)
   bool a_ignoreFlags;
   FixMode::_v a_fixMode;
   bool a_selectStackWithApplicationId; // default behaviour: let the user switch the stack (false for this boolean)


@@ -238,7 +238,9 @@ public:
   * this to have the commonly recommended way to choose the stack: using the Application-Id value.
   *
   * @warning do not activate in case of multithreaded applications.
   * this to have the commonly recommended way to choose the stack: using the Application-Id value.
   *
   * @warning do not activate in case of multithreaded applications.

+  * @warning must register the base protocol stack (with id = 0 = application-id) to manage base protocol messages.

   * @param enable Activates/deactivates the stack selection from the Application-Id value within the message header.
   * @param enable Activates/deactivates the stack selection from the Application-Id value within the message header.

+  *               False by default on engine construction.

   */
   void selectStackWithApplicationId (bool enable) throw() { a_selectStackWithApplicationId = enable; }
 
   */
   void selectStackWithApplicationId (bool enable) throw() { a_selectStackWithApplicationId = enable; }
 


@@ -248,7 +250,7 @@ public:
     Gets the currently configured behaviour regarding stack selection for multistack codec engines in mono thread
     applications.
 
     Gets the currently configured behaviour regarding stack selection for multistack codec engines in mono thread
     applications.
 

-    @return True if selection is done with the Application-Id. False if no selection is performed (user responsibility).
+    @return True if selection is done with the Application-Id. False (default) if no selection is performed (user responsibility).

   */
   bool hasSelectStackWithApplicationId (void) throw() { return a_selectStackWithApplicationId; }
 
   */
   bool hasSelectStackWithApplicationId (void) throw() { return a_selectStackWithApplicationId; }
 


@@ -322,7 +324,20 @@ public:
    */
   FixMode::_v getFixMode() const throw() { return a_fixMode; }
 
    */
   FixMode::_v getFixMode() const throw() { return a_fixMode; }
 

+  /**
+   * Sets single FailedAVP. True by default. If false, and more than one wrong avp are found during message
+   * decoding and or validation, a new Failed-AVP will be added to the dynamic answer provided. The standard
+   * talks about only one but it is open to do this.
+   *
+   * \param single Single Failed-AVP boolean.
+   */
+  void setSingleFailedAVP(bool single = true)  throw() { a_singleFailedAVP = single; }

 
 

+  /**
+   * Returns single Failed-AVP boolean.
+   * \return Failed-AVP could be one (true) or more (false) in answer message.
+   */
+  bool getSingleFailedAVP() const throw() { return a_singleFailedAVP; }

 
   /**
      DTD document for xml message parsing
 
   /**
      DTD document for xml message parsing