| This class contains the enumerations that define whether a timeout has
occured in the underlying implementation. The application gets
informed on whether a retransmission or transaction timer has expired.
There are two types of Timeout, namely:
-
Timeout.RETRANSMIT - This type is used to alert an application that
the underlying retransmit timer has expired so an application can
resend the message specific to a transaction. This timer is defaulted to
500ms and is doubled each time it is fired until the transaction expires
Timeout.TRANSACTION . The default retransmission value can be changed
per transaction using
Transaction.setRetransmitTimer(int) . The
RETRANSMIT type is exposed to the following applications as follows:
- User Agent - Retransmissions on Invite transactions are the
responsibility of the application. This is due to the three way handshake
for an INVITE Request. All other retransmissions are handled by the underlying
implementation. Therefore the application will only receive this Timeout type
specific to Invite transactions.
- User Agent with No Retransmission - an application can configure an
implementation to handle all retransmissions using property characteristics
of the
SipStack . Therefore a Timeout
of this type will not be passed to the application. The application
will only get notified when the
Timeout.TRANSACTION occurs.
- Stateful Proxy - a stateful proxy remembers transaction state about
each incoming request and any requests it sends as a result of
processing the incoming request. The underlying implementation
will handle the retransmissions of all messages it sends and the application
will not receive
Timeout.RETRANSMIT events, however the application
will get notified of
Timeout.TRANSACTION events. As an Invite
transaction is end to end a stateful proxy will not handle the
retransmissions of messages on an Invite transaction, unless it decides to
respond to the Invite transaction, in essence becoming an User Agent Server
and as such should behave as described by the User Agent semantics above
bearing in mind the retranmission property of the underlying implementation.
- Stateless Proxy - as a stateless proxy acts as a simple forwarding
agent, i.e. it simply forwards every message it receives upstream, it
keeps no transaction state for messages. The implementation does not retransmit
messages, therefore an application will not receive
Timeout.RETRANSMIT events on a message handled statelessly. If retransmission semantics are
required by an application using a stateless method, it is the responsibility
of the application to provide this feature, not the underlying implementation.
-
Timeout.TRANSACTION - This type is used to alert an application
that the underlying transaction has expired. A transaction timeout typically
occurs at a time 64*T1 were T1 is the initial value of the
Timeout.RETRANSMIT , usually defaulted to 500ms. The
TRANSACTION type is exposed to the following applications as follows:
- User Agent - All retransmissions except retransmissions on Invite
transactions are the responsibility of the underlying implementation, i.e.
Invite transactions are the responsibility of the application. Therefore the
application will only recieve TRANSACTION Timeout events on transactions that
are not Invite transactions.
- User Agent with No Retransmission - an application can configure an
implementation to handle all retransmissions using property characteristics
of the
SipStack . Therefore a TRANSACTION Timeout will be fired to
the application on any transaction that expires including an Invite
transaction.
- Stateful Proxy - a stateful proxy remembers transaction state about
each incoming request and any requests it sends as a result of
processing the incoming request. The underlying implementation handles
the retransmissions of all messages it sends and will notify the application
of
Timeout.TRANSACTION events on any of its transactions. As an Invite
transaction is end to end a stateful proxy will not handle transaction
timeouts on an Invite transaction, unless it decides to respond to the Invite
transaction, in essence becoming an User Agent Server and as such should
behave as described by the User Agent semantics above bearing in mind
the retransmission property of the underlying implementation.
- Stateless Proxy - as a stateless proxy acts as a simple forwarding
agent, i.e. it simply forwards every message it receives upstream, it
keeps no transaction state of the messages. The implementation does not
maintain transaction state, therefore an application will not receive
Timeout.TRANSACTION events on a message handled statelessly.
If transaction timeout semantics are required by an application using a
stateless method, it the responsibility of the application to provide this
feature, not the underlying implementation.
author: BEA Systems, NIST version: 1.2 |