Unpublished - rights reserved under the Copyright Laws of the United States.
Copyright � 2003 Sun Microsystems, Inc. All rights reserved.
Copyright � 2005 BEA Systems, Inc. All rights reserved.
Use is subject to license terms.
This distribution may include materials developed by third parties.
Module Name : JSIP Specification
File Name : IOExceptionEvent.java
Author : M. Ranganathan
Version Date Author Comments
1.2 05/03/2005 M. Ranganathan Initial version
This object is used to signal to the application that an IO Exception has
occured. The transaction state machine requires to report asynchronous IO Exceptions to
the application immediately (according to RFC 3261).
This class represents an IOExceptionEvent that is passed from a SipProvider to its SipListener.
This event enables an implementation to propagate the asynchronous handling
of IO Exceptions to the application. An application (SipListener) will
register with the SIP protocol stack (SipProvider) and listen for
IO Exceptions from the SipProvider.
In many cases, when sending a SIP message, the sending function will return before
the message was actually sent.
This will happen for example if there is a need to wait for a response from a DNS server
or to perform other asynchronous actions such as connecting a TCP connection.
Later on if the message sending fails an IO exception event will be given to the application.
IO Exception events may also be reported asynchronously when the Transaction State machine
attempts to resend a pending request. Note that synchronous IO Exceptions
are presented to the caller as SipException.
- BEA Systems, NIST
source -- the object that is logically deemed to have caused the IO Exception (dialog/transaction/provider).
remoteHost -- host where the request/response was heading
port -- port where the request/response was heading
transport -- transport ( i.e. UDP/TCP/TLS).
Return the host where Socket was pointing.
Returns the port where the socket was trying to send amessage.
- port associated with the IOException
Return transport used for the failed write attempt.
- the transaction associated with the IOException