X-Git-Url: https://git.teslayout.com/public/public/public/?a=blobdiff_plain;f=include%2Fanna%2Fdiameter.comm%2FMessage.hpp;h=9fc265a83ae8c20b95e0d2d847bac5d392e9da41;hb=8a597c7ccbe2986f505fd70258e4b59ecef4166f;hp=031391cce095e5415549ae121150300850cc0c29;hpb=93366a0bda79e6fd6e7dad6316bfcf8cc82f5731;p=anna.git diff --git a/include/anna/diameter.comm/Message.hpp b/include/anna/diameter.comm/Message.hpp index 031391c..9fc265a 100644 --- a/include/anna/diameter.comm/Message.hpp +++ b/include/anna/diameter.comm/Message.hpp @@ -40,18 +40,19 @@ class ServerSession; /** Messages launched to diameter servers + Could be proxied (end-to-end kept) or not (by default). */ class Message : public anna::comm::Message { public: /** - * Define las acciones a realizar en caso de que el temporizador de la petición expire. + * Define las acciones a realizar en caso de que el temporizador de la petici�n expire. */ - struct OnExpiry { enum _v { Abandon, Ignore }; }; + struct OnExpiry { enum _v { Abandon, Ignore, Retransmit }; }; /** Constructor. - \param onExpiry Indica la acción a realizar si el temporizador de esta transación expira. + \param onExpiry Indica la acci�n a realizar si el temporizador de esta transaci�n expira. */ Message(const OnExpiry::_v onExpiry = OnExpiry::Ignore) : anna::comm::Message(StatusCodeBuffer::Reserve), a_classCode(ClassCode::ApplicationMessage), @@ -64,16 +65,16 @@ public: const ClassCode::_v & getClassCode() const throw() { return a_classCode; } /** - * Devuelve la acción a realizar en caso de que el temporizador asociado a esta petición expire. - * \return la acción a realizar en caso de que el temporizador asociado a esta petición expire. + * Devuelve la acci�n a realizar en caso de que el temporizador asociado a esta petici�n expire. + * \return la acci�n a realizar en caso de que el temporizador asociado a esta petici�n expire. */ OnExpiry::_v getOnExpiry() const throw() { return a_onExpiry; } /** - * Establece la acción a realizar en caso de que el temporizador asociado a esta petición expire. - * \param onExpiry Indica la acción a realizar en caso de que el temporizador asociado a esta petición expire. + * Establece la acci�n a realizar en caso de que el temporizador asociado a esta petici�n expire. + * \param onExpiry Indica la acci�n a realizar en caso de que el temporizador asociado a esta petici�n expire. * - * \warning Establecer el valor OnExpiry::Ignore podría causar pérdida de memoria y uso innecesario de recursos. + * \warning Establecer el valor OnExpiry::Ignore podr�a causar p�rdida de memoria y uso innecesario de recursos. */ void setOnExpiry(const OnExpiry::_v onExpiry) throw() { a_onExpiry = onExpiry; } @@ -104,8 +105,34 @@ public: void setRequestEndToEnd(EndToEnd ete) throw() { a_requestEndToEnd = ete; } CommandId getCommandId(bool &isRequest) const throw(); CommandId getCommandId() const throw() { bool dummy; return getCommandId(dummy); } + ApplicationId getApplicationId() const throw(); + + bool fixRequestSequence(HopByHop hbh, EndToEnd ete) throw(); + + // http://diameter-protocol.blogspot.com.es/2011/05/diameter-message-structure-and-message.html + + /** + * In general, diameter nodes will sequence the End-To-End value when sending new requests. + * A 'false' value stands for intermediate agents (must keep end-to-end during 4 minutes even upon reboots). + */ + bool endToEndSequenced() const throw() { return a_endToEndSequenced; } + + /** + * By default, the diameter::comm message will sequence the end-to-end increasing the initial value created + * during session establishment. Anyway you could change this behaviour with this method. + * + * @see sequenceEndToEnd + */ + void forwardEndToEnd() throw() { a_endToEndSequenced = false; } + + /** + * By default, the diameter::comm message will sequence the end-to-end increasing the initial value created + * during session establishment. Anyway you could set again this behaviour with this method. + * + * @see forwardEndToEnd + */ + void sequenceEndToEnd() throw() { a_endToEndSequenced = true; } - bool fixRequestSequence(HopByHop hbh, EndToEnd ete, bool freezeEndToEnd) throw(); // Statistics void updateRequestTimestampMs(void) throw() { a_request_timestamp_ms = anna::functions::millisecond(); } @@ -127,11 +154,12 @@ public: /** Initializes class information */ void initialize() throw() { - a_retries = 0; + a_retries = 1; a_requestServerSessionKey = -1; // means unknown/unset a_requestClientSessionKey = ""; // means unknown/unset a_requestHopByHop = 0; a_requestEndToEnd = 0; + a_endToEndSequenced = true; } @@ -139,7 +167,7 @@ protected: /** Constructor. \param classCode Tipo de clase de esta peticion. - \param onExpiry Indica la acción a realizar si el temporizador de esta transación expira. + \param onExpiry Indica la acci�n a realizar si el temporizador de esta transaci�n expira. */ Message(const ClassCode::_v & classCode, const OnExpiry::_v onExpiry = OnExpiry::Ignore) : anna::comm::Message(StatusCodeBuffer::Reserve), a_classCode(classCode), @@ -155,6 +183,7 @@ private: std::string a_requestClientSessionKey; // idem for request which was received from servers HopByHop a_requestHopByHop; // application backup for hop-by-hop in order to restore on answer receive EndToEnd a_requestEndToEnd; // application backup for end-to-end in order to restore on answer receive + bool a_endToEndSequenced; // end-to-end will be sequenced by default (true) void send(ClientSession&) const throw(anna::RuntimeException); void send(ServerSession&) const throw(anna::RuntimeException);