/**
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 }; };
/**
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),
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; }
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 agents CANNOT modify the end-to-end value during sending the message to the peer.
+ * That 'true' value stands for intermediate agents and also for retransmissions (must keep end-to-end
+ * during 4 minutes even upon reboots). False is used for new request created from end points (originators)
+ * as diameter clients.
+ */
+ bool updateEndToEnd() const throw() { return a_updateEndToEnd; }
+
+ /**
+ * In general, diameter agents CANNOT modify the end-to-end value during sending the message to the peer.
+ * The appropiate behaviour must be configured before sending the message. By default, the diameter::comm
+ * message will sequence the end-to-end increasing the initial value created during session establishment.
+ */
+ void updateEndToEnd(bool update) throw() { a_updateEndToEnd = update; }
- bool fixRequestSequence(HopByHop hbh, EndToEnd ete, bool freezeEndToEnd) throw();
// Statistics
void updateRequestTimestampMs(void) throw() { a_request_timestamp_ms = anna::functions::millisecond(); }
a_requestClientSessionKey = ""; // means unknown/unset
a_requestHopByHop = 0;
a_requestEndToEnd = 0;
+ a_updateEndToEnd = true;
}
/**
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),
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_updateEndToEnd; // end-to-end will be updated
void send(ClientSession&) const throw(anna::RuntimeException);
void send(ServerSession&) const throw(anna::RuntimeException);